svelteplot 0.10.3 → 0.11.0

package/dist/transforms/select.js

@@ -1,6 +1,10 @@
 import { groupFacetsAndZ } from '../helpers/group.js';
 import { resolveChannel } from '../helpers/resolve.js';
 // let o: SelectOptions = { x: 'min'};
+/**
+ * selects one datum per group based on the given criteria; use "first"/"last"
+ * for positional selection, or `{channel: "min"/"max"}` for value-based selection
+ */
 export function select({ data, ...channels }, options) {
     const newData = [];
     groupFacetsAndZ(data, channels, (items) => {
@@ -22,7 +26,11 @@ export function select({ data, ...channels }, options) {
                 ...item,
                 __sortby: resolveChannel(sortOptions[0][0], item, channels)
             }))
-                .sort((a, b) => (a.__sortby > b.__sortby ? 1 : a.__sortby < b.__sortby ? -1 : 0))
+                .sort((a, b) => a.__sortby > b.__sortby
+                ? 1
+                : a.__sortby < b.__sortby
+                    ? -1
+                    : 0)
                 .at(sortOptions[0][1] === 'min' ? 0 : -1);
             newData.push(selected);
         }
@@ -41,15 +49,19 @@ export function selectFirst(args) {
 export function selectLast(args) {
     return select(args, 'last');
 }
+/** keeps only the datum with the smallest x value per group */
 export function selectMinX(args) {
     return select(args, { x: 'min' });
 }
+/** keeps only the datum with the largest x value per group */
 export function selectMaxX(args) {
     return select(args, { x: 'max' });
 }
+/** keeps only the datum with the smallest y value per group */
 export function selectMinY(args) {
     return select(args, { y: 'min' });
 }
+/** keeps only the datum with the largest y value per group */
 export function selectMaxY(args) {
     return select(args, { y: 'max' });
 }

package/dist/transforms/shift.d.ts

@@ -2,12 +2,20 @@ import type { DataRecord, TransformArg } from '../types/index.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];
+/** per-channel shift amounts for x channels; values can be numbers or time interval strings (e.g. "1 month") */
 type ShiftXOptions = {
     [key in 'x' | 'x1' | 'x2']: string | number;
 };
+/**
+ * shifts the x channel values by a fixed amount or time interval
+ */
 export declare function shiftX({ data, ...channels }: TransformArg<DataRecord>, shiftBy: string | number | RequireAtLeastOne<ShiftXOptions>): TransformArg<DataRecord>;
+/** per-channel shift amounts for y channels; values can be numbers or time interval strings (e.g. "1 month") */
 type ShiftYOptions = {
     [key in 'y' | 'y1' | 'y2']: string | number;
 };
+/**
+ * shifts the y channel values by a fixed amount or time interval
+ */
 export declare function shiftY({ data, ...channels }: TransformArg<DataRecord>, shiftBy: string | number | RequireAtLeastOne<ShiftYOptions>): TransformArg<DataRecord>;
 export {};

package/dist/transforms/shift.js

@@ -1,21 +1,32 @@
 import { resolveChannel } from '../helpers/resolve.js';
 import { maybeTimeInterval } from '../helpers/time.js';
+/**
+ * shifts the x channel values by a fixed amount or time interval
+ */
 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 shiftChannels('x', shiftBy, {
+            data,
+            ...channels
+        });
     }
     return { data, ...channels };
 }
+/**
+ * shifts the y channel values by a fixed amount or time interval
+ */
 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 shiftChannels('y', shiftBy, {
+            data,
+            ...channels
+        });
     return { data, ...channels };
 }
 function shiftChannels(shiftDim, shiftBy, { data, ...channels }) {
@@ -29,11 +40,14 @@ function shiftChannels(shiftDim, shiftBy, { data, ...channels }) {
                         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 match = shift.match(/^([+-])?(\d+)? ?([a-z]+)$/);
+                    if (!match)
+                        throw new Error(`Invalid shift format: '${shift}'`);
+                    const [, sign, value, unit] = match;
+                    const step = (sign === '-' ? -1 : 1) * (Number(value) || 1);
                     const interval = maybeTimeInterval(unit);
                     if (!interval)
-                        throw new Error(`Invalid shift interval: ${shift}`);
+                        throw new Error(`Invalid shift interval: '${shift}'`);
                     newRow[`__shift_${channel}`] = interval.offset(resolveChannel(shiftFrom, d, channels), step);
                 }
             }

package/dist/transforms/sort.d.ts

@@ -1,268 +1,23 @@
-import type { DataRow, TransformArg } from '../types/index.js';
 export declare const SORT_KEY: unique symbol;
 export declare const IS_SORTED: unique symbol;
