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

package/dist/lib/grid.d.ts

@@ -1,72 +0,0 @@
-/**
- * @typedef GridPoint
- * @property {number} x - x-coordinate of the point
- * @property {number} y - y-coordinate of the point
- * @property {number} r - radius of the point
- */
-/**
- * @typedef SwatchGrid
- * @property {number}      width  - width of the grid
- * @property {number}      height - height of the grid
- * @property {GridPoint[]} data   - data points of the grid
- */
-/**
- * @tyoedef {Object} GridOptions
- * @property {number} [pad=0]     - The padding between the items
- * @property {number} [columns=0] - The number of columns
- * @property {number} [rows=0]    - The number of rows
- */
-/**
- * Calculates a grid of centres to fit a list of items of `size` within the number of `columns` and `rows`.
- *
- * - Attempts to find a best fit square if both columns and rows are not specified
- * - Value in columns is prioritized over rows for recalculating the grid
- * - Supports padding between the items
- *
- * @param {number}      count   - number of items
- * @param {number}      size    - size of the items
- * @param {GridOptions} options - options for the grid
- * @returns {SwatchGrid}
- */
-export function swatchGrid(count: number, size: number, options: GridOptions): SwatchGrid;
-/**
- * Spreads values as patterns with colors from a palette
- *
- * @param {number[]} values   - values to spread
- * @param {string[]} patterns - patterns to spread
- * @param {string[]} palette  - colors to spread
- * @returns {Record<number, { id: string, pattern: string, color: string }>}
- */
-export function spreadValuesAsPatterns(values: number[], patterns: string[], palette: string[]): Record<number, {
-    id: string;
-    pattern: string;
-    color: string;
-}>;
-export type GridPoint = {
-    /**
-     * - x-coordinate of the point
-     */
-    x: number;
-    /**
-     * - y-coordinate of the point
-     */
-    y: number;
-    /**
-     * - radius of the point
-     */
-    r: number;
-};
-export type SwatchGrid = {
-    /**
-     * - width of the grid
-     */
-    width: number;
-    /**
-     * - height of the grid
-     */
-    height: number;
-    /**
-     * - data points of the grid
-     */
-    data: GridPoint[];
-};

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

@@ -1,15 +0,0 @@
-/**
- * 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/chartProps.d.ts

@@ -1,177 +0,0 @@
-/**
- * Common props shared by all high-level chart wrappers.
- */
-export type ChartProps = {
-    /**
-     * - Data array to visualize
-     */
-    data?: Object[] | undefined;
-    /**
-     * - Field name for the X axis
-     */
-    x?: string | undefined;
-    /**
-     * - Field name for the Y axis
-     */
-    y?: string | undefined;
-    /**
-     * - Field name for fill color grouping (alias for color)
-     */
-    fill?: string | undefined;
-    /**
-     * - Field name for color grouping
-     */
-    color?: string | undefined;
-    /**
-     * - Field name for pattern fill grouping
-     */
-    pattern?: string | undefined;
-    /**
-     * - Aggregation stat: 'identity' | 'sum' | 'mean' | 'count' | 'min' | 'max' | 'median' | 'boxplot'
-     */
-    stat?: string | undefined;
-    /**
-     * - SVG width in pixels
-     */
-    width?: number | undefined;
-    /**
-     * - SVG height in pixels
-     */
-    height?: number | undefined;
-    /**
-     * - Color mode: 'light' | 'dark'
-     */
-    mode?: string | undefined;
-    /**
-     * - Whether to show grid lines
-     */
-    grid?: boolean | undefined;
-    /**
-     * - Whether to show the legend
-     */
-    legend?: boolean | undefined;
-};
-export type BarChartProps = Object;
-export type PieChartProps = {
-    /**
-     * - Data array to visualize
-     */
-    data?: Object[] | undefined;
-    /**
-     * - Field name for slice labels (drives color key)
-     */
-    label?: string | undefined;
-    /**
-     * - Field name for slice values (theta)
-     */
-    y?: string | undefined;
-    /**
-     * - Alternative to label for color grouping
-     */
-    fill?: string | undefined;
-    /**
-     * - Inner radius as fraction of outer (0=pie, 0.5=donut)
-     */
-    innerRadius?: number | undefined;
-    /**
-     * - Aggregation stat (default sum for pie charts)
-     */
-    stat?: string | undefined;
-    /**
-     * - SVG width in pixels
-     */
-    width?: number | undefined;
-    /**
-     * - SVG height in pixels
-     */
-    height?: number | undefined;
-    /**
-     * - Color mode: 'light' | 'dark'
-     */
-    mode?: string | undefined;
-    /**
-     * - Whether to show the legend
-     */
-    legend?: boolean | undefined;
-};
-export type BoxViolinChartProps = {
-    /**
-     * - Data array to visualize
-     */
-    data?: Object[] | undefined;
-    /**
-     * - Field name for the category axis (groups)
-     */
-    x?: string | undefined;
-    /**
-     * - Field name for the value axis (raw observations)
-     */
-    y?: string | undefined;
-    /**
-     * - Field name for fill color; when different from x, sub-groups within each x-band (like grouped bars); lighter shade used for body, darker shade for whiskers/outline
-     */
-    fill?: string | undefined;
-    /**
-     * - SVG width in pixels
-     */
-    width?: number | undefined;
-    /**
-     * - SVG height in pixels
-     */
-    height?: number | undefined;
-    /**
-     * - Color mode: 'light' | 'dark'
-     */
-    mode?: string | undefined;
-    /**
-     * - Whether to show grid lines
-     */
-    grid?: boolean | undefined;
-    /**
-     * - Whether to show the legend
-     */
-    legend?: boolean | undefined;
-};
-export type ScatterBubbleChartProps = {
-    /**
-     * - Data array to visualize
-     */
-    data?: Object[] | undefined;
-    /**
-     * - Field name for X position
-     */
-    x?: string | undefined;
-    /**
-     * - Field name for Y position
-     */
-    y?: string | undefined;
-    /**
-     * - Field name for color grouping
-     */
-    color?: string | undefined;
-    /**
-     * - Field name for point radius (BubbleChart: required)
-     */
-    size?: string | undefined;
-    /**
-     * - SVG width in pixels
-     */
-    width?: number | undefined;
-    /**
-     * - SVG height in pixels
-     */
-    height?: number | undefined;
-    /**
-     * - Color mode: 'light' | 'dark'
-     */
-    mode?: string | undefined;
-    /**
-     * - Whether to show grid lines
-     */
-    grid?: boolean | undefined;
-    /**
-     * - Whether to show the legend
-     */
-    legend?: boolean | undefined;
-};
-export type LineAreaChartProps = Object;

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

