@sophistry/charts 0.0.0-stage → 0.0.1

package/dist/hierarchy/drill.d.ts

@@ -0,0 +1,246 @@
+/**
+ * Tap-to-drill for the zoomable hierarchy charts (`treemap`, `icicle`,
+ * `sunburst`, `circlePack`, `tree`): {@link createDrillDown}, which turns
+ * "zoom to this node" into a tweened, scrubbable `{ from, to, t }` focus,
+ * plus the drill props the charts share and the interaction a chart's
+ * batched node carries.
+ *
+ * The drill-down is plain tracks (`focus` and `path` are `Readable`s a chart
+ * prop binds to) and its zoom runs on a clock it is given. A chart without
+ * a controlled `focus` keeps one of its own on its scene's clock.
+ *
+ * A chart's nodes are one batched node, so the chart is one tab stop whose
+ * nodes the arrow keys walk (the accessibility layer's item list): Enter or
+ * Space taps the current node (drilling as a tap does), Escape zooms out one
+ * level (`aria-keyshortcuts="Escape"`). The item list walks every drawn node.
+ */
+import type { Clock, CompositeContext, Easing, KeyboardBehaviour, PlayResult, Readable, ReducedMotion, ScenePointerEvent, Track } from "@sophistry/core";
+import type { Point } from "@sophistry/core/geometry";
+import type { HierarchyPathSpec } from "../math/breadcrumbs";
+import type { HierarchyNodeInfo } from "../math/hierarchy";
+import type { TooltipSpec, TooltipState } from "../tooltip";
+import type { HierarchyFocusSpec, ResolvedFocus } from "./shared";
+/**
+ * How a drill-down zoom animates.
+ *
+ * @category Charts
+ */
+export interface DrillOptions {
+    /** Length of the zoom, in seconds. @default 0.75 */
+    duration?: number;
+    /** Easing of the zoom. @default "smooth" */
+    easing?: Easing;
+}
+/**
+ * Options for {@link createDrillDown}.
+ *
+ * @category Charts
+ */
+export interface DrillDownOptions extends DrillOptions {
+    /** The path in focus at first. Defaults to the root. @default [] */
+    initial?: readonly string[];
+    /**
+     * The clock the zoom's tween runs on: pass the scene's (`scene.clock`) so
+     * it pauses and steps with it. @default defaultClock
+     */
+    clock?: Clock;
+    /**
+     * Whether the zoom reduces motion (jumps to its end): `"auto"` defers to
+     * the clock, a `Readable` answers live (a scene's own setting).
+     * @default "auto"
+     */
+    reducedMotion?: ReducedMotion | Readable<boolean>;
+    /** Called just before a reduced-motion zoom jumps to its end. */
+    onReducedJump?: () => void;
+}
+/**
+ * A drill-down's state: where it is going and the tween getting it there.
+ * Returned by {@link createDrillDown}.
+ *
+ * @category Charts
+ */
+export interface DrillDown {
+    /**
+     * The focus to hand to a chart (and to {@link breadcrumbs}): a transition
+     * from the view when the last zoom started to {@link DrillDown.path}. A
+     * `Readable`: pass it as the chart's `focus` prop and the chart follows.
+     */
+    readonly focus: Readable<HierarchyPathSpec>;
+    /** Where the drill-down is (or is going): names below the root. */
+    readonly path: Readable<readonly string[]>;
+    /** The last zoom's 0..1 track; set or scrub it to replay that zoom. */
+    readonly t: Track<number>;
+    /**
+     * Zooms to the node at `path` from the view on screen now, interrupting any
+     * running zoom. Resolves `"done"`, or `"aborted"` if replaced; a no-op when
+     * already there. Hand it straight to a chart's `onFocusChange` or a trail's
+     * `onSelect`.
+     */
+    zoomTo(path: readonly string[]): Promise<PlayResult>;
+    /** Zooms out one level, to the parent of {@link DrillDown.path}. */
+    zoomOut(): Promise<PlayResult>;
+}
+/**
+ * Animated, scrubbable drill-down for a zoomable hierarchy chart. Pass
+ * `focus` to the chart (and to {@link breadcrumbs}), and `zoomTo` to the
+ * chart's `onFocusChange`; every frame is a pure function of the track `t`.
+ * Give it the scene's clock so the zoom runs with the scene.
+ *
+ * @example
+ * ```ts
+ * import { createScene } from "@sophistry/core";
+ * import { createDrillDown, treemap } from "@sophistry/charts";
+ *
+ * const scene = createScene({ host: document.querySelector("#figure")!, units: 10 });
+ * const files = {
+ * 	name: "repo",
+ * 	children: [
+ * 		{ name: "src", children: [{ name: "index.ts", size: 12 }, { name: "chart.ts", size: 30 }] },
+ * 		{ name: "README.md", size: 4 },
+ * 	],
+ * };
+ * const zoom = createDrillDown({ clock: scene.clock });
+ * scene.add(
+ * 	treemap.create({
+ * 		data: files,
+ * 		value: "size",
+ * 		label: "name",
+ * 		width: 8,
+ * 		height: 4,
+ * 		focus: zoom.focus,
+ * 		onFocusChange: (path) => void zoom.zoomTo(path),
+ * 	}),
+ * );
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#hierarchies
+ * @category Charts
+ */
+export declare function createDrillDown(options?: DrillDownOptions): DrillDown;
+/**
+ * A breadcrumb trail drawn by a zoomable hierarchy chart itself (its
+ * `breadcrumbs` prop), by default just above the chart's top-left corner.
+ *
+ * @category Charts
+ */
+export interface HierarchyBreadcrumbOptions {
+    /** The root crumb's text. Defaults to the root's `label`, else `"All"`. */
+    root?: string;
+    /** Where the trail starts (its left end, vertically centred). */
+    at?: Point;
+    /** Font size. Defaults to the chart's label size + 0.04. */
+    fontSize?: number;
+    /**
+     * The widest the trail may be before its middle collapses into `…`;
+     * `false` never collapses. Defaults to the chart's width.
+     */
+    maxWidth?: number | false;
+    /**
+     * A back control before the trail (`true` for `"←"`, or its text) that zooms
+     * out one level.
+     * @default false
+     */
+    back?: boolean | string;
+}
+/**
+ * Tap-to-drill props shared by `treemap`, `icicle`, `sunburst`, `circlePack`
+ * and `tree`. Uncontrolled (`drill`, no `focus`), the chart keeps its own
+ * focus and tweens to tapped nodes; controlled (`focus` + `onFocusChange`),
+ * a tap only calls `onFocusChange`. A tap on the focused node zooms out,
+ * on a parent zooms in, on a leaf zooms to its parent; Enter and Space tap
+ * the node the arrow keys are on, Escape zooms out. Focus is by name path,
+ * so keep sibling labels unique.
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#hierarchies
+ * @category Charts
+ */
+export interface HierarchyDrillProps<T> {
+    /**
+     * Tap or Enter on a node to zoom to it: `true`, or the zoom's timing.
+     * Defaults to true when `onFocusChange` is given, else false.
+     */
+    drill?: boolean | DrillOptions;
+    /** Called when a tap or breadcrumb asks to zoom, with the path below the root and that node's datum. */
+    onFocusChange?: (path: string[], datum: NoInfer<T>) => void;
+    /** The uncontrolled focus at first: a path of names below the root. Defaults to the root. */
+    defaultFocus?: readonly string[];
+    /** Draw a breadcrumb trail of the focus path above the chart; tap a crumb to zoom out to it. */
+    breadcrumbs?: boolean | HierarchyBreadcrumbOptions;
+}
+/** The drill prop keys every zoomable hierarchy chart declares. */
+export declare const DRILL_PROP_KEYS: readonly ["drill", "onFocusChange", "defaultFocus", "breadcrumbs", "focus"];
+/** A chart's drill-down state on one update: the focus to draw and how to ask for a new one. @internal */
+export interface HierarchyDrill<T> {
+    /** The focus to draw. */
+    focus: HierarchyFocusSpec<T> | undefined;
+    /** Whether taps drill. */
+    enabled: boolean;
+    /** Whether asking to zoom does anything (uncontrolled, or someone listens). */
+    canSelect: boolean;
+    /** Asks to zoom to the node at `position` of the current layout. */
+    select(position: number): void;
+    /** Asks to zoom to a path. */
+    selectPath(path: readonly string[]): void;
+}
+/** The props {@link createHierarchyDrill} reads. */
+type DrillChartProps<T> = HierarchyDrillProps<T> & {
+    focus?: HierarchyFocusSpec<T>;
+};
+/**
+ * A chart's drill-down: its `focus`, `drill`, `onFocusChange` and
+ * `defaultFocus` props resolved, with the uncontrolled focus kept on the
+ * scene's clock. The chart reruns its `update` while its own zoom runs.
+ * Call once, in `setup`; call the result in every update.
+ *
+ * @internal
+ */
+export declare function createHierarchyDrill<T, P extends DrillChartProps<T>>(ctx: CompositeContext<P>): (props: DrillChartProps<T>, nodes: readonly HierarchyNodeInfo<T>[]) => HierarchyDrill<T>;
+/** What a chart's node interaction reads on each event: the latest update's state. @internal */
+export interface NodeInteractionState<T> {
+    /** The chart's tooltip. */
+    tooltip: TooltipState;
+    /** The chart's `tooltip` prop. */
+    spec: TooltipSpec<T> | undefined;
+    /** The whole layout. */
+    nodes: readonly HierarchyNodeInfo<T>[];
+    /** The node the zoom is heading for. */
+    target: number;
+    /** The resolved focus: no tooltip opens while it moves. */
+    resolved: ResolvedFocus;
+    drill: HierarchyDrill<T>;
+    /** A batched item's position in the whole layout, or undefined. */
+    positionOf(item: number): number | undefined;
+    /** Where a batched item's tooltip points, in scene units. */
+    atOf(item: number): Point | undefined;
+}
+/** The interaction props a hierarchy chart's batched node carries. @internal */
+export interface NodeInteractionProps {
+    label?: string;
+    itemLabel?: (item: number) => string | undefined;
+    onEnter?: (event: ScenePointerEvent) => void;
+    onLeave?: (event: ScenePointerEvent) => void;
+    onTap?: (event: ScenePointerEvent) => void;
+    keyboard?: KeyboardBehaviour;
+    cursor?: string;
+}
+/** A chart's node interaction: see {@link createNodeInteraction}. @internal */
+export interface NodeInteraction {
+    /**
+     * The props to spread into the batched node's shared props (empty when
+     * neither drilling nor tooltips are on), naming the node `name`.
+     */
+    props(name: string): NodeInteractionProps;
+    /** Taps the node at layout `position` (its tooltip pointing at `at`), as a tap on its item does. */
+    tapNode(position: number, at: Point): void;
+}
+/**
+ * The interaction of a hierarchy chart's batched node (tooltip, drilling
+ * tap, Escape, cursor, each node's accessible name), made once so the
+ * handlers' identities hold across updates. `stateOf` hands back the latest
+ * update's state. Call once, in `setup`.
+ *
+ * @internal
+ */
+export declare function createNodeInteraction<T>(stateOf: () => NodeInteractionState<T>): NodeInteraction;
+export {};
+//# sourceMappingURL=drill.d.ts.map

