@arbidocs/blocks 0.3.185 → 0.4.0

package/dist/connection/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Shared shapes for the ARBI adapter — identical in demo and live mode so UI
+ * never needs to know which backend is serving it — plus the per-app config a
+ * host app supplies once to wire the connection + AI layer.
+ */
+export type ArbiMode = 'demo' | 'live';
+export type ConnectionStatus = 'demo' | 'disconnected' | 'connecting' | 'authenticated' | 'error';
+export interface ArbiUser {
+    name: string;
+    email: string;
+    /** The user's external_id (usr-…), when known (live sessions). */
+    externalId?: string;
+    /** Avatar image URL / data-URL from the backend profile, when set. */
+    picture?: string | null;
+}
+/** A retrieval-augmented answer step surfaced from the agent loop. */
+export interface AssistantStep {
+    label: string;
+    detail?: string;
+    status: 'done' | 'running' | 'queued';
+}
+export interface AssistantCitation {
+    docId: string;
+    docName: string;
+    page?: number;
+    quote: string;
+}
+export interface AssistantMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+    steps?: AssistantStep[];
+    citations?: AssistantCitation[];
+    streaming?: boolean;
+}
+/**
+ * Everything host-specific about the ARBI wiring, injected once at the app root.
+ * Framework-agnostic on purpose: the app reads its own env (Vite, Next, …) and
+ * passes the resolved values in, so the package never touches `import.meta.env`.
+ */
+export interface ArbiConnectionConfig {
+    /** Live backend URL. Empty string ⇒ run entirely in seeded demo mode. */
+    apiUrl: string;
+    /** Inert URL used to mount the SDK provider when there's no live backend. */
+    demoApiUrl?: string;
+    /** Preferred live workspace ext_id (else the first workspace is used). */
+    workspaceId?: string;
+    /** Default assistant *configuration* ext_id every agentic run is grounded on. */
+    assistantConfig?: string;
+    /** The seeded demo identity shown when running without a backend. */
+    demoUser: ArbiUser;
+    /** Workspace id used in demo mode (default "demo-workspace"). */
+    demoWorkspaceId?: string;
+}

package/dist/connection/useImageGen.d.ts

@@ -0,0 +1,22 @@
+import type { AiTaskStatus } from './ai';
+export interface UseImageGen {
+    /** ext_id of the most recently generated image document (null until one exists). */
+    docExtId: string | null;
+    /** Underlying task status: 'idle' | 'running' | 'done' | 'error'. */
+    status: AiTaskStatus;
+    /** Human-readable failure message, or null. */
+    error: string | null;
+    /** True while a generation is in flight. */
+    isGenerating: boolean;
+    /**
+     * Generate an image from a prompt, optionally editing / drawing on one or
+     * more reference images already in the workspace. Pass the reference images'
+     * document ext_ids in `referenceDocIds` (omit or `[]` for plain text→image).
+     * Resolves with the new image document's ext_id, or null when the prompt is
+     * empty or no image was produced.
+     */
+    generate: (prompt: string, referenceDocIds?: string[]) => Promise<string | null>;
+    /** Clear the current result and error. */
+    reset: () => void;
+}
+export declare function useImageGen(): UseImageGen;

package/dist/facts/FactComposer.d.ts

