react-semaphor 0.1.532 → 0.1.534

package/dist/types/lib/matrix-table/matrix-layout-read.d.ts

@@ -1,68 +0,0 @@
-import { MatrixLayoutReadResult } from '../../shared/dashboard-authoring/matrix-delivery.js';
-import { buildMatrixDeliveryPayload } from './matrix-delivery.js';
-import { DocumentTableRowFacts } from '../document/document-pagination.js';
-import { FastPathTableStructure } from '../../shared/format-utils/table-structure.js';
-import { ReportRuntimeContext } from '../../shared/report-runtime-context/index.js';
-/** Matrix sections on one page read at most this many full results at once (tech spec G6). */
-export declare const MATRIX_LAYOUT_READ_CONCURRENCY = 2;
-/**
- * The full Matrix result a Document section prints, from the delivery-authorized
- * layout route (tech spec D-M1). Always resolves to the typed result; an abort
- * rejects, so it is never kept as a result.
- */
-export declare function readMatrixLayout(input: {
-    apiServiceUrl: string;
-    token: string;
-    payload: ReturnType<typeof buildMatrixDeliveryPayload>;
-    signal: AbortSignal;
-}): Promise<MatrixLayoutReadResult>;
-/** How a printed row reads: its role and where it sits in the hierarchy. */
-export type MatrixPrintRowKind = 'member'
-/** A parent row in outline layout, heading its children. */
- | 'group'
-/** The subtotal of the innermost group level. */
- | 'subtotal_inner'
-/** The subtotal of an outer group level. */
- | 'subtotal_outer' | 'grand_total';
-export type MatrixPrintRow = {
-    kind: MatrixPrintRowKind;
-    /**
-     * Group labels this row hides because the row above shows them, by column
-     * index. A page that starts at this row repeats them, marked "(cont.)".
-     */
-    continuation?: Readonly<Record<number, string>>;
-    /**
-     * Indented layout: the parent header rows a page that starts at this row
-     * repeats, outermost first, already indented and marked "(cont.)".
-     */
-    continuationHeaders?: readonly string[];
-};
-/** A read as the page draws it: the formatted table and each row's print facts. */
-export type DocumentMatrixRead = {
-    status: 'ok';
-    table: FastPathTableStructure;
-    rows: readonly MatrixPrintRow[];
-    /** Indented layout: the column that carries the row labels. */
-    hierarchyColumn?: number;
-    /**
-     * Column groups for bands (Plan 2, 2c): per column, the index of its
-     * group in `groups`, or `null` for a row-label column. A group is one
-     * column member (or total) with all its measures.
-     */
-    columnGroups: readonly (number | null)[];
-    /** Each group's label, as the header prints it ("Houston", "Grand Total"). */
-    groupLabels: readonly string[];
-    /** What bands name their groups by: the innermost column level, or "Measures". */
-    groupLevelLabel: string;
-    /** How the paginator may split these rows (Plan 2, L1 and L5). */
-    pageBreaks: DocumentTableRowFacts;
-} | Extract<MatrixLayoutReadResult, {
-    status: 'failed';
-}>;
-/**
- * Formats a read once, with the definition that ran. The Document section
- * does this in its query, so every page slice shares one formatted table.
- * The table is the one every Matrix PDF prints (`buildMatrixPrintTable`);
- * this adds what only a Document uses, such as "(cont.)" labels.
- */
-export declare function formatMatrixLayoutRead(result: MatrixLayoutReadResult, report: ReportRuntimeContext): DocumentMatrixRead;

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

@@ -1,18 +0,0 @@
-import { MatrixAxis, MatrixPath, MatrixSpec, MatrixPresentation, MatrixViewState } from '../../shared/analytics-protocol/index.js';
-import { MatrixAxisItem, MatrixPageSlot } from './matrix-runtime-types.js';
-export declare function matrixBranchKey(axis: MatrixAxis, parent: MatrixPath): string;
-export declare function matrixPageKey(request: Pick<MatrixPageSlot['request'], 'axis' | 'parent' | 'position'>): string;
-export declare function isMatrixExpanded(view: MatrixViewState, axis: MatrixAxis, path: MatrixPath): boolean;
-/** Page-owner tiles include every measure; both axes must fit together. */
-export declare function resolveMatrixPageSizes(spec: Pick<MatrixSpec, 'measures' | 'columns'>): Record<MatrixAxis, number> | null;
-/** Bounded resident pages are projected; unloaded tails never count as branch end. */
-export declare function projectMatrixAxis(input: {
-    axis: MatrixAxis;
-    spec: MatrixSpec;
-    presentation: MatrixPresentation;
-    view: MatrixViewState;
-    pages: readonly MatrixPageSlot[];
-    label?: (path: MatrixPath) => string;
-}): MatrixAxisItem[];
-/** Preserve a role/path anchor across insertion and eviction; pixels stay in the view. */
-export declare function findMatrixAnchor(items: readonly MatrixAxisItem[], key: string, previousIndex: number): number;

