@arbidocs/blocks 0.4.147 → 0.4.151

package/dist/files/ViewerChrome.d.ts

@@ -62,7 +62,8 @@ export interface ViewerTitleProps {
 export declare function ViewerTitle({ title, shared, versionLabel, shrink, labels, sharedTestId, }: ViewerTitleProps): import("react").JSX.Element;
 export interface ViewerImageActionsProps {
     compact: boolean;
-    onUseAsReference: () => void;
+    /** Start a generation from the image. Omitted: not offered. */
+    onUseAsReference?: () => void;
     onCrop: () => void;
     labels?: Partial<ViewerLabels>;
     testIds?: Partial<{
@@ -100,8 +101,8 @@ export interface ViewerZoomControlProps {
     }>;
 }
 /**
- * One small zoom button for touch devices (desktop has no zoom control: the page already fits
- * the width). It stays quiet at fit width and shows the level once zoomed; pinch and double-tap
- * work alongside it.
+ * The viewer's zoom button, on every pointer: a docked panel on a desktop screen still leaves the
+ * text too small to read, so mouse users need a way to enlarge it too. It stays quiet at fit width
+ * and shows the level once zoomed; pinch and double-tap work alongside it.
  */
 export declare function ViewerZoomControl({ zoom, onCycle, labels, testIds }: ViewerZoomControlProps): import("react").JSX.Element;

package/dist/files/ViewerControlBar.d.ts

@@ -0,0 +1,12 @@
+import type { ReactElement, ReactNode } from 'react';
+export interface ViewerControlBarProps {
+    /** The viewer body. It scrolls in the space above the bar, never underneath it. */
+    children: ReactNode;
+    /** Page and zoom controls. Without them no bar is drawn and the body fills the pane. */
+    controls?: ReactNode;
+}
+/**
+ * Lays the viewer's page and zoom controls in a bar of their own below the body. The body stops
+ * above the bar, so the controls never sit over the text being read, even while the reader pauses.
+ */
+export declare function ViewerControlBar({ children, controls }: ViewerControlBarProps): ReactElement;

package/dist/files/doc-labels.d.ts

@@ -0,0 +1,35 @@
+/**
+ * A document's labels as the viewer's label bar shows them: one entry per doctag with the passages
+ * it marks in THIS document, and the bar itself (`DocumentLabelBar`). Chips mark which labels the
+ * document carries and, in the text view (`onSelect`), toggle the active label; the stepper walks
+ * the active label's passages (the PDF mounts the bar read-only, without either).
+ */
+import type { components } from '@arbidocs/client';
+type Tag = Pick<components['schemas']['TagResponse'], 'external_id' | 'name'>;
+type ScopedTag = Pick<components['schemas']['TagResponse'], 'kind' | 'doctag_count' | 'facttag_count'>;
+/**
+ * A label of the documents' vocabulary: a plain label (not an issue, entity or saved search) used
+ * on documents, or not used anywhere yet (a label used only on facts belongs to the facts').
+ */
+export declare function isDocumentLabel(tag: ScopedTag): boolean;
+type DocTag = Pick<components['schemas']['DocTagResponse'], 'tag_ext_id' | 'note' | 'citations'>;
+export interface DocTagSummary {
+    tagExtId: string;
+    name: string;
+    /** Passages in THIS document carrying the label. */
+    chunkIds: string[];
+    hasNote: boolean;
+}
+/** One entry per doctag on the document, in workspace-tag order. */
+export declare function summariseDocTags(doctags: readonly DocTag[], workspaceTags: readonly Tag[]): DocTagSummary[];
+export interface DocumentLabelBarProps {
+    summaries: DocTagSummary[];
+    activeTagExtId?: string | null;
+    /** Position within the active label's passages, 0-based. */
+    cursor?: number;
+    /** When given, chips toggle the active label (text view only). */
+    onSelect?: (tagExtId: string | null) => void;
+    onStep?: (delta: number) => void;
+}
+export declare function DocumentLabelBar({ summaries, activeTagExtId, cursor, onSelect, onStep, }: DocumentLabelBarProps): import("react").JSX.Element;
+export {};

package/dist/files/grid/FilterButton.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Filter button for custom AG Grid header components.
+ * Uses AG Grid's own CSS classes (ag-header-icon, ag-icon-filter) so it is
+ * visually identical to the native filter button shown on standard columns.
+ */
+import type { IHeaderParams } from 'ag-grid-community';
+interface FilterButtonProps {
+    params: IHeaderParams;
+    colId: string;
+}
+export declare const FilterButton: ({ params, colId }: FilterButtonProps) => import("react").JSX.Element;
+export {};

package/dist/files/grid/RowDensityControl.d.ts

@@ -0,0 +1,18 @@
+/**
+ * RowDensityControl
+ *
+ * Row-height adjuster for the documents AND facts tables. It steps in whole
+ * TEXT LINES, not arbitrary pixels: the grid (packages/arbi-blocks GridView)
+ * clamps a multiline cell to `floor((rowHeight - chrome) / lineHeight)` lines,
+ * so a px-based step smaller than a line would grow the row while revealing only
+ * a sliver of the next line (text cut in half). Snapping every value to a line
+ * boundary makes each increment add exactly one fully-visible line.
+ */
+interface RowDensityControlProps {
+    rowHeight: number;
+    onRowHeightChange: (height: number) => void;
+    /** Testid stem — "documents-density" (default) keeps the original ids. */
+    testId?: string;
+}
+export declare function RowDensityControl({ rowHeight, onRowHeightChange, testId, }: RowDensityControlProps): import("react").JSX.Element;
+export {};

package/dist/files/grid/row-density.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Row-height ⇄ line-count math shared by the documents and facts tables.
+ *
+ * The grid (packages/arbi-blocks GridView) clamps a multiline cell to
+ * `floor((rowHeight - chrome) / lineHeight)` fully-visible lines. Snapping every
+ * density value to a line boundary makes each step add exactly one whole line
+ * instead of growing the row while clipping the next line in half.
+ *
+ * The constants MUST match packages/arbi-blocks/src/components/GridView.tsx.
+ */
+/** One multiline line: grid font-size (14) × its line-height (1.35) = 18.9px. */
+export declare const LINE_PX: number;
+/** Fixed per-row chrome: 16px vertical padding + 2px border. */
+export declare const CHROME = 18;
+export declare const MIN_LINES = 1;
+export declare const MAX_LINES = 10;
+/**
+ * Row height (px) that renders exactly `lines` fully-visible text lines. Uses
+ * `ceil` (not `round`) so the value never lands just BELOW a boundary, where the
+ * grid's own `floor` would drop back to `lines - 1`.
+ */
+export declare const rowHeightForLines: (lines: number) => number;
+/** How many whole lines a given row height renders as — the grid's own formula,
+ *  so the density slider position matches what's actually on screen. */
+export declare const linesForRowHeight: (height: number) => number;
+export declare const ROW_MIN: number;
+export declare const ROW_MAX: number;