react-semaphor 0.1.504 → 0.1.505

package/dist/types/lib/document/document-section-utils.d.ts

@@ -0,0 +1,11 @@
+import { LucideIcon } from 'lucide-react';
+import { DocumentInputDefinition, DocumentSection } from '../types/common-types.js';
+export type DocumentSectionType = DocumentSection['type'];
+export type AddableDocumentSectionType = Exclude<DocumentSectionType, 'chart'>;
+export declare const DOCUMENT_SECTION_LABELS: Record<DocumentSectionType, string>;
+export declare const ADDABLE_DOCUMENT_SECTION_TYPES: AddableDocumentSectionType[];
+export declare function documentSectionIcon(type: DocumentSectionType): LucideIcon;
+export declare function createDocumentSection(type: AddableDocumentSectionType): DocumentSection;
+export declare function getDocumentSectionLabel(section: DocumentSection, inputs: DocumentInputDefinition[]): string;
+export declare function getDocumentSectionTitle(section: DocumentSection, inputs: DocumentInputDefinition[]): string;
+export declare function getDocumentSectionSubtitle(section: DocumentSection): string | null;

package/dist/types/lib/document/document-sheet-utils.d.ts

@@ -0,0 +1,4 @@
+import { TSheet } from '../types/common-types.js';
+export declare function isDocumentSheet(sheet: Pick<TSheet, 'kind'> | null | undefined): boolean;
+export declare function getDashboardSheets<T extends Pick<TSheet, 'kind'>>(sheets: T[] | null | undefined): T[];
+export declare const getDashboardExportSheets: typeof getDashboardSheets;

package/dist/types/lib/document/document-table-data-policy.d.ts

@@ -0,0 +1,15 @@
+import { TCard } from '../types/common-types.js';
+export type DocumentTableDataPolicy = 'preview-window' | 'export-full-with-cap';
+export declare const DOCUMENT_TABLE_EXPORT_MAX_ROWS = 10000;
+export declare const DOCUMENT_TABLE_EXPORT_QUERY_CHUNK_SIZE = 500;
+export declare const DOCUMENT_TABLE_PREVIEW_QUERY_CHUNK_SIZE = 250;
+export declare function isDocumentFlatTableAcquisitionCard(card: TCard): boolean;
+export declare function isDocumentSqlTablePaginationEnabled(card: TCard): boolean;
+export declare function getDocumentTableQueryPageSize(policy: DocumentTableDataPolicy): 500 | 250;
+export declare function shouldUseServerPaginationForDashboardCardQuery({ card, isTablePrintMode, isPrintDisplayMode, isDocumentSectionRuntime, documentTableDataPolicy, }: {
+    card: TCard;
+    isTablePrintMode: boolean;
+    isPrintDisplayMode: boolean;
+    isDocumentSectionRuntime: boolean;
+    documentTableDataPolicy?: DocumentTableDataPolicy;
+}): boolean;

package/dist/types/lib/document/document-table-dom.d.ts

@@ -0,0 +1,31 @@
+export declare function getDocumentTableMeasuredRowElements(tableSurfaceElement: HTMLElement): HTMLElement[];
+export declare function getDocumentTableMeasuredChromeMetrics({ sectionElement, tableSurfaceElement, firstRowElement, lastRowElement, measurementScale, }: {
+    sectionElement: HTMLElement;
+    tableSurfaceElement?: HTMLElement;
+    firstRowElement: HTMLElement;
+    lastRowElement: HTMLElement;
+    measurementScale: number;
+}): {
+    renderedMinHeightPx?: number | undefined;
+    chromeHeightPx: number;
+    trailingChromePx: number;
+};
+export declare function getDocumentPageElement(element: HTMLElement | null): HTMLElement | null;
+export declare function getDocumentPageFooterElement(pageElement: HTMLElement | null): HTMLElement | null;
+export declare function getIntendedDocumentPageBoxHeightPx(pageElement: HTMLElement): number;
+export declare function getDocumentPageBodyBoundaryPx(pageElement: HTMLElement): number;
+export declare function hasMaterialTableLayoutMeasurementChange(previousMeasurement: {
+    rowHeightPx: number;
+    averageRowHeightPx?: number;
+    rowHeightsPx?: Array<number | undefined>;
+    chromeHeightPx: number;
+    renderedMinHeightPx?: number;
+    rowsPerPage?: number;
+} | null, nextMeasurement: {
+    rowHeightPx: number;
+    averageRowHeightPx?: number;
+    rowHeightsPx?: Array<number | undefined>;
+    chromeHeightPx: number;
+    renderedMinHeightPx?: number;
+    rowsPerPage?: number;
+}): boolean;

