react-semaphor 0.1.533 → 0.1.534

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

@@ -1,97 +0,0 @@
-import { TFilterValue } from '../../components/surfboard/filter/types.js';
-import { ControlOption, DocumentInputDefinition, DocumentTextInlineFormat, DocumentTextContent, DocumentVariableRef, ResolvedDocumentInput, TextVariablePresentation } from '../types/common-types.js';
-import { TextVariableChipFace, TextVariableOption, TextVariableSelection } from '../text-variables/text-variable-types.js';
-import { TemporalTextPresentationContext } from '../text-variables/temporal-input-text.js';
-export type DocumentTextRenderContext = {
-    inputs: DocumentInputDefinition[];
-    resolvedInputsById: Record<string, ResolvedDocumentInput>;
-    meta: {
-        generatedAt: string;
-        pageNumber: number;
-        pageCount: number;
-    };
-    timezone?: string;
-    generatedAtFormat?: string;
-    /** The viewer's Report preferences and Calendar, for date inputs. */
-    presentation?: TemporalTextPresentationContext;
-};
-export type ParsedDocumentTextContent = {
-    content: DocumentTextContent;
-    unresolvedTokens: string[];
-};
-export type ParsedDocumentTextSegment = ({
-    type: 'text';
-    value: string;
-} | {
-    type: 'variable';
-    ref: DocumentVariableRef;
-}) & {
-    sourceEnd: number;
-    sourceStart: number;
-};
-export type ParsedDocumentTextContentWithSource = {
-    content: ParsedDocumentTextSegment[];
-    unresolvedTokens: string[];
-};
-export type RenderedDocumentTextPart = {
-    type: 'text' | 'variable';
-    value: string;
-    format?: DocumentTextInlineFormat;
-    /** Authoring: how a variable reads as a chip. */
-    chip?: TextVariableChipFace;
-};
-export declare function parseDocumentTextContent(value: string, inputs: DocumentInputDefinition[]): ParsedDocumentTextContent;
-export declare function parseDocumentTextContentWithSource(value: string, inputs: DocumentInputDefinition[]): ParsedDocumentTextContentWithSource;
-export declare function appendDocumentVariable(content: DocumentTextContent | undefined, ref: DocumentVariableRef): DocumentTextContent;
-export declare function getDocumentVariableLabel(ref: DocumentVariableRef, inputs: DocumentInputDefinition[]): string;
-/** What a reference shows, as the picker names it. */
-export declare function getDocumentVariableSelection(ref: DocumentVariableRef, inputs?: DocumentInputDefinition[], presentation?: TextVariablePresentation): TextVariableSelection;
-/** The reference a picker selection stands for. */
-export declare function getDocumentVariableRefFromSelection(selection: TextVariableSelection): DocumentVariableRef;
-/** How a reference reads as a chip: the input's name, or Missing input. */
-export declare function getDocumentVariableChipFace(ref: DocumentVariableRef, inputs: DocumentInputDefinition[], presentation?: TextVariablePresentation): TextVariableChipFace;
-/**
- * The inputs and report values a Document text can show, each part with what
- * it holds now when `context` is given.
- */
-export declare function getDocumentTextVariableOptions(inputs: DocumentInputDefinition[], context?: DocumentTextRenderContext): TextVariableOption[];
-/**
- * Where a document shows an input: the header, the footer and its text
- * sections, in reading order.
- */
-export declare function getDocumentInputTextUsage(document: {
-    header?: {
-        blocks: Array<{
-            type: string;
-            content?: DocumentTextContent;
-        }>;
-    };
-    footer?: {
-        blocks: Array<{
-            type: string;
-            content?: DocumentTextContent;
-        }>;
-    };
-    sections: Array<{
-        type: string;
-        content?: DocumentTextContent;
-    }>;
-}, inputId: string): {
-    header: boolean;
-    footer: boolean;
-    textSections: number;
-};
-export declare function buildDocumentTextRenderContext({ inputs, filterValuesByInputId, controlValuesByInputId, controlOptionsByInputId, generatedAt, timezone, generatedAtFormat, presentation: providedPresentation, pageNumber, pageCount, }: {
-    inputs: DocumentInputDefinition[];
-    filterValuesByInputId: Record<string, TFilterValue | undefined>;
-    controlValuesByInputId: Record<string, unknown>;
-    controlOptionsByInputId?: Record<string, ControlOption[]>;
-    generatedAt: string;
-    timezone?: string;
-    generatedAtFormat?: string;
-    presentation?: TemporalTextPresentationContext;
-    pageNumber?: number;
-    pageCount?: number;
-}): DocumentTextRenderContext;
-export declare function renderDocumentTextContent(content: DocumentTextContent | undefined, context: DocumentTextRenderContext): string;
-export declare function renderDocumentTextContentParts(content: DocumentTextContent | undefined, context: DocumentTextRenderContext): RenderedDocumentTextPart[];

