react-semaphor 0.1.532 → 0.1.534

package/dist/types/lib/hooks/explorer/use-field-availability-context.d.ts

@@ -1,16 +0,0 @@
-import { TCard } from '../../types/common-types.js';
-import { FieldAvailabilityContext } from '../../utils/field-availability-context.js';
-/**
- * The single hook every explorer surface uses to get the availability
- * context for the card being edited: the field list (rows and previews),
- * the click gate, the drop gate, and the matrix editor. It fetches the
- * relationship map for the card's domain and reads the auto-resolved join
- * plan from the card's query, then defers to `buildFieldAvailabilityContext`
- * so the facts are assembled in exactly one place.
- *
- * `card` defaults to the editor store's card so callers that receive an
- * optional card still get a stable context.
- */
-export declare function useFieldAvailabilityContext(card?: TCard, options?: {
-    extraDatasetLabels?: Record<string, string>;
-}): FieldAvailabilityContext;

package/dist/types/lib/hooks/explorer/use-field-management.d.ts

@@ -1,42 +0,0 @@
-import { ContainerId, PivotMemberOrder, DateFormatValue, FormatSpec, Field } from '../../types/explorer-types.js';
-import { TemporalBucketFormat, MetricComparisonPolarity, MetricComparisonSpec } from '../../../shared/analytics-protocol/index.js';
-import { TCard } from '../../types/common-types.js';
-import { MetricTransformMode } from '../../utils/window-transform-utils.js';
-export declare const useFieldManagement: (activeCard: TCard | undefined, sourceFields?: readonly Field[]) => {
-    reconcileMatrixCalculation: (previous?: Field, updated?: Field) => boolean;
-    moveField: (input: {
-        field: Field;
-        from: ContainerId;
-        to: ContainerId;
-        beforeId?: string;
-    }) => boolean;
-    resetFields: () => void;
-    getFieldsForContainer: (containerId: ContainerId) => Field[];
-    setFieldsForContainer: (containerId: ContainerId, fields: Field[]) => void;
-    updateLabel: (containerId: ContainerId, index: number, newLabel: string) => void;
-    handleAggregationChange: (index: number, aggregation: string) => void;
-    handleDetailDateFormatChange: (index: number, format: DateFormatValue, customFormat: string) => void;
-    handleDimensionFormatChange: (zone: "groupBy" | "detailColumns", index: number, format: FormatSpec | undefined) => void;
-    handleTemporalBucketFormatChange: (index: number, format: TemporalBucketFormat) => void;
-    handleGranularityChange: (index: number, granularity: string) => void;
-    handleAliasTemplateChange: (index: number, template: string) => void;
-    handlePivotMemberOrderChange: (index: number, memberOrder: PivotMemberOrder) => void;
-    handleValueAliasesChange: (index: number, aliases: Record<string, string>) => void;
-    handleMetricFormatChange: (index: number, format: FormatSpec | undefined) => void;
-    removeField: (zone: ContainerId, index: number) => void;
-    handleFieldClick: (field: Field) => Promise<void>;
-    handleMetricComparisonChange: (metricIndex: number, comparisonSelection: "inherit" | "off" | "previous_period" | "previous_year" | "target") => void;
-    handleMetricComparisonSpecChange: (metricIndex: number, spec: MetricComparisonSpec) => void;
-    handleMetricComparisonPolarityChange: (metricIndex: number, comparisonPolarity: MetricComparisonPolarity) => void;
-    handleMetricWindowTransformChange: (metricIndex: number, transformMode: "none" | MetricTransformMode) => void;
-    handleMetricWindowOrderByChange: (metricIndex: number, orderByFieldId: string) => void;
-    handleMetricWindowDirectionChange: (metricIndex: number, direction: "asc" | "desc") => void;
-    handleMetricWindowPartitionToggle: (metricIndex: number, partitionFieldId: string) => void;
-    handleMetricMovingAverageWindowSizeChange: (metricIndex: number, windowSize: number) => void;
-    handleMetricMovingAverageMinPeriodsChange: (metricIndex: number, minPeriods: number) => void;
-    handleMetricPreviousPeriodDeltaModeChange: (metricIndex: number, mode: "absolute" | "percent") => void;
-    handleMetricPercentOfTotalScopeChange: (metricIndex: number, scope: "grand_total" | "partition_total") => void;
-    handleMetricPercentOfTotalOutputChange: (metricIndex: number, output: "fraction" | "percent") => void;
-    handleMetricTargetValueChange: (metricIndex: number, targetValue: number | undefined) => void;
-    cardType: import('../../types/index.js').TChartType;
-};

