react-semaphor 0.1.533 → 0.1.535

package/dist/types/lib/constants.d.ts

@@ -1,30 +0,0 @@
-import { TStyle } from './types/common-types.js';
-import { DatabaseEntityType } from './types/explorer-types.js';
-export { PYTHON_DEFAULT_CODE } from './python/default-code.js';
-export declare const isDevEnv: boolean;
-export declare const DATABASE_ENTITY_TYPES: DatabaseEntityType[];
-export declare const METADATA_KEYS: string[];
-export declare const DATAMODEL_NAMESPCACE = "dm";
-export declare const CALCULATED_FIELDS_GROUP_ID = "semaphor_calculated_fields";
-export declare const CALCULATED_FIELDS_GROUP_NAME = "calculated_fields";
-export declare const LOCALE_CURRENCY_PAIRS: {
-    locale: string;
-    currency: string;
-    currencyName: string;
-}[];
-export declare const LOCALES: {
-    label: string;
-    locales: {
-        code: string;
-        name: string;
-    }[];
-}[];
-export declare const BREAKPOINTS: string[];
-export declare const DEFAULT_STYLE: TStyle;
-export declare function getDatalabelColor(context: any): string;
-export declare function getCanvasBackgroundColor(source?: Element | null): string;
-type ContrastColorOptions = {
-    baseColor?: string;
-};
-export declare function getContrastColor(backgroundColor: string | string[], options?: ContrastColorOptions): string;
-export declare function getContrastColor_backup(backgroundColor: string): string;

package/dist/types/lib/contexts/dashboard-preferences-context.d.ts

@@ -1,7 +0,0 @@
-import { DashboardPreferences } from '../types/common-types.js';
-export type DashboardPreferencesContextType = {
-    preferences: DashboardPreferences;
-    isLocalDev: boolean;
-    isConsoleMode: boolean;
-};
-export declare const DashboardPreferencesContext: import('react').Context<DashboardPreferencesContextType | undefined>;

package/dist/types/lib/contexts/display-preferences-context.d.ts

@@ -1,6 +0,0 @@
-import { VisualDisplayPreferences } from '../types/common-types.js';
-export type DisplayPreferencesContextType = {
-    displayPreferences: VisualDisplayPreferences;
-    shouldShowElement: (element: keyof NonNullable<VisualDisplayPreferences['overrides']>) => boolean;
-};
-export declare const DisplayPreferencesContext: import('react').Context<DisplayPreferencesContextType | undefined>;

package/dist/types/lib/contexts/interactions-popover-context.d.ts

@@ -1,14 +0,0 @@
-import { ReactNode } from 'react';
-type InteractionsPopoverContextType = {
-    open: boolean;
-    frameId: string | null;
-    cardId: string | null;
-    openPopover: (frameId: string, cardId: string) => void;
-    closePopover: () => void;
-};
-declare const InteractionsPopoverContext: import('react').Context<InteractionsPopoverContextType>;
-export { InteractionsPopoverContext };
-type InteractionsPopoverProviderProps = {
-    children: ReactNode;
-};
-export declare function InteractionsPopoverProvider({ children, }: InteractionsPopoverProviderProps): import("react").JSX.Element;

package/dist/types/lib/countries.d.ts

@@ -1,8 +0,0 @@
-export interface Country {
-    id: string;
-    name: string;
-    flag: string;
-    code: string;
-    region?: string;
-}
-export declare const countries: Country[];

package/dist/types/lib/csv-download.d.ts

@@ -1,11 +0,0 @@
-/**
- * Save a CSV file in the browser. This is the only place react-semaphor
- * creates a CSV Blob; `content` comes from the CSV file contract
- * (`encodeCsvFile`), which owns the BOM, quoting and record separators, or is
- * a file the server built (a direct Matrix CSV), saved byte for byte so its
- * BOM survives.
- */
-export declare function downloadCsvFile({ content, fileName, }: {
-    content: string | Blob;
-    fileName: string;
-}): void;

package/dist/types/lib/csv-encoding-options.d.ts

@@ -1,6 +0,0 @@
-import { CsvEncoding } from '../shared/format-utils/index.js';
-/** The two CSV encodings as people see them, in every place that offers the choice. */
-export declare const CSV_ENCODING_OPTIONS: ReadonlyArray<{
-    value: CsvEncoding;
-    label: string;
-}>;

package/dist/types/lib/dashboard/click-to-filter-card-references.d.ts

