@arbidocs/blocks 0.4.77 → 0.4.79

package/dist/connection/ConnectedTagMatrix.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `TagMatrix` bound to the connection: a parent label's children from `useTagMatrix`, cells saved
+ * with `useUpdateTagFields`, "Add row" creating a child label, the workspace's people for person
+ * columns, and the export filed in the workspace as a Markdown document (its id goes to
+ * `onExported`, so a host can open it or send it for signature).
+ */
+import { type TagMatrixProps } from '../tags/TagMatrix';
+export interface ConnectedTagMatrixProps extends Pick<TagMatrixProps, 'onOpenDocument' | 'onOpenFact' | 'onOpenRow' | 'actions' | 'labels' | 'className' | 'testId'> {
+    /** The parent label whose children are the rows (`tag-…`). */
+    parentId: string;
+    /** How many documents and facts each row lists (the rest are counted). Default 3. */
+    linksLimit?: number;
+    /** The exported document's title; default the parent label's name. */
+    exportTitle?: string;
+    /** The snapshot was filed: its document id. Absent: no export button. */
+    onExported?: (documentId: string) => void;
+    /** Read only: no cell edits, no "Add row". */
+    readOnly?: boolean;
+}
+export declare function ConnectedTagMatrix({ parentId, linksLimit, exportTitle, onExported, readOnly, ...props }: ConnectedTagMatrixProps): import("react").JSX.Element;

package/dist/connection/ConnectedWorkflowRunner.d.ts

@@ -12,6 +12,10 @@ import { type UseWorkflowThreadOptions } from './useWorkflowThread';
 import { type WorkflowRunnerDialogLabels } from './WorkflowRunnerDialogs';
 export interface ConnectedWorkflowRunnerLabels {
     notify: string;
+    /** An agent step's answer, in the thread layout: a link to it in the thread. */
+    showInThread: string;
+    /** The thread layout's panel toggle, when the panel folds (a narrow container). */
+    currentStep: string;
     /** A finished step whose answer is still being fetched. */
     loadingAnswer: string;
     notified: string;
@@ -39,7 +43,15 @@ export interface ConnectedWorkflowRunnerProps extends Omit<WorkflowRunnerProps,
      */
     actions?: Pick<WorkflowRunnerActions, 'sign' | 'openRedline' | 'openReview'>;
     dialogLabels?: Partial<WorkflowRunnerDialogLabels>;
+    /**
+     * `thread` (default): once the run has its thread, the page is that thread, live (follow-ups,
+     * answers with their sources, documents), with the step bar on top and the current step in a
+     * compact panel beside it; steps' answers link to their message instead of being repeated.
+     * Before the thread exists (the first form), and with `guided`, it is the stepper: one step at
+     * a time, each answer shown in full.
+     */
+    layout?: 'thread' | 'guided';
 }
-export declare function ConnectedWorkflowRunner({ workflow, options, onOpenConversation, emptyHint, connectedLabels, onOpenDocument, onOpenDraft, onOpenMessage, actions: hostActions, dialogLabels, testIdPrefix, ...runnerProps }: ConnectedWorkflowRunnerProps): import("react").JSX.Element;
+export declare function ConnectedWorkflowRunner({ workflow, options, onOpenConversation, emptyHint, connectedLabels, onOpenDocument, onOpenDraft, onOpenMessage, actions: hostActions, dialogLabels, layout, testIdPrefix, ...runnerProps }: ConnectedWorkflowRunnerProps): import("react").JSX.Element;
 /** A document's processing status as the upload step shows it; unknown stays unknown. */
 export declare function fileStatus(status: string | null | undefined): WorkflowRunnerFile['status'];

package/dist/connection/WorkflowRunThread.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A workflow run's thread, live and interactive: the blocks `ChatPage` held to the run's one
+ * conversation (people ask follow-ups, see the answers and their sources, open documents), with
+ * the current step's panel beside it (`aside`). Step messages show as their step's chip.
+ */
+import { type ReactNode } from 'react';
+import type { ChatCitationTarget, ChatPageLabels } from '../chat/chat-page-types';
+export interface WorkflowRunThreadProps {
+    conversationId: string;
+    workspaceId: string | undefined;
+    /** The current step's panel. */
+    aside?: ReactNode;
+    /** A step's title by id (step messages show it). */
+    stepTitle?: (stepId: string) => string | undefined;
+    /** Scroll to and mark this message (a step's answer). */
+    targetMessageId?: string;
+    onOpenCitation?: (target: ChatCitationTarget) => void;
+    labels?: Partial<ChatPageLabels>;
+    className?: string;
+}
+export declare function WorkflowRunThread({ conversationId, workspaceId, aside, stepTitle, targetMessageId, onOpenCitation, labels, className, }: WorkflowRunThreadProps): import("react").JSX.Element;

