react-semaphor 0.1.537 → 0.1.539

package/dist/surfboard/index.js

@@ -1,5 +1,5 @@
-import { a, R as s, D as o } from "../chunks/report-preferences-dialog-DXPjteCU.js";
-import { C as f, E as D } from "../chunks/common-types-g7yS12Cg.js";
+import { a, R as s, D as o } from "../chunks/report-preferences-dialog-CWhSbc5_.js";
+import { C as f, E as D } from "../chunks/common-types-CUf03Htv.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

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

@@ -0,0 +1,2 @@
+export * from './shared/assistant-context/index.js'
+export {}

package/dist/types/assistant-protocol.d.ts

@@ -0,0 +1,2 @@
+export * from './shared/assistant-protocol/index.js'
+export {}

package/dist/types/components/assistant/assistant-entry-points.d.ts

@@ -0,0 +1,18 @@
+/** Where the panel is: beside a dashboard, or on a page with no dashboard in view. */
+export type AssistantPanelSurface = 'dashboard' | 'none';
+/** Opens and closes the panel. Named after the assistant; no other wording. */
+export declare function AssistantToolbarButton(): import("react").JSX.Element | null;
+/**
+ * The panel. Beside a dashboard (`surface="dashboard"`), the chat mounts on
+ * the first open and stays mounted while the panel is closed, so its
+ * conversation and draft are kept; it shows beside the card editor too, where
+ * the draft being edited is the card in focus (Phase 5, D5-1); unmounting the
+ * provider ends them. Hidden with a class, not `Activity`: a hidden Activity
+ * would run the chat's cleanup and stop an answer the viewer is still waiting
+ * for. With no dashboard in view (`surface="none"`, the host's assistant
+ * page, D3c-9) it is always shown, in full page, filling the host's
+ * positioned container.
+ */
+export declare function AssistantPanel({ surface }?: {
+    surface?: AssistantPanelSurface;
+}): import("react").JSX.Element | null;

