@arbidocs/blocks 0.4.153 → 0.4.155

package/dist/connection/workspace-list/useConnectedWorkspaceList.d.ts

@@ -0,0 +1,251 @@
+import type { TriState } from '../../settings/TriStateFilterMenu';
+/** The persisted form of the filters: filter id → include / exclude (absent or null: off). */
+export type WorkspaceListFilters = Record<string, TriState>;
+export interface WorkspaceListLabels {
+    /** After a delete: where deleted workspaces can be restored from. */
+    recentlyDeletedHint: (count: number) => string;
+}
+export declare const DEFAULT_WORKSPACE_LIST_LABELS: WorkspaceListLabels;
+export interface UseConnectedWorkspaceListOptions {
+    /** Controlled filters (a host that keeps them across visits); local state otherwise. */
+    filters?: WorkspaceListFilters;
+    onFiltersChange?: (filters: WorkspaceListFilters) => void;
+    labels?: Partial<WorkspaceListLabels>;
+}
+export declare function useConnectedWorkspaceList({ filters: controlledFilters, onFiltersChange, labels, }?: UseConnectedWorkspaceListOptions): {
+    selfId: string | undefined;
+    /** Every listed workspace (unfiltered): the filter menu's counts. */
+    workspaces: {
+        external_id: string;
+        name: string;
+        description: string | null;
+        is_public: boolean;
+        workspace_type: import("@arbidocs/client").components["schemas"]["WorkspaceType"];
+        created_by_ext_id: string;
+        updated_by_ext_id?: string | null | undefined;
+        created_at: string;
+        updated_at: string;
+        wrapped_key?: string | null | undefined;
+        is_member: boolean;
+        shared_conversation_count: number;
+        private_conversation_count: number;
+        shared_document_count: number;
+        private_document_count: number;
+        user_files_mb: number;
+        users: {
+            user: {
+                external_id: string;
+                parent_ext_id?: string | null | undefined;
+                email: string;
+                given_name: string;
+                family_name?: string | null | undefined;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+                is_sso: boolean;
+                is_identity_verified: boolean;
+            };
+            role: import("@arbidocs/client").components["schemas"]["WorkspaceRole"];
+            joined_at: string;
+            conversation_count: number;
+            document_count: number;
+            files_mb: number;
+            agent_ext_id?: string | null | undefined;
+            is_temporary: boolean;
+        }[];
+        project_ext_id?: string | null | undefined;
+        project_name?: string | null | undefined;
+        project_subscription?: string | null | undefined;
+        project_owner_ext_id?: string | null | undefined;
+        house_template_ext_id?: string | null | undefined;
+        archive?: {
+            status: "archiving" | "archived" | "restoring";
+            archived_at: string;
+            documents_done: number;
+            documents_total: number;
+        } | null | undefined;
+    }[];
+    projects: NoInfer<{
+        external_id: string;
+        name: string;
+        created_by: string;
+        subscription: string;
+        created_at: string;
+        quotas: {
+            storage_gb: {
+                used: number;
+                limit: number;
+            };
+            ai_usage: {
+                used: number;
+                limit: number;
+            };
+            collaborators: {
+                used: number;
+                limit: number;
+            };
+            budget_reset_at?: number | null | undefined;
+        };
+        daily_cap_per_user?: number | null | undefined;
+        budget?: {
+            amount: number;
+            currency: string;
+        } | null | undefined;
+        client?: string | null | undefined;
+        client_ref?: string | null | undefined;
+        stage?: string | null | undefined;
+        stage_changed_at?: string | null | undefined;
+        lead_user?: string | null | undefined;
+        fields?: {
+            [x: string]: unknown;
+        } | undefined;
+        field_schema?: {
+            key: string;
+            label?: string | null | undefined;
+            type: "text" | "number" | "date" | "checkbox" | "select" | "person" | "document" | "relation" | "lookup" | "rollup" | "tag";
+            options?: string[] | null | undefined;
+        }[] | null | undefined;
+        plan_interval?: ("month" | "year") | null | undefined;
+        packs: number;
+        plan_change?: {
+            result: "upgraded" | "scheduled" | "unchanged" | "requires_action";
+            charged_pence: number;
+            charged_ex_vat_pence: number;
+            confirm_url?: string | null | undefined;
+        } | null | undefined;
+        addons?: {
+            packs: number;
+            packs_next?: number | null | undefined;
+            plan_name: string;
+            plan_ai_gbp: number;
+            plan_storage_gb: number;
+            block_ai_gbp: number;
+            block_storage_gb: number;
+            ai_blocks: number;
+            storage_blocks: number;
+            legacy_ai_blocks: number;
+            legacy_storage_blocks: number;
+            legacy_block_ai_gbp: number;
+            legacy_block_storage_gb: number;
+            blocks_ai_gbp: number;
+            blocks_storage_gb: number;
+            ai_blocks_next?: number | null | undefined;
+            storage_blocks_next?: number | null | undefined;
+            storage_blocks_min: number;
+            auto_topup_threshold_gbp: number;
+            min_auto_topup_threshold_gbp: number;
+            spend_cap_pence?: number | null | undefined;
+            addon_spend_pence: number;
+            auto_spent_pence: number;
+            addon_spend_window_end?: number | null | undefined;
+            manual_spent_pence: number;
+            cap_left_pence?: number | null | undefined;
+            ai_used_gbp: number;
+            ai_allowance_gbp: number;
+            ai_allowance_next_gbp: number;
+            storage_used_gb: number;
+            storage_allowance_gb: number;
+            storage_allowance_next_gb: number;
+            ai_block_monthly_pence: number;
+            ai_block_monthly_ex_vat_pence: number;
+            storage_block_monthly_pence: number;
+            storage_block_monthly_ex_vat_pence: number;
+            ai_block_period_pence: number;
+            ai_block_period_ex_vat_pence: number;
+            storage_block_period_pence: number;
+            storage_block_period_ex_vat_pence: number;
+            ai_block_price_pence: number;
+            ai_block_price_ex_vat_pence: number;
+            storage_block_price_pence: number;
+            storage_block_price_ex_vat_pence: number;
+            cap_reached: boolean;
+            period_end?: number | null | undefined;
+            ai_usage_reset_at?: number | null | undefined;
+            pending_interval?: ("month" | "year") | null | undefined;
+            billing_error?: string | null | undefined;
+            confirm_url?: string | null | undefined;
+            payment?: {
+                status: "pending" | "paid";
+                kind?: ("ai_usage" | "storage") | null | undefined;
+                amount_pence?: number | null | undefined;
+                amount_ex_vat_pence?: number | null | undefined;
+                tax_pence?: number | null | undefined;
+                at?: number | null | undefined;
+                confirm_url?: string | null | undefined;
+            } | null | undefined;
+        } | null | undefined;
+        price_id?: string | null | undefined;
+        plan?: string | null | undefined;
+        amount?: number | null | undefined;
+        amount_ex_vat?: number | null | undefined;
+        currency?: string | null | undefined;
+        current_period_end?: number | null | undefined;
+        cancel_at_period_end?: boolean | null | undefined;
+        portal_url?: string | null | undefined;
+    }[]>;
+    pinned: Set<string>;
+    /** The filtered workspaces grouped by project, in list order. */
+    groups: import("../../workspaces").WorkspaceProjectGroup[];
+    /** How many workspaces the filters let through. */
+    shownCount: number;
+    isLoading: boolean;
+    error: Error | null;
+    canCreateProjects: boolean | undefined;
+    filters: Map<string, TriState>;
+    setFilters: (next: Map<string, TriState>) => void;
+    isCollapsed: (key: string) => boolean;
+    toggleGroup: (key: string) => void;
+    selected: {
+        external_id: string;
+        name: string;
+        description: string | null;
+        is_public: boolean;
+        workspace_type: import("@arbidocs/client").components["schemas"]["WorkspaceType"];
+        created_by_ext_id: string;
+        updated_by_ext_id?: string | null;
+        created_at: string;
+        updated_at: string;
+        wrapped_key?: string | null;
+        is_member: boolean;
+        shared_conversation_count: number;
+        private_conversation_count: number;
+        shared_document_count: number;
+        private_document_count: number;
+        user_files_mb: number;
+        users: import("@arbidocs/client").components["schemas"]["WorkspaceUserResponse"][];
+        project_ext_id?: string | null;
+        project_name?: string | null;
+        project_subscription?: string | null;
+        project_owner_ext_id?: string | null;
+        house_template_ext_id?: string | null;
+        archive?: import("@arbidocs/client").components["schemas"]["WorkspaceArchiveState"] | null;
+    }[];
+    setSelected: import("react").Dispatch<import("react").SetStateAction<{
+        external_id: string;
+        name: string;
+        description: string | null;
+        is_public: boolean;
+        workspace_type: import("@arbidocs/client").components["schemas"]["WorkspaceType"];
+        created_by_ext_id: string;
+        updated_by_ext_id?: string | null;
+        created_at: string;
+        updated_at: string;
+        wrapped_key?: string | null;
+        is_member: boolean;
+        shared_conversation_count: number;
+        private_conversation_count: number;
+        shared_document_count: number;
+        private_document_count: number;
+        user_files_mb: number;
+        users: import("@arbidocs/client").components["schemas"]["WorkspaceUserResponse"][];
+        project_ext_id?: string | null;
+        project_name?: string | null;
+        project_subscription?: string | null;
+        project_owner_ext_id?: string | null;
+        house_template_ext_id?: string | null;
+        archive?: import("@arbidocs/client").components["schemas"]["WorkspaceArchiveState"] | null;
+    }[]>>;
+    canDeleteSelected: boolean;
+    deleteSelected: () => Promise<void>;
+    isDeleting: boolean;
+};
+export type ConnectedWorkspaceListState = ReturnType<typeof useConnectedWorkspaceList>;

