@arbidocs/blocks 0.4.147 → 0.4.151

package/dist/connection/facts/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * What the connected Facts page shares with its host. The page reads and writes the facts itself
+ * (`@arbidocs/react`); a host plugs in what lives elsewhere in it: the current chat's facts, the
+ * document viewer's passage collection, where the page's view choices are kept, and the parts that
+ * are its own (the labels panel, export, Smart Search).
+ */
+import type { ReactNode } from 'react';
+import type { GridState } from 'ag-grid-community';
+import type { FactResponse } from '@arbidocs/sdk/browser';
+import type { TriState } from '../../settings/TriStateFilterMenu';
+import type { FactsSearchField } from '../../facts/FactsFilterInput';
+import type { FactsViewMode } from '../../facts/FactsViewToggle';
+export type Fact = FactResponse;
+/**
+ * The current chat's facts (absent: no chat, no In chat column). Adding is the host's to refuse
+ * (a budget, a duplicate) and to say why; it returns how many it added.
+ */
+export interface FactsChat {
+    /** The ids of the facts in the current chat. */
+    factIds: readonly string[];
+    add: (facts: Fact[]) => number;
+    remove: (factIds: string[]) => number;
+    /** The chat's facts budget, in characters (absent: no budget shown). */
+    budget?: {
+        used: number;
+        cap: number;
+    };
+}
+/** A passage picked in the viewer for the fact being written. */
+export interface CollectedPassage {
+    chunk_id: string;
+    page?: number | null;
+}
+/**
+ * The document viewer's passage collection: citing a document opens it in the viewer, and the
+ * passages picked (or unpicked) there land on the fact being written. Absent: citing a document
+ * opens it (`openDocument`) and sources are whole documents or passages already cited.
+ */
+export interface FactPassageCollector {
+    /** The document on display in the viewer (null when it is closed). */
+    displayedDocId: string | null;
+    /** The document passages are being collected from (null: not collecting). */
+    collectingDocId: string | null;
+    /** Passages picked in the viewer since the last `consumePicked`. */
+    picked: readonly CollectedPassage[];
+    /** Passages unpicked in the viewer since the last `consumeUnpicked`. */
+    unpicked: readonly string[];
+    consumePicked: () => void;
+    consumeUnpicked: () => void;
+    /** Open a document in the viewer, collecting for this fact (null: a new one). */
+    open: (docId: string, factId: string | null) => void;
+    /** Collect from a document already on display (null: stop collecting). */
+    collect: (docId: string | null) => void;
+    /** Close the viewer. */
+    close: () => void;
+    /** Mark the cited passages in the viewer while the sources list is open ([]: none). */
+    highlight: (chunkIds: string[]) => void;
+    /** Clear the passage being read in the viewer and its highlight. */
+    clearReading: () => void;
+}
+/**
+ * Where the page keeps its view choices, so they outlast leaving the page (default: kept in the
+ * page while it is mounted). Each pair is a value and its setter.
+ */
+export interface FactsPageView {
+    view: FactsViewMode;
+    setView: (view: FactsViewMode) => void;
+    /** The table's row height (px). */
+    rowHeight: number;
+    setRowHeight: (height: number) => void;
+    /** The timeline's label gutter width (px). */
+    labelWidth: number;
+    setLabelWidth: (width: number) => void;
+    /** The timeline zoom. */
+    zoom: number;
+    setZoom: (zoom: number) => void;
+    /** The filter box's text and what it searches. */
+    filterText: string;
+    setFilterText: (text: string) => void;
+    searchFields: FactsSearchField[];
+    setSearchFields: (fields: FactsSearchField[]) => void;
+    /** The quick filters (tri-state, by filter id). */
+    filters: Map<string, TriState>;
+    setFilters: (filters: Map<string, TriState>) => void;
+    /** The table's column state. */
+    gridState?: GridState;
+    setGridState?: (state: GridState) => void;
+}
+/** What the labels panel applies labels to: the selected facts. */
+export interface FactsLabelTarget {
+    noun: {
+        singular: string;
+        plural: string;
+    };
+    ids: string[];
+    /** How many facts carry a label. */
+    countFor: (tagId: string) => number;
+    apply: (tagIds: string[]) => Promise<void>;
+    clear: (tagIds: string[]) => Promise<void>;
+}
+/** A one-off request from another surface: show a view, start a fact, or bring one into view. */
+export interface FactsPageRequest {
+    view?: FactsViewMode | null;
+    compose?: boolean;
+    focusFactId?: string | null;
+}
+/** The host's own parts of the page. */
+export interface FactsPageSlots {
+    /** The labels panel for the selected facts (opened by `onOpenLabels`). */
+    renderLabelsPanel?: (target: FactsLabelTarget) => ReactNode;
+    /** Export the selected facts. */
+    renderExport?: (props: {
+        open: boolean;
+        onOpenChange: (open: boolean) => void;
+        items: {
+            extId: string;
+            label: string;
+        }[];
+    }) => ReactNode;
+    /** The Smart Search view (absent: no Smart Search). */
+    renderSmartSearch?: (props: {
+        selectedFactId: string | null;
+        onOpenFact: (factId: string) => void;
+    }) => ReactNode;
+    /** Under the empty state (e.g. "find facts in your documents"). */
+    emptyStateExtra?: ReactNode;
+}