package/dist/hierarchy/drill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drill.d.ts","sourceRoot":"","sources":["../../src/hierarchy/drill.ts"],"names":[],"mappings":"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"}

package/dist/hierarchy/frame.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The steps every zoomable hierarchy chart (`treemap`, `icicle`, `sunburst`,
+ * `circlePack`, `tree`) takes on an update before drawing: lay out (both
+ * ends of a keyed transition, joined at `blend`), key, colour, resolve the
+ * drill-down and the zoom window, close a tooltip the view moved away from.
+ * Each step is cached on its inputs (see `shared.ts`), so a `progress` frame
+ * re-lays out nothing and a zoom scrub only moves the window.
+ *
+ * Internal to the family.
+ */
+import type { CompositeContext, SceneNode } from "@sophistry/core";
+import type { Point } from "@sophistry/core/geometry";
+import type { Theme } from "@sophistry/core/themes";
+import type { HierarchyNodeInfo } from "../math/hierarchy";
+import type { TooltipState } from "../tooltip";
+import type { ChartBreadcrumbsFrame } from "./breadcrumbs";
+import type { HierarchyDrill, HierarchyDrillProps, NodeInteractionProps } from "./drill";
+import type { HierarchyChartBaseProps, HierarchyEnds, HierarchyFocusSpec, HierarchyTransitionProps, HierarchyView, HierarchyZoom, Joined } from "./shared";
+/** The props the shared steps read. */
+export type ZoomableChartProps<T> = HierarchyChartBaseProps<T> & HierarchyTransitionProps<T> & HierarchyDrillProps<T> & {
+    focus?: HierarchyFocusSpec<T>;
+};
+/** One update's shared state of a hierarchy chart. @internal */
+export interface HierarchyChartFrame<T, N extends HierarchyNodeInfo<T>> {
+    ends: HierarchyEnds<N>;
+    /** The layout drawn: `data`'s, or both ends joined at `blend`. */
+    layout: readonly Joined<N>[];
+    /** Each node's identity (its path of names): the instance key of its mark. */
+    keys: readonly string[];
+    /** Each node's fill. */
+    fills: readonly string[];
+    drill: HierarchyDrill<T>;
+    zoom: HierarchyZoom;
+    /** The chart's tooltip: the enclosing chart's, else its own. */
+    tooltip: TooltipState;
+    /** Whether nodes take part in interaction (taps, tooltips, the item list). */
+    interactive: boolean;
+}
+/** How a chart turns its layout into the windows its zoom moves between. */
+export interface HierarchyViewOptions<N> {
+    /** The window showing the subtree of the node at `position`. */
+    viewOf: (layout: readonly Joined<N>[], position: number) => HierarchyView;
+    /** How two windows blend. @default linear */
+    blend?: (a: HierarchyView, b: HierarchyView, t: number) => HierarchyView;
+}
+/** A hierarchy chart's shared machinery. See {@link createHierarchyChart}. @internal */
+export interface HierarchyChart<T, N extends HierarchyNodeInfo<T>> {
+    /** Runs the shared steps for this update. */
+    frame(props: ZoomableChartProps<T>, theme: Theme, layoutOf: (data: T, end: "from" | "to") => N[], deps: readonly unknown[], view: HierarchyViewOptions<N>): HierarchyChartFrame<T, N>;
+    /**
+     * The batched node's interaction props for this update, named `name`;
+     * `positionOf` and `atOf` map a batched item to its node and tooltip anchor.
+     */
+    interaction(name: string, positionOf: (item: number) => number | undefined, atOf: (item: number) => Point | undefined): NodeInteractionProps;
+    /** Taps the node at layout `position`, as a tap on its item does (for a node's name). */
+    tapNode(position: number, at: Point): void;
+    /** The chart's own trail, or null for none. */
+    breadcrumbs(frame: Omit<ChartBreadcrumbsFrame<T>, "nodes" | "resolved" | "drill">): SceneNode | null;
+}
+/**
+ * A hierarchy chart's shared machinery: its layout cache, keys, fills,
+ * drill-down, zoom, tooltip and trail. Call once, in `setup`.
+ *
+ * @param fields - The numeric fields that place a node (for the keyed join).
+ * @internal
+ */
+export declare function createHierarchyChart<T, N extends HierarchyNodeInfo<T>, P extends ZoomableChartProps<T>>(ctx: CompositeContext<P>, fields: readonly (keyof N & string)[]): HierarchyChart<T, N>;
+//# sourceMappingURL=frame.d.ts.map