package/dist/types/lib/hooks/explorer/use-files.d.ts

@@ -1,13 +0,0 @@
-export type FileItem = {
-    id: string;
-    type: "upload";
-    name: string;
-    originalName: string;
-    size?: number;
-    lastModified?: string;
-    format?: string;
-};
-export declare const useFiles: () => {
-    files: FileItem[];
-    isPending: boolean;
-};

package/dist/types/lib/hooks/explorer/use-filter-builder.d.ts

@@ -1,24 +0,0 @@
-import { FilterGroup, FilterCondition, LogicalOperator, Field } from '../../types/explorer-types.js';
-interface UseFilterBuilderProps {
-    initialFilters?: FilterGroup | null;
-    availableFields?: Field[];
-}
-export declare function useFilterBuilder({ initialFilters, availableFields: propAvailableFields, }?: UseFilterBuilderProps): {
-    currentFilters: FilterGroup;
-    setCurrentFilters: import('react').Dispatch<import('react').SetStateAction<FilterGroup>>;
-    availableFields: Field[];
-    isLoading: boolean;
-    addCondition: (groupId: string) => void;
-    addGroup: (parentGroupId: string) => void;
-    removeCondition: (groupId: string, conditionId: string) => void;
-    removeGroup: (parentGroupId: string, groupId: string) => void;
-    updateConditionFields: (groupId: string, conditionId: string, updates: Partial<FilterCondition>) => void;
-    replaceCondition: (groupId: string, conditionId: string, next: FilterCondition) => void;
-    updateGroupOperator: (groupId: string, operator: LogicalOperator) => void;
-    updateGroupNegate: (groupId: string, negate: boolean) => void;
-    reorderConditions: (groupId: string, oldIndex: number, newIndex: number) => void;
-    reorderGroups: (parentGroupId: string, oldIndex: number, newIndex: number) => void;
-    generateSQLPreview: (filterGroup: FilterGroup | null) => string;
-    hasAnyFilters: boolean;
-};
-export {};

package/dist/types/lib/hooks/explorer/use-filterable-fields.d.ts

@@ -1,61 +0,0 @@
-import { Field } from '../../types/explorer-types.js';
-export declare function useFilterableFields(): {
-    filterableFields: Field[];
-    sharedFilterableFields: Field[];
-    dashboardFilterableFields: Field[];
-    inlineFilterableFields: Field[];
-    scopedCalculatedFields: Field[];
-    sharedCalculatedFields: Field[];
-    inlineCalculatedFields: Field[];
-    valuePickFilterableFields: Field[];
-    columns: Field[];
-    columnGroups: import('../../types/explorer-types.js').EntityColumnGroup[];
-    rawColumnGroups: import('../../types/explorer-types.js').EntityColumnGroup[];
-    columnFields: Field[];
-    domainCalculatedFields: Field[];
-    dashboardCalculatedFields: Field[];
-    sheetCalculatedFields: Field[];
-    cardCalculatedFields: {
-        id: string;
-        name: string;
-        label: string;
-        derivedLabel?: string;
-        alias?: string;
-        sourceField?: string;
-        source?: Exclude<import('../../../data-app-sdk.js').SemaphorSourceRef, {
-            kind: "sql";
-        }>;
-        qualifiedFieldName: string;
-        dataType: string;
-        nativeDataType?: string;
-        description?: string;
-        qualifiedEntityName?: string;
-        dateFormat?: import('../../types/explorer-types.js').DateFormatValue;
-        customFormat?: string;
-        granularity?: import('../../types/explorer-types.js').TimeGranularity;
-        entityId: string;
-        entityName: string;
-        entityType: import('../../types/explorer-types.js').EntityType;
-        role?: "groupby" | "metric" | "sortby" | "pivotby" | "detail";
-        expression?: string;
-        calculatedFormula?: import('../../types/explorer-types.js').CalculatedFieldFormula;
-        derivedField?: import('../../../data-app-sdk.js').SemaphorDerivedFieldDefinition;
-        format?: import('../../types/explorer-types.js').FormatSpec;
-        semanticTemporalPresentation?: import('../../types/explorer-types.js').SemanticTemporalPresentation;
-        aggregate?: import('../../types/explorer-types.js').AggregateFunction;
-        aggregateOrigin?: "default" | "explicit";
-        calculationRepresentation?: "inline-expression" | "manual" | "typed-derived";
-        calculatedFieldOrigin?: {
-            id: string;
-            role?: Field["role"];
-        };
-        labelOrigin?: "semantic" | "override";
-        formatOrigin?: "semantic" | "override";
-        fieldScope?: import('../../types/explorer-types.js').FieldScope;
-    }[];
-    scopedFields: Field[];
-    isLoading: boolean;
-    hasError: boolean;
-    error: Error | undefined;
-    refetch: () => Promise<void>;
-};

