@arbidocs/blocks 0.4.154 → 0.4.156

package/dist/facts/index.cjs

@@ -1,20 +1,20 @@
 "use client";
 'use strict';
 
-var chunkB3FMUFAW_cjs = require('../chunk-B3FMUFAW.cjs');
-require('../chunk-2WLXQGWC.cjs');
+var chunkUKT3WH5Z_cjs = require('../chunk-UKT3WH5Z.cjs');
 var chunk5FYU7ZIU_cjs = require('../chunk-5FYU7ZIU.cjs');
+require('../chunk-2WLXQGWC.cjs');
 var chunk4RPBUMHB_cjs = require('../chunk-4RPBUMHB.cjs');
 require('../chunk-VPPX5XUF.cjs');
 var chunkRC25WMVB_cjs = require('../chunk-RC25WMVB.cjs');
 require('../chunk-V4ISCZJ7.cjs');
 var chunk2EI7NCUA_cjs = require('../chunk-2EI7NCUA.cjs');
 var chunkC2CWWEHO_cjs = require('../chunk-C2CWWEHO.cjs');
-require('../chunk-BIXHB4LV.cjs');
 require('../chunk-7RGLTF76.cjs');
 require('../chunk-FX3K6LNZ.cjs');
 require('../chunk-PPCATBOY.cjs');
 var chunkMHVNT4J3_cjs = require('../chunk-MHVNT4J3.cjs');
+require('../chunk-BIXHB4LV.cjs');
 require('../chunk-CNHUJRQ4.cjs');
 require('../chunk-ULWRNGGE.cjs');
 var chunkKDG6FER6_cjs = require('../chunk-KDG6FER6.cjs');
