@sophistry/charts 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Benjamin Lucier
+
+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/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# @sophistry/charts
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Charts for sophistry scenes: bars, lines, scatter, histograms, pies, heatmaps, hierarchies and more, with keyed transitions and reveals.
+
+Part of [sophistry](https://sophistry.dev), controllable Manim for the web. Pre-1.0: minor releases may break.
+
+## Install
+
+```sh
+pnpm add @sophistry/core @sophistry/charts
+```
+
+## Example
+
+```ts
+import { createScene } from "@sophistry/core";
+import { chart, scatter } from "@sophistry/charts";
+
+const scene = createScene({ host: document.getElementById("stage") as HTMLElement });
+scene.root.add(
+  chart.create({
+    width: 12,
+    height: 6,
+    children: [scatter.create({ data: [{ x: 1, y: 2 }, { x: 2, y: 3 }], x: "x", y: "y" })],
+  }),
+);
+```
+
+Use the components in [`@sophistry/solidjs/charts`](../solidjs) or `@sophistry/react/charts` from JSX. `/math` holds the plotting helpers and `/3d` the 3D charts.
+
+## Links
+
+[Documentation](https://sophistry.dev) · [API](https://sophistry.dev/reference/api/) · [Source](https://github.com/BenjaminLucier/sophistry/tree/main/packages/charts) · MIT

package/dist/3d/bar-chart3d.d.ts

@@ -0,0 +1,56 @@
+/** A 3D bar chart: one `prism3D` box per datum. */
+import type { Prism3DProps } from "@sophistry/3d";
+import type { ColorInput } from "@sophistry/core/color";
+import type { ColorChannel, Quantity } from "../data/channels";
+import type { AnyDatum } from "../props";
+/** @category Plots */
+export interface BarChart3DProps<T = unknown> extends Omit<Prism3DProps, "center" | "width" | "height" | "depth" | "fill"> {
+    /** One box per datum. A datum with a non-finite anchor or extent is skipped. */
+    data: readonly T[];
+    /** x of each box's anchor corner (the box spans `x` to `x + width`): a constant, a key of `T` or `(d, i) => number`. */
+    x: Quantity<T>;
+    /** y of each box's anchor corner (y is up, so this is the base for upright bars). */
+    y: Quantity<T>;
+    /** z of each box's anchor corner. A data channel, not the paint order: see `zIndex`. */
+    z: Quantity<T>;
+    /** Box extent along x, added onto `x`: a constant, a key of `T` or `(d, i) => number`. @default 1 */
+    width?: Quantity<T>;
+    /** Box extent along y (the bar height), added onto `y`: a constant, a key of `T` or `(d, i) => number`. */
+    height: Quantity<T>;
+    /** Box extent along z, added onto `z`: a constant, a key of `T` or `(d, i) => number`. @default 1 */
+    depth?: Quantity<T>;
+    /** One colour for every bar, or `(d, i) => colour` per bar. Wins over `colors`. */
+    color?: ColorChannel<T>;
+    /** Colours cycled across the bars by index. Defaults to the theme's series colours. */
+    colors?: readonly ColorInput[];
+}
+type Props = BarChart3DProps<AnyDatum>;
+/**
+ * A 3D bar chart: one axis-aligned `prism3D` box per datum, anchored at its
+ * `(x, y, z)` corner and extending by `(width, height, depth)`; for upright
+ * bars set `height` to the values. Every other prop (`light`, `stroke`,
+ * `opacity`, `zIndex`, handlers, ...) goes to each box. Render under a
+ * `camera3D`.
+ *
+ * @example
+ * ```ts
+ * import { camera3D } from "@sophistry/3d";
+ * import { barChart3D } from "@sophistry/charts/3d";
+ *
+ * const sales = [
+ * 	{ month: 0, region: 0, total: 3 },
+ * 	{ month: 1, region: 0, total: 5 },
+ * 	{ month: 0, region: 1, total: 2 },
+ * ];
+ * camera3D.create({
+ * 	children: [
+ * 		barChart3D.create({ data: sales, x: "month", y: 0, z: "region", height: "total", width: 0.8, depth: 0.8 }),
+ * 	],
+ * });
+ * ```
+ *
+ * @category Plots
+ */
+export declare const barChart3D: import("@sophistry/core").Definition<Props, import("@sophistry/core/internal").CompositeNode<Props>, keyof Props>;
+export {};
+//# sourceMappingURL=bar-chart3d.d.ts.map

package/dist/3d/bar-chart3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bar-chart3d.d.ts","sourceRoot":"","sources":["../../src/3d/bar-chart3d.ts"],"names":[],"mappings":"AAAA,mDAAmD;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAI/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AASzC,sBAAsB;AACtB,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO,CAC3C,SAAQ,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAC5E,gFAAgF;IAChF,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,wHAAwH;IACxH,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACf,qFAAqF;IACrF,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACf,wFAAwF;IACxF,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACf,qGAAqG;IACrG,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpB,2GAA2G;IAC3G,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpB,qGAAqG;IACrG,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpB,mFAAmF;IACnF,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB,uFAAuF;IACvF,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CAC/B;AAID,KAAK,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;AAiEvC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,UAAU,mHAmBrB,CAAC"}

package/dist/3d/definitions.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The 3D charts' definitions, keyed by export name and sorted: merged into
+ * `@sophistry/charts/definitions`, which codegen reads to generate the
+ * bindings' 3D chart components (`export const BarChart3D = wrap(barChart3D);`).
+ * Listed by hand (eight entries) rather than collected from the barrel, so
+ * the 2D definitions record decides when to pull the `3d` peer in.
+ */
+/**
+ * Every 3D chart definition, by export name.
+ *
+ * @category Scene graph
+ */
+export declare const charts3DDefinitions: Readonly<{
+    barChart3D: import("@sophistry/core").Definition<import("./bar-chart3d").BarChart3DProps<any>, import("@sophistry/core/internal").CompositeNode<import("./bar-chart3d").BarChart3DProps<any>>, keyof import("./bar-chart3d").BarChart3DProps<any>>;
+    quiver3D: import("@sophistry/core").Definition<import("./quiver3d").Quiver3DProps<any>, import("@sophistry/core/internal").CompositeNode<import("./quiver3d").Quiver3DProps<any>>, keyof import("./quiver3d").Quiver3DProps<any>>;
+    scatter3D: import("@sophistry/core").Definition<import("./scatter3d").Scatter3DProps<any>, import("@sophistry/core/internal").CompositeNode<import("./scatter3d").Scatter3DProps<any>>, keyof import("./scatter3d").Scatter3DProps<any>>;
+    stem3D: import("@sophistry/core").Definition<import("./stem3d").Stem3DProps<any>, import("@sophistry/core/internal").CompositeNode<import("./stem3d").Stem3DProps<any>>, keyof import("./stem3d").Stem3DProps<any>>;
+    surfaceGrid3D: import("@sophistry/core").Definition<import("./surface-grid3d").SurfaceGrid3DProps, import("@sophistry/3d").Shape3DNode<import("./surface-grid3d").SurfaceGrid3DProps, readonly import("@sophistry/3d").PreparedFace[]>, keyof import("./surface-grid3d").SurfaceGrid3DProps>;
+    triSurface3D: import("@sophistry/core").Definition<import("./tri-surface3d").TriSurface3DProps<any>, import("@sophistry/3d").Shape3DNode<import("./tri-surface3d").TriSurface3DProps<any>, readonly import("@sophistry/3d").PreparedFace[]>, keyof import("./tri-surface3d").TriSurface3DProps<any>>;
+    voxels3D: import("@sophistry/core").Definition<import("./voxels3d").Voxels3DProps, import("@sophistry/3d").Shape3DNode<import("./voxels3d").Voxels3DProps, readonly import("@sophistry/3d").PreparedFace[]>, keyof import("./voxels3d").Voxels3DProps>;
+    wireframe3D: import("@sophistry/core").Definition<import("./wireframe3d").Wireframe3DProps, import("@sophistry/core/internal").CompositeNode<import("./wireframe3d").Wireframe3DProps>, keyof import("./wireframe3d").Wireframe3DProps>;
+}>;
+/**
+ * The same record under the name `@sophistry/codegen` reads.
+ *
+ * @category Charts
+ */
+export declare const definitions: Readonly<{
+    barChart3D: import("@sophistry/core").Definition<import("./bar-chart3d").BarChart3DProps<any>, import("@sophistry/core/internal").CompositeNode<import("./bar-chart3d").BarChart3DProps<any>>, keyof import("./bar-chart3d").BarChart3DProps<any>>;
+    quiver3D: import("@sophistry/core").Definition<import("./quiver3d").Quiver3DProps<any>, import("@sophistry/core/internal").CompositeNode<import("./quiver3d").Quiver3DProps<any>>, keyof import("./quiver3d").Quiver3DProps<any>>;
+    scatter3D: import("@sophistry/core").Definition<import("./scatter3d").Scatter3DProps<any>, import("@sophistry/core/internal").CompositeNode<import("./scatter3d").Scatter3DProps<any>>, keyof import("./scatter3d").Scatter3DProps<any>>;
+    stem3D: import("@sophistry/core").Definition<import("./stem3d").Stem3DProps<any>, import("@sophistry/core/internal").CompositeNode<import("./stem3d").Stem3DProps<any>>, keyof import("./stem3d").Stem3DProps<any>>;
+    surfaceGrid3D: import("@sophistry/core").Definition<import("./surface-grid3d").SurfaceGrid3DProps, import("@sophistry/3d").Shape3DNode<import("./surface-grid3d").SurfaceGrid3DProps, readonly import("@sophistry/3d").PreparedFace[]>, keyof import("./surface-grid3d").SurfaceGrid3DProps>;
+    triSurface3D: import("@sophistry/core").Definition<import("./tri-surface3d").TriSurface3DProps<any>, import("@sophistry/3d").Shape3DNode<import("./tri-surface3d").TriSurface3DProps<any>, readonly import("@sophistry/3d").PreparedFace[]>, keyof import("./tri-surface3d").TriSurface3DProps<any>>;
+    voxels3D: import("@sophistry/core").Definition<import("./voxels3d").Voxels3DProps, import("@sophistry/3d").Shape3DNode<import("./voxels3d").Voxels3DProps, readonly import("@sophistry/3d").PreparedFace[]>, keyof import("./voxels3d").Voxels3DProps>;
+    wireframe3D: import("@sophistry/core").Definition<import("./wireframe3d").Wireframe3DProps, import("@sophistry/core/internal").CompositeNode<import("./wireframe3d").Wireframe3DProps>, keyof import("./wireframe3d").Wireframe3DProps>;
+}>;
+//# sourceMappingURL=definitions.d.ts.map

package/dist/3d/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/3d/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;EAS9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;EAAsB,CAAC"}

package/dist/3d/definitions.js

@@ -0,0 +1,14 @@
+import { a as e, c as t, i as n, n as r, o as i, r as a, s as o, t as s } from "../wireframe3d-D157GZAq.js";
+//#region src/3d/definitions.ts
+var c = Object.freeze({
+	barChart3D: t,
+	quiver3D: o,
+	scatter3D: i,
+	stem3D: e,
+	surfaceGrid3D: n,
+	triSurface3D: a,
+	voxels3D: r,
+	wireframe3D: s
+}), l = c;
+//#endregion
+export { c as charts3DDefinitions, l as definitions };

package/dist/3d/forward.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Prop forwarding for the 3D charts: a chart takes its drawn primitive's
+ * props (paints, reveal, interaction, `zIndex`, `light`, `worldWidth`, ...)
+ * and hands them to every node it draws.
+ *
+ * Unlike core's composite shapes, which bind one child to each forwarded
+ * prop, a chart may draw thousands of children: binding every forwarded key
+ * on each would cost a subscription per key per child. Instead the
+ * forwarded props rerun the chart's `update`, which writes only the keys
+ * that changed to the children it already has; a new child gets every
+ * forwarded prop that is set. An unset prop stays unset on the child (an
+ * unset `zIndex` must not become `0` and take the child out of the camera's
+ * depth sort), exactly as a Solid spread passed `undefined` on.
+ *
+ * Internal: not in the barrel.
+ */
+import type { Changes, PropsDescriptor, SceneNode } from "@sophistry/core";
+import type { Point3 } from "@sophistry/core/internal";
+/**
+ * A chart's descriptor entries for the props it forwards to its drawn
+ * nodes: every one reruns `update` (which writes it to the children).
+ * Defaults are kept for docs and bindings; `instanceable` is dropped.
+ *
+ * @param descriptor - The drawn primitive's descriptor (`prism3D.descriptor`).
+ * @param omit - Keys the chart sets itself (positions, colour).
+ * @returns The entries, to spread into the chart's descriptor.
+ */
+export declare function forwardedEntries<P, const O extends keyof P = never>(descriptor: PropsDescriptor<P>, omit?: readonly O[]): PropsDescriptor<Omit<P, O>>;
+/**
+ * Writes every forwarded prop that is set to a new child, skipping keys the
+ * child's definition does not have (a stem's marker takes no `worldWidth`).
+ *
+ * @param props - The chart's props.
+ * @param child - The node just made.
+ * @param keys - The forwarded keys.
+ */
+export declare function forwardAll<P>(props: Readonly<P>, child: SceneNode, keys: readonly (keyof P)[]): void;
+/**
+ * Writes the forwarded props among `changed` (set or unset) to each child
+ * that has them.
+ *
+ * @param changed - What changed since the last `update`.
+ * @param props - The chart's props.
+ * @param children - The chart's drawn nodes.
+ * @param keys - The forwarded keys, as a set.
+ */
+export declare function forwardChanged<P>(changed: Changes<P>, props: Readonly<P>, children: readonly SceneNode[], keys: ReadonlySet<keyof P>): void;
+/**
+ * Whether `changed` holds anything besides forwarded props: a data channel,
+ * the data itself, or a context key the chart read (the theme).
+ *
+ * @param changed - What changed since the last `update`.
+ * @param keys - The forwarded keys, as a set.
+ */
+export declare function dataChanged<P>(changed: Changes<P>, keys: ReadonlySet<keyof P>): boolean;
+/**
+ * Sets a point prop only when its coordinates changed: a fresh object with
+ * the same coordinates would otherwise rebuild the child's world geometry.
+ *
+ * @param node - The child.
+ * @param key - The point prop (`center`, `from`, `to`).
+ * @param point - The new value.
+ */
+export declare function setPoint3(node: SceneNode, key: string, point: Point3): void;
+//# sourceMappingURL=forward.d.ts.map

package/dist/3d/forward.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward.d.ts","sourceRoot":"","sources":["../../src/3d/forward.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACX,OAAO,EAEP,eAAe,EACf,SAAS,EACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAKvD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,KAAK,EAClE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,IAAI,GAAE,SAAS,CAAC,EAAO,GACrB,eAAe,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAc7B;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC3B,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAClB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACxB,IAAI,CAQN;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC/B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,SAAS,SAAS,EAAE,EAC9B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,GACxB,IAAI,CASN;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC5B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,GACxB,OAAO,CAKT;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAW3E"}

package/dist/3d/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `@sophistry/charts/3d`: charts drawn through a `camera3D` from
+ * `@sophistry/3d` (an optional peer). In these charts `z` is a data
+ * channel; `zIndex` is the paint order, forwarded to every drawn node.
+ *
+ * Charts of many marks (`barChart3D`, `quiver3D`, `scatter3D`, `stem3D`,
+ * `wireframe3D`) are composites over the 3D primitives, one per datum or
+ * segment; surfaces (`surfaceGrid3D`, `triSurface3D`, `voxels3D`) are one
+ * mesh each. Either way a camera move only re-projects: the chart's world
+ * geometry is rebuilt when its data changes.
+ *
+ * @module @sophistry/charts/3d
+ * @packageDocumentation
+ */
+export type { BarChart3DProps } from "./bar-chart3d";
+export { barChart3D } from "./bar-chart3d";
+export type { Quiver3DProps } from "./quiver3d";
+export { quiver3D } from "./quiver3d";
+export type { Scatter3DProps } from "./scatter3d";
+export { scatter3D } from "./scatter3d";
+export type { Stem3DProps } from "./stem3d";
+export { stem3D } from "./stem3d";
+export type { SurfaceGrid3DProps } from "./surface-grid3d";
+export { surfaceGrid3D } from "./surface-grid3d";
+export type { TriSurface3DProps } from "./tri-surface3d";
+export { triSurface3D } from "./tri-surface3d";
+export type { Voxels3DProps } from "./voxels3d";
+export { voxels3D } from "./voxels3d";
+export type { Wireframe3DProps } from "./wireframe3d";
+export { wireframe3D } from "./wireframe3d";
+//# sourceMappingURL=index.d.ts.map

package/dist/3d/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/3d/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/3d/index.js

@@ -0,0 +1 @@
+export { c as barChart3D, s as quiver3D, o as scatter3D, a as stem3D, i as surfaceGrid3D, r as triSurface3D, n as voxels3D, t as wireframe3D } from "../wireframe3d-D157GZAq.js";

package/dist/3d/quiver3d.d.ts

@@ -0,0 +1,53 @@
+/** A 3D vector field: one `vector3D` arrow per datum. */
+import type { Vector3DProps } from "@sophistry/3d";
+import type { Channel, ColorChannel } from "../data/channels";
+import type { AnyDatum } from "../props";
+/** @category Plots */
+export interface Quiver3DProps<T = unknown> extends Omit<Vector3DProps, "from" | "to" | "stroke" | "fill"> {
+    /** One arrow per datum. A datum with a non-finite component is skipped. */
+    data: readonly T[];
+    /** World x of the arrow's tail, a key of `T` or `(d, i) => number`. */
+    x: Channel<T, number>;
+    /** World y of the arrow's tail. */
+    y: Channel<T, number>;
+    /** World z of the arrow's tail. A data channel, not the paint order: see `zIndex`. */
+    z: Channel<T, number>;
+    /** x component of the arrow's direction, in world units (before `scale`). */
+    u: Channel<T, number>;
+    /** y component of the arrow's direction. */
+    v: Channel<T, number>;
+    /** z component of the arrow's direction. */
+    w: Channel<T, number>;
+    /** Multiplies `(u, v, w)` before it becomes the drawn arrow. @default 1 */
+    scale?: number;
+    /** Arrow colour: one constant, or `(d, i) => colour` per arrow. */
+    color?: ColorChannel<T>;
+}
+type Props = Quiver3DProps<AnyDatum>;
+/**
+ * A 3D vector field: one `vector3D` arrow per datum, its tail at `(x, y, z)`
+ * and its tip at that point plus `(u, v, w) * scale` (lengths not
+ * normalised). Every other prop (`worldWidth`, `tipLength`, `opacity`,
+ * `zIndex`, handlers, ...) goes to each arrow. Render under a `camera3D`.
+ *
+ * @example
+ * ```ts
+ * import { camera3D } from "@sophistry/3d";
+ * import { quiver3D } from "@sophistry/charts/3d";
+ *
+ * const field = [
+ * 	{ x: 0, y: 0, z: 0, u: 1, v: 0, w: 0 },
+ * 	{ x: 1, y: 0, z: 0, u: 0, v: 1, w: 0 },
+ * ];
+ * camera3D.create({
+ * 	children: [
+ * 		quiver3D.create({ data: field, x: "x", y: "y", z: "z", u: "u", v: "v", w: "w", scale: 0.5 }),
+ * 	],
+ * });
+ * ```
+ *
+ * @category Plots
+ */
+export declare const quiver3D: import("@sophistry/core").Definition<Props, import("@sophistry/core/internal").CompositeNode<Props>, keyof Props>;
+export {};
+//# sourceMappingURL=quiver3d.d.ts.map

package/dist/3d/quiver3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quiver3d.d.ts","sourceRoot":"","sources":["../../src/3d/quiver3d.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAI9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AASzC,sBAAsB;AACtB,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO,CACzC,SAAQ,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9D,2EAA2E;IAC3E,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,uEAAuE;IACvE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,mCAAmC;IACnC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,sFAAsF;IACtF,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,6EAA6E;IAC7E,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,4CAA4C;IAC5C,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,4CAA4C;IAC5C,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CACxB;AAID,KAAK,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;AA0DrC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,QAAQ,mHAmBnB,CAAC"}

package/dist/3d/scatter3d.d.ts

@@ -0,0 +1,45 @@
+/** A 3D scatter plot: one `dot3D` per point. */
+import type { Dot3DProps } from "@sophistry/3d";
+import type { Channel, ColorChannel, Quantity } from "../data/channels";
+import type { AnyDatum } from "../props";
+/** @category Plots */
+export interface Scatter3DProps<T = unknown> extends Omit<Dot3DProps, "center" | "radius" | "color"> {
+    /** One marker per datum. A datum with a non-finite coordinate is skipped. */
+    data: readonly T[];
+    /** World x, a key of `T` or `(d, i) => number`. */
+    x: Channel<T, number>;
+    /** World y (up), a key of `T` or `(d, i) => number`. */
+    y: Channel<T, number>;
+    /** World z, a key of `T` or `(d, i) => number`. A data channel, not the paint order: see `zIndex`. */
+    z: Channel<T, number>;
+    /** World-unit marker radius: a constant, a key of `T` or `(d, i) => number`. @default 0.08 */
+    radius?: Quantity<T>;
+    /** Marker colour: one constant, or `(d, i) => colour` per marker. */
+    color?: ColorChannel<T>;
+}
+type Props = Scatter3DProps<AnyDatum>;
+/**
+ * A 3D scatter plot: one `dot3D` marker per finite `(x, y, z)`; `radius` and
+ * `color` may vary per datum. Every other prop (`shaded`, `stroke`,
+ * `opacity`, `zIndex`, handlers, ...) goes to each marker. Render under a
+ * `camera3D`.
+ *
+ * @example
+ * ```ts
+ * import { camera3D } from "@sophistry/3d";
+ * import { scatter3D } from "@sophistry/charts/3d";
+ *
+ * const samples = [
+ * 	{ x: 0, y: 1, z: 0 },
+ * 	{ x: 1, y: 0.5, z: -1 },
+ * ];
+ * camera3D.create({
+ * 	children: [scatter3D.create({ data: samples, x: "x", y: "y", z: "z", radius: 0.1 })],
+ * });
+ * ```
+ *
+ * @category Plots
+ */
+export declare const scatter3D: import("@sophistry/core").Definition<Props, import("@sophistry/core/internal").CompositeNode<Props>, keyof Props>;
+export {};
+//# sourceMappingURL=scatter3d.d.ts.map

package/dist/3d/scatter3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatter3d.d.ts","sourceRoot":"","sources":["../../src/3d/scatter3d.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AASzC,sBAAsB;AACtB,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO,CAC1C,SAAQ,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvD,6EAA6E;IAC7E,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,mDAAmD;IACnD,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,wDAAwD;IACxD,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,sGAAsG;IACtG,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,qEAAqE;IACrE,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CACxB;AAID,KAAK,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;AA0CtC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,SAAS,mHAgBpB,CAAC"}

package/dist/3d/stem3d.d.ts

@@ -0,0 +1,46 @@
+/** A 3D stem plot: a drop line and a marker per point. */
+import type { Line3DProps } from "@sophistry/3d";
+import type { Channel, ColorChannel } from "../data/channels";
+import type { AnyDatum } from "../props";
+/** @category Plots */
+export interface Stem3DProps<T = unknown> extends Omit<Line3DProps, "from" | "to" | "stroke" | "fill"> {
+    /** One drop line and marker per datum. A datum with a non-finite coordinate is skipped. */
+    data: readonly T[];
+    /** World x, a key of `T` or `(d, i) => number`. */
+    x: Channel<T, number>;
+    /** World y (height; the drop line runs along y from `baseline` to this value), a key of `T` or `(d, i) => number`. */
+    y: Channel<T, number>;
+    /** World z, a key of `T` or `(d, i) => number`. A data channel, not the paint order: see `zIndex`. */
+    z: Channel<T, number>;
+    /** The y value each drop line starts from. @default 0 */
+    baseline?: number;
+    /** World-unit marker radius. @default 0.08 */
+    markerRadius?: number;
+    /** Colour of line and marker: one constant, or `(d, i) => colour` per stem. */
+    color?: ColorChannel<T>;
+}
+type Props = Stem3DProps<AnyDatum>;
+/**
+ * A 3D stem plot: a drop line along world y from `baseline` to `y`, plus a
+ * marker, per point. Style props apply to lines and markers. Render under a
+ * `camera3D`.
+ *
+ * @example
+ * ```ts
+ * import { camera3D } from "@sophistry/3d";
+ * import { stem3D } from "@sophistry/charts/3d";
+ *
+ * const heights = [
+ * 	{ x: -1, y: 1.5, z: 0 },
+ * 	{ x: 1, y: 0.7, z: 1 },
+ * ];
+ * camera3D.create({
+ * 	children: [stem3D.create({ data: heights, x: "x", y: "y", z: "z", color: "#4af" })],
+ * });
+ * ```
+ *
+ * @category Plots
+ */
+export declare const stem3D: import("@sophistry/core").Definition<Props, import("@sophistry/core/internal").CompositeNode<Props>, keyof Props>;
+export {};
+//# sourceMappingURL=stem3d.d.ts.map

package/dist/3d/stem3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stem3d.d.ts","sourceRoot":"","sources":["../../src/3d/stem3d.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAIjD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAI9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AASzC,sBAAsB;AACtB,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO,CACvC,SAAQ,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5D,2FAA2F;IAC3F,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,mDAAmD;IACnD,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,sHAAsH;IACtH,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,sGAAsG;IACtG,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CACxB;AAID,KAAK,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AA2EnC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,MAAM,mHAiBjB,CAAC"}

package/dist/3d/surface-grid3d.d.ts

@@ -0,0 +1,34 @@
+/** A surface from three precomputed coordinate grids, drawn as flat-shaded quads. */
+import type { MeshFacesProps } from "@sophistry/3d";
+/** @category Plots */
+export interface SurfaceGrid3DProps extends Omit<MeshFacesProps, "faces"> {
+    /** `nrows x ncols` grid of world x coordinates, `xs[row][col]`. All three grids must share a shape, or this throws. */
+    xs: number[][];
+    /** Grid of world y (height) coordinates, same shape as `xs`. */
+    ys: number[][];
+    /** Grid of world z coordinates, same shape as `xs`. */
+    zs: number[][];
+}
+/**
+ * A surface given as three coordinate grids (`xs`, `ys`, `zs`) you compute
+ * yourself, drawn as flat-shaded quads. Faces are one-sided: with `xs`
+ * increasing along columns and `zs` along rows, the top (+y) side shows.
+ * The quads are rebuilt only when a grid changes, never on a camera move.
+ * Render under a `camera3D`.
+ *
+ * @example
+ * ```ts
+ * import { camera3D } from "@sophistry/3d";
+ * import { surfaceGrid3D } from "@sophistry/charts/3d";
+ *
+ * const xs = [[0, 1], [0, 1]];
+ * const ys = [[0, 0.5], [0.5, 1]];
+ * const zs = [[0, 0], [1, 1]];
+ * camera3D.create({ children: [surfaceGrid3D.create({ xs, ys, zs, fill: "#4af" })] });
+ * ```
+ *
+ * @see {@link surfacePlot3D} for a surface from a function.
+ * @category Plots
+ */
+export declare const surfaceGrid3D: import("@sophistry/core").Definition<SurfaceGrid3DProps, import("@sophistry/3d").Shape3DNode<SurfaceGrid3DProps, readonly import("@sophistry/3d").PreparedFace[]>, keyof SurfaceGrid3DProps>;
+//# sourceMappingURL=surface-grid3d.d.ts.map

package/dist/3d/surface-grid3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-grid3d.d.ts","sourceRoot":"","sources":["../../src/3d/surface-grid3d.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD,sBAAsB;AACtB,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC;IACxE,uHAAuH;IACvH,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;IACf,gEAAgE;IAChE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;IACf,uDAAuD;IACvD,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;CACf;AAID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,aAAa,8LAcxB,CAAC"}

package/dist/3d/tri-surface3d.d.ts

@@ -0,0 +1,46 @@
+/**
+ * A triangulated surface through scattered vertices. y is up, so the
+ * Delaunay triangulation runs over the `(x, z)` ground plane and `y` is the
+ * height.
+ */
+import type { MeshFacesProps } from "@sophistry/3d";
+import type { Channel } from "../data/channels";
+import type { AnyDatum } from "../props";
+/** @category Plots */
+export interface TriSurface3DProps<T = unknown> extends Omit<MeshFacesProps, "faces"> {
+    /** One vertex per datum. */
+    data: readonly T[];
+    /** World x of the vertex, a key of `T` or `(d, i) => number`. */
+    x: Channel<T, number>;
+    /** World y (height) of the vertex. Triangles with a non-finite height are dropped. */
+    y: Channel<T, number>;
+    /** World z of the vertex. The triangulation runs over `(x, z)`. A data channel, not the paint order: see `zIndex`. */
+    z: Channel<T, number>;
+}
+type Props = TriSurface3DProps<AnyDatum>;
+/**
+ * A surface through scattered vertices (`x`, `z` on the ground, `y` the
+ * height), Delaunay-triangulated over the ground plane and drawn as
+ * flat-shaded triangles. Fewer than three usable or all-collinear points
+ * draw nothing. The triangles are rebuilt only when the data or a channel
+ * changes, never on a camera move. Render under a `camera3D`.
+ *
+ * @example
+ * ```ts
+ * import { camera3D } from "@sophistry/3d";
+ * import { triSurface3D } from "@sophistry/charts/3d";
+ *
+ * const samples = [
+ * 	{ x: 0, y: 0, z: 0 },
+ * 	{ x: 1, y: 0.5, z: 0 },
+ * 	{ x: 0, y: 0.8, z: 1 },
+ * 	{ x: 1, y: 0.2, z: 1 },
+ * ];
+ * camera3D.create({ children: [triSurface3D.create({ data: samples, x: "x", y: "y", z: "z" })] });
+ * ```
+ *
+ * @category Plots
+ */
+export declare const triSurface3D: import("@sophistry/core").Definition<Props, import("@sophistry/3d").Shape3DNode<Props, readonly import("@sophistry/3d").PreparedFace[]>, keyof Props>;
+export {};
+//# sourceMappingURL=tri-surface3d.d.ts.map

package/dist/3d/tri-surface3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tri-surface3d.d.ts","sourceRoot":"","sources":["../../src/3d/tri-surface3d.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAY,cAAc,EAAE,MAAM,eAAe,CAAC;AAI9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,sBAAsB;AACtB,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO,CAC7C,SAAQ,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC;IACrC,4BAA4B;IAC5B,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,iEAAiE;IACjE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,sFAAsF;IACtF,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,sHAAsH;IACtH,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;CACtB;AAED,KAAK,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AAiCzC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,YAAY,uJAUvB,CAAC"}

package/dist/3d/voxels3d.d.ts

@@ -0,0 +1,26 @@
+/** A boolean voxel grid drawn as flat-shaded cube faces, hidden shared faces culled. */
+import type { MeshFacesProps } from "@sophistry/3d";
+/** @category Plots */
+export interface Voxels3DProps extends Omit<MeshFacesProps, "faces"> {
+    /** `values[i][j][k]`; ragged or `undefined` entries are empty. A `true` voxel fills the unit cube `[i,i+1] x [j,j+1] x [k,k+1]`. */
+    values: readonly (readonly (readonly boolean[])[])[];
+}
+/**
+ * A grid of unit cubes, drawn as flat-shaded quads (faces hidden by a
+ * neighbour are skipped). The faces are rebuilt only when `values` changes,
+ * never on a camera move. Render under a `camera3D`.
+ *
+ * @example
+ * ```ts
+ * import { camera3D } from "@sophistry/3d";
+ * import { voxels3D } from "@sophistry/charts/3d";
+ *
+ * // An L of three cubes.
+ * const values = [[[true], [true]], [[true]]];
+ * camera3D.create({ children: [voxels3D.create({ values, fill: "#fa4" })] });
+ * ```
+ *
+ * @category Plots
+ */
+export declare const voxels3D: import("@sophistry/core").Definition<Voxels3DProps, import("@sophistry/3d").Shape3DNode<Voxels3DProps, readonly import("@sophistry/3d").PreparedFace[]>, keyof Voxels3DProps>;
+//# sourceMappingURL=voxels3d.d.ts.map

package/dist/3d/voxels3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voxels3d.d.ts","sourceRoot":"","sources":["../../src/3d/voxels3d.ts"],"names":[],"mappings":"AAAA,wFAAwF;AAExF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD,sBAAsB;AACtB,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC;IACnE,oIAAoI;IACpI,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;CACrD;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ,+KAOnB,CAAC"}

package/dist/3d/wireframe3d.d.ts

@@ -0,0 +1,31 @@
+/** A structured-grid surface drawn as lines only: one polyline per grid row and column, as `line3D` segments. */
+import type { Line3DProps } from "@sophistry/3d";
+/** @category Primitives */
+export interface Wireframe3DProps extends Omit<Line3DProps, "from" | "to"> {
+    /** `nrows x ncols` grid of world x coordinates, `xs[row][col]`. All three grids must share a shape, or this throws. */
+    xs: number[][];
+    /** Grid of world y (height) coordinates, same shape as `xs`. */
+    ys: number[][];
+    /** Grid of world z coordinates, same shape as `xs`. */
+    zs: number[][];
+}
+/**
+ * A grid surface drawn as lines only: one polyline per grid row and column,
+ * no fill. Takes {@link surfaceGrid3D}'s grids; style props apply to every
+ * segment. Render under a `camera3D`.
+ *
+ * @example
+ * ```ts
+ * import { camera3D } from "@sophistry/3d";
+ * import { wireframe3D } from "@sophistry/charts/3d";
+ *
+ * const xs = [[0, 1], [0, 1]];
+ * const ys = [[0, 0.5], [0.5, 1]];
+ * const zs = [[0, 0], [1, 1]];
+ * camera3D.create({ children: [wireframe3D.create({ xs, ys, zs, stroke: "#4af" })] });
+ * ```
+ *
+ * @category Primitives
+ */
+export declare const wireframe3D: import("@sophistry/core").Definition<Wireframe3DProps, import("@sophistry/core/internal").CompositeNode<Wireframe3DProps>, keyof Wireframe3DProps>;
+//# sourceMappingURL=wireframe3d.d.ts.map

package/dist/3d/wireframe3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wireframe3d.d.ts","sourceRoot":"","sources":["../../src/3d/wireframe3d.ts"],"names":[],"mappings":"AAAA,iHAAiH;AAEjH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAcjD,2BAA2B;AAC3B,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACzE,uHAAuH;IACvH,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;IACf,gEAAgE;IAChE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;IACf,uDAAuD;IACvD,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;CACf;AAsDD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,WAAW,oJAatB,CAAC"}

package/dist/band.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Where a value sits on an axis that may be categorical, and whether a value
+ * axis has a zero for a mark to grow from. Pure; internal to the charts.
+ */
+import type { BandKey, BandScale, Range } from "@sophistry/core/geometry";
+/**
+ * Where `value` sits along an axis, in data units: a category's band centre
+ * on a band axis (a number is looked up as a category first, then taken as
+ * a slot coordinate), otherwise the number itself.
+ *
+ * @returns The position, or undefined when there is none.
+ */
+export declare function positionOf(band: BandScale | undefined, value: BandKey | null | undefined): number | undefined;
+/**
+ * The extent of a category's band, `[start, end]` in data units, or undefined
+ * when there is no band axis or the category is not on it.
+ */
+export declare function bandSpan(band: BandScale | undefined, value: BandKey | null | undefined): [number, number] | undefined;
+/** Whether a value axis's range contains 0 for a mark to grow from; marks on axes without one fade in instead. */
+export declare function growsFromZero(range: Readonly<Range>): boolean;
+//# sourceMappingURL=band.d.ts.map