drizzle-cube 0.6.1 → 0.6.3

package/dist/cjs/client/components/AnalysisBuilder/RetentionModeContent.d.ts

@@ -0,0 +1,71 @@
+import { CubeMeta, FunnelBindingKey, ChartType, ChartDisplayConfig, Filter } from '../../types.js';
+import { ColorPalette } from '../../utils/colorPalettes.js';
+import { DateRange, RetentionGranularity, RetentionType, RetentionBreakdownItem } from '../../types/retention.js';
+export interface RetentionModeContentProps {
+    /** Currently selected cube for retention analysis */
+    retentionCube: string | null;
+    /** Binding key that links events to entities */
+    retentionBindingKey: FunnelBindingKey | null;
+    /** Time dimension for event ordering */
+    retentionTimeDimension: string | null;
+    /** Date range for cohort analysis */
+    retentionDateRange: DateRange;
+    /** Cohort filters - define who enters the cohort */
+    retentionCohortFilters: Filter[];
+    /** Activity filters - define what counts as a return */
+    retentionActivityFilters: Filter[];
+    /** Breakdown dimensions for segmentation */
+    retentionBreakdowns: RetentionBreakdownItem[];
+    /** Granularity for viewing retention periods */
+    retentionViewGranularity: RetentionGranularity;
+    /** Number of periods to analyze */
+    retentionPeriods: number;
+    /** Retention calculation type */
+    retentionType: RetentionType;
+    /** Cube metadata for field selection */
+    schema: CubeMeta | null;
+    /** Callback when cube changes */
+    onCubeChange: (cube: string | null) => void;
+    /** Callback when binding key changes */
+    onBindingKeyChange: (key: FunnelBindingKey | null) => void;
+    /** Callback when time dimension changes */
+    onTimeDimensionChange: (dim: string | null) => void;
+    /** Callback when date range changes */
+    onDateRangeChange: (range: DateRange) => void;
+    /** Callback when cohort filters change */
+    onCohortFiltersChange: (filters: Filter[]) => void;
+    /** Callback when activity filters change */
+    onActivityFiltersChange: (filters: Filter[]) => void;
+    /** Callback when breakdowns change (set all) */
+    onBreakdownsChange: (breakdowns: RetentionBreakdownItem[]) => void;
+    /** Callback to add a breakdown */
+    onAddBreakdown: (breakdown: RetentionBreakdownItem) => void;
+    /** Callback to remove a breakdown */
+    onRemoveBreakdown: (field: string) => void;
+    /** Callback when granularity changes */
+    onGranularityChange: (granularity: RetentionGranularity) => void;
+    /** Callback when periods changes */
+    onPeriodsChange: (periods: number) => void;
+    /** Callback when retention type changes */
+    onRetentionTypeChange: (type: RetentionType) => void;
+    /** Callback to open field modal for adding breakdowns */
+    onOpenFieldModal?: () => void;
+    /** Chart type for retention display */
+    chartType?: ChartType;
+    /** Callback when chart type changes */
+    onChartTypeChange?: (type: ChartType) => void;
+    /** Display configuration */
+    displayConfig?: ChartDisplayConfig;
+    /** Color palette */
+    colorPalette?: ColorPalette;
+    /** Callback when display config changes */
+    onDisplayConfigChange?: (config: ChartDisplayConfig) => void;
+}
+/**
+ * RetentionModeContent displays the complete retention configuration interface:
+ * - Tabs: Retention | Display
+ * - Retention tab: Config panel + cohort filter + activity filter + breakdown + settings
+ * - Display tab: Heatmap/chart display options
+ */
+declare const RetentionModeContent: import('react').NamedExoticComponent<RetentionModeContentProps>;
+export default RetentionModeContent;

package/dist/cjs/client/components/AnalysisBuilder/SectionHeading.d.ts

@@ -0,0 +1,12 @@
+import { ReactNode } from 'react';
+interface SectionHeadingProps {
+    children: ReactNode;
+    /** Optional className to add additional styles */
+    className?: string;
+}
+/**
+ * Consistent section heading style for Analysis Builder panels.
+ * Change the styles here to update all section headings at once.
+ */
+export default function SectionHeading({ children, className }: SectionHeadingProps): import("react").JSX.Element;
+export {};

package/dist/cjs/client/components/AnalysisBuilder/SortToggleButton.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SortToggleButton Component
+ *
+ * Shared sort-direction toggle used by MetricItemCard and BreakdownItemCard.
+ * Renders the direction icon, optional sort-priority badge, and tooltip.
+ */
+interface SortToggleButtonProps {
+    sortDirection?: 'asc' | 'desc' | null;
+    sortPriority?: number;
+    onToggleSort: () => void;
+}
+declare const SortToggleButton: import('react').NamedExoticComponent<SortToggleButtonProps>;
+export default SortToggleButton;

package/dist/cjs/client/components/AnalysisBuilder/StringArrayInput.d.ts

@@ -0,0 +1,17 @@
+/**
+ * StringArrayInput Component
+ *
+ * A textarea that edits an array of strings. Uses local state while editing and
+ * only commits to the parent on blur. Extracted from DisplayOptionControl so the
+ * structured-option renderers stay presentational. Behaviour is identical to the
+ * previous inline implementation.
+ */
+interface StringArrayInputProps {
+    label: string;
+    value: string[];
+    onChange: (value: string[]) => void;
+    placeholder?: string;
+    description?: string;
+}
+export default function StringArrayInput({ label, value, onChange, placeholder, description, }: StringArrayInputProps): import("react").JSX.Element;
+export {};