package/dist/types/lib/document/document-table-pagination-model.d.ts

@@ -0,0 +1,67 @@
+import { DocumentTableLayoutMeasurement } from './document-table-print-model.js';
+export type DocumentTableRowMeasurementState = {
+    kind: 'unmeasured';
+    totalRowCount: number;
+    fallbackRowHeightPx: number;
+} | {
+    kind: 'uniform';
+    totalRowCount: number;
+    fallbackRowHeightPx: number;
+    measuredRowHeightPx: number;
+    measuredAverageRowHeightPx?: number;
+} | {
+    kind: 'sparse';
+    totalRowCount: number;
+    fallbackRowHeightPx: number;
+    measuredRowHeightPx: number;
+    measuredAverageRowHeightPx?: number;
+    rowHeightsPx: Array<number | undefined>;
+} | {
+    kind: 'complete';
+    totalRowCount: number;
+    fallbackRowHeightPx: number;
+    measuredRowHeightPx: number;
+    measuredAverageRowHeightPx?: number;
+    rowHeightsPx: number[];
+};
+export declare function getDocumentTableRowMeasurementState({ totalRowCount, fallbackRowHeightPx, layoutMeasurement, }: {
+    totalRowCount: number;
+    fallbackRowHeightPx: number;
+    layoutMeasurement?: DocumentTableLayoutMeasurement;
+}): DocumentTableRowMeasurementState;
+export declare function mergeDocumentTableLayoutMeasurement(existing: DocumentTableLayoutMeasurement | undefined, measurement: DocumentTableLayoutMeasurement): DocumentTableLayoutMeasurement;
+export declare function getDocumentTableResolvedRowHeightPx(rowMeasurementState: DocumentTableRowMeasurementState, rowIndex: number): number;
+export declare function getDocumentTableRowsHeightPx({ rowMeasurementState, startIndex, endIndex, }: {
+    rowMeasurementState: DocumentTableRowMeasurementState;
+    startIndex: number;
+    endIndex: number;
+}): number;
+export declare function getDocumentTableRenderedSliceHeightPx({ rowMeasurementState, startIndex, endIndex, chromeHeightPx, renderedMinHeightPx, }: {
+    rowMeasurementState: DocumentTableRowMeasurementState;
+    startIndex: number;
+    endIndex: number;
+    chromeHeightPx: number;
+    renderedMinHeightPx?: number;
+}): number;
+export declare function getDocumentTableGeneratedSliceHeightPx({ rowMeasurementState, startIndex, endIndex, chromeHeightPx, }: {
+    rowMeasurementState: DocumentTableRowMeasurementState;
+    startIndex: number;
+    endIndex: number;
+    chromeHeightPx: number;
+}): number;
+export declare function getDocumentTableRowsThatFit({ rowMeasurementState, startIndex, availableHeightPx, }: {
+    rowMeasurementState: DocumentTableRowMeasurementState;
+    startIndex: number;
+    availableHeightPx: number;
+}): number;
+export declare function getDocumentTableEffectiveRowHeightFromState(rowMeasurementState: DocumentTableRowMeasurementState): number;
+export declare function shouldReportDocumentTableLayoutMeasurement(_options: {
+    tableSlice?: {
+        pageIndex: number;
+    } | undefined;
+}): boolean;
+export declare function canUpdateDocumentTableLayoutChrome({ tableSlice, }: {
+    tableSlice?: {
+        pageIndex: number;
+    } | undefined;
+}): boolean;

package/dist/types/lib/document/document-table-print-model.d.ts