package/dist/types/lib/document/document-visual-render-contract.d.ts

@@ -1,8 +0,0 @@
-import { TCard, VisualDisplayPreferences } from '../types/common-types.js';
-export declare const DOCUMENT_TABLE_PRINT_DISPLAY_PREFERENCES: VisualDisplayPreferences;
-export declare const DOCUMENT_TABLE_PRINT_RENDER_CONTRACT: {
-    readonly suppressSortControls: true;
-    readonly renderPlainWrapper: true;
-    readonly disableDashboardInteractions: true;
-};
-export declare function prepareDocumentTableCardForRender<TCardLike extends TCard>(card: TCardLike): TCardLike;

package/dist/types/lib/document/use-document-section-data.d.ts

@@ -1,39 +0,0 @@
-import { DocumentSectionRenderState } from './document-section-render-state.js';
-import { DashboardCardQueryResult } from '../hooks/use-dashboard-frame-query.js';
-import { DocumentKpiSection, TCard } from '../types/common-types.js';
-import { ComparisonMetadataMap } from '../types/query-types.js';
-import { DocumentSectionRuntime } from './document-section-query-options.js';
-export type DocumentCardDataStatus = 'unconfigured'
-/** Waiting for required inputs; the query will not run until they are set. */
- | 'blocked' | 'loading' | 'ready' | 'empty' | 'error';
-export type DocumentCardDataState = {
-    cardId: string;
-    card: TCard;
-    status: DocumentCardDataStatus;
-    /** The card query's records, unchanged. Empty unless `ready`. */
-    records: Record<string, unknown>[];
-    comparisonMetadata?: ComparisonMetadataMap;
-    errorMessage?: string;
-    /** The query failure, for delivery error attributes. */
-    error?: unknown;
-    /** `blocked` only: the required inputs to set. */
-    missingRequiredInputLabels?: string[];
-};
-/** A card can run once it is set up (the dashboard's own rule: a connection plus SQL or fields). */
-export declare function isDocumentSectionCardRunnable(card: TCard): boolean;
-/** The print readiness a card's data status means. */
-export declare function getDocumentCardRenderState(status: DocumentCardDataStatus): DocumentSectionRenderState;
-/** One card's data state from its query result. Exported for tests. */
-export declare function toDocumentCardDataState(card: TCard, result: Pick<DashboardCardQueryResult, 'data' | 'isPending' | 'isFetching' | 'isError' | 'error' | 'errorMessage' | 'comparisonMetadata' | 'isCurrentQueryResult' | 'missingRequiredInputLabels'>): DocumentCardDataState;
-/**
- * Data for every card of a KPI section, in display order. Each card runs
- * through the dashboard card query in the section's runtime (section-scoped
- * inputs, document filters and controls), so a Document never has its own
- * query path.
- *
- * KPI sections only: table sections acquire their rows through
- * `useDocumentTableRows` (row policy, full-result acquisition for export) and
- * share only the options builder. Reading a table through this hook would
- * print a partial result.
- */
-export declare function useDocumentSectionData(section: DocumentKpiSection, runtime: Omit<DocumentSectionRuntime, 'missingRequiredInputLabels'>): readonly DocumentCardDataState[];

package/dist/types/lib/document/use-document-table-rows.d.ts