package/dist/connection/facts/useFactActions.d.ts

@@ -0,0 +1,10 @@
+import type { CellValueChangedEvent } from 'ag-grid-community';
+import type { Fact } from './types';
+export declare function useFactActions(refetch: () => unknown): {
+    toggleShared: (m: Fact) => Promise<void>;
+    toggleConfirmed: (m: Fact) => Promise<void>;
+    remove: (m: Fact) => Promise<boolean>;
+    setFactTags: (fact: Fact, tagExtIds: string[]) => Promise<void>;
+    handleCellValueChanged: (event: CellValueChangedEvent<Fact>) => Promise<void>;
+    isDeleting: boolean;
+};

package/dist/connection/facts/useFactComposer.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The inline fact composer's state and behaviour: draft buffers, passage collection from the
+ * document viewer, create/update/delete, and the "dirty" check that gates Save.
+ */
+import type { components } from '@arbidocs/client';
+import { type RefObject } from 'react';
+import type { GridApi } from 'ag-grid-community';
+import { type FactDateFields } from '../../facts/fact-date';
+import type { Fact, FactPassageCollector } from './types';
+export declare function useFactComposer(notes: Fact[], remove: (fact: Fact) => Promise<boolean>, gridApiRef: RefObject<GridApi<Fact> | null>, collector: FactPassageCollector | undefined, 
+/** A request to start a fact (from another surface), and its done. */
+composeRequested: boolean, onComposeHandled: () => void): {
+    composing: boolean;
+    setComposing: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    draft: string;
+    setDraft: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setBaselineText: import("react").Dispatch<import("react").SetStateAction<string>>;
+    draftCitations: {
+        doc_ext_id: string;
+        version?: number | null;
+        chunks?: components["schemas"]["CitedChunk"][];
+    }[] | null;
+    setDraftCitations: import("react").Dispatch<import("react").SetStateAction<{
+        doc_ext_id: string;
+        version?: number | null;
+        chunks?: components["schemas"]["CitedChunk"][];
+    }[] | null>>;
+    draftTagIds: string[];
+    setDraftTagIds: import("react").Dispatch<import("react").SetStateAction<string[]>>;
+    draftDateFields: FactDateFields;
+    setDraftDateFields: import("react").Dispatch<import("react").SetStateAction<FactDateFields>>;
+    draftShared: boolean;
+    setDraftShared: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    draftConfirmed: boolean;
+    setDraftConfirmed: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    composerError: string | null;
+    setComposerError: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    editingId: string | null;
+    composerSession: number;
+    editingIdRef: RefObject<string | null>;
+    displayedDocId: string | null;
+    resetComposer: () => void;
+    startNewFact: () => void;
+    saveComposer: () => Promise<void>;
+    deleteEditingFact: () => Promise<void>;
+    openEdit: (m: Fact) => void;
+    composerDirty: boolean;
+    citeDocument: (docExtId: string, target: string, opts?: {
+        toggle?: boolean;
+    }) => void;
+    setSourceCitationSession: (docExtId: string | null) => void;
+    isSaving: boolean;
+    DRAFT_TARGET: string;
+};

