@arbidocs/blocks 0.3.138 → 0.3.140

package/dist/index.d.cts

@@ -1,10 +1,11 @@
-import { ThemeBundle, ThemeTokens, ThemeState } from './site/index.cjs';
-export { Accordion, AccordionItem, AccordionProps, ApplyThemeOptions, AvatarBlock, AvatarBlockProps, Banner, BannerProps, BannerTone, BlockImage, BlockImageProps, BlockLink, BlockLinkComponent, BlockLinkProps, CTABanner, CTABannerProps, Callout, CalloutProps, CalloutVariant, ColorToken, Columns, ColumnsProps, ContactField, ContactForm, ContactFormProps, Container, ContainerProps, FAQ, FAQProps, FONT_PAIRINGS, FaqItem, FeatureGrid, FeatureGridProps, FeatureItem, FontPairing, Footer, FooterColumn, FooterLink, FooterProps, Gallery, GalleryImage, GalleryProps, Hero, HeroCta, HeroProps, ListBlock, ListBlockProps, ListItem, LogoCloud, LogoCloudProps, LogoItem, MediaText, MediaTextProps, NavLink, Navbar, NavbarProps, PricingPlan, PricingTable, PricingTableProps, RichTextBlock, RichTextBlockProps, SectionHeading, Spacer, SpacerProps, StepItem, Steps, StepsProps, THEME_STYLE_ID, TabItem, Tabs, TabsProps, TeamGrid, TeamGridProps, TeamMember, Testimonial, TestimonialGrid, TestimonialGridProps, TestimonialItem, TestimonialProps, ThemeEditor, ThemeEditorProps, ThemeEmitMode, ThemeFonts, ThemePreset, ThemeStoreConfig, VideoAspect, VideoEmbed, VideoEmbedProps, applyFontVars, applyStoredTheme, applyThemeVars, clearFontVars, clearThemeVars, createThemeStore, daysUntil, fmtDate, fmtDateTime, fontPackages, fromNow, gbp, getFontPairing, hrs, initials, matchFontPairing, pct, tid, toEmbedUrl, toHslTriplet } from './site/index.cjs';
+import { ap as ThemeBundle, ax as ThemeTokens, av as ThemeState } from './index-BzrF2JbQ.cjs';
+export { A as Accordion, a as AccordionItem, b as AccordionProps, c as ApplyThemeOptions, d as AvatarBlock, e as AvatarBlockProps, B as Banner, f as BannerProps, g as BannerTone, h as BlockImage, i as BlockImageProps, j as BlockLink, k as BlockLinkComponent, l as BlockLinkProps, C as CTABanner, m as CTABannerProps, n as Callout, o as CalloutProps, p as CalloutVariant, q as ColorToken, r as Columns, s as ColumnsProps, t as ContactField, u as ContactForm, v as ContactFormProps, w as Container, x as ContainerProps, F as FAQ, y as FAQProps, z as FONT_PAIRINGS, D as FaqItem, E as FeatureGrid, G as FeatureGridProps, H as FeatureItem, I as FontPairing, J as Footer, K as FooterColumn, L as FooterLink, M as FooterProps, N as Gallery, O as GalleryImage, P as GalleryProps, Q as Hero, R as HeroCta, S as HeroProps, T as ListBlock, U as ListBlockProps, V as ListItem, W as LogoCloud, X as LogoCloudProps, Y as LogoItem, Z as MediaText, _ as MediaTextProps, $ as NavLink, a0 as Navbar, a1 as NavbarProps, a2 as PricingPlan, a3 as PricingTable, a4 as PricingTableProps, a5 as RichTextBlock, a6 as RichTextBlockProps, a7 as SectionHeading, a8 as Spacer, a9 as SpacerProps, aa as StepItem, ab as Steps, ac as StepsProps, ad as THEME_STYLE_ID, ae as TabItem, af as Tabs, ag as TabsProps, ah as TeamGrid, ai as TeamGridProps, aj as TeamMember, ak as Testimonial, al as TestimonialGrid, am as TestimonialGridProps, an as TestimonialItem, ao as TestimonialProps, aq as ThemeEditor, ar as ThemeEditorProps, as as ThemeEmitMode, at as ThemeFonts, au as ThemePreset, aw as ThemeStoreConfig, ay as VideoAspect, az as VideoEmbed, aA as VideoEmbedProps, aB as applyFontVars, aC as applyStoredTheme, aD as applyThemeVars, aE as clearFontVars, aF as clearThemeVars, aG as createThemeStore, aH as daysUntil, aI as fmtDate, aJ as fmtDateTime, aK as fontPackages, aL as formatPageRefs, aM as fromNow, aN as gbp, aO as getFontPairing, aP as hrs, aQ as initials, aR as matchFontPairing, aS as pct, aT as tid, aU as toEmbedUrl, aV as toHslTriplet } from './index-BzrF2JbQ.cjs';
 import * as react from 'react';
 import react__default, { ReactNode, ComponentType } from 'react';
 import * as _arbidocs_react from '@arbidocs/react';
-import { AiRunOptions, UserMenuItem, NotifyVariant, useArbi, AiTaskStatus } from '@arbidocs/react';
+import { DocumentLike, AiRunOptions, UserMenuItem, NotifyVariant, useArbi, AiTaskStatus } from '@arbidocs/react';
 export { AiRunOptions, AiTaskStatus, ArtifactEvent, DocumentCard, DocumentCardProps, SearchChunk, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, redlineStats, textToArtifact, toRedlineMarkdown } from '@arbidocs/react';
