react-semaphor 0.1.533 → 0.1.534

package/dist/types/lib/formatters/currency-presentation-binding.d.ts

@@ -1,72 +0,0 @@
-import { ControlBinding, ControlDefinition, CurrencyPresentationTarget, SqlQueryControlSource, TCard, TDashboard } from '../types/common-types.js';
-import { MatrixConfig } from '../../shared/analytics-protocol/index.js';
-import { MatrixCardCatalog } from '../matrix-table/matrix-card-adapter.js';
-import { DetailField, MetricField } from '../types/explorer-types.js';
-export type CurrencyBindingDiagnosticCode = 'invalid_binding_shape' | 'missing_control' | 'invalid_control_type' | 'invalid_currency_option' | 'invalid_control_default' | 'missing_target' | 'stale_target' | 'inapplicable_target';
-export type CurrencyBindingDiagnostic = {
-    code: CurrencyBindingDiagnosticCode;
-    controlId?: string;
-};
-export declare function getCardCurrencyPresentationFields(card: TCard): Array<MetricField | DetailField>;
-export declare function getDashboardPresentationCurrencyControlIds(dashboard: Pick<TDashboard, 'sheets'>): Set<string>;
-export declare function getCardCurrencyPresentationTargets(card: TCard, resultColumnKeys?: readonly string[], matrixCatalog?: MatrixCardCatalog): {
-    knownTargets: CurrencyPresentationTarget[];
-    eligibleTargets: CurrencyPresentationTarget[];
-};
-export declare function getPrimaryKpiCurrencyPresentationTarget(card: TCard, resultColumnKey?: string): CurrencyPresentationTarget | undefined;
-export declare function getTableCurrencyPresentationTarget(params: {
-    card: TCard;
-    columnKey: string;
-    metricId?: string;
-}): CurrencyPresentationTarget | undefined;
-export declare function currencyPresentationTargetKey(target: CurrencyPresentationTarget): string;
-export declare function isPresentationCurrencyBinding(binding: ControlBinding): binding is Extract<ControlBinding, {
-    target: 'presentation_currency';
-}>;
-export declare function isStructuralControlBinding(binding: ControlBinding): binding is Exclude<ControlBinding, {
-    target: 'sql_param' | 'presentation_currency';
-}>;
-type ValidCurrencyPresentationControl = ControlDefinition & {
-    source: Extract<ControlDefinition['source'], {
-        kind: 'manual';
-    }>;
-};
-export declare function isCurrencyPresentationControl(control: ControlDefinition): control is ValidCurrencyPresentationControl;
-type QueryRelevantDashboardControlContextParams = {
-    dashboard: Pick<TDashboard, 'sheets'>;
-    definitions?: ControlDefinition[];
-    values?: Record<string, unknown>;
-};
-type QueryRelevantDashboardControlContext = {
-    definitions: ControlDefinition[];
-    values: Record<string, unknown>;
-};
-export declare function getFilterQueryRelevantDashboardControlContext(params: QueryRelevantDashboardControlContextParams & {
-    filterSql?: string;
-}): QueryRelevantDashboardControlContext;
-export declare function getControlSourceQueryRelevantDashboardControlContext(params: QueryRelevantDashboardControlContextParams & {
-    source?: Pick<SqlQueryControlSource, 'sql'>;
-}): QueryRelevantDashboardControlContext;
-export declare function diagnoseCurrencyPresentationBindings(params: {
-    bindings?: ControlBinding[];
-    controls?: ControlDefinition[];
-    knownTargets: CurrencyPresentationTarget[];
-    eligibleTargets: CurrencyPresentationTarget[];
-}): CurrencyBindingDiagnostic[];
-export declare function resolveBoundPresentationCurrency(params: {
-    bindings?: ControlBinding[];
-    controls?: ControlDefinition[];
-    values?: Record<string, unknown>;
-    target: CurrencyPresentationTarget;
-    knownTargets: CurrencyPresentationTarget[];
-    eligibleTargets: CurrencyPresentationTarget[];
-}): {
-    currency?: string;
-    diagnostics: CurrencyBindingDiagnostic[];
-};
-/** Materialize presentation-only choices before query projection removes them. */
-export declare function resolveMatrixCurrencyPresentation(card: TCard, config: MatrixConfig, context: {
-    controls: ControlDefinition[];
-    values: Record<string, unknown>;
-}, catalog: MatrixCardCatalog): MatrixConfig['presentation'];
-export {};

package/dist/types/lib/formatters/dashboard-temporal-presentation.d.ts