package/dist/types/lib/hooks/explorer/use-join-conditions-builder.d.ts

@@ -1,27 +0,0 @@
-import { Join, DatabaseEntityReference, JoinPlan } from '../../types/explorer-types.js';
-interface UseJoinConditionsBuilderProps {
-    initialJoinPlan: JoinPlan;
-    availableDataSources: DatabaseEntityReference[];
-}
-export declare function useJoinConditionsBuilder({ initialJoinPlan, availableDataSources, }: UseJoinConditionsBuilderProps): {
-    joinPlan: JoinPlan;
-    expandedJoins: Set<string>;
-    setJoinPlan: import('react').Dispatch<import('react').SetStateAction<JoinPlan>>;
-    addJoin: () => void;
-    removeJoin: (joinId: string) => void;
-    updateJoin: (joinId: string, updates: Partial<Join>) => void;
-    moveJoinUp: (joinId: string) => void;
-    moveJoinDown: (joinId: string) => void;
-    toggleJoinExpansion: (joinId: string) => void;
-    getAvailableSourceEntities: (currentJoinId?: string) => DatabaseEntityReference[];
-    getAvailableTargetEntities: (sourceName: string) => DatabaseEntityReference[];
-    addJoinKeyGroup: (joinId: string) => void;
-    updateGroupOperator: (joinId: string, groupIndex: number, operator: string) => void;
-    removeJoinKeyGroup: (joinId: string, groupIndex: number) => void;
-    addJoinKey: (joinId: string, groupIndex: number) => void;
-    updateJoinKey: (joinId: string, groupIndex: number, keyIndex: number, field: string, value: string) => void;
-    removeJoinKey: (joinId: string, groupIndex: number, keyIndex: number) => void;
-    generateSQLPreview: () => string;
-    isValidConfiguration: () => boolean;
-};
-export {};

package/dist/types/lib/hooks/explorer/use-schemas.d.ts

@@ -1,8 +0,0 @@
-import { AuthToken } from '../../types/common-types.js';
-export declare function useSchemas(token?: AuthToken): {
-    isPending: boolean;
-    error: Error | null;
-    schemas: import('../../types/dropdown-types.js').DropdownItem[];
-    refetch: (options?: import('@tanstack/query-core').RefetchOptions) => Promise<import('@tanstack/query-core').QueryObserverResult<any, Error>>;
-    label: string;
-};

package/dist/types/lib/hooks/explorer/use-scoped-fields.d.ts