@@ -1,23 +0,0 @@
-import { DashboardInputValues, TCard, TDashboard } from '../types/common-types.js';
-type Target = {
-    dashboard: Pick<TDashboard, 'sheets' | 'defaultInputValues'>;
-    dashboardInputValues: DashboardInputValues;
-};
-/**
- * Rewrites every click-to-filter reference a card holds. Mutates the card, so
- * it works on a store draft and on a fresh clone alike. The walkers are the
- * shared ones; this only says which members of a card carry card ids.
- */
-export declare function remapCardClickToFilterReferences(card: TCard, cardIds: Map<string, string>): void;
-/**
- * A card's id changed (renamed, or a document section's card replaced). Every
- * other card that names it keeps reaching it, and a live selection it holds
- * moves with it. Without this the save succeeds and filtering silently stops.
- */
-export declare function retargetClickToFilterCardId(target: Target, previousCardId: string, nextCardId: string): void;
-/**
- * Cards were deleted. The cards that remain stop naming them, and a selection
- * a deleted card held goes with it, so no dangling id is ever saved from here.
- */
-export declare function removeClickToFilterCardReferences(target: Target, removedCardIds: Set<string>): void;
-export {};

package/dist/types/lib/dashboard/duplicate-sheet.d.ts

@@ -1,11 +0,0 @@
-import { DashboardInputValues, TDashboard, TSheet } from '../types/common-types.js';
-type IdMap = Map<string, string>;
-/** Copies one sheet and its owned definitions atomically; shared definitions retain identity. */
-export declare function duplicateDashboardSheet(dashboard: TDashboard, sheetId: string): {
-    dashboard: TDashboard;
-    sheet: TSheet;
-    cardIds: IdMap;
-    filterIds: IdMap;
-    copiedDefaultInputValues: DashboardInputValues;
-} | null;
-export {};

package/dist/types/lib/dashboard/global-date-filter-utils.d.ts

@@ -1,22 +0,0 @@
-import { TFilter } from '../../components/surfboard/filter/types.js';
-import { TCard, TDashboard } from '../types/common-types.js';
-import { SemanticExecutionPayload } from '../types/semantic-runtime-types.js';
-import { ResolvedCardDateFields } from '../query-context/resolve-card-primary-date-field.js';
-export declare const DEFAULT_GLOBAL_DATE_FILTER_TITLE = "Global Date";
-export declare const GLOBAL_DATE_FILTER_SYNTHETIC_COLUMN = "__global_date__";
-export declare const GLOBAL_DATE_FILTER_SYNTHETIC_CONNECTION_ID = "__global_date__";
-export declare function isGlobalDateFilter(filter: Pick<TFilter, 'kind'> | null | undefined): boolean;
-export declare function getGlobalDateFilter(filters: TFilter[] | undefined): TFilter | undefined;
-export declare function createDefaultGlobalDateFilter(): TFilter;
-export type GlobalDateFilterCoverage = {
-    eligibleCardIds: string[];
-    eligibleCardCount: number;
-    totalCardCount: number;
-    ineligibleCardCount: number;
-    hasEligibleCards: boolean;
-    allEligibleTargetsAreDateTime: boolean;
-    unresolvedCardIds?: string[];
-};
-/** Scope membership is independent of whether a target can currently compile. */
-export declare function getGlobalDateFilterTargets(dashboard: TDashboard | undefined, globalDateFilter?: TFilter): import('../utils/card-utils.js').DashboardCardEntry[];
-export declare function getGlobalDateFilterCoverage(dashboard: TDashboard | undefined, semanticExecutionPayload?: SemanticExecutionPayload, globalDateFilter?: TFilter, effectiveCards?: ReadonlyMap<string, TCard | null>, resolvedFields?: ReadonlyMap<string, ResolvedCardDateFields | undefined>): GlobalDateFilterCoverage;

package/dist/types/lib/dashboard/open-card-in-visual-editor.d.ts

@@ -1,15 +0,0 @@
-import { useManagementStore } from '../stores/management-store.js';
-import { TCard, TFrame } from '../types/common-types.js';
-type ManagementState = ReturnType<typeof useManagementStore.getState>;
-/** Saved-dashboard edit permission, as the dashboard runtime reads it. */
-export declare function selectCanEditDashboard(state: ManagementState): boolean;
-/**
- * Opens the visual editor on one dashboard card from any dashboard state,
- * including view mode. Store values are read at call time, so callers such as
- * error fallbacks don't subscribe to dashboard or editor state to offer it.
- */
-export declare function openCardInVisualEditor({ frame, card, }: {
-    frame: TFrame;
-    card: TCard;
-}): void;
-export {};

package/dist/types/lib/dashboard-inputs/build-normalized-dashboard-inputs.d.ts

