react-semaphor 0.1.532 → 0.1.534

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

@@ -1,20 +0,0 @@
-import { DashboardInput, TDashboard } from '../types/common-types.js';
-import { DashboardFilterMappingContractIssue } from '../../shared/dashboard-authoring/index.js';
-export type DashboardInputEditValidation = {
-    ok: true;
-} | {
-    ok: false;
-    issues: DashboardFilterMappingContractIssue[];
-};
-/**
- * Validates one Input edit against the whole dashboard, so cross-input rules
- * (duplicate references, aliases) still apply, without holding the edit
- * hostage to problems it did not introduce: an issue already present before
- * the edit is not attributed to it. A rejection always carries the issues
- * the edit introduced, so the author can act on them.
- */
-export declare function validateDashboardInputEdit(params: {
-    dashboard: Pick<TDashboard, 'inputs' | 'filters'>;
-    inputId: string;
-    nextInput: DashboardInput;
-}): DashboardInputEditValidation;

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

@@ -1,15 +0,0 @@
-import { TFilter } from '../../components/surfboard/filter/types.js';
-import { ControlDefinition, DashboardInput, DashboardInputBase, DashboardInputExportKey, DashboardInputPresentation, NormalizedDashboardInput } from '../types/common-types.js';
-export declare function createDashboardInputVariableName(label: string): string;
-export declare function createUniqueDashboardInputVariableName(label: string, existingInputs: Pick<DashboardInput, 'variableName'>[]): string;
-export declare function normalizeDashboardInputVariableName(value: string): string;
-export declare function createUniqueDashboardInputVariableNameFromName(value: string, existingInputs: Pick<DashboardInput, 'variableName'>[]): string;
-export declare function getDefaultDashboardInputExportsForFilter(filter: Pick<TFilter, 'dataType'>): DashboardInputExportKey[];
-export declare function getDefaultDashboardInputExportsForControl(control: Pick<ControlDefinition, 'type'>): DashboardInputExportKey[];
-export declare function getDashboardInputBackingKey(input: NormalizedDashboardInput): string;
-export declare function getDashboardInputPresentationForFilter(filter: TFilter): DashboardInputPresentation;
-export declare function getDashboardInputPresentationForControl(control: ControlDefinition): DashboardInputPresentation;
-export declare function normalizeDashboardInputFilterValue(input: Extract<NormalizedDashboardInput, {
-    kind: 'filter';
-}>): (filterValue: import('../../components/surfboard/filter/types.js').TFilterValue) => import('../../components/surfboard/filter/types.js').TFilterValue;
-export declare function isCompatibilityDashboardInput(input: Pick<DashboardInputBase, 'compatibility'>): boolean;

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

@@ -1,85 +0,0 @@
-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(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;
-    card?: TCard | null;
-    sectionId?: string | null;
-    sheetKind?: 'dashboard' | 'document';
-    mode: DashboardInputExecutionSnapshot['mode'];
-    runtimeValues: DashboardInputRuntimeValues;
-    /**
-     * The carried contexts in effect on the dashboard being captured. Required
-     * so that every caller decides: an export of a dashboard a viewer drilled
-     * through to has to replay what was carried there.
-     */
-    transientContexts: readonly TransientInputContext[] | undefined;
-    generatedAt?: string;
-    timezone?: string;
-};
-export type BuildDashboardInputExecutionSnapshotResult = {
-    snapshot: DashboardInputExecutionSnapshot;
-    context: ResolvedDashboardInputContext;
-};
-export declare function applyFilterOverridesToDashboardInputSlots({ dashboardInputValues, dashboard, filterValues, sheetId, cardId, sectionId, sheetKind, }: {
-    dashboardInputValues?: DashboardInputValues;
-    dashboard: Pick<TDashboard, 'inputs'>;
-    filterValues: TFilterValue[];
-    sheetId?: string | null;
-    cardId?: string | null;
-    sectionId?: string | null;
-    sheetKind?: 'dashboard' | 'document';
-}): DashboardInputValues | undefined;
-export type BuildDocumentDashboardInputExecutionSnapshotParams = BuildDashboardInputExecutionSnapshotParams & {
-    sheetId: string;
-    sheetKind: 'document';
-    sectionIds: string[];
-};
-export type BuildDashboardSheetsInputExecutionSnapshotParams = Omit<BuildDashboardInputExecutionSnapshotParams, 'sheetId' | 'card' | 'sectionId' | 'sheetKind'> & {
-    sheetIds: string[];
-    sheetKind?: 'dashboard' | 'document';
-};
-export declare function buildDashboardInputExecutionSnapshot({ dashboard, sheetId, card, sectionId, sheetKind, mode, runtimeValues, transientContexts, generatedAt, timezone, }: BuildDashboardInputExecutionSnapshotParams): BuildDashboardInputExecutionSnapshotResult;
-export declare function getDocumentDashboardInputMissingRequiredLabels({ sectionIds, ...params }: BuildDocumentDashboardInputExecutionSnapshotParams): string[];
-export declare function buildDashboardSheetsInputExecutionSnapshot({ sheetIds, sheetKind, ...params }: BuildDashboardSheetsInputExecutionSnapshotParams): BuildDashboardInputExecutionSnapshotResult;
-export declare function buildDocumentDashboardInputExecutionSnapshot({ sectionIds, ...params }: BuildDocumentDashboardInputExecutionSnapshotParams): BuildDashboardInputExecutionSnapshotResult;
-export declare function materializeDashboardInputSnapshotValues({ inputs, context, sheetId, cardId, sectionId, }: {
-    inputs: NormalizedDashboardInput[];
-    context: ResolvedDashboardInputContext;
-    sheetId?: string | null;
-    cardId?: string | null;
-    sectionId?: string | null;
-}): DashboardInputValues;
-export {};

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