@@ -1,10 +0,0 @@
-import { resolveDashboardTemporalActivation } from './grouped-temporal-activation.js';
-import { resolveGroupedTemporalPresentation } from './grouped-temporal-presentation.js';
-import { TemporalResultOwner } from '../../shared/dashboard-authoring/index.js';
-export declare function resolveDashboardTemporalPresentation(input: Omit<Parameters<typeof resolveGroupedTemporalPresentation>[0], 'activation'>): import('./grouped-temporal-presentation.js').GroupedTemporalPresentation;
-export declare function isDashboardTemporalResultCompatible(input: {
-    card: Parameters<typeof resolveDashboardTemporalActivation>[0]['card'];
-    cardConfig?: Parameters<typeof resolveDashboardTemporalActivation>[0]['cardConfig'];
-    result: unknown;
-    expectedResultOwner?: TemporalResultOwner;
-}): boolean;

package/dist/types/lib/formatters/grouped-temporal-authoring.d.ts

@@ -1,33 +0,0 @@
-import { SemaphorTimeGrain } from '../../shared/analytics-protocol/index.js';
-import { getTemporalBucketAuthoringSelection } from '../../shared/dashboard-authoring/temporal-bucket-authoring.js';
-import { readSavedTemporalBucketFormat, SavedTemporalFormatInput } from './saved-temporal-bucket-format.js';
-type SemanticTemporalAuthoringPresentation = {
-    granularity?: unknown;
-    format?: unknown;
-};
-export type TemporalBucketAuthoringInput = SavedTemporalFormatInput & {
-    semanticTemporalPresentation?: SemanticTemporalAuthoringPresentation;
-};
-export { AUTOMATIC_TEMPORAL_BUCKET_FORMAT, getTemporalBucketAuthoringOptions, reconcileTemporalBucketAuthoringFormat, resolveTemporalBucketAuthoringFormat, } from '../../shared/dashboard-authoring/temporal-bucket-authoring.js';
-export type { TemporalBucketAuthoringOption, TemporalBucketAuthoringSelection, } from '../../shared/dashboard-authoring/temporal-bucket-authoring.js';
-export type TemporalBucketAuthoringReadState = {
-    ok: true;
-    granularity: SemaphorTimeGrain;
-    selection: ReturnType<typeof getTemporalBucketAuthoringSelection>;
-} | Extract<ReturnType<typeof readSavedTemporalBucketFormat>, {
-    ok: false;
-}>;
-export declare function readTemporalBucketAuthoringState(input: TemporalBucketAuthoringInput): TemporalBucketAuthoringReadState;
-/**
- * Authoring-only bridge for existing saved dashboard bytes. The shared
- * registry accepts only structured formats; this is the sole place where
- * authoring UI reaches the bounded legacy reader.
- */
-export declare function readTemporalBucketAuthoringSelection(input: TemporalBucketAuthoringInput): import('../../shared/dashboard-authoring/temporal-bucket-authoring.js').TemporalBucketAuthoringSelection;
-type TemporalBucketAuthoringOverride = Pick<SavedTemporalFormatInput, 'format' | 'dateFormat' | 'customFormat'>;
-/**
- * Applies a saved authoring override atomically. If any override presentation
- * field is present, the override owns all three fields; otherwise the base
- * field remains authoritative.
- */
-export declare function readTemporalBucketAuthoringSelectionWithOverride(input: TemporalBucketAuthoringInput, override?: TemporalBucketAuthoringOverride): import('../../shared/dashboard-authoring/temporal-bucket-authoring.js').TemporalBucketAuthoringSelection;

package/dist/types/lib/formatters/kpi-number-formatter.d.ts

@@ -1,24 +0,0 @@
-import { TCard } from '../types/common-types.js';
-import { ResolvedValueFormatPreferences } from '../../shared/value-format-preferences/index.js';
-export type KpiNumberFormatter = {
-    format: (value: number | null) => string;
-    formatCompact: (value: number | null) => string;
-    formatSigned: (value: number | null) => string;
-    supportsComparisonDeltaInheritance: boolean;
-};
-export declare function buildKpiNumberFormatter({ card, preferences, boundCurrency, }: {
-    card?: TCard;
-    preferences?: ResolvedValueFormatPreferences | null;
-    boundCurrency?: string;
-}): KpiNumberFormatter;
-export declare function buildKpiMetricNumberFormatter({ card, preferences, boundCurrency, metricIndex, }: {
-    card?: TCard;
-    preferences?: ResolvedValueFormatPreferences | null;
-    boundCurrency?: string;
-    metricIndex: number;
-}): KpiNumberFormatter;
-export declare function buildKpiDeltaNumberFormatter({ card, preferences, boundCurrency, }: {
-    card?: TCard;
-    preferences?: ResolvedValueFormatPreferences | null;
-    boundCurrency?: string;
-}): KpiNumberFormatter;