@@ -1,55 +0,0 @@
-import { DashboardInputValues, NormalizedDashboardInput, TCard, TDashboard } from '../types/common-types.js';
-import { TransientInputContext } from './transient-input-context.js';
-export type BuildNormalizedDashboardInputsInput = {
-    dashboard: Pick<TDashboard, 'inputs' | 'filters' | 'controls' | 'sheets'>;
-    card?: TCard | null;
-    availableSheetIds?: string[];
-    availableCardIds?: string[];
-    /**
-     * Carried definitions for a runtime resolution. Authoring callers leave it
-     * out: a carried definition is never part of the dashboard being edited.
-     */
-    transientContexts?: readonly TransientInputContext[];
-};
-export type BuildNormalizedDashboardInputsOutput = {
-    authoredInputs: NormalizedDashboardInput[];
-    compatibilityInputs: NormalizedDashboardInput[];
-    /** Carried definitions, already normalized and self-contained. */
-    transientInputs: NormalizedDashboardInput[];
-    allInputs: NormalizedDashboardInput[];
-};
-export declare function requiresDashboardInputResolution({ dashboard, dashboardInputValues, transientContexts, }: {
-    dashboard: Pick<TDashboard, 'inputs' | 'filters' | 'controls' | 'defaultInputValues'>;
-    dashboardInputValues?: DashboardInputValues;
-    /**
-     * Carried definitions are inputs of this resolution too, so a dashboard with
-     * no inputs of its own still has to resolve them. Required so that every
-     * caller decides.
-     */
-    transientContexts: readonly TransientInputContext[] | undefined;
-}): boolean;
-export declare function buildNormalizedDashboardInputs({ dashboard, card, availableSheetIds, availableCardIds, transientContexts, }: BuildNormalizedDashboardInputsInput): BuildNormalizedDashboardInputsOutput;
-/** An Input the tolerant normalization rejected, kept identifiable. */
-export type RejectedDashboardInput = {
-    inputId: string;
-    filterId?: string;
-    label: string;
-    message: string;
-};
-export type TolerantNormalizedDashboardInputs = {
-    /** Every Input that normalized without an issue. */
-    inputs: NormalizedDashboardInput[];
-    /** Inputs the contract reported, none of which is in `inputs`. */
-    rejected: RejectedDashboardInput[];
-    /** Filter ids of every filter Input known on the dashboard, rejected included. */
-    knownFilterIds: ReadonlySet<string>;
-};
-/**
- * Tolerant counterpart of `buildNormalizedDashboardInputs` for option loading
- * and authoring diagnostics: the same authored and compatibility assembly, but
- * an Input the contract reports is rejected (never partially kept) and its
- * identity is retained so an explicit reference to it can fail with a typed
- * error and authors can see why. The dashboard-level part is computed once
- * per immutable dashboard object; card inline inputs are lifted per call.
- */
-export declare function buildNormalizedDashboardInputsTolerantly({ dashboard, card, }: Pick<BuildNormalizedDashboardInputsInput, 'dashboard' | 'card'>): TolerantNormalizedDashboardInputs;

package/dist/types/lib/dashboard-inputs/build-selection-dashboard-inputs.d.ts

@@ -1,31 +0,0 @@
-import { SelectionInputValue } from '../../shared/analytics-protocol/selection-contract.js';
-import { DashboardInputValues, SelectionDashboardInput, TCard, TDashboard } from '../types/common-types.js';
-type SelectionDashboard = Pick<TDashboard, 'sheets' | 'interactionDefaults'>;
-/** Every selection lives in the shared slot map: it is dashboard-wide and survives sheet switches. */
-export declare const SELECTION_RUNTIME_TARGET: {};
-/** The slot address of a source card's selection. */
-export declare function selectionSlotAddress(sourceCardId: string): Pick<SelectionDashboardInput, 'id' | 'runtimeScope'>;
-/**
- * The selection input of one source card, or undefined when click to filter is
- * off for it. Settings come from the normalizer, so a legacy cross-filter
- * interaction yields the same input an authored `clickToFilter` would.
- */
-export declare function buildSelectionDashboardInput(card: TCard, dashboard: Pick<TDashboard, 'interactionDefaults' | 'sheets'>): SelectionDashboardInput | undefined;
-/** A set, schema-valid selection value, or undefined. A malformed slot is ignored, never thrown on. */
-export declare function readSelectionValue(values: DashboardInputValues | undefined, sourceCardId: string): SelectionInputValue | undefined;
-export type ActiveSelection = {
-    input: SelectionDashboardInput;
-    value: SelectionInputValue;
-    sourceCard: TCard;
-};
-/**
- * The selections currently in effect, in slot order. Driven by the values, not
- * by the cards: a dashboard pays nothing for cards nobody has clicked. A slot
- * whose source card is gone, or whose card no longer has click to filter on,
- * is not in effect.
- */
-export declare function listActiveSelections(params: {
-    dashboard: SelectionDashboard;
-    dashboardInputValues: DashboardInputValues | undefined;
-}): ActiveSelection[];
-export {};