package/dist/types/lib/matrix-table/matrix-measure-presentation.d.ts

@@ -1,8 +0,0 @@
-import { TCard } from '../types/common-types.js';
-import { MatrixCardCatalog } from './matrix-card-adapter.js';
-/** Stable authored measure targets; no shelf IDs or resident-result descriptors. */
-export declare function resolveMatrixCardMeasures(card: Pick<TCard, 'type' | 'config' | 'sql' | 'python'>, catalog?: MatrixCardCatalog): {
-    measureId: string;
-    label: string;
-    canonical: import('../../shared/format-utils/types/index.js').NumericCanonicalFormat | undefined;
-}[];

package/dist/types/lib/matrix-table/matrix-operation-queue.d.ts

@@ -1,8 +0,0 @@
-/** Dashboard-local admission control; it never retains results or retries work. */
-export declare class MatrixOperationQueue {
-    private pending;
-    private activeByCard;
-    private active;
-    run<T>(cardId: string, signal: AbortSignal, operation: () => Promise<T>): Promise<T>;
-    private pump;
-}

package/dist/types/lib/matrix-table/matrix-query-transport.d.ts

@@ -1,6 +0,0 @@
-import { MatrixExecutionEnvironment } from './matrix-execution-context.js';
-/**
- * The dashboard endpoint owns auth and grounding; no data/SQL reconstruction
- * here. Successful windows arrive indexed (efficiency plan E-D8).
- */
-export declare function createMatrixQueryTransport(endpoint: string, token: string): MatrixExecutionEnvironment['execute'];

package/dist/types/lib/matrix-table/matrix-row-labels.d.ts

@@ -1,13 +0,0 @@
-import { MatrixPath } from '../../shared/analytics-protocol/index.js';
-import { MatrixAxisItem } from './matrix-runtime-types.js';
-/** Suppression is local to a resident page and viewport, never an invisible ancestor. */
-export declare function matrixTabularLabels(input: {
-    item: MatrixAxisItem;
-    previous?: MatrixAxisItem;
-    levelCount: number;
-    repeatLabels: boolean;
-}): Array<{
-    path: MatrixPath;
-    visible: boolean;
-    total: boolean;
-}>;

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

@@ -1,19 +0,0 @@
-import { buildMatrixDeliveryPayload } from './matrix-delivery.js';
-import { downloadMatrixPdf } from '../download-pdf.js';
-import { ActiveExport } from '../stores/export-store.js';
-/** Submission policy stays out of the dialog; presentation consumes the outcome. */
-export declare function submitMatrixDelivery(input: Omit<Parameters<typeof buildMatrixDeliveryPayload>[0], 'format'> & {
-    format: string;
-    apiServiceUrl: string;
-    allowDownload?: boolean;
-    authToken: Parameters<typeof downloadMatrixPdf>[1];
-    pdfOptions: Parameters<typeof downloadMatrixPdf>[3];
-}): Promise<{
-    kind: "pdf";
-    result: import('../download-pdf.js').PdfDownloadResponse;
-    export?: undefined;
-} | {
-    kind: "csv";
-    export: ActiveExport;
-    result?: undefined;
-}>;

package/dist/types/lib/matrix-table/use-matrix-card-catalog.d.ts

@@ -1,20 +0,0 @@
-import { MatrixSpec, SemaphorSourceRef } from '../../shared/analytics-protocol/index.js';
-import { MatrixCardCatalog } from './matrix-card-adapter.js';
-export type MatrixCatalogEnvironment = {
-    token?: string;
-    apiServiceUrl?: string;
-    authorizationScope: string;
-};
-/** Existing columns API and column conversion, without an editor-store dependency. */
-export declare function useMatrixCardCatalog(spec: MatrixSpec | MatrixSpec[] | undefined, supplied?: MatrixCardCatalog, environment?: MatrixCatalogEnvironment): {
-    catalog: MatrixCardCatalog;
-    pending: boolean;
-    error: false | Error | null | undefined;
-};
-export declare function useMatrixSourceCatalog(input: readonly Exclude<SemaphorSourceRef, {
-    kind: 'sql';
-}>[], supplied?: MatrixCardCatalog, environment?: MatrixCatalogEnvironment): {
-    catalog: MatrixCardCatalog;
-    pending: boolean;
-    error: false | Error | null | undefined;
-};