package/dist/types/lib/formatters/kpi-result-columns.d.ts

@@ -1,3 +0,0 @@
-import { TCard } from '../types/common-types.js';
-export declare function isSqlBackedKpi(card: Pick<TCard, 'type' | 'sql'>): boolean;
-export declare function getDisplayedKpiResultColumnKeys(records?: Record<string, unknown>[] | null): string[];

package/dist/types/lib/formatters/kpi-result-values.d.ts

@@ -1,20 +0,0 @@
-/**
- * Reads KPI values out of a card query result. Shared by the dashboard KPI
- * cards and the Document KPI section, so both read the same number from the
- * same result.
- */
-/** A finite number from a numeric value or a numeric string (thousands commas allowed). */
-export declare function toFiniteKpiNumber(value: unknown): number | null;
-/**
- * SQL-backed KPI: the first row's first displayed numeric column is the
- * current value, the second is the previous value.
- */
-export declare function readSqlKpiValues(data?: Record<string, unknown>[] | null): {
-    current: number | null;
-    previous: number | null;
-};
-/**
- * Explorer KPI: the value of a result segment (`current`, `comparison`) for
- * the primary metric. Rows without a `metricId` match any metric.
- */
-export declare function readKpiSegmentValue(data: Record<string, unknown>[] | null | undefined, segment: string, metricId?: string): number | null;

package/dist/types/lib/formatters/metric-formatting.d.ts