-export declare function sort<T>({ data, ...channels }: TransformArg<T>, options?: {
-    reverse?: boolean;
-}): {
-    [IS_SORTED]: string | number | true | symbol | object;
-    sort: null;
-    filter?: import("../types/index.js").ConstantAccessor<boolean, T>;
-    facet?: "auto" | "include" | "exclude" | undefined;
-    fx?: import("../types/channel.js").ChannelAccessor<T>;
-    fy?: import("../types/channel.js").ChannelAccessor<T>;
-    dx?: import("../types/index.js").ConstantAccessor<number, T>;
-    dy?: import("../types/index.js").ConstantAccessor<number, T>;
-    dodgeX?: import("./dodge.js").DodgeXOptions | undefined;
-    dodgeY?: import("./dodge.js").DodgeYOptions | undefined;
-    fill?: import("../types/channel.js").ChannelAccessor<T>;
-    fillOpacity?: import("../types/index.js").ConstantAccessor<number, T>;
-    stroke?: import("../types/channel.js").ChannelAccessor<T>;
-    strokeWidth?: import("../types/index.js").ConstantAccessor<number, T>;
-    strokeOpacity?: import("../types/index.js").ConstantAccessor<number, T>;
-    strokeLinejoin?: import("../types/index.js").ConstantAccessor<import("csstype").Property.StrokeLinejoin, T>;
-    strokeLinecap?: import("../types/index.js").ConstantAccessor<import("csstype").Property.StrokeLinecap, T>;
-    strokeMiterlimit?: import("../types/index.js").ConstantAccessor<number, T>;
-    opacity?: import("../types/channel.js").ChannelAccessor<T>;
-    strokeDasharray?: import("../types/index.js").ConstantAccessor<string, T>;
-    strokeDashoffset?: import("../types/index.js").ConstantAccessor<number, T>;
-    mixBlendMode?: import("../types/index.js").ConstantAccessor<import("csstype").Property.MixBlendMode, T>;
-    clipPath?: string | undefined;
-    mask?: string | undefined;
-    imageFilter?: import("../types/index.js").ConstantAccessor<string, T>;
-    shapeRendering?: import("../types/index.js").ConstantAccessor<import("csstype").Property.ShapeRendering, T>;
-    paintOrder?: import("../types/index.js").ConstantAccessor<string, T>;
-    onclick?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondblclick?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseup?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmousedown?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseenter?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmousemove?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseleave?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseout?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseover?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointercancel?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerdown?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerup?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerenter?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerleave?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointermove?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerover?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerout?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondrag?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondrop?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragstart?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragenter?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragleave?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragover?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragend?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchstart?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchmove?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchend?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchcancel?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    oncontextmenu?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onwheel?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    class?: string | undefined;
-    style?: string | undefined;
-    cursor?: import("../types/index.js").ConstantAccessor<import("csstype").Property.Cursor, T>;
-    data: T[] | Omit<T & {
-        [SORT_KEY]: string | number | Date;
-    }, typeof SORT_KEY>[];
-} | {
-    filter?: import("../types/index.js").ConstantAccessor<boolean, T>;
-    facet?: "auto" | "include" | "exclude" | undefined;
-    fx?: import("../types/channel.js").ChannelAccessor<T>;
-    fy?: import("../types/channel.js").ChannelAccessor<T>;
-    dx?: import("../types/index.js").ConstantAccessor<number, T>;
-    dy?: import("../types/index.js").ConstantAccessor<number, T>;
-    dodgeX?: import("./dodge.js").DodgeXOptions | undefined;
-    dodgeY?: import("./dodge.js").DodgeYOptions | undefined;
-    fill?: import("../types/channel.js").ChannelAccessor<T>;
-    fillOpacity?: import("../types/index.js").ConstantAccessor<number, T>;
-    sort?: ((a: import("../types/data.js").RawValue, b: import("../types/data.js").RawValue) => number) | {
-        channel: string;
-        order?: "ascending" | "descending";
-    } | import("../types/index.js").ConstantAccessor<import("../types/data.js").RawValue, T>;
-    stroke?: import("../types/channel.js").ChannelAccessor<T>;
-    strokeWidth?: import("../types/index.js").ConstantAccessor<number, T>;
-    strokeOpacity?: import("../types/index.js").ConstantAccessor<number, T>;
-    strokeLinejoin?: import("../types/index.js").ConstantAccessor<import("csstype").Property.StrokeLinejoin, T>;
-    strokeLinecap?: import("../types/index.js").ConstantAccessor<import("csstype").Property.StrokeLinecap, T>;
-    strokeMiterlimit?: import("../types/index.js").ConstantAccessor<number, T>;
-    opacity?: import("../types/channel.js").ChannelAccessor<T>;
-    strokeDasharray?: import("../types/index.js").ConstantAccessor<string, T>;
-    strokeDashoffset?: import("../types/index.js").ConstantAccessor<number, T>;
-    mixBlendMode?: import("../types/index.js").ConstantAccessor<import("csstype").Property.MixBlendMode, T>;
-    clipPath?: string | undefined;
-    mask?: string | undefined;
-    imageFilter?: import("../types/index.js").ConstantAccessor<string, T>;
-    shapeRendering?: import("../types/index.js").ConstantAccessor<import("csstype").Property.ShapeRendering, T>;
-    paintOrder?: import("../types/index.js").ConstantAccessor<string, T>;
-    onclick?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondblclick?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseup?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmousedown?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseenter?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmousemove?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseleave?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseout?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseover?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointercancel?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerdown?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerup?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerenter?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerleave?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointermove?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerover?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerout?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondrag?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondrop?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragstart?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragenter?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragleave?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragover?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragend?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchstart?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchmove?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchend?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchcancel?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    oncontextmenu?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onwheel?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    class?: string | undefined;
-    style?: string | undefined;
-    cursor?: import("../types/index.js").ConstantAccessor<import("csstype").Property.Cursor, T>;
+type TransformLike<T = Record<string | symbol, any>> = {
     data: T[];
-};
+} & Record<string | symbol, any>;
+/**
+ * sorts the data according to the sort channel option; supports channel
+ * accessors, comparator functions, and `{channel, order}` objects
+ */
+export declare function sort<T, C extends TransformLike<T> = TransformLike<T>>({ data, ...channels }: C, options?: {
+    reverse?: boolean;
+}): C;
 /**
  * shuffles the data row order
  */