+import { components } from '@arbidocs/client';
 import { ColDef, GridOptions, GridApi, CellValueChangedEvent, GridState } from 'ag-grid-community';
 import { LucideIcon } from 'lucide-react';
 import { CustomField, Field, ComponentConfig, Data, Config } from '@measured/puck';
@@ -128,6 +129,45 @@ declare function createPromptLibrary(config: PromptConfig): {
     }];
 };
 
+type CitationSources = components['schemas']['CitationSources'];
+type Citations = CitationSources | null;
+interface CitationEditorProps {
+    value: string;
+    citations: Citations | null;
+    onChange: (note: string, citations: Citations | null) => void;
+    /** Currently active citation key (controlled from parent) */
+    activeCitationKey?: string | null;
+    /**
+     * Open a document in the viewer, armed to collect passages for this field —
+     * and tag its first passage, so a chosen document is immediately a usable
+     * citation. Passages are picked by reading, so citing means opening.
+     *
+     * The caller owns this because resolving "first passage" needs the parsed
+     * document, and keeping that fetch out here is what lets this component stay
+     * store- and API-free (and therefore hoistable to @arbidocs/blocks).
+     */
+    onCiteDocument?: (docExtId: string) => void;
+    /** Cited documents, already resolved by the caller — keyed by external id. */
+    citedDocs?: Record<string, DocumentLike>;
+    /**
+     * The app's document picker, injected as a slot. It is store-coupled, so it
+     * is passed in rather than imported, and receives the chosen document id.
+     */
+    renderDocumentPicker?: (onSelect: (docExtId: string) => void, selectedIds: string[]) => React.ReactNode;
+    placeholder?: string;
+    readOnly?: boolean;
+    className?: string;
+    /** Start in edit mode with the caret in the field (composer behaviour). */
+    autoFocus?: boolean;
+    /** Applied to the text field itself, so callers can target it directly. */
+    'data-testid'?: string;
+    /** Persisted textarea height in pixels */
+    defaultHeight?: number;
+    /** Called after user resizes the textarea */
+    onHeightChange?: (height: number) => void;
+}
+declare function CitationEditor({ value, citations, onChange, activeCitationKey, onCiteDocument, citedDocs, renderDocumentPicker, autoFocus, 'data-testid': dataTestId, placeholder, readOnly, className, defaultHeight, onHeightChange, }: CitationEditorProps): react.JSX.Element;
+
 /**
  * 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-firm config a
@@ -286,13 +326,11 @@ declare function useWorkspaceDocs(): {
         doctags: {
             note?: string | null | undefined;
             citations?: {
-                [x: string]: {
-                    chunk_ids: string[];
-                    scores: number[];
-                    statement: string;
-                    offset_start: number;
-                    offset_end: number;
-                };
+                passages: {
+                    chunk_id: string;
+                    doc_ext_id?: string | null | undefined;
+                    page?: number | null | undefined;
+                }[];
             } | null | undefined;
             doc_ext_id: string;
             tag_ext_id: string;
@@ -1259,4 +1297,4 @@ interface AgentsPanelProps {
 }
 declare function AgentsPanel({ store, testIdPrefix }: AgentsPanelProps): react.JSX.Element;
 
-export { ASSET_REF_PREFIX, type AgentSelectionStore, AgentsPanel, type AgentsPanelProps, type AiFields, type AiFieldsConfig, AppHeader, type AppHeaderProps, type AppHeaderUser, type AppNavItem, type AppNavSection, AppShell, type AppShellProps, type ArbiBlocksConfigOptions, type ArbiMode, type ArbiUser, type AssetMaterializer, type AssetRenderProps, type AssetRenderer, AssetResolverProvider, AssetThumb, type AssistantCitation, type AssistantMessage, type AssistantStep, type BlockKit, type BuildPrompt, type BuilderModule, type Column, ConnectionProvider, type ConnectionStatus, DataTable, DataTableBlock, type DataTableBlockColumn, type DataTableBlockProps, EmptyState, type ExportedModule, type FirmArbiConfig, GridView, type GridViewEmptyState, type GridViewProps, type GridViewSelection, type ImageFieldConfig, type ImageFieldFactory, LegalArbiProvider, LiveDataProvider, type LoadResult, type MaterializeOptions, type MatterContext, MetricCard, type MetricCardProps, ModuleManager, type ModuleManagerProps, type ModuleRegistry, type ModuleStoreBundle, PageHeader, PageRenderer, type PageRendererProps, type PersistVia, type PromptConfig, type PromptLibrary, type Prompts, type ResolvedModule, Section, type SectionProps, StatGroup, type StatGroupProps, type StatItem, StudioEditor, type StudioEditorProps, type StudioPageMeta, type StudioPersistence, type StudioPersistenceConfig, ThemeBundle, ThemeState, ThemeTokens, Toolbar, UploadDropzone, type UploadDropzoneProps, type UseImageGen, VerticalBuilder, type VerticalBuilderProps, type VerticalConfig, type VerticalExport, type VerticalExportConfig, WidgetPlaceholder, WorkspaceCard, type WorkspaceCardMember, type WorkspaceCardProps, asAssetRef, assetRefId, createAgentSelectionStore, createAiFields, createArbiBlocksConfig, createArbiMaterializer, createBlockKit, createImageField, createLiveWidgets, createModuleRegistry, createModuleStore, createPromptLibrary, createSiteBlocks, createStudioPersistence, createVerticalExport, createWebsiteBlocks, iconMap, isAssetRef, isAuthenticated, materializePageData, matterToContext, useAssetImage, useAssetRenderer, useAssetResolverActive, useConnection, useFirmAiTask, useImageGen, useLiveDataActive, useSemanticSearch, useWorkspaceDocs };
+export { ASSET_REF_PREFIX, type AgentSelectionStore, AgentsPanel, type AgentsPanelProps, type AiFields, type AiFieldsConfig, AppHeader, type AppHeaderProps, type AppHeaderUser, type AppNavItem, type AppNavSection, AppShell, type AppShellProps, type ArbiBlocksConfigOptions, type ArbiMode, type ArbiUser, type AssetMaterializer, type AssetRenderProps, type AssetRenderer, AssetResolverProvider, AssetThumb, type AssistantCitation, type AssistantMessage, type AssistantStep, type BlockKit, type BuildPrompt, type BuilderModule, CitationEditor, type CitationEditorProps, type Column, ConnectionProvider, type ConnectionStatus, DataTable, DataTableBlock, type DataTableBlockColumn, type DataTableBlockProps, EmptyState, type ExportedModule, type FirmArbiConfig, GridView, type GridViewEmptyState, type GridViewProps, type GridViewSelection, type ImageFieldConfig, type ImageFieldFactory, LegalArbiProvider, LiveDataProvider, type LoadResult, type MaterializeOptions, type MatterContext, MetricCard, type MetricCardProps, ModuleManager, type ModuleManagerProps, type ModuleRegistry, type ModuleStoreBundle, PageHeader, PageRenderer, type PageRendererProps, type PersistVia, type PromptConfig, type PromptLibrary, type Prompts, type ResolvedModule, Section, type SectionProps, StatGroup, type StatGroupProps, type StatItem, StudioEditor, type StudioEditorProps, type StudioPageMeta, type StudioPersistence, type StudioPersistenceConfig, ThemeBundle, ThemeState, ThemeTokens, Toolbar, UploadDropzone, type UploadDropzoneProps, type UseImageGen, VerticalBuilder, type VerticalBuilderProps, type VerticalConfig, type VerticalExport, type VerticalExportConfig, WidgetPlaceholder, WorkspaceCard, type WorkspaceCardMember, type WorkspaceCardProps, asAssetRef, assetRefId, createAgentSelectionStore, createAiFields, createArbiBlocksConfig, createArbiMaterializer, createBlockKit, createImageField, createLiveWidgets, createModuleRegistry, createModuleStore, createPromptLibrary, createSiteBlocks, createStudioPersistence, createVerticalExport, createWebsiteBlocks, iconMap, isAssetRef, isAuthenticated, materializePageData, matterToContext, useAssetImage, useAssetRenderer, useAssetResolverActive, useConnection, useFirmAiTask, useImageGen, useLiveDataActive, useSemanticSearch, useWorkspaceDocs };

package/dist/index.d.ts

@@ -1,10 +1,11 @@
-import { ThemeBundle, ThemeTokens, ThemeState } from './site/index.js';
-export { Accordion, AccordionItem, AccordionProps, ApplyThemeOptions, AvatarBlock, AvatarBlockProps, Banner, BannerProps, BannerTone, BlockImage, BlockImageProps, BlockLink, BlockLinkComponent, BlockLinkProps, CTABanner, CTABannerProps, Callout, CalloutProps, CalloutVariant, ColorToken, Columns, ColumnsProps, ContactField, ContactForm, ContactFormProps, Container, ContainerProps, FAQ, FAQProps, FONT_PAIRINGS, FaqItem, FeatureGrid, FeatureGridProps, FeatureItem, FontPairing, Footer, FooterColumn, FooterLink, FooterProps, Gallery, GalleryImage, GalleryProps, Hero, HeroCta, HeroProps, ListBlock, ListBlockProps, ListItem, LogoCloud, LogoCloudProps, LogoItem, MediaText, MediaTextProps, NavLink, Navbar, NavbarProps, PricingPlan, PricingTable, PricingTableProps, RichTextBlock, RichTextBlockProps, SectionHeading, Spacer, SpacerProps, StepItem, Steps, StepsProps, THEME_STYLE_ID, TabItem, Tabs, TabsProps, TeamGrid, TeamGridProps, TeamMember, Testimonial, TestimonialGrid, TestimonialGridProps, TestimonialItem, TestimonialProps, ThemeEditor, ThemeEditorProps, ThemeEmitMode, ThemeFonts, ThemePreset, ThemeStoreConfig, VideoAspect, VideoEmbed, VideoEmbedProps, applyFontVars, applyStoredTheme, applyThemeVars, clearFontVars, clearThemeVars, createThemeStore, daysUntil, fmtDate, fmtDateTime, fontPackages, fromNow, gbp, getFontPairing, hrs, initials, matchFontPairing, pct, tid, toEmbedUrl, toHslTriplet } from './site/index.js';
+import { ap as ThemeBundle, ax as ThemeTokens, av as ThemeState } from './index-BzrF2JbQ.js';
+export { A as Accordion, a as AccordionItem, b as AccordionProps, c as ApplyThemeOptions, d as AvatarBlock, e as AvatarBlockProps, B as Banner, f as BannerProps, g as BannerTone, h as BlockImage, i as BlockImageProps, j as BlockLink, k as BlockLinkComponent, l as BlockLinkProps, C as CTABanner, m as CTABannerProps, n as Callout, o as CalloutProps, p as CalloutVariant, q as ColorToken, r as Columns, s as ColumnsProps, t as ContactField, u as ContactForm, v as ContactFormProps, w as Container, x as ContainerProps, F as FAQ, y as FAQProps, z as FONT_PAIRINGS, D as FaqItem, E as FeatureGrid, G as FeatureGridProps, H as FeatureItem, I as FontPairing, J as Footer, K as FooterColumn, L as FooterLink, M as FooterProps, N as Gallery, O as GalleryImage, P as GalleryProps, Q as Hero, R as HeroCta, S as HeroProps, T as ListBlock, U as ListBlockProps, V as ListItem, W as LogoCloud, X as LogoCloudProps, Y as LogoItem, Z as MediaText, _ as MediaTextProps, $ as NavLink, a0 as Navbar, a1 as NavbarProps, a2 as PricingPlan, a3 as PricingTable, a4 as PricingTableProps, a5 as RichTextBlock, a6 as RichTextBlockProps, a7 as SectionHeading, a8 as Spacer, a9 as SpacerProps, aa as StepItem, ab as Steps, ac as StepsProps, ad as THEME_STYLE_ID, ae as TabItem, af as Tabs, ag as TabsProps, ah as TeamGrid, ai as TeamGridProps, aj as TeamMember, ak as Testimonial, al as TestimonialGrid, am as TestimonialGridProps, an as TestimonialItem, ao as TestimonialProps, aq as ThemeEditor, ar as ThemeEditorProps, as as ThemeEmitMode, at as ThemeFonts, au as ThemePreset, aw as ThemeStoreConfig, ay as VideoAspect, az as VideoEmbed, aA as VideoEmbedProps, aB as applyFontVars, aC as applyStoredTheme, aD as applyThemeVars, aE as clearFontVars, aF as clearThemeVars, aG as createThemeStore, aH as daysUntil, aI as fmtDate, aJ as fmtDateTime, aK as fontPackages, aL as formatPageRefs, aM as fromNow, aN as gbp, aO as getFontPairing, aP as hrs, aQ as initials, aR as matchFontPairing, aS as pct, aT as tid, aU as toEmbedUrl, aV as toHslTriplet } from './index-BzrF2JbQ.js';
 import * as react from 'react';
 import react__default, { ReactNode, ComponentType } from 'react';
 import * as _arbidocs_react from '@arbidocs/react';
-import { AiRunOptions, UserMenuItem, NotifyVariant, useArbi, AiTaskStatus } from '@arbidocs/react';
+import { DocumentLike, AiRunOptions, UserMenuItem, NotifyVariant, useArbi, AiTaskStatus } from '@arbidocs/react';
 export { AiRunOptions, AiTaskStatus, ArtifactEvent, DocumentCard, DocumentCardProps, SearchChunk, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, redlineStats, textToArtifact, toRedlineMarkdown } from '@arbidocs/react';
+import { components } from '@arbidocs/client';
 import { ColDef, GridOptions, GridApi, CellValueChangedEvent, GridState } from 'ag-grid-community';
 import { LucideIcon } from 'lucide-react';
 import { CustomField, Field, ComponentConfig, Data, Config } from '@measured/puck';
@@ -128,6 +129,45 @@ declare function createPromptLibrary(config: PromptConfig): {
     }];
 };
 
+type CitationSources = components['schemas']['CitationSources'];
+type Citations = CitationSources | null;
+interface CitationEditorProps {
+    value: string;
+    citations: Citations | null;
+    onChange: (note: string, citations: Citations | null) => void;
+    /** Currently active citation key (controlled from parent) */
+    activeCitationKey?: string | null;
+    /**
+     * Open a document in the viewer, armed to collect passages for this field —
+     * and tag its first passage, so a chosen document is immediately a usable
+     * citation. Passages are picked by reading, so citing means opening.
+     *
+     * The caller owns this because resolving "first passage" needs the parsed
+     * document, and keeping that fetch out here is what lets this component stay
+     * store- and API-free (and therefore hoistable to @arbidocs/blocks).
+     */
+    onCiteDocument?: (docExtId: string) => void;
+    /** Cited documents, already resolved by the caller — keyed by external id. */
+    citedDocs?: Record<string, DocumentLike>;
+    /**
+     * The app's document picker, injected as a slot. It is store-coupled, so it
+     * is passed in rather than imported, and receives the chosen document id.
+     */
+    renderDocumentPicker?: (onSelect: (docExtId: string) => void, selectedIds: string[]) => React.ReactNode;
+    placeholder?: string;
+    readOnly?: boolean;
+    className?: string;
+    /** Start in edit mode with the caret in the field (composer behaviour). */
+    autoFocus?: boolean;
+    /** Applied to the text field itself, so callers can target it directly. */
+    'data-testid'?: string;
+    /** Persisted textarea height in pixels */
+    defaultHeight?: number;
+    /** Called after user resizes the textarea */
+    onHeightChange?: (height: number) => void;
+}
+declare function CitationEditor({ value, citations, onChange, activeCitationKey, onCiteDocument, citedDocs, renderDocumentPicker, autoFocus, 'data-testid': dataTestId, placeholder, readOnly, className, defaultHeight, onHeightChange, }: CitationEditorProps): react.JSX.Element;
+
 /**
  * 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-firm config a
@@ -286,13 +326,11 @@ declare function useWorkspaceDocs(): {
         doctags: {
             note?: string | null | undefined;
             citations?: {
-                [x: string]: {
-                    chunk_ids: string[];
-                    scores: number[];
-                    statement: string;
-                    offset_start: number;
-                    offset_end: number;
-                };
+                passages: {
+                    chunk_id: string;
+                    doc_ext_id?: string | null | undefined;
+                    page?: number | null | undefined;
+                }[];
             } | null | undefined;
             doc_ext_id: string;
             tag_ext_id: string;
@@ -1259,4 +1297,4 @@ interface AgentsPanelProps {
 }
 declare function AgentsPanel({ store, testIdPrefix }: AgentsPanelProps): react.JSX.Element;
 
-export { ASSET_REF_PREFIX, type AgentSelectionStore, AgentsPanel, type AgentsPanelProps, type AiFields, type AiFieldsConfig, AppHeader, type AppHeaderProps, type AppHeaderUser, type AppNavItem, type AppNavSection, AppShell, type AppShellProps, type ArbiBlocksConfigOptions, type ArbiMode, type ArbiUser, type AssetMaterializer, type AssetRenderProps, type AssetRenderer, AssetResolverProvider, AssetThumb, type AssistantCitation, type AssistantMessage, type AssistantStep, type BlockKit, type BuildPrompt, type BuilderModule, type Column, ConnectionProvider, type ConnectionStatus, DataTable, DataTableBlock, type DataTableBlockColumn, type DataTableBlockProps, EmptyState, type ExportedModule, type FirmArbiConfig, GridView, type GridViewEmptyState, type GridViewProps, type GridViewSelection, type ImageFieldConfig, type ImageFieldFactory, LegalArbiProvider, LiveDataProvider, type LoadResult, type MaterializeOptions, type MatterContext, MetricCard, type MetricCardProps, ModuleManager, type ModuleManagerProps, type ModuleRegistry, type ModuleStoreBundle, PageHeader, PageRenderer, type PageRendererProps, type PersistVia, type PromptConfig, type PromptLibrary, type Prompts, type ResolvedModule, Section, type SectionProps, StatGroup, type StatGroupProps, type StatItem, StudioEditor, type StudioEditorProps, type StudioPageMeta, type StudioPersistence, type StudioPersistenceConfig, ThemeBundle, ThemeState, ThemeTokens, Toolbar, UploadDropzone, type UploadDropzoneProps, type UseImageGen, VerticalBuilder, type VerticalBuilderProps, type VerticalConfig, type VerticalExport, type VerticalExportConfig, WidgetPlaceholder, WorkspaceCard, type WorkspaceCardMember, type WorkspaceCardProps, asAssetRef, assetRefId, createAgentSelectionStore, createAiFields, createArbiBlocksConfig, createArbiMaterializer, createBlockKit, createImageField, createLiveWidgets, createModuleRegistry, createModuleStore, createPromptLibrary, createSiteBlocks, createStudioPersistence, createVerticalExport, createWebsiteBlocks, iconMap, isAssetRef, isAuthenticated, materializePageData, matterToContext, useAssetImage, useAssetRenderer, useAssetResolverActive, useConnection, useFirmAiTask, useImageGen, useLiveDataActive, useSemanticSearch, useWorkspaceDocs };
+export { ASSET_REF_PREFIX, type AgentSelectionStore, AgentsPanel, type AgentsPanelProps, type AiFields, type AiFieldsConfig, AppHeader, type AppHeaderProps, type AppHeaderUser, type AppNavItem, type AppNavSection, AppShell, type AppShellProps, type ArbiBlocksConfigOptions, type ArbiMode, type ArbiUser, type AssetMaterializer, type AssetRenderProps, type AssetRenderer, AssetResolverProvider, AssetThumb, type AssistantCitation, type AssistantMessage, type AssistantStep, type BlockKit, type BuildPrompt, type BuilderModule, CitationEditor, type CitationEditorProps, type Column, ConnectionProvider, type ConnectionStatus, DataTable, DataTableBlock, type DataTableBlockColumn, type DataTableBlockProps, EmptyState, type ExportedModule, type FirmArbiConfig, GridView, type GridViewEmptyState, type GridViewProps, type GridViewSelection, type ImageFieldConfig, type ImageFieldFactory, LegalArbiProvider, LiveDataProvider, type LoadResult, type MaterializeOptions, type MatterContext, MetricCard, type MetricCardProps, ModuleManager, type ModuleManagerProps, type ModuleRegistry, type ModuleStoreBundle, PageHeader, PageRenderer, type PageRendererProps, type PersistVia, type PromptConfig, type PromptLibrary, type Prompts, type ResolvedModule, Section, type SectionProps, StatGroup, type StatGroupProps, type StatItem, StudioEditor, type StudioEditorProps, type StudioPageMeta, type StudioPersistence, type StudioPersistenceConfig, ThemeBundle, ThemeState, ThemeTokens, Toolbar, UploadDropzone, type UploadDropzoneProps, type UseImageGen, VerticalBuilder, type VerticalBuilderProps, type VerticalConfig, type VerticalExport, type VerticalExportConfig, WidgetPlaceholder, WorkspaceCard, type WorkspaceCardMember, type WorkspaceCardProps, asAssetRef, assetRefId, createAgentSelectionStore, createAiFields, createArbiBlocksConfig, createArbiMaterializer, createBlockKit, createImageField, createLiveWidgets, createModuleRegistry, createModuleStore, createPromptLibrary, createSiteBlocks, createStudioPersistence, createVerticalExport, createWebsiteBlocks, iconMap, isAssetRef, isAuthenticated, materializePageData, matterToContext, useAssetImage, useAssetRenderer, useAssetResolverActive, useConnection, useFirmAiTask, useImageGen, useLiveDataActive, useSemanticSearch, useWorkspaceDocs };

package/dist/index.js

@@ -1,13 +1,13 @@
-import { tid, initials, fromNow, fmtDate, assetRefId, applyStoredTheme, AssetResolverProvider, ThemeEditor, applyThemeVars, SectionHeading, PricingTable, Tabs as Tabs$1, Accordion, Gallery, VideoEmbed, ContactForm, Banner, MediaText, TeamGrid, Steps, TestimonialGrid, Columns, Spacer, Container, Hero, FeatureGrid, Testimonial, CTABanner, LogoCloud, FAQ, RichTextBlock, Callout, BlockImage, AvatarBlock, Navbar, Footer, ListBlock, isAssetRef, asAssetRef } from './chunk-L6GG4KN2.js';
-export { ASSET_REF_PREFIX, Accordion, AssetResolverProvider, AvatarBlock, Banner, BlockImage, BlockLink, CTABanner, Callout, Columns, ContactForm, Container, FAQ, FONT_PAIRINGS, FeatureGrid, Footer, Gallery, Hero, ListBlock, LogoCloud, MediaText, Navbar, PricingTable, RichTextBlock, SectionHeading, Spacer, Steps, THEME_STYLE_ID, Tabs, TeamGrid, Testimonial, TestimonialGrid, ThemeEditor, VideoEmbed, applyFontVars, applyStoredTheme, applyThemeVars, asAssetRef, assetRefId, clearFontVars, clearThemeVars, createThemeStore, daysUntil, fmtDate, fmtDateTime, fontPackages, fromNow, gbp, getFontPairing, hrs, initials, isAssetRef, matchFontPairing, pct, tid, toEmbedUrl, toHslTriplet, useAssetRenderer, useAssetResolverActive } from './chunk-L6GG4KN2.js';
-import { createContext, useState, useCallback, useMemo, useContext, useRef, useEffect } from 'react';
-import { useArbi, ArbiProvider, useAiTask, useWorkspaceDocs as useWorkspaceDocs$1, useSemanticSearch as useSemanticSearch$1, cn, Table, TableHeader, TableRow, TableHead, TableBody, TableCell, Input, Card, CardHeader, CardTitle, CardDescription, CardContent, Tooltip, TooltipTrigger, TooltipContent, CardFooter, Avatar, AvatarImage, AvatarFallback, TooltipProvider, Button, NotificationBell, UserMenu, useThumbnails, Badge, Switch, useConfigs, useAgents, Checkbox, Tabs, TabsList, TabsTrigger, TabsContent, Separator, ArbiWebSocketProvider, useDocuments, ImageCropModal, DEFAULT_ASPECT_OPTIONS, useConversations } from '@arbidocs/react';
+import { formatPageRefs, tid, initials, fromNow, fmtDate, assetRefId, applyStoredTheme, AssetResolverProvider, ThemeEditor, applyThemeVars, SectionHeading, PricingTable, Tabs as Tabs$1, Accordion, Gallery, VideoEmbed, ContactForm, Banner, MediaText, TeamGrid, Steps, TestimonialGrid, Columns, Spacer, Container, Hero, FeatureGrid, Testimonial, CTABanner, LogoCloud, FAQ, RichTextBlock, Callout, BlockImage, AvatarBlock, Navbar, Footer, ListBlock, isAssetRef, asAssetRef } from './chunk-ETIYX2MO.js';
+export { ASSET_REF_PREFIX, Accordion, AssetResolverProvider, AvatarBlock, Banner, BlockImage, BlockLink, CTABanner, Callout, Columns, ContactForm, Container, FAQ, FONT_PAIRINGS, FeatureGrid, Footer, Gallery, Hero, ListBlock, LogoCloud, MediaText, Navbar, PricingTable, RichTextBlock, SectionHeading, Spacer, Steps, THEME_STYLE_ID, Tabs, TeamGrid, Testimonial, TestimonialGrid, ThemeEditor, VideoEmbed, applyFontVars, applyStoredTheme, applyThemeVars, asAssetRef, assetRefId, clearFontVars, clearThemeVars, createThemeStore, daysUntil, fmtDate, fmtDateTime, fontPackages, formatPageRefs, fromNow, gbp, getFontPairing, hrs, initials, isAssetRef, matchFontPairing, pct, tid, toEmbedUrl, toHslTriplet, useAssetRenderer, useAssetResolverActive } from './chunk-ETIYX2MO.js';
+import { createContext, useState, useRef, useEffect, useMemo, useCallback, useContext } from 'react';
+import { MessageSquare, Cpu, Code, Cloud, Layers, Target, Award, MapPin, Phone, Mail, Lock, Globe, Heart, Star, Rocket, Shield, Zap, Sparkles, Gavel, Scale, Bell, Activity, BarChart3, DollarSign, TrendingUp, Info, AlertCircle, CheckCircle, Clock, Calendar, Briefcase, Users, Folder, FileText, X, Loader2, UploadCloud, Search, ArrowUpRight, ArrowDownRight, FolderLock, CheckCircle2, ArrowLeftRight, MessagesSquare, Menu, ArrowLeft, Palette, RotateCcw, ChevronUp, ChevronDown, BrainCircuit, Bot, LayoutGrid, FileJson, Download, Crop, ImagePlus, Upload, Link2, Check } from 'lucide-react';
+import { cn, DocumentEntity, useArbi, ArbiProvider, useAiTask, useWorkspaceDocs as useWorkspaceDocs$1, useSemanticSearch as useSemanticSearch$1, Table, TableHeader, TableRow, TableHead, TableBody, TableCell, Input, Card, CardHeader, CardTitle, CardDescription, CardContent, Tooltip, TooltipTrigger, TooltipContent, CardFooter, Avatar, AvatarImage, AvatarFallback, TooltipProvider, Button, NotificationBell, UserMenu, useThumbnails, Badge, Switch, useConfigs, useAgents, Checkbox, Tabs, TabsList, TabsTrigger, TabsContent, Separator, ArbiWebSocketProvider, useDocuments, ImageCropModal, DEFAULT_ASPECT_OPTIONS, useConversations } from '@arbidocs/react';
 export { DocumentCard, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, redlineStats, textToArtifact, toRedlineMarkdown } from '@arbidocs/react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { QueryClient, QueryClientProvider, useQuery, useQueryClient } from '@tanstack/react-query';
 import { AgGridReact } from 'ag-grid-react';
 import { themeQuartz, AllCommunityModule } from 'ag-grid-community';
-import { MessageSquare, Cpu, Code, Cloud, Layers, Target, Award, MapPin, Phone, Mail, Lock, Globe, Heart, Star, Rocket, Shield, Zap, Sparkles, Gavel, Scale, Bell, Activity, BarChart3, DollarSign, TrendingUp, Info, AlertCircle, CheckCircle, Clock, Calendar, Briefcase, Users, Folder, FileText, Loader2, UploadCloud, Search, ArrowUpRight, ArrowDownRight, FolderLock, CheckCircle2, ArrowLeftRight, MessagesSquare, X, Menu, ArrowLeft, Palette, RotateCcw, ChevronUp, ChevronDown, BrainCircuit, Bot, LayoutGrid, FileJson, Download, Crop, ImagePlus, Upload, Link2, Check } from 'lucide-react';
 import { useLocation, Link, useParams, NavLink } from 'react-router-dom';
 import { Puck, Render } from '@measured/puck';
 import { create } from 'zustand';
@@ -194,6 +194,170 @@ Lead with why the firm is the right choice, reference relevant experience at a t
   ];
   return { prompts, WORKFLOW_ACTIONS };
 }
+function CitationEditor({
+  value,
+  citations,
+  onChange,
+  activeCitationKey,
+  onCiteDocument,
+  citedDocs,
+  renderDocumentPicker,
+  autoFocus = false,
+  "data-testid": dataTestId,
+  placeholder = "Add a note...",
+  readOnly = false,
+  className,
+  defaultHeight,
+  onHeightChange
+}) {
+  const [localValue, setLocalValue] = useState(value);
+  const [isEditing, setIsEditing] = useState(autoFocus);
+  const textareaRef = useRef(null);
+  const debounceRef = useRef(null);
+  useEffect(() => {
+    if (!isEditing) {
+      setLocalValue(value);
+    }
+  }, [value, isEditing]);
+  const passages = useMemo(() => citations?.passages ?? [], [citations]);
+  const hasCitations = passages.length > 0;
+  const byDoc = useMemo(() => {
+    const groups = /* @__PURE__ */ new Map();
+    for (const passage of passages) {
+      if (!passage.doc_ext_id) continue;
+      const group = groups.get(passage.doc_ext_id) ?? { pages: [], count: 0 };
+      group.count += 1;
+      if (passage.page != null && !group.pages.includes(passage.page))
+        group.pages.push(passage.page);
+      groups.set(passage.doc_ext_id, group);
+    }
+    return groups;
+  }, [passages]);
+  const docIds = Array.from(byDoc.keys());
+  const handleRemoveDocument = useCallback(
+    (docExtId) => {
+      const remaining = passages.filter((p) => p.doc_ext_id !== docExtId);
+      onChange(localValue, remaining.length ? { passages: remaining } : null);
+    },
+    [passages, localValue, onChange]
+  );
+  const handleToggleDocument = useCallback(
+    (docExtId) => {
+      if (!docExtId) return;
+      if (docIds.includes(docExtId)) {
+        handleRemoveDocument(docExtId);
+        return;
+      }
+      onCiteDocument?.(docExtId);
+    },
+    [docIds, onCiteDocument, handleRemoveDocument]
+  );
+  const renderedContent = useMemo(
+    () => localValue ? /* @__PURE__ */ jsx("span", { children: localValue }) : null,
+    [localValue]
+  );
+  const handleChange = useCallback(
+    (newValue) => {
+      setLocalValue(newValue);
+      if (debounceRef.current) clearTimeout(debounceRef.current);
+      debounceRef.current = setTimeout(() => onChange(newValue, citations ?? null), 400);
+    },
+    [citations, onChange]
+  );
+  const flushPendingChange = useCallback(() => {
+    if (!debounceRef.current) return;
+    clearTimeout(debounceRef.current);
+    debounceRef.current = null;
+    onChange(localValue, citations ?? null);
+  }, [localValue, citations, onChange]);
+  return /* @__PURE__ */ jsxs("div", { className: cn("space-y-1", className), children: [
+    /* @__PURE__ */ jsx("div", { className: "relative", children: isEditing ? /* @__PURE__ */ jsx(
+      "textarea",
+      {
+        ref: textareaRef,
+        value: localValue,
+        onChange: (e) => handleChange(e.target.value),
+        onBlur: () => {
+          flushPendingChange();
+          setIsEditing(false);
+        },
+        onMouseUp: () => {
+          if (textareaRef.current && onHeightChange) {
+            onHeightChange(textareaRef.current.offsetHeight);
+          }
+        },
+        placeholder,
+        readOnly,
+        rows: 2,
+        "data-testid": dataTestId,
+        autoFocus: true,
+        style: defaultHeight ? { height: defaultHeight } : void 0,
+        className: "w-full text-sm p-2 pr-14 border border-border rounded-md resize-y bg-background focus:outline-none focus:ring-2 focus:ring-ring"
+      }
+    ) : /* @__PURE__ */ jsx(
+      "div",
+      {
+        onClick: () => !readOnly && setIsEditing(true),
+        style: defaultHeight ? { minHeight: defaultHeight } : void 0,
+        "data-testid": dataTestId,
+        className: cn(
+          "w-full text-sm p-2 pr-14 border border-border rounded-md min-h-[4rem] whitespace-pre-wrap bg-background",
+          !readOnly && "cursor-text hover:border-ring",
+          !localValue && "text-muted-foreground"
+        ),
+        children: renderedContent || placeholder
+      }
+    ) }),
+    (hasCitations || !readOnly) && /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-1", children: [
+      docIds.map((docId) => {
+        const doc = citedDocs?.[docId];
+        const group = byDoc.get(docId);
+        const pages = (group?.pages ?? []).slice().sort((a, b) => a - b);
+        return /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "flex items-center gap-1.5 text-sm",
+            "data-testid": `citation-doc-${docId}`,
+            children: [
+              doc ? /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  onClick: () => !readOnly && onCiteDocument?.(docId),
+                  className: "flex-1 min-w-0 text-left",
+                  title: "Open to tag more passages",
+                  children: /* @__PURE__ */ jsx(DocumentEntity, { doc, fullWidth: true, labelMaxWidth: "max-w-full" })
+                }
+              ) : /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: docId }),
+              /* @__PURE__ */ jsx("span", { className: "text-muted-foreground shrink-0", children: formatPageRefs(pages) }),
+              !readOnly && /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  onClick: () => handleRemoveDocument(docId),
+                  "aria-label": "Remove this document",
+                  className: "p-0.5 hover:bg-destructive/20 hover:text-destructive rounded shrink-0",
+                  children: /* @__PURE__ */ jsx(X, { size: 12 })
+                }
+              )
+            ]
+          },
+          docId
+        );
+      }),
+      passages.some((p) => !p.doc_ext_id) && /* @__PURE__ */ jsxs("span", { className: "text-sm text-muted-foreground", children: [
+        passages.filter((p) => !p.doc_ext_id).length,
+        " passage(s) without a recorded document"
+      ] }),
+      !readOnly && /* @__PURE__ */ jsx("div", { className: "flex items-center gap-1", children: /* @__PURE__ */ jsx("div", { className: "flex-1 min-w-0", "data-testid": "citation-document-picker", children: renderDocumentPicker?.(handleToggleDocument, docIds) }) })
+    ] }),
+    activeCitationKey && /* @__PURE__ */ jsxs("p", { className: "text-sm text-blue-text", children: [
+      "Click a passage in the document to add it \u2014 ",
+      /* @__PURE__ */ jsx("strong", { children: "shift-click" }),
+      " to take a whole range. Add as many as you like, from as many documents as you like."
+    ] })
+  ] });
+}
 var ConnectionContext = createContext(null);
 var WORKSPACE_STORAGE_PREFIX = "arbi:selectedWorkspace";
 var workspaceStorageKey = (apiUrl) => `${WORKSPACE_STORAGE_PREFIX}:${apiUrl || "demo"}`;