@@ -1,53 +0,0 @@
-import { Field, FieldScope } from '../../types/explorer-types.js';
-export declare function useScopedFields(): {
-    columns: Field[];
-    columnGroups: import('../../types/explorer-types.js').EntityColumnGroup[];
-    rawColumnGroups: import('../../types/explorer-types.js').EntityColumnGroup[];
-    columnFields: Field[];
-    domainCalculatedFields: Field[];
-    dashboardCalculatedFields: Field[];
-    sheetCalculatedFields: Field[];
-    cardCalculatedFields: {
-        id: string;
-        name: string;
-        label: string;
-        derivedLabel?: string;
-        alias?: string;
-        sourceField?: string;
-        source?: Exclude<import('../../../data-app-sdk.js').SemaphorSourceRef, {
-            kind: "sql";
-        }>;
-        qualifiedFieldName: string;
-        dataType: string;
-        nativeDataType?: string;
-        description?: string;
-        qualifiedEntityName?: string;
-        dateFormat?: import('../../types/explorer-types.js').DateFormatValue;
-        customFormat?: string;
-        granularity?: import('../../types/explorer-types.js').TimeGranularity;
-        entityId: string;
-        entityName: string;
-        entityType: import('../../types/explorer-types.js').EntityType;
-        role?: "groupby" | "metric" | "sortby" | "pivotby" | "detail";
-        expression?: string;
-        calculatedFormula?: import('../../types/explorer-types.js').CalculatedFieldFormula;
-        derivedField?: import('../../../data-app-sdk.js').SemaphorDerivedFieldDefinition;
-        format?: import('../../types/explorer-types.js').FormatSpec;
-        semanticTemporalPresentation?: import('../../types/explorer-types.js').SemanticTemporalPresentation;
-        aggregate?: import('../../types/explorer-types.js').AggregateFunction;
-        aggregateOrigin?: "default" | "explicit";
-        calculationRepresentation?: "inline-expression" | "manual" | "typed-derived";
-        calculatedFieldOrigin?: {
-            id: string;
-            role?: Field["role"];
-        };
-        labelOrigin?: "semantic" | "override";
-        formatOrigin?: "semantic" | "override";
-        fieldScope?: FieldScope;
-    }[];
-    scopedFields: Field[];
-    isLoading: boolean;
-    hasError: boolean;
-    error: Error | undefined;
-    refetch: () => Promise<void>;
-};

package/dist/types/lib/hooks/explorer/use-semantic-domains.d.ts

@@ -1,17 +0,0 @@
-import { AuthToken } from '../../types/common-types.js';
-type TSemanticDomain = {
-    id: string;
-    name: string;
-    label: string;
-    description: string;
-};
-export declare function useSemanticDomains(token?: AuthToken): {
-    isPending: boolean;
-    error: boolean;
-    semanticDomainsData: any;
-    semanticDomains: TSemanticDomain[];
-    isSemanticDomainsLoading: boolean;
-    isSemanticDomainsError: boolean;
-    refetchSemanticDomains: (options?: import('@tanstack/query-core').RefetchOptions) => Promise<import('@tanstack/query-core').QueryObserverResult<any, Error>>;
-};
-export {};

package/dist/types/lib/hooks/explorer/use-sync-legacy-editor-state.d.ts

@@ -1,20 +0,0 @@
-/**
- * Bridge hook: Syncs legacy editor state with new data source structure
- *
- * When card.dataSource changes, automatically updates:
- * - selectedTableName
- * - selectedSchemaName
- * - selectedDatabaseName
- * - selectedConnectionId
- * - selectedDatamodelId (when entity is a datamodel)
- *
- * This maintains backward compatibility for code still using legacy state
- * (e.g., useAssignFilter, AI assistant queries, useDataColumns, etc.).
- *
- * Note: For multi-table scenarios, syncs only the FIRST entity to legacy state.
- * This is acceptable because:
- * - Dev mode always uses single tables
- * - Explorer mode filter code primarily uses field.entityName when available
- * - This hook is a bridge solution for gradual migration
- */
-export declare function useSyncLegacyEditorState(): void;

package/dist/types/lib/hooks/query-context/use-card-query-context.d.ts

@@ -1,3 +0,0 @@
-import { TCard } from '../../types/common-types.js';
-import { CardQueryContext } from '../../query-context/build-card-query-context.js';
-export declare function useCardQueryContext(card: TCard): CardQueryContext;

package/dist/types/lib/hooks/query-context/use-dashboard-card-execution-snapshot.d.ts