@@ -0,0 +1,52 @@
+import { DOCUMENT_TABLE_PRINT_RENDER_CONTRACT } from './document-visual-render-contract.js';
+import { DocumentTableSection } from '../types/common-types.js';
+export declare const DOCUMENT_TABLE_DEFAULT_ROW_HEIGHT_PX = 40;
+export declare const DOCUMENT_TABLE_MIN_MEASURED_ROW_HEIGHT_PX = 18;
+export declare const DOCUMENT_TABLE_MIN_RENDERED_SURFACE_HEIGHT_PX = 120;
+export type DocumentTablePrintKind = 'table' | 'pivotTable';
+export type DocumentTableLayoutMeasurement = {
+    rowHeightPx: number;
+    averageRowHeightPx?: number;
+    rowHeightsPx?: Array<number | undefined>;
+    rowRangeStartIndex?: number;
+    rowRangeEndIndex?: number;
+    totalRowCount?: number;
+    chromeHeightPx: number;
+    renderedMinHeightPx?: number;
+    canUpdateLayoutChrome?: boolean;
+    rowsPerPage?: number;
+};
+export type DocumentTablePrintModel = {
+    sectionId: string;
+    kind: DocumentTablePrintKind | 'unsupported';
+    isSupported: boolean;
+    hasConnection: boolean;
+    hasRunnableQuery: boolean;
+    isRunnable: boolean;
+    totalRowCount: number;
+    bodyRowCount: number;
+    trailingRowCount: number;
+    visibleTotalsColumnIds: string[];
+    fallbackRowHeightPx: number;
+    measuredRowHeightPx?: number;
+    measuredAverageRowHeightPx?: number;
+    measuredRowHeightsPx?: Array<number | undefined>;
+    effectiveRowHeightPx: number;
+    chromeHeightPx?: number;
+    renderedMinHeightPx?: number;
+    measuredRowsPerPage?: number;
+    renderContract: typeof DOCUMENT_TABLE_PRINT_RENDER_CONTRACT;
+};
+export declare function getDocumentTablePrintModel({ section, totalRowCount, layoutMeasurement, }: {
+    section: DocumentTableSection;
+    totalRowCount?: number;
+    layoutMeasurement?: DocumentTableLayoutMeasurement;
+}): DocumentTablePrintModel;
+export declare function hasDocumentFlatTableTotalsRow(section: DocumentTableSection): boolean;
+export declare function getDocumentTableFallbackRowHeightPx(section: DocumentTableSection): number;
+export declare function getDocumentTableEffectiveRowHeightPx({ fallbackRowHeightPx, measuredRowHeightPx, measuredRowHeightsPx, totalRowCount, }: {
+    fallbackRowHeightPx: number;
+    measuredRowHeightPx?: number;
+    measuredRowHeightsPx?: Array<number | undefined>;
+    totalRowCount?: number;
+}): number;

package/dist/types/lib/document/document-table-result-columns.d.ts

@@ -0,0 +1,10 @@
+import { DocumentSection, DocumentTableSection } from '../types/common-types.js';
+import { QueryColumnKeyMap } from '../types/explorer-types.js';
+export type DocumentTableResultColumnCacheEntry = {
+    schemaSignature: string;
+    columns: string[];
+    columnKeyMap?: QueryColumnKeyMap;
+};
+export type DocumentTableResultColumnsChange = (sectionId: string, columns: string[], schemaSignature: string, columnKeyMap?: QueryColumnKeyMap) => void;
+export declare function getDocumentTableResultColumns(records: Record<string, unknown>[]): string[];
+export declare function getDocumentTableResultColumnSchemaSignature(section: DocumentSection | DocumentTableSection): string;

package/dist/types/lib/document/document-table-style.d.ts