@@ -75,13 +75,13 @@ function FactsTable({
   gridProps,
   testId = "facts-table"
 }) {
-  const l = { ...chunkB3FMUFAW_cjs.DEFAULT_FACT_COLUMN_LABELS, ...columnLabels };
+  const l = { ...chunkUKT3WH5Z_cjs.DEFAULT_FACT_COLUMN_LABELS, ...columnLabels };
   const columnDefs = react.useMemo(
-    () => chunkB3FMUFAW_cjs.createFactColumns({
+    () => chunkUKT3WH5Z_cjs.createFactColumns({
       isInChat,
       onToggleInChat,
       renderHeader: (params) => /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-[12.5px] font-medium", children: params.displayName }),
-      renderRowActions: (fact) => onEdit && onDelete ? /* @__PURE__ */ jsxRuntime.jsx(chunkB3FMUFAW_cjs.FactRowActions, { onEdit: () => onEdit(fact), onDelete: () => onDelete(fact) }) : null,
+      renderRowActions: (fact) => onEdit && onDelete ? /* @__PURE__ */ jsxRuntime.jsx(chunkUKT3WH5Z_cjs.FactRowActions, { onEdit: () => onEdit(fact), onDelete: () => onDelete(fact) }) : null,
       renderLabels: (fact) => /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex flex-wrap items-center gap-1", children: (fact.tags ?? []).map((tag) => /* @__PURE__ */ jsxRuntime.jsx(
         "span",
         {
@@ -411,195 +411,195 @@ function FactSearchResult({
 
 Object.defineProperty(exports, "DEFAULT_FACTS_BULK_BAR_LABELS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACTS_BULK_BAR_LABELS; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACTS_BULK_BAR_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_FACTS_EMPTY_STATE_LABELS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACTS_EMPTY_STATE_LABELS; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACTS_EMPTY_STATE_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_FACTS_FIELDS_BUTTON_LABELS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACTS_FIELDS_BUTTON_LABELS; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACTS_FIELDS_BUTTON_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_FACTS_TOOLBAR_LABELS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACTS_TOOLBAR_LABELS; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACTS_TOOLBAR_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_FACTS_VIEW_TOGGLE_LABELS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACTS_VIEW_TOGGLE_LABELS; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACTS_VIEW_TOGGLE_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_FACT_COLUMN_LABELS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACT_COLUMN_LABELS; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACT_COLUMN_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_FACT_COLUMN_ORDER", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACT_COLUMN_ORDER; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACT_COLUMN_ORDER; }
 });
 Object.defineProperty(exports, "DEFAULT_FACT_COMPOSER_LABELS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACT_COMPOSER_LABELS; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACT_COMPOSER_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_FACT_DATE_INPUT_LABELS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACT_DATE_INPUT_LABELS; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACT_DATE_INPUT_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_FACT_LABELS_CELL_LABELS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACT_LABELS_CELL_LABELS; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACT_LABELS_CELL_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_FACT_ROW_ACTIONS_LABELS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACT_ROW_ACTIONS_LABELS; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACT_ROW_ACTIONS_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_FACT_SOURCES_ROW_LABELS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACT_SOURCES_ROW_LABELS; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACT_SOURCES_ROW_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_FACT_SOURCE_GROUP_LABELS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACT_SOURCE_GROUP_LABELS; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACT_SOURCE_GROUP_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_FACT_TIMELINE_LABELS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.DEFAULT_FACT_TIMELINE_LABELS; }
+  get: function () { return chunkUKT3WH5Z_cjs.DEFAULT_FACT_TIMELINE_LABELS; }
 });
 Object.defineProperty(exports, "EMPTY_FACT_DATE_FIELDS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.EMPTY_FACT_DATE_FIELDS; }
+  get: function () { return chunkUKT3WH5Z_cjs.EMPTY_FACT_DATE_FIELDS; }
 });
 Object.defineProperty(exports, "FactComposer", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactComposer; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactComposer; }
 });
 Object.defineProperty(exports, "FactDateInput", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactDateInput; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactDateInput; }
 });
 Object.defineProperty(exports, "FactFieldRow", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactFieldRow; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactFieldRow; }
 });
 Object.defineProperty(exports, "FactLabelsCell", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactLabelsCell; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactLabelsCell; }
 });
 Object.defineProperty(exports, "FactRowActions", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactRowActions; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactRowActions; }
 });
 Object.defineProperty(exports, "FactSourceGroup", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactSourceGroup; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactSourceGroup; }
 });
 Object.defineProperty(exports, "FactSourcesRow", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactSourcesRow; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactSourcesRow; }
 });
 Object.defineProperty(exports, "FactsBulkBar", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactsBulkBar; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactsBulkBar; }
 });
 Object.defineProperty(exports, "FactsCalendar", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactsCalendar; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactsCalendar; }
 });
 Object.defineProperty(exports, "FactsEmptyState", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactsEmptyState; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactsEmptyState; }
 });
 Object.defineProperty(exports, "FactsFieldsButton", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactsFieldsButton; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactsFieldsButton; }
 });
 Object.defineProperty(exports, "FactsGanttPane", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactsGanttPane; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactsGanttPane; }
 });
 Object.defineProperty(exports, "FactsLoadError", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactsLoadError; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactsLoadError; }
 });
 Object.defineProperty(exports, "FactsLoading", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactsLoading; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactsLoading; }
 });
 Object.defineProperty(exports, "FactsToolbar", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactsToolbar; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactsToolbar; }
 });
 Object.defineProperty(exports, "FactsViewToggle", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.FactsViewToggle; }
+  get: function () { return chunkUKT3WH5Z_cjs.FactsViewToggle; }
 });
 Object.defineProperty(exports, "ISO_DATE_FILTER_PARAMS", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.ISO_DATE_FILTER_PARAMS; }
+  get: function () { return chunkUKT3WH5Z_cjs.ISO_DATE_FILTER_PARAMS; }
 });
 Object.defineProperty(exports, "buildFactCitations", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.buildFactCitations; }
+  get: function () { return chunkUKT3WH5Z_cjs.buildFactCitations; }
 });
 Object.defineProperty(exports, "chunkIdsOf", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.chunkIdsOf; }
+  get: function () { return chunkUKT3WH5Z_cjs.chunkIdsOf; }
 });
 Object.defineProperty(exports, "citedVersionRef", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.citedVersionRef; }
+  get: function () { return chunkUKT3WH5Z_cjs.citedVersionRef; }
 });
 Object.defineProperty(exports, "createFactColumns", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.createFactColumns; }
