drizzle-cube 0.8.0 → 0.8.2

package/dist/client/components/analyticsPortlet/usePortletPagination.d.ts

@@ -0,0 +1,21 @@
+import { ChartPagination, ChartType, CubeQuery } from '../../types.js';
+/** Fixed page sizes, matching the records table's own `pageSize` option. */
+export declare const PAGE_SIZE_OPTIONS: number[];
+export interface UsePortletPaginationParams {
+    chartType: ChartType;
+    /** The query to paginate — the drilled query when one is active, else the base query. */
+    activeQuery: CubeQuery | null;
+    /** Authored page size from the portlet's display config. */
+    pageSize?: number;
+}
+export interface UsePortletPaginationResult {
+    /** `activeQuery` with limit/offset/order/total merged in, or it unchanged when paging is off. */
+    paginatedQuery: CubeQuery | null;
+    /**
+     * Passed to the chart as `ChartProps.pagination`; undefined when paging is
+     * off. `total` is left unset here — it arrives with the response, so the
+     * caller fills it in from the result set.
+     */
+    pagination?: Omit<ChartPagination, 'total'>;
+}
+export declare function usePortletPagination({ chartType, activeQuery, pageSize: authoredPageSize }: UsePortletPaginationParams): UsePortletPaginationResult;

package/dist/client/components/charts/DotStripChart.config.d.ts

@@ -0,0 +1,15 @@
+import { ChartTypeConfig } from '../../charts/chartConfigs.js';
+/**
+ * Configuration for the dot strip (beeswarm) chart type.
+ *
+ * Eager metadata (`label`, `description`, `useCase`, `isAvailable`) lives in the
+ * unified `chartRegistry` entry (the single source of truth) — see
+ * `src/client/charts/chartRegistry.ts`. This file owns the lazy-loaded shape:
+ * drop zones, display options, clickable elements, validation.
+ *
+ * The zone *keys* are the standard `xAxis` / `yAxis` / `series` (so no
+ * `ChartAxisConfig` change is needed), but the visual axes are transposed —
+ * bands are rows and the measure runs horizontally — so the labels name the
+ * roles rather than the axes.
+ */
+export declare const dotStripChartConfig: ChartTypeConfig;

package/dist/client/components/charts/DotStripChart.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { ChartProps } from '../../types.js';
+declare const DotStripChart: React.MemoExoticComponent<({ data, chartConfig, displayConfig, height, colorPalette, onDataPointClick, drillEnabled, }: ChartProps) => React.JSX.Element>;
+export default DotStripChart;