@@ -1,12 +0,0 @@
-import { DashboardInputTextContent, ResolvedDashboardInputContext } from '../types/common-types.js';
-import { DashboardTextRenderContext } from './dashboard-input-display.js';
-export type ParsedDashboardInputTextContent = {
-    content: DashboardInputTextContent;
-    unresolvedTokens: string[];
-};
-export declare function parseDashboardInputTextContent(value: string, context: Pick<ResolvedDashboardInputContext, 'variablesByName'>): ParsedDashboardInputTextContent;
-export declare function renderDashboardInputTextContent(content: DashboardInputTextContent | undefined, context: DashboardTextRenderContext): string;
-export declare function dashboardInputTextContentToEditableText(content: DashboardInputTextContent | undefined, context: Pick<ResolvedDashboardInputContext, 'variablesById' | 'variablesByName'>): string;
-export declare function hasDashboardInputVariableToken(value: string): boolean;
-export declare function htmlToDashboardInputText(value: string): string;
-export declare function plainTextToSafeHtml(value: string): string;

package/dist/types/lib/dashboard-inputs/dashboard-option-dependency-context.d.ts

@@ -1,40 +0,0 @@
-import { TFilterValue } from '../../components/surfboard/filter/types.js';
-import { NormalizedFilterDashboardInput } from '../types/common-types.js';
-import { DashboardOptionContext } from '../../shared/dashboard-authoring/index.js';
-import { DashboardInputTargetContext } from './dashboard-input-target-context.js';
-/**
- * Everything an option request needs to know about dependency policy for one
- * dashboard filter, resolved once from the Input target context:
- *
- * - the target's stable input identity and its explicit (never inferred)
- *   dependency policy and population;
- * - bindings for every peer filter input in scope, including inactive ones,
- *   so the server can tell a cleared parent from a missing reference;
- * - the active filter values the policy selects, which is also the only part
- *   of the request that should participate in cache identity.
- *
- * Applicability and relationship proof stay server-owned; this module only
- * decides membership. Excluded, out-of-scope, independent and unselected
- * explicit peers never change a query key; in All applicable mode every
- * active candidate participates until the server classifies it.
- *
- * Values that no Input on the dashboard owns (click filters and other
- * request-local values) get request-local bindings so automatic mode can
- * still consider them; they are not authorable in Selected mode. A known
- * Input outside the target's scope, an excluded Input or a malformed Input is
- * never reclassified as ad hoc: the context's `knownFilterIds` decides.
- */
-export type DashboardOptionDependencyContext = {
-    optionContext: DashboardOptionContext;
-    /** Peer inputs the target may reference, in scope for the target. */
-    peerInputs: NormalizedFilterDashboardInput[];
-    /** Active values selected by the policy, self excluded. */
-    candidateFilterValues: TFilterValue[];
-};
-export declare function resolveDashboardOptionDependencyContext(params: {
-    context: DashboardInputTargetContext;
-    /** Active values in scope, self already excluded by the caller. */
-    activeFilterValues: readonly TFilterValue[];
-}): DashboardOptionDependencyContext | undefined;
-/** Request-local identity for a value that no dashboard Input owns. */
-export declare function adHocOptionInputId(filterId: string): string;

