react-semaphor 0.1.533 → 0.1.535

package/dist/types/lib/print-state/capture-expanded-state.d.ts

@@ -1,38 +0,0 @@
-/**
- * Print State Protocol - State Capture Utilities
- *
- * Captures the current expanded state of elements following the print protocol.
- * Used by export-dialog.tsx to capture state before PDF generation.
- *
- * Protocol Contract:
- * - Elements must have `data-spr-expand-id="unique-stable-id"`
- * - Elements must have `aria-expanded="true|false"`
- * - Elements must be clickable (respond to .click())
- */
-/**
- * Captures the current expanded state of all elements following the print protocol.
- *
- * @returns Record of expand IDs to their expanded boolean state
- *
- * @example
- * // In a component with expandable sections:
- * // <button data-spr-expand-id="section:123" aria-expanded="true">...</button>
- * // <button data-spr-expand-id="section:456" aria-expanded="false">...</button>
- *
- * const state = captureExpandedStateFromDom();
- * // Returns: { "section:123": true, "section:456": false }
- */
-export declare function captureExpandedStateFromDom(): Record<string, boolean>;
-/**
- * Checks if any expandable elements exist in the DOM that follow the print protocol.
- *
- * @returns true if any elements with data-spr-expand-id exist
- */
-export declare function hasExpandableElements(): boolean;
-/**
- * Captures only the expanded elements (optimization to reduce state size).
- * Since collapsed is the default state, we only need to track what's expanded.
- *
- * @returns Record of expand IDs that are currently expanded (value is always true)
- */
-export declare function captureExpandedOnlyState(): Record<string, boolean>;

package/dist/types/lib/python/default-code.d.ts

@@ -1 +0,0 @@
-export declare const PYTHON_DEFAULT_CODE = "import pandas as pd\ndf = pd.DataFrame(data)  # 'data' contains the query result\nresult = df.to_dict('records')  # must return 'result' as [dict] type\n";

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

@@ -1,16 +0,0 @@
-import { ControlBinding, ControlDefinition, TCard } from '../types/common-types.js';
-export type BuildCardControlContextParams = {
-    card: TCard;
-    presentationControlIds: ReadonlySet<string>;
-    dashboardControls?: ControlDefinition[];
-    dashboardControlValues?: Record<string, unknown>;
-    cardControlValues?: Record<string, unknown>;
-};
-export type CardControlContext = {
-    controlValues: Record<string, unknown>;
-    controlDefinitions: ControlDefinition[];
-    cardControlDefinitions: ControlDefinition[];
-    controlBindings: ControlBinding[];
-};
-export declare function buildCardControlContext(params: BuildCardControlContextParams): CardControlContext;
-export declare function projectCardControlContextForQuery(card: TCard, context: CardControlContext, presentationControlIds: ReadonlySet<string>): CardControlContext;

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

