react-semaphor 0.1.540 → 0.1.542

package/dist/types/index.js

@@ -1,9 +1,9 @@
-import { C as s, E as r, c as l, g as o, f as i, b as n, e as d, d as m, a as u, h as c, r as E } from "../chunks/common-types-CUf03Htv.js";
-import { C as p, D as T, L as D, P as A, e as I, g as _, j as F, h as S, k as b, d as L, b as f, i as N, c as R, n as g, f as h } from "../chunks/validators-Ej1DdCXa.js";
-import { D as M } from "../chunks/token-types-bxUxXDX2.js";
-import { B as O, j as V, V as k, a as w, h as U, g as B, i as K, f as z, e as v, m as P, n as Y, p as G, b as Q, c as j, d as q, r as W, t as J } from "../chunks/bookmark-state-k7y5SNGf.js";
-import { r as H, a as Z } from "../chunks/pivot-result-identity-D6hhcRXi.js";
-import { D as ee } from "../chunks/report-runtime-context-B984Nq1E.js";
+import { C as s, E as r, V as l, i as o, c as i, g as n, f as d, b as m, e as u, d as E, a as c, u as p, s as C, h as T, j as D, q as A, o as I, m as _, n as F, p as S, k as b, l as L, r as f, t as N } from "../chunks/table-settings-CLZocegs.js";
+import { C as y, D as M, L as g, P as h, e as x, g as O, j as V, h as k, k as w, d as U, b as B, i as K, c as z, n as v, f as P } from "../chunks/validators-DMHTpf7a.js";
+import { D as q } from "../chunks/token-types-DBbZVQsm.js";
+import { B as Q, a as j, p as W, r as J } from "../chunks/bookmark-state-CXw7lZ50.js";
+import { r as H, a as Z } from "../chunks/pivot-result-identity-DJhXXcns.js";
+import { D as ee } from "../chunks/report-runtime-context-Dq8XyODK.js";
 const e = [
   "concatenate",
   "conditional-category",
@@ -37,52 +37,52 @@ const e = [
   "is-blank"
 ];
 export {
-  O as BOOKMARK_STATE_VERSION,
-  V as BOOKMARK_VISIBILITIES,
-  p as CALCULATED_FIELD_ENTITY_MARKER,
+  Q as BOOKMARK_STATE_VERSION,
+  j as BOOKMARK_VISIBILITIES,
+  y as CALCULATED_FIELD_ENTITY_MARKER,
   e as CALCULATED_FIELD_TEMPLATE_IDS,
   s as CONTROL_CARD_DEFAULT_VALUE,
-  T as DATE_FORMAT_VALUES,
+  M as DATE_FORMAT_VALUES,
   ee as DEFAULT_CALENDAR_CONTEXT,
-  M as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
+  q as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
   r as EMPTY_SELECTION,
-  D as LEGACY_CALCULATED_FIELD_ENTITY_MARKER,
-  A as PivotMarkerEnum,
-  k as VIEWER_LIMITS,
-  w as VIEWER_TABLE_SETTINGS_VERSION,
-  l as collectDatasetNamesFromExplorerField,
-  o as collectDatasetNamesFromFilterGroup,
-  i as collectExecutionDatasetNamesFromExplorerField,
-  n as collectPreferredDatasetNamesFromExplorerField,
-  d as collectQualifiedDatasetNamesFromExplorerField,
-  m as datasetRefFromSource,
-  u as dependencyDisplayIdentity,
-  I as getCalculatedFieldComputeStage,
-  U as getCustomizableTableCardIds,
-  _ as getFieldRuntimeColumnName,
-  B as getSortableTableCardIds,
-  F as hasCalculatedFieldMarker,
-  S as hasCalculatedFormulaInputs,
-  b as hasSyntheticCalculatedFieldOwner,
-  c as humanizeDatasetName,
-  L as inspectCalculatedField,
-  f as isCalculatedDimension,
-  N as isCalculatedMetric,
-  R as isDerivedField,
-  K as isEmptyViewerTableSettings,
-  z as isTableCardCustomizable,
-  v as isTableCardSortable,
-  P as measureJsonBytes,
-  g as normalizeCalculatedFieldRepresentation,
-  Y as normalizeViewerTableSettings,
-  G as parseBookmarkState,
-  Q as parseTableColumnId,
-  j as parseViewerTableSettings,
-  q as parseViewerTableSettingsMap,
-  W as readBookmarkState,
-  E as resolveFieldDatasetDependencies,
+  g as LEGACY_CALCULATED_FIELD_ENTITY_MARKER,
+  h as PivotMarkerEnum,
+  l as VIEWER_LIMITS,
+  o as VIEWER_TABLE_SETTINGS_VERSION,
+  i as collectDatasetNamesFromExplorerField,
+  n as collectDatasetNamesFromFilterGroup,
+  d as collectExecutionDatasetNamesFromExplorerField,
+  m as collectPreferredDatasetNamesFromExplorerField,
+  u as collectQualifiedDatasetNamesFromExplorerField,
+  E as datasetRefFromSource,
+  c as dependencyDisplayIdentity,
+  x as getCalculatedFieldComputeStage,
+  p as getCustomizableTableCardIds,
+  O as getFieldRuntimeColumnName,
+  C as getSortableTableCardIds,
+  V as hasCalculatedFieldMarker,
+  k as hasCalculatedFormulaInputs,
+  w as hasSyntheticCalculatedFieldOwner,
+  T as humanizeDatasetName,
+  U as inspectCalculatedField,
+  B as isCalculatedDimension,
+  K as isCalculatedMetric,
+  z as isDerivedField,
+  D as isEmptyViewerTableSettings,
+  A as isTableCardCustomizable,
+  I as isTableCardSortable,
+  _ as measureJsonBytes,
+  v as normalizeCalculatedFieldRepresentation,
+  F as normalizeViewerTableSettings,
+  W as parseBookmarkState,
+  S as parseTableColumnId,
+  b as parseViewerTableSettings,
+  L as parseViewerTableSettingsMap,
+  J as readBookmarkState,
+  f as resolveFieldDatasetDependencies,
   H as resolveQueryColumnKeyMapEntry,
   Z as resolveUniqueQueryColumnKeyMapEntry,
-  h as shouldDropInheritedCalculationAggregate,
-  J as toTableColumnId
+  P as shouldDropInheritedCalculationAggregate,
+  N as toTableColumnId
 };

package/dist/types/lib/api/exports-api.d.ts

@@ -1,62 +1,8 @@
-import { TFilterValue } from '../../components/surfboard/filter/types.js';
-import { CsvEncoding } from '../../shared/format-utils/exporters/csv-utils.js';
-import { CardConfig, DataSource, TableTotalsRequest } from '../types/explorer-types.js';
-import { ControlBinding, ControlDefinition } from '../types/common-types.js';
-import { ResolvedPrimaryDateField } from '../types/semantic-runtime-types.js';
-import { ComparisonPresentationSpec, GlobalDateComparisonContext } from '../../shared/analytics-protocol/index.js';
-import { TemporalResultOwner } from '../../shared/dashboard-authoring/index.js';
-import { PresentationExecutionSnapshot } from '../../shared/format-utils/index.js';
-import { MatrixCsvExportRequest } from '../matrix-table/matrix-delivery.js';
+import { ExportFileFormat } from '../../shared/format-utils/index.js';
+import { MatrixFileExportRequest } from '../matrix-table/matrix-delivery.js';
+import { CreateExportRequest } from '../../shared/dashboard-authoring/card-export-request.js';
 export type ExportStatus = 'pending' | 'processing' | 'chunking' | 'compacting' | 'completed' | 'failed' | 'cancelled';
-export type ExportFormat = 'csv';
 export type CardType = 'table' | 'aggregateTable' | 'pivotTable' | 'detailTable';
-/** Formatting configuration passed to the export job */
-export interface ExportFormattingConfig {
-    useFormattedValues: boolean;
-    timezone: string;
-    browserTimezone?: string;
-    isSqlCard?: boolean;
-    delimiter: ',' | ';' | '\t';
-    /** Resolved by the dialog: the person's choice, else the dashboard's setting. */
-    csvEncoding: CsvEncoding;
-    includeHeaders: boolean;
-    columnSettings?: Record<string, unknown>;
-    visibleColumns?: string[];
-    columnLabels?: Record<string, string>;
-    tableTotalsLabelColumnKey?: string;
-    presentationExecutionSnapshot?: PresentationExecutionSnapshot;
-    comparisonPresentation?: ComparisonPresentationSpec;
-}
-export type AuthoritativeExportFormattingConfig = ExportFormattingConfig & {
-    comparisonPresentation: ComparisonPresentationSpec;
-    presentationExecutionSnapshot: PresentationExecutionSnapshot;
-};
-/** Request to create a new export job */
-export interface CreateExportRequest {
-    type: 'visual' | 'card';
-    dashboardId: string;
-    visualId?: string;
-    cardId: string;
-    title?: string;
-    connection_id: string;
-    cardType: string;
-    sql: string;
-    python: string;
-    resultOwner: TemporalResultOwner;
-    cardConfig: CardConfig;
-    cardDataSource: DataSource;
-    active_filters: TFilterValue[];
-    controlValues?: Record<string, unknown>;
-    controlDefinitions?: ControlDefinition[];
-    cardControlDefinitions?: ControlDefinition[];
-    controlBindings?: ControlBinding[];
-    resolvedPrimaryDateField?: ResolvedPrimaryDateField;
-    globalDateComparison?: GlobalDateComparisonContext;
-    tableTotalsRequest?: TableTotalsRequest;
-    totalRows: number;
-    format: ExportFormat;
-    formatOptions: AuthoritativeExportFormattingConfig;
-}
 /** Response from creating an export job */
 export interface CreateExportResponse {
     exportId: string;
@@ -68,7 +14,7 @@ export interface CreateExportResponse {
     originalRows?: number;
     maxRows?: number;
 }
-export type CardExportRequest = CreateExportRequest | MatrixCsvExportRequest;
+export type CardExportRequest = CreateExportRequest | MatrixFileExportRequest;
 /** Export job status response */
 export interface ExportJobStatus {
     id: string;
@@ -125,6 +71,7 @@ export type MatrixDirectExportResult = {
     kind: 'file';
     file: Blob;
     fileName: string;
+    format: ExportFileFormat;
 } | {
     kind: 'background';
     exportId: string;
@@ -132,14 +79,13 @@ export type MatrixDirectExportResult = {
     deadlineAt: string | null;
 };
 /**
- * A Matrix CSV a user downloads: built in the request when it fits the direct
- * limits, otherwise moved to a background export by the server. The file is
- * read as bytes, so its BOM survives. Errors carry the server's catalog
- * reason in `details.message`.
+ * A Matrix CSV or Excel file a user downloads: built in the request when it
+ * fits the direct limits, otherwise moved to a background export by the
+ * server. The file is read as bytes, so a CSV's BOM survives; its format is
+ * the response's content type. Errors carry the server's catalog reason in
+ * `details.message` (an Excel limit answers 422 `excel_limit`).
  */
-export declare function createMatrixDirectExport(apiServiceUrl: string, token: string, params: MatrixCsvExportRequest & {
-    format: 'csv';
-}): Promise<MatrixDirectExportResult>;
+export declare function createMatrixDirectExport(apiServiceUrl: string, token: string, params: MatrixFileExportRequest): Promise<MatrixDirectExportResult>;
 /**
  * Get list of user's exports
  */

package/dist/types/lib/dashboard-inputs/control-contract-overrides.d.ts

@@ -0,0 +1,17 @@
+import { ControlBinding, ControlDefinition, TDashboard } from '../types/common-types.js';
+/** A saved control contract a host replays: a card attachment's controls and bindings. */
+export type ControlContractOverrides = {
+    controlDefinitions?: ControlDefinition[];
+    cardControlDefinitions?: ControlDefinition[];
+    controlBindings?: ControlBinding[];
+};
+/**
+ * Puts a saved control contract on the dashboard (and on one card) before it
+ * hydrates. Mutates and returns `dashboard`: callers pass a copy. The
+ * dashboard's hydration (`useDashboard`) and a saved card's request on the
+ * server (`buildSavedCardRequest`) both apply it here.
+ */
+export declare function applyControlContractOverrides(dashboard: TDashboard, params: {
+    cardId?: string;
+    controlContractOverrides?: ControlContractOverrides | undefined;
+}): TDashboard;

package/dist/types/lib/dashboard-viewer/export-table-view.d.ts

@@ -34,6 +34,8 @@ export declare function readExportViewerTable(state: {
 export declare function resolveExportTableView(input: {
     readonly card: TCard;
     readonly records: readonly Record<string, unknown>[];
+    /** The result's output keys when it has no row to read them from; else the rows' keys. */
+    readonly keys?: readonly string[];
     readonly columnKeyMap?: QueryColumnKeyMap;
     readonly resultColumns?: readonly SemaphorResultColumn[];
     readonly comparisonMetadata?: ComparisonMetadataMap;

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

@@ -15,6 +15,7 @@ export declare function useCard(cardId: string): {
     queryInputIdentity: string | undefined;
     effectivePaginationConfig: import('../types/index.js').PaginationConfig | undefined;
     queryRequestPayload: Record<string, unknown> | undefined;
+    sourceRowProbe: import('../../shared/dashboard-authoring/index.js').CardQuerySourceRowProbe | undefined;
     pagination: import('../types/index.js').PaginationMetadata | undefined;
     comparisonMetadata: import('../../shared/analytics-protocol/index.js').MetricComparisonMetadataMap | undefined;
     resolvedPrimaryDateField: import('../types/semantic-runtime-types.js').ResolvedPrimaryDateField | undefined;
@@ -35,6 +36,7 @@ export declare function useDashboardCard(card: TCard): {
     queryInputIdentity: string | undefined;
     effectivePaginationConfig: import('../types/index.js').PaginationConfig | undefined;
     queryRequestPayload: Record<string, unknown> | undefined;
+    sourceRowProbe: import('../../shared/dashboard-authoring/index.js').CardQuerySourceRowProbe | undefined;
     pagination: import('../types/index.js').PaginationMetadata | undefined;
     comparisonMetadata: import('../../shared/analytics-protocol/index.js').MetricComparisonMetadataMap | undefined;
     resolvedPrimaryDateField: import('../types/semantic-runtime-types.js').ResolvedPrimaryDateField | undefined;

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

@@ -1,6 +1,7 @@
-import { AuthToken, ControlBinding, ControlDefinition, CustomCard, DashboardLifecycleEvent, DashboardInputExecutionSnapshot, TDashboard, TEvent, TStyle } from '../types/common-types.js';
+import { AuthToken, CustomCard, DashboardLifecycleEvent, DashboardInputExecutionSnapshot, TDashboard, TEvent, TStyle } from '../types/common-types.js';
 import { PresentationExecutionSnapshot } from '../../shared/format-utils/index.js';
 import { TFilterValue } from '../../components/surfboard/filter/types.js';
+import { ControlContractOverrides } from '../dashboard-inputs/control-contract-overrides.js';
 import { ViewerTableSettings } from '../../shared/dashboard-viewer/index.js';
 type UseDashboardProps = {
     id?: string;
@@ -11,11 +12,7 @@ type UseDashboardProps = {
         values: string[] | number[];
     }[] | TFilterValue[];
     defaultControlValues?: Record<string, unknown>;
-    controlContractOverrides?: {
-        controlDefinitions?: ControlDefinition[];
-        cardControlDefinitions?: ControlDefinition[];
-        controlBindings?: ControlBinding[];
-    };
+    controlContractOverrides?: ControlContractOverrides;
     dashboardInputExecutionSnapshot?: DashboardInputExecutionSnapshot;
     /** Untrusted per-sheet input capture of a Full dashboard PDF; see resolvePrintInputs. */
     printInputCapture?: unknown;

package/dist/types/lib/matrix-table/matrix-delivery-policy.d.ts

@@ -8,8 +8,14 @@ export declare const MATRIX_EXPORT_CONTENT: readonly [{
     readonly label: "Matrix layout: All detail levels";
 }, {
     readonly value: "flat";
-    readonly label: "Flat aggregate CSV";
+    readonly label: "Flat aggregate table";
 }];
+/**
+ * What a Matrix download or attachment may be: PDF, CSV and Excel for the
+ * layout, CSV and Excel for Flat content, which is a data file only
+ * (XL-D16). Downloads off leaves PDF of the layout. One policy for the export
+ * dialog and Briefing attachments.
+ */
 export declare function matrixDeliveryOptions(allowDownload?: boolean, content?: MatrixExportContent): {
     contents: ({
         readonly value: "current";
@@ -19,7 +25,7 @@ export declare function matrixDeliveryOptions(allowDownload?: boolean, content?:
         readonly label: "Matrix layout: All detail levels";
     } | {
         readonly value: "flat";
-        readonly label: "Flat aggregate CSV";
+        readonly label: "Flat aggregate table";
     })[];
     formats: import('../types/index.js').BriefingAttachmentFormat[];
 };

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

@@ -1,10 +1,11 @@
 import { MatrixConfig, MatrixViewState } from '../../shared/analytics-protocol/index.js';
 import { CsvEncoding } from '../../shared/format-utils/exporters/csv-utils.js';
+import { ExportFileFormat } from '../../shared/format-utils/exporters/export-file-format.js';
 import { MatrixExportContent } from '../../shared/dashboard-authoring/matrix-delivery.js';
 import { ReportRuntimeContext } from '../../shared/report-runtime-context/index.js';
 import { CompiledCardQueryContext } from '../query-context/build-card-query-context.js';
 import { DataSource } from '../types/explorer-types.js';
-import { BriefingAttachment } from '../../briefings.js';
+import { BriefingAttachment, BriefingAttachmentFormat } from '../../briefings.js';
 export { captureMatrixExport, type MatrixExportContent } from '../../shared/dashboard-authoring/matrix-delivery.js';
 /** Schedule authoring shares the query snapshot but explicitly excludes session state. */
 export declare function buildMatrixBriefingAttachment(input: {
@@ -13,7 +14,7 @@ export declare function buildMatrixBriefingAttachment(input: {
     cardId: string;
     title: string;
     content: MatrixExportContent;
-    format: 'csv' | 'pdf';
+    format: BriefingAttachmentFormat;
 }): BriefingAttachment;
 export { MATRIX_EXPORT_CONTENT } from './matrix-delivery-policy.js';
 /** Supplied by the mounted Matrix host, never inferred from resident cells. */
@@ -33,7 +34,7 @@ export declare function buildMatrixDeliveryPayload(input: {
     title: string;
     reportContext: ReportRuntimeContext;
     content: MatrixExportContent;
-    format: 'csv' | 'pdf';
+    format: 'csv' | 'xlsx' | 'pdf';
     delimiter: ',' | ';' | '\t';
     /** CSV only; absent lets the app resolve the dashboard's setting. */
     csvEncoding?: CsvEncoding;
@@ -662,7 +663,7 @@ export declare function buildMatrixDeliveryPayload(input: {
                     }[];
                 } | undefined;
             };
-            format: "csv";
+            format: "csv" | "xlsx";
             spec: {
                 source: {
                     kind: "semantic";
@@ -754,6 +755,7 @@ export declare function buildMatrixDeliveryPayload(input: {
         acquisition?: "continuation" | undefined;
     };
 };
-export type MatrixCsvExportRequest = ReturnType<typeof buildMatrixDeliveryPayload> & {
-    format: 'csv';
+/** A Matrix data file request (CSV or Excel) for the direct path or a job. */
+export type MatrixFileExportRequest = ReturnType<typeof buildMatrixDeliveryPayload> & {
+    format: ExportFileFormat;
 };

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

@@ -0,0 +1,50 @@
+import { TCard, TDashboard } from '../types/common-types.js';
+import { PaginationConfig } from '../types/explorer-types.js';
+import { ResolvedPrimaryDateField } from '../types/semantic-runtime-types.js';
+import { TableConfig } from '../types/query-types.js';
+import { CardQueryContext, CompiledCardQueryContext } from './build-card-query-context.js';
+import { CalendarContext } from '../../shared/report-runtime-context/index.js';
+import { DashboardCardQueryRequestPayloadBase } from '../../shared/dashboard-authoring/card-query-request.js';
+import { CompiledDashboardCardFilters, CompileDashboardCardFiltersParams } from './compile-dashboard-card-filters.js';
+export type { DashboardCardQueryRequestPayloadBase } from '../../shared/dashboard-authoring/card-query-request.js';
+export type DashboardCardQueryContract = {
+    status: 'ready';
+    queryKey: string[];
+    queryInputIdentity: string;
+    paginationConfig?: PaginationConfig;
+    requestPayloadBase: DashboardCardQueryRequestPayloadBase;
+    tableConfig: TableConfig;
+    compiledFilters: CompiledDashboardCardFilters;
+};
+export type DashboardCardQueryContractResult = DashboardCardQueryContract | {
+    status: 'blocked';
+    cardId: string;
+    mappingDispositions: CompiledDashboardCardFilters['mappingDispositions'];
+    tableConfig: TableConfig;
+};
+/** Test/invariant helper for fixtures that cannot contain mapped inputs. */
+export declare function requireReadyDashboardCardQueryContract(result: DashboardCardQueryContractResult): DashboardCardQueryContract;
+export type DashboardCardQueryExecutionOptions = {
+    resolvedPrimaryDateField?: ResolvedPrimaryDateField;
+    calendarContext: CalendarContext;
+    allowGlobalDateMinutePrecision?: boolean;
+    /**
+     * The cache settings of the dashboard the card belongs to (ledger P1-01).
+     * Required so that every caller decides; never read from the store.
+     */
+    globalCacheConfig: TDashboard['globalCacheConfig'];
+    resolvePaginationConfig?: (queryInputIdentity: string) => PaginationConfig | undefined;
+};
+/** One final compilation for interactive requests and immutable input captures. */
+export declare function compileDashboardCardQueryContext(card: TCard, context: CardQueryContext, execution: Omit<CompileDashboardCardFiltersParams, 'card' | 'cardConfig' | 'input'>): {
+    status: "blocked";
+    cardId: string;
+    mappingDispositions: import('./dashboard-filter-mapping-resolution.js').DashboardFilterMappingDisposition[];
+} | {
+    status: "ready";
+    queryContext: CompiledCardQueryContext;
+    compiledFilters: CompiledDashboardCardFilters & {
+        status: "ready";
+    };
+};
+export declare function buildDashboardCardQueryContract(card: TCard, context: CardQueryContext, execution: DashboardCardQueryExecutionOptions): DashboardCardQueryContractResult;

package/dist/types/lib/query-context/card-server-request.d.ts

@@ -39,10 +39,14 @@ export declare function resolveCardRequestExtras(input: {
     card: TCard;
     /** The config the card runs with (drilled, sorted): its totals are taken from it. */
     finalConfig: CardConfig | undefined;
-    /** A printed table runs whole. Default: on screen. */
+    /**
+     * A printed table runs whole. Default: on screen. `deliveryStrict` (a
+     * scheduled report's render) also asks for source-row evidence (RA-D15).
+     */
     display?: {
         isTablePrintMode: boolean;
         isPrintDisplayMode: boolean;
+        deliveryStrict?: boolean;
     };
     /** Present for a card in a Document section, with the section's table policy. */
     documentSection?: {

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

@@ -131,6 +131,13 @@ export type VisualDisplayPreferences = {
      * - 'table-print': Table-specific print mode (title only, no pagination/toolbar)
      */
     mode?: VisualDisplayMode;
+    /**
+     * 'strict' only on a render made for delivery (a scheduled report). A table
+     * print query then asks for source-row evidence, and a card that can't be
+     * delivered complete marks the page instead of printing. Absent: behave
+     * exactly as today (report attachment delivery RA-D11).
+     */
+    delivery?: 'strict';
     /**
      * Override specific UI elements visibility
      * These overrides take precedence over the mode presets

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

@@ -1,7 +1,7 @@
 import { TimeDrillStep } from './interaction-types.js';
 import { SemaphorDerivedFieldDefinition, MatrixConfig, SemaphorSourceRef, SemaphorResultColumn, SemaphorPivotValue, SemaphorTimeGrain, SemanticGroupedTemporalInput, TemporalBucketMetadata, TemporalBucketFormat, MetricComparisonConfig, MetricComparisonPolarity } from '../../shared/analytics-protocol/index.js';
 import { CanonicalPivotResultContract, CanonicalPivotResultState, FlatTableExportTotalsBehavior, FlatTableExportTotalsRequest, QueryColumnKeyMap as SharedQueryColumnKeyMap } from '../../shared/format-utils/index.js';
-import { TemporalResultOwner } from '../../shared/dashboard-authoring/index.js';
+import { CardQuerySourceRowEvidence, TemporalResultOwner } from '../../shared/dashboard-authoring/index.js';
 import { RelativeDateFilter } from '../../shared/analytics-protocol/relative-date-filter.js';
 /**
  * Special entity name marker for calculated fields.
@@ -700,6 +700,12 @@ export interface PaginationMetadata {
     totalCount: number;
     hasNextPage: boolean;
     hasPrevPage: boolean;
+    /**
+     * `verified` only when the count query returned its row; `unavailable` when
+     * it failed (the count shown is then today's fallback, never a fact). A
+     * server export sizes itself only from a verified count (Excel exports XL-D21).
+     */
+    totalCountStatus?: 'verified' | 'unavailable';
 }
 export { resolveQueryColumnKeyMapEntry, resolveUniqueQueryColumnKeyMapEntry, type QueryColumnKeyMapByRole, type QueryColumnKeyMapEntry, type QueryColumnKeyRole, } from '../../shared/format-utils/pivot-result-identity.js';
 export type QueryColumnKeyMap = SharedQueryColumnKeyMap;
@@ -708,7 +714,7 @@ export type TableTotalsRequest = FlatTableExportTotalsRequest;
 /**
  * Response structure for query execution (standard queries and comparison queries)
  */
-export interface QueryExecutionResponse {
+export interface QueryExecutionResponse extends CardQuerySourceRowEvidence {
     records: any[];
     /** Execution owner captured with these exact result rows. */
     resultOwner?: TemporalResultOwner;

package/dist/types/shared/analytics-protocol/matrix-definition-contract.d.ts

@@ -6861,7 +6861,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
     presentation: MatrixPresentationSchema;
 } & {
     mode: z.ZodLiteral<"flat">;
-    format: z.ZodLiteral<"csv">;
+    format: z.ZodEnum<["csv", "xlsx"]>;
 }, "strict", z.ZodTypeAny, {
     mode: "flat";
     presentation: {
@@ -7086,7 +7086,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
             }[];
         } | undefined;
     };
-    format: "csv";
+    format: "csv" | "xlsx";
     spec: {
         source: {
             kind: "semantic";
@@ -7379,7 +7379,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
             }[];
         } | undefined;
     };
-    format: "csv";
+    format: "csv" | "xlsx";
     spec: {
         source: {
             kind: "semantic";

package/dist/types/shared/assistant-context/index.d.ts

@@ -6,4 +6,4 @@
  * case's context from a saved dashboard with `projectSavedDashboardContext`.
  */
 export { AssistantContextSourceError, projectAssistantContext, type AssistantContextSource, type AssistantContextSourceIssue, } from './project-context.js';
-export { assistantCardReplayFields, buildSavedCardRequest, cardReplayOf, projectSavedDashboardContext, projectSavedDashboardTurn, type AssistantCardReplayFields, type SavedCardRequestRefusal, type SavedDashboardPlace, } from './saved-dashboard-context.js';
+export { assistantCardReplayFields, buildSavedCardRequest, cardReplayOf, projectSavedDashboardContext, projectSavedDashboardTurn, type AssistantCardReplayFields, type SavedCardHost, type SavedCardRequestRefusal, type SavedDashboardPlace, } from './saved-dashboard-context.js';

package/dist/types/shared/assistant-context/saved-dashboard-context.d.ts

@@ -1,5 +1,7 @@
-import { TCard, TDashboard } from '../../lib/types/common-types.js';
+import { DashboardInputExecutionSnapshot, TCard, TDashboard } from '../../lib/types/common-types.js';
+import { TFilterValue } from '../../components/surfboard/filter/types.js';
 import { CardViewStateMap } from '../../lib/dashboard-view-state/index.js';
+import { ControlContractOverrides } from '../../lib/dashboard-inputs/control-contract-overrides.js';
 import { SemanticExecutionPayload } from '../../lib/types/semantic-runtime-types.js';
 import { CalendarContext } from '../report-runtime-context/index.js';
 import { ViewerStoreInputValues } from '../../lib/dashboard-viewer/compatibility-input-storage.js';
@@ -108,11 +110,25 @@ export declare function cardReplayOf(input: {
     message?: string;
 };
 /**
- * A saved card's request as a fresh viewer opens it (saved defaults, no
- * bookmark, no drill), for an external client's `fromCard` replay
- * (analytics agent Plan 1, Phase 3b, D3b-2). The same owners as the context:
- * the viewer baseline, the store's input values, the card's snapshot with its
- * request, and the server-request owner CSV export shares. Pure; the caller
+ * What a host opens a saved dashboard with, as a scheduled card attachment's
+ * print view gets it: default filter and control values, a saved control
+ * contract, and a saved input snapshot. Every field is optional; none at all
+ * is a fresh viewer (saved defaults).
+ */
+export type SavedCardHost = {
+    filterValues?: readonly TFilterValue[];
+    controlValues?: Readonly<Record<string, unknown>>;
+    controlContract?: ControlContractOverrides;
+    dashboardInputExecutionSnapshot?: DashboardInputExecutionSnapshot;
+};
+/**
+ * A saved card's request as a host opens it: by default a fresh viewer
+ * (saved defaults, no bookmark, no drill), for an external client's
+ * `fromCard` replay (analytics agent Plan 1, Phase 3b, D3b-2); with `host`,
+ * a scheduled card attachment's saved values, the values its print view
+ * opens with (Excel exports Phase 6). The same owners as the context: the
+ * viewer baseline, the store's input values, the card's snapshot with its
+ * request, and the server-request owner exports share. Pure; the caller
  * loads the dashboard, its semantic payload and calendar, and checks access.
  */
 export declare function buildSavedCardRequest(input: {
@@ -120,6 +136,7 @@ export declare function buildSavedCardRequest(input: {
     cardId: string;
     semanticExecutionPayload: SemanticExecutionPayload | undefined;
     calendar: CalendarContext;
+    host?: SavedCardHost;
 }): {
     status: 'ready';
     request: AssistantCardRequest;