@@ -4636,6 +4800,6 @@ function VerticalBuilder({
   ] });
 }
 
-export { AgentsPanel, AppHeader, AppShell, AssetThumb, ConnectionProvider, DataTable, DataTableBlock, EmptyState, GridView, LegalArbiProvider, LiveDataProvider, MetricCard, ModuleManager, PageHeader, PageRenderer, Section, StatGroup, StudioEditor, Toolbar, UploadDropzone, VerticalBuilder, WidgetPlaceholder, WorkspaceCard, createAgentSelectionStore, createAiFields, createArbiBlocksConfig, createArbiMaterializer, createBlockKit, createImageField, createLiveWidgets, createModuleRegistry, createModuleStore, createPromptLibrary, createSiteBlocks, createStudioPersistence, createVerticalExport, createWebsiteBlocks, iconMap, isAuthenticated, materializePageData, matterToContext, useAssetImage, useConnection, useFirmAiTask, useImageGen, useLiveDataActive, useSemanticSearch, useWorkspaceDocs };
+export { AgentsPanel, AppHeader, AppShell, AssetThumb, CitationEditor, ConnectionProvider, DataTable, DataTableBlock, EmptyState, GridView, LegalArbiProvider, LiveDataProvider, MetricCard, ModuleManager, PageHeader, PageRenderer, Section, StatGroup, StudioEditor, Toolbar, UploadDropzone, VerticalBuilder, WidgetPlaceholder, WorkspaceCard, createAgentSelectionStore, createAiFields, createArbiBlocksConfig, createArbiMaterializer, createBlockKit, createImageField, createLiveWidgets, createModuleRegistry, createModuleStore, createPromptLibrary, createSiteBlocks, createStudioPersistence, createVerticalExport, createWebsiteBlocks, iconMap, isAuthenticated, materializePageData, matterToContext, useAssetImage, useConnection, useFirmAiTask, useImageGen, useLiveDataActive, useSemanticSearch, useWorkspaceDocs };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map