@sophistry/charts 0.0.0-stage → 0.0.1

package/dist/guides/size-legend.d.ts

@@ -0,0 +1,234 @@
+/**
+ * `sizeLegend`: a key to a size encoding, a hollow reference circle per
+ * value; `sizeKeyStack`: a frame's stack of them, one per size scale; and
+ * the measurements a frame lays them out with.
+ *
+ * A value's nodes are kept for as long as either end of a transition shows
+ * the value, and hidden with `visible: false` when they are not shown.
+ * Each end is measured once per change of its scale, values, title or font,
+ * not as `progress` or a transition's stages move.
+ */
+import type { Point } from "@sophistry/core/geometry";
+import type { SizeScale } from "../frame/types";
+/**
+ * A size key's keyed transition: the far end's scale and values, and how far each stage has
+ * got. `chart` passes one while a keyed transition runs.
+ *
+ * @see https://sophistry.dev/guides/chart-animation/#data-transitions
+ * @category Charts
+ */
+export interface SizeLegendTransition {
+    /** The scale at the end. */
+    to: SizeScale;
+    /** The values the end shows. Defaults to `values`, else the end's own round values. */
+    values?: readonly number[];
+    /** Progress of the exit stage, 0..1. */
+    exit: number;
+    /** Progress of the update stage, 0..1. */
+    update: number;
+    /** Progress of the enter stage, 0..1. */
+    enter: number;
+}
+/**
+ * Props for {@link sizeLegend}.
+ *
+ * @category Charts
+ */
+export interface SizeLegendProps {
+    /** The size scale the key explains. */
+    scale: SizeScale;
+    /**
+     * The values to draw circles for, in order. Defaults to up to three round values of the scale.
+     */
+    values?: readonly number[];
+    /** How a value is written. Defaults to the axes' formatting. */
+    format?: (value: number) => string;
+    /** The key's top-left corner, in scene units. */
+    at: Point;
+    /**
+     * `"column"`: one circle per row. `"row"`: side by side, wrapping at `maxWidth`.
+     * @default "column"
+     */
+    direction?: "column" | "row";
+    /** With `direction: "row"`: wrap before an entry that would run past this width. */
+    maxWidth?: number;
+    /** A title line above the circles. */
+    title?: string;
+    /**
+     * Font size of the labels.
+     * @default 0.28
+     */
+    fontSize?: number;
+    /**
+     * Reveal, 0..1: the circles fade in one after another.
+     * @default 1
+     */
+    progress?: number;
+    /** A keyed data transition in progress; see {@link SizeLegendTransition}. */
+    transition?: SizeLegendTransition;
+    /** Paint order; higher draws later. */
+    zIndex?: number;
+    /** Set to `false` to hide the key. */
+    visible?: boolean;
+}
+/** Measurement options shared by {@link sizeLegend} and the frames that place one. */
+export interface SizeLegendMetrics {
+    direction?: "column" | "row";
+    maxWidth?: number;
+    title?: string;
+    fontSize?: number;
+    format?: (value: number) => string;
+    fontFamily: string;
+}
+/**
+ * A key to a size encoding: a hollow reference circle per value, with the value beside it,
+ * drawn through the same square-root scale as the marks. `chart` draws one automatically for
+ * layers sized by value (`scatter`'s `size`); use this directly for charts without a frame.
+ *
+ * @example
+ * ```ts
+ * import { sizeLegend } from "@sophistry/charts";
+ *
+ * sizeLegend.create({
+ * 	at: { x: 3, y: 2 },
+ * 	scale: { maxValue: 100, range: [0, 0.5] },
+ * 	values: [25, 100],
+ * 	title: "Population",
+ * });
+ * ```
+ *
+ * @see https://sophistry.dev/guides/charts/#series-and-legends
+ * @category Charts
+ */
+export declare const sizeLegend: import("@sophistry/core").Definition<SizeLegendProps, import("@sophistry/core/internal").CompositeNode<SizeLegendProps>, keyof SizeLegendProps>;
+/**
+ * One key of a frame's stack of size keys: the scale its sized layers draw on at each end of a
+ * keyed transition, and the first such layer's channel name.
+ *
+ * @internal
+ */
+export interface SizeKey {
+    maxValue: number;
+    to?: number;
+    range: readonly [number, number];
+    label?: string;
+}
+/**
+ * A key's laid-out size, and how far it is there at all (0 at an end without one).
+ *
+ * @internal
+ */
+export interface SizeKeyExtent {
+    width: number;
+    height: number;
+    presence: number;
+}
+/**
+ * A stack of size keys at each end of a keyed transition: the stack's size and each key's
+ * place in it.
+ *
+ * @internal
+ */
+export interface SizeKeysEnds {
+    from: SizeKeyExtent;
+    to: SizeKeyExtent | undefined;
+    /** Each key's top-left corner from the stack's: `x` to the right, `y` down. */
+    offsets: {
+        from: readonly Point[];
+        to: readonly Point[] | undefined;
+    };
+}
+/**
+ * Each key of a stack measured at each end, before the stack is flowed ({@link flowSizeKeys}).
+ *
+ * @internal
+ */
+export interface SizeKeyMeasures {
+    from: readonly SizeKeyExtent[];
+    to: readonly SizeKeyExtent[] | undefined;
+}
+/**
+ * How a stack of keys flows into columns: a key that would run past `maxHeight` starts a new
+ * column `gap` to the right.
+ *
+ * @internal
+ */
+interface SizeKeyColumns {
+    maxHeight: number;
+    gap: number;
+}
+/**
+ * Measures each key of a stack at each end (presence 0 where an end sizes nothing). Undefined
+ * without keys. Separate from {@link flowSizeKeys} so a re-flow doesn't re-measure text.
+ *
+ * @internal
+ */
+export declare function measureSizeKeyExtents(keys: readonly SizeKey[], options: Omit<SizeLegendMetrics, "title"> & {
+    title?: string;
+    values?: readonly number[];
+}): SizeKeyMeasures | undefined;
+/**
+ * Flows a stack's measured keys at each end: one under another `gap` apart, starting a new
+ * column when one would run past `columns.maxHeight`. A key absent at an end takes no room.
+ *
+ * @internal
+ */
+export declare function flowSizeKeys(measures: SizeKeyMeasures | undefined, gap: number, columns?: SizeKeyColumns): SizeKeysEnds | undefined;
+/**
+ * Measures a stack of size keys and flows it ({@link measureSizeKeyExtents},
+ * {@link flowSizeKeys}). Undefined without keys.
+ *
+ * @internal
+ */
+export declare function measureSizeKeys(keys: readonly SizeKey[], options: Omit<SizeLegendMetrics, "title"> & {
+    title?: string;
+    values?: readonly number[];
+}, gap: number, columns?: SizeKeyColumns): SizeKeysEnds | undefined;
+/** Two stacks' measured keys with the same sizes, end by end. */
+export declare function sameSizeKeyMeasures(a: SizeKeyMeasures | undefined, b: SizeKeyMeasures | undefined): boolean;
+/** Two measured stacks of size keys with the same sizes and places. */
+export declare function sameSizeKeysEnds(a: SizeKeysEnds | undefined, b: SizeKeysEnds | undefined): boolean;
+/**
+ * Each key's place in the stack now: its own end's, or while a key rescales, both ends'
+ * blended by the update progress `u`.
+ *
+ * @internal
+ */
+export declare function sizeKeyOffsets(ends: SizeKeysEnds | undefined, u: number): readonly Point[];
+/** Two lists of key places, compared by value. */
+export declare function sameOffsets(a: readonly Point[] | undefined, b: readonly Point[] | undefined): boolean;
+/** The stages a stack of keys transitions on: exit, update and enter progress, as `SizeLegendTransition` takes them. */
+export type SizeKeyStages = Pick<SizeLegendTransition, "exit" | "update" | "enter">;
+/**
+ * Props for {@link sizeKeyStack}.
+ *
+ * @internal
+ */
+export interface SizeKeyStackProps {
+    keys: readonly SizeKey[];
+    /** Each key's top-left corner from `at`: `x` to the right, `y` down. */
+    offsets: readonly Point[];
+    /** The stack's top-left corner. */
+    at: Point;
+    /** A title for the first key (see `sizeKeyTitle`). */
+    title?: string;
+    values?: readonly number[];
+    format?: (value: number) => string;
+    direction: "column" | "row";
+    maxWidth?: number;
+    fontSize?: number;
+    progress?: number;
+    /** The keyed transition's stages, while one runs. */
+    stages?: SizeKeyStages;
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * A frame's size keys, one {@link sizeLegend} per key at its place in the stack, each blending to
+ * its far end's scale while `stages` is given. Keys are kept by position in the stack.
+ *
+ * @internal
+ */
+export declare const sizeKeyStack: import("@sophistry/core").Definition<SizeKeyStackProps, import("@sophistry/core/internal").CompositeNode<SizeKeyStackProps>, keyof SizeKeyStackProps>;
+export {};
+//# sourceMappingURL=size-legend.d.ts.map

package/dist/guides/size-legend.d.ts.map

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

package/dist/hierarchy/breadcrumbs.d.ts

@@ -0,0 +1,134 @@
+/**
+ * `breadcrumbs`: a trail of names for a drill-down, and the trail a zoomable
+ * hierarchy chart draws for its own `breadcrumbs` prop.
+ *
+ * A trail is a handful of words, each its own tap target and tab stop, so
+ * every crumb, separator and the back control stay `label` nodes (keyed by
+ * the crumb's path, so a crumb cross-fading through a zoom keeps its node).
+ */
+import type { SceneNode } from "@sophistry/core";
+import type { Point } from "@sophistry/core/geometry";
+import type { HierarchyPathSpec } from "../math/breadcrumbs";
+import type { HierarchyNodeInfo } from "../math/hierarchy";
+import type { HierarchyBreadcrumbOptions, HierarchyDrill } from "./drill";
+import type { ResolvedFocus } from "./shared";
+/** @category Charts */
+export interface BreadcrumbsProps {
+    /**
+     * The trail: names below the root (`[]` is the root alone), or a `{ from, to, t }` transition
+     * such as {@link createDrillDown}'s `focus`, so the crumbs follow a zoom.
+     */
+    path: HierarchyPathSpec;
+    /**
+     * The root crumb's text.
+     * @default "All"
+     */
+    root?: string;
+    /**
+     * Anchor x.
+     * @default 0
+     */
+    x?: number;
+    /**
+     * Anchor y (the text's vertical middle).
+     * @default 0
+     */
+    y?: number;
+    /**
+     * Where the anchor is on the trail.
+     * @default "left"
+     */
+    align?: "left" | "center" | "right";
+    /**
+     * Font size.
+     * @default 0.24
+     */
+    fontSize?: number;
+    /**
+     * Drawn between crumbs.
+     * @default "›"
+     */
+    separator?: string;
+    /**
+     * The widest the trail may be: a deeper path collapses its middle into one `…` crumb (tap it to
+     * climb), keeping the root and as many last crumbs as fit. Omitted, the trail never collapses.
+     */
+    maxWidth?: number;
+    /**
+     * The collapsed crumbs' text.
+     * @default "…"
+     */
+    ellipsis?: string;
+    /**
+     * A back control before the root crumb: `true` for `"←"`, or its text. With `onSelect`, tapping
+     * it asks for the parent of the node in focus; it fades out at the root. Defaults to none.
+     */
+    back?: boolean | string;
+    /** The last crumb's colour (the node in focus). Defaults to the theme foreground. */
+    color?: string;
+    /** The other crumbs' colour, marking them as tappable. Defaults to the theme accent. */
+    linkColor?: string;
+    /**
+     * Called with a crumb's path when an earlier crumb is tapped (or Enter is pressed on it).
+     * Without it the crumbs are not interactive.
+     */
+    onSelect?: (path: string[]) => void;
+    /**
+     * Reveal, 0..1: the trail fades in.
+     * @default 1
+     */
+    progress?: number;
+    /** Paint order; higher draws later. */
+    zIndex?: number;
+    /**
+     * Set to `false` to hide the trail.
+     * @default true
+     */
+    visible?: boolean;
+}
+/**
+ * A breadcrumb trail for a drill-down: the root's name, then each name on the path to the node
+ * in focus. Tap (or Enter on) an earlier crumb to go back up; Escape asks for the parent. Give
+ * it the same `path` as a hierarchy chart's `focus` and it scrubs with the zoom. The hierarchy
+ * charts draw one themselves with their `breadcrumbs` prop.
+ *
+ * @example
+ * ```ts
+ * import { createScene } from "@sophistry/core";
+ * import { breadcrumbs, createDrillDown } from "@sophistry/charts";
+ *
+ * const scene = createScene({ host: document.querySelector("#figure")!, units: 10 });
+ * const zoom = createDrillDown({ clock: scene.clock });
+ * breadcrumbs.create({ path: zoom.focus, root: "repo", x: -4, y: 2.4, onSelect: (path) => void zoom.zoomTo(path) });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#hierarchies
+ * @category Charts
+ */
+export declare const breadcrumbs: import("@sophistry/core").Definition<BreadcrumbsProps, import("@sophistry/core/internal").CompositeNode<BreadcrumbsProps>, keyof BreadcrumbsProps>;
+/** Where a chart's trail goes and how wide it may grow. @internal */
+export interface ChartBreadcrumbsFrame<T> {
+    options: boolean | HierarchyBreadcrumbOptions | undefined;
+    nodes: readonly HierarchyNodeInfo<T>[];
+    resolved: ResolvedFocus;
+    drill: HierarchyDrill<T>;
+    /** The chart's top-left corner, in scene units. */
+    corner: Point;
+    /** The chart's width: how wide the trail may grow by default. */
+    width: number;
+    /** The chart's label font size. */
+    labelFontSize: number;
+    progress?: number;
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * The trail a zoomable hierarchy chart draws for its `breadcrumbs` prop: its
+ * focus as names, just above the chart's top-left unless placed, collapsing
+ * past the chart's width. Call once, in `setup`; the result hands back the
+ * trail's node (made the first time it is asked for), or null for none.
+ *
+ * @internal
+ */
+export declare function createChartBreadcrumbs<T>(): (frame: ChartBreadcrumbsFrame<T>) => SceneNode | null;
+//# sourceMappingURL=breadcrumbs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../../src/hierarchy/breadcrumbs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAIX,SAAS,EACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAU,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAY9C,uBAAuB;AACvB,MAAM,WAAW,gBAAgB;IAChC;;;OAGG;IACH,IAAI,EAAE,iBAAiB,CAAC;IACxB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AA6MD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW,oJAyEtB,CAAC;AAKH,qEAAqE;AACrE,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACvC,OAAO,EAAE,OAAO,GAAG,0BAA0B,GAAG,SAAS,CAAC;IAC1D,KAAK,EAAE,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACzB,mDAAmD;IACnD,MAAM,EAAE,KAAK,CAAC;IACd,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,KAAK,CAC5C,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAC3B,SAAS,GAAG,IAAI,CA6CpB"}

package/dist/hierarchy/circle-pack.d.ts

@@ -0,0 +1,73 @@
+/**
+ * `circlePack`: every leaf a disc, packed inside its parent's circle.
+ *
+ * Every circle is one `circle` instance of one instances node, keyed by the
+ * node's path of names, with its own fill, fill opacity and stroke (groups
+ * are tinted and outlined, leaves filled); per-node picking, tooltips and
+ * drilling go through `event.item`. Circles grow from their centres
+ * (radius). While zoomed, the node and the leaf names sit in
+ * a `group` clipped to the root's disc. Names are `label` nodes, one per
+ * leaf 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 CirclePackBaseProps<T> extends HierarchyChartBaseProps<T>, HierarchyTransitionProps<T>, HierarchyDrillProps<T> {
+    /** Centre of the chart. Defaults to the origin. */
+    center?: Point;
+    /**
+     * Radius of the root circle.
+     * @default 1
+     */
+    radius?: number;
+    /**
+     * Gap between sibling circles and their parent's rim.
+     * @default 0.03
+     */
+    padding?: number;
+    /**
+     * Draw the root's circle.
+     * @default true
+     */
+    root?: boolean;
+    /**
+     * Zoom into a node: its circle grows to fill the root's while the rest fades away along a
+     * smooth zoom path. 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 circlePack}: `value` is required unless the tree's nodes are numbers.
+ *
+ * @category Charts
+ */
+export type CirclePackProps<T> = CirclePackBaseProps<T> & RequiredUnless<T, number, "value">;
+/**
+ * Circle packing: every leaf a disc with area proportional to its value, packed inside its
+ * parent's circle. Draws in scene units; circles grow from their centres, parents first.
+ * Supports drill-down `focus` and keyed transitions. The circles are one instances node
+ * (`event.item` picks a circle). See {@link packLayout} for the layout alone.
+ *
+ * @example
+ * ```ts
+ * import { circlePack } 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 },
+ * 	],
+ * };
+ * circlePack.create({ data: files, value: "size", label: "name", radius: 2, drill: true });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#hierarchies
+ * @category Charts
+ */
+export declare const circlePack: import("@sophistry/core").Definition<CirclePackBaseProps<any>, import("@sophistry/core/internal").CompositeNode<CirclePackBaseProps<any>>, keyof CirclePackBaseProps<any>>;
+//# sourceMappingURL=circle-pack.d.ts.map

package/dist/hierarchy/circle-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circle-pack.d.ts","sourceRoot":"","sources":["../../src/hierarchy/circle-pack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAKtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAMnD,OAAO,KAAK,EACX,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,MAAM,UAAU,CAAC;AAmBlB,uBAAuB;AACvB,MAAM,WAAW,mBAAmB,CAAC,CAAC,CACrC,SAAQ,uBAAuB,CAAC,CAAC,CAAC,EACjC,wBAAwB,CAAC,CAAC,CAAC,EAC3B,mBAAmB,CAAC,CAAC,CAAC;IACvB,mDAAmD;IACnD,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,mBAAmB,CAAC,CAAC,CAAC,GACtD,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AA+KpC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,UAAU,4KAmCrB,CAAC"}