package/dist/connection/workspace-list/workspaceTable.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The workspace list as a table: each project is a heading row with its workspaces underneath.
+ *
+ * A project is a container, not a workspace: its heading is presentation only. It cannot be
+ * selected, does not sort as data (it is regrouped back above its workspaces after a sort), and
+ * shows the project's own facts (name, billing) under Name and its group's totals in the count
+ * columns, lined up with the workspace rows they sum. AG Grid Community has no row grouping, so the
+ * rows are a flat union and `postSortRows` keeps each group together.
+ */
+import { type ReactNode } from 'react';
+import type { ColDef } from 'ag-grid-community';
+import { type GroupedWorkspace, type WorkspaceGroupStats, type WorkspaceProjectGroup } from '../../workspaces/workspace-groups';
+type WorkspaceMemberUser = GroupedWorkspace['users'][number]['user'];
+/** How a person shows in the Members column (the host's own user chip, say). */
+export type RenderWorkspaceMember = (user: WorkspaceMemberUser, size: 'xs' | 'sm') => ReactNode;
+export interface WorkspaceTableHeadingRow {
+    kind: 'heading';
+    key: string;
+    /** Section order: the groups' order. */
+    groupIndex: number;
+    group: WorkspaceProjectGroup;
+    stats: WorkspaceGroupStats;
+}
+export interface WorkspaceTableItemRow {
+    kind: 'workspace';
+    key: string;
+    groupIndex: number;
+    workspace: GroupedWorkspace;
+}
+export type WorkspaceTableRow = WorkspaceTableHeadingRow | WorkspaceTableItemRow;
+export declare const isWorkspaceRow: (row: WorkspaceTableRow) => row is WorkspaceTableItemRow;
+/**
+ * One heading per group with workspaces, followed by them unless the group is collapsed. (An own
+ * project with no workspace yet has a band among the cards, but no heading here.)
+ */
+export declare function buildWorkspaceTableRows(groups: readonly WorkspaceProjectGroup[], isCollapsed?: (key: string) => boolean): WorkspaceTableRow[];
+/** What a project heading needs beyond its row: its billing and the group's actions. */
+export interface ProjectHeadingContext {
+    isCollapsed: (key: string) => boolean;
+    onToggle: (key: string) => void;
+    onOpenProject: (projectId: string) => void;
+    /** The heading's billing line and breakdown (`projectGroupBilling`). */
+    billing: (group: WorkspaceProjectGroup) => {
+        readout?: ReactNode;
+        breakdown?: ReactNode;
+        createdAt?: string;
+    };
+}
+/**
+ * The table's columns. There is no Project column (the project is the heading above each group),
+ * and no column filters (they cannot mix with heading rows): the filter sits above the table.
+ */
+export declare function workspaceTableColumns({ selfId, renderMember, heading, }: {
+    selfId: string | undefined;
+    renderMember: RenderWorkspaceMember;
+    heading: ProjectHeadingContext;
+}): ColDef<WorkspaceTableRow>[];
+export {};

