@rokkit/chart 1.0.0-next.150 → 1.0.0-next.155

package/dist/PlotState.svelte.d.ts

@@ -8,13 +8,16 @@ export class PlotState {
     colors: Map<unknown, {
         fill: string;
         stroke: string;
+    }> | Map<null, {
+        fill: any;
+        stroke: any;
     }>;
-    patterns: Map<any, any>;
-    symbols: Map<any, any>;
+    patterns: Map<unknown, string> | SvelteMap<any, any>;
+    symbols: Map<unknown, string> | SvelteMap<any, any>;
     colorField: any;
     patternField: any;
     symbolField: any;
-    geomTypes: Set<any>;
+    geomTypes: SvelteSet<any>;
     xAxisY: any;
     yAxisX: any;
     update(config: any): void;
@@ -40,8 +43,33 @@ export class PlotState {
     get innerWidth(): number;
     get innerHeight(): number;
     get mode(): string;
+    get chartPreset(): {
+        colors: string[];
+        shades: {
+            light: {
+                fill: string;
+                stroke: string;
+            };
+            dark: {
+                fill: string;
+                stroke: string;
+            };
+        };
+        opacity: {
+            area: number;
+            box: number;
+            violin: number;
+            point: number;
+        };
+        patterns: string[];
+        symbols: string[];
+    };
     get hovered(): null;
     setHovered(data: any): void;
     clearHovered(): void;
+    applyZoom(transform: any): void;
+    resetZoom(): void;
     #private;
 }
+import { SvelteMap } from 'svelte/reactivity';
+import { SvelteSet } from 'svelte/reactivity';

package/dist/crossfilter/createCrossFilter.svelte.d.ts

@@ -1,15 +1,13 @@
-/**
- * Creates a reactive cross-filter state object.
- *
- * Filter values follow the spec type:
- *   FilterState = Map<string, Set<unknown> | [number, number]>
- *   - categorical: raw Set of selected values
- *   - continuous:  [min, max] tuple
- *
- * Exposes a `filters` getter so CrossFilter.svelte can bind to current state.
- * Exposes a `version` counter that increments on every mutation, giving
- * components a simple reactive signal to watch for filter changes.
- *
- * @returns {CrossFilter}
- */
-export function createCrossFilter(): CrossFilter;
+export function createCrossFilter(): {
+    /** @readonly — reactive Map of current filter state */
+    readonly filters: SvelteMap<any, any>;
+    /** @readonly — increments on every mutation; read inside $effect to react to any filter change */
+    readonly version: number;
+    isFiltered: (dimension: string) => boolean;
+    isDimmed: (dimension: string, value: unknown) => boolean;
+    toggleCategorical: (dimension: string, value: unknown) => void;
+    setRange: (dimension: string, range: [number, number]) => void;
+    clearFilter: (dimension: string) => void;
+    clearAll: () => void;
+};
+import { SvelteMap } from 'svelte/reactivity';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export namespace PlotLayers {
+export namespace Plot {
     export { Root };
     export { Axis };
     export { Bar };
@@ -9,7 +9,9 @@ export namespace PlotLayers {
     export { Point };
     export { Arc };
 }
+export namespace PlotLayers { }
 export { default as PlotChart } from "./Plot.svelte";
+export { default as ChartProvider } from "./ChartProvider.svelte";
 export { default as FacetPlot } from "./FacetPlot.svelte";
 export { default as AnimatedPlot } from "./AnimatedPlot.svelte";
 export { default as GeomBar } from "./geoms/Bar.svelte";
@@ -34,12 +36,14 @@ export { ChartBrewer } from "./lib/brewing/index.svelte.js";
 export * from "./lib/brewing/index.svelte.js";
 export { CartesianBrewer } from "./lib/brewing/CartesianBrewer.svelte.js";
 export { PieBrewer } from "./lib/brewing/PieBrewer.svelte.js";
+export { QuartileBrewer } from "./lib/brewing/QuartileBrewer.svelte.js";
 export { BoxBrewer } from "./lib/brewing/BoxBrewer.svelte.js";
 export { ViolinBrewer } from "./lib/brewing/ViolinBrewer.svelte.js";
 export { createCrossFilter } from "./crossfilter/createCrossFilter.svelte.js";
 export { default as CrossFilter } from "./crossfilter/CrossFilter.svelte";
 export { default as FilterBar } from "./crossfilter/FilterBar.svelte";
 export { default as FilterSlider } from "./crossfilter/FilterSlider.svelte";
+export { default as FilterHistogram } from "./crossfilter/FilterHistogram.svelte";
 import Root from './Plot/Root.svelte';
 import Axis from './Plot/Axis.svelte';
 import Bar from './Plot/Bar.svelte';
@@ -49,3 +53,4 @@ import Line from './Plot/Line.svelte';
 import Area from './Plot/Area.svelte';
 import Point from './Plot/Point.svelte';
 import Arc from './Plot/Arc.svelte';
+export { createChartPreset, defaultPreset } from "./lib/preset.js";

package/dist/lib/brewing/BoxBrewer.svelte.d.ts

@@ -1,10 +1,8 @@
 /**
- * Brewer for box plots. Always computes quartile statistics regardless of the stat prop.
- * Groups by x + fill (primary) or x + color (fallback).
+ * Brewer for box plots.
  * fill = box interior color, color = whisker/outline stroke.
  */
-export class BoxBrewer extends ChartBrewer {
-    transform(data: any, channels: any): any;
+export class BoxBrewer extends QuartileBrewer {
     boxes: any[];
 }
-import { ChartBrewer } from './brewer.svelte.js';
+import { QuartileBrewer } from './QuartileBrewer.svelte.js';

package/dist/lib/brewing/QuartileBrewer.svelte.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared base for box and violin plots.
+ * Groups by x + fill (primary) or x + color (fallback) and computes quartile statistics.
+ * Subclasses add their mark-specific $derived (boxes, violins, etc.).
+ */
+export class QuartileBrewer extends ChartBrewer {
+    transform(data: any, channels: any): any;
+}
+import { ChartBrewer } from './brewer.svelte.js';

package/dist/lib/brewing/ViolinBrewer.svelte.d.ts

@@ -1,9 +1,8 @@
 /**
- * Brewer for violin plots. Computes the same quartile statistics as BoxBrewer.
+ * Brewer for violin plots.
  * fill = violin body color, color = outline stroke.
  */
-export class ViolinBrewer extends ChartBrewer {
-    transform(data: any, channels: any): any;
+export class ViolinBrewer extends QuartileBrewer {
     violins: any[];
 }
-import { ChartBrewer } from './brewer.svelte.js';
+import { QuartileBrewer } from './QuartileBrewer.svelte.js';

package/dist/lib/brewing/brewer.svelte.d.ts

@@ -1,31 +1,6 @@
-/**
- * Groups aesthetic channel mappings by field name, merging aesthetics that
- * share the same field into one legend section.
- *
- * @param {{ fill?: string, color?: string, pattern?: string, symbol?: string }} channels
- *   `fill` takes precedence over `color` for polygon charts (bars, areas, pie slices).
- * @param {Map<unknown, {fill:string, stroke:string}>} colorMap
- * @param {Map<unknown, string>} patternMap
- * @param {Map<unknown, string>} symbolMap
- * @returns {{ field: string, items: { label: string, fill: string|null, stroke: string|null, patternId: string|null, shape: string|null }[] }[]}
- */
-export function buildLegendGroups(channels: {
-    fill?: string;
-    color?: string;
-    pattern?: string;
-    symbol?: string;
-}, colorMap: Map<unknown, {
-    fill: string;
-    stroke: string;
-}>, patternMap: Map<unknown, string>, symbolMap: Map<unknown, string>): {
-    field: string;
-    items: {
-        label: string;
-        fill: string | null;
-        stroke: string | null;
-        patternId: string | null;
-        shape: string | null;
-    }[];
+export function buildLegendGroups(channels: any, colorMap: any, patternMap: any, symbolMap: any): {
+    field: any;
+    items: any;
 }[];
 export class ChartBrewer {
     /**
@@ -107,14 +82,8 @@ export class ChartBrewer {
         key: any;
     }[];
     legendGroups: {
-        field: string;
-        items: {
-            label: string;
-            fill: string | null;
-            stroke: string | null;
-            patternId: string | null;
-            shape: string | null;
-        }[];
+        field: any;
+        items: any;
     }[];
     get margin(): {
         top: number;

package/dist/lib/brewing/colors.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Returns true if the value looks like a CSS color literal (not a field name).
+ * Supports hex (#rgb, #rrggbb, #rrggbbaa), and functional notations (rgb, hsl, oklch, etc.).
+ * @param {unknown} value
+ * @returns {boolean}
+ */
+export function isLiteralColor(value: unknown): boolean;
 /**
  * Extracts distinct values for a given field from the data array.
  * @param {Object[]} data
@@ -9,9 +16,11 @@ export function distinct(data: Object[], field: string | null): unknown[];
  * Assigns palette colors to an array of distinct values.
  * @param {unknown[]} values
  * @param {'light'|'dark'} mode
+ * @param {typeof defaultPreset} preset
  * @returns {Map<unknown, {fill: string, stroke: string}>}
  */
-export function assignColors(values: unknown[], mode?: "light" | "dark"): Map<unknown, {
+export function assignColors(values: unknown[], mode?: "light" | "dark", preset?: typeof defaultPreset): Map<unknown, {
     fill: string;
     stroke: string;
 }>;
+import { defaultPreset } from '../preset.js';

package/dist/lib/brewing/marks/points.d.ts

@@ -1,9 +1,10 @@
 /**
  * Returns a Map assigning shape names to distinct values, cycling through available shapes.
  * @param {unknown[]} values
+ * @param {typeof defaultPreset} preset
  * @returns {Map<unknown, string>}
  */
-export function assignSymbols(values: unknown[]): Map<unknown, string>;
+export function assignSymbols(values: unknown[], preset?: typeof defaultPreset): Map<unknown, string>;
 /**
  * Builds an SVG path string for a given shape name and radius.
  * @param {string} shapeName
@@ -11,6 +12,15 @@ export function assignSymbols(values: unknown[]): Map<unknown, string>;
  * @returns {string}
  */
 export function buildSymbolPath(shapeName: string, r: number): string;
+/**
+ * Returns a stable pseudo-random offset for a given index.
+ * Uses a linear congruential generator seeded by index — no external dependency,
+ * stable across re-renders.
+ * @param {number} i - row index (seed)
+ * @param {number} range - total spread (jitter is ±range/2)
+ * @returns {number}
+ */
+export function jitterOffset(i: number, range: number): number;
 /**
  * Builds point geometry for scatter/bubble charts.
  * @param {Object[]} data
@@ -21,6 +31,7 @@ export function buildSymbolPath(shapeName: string, r: number): string;
  * @param {Function|null} sizeScale
  * @param {Map<unknown, string>|null} symbolMap  — maps symbol field value → shape name
  * @param {number} defaultRadius
+ * @param {{ width?: number, height?: number }|null} jitter
  */
 export function buildPoints(data: Object[], channels: {
     x: string;
@@ -28,7 +39,10 @@ export function buildPoints(data: Object[], channels: {
     color?: string;
     size?: string;
     symbol?: string;
-}, xScale: Function, yScale: Function, colors: Map<any, any>, sizeScale: Function | null, symbolMap: Map<unknown, string> | null, defaultRadius?: number): {
+}, xScale: Function, yScale: Function, colors: Map<any, any>, sizeScale: Function | null, symbolMap: Map<unknown, string> | null, defaultRadius?: number, jitter?: {
+    width?: number;
+    height?: number;
+} | null): {
     data: Object;
     cx: any;
     cy: any;
@@ -38,3 +52,4 @@ export function buildPoints(data: Object[], channels: {
     symbolPath: string | null;
     key: any;
 }[];
+import { defaultPreset } from '../../preset.js';

package/dist/lib/brewing/stats.d.ts

@@ -11,19 +11,11 @@ export function applyBoxStat(data: Object[], channels: {
     y?: string;
     color?: string;
 }): Object[];
-/**
- * Aggregates data by one or more grouping fields, reducing the value field
- * using the given stat. Accepts a built-in name or a custom function.
- *
- * @param {Object[]} data
- * @param {{ by: string[], value: string, stat: string|Function }} opts
- * @returns {Object[]}
- */
-export function applyAggregate(data: Object[], { by, value, stat }: {
-    by: string[];
-    value: string;
-    stat: string | Function;
-}): Object[];
+export function applyAggregate(data: any, { by, value, stat }: {
+    by: any;
+    value: any;
+    stat: any;
+}): any;
 /**
  * Built-in reduction functions. Each receives an array of numeric values.
  * @type {Record<string, (values: number[]) => number>}

package/dist/lib/chart.d.ts

@@ -1,8 +1,8 @@
 export function chart(data: any, aes: any): Chart;
 declare class Chart {
     constructor(data: any, opts: any);
-    width: number;
-    height: number;
+    width: number | undefined;
+    height: number | undefined;
     flipCoords: any;
     x: any;
     y: any;
@@ -13,13 +13,10 @@ declare class Chart {
     color: any;
     shape: any;
     padding(value: any): this;
-    spacing: number;
+    spacing: number | undefined;
     margin(value: any): this;
-    domain: {
-        x: any[];
-        y: any[];
-    };
     stat: any;
+    domain: any;
     data: any;
     refresh(): this;
     range: {
@@ -36,5 +33,6 @@ declare class Chart {
     } | undefined;
     aggregate(value: any, stat: any): void;
     ticks(axis: any, count: any, fontSize?: number): any;
+    #private;
 }
 export {};

package/dist/lib/keyboard-nav.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Svelte action: arrow key navigation between sibling data elements within a geom.
+ *
+ * When applied to a focusable SVG element with `enabled=true`, ArrowLeft/ArrowRight
+ * move focus between elements sharing the same `[data-plot-geom]` container.
+ *
+ * Usage: `<circle use:keyboardNav={keyboard} ...>`
+ *
+ * @param {Element} node
+ * @param {boolean} enabled
+ */
+export function keyboardNav(node: Element, enabled: boolean): {
+    update(newEnabled: any): void;
+    destroy: () => any;
+};

package/dist/lib/plot/preset.d.ts

@@ -4,7 +4,7 @@ export function resolvePreset(name: any, helpers?: {}): {
     symbols: any;
 };
 export namespace DEFAULT_PRESET {
-    export let colors: string[];
+    export let colors: any[];
     export { PATTERN_ORDER as patterns };
     export { SYMBOL_ORDER as symbols };
 }

package/dist/lib/preset.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Creates a chart preset by deep-merging overrides with the default preset.
+ * All fields are optional. `opacity` is merged key-by-key so partial overrides work.
+ * @param {Partial<typeof defaultPreset>} [overrides]
+ * @returns {typeof defaultPreset}
+ */
+export function createChartPreset(overrides?: Partial<typeof defaultPreset>): typeof defaultPreset;
+export namespace defaultPreset {
+    let colors: string[];
+    namespace shades {
+        namespace light {
+            let fill: string;
+            let stroke: string;
+        }
+        namespace dark {
+            let fill_1: string;
+            export { fill_1 as fill };
+            let stroke_1: string;
+            export { stroke_1 as stroke };
+        }
+    }
+    namespace opacity {
+        let area: number;
+        let box: number;
+        let violin: number;
+        let point: number;
+    }
+    let patterns: string[];
+    let symbols: string[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rokkit/chart",
-  "version": "1.0.0-next.150",
+  "version": "1.0.0-next.155",
   "type": "module",
   "description": "Data-driven chart components",
   "repository": {
@@ -54,6 +54,7 @@
     "d3-selection": "^3.0.0",
     "d3-shape": "^3.2.0",
     "d3-transition": "^3.0.1",
+    "d3-zoom": "^3.0.0",
     "ramda": "^0.32.0"
   }
 }