@sentropic/dataviz-core 0.1.0 → 0.2.0

package/dist/pivot.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pivot / matrix aggregation.
+ *
+ * The output is intentionally presentation-neutral but shaped for DS DataTable:
+ * a column list with stable keys and row objects carrying those keys.
+ */
+import type { DataModel, Row } from './model.js';
+export interface PivotConfig {
+    rows: string[];
+    columns?: string[];
+    measures: string[];
+}
+export interface PivotTableColumn {
+    key: string;
+    label: string;
+    kind: 'row' | 'value';
+    dimensionId?: string;
+    columnKey?: string;
+    columnLabel?: string;
+    measureId?: string;
+}
+export interface PivotTableRow {
+    id: string;
+    [key: string]: string | number;
+}
+export interface PivotTable {
+    columns: PivotTableColumn[];
+    rows: PivotTableRow[];
+}
+export declare function buildPivotTable(model: DataModel, data: readonly Row[], config: PivotConfig): PivotTable;
+//# sourceMappingURL=pivot.d.ts.map

package/dist/pivot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pivot.d.ts","sourceRoot":"","sources":["../src/pivot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAW,GAAG,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,IAAI,EAAE,aAAa,EAAE,CAAC;CACvB;AAoCD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,SAAS,GAAG,EAAE,EACpB,MAAM,EAAE,WAAW,GAClB,UAAU,CA0FZ"}

package/dist/pivot.js

@@ -0,0 +1,121 @@
+/**
+ * Pivot / matrix aggregation.
+ *
+ * The output is intentionally presentation-neutral but shaped for DS DataTable:
+ * a column list with stable keys and row objects carrying those keys.
+ */
+import { aggregate } from './aggregate.js';
+import { findDimension, findMeasure } from './model.js';
+function cellKey(value) {
+    return value == null ? 'null' : String(value);
+}
+function pathFor(row, dimensions) {
+    return dimensions.map((dimensionId) => cellKey(row[dimensionId]));
+}
+function pathKey(path) {
+    return path.join('\u001f');
+}
+function pathLabel(path) {
+    return path.join(' / ');
+}
+function assertDimensions(model, ids, role) {
+    for (const id of ids) {
+        if (!findDimension(model, id)) {
+            throw new Error(`Unknown pivot ${role} dimension: ${id}`);
+        }
+    }
+}
+function resolveMeasures(model, ids) {
+    return ids.map((id) => {
+        const measure = findMeasure(model, id);
+        if (!measure) {
+            throw new Error(`Unknown pivot measure: ${id}`);
+        }
+        return measure;
+    });
+}
+export function buildPivotTable(model, data, config) {
+    if (config.rows.length === 0) {
+        throw new Error('Pivot requires at least one row dimension');
+    }
+    if (config.measures.length === 0) {
+        throw new Error('Pivot requires at least one measure');
+    }
+    const columnDimensions = config.columns ?? [];
+    assertDimensions(model, config.rows, 'row');
+    assertDimensions(model, columnDimensions, 'column');
+    const measures = resolveMeasures(model, config.measures);
+    const rowGroups = new Map();
+    const columnPaths = new Map();
+    for (const row of data) {
+        const rowPath = pathFor(row, config.rows);
+        const rowId = pathKey(rowPath);
+        const rowGroup = rowGroups.get(rowId);
+        if (rowGroup) {
+            rowGroup.rows.push(row);
+        }
+        else {
+            rowGroups.set(rowId, { path: rowPath, rows: [row] });
+        }
+        if (columnDimensions.length > 0) {
+            const columnPath = pathFor(row, columnDimensions);
+            const columnKey = pathKey(columnPath);
+            if (!columnPaths.has(columnKey)) {
+                columnPaths.set(columnKey, columnPath);
+            }
+        }
+    }
+    const columns = config.rows.map((dimensionId) => ({
+        key: `row:${dimensionId}`,
+        label: findDimension(model, dimensionId).label,
+        kind: 'row',
+    }));
+    if (columnDimensions.length === 0) {
+        for (const measure of measures) {
+            columns.push({
+                key: `value:${measure.id}`,
+                label: measure.label,
+                kind: 'value',
+                measureId: measure.id,
+            });
+        }
+    }
+    else {
+        for (const [columnKey, columnPath] of columnPaths) {
+            const columnLabel = pathLabel(columnPath);
+            for (const measure of measures) {
+                columns.push({
+                    key: `value:${columnKey}:${measure.id}`,
+                    label: `${columnLabel} · ${measure.label}`,
+                    kind: 'value',
+                    columnKey,
+                    columnLabel,
+                    measureId: measure.id,
+                });
+            }
+        }
+    }
+    const rows = [];
+    for (const [rowId, group] of rowGroups) {
+        const out = { id: rowId };
+        config.rows.forEach((dimensionId, index) => {
+            out[`row:${dimensionId}`] = group.path[index] ?? 'null';
+        });
+        if (columnDimensions.length === 0) {
+            for (const measure of measures) {
+                out[`value:${measure.id}`] = aggregate(group.rows, measure);
+            }
+        }
+        else {
+            for (const [columnKey, columnPath] of columnPaths) {
+                const bucket = group.rows.filter((row) => pathKey(pathFor(row, columnDimensions)) === columnKey);
+                for (const measure of measures) {
+                    out[`value:${pathKey(columnPath)}:${measure.id}`] = aggregate(bucket, measure);
+                }
+            }
+        }
+        rows.push(out);
+    }
+    return { columns, rows };
+}
+//# sourceMappingURL=pivot.js.map