@@ -1,10 +0,0 @@
-import { MatrixCardCatalog } from '../../matrix-table/matrix-card-adapter.js';
-import { TCard } from '../../types/common-types.js';
-import { DocumentSectionCardRuntime } from '../../query-context/document-section-card-query.js';
-/**
- * Store adapter only: field, input, scope and precision decisions stay in the
- * compiler. A Document section passes its runtime; the editor's preview of a
- * section's card uses the editor's snapshot of the document inputs, as the
- * card's frame query does.
- */
-export declare function useDashboardCardExecutionSnapshot(card: TCard, matrixCatalog: MatrixCardCatalog, documentSection?: DocumentSectionCardRuntime): import('../../query-context/build-dashboard-execution-snapshot.js').DashboardCardExecutionSnapshotResult;

package/dist/types/lib/hooks/selection/use-active-selections.d.ts

@@ -1,15 +0,0 @@
-/** Every selection in effect, with how many cards each narrows. For the filter bar. */
-export declare function useActiveSelections(): (import('../../dashboard-inputs/build-selection-dashboard-inputs.js').ActiveSelection & {
-    targetCount: number;
-})[];
-/** What each active selection does on one card. For that card's filter badge. */
-export declare function useSelectionsOnCard(cardId: string | undefined): {
-    resolution: import('../../dashboard-inputs/resolve-selection-input.js').ResolvedCardSelection;
-    input: import('../../types/index.js').SelectionDashboardInput;
-    value: import('../../../shared/analytics-protocol/selection-contract.js').SelectionInputValue;
-    sourceCard: import('../../types/index.js').TCard;
-}[];
-/** How many source cards currently narrow this card. */
-export declare function useCardSelectionFilterCount(cardId: string | undefined): number;
-/** Clears every selection slot, including one whose source card is gone. */
-export declare function clearAllSelections(): void;

package/dist/types/lib/hooks/selection/use-click-to-filter-mapping-draft.d.ts

@@ -1,20 +0,0 @@
-import { NormalizedFilterDashboardInput, TCard } from '../../types/common-types.js';
-import { ClickToFilterSettings } from '../../../shared/dashboard-authoring/index.js';
-import { ClickToFilterDimension } from '../../dashboard-inputs/click-to-filter-emitted-fields.js';
-/**
- * The review rows for one source card's draft settings. Field metadata and
- * labels come from the same loader the toolbar filter's Cards tab uses, and
- * are requested only while the behavior is on and the surface is open.
- */
-export declare function useClickToFilterMappingDraft(params: {
-    sourceCard: Pick<TCard, 'id'> | null | undefined;
-    settings: ClickToFilterSettings;
-    dimensions: ClickToFilterDimension[];
-    enabled: boolean;
-}): {
-    draft: import('../../dashboard-inputs/click-to-filter-mapping-draft.js').ClickToFilterMappingDraft | undefined;
-    fieldLabels: import('../../dashboard-inputs/dashboard-filter-mapping-candidate-metadata.js').DashboardFilterMappingFieldLabels;
-    filterInputs: NormalizedFilterDashboardInput[];
-    isLoading: boolean;
-    retry: () => void;
-};

package/dist/types/lib/hooks/selection/use-selection-click.d.ts

@@ -1,34 +0,0 @@
-import { ClickContextResult } from '../../interactions/get-click-context-from-chartjs.js';
-import { TCard } from '../../types/common-types.js';
-import { Interaction } from '../../types/interaction-types.js';
-type PointerInteraction = (params: {
-    context: ClickContextResult;
-    gesture: 'leftClick';
-    modifierKeys?: {
-        shift: boolean;
-        ctrl: boolean;
-        meta: boolean;
-    };
-    position?: {
-        x: number;
-        y: number;
-    };
-}) => void;
-/**
- * One left click on a mark or cell of a visual without row ranges: it selects
- * for click to filter, runs the card's drill, or, when it does both, opens the
- * menu with "Filter" beside the drills. Cmd, Ctrl and Shift toggle.
- */
-export declare function useSelectionClick(card: TCard, params: {
-    handlePointerInteraction: PointerInteraction;
-    onMultipleInteractions?: (matches: Interaction[], context: ClickContextResult, position?: {
-        x: number;
-        y: number;
-    }) => void;
-}): {
-    isEnabled: boolean;
-    handleClick: (event: Pick<React.MouseEvent, "shiftKey" | "metaKey" | "ctrlKey" | "clientX" | "clientY">, context: ClickContextResult, options?: {
-        canDrill: boolean;
-    }) => void;
-};
-export {};

