drizzle-cube 0.6.1 → 0.6.2

package/dist/cjs/client/icons/types.d.ts

@@ -0,0 +1,129 @@
+import { IconifyIcon } from '@iconify/types';
+import { ComponentType, CSSProperties } from 'react';
+/**
+ * Icon categories for organization and filtering
+ */
+export type IconCategory = 'action' | 'field' | 'chart' | 'measure' | 'state' | 'navigation';
+/**
+ * Standard icon component props
+ */
+export interface IconProps {
+    className?: string;
+    'aria-hidden'?: boolean;
+    style?: CSSProperties;
+}
+/**
+ * Icon component type that can be used in JSX
+ */
+export type IconComponent = ComponentType<IconProps>;
+/**
+ * Icon definition with Iconify data and metadata
+ */
+export interface IconDefinition {
+    /** The Iconify icon data */
+    icon: IconifyIcon;
+    /** Category for filtering/organization */
+    category: IconCategory;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Complete icon registry with all available icons
+ */
+export interface IconRegistry {
+    close: IconDefinition;
+    add: IconDefinition;
+    edit: IconDefinition;
+    delete: IconDefinition;
+    refresh: IconDefinition;
+    copy: IconDefinition;
+    duplicate: IconDefinition;
+    settings: IconDefinition;
+    filter: IconDefinition;
+    share: IconDefinition;
+    expand: IconDefinition;
+    collapse: IconDefinition;
+    search: IconDefinition;
+    menu: IconDefinition;
+    run: IconDefinition;
+    check: IconDefinition;
+    link: IconDefinition;
+    eye: IconDefinition;
+    eyeOff: IconDefinition;
+    adjustments: IconDefinition;
+    desktop: IconDefinition;
+    table: IconDefinition;
+    sun: IconDefinition;
+    moon: IconDefinition;
+    ellipsisHorizontal: IconDefinition;
+    documentText: IconDefinition;
+    bookOpen: IconDefinition;
+    codeBracket: IconDefinition;
+    swatch: IconDefinition;
+    camera: IconDefinition;
+    thumbUp: IconDefinition;
+    thumbDown: IconDefinition;
+    schemaGraph: IconDefinition;
+    cube: IconDefinition;
+    download: IconDefinition;
+    measure: IconDefinition;
+    dimension: IconDefinition;
+    timeDimension: IconDefinition;
+    segment: IconDefinition;
+    chartBar: IconDefinition;
+    chartLine: IconDefinition;
+    chartArea: IconDefinition;
+    chartPie: IconDefinition;
+    chartScatter: IconDefinition;
+    chartBubble: IconDefinition;
+    chartRadar: IconDefinition;
+    chartRadialBar: IconDefinition;
+    chartTreemap: IconDefinition;
+    chartTable: IconDefinition;
+    chartActivityGrid: IconDefinition;
+    chartKpiNumber: IconDefinition;
+    chartKpiDelta: IconDefinition;
+    chartKpiText: IconDefinition;
+    chartMarkdown: IconDefinition;
+    chartFunnel: IconDefinition;
+    chartSankey: IconDefinition;
+    chartSunburst: IconDefinition;
+    chartHeatmap: IconDefinition;
+    chartRetention: IconDefinition;
+    measureCount: IconDefinition;
+    measureCountDistinct: IconDefinition;
+    measureCountDistinctApprox: IconDefinition;
+    measureSum: IconDefinition;
+    measureAvg: IconDefinition;
+    measureMin: IconDefinition;
+    measureMax: IconDefinition;
+    measureRunningTotal: IconDefinition;
+    measureCalculated: IconDefinition;
+    measureNumber: IconDefinition;
+    success: IconDefinition;
+    warning: IconDefinition;
+    error: IconDefinition;
+    info: IconDefinition;
+    loading: IconDefinition;
+    sparkles: IconDefinition;
+    chevronUp: IconDefinition;
+    chevronDown: IconDefinition;
+    chevronLeft: IconDefinition;
+    chevronRight: IconDefinition;
+    chevronUpDown: IconDefinition;
+    arrowUp: IconDefinition;
+    arrowDown: IconDefinition;
+    arrowRight: IconDefinition;
+    arrowPath: IconDefinition;
+}
+/**
+ * Type for icon registry keys
+ */
+export type IconName = keyof IconRegistry;
+/**
+ * Partial icon registry for user overrides
+ * Users can provide just the IconifyIcon or a full IconDefinition
+ */
+export type PartialIconRegistry = Partial<{
+    [K in keyof IconRegistry]: IconifyIcon | Partial<IconDefinition>;
+}>;

package/dist/cjs/client/icons.d.ts

@@ -0,0 +1,2 @@
+export * from './icons/index.js'
+export {}

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

@@ -0,0 +1,76 @@
+export { default as AnalyticsPortlet } from './components/AnalyticsPortlet.js';
+export { default as AnalyticsDashboard } from './components/AnalyticsDashboard.js';
+export { default as AgenticNotebook } from './components/AgenticNotebook/index.js';
+export type { AgenticNotebookProps } from './components/AgenticNotebook/index.js';
+export { AnalyticsPage } from './components/AnalyticsPage.js';
+export { default as ChartErrorBoundary } from './components/ChartErrorBoundary.js';
+export { default as LoadingIndicator } from './components/LoadingIndicator.js';
+export type { LoadingIndicatorProps } from './components/LoadingIndicator.js';
+export { default as DataBrowser } from './components/DataBrowser/index.js';
+export type { DataBrowserProps } from './components/DataBrowser/index.js';
+export { LazyChart, preloadChart, preloadCharts, isValidChartType, getAvailableChartTypes, isChartTypeAvailable, getUnavailableChartTypes } from './charts/ChartLoader.js';
+export type { LazyChartProps } from './charts/ChartLoader.js';
+export { default as DashboardGrid } from './components/DashboardGrid.js';
+export { DashboardProvider, DashboardToolbar, DashboardFilterBar, DashboardGridSurface, DashboardModals, useDashboardContext, } from './components/dashboard/index.js';
+export type { DashboardContextValue, DashboardProviderProps } from './components/dashboard/index.js';
+export { default as PortletContainer } from './components/PortletContainer.js';
+export { default as DrillMenu } from './components/DrillMenu.js';
+export { default as DrillBreadcrumb } from './components/DrillBreadcrumb.js';
+export { DashboardThumbnailPlaceholder } from './components/DashboardThumbnailPlaceholder.js';
+export type { DashboardThumbnailPlaceholderProps } from './components/DashboardThumbnailPlaceholder.js';
+export { default as PortletAnalysisModal } from './components/PortletAnalysisModal.js';
+export { default as DashboardEditModal } from './components/DashboardEditModal.js';
+export { default as Modal } from './components/Modal.js';
+export { default as ConfirmModal } from './components/ConfirmModal.js';
+export { default as AnalysisBuilder } from './components/AnalysisBuilderLazy.js';
+export type { AnalysisBuilderRef } from './components/AnalysisBuilder/types.js';
+export { ExecutionPlanPanel } from './components/AnalysisBuilder/ExecutionPlanPanel.js';
+export { ExplainAIPanel } from './components/AnalysisBuilder/ExplainAIPanel.js';
+export type { SchemaVisualizationProps } from './components/SchemaVisualization/index.js';
+export { CubeProvider, useCubeContext, useCubeApi, // Only re-renders on API/auth changes
+useCubeMeta, // Only re-renders on metadata changes
+useCubeFeatures } from './providers/CubeProvider.js';
+export { ScrollContainerProvider, useScrollContainer } from './providers/ScrollContainerContext.js';
+export { useCubeFieldLabel } from './hooks/useCubeFieldLabel.js';
+export { createCubeClient } from './client/CubeClient.js';
+export { CubeClient } from './client/CubeClient.js';
+export { useCubeMetaQuery, useCubeLoadQuery, useCubeQuery, useMultiCubeLoadQuery, useDryRunQuery, useMultiDryRunQueries, useDryRunQueries, useExplainQuery, createExplainQueryKey, useExplainAI, useFunnelQuery, createFunnelQueryKey, useFlowQuery, createFlowQueryKey, } from './hooks/queries/index.js';
+export type { UseCubeMetaQueryOptions, UseCubeMetaQueryResult, UseCubeLoadQueryOptions, UseCubeLoadQueryResult, UseMultiCubeLoadQueryOptions, UseMultiCubeLoadQueryResult, DebugDataEntry, UseExplainQueryOptions, UseExplainQueryResult, UseExplainAIOptions, UseExplainAIResult, UseFlowQueryOptions, UseFlowQueryResult, } from './hooks/queries/index.js';
+export { useAnalysisBuilder } from './hooks/useAnalysisBuilderHook.js';
+export type { UseAnalysisBuilderOptions, UseAnalysisBuilderResult, } from './hooks/useAnalysisBuilderHook.js';
+export { useDataBrowser } from './hooks/useDataBrowser.js';
+export { useDashboard } from './hooks/useDashboardHook.js';
+export type { UseDashboardOptions, UseDashboardResult, UseDashboardActions, } from './hooks/useDashboardHook.js';
+export { useAnalysisBuilderStore, selectCurrentState, selectMetrics, selectBreakdowns, selectFilters, selectChartConfig, selectUIState, selectMultiQueryState, selectFunnelState, } from './stores/analysisBuilderStore.js';
+export type { AnalysisBuilderStore, AnalysisBuilderStoreState, AnalysisBuilderStoreActions, FieldModalMode, } from './stores/analysisBuilderStore.js';
+export { DashboardStoreProvider, useDashboardStore, useDashboardStoreApi, useDashboardStoreOptional, createDashboardStore, selectEditModeState, selectModalState, selectLayoutState, selectDebugData, selectPortletDebugData, selectEditModeActions, selectModalActions, selectLayoutActions, selectDebugDataActions, selectThumbnailDirty, selectAllActions, } from './stores/dashboardStore.js';
+export type { DashboardStore, DashboardStoreState, DashboardStoreActions, PortletDebugDataEntry, DragState, CreateDashboardStoreOptions, DashboardStoreProviderProps, } from './stores/dashboardStore.js';
+export { NotebookStoreProvider, useNotebookStore, createNotebookStore, selectBlocks, selectMessages, selectIsStreaming, selectSessionId, selectInputValue, selectChatState, selectChatActions, selectBlockActions, } from './stores/notebookStore.js';
+export type { NotebookStore, NotebookStoreState, NotebookStoreActions, NotebookStoreProviderProps, NotebookConfig, NotebookBlock, PortletBlock, MarkdownBlock, ChatMessage, ToolCallRecord, } from './stores/notebookStore.js';
+export { useAgentChat } from './hooks/useAgentChat.js';
+export type { UseAgentChatOptions, UseAgentChatResult } from './hooks/useAgentChat.js';
+export { validateMultiQueryConfig, validateTimeDimensionAlignment, validateMergeKeys, detectMeasureCollisions, detectAsymmetricDateRanges, isMultiQueryValid, getValidationSummary } from './utils/multiQueryValidation.js';
+export type { MultiQueryValidationError, MultiQueryValidationWarning, MultiQueryValidationResult } from './utils/multiQueryValidation.js';
+export { useTheme } from './hooks/useTheme.js';
+export { useScrollDetection } from './hooks/useScrollDetection.js';
+export { useElementVisibility } from './hooks/useElementVisibility.js';
+export { useDrillInteraction } from './hooks/useDrillInteraction.js';
+export type { PortletConfig, ChartType, BuiltInChartType, ChartAxisConfig, ChartDisplayConfig, CubeQuery, CubeQueryOptions, CubeApiOptions, DashboardConfig, FeaturesConfig, XlsExportFeatureConfig, ThumbnailFeatureConfig, MultiQueryConfig, QueryMergeStrategy, FunnelBindingKey, FunnelBindingKeyMapping, FunnelStep, FunnelConfig, FunnelStepResult, FunnelExecutionResult, FunnelChartData, FunnelValidationError, FunnelValidationResult, UseFunnelQueryOptions, UseFunnelQueryResult, ServerFlowQuery, FlowQueryConfig, FlowChartData, FlowSliceState, SankeyNode, SankeyLink, FlowStartingStep, FlowResultRow, } from './types.js';
+export { isQueryConfig, isFunnelConfig, isFlowConfig, isRetentionConfig, isMultiQuery, isSingleQuery, isValidAnalysisConfig, createDefaultQueryConfig, createDefaultFunnelConfig, createDefaultFlowConfig, createDefaultRetentionConfig, createDefaultConfig, isValidAnalysisWorkspace, createDefaultWorkspace } from './types/analysisConfig.js';
+export type { AnalysisConfig, QueryAnalysisConfig, FunnelAnalysisConfig, FlowAnalysisConfig, RetentionAnalysisConfig, AnalysisWorkspace } from './types/analysisConfig.js';
+export { isMultiQueryConfig, isServerFunnelQuery, isServerFlowQuery, isSankeyData } from './types.js';
+export type { ChartTypeConfig, DisplayOptionConfig, AxisDropZoneConfig } from './charts/chartConfigs.js';
+export type { ChartDefinition } from './charts/chartPlugin.js';
+export { chartPluginRegistry } from './charts/chartPlugin.js';
+export { createDashboardLayout, formatChartData, highlightCodeBlocks } from './utils/index.js';
+export { migrateConfig, migrateLegacyPortlet } from './utils/configMigration.js';
+export { captureThumbnail, isThumbnailCaptureAvailable, warnIfScreenshotLibMissing } from './utils/thumbnail.js';
+export { exportPortletToXlsx, isExportAvailable, warnIfExcelJsMissing } from './utils/exportXlsx.js';
+export { compressAndEncode, decodeAndDecompress, generateShareUrl, parseShareUrl, isShareableSize } from './utils/shareUtils.js';
+export { isMultiQueryData, mergeQueryResults, mergeResultsConcat, mergeResultsByKey, getCombinedFields, getQueryLabels, getQueryIndices, generateQueryLabel, validateMergeKey } from './utils/multiQueryUtils.js';
+export { validateFunnelConfig, validateBindingKeyExists, validateStepQueries, validateBindingKeyForSteps, isMinimumFunnelConfigValid, getAvailableBindingKeyDimensions, getBindingKeyLabel, } from './utils/funnelValidation.js';
+export { getBindingKeyField, getCubeNameFromQuery, formatDuration, transformServerFunnelResult, buildServerFunnelQuery, isFunnelData, buildFunnelConfigFromQueries, } from './utils/funnelExecution.js';
+export { getThemeVariable, setThemeVariable, applyTheme, resetTheme, getTheme, setTheme, isDarkMode, watchThemeChanges, THEME_PRESETS } from './theme/index.js';
+export type { ThemeColorTokens, ThemeConfig, Theme } from './theme/index.js';
+export { getIcon, getIconData, setIcon, registerIcons, resetIcons, getIconRegistry, getIconsByCategory, getMeasureTypeIcon, getChartTypeIcon, getFieldTypeIcon, DEFAULT_ICONS } from './icons/index.js';
+export type { IconCategory, IconProps, IconComponent, IconDefinition, IconRegistry, IconName, PartialIconRegistry } from './icons/index.js';

package/dist/cjs/client/providers/CubeApiProvider.d.ts

@@ -0,0 +1,24 @@
+import { ReactNode } from 'react';
+import { CubeClient } from '../client/CubeClient.js';
+import { CubeQueryOptions, CubeApiOptions } from '../types.js';
+import { BatchCoordinator } from '../client/BatchCoordinator.js';
+interface CubeApiContextValue {
+    cubeApi: CubeClient;
+    options?: CubeQueryOptions;
+    apiOptions: CubeApiOptions;
+    updateApiConfig: (apiOptions: CubeApiOptions, token?: string) => void;
+    batchCoordinator: BatchCoordinator | null;
+    enableBatching: boolean;
+}
+interface CubeApiProviderProps {
+    apiOptions: CubeApiOptions;
+    token?: string;
+    options?: CubeQueryOptions;
+    locale?: string;
+    enableBatching?: boolean;
+    batchDelayMs?: number;
+    children: ReactNode;
+}
+export declare function CubeApiProvider({ apiOptions: initialApiOptions, token: initialToken, options, locale, enableBatching, batchDelayMs, children }: CubeApiProviderProps): import("react").JSX.Element;
+export declare function useCubeApi(): CubeApiContextValue;
+export {};

package/dist/cjs/client/providers/CubeFeaturesProvider.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+import { FeaturesConfig, DashboardLayoutMode } from '../types.js';
+interface CubeFeaturesContextValue {
+    features: FeaturesConfig;
+    dashboardModes: DashboardLayoutMode[];
+    updateFeatures: (newFeatures: Partial<FeaturesConfig>) => void;
+}
+interface CubeFeaturesProviderProps {
+    features?: FeaturesConfig;
+    dashboardModes?: DashboardLayoutMode[];
+    children: ReactNode;
+}
+export declare function CubeFeaturesProvider({ features: initialFeatures, dashboardModes, children }: CubeFeaturesProviderProps): import("react").JSX.Element;
+/**
+ * Hook to access cube features context.
+ * Returns default values if used outside CubeFeaturesProvider (graceful fallback).
+ */
+export declare function useCubeFeatures(): CubeFeaturesContextValue;
+export {};

package/dist/cjs/client/providers/CubeMetaContext.d.ts

@@ -0,0 +1,11 @@
+import { CubeMeta, FieldLabelMap } from '../types.js';
+export interface CubeMetaContextValue {
+    meta: CubeMeta | null;
+    labelMap: FieldLabelMap;
+    metaLoading: boolean;
+    metaError: string | null;
+    getFieldLabel: (fieldName: string) => string;
+    refetchMeta: () => void;
+}
+export declare const CubeMetaContext: import('react').Context<CubeMetaContextValue | null>;
+export declare function useCubeMeta(): CubeMetaContextValue;

package/dist/cjs/client/providers/CubeMetaProvider.d.ts

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react';
+interface CubeMetaProviderProps {
+    children: ReactNode;
+}
+export declare function CubeMetaProvider({ children }: CubeMetaProviderProps): import("react").JSX.Element;
+export {};

package/dist/cjs/client/providers/CubeProvider.d.ts

@@ -0,0 +1,70 @@
+import { ReactNode } from 'react';
+import { QueryClient } from '@tanstack/react-query';
+import { useCubeApi } from './CubeApiProvider.js';
+import { useCubeMeta } from './CubeMetaContext.js';
+import { useCubeFeatures } from './CubeFeaturesProvider.js';
+import { CubeQueryOptions, CubeApiOptions, FeaturesConfig, DashboardLayoutMode, CubeMeta, FieldLabelMap } from '../types.js';
+import { CubeClient } from '../client/CubeClient.js';
+import { BatchCoordinator } from '../client/BatchCoordinator.js';
+import { ChartDefinition } from '../charts/chartPlugin.js';
+export declare const createCubeQueryClient: () => QueryClient;
+export declare const queryClient: QueryClient;
+interface CubeContextValue {
+    cubeApi: CubeClient;
+    options?: CubeQueryOptions;
+    meta: CubeMeta | null;
+    labelMap: FieldLabelMap;
+    metaLoading: boolean;
+    metaError: string | null;
+    getFieldLabel: (fieldName: string) => string;
+    refetchMeta: () => void;
+    updateApiConfig: (apiOptions: CubeApiOptions, token?: string) => void;
+    features: FeaturesConfig;
+    batchCoordinator: BatchCoordinator | null;
+    enableBatching: boolean;
+    dashboardModes: DashboardLayoutMode[];
+}
+interface CubeProviderProps {
+    cubeApi?: CubeClient;
+    apiOptions?: CubeApiOptions;
+    token?: string;
+    options?: CubeQueryOptions;
+    features?: FeaturesConfig;
+    dashboardModes?: DashboardLayoutMode[];
+    enableBatching?: boolean;
+    batchDelayMs?: number;
+    queryClient?: QueryClient;
+    /** Custom chart definitions to register. Overrides built-in charts when `type` matches. */
+    customCharts?: ChartDefinition[];
+    /** Locale code for i18n (default: 'en-GB'). Bundled locales are loaded via dynamic import. */
+    locale?: string;
+    /** Optional translation overrides merged on top of the loaded locale. */
+    translations?: Record<string, string>;
+    /** Enable i18n debug mode — logs console warnings for missing translation keys. */
+    debugI18n?: boolean;
+    children: ReactNode;
+}
+/**
+ * CubeProvider - Three-layer context wrapper
+ *
+ * Wraps children in three isolated context providers for optimal performance:
+ * 1. CubeApiProvider - Stable API layer (changes only on auth)
+ * 2. CubeMetaProvider - Metadata layer (changes on metadata load)
+ * 3. CubeFeaturesProvider - Feature flags layer (changes on feature updates)
+ */
+export declare function CubeProvider({ cubeApi: _initialCubeApi, // Intentionally unused - for backward compatibility
+apiOptions, token, options, features, dashboardModes, enableBatching, batchDelayMs, queryClient: providedQueryClient, customCharts, locale, translations, debugI18n, children }: CubeProviderProps): import("react").JSX.Element;
+/**
+ * useCubeContext - Backward compatible hook
+ *
+ * Merges all three contexts into a single object for backward compatibility.
+ * Components using this hook will re-render when ANY context changes.
+ *
+ * For better performance, use specialized hooks:
+ * - useCubeApi() - Only re-renders on API changes
+ * - useCubeMeta() - Only re-renders on metadata changes
+ * - useCubeFeatures() - Only re-renders on feature changes
+ */
+export declare function useCubeContext(): CubeContextValue;
+export { useCubeApi, useCubeMeta, useCubeFeatures };
+export { createCubeQueryClient as createQueryClient };

package/dist/cjs/client/providers/I18nProvider.d.ts

@@ -0,0 +1,18 @@
+import { ReactNode } from 'react';
+import { TranslationKey, TranslationParams } from '../../i18n/types.js';
+export interface I18nContextValue {
+    t: (key: TranslationKey, params?: TranslationParams) => string;
+    locale: string;
+}
+export declare const I18nContext: import('react').Context<I18nContextValue>;
+interface I18nProviderProps {
+    locale?: string;
+    translations?: Record<string, string>;
+    children: ReactNode;
+}
+/**
+ * I18nProvider — loads the requested locale and optionally merges consumer overrides.
+ * Wraps children with a React context providing `t()` and `locale`.
+ */
+export declare function I18nProvider({ locale, translations, children }: I18nProviderProps): import("react").JSX.Element;
+export {};

package/dist/cjs/client/providers/ScrollContainerContext.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ScrollContainerContext
+ *
+ * Provides the scroll container element for lazy loading with IntersectionObserver.
+ * This allows portlets to detect visibility relative to a custom scroll container
+ * (not just the viewport) when the dashboard is embedded in a scrolling div.
+ */
+/**
+ * Provider component to wrap dashboard content with a scroll container reference.
+ * Used by DashboardGrid and MobileStackedLayout to pass the detected scroll container
+ * to child portlets.
+ */
+export declare const ScrollContainerProvider: import('react').Provider<HTMLElement | null>;
+/**
+ * Hook to access the scroll container element for lazy loading.
+ * Returns null if using viewport (window) scroll, or the container element
+ * if the dashboard is inside a scrolling container.
+ */
+export declare const useScrollContainer: () => HTMLElement | null;

package/dist/cjs/client/providers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Drizzle Cube React Providers
+ *
+ * React providers and context only - for applications that need data providers
+ * without UI components.
+ */
+export { CubeProvider, useCubeContext } from './providers/CubeProvider.js';
+export { ScrollContainerProvider, useScrollContainer } from './providers/ScrollContainerContext.js';
+export { createCubeClient } from './client/CubeClient.js';
+export type { CubeApiOptions, CubeQueryOptions } from './types.js';

package/dist/cjs/client/schema.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Separate entry point for SchemaVisualization.
+ *
+ * This component requires @xyflow/react and elkjs as peer dependencies.
+ * It is exported separately to avoid pulling these optional dependencies
+ * into the main 'drizzle-cube/client' bundle, which would break
+ * webpack/Next.js builds that don't have them installed.
+ *
+ * Usage:
+ *   import { SchemaVisualization } from 'drizzle-cube/client/schema'
+ */
+export { SchemaVisualizationLazy as SchemaVisualization } from './components/SchemaVisualization/SchemaVisualizationLazy.js';
+export type { SchemaVisualizationProps } from './components/SchemaVisualization/index.js';

package/dist/cjs/client/shared/chartConfigBuilders.d.ts

@@ -0,0 +1,18 @@
+import { ChartType, ChartAxisConfig } from '../types.js';
+import { MetricItem, BreakdownItem } from '../components/AnalysisBuilder/types.js';
+/**
+ * Resolved breakdown selections passed to every axis builder.
+ */
+export interface AxisBuilderContext {
+    metrics: MetricItem[];
+    breakdowns: BreakdownItem[];
+    timeDimension: BreakdownItem | undefined;
+    dimension: BreakdownItem | undefined;
+    dimensions: BreakdownItem[];
+}
+type AxisBuilder = (ctx: AxisBuilderContext) => ChartAxisConfig;
+/**
+ * Resolve the axis builder for a chart type, falling back to the default.
+ */
+export declare function getAxisBuilder(chartType: ChartType): AxisBuilder;
+export {};

package/dist/cjs/client/shared/chartDefaults.d.ts

@@ -0,0 +1,59 @@
+import { ChartType, ChartAxisConfig } from '../types.js';
+import { MetricItem, BreakdownItem } from '../components/AnalysisBuilder/types.js';
+import { ChartAvailability } from '../charts/chartConfigs.js';
+/**
+ * Result of smart chart defaults calculation
+ */
+export interface SmartChartDefaults {
+    /** The recommended chart type */
+    chartType: ChartType;
+    /** The auto-configured chart axis settings */
+    chartConfig: ChartAxisConfig;
+}
+export type { ChartAvailability } from '../charts/chartConfigs.js';
+/**
+ * Map of chart type availability statuses
+ */
+export type ChartAvailabilityMap = Record<ChartType, ChartAvailability>;
+/**
+ * Check if a specific chart type is available given current selections.
+ * Delegates to each chart's own `isAvailable` declared in its .config.ts —
+ * availability requirements live next to the chart they describe, not here.
+ */
+export declare function getChartAvailability(chartType: ChartType, metrics: MetricItem[], breakdowns: BreakdownItem[]): ChartAvailability;
+/**
+ * Get availability for all chart types
+ */
+export declare function getAllChartAvailability(metrics: MetricItem[], breakdowns: BreakdownItem[]): ChartAvailabilityMap;
+/**
+ * Select the best chart type based on current metrics and breakdowns
+ *
+ * Priority order:
+ * 1. If current chart type is still valid, keep it (preserve user intent)
+ * 2. If current chart becomes invalid, switch to best alternative:
+ *    - Has time dimension → line
+ *    - Has dimension + measure → bar
+ *    - Has measures only → bar (or kpiNumber if single measure + no breakdowns)
+ *    - No fields → keep current
+ */
+export declare function selectBestChartType(metrics: MetricItem[], breakdowns: BreakdownItem[], currentChartType: ChartType): ChartType;
+/**
+ * Get smart default chart configuration based on chart type and selections
+ */
+export declare function getSmartChartDefaults(metrics: MetricItem[], breakdowns: BreakdownItem[], currentChartType: ChartType): SmartChartDefaults;
+/**
+ * Determine if chart type should be auto-switched based on selections change
+ *
+ * Returns the new chart type if a switch is recommended, or null if no change needed.
+ *
+ * @param metrics - Current metrics selection
+ * @param breakdowns - Current breakdowns selection
+ * @param currentChartType - Current chart type
+ * @param userManuallySelected - Whether user manually selected the current chart type
+ */
+export declare function shouldAutoSwitchChartType(metrics: MetricItem[], breakdowns: BreakdownItem[], currentChartType: ChartType, userManuallySelected: boolean): ChartType | null;
+/**
+ * Merge existing chart config with smart defaults
+ * Only fills in missing or invalid fields, preserves valid existing config
+ */
+export declare function mergeChartConfigWithDefaults(existingConfig: ChartAxisConfig, smartDefaults: ChartAxisConfig, metrics: MetricItem[], breakdowns: BreakdownItem[]): ChartAxisConfig;

package/dist/cjs/client/shared/components/CodeBlock.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+interface CodeBlockProps {
+    code: string;
+    language: 'json' | 'sql';
+    title?: string;
+    maxHeight?: string;
+    height?: string;
+    className?: string;
+    /** Additional content to render on the right side of the header (before Copy button) */
+    headerRight?: React.ReactNode;
+}
+export declare const CodeBlock: React.FC<CodeBlockProps>;
+export default CodeBlock;

package/dist/cjs/client/shared/components/QueryAnalysisPanel.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+import { QueryAnalysis } from '../types.js';
+interface QueryAnalysisPanelProps {
+    analysis: QueryAnalysis;
+}
+declare const QueryAnalysisPanel: React.FC<QueryAnalysisPanelProps>;
+export default QueryAnalysisPanel;

package/dist/cjs/client/shared/components/QueryAnalysisPanel.sections.d.ts

@@ -0,0 +1,41 @@
+import { default as React } from 'react';
+import { QueryAnalysis, JoinPathAnalysis } from '../types.js';
+/**
+ * Format reason string for display
+ */
+export declare function formatReason(reason: string): string;
+/**
+ * Get badge color based on reason
+ */
+export declare function getReasonBadgeClasses(reason: string): string;
+/**
+ * Render a single join path entry (header, steps, selection, candidates).
+ */
+export declare const JoinPathItem: React.FC<{
+    jp: JoinPathAnalysis;
+    primaryCube: string;
+}>;
+/**
+ * Render the "Join Paths" section (only when paths are present).
+ */
+export declare const JoinPathsSection: React.FC<{
+    analysis: QueryAnalysis;
+}>;
+/**
+ * Render the "Primary Cube" section.
+ */
+export declare const PrimaryCubeSection: React.FC<{
+    analysis: QueryAnalysis;
+}>;
+/**
+ * Render the "Pre-Aggregations" section (only when present).
+ */
+export declare const PreAggregationsSection: React.FC<{
+    analysis: QueryAnalysis;
+}>;
+/**
+ * Render the "Warnings" section (only when present).
+ */
+export declare const WarningsSection: React.FC<{
+    analysis: QueryAnalysis;
+}>;

package/dist/cjs/client/shared/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared module exports
+ * Common types, utilities, and components used across QueryBuilder and AnalysisBuilder
+ */
+export type { MetaField, MetaCube, MetaResponse, QueryAnalysis, PrimaryCubeSelectionReason, PrimaryCubeCandidate, PrimaryCubeAnalysis, JoinPathStep, JoinPathAnalysis, PreAggregationAnalysis, QuerySummary, ValidationResult, FilterOperatorMeta, DateRangeType, DateRangeOption, TimeGranularity } from './types.js';
+export { FILTER_OPERATORS, DATE_RANGE_OPTIONS, TIME_GRANULARITIES } from './types.js';
+export { isSimpleFilter, isGroupFilter, isAndFilter, isOrFilter, flattenFilters, countFilters, createSimpleFilter, createAndFilter, createOrFilter, transformFiltersForServer, transformFiltersFromServer, hasQueryContent, cleanQuery, cleanQueryForServer, transformQueryForUI, getCubeNameFromField, getFieldType, getFieldTitle, getAvailableOperators, getAllFilterableFields, convertDateRangeTypeToValue, requiresNumberInput, formatDateForCube } from './utils.js';
+export { default as QueryAnalysisPanel } from './components/QueryAnalysisPanel.js';
+export { default as CodeBlock } from './components/CodeBlock.js';
+export { getChartAvailability, getAllChartAvailability, selectBestChartType, getSmartChartDefaults, shouldAutoSwitchChartType, mergeChartConfigWithDefaults } from './chartDefaults.js';
+export type { SmartChartDefaults, ChartAvailability, ChartAvailabilityMap } from './chartDefaults.js';

package/dist/cjs/client/shared/queryKey.d.ts

@@ -0,0 +1 @@
+export declare function stableStringify(value: unknown): string;

package/dist/cjs/client/shared/queryTransforms.d.ts

@@ -0,0 +1,20 @@
+import { CubeQuery, Filter } from '../types.js';
+/**
+ * Clean query object by removing empty arrays.
+ *
+ * Leaf helper kept here (rather than in shared/utils.ts) so that
+ * `transformQueryForUIImpl` can use it without creating an import cycle back
+ * into utils.ts. Re-exported from utils.ts to keep existing import paths stable.
+ */
+export declare function cleanQuery(query: CubeQuery): CubeQuery;
+/**
+ * Transform a single filter from server/API format to UI format.
+ * Converts {and: [...]} / {or: [...]} to {type, filters} GroupFilter shape and
+ * recurses; passes simple filters through unchanged.
+ */
+export declare function transformFilterFromServer(filter: any): Filter | null | undefined;
+/**
+ * Transform a Cube.js query from external format to UI internal format.
+ * Handles format differences between server/API queries and QueryBuilder state.
+ */
+export declare function transformQueryForUIImpl(query: any, transformFiltersFromServer: (filters: any[]) => Filter[]): CubeQuery;