react-semaphor 0.1.506 → 0.1.508

package/dist/types/lib/stores/interaction-store.d.ts

@@ -1,113 +0,0 @@
-import { ShelfCard } from '../utils/card-definition.js';
-import { InteractionEvent, InteractionState, ClickFilterEvent, ClickFilterCondition } from '../types/interaction-types.js';
-import { CardConfig, FilterGroup } from '../types/explorer-types.js';
-import { TCard } from '../types/common-types.js';
-/**
- * Special card ID for global drill-through context
- * Stores drill filters that apply to all cards on the destination dashboard
- */
-export declare const DRILL_CONTEXT_CARD_ID = "__DRILL_CONTEXT__";
-/**
- * Creates the initial state for interaction tracking
- */
-export declare function createInitialInteractionState(): InteractionState;
-interface InteractionStore {
-    /** Maps card IDs to their interaction states */
-    interactionStates: Record<string, InteractionState>;
-    /** Maps card IDs to insight replacements (for replace-card display mode) */
-    replacedCards: Record<string, {
-        insightId: string;
-        filters?: any[];
-        contextMode?: 'interactionFilters' | 'full' | 'none';
-    }>;
-    /** Pending drill-through navigation (waiting for metadata to load) */
-    pendingDrillThrough: {
-        targetDashboardId: string;
-        sourceDashboardId: string;
-        sourceDashboardTitle?: string;
-        filters: ClickFilterCondition[];
-        contextMode: 'interactionFilters' | 'full' | 'none';
-    } | null;
-    /** Sets the interaction state for a specific card */
-    setInteractionState: (cardId: string, state: InteractionState) => void;
-    /** Resets the interaction state for a specific card to initial state */
-    resetInteractionState: (cardId: string) => void;
-    /** Applies an interaction event to a card, optionally replacing existing events */
-    applyInteractionEvent: (cardId: string, event: InteractionEvent, replaceExisting?: boolean) => void;
-    /** Toggles a click filter on/off for a card */
-    toggleClickFilter: (cardId: string, event: ClickFilterEvent) => void;
-    /** Removes click filters that match a specific field-value combination */
-    removeClickFiltersByValue: (cardId: string, fieldName: string, value: string | number | null) => void;
-    /** Removes the last interaction step (breadcrumb) from a card */
-    popInteractionStep: (cardId: string) => void;
-    /** Clears the last interaction event for a card (after execution) */
-    clearLastInteractionEvent: (cardId: string) => void;
-    /** Replaces a card with an insight (for replace-card display mode) */
-    replaceCardWithInsight: (cardId: string, insightId: string, filters?: any[], contextMode?: 'interactionFilters' | 'full' | 'none') => void;
-    /** Restores a replaced card to its original state */
-    restoreCard: (cardId: string) => void;
-    /** Clears all click filters across all cards */
-    clearAllClickFilters: () => void;
-    /** Sets pending drill-through navigation */
-    setPendingDrillThrough: (params: {
-        targetDashboardId: string;
-        sourceDashboardId: string;
-        sourceDashboardTitle?: string;
-        filters: ClickFilterCondition[];
-        contextMode: 'interactionFilters' | 'full' | 'none';
-    }) => void;
-    /** Clears pending drill-through navigation */
-    clearPendingDrillThrough: () => void;
-    /** Resets all interaction states. Called when loading a new dashboard. */
-    resetAllInteractionStates: () => void;
-}
-export declare const useInteractionStore: import('zustand').UseBoundStore<Omit<import('zustand').StoreApi<InteractionStore>, "setState" | "devtools"> & {
-    setState(partial: InteractionStore | Partial<InteractionStore> | ((state: InteractionStore) => InteractionStore | Partial<InteractionStore>), replace?: false | undefined, action?: (string | {
-        [x: string]: unknown;
-        [x: number]: unknown;
-        [x: symbol]: unknown;
-        type: string;
-    }) | undefined): void;
-    setState(state: InteractionStore | ((state: InteractionStore) => InteractionStore), replace: true, action?: (string | {
-        [x: string]: unknown;
-        [x: number]: unknown;
-        [x: symbol]: unknown;
-        type: string;
-    }) | undefined): void;
-    devtools: {
-        cleanup: () => void;
-    };
-}>;
-/**
- * Hook to get all click filters that apply to a specific card
- * Filters out filters from the card itself and applies inclusion/exclusion rules
- */
-export declare function getClickFiltersForCardFromStates(cardId: string, interactionStates: Record<string, InteractionState | undefined>): ClickFilterEvent[];
-export declare const useClickFiltersForCard: (cardId: string) => ClickFilterEvent[];
-/**
- * Combines static filters, click filters, and drill breadcrumbs into a single merged FilterGroup.
- *
- * Filter combination logic:
- * - Inside a filter group (group.filters): AND
- * - Between filter groups in ClickFilterEvent or DrillBreadcrumb: OR
- * - Between breadcrumbs (drill steps): AND
- * - Between click filters, drill filters, and static filters: AND
- */
-export declare function resolveFiltersFromInteractionStates(card: TCard, interactionStates: Record<string, InteractionState | undefined>, currentDashboardId?: string, options?: {
-    includeAuthoredFilters?: boolean;
-}): FilterGroup | undefined;
-export declare function useResolvedFilters(card: TCard): FilterGroup | undefined;
-/**
- * Returns a modified copy of card.config where groupBy is overridden
- * by the most recent drill target field from breadcrumbs (if any).
- * Also updates sortByColumns to prevent SQL errors when drilling.
- */
-export declare function resolveCardConfigFromInteractionStates(card: TCard, interactionStates: Record<string, InteractionState | undefined>, resolvedFilters?: FilterGroup): CardConfig;
-export declare function resolveShelfCardConfigFromInteractionStates(card: ShelfCard, interactionStates: Record<string, InteractionState | undefined>, resolvedFilters?: FilterGroup): CardConfig;
-export declare function useResolvedCardConfig(card: TCard): CardConfig;
-/**
- * Generates a stable key for React Query based on the final resolved filters
- */
-export declare function getFinalFilterGroupKeyFromInteractionStates(card: TCard, interactionStates: Record<string, InteractionState | undefined>, resolvedFilters?: FilterGroup): string | undefined;
-export declare function useFinalFilterGroupKey(card: TCard): string | undefined;
-export {};

package/dist/types/lib/stores/pointer-interaction-store.d.ts

@@ -1,18 +0,0 @@
-import { ClickFilterCondition, ClickedMetricValue } from '../types/interaction-types.js';
-export type PointerInteractionType = 'leftClick' | 'rightClick' | 'hover' | 'longPress' | 'multiClick';
-export interface PointerInteractionContext {
-    type: PointerInteractionType;
-    cardId: string;
-    conditions: ClickFilterCondition[];
-    metric?: ClickedMetricValue;
-    anchorPosition?: {
-        x: number;
-        y: number;
-    };
-}
-export declare const usePointerInteractionStore: import('zustand').UseBoundStore<import('zustand').StoreApi<{
-    context: PointerInteractionContext | null;
-    setContext: (ctx: PointerInteractionContext) => void;
-    appendCondition: (cond: ClickFilterCondition) => void;
-    clear: () => void;
-}>>;