@@ -1,197 +0,0 @@
-import { ColumnSettings, ColumnSettingsMap, PersistedColumnSettings, PersistedColumnSettingsMap } from '../../components/visual/data-table/types/data-table.js';
-import { AxisConfig, CurrencyPresentationTarget, TCard, TCardPreferences, TDataLabelsConfig, TFormatOptions } from '../types/common-types.js';
-import { DetailField, GroupByField, MetricField, QueryColumnKeyMap } from '../types/explorer-types.js';
-import { TableFieldLookup } from '../table-formatting/table-presentation-fields.js';
-import { CardNumericPresentationContext } from './numeric-presentation.js';
-import { RawTemporalValueKind } from '../../shared/format-utils/index.js';
-import { ResolvedValueFormatPreferences } from '../../shared/value-format-preferences/index.js';
-import { MatrixCardCatalog } from '../matrix-table/matrix-card-adapter.js';
-import { MeasureCanonicalFormat, NumericCanonicalFormat } from '../../shared/format-utils/types/index.js';
-import { ChartNumericPresentationContext } from './chart-numeric-presentation.js';
-type MetricLookup = TableFieldLookup;
-export type PresentationFormatField = Pick<MetricField | DetailField | GroupByField, 'id' | 'name' | 'alias' | 'format' | 'dataType'>;
-export type FormatResolutionSource = 'override' | 'metric' | 'legacy' | 'auto';
-export type ChartAxisId = 'x' | 'y' | 'y2';
-type ContextFormatMode = 'inherit' | 'override';
-type ContextResolution = {
-    formatOptions?: TFormatOptions;
-    source: FormatResolutionSource;
-    rawValue?: boolean;
-};
-export declare function hasExplicitFormatOptions(formatOptions?: TFormatOptions | null): boolean;
-export declare function getMetricColumnKey(metric?: Pick<MetricField, 'alias' | 'label' | 'name'> | null): string | undefined;
-export declare function findMetricFieldForColumn(card: TCard | undefined, lookup: MetricLookup): MetricField | undefined;
-export declare function findPresentationFieldForColumn(card: TCard | undefined, lookup: MetricLookup): (GroupByField | MetricField | DetailField) | undefined;
-export declare function normalizePersistedColumnSettings(settings: PersistedColumnSettings | undefined): ColumnSettings | undefined;
-export declare function normalizePersistedColumnSettingsMap(settings: PersistedColumnSettingsMap | undefined): ColumnSettingsMap;
-export declare function serializeEditedColumnSettings(params: {
-    persisted?: PersistedColumnSettings;
-    baseline: ColumnSettings;
-    next: ColumnSettings;
-    forcePersistDateType?: boolean;
-    enforceDeclaredSqlTemporalFormat?: boolean;
-    rawTemporalValueKind?: RawTemporalValueKind;
-}): PersistedColumnSettings;
-export declare function serializeEditedColumnSettingsMap(params: {
-    persisted: PersistedColumnSettingsMap;
-    columnId: string;
-    baseline: ColumnSettings;
-    next: ColumnSettings;
-    reset?: boolean;
-    forcePersistDateType?: boolean;
-    enforceDeclaredSqlTemporalFormat?: boolean;
-    rawTemporalValueKind?: RawTemporalValueKind;
-}): PersistedColumnSettingsMap;
-export declare function removePersistedColumnSettings(persisted: PersistedColumnSettingsMap, columnId: string): PersistedColumnSettingsMap;
-/** Resolves one configured metric instance from authoritative result identity. */
-export declare function resolveMetricFieldFromResultIdentity(metrics: readonly MetricField[], identity: {
-    metricAlias?: string;
-    metricId?: string;
-}): MetricField | undefined;
-export declare function resolveDatasetMetricField(params: {
-    card: TCard | undefined;
-    metricId?: string;
-    metricAlias?: string;
-    datasetIndex?: number;
-    datasetLabel?: string;
-    metricKey?: string;
-}): MetricField | undefined;
-export declare function getMetricFormatOptions(metric?: Pick<MetricField, 'format'> | null): TFormatOptions | undefined;
-export declare function areFormatOptionsEquivalent(left?: TFormatOptions, right?: TFormatOptions): boolean;
-export declare function resolveSharedMetricFormatOptions(metrics: Array<Pick<MetricField, 'format'> | null | undefined>): TFormatOptions | undefined;
-export declare function normalizeContextFormatMode(params: {
-    formatMode?: string | null;
-    legacyMode?: string | null;
-    formatOptions?: TFormatOptions | null;
-}): ContextFormatMode;
-export declare function getChartAxisMetricFields(params: {
-    card: TCard | undefined;
-    chartType?: string;
-    axis: ChartAxisId;
-    preferences?: TCardPreferences;
-}): MetricField[];
-export declare function resolveAxisFormatOptions(params: {
-    card: TCard | undefined;
-    chartType?: string;
-    axis: ChartAxisId;
-    preferences?: TCardPreferences;
-    axisConfig?: AxisConfig;
-    numericPresentation?: ChartNumericPresentationContext;
-}): ContextResolution;
-export declare function resolveTooltipFormatOptions(params: {
-    card?: TCard;
-    preferences?: TCardPreferences;
-    metric?: Pick<MetricField, 'id' | 'format'> | null;
-    numericPresentation?: ChartNumericPresentationContext;
-}): ContextResolution;
-export declare function resolveTooltipValueFormatOptions(params: {
-    card: TCard | undefined;
-    chartType?: string;
-    preferences?: TCardPreferences;
-    metric?: Pick<MetricField, 'id' | 'format'> | null;
-    axis?: ChartAxisId;
-    numericPresentation?: ChartNumericPresentationContext;
-}): ContextResolution;
-export declare function resolveDataLabelFormatOptions(params: {
-    card: TCard | undefined;
-    chartType?: string;
-    preferences?: TCardPreferences;
-    dataLabelsConfig?: TDataLabelsConfig;
-    numericPresentation?: ChartNumericPresentationContext;
-}): ContextResolution;
-export declare function resolveMetricDataLabelFormatOptions(params: {
-    card?: TCard;
-    preferences?: TCardPreferences;
-    dataLabelsConfig?: TDataLabelsConfig;
-    metric?: Pick<MetricField, 'id' | 'format'> | null;
-    numericPresentation?: ChartNumericPresentationContext;
-}): ContextResolution;
-export declare function resolveDatasetDataLabelFormatOptions(params: {
-    card: TCard | undefined;
-    preferences?: TCardPreferences;
-    dataLabelsConfig?: TDataLabelsConfig;
-    metricId?: string;
-    metricAlias?: string;
-    datasetIndex?: number;
-    datasetLabel?: string;
-    metricKey?: string;
-    numericPresentation?: ChartNumericPresentationContext;
-}): ContextResolution;
-export declare function hasRawDataLabelOverride(resolution?: Pick<ContextResolution, 'rawValue'> | null): boolean;
-export declare function buildMetricColumnSettings(metric?: Pick<MetricField, 'format'> | null, baseSettings?: ColumnSettings, preserveOmittedProperties?: boolean): ColumnSettings | undefined;
-export declare function resolveMetricColumnSettings(params: {
-    card: TCard | undefined;
-    columnId: string;
-    persistedSettings?: PersistedColumnSettings;
-    resolvedSettings?: ColumnSettings;
-    fallbackSettings?: ColumnSettings;
-    metricId?: string;
-    metricAlias?: string;
-    /**
-     * Explicit authored identity for adapters whose view keys differ from result
-     * keys (for example pivot row levels). Other consumers supply columnKeyMap.
-     */
-    fieldId?: string;
-    fieldRole?: TableFieldLookup['fieldRole'];
-    columnKeyMap?: QueryColumnKeyMap;
-    valueFormatPreferences?: ResolvedValueFormatPreferences | null;
-    boundCurrency?: string;
-    preserveOmittedProperties?: boolean;
-}): ColumnSettings | undefined;
-export declare function applyColumnNumericPresentation(settings: ColumnSettings | undefined, preferences?: ResolvedValueFormatPreferences | null, boundCurrency?: string, options?: {
-    preserveHistoricalPersistedPrecision?: boolean;
-}): ColumnSettings | undefined;
-export declare function resolveMetricCanonicalFormat(params: {
-    card: TCard | undefined;
-    columnId: string;
-    persistedSettings?: PersistedColumnSettings;
-    resolvedSettings?: ColumnSettings;
-    fallbackSettings?: ColumnSettings;
-    metricId?: string;
-    metricAlias?: string;
-    fieldId?: string;
-    fieldRole?: TableFieldLookup['fieldRole'];
-    columnKeyMap?: QueryColumnKeyMap;
-    valueFormatPreferences?: ResolvedValueFormatPreferences | null;
-    boundCurrency?: string;
-}): MeasureCanonicalFormat | undefined;
-export declare function resolveTableColumnCanonicalPresentation(params: {
-    card: TCard;
-    columnId: string;
-    persistedSettings?: PersistedColumnSettings;
-    resolvedSettings?: ColumnSettings;
-    fallbackSettings?: ColumnSettings;
-    metricId?: string;
-    metricAlias?: string;
-    columnKeyMap?: QueryColumnKeyMap;
-    comparisonValueKind?: 'comparison' | 'delta' | 'percent_change' | 'ratio';
-    comparisonPrecision?: number;
-    presentation: CardNumericPresentationContext;
-}): MeasureCanonicalFormat | undefined;
-export declare function resolveCurrencyPresentationTargetFormat(params: {
-    matrixCatalog?: MatrixCardCatalog;
-    card: TCard;
-    target: CurrencyPresentationTarget;
-    resultColumnKeys?: readonly string[];
-    valueFormatPreferences: ResolvedValueFormatPreferences;
-    boundCurrency?: string;
-}): NumericCanonicalFormat | undefined;
-export declare function resolveMetricFormatOptions(params: {
-    card: TCard | undefined;
-    columnId: string;
-    persistedSettings?: PersistedColumnSettings;
-    resolvedSettings?: ColumnSettings;
-    fallbackSettings?: ColumnSettings;
-    metricId?: string;
-    metricAlias?: string;
-    columnKeyMap?: QueryColumnKeyMap;
-    valueFormatPreferences?: ResolvedValueFormatPreferences | null;
-    boundCurrency?: string;
-}): TFormatOptions | undefined;
-export declare function getLegacyCardFormatOptions(preferences: TCardPreferences | undefined): TFormatOptions | undefined;
-export declare function formatNumericValueWithFallback(params: {
-    value: number;
-    formatOptions?: TFormatOptions;
-    preferences?: TCardPreferences;
-}): string;
-export {};

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