package/dist/types/lib/dashboard-inputs/card-compat-adapter.d.ts

@@ -1,9 +0,0 @@
-import { ControlDashboardInput, FilterDashboardInput, TCard, TInlineFilter } from '../types/common-types.js';
-import { TFilter } from '../../components/surfboard/filter/types.js';
-export { getCardControlCompatInputId, getCardInlineFilterCompatInputId, } from '../../shared/analytics-protocol/index.js';
-export declare function adaptCardInputsToDashboardInputs(card: TCard | null | undefined, options?: {
-    existingInputs?: Array<{
-        variableName: string;
-    }>;
-}): Array<FilterDashboardInput | ControlDashboardInput>;
-export declare function inlineFilterToFilter(inlineFilter: TInlineFilter): TFilter;

package/dist/types/lib/dashboard-inputs/click-to-filter-emitted-fields.d.ts

@@ -1,17 +0,0 @@
-import { SelectionField } from '../../shared/analytics-protocol/selection-contract.js';
-import { ClickToFilterFieldsRule, DashboardCardFilterSourceInventory } from '../../shared/dashboard-authoring/index.js';
-import { Field } from '../types/explorer-types.js';
-export type ClickToFilterDimension = {
-    key: string;
-    field: SelectionField;
-    /** The authored field, for its label. */
-    authored: Field;
-};
-/**
- * The dimension fields of a card that a click can carry, grounded the same way
- * a click grounds them. A calculated field or one with no data type is left
- * out here exactly as it is left out of a tuple.
- */
-export declare function clickToFilterDimensions(dimensions: Field[], sourceIndex: DashboardCardFilterSourceInventory): ClickToFilterDimension[];
-/** The fields the rule lets a click carry. Whole row and clicked cell can carry any dimension. */
-export declare function clickToFilterEmittedFields(dimensions: ClickToFilterDimension[], rule: ClickToFilterFieldsRule): SelectionField[];

package/dist/types/lib/dashboard-inputs/click-to-filter-mapping-draft.d.ts

@@ -1,99 +0,0 @@
-import { SelectionField } from '../../shared/analytics-protocol/selection-contract.js';
-import { ClickToFilterCardMapping, ClickToFilterSettings } from '../../shared/dashboard-authoring/index.js';
-import { NormalizedFilterDashboardInput, TCard, TDashboard } from '../types/common-types.js';
-import { DashboardFilterMappingCandidateCatalog, DashboardFilterMappingDraftRow } from './dashboard-filter-mapping-authoring.js';
-/** Why a card gets nothing from this source, decided before any field is looked at. */
-export type ClickToFilterDraftCardState = 'listening'
-/** An 'excluded' card mapping: the author chose "Don't apply to this card". */
- | 'excluded'
-/** `card.respondsToSelections === false`, set on the target card itself. */
- | 'receiverOptedOut'
-/** `settings.targets` does not reach the card. */
- | 'outsideTargets'
-/** SQL and unconfigured cards: a selection compiles to card filter conditions, which only config cards execute. */
- | 'notSupported';
-export type ClickToFilterMappingDraftRow = {
-    /** Target card. */
-    cardId: string;
-    clickedFieldKey: string;
-    clickedField: SelectionField;
-    /** The toolbar filter's row type, unchanged, so `MappingRow` renders it. */
-    row: DashboardFilterMappingDraftRow;
-    /**
-     * Set when the card has fields to choose from but none the click matches.
-     * The click drops this field here, which is ordinary and needs no decision;
-     * `row.status` is 'excluded' so the row reads "Not applied" and stays choosable.
-     */
-    unmapped?: true;
-    /** Shows "Same as <filter> filter". A borrowed binding is never persisted here. */
-    provenanceHint?: 'borrowedFromFilter';
-    borrowedFromInputId?: string;
-};
-export type ClickToFilterMappingDraftCard = {
-    cardId: string;
-    cardTitle: string;
-    cardType: TCard['type'];
-    sheetId: string;
-    state: ClickToFilterDraftCardState;
-    /** One per emitted field. Empty unless the card is listening or excluded. */
-    rows: ClickToFilterMappingDraftRow[];
-    /** A suggestion to accept, an ambiguous match, or a mapping that went stale. */
-    needsReview: boolean;
-};
-export type ClickToFilterMappingDraft = {
-    sourceCardId: string;
-    /** Cards that need review first, then dashboard order. */
-    cards: ClickToFilterMappingDraftCard[];
-    rows: ClickToFilterMappingDraftRow[];
-    /** Per target card. */
-    counts: {
-        /** At least one clicked field applies. */
-        covered: number;
-        toReview: number;
-        /** Listening, but no clicked field applies. */
-        skipped: number;
-        /** Excluded by the author, opted out, outside the targets, or not supported. */
-        notApplied: number;
-    };
-};
-/**
- * What one source card's clicks do on every other card, as review rows. It
- * reads the same settings the runtime resolver reads, in the same order, so
- * the dialog never promises a match a click will not make.
- */
-export declare function buildClickToFilterMappingDraft(params: {
-    sourceCard: Pick<TCard, 'id'>;
-    settings: ClickToFilterSettings;
-    dashboard: Pick<TDashboard, 'sheets'>;
-    /** Fields a click on the source card can carry under its fields rule. */
-    emittedFields: SelectionField[];
-    candidatesByCardId: Record<string, DashboardFilterMappingCandidateCatalog | undefined>;
-    /** Toolbar filters, for borrowed bindings. */
-    filterInputs: NormalizedFilterDashboardInput[];
-}): ClickToFilterMappingDraft;
-export type ClickToFilterMappingDraftIssue = {
-    cardId: string;
-    clickedFieldKey: string;
-    message: string;
-};
-/**
- * Mirrors `acceptDashboardFilterMappingDraft`: fails while any row of a
- * listening card is ambiguous, has no metadata, or holds a stale mapping. The
- * result is sparse: automatic, suggested and borrowed rows write nothing.
- */
-export declare function acceptClickToFilterMappingDraft(params: {
-    draft: ClickToFilterMappingDraft;
-    settings: ClickToFilterSettings;
-}): {
-    ok: true;
-    cardMappings: ClickToFilterCardMapping[];
-} | {
-    ok: false;
-    issues: ClickToFilterMappingDraftIssue[];
-};
-/** Binds one clicked field on one card. Choosing a field re-includes an excluded card. */
-export declare function bindClickToFilterField(settings: ClickToFilterSettings, binding: Extract<ClickToFilterCardMapping, {
-    kind: 'bound';
-}>): ClickToFilterSettings;
-/** "Don't apply to this card". Bindings are kept, so re-including restores them. */
-export declare function setClickToFilterCardExcluded(settings: ClickToFilterSettings, cardId: string, excluded: boolean): ClickToFilterSettings;