package/dist/types/lib/hooks/selection/use-selection-gestures.d.ts

@@ -1,38 +0,0 @@
-import { SelectionTuple } from '../../../shared/analytics-protocol/selection-contract.js';
-import { SelectionGesture, SelectionReduceResult } from '../../selection/selection-reducer.js';
-import { SelectionTupleResult } from '../../selection/selection-from-click-context.js';
-import { ClickToFilterFieldsRule, ClickToFilterSettings, TCard } from '../../types/common-types.js';
-import { Field } from '../../types/explorer-types.js';
-import { ClickFilterCondition, Interaction } from '../../types/interaction-types.js';
-/**
- * The "Filter" entry offered beside a card's drills when one click matches
- * both. Compared by identity; it is never persisted and never executed by the
- * drill engine.
- */
-export declare const SELECTION_MENU_INTERACTION: Interaction;
-export type SelectionGestures = {
-    /** Normalized `settings.enabled`. */
-    isEnabled: boolean;
-    settings: ClickToFilterSettings;
-    /** From the card's selection slot. */
-    selection: SelectionTuple[];
-    select: (tuple: SelectionTuple, gesture: SelectionGesture) => SelectionReduceResult;
-    /** Checkbox column: the checked set replaces the selection. */
-    selectMany: (tuples: SelectionTuple[]) => void;
-    clear: () => void;
-    /** Turns a capture builder's conditions into a tuple under this card's fields rule. */
-    tupleFromClick: (conditions: ClickFilterCondition[], clickedField?: Field, 
-    /** Overrides the card's fields rule, for callers that need one specific cell or the whole row. */
-    rule?: ClickToFilterFieldsRule) => SelectionTupleResult;
-    /** Last tuple selected by replace or toggle, read at call time; the start of a Shift range. */
-    getAnchor: () => SelectionTuple | undefined;
-    /** Target cards the current selection narrows. Zero without a selection. */
-    targetCount: number;
-};
-/**
- * Writes a source card's selection slot. Callable outside React so a store
- * action or an imperative grid callback shares the one write path.
- */
-export declare function writeSelection(sourceCardId: string, tuples: SelectionTuple[]): void;
-/** The one place a card reads and changes its own selection. */
-export declare function useSelectionGestures(card: TCard): SelectionGestures;

package/dist/types/lib/hooks/selection/use-table-row-selection.d.ts

@@ -1,46 +0,0 @@
-import { Row, Table } from '@tanstack/react-table';
-import { SelectionTupleResult } from '../../selection/selection-from-click-context.js';
-import { Field } from '../../types/explorer-types.js';
-import { ClickFilterCondition } from '../../types/interaction-types.js';
-import { SelectionGestures } from './use-selection-gestures.js';
-/** Checkboxes are the touch affordance: always, never, or on coarse pointers only. */
-export declare function areSelectionCheckboxesShown(gestures: Pick<SelectionGestures, 'isEnabled' | 'settings'>): boolean;
-export type TableRowClickOutcome = 
-/** Click to filter is off, or the table is not interactive. */
-{
-    status: 'ignored';
-} | {
-    status: 'selected';
-}
-/** The click cannot become a selection. */
- | {
-    status: 'unavailable';
-    result: Extract<SelectionTupleResult, {
-        status: 'unavailable';
-    }>;
-} | {
-    status: 'limitReached';
-};
-/**
- * Click to filter for a row-based table. The selection slot is the record:
- * row highlight and checkbox state are derived from it, and a checkbox change
- * is applied to it as a difference, so rows selected on another page survive.
- */
-export declare function useTableRowSelection<TData>(params: {
-    /** The card's one gestures instance, shared with the rest of the table. */
-    gestures: SelectionGestures;
-    table: Table<TData>;
-    /** Visible rows in display order, after sort and filter. */
-    rows: Row<TData>[];
-    isInteractive: boolean;
-    /** Dimension conditions of a row, from the table's capture builder. */
-    conditionsForRow: (row: Row<TData>) => ClickFilterCondition[] | undefined;
-    /** The dimension field a column shows, if any. */
-    fieldForColumnId: (columnId: string) => Field | undefined;
-}): {
-    isEnabled: boolean;
-    checkboxesShown: boolean;
-    hasSelection: boolean;
-    handleRowClick: (event: Pick<React.MouseEvent, "shiftKey" | "metaKey" | "ctrlKey" | "nativeEvent">, row: Row<TData>, columnId: string | undefined) => TableRowClickOutcome;
-    clear: () => void;
-};