-export declare function shuffle({ data, ...channels }: TransformArg<DataRow[]>, options?: {
+export declare function shuffle({ data, ...channels }: TransformLike, options?: {
     seed?: number;
-}): {
-    sort: null;
-    [IS_SORTED]: boolean;
-    filter?: import("../types/index.js").ConstantAccessor<boolean, DataRow[]>;
-    facet?: "auto" | "include" | "exclude" | undefined;
-    fx?: import("../types/channel.js").ChannelAccessor<DataRow[]>;
-    fy?: import("../types/channel.js").ChannelAccessor<DataRow[]>;
-    dx?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    dy?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    dodgeX?: import("./dodge.js").DodgeXOptions | undefined;
-    dodgeY?: import("./dodge.js").DodgeYOptions | undefined;
-    fill?: import("../types/channel.js").ChannelAccessor<DataRow[]>;
-    fillOpacity?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    stroke?: import("../types/channel.js").ChannelAccessor<DataRow[]>;
-    strokeWidth?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    strokeOpacity?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    strokeLinejoin?: import("../types/index.js").ConstantAccessor<import("csstype").Property.StrokeLinejoin, DataRow[]>;
-    strokeLinecap?: import("../types/index.js").ConstantAccessor<import("csstype").Property.StrokeLinecap, DataRow[]>;
-    strokeMiterlimit?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    opacity?: import("../types/channel.js").ChannelAccessor<DataRow[]>;
-    strokeDasharray?: import("../types/index.js").ConstantAccessor<string, DataRow[]>;
-    strokeDashoffset?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    mixBlendMode?: import("../types/index.js").ConstantAccessor<import("csstype").Property.MixBlendMode, DataRow[]>;
-    clipPath?: string | undefined;
-    mask?: string | undefined;
-    imageFilter?: import("../types/index.js").ConstantAccessor<string, DataRow[]>;
-    shapeRendering?: import("../types/index.js").ConstantAccessor<import("csstype").Property.ShapeRendering, DataRow[]>;
-    paintOrder?: import("../types/index.js").ConstantAccessor<string, DataRow[]>;
-    onclick?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondblclick?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseup?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmousedown?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseenter?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmousemove?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseleave?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseout?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseover?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointercancel?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerdown?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerup?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerenter?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerleave?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointermove?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerover?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerout?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondrag?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondrop?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragstart?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragenter?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragleave?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragover?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragend?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchstart?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchmove?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchend?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchcancel?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    oncontextmenu?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onwheel?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    class?: string | undefined;
-    style?: string | undefined;
-    cursor?: import("../types/index.js").ConstantAccessor<import("csstype").Property.Cursor, DataRow[]>;
-    data: DataRow[][];
-};
+}): TransformLike;
 /**
  * reverses the data row order
  */