package/dist/cjs/client/components/AnalysisBuilder/filterConfigModalUtils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * filterConfigModalUtils
+ *
+ * Pure helpers extracted from FilterConfigModal to keep the component's effects
+ * and render flat. Behaviour is identical to the previous inline logic.
+ *
+ * `deriveRangeFromDateRange` lives in the shared `dateRangeUtils` module and is
+ * re-exported here to keep existing import paths stable.
+ */
+export type { DerivedRange } from '../shared/dateRangeUtils.js';
+export { deriveRangeFromDateRange } from '../shared/dateRangeUtils.js';
+/** Action the value-dropdown keyboard handler should apply, decided purely. */
+export type ValueKeyAction = {
+    type: 'none';
+} | {
+    type: 'highlight';
+    index: number;
+} | {
+    type: 'select';
+    index: number;
+} | {
+    type: 'close';
+};
+/**
+ * Pure keyboard-navigation logic for the filter value dropdown. Given the key
+ * and current state, returns the action to apply (no side effects), so the
+ * branchy decision can be unit-tested and the React handler stays a thin
+ * dispatcher.
+ */
+export declare function resolveValueKeyboardAction(key: string, isOpen: boolean, length: number, highlightedIndex: number): ValueKeyAction;

package/dist/cjs/client/components/AnalysisBuilder/hooks/useAnalysisBuilderImperativeHandle.d.ts

@@ -0,0 +1,13 @@
+import { Ref } from 'react';
+import { StoreApi } from 'zustand';
+import { AnalysisBuilderRef } from '../types.js';
+import { AnalysisBuilderStore } from '../../../stores/analysisBuilderStore.js';
+interface ImperativeHandleDeps {
+    getQueryConfig: AnalysisBuilderRef['getQueryConfig'];
+    getChartConfig: AnalysisBuilderRef['getChartConfig'];
+    getAnalysisType: AnalysisBuilderRef['getAnalysisType'];
+    clearQuery: AnalysisBuilderRef['clearQuery'];
+    storeApi: StoreApi<AnalysisBuilderStore>;
+}
+export declare function useAnalysisBuilderImperativeHandle(ref: Ref<AnalysisBuilderRef>, deps: ImperativeHandleDeps): void;
+export {};

package/dist/cjs/client/components/AnalysisBuilder/hooks/useDragReorder.d.ts

@@ -0,0 +1,25 @@
+import { DragEvent } from 'react';
+/**
+ * Calculate the vertical transform for an item while a drag is in progress.
+ * Pure helper extracted to keep the hook body flat.
+ */
+export declare function computeItemTransform(itemIndex: number, draggedIndex: number | null, dropTargetIndex: number | null): string;
+export interface DragReorderApi {
+    draggedIndex: number | null;
+    dropTargetIndex: number | null;
+    handleDragStart: (e: DragEvent, index: number) => void;
+    handleDragEnd: () => void;
+    handleItemDragOver: (e: DragEvent, itemIndex: number) => void;
+    handleItemDrop: (e: DragEvent) => void;
+    handleSectionDragLeave: (e: DragEvent) => void;
+    handleEndZoneDragOver: (e: DragEvent) => void;
+    getItemTransform: (itemIndex: number) => string;
+    shouldShowGapIndicator: (itemIndex: number) => boolean;
+}
+/**
+ * @param dragType  Label written into the drag dataTransfer payload.
+ * @param getField  Resolves the field name for a given index (for the payload).
+ * @param itemCount Current number of items (used for end-of-list drop zone).
+ * @param onReorder Optional reorder callback (fromIndex, toIndex).
+ */
+export declare function useDragReorder(dragType: string, getField: (index: number) => string, itemCount: number, onReorder?: (fromIndex: number, toIndex: number) => void): DragReorderApi;

package/dist/cjs/client/components/AnalysisBuilder/hooks/useFieldSearchKeyboard.d.ts

@@ -0,0 +1,11 @@
+import { KeyboardEvent, RefObject } from 'react';
+import { FieldOption } from '../types.js';
+export interface FieldSearchKeyboardApi {
+    focusedField: FieldOption | null;
+    setFocusedField: (field: FieldOption | null) => void;
+    focusedIndex: number;
+    setFocusedIndex: (index: number) => void;
+    resultsContainerRef: RefObject<HTMLDivElement>;
+    handleKeyDown: (e: KeyboardEvent) => void;
+}
+export declare function useFieldSearchKeyboard(flatFieldsList: FieldOption[], onSelectField: (field: FieldOption, fieldIndex: number, shiftKey: boolean) => void, onClose: () => void): FieldSearchKeyboardApi;

package/dist/cjs/client/components/AnalysisBuilder/index.d.ts

@@ -0,0 +1,9 @@
+import { AnalysisBuilderProps, AnalysisBuilderRef } from './types.js';
+/**
+ * AnalysisBuilder - Main exported component
+ *
+ * Wraps the inner component with the store provider to ensure
+ * each AnalysisBuilder instance has its own isolated state.
+ */
+declare const AnalysisBuilder: import('react').ForwardRefExoticComponent<AnalysisBuilderProps & import('react').RefAttributes<AnalysisBuilderRef>>;
+export default AnalysisBuilder;