package/dist/pivot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pivot.js","sourceRoot":"","sources":["../src/pivot.ts"],"names":[],"mappings":"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"}

package/dist/pivotAdvanced.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Advanced pivot data contracts.
+ *
+ * This module keeps the existing flat pivot table contract stable and adds a
+ * hierarchical, metadata-rich shape for subtotals, collapsed paths, cell heat
+ * and in-cell sparklines.
+ */
+import type { DataModel, Row } from './model.js';
+import type { PivotTableColumn } from './pivot.js';
+export interface AdvancedPivotConfig {
+    rows: string[];
+    columns?: string[];
+    measures: string[];
+    includeSubtotals?: boolean;
+    collapsedRowPaths?: readonly string[];
+    heatmap?: boolean;
+    sparklineDimension?: string;
+}
+export interface AdvancedPivotSparklinePoint {
+    key: string;
+    value: number;
+}
+export interface AdvancedPivotCell {
+    key: string;
+    measureId: string;
+    value: number;
+    columnKey?: string;
+    columnLabel?: string;
+    heat?: number;
+    sparkline?: AdvancedPivotSparklinePoint[];
+}
+export interface AdvancedPivotRow {
+    id: string;
+    path: string[];
+    labels: Record<string, string>;
+    kind: 'leaf' | 'subtotal';
+    depth: number;
+    expanded: boolean;
+    values: Record<string, AdvancedPivotCell>;
+}
+export interface AdvancedPivotTable {
+    columns: PivotTableColumn[];
+    rows: AdvancedPivotRow[];
+    heatDomain?: [number, number];
+}
+export declare function buildAdvancedPivotTable(model: DataModel, data: readonly Row[], config: AdvancedPivotConfig): AdvancedPivotTable;
+//# sourceMappingURL=pivotAdvanced.d.ts.map

package/dist/pivotAdvanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pivotAdvanced.d.ts","sourceRoot":"","sources":["../src/pivotAdvanced.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAW,GAAG,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,2BAA2B,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AA6ND,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,SAAS,GAAG,EAAE,EACpB,MAAM,EAAE,mBAAmB,GAC1B,kBAAkB,CA2CpB"}

package/dist/pivotAdvanced.js