package/dist/databases/ColumnConfigFields.d.ts

@@ -0,0 +1,68 @@
+import { type DatabaseColumnView, type DatabaseRollupOp, type DatabaseSummaryView } from './column-types';
+export interface ColumnConfigLabels {
+    relatedDatabase: string;
+    pickDatabase: string;
+    noDatabases: string;
+    targetFixed: string;
+    thisDatabase: string;
+    showOnTarget: (target: string) => string;
+    showOnTargetHint: string;
+    pairName: string;
+    pairNamePlaceholder: (name: string) => string;
+    pairedWith: (target: string) => string;
+    oneWay: string;
+    relation: string;
+    pickRelation: string;
+    noRelations: string;
+    lookupColumn: string;
+    pickColumn: string;
+    noColumns: string;
+    rollupOp: string;
+    rollupColumn: string;
+    noNumberColumns: string;
+    ops: Record<DatabaseRollupOp, string>;
+}
+export declare const DEFAULT_COLUMN_CONFIG_LABELS: ColumnConfigLabels;
+export interface RelationDraft {
+    database_id: string;
+    two_way: boolean;
+    pair_name: string;
+}
+export interface LookupDraft {
+    relation: string;
+    column: string;
+}
+export interface RollupDraft {
+    relation: string;
+    column: string;
+    op: DatabaseRollupOp;
+}
+export declare function RelationFields({ draft, onChange, databases, databaseId, databaseName, editing, column, labels, }: {
+    draft: RelationDraft;
+    onChange: (draft: RelationDraft) => void;
+    databases: DatabaseSummaryView[];
+    databaseId?: string;
+    databaseName?: string;
+    editing: boolean;
+    column?: DatabaseColumnView | null;
+    labels: ColumnConfigLabels;
+}): import("react").JSX.Element;
+/** The relation columns of this database, and the columns of a relation's target. */
+export declare function relationColumnsOf(columns: DatabaseColumnView[]): DatabaseColumnView[];
+export declare function targetColumnsOf(relationId: string, columns: DatabaseColumnView[], databases: DatabaseSummaryView[], databaseId?: string): DatabaseColumnView[];
+export declare function LookupFields({ draft, onChange, columns, databases, databaseId, labels, }: {
+    draft: LookupDraft;
+    onChange: (draft: LookupDraft) => void;
+    columns: DatabaseColumnView[];
+    databases: DatabaseSummaryView[];
+    databaseId?: string;
+    labels: ColumnConfigLabels;
+}): import("react").JSX.Element;
+export declare function RollupFields({ draft, onChange, columns, databases, databaseId, labels, }: {
+    draft: RollupDraft;
+    onChange: (draft: RollupDraft) => void;
+    columns: DatabaseColumnView[];
+    databases: DatabaseSummaryView[];
+    databaseId?: string;
+    labels: ColumnConfigLabels;
+}): import("react").JSX.Element;

package/dist/databases/DatabaseColumnDialog.d.ts