package/dist/types/lib/dashboard-inputs/click-to-filter-sheet-reach.d.ts

@@ -1,12 +0,0 @@
-import { DashboardInputScope, TDashboard } from '../types/common-types.js';
-/**
- * A click filters cards on its own sheet, and only those. This is a product
- * rule, not a saved setting: `settings.targets` keeps whatever the author or a
- * legacy entry stored, and is narrowed here on the way to every reader (the
- * runtime input and the authoring draft), so lifting the rule later is a change
- * to this one function.
- *
- * A source card that is not on the dashboard (an editor preview) has no sheet
- * to narrow to, and its targets are returned as they are.
- */
-export declare function restrictClickToFilterTargetsToSourceSheet(targets: DashboardInputScope, sourceCardId: string, dashboard: Pick<TDashboard, 'sheets'>): DashboardInputScope;

package/dist/types/lib/dashboard-inputs/dashboard-control-compat-adapter.d.ts

@@ -1,7 +0,0 @@
-import { ControlDashboardInput, TDashboard } from '../types/common-types.js';
-export { getDashboardControlCompatInputId } from '../../shared/analytics-protocol/index.js';
-export declare function adaptDashboardControlsToInputs(dashboard: Pick<TDashboard, 'controls'>, options?: {
-    existingInputs?: Array<{
-        variableName: string;
-    }>;
-}): ControlDashboardInput[];

package/dist/types/lib/dashboard-inputs/dashboard-filter-authoring-policy.d.ts

@@ -1,21 +0,0 @@
-import { TFilter } from '../../components/surfboard/filter/types.js';
-export type DashboardFilterAuthoringMode = 'ordinary' | 'filterInput' | 'mapping';
-/**
- * Keep the ordinary/filter-input/mapped storage decision out of UI code. The
- * selected transaction remains explicit and table-testable while persisted
- * dashboard shapes stay backward compatible.
- */
-export declare function selectDashboardFilterAuthoringMode(params: {
-    hasPersistedApplication: boolean;
-    hasDraftMappingChanges: boolean;
-    hasAuthoredOptionSource: boolean;
-    /** An authored dependency policy or population is Input-owned metadata. */
-    hasAuthoredOptionPolicy?: boolean;
-    forceSelection?: boolean;
-    hasPersistedInput?: boolean;
-    optionSourceChanged: boolean;
-    selectionIdentityChanged: boolean;
-    scopeChanged: boolean;
-}): DashboardFilterAuthoringMode;
-/** The UI and authoring transactions share this complete eligibility rule. */
-export declare function resolveFilterInputForceSelection(requested: boolean | undefined, filter: TFilter | undefined, timezone?: string): true | undefined;