package/dist/connection/workspace-settings/ConnectedWorkspaceMembers.d.ts

@@ -0,0 +1,26 @@
+/**
+ * A workspace's member table: name, email, role (an owner changes it inline, or for a selection),
+ * when they joined, their threads, documents and storage. You come first, then by role. An owner
+ * removes a selection (never an owner or themselves) after one confirmation.
+ */
+import { type ReactNode } from 'react';
+import type { GridState } from 'ag-grid-community';
+import type { components } from '@arbidocs/client';
+type Workspace = components['schemas']['WorkspaceResponse'];
+export type WorkspaceMemberRow = Workspace['users'][number];
+export interface ConnectedWorkspaceMembersProps {
+    workspace: Workspace;
+    members: WorkspaceMemberRow[];
+    /** The viewer (`usr-…`). */
+    selfId: string | undefined;
+    isOwner: boolean;
+    isLoading?: boolean;
+    /** No edits (role changes, removal), whoever looks. */
+    readOnly?: boolean;
+    /** A person in the Name column. Default: a plain pill. */
+    renderMember?: (member: WorkspaceMemberRow) => ReactNode;
+    gridState?: GridState;
+    onGridStateChange?: (state: GridState) => void;
+}
+export declare function ConnectedWorkspaceMembers({ workspace, members, selfId, isOwner: isOwnerRaw, isLoading, readOnly, renderMember, gridState, onGridStateChange, }: ConnectedWorkspaceMembersProps): import("react").JSX.Element;
+export {};

