react-semaphor 0.1.522 → 0.1.524

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/ai/use-dashboard-assistant.d.ts

@@ -1,8 +1,5 @@
 import { UIMessage } from 'ai';
-type DynamicVisualMode = 'auto' | 'force' | 'off';
-export declare function useDashboardAssistant({ dynamicVisualMode, }?: {
-    dynamicVisualMode?: DynamicVisualMode;
-}): {
+export declare function useDashboardAssistant(): {
     sendMessage: (message?: (Omit<UIMessage<unknown, import('ai').UIDataTypes, import('ai').UITools>, "id" | "role"> & {
         id?: string | undefined;
         role?: "system" | "user" | "assistant" | undefined;
@@ -33,4 +30,3 @@ export declare function useDashboardAssistant({ dynamicVisualMode, }?: {
     errorMessage: string;
     clearError: () => void;
 };
-export {};

package/dist/types/lib/hooks/semaphor-ready-indicator.d.ts

@@ -13,5 +13,5 @@ type SemaphorReadyIndicatorProps = {
  *
  * The element is visually hidden (sr-only pattern) so it doesn't affect layouts.
  */
-export declare function SemaphorReadyIndicator({ delayMs, quietMs, componentType, componentId, }: SemaphorReadyIndicatorProps): import("react/jsx-runtime").JSX.Element;
+export declare function SemaphorReadyIndicator({ delayMs, quietMs, componentType, componentId, }: SemaphorReadyIndicatorProps): import("react").JSX.Element;
 export {};

package/dist/types/lib/hooks/use-card-render-context.d.ts

@@ -0,0 +1,14 @@
+import { PivotTableResponse } from '../../components/visual/pivot-table/types.js';
+import { QueryExecutionResponse } from '../types/explorer-types.js';
+import { TCard } from '../types/common-types.js';
+type CardRenderQueryData = (QueryExecutionResponse & Pick<Partial<PivotTableResponse>, 'groupByColumns'>) | null | undefined;
+/**
+ * Pairs a card with the config that produced its current result, so table
+ * and pivot renderers never read retained rows against stale drill state.
+ */
+export declare function useCardRenderContext(card: TCard, effectiveCardConfig: TCard['config'] | undefined, queryData: CardRenderQueryData): {
+    renderCard: TCard;
+    tableRecords: any[];
+    pivotTableConfig: import('../../components/visual/pivot-table/pivot-table.js').PivotTableConfig | null;
+};
+export {};

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

@@ -2,10 +2,6 @@ export declare function useDashboardQuery(): {
     data: {
         initialReportContext: import('../../shared/report-runtime-context/index.js').ReportRuntimeContext;
         dashboard: import('../types/index.js').TDashboard;
-        lenses: import('../types/index.js').TLens[];
-        filterValues?: import('../types/index.js').TFilterValue[] | null;
-        inputValues?: import('../types/index.js').LensInputValuesSnapshot | null;
-        defaultLensId?: string;
         assistantProfileId?: string;
         semanticExecutionPayload: import('../types/semantic-runtime-types.js').SemanticExecutionPayload;
         organizationAppearance?: import('../types/index.js').AppearanceSpec | null;
@@ -16,10 +12,6 @@ export declare function useDashboardQuery(): {
     refetch: (options?: import('@tanstack/query-core').RefetchOptions) => Promise<import('@tanstack/query-core').QueryObserverResult<{
         initialReportContext: import('../../shared/report-runtime-context/index.js').ReportRuntimeContext;
         dashboard: import('../types/index.js').TDashboard;
-        lenses: import('../types/index.js').TLens[];
-        filterValues?: import('../types/index.js').TFilterValue[] | null;
-        inputValues?: import('../types/index.js').LensInputValuesSnapshot | null;
-        defaultLensId?: string;
         assistantProfileId?: string;
         semanticExecutionPayload: import('../types/semantic-runtime-types.js').SemanticExecutionPayload;
         organizationAppearance?: import('../types/index.js').AppearanceSpec | null;

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,17 +30,13 @@ 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;
     refetch: (options?: import('@tanstack/query-core').RefetchOptions) => Promise<import('@tanstack/query-core').QueryObserverResult<{
         initialReportContext: import('../../shared/report-runtime-context/index.js').ReportRuntimeContext;
         dashboard: TDashboard;
-        lenses: import('../../components/index.js').TLens[];
-        filterValues?: TFilterValue[] | null;
-        inputValues?: import('../../components/index.js').LensInputValuesSnapshot | null;
-        defaultLensId?: string;
         assistantProfileId?: string;
         semanticExecutionPayload: import('../types/semantic-runtime-types.js').SemanticExecutionPayload;
         organizationAppearance?: import('../../components/index.js').AppearanceSpec | null;

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-execution-provider.d.ts

@@ -4,4 +4,4 @@ import { MatrixExecutionEnvironment } from './matrix-execution-context.js';
 export declare function MatrixExecutionProvider({ value, children, }: {
     value: MatrixExecutionEnvironment;
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;

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), 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/query-context/build-dashboard-card-query-contract.d.ts

@@ -48,7 +48,6 @@ export type DashboardCardQueryContractResult = DashboardCardQueryContract | {
 /** Test/invariant helper for fixtures that cannot contain mapped inputs. */
 export declare function requireReadyDashboardCardQueryContract(result: DashboardCardQueryContractResult): DashboardCardQueryContract;
 export type DashboardCardQueryExecutionOptions = {
-    selectedLensId?: string;
     resolvedPrimaryDateField?: ResolvedPrimaryDateField;
     calendarContext: CalendarContext;
     allowGlobalDateMinutePrecision?: boolean;

package/dist/types/lib/query-context/dashboard-card-query-key.d.ts

@@ -6,7 +6,6 @@ import { CalendarContext } from '../../shared/report-runtime-context/index.js';
 export declare const isPaginatedCardType: (card: TCard) => boolean;
 export type CreateDashboardCardQueryKeyOptions = {
     finalFiltersKey: string;
-    selectedLensId?: string;
     cardFilterValues: unknown;
     controlValues?: Record<string, unknown>;
     controlDefinitions?: ControlDefinition[];

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 { AuthToken, TBaseQuery, Breakpoint, ControlDefinition, CustomCard, StyleProps, TCard, TDashboard, TEvent, TFrame, TSheet, TStyle, AIScopeTable, 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';
@@ -53,8 +54,6 @@ export type DashboardStore = {
     currentBreakpoint: Breakpoint;
     theme?: 'light' | 'dark' | 'system';
     themeStyle?: StyleProps;
-    lenses?: TLens[];
-    selectedLensId?: string;
     filteringCards?: TCard[];
     dashboard: TDashboard;
     dashboardAssistantDraftScopeKey: string;
@@ -104,6 +103,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. */
@@ -186,8 +190,6 @@ type Actions = {
     updateDashboardControl: (controlId: string, updates: Partial<ControlDefinition>) => void;
     reorderDashboardControls: (orderedControlIds: string[]) => void;
     setIsDownloadingPdf: (isDownloadingPdf: boolean) => void;
-    setLenses: (lenses: TLens[]) => void;
-    setSelectedLensId: (lensId: string) => void;
     setAIScopeTables: (aiScopeTables: AIScopeTable[]) => void;
     addToAIScope: (scopeTable: AIScopeTable) => void;
     removeFromAIScope: (scopeTable: AIScopeTable) => void;
@@ -216,6 +218,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/stores/editor-store.d.ts

@@ -1,4 +1,4 @@
-import { ColorRange, TCard, TDynamicCardPreferences, TCardPreferences, TCustomCardPreferences, TFrame, TLegendOptions, TVisualizationMode, AggregateCalc, SqlGen, ControlDefinition } from '../types/common-types.js';
+import { ColorRange, TCard, TCardPreferences, TCustomCardPreferences, TFrame, TLegendOptions, AggregateCalc, SqlGen, ControlDefinition } from '../types/common-types.js';
 import { TFilterValue } from '../../components/surfboard/filter/types.js';
 import { TChartType } from '../charts/types.js';
 import { AIScopeTable } from '../../components/index.js';
@@ -175,8 +175,6 @@ type Actions = TableActions & ExplorerActions & {
     setRunSql: (runSql: boolean) => void;
     setCardPreferences: (preferences: TCardPreferences) => void;
     setCustomCardPreferences: (customPreferences: TCustomCardPreferences) => void;
-    setVisualizationMode: (mode: TVisualizationMode) => void;
-    setDynamicCardPreferences: (dynamicPreferences: TDynamicCardPreferences | undefined) => void;
     setFilterOnClickField: (field: string) => void;
     setFilterOnClickColumnIndex: (index: number) => void;
     setIsSqlRunning: (isSqlRunning: boolean) => void;

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

@@ -72,26 +72,9 @@ export type SqlGen = {
     dimensions?: string[];
 };
 export type Theme = 'dark' | 'light' | 'system';
-export type LensInputValuesSnapshot = {
-    generatedAt: string;
-    dashboardInputValues: DashboardInputValues;
-};
-export type TLens = {
-    id: string;
-    name: string;
-    template?: string;
-    filterValues?: TFilterValue[] | null;
-    inputValues?: LensInputValuesSnapshot | null;
-    isDefault?: boolean;
-    shared?: boolean;
-};
 export type GetDashboardResponse = {
     dashboard: TDashboard;
     initialReportContext: ReportRuntimeContext;
-    lenses: TLens[];
-    filterValues?: TFilterValue[] | null;
-    inputValues?: LensInputValuesSnapshot | null;
-    defaultLensId?: string;
     assistantProfileId?: string;
     semanticExecutionPayload: SemanticExecutionPayload;
     organizationAppearance?: import('../appearance/types.js').AppearanceSpec | null;
@@ -259,6 +242,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;
     /**
@@ -784,38 +773,6 @@ export type TCustomCardPreferences = {
         };
     };
 };
-export type TVisualizationMode = 'builtin' | 'dynamic';
-export type TDynamicVisualIntent = {
-    primaryChartType?: TChartType | 'custom';
-    layout: 'chart-only' | 'composite';
-    includesKpis: boolean;
-};
-export type TDynamicVisualFallback = {
-    mode: 'chart' | 'table';
-    chartType?: TChartType;
-    reason: string;
-};
-export type TDynamicCardPreferences = {
-    renderer: 'dynamic-visual';
-    artifactId?: string;
-    parentArtifactId?: string;
-    title?: string;
-    rendererCode?: string;
-    question?: string;
-    provenance?: 'card-config' | 'query_spec' | 'sql' | 'sql+python';
-    visualIntent?: TDynamicVisualIntent;
-    assistantNote?: string;
-    builtinDisplayOptions?: {
-        showChrome?: boolean;
-        allowScroll?: boolean;
-    };
-    fallback: TDynamicVisualFallback;
-    error?: {
-        stage: string;
-        message: string;
-        details?: string[];
-    };
-};
 /**
  * Inline filter definition stored on a card.
  * Inline filters appear on the right-hand side of the card header,
@@ -1290,8 +1247,6 @@ export type TCard = {
     customCfg?: any;
     preferences?: TCardPreferences;
     customCardPreferences?: TCustomCardPreferences;
-    visualizationMode?: TVisualizationMode;
-    dynamicCardPreferences?: TDynamicCardPreferences;
     lastSelectedDatabase?: string;
     lastSelectedDatamodelId?: string;
     lastSelectedSchema?: string;

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

@@ -68,7 +68,7 @@ export type TokenSecurityPolicy = {
  */
 export type UIConfig = {
     /**
-     * Enables self-service editing and lens creation by the end user. Legacy field. Use config.allowEdit instead.
+     * Enables self-service editing by the end user. Legacy field. Use config.allowEdit instead.
      */
     allowEdit?: boolean;
     /**
@@ -203,7 +203,7 @@ export type TokenRequest = {
      */
     displayName?: string;
     /**
-     * Enables self-service editing and lens creation by the end user.
+     * Enables self-service editing by the end user.
      */
     allowEdit?: boolean;
     /**
@@ -275,7 +275,7 @@ export type TokenProps = {
      */
     displayName?: string;
     /**
-     * Enables self-service editing and lens creation by the end user.
+     * Enables self-service editing by the end user.
      */
     allowEdit?: boolean;
     /**

package/dist/types/lib/utils/build-saved-editor-card.d.ts

@@ -0,0 +1,15 @@
+import { TCard } from '../types/common-types.js';
+type BuildSavedEditorCardOptions = {
+    isDevMode: boolean;
+    cardSql?: string;
+    isShowingVisual: boolean;
+    selectedSchemaName?: string;
+    selectedDatamodelId?: string;
+    selectedDatabaseName?: string;
+    selectedTableName?: string;
+    selectedConnectionId?: string;
+    remoteChartSettings?: unknown;
+    stripConfig: (config: TCard['config']) => TCard['config'];
+};
+export declare function buildSavedEditorCard(card: TCard, { isDevMode, cardSql, isShowingVisual, selectedSchemaName, selectedDatamodelId, selectedDatabaseName, selectedTableName, selectedConnectionId, remoteChartSettings, stripConfig, }: BuildSavedEditorCardOptions): TCard;
+export {};

package/dist/types/lib/utils/dashboard-controls-visibility.d.ts

@@ -6,10 +6,9 @@ export type DashboardControlsVisibility = {
     showGroupManagement: boolean;
 };
 export declare function isDashboardSharingVisible(config?: Pick<UIConfig, 'showDashboardSharing'>): boolean;
-export declare function resolveDashboardTitleEditability({ isDashboardEditing, canEditDashboard, hasCurrentLens, }: {
+export declare function resolveDashboardTitleEditability({ isDashboardEditing, canEditDashboard, }: {
     isDashboardEditing: boolean;
     canEditDashboard: boolean;
-    hasCurrentLens: boolean;
 }): boolean;
 /**
  * Resolves token-scoped dashboard chrome without weakening authorization.

package/dist/types/lib/utils/entity-icon-utils.d.ts

@@ -13,5 +13,5 @@ interface GetEntityIconOptions {
  * @param options - Optional configuration for icon appearance
  * @returns React icon component
  */
-export declare function getEntityIcon(type: EntityType | string, options?: GetEntityIconOptions): import("react/jsx-runtime").JSX.Element;
+export declare function getEntityIcon(type: EntityType | string, options?: GetEntityIconOptions): import("react").JSX.Element;
 export {};

package/dist/types/lib/utils/field-icon-utils.d.ts

@@ -7,4 +7,4 @@
  * monochrome `TypeGlyph` primitive so a single change here propagates
  * everywhere a field icon is rendered.
  */
-export declare function getFieldIconComponent(dataType: string | undefined): import("react/jsx-runtime").JSX.Element;
+export declare function getFieldIconComponent(dataType: string | undefined): import("react").JSX.Element;

package/dist/types/lib/utils.d.ts

@@ -46,10 +46,6 @@ export declare function invalidateToken(apiServiceUrl: string): Promise<any>;
 export declare function getDashboard(apiServiceUrl: string, accessToken: string | undefined, params?: {}): Promise<{
     initialReportContext: import('../shared/report-runtime-context/index.js').ReportRuntimeContext;
     dashboard: import('./types/common-types.js').TDashboard;
-    lenses: import('./types/common-types.js').TLens[];
-    filterValues?: import('./types/index.js').TFilterValue[] | null;
-    inputValues?: import('./types/common-types.js').LensInputValuesSnapshot | null;
-    defaultLensId?: string;
     assistantProfileId?: string;
     semanticExecutionPayload: import('./types/semantic-runtime-types.js').SemanticExecutionPayload;
     organizationAppearance?: import('./types/index.js').AppearanceSpec | null;