@@ -1,4 +1,5 @@
-import { type DatabaseColumnType, type DatabaseColumnTypeLabels, type DatabaseColumnView } from './column-types';
+import { type DatabaseColumnType, type DatabaseColumnTypeLabels, type DatabaseColumnView, type DatabaseRollupOp, type DatabaseSummaryView } from './column-types';
+import { type ColumnConfigLabels } from './ColumnConfigFields';
 export interface DatabaseColumnDialogLabels {
     addTitle: string;
     editTitle: string;
@@ -25,12 +26,35 @@ export interface DatabaseColumnDraft {
     name: string;
     type: DatabaseColumnType;
     options: string[] | null;
+    /** A new relation column's target (and paired column). Absent when editing: it cannot change. */
+    relation?: {
+        database_id: string;
+        two_way: boolean;
+        pair_name?: string | null;
+    } | null;
+    lookup?: {
+        relation: string;
+        column: string;
+    } | null;
+    rollup?: {
+        relation: string;
+        column?: string | null;
+        op: DatabaseRollupOp;
+    } | null;
 }
 export interface DatabaseColumnDialogProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
     /** The column being edited; omit to add one. */
     column?: DatabaseColumnView | null;
+    /** The database the column belongs to (relations to it are marked "this database"). */
+    databaseId?: string;
+    /** Its name: the default name of a two-way relation's paired column. */
+    databaseName?: string;
+    /** Its columns: lookups and rollups read through one of its relation columns. */
+    columns?: DatabaseColumnView[];
+    /** The databases a relation can link to (this workspace's), with their columns. */
+    databases?: DatabaseSummaryView[];
     onSave: (draft: DatabaseColumnDraft) => void;
     /** Delete the column (editing only). */
     onDelete?: () => void;
@@ -39,5 +63,6 @@ export interface DatabaseColumnDialogProps {
     error?: string | null;
     labels?: Partial<DatabaseColumnDialogLabels>;
     typeLabels?: Partial<DatabaseColumnTypeLabels>;
+    configLabels?: Partial<ColumnConfigLabels>;
 }
-export declare function DatabaseColumnDialog({ open, onOpenChange, column, onSave, onDelete, isSaving, error, labels, typeLabels, }: DatabaseColumnDialogProps): import("react").JSX.Element;
+export declare function DatabaseColumnDialog({ open, onOpenChange, column, databaseId, databaseName, columns, databases, onSave, onDelete, isSaving, error, labels, typeLabels, configLabels, }: DatabaseColumnDialogProps): import("react").JSX.Element;

package/dist/databases/DatabaseTable.d.ts

@@ -1,6 +1,7 @@
 import { type GridViewProps } from '../files/GridView';
 import { type DatabaseColumnLabels } from './databaseColumns';
 import type { DatabaseColumnView, DatabaseRowView } from './column-types';
+import type { DatabaseCellSources } from './linkCells';
 export interface DatabaseTableLabels {
     newRow: string;
     emptyTitle: string;
@@ -18,6 +19,12 @@ export interface DatabaseTableProps {
     onAddRow?: () => void;
     onAddColumn?: () => void;
     onEditColumn?: (column: DatabaseColumnView) => void;
+    /**
+     * Choices for person, document and relation cells (workspace members, documents, a search of
+     * the related database's rows) and what a document chip opens. Keep it stable (memoise it): the
+     * columns are rebuilt when it changes.
+     */
+    sources?: DatabaseCellSources;
     /** Ticked rows (for a bulk delete). With it, rows show a checkbox. */
     onSelectionChange?: (rows: DatabaseRowView[]) => void;
     selected?: DatabaseRowView[];
@@ -35,4 +42,4 @@ export interface DatabaseTableProps {
     gridProps?: Partial<Omit<GridViewProps<DatabaseRowView>, 'items' | 'columnDefs' | 'getItemId'>>;
     testId?: string;
 }
-export declare function DatabaseTable({ columns, rows, onCellChange, onAddRow, onAddColumn, onEditColumn, onSelectionChange, selected, readOnly, isFiltered, isLoading, locale, gridId, height, labels, columnLabels, gridProps, testId, }: DatabaseTableProps): import("react").JSX.Element;
+export declare function DatabaseTable({ columns, rows, onCellChange, onAddRow, onAddColumn, onEditColumn, sources, onSelectionChange, selected, readOnly, isFiltered, isLoading, locale, gridId, height, labels, columnLabels, gridProps, testId, }: DatabaseTableProps): import("react").JSX.Element;

package/dist/databases/PickCellEditor.d.ts

@@ -0,0 +1,21 @@
+import type { CustomCellEditorProps } from 'ag-grid-react';
+import { type DatabaseRowView } from './column-types';
+import { type DatabasePickOption } from './linkCells';
+export interface PickCellEditorLabels {
+    searchPlaceholder: string;
+    noMatches: string;
+    searching: string;
+    clear: string;
+    done: string;
+    remove: (label: string) => string;
+}
+export declare const DEFAULT_PICK_CELL_EDITOR_LABELS: PickCellEditorLabels;
+export interface PickCellEditorParams {
+    kind: 'person' | 'document' | 'relation';
+    /** A fixed list of choices, filtered as the user types. */
+    options?: DatabasePickOption[];
+    /** Choices from the server for a search (instead of `options`). */
+    search?: (q: string) => Promise<DatabasePickOption[]>;
+    labels?: Partial<PickCellEditorLabels>;
+}
+export declare function PickCellEditor(props: CustomCellEditorProps<DatabaseRowView> & PickCellEditorParams): import("react").JSX.Element;

package/dist/databases/column-types.d.ts

@@ -2,24 +2,63 @@
  * Databases: the shapes the blocks read, and the per-type rules for showing and editing a cell.
  *
  * A database is a user-defined table (a client database, billing records). Its columns are typed:
- * `text`, `number`, `date`, `checkbox` or `select`. The server checks and normalises every cell
- * (dates arrive as ISO `YYYY-MM-DD` or a full timestamp, numbers as numbers, a select as one of its
- * options), so the blocks only format for display and turn an editor's value into what the API takes.
+ * `text`, `number`, `date`, `checkbox` and `select` hold a value; `person` holds a workspace member's
+ * id (`usr-…`); `document` and `relation` hold lists of ids (documents of the workspace, rows of the
+ * target database); `lookup` (the values of a column of the related rows) and `rollup` (a number
+ * measured over them) are computed by the server and never written. The server checks and
+ * normalises every cell (dates arrive as ISO `YYYY-MM-DD` or a full timestamp, numbers as numbers, a
+ * select as one of its options) and names every id a row refers to in the row's `titles`, so the
+ * blocks only format for display and turn an editor's value into what the API takes.
  */
-export type DatabaseColumnType = 'text' | 'number' | 'date' | 'checkbox' | 'select';
+export type DatabaseColumnType = 'text' | 'number' | 'date' | 'checkbox' | 'select' | 'person' | 'document' | 'relation' | 'lookup' | 'rollup';
 /** Every type, in the order a type picker lists them. */
 export declare const DATABASE_COLUMN_TYPES: DatabaseColumnType[];
+/** Types whose cells the server computes from a relation: shown, never edited. */
+export declare const COMPUTED_COLUMN_TYPES: ReadonlySet<DatabaseColumnType>;
+/** Types whose cells are lists of ids (written as a list that replaces the cell's links). */
+export declare const LINK_COLUMN_TYPES: ReadonlySet<DatabaseColumnType>;
+export declare const isComputedColumn: (column: Pick<DatabaseColumnView, "type">) => boolean;
+export type DatabaseRollupOp = 'count' | 'sum' | 'avg' | 'min' | 'max';
+export declare const DATABASE_ROLLUP_OPS: DatabaseRollupOp[];
+/**
+ * A relation column's target. A `two_way` column has a paired column on the target database
+ * (`pair_column_id`) showing the same links from the other side; `reverse` marks the paired side.
+ */
+export interface DatabaseRelationView {
+    database_id: string;
+    two_way?: boolean;
+    pair_column_id?: string | null;
+    reverse?: boolean;
+}
+/** A lookup: `column` of the target database, read through this database's `relation` column. */
+export interface DatabaseLookupView {
+    relation: string;
+    column: string;
+}
+/** A rollup: `op` over the rows linked through `relation` (`column`: a number column, not for count). */
+export interface DatabaseRollupView {
+    relation: string;
+    column?: string | null;
+    op?: DatabaseRollupOp;
+}
 /** A column as the blocks read it (the API's `DatabaseColumn`). */
 export interface DatabaseColumnView {
     id: string;
     name: string;
     type: DatabaseColumnType;
     options?: string[] | null;
+    relation?: DatabaseRelationView | null;
+    lookup?: DatabaseLookupView | null;
+    rollup?: DatabaseRollupView | null;
 }
-/** A row as the blocks read it: cell values keyed by column id; an empty cell is absent. */
+/**
+ * A row as the blocks read it: cell values keyed by column id; an empty cell is absent. `titles`
+ * names every person, document and related row the cells refer to (id → display name).
+ */
 export interface DatabaseRowView {
     id: string;
     values: Record<string, unknown>;
+    titles?: Record<string, string>;
 }
 /** A database as a list shows it (the API's `DatabaseRead`). */
 export interface DatabaseSummaryView {
@@ -38,21 +77,46 @@ export interface DatabaseColumnTypeLabels {
     date: string;
     checkbox: string;
     select: string;
+    person: string;
+    document: string;
+    relation: string;
+    lookup: string;
+    rollup: string;
 }
 export declare const DEFAULT_DATABASE_COLUMN_TYPE_LABELS: DatabaseColumnTypeLabels;
 export declare function optionTone(option: string): string;
+/** A cell as a list: a list cell as is, a single value as a list of one, an empty cell as none. */
+export declare function cellList(value: unknown): unknown[];
+/** The ids a person, document or relation cell holds. */
+export declare function cellIds(value: unknown): string[];
+/** An id's display name from the row's titles (the id itself when the server could not name it). */
+export declare function titleOf(id: string, titles?: Record<string, string>): string;
+/** Two cell values, as the API stores them, are the same (lists compare item by item). */
+export declare function sameCellValue(a: unknown, b: unknown): boolean;
 /**
  * A stored date for display. A bare `YYYY-MM-DD` is a calendar day: it is shown from its own
  * components, never through a time zone (which would move it a day for viewers west of UTC).
  */
 export declare function formatDateValue(value: string, locale?: string): string;
 export declare function formatNumberValue(value: number, locale?: string): string;
-/** A cell as text: what a cell shows, what search and copy see. Checkboxes read as Yes/No. */
-export declare function formatCell(value: unknown, type: DatabaseColumnType, locale?: string): string;
+/**
+ * One value of a lookup cell, whose type is the looked-up column's: an id reads as its title, a
+ * number and an ISO date as their own column would show them.
+ */
+export declare function formatLookupValue(value: unknown, titles?: Record<string, string>, locale?: string): string;
+/**
+ * A cell as text: what a cell shows, what search and copy see. Checkboxes read as Yes/No; people,
+ * documents and related rows by their titles (the row's `titles`), lists joined with commas.
+ */
+export declare function formatCell(value: unknown, type: DatabaseColumnType, locale?: string, titles?: Record<string, string>): string;
 /**
  * An editor's value as the API takes it. Empty becomes `null` (which empties the cell); everything
  * else goes as typed and the server checks it, so a bad value comes back as a 422 naming the column.
+ * A document or relation cell goes as its list of ids (which replaces the cell's links).
  */
 export declare function toApiValue(value: unknown, type: DatabaseColumnType): unknown;
-/** Sort comparator for a column's stored values: empty cells last, then by type. */
-export declare function compareCells(a: unknown, b: unknown, type: DatabaseColumnType): number;
+/**
+ * Sort comparator for a column's stored values: empty cells last, then by type. People, documents,
+ * related rows and lookups sort by what they show, so pass each row's titles.
+ */
+export declare function compareCells(a: unknown, b: unknown, type: DatabaseColumnType, titlesA?: Record<string, string>, titlesB?: Record<string, string>): number;

package/dist/databases/databaseColumns.d.ts

@@ -2,10 +2,12 @@ import type { ColDef } from 'ag-grid-community';
 import { Type } from 'lucide-react';
 import { type DatabaseColumnType, type DatabaseColumnView, type DatabaseRowView } from './column-types';
 import { SelectChip } from './SelectChip';
+import { type DatabaseCellSources } from './linkCells';
 export { SelectChip };
 export interface DatabaseColumnLabels {
     addColumn: string;
     columnSettings: (name: string) => string;
+    computed: string;
 }
 export declare const DEFAULT_DATABASE_COLUMN_LABELS: DatabaseColumnLabels;
 /** colId of the trailing "add a column" column (never a database column id). */
@@ -18,6 +20,8 @@ export interface DatabaseColumnOptions {
     onEditColumn?: (column: DatabaseColumnView) => void;
     /** Add a column (the trailing "+" header). */
     onAddColumn?: () => void;
+    /** Choices for person, document and relation cells, and what a document chip opens. */
+    sources?: DatabaseCellSources;
     /** Locale for numbers and dates. */
     locale?: string;
     labels?: Partial<DatabaseColumnLabels>;