package/dist/types/lib/dashboard-inputs/document-input-prototype-normalizer.d.ts

@@ -1,2 +0,0 @@
-import { TDashboard } from '../types/common-types.js';
-export declare function normalizePrototypeDocumentInputsToDashboardInputs(dashboard: TDashboard): TDashboard;

package/dist/types/lib/dashboard-inputs/filter-authoring-capabilities.d.ts

@@ -1,39 +0,0 @@
-import { TFilter } from '../../components/surfboard/filter/types.js';
-import { NormalizedFilterDashboardInput } from '../types/common-types.js';
-/**
- * How the settings popover's edits reach a store:
- *
- * - `dashboardFilter`: the filter is a legacy dashboard filter definition
- *   that the store accepts through its filter-Input and mapping paths.
- * - `input`: a persisted Dashboard Input the presentation binds directly
- *   (the document input bar); definition, metadata and option settings go
- *   through the definition-update action.
- * - `definition`: a callback that only updates a filter definition (inline
- *   card filters inside the visual editor).
- */
-export type FilterAuthoringPersistence = 'dashboardFilter' | 'input' | 'definition';
-/**
- * What an author may configure for one filter. Each capability is decided on
- * its own from the filter category, the target Input and the persistence
- * path; presentation variants control layout only. Excluding a category from
- * one capability never removes another it has today.
- */
-export type FilterAuthoringCapabilities = {
-    persistence: FilterAuthoringPersistence;
-    /** Option source (value and label fields), narrowing and population. */
-    optionSettings: boolean;
-    /** Per-card mapping (the Cards tab). Section mapping is not authorable yet. */
-    mapping: boolean;
-    /** Sheet scope of a legacy dashboard filter definition. */
-    scope: boolean;
-    /** Keep selection (forceSelection). */
-    forceSelection: boolean;
-};
-export declare function deriveFilterAuthoringCapabilities(params: {
-    filter: Pick<TFilter, 'kind' | 'sql' | 'customFilterPreferences'>;
-    target: NormalizedFilterDashboardInput | undefined;
-    /** The target is stored in `dashboard.inputs`, not lifted for the request. */
-    targetIsPersisted: boolean;
-    hasAcceptCallback: boolean;
-    isDashboardFilterReference: boolean;
-}): FilterAuthoringCapabilities;

package/dist/types/lib/dashboard-inputs/find-normalized-dashboard-filter-input.d.ts

@@ -1,4 +0,0 @@
-import { NormalizedDashboardInput, TDashboard } from '../types/common-types.js';
-export declare function findNormalizedDashboardFilterInput(dashboard: Pick<TDashboard, 'inputs' | 'filters' | 'controls' | 'sheets'>, filterId: string): Extract<NormalizedDashboardInput, {
-    kind: 'filter';
-}> | undefined;

package/dist/types/lib/dashboard-inputs/index.d.ts

@@ -1,12 +0,0 @@
-export * from './build-normalized-dashboard-inputs.js';
-export * from './card-compat-adapter.js';
-export * from './dashboard-control-compat-adapter.js';
-export * from './dashboard-filter-compat-adapter.js';
-export * from './dashboard-filter-mapping-authoring.js';
-export * from './dashboard-input-helpers.js';
-export * from './dashboard-input-snapshot.js';
-export * from './dashboard-input-text.js';
-export * from './dashboard-input-values.js';
-export * from './document-input-prototype-normalizer.js';
-export * from './resolve-dashboard-input-context.js';
-export * from './transient-input-context.js';

package/dist/types/lib/dashboard-inputs/resolve-field-date-comparison-coverage.d.ts