package/dist/client/components/charts/DotStripChart.helpers.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Layout maths for the dot strip (beeswarm) chart.
+ *
+ * Kept out of the component — like `ScatterChart.helpers.ts` and
+ * `BubbleChart.render.ts` — so the swarm packing can be unit-tested without a
+ * DOM. Everything here is pure: same input, same output, every time.
+ */
+/** Hard caps so one pathological band cannot blow up the layout. */
+export declare const MAX_BANDS = 50;
+export declare const MAX_DOTS_PER_BAND = 500;
+export declare const MAX_LANES = 8;
+export declare const MIN_ROW_HEIGHT = 44;
+export declare const MAX_ROW_HEIGHT = 220;
+/** Vertical breathing room added above and below the outermost lanes. */
+export declare const ROW_VERTICAL_PADDING = 12;
+export declare const DOT_RADIUS: Record<'small' | 'medium' | 'large', number>;
+/** Gap between the edges of two adjacent dots in the same lane. */
+export declare const DOT_GAP = 1.5;
+export interface DotDatum {
+    /** Raw numeric value of the measure. */
+    value: number;
+    /** Identity label for the dot (from the optional series dimension). */
+    label: string;
+    /** The source row, handed back on click. */
+    row: Record<string, unknown>;
+}
+export interface PlacedDot extends DotDatum {
+    /** Pixel x within the plot area. */
+    x: number;
+    /** Lane index: 0 is the centre line, then +1, -1, +2, -2, … */
+    lane: number;
+    /** Pixel y offset from the band's centre line. */
+    y: number;
+}
+export interface BandStats {
+    /** The band's own label (the value of the band dimension). */
+    label: string;
+    dots: PlacedDot[];
+    count: number;
+    median: number | null;
+    min: number | null;
+    max: number | null;
+    /**
+     * max / min. `null` when it cannot be stated meaningfully — fewer than two
+     * dots, or a non-positive minimum (the ratio is infinite or sign-flipped).
+     */
+    spread: number | null;
+    /** True when the band has rows but not one usable numeric value. */
+    noData: boolean;
+    /** Rendered height of this band's row, in px. */
+    height: number;
+    /** True when the band's dots were truncated at MAX_DOTS_PER_BAND. */
+    truncated: boolean;
+}
+export declare function parseNumeric(v: unknown): number | null;
+export declare function median(sortedValues: number[]): number | null;
+/**
+ * Greedy deterministic beeswarm packing.
+ *
+ * Dots are sorted by x (ties broken by label, so the output is stable for a
+ * given input rather than dependent on row order) and each is dropped into the
+ * first lane — searched outward from the centre — where it clears every dot
+ * already in that lane by at least `2r + gap`. Beyond `MAX_LANES` the dot is
+ * forced onto the outermost lane and simply overlaps; the surface-coloured
+ * stroke keeps that readable.
+ *
+ * A force simulation would do this too, but it settles asynchronously and
+ * non-deterministically, which makes it untestable and jittery on re-render.
+ */
+export declare function packSwarm(dots: DotDatum[], scale: (v: number) => number, radius: number): PlacedDot[];
+/** Row height needed to show every lane the swarm used. */
+export declare function swarmHeight(placed: PlacedDot[], radius: number): number;
+/** max / min, or null when the ratio would be meaningless. */
+export declare function computeSpread(min: number | null, max: number | null, count: number): number | null;
+export type BandSort = 'none' | 'valueDesc' | 'valueAsc' | 'count';
+/**
+ * Group rows into bands, in the order requested. Sorting happens before the
+ * swarm is packed so row heights follow the rows the user actually sees.
+ */
+export declare function groupIntoBands(rows: Record<string, unknown>[], bandField: string, valueField: string, labelField: string | undefined, sort: BandSort): Array<{
+    label: string;
+    values: DotDatum[];
+    truncated: boolean;
+}>;
+/** Nicely padded numeric domain across every dot in every band. */
+export declare function computeDomain(values: number[]): {
+    min: number;
+    max: number;
+};
+/** Evenly spaced axis ticks across the domain. */
+export declare function computeTicks(min: number, max: number, count?: number): number[];

package/dist/client/components/charts/RecordsTable.config.d.ts

@@ -0,0 +1,10 @@
+import { ChartTypeConfig } from '../../charts/chartConfigs.js';
+/**
+ * Configuration for the records table.
+ *
+ * Eager metadata (`label`, `description`, `useCase`, `isAvailable`) lives in the
+ * unified `chartRegistry` entry — see `src/client/charts/chartRegistry.ts`. This
+ * file owns the lazy-loaded shape: drop zones, display options, clickable
+ * elements, validation.
+ */
+export declare const recordsTableConfig: ChartTypeConfig;

package/dist/client/components/charts/RecordsTable.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { ChartProps } from '../../types.js';
+declare const RecordsTable: React.MemoExoticComponent<({ data, chartConfig, displayConfig, queryObject, colorPalette, height, onDataPointClick, drillEnabled, pagination }: ChartProps) => React.JSX.Element>;
+export default RecordsTable;

package/dist/client/components/charts/recordsTableHooks.d.ts