package/dist/connection/facts/useFactFilters.d.ts

@@ -0,0 +1,101 @@
+import type { TriStateGroup, TriStateOption } from '../../settings/TriStateFilterMenu';
+import type { Fact, FactsChat, FactsPageView } from './types';
+export declare function useFactFilters(notes: Fact[], view: FactsPageView, chat: FactsChat | undefined): {
+    labelTags: {
+        external_id: string;
+        workspace_ext_id: string;
+        name: string;
+        instruction?: string | null | undefined;
+        tag_type: {
+            type: "checkbox" | "text" | "number" | "select" | "search" | "date";
+            options: string[];
+        };
+        kind: "label" | "annotation" | "search" | "issue" | "person" | "organisation";
+        shared: boolean;
+        parent_ext_id?: string | null | undefined;
+        doctag_count: number;
+        facttag_count: number;
+        convotag_count: number;
+        field_values?: {
+            [x: string]: unknown;
+        } | undefined;
+        links?: {
+            docs?: {
+                doc_ext_id: string;
+                file_name: string;
+                note?: string | null | undefined;
+                citations_count: number;
+                updated_at: string;
+            }[] | undefined;
+            facts?: {
+                fact_ext_id: string;
+                text: string;
+                confirmed: boolean;
+                updated_at: string;
+            }[] | undefined;
+            threads?: {
+                conversation_ext_id: string;
+                title?: string | null | undefined;
+                updated_at: string;
+            }[] | undefined;
+            doc_count: number;
+            fact_count: number;
+            thread_count: number;
+        } | null | undefined;
+        created_by_ext_id: string;
+        updated_by_ext_id?: string | null | undefined;
+        created_at: string;
+        updated_at: string;
+    }[];
+    createTagStable: {
+        mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<{
+            external_id: string;
+            workspace_ext_id: string;
+            name: string;
+            instruction?: string | null;
+            tag_type: import("@arbidocs/client").components["schemas"]["TagFormat"];
+            kind: "label" | "annotation" | "search" | "issue" | "person" | "organisation";
+            shared: boolean;
+            parent_ext_id?: string | null;
+            doctag_count: number;
+            facttag_count: number;
+            convotag_count: number;
+            field_values?: {
+                [key: string]: unknown;
+            };
+            links?: import("@arbidocs/client").components["schemas"]["TagLinks"] | null;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null;
+            created_at: string;
+            updated_at: string;
+        }, Error, import("@arbidocs/react").CreateTagInput, unknown>;
+    };
+    makeTagPicker: (selected: string[], setSelected: (ids: string[]) => void, opts?: {
+        hideAppliedPills?: boolean;
+    }) => import("react").JSX.Element;
+    factFilters: Map<string, import("../../settings").TriState>;
+    setFactFilters: (filters: Map<string, import("../../settings").TriState>) => void;
+    factFilterOptions: TriStateOption<string>[];
+    factFilterGroups: TriStateGroup<string>[];
+    factsFilter: string;
+    setFactsFilter: (text: string) => void;
+    factsSearchFields: import("../..").FilterField[];
+    setFactsSearchFields: (fields: import("../..").FilterField[]) => void;
+    filteredNotes: {
+        text: string;
+        citations?: import("@arbidocs/client").components["schemas"]["CitationSources"] | null;
+        external_id: string;
+        workspace_ext_id: string;
+        shared: boolean;
+        confirmed: boolean;
+        date_start?: string | null;
+        date_end?: string | null;
+        timezone?: string | null;
+        reminder_task_ext_ids: string[];
+        tags: import("@arbidocs/client").components["schemas"]["FactTagResponse"][];
+        created_by_ext_id: string;
+        created_at: string;
+        updated_at: string;
+    }[];
+    hasActiveFilters: boolean;
+};