@@ -1,20 +0,0 @@
-import { CardViewStateMap } from '../dashboard-view-state/index.js';
-import { DashboardInput, TDashboard } from '../types/common-types.js';
-import { SemanticExecutionPayload } from '../types/semantic-runtime-types.js';
-import { FieldDateComparisonCoverage } from './dashboard-date-comparison-plan.js';
-import { ResolveDashboardInputContextInput } from './resolve-dashboard-input-context.js';
-import { DashboardInputRuntimeTarget } from './dashboard-input-values.js';
-export declare function resolveDashboardFieldDateComparisonCoverage(params: {
-    dashboard: TDashboard;
-    dashboardInput: Extract<DashboardInput, {
-        kind: 'filter';
-    }>;
-    dashboardInputTarget: DashboardInputRuntimeTarget;
-    runtimeValues: ResolveDashboardInputContextInput['runtimeValues'];
-    /** Carried contexts in effect on this dashboard; see `buildCardQueryContext`. */
-    transientContexts: ResolveDashboardInputContextInput['transientContexts'];
-    /** Drill paths by card: a drilled card groups by another field. */
-    cardViewStates: CardViewStateMap | undefined;
-    semanticExecutionPayload?: SemanticExecutionPayload;
-    timezone?: string;
-}): FieldDateComparisonCoverage;

package/dist/types/lib/dashboard-inputs/selection-targets.d.ts

@@ -1,26 +0,0 @@
-import { DashboardInputValues, TDashboard } from '../types/common-types.js';
-import { ActiveSelection } from './build-selection-dashboard-inputs.js';
-import { ResolvedCardSelection } from './resolve-selection-input.js';
-export type SelectionTargetResolution = {
-    cardId: string;
-    cardTitle: string;
-    resolution: ResolvedCardSelection;
-};
-/**
- * What one source card's selection does on every other card, each resolved
- * where it sits. The same resolver the query path uses, so the count on the
- * source card and the chip can never disagree with what actually refiltered.
- */
-export declare function resolveSelectionTargets(params: {
-    dashboard: Pick<TDashboard, 'sheets' | 'inputs' | 'filters' | 'controls'>;
-    selection: Pick<ActiveSelection, 'input' | 'value'>;
-}): SelectionTargetResolution[];
-/** Target cards this selection currently narrows. */
-export declare function countSelectionTargets(params: Parameters<typeof resolveSelectionTargets>[0]): number;
-/** Active selections with the number of cards each one narrows. */
-export declare function listActiveSelectionsWithTargets(params: {
-    dashboard: Pick<TDashboard, 'sheets' | 'inputs' | 'filters' | 'controls' | 'interactionDefaults'>;
-    dashboardInputValues: DashboardInputValues | undefined;
-}): Array<ActiveSelection & {
-    targetCount: number;
-}>;

package/dist/types/lib/dashboard-inputs/text-card-rich-content.d.ts

@@ -1,6 +0,0 @@
-import { TextCardRichContent } from '../types/common-types.js';
-import { DashboardTextRenderContext } from './dashboard-input-display.js';
-export declare function createEmptyRichContent(): TextCardRichContent;
-export declare function isTextCardRichContent(value: unknown): value is TextCardRichContent;
-export declare function renderRichContentToHtml(content: TextCardRichContent | undefined, context: DashboardTextRenderContext): string;
-export declare function extractPlainTextFromRichContent(content: TextCardRichContent | undefined): string;

package/dist/types/lib/dashboard-inputs/text-variable-options.d.ts

@@ -1,16 +0,0 @@
-import { DashboardInputVariableRef, ResolvedDashboardInputContext, TextVariablePresentation } from '../types/common-types.js';
-import { TextVariableChipFace, TextVariableOption, TextVariableSelection } from '../text-variables/text-variable-types.js';
-import { DashboardTextRenderContext } from './dashboard-input-display.js';
-/** What resolves a reference to its input. */
-type DashboardVariableLookup = Pick<ResolvedDashboardInputContext, 'variablesById' | 'variablesByName'>;
-/** The dashboard inputs a text visual can show, each part with its value now. */
-export declare function getDashboardTextVariableOptions(context?: Pick<ResolvedDashboardInputContext, 'resolvedInputs'> & Pick<DashboardTextRenderContext, 'presentation'>): TextVariableOption[];
-/** What a reference shows, as the picker names it; undefined when missing. */
-export declare function getDashboardVariableSelection(ref: DashboardInputVariableRef, context?: DashboardVariableLookup, presentation?: TextVariablePresentation): TextVariableSelection | undefined;
-/** The reference a picker selection stands for. */
-export declare function getDashboardVariableRefFromSelection(selection: TextVariableSelection): DashboardInputVariableRef;
-/** How a reference reads as a chip: the input's name, or Missing input. */
-export declare function getDashboardVariableChipFace(ref: DashboardInputVariableRef, context?: DashboardVariableLookup, presentation?: TextVariablePresentation): TextVariableChipFace;
-/** `name.part`, for copying a variable as a typed token. */
-export declare function getDashboardVariableToken(ref: DashboardInputVariableRef, context?: DashboardVariableLookup): string;
-export {};