package/dist/types/lib/matrix-table/use-matrix-cell-focus.d.ts

@@ -1,55 +0,0 @@
-import { KeyboardEvent } from 'react';
-import { MatrixCoordinate, MatrixSpec } from '../../shared/analytics-protocol/index.js';
-import { MatrixRuntime } from './use-matrix.js';
-/**
- * One view-local active cell for grid navigation and editor field scoping.
- * Dashboard selection remains owned by the selection input runtime.
- */
-export declare function useMatrixCellFocus(input: {
-    runtime: MatrixRuntime;
-    spec: MatrixSpec;
-    reveal: (row: number, valueColumn: number) => void;
-    onFocusChange?: (coordinate: MatrixCoordinate | undefined) => void;
-    onActivate?: (coordinate: MatrixCoordinate, event: KeyboardEvent<HTMLDivElement>) => void;
-}): {
-    hasFocus: boolean;
-    focusedRow: number;
-    focusedColumn: number;
-    coordinate: {
-        rowPath: readonly {
-            member: {
-                value: string | number | boolean | {
-                    value: string;
-                    type: "integer" | "decimal";
-                    kind: "exact_number";
-                } | null;
-                kind: "value";
-            } | {
-                kind: "others";
-                rankingId: string;
-            };
-            levelId: string;
-        }[];
-        columnPath: readonly {
-            member: {
-                value: string | number | boolean | {
-                    value: string;
-                    type: "integer" | "decimal";
-                    kind: "exact_number";
-                } | null;
-                kind: "value";
-            } | {
-                kind: "others";
-                rankingId: string;
-            };
-            levelId: string;
-        }[];
-        measureId: string;
-    } | undefined;
-    keyboard: (event: KeyboardEvent<HTMLDivElement>) => void;
-    setFocus: (rowIndex: number, valueColumn: number, options?: {
-        toggle?: boolean;
-    }) => void;
-    clear: () => void;
-    isFocused: (rowIndex: number, valueColumn: number) => boolean;
-};

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

@@ -1,6 +0,0 @@
-import { MatrixDeliveryContext } from './matrix-delivery.js';
-/** Card-owned accessor. Publishing a view does not rerender the host or refetch data. */
-export declare function useMatrixDeliveryCapture(): {
-    read: () => MatrixDeliveryContext | undefined;
-    publish: (value: MatrixDeliveryContext | undefined) => void;
-};

package/dist/types/lib/matrix-table/use-matrix-editor-catalog.d.ts

@@ -1,5 +0,0 @@
-import { TCard } from '../types/common-types.js';
-/** The existing source picker and Matrix refs share the same columns owner. */
-export declare function useMatrixEditorCatalog(card: TCard | undefined): {
-    catalog: import('./matrix-card-adapter.js').MatrixCardCatalog;
-};

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