-export declare function reverse({ data, ...channels }: TransformArg<DataRow[]>): {
-    sort: null;
-    [IS_SORTED]: boolean;
-    filter?: import("../types/index.js").ConstantAccessor<boolean, DataRow[]>;
-    facet?: "auto" | "include" | "exclude" | undefined;
-    fx?: import("../types/channel.js").ChannelAccessor<DataRow[]>;
-    fy?: import("../types/channel.js").ChannelAccessor<DataRow[]>;
-    dx?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    dy?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    dodgeX?: import("./dodge.js").DodgeXOptions | undefined;
-    dodgeY?: import("./dodge.js").DodgeYOptions | undefined;
-    fill?: import("../types/channel.js").ChannelAccessor<DataRow[]>;
-    fillOpacity?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    stroke?: import("../types/channel.js").ChannelAccessor<DataRow[]>;
-    strokeWidth?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    strokeOpacity?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    strokeLinejoin?: import("../types/index.js").ConstantAccessor<import("csstype").Property.StrokeLinejoin, DataRow[]>;
-    strokeLinecap?: import("../types/index.js").ConstantAccessor<import("csstype").Property.StrokeLinecap, DataRow[]>;
-    strokeMiterlimit?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    opacity?: import("../types/channel.js").ChannelAccessor<DataRow[]>;
-    strokeDasharray?: import("../types/index.js").ConstantAccessor<string, DataRow[]>;
-    strokeDashoffset?: import("../types/index.js").ConstantAccessor<number, DataRow[]>;
-    mixBlendMode?: import("../types/index.js").ConstantAccessor<import("csstype").Property.MixBlendMode, DataRow[]>;
-    clipPath?: string | undefined;
-    mask?: string | undefined;
-    imageFilter?: import("../types/index.js").ConstantAccessor<string, DataRow[]>;
-    shapeRendering?: import("../types/index.js").ConstantAccessor<import("csstype").Property.ShapeRendering, DataRow[]>;
-    paintOrder?: import("../types/index.js").ConstantAccessor<string, DataRow[]>;
-    onclick?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondblclick?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseup?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmousedown?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseenter?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmousemove?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseleave?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseout?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onmouseover?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointercancel?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerdown?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerup?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerenter?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerleave?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointermove?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerover?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onpointerout?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondrag?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondrop?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragstart?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragenter?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragleave?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragover?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ondragend?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchstart?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchmove?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchend?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    ontouchcancel?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    oncontextmenu?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    onwheel?: import("svelte/elements").MouseEventHandler<SVGPathElement> | undefined;
-    class?: string | undefined;
-    style?: string | undefined;
-    cursor?: import("../types/index.js").ConstantAccessor<import("csstype").Property.Cursor, DataRow[]>;
-    data: DataRow[][];
-};
+export declare function reverse({ data, ...channels }: TransformLike): TransformLike;
+export {};

package/dist/transforms/sort.js

@@ -4,9 +4,11 @@ import { shuffler } from 'd3-array';
 import { randomLcg } from 'd3-random';
 export const SORT_KEY = Symbol('sortKey');
 export const IS_SORTED = Symbol('isSorted');