@@ -0,0 +1,208 @@
+/**
+ * Advanced pivot data contracts.
+ *
+ * This module keeps the existing flat pivot table contract stable and adds a
+ * hierarchical, metadata-rich shape for subtotals, collapsed paths, cell heat
+ * and in-cell sparklines.
+ */
+import { aggregate, groupAggregate } from './aggregate.js';
+import { findDimension, findMeasure } from './model.js';
+function cellKey(value) {
+    return value == null ? 'null' : String(value);
+}
+function pathFor(row, dimensions) {
+    return dimensions.map((dimensionId) => cellKey(row[dimensionId]));
+}
+function pathKey(path) {
+    return path.join('\u001f');
+}
+function pathLabel(path) {
+    return path.join(' / ');
+}
+function hasPathPrefix(path, prefix) {
+    if (path.length <= prefix.length)
+        return false;
+    return prefix.every((segment, index) => path[index] === segment);
+}
+function assertDimensions(model, ids, role) {
+    for (const id of ids) {
+        if (!findDimension(model, id)) {
+            throw new Error(`Unknown advanced pivot ${role} dimension: ${id}`);
+        }
+    }
+}
+function resolveMeasures(model, ids) {
+    return ids.map((id) => {
+        const measure = findMeasure(model, id);
+        if (!measure) {
+            throw new Error(`Unknown advanced pivot measure: ${id}`);
+        }
+        return measure;
+    });
+}
+function assertSparklineDimension(model, id) {
+    if (id !== undefined && !findDimension(model, id)) {
+        throw new Error(`Unknown advanced pivot sparkline dimension: ${id}`);
+    }
+}
+function columnPathsFor(data, columns) {
+    const paths = new Map();
+    if (columns.length === 0)
+        return paths;
+    for (const row of data) {
+        const path = pathFor(row, columns);
+        const id = pathKey(path);
+        if (!paths.has(id)) {
+            paths.set(id, path);
+        }
+    }
+    return paths;
+}
+function buildColumns(model, rowDimensions, columnPaths, measures) {
+    const columns = rowDimensions.map((dimensionId) => ({
+        key: `row:${dimensionId}`,
+        label: findDimension(model, dimensionId).label,
+        kind: 'row',
+    }));
+    if (columnPaths.size === 0) {
+        for (const measure of measures) {
+            columns.push({
+                key: `value:${measure.id}`,
+                label: measure.label,
+                kind: 'value',
+                measureId: measure.id,
+            });
+        }
+        return columns;
+    }
+    for (const [columnKey, columnPath] of columnPaths) {
+        const columnLabel = pathLabel(columnPath);
+        for (const measure of measures) {
+            columns.push({
+                key: `value:${columnKey}:${measure.id}`,
+                label: `${columnLabel} · ${measure.label}`,
+                kind: 'value',
+                columnKey,
+                columnLabel,
+                measureId: measure.id,
+            });
+        }
+    }
+    return columns;
+}
+function collectRowNodes(data, rowDimensions, includeSubtotals) {
+    const nodes = new Map();
+    for (const row of data) {
+        for (let depth = 1; depth <= rowDimensions.length; depth += 1) {
+            if (!includeSubtotals && depth < rowDimensions.length)
+                continue;
+            const path = pathFor(row, rowDimensions.slice(0, depth));
+            const id = pathKey(path);
+            const kind = depth === rowDimensions.length ? 'leaf' : 'subtotal';
+            const node = nodes.get(id);
+            if (node) {
+                node.rows.push(row);
+            }
+            else {
+                nodes.set(id, { id, path, rows: [row], kind });
+            }
+        }
+    }
+    return [...nodes.values()];
+}
+function matchesColumnPath(row, columns, path) {
+    return pathFor(row, columns).every((value, index) => value === path[index]);
+}
+function labelsFor(path, rowDimensions) {
+    const labels = {};
+    path.forEach((label, index) => {
+        labels[rowDimensions[index]] = label;
+    });
+    return labels;
+}
+function valueKey(columnKey, measure) {
+    return columnKey === undefined ? `value:${measure.id}` : `value:${columnKey}:${measure.id}`;
+}
+function buildValues(rows, columnDimensions, columnPaths, measures, sparklineDimension) {
+    const values = {};
+    if (columnPaths.size === 0) {
+        for (const measure of measures) {
+            const key = valueKey(undefined, measure);
+            values[key] = {
+                key,
+                measureId: measure.id,
+                value: aggregate([...rows], measure),
+            };
+            if (sparklineDimension !== undefined) {
+                values[key].sparkline = groupAggregate([...rows], sparklineDimension, measure);
+            }
+        }
+        return values;
+    }
+    for (const [columnKey, columnPath] of columnPaths) {
+        const bucket = rows.filter((row) => matchesColumnPath(row, columnDimensions, columnPath));
+        const columnLabel = pathLabel(columnPath);
+        for (const measure of measures) {
+            const key = valueKey(columnKey, measure);
+            values[key] = {
+                key,
+                measureId: measure.id,
+                columnKey,
+                columnLabel,
+                value: aggregate(bucket, measure),
+            };
+            if (sparklineDimension !== undefined) {
+                values[key].sparkline = groupAggregate(bucket, sparklineDimension, measure);
+            }
+        }
+    }
+    return values;
+}
+function applyHeat(rows) {
+    const cells = rows.flatMap((row) => Object.values(row.values));
+    const finite = cells.map((cell) => cell.value).filter(Number.isFinite);
+    if (finite.length === 0)
+        return undefined;
+    const min = Math.min(...finite);
+    const max = Math.max(...finite);
+    const span = max - min;
+    for (const cell of cells) {
+        cell.heat = span === 0 ? 1 : (cell.value - min) / span;
+    }
+    return [min, max];
+}
+function visibleNodes(nodes, collapsedRowPaths) {
+    const collapsed = collapsedRowPaths.map((id) => id.split('\u001f'));
+    return nodes.filter((node) => !collapsed.some((path) => hasPathPrefix(node.path, path)));
+}
+export function buildAdvancedPivotTable(model, data, config) {
+    if (config.rows.length === 0) {
+        throw new Error('Advanced pivot requires at least one row dimension');
+    }
+    if (config.measures.length === 0) {
+        throw new Error('Advanced pivot requires at least one measure');
+    }
+    const columnDimensions = config.columns ?? [];
+    assertDimensions(model, config.rows, 'row');
+    assertDimensions(model, columnDimensions, 'column');
+    assertSparklineDimension(model, config.sparklineDimension);
+    const measures = resolveMeasures(model, config.measures);
+    const columnPaths = columnPathsFor(data, columnDimensions);
+    const draftRows = visibleNodes(collectRowNodes(data, config.rows, config.includeSubtotals ?? false), config.collapsedRowPaths ?? []);
+    const rows = draftRows.map((node) => ({
+        id: node.id,
+        path: node.path,
+        labels: labelsFor(node.path, config.rows),
+        kind: node.kind,
+        depth: node.path.length - 1,
+        expanded: node.kind === 'subtotal' && !(config.collapsedRowPaths ?? []).includes(node.id),
+        values: buildValues(node.rows, columnDimensions, columnPaths, measures, config.sparklineDimension),
+    }));
+    const heatDomain = config.heatmap ? applyHeat(rows) : undefined;
+    return {
+        columns: buildColumns(model, config.rows, columnPaths, measures),
+        rows,
+        ...(heatDomain ? { heatDomain } : {}),
+    };
+}
+//# sourceMappingURL=pivotAdvanced.js.map

