@arbidocs/blocks 0.4.159 → 0.4.161

package/dist/connection/messenger/useMessengerRows.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The messenger's rows: one per chat (direct or group), newest activity first, then the people I
+ * can message but have no chat with yet.
+ *
+ * Row identity (`id`, also what `onOpen` receives) is the peer's `usr-`/`agt-` id for a direct
+ * chat — so "message this person" from anywhere lands on the same row — and the `cht-` id for a
+ * group or meeting chat. Only the last message of each chat is decrypted (`useChatSummaries`);
+ * the thread decrypts in full when it is opened.
+ */
+import { type DmUser } from '@arbidocs/react';
+import type { MessengerRow } from './types';
+/** A group's name when it has no title: its other members' first names. */
+export declare function groupFallbackName(others: DmUser[]): string;
+export declare function useMessengerRows(people: DmUser[]): {
+    rows: MessengerRow[];
+    isLoading: boolean;
+    /** The row for an id (`usr-`/`agt-` peer or `cht-` chat). */
+    findRow: (id: string | null) => MessengerRow | null;
+};

package/dist/connection/tags/ConnectedTagsPage.d.ts

@@ -1,39 +1,8 @@
-/**
- * The Tags page: every tag of the open workspace, by kind — labels, annotations, issues, people,
- * organisations and saved searches — and everything tagged with each one.
- *
- * The tab header has a button per kind and the filter box with its filter menu, which only filters
- * what is shown: tags included or excluded, whichever kind they are, narrow every view to the
- * items they let through (`TagFilterChips` lists them). In the main area a search-and-create picker
- * (`TagPicker`) opens a tag of the open kind or creates one. A kind shows all its tags as a table
- * (their kind's fields as columns, and the items tagged with each); a tag shows its fields,
- * editable in place, and every document (with the tag's note there and the passages it cites),
- * fact and thread tagged with it, plus its sub-tags. Tags are moved, shared and deleted here;
- * people and organisations can be extracted from documents.
- *
- * Data comes from `@arbidocs/react` (the open workspace's tags, tables, kinds, facts) and the
- * connected workspace lists (`useConnectedDocuments`, `useConnectedConversations`: a host that keeps
- * them itself gives them once through `ConnectedWorkspaceDataProvider`). What belongs to other
- * parts of the host — the AI review, Smart Search, the tag editor form, opening a fact — comes in
- * as callbacks and a render slot.
- */
-import { type ReactNode } from 'react';
-import { type TagKind, type TagResponse } from '@arbidocs/sdk/browser';
+import { type TagKind } from '@arbidocs/sdk/browser';
 /** The kinds the AI review fills across the documents. */
 export type TagsReviewKind = Extract<TagKind, 'label' | 'annotation' | 'issue'>;
 /** What the tag editor is given: the tag to edit, and what to do once a new one is made. */
-export interface TagEditorSlotProps {
-    open: boolean;
-    onOpenChange: (open: boolean) => void;
-    tag: TagResponse | undefined;
-    /** The workspace's tags (saved searches aside): what a tag can be nested under. */
-    tags: TagResponse[];
-    /** A new tag was made: open it. */
-    onCreated: (tagId: string) => void;
-}
 export interface ConnectedTagsPageProps {
-    /** Documents whose people and organisations are still being extracted. */
-    extractingDocIds?: readonly string[];
     /** Open a fact. Absent: facts are listed, not opened. */
     onOpenFact?: (factId: string) => void;
     /** Open Smart Search: the saved searches' action. Absent: none. */
@@ -49,7 +18,5 @@ export interface ConnectedTagsPageProps {
             name: string;
         };
     }) => void;
-    /** The tag editor (a dialog). Absent: tags are not edited here. */
-    renderTagEditor?: (props: TagEditorSlotProps) => ReactNode;
 }
-export declare function ConnectedTagsPage({ extractingDocIds, onOpenFact, onOpenSmartSearch, onReview, renderTagEditor, }: ConnectedTagsPageProps): import("react").JSX.Element;
+export declare function ConnectedTagsPage({ onOpenFact, onOpenSmartSearch, onReview, }: ConnectedTagsPageProps): import("react").JSX.Element;