@@ -1,21 +0,0 @@
-import { DashboardCardQueryOptions, DashboardCardQueryResult } from '../hooks/use-dashboard-frame-query.js';
-import { TCard } from '../types/common-types.js';
-export type DocumentTableRowsResult = Pick<DashboardCardQueryResult, 'data' | 'pagination' | 'comparisonMetadata' | 'queryRequestPayload' | 'errorSql'> & {
-    records: Record<string, unknown>[];
-    errorMessage: string;
-    isLoading: boolean;
-    isPending: boolean;
-    isFetching: boolean;
-    isPreviewWindowIncomplete: boolean;
-    loadedRowCount: number;
-    totalRowCount?: number;
-    rowDataVersion: string;
-    loadMorePreviewRows?: () => void;
-};
-export declare function useDocumentTableRows({ card, queryOptions, surfaceMode, previewRowLimit, onPreviewRowLimitChange, }: {
-    card: TCard;
-    queryOptions: DashboardCardQueryOptions;
-    surfaceMode: 'preview' | 'print';
-    previewRowLimit?: number;
-    onPreviewRowLimitChange?: (nextRowLimit: number) => void;
-}): DocumentTableRowsResult;

package/dist/types/lib/document/use-measured-document-table-layout.d.ts

@@ -1,50 +0,0 @@
-import { RefObject } from 'react';
-import { DocumentTableSlice } from './document-pagination.js';
-import { DocumentTableLayoutMeasurement } from './document-table-print-model.js';
-export declare function useMeasuredTableLayout({ sectionId, sectionRef, tableSurfaceRef, enabled, measureKey, measurementScale, fallbackRowHeightPx, rowRangeStartIndex, rowRangeEndIndex, totalRowCount, canUpdateLayoutChrome, measureColumnWidths, extraMeasurement, onTableLayoutMeasure, }: {
-    sectionId: string;
-    sectionRef: RefObject<HTMLDivElement | null>;
-    tableSurfaceRef: RefObject<HTMLDivElement | null>;
-    enabled: boolean;
-    measureKey: string;
-    measurementScale: number;
-    /** For a drawn row with no layout box (a test DOM). */
-    fallbackRowHeightPx: number;
-    rowRangeStartIndex: number;
-    rowRangeEndIndex: number;
-    totalRowCount: number;
-    canUpdateLayoutChrome: boolean;
-    /** Report the first drawn row's cell widths (Matrix). */
-    measureColumnWidths?: boolean;
-    /** Reported with the measurement (a Matrix's fit). Keep it stable. */
-    extraMeasurement?: Pick<DocumentTableLayoutMeasurement, 'matrixFit'>;
-    onTableLayoutMeasure?: (sectionId: string, measurement: DocumentTableLayoutMeasurement) => void;
-}): void;
-/**
- * Measures a Matrix printed in column bands (Plan 2, 2c, B2): every band draws
- * every row, inside a `[data-document-matrix-band]` container under
- * `bandsRef`. A row's height is its tallest across the bands, and the chrome
- * is the tallest band's, so a slice of rows fits the page in every band.
- */
-export declare function useMeasuredBandedTableLayout({ sectionId, sectionRef, bandsRef, enabled, measureKey, measurementScale, fallbackRowHeightPx, rowCount, extraMeasurement, onTableLayoutMeasure, }: {
-    sectionId: string;
-    sectionRef: RefObject<HTMLDivElement | null>;
-    bandsRef: RefObject<HTMLDivElement | null>;
-    enabled: boolean;
-    measureKey: string;
-    measurementScale: number;
-    fallbackRowHeightPx: number;
-    rowCount: number;
-    /** Reported with the measurement: widths and the fit. Keep it stable. */
-    extraMeasurement?: Pick<DocumentTableLayoutMeasurement, 'matrixFit' | 'columnWidthsPx'>;
-    onTableLayoutMeasure?: (sectionId: string, measurement: DocumentTableLayoutMeasurement) => void;
-}): void;
-export declare function getMeasurementRowRange({ tableSlice, initialRowsPerPageLimit, totalRowCount, }: {
-    tableSlice?: DocumentTableSlice;
-    initialRowsPerPageLimit?: number;
-    totalRowCount: number;
-}): {
-    startIndex: number;
-    endIndex: number;
-    totalRowCount: number;
-};