package/dist/pivotAdvanced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pivotAdvanced.js","sourceRoot":"","sources":["../src/pivotAdvanced.ts"],"names":[],"mappings":"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"}

package/dist/serialize.d.ts

@@ -11,9 +11,7 @@
  * the value stays human-inspectable and dependency-free.)
  */
 import type { DataModel } from './model.js';
-import type { FilterSpec, FilterState } from './store.js';
-/** Validate that an unknown value is a well-formed {@link FilterSpec}. */
-export declare function isFilterSpec(value: unknown): value is FilterSpec;
+import type { DrillState, FilterState } from './store.js';
 /**
  * Serialise the filter portion of a state to a URL-safe string.
  * Selections are intentionally *not* serialised here — they are ephemeral
@@ -28,4 +26,18 @@ export declare function serializeFilters(state: {
  * parse error yields an empty state (never throws).
  */
 export declare function deserializeFilters(encoded: string, model: DataModel): FilterState;
+/**
+ * Serialise the drill portion of a state to a URL-safe string.
+ * Filters keep their existing bookmark channel; drill is separate so callers
+ * can opt in when bookmark semantics include drill navigation.
+ */
+export declare function serializeDrill(state: {
+    drill: DrillState;
+}): string;
+/**
+ * Parse a serialised drill string back to a {@link DrillState}, validating
+ * dimensions against the model. Unknown dimensions and malformed paths are
+ * dropped. Any parse error yields an empty state.
+ */
+export declare function deserializeDrill(encoded: string, model: DataModel): DrillState;
 //# sourceMappingURL=serialize.d.ts.map

