svelteplot 0.0.1-alpha.9 → 0.1.3-next.11

package/dist/transforms/shift.d.ts

@@ -0,0 +1,13 @@
+import type { DataRecord, TransformArg } from '../types.js';
+type RequireAtLeastOne<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & {
+    [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>>;
+}[Keys];
+type ShiftXOptions = {
+    [key in 'x' | 'x1' | 'x2']: string | number;
+};
+export declare function shiftX({ data, ...channels }: TransformArg<DataRecord>, shiftBy: string | number | RequireAtLeastOne<ShiftXOptions>): TransformArg<DataRecord>;
+type ShiftYOptions = {
+    [key in 'y' | 'y1' | 'y2']: string | number;
+};
+export declare function shiftY({ data, ...channels }: TransformArg<DataRecord>, shiftBy: string | number | RequireAtLeastOne<ShiftYOptions>): TransformArg<DataRecord>;
+export {};

package/dist/transforms/shift.js

@@ -0,0 +1,45 @@
+import { resolveChannel } from '../helpers/resolve.js';
+import { maybeTimeInterval } from '../helpers/time.js';
+export function shiftX({ data, ...channels }, shiftBy) {
+    if (typeof shiftBy === 'number' || typeof shiftBy === 'string') {
+        shiftBy = { x: shiftBy };
+    }
+    if (shiftBy) {
+        if (shiftBy)
+            return shiftChannels('x', shiftBy, { data, ...channels });
+    }
+    return { data, ...channels };
+}
+export function shiftY({ data, ...channels }, shiftBy) {
+    if (typeof shiftBy === 'number' || typeof shiftBy === 'string') {
+        shiftBy = { y: shiftBy };
+    }
+    if (shiftBy)
+        return shiftChannels('y', shiftBy, { data, ...channels });
+    return { data, ...channels };
+}
+function shiftChannels(shiftDim, shiftBy, { data, ...channels }) {
+    return {
+        data: data.map((d) => {
+            const newRow = { ...d };
+            for (const [channel, shift] of Object.entries(shiftBy)) {
+                const shiftFrom = (channels[channel] != null ? channel : shiftDim);
+                if (typeof shift === 'number') {
+                    newRow[`__shift_${channel}`] =
+                        resolveChannel(shiftFrom, d, channels) + shift;
+                }
+                else if (typeof shift === 'string') {
+                    const [, sign, value, unit] = shift.match(/^([+-])?(\d+)? ?([a-z]+)$/);
+                    const step = (sign === '-' ? -1 : 1) * (value || 1);
+                    const interval = maybeTimeInterval(unit);
+                    if (!interval)
+                        throw new Error(`Invalid shift interval: ${shift}`);
+                    newRow[`__shift_${channel}`] = interval.offset(resolveChannel(shiftFrom, d, channels), step);
+                }
+            }
+            return newRow;
+        }),
+        ...channels,
+        ...Object.fromEntries(Object.keys(shiftBy).map((key) => [key, `__shift_${key}`]))
+    };
+}

package/dist/transforms/sort.d.ts

@@ -0,0 +1,28 @@
+import type { DataRecord, DataRow, TransformArg } from '../types.js';
+export declare const SORT_KEY: unique symbol;
+export declare function sort({ data, ...channels }: TransformArg<DataRecord>, options?: {
+    reverse?: boolean;
+}): {
+    sort: null;
+    data: {
+        ___orig___?: import("../types.js").RawValue | [import("../types.js").RawValue, import("../types.js").RawValue];
+    }[];
+} | {
+    data: DataRecord[];
+};
+/**
+ * reverses the data row order
+ */
+export declare function shuffle({ data, ...channels }: TransformArg<DataRow[]>, options?: {
+    seed?: number;
+}): {
+    sort: null;
+    data: DataRow[][];
+};
+/**
+ * reverses the data row order
+ */
+export declare function reverse({ data, ...channels }: TransformArg<DataRow[]>): {
+    sort: null;
+    data: DataRow[][];
+};

package/dist/transforms/sort.js

@@ -0,0 +1,66 @@
+import isDataRecord from '../helpers/isDataRecord.js';
+import { resolveChannel } from '../helpers/resolve.js';
+import { shuffler } from 'd3-array';
+import { randomLcg } from 'd3-random';
+export const SORT_KEY = Symbol('sortKey');
+export function sort({ data, ...channels }, options = {}) {
+    if (!Array.isArray(data))
+        return { data, ...channels };
+    if (channels.sort) {
+        const { sort } = channels;
+        if (isDataRecord(sort) &&
+            typeof sort.channel === 'string' &&
+            sort.channel.charAt(0) === '-') {
+            sort.channel = sort.channel.substring(1);
+            sort.order = 'descending';
+        }
+        // sort data
+        return {
+            data: data
+                .map((d) => ({
+                ...d,
+                [SORT_KEY]: resolveChannel('sort', d, { ...channels, sort })
+            }))
+                .toSorted((a, b) => (a[SORT_KEY] > b[SORT_KEY] ? 1 : a[SORT_KEY] < b[SORT_KEY] ? -1 : 0) *
+                (options.reverse || (isDataRecord(sort) && sort?.order === 'descending')
+                    ? -1
+                    : 1))
+                .map(({ [SORT_KEY]: a, ...rest }) => rest),
+            ...channels,
+            // set the sort channel to null to disable the implicit alphabetical
+            // ordering of ordinal domains, and also to avoid double sorting in case
+            // this transform is used "outside" a mark
+            sort: null
+        };
+    }
+    return {
+        data,
+        ...channels
+    };
+}
+/**
+ * reverses the data row order
+ */
+export function shuffle({ data, ...channels }, options = {}) {
+    const random = randomLcg(options.seed);
+    const shuffle = shuffler(random);
+    return {
+        data: shuffle([...data]),
+        ...channels,
+        // set the sort channel to null to disable the implicit
+        // alphabetical ordering of ordinal domains
+        sort: null
+    };
+}
+/**
+ * reverses the data row order
+ */
+export function reverse({ data, ...channels }) {
+    return {
+        data: data.toReversed(),
+        ...channels,
+        // set the sort channel to null to disable the implicit
+        // alphabetical ordering of ordinal domains
+        sort: null
+    };
+}

package/dist/transforms/stack.d.ts

@@ -0,0 +1,10 @@
+import type { TransformArg } from '../types.js';
+export type StackOrder = 'none' | 'appearance' | 'inside-out' | 'sum';
+export type StackOffset = 'none' | 'wiggle' | 'center' | 'normalize' | 'diverging';
+export type StackOptions = {
+    offset: null | StackOffset;
+    order: null | StackOrder;
+    reverse: boolean;
+};
+export declare function stackY<T>({ data, ...channels }: T, opts?: Partial<StackOptions>): T;
+export declare function stackX({ data, ...channels }: TransformArg, opts?: Partial<StackOptions>): TransformArg;

package/dist/transforms/stack.js

@@ -0,0 +1,110 @@
+import isDataRecord from '../helpers/isDataRecord.js';
+import { resolveChannel } from '../helpers/resolve.js';
+import { stack, stackOffsetExpand, stackOffsetSilhouette, stackOffsetWiggle, stackOrderAppearance, stackOrderAscending, stackOrderInsideOut, stackOrderNone, stackOffsetDiverging } from 'd3-shape';
+import { index, union, groups as d3Groups } from 'd3-array';
+const DEFAULT_STACK_OPTIONS = {
+    order: null,
+    offset: null,
+    reverse: false
+};
+const STACK_ORDER = {
+    // null
+    // TODO: value: ,
+    none: stackOrderNone,
+    sum: stackOrderAscending,
+    appearance: stackOrderAppearance,
+    'inside-out': stackOrderInsideOut
+};
+const STACK_OFFSET = {
+    none: null,
+    diverging: stackOffsetDiverging,
+    wiggle: stackOffsetWiggle,
+    center: stackOffsetSilhouette,
+    normalize: stackOffsetExpand
+};
+function stackXY(byDim, data, channels, options) {
+    // we need to stack the data for each facet separately
+    const groupFacetsBy = [
+        channels.fx != null ? 'fx' : null,
+        channels.fy != null ? 'fy' : null
+    ].filter((d) => d !== null);
+    const groupBy = channels.z ? 'z' : channels.fill ? 'fill' : channels.stroke ? 'stroke' : true;
+    const secondDim = byDim === 'x' ? (channels.y1 != null ? 'y1' : 'y') : channels.x1 != null ? 'x1' : 'x';
+    const byLow = `${byDim}1`;
+    const byHigh = `${byDim}2`;
+    if (channels[byDim] != null &&
+        channels[`${byLow}`] === undefined &&
+        channels[`${byHigh}`] === undefined) {
+        // resolve all channels for easier computation below
+        const resolvedData = data.map((d) => ({
+            ...(isDataRecord(d) ? d : { __orig: d }),
+            [`__${secondDim}`]: resolveChannel(secondDim, d, channels),
+            __group: groupBy === true ? 'G' : resolveChannel(groupBy, d, channels),
+            __facet: groupFacetsBy.length > 0
+                ? groupFacetsBy
+                    .map((channel) => String(resolveChannel(channel, d, channels)))
+                    .join('---')
+                : 'F',
+            [`__${byDim}`]: resolveChannel(byDim, d, channels)
+        }));
+        // the final data ends up here
+        const out = [];
+        // first we group the dataset by facets to avoid stacking of rows that are
+        // in separate panels
+        const groups = d3Groups(resolvedData, (d) => d.__facet);
+        for (const [, facetData] of groups) {
+            // now we index the data on the second dimension, e.g. over x
+            // when stacking over y
+            const indexed = index(facetData, (d) => d[`__${secondDim}`], (d) => d.__group);
+            const stackOrder = (series) => {
+                const f = STACK_ORDER[options.order || 'none'];
+                return options.reverse ? f(series).reverse() : f(series);
+            };
+            // now stack the values for each index
+            const series = stack()
+                .order(stackOrder)
+                .offset(STACK_OFFSET[options.offset])
+                .keys(union(facetData.map((d) => d.__group)))
+                .value(([, group], key) => (group.get(key) ? group.get(key)[`__${byDim}`] : 0))(indexed);
+            // and combine it all back into a flat array
+            const newData = series
+                .map((values) => {
+                const groupKey = values.key;
+                return values
+                    .filter((d) => d.data[1].get(groupKey))
+                    .map((d) => {
+                    const datum = d.data[1].get(groupKey);
+                    // cleanup our internal keys
+                    delete datum.__group;
+                    delete datum.__facet;
+                    return { ...datum, [`__${byLow}`]: d[0], [`__${byHigh}`]: d[1] };
+                });
+            })
+                .flat(1);
+            // which we then add to the output data
+            out.push(newData);
+        }
+        return {
+            data: out.flat(1),
+            ...channels,
+            [byDim]: undefined,
+            ...(typeof channels[byDim] === 'string' && !channels[`__${byDim}_origField`]
+                ? { [`__${byDim}_origField`]: channels[byDim] }
+                : {}),
+            ...{ [byLow]: `__${byLow}`, [byHigh]: `__${byHigh}` }
+        };
+    }
+    return { data, ...channels };
+}
+export function stackY({ data, ...channels }, opts = {}) {
+    return stackXY('y', data, channels, applyDefaults(opts));
+}
+export function stackX({ data, ...channels }, opts = {}) {
+    return stackXY('x', data, channels, applyDefaults(opts));
+}
+function applyDefaults(opts) {
+    if (opts.offset === 'wiggle' && opts.order === undefined) {
+        return { ...DEFAULT_STACK_OPTIONS, order: 'inside-out', ...opts };
+    }
+    return { ...DEFAULT_STACK_OPTIONS, ...opts };
+}

package/dist/transforms/window.d.ts

@@ -0,0 +1,22 @@
+import { type ReducerName } from '../helpers/reduce.js';
+import type { DataRecord, TransformArg } from '../types.js';
+type WindowOptions = {
+    k: number;
+    interval: string;
+    anchor: 'start' | 'middle' | 'end';
+    reduce: ReducerName;
+    strict: boolean;
+};
+export declare function windowX(args: TransformArg<DataRecord>, options: WindowOptions): {
+    data: {
+        [x: string]: import("../types.js").RawValue;
+        ___orig___?: import("../types.js").RawValue | [import("../types.js").RawValue, import("../types.js").RawValue];
+    }[];
+};
+export declare function windowY(args: TransformArg<DataRecord>, options: WindowOptions): {
+    data: {
+        [x: string]: import("../types.js").RawValue;
+        ___orig___?: import("../types.js").RawValue | [import("../types.js").RawValue, import("../types.js").RawValue];
+    }[];
+};
+export {};

package/dist/transforms/window.js

@@ -0,0 +1,73 @@
+import { maybeInterval } from '../helpers/autoTicks.js';
+import { isValid } from '../helpers/index.js';
+import { Reducer, mayberReducer } from '../helpers/reduce.js';
+import { resolveChannel } from '../helpers/resolve.js';
+import { groups as d3Groups } from 'd3-array';
+export function windowX(args, options) {
+    return windowDim('x', args, options);
+}
+export function windowY(args, options) {
+    return windowDim('y', args, options);
+}
+function windowDim(dim, { data, ...channels }, options) {
+    const { anchor = 'middle', reduce = 'mean', strict = false } = options;
+    let { k, interval } = options;
+    interval = maybeInterval(interval, 'time');
+    // we only change the data, but not the
+    if (!((k = Math.floor(k)) > 0))
+        throw new Error(`invalid k: ${k}`);
+    const reduceFn = mayberReducer(reduce);
+    // group by z, fill or stroke
+    const groupBy = channels.z != null
+        ? 'z'
+        : channels.fill != null
+            ? 'fill'
+            : channels.stroke != null
+                ? 'stroke'
+                : false;
+    const groups = groupBy
+        ? d3Groups(data, (d) => resolveChannel(groupBy, d, channels)).map(([, v]) => v)
+        : [data];
+    const out = [];
+    const reduceChannels = [dim, `${dim}1`, `${dim}2`].filter((d) => channels[d] != null);
+    const shift = anchor === 'start' ? 0 : anchor === 'end' ? k - 1 : (k - 1) >> 1;
+    for (const values of groups) {
+        // resolve all "x" values
+        const X = values.map((d) => Object.fromEntries(reduceChannels.map((channel) => [channel, resolveChannel(channel, d, channels)])));
+        const Y = interval
+            ? values.map((d, index) => ({
+                index,
+                value: resolveChannel(dim === 'x' ? 'y' : 'x', d, channels)
+            }))
+            : [];
+        const L = values.length;
+        for (let i = 0; i < L; i++) {
+            const s0 = Math.max(0, i - shift);
+            const newDatum = { ...values[i] };
+            let yWindow = new Set();
+            if (interval) {
+                const minDate = interval.offset(Y[i].value, -shift);
+                const maxDate = interval.offset(Y[i].value, -shift + k);
+                yWindow = new Set(Y.filter(({ value }) => value >= minDate && value <= maxDate).map(({ index }) => index));
+            }
+            for (const channel of reduceChannels) {
+                const window = (interval
+                    ? // we select X values based on the interval
+                        X.filter((d, i) => yWindow.has(i))
+                    : X.slice(s0, Math.min(L, i - shift + k)))
+                    .map((d) => d[channel])
+                    .filter(isValid);
+                const reduced = strict && window.length < (strict === true ? k : strict)
+                    ? null
+                    : reduceFn(window);
+                newDatum[`__reduced_${channel}__`] = reduced;
+            }
+            out.push(newDatum);
+        }
+    }
+    return {
+        data: out,
+        ...channels,
+        ...Object.fromEntries(reduceChannels.map((channel) => [channel, `__reduced_${channel}__`]))
+    };
+}