package/dist/types/lib/dashboard-inputs/dashboard-filter-compat-adapter.d.ts

@@ -1,10 +0,0 @@
-import { FilterDashboardInput, TDashboard } from '../types/common-types.js';
-export { getDashboardFilterCompatInputId } from '../../shared/analytics-protocol/index.js';
-export type DashboardFilterCompatAdapterOptions = {
-    existingInputs?: Array<{
-        variableName: string;
-    }>;
-    availableSheetIds?: string[];
-    availableCardIds?: string[];
-};
-export declare function adaptDashboardFiltersToInputs(dashboard: Pick<TDashboard, 'filters' | 'sheets'>, options?: DashboardFilterCompatAdapterOptions): FilterDashboardInput[];

package/dist/types/lib/dashboard-inputs/dashboard-filter-mapping-candidate-metadata.d.ts

@@ -1,107 +0,0 @@
-import { DashboardInputScope, TDashboard, TDataColumn } from '../types/common-types.js';
-import { FieldSearchSource } from '../fields/field-display.js';
-import { DashboardFilterOptionSource, DashboardFilterTargetField, DashboardFilterTargetSource } from '../../shared/dashboard-authoring/index.js';
-import { SemaphorConnectionCapabilities } from '../../shared/analytics-protocol/index.js';
-import { DashboardFilterMappingCandidateCatalog } from './dashboard-filter-mapping-authoring.js';
-export type DashboardFilterMappingSourceMetadata = {
-    status: 'ready';
-    columns: TDataColumn[];
-} | {
-    status: 'unavailable';
-    message: string;
-};
-/** Catalog display labels for one source: the dataset's own label and its fields. */
-export type DashboardFilterMappingSourceLabels = {
-    /** Human-readable dataset label when a semantic dataset declares this source. */
-    sourceLabel?: string;
-    /** Set when two datasets declare this table with different labels. */
-    sourceLabelConflict?: boolean;
-    /** Normalized field name to authored label; only labels that differ from the name. */
-    fields: ReadonlyMap<string, string>;
-    /** Normalized field names two datasets label differently. */
-    fieldConflicts?: ReadonlySet<string>;
-};
-/**
- * Catalog display labels resolved from live column metadata, keyed by source
- * request key. Presentation only: mappings persist the stable field
- * coordinate, and this lookup is rebuilt from the catalog every time metadata
- * loads, so a renamed semantic label shows up without touching the saved
- * dashboard. Semantic datasets also register under the physical table their
- * columns declare they project, so a filter or option source that addresses
- * the raw table shows the same dataset and field labels.
- */
-export type DashboardFilterMappingFieldLabels = ReadonlyMap<string, DashboardFilterMappingSourceLabels>;
-export type DashboardFilterMappingColumnsRequestResolution = {
-    status: 'ready';
-    request: Record<string, string>;
-} | {
-    status: 'unavailable';
-    message: string;
-};
-export type DashboardFilterMappingSourceRequest = {
-    key: string;
-    source: DashboardFilterTargetSource;
-} & DashboardFilterMappingColumnsRequestResolution;
-/** A governed option field with the concrete source required by authoring. */
-export type DashboardFilterOptionFieldChoice = Omit<DashboardFilterOptionSource['labelField'], 'source'> & {
-    source: DashboardFilterOptionSource['source'];
-    /** Exact catalog type for filter predicate materialization. */
-    nativeDataType?: string;
-};
-type DashboardFilterMappingOuterScope = Extract<DashboardInputScope, {
-    kind: 'allSheets' | 'sheets';
-}>;
-/**
- * Metadata queries use the full execution coordinate, not only semantic
- * identity. This prevents two bindings for the same semantic dataset from
- * accidentally sharing columns fetched through different connections.
- */
-export declare function dashboardFilterMappingSourceRequestKey(source: DashboardFilterTargetSource): string;
-export declare function resolveDashboardFilterMappingColumnsRequest(source: DashboardFilterTargetSource, capabilities?: Pick<SemaphorConnectionCapabilities, 'prefixLevels'>): DashboardFilterMappingColumnsRequestResolution;
-export declare function collectDashboardFilterMappingSourceRequests(dashboard: Pick<TDashboard, 'sheets'>, outerScope?: DashboardFilterMappingOuterScope, capabilitiesByConnectionId?: ReadonlyMap<string, Pick<SemaphorConnectionCapabilities, 'prefixLevels'>>, options?: {
-    includeDocumentSections?: boolean;
-}): DashboardFilterMappingSourceRequest[];
-/**
- * Builds the label lookup from live column metadata. A field label is
- * recorded only when it differs from the column name. Semantic columns also
- * register under the physical table they declare (`qualifiedEntityName`),
- * keyed by the physical column (`sourceField`) as well as the semantic name,
- * and carry the dataset label to that table. `sourcesByKey` supplies the
- * source for each metadata key; without it the physical registration is
- * skipped.
- */
-export declare function buildDashboardFilterMappingFieldLabels(metadataBySourceKey: ReadonlyMap<string, DashboardFilterMappingSourceMetadata>, sourcesByKey?: ReadonlyMap<string, DashboardFilterTargetSource>): DashboardFilterMappingFieldLabels;
-/**
- * Combines lookups under the same conflict rule as a single build: a table
- * or field that two inputs label differently shows its raw path or name.
- * Conflicts already recorded in an input are preserved.
- */
-export declare function mergeDashboardFilterMappingFieldLabels(...maps: (DashboardFilterMappingFieldLabels | undefined)[]): DashboardFilterMappingFieldLabels;
-/** Dotted physical path as persisted on the source (database.schema.table). */
-export declare function dashboardFilterPhysicalSourcePath(source: Extract<DashboardFilterTargetSource, {
-    kind: 'physical';
-}>): string;
-/** Display label for a target field when the catalog defines one that differs from the field name. */
-export declare function resolveDashboardFilterMappingFieldLabel(labels: DashboardFilterMappingFieldLabels | undefined, field: Pick<DashboardFilterTargetField, 'name' | 'source'>): string | undefined;
-/**
- * Display label for a source. Semantic sources carry their own label;
- * physical sources show the label of a semantic dataset that declares it
- * projects the table, otherwise the dotted physical path.
- */
-export declare function resolveDashboardFilterMappingSourceLabel(labels: DashboardFilterMappingFieldLabels | undefined, source: DashboardFilterTargetSource): string;
-/**
- * A mapping target or option field as the shared field display rule sees it
- * (`getFieldDisplayLabel`, `matchesFieldQuery`): the catalog label counts as
- * authored, the source label stands in for the entity, and a physical path
- * stays searchable as the qualified entity name.
- */
-export declare function toMappingDisplayField(labels: DashboardFilterMappingFieldLabels | undefined, field: Pick<DashboardFilterTargetField, 'name' | 'source'> & {
-    dataType?: string;
-}): FieldSearchSource;
-export declare function buildDashboardFilterMappingCandidateCatalogs(params: {
-    dashboard: Pick<TDashboard, 'sheets'>;
-    outerScope?: DashboardFilterMappingOuterScope;
-    includeDocumentSections?: boolean;
-    metadataBySourceKey: ReadonlyMap<string, DashboardFilterMappingSourceMetadata>;
-}): Record<string, DashboardFilterMappingCandidateCatalog | undefined>;
-export {};