package/dist/connection/facts/useFactSelection.d.ts

@@ -0,0 +1,82 @@
+import { type RefObject } from 'react';
+import type { GridApi } from 'ag-grid-community';
+import type { Fact, FactsChat, FactsLabelTarget } from './types';
+export declare function useFactSelection(notes: Fact[], gridApiRef: RefObject<GridApi<Fact> | null>, setFactTags: (fact: Fact, tagExtIds: string[]) => Promise<void>, chat: FactsChat | undefined): {
+    selectedFacts: {
+        text: string;
+        citations?: import("@arbidocs/client").components["schemas"]["CitationSources"] | null;
+        external_id: string;
+        workspace_ext_id: string;
+        shared: boolean;
+        confirmed: boolean;
+        date_start?: string | null;
+        date_end?: string | null;
+        timezone?: string | null;
+        reminder_task_ext_ids: string[];
+        tags: import("@arbidocs/client").components["schemas"]["FactTagResponse"][];
+        created_by_ext_id: string;
+        created_at: string;
+        updated_at: string;
+    }[];
+    clearSelection: () => void;
+    gridSelection: {
+        mode: "multiple";
+        selected: {
+            text: string;
+            citations?: import("@arbidocs/client").components["schemas"]["CitationSources"] | null;
+            external_id: string;
+            workspace_ext_id: string;
+            shared: boolean;
+            confirmed: boolean;
+            date_start?: string | null;
+            date_end?: string | null;
+            timezone?: string | null;
+            reminder_task_ext_ids: string[];
+            tags: import("@arbidocs/client").components["schemas"]["FactTagResponse"][];
+            created_by_ext_id: string;
+            created_at: string;
+            updated_at: string;
+        }[];
+        onSelectionChange: import("react").Dispatch<import("react").SetStateAction<{
+            text: string;
+            citations?: import("@arbidocs/client").components["schemas"]["CitationSources"] | null;
+            external_id: string;
+            workspace_ext_id: string;
+            shared: boolean;
+            confirmed: boolean;
+            date_start?: string | null;
+            date_end?: string | null;
+            timezone?: string | null;
+            reminder_task_ext_ids: string[];
+            tags: import("@arbidocs/client").components["schemas"]["FactTagResponse"][];
+            created_by_ext_id: string;
+            created_at: string;
+            updated_at: string;
+        }[]>>;
+    };
+    bulkDelete: () => Promise<void>;
+    freshSelectedFacts: {
+        text: string;
+        citations?: import("@arbidocs/client").components["schemas"]["CitationSources"] | null;
+        external_id: string;
+        workspace_ext_id: string;
+        shared: boolean;
+        confirmed: boolean;
+        date_start?: string | null;
+        date_end?: string | null;
+        timezone?: string | null;
+        reminder_task_ext_ids: string[];
+        tags: import("@arbidocs/client").components["schemas"]["FactTagResponse"][];
+        created_by_ext_id: string;
+        created_at: string;
+        updated_at: string;
+    }[];
+    factsLabelTarget: FactsLabelTarget;
+    allSelectedInChat: boolean;
+    bulkToggleInChat: () => void;
+    bulkSetShared: (shouldShare: boolean) => Promise<void>;
+    exportItems: {
+        extId: string;
+        label: string;
+    }[];
+};