@@ -0,0 +1,33 @@
+import { TableDensity } from '../../components/visual/data-table/types/data-table.js';
+import { DocumentTableSection } from '../types/common-types.js';
+import { getTableTotalsBorderTopWidthValue, getTableTotalsFontWeightValue, ResolvedTablePresentationStyle } from '../table-formatting/table-presentation-style.js';
+export declare const DOCUMENT_TABLE_DENSITY_OPTIONS: readonly ["spacious", "comfortable", "standard", "compact", "dense"];
+export declare const DOCUMENT_TABLE_HEADER_STYLE_OPTIONS: readonly ["plain", "filled", "accent"];
+export declare const DOCUMENT_TABLE_GRID_LINE_OPTIONS: readonly ["full", "outer", "inner", "horizontal", "vertical", "top", "right", "bottom", "left", "none"];
+export declare const DOCUMENT_TABLE_DEFAULT_STYLE: {
+    density: "compact";
+    headerStyle: "filled";
+    headerBackgroundColor: undefined;
+    headerTextColor: undefined;
+    headerWrapText: false;
+    stripedRows: false;
+    gridLines: "horizontal";
+    wrapText: false;
+};
+export declare const DOCUMENT_TABLE_TOTALS_FONT_WEIGHT_OPTIONS: readonly ["normal", "medium", "semibold", "bold"];
+export declare const DOCUMENT_TABLE_DEFAULT_TOTALS_STYLE: {
+    enabled: false;
+    backgroundColor: string;
+    textColor: string;
+    fontWeight: "medium";
+    borderTop: true;
+    borderTopStyle: "solid";
+    borderTopColor: string;
+};
+export type ResolvedDocumentTableStyle = ResolvedTablePresentationStyle;
+export declare function resolveDocumentTableStyle(section: DocumentTableSection): ResolvedDocumentTableStyle;
+export declare function getDocumentTableStyleMeasureKey(style: ResolvedDocumentTableStyle): string;
+export declare const getDocumentTableTotalsFontWeightValue: typeof getTableTotalsFontWeightValue;
+export declare const getDocumentTableTotalsBorderTopWidthValue: typeof getTableTotalsBorderTopWidthValue;
+export declare function getDocumentTableDensityRowHeightPx(density: TableDensity): number;
+export declare function getDocumentTableAuthoredRowHeightPx(section: DocumentTableSection): number;

package/dist/types/lib/document/document-table-totals.d.ts

@@ -0,0 +1,8 @@
+import { TCard } from '../types/common-types.js';
+import { TableTotalsRequest } from '../types/explorer-types.js';
+export declare function isEligibleDocumentFlatTableTotalsCard(card: TCard): boolean;
+export declare function getDocumentFlatTableTotalsRenderColumnIds(card: TCard): string[];
+export declare function applyDocumentFlatTableTotalsDefaults<TCardLike extends TCard>(card: TCardLike): TCardLike;
+export declare function buildDocumentFlatTableTotalsRequest(card: TCard): TableTotalsRequest | undefined;
+export declare function documentFlatTableTotalsRequestRequiresBackend(request: TableTotalsRequest | undefined): boolean;
+export declare function removeFlatTableTotalsRowFromCard<TCardLike extends TCard>(card: TCardLike): TCardLike;

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