package/dist/connection/workspace-settings/ConnectedWorkspaceSettings.d.ts

@@ -10,14 +10,9 @@ import { type ReactNode } from 'react';
 import { type WorkspaceRole } from '@arbidocs/react';
 import type { components } from '@arbidocs/client';
 import { type ShareOutcome } from './useConnectedWorkspaceSettings';
+import type { GridState } from 'ag-grid-community';
 type Workspace = components['schemas']['WorkspaceResponse'];
 type WorkspaceMember = Workspace['users'][number];
-export interface WorkspaceMembersSlot {
-    workspace: Workspace;
-    members: WorkspaceMember[];
-    onRemove: (userExtId: string, email: string, name: string) => Promise<void>;
-    isRemoving: boolean;
-}
 export interface WorkspaceShareSlot {
     open: boolean;
     onOpenChange: (open: boolean) => void;
@@ -35,8 +30,11 @@ export interface ConnectedWorkspaceSettingsProps {
     }) => ReactNode;
     /** The project line under the workspace mark. */
     projectLine?: (workspace: Workspace) => ReactNode;
-    /** The full member table, shown when the member avatars are opened. */
-    membersTable?: (ctx: WorkspaceMembersSlot) => ReactNode;
+    /** A person in the member table (opened from the member avatars). Default: a plain pill. */
+    renderMember?: (member: WorkspaceMember) => ReactNode;
+    /** The member table's column state. */
+    membersGridState?: GridState;
+    onMembersGridStateChange?: (state: GridState) => void;
     /** The dialog behind Share (owners only). */
     shareDialog?: (ctx: WorkspaceShareSlot) => ReactNode;
     /** The workspace's dashboard, between the identity and the page foot. */
@@ -49,5 +47,5 @@ export interface ConnectedWorkspaceSettingsProps {
     onLeft?: () => void;
     testId?: string;
 }
-export declare function ConnectedWorkspaceSettings({ workspaceId, project, projectLine, membersTable, shareDialog, children, onExport, onOpenActivity, onLeft, testId, }: ConnectedWorkspaceSettingsProps): import("react").JSX.Element;
+export declare function ConnectedWorkspaceSettings({ workspaceId, project, projectLine, renderMember, membersGridState, onMembersGridStateChange, shareDialog, children, onExport, onOpenActivity, onLeft, testId, }: ConnectedWorkspaceSettingsProps): import("react").JSX.Element;
 export {};

package/dist/connection/workspace-settings/index.d.ts

@@ -1,2 +1,3 @@
-export { ConnectedWorkspaceSettings, type ConnectedWorkspaceSettingsProps, type WorkspaceMembersSlot, type WorkspaceShareSlot, } from './ConnectedWorkspaceSettings';
+export { ConnectedWorkspaceSettings, type ConnectedWorkspaceSettingsProps, type WorkspaceShareSlot, } from './ConnectedWorkspaceSettings';
 export { useConnectedWorkspaceSettings, type ShareOutcome, type UseConnectedWorkspaceSettingsOptions, } from './useConnectedWorkspaceSettings';
+export { ConnectedWorkspaceMembers, type ConnectedWorkspaceMembersProps, type WorkspaceMemberRow, } from './ConnectedWorkspaceMembers';

package/dist/connection/workspace-settings/useConnectedWorkspaceSettings.d.ts