package/dist/hierarchy/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/hierarchy/frame.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,KAAK,EACX,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EAEpB,MAAM,SAAS,CAAC;AAGjB,OAAO,KAAK,EACX,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,MAAM,EACN,MAAM,UAAU,CAAC;AAUlB,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,uBAAuB,CAAC,CAAC,CAAC,GAC7D,wBAAwB,CAAC,CAAC,CAAC,GAC3B,mBAAmB,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AAE5D,gEAAgE;AAChE,MAAM,WAAW,mBAAmB,CAAC,CAAC,EAAE,CAAC,SAAS,iBAAiB,CAAC,CAAC,CAAC;IACrE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACvB,kEAAkE;IAClE,MAAM,EAAE,SAAS,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7B,8EAA8E;IAC9E,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,wBAAwB;IACxB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,gEAAgE;IAChE,OAAO,EAAE,YAAY,CAAC;IACtB,8EAA8E;IAC9E,WAAW,EAAE,OAAO,CAAC;CACrB;AAED,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACtC,gEAAgE;IAChE,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,aAAa,CAAC;IAC1E,6CAA6C;IAC7C,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,KAAK,aAAa,CAAC;CACzE;AAED,wFAAwF;AACxF,MAAM,WAAW,cAAc,CAAC,CAAC,EAAE,CAAC,SAAS,iBAAiB,CAAC,CAAC,CAAC;IAChE,6CAA6C;IAC7C,KAAK,CACJ,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC5B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,CAAC,EAAE,EAC9C,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC3B,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7B;;;OAGG;IACH,WAAW,CACV,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EAChD,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,GAAG,SAAS,GACvC,oBAAoB,CAAC;IACxB,yFAAyF;IACzF,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3C,+CAA+C;IAC/C,WAAW,CACV,KAAK,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC,GACnE,SAAS,GAAG,IAAI,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CACnC,CAAC,EACD,CAAC,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAC9B,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAE/B,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,EACxB,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GACnC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CA6EtB"}