package/dist/types/lib/dashboard-inputs/use-effective-dashboard-filter-storage.d.ts

@@ -1,7 +0,0 @@
-import { FilterStorageOptions, TFilter } from '../../components/surfboard/filter/types.js';
-/**
- * Keeps filter UI storage aligned with self-describing Dashboard Input slots.
- * A set or cleared value aspect owns storage; a comparison-only slot leaves the
- * ordinary compatibility filter value in its established store.
- */
-export declare function useEffectiveDashboardFilterStorage(filter: TFilter, storageOptions?: FilterStorageOptions): FilterStorageOptions | undefined;

package/dist/types/lib/dashboard-navigation/build-carried-click-context.d.ts

@@ -1,49 +0,0 @@
-import { DashboardInputRuntimeValues } from '../dashboard-inputs/resolve-dashboard-input-context.js';
-import { InteractionContextMode, ResolveRelativeDateWindow, TransientInputContext } from '../dashboard-inputs/transient-input-context.js';
-import { CardViewState } from '../dashboard-view-state/index.js';
-import { TCard, TDashboard } from '../types/common-types.js';
-import { ClickFilterCondition } from '../types/interaction-types.js';
-import { SemanticExecutionPayload } from '../types/semantic-runtime-types.js';
-import { CalendarContext } from '../../shared/report-runtime-context/index.js';
-import { DashboardNavigationTrigger } from './navigation-state.js';
-/**
- * What a drill carries away from a click, built at the moment of the click
- * from the state the clicked card was executing under. The one caller-side
- * owner of that capture: drill-through and drill to insight both use it, so
- * the context-mode table is implemented once.
- */
-export type BuildCarriedClickContextParams = {
-    namespace: string;
-    contextMode: InteractionContextMode;
-    /** The clicked card, on the dashboard below. */
-    card: TCard;
-    /** Conditions the matched interaction keeps from the click. */
-    conditions: ClickFilterCondition[];
-    /** Shown by navigation and insight chrome. */
-    label?: string;
-    dashboard: TDashboard;
-    sheetId: string | null | undefined;
-    runtimeValues: DashboardInputRuntimeValues;
-    cardViewState: CardViewState | undefined;
-    /** The carried contexts the clicked card itself resolves under. */
-    sourceTransientContexts: readonly TransientInputContext[] | undefined;
-    /**
-     * Under `full`, whether the source dashboard's own toolbar filters travel.
-     * A drill-through carries them to the other dashboard. An insight renders on
-     * this dashboard, where those filters keep applying live, so carrying a
-     * frozen copy would pin the insight to a value the viewer has since changed.
-     * What the source itself received always travels under `full`.
-     */
-    carryOwnToolbarFilters: boolean;
-    /** Card ids on the destination, for pruning carried bindings. Empty when unknown. */
-    destinationCardIds: string[];
-    semanticExecutionPayload?: SemanticExecutionPayload;
-    calendarContext?: CalendarContext | null;
-    resolveRelativeDateWindow?: ResolveRelativeDateWindow;
-};
-export type CarriedClickContext = {
-    /** Display-only: the click as the viewer made it, in every context mode. */
-    trigger: DashboardNavigationTrigger;
-    carried: TransientInputContext;
-};
-export declare function buildCarriedClickContext(params: BuildCarriedClickContextParams): CarriedClickContext;

package/dist/types/lib/dashboard-navigation/describe-carried-context.d.ts

@@ -1,11 +0,0 @@
-import { TransientInputContext } from '../dashboard-inputs/transient-input-context.js';
-import { SelectionTuple } from '../../shared/analytics-protocol/selection-contract.js';
-/** One line of "what came along": a field and the value it was narrowed to. */
-export type CarriedContextItem = {
-    fieldName: string;
-    value: string;
-};
-/** The click, as chrome shows it. Works for a display-only trigger too. */
-export declare function describeSelectionTuples(tuples: readonly SelectionTuple[]): CarriedContextItem[];
-/** Everything a carried context applies: the click, then the carried toolbar filters. */
-export declare function describeCarriedContext(context: TransientInputContext): CarriedContextItem[];

package/dist/types/lib/dashboard-navigation/run-one-off-drill.d.ts