@@ -1,13 +0,0 @@
-/**
- * Applies dimming state to data rows using crossfilter instance.
- * Maps each row to { data: row, dimmed: boolean }.
- *
- * @param {Object[]} data - raw data array
- * @param {Object} cf - crossfilter instance (from createCrossFilter)
- * @param {Object} channels - { x, y, color, ... } field name mapping
- * @returns {{ data: Object, dimmed: boolean }[]}
- */
-export function applyDimming(data: Object[], cf: Object, channels: Object): {
-    data: Object;
-    dimmed: boolean;
-}[];

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

@@ -1,24 +0,0 @@
-/**
- * Splits data into a Map of panels keyed by facet field value.
- * Preserves insertion order of first occurrence.
- *
- * @param {Object[]} data
- * @param {string} field
- * @returns {Map<unknown, Object[]>}
- */
-export function splitByField(data: Object[], field: string): Map<unknown, Object[]>;
-/**
- * Computes x/y domains for each panel.
- *
- * @param {Map<unknown, Object[]>} panels
- * @param {{ x: string, y: string }} channels
- * @param {'fixed'|'free'|'free_x'|'free_y'} scalesMode
- * @returns {Map<unknown, { xDomain: unknown[], yDomain: [number, number] }>}
- */
-export function getFacetDomains(panels: Map<unknown, Object[]>, channels: {
-    x: string;
-    y: string;
-}, scalesMode?: "fixed" | "free" | "free_x" | "free_y"): Map<unknown, {
-    xDomain: unknown[];
-    yDomain: [number, number];
-}>;

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

@@ -1,47 +0,0 @@
-/**
- * Extracts animation frames from data, keyed by time field value.
- * Preserves insertion order of time values.
- *
- * @param {Object[]} data
- * @param {string} timeField
- * @returns {Map<unknown, Object[]>}
- */
-export function extractFrames(data: Object[], timeField: string): Map<unknown, Object[]>;
-/**
- * Ensures all frame values (byField) appear for every (x, color?) combination.
- * Uses dataset alignBy to fill missing frame-value combos with y=0 so bars
- * animate smoothly rather than disappearing between frames.
- *
- * Call after pre-aggregation. The result can be split directly by extractFrames
- * with no further per-frame normalization needed.
- *
- * @param {Object[]} data - pre-aggregated rows, one per (x, color?, byField)
- * @param {{ x?: string, y: string, color?: string }} channels
- * @param {string} byField - the frame field (e.g. 'year')
- * @returns {Object[]}
- */
-export function completeFrames(data: Object[], channels: {
-    x?: string;
-    y: string;
-    color?: string;
-}, byField: string): Object[];
-/**
- * Computes static x/y domains from the full (pre-split) data array.
- * These domains stay constant throughout the animation so values are
- * always comparable across frames.
- *
- * NOTE: y domain is pinned to [0, max] — assumes bar chart semantics.
- * Pass an explicit yDomain override for scatter/line charts where y can
- * be negative.
- *
- * @param {Object[]} data - full dataset (before frame extraction)
- * @param {{ x: string, y: string }} channels
- * @returns {{ xDomain: unknown[], yDomain: [number, number] }}
- */
-export function computeStaticDomains(data: Object[], channels: {
-    x: string;
-    y: string;
-}): {
-    xDomain: unknown[];
-    yDomain: [number, number];
-};

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

