@rokkit/chart 1.0.0-next.158 → 1.0.0-next.159

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rokkit/chart",
-  "version": "1.0.0-next.158",
+  "version": "1.0.0-next.159",
   "type": "module",
   "description": "Data-driven chart components",
   "repository": {

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Jerry Thomas
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/Plot/index.d.ts

@@ -1,9 +0,0 @@
-export { default as Root } from "./Root.svelte";
-export { default as Axis } from "./Axis.svelte";
-export { default as Bar } from "./Bar.svelte";
-export { default as Legend } from "./Legend.svelte";
-export { default as Grid } from "./Grid.svelte";
-export { default as Line } from "./Line.svelte";
-export { default as Area } from "./Area.svelte";
-export { default as Point } from "./Point.svelte";
-export { default as Arc } from "./Arc.svelte";

package/dist/PlotState.svelte.d.ts

@@ -1,75 +0,0 @@
-export class PlotState {
-    constructor(config?: {});
-    axisOrigin: undefined[];
-    orientation: string;
-    colorScaleType: any;
-    xScale: any;
-    yScale: any;
-    colors: Map<unknown, {
-        fill: string;
-        stroke: string;
-    }> | Map<null, {
-        fill: any;
-        stroke: any;
-    }>;
-    patterns: Map<unknown, string> | SvelteMap<any, any>;
-    symbols: Map<unknown, string> | SvelteMap<any, any>;
-    colorField: any;
-    patternField: any;
-    symbolField: any;
-    geomTypes: SvelteSet<any>;
-    xAxisY: any;
-    yAxisX: any;
-    update(config: any): void;
-    registerGeom(config: any): string;
-    updateGeom(id: any, config: any): void;
-    unregisterGeom(id: any): void;
-    geomData(id: any): any[];
-    label(field: any): any;
-    format(field: any): any;
-    tooltip(): any;
-    geomComponent(type: any): any;
-    preset(): {
-        colors: any;
-        patterns: any;
-        symbols: any;
-    };
-    get margin(): {
-        top: number;
-        right: number;
-        bottom: number;
-        left: number;
-    };
-    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,13 +0,0 @@
-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/elements/index.d.ts

@@ -1,6 +0,0 @@
-export { default as Bar } from "./Bar.svelte";
-export { default as ColorRamp } from "./ColorRamp.svelte";
-export { default as ContinuousLegend } from "./ContinuousLegend.svelte";
-export { default as Label } from "./Label.svelte";
-export { default as DefinePatterns } from "./DefinePatterns.svelte";
-export { default as SymbolGrid } from "./SymbolGrid.svelte";

package/dist/geoms/lib/areas.d.ts

@@ -1,52 +0,0 @@
-/**
- * Builds area path geometry for multi-series area charts.
- *
- * @param {Object[]} data
- * @param {{ x: string, y: string, color?: string }} channels
- * @param {Function} xScale
- * @param {Function} yScale
- * @param {Map<unknown, {fill: string, stroke: string}>} colors
- * @param {'linear'|'smooth'|'step'} [curve]
- * @param {Map<unknown, string>} [patterns]
- * @returns {{ d: string, fill: string, stroke: string, key: unknown, patternId: string|null }[]}
- */
-export function buildAreas(data: Object[], channels: {
-    x: string;
-    y: string;
-    color?: string;
-}, xScale: Function, yScale: Function, colors: Map<unknown, {
-    fill: string;
-    stroke: string;
-}>, curve?: "linear" | "smooth" | "step", patterns?: Map<unknown, string>): {
-    d: string;
-    fill: string;
-    stroke: string;
-    key: unknown;
-    patternId: string | null;
-}[];
-/**
- * Builds stacked area paths using d3 stack layout.
- *
- * @param {Object[]} data
- * @param {{ x: string, y: string, color: string }} channels
- * @param {Function} xScale
- * @param {Function} yScale
- * @param {Map<unknown, {fill: string, stroke: string}>} colors
- * @param {'linear'|'smooth'|'step'} [curve]
- * @param {Map<unknown, string>} [patterns]
- * @returns {{ d: string, fill: string, stroke: string, key: unknown, patternId: string|null }[]}
- */
-export function buildStackedAreas(data: Object[], channels: {
-    x: string;
-    y: string;
-    color: string;
-}, xScale: Function, yScale: Function, colors: Map<unknown, {
-    fill: string;
-    stroke: string;
-}>, curve?: "linear" | "smooth" | "step", patterns?: Map<unknown, string>): {
-    d: string;
-    fill: string;
-    stroke: string;
-    key: unknown;
-    patternId: string | null;
-}[];

package/dist/geoms/lib/bars.d.ts

@@ -1,3 +0,0 @@
-export function buildGroupedBars(data: any, channels: any, xScale: any, yScale: any, colors: any, innerHeight: any, patterns: any): any;
-export function buildStackedBars(data: any, channels: any, xScale: any, yScale: any, colors: any, innerHeight: any, patterns: any): any;
-export function buildHorizontalBars(data: any, channels: any, xScale: any, yScale: any, colors: any, _innerHeight: any): any;

package/dist/index.d.ts

@@ -1,56 +0,0 @@
-export namespace Plot {
-    export { Root };
-    export { Axis };
-    export { Bar };
-    export { Grid };
-    export { Legend };
-    export { Line };
-    export { Area };
-    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";
-export { default as GeomLine } from "./geoms/Line.svelte";
-export { default as GeomArea } from "./geoms/Area.svelte";
-export { default as GeomPoint } from "./geoms/Point.svelte";
-export { default as GeomArc } from "./geoms/Arc.svelte";
-export { default as GeomBox } from "./geoms/Box.svelte";
-export { default as GeomViolin } from "./geoms/Violin.svelte";
-export { default as Chart } from "./Chart.svelte";
-export { default as Sparkline } from "./Sparkline.svelte";
-export { default as BarChart } from "./charts/BarChart.svelte";
-export { default as LineChart } from "./charts/LineChart.svelte";
-export { default as AreaChart } from "./charts/AreaChart.svelte";
-export { default as PieChart } from "./charts/PieChart.svelte";
-export { default as ScatterPlot } from "./charts/ScatterPlot.svelte";
-export { default as BoxPlot } from "./charts/BoxPlot.svelte";
-export { default as ViolinPlot } from "./charts/ViolinPlot.svelte";
-export { default as BubbleChart } from "./charts/BubbleChart.svelte";
-export { PlotState } from "./PlotState.svelte.js";
-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';
-import Grid from './Plot/Grid.svelte';
-import Legend from './Plot/Legend.svelte';
-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/brewer.d.ts

@@ -1,9 +0,0 @@
-/**
- * Get fill patterns for a set of values
- *
- * @param {Array} values - Array of values
- * @param {Object} swatch - Object with keys for color, gray, and pattern
- * @param {Boolean} gray - Boolean to determine if gray or color
- * @returns {Object} - Object with keys for pattern and color
- */
-export function getFillPatterns(values: any[], swatch: Object, gray?: boolean): Object;

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

@@ -1,8 +0,0 @@
-/**
- * Brewer for box plots.
- * fill = box interior color, color = whisker/outline stroke.
- */
-export class BoxBrewer extends QuartileBrewer {
-    boxes: any[];
-}
-import { QuartileBrewer } from './QuartileBrewer.svelte.js';

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

@@ -1,8 +0,0 @@
-/**
- * Brewer for cartesian charts (Bar, Line, Area).
- * Groups by x (and fill/color if set) and applies the given stat.
- */
-export class CartesianBrewer extends ChartBrewer {
-    transform(data: any, channels: any, stat: any): any;
-}
-import { ChartBrewer } from './brewer.svelte.js';

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

@@ -1,8 +0,0 @@
-/**
- * Brewer for pie charts. Always aggregates by the label field.
- * 'identity' is not meaningful for pie charts — falls back to 'sum'.
- */
-export class PieBrewer extends ChartBrewer {
-    transform(data: any, channels: any, stat: any): any;
-}
-import { ChartBrewer } from './brewer.svelte.js';

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

@@ -1,9 +0,0 @@
-/**
- * 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,8 +0,0 @@
-/**
- * Brewer for violin plots.
- * fill = violin body color, color = outline stroke.
- */
-export class ViolinBrewer extends QuartileBrewer {
-    violins: any[];
-}
-import { QuartileBrewer } from './QuartileBrewer.svelte.js';

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

@@ -1,66 +0,0 @@
-/**
- * Creates x-axis tick data for rendering
- *
- * @param {Object} scales - Chart scales
- * @param {Function} scales.x - X-axis scale
- * @param {Object} dimensions - Chart dimensions
- * @param {Object} options - Axis options
- * @param {number} [options.tickCount] - Number of ticks to show
- * @param {Function} [options.tickFormat] - Tick formatting function
- * @param {string} [options.label] - Axis label
- * @returns {AxisData} Axis rendering data
- */
-export function createXAxis(scales: {
-    x: Function;
-}, dimensions: Object, options: {
-    tickCount?: number | undefined;
-    tickFormat?: Function | undefined;
-    label?: string | undefined;
-}): AxisData;
-/**
- * Creates y-axis tick data for rendering
- *
- * @param {Object} scales - Chart scales
- * @param {Function} scales.y - Y-axis scale
- * @param {Object} dimensions - Chart dimensions
- * @param {Object} options - Axis options
- * @param {number} [options.tickCount] - Number of ticks to show
- * @param {Function} [options.tickFormat] - Tick formatting function
- * @param {string} [options.label] - Axis label
- * @returns {AxisData} Axis rendering data
- */
-export function createYAxis(scales: {
-    y: Function;
-}, dimensions: Object, options: {
-    tickCount?: number | undefined;
-    tickFormat?: Function | undefined;
-    label?: string | undefined;
-}): AxisData;
-/**
- * Creates grid line data for rendering
- *
- * @param {Object} scales - Chart scales
- * @param {Object} dimensions - Chart dimensions
- * @param {Object} options - Grid options
- * @param {string} [options.direction='both'] - Grid direction ('x', 'y', or 'both')
- * @param {number} [options.xTickCount] - Number of x-axis ticks
- * @param {number} [options.yTickCount] - Number of y-axis ticks
- * @returns {Object} Grid rendering data
- */
-export function createGrid(scales: Object, dimensions: Object, options: {
-    direction?: string | undefined;
-    xTickCount?: number | undefined;
-    yTickCount?: number | undefined;
-}): Object;
-/**
- * Creates DOM attributes for a tick element
- *
- * @param {TickData} tick - Tick data
- * @param {string} axis - Axis type ('x' or 'y')
- * @returns {Object} Attributes for the tick
- */
-export function createTickAttributes(tick: TickData, axis: string): Object;
-export type TickData = import("./types").TickData;
-export type AxisData = import("./types").AxisData;
-export type ChartScales = import("./types").ChartScales;
-export type ChartDimensions = import("./types").ChartDimensions;

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

@@ -1,56 +0,0 @@
-/**
- * Creates bar data for rendering
- *
- * @param {Array} data - Chart data
- * @param {Object} fields - Field mappings
- * @param {string} fields.x - X-axis field
- * @param {string} fields.y - Y-axis field
- * @param {string} fields.color - Color field (optional)
- * @param {Object} scales - Chart scales
- * @param {Function} scales.x - X-axis scale
- * @param {Function} scales.y - Y-axis scale
- * @param {Function} scales.color - Color scale
- * @param {Object} options - Options including dimensions and defaultColor
- * @param {Object} options.dimensions - Chart dimensions
- * @param {string} [options.defaultColor='#4682b4'] - Default color if no color scale
- * @returns {BarData[]} Bar data for rendering
- */
-export function createBars(data: any[], fields: {
-    x: string;
-    y: string;
-    color: string;
-}, scales: {
-    x: Function;
-    y: Function;
-    color: Function;
-}, options: {
-    dimensions: Object;
-    defaultColor?: string | undefined;
-}): BarData[];
-/**
- * Filter bars based on a selection criteria
- *
- * @param {BarData[]} bars - Bar data array
- * @param {Object} selection - Selection criteria
- * @returns {BarData[]} Filtered bars
- */
-export function filterBars(bars: BarData[], selection: Object): BarData[];
-/**
- * Creates a grouped bars layout
- *
- * @param {Array} data - Chart data
- * @param {Object} fields - Field mappings
- * @param {Object} scales - Chart scales
- * @param {Object} options - Options including dimensions and padding
- * @param {Object} options.dimensions - Chart dimensions
- * @param {number} [options.padding=0.1] - Padding between bars in a group
- * @returns {Object} Grouped bar data
- */
-export function createGroupedBars(data: any[], fields: Object, scales: Object, options: {
-    dimensions: Object;
-    padding?: number | undefined;
-}): Object;
-export type BarData = import("./types").BarData;
-export type ScaleFields = import("./types").ScaleFields;
-export type ChartScales = import("./types").ChartScales;
-export type ChartDimensions = import("./types").ChartDimensions;

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

@@ -1,114 +0,0 @@
-export function buildLegendGroups(channels: any, colorMap: any, patternMap: any, symbolMap: any): {
-    field: any;
-    items: any;
-}[];
-export class ChartBrewer {
-    /**
-     * Override in subclasses to apply stat aggregation.
-     * @param {Object[]} data
-     * @param {Object} channels
-     * @param {string|Function} stat
-     * @returns {Object[]}
-     */
-    transform(data: Object[], _channels: any, _stat: any): Object[];
-    /** Aggregated data — all derived marks read this, not #rawData */
-    processedData: Object[];
-    /** Exposes channels to subclasses for use in their own $derived properties */
-    get channels(): {};
-    /** @type {Map<unknown, {fill:string,stroke:string}>} */
-    colorMap: Map<unknown, {
-        fill: string;
-        stroke: string;
-    }>;
-    /** @type {Map<unknown, string>} */
-    patternMap: Map<unknown, string>;
-    /**
-     * Unified pattern defs for ChartPatternDefs.
-     * When fill and pattern map the same field, pattern key = color key (simple case).
-     * When they differ, each unique (fillKey, patternKey) pair gets its own pattern def
-     * so bars/areas can have distinct colors per region AND distinct textures per category.
-     * @type {Array<{ id: string, name: string, fill: string, stroke: string }>}
-     */
-    patternDefs: Array<{
-        id: string;
-        name: string;
-        fill: string;
-        stroke: string;
-    }>;
-    /** @type {Map<unknown, string>} */
-    symbolMap: Map<unknown, string>;
-    get innerWidth(): number;
-    get innerHeight(): number;
-    xScale: any;
-    yScale: any;
-    sizeScale: any;
-    bars: any;
-    lines: {
-        d: string;
-        fill: string;
-        stroke: string;
-        points: {
-            x: number;
-            y: number;
-            data: Object;
-        }[];
-        key?: unknown;
-    }[];
-    areas: {
-        d: any;
-        fill: any;
-        stroke: string;
-        key: any;
-        colorKey: any;
-        patternKey: any;
-        patternId: string | null;
-    }[] | {
-        d: any;
-        fill: any;
-        stroke: string;
-        colorKey: null;
-        patternKey: null;
-        patternId: null;
-    }[];
-    arcs: any;
-    points: {
-        data: Object;
-        cx: any;
-        cy: any;
-        r: any;
-        fill: any;
-        stroke: any;
-        symbolPath: string | null;
-        key: any;
-    }[];
-    legendGroups: {
-        field: any;
-        items: any;
-    }[];
-    get margin(): {
-        top: number;
-        right: number;
-        bottom: number;
-        left: number;
-    };
-    get width(): number;
-    get height(): number;
-    get mode(): string;
-    /**
-     * @param {{ data?: Object[], channels?: Object, width?: number, height?: number, mode?: string, margin?: Object, layers?: Object[], curve?: string, stat?: string|Function }} opts
-     *   Supported channel keys: `x`, `y`, `fill`, `color`, `pattern`, `symbol`, `size`, `label`.
-     *   `frame` is reserved for future animation use (no-op).
-     */
-    update(opts?: {
-        data?: Object[];
-        channels?: Object;
-        width?: number;
-        height?: number;
-        mode?: string;
-        margin?: Object;
-        layers?: Object[];
-        curve?: string;
-        stat?: string | Function;
-    }): void;
-    #private;
-}

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

@@ -1,26 +0,0 @@
-/**
- * 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
- * @param {string|null} field
- * @returns {unknown[]}
- */
-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", preset?: typeof defaultPreset): Map<unknown, {
-    fill: string;
-    stroke: string;
-}>;
-import { defaultPreset } from '../preset.js';

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

@@ -1,35 +0,0 @@
-/**
- * Creates chart dimensions based on width, height and margins
- *
- * @param {number} width - Total chart width
- * @param {number} height - Total chart height
- * @param {ChartMargin} margin - Chart margins
- * @returns {ChartDimensions} Chart dimensions
- */
-export function createDimensions(width?: number, height?: number, margin?: ChartMargin): ChartDimensions;
-/**
- * Updates existing dimensions with new values
- *
- * @param {ChartDimensions} dimensions - Current dimensions
- * @param {Object} updates - Values to update
- * @param {number} [updates.width] - New width
- * @param {number} [updates.height] - New height
- * @param {ChartMargin} [updates.margin] - New margin
- * @returns {ChartDimensions} Updated dimensions
- */
-export function updateDimensions(dimensions: ChartDimensions, updates?: {
-    width?: number | undefined;
-    height?: number | undefined;
-    margin?: import("./types.js").ChartMargin | undefined;
-}): ChartDimensions;
-/**
- * @typedef {import('./types').ChartMargin} ChartMargin
- * @typedef {import('./types').ChartDimensions} ChartDimensions
- */
-/**
- * Default chart margin
- * @type {ChartMargin}
- */
-export const DEFAULT_MARGIN: ChartMargin;
-export type ChartMargin = import("./types").ChartMargin;
-export type ChartDimensions = import("./types").ChartDimensions;