package/dist/hierarchy/icicle.d.ts

@@ -0,0 +1,77 @@
+/**
+ * `icicle`: the partition layout as rectangles, one band per depth.
+ *
+ * Every band is one `rect` instance of one instances node, keyed by the
+ * node's path of names; per-node picking, tooltips and drilling go through
+ * `event.item`. The level-by-level reveal grows each rectangle from its
+ * parent side (geometry). Names are `label` nodes, one per
+ * rectangle whose name fits.
+ */
+import type { Point } from "@sophistry/core/geometry";
+import type { RequiredUnless } from "../data/channels";
+import type { HierarchyDrillProps } from "./drill";
+import type { HierarchyChartBaseProps, HierarchyFocusSpec, HierarchyTransitionProps } from "./shared";
+/** @category Charts */
+export interface IcicleBaseProps<T> extends HierarchyChartBaseProps<T>, HierarchyTransitionProps<T>, HierarchyDrillProps<T> {
+    /** Width of the whole chart. */
+    width: number;
+    /** Height of the whole chart. */
+    height: number;
+    /** Centre of the chart. Defaults to the origin. */
+    center?: Point;
+    /**
+     * `"horizontal"`: the root is a column at the left, depth increasing to the right.
+     * `"vertical"`: the root is a row at the top, depth increasing downward.
+     * @default "horizontal"
+     */
+    orientation?: "horizontal" | "vertical";
+    /**
+     * Draw the root's band; `false` gives its room to the other levels.
+     * @default true
+     */
+    root?: boolean;
+    /**
+     * Gap left around each rectangle.
+     * @default 0.01
+     */
+    inset?: number;
+    /**
+     * Zoom into a node: it spans the whole breadth, its descendants fill the depth after it, and
+     * the rest fades away. A path of names below the root (`["a"]`), a predicate, or `{ from, to, t
+     * }` for a scrubbable transition. Given, the chart is controlled: taps only call
+     * `onFocusChange`. Defaults to the root.
+     */
+    focus?: HierarchyFocusSpec<T>;
+}
+/**
+ * Props of {@link icicle}: `value` is required unless the tree's nodes are numbers.
+ *
+ * @category Charts
+ */
+export type IcicleProps<T> = IcicleBaseProps<T> & RequiredUnless<T, number, "value">;
+/**
+ * An icicle chart: the partition layout as rectangles, one band per depth, each node spanning
+ * exactly its children, sized by value. Lays itself out in a `width × height` box; reveals one
+ * depth at a time from the root. Supports drill-down `focus` and keyed transitions. The
+ * rectangles are one instances node (`event.item` picks a node). See {@link partitionLayout} for
+ * the layout alone.
+ *
+ * @example
+ * ```ts
+ * import { icicle } from "@sophistry/charts";
+ *
+ * const files = {
+ * 	name: "repo",
+ * 	children: [
+ * 		{ name: "src", children: [{ name: "index.ts", size: 12 }, { name: "chart.ts", size: 30 }] },
+ * 		{ name: "README.md", size: 4 },
+ * 	],
+ * };
+ * icicle.create({ data: files, value: "size", label: "name", width: 8, height: 4, orientation: "vertical" });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#hierarchies
+ * @category Charts
+ */
+export declare const icicle: import("@sophistry/core").Definition<IcicleBaseProps<any>, import("@sophistry/core/internal").CompositeNode<IcicleBaseProps<any>>, keyof IcicleBaseProps<any>>;
+//# sourceMappingURL=icicle.d.ts.map