@@ -0,0 +1,75 @@
+import type { ReactNode, Ref } from 'react';
+export interface FactComposerLabels {
+    shared: string;
+    verified: string;
+    dates: string;
+    deleteFact: string;
+    cancel: string;
+    saveFact: string;
+    saving: string;
+    addFact: string;
+    adding: string;
+}
+export declare const DEFAULT_FACT_COMPOSER_LABELS: FactComposerLabels;
+export interface FactComposerTestIds {
+    tags: string;
+    delete: string;
+    save: string;
+    error: string;
+}
+export interface FactSourcesRowLabels {
+    sources: string;
+    hintButton: string;
+    hint: string;
+}
+export declare const DEFAULT_FACT_SOURCES_ROW_LABELS: FactSourcesRowLabels;
+/** Composer field: the name stacked above its control ("Labels", "Dates"...). */
+export declare function FactFieldRow({ label, children, className, }: {
+    label: string;
+    children: ReactNode;
+    className?: string;
+}): import("react").JSX.Element;
+export interface FactSourcesRowProps {
+    /** The show/hide-sources toggle. */
+    toggle: ReactNode;
+    /** The document picker. */
+    picker: ReactNode;
+    labels?: Partial<FactSourcesRowLabels>;
+    /** Test id of the hint button (default `facts-source-hint`). */
+    hintTestId?: string;
+}
+/** Sources label (with passage-collection guidance), the sources toggle and the picker. */
+export declare function FactSourcesRow({ toggle, picker, labels, hintTestId }: FactSourcesRowProps): import("react").JSX.Element;
+export interface FactComposerProps {
+    /** Whether the composer is open (it stays mounted so it animates both ways). */
+    isOpen: boolean;
+    /** Ref to the panel (used to keep it measured/focus-managed by the page). */
+    panelRef?: Ref<HTMLDivElement>;
+    /** The WYSIWYG fact editor, with its sources row. */
+    editor: ReactNode;
+    /** The labels picker row. */
+    labels: ReactNode;
+    /** The Shared switch (label is added here). */
+    sharedToggle: ReactNode;
+    /** The Verified switch (label is added here). */
+    verifiedToggle: ReactNode;
+    /** The date picker. */
+    dateInput: ReactNode;
+    /** Editing an existing fact (shows Delete, "Save fact"). */
+    isEditing: boolean;
+    canSave: boolean;
+    isSaving: boolean;
+    isDeleting: boolean;
+    onSave: () => void;
+    onCancel: () => void;
+    onDelete: () => void;
+    error?: string | null;
+    uiLabels?: Partial<FactComposerLabels>;
+    testIds?: Partial<FactComposerTestIds>;
+}
+/**
+ * The inline fact composer: editor on top, then labels + Shared / Verified, then the date with
+ * Cancel / Save (and Delete when editing). Always mounted; the grid-rows transition animates it
+ * open and closed symmetrically (a conditional mount could only animate one way).
+ */
+export declare function FactComposer({ isOpen, panelRef, editor, labels, sharedToggle, verifiedToggle, dateInput, isEditing, canSave, isSaving, isDeleting, onSave, onCancel, onDelete, error, uiLabels: labelOverrides, testIds, }: FactComposerProps): import("react").JSX.Element;

package/dist/facts/FactDateInput.d.ts

@@ -0,0 +1,34 @@
+import { type FactDateFields } from './fact-date';
+export interface FactDateInputLabels {
+    weekdays: string[];
+    months: string[];
+    previousMonth: string;
+    earlierYears: string;
+    nextMonth: string;
+    laterYears: string;
+    pickYear: string;
+    addDate: string;
+    startTime: string;
+    endTime: string;
+    setStartFirst: string;
+    timezone: string;
+    endDate: string;
+    clearDate: string;
+}
+export declare const DEFAULT_FACT_DATE_INPUT_LABELS: FactDateInputLabels;
+export interface FactDateInputTestIds {
+    caption: string;
+    day: (dateKey: string) => string;
+    year: (year: number) => string;
+}
+export interface FactDateInputProps {
+    value: FactDateFields;
+    onChange: (next: FactDateFields) => void;
+    /** Prefix for data-testids: keeps composer vs. edit-row instances distinct. */
+    idPrefix: string;
+    labels?: Partial<FactDateInputLabels>;
+    /** Overrides for the calendar's own ids (the field ids derive from `idPrefix`). */
+    testIds?: Partial<FactDateInputTestIds>;
+}
+/** A fact's date in a popover: month/year calendar plus optional times, timezone and end date. */
+export declare function FactDateInput({ value, onChange, idPrefix, labels, testIds }: FactDateInputProps): import("react").JSX.Element;

package/dist/facts/FactLabelsCell.d.ts