@@ -1,74 +0,0 @@
-import { CompiledCardQueryContext } from '../query-context/build-card-query-context.js';
-import { ReportRuntimeContext } from '../../shared/report-runtime-context/index.js';
-import { MatrixViewState, MatrixSpec } from '../../shared/analytics-protocol/index.js';
-import { MatrixRuntimeController } from './matrix-runtime.js';
-import { MatrixRuntimeInput } from './matrix-runtime-types.js';
-type MatrixInput = MatrixRuntimeInput & {
-    /** Mount-scoped command subscription for host toolbars, not result storage. */
-    onRuntimeMount?: (runtime: MatrixRuntimeController) => (() => void) | void;
-    cardId?: string;
-    /** Authored controls input; runtime spec is the resolved display definition. */
-    authoredSpec?: MatrixSpec;
-    /**
-     * The shared card query identity (`createCompiledCardQueryIdentities`) of the
-     * same `queryContext` and calendar this card sends. It is the only source of
-     * query-context identity here; never hash query-context fields locally.
-     */
-    queryInputIdentity: string;
-    queryContext: CompiledCardQueryContext;
-    reportContext: ReportRuntimeContext;
-    /** Milliseconds from the card refresh setting; absent while editing. */
-    refreshInterval?: number;
-};
-/** One lifecycle per mounted card; the frame must not fetch this staged viewer. */
-export declare function useMatrix(input: MatrixInput): {
-    formatting: {
-        levels: Map<string, (value: import('../../shared/analytics-protocol/index.js').SemaphorScalarValue) => string>;
-        measures: Map<string, (value: import('../../shared/analytics-protocol/index.js').SemaphorScalarValue) => string>;
-        measureSemantics: Map<string, {
-            isNumeric: boolean;
-            hasTextAffixes: boolean;
-        }>;
-    };
-    readCell: (coordinate: import('./matrix-runtime-types.js').MatrixCellAddress) => import('./matrix-runtime-types.js').MatrixCellState;
-    setViewport: (viewport: import('./matrix-runtime-types.js').MatrixViewport) => void;
-    retry: (retryKey: string) => void;
-    refresh: () => void;
-    dismissNotice: () => void;
-    setExpanded: (axis: "columns" | "rows", path: readonly {
-        member: {
-            value: string | number | boolean | {
-                value: string;
-                type: "integer" | "decimal";
-                kind: "exact_number";
-            } | null;
-            kind: "value";
-        } | {
-            kind: "others";
-            rankingId: string;
-        };
-        levelId: string;
-    }[], expanded: boolean) => void;
-    setExpansionDepth: (axis: "columns" | "rows", depth: number) => void;
-    setSort: (rule: import('../../shared/analytics-protocol/index.js').MatrixSort) => void;
-    clearSort: (scope: Pick<import('../../shared/analytics-protocol/index.js').MatrixSort, "scope" | "levelId" | "axis">) => void;
-    rows: readonly import('./matrix-runtime-types.js').MatrixAxisItem[];
-    columns: readonly import('./matrix-runtime-types.js').MatrixAxisItem[];
-    view: MatrixViewState;
-    status: "idle" | "loading" | "ready" | "failed";
-    error?: import('./matrix-runtime-types.js').MatrixRuntimeError;
-    descriptors: import('../../shared/analytics-protocol/index.js').MatrixWindow["descriptors"];
-    notice?: string;
-    generation: number;
-    diagnostics: {
-        pages: number;
-        blocks: number;
-        cells: number;
-        bytes: number;
-        checkpoints: number;
-        inFlight: number;
-        queued: number;
-    };
-};
-export type MatrixRuntime = ReturnType<typeof useMatrix>;
-export {};

package/dist/types/lib/pdf-execution-snapshot.d.ts

@@ -1,12 +0,0 @@
-import { ReportRuntimeContext } from '../shared/report-runtime-context/index.js';
-export declare const PDF_REPORT_CONTEXT_MAX_BYTES: number;
-export type PdfReportContextSnapshot = {
-    reportContext: ReportRuntimeContext;
-    timezone: string;
-};
-/**
- * Capture the common immutable report-context portion of a synchronous PDF
- * request. Filters, controls, inputs, and persisted report identity remain
- * owned by their existing target-specific snapshot builders.
- */
-export declare function buildPdfReportContextSnapshot(input: unknown): PdfReportContextSnapshot;

package/dist/types/lib/pdf-fast-path/aggregate-metric-semantics.d.ts

@@ -1 +0,0 @@
-export declare function isAggregateMetricNumericForPdf(dataType: unknown): boolean;

package/dist/types/lib/pdf-fast-path/builders.d.ts