package/dist/hierarchy/icicle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icicle.d.ts","sourceRoot":"","sources":["../../src/hierarchy/icicle.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAItD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAMnD,OAAO,KAAK,EACX,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,MAAM,UAAU,CAAC;AAclB,uBAAuB;AACvB,MAAM,WAAW,eAAe,CAAC,CAAC,CACjC,SAAQ,uBAAuB,CAAC,CAAC,CAAC,EACjC,wBAAwB,CAAC,CAAC,CAAC,EAC3B,mBAAmB,CAAC,CAAC,CAAC;IACvB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,GAC9C,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAgLpC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,MAAM,gKAiCjB,CAAC"}

package/dist/hierarchy/index.d.ts

@@ -0,0 +1,21 @@
+/** Family barrel: hierarchy. Owned by its family; re-exported from the package entry. */
+export type { BreadcrumbsProps } from "./breadcrumbs";
+export { breadcrumbs } from "./breadcrumbs";
+export type { CirclePackBaseProps, CirclePackProps } from "./circle-pack";
+export { circlePack } from "./circle-pack";
+export type { DrillDown, DrillDownOptions, DrillOptions, HierarchyBreadcrumbOptions, HierarchyDrillProps, } from "./drill";
+export { createDrillDown } from "./drill";
+export type { IcicleBaseProps, IcicleProps } from "./icicle";
+export { icicle } from "./icicle";
+export type { MosaicProps } from "./mosaic";
+export { mosaic } from "./mosaic";
+export type { SankeyBaseProps, SankeyProps } from "./sankey";
+export { sankey } from "./sankey";
+export type { HierarchyChartBaseProps, HierarchyFocus, HierarchyFocusSpec, HierarchyTransitionProps, HierarchyView, } from "./shared";
+export type { SunburstBaseProps, SunburstProps } from "./sunburst";
+export { sunburst } from "./sunburst";
+export type { TreeProps } from "./tree";
+export { tree } from "./tree";
+export type { TreemapBaseProps, TreemapProps } from "./treemap";
+export { treemap } from "./treemap";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hierarchy/index.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAEzF,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EACX,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,0BAA0B,EAC1B,mBAAmB,GACnB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EACX,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,GACb,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/hierarchy/labels.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Node names of the hierarchy, flow and mosaic charts: one `label` node per
+ * name drawn, keyed by its node (so a name moving through a transition
+ * keeps its node), and a text-width cache so fitting names on every frame
+ * of a reveal or zoom measures each string once. Internal to the family.
+ */
+import type { CompositeContext, LabelProps, SceneNode } from "@sophistry/core";
+import type { Theme } from "@sophistry/core/themes";
+/** One label of a keyed list: its key and the label's props. */
+export interface KeyedLabel {
+    key: unknown;
+    props: LabelProps;
+}
+/**
+ * Keyed `label` nodes for one list (`slot`): a node per key, created once
+ * and updated in place, disposed when its key leaves.
+ */
+export declare function labelList<P>(ctx: CompositeContext<P>, slot: string, labels: readonly KeyedLabel[]): SceneNode[];
+/**
+ * A text-width cache for one chart: `(text, fontSize, theme, weight?)` is
+ * `textWidth` at the theme's font, measured once per string and size.
+ * Call once, in `setup`.
+ */
+export declare function createLabelMeasure(): (text: string, fontSize: number, theme: Theme, fontWeight?: number) => number;
+//# sourceMappingURL=labels.d.ts.map