@@ -0,0 +1,35 @@
+export interface FactLabelsCellLabels {
+    edit: string;
+    searchPlaceholder: string;
+    create: (name: string) => string;
+    empty: string;
+}
+export declare const DEFAULT_FACT_LABELS_CELL_LABELS: FactLabelsCellLabels;
+export interface FactLabelsCellTestIds {
+    option: (labelId: string) => string;
+}
+/** One selectable label: id, name and a colour (any CSS colour) that keys its chip. */
+export interface FactLabelOption {
+    id: string;
+    name: string;
+    color: string;
+}
+export interface FactLabelsCellProps {
+    /** Every label that can be applied. */
+    options: FactLabelOption[];
+    /** The fact's full label id list (ids not in `options` are preserved on change). */
+    selectedIds: string[];
+    /** Persist the fact's full label id list. */
+    onChange: (ids: string[]) => void;
+    /** Create a label and resolve with its id (undefined when creation failed). */
+    onCreate: (name: string) => Promise<string | undefined>;
+    /** The grid row height; clamps the chips to the rows that fully fit. */
+    rowHeight?: number;
+    labels?: Partial<FactLabelsCellLabels>;
+    testIds?: Partial<FactLabelsCellTestIds>;
+}
+/**
+ * The Labels cell of the Facts table: applied labels as colour-keyed chips (an empty cell shows
+ * a pencil), and a popover to toggle labels or create one with Enter.
+ */
+export declare const FactLabelsCell: import("react").NamedExoticComponent<FactLabelsCellProps>;

package/dist/facts/FactPassages.d.ts

@@ -0,0 +1,52 @@
+import type { ReactNode } from 'react';
+export interface FactPassagesLabels {
+    loading: string;
+    close: string;
+}
+export declare const DEFAULT_FACT_PASSAGES_LABELS: FactPassagesLabels;
+export interface FactSourcesPanelTestIds {
+    popover: string;
+    close: string;
+    list: string;
+}
+/**
+ * Flatten a passage's markdown to one readable line for a list preview: headings, bullets,
+ * emphasis, links and table pipes only add noise on a single truncated line.
+ */
+export declare function toPreviewLine(md: string): string;
+/**
+ * Render a flattened preview line with real super/subscripts: `<sup>15</sup>` shows as a
+ * superscript 15, not literal tag text. Unpaired tag fragments are dropped.
+ */
+export declare function renderPreviewInline(line: string): ReactNode;
+export interface FactPassageItemProps {
+    /** Zero-based position in the list (shown as `n.`). */
+    index: number;
+    page?: number | null;
+    /** The passage excerpt (markdown), or null/undefined while it loads. */
+    excerpt?: string | null;
+    /** This passage is the one open in the viewer. */
+    isViewing?: boolean;
+    onSelect: () => void;
+    testId?: string;
+    className?: string;
+    labels?: Partial<FactPassagesLabels>;
+}
+/** One cited passage: index badge, page pill and a single quoted line. */
+export declare function FactPassageItem({ index, page, excerpt, isViewing, onSelect, testId, className, labels, }: FactPassageItemProps): import("react").JSX.Element;
+export interface FactSourcesPanelProps {
+    /** Header caption, e.g. "Sources (2 documents)". */
+    title: string;
+    onClose: () => void;
+    /** The fact section the panel is portalled INTO and fenced WITHIN. */
+    container?: HTMLElement | null;
+    children: ReactNode;
+    labels?: Partial<FactPassagesLabels>;
+    testIds?: Partial<FactSourcesPanelTestIds>;
+}
+/**
+ * Popover panel shell for a fact's sources: sticky header with a close control and a scrolling
+ * list. Must sit inside a `Popover`. Stays open while the user works in the document viewer
+ * (clicks inside the viewer, dialogs or other popper layers do not dismiss it).
+ */
+export declare function FactSourcesPanel({ title, onClose, container, children, labels, testIds, }: FactSourcesPanelProps): import("react").JSX.Element;

package/dist/facts/FactRowActions.d.ts