package/dist/types/lib/drag-and-drop-utils.d.ts

@@ -1,2 +0,0 @@
-import { AggregateFunction } from './types/explorer-types.js';
-export declare function getAggregationLabel(fieldName: string, aggregation: AggregateFunction): string;

package/dist/types/lib/editor-draft-sync.d.ts

@@ -1,2 +0,0 @@
-export declare function registerPendingEditorDraftFlusher(flush: () => void): () => void;
-export declare function flushPendingEditorDrafts(): void;

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

@@ -1,11 +0,0 @@
-import { DataSource, EntityType, DatabaseEntityReference, DataModelEntityReference } from './types/explorer-types.js';
-interface SelectedEntity {
-    type: EntityType;
-    displayName: string;
-    originalIndex: number;
-    data: DatabaseEntityReference | DataModelEntityReference;
-}
-export declare function dataSourceSummary(dataSourceState: DataSource): {
-    selectedEntities: SelectedEntity[];
-};
-export {};

package/dist/types/lib/export-messages.d.ts

@@ -1,47 +0,0 @@
-/**
- * Every export message the export dialog, its toasts and the notification bell
- * show (MX-D17; PLAN "Customer messages", M1 to M3, M7 and M8 to M18). Plain
- * sentences that say where the export is and what to do: no internal terms,
- * never the product name (white label), no em dashes. A failure reason comes
- * from the server's own catalog.
- */
-export declare const EXPORT_UI_MESSAGES: {
-    /** M1: a direct Matrix CSV attempt is running (the export button, and the line under it). */
-    readonly preparingFile: "Preparing file...";
-    readonly preparingFileHint: "Large tables can take a few seconds.";
-    /** M2: the direct attempt returned the file. */
-    readonly fileDownloading: "Your file is downloading.";
-    /** M3: the direct attempt moved to a background export. */
-    readonly movedToBackground: "We're preparing your export in the background. We'll notify you when it's ready.";
-    /** M7: `reason` is the server's catalog reason. */
-    readonly directFailed: (reason: string) => string;
-    /** M8 */
-    readonly queued: "Queued...";
-    /** M9: a Matrix export before any rows. */
-    readonly preparing: "Preparing...";
-    /** M10: a Matrix export, with its committed row count. */
-    readonly fetchingRows: (rows: number) => string;
-    /** M11: a table export. */
-    readonly processing: "Processing...";
-    readonly percentComplete: (progress: number) => string;
-    readonly rowsProcessed: (rows: number) => string;
-    /** M12 */
-    readonly finalizing: "Finalizing...";
-    /** Every in-progress row; `elapsed` is a distance such as "5 minutes". */
-    readonly started: (elapsed: string) => string;
-    /** M13: still running 5 minutes after it started. */
-    readonly longRunning: "Large exports can take up to 30 minutes. You can keep working; we'll notify you.";
-    /** M14, M15, M16 */
-    readonly ready: "Ready";
-    readonly failed: "Failed";
-    readonly cancelled: "Cancelled";
-    readonly inProgress: "In progress";
-    /** M15 when an older server stored no reason: never only "Export failed". */
-    readonly failedFallback: "Something went wrong while preparing this export. Try again, and contact support if it keeps happening.";
-    /** M17: no final status by the server's deadline plus the grace period. */
-    readonly unconfirmed: "We couldn't confirm this export's status. Check the notification bell again when your connection returns.";
-    /** M18 */
-    readonly linkExpired: "This link expired. Refresh the tray to sign the file again.";
-};
-/** M13 appears this long after an export started. */
-export declare const EXPORT_LONG_RUNNING_MS: number;

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