@@ -1,10 +0,0 @@
-import { CurrencyPresentationTarget } from '../types/common-types.js';
-import { ResolvedValueFormatPreferences } from '../../shared/value-format-preferences/index.js';
-export type CardNumericPresentationContext = {
-    preferences: ResolvedValueFormatPreferences | null;
-    resolveBoundCurrency: (target: CurrencyPresentationTarget) => string | undefined;
-};
-export declare const LIVE_NUMERIC_PRESENTATION_CARD_TYPES: readonly ["kpi", "table", "detailTable", "aggregateTable", "pivotTable", "bar", "horizontalBar", "stackedBar", "line", "stackedLine", "area", "stackedArea", "combo", "pie", "doughnut", "polarArea", "radar", "scatter", "bubble", "tornado", "pyramid", "range", "funnel", "bullet", "heatmap", "treemap", "map", "matrixTable"];
-export declare const TABLE_NUMERIC_PRESENTATION_CARD_TYPES: readonly ["table", "detailTable", "aggregateTable", "pivotTable", "matrixTable"];
-export declare function isTableNumericPresentationCardType(cardType: string | null | undefined): boolean;
-export declare function supportsLiveNumericPresentation(cardType: string | null | undefined): boolean;

package/dist/types/lib/formatters/numeric-value-coercion.d.ts

@@ -1,10 +0,0 @@
-/**
- * Parse numeric values returned by database drivers without interpreting
- * locale-specific decimal strings such as "1,23".
- */
-export declare function coerceNumericValue(value: unknown): number | null;
-/**
- * Coerce a value only when rendering it as a JavaScript number cannot silently
- * lose integer precision. Unsafe database bigint/decimal strings stay raw.
- */
-export declare function coerceNumericPresentationValue(value: unknown): number | null;

