react-semaphor 0.1.514 → 0.1.516

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-DrOFJOCq.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-DcLkVqni.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-UNKSfi7s.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-Cto0vDwI.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;

package/dist/surfboard/index.js

@@ -1,6 +1,6 @@
-import { b as a, a as o } from "../chunks/index-nhUr9xBz.js";
+import { b as a, a as o } from "../chunks/index-BVVl2JDK.js";
 import { C as f, E } from "../chunks/common-types-C6cAQgyh.js";
-import { R as t } from "../chunks/report-preferences-dialog-B2fzQH1T.js";
+import { R as t } from "../chunks/report-preferences-dialog-CHXPEl7v.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

package/dist/types/briefings/index.d.ts

@@ -1,7 +1,7 @@
 import { NumericCanonicalFormat, NumericPresentationTarget, PresentationExecutionSnapshot } from '../shared/format-utils/index.js';
 import { BriefingAppearanceSpec, BriefingFragments, BriefingThemeOverrides } from './presentation-contract.js';
 import { MatrixConfig } from '../shared/analytics-protocol/index.js';
-export { captureMatrixExport, buildMatrixDeliveryEnvelope, matrixDeliveryPayloadSchema, matrixDeliveryQuerySchema } from '../shared/dashboard-authoring/matrix-delivery.js';
+export { captureMatrixExport, buildMatrixDeliveryEnvelope, matrixDeliveryPayloadSchema, matrixDeliveryQuerySchema, type MatrixLayoutReadResult } from '../shared/dashboard-authoring/matrix-delivery.js';
 export declare const BRIEFING_KIND: "BRIEFING";
 export { DEFAULT_BRIEFING_SCHEDULE, buildBriefingScheduleExpr, describeBriefingSchedule, isValidBriefingTimezone, parseBriefingScheduleExpr, type BriefingScheduleCadence, type BriefingScheduleViewModel, } from './schedule.js';
 export { getBriefingCardAttachmentCapability, getBriefingCardAttachmentFormats, getDefaultBriefingCardAttachmentFormat, type BriefingCardAttachmentCapability, } from './attachments.js';

package/dist/types/components/document-sheet/document-input-bar.d.ts

@@ -1,9 +1,8 @@
-import { ReactNode } from 'react';
 import { FilterAuthoringAcceptance, FilterAuthoringInputMetadata } from '../surfboard/filter/custom-filter-popover.js';
 import { TFilter, TFilterValue } from '../surfboard/filter/types.js';
 import { DocumentFilterMode } from '../../lib/document/document-input-runtime.js';
 import { ControlDefinition, DocumentInputDefinition, NormalizedDashboardInput } from '../../lib/types/common-types.js';