@@ -0,0 +1,68 @@
+import { default as React } from 'react';
+import { ChartAxisConfig, ChartPagination, CubeQuery } from '../../types.js';
+export declare const DEFAULT_PAGE_SIZE = 25;
+/**
+ * Which columns to render, in which order.
+ *
+ * The author's arrangement comes from the Columns drop zone; a viewer can drag
+ * a header on top of it, and that order is remembered per column set. It is
+ * *reconciled* rather than substituted, so a column the author adds later still
+ * appears instead of being swallowed by a stale local order.
+ */
+export declare function useRecordsColumns(params: {
+    rows: Record<string, unknown>[];
+    chartConfig?: ChartAxisConfig;
+    queryObject?: CubeQuery;
+}): {
+    columns: string[];
+    storageKey: string;
+    draggedColumn: string | null;
+    didDragRef: React.MutableRefObject<boolean>;
+    startColumnDrag: (column: string) => void;
+    endColumnDrag: () => void;
+    dropColumn: (target: string) => void;
+};
+/**
+ * Drag-resizable column widths, remembered per column set.
+ *
+ * A chart has no portlet id and no write path back to `displayConfig`, so an
+ * authored `columnWidths` acts as the default a viewer's own drags layer over —
+ * the same arrangement the data browser uses.
+ */
+export declare function useColumnWidths(params: {
+    columns: string[];
+    storageKey: string;
+    authored?: Record<string, number>;
+}): {
+    columnWidths: Record<string, number>;
+    totalWidth: number | undefined;
+    tableRef: React.RefObject<HTMLTableElement>;
+    didResizeRef: React.MutableRefObject<boolean>;
+    startResize: (event: React.MouseEvent, column: string) => void;
+};
+/**
+ * Sorting and paging, server-side when the host offers it.
+ *
+ * With a `pagination` prop the host re-queries, so both must go through it:
+ * sorting only the loaded page would put the wrong rows on page 1. Without one
+ * — the AnalysisBuilder preview, the notebook, plugin hosts — the table sorts
+ * and pages over the rows it already has.
+ */
+export declare function useRecordsPaging(params: {
+    rows: Record<string, unknown>[];
+    pagination?: ChartPagination;
+    authoredPageSize?: number;
+}): {
+    sort: {
+        column: string;
+        direction: "asc" | "desc";
+    } | null;
+    toggleSort: (column: string) => void;
+    visibleRows: Record<string, unknown>[];
+    page: number;
+    pageSize: number;
+    pageCount: number;
+    rowCount: number;
+    goToPage: (next: number) => void;
+    showPager: boolean;
+};

package/dist/client/components.js

@@ -1,3 +1,3 @@
-import { D as e, O as t, X as n, a as r, h as i, i as a, m as o, n as s, p as c, r as l, s as u, t as d, w as f } from "./chunks/DashboardEditModal-9An5EDAz.js";
+import { D as e, O as t, X as n, a as r, h as i, i as a, m as o, n as s, p as c, r as l, s as u, t as d, w as f } from "./chunks/DashboardEditModal-BliiIHcI.js";
 import { a as p, n as m, o as h, r as g, s as _, t as v } from "./chunks/utils-CToHkuhU.js";
 export { u as AnalysisDisplayConfigPanel, l as AnalyticsDashboard, n as AnalyticsPortlet, d as DashboardEditModal, i as DashboardFilterBar, a as DashboardGrid, o as DashboardGridSurface, r as DashboardModals, e as DashboardProvider, f as DashboardToolbar, c as Modal, s as PortletContainer, v as createDashboardLayout, m as createSamplePortlet, g as findNextPosition, p as generatePortletId, h as generateResponsiveLayouts, t as useDashboardContext, _ as validateCubeQuery };

package/dist/client/hooks.js