package/dist/serialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM1D,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAehE;AAaD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG,MAAM,CAMxE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW,CAiBjF"}
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EAAE,UAAU,EAAc,WAAW,EAAE,MAAM,YAAY,CAAC;AActE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG,MAAM,CAUxE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW,CAiBjF;AAUD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,MAAM,CAUnE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,CAiB9E"}

package/dist/serialize.js

@@ -11,25 +11,7 @@
  * the value stays human-inspectable and dependency-free.)
  */
 import { findDimension } from './model.js';
-function isStringArray(value) {
-    return Array.isArray(value) && value.every((v) => typeof v === 'string');
-}
-/** Validate that an unknown value is a well-formed {@link FilterSpec}. */
-export function isFilterSpec(value) {
-    if (typeof value !== 'object' || value === null)
-        return false;
-    const spec = value;
-    switch (spec.kind) {
-        case 'include':
-        case 'exclude':
-            return isStringArray(spec.values);
-        case 'range':
-            return ((spec.min === undefined || typeof spec.min === 'number') &&
-                (spec.max === undefined || typeof spec.max === 'number'));
-        default:
-            return false;
-    }
-}
+import { isFilterSpec } from './store.js';
 /** Normalise a spec into a minimal, stable object for serialisation. */
 function normaliseSpec(spec) {
     if (spec.kind === 'include' || spec.kind === 'exclude') {
@@ -50,7 +32,11 @@ function normaliseSpec(spec) {
 export function serializeFilters(state) {
     const normalised = {};
     for (const key of Object.keys(state.filters).sort()) {
-        normalised[key] = normaliseSpec(state.filters[key]);
+        const spec = state.filters[key];
+        if (!isFilterSpec(spec)) {
+            throw new TypeError(`Cannot serialize malformed filter spec for dimension ${key}`);
+        }
+        normalised[key] = normaliseSpec(spec);
     }
     return encodeURIComponent(JSON.stringify(normalised));
 }
@@ -81,4 +67,53 @@ export function deserializeFilters(encoded, model) {
     }
     return result;
 }
+function isDrillPath(value) {
+    return Array.isArray(value) && value.length > 0 && value.every((item) => typeof item === 'string');
+}
+function normaliseDrillPath(path) {
+    return [...path];
+}
+/**
+ * Serialise the drill portion of a state to a URL-safe string.
+ * Filters keep their existing bookmark channel; drill is separate so callers
+ * can opt in when bookmark semantics include drill navigation.
+ */
+export function serializeDrill(state) {
+    const normalised = {};
+    for (const key of Object.keys(state.drill).sort()) {
+        const path = state.drill[key];
+        if (!isDrillPath(path)) {
+            throw new TypeError(`Cannot serialize malformed drill path for view ${key}`);
+        }
+        normalised[key] = normaliseDrillPath(path);
+    }
+    return encodeURIComponent(JSON.stringify(normalised));
+}
+/**
+ * Parse a serialised drill string back to a {@link DrillState}, validating
+ * dimensions against the model. Unknown dimensions and malformed paths are
+ * dropped. Any parse error yields an empty state.
+ */
+export function deserializeDrill(encoded, model) {
+    if (!encoded)
+        return {};
+    let raw;
+    try {
+        raw = JSON.parse(decodeURIComponent(encoded));
+    }
+    catch {
+        return {};
+    }
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        return {};
+    const result = {};
+    for (const [viewId, path] of Object.entries(raw)) {
+        if (!isDrillPath(path))
+            continue;
+        if (!path.every((dimensionId) => findDimension(model, dimensionId)))
+            continue;
+        result[viewId] = normaliseDrillPath(path);
+    }
+    return result;
+}
 //# sourceMappingURL=serialize.js.map

package/dist/serialize.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"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"}

package/dist/store.d.ts

@@ -1,6 +1,6 @@
 /**
  * The dashboard store: an immutable, observable container for the shared
- * inter-view state (filters + selections).
+ * inter-view state (filters + selections + drill paths).
  *
  * Every mutation produces a brand-new frozen {@link DashboardState} (a different
  * object reference) and then notifies subscribers. The state is fully
@@ -33,13 +33,14 @@ export type FilterSpec = {
 export type FilterState = Record<string, FilterSpec>;
 /** Map of viewId -> selected keys. Serialisable. */
 export type SelectionState = Record<string, string[]>;
+/** Map of viewId -> current drill dimension path. Serialisable. */
+export type DrillState = Record<string, string[]>;
 /** Immutable snapshot of the dashboard's shared state. */
 export interface DashboardState {
     readonly filters: FilterState;
     readonly selections: SelectionState;
+    readonly drill: DrillState;
 }
-/** Accepted argument to {@link DashboardStore.setFilter}. */
-export type FilterInput = FilterSpec | ((value: Cell, row: Row) => boolean);
 export interface DashboardStoreConfig {
     model: DataModel;
     data: Row[];
@@ -58,15 +59,27 @@ export interface DashboardStore {
     subscribe(listener: () => void): () => void;
     /** Set (or replace) the filter on a dimension. */
     setFilter(dimensionId: string, spec: FilterSpec): void;
+    /** Alias for clearing one filter, matching the public store contract. */
+    clear(dimensionId: string): void;
     /** Remove the filter on a dimension. No-op if absent. */
     clearFilter(dimensionId: string): void;
     /** Toggle a single selected key for a view. */
     toggleSelection(viewId: string, key: string): void;
     /** Clear all selections for a view. No-op if absent. */
     clearSelection(viewId: string): void;
-    /** Reset all filters and selections. */
+    /** Append one dimension to a view's drill path. */
+    drillDown(viewId: string, dimensionId: string): void;
+    /** Remove the latest dimension from a view's drill path. No-op if absent. */
+    drillUp(viewId: string): void;
+    /** Clear all drill state for a view. No-op if absent. */
+    clearDrill(viewId: string): void;
+    /** Reset all filters, selections and drill state. */
     clearAll(): void;
+    /** Apply global filters and this store's cross-filter graph for one view. */
+    applyCrossfilter(viewId?: string): Row[];
 }
+/** Validate that an unknown value is a well-formed, serialisable {@link FilterSpec}. */
+export declare function isFilterSpec(value: unknown): value is FilterSpec;
 /**
  * Create an observable, immutable dashboard store.
  *