@@ -1,46 +0,0 @@
-import { FastPathTableStructure } from '../../shared/format-utils/table-structure.js';
-import { TablePreferences, ColumnSettings } from '../../components/visual/data-table/types/data-table.js';
-import { FlatTableTotalsByColumnId } from '../table-formatting/table-totals-settings.js';
-import { TCard } from '../types/common-types.js';
-import { SemaphorResultColumn } from '../../shared/analytics-protocol/index.js';
-import { CardConfig, GroupByField, QueryColumnKeyMap } from '../types/explorer-types.js';
-import { PivotTableConfig } from '../../components/visual/pivot-table/pivot-table.js';
-import { PivotColumnSchema } from '../../components/visual/pivot-table/types.js';
-import { ComparisonMetadataMap } from '../types/query-types.js';
-import { CardNumericPresentationContext } from '../formatters/numeric-presentation.js';
-import { RegularTableTemporalPresentation } from '../formatters/regular-table-temporal-presentation.js';
-import { RawTemporalPresentation } from '../formatters/raw-temporal-presentation.js';
-import { AggregateTemporalPresentation } from '../../components/visual/aggregated-table/utils/temporal-presentation.js';
-type DataTableInput = {
-    records: Record<string, any>[];
-    tablePreferences?: TablePreferences;
-    card?: TCard;
-    comparisonMetadata?: ComparisonMetadataMap;
-    numericPresentation?: CardNumericPresentationContext;
-    totalsByColumnId?: FlatTableTotalsByColumnId;
-    temporalPresentation?: RegularTableTemporalPresentation;
-    rawTemporalPresentation?: RawTemporalPresentation;
-    effectiveCardConfig?: CardConfig;
-    columnKeyMap?: QueryColumnKeyMap;
-    resultColumns?: readonly SemaphorResultColumn[];
-};
-export declare function buildDataTableStructure({ records, tablePreferences, card, comparisonMetadata, numericPresentation, totalsByColumnId: authoritativeTotalsByColumnId, temporalPresentation, rawTemporalPresentation, effectiveCardConfig, columnKeyMap, resultColumns, }: DataTableInput): FastPathTableStructure | null;
-type AggregateInput = {
-    records: Record<string, any>[];
-    groupByColumns: GroupByField[];
-    pivotSchema: PivotColumnSchema[];
-    card: TCard;
-    effectiveCardConfig?: CardConfig;
-    columnSettings?: Record<string, ColumnSettings>;
-    numericPresentation?: CardNumericPresentationContext;
-    temporalPresentation?: AggregateTemporalPresentation;
-    columnKeyMap?: QueryColumnKeyMap;
-};
-export declare function buildAggregateTableStructure({ records, groupByColumns, pivotSchema, card, effectiveCardConfig, columnSettings, numericPresentation, temporalPresentation, columnKeyMap, }: AggregateInput): FastPathTableStructure | null;
-type PivotInput = {
-    pivotConfig: PivotTableConfig;
-    card: TCard;
-    showRowTotals?: boolean;
-};
-export declare function buildPivotTableStructure({ pivotConfig, card, showRowTotals, }: PivotInput): FastPathTableStructure | null;
-export {};

package/dist/types/lib/pdf-fast-path/candidate-eligibility.d.ts

@@ -1,17 +0,0 @@
-import { TChartType } from '../charts/types.js';
-import { ExportFormat } from '../utils/export-utils.js';
-export declare const PDF_ROW_LIMIT_GUIDANCE: string;
-export declare function isExistingStructuredFastPdfCardType(cardType: TChartType | undefined): boolean;
-export declare function shouldAttemptExistingFastPdfCandidate({ cardType, rowCount, hasServerPagination, hasRequiredStructure, }: {
-    cardType: TChartType | undefined;
-    rowCount: number;
-    hasServerPagination: boolean;
-    hasRequiredStructure: boolean;
-}): boolean;
-export declare function isExistingStructuredPdfOptionAvailable(cardType: TChartType | undefined, knownRowCount: number | null): boolean;
-export declare function shouldAutoSelectCsvForPdfRowLimit({ cardType, knownRowCount, selectedFormat, csvSupported, }: {
-    cardType: TChartType | undefined;
-    knownRowCount: number | null;
-    selectedFormat: ExportFormat;
-    csvSupported: boolean;
-}): boolean;

package/dist/types/lib/pdf-fast-path/extract-table-structure.d.ts

@@ -1,5 +0,0 @@
-import { FastPathTableStructure } from '../../shared/format-utils/table-structure.js';
-export declare function extractDataTableStructure(root: Element | null): FastPathTableStructure | null;
-export declare function extractAggregateTableStructure(root: Element | null): FastPathTableStructure | null;
-export declare function extractPivotTableStructure(root: Element | null): FastPathTableStructure | null;
-export declare function extractFastPathStructure(frameId: string, cardType: string): FastPathTableStructure | null;

package/dist/types/lib/pdf-fast-path/index.d.ts