+/**
+ * sorts the data according to the sort channel option; supports channel
+ * accessors, comparator functions, and `{channel, order}` objects
+ */
 export function sort({ data, ...channels }, options = {}) {
-    if (!Array.isArray(data))
-        return { data, ...channels };
     if (channels.sort) {
         const { sort } = channels;
         if (isDataRecord(sort) &&
@@ -23,15 +25,16 @@ export function sort({ data, ...channels }, options = {}) {
             data: isComparator
                 ? data.toSorted(channels.sort)
                 : data
-                    .map((d) => ({
-                    ...d,
-                    [SORT_KEY]: resolveChannel('sort', d, { ...channels, sort })
+                    .map((datum) => ({
+                    datum,
+                    [SORT_KEY]: resolveChannel('sort', datum, { ...channels, sort })
                 }))
-                    .map((d) => ({
-                    ...d,
-                    [SORT_KEY]: typeof d[SORT_KEY] === 'number' && !Number.isFinite(d[SORT_KEY])
+                    .map((entry) => ({
+                    ...entry,
+                    [SORT_KEY]: typeof entry[SORT_KEY] === 'number' &&
+                        !Number.isFinite(entry[SORT_KEY])
                         ? Number.POSITIVE_INFINITY
-                        : d[SORT_KEY]
+                        : entry[SORT_KEY]
                 }))
                     .toSorted((a, b) => (typeof a[SORT_KEY] === 'string' && typeof b[SORT_KEY] === 'string'
                     ? a[SORT_KEY].localeCompare(b[SORT_KEY])
@@ -44,7 +47,7 @@ export function sort({ data, ...channels }, options = {}) {
                         (isDataRecord(sort) && sort?.order === 'descending')
                         ? -1
                         : 1))
-                    .map(({ [SORT_KEY]: a, ...rest }) => rest),
+                    .map((entry) => entry.datum),
             ...channels,
             [IS_SORTED]: sort,
             // set the sort channel to null to disable the implicit alphabetical

package/dist/transforms/stack.d.ts

@@ -1,17 +1,46 @@
-import type { ChannelAccessor, TransformArg } from '../types/index.js';
+import type { ChannelAccessor, TransformArg, Channels } from '../types/index.js';
+/** the order in which series are stacked */
 export type StackOrder = 'none' | 'appearance' | 'inside-out' | 'sum';
+/** the offset method used to position stacked values */
 export type StackOffset = 'none' | 'wiggle' | 'center' | 'normalize' | 'diverging';
+/** options for the stack transform, or false to disable stacking */
 export type StackOptions = {
+    /** the offset method, or null for the default (zero baseline) */
     offset: null | StackOffset;
+    /** the stack order, or null for the default (input order) */
     order: null | StackOrder;
+    /** if true, reverse the stack order */
     reverse: boolean;
 } | false;
+/**
+ * stacks data along the y dimension, producing y1 and y2 channels
+ */
 export declare function stackY<T>({ data, ...channels }: TransformArg<T>, opts?: Partial<StackOptions>): TransformArg<T>;
+/**
+ * stacks data along the x dimension, producing x1 and x2 channels
+ */
 export declare function stackX<T>({ data, ...channels }: TransformArg<T>, opts?: Partial<StackOptions>): TransformArg<T>;
-export declare function stackMosaicX<T>(args: any, opts: any): {
-    fx: ChannelAccessor<unknown>;
-    fy: ChannelAccessor<unknown>;
-    data: unknown[];
+declare function stackMosaic<T>({ data, x, y, value, fx, fy, ...rest }: {
+    data: T[];
+    x: ChannelAccessor<T>;
+    y: ChannelAccessor<T>;
+    value: ChannelAccessor<T>;
+    fx?: ChannelAccessor<T>;
+    fy?: ChannelAccessor<T>;
+} & Channels<T>, { outer, inner }: {
+    outer: 'x' | 'y';
+    inner: 'x' | 'y';
+}, { x: xOpt, y: yOpt }?: {
+    x?: {
+        percent?: boolean;
+    };
+    y?: {
+        percent?: boolean;
+    };
+}): {
+    fx: ChannelAccessor<T>;
+    fy: ChannelAccessor<T>;
+    data: T[];
     x: symbol;
     x1: symbol;
     x2: symbol;
@@ -19,10 +48,14 @@ export declare function stackMosaicX<T>(args: any, opts: any): {
     y1: symbol;
     y2: symbol;
 };
-export declare function stackMosaicY<T>(args: any, opts: any): {
-    fx: ChannelAccessor<unknown>;
-    fy: ChannelAccessor<unknown>;
-    data: unknown[];
+/**
+ * creates a mosaic layout with the outer (width) dimension along x and
+ * the inner (height) dimension along y
+ */
+export declare function stackMosaicX<T>(args: Parameters<typeof stackMosaic<T>>[0], opts?: Parameters<typeof stackMosaic<T>>[2]): {
+    fx: ChannelAccessor<T>;
+    fy: ChannelAccessor<T>;
+    data: T[];
     x: symbol;
     x1: symbol;
     x2: symbol;
@@ -30,3 +63,19 @@ export declare function stackMosaicY<T>(args: any, opts: any): {
     y1: symbol;
     y2: symbol;
 };
+/**
+ * creates a mosaic layout with the outer (height) dimension along y and
+ * the inner (width) dimension along x
+ */
+export declare function stackMosaicY<T>(args: Parameters<typeof stackMosaic<T>>[0], opts?: Parameters<typeof stackMosaic<T>>[2]): {
+    fx: ChannelAccessor<T>;
+    fy: ChannelAccessor<T>;
+    data: T[];
+    x: symbol;
+    x1: symbol;
+    x2: symbol;
+    y: symbol;
+    y1: symbol;
+    y2: symbol;
+};
+export {};