-export declare function DocumentInputBar({ className, sheetId, inputs, dashboardInputsById, filterValuesByInputId, filterModesByInputId, documentFilterValues, documentControlValues, onSetFilterValue, onSetFilterMode, onUpdateFilterInput, onUpdateControlInput, onRemoveFilterValue, onRemoveInput, onReorderInputs, controlValuesByInputId, onSetControlValue, actions, isEditing, }: {
+export declare function DocumentInputBar({ className, sheetId, inputs, dashboardInputsById, filterValuesByInputId, filterModesByInputId, documentFilterValues, documentControlValues, onSetFilterValue, onSetFilterMode, onUpdateFilterInput, onUpdateControlInput, onRemoveFilterValue, onRemoveInput, onReorderInputs, controlValuesByInputId, onSetControlValue, isEditing, }: {
     className?: string;
     /** The document sheet these inputs belong to; the target scope for options. */
     sheetId: string;
@@ -27,6 +26,5 @@ export declare function DocumentInputBar({ className, sheetId, inputs, dashboard
     onReorderInputs?: (orderedInputIds: string[]) => void;
     controlValuesByInputId: Record<string, unknown>;
     onSetControlValue: (inputId: string, value: unknown) => void;
-    actions?: ReactNode;
     isEditing?: boolean;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/document-sheet/document-insert-picker.d.ts

@@ -0,0 +1,37 @@
+import { ReactNode } from 'react';
+import { AddableDocumentSectionType } from '../../lib/document/document-section-utils.js';
+import { DashboardCardLocation } from '../../shared/dashboard-authoring/document-section-cards.js';
+export type DocumentInsertChoice = {
+    kind: 'section';
+    type: AddableDocumentSectionType;
+} | {
+    kind: 'copy';
+    source: DashboardCardLocation;
+};
+/**
+ * The one way to add a section: kind first (Data, Content, Layout), then
+ * "Copy from this dashboard". It opens from the outline's Add button, the
+ * gutters between sections, and the empty page. Section kinds come from the
+ * registry, and copyable cards from `listCopyableDocumentCardLocations`, so
+ * the picker never offers what an edit would refuse.
+ */
+export declare function DocumentInsertPicker({ onChoose, className, }: {
+    onChoose: (choice: DocumentInsertChoice) => void;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * The picker in a popover on any trigger. A choice runs only after the
+ * popover has closed and unmounted (`onCloseAutoFocus`). Adding a data section
+ * opens the full-screen editor, which hides the document in a React
+ * <Activity>; this portaled content sits outside that tree, and an unmount
+ * scheduled while the document is hidden would be deferred, leaving the
+ * picker stuck on screen.
+ */
+export declare function DocumentInsertPickerPopover({ open, onOpenChange, trigger, onChoose, align, side, }: {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    trigger: ReactNode;
+    onChoose: (choice: DocumentInsertChoice) => void;
+    align?: 'start' | 'center' | 'end';
+    side?: 'top' | 'bottom' | 'left' | 'right';
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/document-sheet/document-kpi-section.d.ts

@@ -0,0 +1,17 @@
+import { DocumentSectionRuntime } from '../../lib/document/document-section-query-options.js';
+import { DocumentKpiSection } from '../../lib/types/common-types.js';
+export type EditDocumentKpiCard = (section: DocumentKpiSection, cardId: string) => void;
+type DocumentKpiSectionProps = {
+    section: DocumentKpiSection;
+    runtime: DocumentSectionRuntime;
+    isEditing: boolean;
+    onEditKpiCard?: EditDocumentKpiCard;
+};
+/**
+ * A KPI section on a Document page: one query per KPI card, printed as a row
+ * of tiles or as label and value lines. The section's height is fixed by
+ * `document-kpi-layout`, so pagination places it exactly and never splits it.
+ */
+declare function DocumentKpiSectionRendererImpl({ section, runtime, isEditing, onEditKpiCard, }: DocumentKpiSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare const DocumentKpiSectionRenderer: import('react').MemoExoticComponent<typeof DocumentKpiSectionRendererImpl>;
+export {};

package/dist/types/components/document-sheet/document-matrix-layout-context.d.ts

@@ -0,0 +1,10 @@
+import { DocumentMatrixFit } from '../../lib/document/document-matrix-bands.js';
+/** What the measuring layer found for a Matrix section (Plan 2, N1 and B2). */
+export type DocumentMatrixLayout = {
+    /** Each column's width over the whole result. */
+    columnWidthsPx?: readonly number[];
+    /** How the Matrix fits the page body: one table, bands, or too wide. */
+    matrixFit?: DocumentMatrixFit;
+};
+/** The measuring layer's Matrix layouts by section id; page slices draw them. */
+export declare const DocumentMatrixLayoutContext: import('react').Context<Readonly<Record<string, DocumentMatrixLayout | undefined>>>;

package/dist/types/components/document-sheet/document-matrix-section.d.ts

@@ -0,0 +1,27 @@
+import { DocumentTableRowCountChange, DocumentTableSlice } from '../../lib/document/document-pagination.js';
+import { DocumentTableLayoutMeasurement } from '../../lib/document/document-table-print-model.js';
+import { ControlDefinition, DashboardInputValues, DocumentTableSection } from '../../lib/types/common-types.js';
+import { TFilterValue } from '../surfboard/filter/types.js';
+type DocumentMatrixSectionProps = {
+    section: DocumentTableSection;
+    documentFilterValues: TFilterValue[];
+    documentControlDefinitions: ControlDefinition[];
+    documentControlValues: Record<string, unknown>;
+    documentDashboardInputValues?: DashboardInputValues;
+    tableSlice?: DocumentTableSlice;
+    initialRowsPerPageLimit?: number;
+    surfaceMode: 'preview' | 'print';
+    onTableRowCountChange?: DocumentTableRowCountChange;
+    onTableLayoutMeasure?: (sectionId: string, measurement: DocumentTableLayoutMeasurement) => void;
+    onTableLayoutInvalidate?: (sectionId: string) => void;
+    measurementScale: number;
+};
+/**
+ * A Matrix section: the full result from one delivery-authorized layout read
+ * (tech spec D-M1), drawn as a static table in the document table surface and
+ * paginated like any table section. It never mounts the windowed Matrix
+ * viewer, and it never prints part of a result: a failed read fails the
+ * section, and a scheduled PDF with it.
+ */
+export declare function DocumentMatrixSection(props: DocumentMatrixSectionProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/document-sheet/document-measure-layer.d.ts

@@ -0,0 +1,45 @@
+import { ReactNode } from 'react';
+import { DocumentTableRowCountChange } from '../../lib/document/document-pagination.js';
+import { DocumentTableLayoutMeasurement } from '../../lib/document/document-table-print-model.js';
+import { ControlDefinition, DashboardInputValues, DocumentTableSection } from '../../lib/types/common-types.js';
+import { TFilterValue } from '../surfboard/filter/types.js';
+/** Rows a flat table draws per measuring pass; its column widths are fixed. */
+export declare const DOCUMENT_TABLE_MEASURE_CHUNK_ROWS = 500;
+export type DocumentRegionHeights = {
+    header?: number;
+    footer?: number;
+};
+type DocumentMeasureLayerProps = {
+    /** The paginated Table and Matrix sections. */
+    sections: readonly DocumentTableSection[];
+    /** The page body width, in page pixels. */
+    bodyWidthPx: number;
+    /** The zoom the page is drawn at; the layer cancels it. */
+    measurementScale: number;
+    surfaceMode: 'preview' | 'print';
+    /** Holds the PDF (print) until every section is measured (N3). */
+    isMeasuring: boolean;
+    header: ReactNode;
+    footer: ReactNode;
+    documentFilterValues: TFilterValue[];
+    documentControlDefinitions: ControlDefinition[];
+    documentControlValues: Record<string, unknown>;
+    documentDashboardInputValues?: DashboardInputValues;
+    previewRowLimitsBySectionId: Record<string, number>;
+    defaultPreviewRowLimit: number;
+    onTableRowCountChange: DocumentTableRowCountChange;
+    onTableLayoutMeasure: (sectionId: string, measurement: DocumentTableLayoutMeasurement) => void;
+    onTableLayoutInvalidate: (sectionId: string) => void;
+    onRegionHeightsChange: (heights: DocumentRegionHeights) => void;
+};
+/**
+ * The Document's single source of layout measurements (Plan 2, N1). It draws
+ * every paginated Table and Matrix section once, off the page, at page body
+ * width and without the canvas zoom, on the canvas and in print alike, so
+ * both paginate from the same numbers. Visible pages only draw.
+ *
+ * The layer is a zero-size, clipped, hidden box: it takes no space, never
+ * prints and is never announced, but its content is still laid out.
+ */
+export declare function DocumentMeasureLayer({ sections, bodyWidthPx, measurementScale, surfaceMode, isMeasuring, header, footer, onRegionHeightsChange, ...sectionProps }: DocumentMeasureLayerProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/document-sheet/document-outline.d.ts

@@ -1,7 +1,8 @@
+import { DashboardCardLocation } from '../../shared/dashboard-authoring/document-section-cards.js';
 import { AddableDocumentSectionType } from '../../lib/document/document-section-utils.js';
 import { DocumentInputDefinition, DocumentSection } from '../../lib/types/common-types.js';
 export type DocumentSectionDropPlacement = 'before' | 'after';
-export declare function DocumentOutline({ sections, inputs, selectedSectionId, onSelectSection, onDeleteSection, onReorderSection, onInsertSection, }: {
+export declare function DocumentOutline({ sections, inputs, selectedSectionId, onSelectSection, onDeleteSection, onReorderSection, onInsertSection, onCopyCard, startPageBySectionId, }: {
     sections: DocumentSection[];
     inputs: DocumentInputDefinition[];
     selectedSectionId: string | null;
@@ -12,4 +13,9 @@ export declare function DocumentOutline({ sections, inputs, selectedSectionId, o
      * "+ Add" entry replaces the inline + Add buttons that used to sit
      * between every section on the canvas. */
     onInsertSection?: (type: AddableDocumentSectionType) => void;
+    /** Append a copy of a dashboard card as a new section. */
+    onCopyCard?: (source: DashboardCardLocation) => void;
+    /** The page each section starts on. Every page is measured, whichever
+     * page is shown, so these are the printed pages. */
+    startPageBySectionId?: Record<string, number>;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/document-sheet/document-page-navigation.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The Document pager, floating at the bottom of the canvas in the editor and
+ * the viewer. It sits on the app canvas, not the paper, so it follows the
+ * theme: a 28px (h-7) shell like every Document toolbar control, with a
+ * hairline and the floating-menu shadow; the buttons and the page field sit
+ * inside it with the chip radius (BRAND.md, TOKENS.md).
+ */
+export declare function DocumentPageNavigation({ pageNumber, pageCount, onGoToPage, }: {
+    pageNumber: number;
+    pageCount: number;
+    /** Any page; the caller clamps it to the Document's pages. */
+    onGoToPage: (pageNumber: number) => void;
+}): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * The pager's "n / N": the page number is a field, so a reader can type a
+ * page and press Enter to go to it. Escape or an empty field keeps the page.
+ */
+export declare function DocumentPageNumberInput({ pageNumber, pageCount, onGoToPage, }: {
+    pageNumber: number;
+    pageCount: number;
+    onGoToPage: (pageNumber: number) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/document-sheet/document-page.d.ts

@@ -1,12 +1,13 @@
-import { ReactNode } from 'react';
+import { DocumentMatrixFit } from '../../lib/document/document-matrix-bands.js';
 import { AddableDocumentSectionType } from '../../lib/document/document-section-utils.js';
 import { DocumentTextRenderContext } from '../../lib/document/document-variables.js';
 import { DocumentTableResultColumnsChange } from '../../lib/document/document-table-result-columns.js';
 import { DocumentFilterMode } from '../../lib/document/document-input-runtime.js';
+import { EditDocumentKpiCard } from './document-kpi-section.js';
 import { TFilterValue } from '../surfboard/filter/types.js';
 import { DashboardInputValues, DocumentControlInputDefinition, DocumentDefinition, DocumentInputDefinition, NormalizedDashboardInput, DocumentTableSection } from '../../lib/types/common-types.js';
 type UpdateDocumentTableSection = (sectionId: string, updater: (section: DocumentTableSection) => DocumentTableSection) => void;
-export declare function DocumentViewerSurface({ sheetId, document, inputs, dashboardInputsById, textRenderContext, filterValuesByInputId, filterModesByInputId, documentFilterValues, documentControlDefinitions, documentControlValues, documentDashboardInputValues, missingRequiredInputLabels, onSetFilterValue, onSetFilterMode, onRemoveFilterValue, controlValuesByInputId, onSetControlValue, actions, }: {
+export declare function DocumentViewerSurface({ sheetId, document, inputs, dashboardInputsById, textRenderContext, filterValuesByInputId, filterModesByInputId, documentFilterValues, documentControlDefinitions, documentControlValues, documentDashboardInputValues, missingRequiredInputLabels, onSetFilterValue, onSetFilterMode, onRemoveFilterValue, controlValuesByInputId, onSetControlValue, }: {
     /** The document sheet being viewed; the target scope for its inputs. */
     sheetId: string;
     document: DocumentDefinition;
@@ -25,7 +26,6 @@ export declare function DocumentViewerSurface({ sheetId, document, inputs, dashb
     onRemoveFilterValue: (inputId: string) => void;
     controlValuesByInputId: Record<string, unknown>;
     onSetControlValue: (inputId: string, value: unknown) => void;
-    actions?: ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
 export declare function DocumentPrintSurface({ document, inputs, textRenderContext, documentFilterValues, documentControlDefinitions, documentControlValues, documentDashboardInputValues, missingRequiredInputLabels, }: {
     document: DocumentDefinition;
@@ -37,7 +37,7 @@ export declare function DocumentPrintSurface({ document, inputs, textRenderConte
     documentDashboardInputValues?: DashboardInputValues;
     missingRequiredInputLabels: string[];
 }): import("react/jsx-runtime").JSX.Element;
-export declare function DocumentPage({ document, inputs, textRenderContext, documentFilterValues, documentControlDefinitions, documentControlValues, documentDashboardInputValues, missingRequiredInputLabels, isEditing, selectedSectionId, activeAddIndex, onSelectSection, onToggleAddIndex, onInsertSection, onEditTableSection, onUpdateTableSection, onTableResultColumnsChange, onReorderSection, pageNumber, onPageCountChange, surfaceMode, measurementScale, }: {
+export declare function DocumentPage({ document, inputs, textRenderContext, documentFilterValues, documentControlDefinitions, documentControlValues, documentDashboardInputValues, missingRequiredInputLabels, isEditing, selectedSectionId, activeAddIndex, onSelectSection, onToggleAddIndex, onInsertSection, onEditKpiCard, onUpdateTableSection, onTableResultColumnsChange, onReorderSection, pageNumber, onPageCountChange, onSectionStartPagesChange, onMatrixFitsChange, surfaceMode, measurementScale, }: {
     document: DocumentDefinition;
     inputs: DocumentInputDefinition[];
     textRenderContext: DocumentTextRenderContext;
@@ -52,12 +52,16 @@ export declare function DocumentPage({ document, inputs, textRenderContext, docu
     onSelectSection?: (sectionId: string | null) => void;
     onToggleAddIndex?: (index: number | null) => void;
     onInsertSection?: (type: AddableDocumentSectionType, insertIndex: number) => void;
-    onEditTableSection?: (section: DocumentTableSection) => void;
+    onEditKpiCard?: EditDocumentKpiCard;
     onUpdateTableSection?: UpdateDocumentTableSection;
     onTableResultColumnsChange?: DocumentTableResultColumnsChange;
     onReorderSection?: (draggedSectionId: string, targetSectionId: string, placement: 'before' | 'after') => void;
     pageNumber?: number;
     onPageCountChange?: (pageCount: number) => void;
+    /** The page each section starts on (1-based), for the outline. */
+    onSectionStartPagesChange?: (startPageBySectionId: Record<string, number>) => void;
+    /** How each Matrix section fits the page, for the section panel (2c). */
+    onMatrixFitsChange?: (fitBySectionId: Record<string, DocumentMatrixFit>) => void;
     surfaceMode?: 'preview' | 'print';
     measurementScale?: number;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/document-sheet/document-panel/document-side-panel.d.ts

@@ -0,0 +1,36 @@
+import { ReactNode } from 'react';
+import { DocumentEdit } from '../../../lib/document/document-edits.js';
+import { DocumentPanelTarget } from '../../../lib/document/document-panel-target.js';
+import { DocumentTableResultColumnCacheEntry } from '../../../lib/document/document-table-result-columns.js';
+import { DocumentDefinition, DocumentFooterRegion, DocumentHeaderRegion, DocumentKpiSection, DocumentPageSetup, DocumentSection, DocumentTableSection } from '../../../lib/types/common-types.js';
+import { DocumentMatrixFit } from '../../../lib/document/document-matrix-bands.js';
+/**
+ * The Document side panel. It follows the panel target:
+ * - `document`: Page, Header and footer, and Inputs, as stacked groups;
+ * - `header` and `footer`: the region's settings;
+ * - `section`: the selected section's settings.
+ * The header and footer are selected by clicking them on the page.
+ */
+export declare function DocumentSidePanel({ sheetId, target, onTargetChange, document, selectedSection, inputSourceSection, tableResultColumnCacheBySectionId, onSelectInputSourceSection, onUpdatePage, matrixFits, onUpdateSelectedSection, onUpdateHeader, onUpdateFooter, onEditTableSection, onEditKpiCard, onAddKpiCard, onEditSection, actions, }: {
+    sheetId: string;
+    target: DocumentPanelTarget;
+    onTargetChange: (target: DocumentPanelTarget) => void;
+    document: DocumentDefinition;
+    selectedSection: DocumentSection | null;
+    inputSourceSection: DocumentSection | null;
+    tableResultColumnCacheBySectionId: Record<string, DocumentTableResultColumnCacheEntry>;
+    /** Choose the table whose fields the Inputs group offers, without leaving it. */
+    onSelectInputSourceSection: (sectionId: string | null) => void;
+    onUpdatePage: (page: DocumentPageSetup) => void;
+    /** How each Matrix section fits the page (2c), by section id. */
+    matrixFits?: Record<string, DocumentMatrixFit>;
+    onUpdateSelectedSection: (updater: (section: DocumentSection) => DocumentSection) => void;
+    onUpdateHeader: (updater: (header: DocumentHeaderRegion | undefined) => DocumentHeaderRegion | undefined) => void;
+    onUpdateFooter: (updater: (footer: DocumentFooterRegion | undefined) => DocumentFooterRegion | undefined) => void;
+    onEditTableSection: (section: DocumentTableSection) => void;
+    onEditKpiCard: (section: DocumentKpiSection, cardId: string) => void;
+    onAddKpiCard: (section: DocumentKpiSection) => void;
+    onEditSection: (edit: DocumentEdit) => void;
+    /** Document-level actions (Edit/Preview toggle and Export), in the panel header. */
+    actions?: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/document-sheet/document-panel/inputs-panel.d.ts

@@ -0,0 +1,9 @@
+import { DocumentDefinition, DocumentSection, DocumentTableSection } from '../../../lib/types/common-types.js';
+export declare function InputsInspector({ sheetId, document, selectedSection, inputCount, onSelectSection, onEditTableSection, }: {
+    sheetId: string;
+    document: DocumentDefinition;
+    selectedSection: DocumentSection | null;
+    inputCount: number;
+    onSelectSection: (sectionId: string | null) => void;
+    onEditTableSection: (section: DocumentTableSection) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/document-sheet/document-panel/page-panel.d.ts

@@ -0,0 +1,5 @@
+import { DocumentPageSetup } from '../../../lib/types/common-types.js';
+export declare function PageInspector({ page, onUpdatePage, }: {
+    page: DocumentPageSetup;
+    onUpdatePage: (page: DocumentPageSetup) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/document-sheet/document-panel/panel-controls.d.ts

@@ -0,0 +1,14 @@
+export declare function DraftNumberInput({ value, onValueChange, min, max, step, disabled, 'aria-label': ariaLabel, }: {
+    'value': number;
+    'onValueChange': (value: number) => void;
+    'min'?: number;
+    'max'?: number;
+    'step'?: number;
+    'disabled'?: boolean;
+    'aria-label'?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function DraftColorInput({ value, onValueChange, 'aria-label': ariaLabel, }: {
+    'value': string;
+    'onValueChange': (value: string) => void;
+    'aria-label'?: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/document-sheet/document-panel/region-panels.d.ts

@@ -0,0 +1,11 @@
+import { DocumentFooterRegion, DocumentHeaderRegion, DocumentInputDefinition } from '../../../lib/types/common-types.js';
+export declare function HeaderInspector({ header, inputs, onUpdateHeader, }: {
+    header?: DocumentHeaderRegion;
+    inputs: DocumentInputDefinition[];
+    onUpdateHeader: (updater: (header: DocumentHeaderRegion | undefined) => DocumentHeaderRegion | undefined) => void;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function FooterInspector({ footer, inputs, onUpdateFooter, }: {
+    footer?: DocumentFooterRegion;
+    inputs: DocumentInputDefinition[];
+    onUpdateFooter: (updater: (footer: DocumentFooterRegion | undefined) => DocumentFooterRegion | undefined) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/document-sheet/document-panel/section-panel.d.ts

@@ -0,0 +1,25 @@
+import { ReactNode } from 'react';
+import { DocumentEdit } from '../../../lib/document/document-edits.js';
+import { QueryColumnKeyMap } from '../../../lib/types/explorer-types.js';
+import { DocumentInputDefinition, DocumentPageSetup, DocumentSection, DocumentKpiSection, DocumentTableSection } from '../../../lib/types/common-types.js';
+import { DocumentMatrixFit } from '../../../lib/document/document-matrix-bands.js';
+export declare function SectionModeHeader({ section, onBack, actions, }: {
+    section: DocumentSection;
+    onBack: () => void;
+    actions?: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function SectionInspector({ section, inputs, tableResultColumns, tableColumnKeyMap, onUpdateSection, matrixFit, page, onUpdatePage, onEditTableSection, onEditKpiCard, onAddKpiCard, onEditSection, }: {
+    section: DocumentSection | null;
+    /** How this Matrix section fits the page, from the canvas (2c). */
+    matrixFit?: DocumentMatrixFit;
+    page?: DocumentPageSetup;
+    onUpdatePage?: (page: DocumentPageSetup) => void;
+    inputs: DocumentInputDefinition[];
+    tableResultColumns?: string[];
+    tableColumnKeyMap?: QueryColumnKeyMap;
+    onUpdateSection: (updater: (section: DocumentSection) => DocumentSection) => void;
+    onEditTableSection: (section: DocumentTableSection) => void;
+    onEditKpiCard: (section: DocumentKpiSection, cardId: string) => void;
+    onAddKpiCard: (section: DocumentKpiSection) => void;
+    onEditSection: (edit: DocumentEdit) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/document-sheet/document-section-print-boundary.d.ts

@@ -0,0 +1,9 @@
+import { HTMLAttributes, ReactNode } from 'react';
+import { DocumentSectionRenderState } from '../../lib/document/document-section-render-state.js';
+/** Wraps a section's content with the markers for its state. */
+export declare function DocumentSectionPrintBoundary({ sectionId, state, error, children, ...rest }: {
+    sectionId: string;
+    state: DocumentSectionRenderState;
+    error?: unknown;
+    children: ReactNode;
+} & Omit<HTMLAttributes<HTMLDivElement>, 'children'>): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/document-sheet/document-table-chrome.d.ts

@@ -0,0 +1,22 @@
+import { ReactNode } from 'react';
+import { DocumentSectionRenderState } from '../../lib/document/document-section-render-state.js';
+import { DocumentTableSection } from '../../lib/types/common-types.js';
+export declare function DocumentTablePlaceholder({ section, reason, }: {
+    section: DocumentTableSection;
+    reason?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function DocumentTableLoading(): import("react/jsx-runtime").JSX.Element;
+export declare function DocumentTableState({ icon, title, message, exportState, }: {
+    icon: ReactNode;
+    title: string;
+    message: string;
+    exportState?: Exclude<DocumentSectionRenderState, 'ready'>;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function DocumentTableHeader({ section, }: {
+    section: DocumentTableSection;
+}): import("react/jsx-runtime").JSX.Element | null;
+/** "Edit Matrix" for a Matrix section, "Edit table" for Table and Pivot. */
+export declare function DocumentTableEditLabel({ section, className, }: {
+    section: DocumentTableSection;
+    className: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/document-sheet/document-table-section.d.ts

@@ -1,10 +1,8 @@
-import { DocumentTableSlice } from '../../lib/document/document-pagination.js';
+import { DocumentTableRowCountChange, DocumentTableSlice } from '../../lib/document/document-pagination.js';
 import { DocumentTableLayoutMeasurement } from '../../lib/document/document-table-print-model.js';
 import { DocumentTableResultColumnsChange } from '../../lib/document/document-table-result-columns.js';
-import { ResolvedDocumentTableStyle } from '../../lib/document/document-table-style.js';
 import { ControlDefinition, DashboardInputValues, DocumentTableSection } from '../../lib/types/common-types.js';
 import { TFilterValue } from '../surfboard/filter/types.js';
-export declare function getDocumentTableSurfaceClassName(style: ResolvedDocumentTableStyle): string;
 type DocumentTableSectionRendererProps = {
     section: DocumentTableSection;
     documentFilterValues?: TFilterValue[];
@@ -17,9 +15,7 @@ type DocumentTableSectionRendererProps = {
     tableSlice?: DocumentTableSlice;
     initialRowsPerPageLimit?: number;
     previewRowLimit?: number;
-    showInlineEditAction?: boolean;
-    onEditTableSection?: (section: DocumentTableSection) => void;
-    onTableRowCountChange?: (sectionId: string, rowCount: number) => void;
+    onTableRowCountChange?: DocumentTableRowCountChange;
     onTableResultColumnsChange?: DocumentTableResultColumnsChange;
     onTableLayoutMeasure?: (sectionId: string, measurement: DocumentTableLayoutMeasurement) => void;
     onTableLayoutInvalidate?: (sectionId: string) => void;
@@ -27,6 +23,6 @@ type DocumentTableSectionRendererProps = {
     onPreviewRowLimitChange?: (nextRowLimit: number) => void;
     measurementScale?: number;
 };
-declare function DocumentTableSectionRendererImpl({ section, documentFilterValues, documentControlDefinitions, documentControlValues, documentDashboardInputValues, missingRequiredInputLabels, isEditing, surfaceMode, tableSlice, initialRowsPerPageLimit, previewRowLimit, showInlineEditAction, onEditTableSection, onTableRowCountChange, onTableResultColumnsChange, onTableLayoutMeasure, onTableLayoutInvalidate, onUpdateTableSection, onPreviewRowLimitChange, measurementScale, }: DocumentTableSectionRendererProps): import("react/jsx-runtime").JSX.Element;
+declare function DocumentTableSectionRendererImpl({ section, documentFilterValues, documentControlDefinitions, documentControlValues, documentDashboardInputValues, missingRequiredInputLabels, isEditing, surfaceMode, tableSlice, initialRowsPerPageLimit, previewRowLimit, onTableRowCountChange, onTableResultColumnsChange, onTableLayoutMeasure, onTableLayoutInvalidate, onUpdateTableSection, onPreviewRowLimitChange, measurementScale, }: DocumentTableSectionRendererProps): import("react/jsx-runtime").JSX.Element;
 export declare const DocumentTableSectionRenderer: import('react').MemoExoticComponent<typeof DocumentTableSectionRendererImpl>;
 export {};

package/dist/types/components/document-sheet/document-text-preview-context.d.ts

@@ -0,0 +1,8 @@
+import { DocumentTextRenderContext } from '../../lib/document/document-variables.js';
+/**
+ * What the Document's inputs and report values hold now, for the text
+ * editors' variable pickers ("Label: California"). The sheet provides it
+ * around its side panel; without it the pickers show no values.
+ */
+export declare const DocumentTextPreviewContext: import('react').Context<DocumentTextRenderContext | null>;
+export declare function useDocumentTextPreview(): DocumentTextRenderContext | null;

package/dist/types/components/document-sheet/use-first-fitting-variant.d.ts

@@ -0,0 +1,18 @@
+import { RefObject } from 'react';
+/**
+ * Picks the first of `variantCount` renderings whose text fits its element
+ * without overflowing (for example the same number at smaller type sizes).
+ * The caller renders variant `index`; after each layout the element is
+ * measured and, if it overflows, the next variant is tried. `overflowed`
+ * means no variant fits, so the caller must fail closed rather than print a
+ * clipped number.
+ *
+ * `contentKey` identifies the content (text and sizes); a change restarts the
+ * search. The parent's width is observed, so a wider or narrower box (zoom,
+ * orientation, a layout change) restarts it too.
+ */
+export declare function useFirstFittingVariant<T extends HTMLElement>(variantCount: number, contentKey: string): {
+    ref: RefObject<T | null>;
+    index: number;
+    overflowed: boolean;
+};

package/dist/types/components/editor/editor-main/dashboard-variable-node.d.ts

@@ -1,18 +1,28 @@
 import { TextNode, DOMConversionMap, DOMExportOutput, EditorConfig, LexicalNode, NodeKey, SerializedTextNode } from 'lexical';
 import { DashboardInputVariableRef } from '../../../lib/types/common-types.js';
+import { TextVariableChipFace } from '../../../lib/text-variables/text-variable-types.js';
 export type SerializedDashboardVariableNode = SerializedTextNode & {
     ref: DashboardInputVariableRef;
+    face?: TextVariableChipFace;
+    token?: string;
     type: 'dashboard-variable';
     version: 1;
 };
 export declare class DashboardVariableNode extends TextNode {
     __ref: DashboardInputVariableRef;
+    __face: TextVariableChipFace;
+    /** `name.part`, for copying the variable as a typed token. */
+    __token: string;
     static getType(): string;
     static clone(node: DashboardVariableNode): DashboardVariableNode;
     static importJSON(serializedNode: SerializedDashboardVariableNode): DashboardVariableNode;
     static importDOM(): DOMConversionMap | null;
-    constructor(ref: DashboardInputVariableRef, text: string, key?: NodeKey);
+    constructor(ref: DashboardInputVariableRef, face: TextVariableChipFace, token: string, key?: NodeKey);
     getRef(): DashboardInputVariableRef;
+    getFace(): TextVariableChipFace;
+    getToken(): string;
+    /** Renames the chip when its input changes (its reference stays). */
+    setFace(face: TextVariableChipFace, token: string): this;
     createDOM(_config: EditorConfig): HTMLElement;
     updateDOM(prevNode: this, dom: HTMLElement): boolean;
     exportDOM(): DOMExportOutput;
@@ -21,5 +31,5 @@ export declare class DashboardVariableNode extends TextNode {
     canInsertTextBefore(): false;
     canInsertTextAfter(): false;
 }
-export declare function $createDashboardVariableNode(ref: DashboardInputVariableRef, label: string): DashboardVariableNode;
+export declare function $createDashboardVariableNode(ref: DashboardInputVariableRef, face: TextVariableChipFace, token: string): DashboardVariableNode;
 export declare function $isDashboardVariableNode(node: LexicalNode | null | undefined): node is DashboardVariableNode;

package/dist/types/components/explorer/chart-configuration/matrix-authoring-controls.d.ts

@@ -10,13 +10,16 @@ export declare function Choice({ label, value, options, onChange, disabled, }: {
     onChange: (value: string) => void;
     disabled?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function TextSetting({ label, value, onChange, type, min, max, }: {
+export declare function TextSetting({ label, value, onChange, type, min, max, placeholder, hint, }: {
     label: string;
     value: string | number;
     onChange: (value: string) => void;
     type?: 'text' | 'number';
     min?: number;
     max?: number;
+    placeholder?: string;
+    /** One line under the field. */
+    hint?: string;
 }): import("react/jsx-runtime").JSX.Element;
 export declare function Toggle({ label, checked, onChange, }: {
     label: string;
@@ -29,8 +32,10 @@ export declare function IconAction({ label, disabled, onClick, children, }: {
     onClick: () => void;
     children: ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function TotalSettings({ label, value, onChange, }: {
+export declare function TotalSettings({ label, value, onChange, role, }: {
     label: string;
     value: MatrixTotalPresentation;
     onChange: (value: MatrixTotalPresentation) => void;
+    /** A subtotal's label can name its member; the grand total has none. */
+    role?: 'subtotal' | 'grand_total';
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/text-variables/variable-chip-plugin.d.ts

@@ -0,0 +1,23 @@
+import { LexicalNode, TextNode } from 'lexical';
+import { TextVariableOption, TextVariableSelection } from '../../lib/text-variables/text-variable-types.js';
+export type VariableChipAdapter = {
+    options: readonly TextVariableOption[];
+    /**
+     * For a variable node: what it shows, or `missing` when its input no longer
+     * exists. `null` for any other node.
+     */
+    readNode: (node: LexicalNode) => {
+        selection?: TextVariableSelection;
+        missing?: boolean;
+    } | null;
+    /** A new variable node showing `selection`. */
+    createNode: (selection: TextVariableSelection) => TextNode;
+};
+export declare function VariableChipPlugin({ adapter, }: {
+    adapter: VariableChipAdapter;
+}): import("react/jsx-runtime").JSX.Element;
+/** The toolbar's Input button: the same picker, with its own search. */
+export declare function VariableInsertButton({ adapter, className, }: {
+    adapter: VariableChipAdapter;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/components/text-variables/variable-chip.d.ts

@@ -0,0 +1,18 @@
+import { TextVariableChipFace } from '../../lib/text-variables/text-variable-types.js';
+export declare const VARIABLE_CHIP_CLASS_NAME = "semaphor-variable-chip";
+type ChipOptions = {
+    bold?: boolean;
+    /** The Document paper: white in both themes, so the colors stay light. */
+    surface?: 'paper';
+    /** Clicking the chip opens its picker (in an editor). */
+    interactive?: boolean;
+};
+/** Attributes for a chip rendered by React. */
+export declare function variableChipAttributes(face: TextVariableChipFace, options?: ChipOptions): Record<string, string | undefined>;
+/** Applies a chip's face to an element a Lexical node created. */
+export declare function applyVariableChipToElement(element: HTMLElement, face: TextVariableChipFace, options?: ChipOptions & {
+    extraClassName?: string;
+    /** `name.part`: what copying the chip writes, as a typed token. */
+    token?: string;
+}): void;
+export {};