package/dist/types/components/assistant/assistant-provider.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+import { AuthToken } from '../../lib/types/common-types.js';
+export declare function AssistantProvider({ children, authToken, }: {
+    children: ReactNode;
+    /**
+     * The dashboard's token, for a host that mounts the provider above its own
+     * toolbar and the dashboard. Null while there is none (the assistant is
+     * unavailable). Omitted inside the dashboard, which reads its own token.
+     */
+    authToken?: AuthToken | null;
+}): import("react").JSX.Element;
+/**
+ * The dashboard's assistant: the host's instance when the host mounted a
+ * provider above it, otherwise one of its own. One instance per caller, never
+ * two (L3-6).
+ */
+export declare function AssistantScope({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/types/components/assistant/assistant-store.d.ts

@@ -0,0 +1,52 @@
+import { StoreApi } from 'zustand/vanilla';
+import { AssistantLayout } from '../../shared/assistant-protocol/conversation.js';
+/**
+ * One assistant instance's panel state (analytics agent Plan 1, ledger
+ * D3a-10, L3-4). Created by the provider for one caller, never at module
+ * level: a different caller gets a new store, so nothing here needs a reset.
+ * The conversation itself (messages, its id, the answer streaming) lives in
+ * the chat, which mounts on first open and stays mounted while the panel is
+ * closed.
+ */
+/** The card the user asked about, on the sheet it was asked on. */
+export type AssistantFocus = {
+    cardId: string;
+    sheetId: string | null;
+};
+export type AssistantPanelState = {
+    isOpen: boolean;
+    /** True from the first open: the chat stays mounted (hidden while closed), so its conversation is kept. */
+    mounted: boolean;
+    focus: AssistantFocus | undefined;
+    /** Counts Ask actions, so the composer takes focus on each one. */
+    askCount: number;
+    /** Where the panel shows (AG-D21, D3c-4): the viewer's saved choice, else the token's default, else docked right. */
+    layout: AssistantLayout;
+    /** The docked panel's width in pixels: the viewer's saved choice, else the default. */
+    width: number;
+};
+export type AssistantStore = {
+    store: StoreApi<AssistantPanelState>;
+    toggle(): void;
+    close(): void;
+    askAbout(focus: AssistantFocus): void;
+    clearFocus(): void;
+    setLayout(layout: AssistantLayout): void;
+    /** Sets the docked width, clamped; `save` keeps it in this browser (at the end of a drag, on each key). */
+    setWidth(width: number, options?: {
+        save?: boolean;
+    }): void;
+};
+/** The viewer's layout choice, kept in this browser (AG-D21). */
+export declare const ASSISTANT_LAYOUT_STORAGE_KEY = "semaphor.assistant.layout";
+/** The viewer's docked width, kept in this browser. */
+export declare const ASSISTANT_WIDTH_STORAGE_KEY = "semaphor.assistant.width";
+/** The docked panel's width: the default, and the range a viewer can resize it within. */
+export declare const ASSISTANT_WIDTH: {
+    readonly default: 360;
+    readonly min: 320;
+    readonly max: 720;
+};
+export declare function clampAssistantWidth(width: number, maxForArea?: number): number;
+/** `defaultLayout`: the token's `config.assistant.layout`, an embed's default (AG-D21); the viewer's own choice wins. */
+export declare function createAssistantStore(defaultLayout?: AssistantLayout): AssistantStore;

package/dist/types/components/assistant/use-assistant.d.ts

@@ -0,0 +1,38 @@
+import { AssistantLayout } from '../../shared/assistant-protocol/conversation.js';
+import { AssistantStore } from './assistant-store.js';
+/**
+ * The assistant instance a provider holds, and the hooks that read it
+ * (analytics agent Plan 1, spec 5). Light: imported by the toolbar, the card
+ * menu and the panel.
+ */
+/** One caller's assistant. `id` keys the chat: a new caller mounts a new chat. */
+export type AssistantInstance = AssistantStore & {
+    id: number;
+    callerKey: string;
+    assistantName: string;
+};
+export type AssistantContextValue = {
+    instance: AssistantInstance;
+    available: boolean;
+};
+export declare const AssistantInstanceContext: import('react').Context<AssistantContextValue | null>;
+/** The instance, for the panel and the chat. Undefined outside a provider. */
+export declare function useAssistantInstance(): AssistantContextValue | null;
+export type UseAssistantResult = {
+    available: boolean;
+    isOpen: boolean;
+    assistantName: string;
+    layout: AssistantLayout;
+    toggle(): void;
+    close(): void;
+    setLayout(layout: AssistantLayout): void;
+    askAbout(cardId: string): void;
+    clearSelectedCard(): void;
+};
+/** Read where there is no provider; never written. */
+export declare const NO_ASSISTANT_STORE: import('zustand').StoreApi<import('./assistant-store.js').AssistantPanelState>;
+/**
+ * For the toolbar button and Ask. Outside a provider, or when the assistant
+ * is unavailable, `available` is false and every entry point renders nothing.
+ */
+export declare function useAssistant(): UseAssistantResult;

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

@@ -33,6 +33,10 @@ export * from './editor/editor-aside/utils.js';
 export * from '../lib/hooks/use-editor-aside.js';
 export { VisualEditingControls } from './editor/editor-main/visual-editing-controls.js';
 export { AdvancedModeToggle } from './editor/editor-main/advanced-mode-toggle.js';
+export { AssistantProvider } from './assistant/assistant-provider.js';
+export { AssistantPanel, AssistantToolbarButton } from './assistant/assistant-entry-points.js';
+export type { AssistantPanelSurface } from './assistant/assistant-entry-points.js';
+export { useAssistant } from './assistant/use-assistant.js';
 export * from '../lib/types/common-types.js';
 export * from '../lib/stores/dashboard-store.js';
 export * from '../lib/stores/editor-store.js';
@@ -42,7 +46,7 @@ export { normalizeDashboardForDirtyCheck, serializeDashboardForDirtyCheck, } fro
 export { cloneDeep } from '../lib/object-utils.js';
 export { Combobox } from './ui-custom/combo-box.js';
 export * from './providers/semaphor-query-provider.js';
-export { invalidateToken } from '../lib/utils.js';
+export { invalidateToken } from '../lib/api/invalidate-token.js';
 export { downloadPdf, downloadDocumentPdf } from '../lib/download-pdf.js';
 export { DashboardExportDialog } from './dashboard/dashboard-export-dialog.js';
 export { DashboardCreateDialogBase, type DashboardCreateDialogBaseProps, } from './dashboard/ai-dashboard-create-dialog.js';

package/dist/types/components/surfboard/filter/types.d.ts

@@ -75,6 +75,11 @@ export type FilterFieldMeta = Pick<Field, 'name' | 'qualifiedFieldName'> & Parti
     nativeDataType?: string;
     expression?: string;
     calculatedFormula?: CalculatedFieldFormula;
+    /**
+     * The dashboard input's title, as the viewer sees it: how evidence names
+     * the condition (ledger P3-100). Never used to resolve the field.
+     */
+    label?: string;
 };
 export type FilterSemanticContext = {
     semanticDomainId?: string;
@@ -218,8 +223,6 @@ export type FilterStorageOptions = {
     setInlineFilterValue?: (filterValue: TFilterValue) => void;
     /** Optional inline filter value remover override for editor-scoped state. */
     removeInlineFilterValue?: (filterId: string) => void;
-    /** Optional inline filter mode setter override for non-dashboard state. */
-    setInlineFilterMode?: (filterId: string, filterMode: 'include' | 'exclude') => void;
     /** Sheet kind of the target; inferred from the dashboard when omitted. */
     sheetKind?: 'dashboard' | 'document';
     /** Document section id when the Input is local to one section. */

package/dist/types/index.js

@@ -1,10 +1,9 @@
-import { C as s, E as r } from "../chunks/common-types-g7yS12Cg.js";
-import { C as o, D as i, L as n, P as d, f as m, g as u, k as c, j as E, l as p, e as C, c as T, b as D, d as A, n as I, h as _ } from "../chunks/validators-DMSH81OM.js";
-import { c as S, g as b, f, b as L, e as N, d as R, a as g, h, r as x } from "../chunks/field-dependencies-CpRUwr9J.js";
-import { D as M } from "../chunks/token-types-DtSJOUjh.js";
-import { B as V, j as k, V as w, a as U, h as B, g as K, i as z, f as v, e as P, m as Y, n as G, p as Q, b as j, c as q, d as W, r as J, t as X } from "../chunks/bookmark-state-B-I9BDD0.js";
-import { r as Z, a as $ } from "../chunks/pivot-result-identity-Bs4tLtLo.js";
-import { D as ae } from "../chunks/report-runtime-context-CG_I0PPW.js";
+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";
 const e = [
   "concatenate",
   "conditional-category",
@@ -38,52 +37,52 @@ const e = [
   "is-blank"
 ];
 export {
-  V as BOOKMARK_STATE_VERSION,
-  k as BOOKMARK_VISIBILITIES,
-  o as CALCULATED_FIELD_ENTITY_MARKER,
+  O as BOOKMARK_STATE_VERSION,
+  V as BOOKMARK_VISIBILITIES,
+  p as CALCULATED_FIELD_ENTITY_MARKER,
   e as CALCULATED_FIELD_TEMPLATE_IDS,
   s as CONTROL_CARD_DEFAULT_VALUE,
-  i as DATE_FORMAT_VALUES,
-  ae as DEFAULT_CALENDAR_CONTEXT,
+  T as DATE_FORMAT_VALUES,
+  ee as DEFAULT_CALENDAR_CONTEXT,
   M as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
   r as EMPTY_SELECTION,
-  n as LEGACY_CALCULATED_FIELD_ENTITY_MARKER,
-  d as PivotMarkerEnum,
-  w as VIEWER_LIMITS,
-  U as VIEWER_TABLE_SETTINGS_VERSION,
-  S as collectDatasetNamesFromExplorerField,
-  b as collectDatasetNamesFromFilterGroup,
-  f as collectExecutionDatasetNamesFromExplorerField,
-  L as collectPreferredDatasetNamesFromExplorerField,
-  N as collectQualifiedDatasetNamesFromExplorerField,
-  R as datasetRefFromSource,
-  g as dependencyDisplayIdentity,
-  m as getCalculatedFieldComputeStage,
-  B as getCustomizableTableCardIds,
-  u as getFieldRuntimeColumnName,
-  K as getSortableTableCardIds,
-  c as hasCalculatedFieldMarker,
-  E as hasCalculatedFormulaInputs,
-  p as hasSyntheticCalculatedFieldOwner,
-  h as humanizeDatasetName,
-  C as inspectCalculatedField,
-  T as isCalculatedDimension,
-  D as isCalculatedMetric,
-  A as isDerivedField,
-  z as isEmptyViewerTableSettings,
-  v as isTableCardCustomizable,
-  P as isTableCardSortable,
-  Y as measureJsonBytes,
-  I as normalizeCalculatedFieldRepresentation,
-  G as normalizeViewerTableSettings,
-  Q as parseBookmarkState,
-  j as parseTableColumnId,
-  q as parseViewerTableSettings,
-  W as parseViewerTableSettingsMap,
-  J as readBookmarkState,
-  x as resolveFieldDatasetDependencies,
-  Z as resolveQueryColumnKeyMapEntry,
-  $ as resolveUniqueQueryColumnKeyMapEntry,
-  _ as shouldDropInheritedCalculationAggregate,
-  X as toTableColumnId
+  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,
+  H as resolveQueryColumnKeyMapEntry,
+  Z as resolveUniqueQueryColumnKeyMapEntry,
+  h as shouldDropInheritedCalculationAggregate,
+  J as toTableColumnId
 };

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

@@ -0,0 +1,7 @@
+/**
+ * Invalidates the dashboard's current token on the server. Apart from
+ * `lib/utils` because it reads the dashboard store: the pure helpers there are
+ * loaded by server entries (`react-semaphor/assistant-context`), which must
+ * not load the store.
+ */
+export declare function invalidateToken(apiServiceUrl: string): Promise<any>;

package/dist/types/lib/charts/cartesian-fields.d.ts

@@ -0,0 +1,64 @@
+import { TCard } from '../types/common-types.js';
+import { CardConfig, Field, QueryColumnKeyMap } from '../types/explorer-types.js';
+import { CartesianTemporalPresentation } from '../formatters/cartesian-temporal-presentation.js';
+export declare const CARTESIAN_AXIS_PATH_SEPARATOR = " \u00B7 ";
+export type CartesianFieldRoles = {
+    /** Result keys for the category path, outer to inner. */
+    axisKeys: string[];
+    /** Result key whose values become series through a local pivot. */
+    seriesKey?: string;
+    /** Result keys plotted as values, in display order. */
+    valueKeys: string[];
+};
+export declare function usesCartesianFieldRoles(cardType?: string): boolean;
+/**
+ * The saved Sort setting applies only where the editor offers it, so a value
+ * left over from switching chart type has no effect.
+ */
+export declare function supportsChartSort(cardType?: string): boolean;
+export declare function isStackedCartesianChartType(cardType?: string): boolean;
+/**
+ * Legacy stacked shape: exactly two Rows fields and an empty Pivot zone render
+ * the second Rows field as the series. Saved dashboards depend on this, so it
+ * is kept for that exact shape only and never extended to more Rows fields.
+ */
+export declare function resolveLegacySeriesGroupField(cardConfig: CardConfig | undefined): Field | undefined;
+/**
+ * Resolve cartesian roles for a chart.
+ *
+ * `keys` are the result keys in display order (comparison internals removed,
+ * temporal axis first), as builders already compute them.
+ */
+export declare function resolveCartesianFieldRoles(input: {
+    card: TCard;
+    cardType: string;
+    keys: readonly string[];
+    columnKeyMap?: QueryColumnKeyMap;
+    isComparison: boolean;
+}): CartesianFieldRoles;
+/**
+ * Order records so bars sharing an outer axis value are contiguous, keeping
+ * first-appearance order of groups and query order within a group. With a sort
+ * direction, groups are ordered by group total and records within each group
+ * by record total. Single-level charts without a sort keep their order.
+ */
+export declare function orderCartesianRecordsByAxisPath<T extends Record<string, unknown>>(input: {
+    records: readonly T[];
+    axisKeys: readonly string[];
+    valueKeys: readonly string[];
+    sortChart?: 'asc' | 'desc' | 'none';
+}): T[];
+/**
+ * The one rule for a missing category on a chart axis: only null, undefined
+ * and empty text are missing, so `0` and `false` stay categories of their own
+ * (ledger P4-20; analytics agent Plan 1).
+ */
+export declare function isMissingCategory(value: unknown): boolean;
+/** One level of a multi-level path. */
+export declare function formatAxisPathLevel(value: unknown, columnKey: string, temporalPresentation?: CartesianTemporalPresentation): string;
+/**
+ * Axis labels for the category path. One-level paths match `getXaxisLabels`;
+ * deeper paths join each formatted level with ` · `. Both read a missing
+ * category by `isMissingCategory`.
+ */
+export declare function formatCartesianAxisPathLabels(records: readonly Record<string, unknown>[], axisKeys: readonly string[], temporalPresentation?: CartesianTemporalPresentation): unknown[];

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

@@ -6,6 +6,7 @@ import { QueryColumnKeyMap } from '../types/explorer-types.js';
 import { SemaphorResultColumn } from '../../shared/analytics-protocol/index.js';
 import { PresentationExecutionSnapshot } from '../../shared/format-utils/index.js';
 import { CartesianTemporalPresentation } from '../formatters/cartesian-temporal-presentation.js';
+import { CartesianFieldRoles } from './cartesian-fields.js';
 export type ChartConfigParams = {
     card: TCard;
     data: any[];
@@ -31,6 +32,12 @@ export type ChartConfigParams = {
     isDevMode?: boolean;
     comparisonMetadata?: ComparisonMetadataMap;
     numericPresentation?: ChartNumericPresentationContext;
+    /**
+     * Cartesian roles (axis, series, values) from a caller without saved Rows
+     * and Pivot fields, such as an assistant answer's result. Without it, roles
+     * come from the card's fields, or by position for an SQL card.
+     */
+    fieldRoles?: CartesianFieldRoles;
 };
 export type BlurEffectProps = {
     chart: Chart;

package/dist/types/lib/dashboard-inputs/dashboard-filter-mapping-storage-transition.d.ts

@@ -12,7 +12,14 @@ export type DashboardFilterStorageState = {
 };
 export type DashboardFilterAuthoringSettingsUpdate = {
     forceSelection?: boolean;
-    /** Explicit reset of a persisted default slot that may lack a backing default. */
+    /**
+     * The caller changed the default its target loads. Filter settings start
+     * from the target's saved default (`resolveAuthoredFilterDefaultFields`),
+     * which can differ from the definition for a scoped Input or an overlay
+     * entry, so they say so; callers that start from the definition leave it
+     * unset and the owner compares definitions. Also resets a saved slot that
+     * has no backing default.
+     */
     defaultValueChanged?: boolean;
     defaultComparisonChanged?: boolean;
     defaultComparisonSelection?: GlobalDateComparisonSelection;
@@ -36,7 +43,12 @@ export type DashboardFilterOptionPolicy = {
 /** Resolves the policy an authoring transaction should persist. */
 export declare function resolveFilterOptionPolicy(current: DashboardFilterOptionPolicy | undefined, settings: DashboardFilterAuthoringSettingsUpdate | undefined): DashboardFilterOptionPolicy;
 export declare function hasFilterOptionPolicy(policy: DashboardFilterOptionPolicy | undefined): boolean;
-/** Callers submit edits; the owner decides whether defaults must be reseeded. */
+/**
+ * Callers submit edits; the owner decides whether defaults must be reseeded.
+ * A default change (values, date window or mode) writes the target's saved
+ * default and live value; the definition, which the caller submits whole,
+ * holds the last authored default.
+ */
 export declare function resolveFilterAuthoringSettings(previous: TFilter | undefined, filter: TFilter, settings: DashboardFilterAuthoringSettingsUpdate | undefined, target: DashboardInputRuntimeTarget, calendar?: DefaultsCalendar): {
     target: DashboardInputRuntimeTarget;
     defaultValueChanged: boolean;

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

@@ -1,6 +1,7 @@
+import { CalendarContext } from '../../shared/report-runtime-context/index.js';
 import { ControlDefinition, NormalizedDashboardInput, NormalizedFilterDashboardInput, TCard, TDashboard } from '../types/common-types.js';
 import { TFilter, TFilterValue } from '../../components/surfboard/filter/types.js';
-import { DashboardInputResolveMode, DashboardInputRuntimeValues } from './resolve-dashboard-input-context.js';
+import { DashboardInputRuntimeValues } from './resolve-dashboard-input-context.js';
 /**
  * The Input target context: one resolved view of "what is in scope" for a
  * filter whose options are browsed, searched, label-resolved or authored.
@@ -71,7 +72,6 @@ export type DashboardInputTargetContext = {
         definitions: ControlDefinition[];
         values: Record<string, unknown>;
     };
-    resolveMode: DashboardInputResolveMode;
     validation: DashboardInputValidationPolicy;
     /** Inputs excluded from this context, each with its reason. */
     excluded: DashboardInputTargetExclusion[];
@@ -85,15 +85,15 @@ export type BuildDashboardInputTargetContextInput = {
     /** The card a card-local target belongs to; lifts its inline inputs. */
     card?: TCard | null;
     runtimeValues: DashboardInputRuntimeValues;
-    resolveMode?: DashboardInputResolveMode;
     validation?: DashboardInputValidationPolicy;
-    timezone?: string;
+    /** The report calendar input defaults resolve in (CQ-D8); null only before the report context loads. */
+    calendar: CalendarContext | null;
 };
 export declare class DashboardInputTargetContextError extends Error {
     readonly exclusions: DashboardInputTargetExclusion[];
     constructor(exclusions: DashboardInputTargetExclusion[]);
 }
-export declare function buildDashboardInputTargetContext({ dashboard, filter, scope: requestedScope, card, runtimeValues, resolveMode, validation, timezone, }: BuildDashboardInputTargetContextInput): DashboardInputTargetContext;
+export declare function buildDashboardInputTargetContext({ dashboard, filter, scope: requestedScope, card, runtimeValues, validation, calendar, }: BuildDashboardInputTargetContextInput): DashboardInputTargetContext;
 /**
  * An explicit context for surfaces that inject their own scope (explorer
  * field probes, captured execution). Nothing is read from a store; the
@@ -106,7 +106,6 @@ export declare function createExplicitDashboardInputTargetContext(params: {
     values?: TFilterValue[];
     adHocValues?: TFilterValue[];
     controls?: DashboardInputTargetContext['controls'];
-    resolveMode?: DashboardInputResolveMode;
     target?: NormalizedFilterDashboardInput;
 }): DashboardInputTargetContext;
 /**

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

@@ -1,3 +1,4 @@
+import { CalendarContext } from '../../shared/report-runtime-context/index.js';
 import { TFilterValue } from '../../components/surfboard/filter/types.js';
 import { DashboardInput, NormalizedDashboardInput, DashboardInputSlot, DashboardInputValues, TDashboard } from '../types/common-types.js';
 import { GlobalDateComparisonSelection } from '../../shared/analytics-protocol/index.js';
@@ -22,7 +23,8 @@ export declare function hydrateAuthoredDashboardInputSlot(params: {
     input: NormalizedDashboardInput;
     runtimeValues?: DashboardInputValues;
     target: DashboardInputRuntimeTarget;
-    timezone?: string;
+    /** The report calendar a default resolves in; null only before the report context loads (CQ-D8). */
+    calendar: CalendarContext | null;
 }): DashboardInputSlot | undefined;
 /** Materialize protected empty slots at writes using the same policy as reads.
  * Missing scoped slots may still inherit defaults lazily until first use.
@@ -30,13 +32,16 @@ export declare function hydrateAuthoredDashboardInputSlot(params: {
 export declare function restoreForcedDashboardInputValues(params: {
     dashboard: Pick<TDashboard, 'inputs' | 'filters' | 'defaultInputValues'>;
     runtimeValues: DashboardInputValues;
-    timezone?: string;
+    /** The report calendar forced defaults resolve in; null only before the report context loads (CQ-D8). */
+    calendar: CalendarContext | null;
 }): DashboardInputValues;
 export declare function setDashboardInputRuntimeComparisonSelection(values: DashboardInputValues, input: Pick<DashboardInput, 'id' | 'runtimeScope'>, target: DashboardInputRuntimeTarget, comparisonSelection: GlobalDateComparisonSelection | undefined): DashboardInputValues;
 export declare function setDashboardInputRuntimeValueAspect(values: DashboardInputValues, input: Pick<DashboardInput, 'id' | 'runtimeScope'>, target: DashboardInputRuntimeTarget, valueAspect: Extract<DashboardInputSlot, {
     status: 'set' | 'cleared';
 }>): DashboardInputValues;
-export declare function getBackingDefaultSlot(input: NormalizedDashboardInput, timezone?: string): DashboardInputSlot | undefined;
+export declare function getBackingDefaultSlot(input: NormalizedDashboardInput, 
+/** The report calendar the default resolves in; null only before the report context loads (CQ-D8). */
+calendar: CalendarContext | null): DashboardInputSlot | undefined;
 export declare function createFilterDashboardInputSlot(filterValue: TFilterValue | undefined): DashboardInputSlot | undefined;
 export declare function createControlDashboardInputSlot(value: unknown): DashboardInputSlot | undefined;
 export declare function cloneDashboardInputValues(values: DashboardInputValues | undefined): DashboardInputValues;

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

@@ -1,3 +1,4 @@
+import { CalendarContext } from '../../shared/report-runtime-context/index.js';
 import { CardViewStateMap } from '../dashboard-view-state/index.js';
 import { TFilterValue } from '../../components/surfboard/filter/types.js';
 import { DashboardInputValues, NormalizedDashboardInput, ResolvedDashboardInput, ResolvedDashboardInputContext, TCard, TDashboard } from '../types/common-types.js';
@@ -5,7 +6,6 @@ import { DashboardInputRuntimeTarget } from './dashboard-input-values.js';
 import { doesDashboardInputApplyToTarget } from './dashboard-input-scope.js';
 import { TransientInputContext } from './transient-input-context.js';
 export { doesDashboardInputApplyToTarget };
-export type DashboardInputResolveMode = 'interactive' | 'editor' | 'print' | 'schedule' | 'export';
 export type DashboardInputRuntimeValues = {
     dashboardInputValues?: DashboardInputValues;
     filterValues?: TFilterValue[];
@@ -32,10 +32,15 @@ export type ResolveDashboardInputContextInput = {
      * would show or query the destination without what the viewer drilled on.
      */
     transientContexts: readonly TransientInputContext[] | undefined;
-    mode?: DashboardInputResolveMode;
-    timezone?: string;
+    /**
+     * The viewer's report calendar, from report preferences (zone, week start,
+     * fiscal year, anchor): an input's default resolves in it (card query
+     * assembly CQ-D8). Required so that every caller passes it; null only
+     * before the report context loads.
+     */
+    calendar: CalendarContext | null;
 };
-export declare function resolveDashboardInputContext({ dashboard, sheetId, card, sectionId, sheetKind, runtimeValues: authoredRuntimeValues, transientContexts, mode, timezone, }: ResolveDashboardInputContextInput): ResolvedDashboardInputContext;
+export declare function resolveDashboardInputContext({ dashboard, sheetId, card, sectionId, sheetKind, runtimeValues: authoredRuntimeValues, transientContexts, calendar, }: ResolveDashboardInputContextInput): ResolvedDashboardInputContext;
 /**
  * The Global Date rule: exactly one Global Date input may exist. Returns every
  * Global Date input after the first, in order. The strict resolver fails on
@@ -48,8 +53,8 @@ export declare function resolveDashboardInput(params: {
     input: NormalizedDashboardInput;
     runtimeValues: ResolveDashboardInputContextInput['runtimeValues'];
     target: DashboardInputRuntimeTarget;
-    mode: DashboardInputResolveMode;
-    timezone?: string;
+    /** See `ResolveDashboardInputContextInput.calendar`. */
+    calendar: CalendarContext | null;
 }): ResolvedDashboardInput;
 export declare function compileDashboardInputQueryPayload({ resolvedInputs, card, }: {
     resolvedInputs: ResolvedDashboardInput[];

package/dist/types/lib/dashboard-pagination/dashboard-card-pagination.d.ts

@@ -1,4 +1,11 @@
+import { TCard } from '../types/common-types.js';
 import { PaginationConfig, PaginationMetadata } from '../types/explorer-types.js';
+/**
+ * The page size a viewer starts a server-paginated card on: the card's saved
+ * page size, then its table preference. One owner for the live query and a
+ * captured request (the analytics agent's replay of a card, ledger P3-78).
+ */
+export declare function resolveDashboardCardDefaultPageSize(card: TCard): number;
 export type DashboardCardPaginationState = PaginationConfig & {
     queryInputIdentity: string;
 };