@@ -1,3 +0,0 @@
-export function resolveFormat(field: any, helpers?: {}): any;
-export function resolveTooltip(helpers?: {}): any;
-export function resolveGeom(type: any, helpers?: {}): any;

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

@@ -1,29 +0,0 @@
-export function resolvePreset(name: any, helpers?: {}): {
-    colors: any;
-    patterns: any;
-    symbols: any;
-};
-export namespace DEFAULT_PRESET {
-    export let colors: any[];
-    export { PATTERN_ORDER as patterns };
-    export { SYMBOL_ORDER as symbols };
-}
-export namespace ACCESSIBLE_PRESET {
-    let colors_1: string[];
-    export { colors_1 as colors };
-    export { PATTERN_ORDER as patterns };
-    export { SYMBOL_ORDER as symbols };
-}
-export namespace PRINT_PRESET {
-    let colors_2: string[];
-    export { colors_2 as colors };
-    export let patterns: string[];
-    export { SYMBOL_ORDER as symbols };
-}
-export type PlotPreset = {
-    colors: string[];
-    patterns: string[];
-    symbols: string[];
-};
-import { PATTERN_ORDER } from '../brewing/patterns.js';
-import { SYMBOL_ORDER } from '../brewing/symbols.js';

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

@@ -1,5 +0,0 @@
-export function inferFieldType(data: any, field: any): "continuous" | "band";
-export function inferOrientation(xType: any, yType: any): "none" | "vertical" | "horizontal";
-export function buildUnifiedXScale(datasets: any, field: any, width: any, opts?: {}): any;
-export function buildUnifiedYScale(datasets: any, field: any, height: any, opts?: {}): any;
-export function inferColorScaleType(data: any, field: any, spec?: {}): any;

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

@@ -1,32 +0,0 @@
-/**
- * Resolves a stat name to an aggregation function.
- * Checks built-ins first, then helpers.stats, then warns and falls back to identity.
- *
- * @param {string} name
- * @param {Object} helpers
- * @returns {Function}
- */
-export function resolveStat(name: string, helpers?: Object): Function;
-/**
- * Infers group-by fields from channels by excluding value fields.
- * valueFields may contain channel keys (e.g. ['y', 'size']) OR field values (e.g. ['cty']).
- * A channel's field is excluded if either the channel key OR the field value is in valueFields.
- *
- * @param {Record<string, string|undefined>} channels
- * @param {string[]} valueFields
- * @returns {string[]}
- */
-export function inferGroupByFields(channels: Record<string, string | undefined>, valueFields: string[]): string[];
-/**
- * Applies a stat aggregation to data based on a geom config.
- * Returns data unchanged for identity stat.
- *
- * @param {Object[]} data
- * @param {{ stat?: string, channels?: Record<string, string> }} geomConfig
- * @param {Object} helpers
- * @returns {Object[]}
- */
-export function applyGeomStat(data: Object[], geomConfig: {
-    stat?: string;
-    channels?: Record<string, string>;
-}, helpers?: Object): Object[];

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