package/dist/types/lib/formatters/pivot-result-lifecycle-config.d.ts

@@ -1,15 +0,0 @@
-import { CardConfig } from '../types/explorer-types.js';
-import { parseCanonicalPivotResultTransport, CanonicalPivotResultContract, CanonicalPivotResultTransport } from '../../shared/format-utils/index.js';
-/**
- * Browser query results are immutable and retain object identity across cache,
- * placeholder, and render consumers. Cache only successful validation so the
- * same physical projection is parsed once while malformed input keeps failing
- * closed on every attempt. The shared React-free parser remains pure.
- */
-export declare function parseCanonicalPivotResultTransportOnce(input: Parameters<typeof parseCanonicalPivotResultTransport>[0]): CanonicalPivotResultTransport;
-/**
- * Cache/refetch compatibility is the only browser seam that compares a parsed
- * transport with the current effective config. Parsing itself remains fully
- * self-describing and does not reconstruct producer expectations.
- */
-export declare function isPivotResultContractCompatibleWithCardConfig(contract: CanonicalPivotResultContract, cardConfig: CardConfig): boolean;

package/dist/types/lib/formatters/raw-temporal-on-demand-delivery.d.ts

@@ -1,63 +0,0 @@
-import { RawTemporalCellPresentation, RawTemporalPresentation, RawTemporalPresentationError } from './raw-temporal-presentation.js';
-import { RawTemporalFormatResult } from '../../shared/format-utils/index.js';
-import { TCard } from '../types/common-types.js';
-import { CardConfig, QueryColumnKeyMap } from '../types/explorer-types.js';
-import { SemaphorResultColumn } from '../../shared/analytics-protocol/index.js';
-import { ResolvedValueFormatPreferences } from '../../shared/value-format-preferences/index.js';
-import { CalendarContext } from '../../shared/report-runtime-context/index.js';
-declare const RAW_TEMPORAL_EXPORT_HAS_RAW_VALUE_ATTRIBUTE = "data-export-has-raw-value";
-declare const RAW_TEMPORAL_EXPORT_RAW_VALUE_ATTRIBUTE = "data-export-raw-value";
-type RawTemporalExportAttributes = {
-    [RAW_TEMPORAL_EXPORT_HAS_RAW_VALUE_ATTRIBUTE]: 'true';
-    [RAW_TEMPORAL_EXPORT_RAW_VALUE_ATTRIBUTE]: string;
-};
-type RawTemporalOnDemandCell = RawTemporalCellPresentation & {
-    columnKey: string;
-    exportAttributes: RawTemporalExportAttributes;
-};
-type RawTemporalOnDemandRow = {
-    /** The exact record produced by the resolved query. */
-    canonicalRecord: Readonly<Record<string, unknown>>;
-    /** A copy for formatted artifacts; never use this as interaction identity. */
-    formattedRecord: Readonly<Record<string, unknown>>;
-    temporalCells: ReadonlyMap<string, RawTemporalOnDemandCell>;
-};
-type FailedRawTemporalFormatResult = Extract<RawTemporalFormatResult, {
-    ok: false;
-}>;
-type RawTemporalOnDemandDiagnostic = FailedRawTemporalFormatResult['diagnostic'] & {
-    columnKey: string;
-};
-type RawTemporalOnDemandDeliveryState = {
-    kind: 'inactive';
-} | {
-    kind: 'loading';
-} | {
-    kind: 'loaded_empty';
-    presentation: RawTemporalPresentation;
-    rows: readonly [];
-    diagnostics: readonly [];
-} | {
-    kind: 'loaded_valid';
-    presentation: RawTemporalPresentation;
-    rows: readonly RawTemporalOnDemandRow[];
-    diagnostics: readonly RawTemporalOnDemandDiagnostic[];
-} | {
-    kind: 'invalid';
-    error: RawTemporalPresentationError;
-};
-/**
- * Production on-demand adapter. The card, effective configuration, and result
- * are accepted together so CSV/PDF callers cannot resolve presentation from
- * one query and project rows from another.
- */
-export declare function buildCardRawTemporalOnDemandDelivery(input: {
-    card: TCard;
-    effectiveCardConfig?: CardConfig;
-    records: readonly Record<string, unknown>[] | undefined;
-    columns?: readonly SemaphorResultColumn[];
-    columnKeyMap?: QueryColumnKeyMap;
-    preferences: ResolvedValueFormatPreferences;
-    calendar: Pick<CalendarContext, 'tz'>;
-}): RawTemporalOnDemandDeliveryState;
-export {};

package/dist/types/lib/formatters/result-column-identity.d.ts