package/dist/types/lib/hooks/semaphor-ready-indicator.d.ts

@@ -1,17 +0,0 @@
-type SemaphorReadyIndicatorProps = {
-    delayMs?: number;
-    quietMs?: number;
-    componentType: 'surfboard' | 'dashboard' | 'visual';
-    componentId?: string;
-};
-/**
- * Component that renders a ready indicator for PDF generation.
- *
- * Provides two signals:
- * 1. DOM element: `#idle-check` with text "ready" (for Puppeteer to detect)
- * 2. Window object: `window.__SEMAPHOR_READY__` with detailed info
- *
- * The element is visually hidden (sr-only pattern) so it doesn't affect layouts.
- */
-export declare function SemaphorReadyIndicator({ delayMs, quietMs, componentType, componentId, }: SemaphorReadyIndicatorProps): import("react").JSX.Element;
-export {};

package/dist/types/lib/hooks/summary/create-summary-action-handler.d.ts

@@ -1,15 +0,0 @@
-import { TFilterValue } from '../../../components/surfboard/filter/types.js';
-import { TEvent } from '../../types/common-types.js';
-import { SummaryAction } from '../../types/summary-types.js';
-type FiltersUpdater = (filterValues: TFilterValue[]) => void;
-type EventHandler = ((event: TEvent) => void) | undefined;
-type SummaryActionHandlerParams = {
-    addOrUpdateFilterValues: FiltersUpdater;
-    onEvent: EventHandler;
-    refresh: () => Promise<unknown>;
-    selectedSheetId?: string | null;
-    cardId?: string;
-    onChangeComparison?: (action: SummaryAction) => void | Promise<void>;
-};
-export declare function createSummaryActionHandler({ addOrUpdateFilterValues, onEvent, refresh, selectedSheetId, cardId, onChangeComparison, }: SummaryActionHandlerParams): (action: SummaryAction) => Promise<void>;
-export {};

package/dist/types/lib/hooks/use-assign-filter.d.ts

@@ -1,5 +0,0 @@
-import { FilterLocation } from '../../components/surfboard/filter/types.js';
-import { Field } from '../types/explorer-types.js';
-export declare function useAssignFilter(): {
-    assignFilter: (field: Field, location?: FilterLocation) => string | undefined;
-};

package/dist/types/lib/hooks/use-attribute-values.d.ts

@@ -1,20 +0,0 @@
-import { Field } from '../types/explorer-types.js';
-export interface AttributeValue {
-    id: string | number;
-    value: any;
-    label?: string;
-}
-interface UseAttributeValuesOptions {
-    field: Field;
-    searchQuery?: string;
-    limit?: number;
-}
-export declare function useAttributeValues({ field, searchQuery, limit, }: UseAttributeValuesOptions): {
-    values: AttributeValue[];
-    isLoading: boolean;
-    isFetching: boolean;
-    isError: boolean;
-    error: Error | null;
-    refetch: (options?: import('@tanstack/query-core').RefetchOptions) => Promise<import('@tanstack/query-core').QueryObserverResult<AttributeValue[], Error>>;
-};
-export {};

package/dist/types/lib/hooks/use-auth-token.d.ts

@@ -1 +0,0 @@
-export declare function useAuthToken(): import('../types/index.js').AuthToken | undefined;

package/dist/types/lib/hooks/use-authorization-scope.d.ts

@@ -1,2 +0,0 @@
-/** One opaque cache namespace per host and credential revision, never a token key. */
-export declare function useAuthorizationScope(token: string | undefined): string;