@@ -1,47 +0,0 @@
-import { TablePreferences } from '../components/visual/data-table/types/data-table.js';
-import { TCard } from './types/common-types.js';
-import { SemaphorResultColumn } from '../shared/analytics-protocol/index.js';
-import { CsvDelimiter, CsvEncoding } from '../shared/format-utils/index.js';
-import { CardNumericPresentationContext } from './formatters/numeric-presentation.js';
-import { ComparisonMetadataMap } from './types/query-types.js';
-import { CardConfig, QueryColumnKeyMap } from './types/explorer-types.js';
-import { FlatTableTotalsByColumnId } from './table-formatting/table-totals-settings.js';
-import { RegularTableTemporalPresentation } from './formatters/regular-table-temporal-presentation.js';
-import { RawTemporalPresentation } from './formatters/raw-temporal-presentation.js';
-type ExportTableOptions = {
-    delimiter?: CsvDelimiter;
-    encoding?: CsvEncoding;
-    includeHeaders?: boolean;
-    useFormattedValues?: boolean;
-    comparisonMetadata?: ComparisonMetadataMap;
-    numericPresentation?: CardNumericPresentationContext;
-    totalsByColumnId?: FlatTableTotalsByColumnId;
-    temporalPresentation?: RegularTableTemporalPresentation;
-    rawTemporalPresentation?: RawTemporalPresentation;
-    effectiveCardConfig?: CardConfig;
-    columnKeyMap?: QueryColumnKeyMap;
-    resultColumns?: readonly SemaphorResultColumn[];
-};
-/** Build a filesystem-safe CSV filename with the export time in UTC. */
-export declare function buildCsvExportFilename(title: string | null | undefined, generatedAt?: Date): string;
-/**
- * The CSV file for plain records (charts and other non-table cards, and the
- * editor's raw download). Columns are the union of record keys in first-seen
- * order, so a record missing a key gets an empty cell.
- */
-export declare function buildRecordsCsv({ records, includeHeaders, delimiter, encoding, }: {
-    records: readonly Record<string, unknown>[];
-    includeHeaders?: boolean;
-    delimiter?: CsvDelimiter;
-    encoding?: CsvEncoding;
-}): string;
-/**
- * Export table data as CSV with column preferences
- */
-export declare function exportTableAsCSV(data: any[], fileName: string, tablePreferences?: TablePreferences, card?: TCard, options?: ExportTableOptions): void;
-/**
- * The CSV file for a Table or Detail Table, or undefined when there is
- * nothing exportable.
- */
-export declare function buildTableCsv(data: any[], tablePreferences?: TablePreferences, card?: TCard, options?: ExportTableOptions): string | undefined;
-export {};

package/dist/types/lib/exports/export-status.d.ts

@@ -1,19 +0,0 @@
-import { ExportJobStatus, ExportJobListItem } from '../api/exports-api.js';
-/** Polling, recovery and notification refresh project the same server facts.
- * Older ordinary list responses omit progress; unknown totals stay unknown. */
-export declare function mapExportStatus(input: ExportJobStatus | ExportJobListItem, downloadUrl?: string): {
-    id: string;
-    status: import('../api/index.js').ExportStatus;
-    progress: number | null;
-    totalRows: number | null;
-    totalChunks: number | null;
-    rowsProcessed: number | undefined;
-    completedChunks: number;
-    completedAt: Date | undefined;
-    lastUpdatedAt: Date;
-    fileSize: number | undefined;
-    error: string | undefined;
-    phase: import('../api/index.js').MatrixExportPhase | undefined;
-    deadlineAt: Date | undefined;
-    downloadUrl: string | undefined;
-};

package/dist/types/lib/fields/field-display.d.ts