package/dist/connection/viewer/ConnectedDocumentToolsProvider.d.ts

@@ -2,10 +2,27 @@
  * The PDF document tools (markup, Freeze, signing, signature requests, productions) on the
  * signed-in session, for any host: the API client, the signed-in user, the host's notices and
  * document opening (`BlocksEnvironment`), and the shared caches a change refreshes. A host with its
- * own binding (its own lists to refresh, an XHR upload with progress, Mail) keeps it: an enclosing
- * `DocumentToolsProvider` wins.
+ * own binding (its own lists to refresh, an XHR upload with progress, Mail) gives it as the host
+ * configuration's `documentTools`, field by field. An enclosing `DocumentToolsProvider` (a dialog
+ * with its own client) wins.
  */
 import { type ReactNode } from 'react';
+import { type DocumentToolsClient, type DocumentToolsEnvironment } from '@arbidocs/react/document-tools';
+/** What a host binds of the document tools itself; each absent field is the kit's own. */
+export interface DocumentToolsHost {
+    /** The API client the tools call. Default: the host `arbi`'s. */
+    client?: DocumentToolsClient;
+    /** The deployment domain keys are derived for (signing). Default: the host `arbi`'s. */
+    deploymentDomain?: string;
+    /** Open a document or a version the tools made. Default: the environment's `openDocument`. */
+    openDocument?: (documentRef: string) => void;
+    /** Refresh the host's lists after a change. Default: the shared document caches. */
+    onDocumentsChanged?: DocumentToolsEnvironment['onDocumentsChanged'];
+    /** Upload a derived copy. Default: through the API client, into the open workspace. */
+    uploadDocument?: DocumentToolsEnvironment['uploadDocument'];
+    /** Email a document (a hook): absent, or returning nothing, when mail is not offered. */
+    useEmailDocument?: () => ((documentRef: string) => void) | undefined;
+}
 export declare function ConnectedDocumentToolsProvider({ children }: {
     children: ReactNode;
 }): import("react").JSX.Element;

package/dist/connection/viewer/ConnectedDocumentViewer.d.ts

@@ -4,7 +4,7 @@
  * its versions and comparisons; markup, signing and signature requests; sharing, Email, Translate
  * and Finalise. Runs under any host (`useConnectedWorkspace`): the open document, tab and comparison
  * are the session state's, navigation the `BlocksEnvironment`'s, and what only the host knows comes