@@ -1,3 +0,0 @@
-export declare function isFiniteNumericResultValue(value: unknown): boolean;
-export declare function getOrderedResultColumnKeys(records?: readonly Record<string, unknown>[] | null): string[];
-export declare function getNumericResultColumnKeys(records?: readonly Record<string, unknown>[] | null): string[];

package/dist/types/lib/formatters/saved-temporal-bucket-format.d.ts

@@ -1,43 +0,0 @@
-import { TemporalBucketFormat } from '../../shared/analytics-protocol/index.js';
-export type TemporalPresentationRepairCode = 'missing_custom_pattern' | 'unsupported_pattern' | 'grain_incompatible_pattern' | 'missing_grain_assumed_day';
-export type TemporalPresentationRepairDiagnostic = {
-    code: TemporalPresentationRepairCode;
-    severity: 'warning';
-    fieldId: string;
-    ignoredPattern?: string;
-    effectiveFormat: TemporalBucketFormat;
-};
-export type SavedTemporalFormatReadResult = {
-    ok: true;
-    format: TemporalBucketFormat;
-    diagnostic?: TemporalPresentationRepairDiagnostic;
-} | {
-    ok: false;
-    error: {
-        code: 'ambiguous_temporal_grain';
-        fieldId: string;
-    };
-};
-export type SavedTemporalFormatInput = {
-    fieldId: string;
-    dataType?: unknown;
-    granularity?: unknown;
-    format?: unknown;
-    dateFormat?: unknown;
-    customFormat?: unknown;
-};
-type SavedTemporalPresentationInput = Pick<SavedTemporalFormatInput, 'format' | 'dateFormat'>;
-/**
- * Identifies whether a grouped field carries card-authored temporal
- * presentation in either the structured contract or the bounded legacy
- * representation. `customFormat` is only an adjunct to `dateFormat: custom`
- * and must not activate presentation by itself.
- */
-export declare function hasSavedTemporalBucketPresentation(input: SavedTemporalPresentationInput): boolean;
-/**
- * The only compatibility reader for persisted dashboard grouped-date
- * presentation. It never mutates saved bytes and is deliberately not exported
- * through the worker-facing format-utils subpath.
- */
-export declare function readSavedTemporalBucketFormat(input: SavedTemporalFormatInput): SavedTemporalFormatReadResult;
-export {};

package/dist/types/lib/formatters/semantic-column-presentation.d.ts

@@ -1,9 +0,0 @@
-import { Field } from '../types/explorer-types.js';
-import { TDataColumn } from '../types/common-types.js';
-type SemanticColumnPresentation = Pick<Field, 'format' | 'granularity' | 'semanticTemporalPresentation'>;
-/**
- * Translates semantic column presentation as one unit so a temporal bucket
- * format can never cross the API-to-authoring boundary without its grain.
- */
-export declare function fromSemanticColumnPresentation(column: Pick<TDataColumn, 'format' | 'granularity'>): SemanticColumnPresentation;
-export {};

package/dist/types/lib/formatters/value-formatter.d.ts

@@ -1,64 +0,0 @@
-import { DurationDisplayStyle, DurationUnit } from '../../shared/format-utils/types/index.js';
-export interface FormatOptions {
-    decimalPlaces?: number;
-    minimumFractionDigits?: number;
-    maximumFractionDigits?: number;
-    useGrouping?: boolean;
-    useSuffix?: boolean;
-    currency?: string;
-    locale?: string;
-    prefix?: string;
-    suffix?: string;
-    negativeInParentheses?: boolean;
-    multiplyBy?: number;
-    percentValueMode?: 'fraction' | 'whole';
-    durationInputUnit?: DurationUnit;
-    durationDisplayStyle?: DurationDisplayStyle;
-    durationLargestUnit?: DurationUnit;
-    durationSmallestUnit?: DurationUnit;
-    durationMaxUnits?: number;
-}
-/**
- * Main value formatting function for axis labels, tooltips, and data labels
- */
-export declare function formatValue(value: any, type?: 'auto' | 'number' | 'currency' | 'percent' | 'date' | 'scientific' | 'duration', options?: FormatOptions): string;
-/**
- * Format as number with optional magnitude suffixes (K, M, B)
- */
-export declare function formatNumber(value: number, options?: FormatOptions): string;
-/**
- * Format as currency
- */
-export declare function formatCurrency(value: number, options?: FormatOptions): string;
-/**
- * Format as percentage
- */
-export declare function formatPercent(value: number, options?: FormatOptions): string;
-/**
- * Format as date
- */
-export declare function formatDate(value: any, options?: FormatOptions): string;
-/**
- * Format as scientific notation
- */
-export declare function formatScientific(value: number, options?: FormatOptions): string;
-/**
- * Format as elapsed duration
- */
-export declare function formatDuration(value: number, options?: FormatOptions): string;
-/**
- * Create a formatter function for use in Chart.js callbacks
- */
-export declare function createFormatter(type: 'auto' | 'number' | 'currency' | 'percent' | 'date' | 'scientific' | 'duration', options?: FormatOptions): (value: any) => string;
-/**
- * Legacy compatibility wrapper for formatNumberCustom
- * Maps old format to formatValue-compatible options.
- */
-export declare function formatNumberCustom({ number, decimalPlaces, useSuffix, customSuffix, currency, locale, }: {
-    number: number;
-    decimalPlaces?: number;
-    useSuffix?: boolean;
-    customSuffix?: string;
-    currency?: string;
-    locale?: string;
-}): string;