package/dist/connection/facts/useFactsGrid.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Wiring for the facts AG Grid: stable columns and grid options (context delegates through a ref
+ * so the grid never blanket-refreshes), label cell, focus-flash from quick-access jumps.
+ */
+import type { useCreateTag } from '@arbidocs/react';
+import type { TagResponse } from '@arbidocs/sdk/browser';
+import { type ReactNode, type RefObject } from 'react';
+import type { GridApi } from 'ag-grid-community';
+import { type FactCreator, type LookupUser } from './factPageColumns';
+import type { Fact } from './types';
+type Tag = TagResponse;
+/** Who may do something to a fact, by its creator's id. */
+type CreatorCheck = (creatorExtId: string | null | undefined) => boolean;
+interface FactsGridArgs {
+    notes: Fact[];
+    labelTags: Tag[];
+    createTagStable: Pick<ReturnType<typeof useCreateTag>, 'mutateAsync'>;
+    setFactTags: (fact: Fact, tagExtIds: string[]) => Promise<void>;
+    /** The current chat's fact ids: the In chat column refreshes when they change. */
+    chatFactIds: string[];
+    toggleInChat: (fact: Fact) => void;
+    toggleConfirmed: (fact: Fact) => void;
+    toggleShared: (fact: Fact) => void;
+    remove: (fact: Fact) => Promise<boolean>;
+    openEdit: (fact: Fact) => void;
+    gridApiRef: RefObject<GridApi<Fact> | null>;
+    editingIdRef: RefObject<string | null>;
+    /** Who may change who sees a fact, and who may reword or delete it. */
+    canChangeSharing: CreatorCheck;
+    canRewrite: CreatorCheck;
+    lookupUser: LookupUser;
+    renderUser?: (user: FactCreator | null) => ReactNode;
+    /** A fact to bring into view once (a jump from elsewhere), and its done. */
+    focusFactId?: string | null;
+    onFocused?: () => void;
+    /** The chat's In chat column (absent: no chat). */
+    hasChat: boolean;
+}
+export declare function useFactsGrid({ notes, labelTags, createTagStable, setFactTags, chatFactIds, toggleInChat, toggleConfirmed, toggleShared, remove, openEdit, gridApiRef, editingIdRef, canChangeSharing: canChange, canRewrite, lookupUser, renderUser, focusFactId: focusedFactId, onFocused, hasChat, }: FactsGridArgs): {
+    factColumns: import("ag-grid-community").ColDef<{
+        text: string;
+        citations?: import("@arbidocs/client").components["schemas"]["CitationSources"] | null;
+        external_id: string;
+        workspace_ext_id: string;
+        shared: boolean;
+        confirmed: boolean;
+        date_start?: string | null;
+        date_end?: string | null;
+        timezone?: string | null;
+        reminder_task_ext_ids: string[];
+        tags: import("@arbidocs/client").components["schemas"]["FactTagResponse"][];
+        created_by_ext_id: string;
+        created_at: string;
+        updated_at: string;
+    }, any>[];
+    factGridOptions: {
+        context: {
+            lookupUser: LookupUser;
+            renderUser: ((user: FactCreator | null) => ReactNode) | undefined;
+            renderFactTags: (fact: Fact, rowHeight?: number) => import("react").JSX.Element;
+            openEdit: (m: Fact) => void;
+            removeFact: (m: Fact) => Promise<boolean>;
+            canChangeSharing: (m: Fact) => boolean;
+            canRewrite: (m: Fact) => boolean;
+        };
+        onRowDoubleClicked: (e: {
+            data?: Fact;
+        }) => void | undefined;
+        getRowClass: (p: {
+            data?: Fact;
+        }) => "facts-row-editing" | undefined;
+        suppressClickEdit: boolean;
+        tooltipInteraction: boolean;
+    };
+    factCtxRef: RefObject<{
+        lookupUser: LookupUser;
+        renderUser: ((user: FactCreator | null) => ReactNode) | undefined;
+        renderFactTags: (fact: Fact, rowHeight?: number) => import("react").JSX.Element;
+        openEdit: (fact: Fact) => void;
+        removeFact: (fact: Fact) => Promise<boolean>;
+        canChange: CreatorCheck;
+        canRewrite: CreatorCheck;
+        chatFactIdSet: Set<string>;
+        toggleInChat: (fact: Fact) => void;
+    }>;
+};
+export {};