package/dist/hierarchy/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/hierarchy/labels.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAGpD,gEAAgE;AAChE,MAAM,WAAW,UAAU;IAC1B,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAC1B,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,EACxB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,UAAU,EAAE,GAC3B,SAAS,EAAE,CAQb;AAKD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,UAAU,CAAC,EAAE,MAAM,KACf,MAAM,CAiBV"}

package/dist/hierarchy/mosaic.d.ts

@@ -0,0 +1,131 @@
+/**
+ * `mosaic`: a Marimekko chart, columns as wide as their share of the whole,
+ * split into segments as tall as each row's share within the column.
+ *
+ * Every segment is one `rect` instance of one instances node, keyed by its
+ * (column, row) pair; per-segment picking and tooltips go through
+ * `event.item`. Columns grow from the bottom edge (geometry).
+ * Segment and column names are `label` nodes, one per name that fits.
+ */
+import type { ColorInput } from "@sophistry/core/color";
+import type { Point } from "@sophistry/core/geometry";
+import type { Channel, ColorChannel } from "../data/channels";
+import type { MosaicKey } from "../math/mosaic";
+import type { TooltipSpec } from "../tooltip";
+/**
+ * Props of {@link mosaic}.
+ *
+ * @category Charts
+ */
+export interface MosaicProps<T> {
+    /** Long-form table: one datum per (column, row, value); duplicate pairs sum. */
+    data: readonly T[];
+    /** The column category. Data with no category are skipped. */
+    x: Channel<T, MosaicKey>;
+    /** The segment (row) category. Data with no category are skipped. */
+    y: Channel<T, MosaicKey>;
+    /**
+     * The amount; negative and non-finite values count as 0. Omitted, every datum counts 1 (a
+     * contingency table of counts).
+     */
+    value?: Channel<T, number>;
+    /** Column order, left to right; unlisted categories follow. Defaults to first-seen order. */
+    columns?: readonly MosaicKey[];
+    /** Segment order, bottom to top; unlisted categories follow. Defaults to first-seen order. */
+    rows?: readonly MosaicKey[];
+    /** Width of the mosaic. */
+    width: number;
+    /** Height of the mosaic (column names hang below it). */
+    height: number;
+    /** Centre of the mosaic. Defaults to the origin. */
+    center?: Point;
+    /**
+     * Gap between columns, and between segments in a column.
+     * @default 0.04
+     */
+    padding?: number;
+    /**
+     * One colour for every segment, or `(d, i) => colour` called with the segment's first datum
+     * (returning nothing falls back to `colors`). Wins over `colors`.
+     */
+    color?: ColorChannel<T>;
+    /**
+     * Colours cycled across the row categories, so a row has one colour in every column. Defaults
+     * to the theme's categorical colours.
+     */
+    colors?: readonly ColorInput[];
+    /**
+     * Fill opacity of the segments, 0..1.
+     * @default 1
+     */
+    fillOpacity?: number;
+    /**
+     * Write each row's name inside its segment where it fits.
+     * @default true
+     */
+    labels?: boolean;
+    /**
+     * Write each column's name under it where it fits.
+     * @default true
+     */
+    columnLabels?: boolean;
+    /**
+     * Write each column's share of the total under its name.
+     * @default false
+     */
+    shares?: boolean;
+    /**
+     * Label font size.
+     * @default 0.2
+     */
+    labelFontSize?: number;
+    /**
+     * Reveal, 0..1: column names fade in first, then the columns grow left to right from the
+     * bottom, segment names fading in as they go.
+     * @default 1
+     * @see https://sophistry.dev/guides/chart-animation/#reveals
+     */
+    progress?: number;
+    /**
+     * Fraction of the columns' reveal spent staggering column after column, 0..0.95.
+     * @default 0.5
+     */
+    stagger?: number;
+    /**
+     * Hover tooltip on a segment: `true` for "column · row: value (pct% of column)", or `(d, i) =>
+     * string` called with its first datum.
+     */
+    tooltip?: TooltipSpec<T>;
+    /** Paint order; labels draw at `zIndex + 1`. */
+    zIndex?: number;
+    /**
+     * Set to `false` to hide the chart.
+     * @default true
+     */
+    visible?: boolean;
+}
+/**
+ * A mosaic (Marimekko) chart: columns whose widths are their share of the whole, split into
+ * segments whose heights are each row's share within the column, so every rectangle's area is
+ * its value. `data` is long-form, one datum per (column, row, value). Lays itself out in a
+ * `width × height` box; needs no `chart`. The segments are one instances node (`event.item`
+ * picks one). See {@link mosaicLayout} for the layout alone.
+ *
+ * @example
+ * ```ts
+ * import { mosaic } from "@sophistry/charts";
+ *
+ * const sales = [
+ * 	{ region: "north", product: "tea", units: 30 },
+ * 	{ region: "north", product: "coffee", units: 50 },
+ * 	{ region: "south", product: "tea", units: 45 },
+ * 	{ region: "south", product: "coffee", units: 15 },
+ * ];
+ * mosaic.create({ data: sales, x: "region", y: "product", value: "units", width: 8, height: 4, shares: true });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#gauges-bullets-waffles-mosaics-and-radial-bars
+ * @category Charts
+ */
+export declare const mosaic: import("@sophistry/core").Definition<MosaicProps<any>, import("@sophistry/core/internal").CompositeNode<MosaicProps<any>>, keyof MosaicProps<any>>;
+//# sourceMappingURL=mosaic.d.ts.map