@@ -1,35 +0,0 @@
-import { Field } from '../types/explorer-types.js';
-/**
- * The one naming rule for field pickers and field search.
- *
- * Semaphor fields come from two kinds of source. Semantic datasets carry
- * labels and descriptions an author wrote, so those are what people expect
- * to see and search. Raw database objects carry only the column name; the
- * columns hook synthesizes a title-cased `label` for chart headers and
- * records that fact in `derivedLabel`. Pickers show the authored label when
- * one exists and the physical name otherwise, and search matches both, so
- * "Supplier Name" and "counterparty_name" find the same field on every
- * surface.
- *
- * Expression tokens and SQL keep using `name`; that is identity, not display.
- */
-export type FieldDisplaySource = Pick<Field, 'name'> & Partial<Pick<Field, 'label' | 'derivedLabel'>>;
-export type FieldSearchSource = FieldDisplaySource & Partial<Pick<Field, 'description' | 'entityName' | 'qualifiedEntityName' | 'dataType'>>;
-export declare function hasAuthoredFieldLabel(field: FieldDisplaySource): boolean;
-/** Authored label when there is one, otherwise the physical column name. */
-export declare function getFieldDisplayLabel(field: FieldDisplaySource): string;
-/** Case-insensitive sort key that follows the display rule. */
-export declare function getFieldSortKey(field: FieldDisplaySource): string;
-export declare function compareFieldsByDisplayLabel(left: FieldDisplaySource, right: FieldDisplaySource): number;
-/**
- * Lowercase and drop the separators people type interchangeably (space,
- * underscore, hyphen, dot) so "supplier name", "supplier_name" and
- * "SupplierName" all match the same field.
- */
-export declare function normalizeFieldSearchText(value: unknown): string;
-/**
- * Substring match over everything a person might know the field by: the
- * display label, the authored label, the physical name, the description,
- * the owning entity, and the data type. An empty query matches everything.
- */
-export declare function matchesFieldQuery(field: FieldSearchSource, query: string): boolean;

package/dist/types/lib/filter-values/build-card-filter-definition.d.ts

@@ -1,18 +0,0 @@
-import { TFilter } from '../../components/surfboard/filter/types.js';
-import { DataSource, Field } from '../types/explorer-types.js';
-export type CardFilterDefinition = Pick<TFilter, 'column' | 'title' | 'dataType' | 'nativeDataType' | 'qualifiedTableName' | 'connectionId' | 'operation' | 'sql' | 'fieldMeta' | 'semanticContext'> & {
-    table: string;
-    database: string;
-};
-/**
- * The one mapping from an explorer `Field` on a card to the filter
- * definition the filter-values route understands.
- *
- * Used for card inline filters and for browsing values inside the card
- * filter builder, so both read the same catalog coordinates (semantic
- * context, field metadata, qualified table) for the same field.
- */
-export declare function buildCardFilterDefinition(field: Field, source: {
-    dataSource?: DataSource | null;
-    connectionId?: string;
-}): CardFilterDefinition;

package/dist/types/lib/filter-values/build-filter-values-request-payload.d.ts