@@ -1,11 +0,0 @@
-import { TCard } from '../types/common-types.js';
-import { DrillThroughEvent, DrillToDetailEvent } from '../types/interaction-types.js';
-/** A drill that leaves the card: to another dashboard, or into an insight. */
-export type OneOffDrillEvent = DrillThroughEvent | DrillToDetailEvent;
-/**
- * Runs a one-off drill from the click that raised it. The carried context is
- * captured here, at the moment of the click, from the state the clicked card
- * was executing under; nothing is read again later. Returns false when the
- * drill has no target to open.
- */
-export declare function runOneOffDrill(card: TCard, event: OneOffDrillEvent): boolean;

package/dist/types/lib/dashboard-navigation/use-transient-contexts.d.ts

@@ -1,17 +0,0 @@
-import { TransientInputContext } from '../dashboard-inputs/transient-input-context.js';
-/**
- * Set by an insight viewer around the card it renders: that card resolves only
- * under the insight's own runtime, never under what navigation carried to the
- * dashboard behind it.
- */
-export declare const InsightRuntimeContext: import('react').Context<readonly TransientInputContext[] | null>;
-/** The carried contexts in effect on the dashboard being rendered. */
-export declare function useDashboardTransientContexts(): readonly TransientInputContext[];
-/**
- * The carried contexts a card resolves under: the enclosing insight's runtime,
- * otherwise the dashboard's. Every live reader that resolves inputs or builds
- * a query context for a card reads this one value for both.
- */
-export declare function useCardTransientContexts(): readonly TransientInputContext[];
-/** Non-reactive read for code that runs outside React (exports, the assistant). */
-export declare function getDashboardTransientContexts(): readonly TransientInputContext[];

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

@@ -1,5 +0,0 @@
-import { Granularity } from './types/query-types.js';
-import { AggregateFunction } from './types/explorer-types.js';
-export declare function generateUniqueDndId(baseId: string): string;
-export declare function getAggregationLabel(columnName: string, aggregation: AggregateFunction): string;
-export declare function getGranularityLabel(columnName: string, granularity: Granularity): string;

package/dist/types/lib/document/document-canvas-actions.d.ts

@@ -1,22 +0,0 @@
-import { DocumentKpiSection, DocumentTableSection } from '../types/common-types.js';
-import { DashboardCardLocation } from '../../shared/dashboard-authoring/document-section-cards.js';
-/**
- * Canvas editing actions for the Document page: the floating section
- * toolbar, the gutters between sections, and the insert picker. The sheet
- * provides them only while editing; each routes through `editDocument`.
- */
-export type DocumentCanvasActions = {
-    /** Section ids in document order, for Move up and Move down. */
-    sectionIds: readonly string[];
-    moveSection: (sectionId: string, delta: -1 | 1) => void;
-    duplicateSection: (sectionId: string) => void;
-    deleteSection: (sectionId: string) => void;
-    openFullEditor: (section: DocumentTableSection | DocumentKpiSection) => void;
-    copyCard: (source: DashboardCardLocation, index: number) => void;
-    /** The page region whose settings the side panel shows, if any. */
-    selectedRegion: 'header' | 'footer' | null;
-    selectRegion: (region: 'header' | 'footer') => void;
-};
-export declare const DocumentCanvasActionsContext: import('react').Context<DocumentCanvasActions | null>;
-/** The canvas actions, or null outside the editing surface. */
-export declare function useDocumentCanvasActions(): DocumentCanvasActions | null;

package/dist/types/lib/document/document-dashboard-inputs.d.ts