@@ -1,5 +1,5 @@
-import { R as e } from "./chunks/chart-data-table-DgiNBOWf.js";
-import { S as t, a as n, c as r, d as i, i as a, l as o, n as s, o as c, r as l, s as u, t as d } from "./chunks/useDirtyStateTracking-CSDg96Rw.js";
-import { a as f, i as p, n as m, o as h, r as g, t as _ } from "./chunks/useExplainAI-BnkoZ-zS.js";
+import { z as e } from "./chunks/chart-data-table-Cou9qOab.js";
+import { S as t, a as n, c as r, d as i, i as a, l as o, n as s, o as c, r as l, s as u, t as d } from "./chunks/useDirtyStateTracking-DTYbmRBn.js";
+import { a as f, i as p, n as m, o as h, r as g, t as _ } from "./chunks/useExplainAI-MuC9jBn-.js";
 import { t as v } from "./chunks/useNotebookLayout-Ck3Z3uzg.js";
 export { m as createExplainQueryKey, c as createFlowQueryKey, r as createFunnelQueryKey, t as useCubeLoadQuery, t as useCubeQuery, e as useCubeMetaQuery, s as useDebounce, d as useDirtyStateTracking, p as useDryRunQueries, f as useDryRunQuery, _ as useExplainAI, g as useExplainQuery, l as useFilterValues, u as useFlowQuery, o as useFunnelQuery, i as useMultiCubeLoadQuery, h as useMultiDryRunQueries, v as useNotebookLayout, a as useResponsiveDashboard, n as useRetentionQuery };

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

@@ -80,6 +80,7 @@ export interface IconRegistry {
     chartRadialBar: IconDefinition;
     chartTreemap: IconDefinition;
     chartTable: IconDefinition;
+    chartRecordsTable: IconDefinition;
     chartActivityGrid: IconDefinition;
     chartKpiNumber: IconDefinition;
     chartKpiDelta: IconDefinition;
@@ -91,6 +92,7 @@ export interface IconRegistry {
     chartHeatmap: IconDefinition;
     chartRetention: IconDefinition;
     chartBoxPlot: IconDefinition;
+    chartDotStrip: IconDefinition;
     chartWaterfall: IconDefinition;
     chartCandlestick: IconDefinition;
     chartMeasureProfile: IconDefinition;

package/dist/client/icons.js

@@ -1,2 +1,2 @@
-import { C as e, E as t, S as n, T as r, _ as i, b as a, g as o, v as s, w as c, x as l, y as u } from "./chunks/chart-data-table-DgiNBOWf.js";
-export { t as DEFAULT_ICONS, o as getChartTypeIcon, i as getFieldTypeIcon, s as getIcon, u as getIconData, a as getIconRegistry, l as getIconsByCategory, n as getMeasureTypeIcon, e as registerIcons, c as resetIcons, r as setIcon };
+import { C as e, D as t, E as n, S as r, T as i, _ as a, b as o, v as s, w as c, x as l, y as u } from "./chunks/chart-data-table-Cou9qOab.js";
+export { t as DEFAULT_ICONS, a as getChartTypeIcon, s as getFieldTypeIcon, u as getIcon, o as getIconData, l as getIconRegistry, r as getIconsByCategory, e as getMeasureTypeIcon, c as registerIcons, i as resetIcons, n as setIcon };

package/dist/client/index.d.ts

@@ -33,7 +33,7 @@ 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 { CubeClient, CubeQueryError } 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';
@@ -55,7 +55,7 @@ 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, ChartProps, ColorPalette, CubeQuery, CubeQueryOptions, CubeApiOptions, DashboardConfig, PortletGroup, PortletGroupCell, 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 type { PortletConfig, ChartType, BuiltInChartType, ChartAxisConfig, ChartDisplayConfig, ChartProps, ColorPalette, CubeQuery, CubeQueryOptions, CubeApiOptions, CubeValidationIssue, ChartPagination, ColumnFormatConfig, ColumnFormatKind, RowLinkConfig, DashboardConfig, PortletGroup, PortletGroupCell, 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';