@@ -0,0 +1,59 @@
+import { TFilterValue } from '../../components/surfboard/filter/types.js';
+import { ControlOption, DocumentInputDefinition, DocumentTextInlineFormat, DocumentTextContent, DocumentVariableRef, ResolvedDocumentInput } from '../types/common-types.js';
+export type DocumentTextRenderContext = {
+    inputs: DocumentInputDefinition[];
+    resolvedInputsById: Record<string, ResolvedDocumentInput>;
+    meta: {
+        generatedAt: string;
+        pageNumber: number;
+        pageCount: number;
+    };
+    timezone?: string;
+    generatedAtFormat?: string;
+};
+export type DocumentVariableChoice = {
+    label: string;
+    token: string;
+    ref: DocumentVariableRef;
+};
+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;
+};
+export declare function parseDocumentTextContent(value: string, inputs: DocumentInputDefinition[]): ParsedDocumentTextContent;
+export declare function parseDocumentTextContentWithSource(value: string, inputs: DocumentInputDefinition[]): ParsedDocumentTextContentWithSource;
+export declare function getDocumentVariableChoices(inputs: DocumentInputDefinition[]): DocumentVariableChoice[];
+export declare function appendDocumentVariable(content: DocumentTextContent | undefined, ref: DocumentVariableRef): DocumentTextContent;
+export declare function getDocumentVariableLabel(ref: DocumentVariableRef, inputs: DocumentInputDefinition[]): string;
+export declare function buildDocumentTextRenderContext({ inputs, filterValuesByInputId, controlValuesByInputId, controlOptionsByInputId, generatedAt, timezone, generatedAtFormat, pageNumber, pageCount, }: {
+    inputs: DocumentInputDefinition[];
+    filterValuesByInputId: Record<string, TFilterValue | undefined>;
+    controlValuesByInputId: Record<string, unknown>;
+    controlOptionsByInputId?: Record<string, ControlOption[]>;
+    generatedAt: string;
+    timezone?: string;
+    generatedAtFormat?: string;
+    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

@@ -0,0 +1,8 @@
+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-table-rows.d.ts

@@ -0,0 +1,21 @@
+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/download-pdf.d.ts

@@ -0,0 +1,104 @@
+import { TFilterValue } from '../components/surfboard/filter/types.js';
+import { AuthToken, ControlBinding, ControlDefinition, DashboardInputExecutionSnapshot, DocumentInputRuntimeValues } from './types/common-types.js';
+import { TChartType } from './charts/types.js';
+import { FastPathTableStructure } from '../shared/format-utils/table-structure.js';
+import { PresentationExecutionSnapshot } from '../shared/format-utils/index.js';
+import { InteractionState } from './types/interaction-types.js';
+import { buildMatrixDeliveryPayload } from './matrix-table/matrix-delivery.js';
+export type MatrixPdfCapture = ReturnType<typeof buildMatrixDeliveryPayload>;
+export type DashboardParams = {
+    authToken: AuthToken;
+    theme: string;
+    filterValues: TFilterValue[];
+    defaultControlValues: Record<string, unknown>;
+    controlDefinitions?: ControlDefinition[];
+    dashboardTitle: string;
+    cardTitle?: string;
+    selectedSheetId?: string;
+    dashboardId: string;
+    dashboardInputExecutionSnapshot?: DashboardInputExecutionSnapshot;
+    interactionExecutionSnapshot?: Record<string, InteractionState>;
+    presentationExecutionSnapshot: PresentationExecutionSnapshot;
+    timezone?: string;
+};
+export type VisualPdfParams = {
+    authToken: AuthToken;
+    theme: string;
+    filterValues: TFilterValue[];
+    defaultControlValues: Record<string, unknown>;
+    controlDefinitions?: ControlDefinition[];
+    cardControlDefinitions?: ControlDefinition[];
+    controlBindings?: ControlBinding[];
+    selectedSheetId?: string;
+    cardId: string;
+    frameId: string;
+    cardTitle: string;
+    dashboardId: string;
+    dashboardInputExecutionSnapshot?: DashboardInputExecutionSnapshot;
+    interactionExecutionSnapshot?: Record<string, InteractionState>;
+    presentationExecutionSnapshot: PresentationExecutionSnapshot;
+    timezone?: string;
+};
+type VisualPrintRuntimeOverrides = {
+    filterValues?: TFilterValue[];
+};
+export type LayoutApplied = {
+    requestedPageSize?: string;
+    requestedOrientation?: string;
+    effectivePageSize?: string;
+    effectiveOrientation?: string;
+    usedBanding?: boolean;
+    bandCount?: number;
+    totalColumns?: number;
+    anchorColumns?: string[];
+    autoAdjustedLayout?: boolean;
+    strategyApplied?: string;
+};
+export type PdfDownloadResponse = {
+    url?: string;
+    layoutApplied?: LayoutApplied | null;
+    error?: string;
+};
+export declare const PDF_DOWNLOAD_ERROR_DESCRIPTION_CLASSNAME = "max-h-[12.5rem] min-w-0 max-w-full overflow-x-hidden overflow-y-auto whitespace-pre-wrap break-words pr-2 [overflow-wrap:anywhere]";
+export declare function getPdfDownloadErrorMessage(error: unknown, fallback?: string): string;
+export declare function appendControlContractParams(urlParams: URLSearchParams, params: {
+    controlDefinitions?: ControlDefinition[];
+    cardControlDefinitions?: ControlDefinition[];
+    controlBindings?: ControlBinding[];
+}): void;
+export declare function getDashboardParamsForPrint(authToken: AuthToken | undefined, options?: {
+    selectedSheetId?: string | null;
+    sheetSelection?: 'current' | 'all';
+}): DashboardParams;
+export declare function getParamsForPrint(authToken: AuthToken | undefined, sheetSelection?: 'current' | 'all'): DashboardParams;
+export declare function downloadPdf(apiServiceUrl: string, authToken: AuthToken | undefined, password?: string, sheetSelection?: 'current' | 'all', expandedState?: Record<string, boolean>): Promise<void>;
+export declare function downloadDocumentPdf(apiServiceUrl: string, authToken: AuthToken | undefined, options: {
+    sheetId: string;
+    title: string;
+    pageSize: string;
+    orientation: string;
+    inputSnapshot?: DashboardInputExecutionSnapshot;
+    inputValues?: DocumentInputRuntimeValues;
+    timezone?: string;
+    password?: string;
+}): Promise<void>;
+export declare function getVisualParamsForPrint(authToken: AuthToken | undefined, cardId: string, frameId: string, cardTitle: string, overrides?: VisualPrintRuntimeOverrides): VisualPdfParams;
+export declare function downloadVisualPdf(apiServiceUrl: string, authToken: AuthToken | undefined, cardId: string, frameId: string, cardTitle: string, cardChartType?: TChartType, password?: string, pageSize?: string, orientation?: string, filterLine?: string, filterValues?: TFilterValue[], expandedState?: Record<string, boolean>, matrix?: MatrixPdfCapture): Promise<void>;
+export declare function downloadVisualPdfWithResponse(apiServiceUrl: string, authToken: AuthToken | undefined, cardId: string, frameId: string, cardTitle: string, cardChartType?: TChartType, password?: string, pageSize?: string, orientation?: string, filterLine?: string, filterValues?: TFilterValue[], expandedState?: Record<string, boolean>, matrix?: MatrixPdfCapture): Promise<PdfDownloadResponse | undefined>;
+type FastPathOptions = {
+    password?: string;
+    pageSize?: string;
+    orientation?: string;
+    filterLine?: string;
+    tableStructure?: FastPathTableStructure | null;
+    filterValues?: TFilterValue[];
+    wideTableStrategy?: 'auto' | 'fit' | 'horizontal_paginate';
+};
+export declare function downloadMatrixPdf(apiServiceUrl: string, authToken: AuthToken | undefined, capture: MatrixPdfCapture, options?: Pick<FastPathOptions, 'password' | 'pageSize' | 'orientation' | 'filterLine'>): Promise<PdfDownloadResponse>;
+/** Open the governed PDF in the browser's print viewer, never capture a viewport. */
+export declare function openMatrixPrintPdf(apiServiceUrl: string, authToken: AuthToken | undefined, capture: MatrixPdfCapture, options?: Pick<FastPathOptions, 'password' | 'pageSize' | 'orientation' | 'filterLine'>): Promise<void>;
+export declare function tryDownloadVisualPdfFastPath(apiServiceUrl: string, authToken: AuthToken | undefined, cardId: string, frameId: string, cardTitle: string, cardChartType: TChartType, options?: FastPathOptions): Promise<{
+    success: boolean;
+    layoutApplied?: LayoutApplied | null;
+}>;
+export {};

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

@@ -0,0 +1,2 @@
+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

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

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

@@ -0,0 +1,9 @@
+interface EncryptionResult {
+    payload: string;
+}
+export declare function encryptWithJwtSalt(data: string, accessToken: string): Promise<EncryptionResult>;
+interface DecryptionResult {
+    decryptedData: string;
+}
+export declare function decryptWithJwtSalt(encryptedData: string, accessToken: string): Promise<DecryptionResult>;
+export {};

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

@@ -0,0 +1,11 @@
+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-utils.d.ts

@@ -0,0 +1,45 @@
+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 { 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?: string;
+    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;
+/**
+ * Export table data as CSV with column preferences
+ */
+export declare function exportTableAsCSV(data: any[], fileName: string, tablePreferences?: TablePreferences, card?: TCard, options?: ExportTableOptions): void;
+/**
+ * Export table data with aggregations (for aggregated tables)
+ */
+export declare function exportAggregatedTableAsCSV(data: any[], fileName: string, groupByColumns?: string[], metricColumns?: string[], options?: {
+    delimiter?: string;
+    includeHeaders?: boolean;
+    includeSubtotals?: boolean;
+    includeGrandTotal?: boolean;
+}): void;
+/**
+ * Export pivot table as CSV
+ */
+export declare function exportPivotTableAsCSV(data: any[], fileName: string, rowHeaders?: string[], columnHeaders?: string[], options?: {
+    delimiter?: string;
+    includeHeaders?: boolean;
+}): void;
+export {};

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

@@ -0,0 +1,17 @@
+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;
+    downloadUrl: string | undefined;
+};

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

@@ -0,0 +1,35 @@
+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

@@ -0,0 +1,18 @@
+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;