@@ -1,48 +0,0 @@
-import { TFilterValue } from '../../components/surfboard/filter/types.js';
-import { ControlDefinition, DashboardInput, DashboardInputSlot, DashboardInputValues, DocumentDefinition, DocumentInputDefinition, NormalizedDashboardInput, TDashboard } from '../types/common-types.js';
-import { Field, DataSource } from '../types/explorer-types.js';
-export declare function getDocumentSheetDashboardInputs(dashboard: Pick<TDashboard, 'inputs' | 'filters'>, sheetId: string): NormalizedDashboardInput[];
-export declare function hasDashboardInputsForDocumentSheet(dashboard: Pick<TDashboard, 'inputs' | 'sheets'>, sheetId: string): boolean;
-export declare function dashboardInputToDocumentInputDefinition(input: NormalizedDashboardInput): DocumentInputDefinition;
-export declare function createDashboardFilterInputFromField({ field, existingInputs, sheetId, dataSource, connectionId, connectionType, inputId, filterId, }: {
-    field: Field;
-    existingInputs: DashboardInput[];
-    sheetId: string;
-    dataSource?: DataSource | null;
-    connectionId?: string;
-    connectionType?: string;
-    inputId?: string;
-    filterId?: string;
-}): DashboardInput;
-export declare function createDashboardControlInputFromControl({ control, existingInputs, sheetId, inputId, }: {
-    control: ControlDefinition;
-    existingInputs: DashboardInput[];
-    sheetId: string;
-    inputId?: string;
-}): DashboardInput;
-export declare function updateDocumentDashboardInputMetadata({ input, allInputs, label, variableName, }: {
-    input: DashboardInput;
-    allInputs: DashboardInput[];
-    label?: string;
-    variableName?: string;
-}): DashboardInput;
-export declare function renameDocumentControlReferences(document: DocumentDefinition, oldControlId: string, newControlId: string): DocumentDefinition;
-export declare function dashboardInputMatchesField(input: NormalizedDashboardInput, field: Field): boolean;
-export declare function getFilterValuesByDashboardInputId(resolvedInputs: Array<{
-    id: string;
-    kind: 'filter' | 'control';
-    filterValue?: TFilterValue;
-    slot?: DashboardInputSlot;
-}>): Record<string, TFilterValue | undefined>;
-export declare function getControlValuesByDashboardInputId(resolvedInputs: Array<{
-    id: string;
-    kind: 'filter' | 'control';
-    controlValue?: unknown;
-    slot?: DashboardInputSlot;
-}>): Record<string, unknown>;
-export declare function buildDashboardInputValuesFromLegacyDocumentSnapshot({ dashboard, sheetId, filterValuesByInputId, controlValuesByInputId, }: {
-    dashboard: TDashboard;
-    sheetId: string;
-    filterValuesByInputId?: Record<string, TFilterValue | undefined>;
-    controlValuesByInputId?: Record<string, unknown>;
-}): DashboardInputValues;

package/dist/types/lib/document/document-definition.d.ts

@@ -1,14 +0,0 @@
-import { DocumentDefinition, DocumentFooterRegion, DocumentHeaderRegion, DocumentImageRegionBlock, DocumentInputDefinition, DocumentRegionBlock, DocumentTextContent, DocumentTextRegionBlock } from '../types/common-types.js';
-export declare const DEFAULT_DOCUMENT_GENERATED_AT_FORMAT = "MMM D, YYYY [at] h:mm A";
-export declare function createDefaultDocumentDefinition(): DocumentDefinition;
-export declare function createHeaderRegion(): DocumentHeaderRegion;
-export declare function createFooterRegion(): DocumentFooterRegion;
-export declare function textContent(value: string): DocumentTextContent;
-export declare function textContentToString(content?: DocumentTextContent, inputs?: DocumentInputDefinition[]): string;
-export declare function textContentHasVariables(content?: DocumentTextContent): boolean;
-export declare function getRegionTextBlock(blocks: DocumentRegionBlock[], role: NonNullable<DocumentTextRegionBlock['role']>): DocumentTextRegionBlock | undefined;
-export declare function getRegionImageBlock(blocks: DocumentRegionBlock[], role: NonNullable<DocumentImageRegionBlock['role']>): DocumentImageRegionBlock | undefined;
-export declare function upsertTextRegionBlock(blocks: DocumentRegionBlock[], nextBlock: Omit<DocumentTextRegionBlock, 'type' | 'content'> & {
-    content: string | DocumentTextContent;
-}): DocumentRegionBlock[];
-export declare function upsertImageRegionBlock(blocks: DocumentRegionBlock[], nextBlock: DocumentImageRegionBlock): DocumentRegionBlock[];

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

@@ -1,13 +0,0 @@
-/**
- * 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/document/document-input-order.d.ts

@@ -1,5 +0,0 @@
-/**
- * Pure reorder step for the document input bar. Returns null when the drop
- * would leave the order unchanged so callers can skip a persist.
- */
-export declare function getReorderedDocumentInputIds(inputIds: string[], activeId: string, overId: string): string[] | null;

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