package/dist/hierarchy/mosaic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mosaic.d.ts","sourceRoot":"","sources":["../../src/hierarchy/mosaic.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAKtD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,KAAK,EAEX,SAAS,EAGT,MAAM,gBAAgB,CAAC;AAMxB,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAoB5D;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC7B,gFAAgF;IAChF,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,8DAA8D;IAC9D,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACzB,qEAAqE;IACrE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3B,6FAA6F;IAC7F,OAAO,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC/B,8FAA8F;IAC9F,IAAI,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACzB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAmOD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,MAAM,oJAgHjB,CAAC"}

package/dist/hierarchy/own-tooltip.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The tooltip a standalone hierarchy, flow or mosaic chart shows through:
+ * the enclosing chart's, else its own. Internal to the family.
+ *
+ * Outside a chart the state is kept (handlers, accessible names, the item
+ * walked by the keys) but no panel is drawn yet: the overlay is the chart
+ * frame's (`frame/tooltip-overlay.ts`).
+ */
+import type { CompositeContext } from "@sophistry/core";
+import type { TooltipState } from "../tooltip";
+/** Call once, in `setup`; read the result in each `update`. */
+export declare function createOwnTooltip(): <P>(ctx: CompositeContext<P>) => TooltipState;
+//# sourceMappingURL=own-tooltip.d.ts.map

package/dist/hierarchy/own-tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-tooltip.d.ts","sourceRoot":"","sources":["../../src/hierarchy/own-tooltip.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,+DAA+D;AAC/D,wBAAgB,gBAAgB,IAAI,CAAC,CAAC,EACrC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,KACpB,YAAY,CAQhB"}

package/dist/hierarchy/props.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The props descriptor the zoomable hierarchy charts share: every base,
+ * transition and drill prop reruns `update`, plus each chart's own. Internal
+ * to the family.
+ */
+import type { PropsDescriptor } from "@sophistry/core";
+/**
+ * A hierarchy chart's props descriptor: the shared keys and `own`, each
+ * rerunning `update` when written (`progress` defaults to 1).
+ *
+ * @internal
+ */
+export declare function hierarchyPropsDescriptor<P extends object>(own: readonly (keyof P & string)[]): PropsDescriptor<P>;
+//# sourceMappingURL=props.d.ts.map

package/dist/hierarchy/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../src/hierarchy/props.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKvD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,EACxD,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GAChC,eAAe,CAAC,CAAC,CAAC,CAMpB"}