@@ -1,27 +0,0 @@
-import { FastPathTableStructure } from '../../shared/format-utils/table-structure.js';
-import { PresentationExecutionSnapshot } from '../../shared/format-utils/index.js';
-export type FastPathPayload = {
-    cardType: string;
-    reportTitle: string;
-    tableStructure: FastPathTableStructure;
-    filterLine?: string;
-    presentationExecutionSnapshot: PresentationExecutionSnapshot;
-    timezone?: string;
-    pageSize?: string;
-    orientation?: string;
-    wideTableStrategy?: 'auto' | 'fit' | 'horizontal_paginate';
-    password?: string;
-    rowCount: number;
-};
-export declare function buildFastPathPayload(params: {
-    cardType: string;
-    reportTitle: string;
-    tableStructure: FastPathTableStructure;
-    filterLine?: string;
-    presentationExecutionSnapshot: PresentationExecutionSnapshot;
-    timezone?: string;
-    pageSize?: string;
-    orientation?: string;
-    wideTableStrategy?: 'auto' | 'fit' | 'horizontal_paginate';
-    password?: string;
-}): FastPathPayload;

package/dist/types/lib/pdf-fast-path/pivot-fast-path-utils.d.ts

@@ -1,12 +0,0 @@
-export declare function countPivotBodyRows(records: any[]): number;
-export declare function getPivotFastPathRowCount({ exportData, pivotTableConfig, pivotData, }: {
-    exportData: any;
-    pivotTableConfig?: {
-        data?: {
-            rowData?: any[];
-        };
-    } | null;
-    pivotData?: {
-        records?: any[];
-    } | null;
-}): number;

package/dist/types/lib/pdf-fast-path/prepare-server-table-pdf-export.d.ts

@@ -1,37 +0,0 @@
-import { TablePreferences } from '../../components/visual/data-table/types/data-table.js';
-import { CardNumericPresentationContext } from '../formatters/numeric-presentation.js';
-import { DashboardCardQueryContract } from '../query-context/build-dashboard-card-query-contract.js';
-import { TCard } from '../types/common-types.js';
-import { CardConfig } from '../types/explorer-types.js';
-import { ReportRuntimeContext } from '../../shared/report-runtime-context/index.js';
-import { FastPathTableStructure } from '../../shared/format-utils/table-structure.js';
-export type ServerTablePdfExportDecision = {
-    action: 'use_fast_pdf';
-    sourceRecordCount: number;
-    renderedBodyRowCount: number;
-    tableStructure: FastPathTableStructure;
-} | {
-    action: 'use_rendered_pdf';
-    reason: 'unsupported_card_type' | 'server_paginated_sql_with_python' | 'missing_invalid_or_empty_total_count' | 'complete_result_query_failed' | 'empty_fresh_result' | 'invalid_presentation_metadata' | 'table_structure_unavailable';
-} | {
-    action: 'stop_pdf_export';
-    reason: 'known_row_count_exceeds_limit' | 'fresh_row_count_exceeds_limit' | 'complete_result_truncated' | 'rendered_body_row_count_exceeds_limit';
-    customerMessage: string;
-};
-type PrepareServerTablePdfExportInput = {
-    apiServiceUrl: string;
-    authToken: string;
-    card: TCard;
-    displayedTotalCount: unknown;
-    queryContract: DashboardCardQueryContract;
-    effectiveCardConfig?: CardConfig;
-    tablePreferences?: TablePreferences;
-    numericPresentation?: CardNumericPresentationContext;
-    reportContext: ReportRuntimeContext;
-};
-/**
- * Acquires and prepares one complete Fast PDF candidate for a server-paginated
- * regular/detail table. It never loops pages or rewrites authored SQL.
- */
-export declare function prepareServerTablePdfExport({ apiServiceUrl, authToken, card, displayedTotalCount, queryContract, effectiveCardConfig, tablePreferences, numericPresentation, reportContext, }: PrepareServerTablePdfExportInput): Promise<ServerTablePdfExportDecision>;
-export {};

package/dist/types/lib/print/print-holds.d.ts

@@ -1,15 +0,0 @@
-/** Something that must finish before the dashboard counts as ready. */
-export type PrintHold = {
-    /** Stable, e.g. `matrix:${cardId}`. Registrations with the same key are listed once. */
-    key: string;
-    /** Card title for error messages; never data values. */
-    label: string;
-};
-/**
- * While `held` is true, the dashboard's ready flag stays false. The hold is
- * released when `held` turns false or the component unmounts. Each call is its
- * own registration, so parent and child components can hold the same key.
- */
-export declare function usePrintHold(hold: PrintHold, held: boolean): void;
-/** Holds registered right now, one per key, in registration order. */
-export declare function useActivePrintHolds(): readonly PrintHold[];

package/dist/types/lib/print-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;