@@ -1,89 +0,0 @@
-export type GeomSpec = {
-    /**
-     * - Geom type: 'bar'|'line'|'area'|'point'|'box'|'violin'|'arc' or custom
-     */
-    type: string;
-    x?: string | undefined;
-    y?: string | undefined;
-    color?: string | undefined;
-    fill?: string | undefined;
-    size?: string | undefined;
-    symbol?: string | undefined;
-    pattern?: string | undefined;
-    /**
-     * - Built-in or helpers.stats key
-     */
-    stat?: string | undefined;
-    options?: Record<string, unknown> | undefined;
-};
-export type PlotSpec = {
-    data: Record<string, unknown>[];
-    x?: string | undefined;
-    y?: string | undefined;
-    color?: string | undefined;
-    fill?: string | undefined;
-    size?: string | undefined;
-    symbol?: string | undefined;
-    pattern?: string | undefined;
-    theta?: string | undefined;
-    labels?: Record<string, string> | undefined;
-    xDomain?: unknown[] | undefined;
-    yDomain?: number[] | undefined;
-    xLabel?: string | undefined;
-    yLabel?: string | undefined;
-    axisOrigin?: [number, number] | undefined;
-    colorScale?: "diverging" | "sequential" | "categorical" | undefined;
-    colorScheme?: string | undefined;
-    colorMidpoint?: number | undefined;
-    colorDomain?: unknown[] | undefined;
-    geoms: GeomSpec[];
-    facet?: {
-        by: string;
-        cols?: number;
-        scales?: "fixed" | "free" | "free_x" | "free_y";
-    } | undefined;
-    animate?: {
-        by: string;
-        duration?: number;
-        loop?: boolean;
-    } | undefined;
-    grid?: boolean | undefined;
-    legend?: boolean | undefined;
-    tooltip?: boolean | undefined;
-    title?: string | undefined;
-    preset?: string | undefined;
-    width?: number | undefined;
-    height?: number | undefined;
-    mode?: "light" | "dark" | undefined;
-};
-export type PlotHelpers = {
-    stats?: Record<string, (values: unknown[]) => unknown> | undefined;
-    format?: Record<string, (v: unknown) => string> | undefined;
-    tooltip?: ((d: Record<string, unknown>) => string) | undefined;
-    /**
-     * Svelte components keyed by type name
-     */
-    geoms?: Record<string, unknown> | undefined;
-    /**
-     * d3 scale override
-     */
-    colorScale?: unknown;
-    preset?: {
-        colors: string[];
-        patterns: string[];
-        symbols: string[];
-    } | undefined;
-    presets?: Record<string, {
-        colors: string[];
-        patterns: string[];
-        symbols: string[];
-    }> | undefined;
-    /**
-     * custom SVG pattern components keyed by name
-     */
-    patterns?: Record<string, unknown> | undefined;
-    /**
-     * custom symbol shape components keyed by name
-     */
-    symbols?: Record<string, unknown> | undefined;
-};

package/dist/lib/preset.d.ts

@@ -1,30 +0,0 @@
-/**
- * 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/dist/lib/scales.svelte.d.ts

@@ -1,35 +0,0 @@
-export function createScales(data: any, dimensions: any, options: any): {
-    xScale?: undefined;
-    yScale?: undefined;
-    colorScale?: undefined;
-} | {
-    xScale: any;
-    yScale: any;
-    colorScale: Object | null;
-};
-/**
- * Calculates the actual chart dimensions after applying margins
- *
- * @param {number} width
- * @param {number} height
- * @param {Object} margin
- * @returns {Object} Dimensions with calculated inner width and height
- */
-export function calculateChartDimensions(width: number, height: number, margin: Object): Object;
-/**
- * Gets the axis origin value
- *
- * @param {Object} scale D3 scale
- * @returns {number} Origin value
- */
-export function getOriginValue(scale: Object): number;
-/**
- * Creates axis ticks
- *
- * @param {Object} scale D3 scale
- * @param {string} axis Axis type ('x' or 'y')
- * @param {number} count Number of ticks
- * @param {number} fontSize Font size for determining tick density
- * @returns {Array} Array of tick objects
- */
-export function createTicks(scale: Object, axis: string, count?: number, fontSize?: number): any[];

package/dist/lib/swatch.d.ts

@@ -1,12 +0,0 @@
-export namespace swatch {
-    export { palette };
-    export namespace keys {
-        export let gray: string[];
-        export let color: string[];
-        export { shapes as symbol };
-        export { PATTERN_ORDER as pattern };
-    }
-}
-import palette from './palette.json';
-import { shapes } from '../symbols';
-import { PATTERN_ORDER } from './brewing/patterns.js';

package/dist/lib/ticks.d.ts

@@ -1,36 +0,0 @@
-/**
- * @typedef {Object} TickSteps
- * @property {number} major - count of major ticks
- * @property {number} minor - count of minor ticks
- */
-/**
- * Generate an array of ticks for a given axis and the tick type
- *
- * @param {number}    lower - The lower bound of the axis
- * @param {number}    upper - The upper bound of the axis
- * @param {TickSteps} steps - The number of steps between major and minor ticks
- * @param {string}    type  - The type of tick to generate
- *
- * @returns {Array} - An array of objects representing the ticks
- */
-export function ticksByType(lower: number, upper: number, steps: TickSteps, type: string): any[];
-/**
- * Generate an array of ticks for a given axis
- *
- * @param {number}    lower - The lower bound of the axis
- * @param {number}    upper - The upper bound of the axis
- * @param {TickSteps} steps - The number of steps between major and minor ticks
- *
- * @returns {Array} - An array of objects representing the ticks
- */
-export function getTicks(lower: number, upper: number, steps?: TickSteps): any[];
-export type TickSteps = {
-    /**
-     * - count of major ticks
-     */
-    major: number;
-    /**
-     * - count of minor ticks
-     */
-    minor: number;
-};