react-semaphor 0.1.522 → 0.1.523

package/dist/dashboard/index.js

@@ -1,4 +1,4 @@
-import { D as o } from "../chunks/index-krDPPQuA.js";
+import { D as o } from "../chunks/index-BBn_2FHm.js";
 import { C as s, E as C } from "../chunks/common-types-C6cAQgyh.js";
 export {
   s as CONTROL_CARD_DEFAULT_VALUE,

package/dist/data-app-builder/index.js

@@ -2,8 +2,8 @@ import { jsx as r, jsxs as c, Fragment as re } from "react/jsx-runtime";
 import * as Zn from "react";
 import { useContext as qn, useState as x, useRef as oe, useMemo as je, useEffect as W, useCallback as Ot } from "react";
 import * as Xn from "react-dom/client";
-import { aL as ea, aM as ta, aN as Ir, aO as jr, aP as zr, aQ as ra, aR as Wr, aS as Hr, aT as Jr, aU as Vr, aV as _r, aW as Ur, aX as Gr, aY as na, aZ as aa, a_ as oa, a$ as Ht, b0 as on, R as Kr, b1 as sa, b2 as Vt, b3 as sn, b4 as ia, b5 as la } from "../chunks/index-krDPPQuA.js";
-import { B as H, P as it, a as lt, b as dt, _ as da, $ as ca, a0 as ua, a1 as pa, a2 as ha, L as me, R as ma, d as _t } from "../chunks/switch-evlnTA4t.js";
+import { aL as ea, aM as ta, aN as Ir, aO as jr, aP as zr, aQ as ra, aR as Wr, aS as Hr, aT as Jr, aU as Vr, aV as _r, aW as Ur, aX as Gr, aY as na, aZ as aa, a_ as oa, a$ as Ht, b0 as on, R as Kr, b1 as sa, b2 as Vt, b3 as sn, b4 as ia, b5 as la } from "../chunks/index-BBn_2FHm.js";
+import { B as H, P as it, a as lt, b as dt, _ as da, $ as ca, a0 as ua, a1 as pa, a2 as ha, L as me, R as ma, d as _t } from "../chunks/switch-BxOntwjd.js";
 import { loadSemaphorBrowserRuntime as ot } from "../data-app-builder-browser-runtime/index.js";
 import { c as Ve, X as He } from "../chunks/x-CXDkqdur.js";
 import { S as fa } from "../chunks/save-DgMfP0j8.js";

package/dist/index.js

@@ -1,15 +1,15 @@
-import { E as x, F as B, S, c as N, U as _, d as P, C as w, V as F, e as R, f as L, g as I, h as M, I as k, R as U, i as O, j as V, k as q, l as z } from "./chunks/index-krDPPQuA.js";
-import { al as Ta, am as va, an as Aa, ao as Ba, W as Sa, G as Na, D as _a, A as Pa, z as wa, w as Fa, b as Ra, av as La, M as Ia, n as Ma, q as ka, q as Ua, r as Oa, B as Va, a as qa, ag as za, ai as ja, aj as Wa, ah as Qa, a7 as Ha, aa as Ka, au as Ga, _ as Ya, af as Xa, aq as $a, a2 as Ja, ab as Za, y as ae, x as ee, ay as se, Z as re, ac as oe, ad as ie, a6 as te, a9 as ne, at as le, as as de, ar as ue, ax as ce, aw as pe, a8 as fe, Y as me, X as he, a0 as Ce, ae as ge, a4 as De, a1 as Ee, a3 as xe, a5 as be, $ as ye, P as Te, L as ve, ap as Ae, v as Be, J as Se, t as Ne, m as _e, H as Pe, K as we, o as Fe, T as Re, O as Le, N as Ie, Q as Me, u as ke, s as Ue, p as Oe, ak as Ve } from "./chunks/index-krDPPQuA.js";
+import { E as x, F as B, S, c as N, U as _, d as P, C as w, V as F, e as R, f as L, g as I, h as M, I as k, R as U, i as O, j as V, k as q, l as z } from "./chunks/index-BBn_2FHm.js";
+import { al as Ta, am as va, an as Aa, ao as Ba, W as Sa, G as Na, D as _a, A as Pa, z as wa, w as Fa, b as Ra, av as La, M as Ia, n as Ma, q as ka, q as Ua, r as Oa, B as Va, a as qa, ag as za, ai as ja, aj as Wa, ah as Qa, a7 as Ha, aa as Ka, au as Ga, _ as Ya, af as Xa, aq as $a, a2 as Ja, ab as Za, y as ae, x as ee, ay as se, Z as re, ac as oe, ad as ie, a6 as te, a9 as ne, at as le, as as de, ar as ue, ax as ce, aw as pe, a8 as fe, Y as me, X as he, a0 as Ce, ae as ge, a4 as De, a1 as Ee, a3 as xe, a5 as be, $ as ye, P as Te, L as ve, ap as Ae, v as Be, J as Se, t as Ne, m as _e, H as Pe, K as we, o as Fe, T as Re, O as Le, N as Ie, Q as Me, u as ke, s as Ue, p as Oe, ak as Ve } from "./chunks/index-BBn_2FHm.js";
 import { C as ze, E as je } from "./chunks/common-types-C6cAQgyh.js";
-import { R as Qe } from "./chunks/report-preferences-dialog-BA9YJnPe.js";
+import { R as Qe } from "./chunks/report-preferences-dialog-B7Ny-bLC.js";
 import { jsx as a, jsxs as l } from "react/jsx-runtime";
-import { u as j, P as W, a as Q, B as H, c as g, b as K, d as G } from "./chunks/switch-evlnTA4t.js";
-import { A as Ke, n as Ge, e as Ye, f as Xe, g as $e, p as Je, o as Ze, s as as, t as es, m as ss, i as rs, l as os, q as is, k as ts, j as ns, h as ls, v as ds, r as us, w as cs, y as ps, x as fs, z as ms, E as hs, D as Cs } from "./chunks/switch-evlnTA4t.js";
+import { u as j, P as W, a as Q, B as H, c as g, b as K, d as G } from "./chunks/switch-BxOntwjd.js";
+import { A as Ke, n as Ge, e as Ye, f as Xe, g as $e, p as Je, o as Ze, s as as, t as es, m as ss, i as rs, l as os, q as is, k as ts, j as ns, h as ls, v as ds, r as us, w as cs, y as ps, x as fs, z as ms, E as hs, D as Cs } from "./chunks/switch-BxOntwjd.js";
 import * as f from "react";
 import { useMemo as Y, useEffect as b } from "react";
 import { D as Ds } from "./chunks/token-types-BC6RcUY8.js";
 import { C as xs, D as bs, L as ys, P as Ts, f as vs, g as As, k as Bs, j as Ss, l as Ns, e as _s, c as Ps, b as ws, d as Fs, n as Rs, h as Ls } from "./chunks/validators-CsdOtZI6.js";
-import { A as Ms, h as ks, D as Us, f as Os, g as Vs, e as qs, b as zs, E as js, N as Ws, U as Qs, a as Hs, V as Ks, W as Gs, u as Ys, c as Xs, d as $s } from "./chunks/dashboard-briefing-launcher-BIRnsMqX.js";
+import { A as Ms, h as ks, D as Us, f as Os, g as Vs, e as qs, b as zs, E as js, N as Ws, U as Qs, a as Hs, V as Ks, W as Gs, u as Ys, c as Xs, d as $s } from "./chunks/dashboard-briefing-launcher-CYiPCXQv.js";
 import { u as Zs } from "./chunks/use-debounced-dirty-check-BwAbnX_5.js";
 import "./chunks/matrix-operation-contract-D32U2CSw.js";
 import "./chunks/matrix-continuation-C4sRcjZU.js";
@@ -21,7 +21,7 @@ import { c as X } from "./chunks/calculated-field-identity-Dy_WpDdo.js";
 import "zod";
 import "./chunks/card-config-utils-CAyjC5Tp.js";
 import "react-dom";
-import "./chunks/index-B0KwXM6P.js";
+import "./chunks/index-BnZz-3jX.js";
 import "./chunks/appearance-context-VJdrKi7r.js";
 import "./chunks/color-CJvdlFM_.js";
 import "./chunks/index-CLIro-EG.js";

package/dist/surfboard/index.js

@@ -1,6 +1,6 @@
-import { b as a, a as o } from "../chunks/index-krDPPQuA.js";
+import { b as a, a as o } from "../chunks/index-BBn_2FHm.js";
 import { C as f, E } from "../chunks/common-types-C6cAQgyh.js";
-import { R as t } from "../chunks/report-preferences-dialog-BA9YJnPe.js";
+import { R as t } from "../chunks/report-preferences-dialog-B7Ny-bLC.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

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

@@ -196,6 +196,11 @@ export type BriefingAttachmentSettings = {
     controlBindings?: unknown[];
     tablePreferences?: Record<string, unknown>;
     dashboardInputExecutionSnapshot?: Record<string, unknown>;
+    /**
+     * Full dashboard PDF only: one input capture per sheet under one reference
+     * time (react-semaphor `PrintInputCapture`). Opaque to the app.
+     */
+    printInputCapture?: Record<string, unknown>;
     selectedSheetId?: string;
     cardType?: string;
     allowDownload?: boolean;

package/dist/types/components/dashboard/dashboard-container.d.ts

@@ -5,5 +5,5 @@ type ContainerProps = DashboardProps & HTMLAttributes<HTMLDivElement> & {
     cardId?: string;
     dashboardId?: string;
 };
-export declare function Container({ className, customStyle, onSave, onEvent, onDashboardLifecycleEvent, LoadingComponent, ErrorComponent, onChartElementClicked, id, authToken, currentTheme, appearance: _appearance, version, customCards, showAssistant, defaultFilterValues, defaultControlValues, controlContractOverrides, documentInputValues: _documentInputValues, dashboardInputExecutionSnapshot, presentationExecutionSnapshot, renderMode: _renderMode, onFilterValuesChange, selectedSheetId, eventHandlers, type, cardId, dashboardId, style, ...props }: ContainerProps): import("react/jsx-runtime").JSX.Element;
+export declare function Container({ className, customStyle, onSave, onEvent, onDashboardLifecycleEvent, LoadingComponent, ErrorComponent, onChartElementClicked, id, authToken, currentTheme, appearance: _appearance, version, customCards, showAssistant, defaultFilterValues, defaultControlValues, controlContractOverrides, documentInputValues: _documentInputValues, dashboardInputExecutionSnapshot, printInputCapture, presentationExecutionSnapshot, renderMode: _renderMode, onFilterValuesChange, selectedSheetId, eventHandlers, type, cardId, dashboardId, style, ...props }: ContainerProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/lib/dashboard-inputs/dashboard-input-snapshot.d.ts

@@ -1,18 +1,37 @@
 import { DashboardInputExecutionSnapshot, DashboardInputValues, NormalizedDashboardInput, ResolvedDashboardInputContext, TCard, TDashboard } from '../types/common-types.js';
 import { TFilterValue } from '../../components/surfboard/filter/types.js';
+import { DashboardInputRuntimeTarget } from './dashboard-input-values.js';
 import { DashboardInputRuntimeValues } from './resolve-dashboard-input-context.js';
 import { TransientInputContext } from './transient-input-context.js';
+type DashboardInputReplacementScope = {
+    dashboard: TDashboard;
+    dashboardInputValues?: DashboardInputValues;
+    sheetId?: string;
+    cardId?: string;
+};
+/** An applicable input whose slot replay completes as `cleared`, because nothing was captured for it. */
+export type UncapturedInputSlot = {
+    input: NormalizedDashboardInput;
+    target: DashboardInputRuntimeTarget;
+};
+export type UncapturedInputSlotsResult = {
+    status: 'unresolved';
+} | {
+    status: 'resolved';
+    uncaptured: UncapturedInputSlot[];
+};
 /**
  * Converts replacement snapshot semantics into self-describing slots at the
  * ingestion seam. Consumers can then resolve every slot with one precedence
  * rule and never need a separately travelling authority bit.
  */
-export declare function completeDashboardInputReplacementValues({ dashboard, dashboardInputValues, sheetId, cardId, }: {
-    dashboard: TDashboard;
-    dashboardInputValues?: DashboardInputValues;
-    sheetId?: string;
-    cardId?: string;
-}): DashboardInputValues;
+export declare function completeDashboardInputReplacementValues(scope: DashboardInputReplacementScope): DashboardInputValues;
+/**
+ * Every applicable input slot that replay would complete as `cleared` for this
+ * scope. It runs the same completion as `completeDashboardInputReplacementValues`,
+ * so the two can never disagree about what a snapshot covers.
+ */
+export declare function listUncapturedInputSlots(scope: DashboardInputReplacementScope): UncapturedInputSlotsResult;
 export type BuildDashboardInputExecutionSnapshotParams = {
     dashboard: TDashboard;
     sheetId?: string | null;
@@ -63,3 +82,4 @@ export declare function materializeDashboardInputSnapshotValues({ inputs, contex
     cardId?: string | null;
     sectionId?: string | null;
 }): DashboardInputValues;
+export {};

package/dist/types/lib/document/document-generated-at.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The first "generated at" time a Document shows. In a Document print render
+ * the store holds the replayed reference time for every replay source,
+ * including a per-sheet capture that never reaches the context prop.
+ * Interactive views keep seeding from the prop, legacy values, or now.
+ */
+export declare function resolveDocumentGeneratedAtSeed(input: {
+    isDocumentPrintMode: boolean;
+    replayReferenceTime?: string;
+    snapshotGeneratedAt?: string;
+    legacyGeneratedAt?: string;
+    now: () => string;
+}): string;

package/dist/types/lib/download-pdf.d.ts

@@ -3,6 +3,7 @@ import { AuthToken, ControlBinding, ControlDefinition, DashboardInputExecutionSn
 import { TChartType } from './charts/types.js';
 import { FastPathTableStructure } from '../shared/format-utils/table-structure.js';
 import { PresentationExecutionSnapshot } from '../shared/format-utils/index.js';
+import { PrintInputCapture } from './print/print-inputs.js';
 import { buildMatrixDeliveryPayload } from './matrix-table/matrix-delivery.js';
 export type MatrixPdfCapture = ReturnType<typeof buildMatrixDeliveryPayload>;
 export type DashboardParams = {
@@ -16,6 +17,8 @@ export type DashboardParams = {
     selectedSheetId?: string;
     dashboardId: string;
     dashboardInputExecutionSnapshot?: DashboardInputExecutionSnapshot;
+    /** "All sheets" downloads: one input capture per sheet, Documents included. */
+    printInputCapture?: PrintInputCapture;
     presentationExecutionSnapshot: PresentationExecutionSnapshot;
     timezone?: string;
 };

package/dist/types/lib/hooks/use-dashboard.d.ts

@@ -16,6 +16,8 @@ type UseDashboardProps = {
         controlBindings?: ControlBinding[];
     };
     dashboardInputExecutionSnapshot?: DashboardInputExecutionSnapshot;
+    /** Untrusted per-sheet input capture of a Full dashboard PDF; see resolvePrintInputs. */
+    printInputCapture?: unknown;
     presentationExecutionSnapshot?: PresentationExecutionSnapshot;
     customStyle?: TStyle;
     currentTheme?: 'light' | 'dark' | 'system';
@@ -28,7 +30,7 @@ type UseDashboardProps = {
     type?: 'dashboard' | 'visual';
     cardId?: string;
 };
-export declare function useDashboard({ customStyle, currentTheme, onSave, onEvent, onDashboardLifecycleEvent, defaultFilterValues, defaultControlValues, controlContractOverrides, dashboardInputExecutionSnapshot, presentationExecutionSnapshot, type, cardId, selectedSheetId, onFilterValuesChange, }: UseDashboardProps): {
+export declare function useDashboard({ customStyle, currentTheme, onSave, onEvent, onDashboardLifecycleEvent, defaultFilterValues, defaultControlValues, controlContractOverrides, dashboardInputExecutionSnapshot, printInputCapture, presentationExecutionSnapshot, type, cardId, selectedSheetId, onFilterValuesChange, }: UseDashboardProps): {
     isFetching: boolean;
     isLoading: boolean;
     isError: boolean;

package/dist/types/lib/hooks/use-is-dashboard-ready.d.ts

@@ -4,6 +4,9 @@
  * Uses TanStack Query's global fetching count to determine when all queries are complete.
  * This is more accurate than intercepting fetch/XHR as it only tracks actual data queries.
  *
+ * An active print hold (for example, a Matrix still loading visible cells)
+ * counts like an in-flight fetch: ready needs a quiet window with neither.
+ *
  * @param delayMs - Initial delay before monitoring starts (allows queries to begin)
  * @param quietMs - Time with no fetching activity before declaring ready
  * @returns boolean - true when dashboard is ready (all queries complete)

package/dist/types/lib/matrix-table/matrix-runtime-types.d.ts

@@ -79,8 +79,29 @@ export type MatrixRuntimeSnapshot = {
         bytes: number;
         checkpoints: number;
         inFlight: number;
+        /** Work waiting for an operation slot in the current generation. */
+        queued: number;
     };
 };
+/**
+ * Coverage of the current viewport for the current generation. `failed` wins
+ * over `incomplete`, which wins over `complete`.
+ */
+export type MatrixVisibleCoverage = {
+    status: 'complete';
+    generation: number;
+} | {
+    status: 'incomplete';
+    generation: number;
+    unloadedCells: number;
+    loadingCells: number;
+    queued: number;
+    inFlight: number;
+} | {
+    status: 'failed';
+    generation: number;
+    error: MatrixRuntimeError;
+};
 /** One operation boundary; providers own transport/auth, never branch assembly. */
 export type MatrixWindowExecutor = (input: {
     spec: MatrixSpec;

package/dist/types/lib/matrix-table/matrix-runtime.d.ts

@@ -1,6 +1,6 @@
 import { QueryClient } from '@tanstack/react-query';
 import { MatrixAxis, MatrixCoordinate, MatrixPath, MatrixSort, MatrixViewState } from '../../shared/analytics-protocol/index.js';
-import { MatrixCellAddress, MatrixCellState, MatrixRuntimeInput, MatrixRuntimeSnapshot, MatrixViewport, MatrixWindowExecutor } from './matrix-runtime-types.js';
+import { MatrixCellAddress, MatrixCellState, MatrixRuntimeInput, MatrixRuntimeSnapshot, MatrixViewport, MatrixVisibleCoverage, MatrixWindowExecutor } from './matrix-runtime-types.js';
 /** Owns acquisition, errors, generation fencing and retention for exactly one card. */
 export declare class MatrixRuntimeController {
     private query;
@@ -48,6 +48,13 @@ export declare class MatrixRuntimeController {
     private acceptChoices;
     retry: (retryKey: string) => void;
     readCell: (coordinate: MatrixCellAddress) => MatrixCellState;
+    /**
+     * Whether every visible axis item and cell of the current generation is
+     * loaded. A pure read over the slice `plan()` loads; it never schedules work.
+     * Value, null and empty cells are complete; unloaded and loading cells, axis
+     * pages still loading, and queued or active work are not.
+     */
+    readVisibleCoverage: () => MatrixVisibleCoverage;
     /** Used by explicit refresh/retry integrations; latest-issued response wins. */
     refetchCell: (coordinate: MatrixCoordinate) => void;
     refetchPage: (key: string) => void;

package/dist/types/lib/matrix-table/use-matrix.d.ts

@@ -61,6 +61,7 @@ export declare function useMatrix(input: MatrixInput): {
         bytes: number;
         checkpoints: number;
         inFlight: number;
+        queued: number;
     };
 };
 export type MatrixRuntime = ReturnType<typeof useMatrix>;

package/dist/types/lib/print/print-holds.d.ts

@@ -0,0 +1,15 @@
+/** Something that must finish before the dashboard counts as ready. */
+export type PrintHold = {
+    /** Stable, e.g. `matrix:${cardId}`. Registrations with the same key are listed once. */
+    key: string;
+    /** Card title for error messages; never data values. */
+    label: string;
+};
+/**
+ * While `held` is true, the dashboard's ready flag stays false. The hold is
+ * released when `held` turns false or the component unmounts. Each call is its
+ * own registration, so parent and child components can hold the same key.
+ */
+export declare function usePrintHold(hold: PrintHold, held: boolean): void;
+/** Holds registered right now, one per key, in registration order. */
+export declare function useActivePrintHolds(): readonly PrintHold[];

package/dist/types/lib/print/print-inputs.d.ts

@@ -0,0 +1,104 @@
+import { DashboardInputExecutionSnapshot, TDashboard } from '../types/common-types.js';
+import { DashboardInputRuntimeValues } from '../dashboard-inputs/resolve-dashboard-input-context.js';
+import { TransientInputContext } from '../dashboard-inputs/transient-input-context.js';
+import { PrintSheetRef } from './print-sheets.js';
+/**
+ * The inputs a Full dashboard PDF replays: one single-sheet capture per sheet,
+ * each in its own sheet's mode, under one reference time. Persisted in
+ * Briefing attachment settings (`settings.printInputCapture`) and carried in
+ * the print render record (`viewState.printInputCapture`).
+ */
+export type PrintInputCapture = {
+    version: 1;
+    /** Relative dates resolve against this. Briefing execution rewrites it on every run. */
+    generatedAt: string;
+    /** IANA zone when known; optional like the existing snapshot contract's. */
+    timezone?: string;
+    /** Keyed by sheet id. Every printable sheet at capture time has an entry. */
+    sheets: Record<string, PrintSheetInputs>;
+};
+/** One sheet's captured inputs: a single-sheet snapshot minus the capture-level fields. */
+export type PrintSheetInputs = Omit<DashboardInputExecutionSnapshot, 'generatedAt' | 'timezone' | 'mode' | 'sheetId'> & {
+    /** Equals its key in `sheets`. */
+    sheetId: string;
+    /** Equals the sheet's kind. */
+    mode: 'dashboard' | 'document';
+};
+/**
+ * What a PDF render replays for one sheet. Decided once per sheet, before the
+ * existing replay in useDashboard runs.
+ */
+export type PrintInputResolution = 
+/** Replay this snapshot through the existing replay code. */
+{
+    status: 'replay';
+    snapshot: DashboardInputExecutionSnapshot;
+    source: 'capture' | 'legacy_snapshot';
+}
+/** Replay nothing: the existing no-snapshot path (dashboard defaults, Lens values), as today. */
+ | {
+    status: 'no_replay';
+}
+/** The sheet has applicable inputs that were never captured. The sheet must not print. */
+ | {
+    status: 'missing';
+    missing: MissingPrintInputs;
+};
+/**
+ * Why a sheet cannot print. A plain object, not an Error instance, so it can
+ * live in the Immer store. Shaped for getDeliveryRenderErrorAttributes.
+ */
+export type MissingPrintInputs = {
+    code: 'print_inputs_not_captured';
+    deliveryBlocking: true;
+    sheetId: string;
+    sheetTitle: string;
+    /** Distinct authored labels, at most three. */
+    inputLabels: readonly string[];
+    message: string;
+};
+/**
+ * Decides, for one sheet of a dashboard PDF render, whether and what to
+ * replay. Rules (first match wins; a present capture wins over a legacy
+ * snapshot):
+ * - R1: a capture with an entry for the sheet replays that entry.
+ * - R2: a capture without an entry for the sheet (a sheet added after saving),
+ *   or one that does not parse, is decided by applicability.
+ * - R3: a legacy snapshot built for dashboard sheets is never replayed onto a
+ *   Document; the Document is decided by applicability.
+ * - R4: any other legacy snapshot replays unchanged.
+ * - R5: nothing captured for a dashboard sheet replays nothing, as today.
+ * - R6: nothing captured for a Document is decided by applicability.
+ *
+ * "By applicability": if replaying empty values would clear any applicable
+ * input slot, the sheet's inputs were never captured and it must not print.
+ */
+export declare function resolvePrintInputs({ dashboard, sheetId, legacySnapshot, capture, }: {
+    dashboard: TDashboard;
+    sheetId: string;
+    legacySnapshot?: DashboardInputExecutionSnapshot;
+    /** Untrusted: it crossed persistence and the print render record. */
+    capture?: unknown;
+}): PrintInputResolution;
+export declare function buildMissingPrintInputs({ sheetId, sheetTitle, inputLabels, }: {
+    sheetId: string;
+    sheetTitle: string;
+    inputLabels: readonly string[];
+}): MissingPrintInputs;
+/**
+ * Captures every sheet's inputs for a Full dashboard PDF. It has no gate of
+ * its own: each caller keeps the gate it used before (Briefings capture when
+ * the dashboard requires input resolution; immediate downloads also capture
+ * for drill state). Carried state follows the caller: a schedule passes no
+ * transient contexts or card view state, a download passes the viewer's.
+ */
+export declare function capturePrintInputs({ dashboard, sheets, runtimeValues, transientContexts, timezone, generatedAt, }: {
+    dashboard: TDashboard;
+    sheets: readonly PrintSheetRef[];
+    runtimeValues: DashboardInputRuntimeValues;
+    transientContexts: readonly TransientInputContext[] | undefined;
+    timezone?: string;
+    generatedAt?: string;
+}): PrintInputCapture;
+/** Reads an untrusted value. Returns undefined for anything that is not a valid version-1 capture. */
+export declare function parsePrintInputCapture(value: unknown): PrintInputCapture | undefined;

package/dist/types/lib/print/print-sheets.d.ts

@@ -0,0 +1,16 @@
+import { TDashboard } from '../types/common-types.js';
+export type PrintSheetKind = 'dashboard' | 'document';
+/** One sheet a Full dashboard PDF prints. */
+export type PrintSheetRef = {
+    sheetId: string;
+    /** The sheet's kind, or 'dashboard' when the sheet has none. */
+    kind: PrintSheetKind;
+    /** The sheet's title, or `Sheet ${index + 1}` when it is empty. */
+    title: string;
+};
+/**
+ * Every sheet a Full dashboard PDF prints, in dashboard order. Pure.
+ * The scheduler's `listPrintSheetsFromTemplate` mirrors these rules; a shared
+ * fixture (`__fixtures__/print-sheets.json`) pins both to the same output.
+ */
+export declare function listPrintSheets(dashboard: Pick<TDashboard, 'sheets'> | null | undefined): PrintSheetRef[];

package/dist/types/lib/stores/dashboard-store.d.ts

@@ -1,6 +1,7 @@
 import { AuthToken, TBaseQuery, Breakpoint, ControlDefinition, CustomCard, StyleProps, TCard, TDashboard, TEvent, TFrame, TSheet, TStyle, AIScopeTable, TLens, CacheConfig, FilterLayoutSettings, DocumentDefinition, DashboardInput, DashboardInputSlot, DashboardInputValues, DashboardLifecycleEvent } from '../types/common-types.js';
 import { TFilter, TFilterValue } from '../../components/surfboard/filter/types.js';
 import { TransientInputContext } from '../dashboard-inputs/transient-input-context.js';
+import { MissingPrintInputs } from '../print/print-inputs.js';
 import { default as ReactGridLayout } from 'react-grid-layout';
 import { DashboardAIContext } from '../types/assistant-types.js';
 import { FilterGroup, Field } from '../types/explorer-types.js';
@@ -104,6 +105,11 @@ export type DashboardStore = {
     dashboardCardPagination: Record<string, DashboardCardPaginationState>;
     /** Fixed execution clock from a strict dashboard input replay snapshot. */
     dashboardInputReferenceTime?: string;
+    /**
+     * Set when a PDF render's sheet has applicable inputs that were never
+     * captured. The sheet must not print; DashboardTabs renders the reason.
+     */
+    missingPrintInputs?: MissingPrintInputs;
     semanticExecutionPayload: SemanticExecutionPayload;
     reportContext: ReportRuntimeContext | null;
     /** Access-token session that owns the hydrated report context. */
@@ -216,6 +222,8 @@ type Actions = {
         transientContexts?: TransientInputContext[];
         reportContext?: ReportRuntimeContext;
         authToken?: AuthToken;
+        /** Present (even as undefined) on every PDF-aware hydration; replaces the previous value. */
+        missingPrintInputs?: MissingPrintInputs;
     }) => void;
     hydrateRuntimeControlValues: (dashboard: TDashboard, runtimeOverrides?: Record<string, unknown>) => void;
     mergeSemanticExecutionPayload: (semanticExecutionPayload: SemanticExecutionPayload) => void;

package/dist/types/lib/types/common-types.d.ts

@@ -259,6 +259,12 @@ export type DashboardProps = {
      * inputs instead of documentInputValues.
      */
     dashboardInputExecutionSnapshot?: DashboardInputExecutionSnapshot;
+    /**
+     * Internal print prop: the per-sheet input capture of a Full dashboard PDF
+     * (`PrintInputCapture`). Untrusted; resolved per sheet by resolvePrintInputs
+     * on PDF renders only.
+     */
+    printInputCapture?: unknown;
     /** Server-resolved immutable presentation snapshot for internal print views. */
     presentationExecutionSnapshot?: PresentationExecutionSnapshot;
     /**

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.522",
+  "version": "0.1.523",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",