@@ -1,116 +0,0 @@
-import { TFilter, TFilterValue } from '../../components/surfboard/filter/types.js';
-import { ControlBinding, ControlDefinition } from '../types/common-types.js';
-import { CalendarContext } from '../../shared/report-runtime-context/index.js';
-import { DashboardFilterOptionSource, DashboardOptionContext } from '../../shared/dashboard-authoring/index.js';
-import { SemaphorFieldRef, SemaphorInputBinding, SemaphorSourceRef, NativePredicateSemanticsCandidate } from '../../shared/analytics-protocol/index.js';
-type FilterValuesSearchPayload = {
-    query: string;
-    mode: string;
-};
-type FilterValuesControlPayload = {
-    controlValues: Record<string, unknown>;
-    controlDefinitions: ControlDefinition[];
-    cardControlDefinitions: ControlDefinition[];
-    controlBindings: ControlBinding[];
-};
-type BuildFilterValuesRequestPayloadParams = {
-    filter: TFilter;
-    activeFilters?: TFilterValue[];
-    cacheConfig?: unknown;
-    search?: FilterValuesSearchPayload;
-    /** Defaults to the label field for author-entered search. */
-    optionSearchField?: 'label' | 'value';
-    /** Exact raw values used only to resolve presentation labels. */
-    optionValueLookup?: readonly unknown[];
-    dashboardControlValues?: Record<string, unknown>;
-    dashboardControlDefinitions?: ControlDefinition[];
-    optionSource?: DashboardFilterOptionSource;
-    /**
-     * Explicit dependency policy and peer bindings from Dashboard Inputs.
-     * Standard requests carry it as `optionContext`; governed requests express
-     * it through intent dependencies. Absent for SQL and custom renderers.
-     */
-    optionContext?: DashboardOptionContext;
-    calendarContext: CalendarContext;
-    /**
-     * Exact-value relevance check for retained selections. Sent under the
-     * authored dependency context with no search or paging; see
-     * `SemaphorInputOptionsIntent.matchValues`.
-     */
-    matchValues?: readonly unknown[];
-};
-/**
- * One active peer on the governed dashboard transport. The shared snapshot
- * fields describe identity for grounding; `predicate` carries the native
- * operation and values so null checks and temporal predicates survive, and
- * so a peer without resolvable source identity still reaches the server for
- * classification instead of being dropped client-side.
- */
-type DashboardOptionActiveInput = SemaphorInputBinding & {
-    value: unknown;
-    isActive: true;
-    /** Allowlisted native semantics, unvalidated: the server alone decides
-     * whether they execute, so nothing is dropped on the client. */
-    predicate?: NativePredicateSemanticsCandidate;
-    /** Bounded capability declaration. It can only narrow what the server
-     * will execute: a calculated peer is skipped or rejected, never grounded
-     * as a column. Column-only option sources cannot execute calculated peers. */
-    candidateKind?: 'column' | 'calculated';
-};
-type FilterValuesResponse = {
-    records: Array<Record<string, unknown>>;
-    [key: string]: unknown;
-};
-export declare function normalizeDashboardInputOptionsResponse(response: unknown, optionSource: DashboardFilterOptionSource): FilterValuesResponse;
-export declare function buildFilterValuesControlPayload(params: {
-    filter: TFilter;
-    activeFilters?: TFilterValue[];
-    dashboardControlValues?: Record<string, unknown>;
-    dashboardControlDefinitions?: ControlDefinition[];
-}): FilterValuesControlPayload | undefined;
-export declare function buildFilterValuesRequestPayload(params: BuildFilterValuesRequestPayloadParams): {
-    activeInputs?: DashboardOptionActiveInput[] | undefined;
-    requestKind: "dashboardInputOptions";
-    intent: {
-        dependencies?: import('../../shared/analytics-protocol/index.js').SemaphorOptionDependencies | undefined;
-        inputs?: SemaphorInputBinding[] | undefined;
-        limit: number;
-        matchValues?: unknown[] | undefined;
-        searchField?: SemaphorFieldRef;
-        search?: string | undefined;
-        population?: import('../../shared/analytics-protocol/index.js').SemaphorOptionPopulation | undefined;
-        source: Extract<SemaphorSourceRef, {
-            kind: "semantic" | "physical";
-        }>;
-        labelField: SemaphorFieldRef;
-        valueField: SemaphorFieldRef;
-        disambiguationFields?: SemaphorFieldRef[];
-        kind: "inputOptions";
-        inputId: string;
-    };
-} | {
-    controlValues?: Record<string, unknown> | undefined;
-    controlDefinitions?: ControlDefinition[] | undefined;
-    cardControlDefinitions?: ControlDefinition[] | undefined;
-    controlBindings?: ControlBinding[] | undefined;
-    cache_config: unknown;
-    calendarContext: CalendarContext;
-    optionContext?: DashboardOptionContext | undefined;
-    active_filters: TFilterValue[] | undefined;
-    match_values?: unknown[] | undefined;
-    search?: FilterValuesSearchPayload | undefined;
-    filter: {
-        sql: string;
-        fieldMeta: import('../../components/surfboard/filter/types.js').FilterFieldMeta | undefined;
-        semanticContext: import('../../components/surfboard/filter/types.js').FilterSemanticContext | undefined;
-        nativeDataType?: string | undefined;
-        id: string;
-        connectionId: string;
-        column: string;
-        table: string | undefined;
-        database: string | undefined;
-        qualifiedTableName: string | undefined;
-        dataType: string;
-    };
-};
-export {};

package/dist/types/lib/filter-values/filter-option-identity.d.ts

@@ -1,10 +0,0 @@
-import { FilterOptionValue } from '../../components/surfboard/filter/types.js';
-/**
- * Stable identity for raw filter-option values.
- *
- * Values that render alike can still have different predicate semantics, so
- * identity retains the runtime scalar type. Numeric `1` and string `"1"` are
- * therefore different options throughout hydration, selection, and rendering.
- */
-export declare function getFilterOptionValueIdentity(value: FilterOptionValue): string;
-export declare function filterOptionValuesEqual(left: FilterOptionValue, right: FilterOptionValue): boolean;