+  get: function () { return chunkUKT3WH5Z_cjs.createFactColumns; }
 });
 Object.defineProperty(exports, "docIdsOf", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.docIdsOf; }
+  get: function () { return chunkUKT3WH5Z_cjs.docIdsOf; }
 });
 Object.defineProperty(exports, "enableFactTableColumnResize", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.enableFactTableColumnResize; }
+  get: function () { return chunkUKT3WH5Z_cjs.enableFactTableColumnResize; }
 });
 Object.defineProperty(exports, "factDateFieldsToSpan", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.factDateFieldsToSpan; }
+  get: function () { return chunkUKT3WH5Z_cjs.factDateFieldsToSpan; }
 });
 Object.defineProperty(exports, "factDateSpanToFields", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.factDateSpanToFields; }
+  get: function () { return chunkUKT3WH5Z_cjs.factDateSpanToFields; }
 });
 Object.defineProperty(exports, "hasChunk", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.hasChunk; }
+  get: function () { return chunkUKT3WH5Z_cjs.hasChunk; }
 });
 Object.defineProperty(exports, "isWholeDoc", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.isWholeDoc; }
+  get: function () { return chunkUKT3WH5Z_cjs.isWholeDoc; }
 });
 Object.defineProperty(exports, "sourceDocCount", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.sourceDocCount; }
+  get: function () { return chunkUKT3WH5Z_cjs.sourceDocCount; }
 });
 Object.defineProperty(exports, "toFactCitations", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.toFactCitations; }
+  get: function () { return chunkUKT3WH5Z_cjs.toFactCitations; }
 });
 Object.defineProperty(exports, "withChunk", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.withChunk; }
+  get: function () { return chunkUKT3WH5Z_cjs.withChunk; }
 });
 Object.defineProperty(exports, "withDoc", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.withDoc; }
+  get: function () { return chunkUKT3WH5Z_cjs.withDoc; }
 });
 Object.defineProperty(exports, "withoutChunk", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.withoutChunk; }
+  get: function () { return chunkUKT3WH5Z_cjs.withoutChunk; }
 });
 Object.defineProperty(exports, "withoutDoc", {
   enumerable: true,
-  get: function () { return chunkB3FMUFAW_cjs.withoutDoc; }
+  get: function () { return chunkUKT3WH5Z_cjs.withoutDoc; }
 });
 Object.defineProperty(exports, "DEFAULT_FACT_PASSAGES_LABELS", {
   enumerable: true,

package/dist/facts/index.js

@@ -1,19 +1,19 @@
 "use client";
-import { DEFAULT_FACT_COLUMN_LABELS, createFactColumns, FactRowActions } from '../chunk-WU34CHU5.js';
-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';
+import { DEFAULT_FACT_COLUMN_LABELS, createFactColumns, FactRowActions } from '../chunk-YMQDDUKW.js';
+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-YMQDDUKW.js';
 export { DEFAULT_FACT_PASSAGES_LABELS, FactPassageItem, FactSourcesPanel, renderPreviewInline, toPreviewLine } from '../chunk-HFZ45FD3.js';
+import '../chunk-JJA6GQKH.js';
 import { SearchHit } from '../chunk-DEPF5LQI.js';
 import '../chunk-4EZVCGRL.js';
 export { decodeWhitespaceEntities } from '../chunk-AF6RDAJF.js';
 import '../chunk-NUNKSZKU.js';
 export { DEFAULT_FILTER_INPUT_LABELS as DEFAULT_FACTS_FILTER_INPUT_LABELS, DEFAULT_FILTER_FIELDS as FACTS_SEARCH_FIELD_OPTIONS, FilterInput as FactsFilterInput } from '../chunk-YU2KUMGE.js';
 import { GridView } from '../chunk-N5YEF3LC.js';
-import '../chunk-GTCC2VAR.js';
 import '../chunk-4WWM3GQ5.js';
 import '../chunk-SLSBJRWW.js';
 import '../chunk-NPLYHR2E.js';
 import { testIdOr } from '../chunk-7F6CBP3Z.js';
+import '../chunk-GTCC2VAR.js';
 import '../chunk-F57LNUSZ.js';
 import '../chunk-TX2ZICS7.js';
 import { initials } from '../chunk-OXF2IFXG.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';