package/dist/types/lib/hooks/ai/assistant-context-entity-utils.d.ts

@@ -1,6 +0,0 @@
-import { DatabaseEntityReference, DataModelEntityReference, DatasetEntityReference, FileEntityReference, SelectedEntities } from '../../types/explorer-types.js';
-export type AssistantContextEntity = DatabaseEntityReference | DataModelEntityReference | DatasetEntityReference | FileEntityReference;
-export declare function areContextEntitiesEqual(left: AssistantContextEntity, right: AssistantContextEntity): boolean;
-export declare function toEntityArray(entities: SelectedEntities | undefined): AssistantContextEntity[];
-export declare function dedupeContextEntities(entities: AssistantContextEntity[]): AssistantContextEntity[];
-export declare function areEntityListsEqual(left: AssistantContextEntity[], right: AssistantContextEntity[]): boolean;

package/dist/types/lib/hooks/ai/assistant-session.d.ts

@@ -1,3 +0,0 @@
-export declare function createAssistantConversationId(): `${string}-${string}-${string}-${string}-${string}`;
-export declare function createAssistantRequestId(): `${string}-${string}-${string}-${string}-${string}`;
-export declare function isPromiseLike<T>(value: PromiseLike<T> | T): value is PromiseLike<T>;

package/dist/types/lib/hooks/ai/dashboard-assistant-context.d.ts

@@ -1,35 +0,0 @@
-import { TDashboard } from '../../types/common-types.js';
-import { SelectedEntities } from '../../types/explorer-types.js';
-import { AssistantContextEntity } from './assistant-context-entity-utils.js';
-import { AIContext, DashboardAIContext, DashboardAIContextMode } from '../../types/assistant-types.js';
-export declare function deriveSelectedSheetAssistantEntities(dashboard: TDashboard, selectedSheetId: string | null | undefined): AssistantContextEntity[];
-export declare function getDashboardAssistantScopeKey(dashboardId: string | null | undefined, draftScopeKey?: string | null): string;
-export declare function getDashboardAssistantPersistedScopeKey(dashboardId: string | null | undefined): string | null;
-export declare function resolveDashboardAssistantManualOverride({ overrides, dashboardId, draftScopeKey, }: {
-    overrides: Record<string, SelectedEntities | undefined>;
-    dashboardId: string | null | undefined;
-    draftScopeKey?: string | null;
-}): {
-    selectedEntities: SelectedEntities | undefined;
-    hasManualOverride: boolean;
-    activeScopeKey: string;
-};
-export declare function resolveDashboardAIContextMode(aiContext: DashboardAIContext | undefined): DashboardAIContextMode;
-export declare function buildResolvedDashboardAssistantAIContext({ currentAIContext, manualSelectedEntities, hasManualOverride, dashboardAIContext, derivedSelectedSheetEntities, }: {
-    currentAIContext: AIContext;
-    manualSelectedEntities: SelectedEntities | undefined;
-    hasManualOverride: boolean;
-    dashboardAIContext: DashboardAIContext | undefined;
-    derivedSelectedSheetEntities: SelectedEntities | undefined;
-}): AIContext;
-export declare function resolveDashboardAssistantSelectedEntities({ manualSelectedEntities, hasManualOverride, dashboardAIContext, derivedSelectedSheetEntities, }: {
-    manualSelectedEntities: SelectedEntities | undefined;
-    hasManualOverride: boolean;
-    dashboardAIContext: DashboardAIContext | undefined;
-    derivedSelectedSheetEntities: SelectedEntities | undefined;
-}): AssistantContextEntity[];
-export declare function resolveDashboardAssistantAvailableEntities({ manualSelectedEntities, dashboardAIContext, derivedSelectedSheetEntities, }: {
-    manualSelectedEntities: SelectedEntities | undefined;
-    dashboardAIContext: DashboardAIContext | undefined;
-    derivedSelectedSheetEntities: SelectedEntities | undefined;
-}): AssistantContextEntity[];