- * through `DocumentViewerSupportProvider`.
+ * as its host config's `viewer`.
  */
 import { type ReactNode } from 'react';
 export interface ConnectedDocumentViewerProps {

package/dist/connection/viewer/support.d.ts

@@ -3,10 +3,11 @@
  * markup and signatures on the signed-in session by itself; these are the host's own things it
  * cannot know: documents the host makes on the client (an artifact streaming in from a chat, an
  * unsaved draft), the host's dialogs and workflows a document action opens, and how the host lays
- * the viewer out. Every field is optional: without one the viewer offers less (no Translate button,
- * no draft controls), never something that does nothing.
+ * the viewer out. It is the host configuration's `viewer`. Every field is optional: without one the
+ * viewer offers less (no Translate button, no draft controls), never something that does nothing.
+ * What changes while the viewer is open is read through hooks (`use…`).
  */
-import { type ReactNode } from 'react';
+import type { ReactNode } from 'react';
 import type { components } from '@arbidocs/client';
 /** A document's record, as the viewer reads it. */
 export type ViewerDocumentRecord = components['schemas']['DocResponse'];
@@ -27,10 +28,10 @@ export interface ViewerDraftDocument {
     content?: string | null;
 }
 export interface DocumentViewerSupport {
-    /** Artifacts streaming in, by document id. */
-    streamingDocuments?: Readonly<Record<string, ViewerStreamingDocument>>;
-    /** Unsaved drafts, by their client id. */
-    draftDocuments?: Readonly<Record<string, ViewerDraftDocument>>;
+    /** The artifact streaming in as this document, if one is (a hook). */
+    useStreamingDocument?: (documentId: string) => ViewerStreamingDocument | undefined;
+    /** The unsaved draft with this client id, if there is one (a hook). */
+    useDraftDocument?: (draftId: string) => ViewerDraftDocument | undefined;
     /** A draft's kind (text, photo, audio, video), in place of the tabs. */
     renderDraftKind?: (draftId: string) => ReactNode;
     /** A draft's name (editable), in place of the title. */
@@ -59,17 +60,18 @@ export interface DocumentViewerSupport {
     useImageAsReference?: (documentId: string) => void;
     /**
      * A citation being edited elsewhere (a fact's sources, a field's) picks its passages in the text
-     * view: clicks and selections there are handed to it. Absent: passages are not pickable.
+     * view: clicks and selections there are handed to it (a hook). Absent: passages are not pickable.
      */
-    passageCitation?: PassageCitation;
+    usePassageCitation?: () => PassageCitation | undefined;
     /** Open the document's passages in the host's navigator (a passage's menu). Absent: not offered. */
     openInNavigator?: (documentId: string) => void;
     /** Start a new label or field in the host's editor (the passage tagging panel). Absent: not offered. */
     createTag?: () => void;
     /** How dates read (versions, signatures). Default: `fmtDate`. */
     formatDate?: (iso: string) => string;
-    /** The viewer is shown in another window: PDF pages render without the page's web fonts. */
-    isDetached?: boolean;
+    /** Whether the viewer is shown in another window, where PDF pages render without the page's web
+     *  fonts (a hook). */
+    useIsDetached?: () => boolean;
 }
 /** A passage picked for a citation: its chunk and, when known, its page. */
 export interface PickedPassage {
@@ -90,8 +92,12 @@ export interface PassageCitation {
     /** Passages taken off it. */
     unpick: (chunkIds: string[]) => void;
 }
-export declare function DocumentViewerSupportProvider({ value, children, }: {
-    value: DocumentViewerSupport;
-    children: ReactNode;
-}): import("react").JSX.Element;
 export declare function useDocumentViewerSupport(): DocumentViewerSupport;
+/** The artifact streaming in as this document (none without the host's). */
+export declare function useViewerStreamingDocument(documentId: string): ViewerStreamingDocument | undefined;
+/** The unsaved draft with this id (none without the host's). */
+export declare function useViewerDraftDocument(draftId: string): ViewerDraftDocument | undefined;
+/** The citation picking passages (none without the host's). */
+export declare function useViewerPassageCitation(): PassageCitation | undefined;
+/** Whether the viewer is in another window (never without the host's). */
+export declare function useViewerIsDetached(): boolean;

package/dist/connection/workspaceData.d.ts

@@ -2,10 +2,10 @@
  * The open workspace's documents, tags and conversations for the connected kits. Each kit reads them
  * through the `@arbidocs/react` hooks; the documents always come from `useDocuments` (read once,
  * progressively, then patched in place by every write and event, so a kit never re-reads it). A
- * host that already keeps tags or conversations live in its own cache passes them once through
- * `ConnectedWorkspaceDataProvider`, so the kits show the same list and nothing is fetched twice.
+ * host that already keeps tags or conversations live in its own cache gives them once, as hooks in
+ * the host configuration's `workspaceData`, so the kits show the same list and nothing is fetched
+ * twice.
  */
-import { type ReactNode } from 'react';
 import { useConversations, useDocuments, useTags } from '@arbidocs/react';
 export type ConnectedDocument = NonNullable<ReturnType<typeof useDocuments>['data']>[number];
 export type ConnectedTag = NonNullable<ReturnType<typeof useTags>['data']>[number];
@@ -19,13 +19,11 @@ export interface ConnectedList<T> {
     isFetched: boolean;
     refetch?: () => unknown;
 }
+/** The lists a host keeps live for the open workspace, as hooks (each fixed for the host's life). */
 export interface ConnectedWorkspaceData {
-    tags?: ConnectedList<ConnectedTag>;
-    conversations?: ConnectedList<ConnectedConversation>;
+    useTags?: () => ConnectedList<ConnectedTag>;
+    useConversations?: () => ConnectedList<ConnectedConversation>;
 }
-export declare function ConnectedWorkspaceDataProvider({ tags, conversations, children, }: ConnectedWorkspaceData & {
-    children: ReactNode;
-}): import("react").JSX.Element;
 export interface ConnectedListResult<T> {
     data: T[];
     loaded: boolean;
@@ -43,3 +41,131 @@ export declare function useConnectedTags(): ConnectedListResult<ConnectedTag>;
 export declare function useConnectedConversations(options?: {
     live?: boolean;
 }): ConnectedListResult<ConnectedConversation>;
+/**
+ * Run a workflow now (`useRunWorkflow`). The task it starts joins the workspace's conversations:
+ * the package's lists follow by themselves, and the host's own list (`workspaceData`) is read
+ * again once the run is accepted.
+ */
+export declare function useConnectedRunWorkflow(): {
+    mutateAsync: (workflowId: string) => Promise<{
+        execution_id?: number | null;
+        action_type?: string | null;
+        conversation_ext_id?: string | null;
+        started: boolean;
+        error?: string | null;
+    }>;
+    data: undefined;
+    variables: undefined;
+    error: null;
+    isError: false;
+    isIdle: true;
+    isPending: false;
+    isSuccess: false;
+    status: "idle";
+    mutate: import("@tanstack/react-query").UseMutateFunction<{
+        execution_id?: number | null;
+        action_type?: string | null;
+        conversation_ext_id?: string | null;
+        started: boolean;
+        error?: string | null;
+    }, Error, string, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+} | {
+    mutateAsync: (workflowId: string) => Promise<{
+        execution_id?: number | null;
+        action_type?: string | null;
+        conversation_ext_id?: string | null;
+        started: boolean;
+        error?: string | null;
+    }>;
+    data: undefined;
+    variables: string;
+    error: null;
+    isError: false;
+    isIdle: false;
+    isPending: true;
+    isSuccess: false;
+    status: "pending";
+    mutate: import("@tanstack/react-query").UseMutateFunction<{
+        execution_id?: number | null;
+        action_type?: string | null;
+        conversation_ext_id?: string | null;
+        started: boolean;
+        error?: string | null;
+    }, Error, string, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+} | {
+    mutateAsync: (workflowId: string) => Promise<{
+        execution_id?: number | null;
+        action_type?: string | null;
+        conversation_ext_id?: string | null;
+        started: boolean;
+        error?: string | null;
+    }>;
+    data: undefined;
+    error: Error;
+    variables: string;
+    isError: true;
+    isIdle: false;
+    isPending: false;
+    isSuccess: false;
+    status: "error";
+    mutate: import("@tanstack/react-query").UseMutateFunction<{
+        execution_id?: number | null;
+        action_type?: string | null;
+        conversation_ext_id?: string | null;
+        started: boolean;
+        error?: string | null;
+    }, Error, string, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+} | {
+    mutateAsync: (workflowId: string) => Promise<{
+        execution_id?: number | null;
+        action_type?: string | null;
+        conversation_ext_id?: string | null;
+        started: boolean;
+        error?: string | null;
+    }>;
+    data: {
+        execution_id?: number | null;
+        action_type?: string | null;
+        conversation_ext_id?: string | null;
+        started: boolean;
+        error?: string | null;
+    };
+    error: null;
+    variables: string;
+    isError: false;
+    isIdle: false;
+    isPending: false;
+    isSuccess: true;
+    status: "success";
+    mutate: import("@tanstack/react-query").UseMutateFunction<{
+        execution_id?: number | null;
+        action_type?: string | null;
+        conversation_ext_id?: string | null;
+        started: boolean;
+        error?: string | null;
+    }, Error, string, unknown>;
+    reset: () => void;
+    context: unknown;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+};

package/dist/facts/index.cjs

@@ -4,7 +4,7 @@
 var chunkB3FMUFAW_cjs = require('../chunk-B3FMUFAW.cjs');
 require('../chunk-2WLXQGWC.cjs');
 var chunk5FYU7ZIU_cjs = require('../chunk-5FYU7ZIU.cjs');
-var chunk4RPBUMHB_cjs = require('../chunk-4RPBUMHB.cjs');
+var chunkKMZO5W6D_cjs = require('../chunk-KMZO5W6D.cjs');
 require('../chunk-VPPX5XUF.cjs');
 var chunkRC25WMVB_cjs = require('../chunk-RC25WMVB.cjs');
 require('../chunk-V4ISCZJ7.cjs');
@@ -15,7 +15,7 @@ require('../chunk-7RGLTF76.cjs');
 require('../chunk-FX3K6LNZ.cjs');
 require('../chunk-PPCATBOY.cjs');
 var chunkMHVNT4J3_cjs = require('../chunk-MHVNT4J3.cjs');
-require('../chunk-CNHUJRQ4.cjs');
+require('../chunk-EFEFLBRM.cjs');
 require('../chunk-ULWRNGGE.cjs');
 var chunkKDG6FER6_cjs = require('../chunk-KDG6FER6.cjs');
 require('../chunk-DES3K4SD.cjs');
@@ -330,7 +330,7 @@ function FactSearchResult({
       }
     ),
     /* @__PURE__ */ jsxRuntime.jsx(
-      chunk4RPBUMHB_cjs.SearchHit,
+      chunkKMZO5W6D_cjs.SearchHit,
       {
         className: "min-w-0 flex-1",
         testId: chunkMHVNT4J3_cjs.testIdOr(testIds?.hit?.(id), { testId: `facts-smart-search-hit-${id}` }),

package/dist/facts/index.js

@@ -3,7 +3,7 @@ import { DEFAULT_FACT_COLUMN_LABELS, createFactColumns, FactRowActions } from '.
 export { DEFAULT_FACTS_BULK_BAR_LABELS, DEFAULT_FACTS_EMPTY_STATE_LABELS, DEFAULT_FACTS_FIELDS_BUTTON_LABELS, DEFAULT_FACTS_TOOLBAR_LABELS, DEFAULT_FACTS_VIEW_TOGGLE_LABELS, DEFAULT_FACT_COLUMN_LABELS, DEFAULT_FACT_COLUMN_ORDER, DEFAULT_FACT_COMPOSER_LABELS, DEFAULT_FACT_DATE_INPUT_LABELS, DEFAULT_FACT_LABELS_CELL_LABELS, DEFAULT_FACT_ROW_ACTIONS_LABELS, DEFAULT_FACT_SOURCES_ROW_LABELS, DEFAULT_FACT_SOURCE_GROUP_LABELS, DEFAULT_FACT_TIMELINE_LABELS, EMPTY_FACT_DATE_FIELDS, FactComposer, FactDateInput, FactFieldRow, FactLabelsCell, FactRowActions, FactSourceGroup, FactSourcesRow, FactsBulkBar, FactsCalendar, FactsEmptyState, FactsFieldsButton, FactsGanttPane, FactsLoadError, FactsLoading, FactsToolbar, FactsViewToggle, ISO_DATE_FILTER_PARAMS, buildFactCitations, chunkIdsOf, citedVersionRef, createFactColumns, docIdsOf, enableFactTableColumnResize, factDateFieldsToSpan, factDateSpanToFields, hasChunk, isWholeDoc, sourceDocCount, toFactCitations, withChunk, withDoc, withoutChunk, withoutDoc } from '../chunk-WU34CHU5.js';
 import '../chunk-JJA6GQKH.js';
 export { DEFAULT_FACT_PASSAGES_LABELS, FactPassageItem, FactSourcesPanel, renderPreviewInline, toPreviewLine } from '../chunk-HFZ45FD3.js';
-import { SearchHit } from '../chunk-DEPF5LQI.js';
+import { SearchHit } from '../chunk-OKRYNQPH.js';
 import '../chunk-4EZVCGRL.js';
 export { decodeWhitespaceEntities } from '../chunk-AF6RDAJF.js';
 import '../chunk-NUNKSZKU.js';
@@ -14,7 +14,7 @@ import '../chunk-4WWM3GQ5.js';
 import '../chunk-SLSBJRWW.js';
 import '../chunk-NPLYHR2E.js';
 import { testIdOr } from '../chunk-7F6CBP3Z.js';
-import '../chunk-F57LNUSZ.js';
+import '../chunk-5NWY3FXQ.js';
 import '../chunk-TX2ZICS7.js';
 import { initials } from '../chunk-OXF2IFXG.js';
 import '../chunk-VUNV25KB.js';

package/dist/files/bulk/BulkActionsBar.d.ts

@@ -42,9 +42,12 @@ export interface BulkActionsBarProps {
     isMember: boolean;
     /** Online-only actions (export, reprocess, enabling offline) are disabled while offline. */
     isOnline: boolean;
-    onChat: () => void;
-    onAnnotate: () => void;
-    onLabel: () => void;
+    /** Chat about the selection. Absent: not offered. */
+    onChat?: () => void;
+    /** Fill AI fields on the selection. Absent: not offered. */
+    onAnnotate?: () => void;
+    /** Label the selection. Absent: not offered. */
+    onLabel?: () => void;
     onMoveToFolder: () => void;
     onExport: () => void;
     /** Opens the production-set (Bates numbering) flow; the menu item is hidden when omitted. */
@@ -52,9 +55,10 @@ export interface BulkActionsBarProps {
     onReprocess: () => void;
     /** Label of the reprocess item (the app adds the "(max N)" cap hint). */
     reprocessLabel?: string;
-    onToggleOffline: () => void;
+    /** Keep the selection on this device (or stop). Absent: not offered. */
+    onToggleOffline?: () => void;
     /** All selected docs are already available offline: the item removes them instead. */
-    isAllOffline: boolean;
+    isAllOffline?: boolean;
     isOfflinePending?: boolean;
     onDelete: () => void;
     /** Visibility of the selection (all shared, none shared, or a mix). */

package/dist/files/cells/DocumentNameCell.d.ts

@@ -3,8 +3,10 @@ export interface DocumentRowMenuProps {
     /** Whether the user may rename / move / delete this document. */
     canEdit: boolean;
     onOpen: () => void;
-    onReview: () => void;
-    onDocumentChat: () => void;
+    /** Open in the review view. Absent: not offered. */
+    onReview?: () => void;
+    /** Start a chat about the document. Absent: not offered. */
+    onDocumentChat?: () => void;
     onRename: () => void;
     onDownload: () => void;
     /** "Download with markup": shown when the document's current version has markup. */

package/dist/files/cells/MultiSelectCellEditor.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AG Grid Cell Editor for Multi-Select
+ *
+ * Custom cell editor that displays a Command-based multi-select UI directly.
+ * Uses AG Grid's cellEditorPopup for positioning - no internal Popover needed.
+ * Values are stored as semicolon-separated strings (e.g., "Option1;Option2").
+ */
+import { CustomCellEditorProps } from 'ag-grid-react';
+export interface MultiSelectCellEditorParams {
+    /** Available options for selection */
+    values: string[];
+}
+export declare const MultiSelectCellEditor: import("react").MemoExoticComponent<(props: CustomCellEditorProps & MultiSelectCellEditorParams) => import("react").JSX.Element>;

package/dist/files/cells/RelatedDocsCell.d.ts

@@ -18,7 +18,8 @@ export interface RelatedDocsCellProps<T> {
     /** "Switch to": open the doc in the viewer. */
     onSwitchTo: (doc: T) => void;
     onDelete: (doc: T) => void;
-    onCompare: (doc: T) => void;
+    /** Compare with a similar document. Absent: not offered. */
+    onCompare?: (doc: T) => void;
     className?: string;
 }
 /**

package/dist/files/cells/index.d.ts

@@ -5,3 +5,4 @@ export { CellHoverIcon, HoverIconCell, type CellHoverIconKind, type HoverIconCel
 export { LabelMultiSelectView, LabelPickerList, labelChipClampHeight, DEFAULT_LABEL_MULTI_SELECT_LABELS, type LabelMultiSelectViewProps, type LabelPickerListProps, type LabelMultiSelectLabels, type LabelOption, } from './LabelMultiSelect';
 export { CheckboxCell, TagColumnHeader, type CheckboxCellProps, type TagColumnHeaderProps, } from './TagColumnParts';
 export { BulkLabelSelectView } from './BulkLabelSelect';
+export { MultiSelectCellEditor, type MultiSelectCellEditorParams } from './MultiSelectCellEditor';

package/dist/files/documentColumns.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The documents table's columns as data: the ones a new user sees (and their order), the built-in
+ * email view's, and the document types the Type column offers.
+ */
+/** Visible columns, left to right, before any view is saved (or after a reset). */
+export declare const DEFAULT_DOCUMENT_COLUMNS: readonly string[];
+/** The built-in email view's columns: Date, From, Title, Folder, Related, Labels, Abstract, Status. */
+export declare const EMAIL_VIEW_COLUMNS: readonly string[];
+/** The document types the AI assigns and the Type column offers (the server's own list). */
+export declare const DOCUMENT_TYPE_OPTIONS: readonly ["Agreement", "Email", "Letter", "Report", "Decision", "Memo", "Financial", "Form", "Index", "Submission", "Other"];
+export type DocumentType = (typeof DOCUMENT_TYPE_OPTIONS)[number];
+/** The documents table's row height at the built-in views (the compact minimum). */
+export declare const DOCUMENTS_ROW_HEIGHT_INITIAL = 28;
+/** The row height the "Default" density means. */
+export declare const DOCUMENTS_ROW_HEIGHT_DEFAULT = 52;

package/dist/files/folders/DocumentsFolderButton.d.ts

@@ -0,0 +1,26 @@
+/**
+ * DocumentsFolderButton
+ *
+ * The folder-tree filter control: a ghost button showing the active folder,
+ * opening a popover with the "All" row + the full folder tree picker (and an
+ * optional "New folder" action). Extracted from DocumentsFilterBar so it can be
+ * reused wherever the shared 'documents' folder filter should be adjustable —
+ * e.g. above the Smart Search search bar as well as in the filter toolbar.
+ *
+ * It reads/writes the same `documentFilters` map every consumer shares, so the
+ * selected folder scopes the document list and the Smart Search query alike.
+ */
+import { type FolderTreePickerProps } from './FolderTreePicker';
+type Doc = FolderTreePickerProps['docs'][number];
+type FilterState = 'include' | 'exclude' | null;
+/** A filter id of the documents list (`folder:<path>` for folders, `folder:none` for unfiled). */
+type DocumentFilterId = string;
+export interface DocumentsFolderButtonProps {
+    documents: Doc[];
+    documentFilters: Map<DocumentFilterId, FilterState>;
+    onFiltersChange: (filters: Map<DocumentFilterId, FilterState>) => void;
+    /** When set, the folder dropdown offers a "New folder" action that calls this. */
+    onNewFolder?: () => void;
+}
+export declare function DocumentsFolderButton({ documents, documentFilters, onFiltersChange, onNewFolder, }: DocumentsFolderButtonProps): import("react").JSX.Element;
+export {};

package/dist/files/folders/FolderTreePicker.d.ts

@@ -0,0 +1,16 @@
+/**
+ * FolderTreePicker: binds the `FolderTree` block to documents. Builds the hierarchy from each
+ * document's folder and gives connector (provider) roots their brand mark and shortened label.
+ * Shared by the filter bar popover and MoveToFolderModal.
+ */
+import { buildFolderTree } from '@arbidocs/react/ui';
+type Doc = Parameters<typeof buildFolderTree>[0][number];
+export interface FolderTreePickerProps {
+    docs: Doc[];
+    /** string = folder path selected, null = Unfiled selected, undefined = nothing selected. */
+    value: string | null | undefined;
+    onChange: (folder: string | null) => void;
+    showUnfiledAlways?: boolean;
+}
+export declare function FolderTreePicker({ docs, value, onChange, showUnfiledAlways, }: FolderTreePickerProps): import("react").JSX.Element;
+export {};

package/dist/files/folders/index.d.ts

@@ -1,2 +1,4 @@
 export { getExplorerDisplayName, parseFolderSegments, joinFolderPath, isExplorerDocument, collectFolderDocs, sortExplorerFiles, buildExplorerEntries, searchExplorerDocuments, type FolderDocument, type ExplorerFolder, type ExplorerFile, type ExplorerEntry, type ExplorerSort, } from './folderPaths';
 export { FolderProviderIcon, hasFolderProviderIcon, formatFolderSegment, } from './FolderProviderIcon';
+export { FolderTreePicker, type FolderTreePickerProps } from './FolderTreePicker';
+export { DocumentsFolderButton, type DocumentsFolderButtonProps } from './DocumentsFolderButton';