@@ -1,68 +0,0 @@
-import { TFilterValue } from '../../components/surfboard/filter/types.js';
-import { getCacheConfig } from '../stores/utils.js';
-import { ControlBinding, ControlDefinition, TCard } from '../types/common-types.js';
-import { CardConfig, 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 { GlobalDateComparisonContext } from '../../shared/analytics-protocol/index.js';
-import { CalendarContext } from '../../shared/report-runtime-context/index.js';
-import { CompiledDashboardCardFilters, CompileDashboardCardFiltersParams } from './compile-dashboard-card-filters.js';
-import { TemporalResultOwner } from '../../shared/dashboard-authoring/index.js';
-export type DashboardCardQueryRequestPayloadBase = {
-    cardId: string;
-    sql: string;
-    python: string;
-    resultOwner: TemporalResultOwner;
-    active_filters: TFilterValue[];
-    controlValues: Record<string, unknown>;
-    controlDefinitions: ControlDefinition[];
-    cardControlDefinitions: ControlDefinition[];
-    controlBindings: ControlBinding[];
-    cache_config: ReturnType<typeof getCacheConfig>;
-    queryConfig: TCard['queryConfig'];
-    tableConfig: TableConfig;
-    cardType: TCard['type'];
-    cardTitle: string;
-    cardConfig: CardConfig;
-    cardDataSource: TCard['dataSource'];
-    resolvedPrimaryDateField?: ResolvedPrimaryDateField;
-    globalDateComparison?: GlobalDateComparisonContext;
-    calendarContext: CalendarContext;
-};
-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;
-    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/build-dashboard-execution-snapshot.d.ts

@@ -1,63 +0,0 @@
-import { CardViewStateMap } from '../dashboard-view-state/index.js';
-import { TFilterValue } from '../../components/surfboard/filter/types.js';
-import { DashboardInputValues, TCard, TDashboard } from '../types/common-types.js';
-import { SemanticExecutionPayload } from '../types/semantic-runtime-types.js';
-import { BuildCardQueryContextParams, CompiledCardQueryContext } from './build-card-query-context.js';
-import { CompiledDashboardCardFilters } from './compile-dashboard-card-filters.js';
-import { DashboardInputResolveMode } from '../dashboard-inputs/resolve-dashboard-input-context.js';
-import { prepareMatrixCard, MatrixCardCatalog } from '../matrix-table/matrix-card-adapter.js';
-import { DocumentSectionCardRuntime } from './document-section-card-query.js';
-export type DashboardExecutionSnapshot = {
-    selectedSheetId: string | null;
-    filterValues: TFilterValue[];
-    controlValues: Record<string, unknown>;
-};
-type BuildDashboardExecutionSnapshotParams = {
-    dashboard: Pick<TDashboard, 'filters' | 'sheets'> | undefined;
-    filterValues: TFilterValue[] | undefined;
-    selectedSheetId: string | null | undefined;
-    sheetSelection?: 'current' | 'all';
-    dashboardControlValues?: Record<string, unknown>;
-    cardControlValuesMap?: Record<string, Record<string, unknown> | undefined> | undefined;
-    semanticExecutionPayload?: SemanticExecutionPayload;
-    timezone?: string;
-};
-export declare function buildDashboardExecutionSnapshot({ dashboard, filterValues, selectedSheetId, sheetSelection, dashboardControlValues, cardControlValuesMap, semanticExecutionPayload, timezone, }: BuildDashboardExecutionSnapshotParams): DashboardExecutionSnapshot;
-export type BuildDashboardCardExecutionSnapshotParams = Omit<BuildCardQueryContextParams, 'card' | 'dashboard' | 'selectedSheetId' | 'dashboardInputContext' | 'cardViewState'> & {
-    dashboard: TDashboard | undefined;
-    cardId: string;
-    /** Drill paths by card. Required so that every caller decides; see `buildCardQueryContext`. */
-    cardViewStates: CardViewStateMap | undefined;
-    dashboardInputValues?: DashboardInputValues;
-    dashboardInputMode?: DashboardInputResolveMode;
-    semanticExecutionPayload?: SemanticExecutionPayload;
-    timezone?: string;
-    /** Current columns metadata for all Matrix targets participating in coverage. */
-    matrixCatalog?: MatrixCardCatalog;
-    /** Editor drafts replace their persisted card only for this computation. */
-    cardOverride?: TCard;
-    sheetId?: string | null;
-    /**
-     * Runs the target card as a Document section (tech spec G3), with the same
-     * rules as every section card's frame query. Other cards keep the dashboard
-     * runtime.
-     */
-    documentSection?: DocumentSectionCardRuntime;
-};
-export type DashboardCardExecutionSnapshot = {
-    status: 'ready';
-    card: TCard;
-    sheetId: string;
-    queryContext: CompiledCardQueryContext;
-    matrix?: ReturnType<typeof prepareMatrixCard>;
-};
-export type DashboardCardExecutionSnapshotResult = DashboardCardExecutionSnapshot | {
-    status: 'blocked';
-    cardId: string;
-    mappingDispositions: CompiledDashboardCardFilters['mappingDispositions'];
-    reason?: 'metadata' | 'configuration' | 'coverage';
-    message?: string;
-} | null;
-export declare function requireReadyDashboardCardExecutionSnapshot(result: DashboardCardExecutionSnapshotResult): DashboardCardExecutionSnapshot | null;
-export declare function buildDashboardCardExecutionSnapshot({ dashboard, cardId, transientContexts, cardViewStates, semanticExecutionPayload, filters, filterValues, inlineFilterValuesMap, dashboardControls, dashboardControlValues, cardControlValuesMap, dashboardInputValues, dashboardInputMode, timezone, matrixCatalog, cardOverride, sheetId, documentSection, }: BuildDashboardCardExecutionSnapshotParams): DashboardCardExecutionSnapshotResult;
-export {};

package/dist/types/lib/query-context/build-dashboard-frame-base-query-contexts.d.ts

@@ -1,60 +0,0 @@
-import { CardViewStateMap } from '../dashboard-view-state/index.js';
-import { TFilter, TFilterValue } from '../../components/surfboard/filter/types.js';
-import { ControlDefinition, DashboardInputValues, TCard, TDashboard, TFrame } from '../types/common-types.js';
-import { TransientInputContext } from '../dashboard-inputs/transient-input-context.js';
-import { CardQueryContext } from './build-card-query-context.js';
-import { CardExecution } from './card-execution.js';
-export type DashboardFrameDocumentQueryState = {
-    isExplicitDocumentSectionRuntime: boolean;
-    isDocumentSectionEditing: boolean;
-    editedDocumentSectionCardId?: string;
-    editorDocumentSheetId?: string;
-    editorDocumentSectionId?: string;
-    explicitDocumentSheetId?: string;
-    explicitDocumentSectionId?: string;
-    editorDocumentFilterValues?: TFilterValue[];
-    editorDocumentControlDefinitions?: ControlDefinition[];
-    editorDocumentControlValues?: Record<string, unknown>;
-    editorMissingRequiredInputLabels?: string[];
-    explicitDocumentFilterValues?: TFilterValue[];
-    explicitDocumentControlDefinitions?: ControlDefinition[];
-    explicitDocumentControlValues?: Record<string, unknown>;
-    explicitDocumentDashboardInputValues?: DashboardInputValues;
-};
-export type BuildDashboardFrameBaseQueryContextsParams = {
-    cards: TCard[];
-    dashboard: TDashboard;
-    filters?: TFilter[];
-    dashboardControls?: ControlDefinition[];
-    filterValues?: TFilterValue[];
-    controlValues?: Record<string, unknown>;
-    dashboardInputValues?: DashboardInputValues;
-    dashboardInlineFilterValuesMap: Record<string, TFilterValue[]>;
-    editorInlineFilterValuesMap: Record<string, TFilterValue[] | undefined>;
-    dashboardCardControlValuesMap: Record<string, Record<string, unknown>>;
-    /**
-     * Carried contexts in effect on this dashboard. Required so that every
-     * caller decides; see `buildCardQueryContext`. Document section cards never
-     * receive them.
-     */
-    transientContexts: readonly TransientInputContext[] | undefined;
-    /** Drill paths by card. Required so that every caller decides; see `buildCardQueryContext`. */
-    cardViewStates: CardViewStateMap | undefined;
-    filteringCards?: TCard[];
-    selectedSheetId?: string | null;
-    /** How this call's queries run (tech spec M7). */
-    execution: CardExecution;
-    getCardFrame: (cardId: string) => TFrame | undefined;
-    lastRequestPayloadMap?: Map<string, Record<string, unknown>>;
-    documentState: DashboardFrameDocumentQueryState;
-};
-export type DashboardFrameBaseQueryContext = CardQueryContext & {
-    card: TCard;
-    interval: number;
-    isFilteringCard: boolean;
-    isSingleCardFrame: boolean;
-    isDocumentSectionRuntime: boolean;
-    missingRequiredInputLabels: string[];
-    dashboardInputMissingRequiredLabels: string[];
-};
-export declare function buildDashboardFrameBaseQueryContexts({ cards, dashboard, filters, dashboardControls, filterValues, controlValues, dashboardInputValues, dashboardInlineFilterValuesMap, editorInlineFilterValuesMap, dashboardCardControlValuesMap, transientContexts, cardViewStates, filteringCards, selectedSheetId, execution, getCardFrame, lastRequestPayloadMap, documentState, }: BuildDashboardFrameBaseQueryContextsParams): DashboardFrameBaseQueryContext[];

package/dist/types/lib/query-context/build-global-date-comparison-context.d.ts

@@ -1,8 +0,0 @@
-import { TCard } from '../types/common-types.js';
-import { DashboardDateComparisonOwner, GlobalDateComparisonContext, GlobalDateComparisonSelection } from '../../shared/analytics-protocol/index.js';
-import { DashboardDateComparisonResolution } from '../dashboard-inputs/dashboard-date-comparison-plan.js';
-export declare function buildGlobalDateComparisonContext(card: Pick<TCard, 'preferences'>, selection: GlobalDateComparisonSelection | undefined, owner?: DashboardDateComparisonOwner): GlobalDateComparisonContext | undefined;
-export declare function buildDashboardDateComparisonContext(params: {
-    card: TCard;
-    resolution: DashboardDateComparisonResolution;
-}): GlobalDateComparisonContext | undefined;

package/dist/types/lib/query-context/build-query-relevant-card-config.d.ts

@@ -1,15 +0,0 @@
-import { CardConfig, DataSource, FilterGroup } from '../types/explorer-types.js';
-import { TChartType } from '../charts/types.js';
-import { TemporalResultOwner } from '../../shared/dashboard-authoring/index.js';
-import { ShelfDefinitionCard } from '../utils/card-definition.js';
-export declare function buildQueryRelevantFilterGroup(group?: FilterGroup, omitTemporalPresentation?: boolean): FilterGroup | undefined;
-type BuildQueryRelevantCardConfigOptions = {
-    cardType?: TChartType;
-    dataSource?: DataSource;
-    temporalResultOwner?: TemporalResultOwner;
-};
-export declare function buildQueryRelevantCardConfig(config: CardConfig | undefined, options: BuildQueryRelevantCardConfigOptions & {
-    cardType: TChartType;
-}): CardConfig | undefined;
-export declare function buildShelfQueryRelevantCardConfig(card: ShelfDefinitionCard, execution?: Omit<BuildQueryRelevantCardConfigOptions, 'cardType'>): CardConfig | undefined;
-export {};

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

@@ -1,30 +0,0 @@
-import { SemanticExecutionPayloadAuthority } from './use-semantic-execution-payload-for-cards.js';
-/**
- * How one card's query runs, decided once per card (tech spec M7). Every gate
- * in `useDashboardFrameQuery` and the base query-context builder reads this
- * instead of the global `isVisualEditing` flag.
- */
-export type CardExecution = {
-    /** The editor shows a failed query inline; a dashboard or report throws to its boundary. */
-    errorMode: 'throw' | 'inline';
-    refetchOnInterval: boolean;
-    /**
-     * `editor`: config cards run unless the editor is in dev mode, and dev mode
-     * uses the card's own connection. `runtime`: any card with a connection and
-     * SQL or a valid config runs.
-     */
-    gating: 'editor' | 'runtime';
-    /** `editor` waits for fresh semantic metadata before querying. */
-    metadataAuthority: SemanticExecutionPayloadAuthority;
-    /** `editorSnapshot`: the editor's inline filter values and the document inputs captured when it opened. */
-    inputSource: 'host' | 'editorSnapshot';
-};
-/**
- * - `isEditorPreview`: the card renders inside `<Editor>`.
- * - `requestedAuthority`: the caller's explicit choice. Inside the editor some
- *   components query with runtime metadata, so it is kept as is.
- */
-export declare function resolveCardExecution({ isEditorPreview, requestedAuthority, }: {
-    isEditorPreview: boolean;
-    requestedAuthority?: SemanticExecutionPayloadAuthority;
-}): CardExecution;

package/dist/types/lib/query-context/control-contract-serialization.d.ts

@@ -1,11 +0,0 @@
-import { ControlBinding, ControlDefinition } from '../types/common-types.js';
-type ControlContract = {
-    controlDefinitions?: ControlDefinition[];
-    cardControlDefinitions?: ControlDefinition[];
-    controlBindings?: ControlBinding[];
-};
-type SerializeControlContractOptions = {
-    includePresentation?: boolean;
-};
-export declare function serializeControlContract(contract?: ControlContract, options?: SerializeControlContractOptions): string;
-export {};

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

@@ -1,49 +0,0 @@
-import { ControlBinding, ControlDefinition, TCard } from '../types/common-types.js';
-import { ResolvedPrimaryDateField } from '../types/semantic-runtime-types.js';
-import { CardConfig, PaginationConfig } from '../types/explorer-types.js';
-import { GlobalDateComparisonContext } from '../../shared/analytics-protocol/index.js';
-import { CalendarContext } from '../../shared/report-runtime-context/index.js';
-import { CompiledCardQueryContext } from './build-card-query-context.js';
-export declare const isPaginatedCardType: (card: TCard) => boolean;
-export type CreateDashboardCardQueryKeyOptions = {
-    finalFiltersKey: string;
-    cardFilterValues: unknown;
-    controlValues?: Record<string, unknown>;
-    controlDefinitions?: ControlDefinition[];
-    cardControlDefinitions?: ControlDefinition[];
-    controlBindings?: ControlBinding[];
-    queryRelevantConfig?: CardConfig;
-    resolvedPrimaryDateField?: ResolvedPrimaryDateField;
-    globalDateComparison?: GlobalDateComparisonContext;
-    calendarContext: CalendarContext;
-};
-export declare function dashboardCardQueryKeysShareCalendarIdentity(currentQueryKey: readonly unknown[], previousQueryKey: readonly unknown[] | undefined): boolean;
-export declare function dashboardCardQueryKeysMatch(currentQueryKey: readonly unknown[], previousQueryKey: readonly unknown[] | undefined): boolean;
-/**
- * Returns the semantic identity of a dashboard-card query key. React Query
- * callers can rebuild equivalent key arrays during ordinary renders, so
- * lifecycle effects must depend on this value rather than array identity.
- */
-export declare function serializeDashboardCardQueryKey(queryKey: readonly unknown[]): string;
-/**
- * Builds the cache identity and the data-shaping identity from one projection.
- * Pagination belongs in the cache key, but is deliberately excluded from the
- * input identity so consumers can distinguish paging from a changed result set.
- */
-export declare function createDashboardCardQueryIdentities(card: TCard, options: CreateDashboardCardQueryKeyOptions, identityOptions?: {
-    resolvePaginationConfig?: (queryInputIdentity: string) => PaginationConfig | undefined;
-}): {
-    queryKey: string[];
-    queryInputIdentity: string;
-    paginationConfig: PaginationConfig | undefined;
-};
-/**
- * The one identity for a compiled card context. Regular cards and the Matrix
- * both use it, so a card's identity always covers what its request sends.
- */
-export declare function createCompiledCardQueryIdentities(card: TCard, context: CompiledCardQueryContext, calendarContext: CalendarContext, identityOptions?: Parameters<typeof createDashboardCardQueryIdentities>[2]): {
-    queryKey: string[];
-    queryInputIdentity: string;
-    paginationConfig: PaginationConfig | undefined;
-};
-export declare function createDashboardCardQueryKey(card: TCard, options: CreateDashboardCardQueryKeyOptions): string[];

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

@@ -1,17 +0,0 @@
-import { CardConfig } from '../types/explorer-types.js';
-import { TemporalResultOwner } from '../../shared/dashboard-authoring/index.js';
-export type DashboardQueryResultContext = {
-    queryIdentity: string;
-    effectiveCardConfig: CardConfig;
-};
-export declare function serializeDashboardQueryIdentity(queryKey: readonly unknown[]): string;
-/**
- * Binds request-owned state to the response produced by that exact request.
- * Retained results keep this context, so consumers can avoid pairing old rows
- * with a newer structural config while the next query is running.
- */
-export declare function bindDashboardQueryResultContext<T>(response: T, input: DashboardQueryResultContext & {
-    resultOwner: TemporalResultOwner;
-}): T;
-export declare function bindDashboardQueryResultOwnership<T>(response: T, resultOwner: TemporalResultOwner): T;
-export declare function readDashboardQueryResultContext(result: unknown): DashboardQueryResultContext | undefined;

package/dist/types/lib/query-context/document-section-card-query.d.ts

@@ -1,37 +0,0 @@
-import { TFilterValue } from '../../components/surfboard/filter/types.js';
-import { DashboardInputRuntimeValues } from '../dashboard-inputs/resolve-dashboard-input-context.js';
-import { ControlDefinition, DashboardInputValues, TCard, TDashboard } from '../types/common-types.js';
-import { BuildCardQueryContextParams } from './build-card-query-context.js';
-/** What a Document sheet resolved for one section, as one card's query sees it. */
-export type DocumentSectionCardRuntime = {
-    sheetId: string | undefined;
-    sectionId: string | undefined;
-    documentFilterValues: TFilterValue[];
-    documentControlDefinitions: ControlDefinition[];
-    documentControlValues: Record<string, unknown>;
-    /** The page's own input values; the editor's query uses the dashboard's. */
-    documentDashboardInputValues?: DashboardInputValues;
-    /** The editor's card filters, for the editor's query of the card it edits. */
-    editorFilterValues?: TFilterValue[];
-    /** `editor` for the editor's query of the card it edits, else `print`. */
-    mode: 'print' | 'editor';
-};
-/**
- * The `buildCardQueryContext` inputs for a card that runs as a Document
- * section. A section is its own runtime:
- * - nothing is carried in (no transient contexts, no drill state);
- * - the dashboard's toolbar filters and controls do not apply;
- * - the section's scoped dashboard inputs apply when the dashboard has any,
- *   otherwise the document's filter and control values do.
- *
- * The one owner of these rules, for frame queries and the Matrix execution
- * snapshot alike.
- */
-export declare function buildDocumentSectionCardQueryParams({ card, dashboard, runtime, dashboardRuntimeValues, timezone, }: {
-    card: TCard;
-    dashboard: TDashboard;
-    runtime: DocumentSectionCardRuntime;
-    /** The dashboard's runtime values, which scoped input resolution reads. */
-    dashboardRuntimeValues: Omit<DashboardInputRuntimeValues, 'cardViewState'>;
-    timezone?: string;
-}): Omit<BuildCardQueryContextParams, 'selectedSheetId' | 'includeAuthoredFilters'>;

package/dist/types/lib/query-context/filter-group-utils.d.ts

@@ -1,3 +0,0 @@
-import { FilterGroup } from '../types/explorer-types.js';
-export declare function mergeFilterGroups(groups: (FilterGroup | undefined)[]): FilterGroup | undefined;
-export declare function getFilterGroupKey(filterGroup: FilterGroup | undefined): string | undefined;

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

@@ -1,7 +0,0 @@
-import { TCard } from '../types/common-types.js';
-import { CardConfig } from '../types/explorer-types.js';
-import { TableConfig } from '../types/query-types.js';
-import { TemporalResultOwner } from '../../shared/dashboard-authoring/index.js';
-export declare function buildDashboardCardTableConfig(card: TCard): TableConfig;
-export declare function normalizeDashboardCardPythonCode(pythonCode: string): string;
-export declare function resolveDashboardCardResultOwner(card: Pick<TCard, 'config' | 'sql' | 'python'> & Partial<Pick<TCard, 'type'>>, cardConfig?: CardConfig | undefined): TemporalResultOwner;

package/dist/types/lib/query-context/query-auth-scope.d.ts

@@ -1,5 +0,0 @@
-/**
- * The auth scope every card puts in its query identity: a stable hash of the
- * access token, never the token itself. A new token is a new scope.
- */
-export declare function hashTokenForQueryKey(accessToken?: string): string;

package/dist/types/lib/query-context/resolve-render-card-config.d.ts

@@ -1,16 +0,0 @@
-import { CardConfig } from '../types/explorer-types.js';
-/**
- * Chooses the card config a fetched result should render with.
- *
- * The config bound to the result at fetch time stays authoritative while the
- * current context merely rebuilt an equivalent object (stable identity avoids
- * recompiling charts on unrelated store updates) or while the rows belong to
- * a different query identity (a retained previous result must keep its own
- * config). When the rows are current and the config content changed, the
- * change was presentation-only (formats, labels), so the current config wins.
- */
-export declare function resolveRenderCardConfig(input: {
-    resultBoundConfig: CardConfig | undefined;
-    currentConfig: CardConfig | undefined;
-    isCurrentQueryResult: boolean;
-}): CardConfig | undefined;

package/dist/types/lib/query-context/temporal-context-preview.d.ts

@@ -1,14 +0,0 @@
-import { GroupByField } from '../types/explorer-types.js';
-import { ResolvedPrimaryDateField } from '../types/semantic-runtime-types.js';
-import { ResolveTemporalContextInput, ResolvedTemporalContext, SemaphorSourceRef } from '../../shared/analytics-protocol/index.js';
-type ClientTemporalField = {
-    field: GroupByField | NonNullable<ResolvedPrimaryDateField>;
-    source: SemaphorSourceRef;
-};
-export type ClientTemporalContextPreviewInput = Omit<ResolveTemporalContextInput, 'candidates'> & {
-    visibleAxisFields?: ClientTemporalField[];
-    explicitHiddenFields?: ClientTemporalField[];
-    semanticPrimaryFields?: ClientTemporalField[];
-};
-export declare function previewClientTemporalContext(input: ClientTemporalContextPreviewInput): ResolvedTemporalContext;
-export {};

package/dist/types/lib/query-context/use-semantic-execution-payload-for-cards.d.ts

@@ -1,24 +0,0 @@
-import { TCard } from '../types/common-types.js';
-import { CardConfig } from '../types/explorer-types.js';
-import { SemanticExecutionPayload } from '../types/semantic-runtime-types.js';
-export type SemanticExecutionPayloadAuthority = 'runtime' | 'editor';
-export type SemanticExecutionPayloadCardState = {
-    status: 'ready' | 'loading' | 'error';
-    errorMessage: string | null;
-};
-export type SemanticExecutionPayloadForCardsResult = {
-    payload: SemanticExecutionPayload;
-    cardStatesById: Record<string, SemanticExecutionPayloadCardState>;
-};
-type QueryRelevantConfigsByCardId = Record<string, CardConfig | undefined>;
-export declare function useSemanticExecutionPayloadForCards(cards: TCard[], options?: {
-    authority?: SemanticExecutionPayloadAuthority;
-    queryRelevantConfigsByCardId?: QueryRelevantConfigsByCardId;
-    /** Standalone authoring supplies its own authority instead of borrowing a dashboard session. */
-    environment?: {
-        token?: string;
-        apiServiceUrl?: string;
-        authorizationScope: string;
-    };
-}): SemanticExecutionPayloadForCardsResult;
-export {};

package/dist/types/lib/resize-observer-utils.d.ts

@@ -1,10 +0,0 @@
-/**
- * Utility to suppress common ResizeObserver errors in the console
- *
- * ResizeObserver errors are often harmless but noisy in the console,
- * especially in applications with complex layouts, drag-and-drop functionality,
- * or dynamic visualizations.
- *
- * @returns A cleanup function to restore original error handling
- */
-export declare const suppressResizeObserverErrors: () => () => void;

package/dist/types/lib/selection/click-to-filter-authoring-support.d.ts

@@ -1,9 +0,0 @@
-import { TCard } from '../types/common-types.js';
-/**
- * Card types that get the new click-to-filter authoring: the fields rule, the
- * Matrix sources, Review cards and its field mapping. The aggregate table and
- * the legacy pivot are legacy producers. Their clicks still filter, and an
- * author can still turn that on or off and set the receiver flag, but they get
- * none of the new options.
- */
-export declare function supportsClickToFilterAuthoring(type: TCard['type']): boolean;

package/dist/types/lib/selection/selection-from-click-context.d.ts

@@ -1,41 +0,0 @@
-import { SelectionTuple } from '../../shared/analytics-protocol/selection-contract.js';
-import { ClickToFilterSettings } from '../../shared/dashboard-authoring/click-to-filter-settings.js';
-import { DashboardCardFilterSourceInventory } from '../../shared/dashboard-authoring/dashboard-card-source-index.js';
-import { Field } from '../types/explorer-types.js';
-import { ClickFilterCondition } from '../types/interaction-types.js';
-export type SelectionTupleUnavailableReason = 
-/** The click carried no dimension value (a total, a blank area). */
-'noFields'
-/** The fields rule needs the clicked column and it is not a filterable dimension. */
- | 'clickedColumnNotFilterable'
-/** None of the clicked fields are among the author's chosen columns. */
- | 'noChosenColumns'
-/** A field is calculated, or is not on a source this card executes. */
- | 'fieldNotFilterable'
-/** The builder produced a condition that is not an equality or a blank. */
- | 'unsupportedCondition';
-export type SelectionTupleResult = {
-    status: 'ready';
-    tuple: SelectionTuple;
-} | {
-    status: 'unavailable';
-    code: SelectionTupleUnavailableReason;
-    /** Viewer-facing; shown as a tooltip on the source. */
-    reason: string;
-};
-/**
- * Turns a click-context builder's output into one selection tuple: applies the
- * card's fields rule, drops measures, and grounds every explorer field on one
- * of the source card's own executable sources. One ungroundable condition
- * makes the whole tuple unavailable, because a partial tuple would filter to
- * more than the viewer clicked.
- */
-export declare function selectionTupleFromClickContext(params: {
-    settings: Pick<ClickToFilterSettings, 'fields'>;
-    /** Builder output. */
-    conditions: ClickFilterCondition[];
-    /** The dimension column under the pointer; required for 'clickedCell'. */
-    clickedField?: Field;
-    /** buildDashboardCardSourceIndex(card) of the source card. */
-    sourceIndex: DashboardCardFilterSourceInventory;
-}): SelectionTupleResult;

package/dist/types/lib/selection/selection-labels.d.ts

@@ -1,3 +0,0 @@
-import { SelectionTuple } from '../../shared/analytics-protocol/selection-contract.js';
-/** "West, East +3": the first two labels, then a count once there are more than three. */
-export declare function selectionChipLabel(tuples: SelectionTuple[]): string;

package/dist/types/lib/selection/selection-notices.d.ts

@@ -1,9 +0,0 @@
-import { SelectionTupleResult } from './selection-from-click-context.js';
-/**
- * Tells the viewer why a click did not filter. A click on a column that simply
- * is not a filter column stays silent: it is the ordinary case on a
- * clicked-cell table, not a problem to report.
- */
-export declare function notifySelectionUnavailable(result: Extract<SelectionTupleResult, {
-    status: 'unavailable';
-}>): void;

package/dist/types/lib/selection/selection-reducer.d.ts

@@ -1,46 +0,0 @@
-import { SelectionTuple } from '../../shared/analytics-protocol/selection-contract.js';
-export type SelectionGesture<TTuple = SelectionTuple> = 
-/** Plain click. */
-{
-    kind: 'replace';
-}
-/** Cmd/Ctrl-click; Shift-click on charts and matrix; tap when checkboxes are shown. */
- | {
-    kind: 'toggle';
-}
-/** Shift-click on tables. `ordered` is the visible row order after sort and filter. */
- | {
-    kind: 'range';
-    anchor: TTuple;
-    ordered: TTuple[];
-}
-/** Esc, blank plot area, chip dismiss, card Clear. */
- | {
-    kind: 'clear';
-};
-export type SelectionReduceResult<TTuple = SelectionTuple> = {
-    tuples: TTuple[];
-    outcome: 'selected' | 'added' | 'removed' | 'cleared' | 'rangeSelected' | 'limitReached';
-};
-/** Pure selection state transition. `incoming` is ignored by `clear`. */
-export declare function reduceSelection(current: SelectionTuple[], incoming: SelectionTuple, gesture: SelectionGesture<SelectionTuple>, options: {
-    multipleSelection: boolean;
-    limit?: number;
-}): SelectionReduceResult<SelectionTuple>;
-export declare function reduceSelection<TTuple>(current: TTuple[], incoming: TTuple, gesture: SelectionGesture<TTuple>, options: {
-    multipleSelection: boolean;
-    limit?: number;
-    tupleKey: (tuple: TTuple) => string;
-}): SelectionReduceResult<TTuple>;
-/** What the pointer asked for. A range still needs the anchor and the visible row order, which the caller owns. */
-export type SelectionGestureIntent = 'replace' | 'toggle' | 'range';
-export declare function gestureFromPointer(event: {
-    shiftKey: boolean;
-    metaKey: boolean;
-    ctrlKey: boolean;
-    pointerType?: string;
-}, visual: 'table' | 'chart' | 'matrix', options: {
-    multipleSelection: boolean;
-    hasAnchor: boolean;
-    checkboxesShown: boolean;
-}): SelectionGestureIntent;