package/dist/types/lib/hooks/use-calendar-preferences.d.ts

@@ -1,16 +0,0 @@
-import { CalendarPreferences, CalendarPreferencesResponse } from '../../shared/report-runtime-context/index.js';
-interface UseCalendarPreferencesResult {
-    preferences: CalendarPreferencesResponse | null;
-    isLoading: boolean;
-    isSaving: boolean;
-    isClearing: boolean;
-    error: string | null;
-    updatePreferences: (prefs: CalendarPreferences) => Promise<boolean>;
-    clearPreferences: () => Promise<boolean>;
-    refetch: () => Promise<void>;
-}
-interface UseCalendarPreferencesOptions {
-    enabled?: boolean;
-}
-export declare function useCalendarPreferences(options?: UseCalendarPreferencesOptions): UseCalendarPreferencesResult;
-export {};

package/dist/types/lib/hooks/use-card-filter-values.d.ts

@@ -1,19 +0,0 @@
-/**
- * React hook that returns filters and filter values applicable to a specific card,
- * taking into account both sheet-level and card-level scoping.
- *
- * This hook fetches the necessary data from the dashboard store and delegates
- * the filtering logic to the calculateCardFilterValues utility function.
- *
- * Scoping logic:
- * 1. Sheet-level scope is applied first (applyToSheetIds, excludeSheetIds)
- * 2. Card-level scope is applied second (applyToCardIds, excludeCardIds)
- * 3. Filters without scope properties apply to all sheets/cards (default)
- *
- * @param cardId - The ID of the card to get filters for
- * @returns Object containing cardFilters and cardFilterValues
- */
-export declare function useCardFilterValues(cardId: string): {
-    cardFilters: import('../types/index.js').TFilter[] | undefined;
-    cardFilterValues: import('../types/index.js').TFilterValue[] | undefined;
-};

package/dist/types/lib/hooks/use-card-numeric-presentation.d.ts

@@ -1,11 +0,0 @@
-import { ResolvedValueFormatPreferences } from '../../shared/value-format-preferences/index.js';
-import { CurrencyPresentationTarget, TCard } from '../types/common-types.js';
-import { CardNumericPresentationContext } from '../formatters/numeric-presentation.js';
-import { MatrixCardCatalog } from '../matrix-table/matrix-card-adapter.js';
-export declare function useCardNumericPresentation(card?: TCard, resultColumnKeys?: readonly string[], matrixCatalog?: MatrixCardCatalog): CardNumericPresentationContext;
-export declare function usePrimaryKpiNumericPresentation(card: TCard, records?: Record<string, unknown>[] | null): {
-    preferences: ResolvedValueFormatPreferences | null;
-    boundCurrency?: string;
-    resultColumnKeys: readonly string[];
-    resolveBoundCurrency: (target: CurrencyPresentationTarget) => string | undefined;
-};

package/dist/types/lib/hooks/use-card-render-context.d.ts

@@ -1,14 +0,0 @@
-import { PivotTableResponse } from '../../components/visual/pivot-table/types.js';
-import { QueryExecutionResponse } from '../types/explorer-types.js';
-import { TCard } from '../types/common-types.js';
-type CardRenderQueryData = (QueryExecutionResponse & Pick<Partial<PivotTableResponse>, 'groupByColumns'>) | null | undefined;
-/**
- * Pairs a card with the config that produced its current result, so table
- * and pivot renderers never read retained rows against stale drill state.
- */
-export declare function useCardRenderContext(card: TCard, effectiveCardConfig: TCard['config'] | undefined, queryData: CardRenderQueryData): {
-    renderCard: TCard;
-    tableRecords: any[];
-    pivotTableConfig: import('../../components/visual/pivot-table/pivot-table.js').PivotTableConfig | null;
-};
-export {};

package/dist/types/lib/hooks/use-chart-numeric-presentation.d.ts

@@ -1,3 +0,0 @@
-import { TCard } from '../types/common-types.js';
-import { ChartNumericPresentationContext } from '../formatters/chart-numeric-presentation.js';
-export declare function useChartNumericPresentation(card: TCard | undefined, records?: readonly Record<string, unknown>[]): ChartNumericPresentationContext;