@@ -84,7 +84,6 @@ export declare function useConnectedWorkspaceSettings(workspaceId: string, { onL
     }) => Promise<void>;
     setPublic: (isPublic: boolean) => Promise<void>;
     share: (emails: string[], memberRole?: WorkspaceRole) => Promise<ShareOutcome>;
-    removeMember: (userExtId: string, email: string, name: string) => Promise<void>;
     leave: () => Promise<void>;
     isSharing: boolean;
     isRemoving: boolean;

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 chunkUTTTJSQU_cjs = require('../chunk-UTTTJSQU.cjs');
+var chunk4RPBUMHB_cjs = require('../chunk-4RPBUMHB.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-KPZZ5FHE.cjs');
+require('../chunk-CNHUJRQ4.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(
-      chunkUTTTJSQU_cjs.SearchHit,
+      chunk4RPBUMHB_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-EF4ZLKRM.js';
+import { SearchHit } from '../chunk-DEPF5LQI.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-TBEVGWY3.js';
+import '../chunk-F57LNUSZ.js';
 import '../chunk-TX2ZICS7.js';
 import { initials } from '../chunk-OXF2IFXG.js';
 import '../chunk-VUNV25KB.js';

package/dist/files/DocStatusIcon.d.ts

@@ -1,12 +1,13 @@
-import type { ReactNode } from 'react';
 export interface DocStatusIconProps {
     /** Document processing status (case-insensitive); unknown / empty renders nothing. */
     status?: string | null;
     /** Activating the glyph (click, Enter, Space) e.g. opens the status details. */
     onClick?: () => void;
-    /** The `failed` glyph is stage-aware and host-supplied. */
-    failed?: ReactNode;
+    /** Where a failed document's processing stopped (the failed glyph differs per stage). */
+    failedStage?: string | null;
+    /** Why it failed, added to the failed glyph's title. */
+    errorMessage?: string | null;
     className?: string;
 }
 /** Compact status glyph of a document row (ready, empty, low content, indexing, queued, failed). */
-export declare function DocStatusIcon({ status, onClick, failed, className }: DocStatusIconProps): import("react").JSX.Element | null;
+export declare function DocStatusIcon({ status, onClick, failedStage, errorMessage, className, }: DocStatusIconProps): import("react").JSX.Element | null;

package/dist/files/FailedStageIcon.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Stage-aware failure icon.
+ *
+ * All variants share the red color and "alert" weight so the cell still
+ * reads as "failure" at a glance, but the glyph differs per pipeline
+ * stage so users can tell *where* it died without opening details.
+ *
+ * Backend taxonomy (mirrors src/models/document.py FAILABLE_STAGES):
+ *   parsing    — parser service: extraction / OCR / marker-subchunk
+ *   indexing   — Qdrant chunk + vector writes
+ *   encrypting — SecretBox wrap of chunks/metadata
+ *   analysing  — doctagllm metadata extraction
+ *   queued     — failed before processing started
+ *   unknown    — current code couldn't classify (defensive fallback)
+ *   null       — legacy failure predating the failed_stage column;
+ *                rendered as "Failed (stage unknown)"
+ */
+export type FailedStage = 'parsing' | 'indexing' | 'encrypting' | 'analysing' | 'queued' | 'unknown';
+interface FailedStageIconProps {
+    stage: string | null | undefined;
+    errorMessage?: string | null;
+    className?: string;
+    onClick?: (e: React.MouseEvent) => void;
+}
+export declare const FailedStageIcon: import("react").NamedExoticComponent<FailedStageIconProps>;
+export {};

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

@@ -0,0 +1,29 @@
+/**
+ * folderProviderIcon
+ *
+ * Maps a folder path to the brand mark of the connector that imported it, so
+ * connector-created folders (e.g. "Outlook (jane@arbi.city)") show their
+ * source at a glance. Only the ROOT segment is matched — nested subfolders
+ * keep the generic folder icon. Returns null when the root isn't a known
+ * provider (including the legacy bare "Email" root), letting call sites fall
+ * back to their existing folder glyph.
+ */
+/**
+ * Provider brand mark for a folder path's root segment, or null when the
+ * folder isn't a connector import (call sites render their usual icon).
+ */
+export declare function FolderProviderIcon({ folderPath, className, }: {
+    folderPath: string;
+    className?: string;
+}): import("react").JSX.Element | null;
+/** True when the folder path's root segment belongs to a known connector. */
+export declare function hasFolderProviderIcon(folderPath: string): boolean;
+/**
+ * Display text for a single folder path segment. Provider roots drop the
+ * provider name — the brand mark already says it — leaving just the account:
+ *   "Outlook (jane@arbi.city)" → "jane@arbi.city"
+ *   "Outlook" (legacy bare root) → "" (the logo stands alone)
+ * Non-provider segments are returned unchanged. Stored paths are untouched;
+ * this is display-only.
+ */
+export declare function formatFolderSegment(segment: string): string;

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

@@ -0,0 +1,86 @@
+/**
+ * Pure helpers that turn the flat document list into a navigable folder tree.
+ *
+ * Folders are not a backend entity — each document carries a slash-separated
+ * `folder` path string (e.g. `"Reports/Q1"`, or `null`/`""` for the root).
+ * These helpers derive, for a given path, the immediate sub-folders (with
+ * descendant counts) and the files that live directly in that folder. Kept
+ * pure and side-effect-free so the navigation logic is unit-testable.
+ */
+/** The fields of a document the folder view reads. */
+export interface FolderDocument {
+    external_id: string;
+    file_name?: string | null;
+    file_type?: string | null;
+    file_size?: number | null;
+    folder?: string | null;
+    parent_ext_id?: string | null;
+    created_at?: string | null;
+    doc_metadata?: {
+        title?: string | null;
+    } | null;
+}
+export interface ExplorerFolder {
+    kind: 'folder';
+    /** The folder's own name (last path segment). */
+    name: string;
+    /** Full path segments from the root, including this folder. */
+    path: string[];
+    /** Number of documents anywhere beneath this folder. */
+    count: number;
+}
+export interface ExplorerFile<D extends FolderDocument = FolderDocument> {
+    kind: 'file';
+    doc: D;
+}
+export type ExplorerEntry<D extends FolderDocument = FolderDocument> = ExplorerFolder | ExplorerFile<D>;
+export type ExplorerSort = 'name' | 'date' | 'size';
+/**
+ * Display name for a document in the explorer, with its real file extension —
+ * the familiar "Report.pdf" form. Many documents store an AI-generated display
+ * title that drops the extension, so we re-attach it from the stored
+ * `file_name` or, failing that, the MIME `file_type`.
+ */
+export declare function getExplorerDisplayName(doc: FolderDocument): string;
+/** Split a `Doc.folder` value into trimmed, non-empty path segments. */
+export declare function parseFolderSegments(folder?: string | null): string[];
+/** Join path segments back into a canonical `Doc.folder` string (or null at root). */
+export declare function joinFolderPath(segments: string[]): string | null;
+/**
+ * A document is shown in the explorer unless it belongs to an email family:
+ * attachments and archived messages (`parent_ext_id` set) live "inside" their
+ * email / archive and would otherwise clutter the folder view. Versions are not
+ * children — the list holds each document's current version only.
+ */
+export declare function isExplorerDocument(doc: FolderDocument): boolean;
+/**
+ * Every explorer document that lives anywhere beneath `path` (directly in the
+ * folder or in a sub-folder). Used to expand a folder into the documents a
+ * folder-level action (select / move / download / delete / rename) applies to —
+ * "act on a folder" means "act on everything in it".
+ */
+export declare function collectFolderDocs<D extends FolderDocument>(documents: D[], path: string[]): D[];
+/**
+ * Documents in the order the gallery shows them for a sort choice (and its
+ * direction toggle). Review mode steps through this same order.
+ */
+export declare function sortExplorerFiles<D extends FolderDocument>(docs: D[], sort: ExplorerSort, reversed?: boolean): D[];
+/**
+ * Build the folders and files that live directly under `currentPath`.
+ *
+ * - Files: documents whose folder path exactly equals `currentPath`.
+ * - Folders: the distinct next path segment of any document nested deeper than
+ *   `currentPath`, with `count` = number of documents beneath it.
+ *
+ * Folders are always sorted by name; files by the requested sort.
+ */
+export declare function buildExplorerEntries<D extends FolderDocument>(documents: D[], currentPath: string[], sort?: ExplorerSort, pendingFolders?: string[]): {
+    folders: ExplorerFolder[];
+    files: D[];
+};
+/**
+ * Flat, cross-folder search over every top-level document by title / file name.
+ * Used when the explorer search box is non-empty (mirrors real file explorers,
+ * which flatten results and ignore the current folder while searching).
+ */
+export declare function searchExplorerDocuments<D extends FolderDocument>(documents: D[], query: string, sort?: ExplorerSort): D[];

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

@@ -0,0 +1,2 @@
+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';