package/dist/types/lib/dashboard-inputs/dashboard-filter-ownership.d.ts

@@ -1,13 +0,0 @@
-import { TFilter } from '../../components/surfboard/filter/types.js';
-import { DashboardInput, DashboardInputScope, TDashboard } from '../types/common-types.js';
-/** Scope owns an input's lifetime; runtimeScope only owns its value slots. */
-export declare function isDashboardInputOwnedBySheet(scope: DashboardInputScope, sheetId: string, cardIds: ReadonlySet<string>): boolean;
-export declare function getDashboardFilterInputOwners(inputs: DashboardInput[] | undefined): Map<string, import('../types/common-types.js').ReferencedFilterDashboardInput>;
-/** A reference-backed filter follows its input, regardless of storage placement. */
-export declare function getSheetOwnedDashboardFilterIds(dashboard: Pick<TDashboard, 'filters' | 'inputs'>, sheetId: string, cardIds: ReadonlySet<string>): Set<string>;
-/** Drop exclusive sheet ownership while preserving the backing's scope restrictions.
- * The referencing input remains authoritative for applicability and lifetime.
- */
-export declare function releaseDashboardFilterSheetOwnership(filter: TFilter): TFilter;
-/** Clean a retained backing after sheet deletion; its input still owns it. */
-export declare function removeDashboardFilterSheetReferences(filter: TFilter, sheetId: string, cardIds: ReadonlySet<string>): TFilter;

package/dist/types/lib/dashboard-inputs/dashboard-filter-value-identity.d.ts