@@ -0,0 +1,18 @@
+export interface FactRowActionsLabels {
+    actions: string;
+    edit: string;
+    delete: string;
+}
+export declare const DEFAULT_FACT_ROW_ACTIONS_LABELS: FactRowActionsLabels;
+export interface FactRowActionsTestIds {
+    trigger: string;
+    edit: string;
+    delete: string;
+}
+export interface FactRowActionsProps {
+    onEdit: () => void;
+    onDelete: () => void;
+    labels?: Partial<FactRowActionsLabels>;
+    testIds?: Partial<FactRowActionsTestIds>;
+}
+export declare function FactRowActions({ onEdit, onDelete, labels, testIds }: FactRowActionsProps): import("react").JSX.Element;

package/dist/facts/FactSearchParts.d.ts

@@ -0,0 +1,80 @@
+import type { ReactNode } from 'react';
+export interface FactSearchBarLabels {
+    search: string;
+    placeholder: string;
+    clear: string;
+    submit: string;
+}
+export declare const DEFAULT_FACT_SEARCH_BAR_LABELS: FactSearchBarLabels;
+export interface FactSearchBarTestIds {
+    input: string;
+    clear: string;
+    submit: string;
+}
+export interface FactSearchResultLabels {
+    core: string;
+    verified: string;
+    open: string;
+}
+export declare const DEFAULT_FACT_SEARCH_RESULT_LABELS: FactSearchResultLabels;
+export interface FactSearchResultTestIds {
+    hit: (id: string) => string;
+    labels: (id: string) => string;
+    verified: (id: string) => string;
+}
+export interface FactSearchBarProps {
+    query: string;
+    onQueryChange: (query: string) => void;
+    onSubmit: () => void;
+    onClear: () => void;
+    isSearching: boolean;
+    /** Wins over `labels.placeholder`. */
+    placeholder?: string;
+    labels?: Partial<FactSearchBarLabels>;
+    testIds?: Partial<FactSearchBarTestIds>;
+}
+/**
+ * The facts Smart Search bar: the same bordered, auto-growing box as the Files Smart Search.
+ * Enter searches; Shift+Enter breaks a line.
+ */
+export declare function FactSearchBar({ query, onQueryChange, onSubmit, onClear, isSearching, placeholder, labels, testIds, }: FactSearchBarProps): import("react").JSX.Element;
+/** Totals headline pinned between the search bar and the scrolling results. */
+export declare function FactSearchTotals({ children, testId }: {
+    children: ReactNode;
+    testId?: string;
+}): import("react").JSX.Element;
+/** "Searching facts…" line. */
+export declare function FactSearchPending({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** No-matches message. */
+export declare function FactSearchNoMatches({ children, testId, }: {
+    children: ReactNode;
+    testId?: string;
+}): import("react").JSX.Element;
+export interface FactSearchResultLabel {
+    id: string;
+    name: string;
+    color: string;
+}
+export interface FactSearchResultProps {
+    /** Fact id: keys the test ids. */
+    id: string;
+    /** 1-based rank, shown outside the card (it numbers the results, it is not part of the hit). */
+    rank: number;
+    text: string;
+    terms: string[];
+    renderSnippet: (content: string, terms: string[]) => ReactNode;
+    labels: FactSearchResultLabel[];
+    isPinned?: boolean;
+    isVerified?: boolean;
+    /** The fact open in the composer. */
+    isSelected?: boolean;
+    onOpen: () => void;
+    uiLabels?: Partial<FactSearchResultLabels>;
+    testIds?: Partial<FactSearchResultTestIds>;
+    /** Destination of the fact; the card stays a click target (see SearchHit `href`). */
+    href?: string;
+}
+/** One facts search result: rank, highlighted text, labels (and Core) and the Verified mark. */
+export declare function FactSearchResult({ id, rank, text, terms, renderSnippet, labels, isPinned, isVerified, isSelected, onOpen, uiLabels: labelOverrides, testIds, href, }: FactSearchResultProps): import("react").JSX.Element;

package/dist/facts/FactSourceGroup.d.ts

@@ -0,0 +1,26 @@
+import type { ReactNode } from 'react';
+export interface FactSourceGroupLabels {
+    remove: string;
+    wholeDocument: string;
+}
+export declare const DEFAULT_FACT_SOURCE_GROUP_LABELS: FactSourceGroupLabels;
+export interface FactSourceGroupTestIds {
+    root: (docId: string) => string;
+    remove: (docId: string) => string;
+}
+export interface FactSourceGroupProps {
+    docId: string;
+    /** The document label/pill (the app supplies its entity pill). */
+    document: ReactNode;
+    /** True when this document is the one on display in the viewer. */
+    isViewing?: boolean;
+    onRemove: () => void;
+    /** The FactPassageItem children; when absent a "whole document" hint shows. */
+    children?: ReactNode;
+    /** Whether any passages are cited from this document. */
+    hasPassages: boolean;
+    labels?: Partial<FactSourceGroupLabels>;
+    testIds?: Partial<FactSourceGroupTestIds>;
+}
+/** One cited document in the sources list: its label, a remove control and its passages. */
+export declare function FactSourceGroup({ docId, document, isViewing, onRemove, children, hasPassages, labels, testIds, }: FactSourceGroupProps): import("react").JSX.Element;

package/dist/facts/FactTimelineViews.d.ts

@@ -0,0 +1,37 @@
+import { type TimelineGanttProps } from '../timeline/TimelineGantt';
+export interface FactTimelineLabels {
+    ganttEmpty: string;
+}
+export declare const DEFAULT_FACT_TIMELINE_LABELS: FactTimelineLabels;
+/** The fields of a fact the calendar reads. */
+export interface FactCalendarRow {
+    external_id: string;
+    text: string;
+    date_start?: string | null;
+    date_end?: string | null;
+}
+export interface FactsCalendarProps<T extends FactCalendarRow> {
+    facts: T[];
+    onSelect?: (fact: T) => void;
+    /** The fact currently open for editing: its bars are highlighted. */
+    selectedId?: string | null;
+    /** Host element the n / N fact navigator portals into (see TimelineCalendar). */
+    navigatorContainer?: HTMLElement | null;
+    /** Denominator for the navigator: the page's filtered fact count. */
+    navigatorTotal?: number;
+    /** Calendar test id; entries are `${testId}-entry-${factId}` (default `facts-calendar`). */
+    testId?: string;
+}
+/**
+ * Facts on the shared calendar. Maps a fact to a labelled span and hands the fact back on select,
+ * so packing, spanning bars and continuous scroll stay one implementation shared with every
+ * other timeline surface. Undated facts have nowhere to sit and are skipped.
+ */
+export declare function FactsCalendar<T extends FactCalendarRow>({ facts, onSelect, selectedId, navigatorContainer, navigatorTotal, testId, }: FactsCalendarProps<T>): import("react").JSX.Element;
+/**
+ * The Facts timeline. `.facts-gantt` scopes CSS that truncates row labels to one line and hides
+ * the built-in detail side panel: a fact's contents are seen and edited in the composer instead.
+ */
+export declare function FactsGanttPane({ testId, emptyMessage, labels, ...props }: TimelineGanttProps & {
+    labels?: Partial<FactTimelineLabels>;
+}): import("react").JSX.Element;

package/dist/facts/FactsBulkBar.d.ts

@@ -0,0 +1,53 @@
+import type { ReactNode } from 'react';
+export interface FactsBulkBarLabels {
+    unpin: string;
+    pin: string;
+    label: string;
+    shared: string;
+    more: string;
+    export: string;
+    delete: string;
+    budgetHint: string;
+    /** The `~{tokens}/{cap} tokens` line (numbers arrive formatted). */
+    budget: (tokens: string, cap: string) => string;
+    unpinTooltip: (pluralNoun: string) => string;
+    pinTooltip: (pluralNoun: string) => string;
+    labelTooltip: (pluralNoun: string) => string;
+}
+export declare const DEFAULT_FACTS_BULK_BAR_LABELS: FactsBulkBarLabels;
+export interface FactsBulkBarTestIds {
+    budget: string;
+    pin: string;
+    label: string;
+    more: string;
+    export: string;
+    delete: string;
+}
+export interface FactsBulkBarProps {
+    /** Number of selected facts. */
+    count: number;
+    onClear: () => void;
+    /** True when every selected fact is already pinned (the action then unpins). */
+    allSelectedPinned: boolean;
+    onTogglePin: () => void;
+    onLabel: () => void;
+    /** The aggregate Shared switch for the selection (the app binds its toggle). */
+    sharedToggle: ReactNode;
+    onExport: () => void;
+    onDelete: () => void;
+    /** Pinned-core token budget, shown at the left (reflects the whole workspace, not the selection). */
+    budget?: {
+        tokens: number;
+        cap: number;
+        isOver: boolean;
+    } | null;
+    /** Plural noun for tooltips (lower case). */
+    pluralNoun?: string;
+    labels?: Partial<FactsBulkBarLabels>;
+    testIds?: Partial<FactsBulkBarTestIds>;
+}
+/**
+ * Sticky bulk-action bar for the facts table: Pin, Label, Shared and a More menu (Export,
+ * Delete). Actions are disabled until something is selected.
+ */
+export declare function FactsBulkBar({ count, onClear, allSelectedPinned, onTogglePin, onLabel, sharedToggle, onExport, onDelete, budget, pluralNoun, labels, testIds, }: FactsBulkBarProps): import("react").JSX.Element;

package/dist/facts/FactsEmptyState.d.ts

@@ -0,0 +1,38 @@
+export interface FactsEmptyStateLabels {
+    title: string;
+    intro: string;
+    tryAdding: string;
+    /** Three kinds of durable knowledge a fact captures. */
+    kinds: {
+        label: string;
+        desc: string;
+    }[];
+    /** Starter fact texts offered as one-tap examples. */
+    examples: string[];
+    loading: string;
+    loadError: string;
+    retry: string;
+}
+export declare const DEFAULT_FACTS_EMPTY_STATE_LABELS: FactsEmptyStateLabels;
+export interface FactsEmptyStateTestIds {
+    root: string;
+    example: string;
+}
+export interface FactsEmptyStateProps {
+    /** Open the composer prefilled with an example. */
+    onUseExample: (text: string) => void;
+    labels?: Partial<FactsEmptyStateLabels>;
+    testIds?: Partial<FactsEmptyStateTestIds>;
+}
+/** First-run state: what facts are, the kinds they capture, and one-tap examples. */
+export declare function FactsEmptyState({ onUseExample, labels, testIds }: FactsEmptyStateProps): import("react").JSX.Element;
+/** Centered "Loading facts…" line. */
+export declare function FactsLoading({ label, }: {
+    label?: string;
+}): import("react").JSX.Element;
+/** Load-failure message with a retry action. */
+export declare function FactsLoadError({ onRetry, message, retryLabel, }: {
+    onRetry: () => void;
+    message?: string;
+    retryLabel?: string;
+}): import("react").JSX.Element;

package/dist/facts/FactsFieldsButton.d.ts

@@ -0,0 +1,21 @@
+import type { GridApi } from 'ag-grid-community';
+export interface FactsFieldsButtonLabels {
+    fields: string;
+    defaultView: string;
+    columns: string;
+    /** Names for icon-only columns, keyed by colId. */
+    columnNames: Record<string, string>;
+}
+export declare const DEFAULT_FACTS_FIELDS_BUTTON_LABELS: FactsFieldsButtonLabels;
+export interface FactsFieldsButtonTestIds {
+    trigger: string;
+    defaultView: string;
+    toggle: (colId: string) => string;
+}
+export interface FactsFieldsButtonProps<TData = unknown> {
+    /** The facts grid api (read lazily: the grid may not exist yet). */
+    getGridApi: () => GridApi<TData> | null | undefined;
+    labels?: Partial<FactsFieldsButtonLabels>;
+    testIds?: Partial<FactsFieldsButtonTestIds>;
+}
+export declare function FactsFieldsButton<TData = unknown>({ getGridApi, labels, testIds, }: FactsFieldsButtonProps<TData>): import("react").JSX.Element;

package/dist/facts/FactsFilterInput.d.ts

@@ -0,0 +1,46 @@
+/**
+ * FactsFilterInput
+ *
+ * The Facts table's "Filter…" box, styled to match the Documents table's filter
+ * bar: a muted input with a leading funnel icon and an appended settings button
+ * whose popover picks WHICH fields the text matches against (the fact text, its
+ * labels, or both). The page owns the query + field state; this is a view.
+ */
+import type { ReactNode } from 'react';
+export type FactsSearchField = 'text' | 'labels';
+export declare const FACTS_SEARCH_FIELD_OPTIONS: {
+    value: FactsSearchField;
+    label: string;
+}[];
+export interface FactsFilterInputLabels {
+    placeholder: string;
+    clear: string;
+    chooseFields: string;
+    fieldsHeading: string;
+    /** Display name per searchable field. */
+    fieldNames: Record<FactsSearchField, string>;
+}
+export declare const DEFAULT_FACTS_FILTER_INPUT_LABELS: FactsFilterInputLabels;
+export interface FactsFilterInputTestIds {
+    root: string;
+    quick: string;
+    input: string;
+    fieldsButton: string;
+    field: (field: FactsSearchField) => string;
+}
+export interface FactsFilterInputProps {
+    value: string;
+    onChange: (q: string) => void;
+    fields: FactsSearchField[];
+    onFieldsChange: (fields: FactsSearchField[]) => void;
+    /**
+     * The quick-filter dropdown trigger, embedded inside the input on the left
+     * (mirroring the Files search box). When absent, a static funnel icon shows.
+     */
+    filter?: ReactNode;
+    /** Width classes for the box (default `w-44`). */
+    className?: string;
+    labels?: Partial<FactsFilterInputLabels>;
+    testIds?: Partial<FactsFilterInputTestIds>;
+}
+export declare function FactsFilterInput({ value, onChange, fields, onFieldsChange, filter, className, labels, testIds, }: FactsFilterInputProps): import("react").JSX.Element;

package/dist/facts/FactsTable.d.ts

@@ -0,0 +1,28 @@
+import { type GridViewProps } from '../files/GridView';
+import { type FactColumnLabels, type FactRowView } from './factColumns';
+export interface FactsTableProps<T extends FactRowView> {
+    facts: T[];
+    onTogglePin: (fact: T) => void;
+    onToggleConfirmed: (fact: T) => void;
+    onToggleShared: (fact: T) => void;
+    /** The row menu appears when both `onEdit` and `onDelete` are provided. */
+    onEdit?: (fact: T) => void;
+    onDelete?: (fact: T) => void;
+    /** Row click (opens the fact). */
+    onOpen?: (fact: T) => void;
+    /** Display name of the fact's creator (sorting, filtering and the initials chip). */
+    getCreatorName?: (fact: T) => string;
+    /** Friendly display of an ISO timestamp. Defaults to the locale date. */
+    formatDate?: (iso: string) => string;
+    columnLabels?: Partial<FactColumnLabels>;
+    isLoading?: boolean;
+    /** Saved column state key (AG Grid persists by it). */
+    gridId?: string;
+    height?: GridViewProps<T>['height'];
+    rowHeight?: number;
+    /** Escape hatch for any other `GridView` prop. */
+    gridProps?: Partial<Omit<GridViewProps<T>, 'items' | 'columnDefs' | 'getItemId'>>;
+    testId?: string;
+}
+/** The default facts table: columns, cells and the grid in one component. */
+export declare function FactsTable<T extends FactRowView>({ facts, onTogglePin, onToggleConfirmed, onToggleShared, onEdit, onDelete, onOpen, getCreatorName, formatDate, columnLabels, isLoading, gridId, height, rowHeight, gridProps, testId, }: FactsTableProps<T>): import("react").JSX.Element;