@@ -1,30 +0,0 @@
-import { TFilter } from '../../components/surfboard/filter/types.js';
-import { ControlDefinition, DocumentControlInputDefinition, DocumentFilterInputDefinition, DocumentInputDefinition, DocumentInputExportKey } from '../types/common-types.js';
-import { DataSource, Field } from '../types/explorer-types.js';
-type CreateDocumentFilterInputOptions = {
-    field: Field;
-    existingInputs: DocumentInputDefinition[];
-    dataSource?: DataSource | null;
-    connectionId?: string;
-    connectionType?: string;
-    inputId?: string;
-    filterId?: string;
-};
-export declare function createDocumentFilterInputFromField({ field, existingInputs, dataSource, connectionId, connectionType, inputId, filterId, }: CreateDocumentFilterInputOptions): DocumentFilterInputDefinition;
-export declare function createDocumentControlInputFromControl({ control, existingInputs, inputId, }: {
-    control: ControlDefinition;
-    existingInputs: DocumentInputDefinition[];
-    inputId?: string;
-}): DocumentControlInputDefinition;
-export declare function createDocumentInputBackingFilter({ field, dataSource, connectionId, connectionType, filterId, }: {
-    field: Field;
-    dataSource?: DataSource | null;
-    connectionId?: string;
-    connectionType?: string;
-    filterId?: string;
-}): TFilter;
-export declare function createUniqueDocumentInputVariableName(label: string, existingInputs: DocumentInputDefinition[]): string;
-export declare function documentInputMatchesField(input: DocumentInputDefinition, field: Field): boolean;
-export declare function getDocumentInputExportsForFilter(filter: Pick<TFilter, 'dataType'>): DocumentInputExportKey[];
-export declare function getDocumentInputExportsForControl(control: Pick<ControlDefinition, 'type'>): DocumentInputExportKey[];
-export {};

package/dist/types/lib/document/document-kpi-figure.d.ts

@@ -1,27 +0,0 @@
-import { TCard } from '../types/common-types.js';
-import { ComparisonMetadataMap } from '../types/query-types.js';
-import { MetricComparisonSentiment } from '../../shared/analytics-protocol/index.js';
-/**
- * What a KPI shows in print: its value and, when the card compares, one
- * comparison line. Reads the result exactly as the dashboard KPI cards do
- * (`kpi-result-values`), without their interactive layout.
- */
-export type DocumentKpiFigure = {
-    label: string;
-    value: number | null;
-    /** Shown instead of a value when there is none. */
-    emptyMessage?: string;
-    comparison?: {
-        /** "Previous", "Target", or the author's label. */
-        label: string;
-        value: number;
-        /** Change against the comparison, as a ratio (0.042 = +4.2%). Null when the comparison is 0. */
-        change: number | null;
-        sentiment: MetricComparisonSentiment;
-    };
-};
-export declare function resolveDocumentKpiFigure({ card, data, comparisonMetadata, }: {
-    card: TCard;
-    data?: Record<string, unknown>[] | null;
-    comparisonMetadata?: ComparisonMetadataMap;
-}): DocumentKpiFigure;

package/dist/types/lib/document/document-kpi-layout.d.ts

@@ -1,29 +0,0 @@
-import { DocumentKpiSection } from '../types/common-types.js';
-/**
- * Fixed geometry of a KPI section. The renderer sets these heights exactly,
- * so the pagination estimate equals the printed height and a KPI section is
- * placed on a page as one block.
- */
-export declare const DOCUMENT_KPI_SECTION_TITLE_HEIGHT_PX = 24;
-export declare const DOCUMENT_KPI_TILE_ROW_HEIGHT_PX = 72;
-export declare const DOCUMENT_KPI_LINE_HEIGHT_PX = 28;
-/** Top and bottom rule plus the inner padding of the lines grid. */
-export declare const DOCUMENT_KPI_LINES_FRAME_HEIGHT_PX = 18;
-/** Top and bottom rule of the tile row. */
-export declare const DOCUMENT_KPI_TILES_FRAME_HEIGHT_PX = 2;
-export type DocumentKpiLayout = {
-    kind: 'tiles';
-    columns: number;
-} | {
-    kind: 'lines';
-    columns: 1 | 2;
-    rows: number;
-};
-/**
- * The layout a KPI section prints with. A `tiles` section with more cards
- * than tiles allow (save rejects it, but a runtime guard costs nothing) prints
- * as two-column lines.
- */
-export declare function resolveDocumentKpiLayout(section: Pick<DocumentKpiSection, 'cards' | 'kpi'>): DocumentKpiLayout;
-/** Printed height of a KPI section; the renderer uses the same numbers. */
-export declare function estimateKpiSectionHeightPx(section: Pick<DocumentKpiSection, 'cards' | 'kpi' | 'title'>): number;