package/dist/types/lib/filter-values/filter-record-value.d.ts

@@ -1,9 +0,0 @@
-import { TFilter, TSelectedRecord } from '../../components/surfboard/filter/types.js';
-/**
- * Resolve the option value from a filter-values record.
- *
- * Shared by the viewer option hooks and authoring default-value pickers so
- * both read records with identical column-name fallbacks (quoted, lower-case,
- * semantic field, title, generic `value` / `label`).
- */
-export declare function getFilterRecordValue(record: Record<string, unknown>, filter: TFilter, preferredFieldName?: string): TSelectedRecord['value'] | undefined;

package/dist/types/lib/filter-values/merge-additional-filter-values.d.ts

@@ -1,12 +0,0 @@
-import { TFilterValue } from '../../components/surfboard/filter/types.js';
-/**
- * Fold surface-supplied sibling values (editor draft inline values) into the
- * context's values. A supplied value replaces the context's value for the
- * same filter so a draft edit wins over the last saved state; the target's
- * own value never arrives through this channel.
- */
-export declare function mergeAdditionalFilterValues(params: {
-    base: readonly TFilterValue[];
-    additional: readonly TFilterValue[] | undefined;
-    excludeFilterId: string;
-}): TFilterValue[];

package/dist/types/lib/formatters/active-numeric-presentation.d.ts

@@ -1,25 +0,0 @@
-import { CurrencyPresentationTarget, TCard } from '../types/common-types.js';
-import { PersistedColumnSettings } from '../../components/visual/data-table/types/data-table.js';
-import { DetailField, MetricField } from '../types/explorer-types.js';
-import { CanonicalFormatSpec } from '../../shared/format-utils/types/index.js';
-export type ActiveKpiNumericPresentation = {
-    target?: CurrencyPresentationTarget;
-    authoredFormat?: CanonicalFormatSpec;
-    currencyBindable: boolean;
-};
-export type ActiveFieldNumericPresentation = {
-    authoredFormat?: CanonicalFormatSpec;
-    currencyBindable: boolean;
-};
-export type ActiveChartMetricNumericPresentation = ActiveFieldNumericPresentation & {
-    source?: 'semantic' | 'number_axis' | 'legacy' | 'inferred';
-};
-export declare function isCurrencyBindableCanonicalFormat(format: CanonicalFormatSpec | undefined): boolean;
-export declare function hasExplicitSqlNumericIntent(settings: PersistedColumnSettings | undefined): boolean;
-export declare function isSqlColumnCurrencyBindable(settings: PersistedColumnSettings | undefined): boolean;
-export declare function resolveActiveFieldNumericPresentation(field: Pick<MetricField | DetailField, 'dataType' | 'format'>, settings: PersistedColumnSettings | undefined): ActiveFieldNumericPresentation;
-export declare function resolveActiveChartMetricNumericPresentation(card: TCard, metric: Pick<MetricField, 'dataType' | 'format'>): ActiveChartMetricNumericPresentation;
-export declare function resolveActiveKpiNumericPresentation(card: TCard, options?: {
-    metricIndex?: number;
-    resultColumnKey?: string;
-}): ActiveKpiNumericPresentation;

package/dist/types/lib/formatters/card-format-context.d.ts

@@ -1,14 +0,0 @@
-import { TCard } from '../types/common-types.js';
-import { CanonicalFormatSpec } from './canonical-format-adapter.js';
-import { ResolvedValueFormatPreferences } from '../../shared/value-format-preferences/index.js';
-export type CardFormatContext = {
-    currency?: string;
-    locale: string;
-    canonicalPrimaryFormat?: CanonicalFormatSpec;
-    isFormattingDisabled: boolean;
-};
-export declare function resolveCardFormatContext({ card, preferences, boundCurrency, }: {
-    card?: TCard;
-    preferences?: ResolvedValueFormatPreferences | null;
-    boundCurrency?: string;
-}): CardFormatContext;