package/dist/connection/facts/useFactsPageView.d.ts

@@ -0,0 +1,4 @@
+import type { FactsPageView } from './types';
+/** The timeline's label gutter, by default. */
+export declare const DEFAULT_TIMELINE_LABEL_WIDTH = 240;
+export declare function useFactsPageView(): FactsPageView;

package/dist/connection/mail/ConnectedMailComposer.d.ts

@@ -7,7 +7,7 @@
  */
 import { type RefObject } from 'react';
 import { type MailAccount, type MailCompose, type MailMessage } from '@arbidocs/react';
-import type { MailDocumentSource, MailOfflineSupport, MailWordEditor } from './types';
+import type { MailDocumentSource, MailOfflineSupport, MailRecipientSuggestions, MailWordEditor } from './types';
 export interface ConnectedMailComposerProps {
     /** Open this saved draft (from the account's Drafts) instead of a new message. */
     draftId?: string;
@@ -35,6 +35,8 @@ export interface ConnectedMailComposerProps {
     offline?: MailOfflineSupport;
     /** Workspace documents to attach ("From workspace"). Absent: not offered. */
     documents?: MailDocumentSource;
+    /** People suggested while typing a recipient. Absent: plain address fields. */
+    recipients?: MailRecipientSuggestions;
     /** A native draft's body in the Word editor (see {@link MailWordEditor}). Absent: the rich-text body. */
     word?: MailWordEditor;
     /** This compose session, stable across remounts (its Word room is kept for it). */

package/dist/connection/mail/ConnectedMailbox.d.ts

@@ -12,7 +12,7 @@ import { type ReactNode } from 'react';
 import type { GridState } from 'ag-grid-community';
 import { type MailAddress, type MailAccount, type MailAttachment, type MailMessage } from '@arbidocs/react';
 import { type MailAliasUser } from './ConnectedMailAccounts';
-import type { MailDocumentSource, MailOfflineSupport, MailPanelProps, MailSaveToWorkspace, MailWordEditor } from './types';
+import type { MailDocumentSource, MailRecipientSuggestions, MailOfflineSupport, MailPanelProps, MailSaveToWorkspace, MailWordEditor } from './types';
 export interface ConnectedMailboxProps {
     /** Which mailbox: an account id, or `'native'` for the user's own inbox. Default: the first. */
     mailbox?: string;
@@ -42,6 +42,8 @@ export interface ConnectedMailboxProps {
     offline?: MailOfflineSupport;
     /** The open workspace's documents, attachable in the composer. */
     documents?: MailDocumentSource;
+    /** People suggested while typing a recipient in the composer. Absent: plain address fields. */
+    recipients?: MailRecipientSuggestions;
     /** Saving an email into a workspace ("Save to workspace" on native mail). */
     saveToWorkspace?: MailSaveToWorkspace;
     /** Native drafts' bodies in the Word editor, where ARBI's edits are suggestions. Absent: rich text. */
@@ -65,4 +67,4 @@ export interface ConnectedMailboxProps {
     /** The message opened first (e.g. restored after a redirect). */
     initialMessageId?: string | null;
 }
-export declare function ConnectedMailbox({ mailbox, draftId, onDraftOpened, folder: requestedFolder, onFolderOpened, composeAttachments, onComposeOpened, onOpenDocument, user, productName, oauthReturnPath, personLabel, offline, documents, saveToWorkspace, word, onReplyWithArbi, renderInvite, renderPanel, onViewerOpenChange, gridState, onGridStateChange, initialMessageId, }: ConnectedMailboxProps): import("react").JSX.Element;
+export declare function ConnectedMailbox({ mailbox, draftId, onDraftOpened, folder: requestedFolder, onFolderOpened, composeAttachments, onComposeOpened, onOpenDocument, user, productName, oauthReturnPath, personLabel, offline, documents, recipients, saveToWorkspace, word, onReplyWithArbi, renderInvite, renderPanel, onViewerOpenChange, gridState, onGridStateChange, initialMessageId, }: ConnectedMailboxProps): import("react").JSX.Element;

package/dist/connection/mail/MailComposerForm.d.ts

@@ -1,6 +1,6 @@
 import { type RefObject } from 'react';
 import { type MailAccount, type MailCompose, type MailMessage } from '@arbidocs/react';
-import type { MailDocumentSource, MailOfflineSupport, MailWordEditor } from './types';
+import type { MailDocumentSource, MailOfflineSupport, MailRecipientSuggestions, MailWordEditor } from './types';
 export interface MailComposerFormProps {
     account?: MailAccount;
     initial: MailCompose;
@@ -21,6 +21,8 @@ export interface MailComposerFormProps {
     localDraftId?: string;
     offline?: MailOfflineSupport;
     documents?: MailDocumentSource;
+    /** People suggested while typing a recipient. Absent: plain address fields. */
+    recipients?: MailRecipientSuggestions;
     /** A native draft's body in the Word editor. Absent: the rich-text body. */
     word?: MailWordEditor;
     /** This compose session, stable across remounts (its Word room is kept for it). */
@@ -31,4 +33,4 @@ export interface MailComposerFormProps {
     headerSlot?: HTMLElement | null;
 }
 /** Write, save and send one message. */
-export declare function MailComposerForm({ account, initial, maxBytes, ready, drafts, onClose, onOpenDraft, onReload, onChange, embedded, closeRequestRef, localDraftId: initialLocalDraftId, offline, documents, word, sessionKey, roomId, headerSlot, }: MailComposerFormProps): import("react").JSX.Element;
+export declare function MailComposerForm({ account, initial, maxBytes, ready, drafts, onClose, onOpenDraft, onReload, onChange, embedded, closeRequestRef, localDraftId: initialLocalDraftId, offline, documents, recipients, word, sessionKey, roomId, headerSlot, }: MailComposerFormProps): import("react").JSX.Element;

package/dist/connection/mail/MailRecipientInput.d.ts

@@ -0,0 +1,14 @@
+import { type InputHTMLAttributes } from 'react';
+import type { MailRecipientSuggestions } from './types';
+type InputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange'>;
+export interface MailRecipientInputProps extends InputProps {
+    value: string;
+    onValueChange: (value: string) => void;
+    suggestions: MailRecipientSuggestions;
+}
+/**
+ * A To / Cc / Bcc field that suggests people as you type the current address (a combobox: arrows move,
+ * Enter picks, Escape dismisses). Picking replaces the address being typed and leaves room for the next one.
+ */
+export declare function MailRecipientInput({ value, onValueChange, suggestions: source, className, ...input }: MailRecipientInputProps): import("react").JSX.Element;
+export {};

package/dist/connection/mail/index.d.ts

@@ -4,4 +4,4 @@ export { ConnectedMailMessage, type ConnectedMailMessageProps } from './Connecte
 export { resolveMailbox } from './mailbox';
 export { ConnectedMailAccounts, type ConnectedMailAccountsProps, type MailAliasUser, } from './ConnectedMailAccounts';
 export { ConnectedMailSetup } from './ConnectedMailSetup';
-export type { MailLocalDraft, MailOutboxEntry, MailOutboxRequest, MailOfflineSupport, MailDocumentSource, MailSaveToWorkspace, MailPanelProps, MailWordEditor, } from './types';
+export type { MailLocalDraft, MailOutboxEntry, MailOutboxRequest, MailOfflineSupport, MailDocumentSource, MailRecipientSuggestions, MailSaveToWorkspace, MailPanelProps, MailWordEditor, } from './types';

package/dist/connection/mail/types.d.ts

@@ -59,6 +59,16 @@ export interface MailOfflineSupport {
     /** The request never got an answer (no connection), as opposed to the server refusing it. */
     isNetworkFailure(error: unknown): boolean;
 }
+/**
+ * People to suggest while an address is typed in To / Cc / Bcc. `useSuggestions` is a hook (called on every
+ * render with the address being typed, '' for none): pass a stable object (e.g. a module constant).
+ */
+export interface MailRecipientSuggestions {
+    useSuggestions(query: string): {
+        email: string;
+        name?: string | null;
+    }[];
+}
 /** The open workspace's documents, attachable to an email as their files. */
 export interface MailDocumentSource {
     documents: MailAttachableDocument[];

package/dist/connection/search/ConnectedSearchPage.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The Smart Search page, connected: search the open workspace's documents for passages
+ * (`useSemanticSearch` over the shared search session, so results outlive the page), group them
+ * by document or list them by relevance, cut them by a relevance threshold, open a passage in the
+ * host's viewer (`BlocksEnvironment.openDocument`), and label every listed document.
+ *
+ * Runs under any host (`useConnectedWorkspace`). What it searches is the host's to narrow: pass
+ * `scope` (the filtered documents and the filter control); without it the page searches the whole
+ * workspace. A host can also bring its own document chip and empty-workspace surface.
+ */
+import { type ReactNode } from 'react';
+import { type ConnectedDocument } from '../workspaceData';
+import { type SearchRowLabels } from './SearchResultRows';
+/** What the page searches: the host's narrowed document set and the control that narrows it. */
+export interface SearchScope {
+    /** The documents to search; `null` searches the whole workspace (nothing narrowed). */
+    docIds: string[] | null;
+    /** How many documents are in scope (the tab's count, the intro's "N documents"). */
+    count: number;
+    /** The filter control, shown in the tab's actions on the standalone page. */
+    filter?: ReactNode;
+    /** Hover handlers of the filter control, attached to the whole tab. */
+    filterHoverHandlers?: {
+        onMouseEnter: () => void;
+        onMouseLeave: () => void;
+    };
+}
+export interface SearchDocumentChipProps {
+    docId: string;
+    /** The document from the open workspace's list, when it is there. */
+    doc?: ConnectedDocument;
+}
+export interface ConnectedSearchPageLabels extends SearchRowLabels {
+    tab: string;
+    /** An example query rather than an instruction: quoted phrase plus free words. */
+    placeholder: string;
+    byDoc: string;
+    byDocTitle: string;
+    byPassage: string;
+    byPassageTitle: string;
+    grouping: string;
+    offline: string;
+    tooManyDocuments: (count: number, max: number) => string;
+    /** The default name of the label made from a search. */
+    labelName: (query: string) => string;
+    labelled: (count: number, name: string) => string;
+    labelFailed: string;
+}
+export declare const DEFAULT_CONNECTED_SEARCH_PAGE_LABELS: ConnectedSearchPageLabels;
+export interface ConnectedSearchPageProps {
+    /**
+     * Shown inside a host's Files view: no tab header of its own (the host has it and the filter),
+     * and the grouping toggle on a slim row above the search box.
+     */
+    embedded?: boolean;
+    /** What to search; default the whole workspace. */
+    scope?: SearchScope;
+    /** A document's chip in a group's header; default the document's entity pill. */
+    DocumentChip?: (props: SearchDocumentChipProps) => ReactNode;
+    /** Shown instead of the intro when the workspace has no documents (e.g. an upload surface). */
+    emptyWorkspace?: ReactNode;
+    labels?: Partial<ConnectedSearchPageLabels>;
+}
+export declare function ConnectedSearchPage({ embedded, scope, DocumentChip, emptyWorkspace, labels, }: ConnectedSearchPageProps): import("react").JSX.Element;