@@ -1,36 +0,0 @@
-import { TFilter } from '../../components/surfboard/filter/types.js';
-import { DashboardFilterOptionSource, DashboardFilterTargetField, DashboardFilterTargetSource } from '../../shared/dashboard-authoring/index.js';
-import { SemaphorConnectionCapabilities } from '../../shared/analytics-protocol/index.js';
-export type DashboardFilterSourceResolutionContext = {
-    connectionType?: string;
-    capabilities?: Pick<SemaphorConnectionCapabilities, 'dialect' | 'prefixLevels'>;
-};
-/**
- * Resolves the concrete source carried by an Option Source field, falling
- * back to the Option Source declaration for older field refs that omit it.
- */
-export declare function resolveDashboardFilterOptionFieldSource(field: DashboardFilterOptionSource['valueField'], fallbackSource: DashboardFilterOptionSource['source']): DashboardFilterTargetSource;
-export declare function resolveDashboardFilterBackingSourceResolution(filter: TFilter, context?: DashboardFilterSourceResolutionContext): import('../../shared/analytics-protocol/index.js').SemaphorSourceEntityResolution<Record<string, unknown>>;
-/** Resolves the one source that owns an ordinary dashboard filter field. */
-export declare function resolveDashboardFilterBackingSource(filter: TFilter, context?: DashboardFilterSourceResolutionContext): DashboardFilterTargetSource | undefined;
-/**
- * Metadata authoring may inspect a complete persisted qualified source even
- * when stale selected-entity inventory no longer contains it. Runtime source
- * resolution remains fail-closed through resolveDashboardFilterBackingSource.
- */
-export declare function resolveDashboardFilterMappingCandidateSource(filter: TFilter, context?: DashboardFilterSourceResolutionContext): DashboardFilterTargetSource | undefined;
-/**
- * Resolves every proven identity by which the selected filter field may map.
- * A physical dataset selected within a semantic domain legitimately has both
- * a physical backing identity and a semantic projection; the consuming card
- * chooses the identity present in its own executable-source inventory.
- */
-export declare function resolveDashboardFilterMappingSources(filter: TFilter): DashboardFilterTargetSource[];
-/**
- * Authoring counterpart to resolveDashboardFilterMappingSources. It may carry
- * a complete qualified backing candidate when persisted entity inventory is
- * stale, while the semantic projection still requires a resolved entity.
- */
-export declare function resolveDashboardFilterMappingCandidateSources(filter: TFilter, context?: DashboardFilterSourceResolutionContext): DashboardFilterTargetSource[];
-/** Resolves the ordinary filter field used as the pre-Option-Source value key. */
-export declare function deriveDashboardFilterLogicalSelectionField(filter: TFilter): Pick<DashboardFilterTargetField, 'name'> | undefined;

package/dist/types/lib/dashboard-inputs/dashboard-input-authoring-aliases.d.ts

@@ -1,13 +0,0 @@
-import { TFilter } from '../../components/surfboard/filter/types.js';
-import { TDashboard } from '../types/common-types.js';
-type DashboardInputAliasExclusion = {
-    source: 'dashboardFilter';
-    filterId: string;
-} | {
-    source: 'dashboardControl';
-    controlId: string;
-};
-type DashboardAliasSource = Pick<TDashboard, 'inputs' | 'filters' | 'controls' | 'sheets'>;
-export declare function getEffectiveDashboardFilterVariableName(dashboard: DashboardAliasSource | null | undefined, filter: TFilter): string;
-export declare function getReservedDashboardInputVariableNames(dashboard: DashboardAliasSource | null | undefined, exclude?: DashboardInputAliasExclusion): string[];
-export {};

package/dist/types/lib/dashboard-inputs/dashboard-input-display.d.ts

@@ -1,11 +0,0 @@
-import { DashboardInputExportKey, ResolvedDashboardInput, ResolvedDashboardInputContext, TextVariablePresentation } from '../types/common-types.js';
-import { TemporalTextPresentationContext } from '../text-variables/temporal-input-text.js';
-/** What text visual rendering resolves variables against. */
-export type DashboardTextRenderContext = Pick<ResolvedDashboardInputContext, 'variablesById' | 'variablesByName'> & {
-    /** The viewer's Report preferences and Calendar; defaults when absent. */
-    presentation?: TemporalTextPresentationContext;
-};
-/** A date filter or a date control: its value can be formatted as a date. */
-export declare function isTemporalDashboardInput(input: ResolvedDashboardInput): boolean;
-/** One part of an input as text, with the variable's stored presentation. */
-export declare function getDashboardInputText(input: ResolvedDashboardInput, exportKey: DashboardInputExportKey, context: Pick<DashboardTextRenderContext, 'presentation'>, stored?: TextVariablePresentation): string;