@pibbl/core 0.0.1

package/dist/features/viz/lib/linear-scale.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/linear-scale.ts"],
+  "sourcesContent": ["import type {\n  LinearDomain,\n  ResolvedLinearScale,\n  ResolvedScale,\n  ScaleRange,\n} from \"./types.js\";\nfunction finite(value: number, field: string): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value))\n    throw new RangeError(`Scale ${field} must be finite.`);\n  return value;\n}\nfunction pair(\n  value: readonly number[],\n  field: string,\n): readonly [number, number] {\n  if (!Array.isArray(value) || value.length !== 2)\n    throw new RangeError(`Scale ${field} requires two finite endpoints.`);\n  return Object.freeze([finite(value[0], field), finite(value[1], field)]);\n}\nexport function resolveLinearScale(\n  domainInput: LinearDomain,\n  rangeInput: ScaleRange,\n  reverse: boolean,\n  width: number,\n  height: number,\n): ResolvedLinearScale {\n  finite(width, \"frame.width\");\n  finite(height, \"frame.height\");\n  if (width < 0 || height < 0)\n    throw new RangeError(\"Scale allocation must be nonnegative.\");\n  if (typeof reverse !== \"boolean\")\n    throw new TypeError(\"Scale reverse must be boolean.\");\n  const domain = pair(domainInput, \"domain\");\n  if (domain[0] === domain[1])\n    throw new RangeError(\"Scale domain endpoints must differ.\");\n  const original = pair(\n    rangeInput === \"width\"\n      ? [0, width]\n      : rangeInput === \"height\"\n        ? [0, height]\n        : (rangeInput as readonly number[]),\n    \"range\",\n  );\n  const range = reverse ? pair([original[1], original[0]], \"range\") : original;\n  const domainSpan = finite(domain[1] - domain[0], \"domain span\");\n  const rangeSpan = finite(range[1] - range[0], \"range span\");\n  return Object.freeze({\n    type: \"linear\",\n    domain,\n    range,\n    frame: Object.freeze({ x: 0, y: 0, width, height }),\n    map(value: number) {\n      return finite(\n        range[0] +\n          ((finite(value, \"map input\") - domain[0]) / domainSpan) * rangeSpan,\n        \"mapped output\",\n      );\n    },\n    invert(pixel: number) {\n      if (rangeSpan === 0)\n        throw new RangeError(\n          \"Scale cannot invert a collapsed range; supply a nonzero extent.\",\n        );\n      return finite(\n        domain[0] +\n          ((finite(pixel, \"invert input\") - range[0]) / rangeSpan) * domainSpan,\n        \"inverted output\",\n      );\n    },\n    ticks(count = 5) {\n      if (!Number.isInteger(count) || count < 2 || count > 100)\n        throw new RangeError(\n          \"Scale ticks count must be an integer from 2 to 100.\",\n        );\n      return Object.freeze(\n        Array.from({ length: count }, (_, i) =>\n          i === count - 1\n            ? domain[1]\n            : finite(domain[0] + (domainSpan * i) / (count - 1), \"tick\"),\n        ),\n      );\n    },\n  });\n}\nexport function equalScale(a: ResolvedScale, b: ResolvedScale): boolean {\n  return (\n    a.type === b.type &&\n    a.domain.length === b.domain.length &&\n    a.domain.every((value, index) => Object.is(value, b.domain[index])) &&\n    (a.type !== \"band\" ||\n      (b.type === \"band\" &&\n        a.bandwidth === b.bandwidth &&\n        a.step === b.step)) &&\n    Object.is(a.range[0], b.range[0]) &&\n    Object.is(a.range[1], b.range[1]) &&\n    Object.is(a.frame.width, b.frame.width) &&\n    Object.is(a.frame.height, b.frame.height)\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/features/viz/lib/nearest.d.ts

@@ -0,0 +1,82 @@
+import type { ResolvedLinearScale } from "./types.js";
+import type { PointAccessor } from "./point-types.js";
+/**
+ * Coordinate accessors, resolved scales, and candidate filtering for a nearest-point search.
+ *
+ * @see {@link PointAccessor}
+ * @see {@link ResolvedLinearScale}
+ * @see {@link nearestPoint}
+ */
+export interface NearestPointOptions<D> {
+    /** Property key or callback extracting the horizontal domain coordinate. See {@link PointAccessor}. */
+    readonly x: PointAccessor<D>;
+    /** Property key or callback extracting the vertical domain coordinate. See {@link PointAccessor}. */
+    readonly y: PointAccessor<D>;
+    /** The scale used to map horizontal data coordinates. See {@link ResolvedLinearScale}. */
+    readonly xScale: ResolvedLinearScale;
+    /** The scale used to map vertical data coordinates. See {@link ResolvedLinearScale}. */
+    readonly yScale: ResolvedLinearScale;
+    /**
+     * Returns whether a datum contributes drawable or queryable coordinates. See
+     * {@link NearestPointOptions}.
+     * @param datum - Datum to test.
+     * @param index - Zero-based index in the source data.
+     * @param data - Complete source data array.
+     * @returns Whether this datum should participate in the series or query.
+     */
+    readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;
+    /** Maximum distance accepted by the query. See {@link NearestPointOptions}. */
+    readonly maxDistance?: number;
+}
+/**
+ * The selected datum, source index, mapped coordinates, and distance from the query point.
+ *
+ * @see {@link nearestPoint}
+ */
+export interface NearestPoint<D> {
+    /** The original data item selected by this result. See {@link NearestPoint}. */
+    readonly datum: D;
+    /** Index of the selected datum in its source data. See {@link NearestPoint}. */
+    readonly index: number;
+    /**
+     * Horizontal coordinate or displacement in the containing coordinate system. See
+     * {@link NearestPoint}.
+     */
+    readonly x: number;
+    /**
+     * Vertical coordinate or displacement in the containing coordinate system. See
+     * {@link NearestPoint}.
+     */
+    readonly y: number;
+    /** Distance measured in this query or guide's coordinate system. See {@link NearestPoint}. */
+    readonly distance: number;
+}
+/**
+ * Finds the domain value nearest to a logical range coordinate; returns undefined for no
+ * candidate.
+ *
+ * @param values - Candidate domain values.
+ * @param rangeValue - Pointer coordinate in the scale's range.
+ * @param scale - Scale mapping candidates into range coordinates. See {@link ResolvedLinearScale}.
+ * @returns The nearest domain value, or undefined when no candidate can be selected.
+ *
+ * @see {@link ResolvedLinearScale}
+ */
+export declare function nearestDomainValue(values: readonly number[], rangeValue: number, scale: ResolvedLinearScale): number | undefined;
+/**
+ * Finds the nearest defined datum in scaled coordinates, subject to an optional maximum distance.
+ *
+ * @param data - Candidate data records.
+ * @param point - Query point in plotted range coordinates.
+ * @param options - Accessors, scales, eligibility, and distance settings. See
+ * {@link NearestPointOptions} .
+ * @returns The nearest matching point, or undefined when no candidate qualifies. See
+ * {@link NearestPoint} .
+ *
+ * @see {@link NearestPointOptions}
+ * @see {@link NearestPoint}
+ */
+export declare function nearestPoint<D>(data: readonly D[], point: Readonly<{
+    x: number;
+    y: number;
+}>, options: NearestPointOptions<D>): NearestPoint<D> | undefined;

package/dist/features/viz/lib/nearest.js

@@ -0,0 +1,51 @@
+import { finiteCoordinate, pointAccessor, pointData } from "./point-data.js";
+function finite(value, name) {
+  if (!finiteCoordinate(value)) throw new RangeError(`${name} must be finite.`);
+}
+function nearestDomainValue(values, rangeValue, scale) {
+  pointData(values, "nearestDomainValue");
+  finite(rangeValue, "nearestDomainValue rangeValue");
+  let best, distance = Infinity;
+  for (const value of values) {
+    if (!finiteCoordinate(value)) continue;
+    const next = Math.abs(scale.map(value) - rangeValue);
+    finite(next, "nearestDomainValue distance");
+    if (next < distance) {
+      best = value;
+      distance = next;
+    }
+  }
+  return best;
+}
+function nearestPoint(data, point, options) {
+  pointData(data, "nearestPoint");
+  finite(point.x, "nearestPoint x");
+  finite(point.y, "nearestPoint y");
+  const max = options.maxDistance;
+  if (max !== void 0) {
+    finite(max, "nearestPoint maxDistance");
+    if (max < 0)
+      throw new RangeError("nearestPoint maxDistance must be nonnegative.");
+  }
+  const x = pointAccessor(options.x), y = pointAccessor(options.y);
+  let best, distance = Infinity;
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    if (options.defined && !options.defined(datum, i, data)) continue;
+    const xv = x(datum, i, data), yv = y(datum, i, data);
+    if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) continue;
+    const px = options.xScale.map(xv), py = options.yScale.map(yv);
+    const next = Math.hypot(px - point.x, py - point.y);
+    finite(next, "nearestPoint distance");
+    if (next < distance && (max === void 0 || next <= max)) {
+      distance = next;
+      best = { datum, index: i, x: px, y: py, distance: next };
+    }
+  }
+  return best;
+}
+export {
+  nearestDomainValue,
+  nearestPoint
+};
+//# sourceMappingURL=nearest.js.map

package/dist/features/viz/lib/nearest.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/nearest.ts"],
+  "sourcesContent": ["import type { ResolvedLinearScale } from \"./types.js\";\nimport type { PointAccessor } from \"./point-types.js\";\nimport { finiteCoordinate, pointAccessor, pointData } from \"./point-data.js\";\n/**\n * Coordinate accessors, resolved scales, and candidate filtering for a nearest-point search.\n *\n * @see {@link PointAccessor}\n * @see {@link ResolvedLinearScale}\n * @see {@link nearestPoint}\n */\nexport interface NearestPointOptions<D> {\n  /** Property key or callback extracting the horizontal domain coordinate. See {@link PointAccessor}. */\n  readonly x: PointAccessor<D>;\n  /** Property key or callback extracting the vertical domain coordinate. See {@link PointAccessor}. */\n  readonly y: PointAccessor<D>;\n  /** The scale used to map horizontal data coordinates. See {@link ResolvedLinearScale}. */\n  readonly xScale: ResolvedLinearScale;\n  /** The scale used to map vertical data coordinates. See {@link ResolvedLinearScale}. */\n  readonly yScale: ResolvedLinearScale;\n  /**\n   * Returns whether a datum contributes drawable or queryable coordinates. See\n   * {@link NearestPointOptions}.\n   * @param datum - Datum to test.\n   * @param index - Zero-based index in the source data.\n   * @param data - Complete source data array.\n   * @returns Whether this datum should participate in the series or query.\n   */\n  readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;\n  /** Maximum distance accepted by the query. See {@link NearestPointOptions}. */\n  readonly maxDistance?: number;\n}\n/**\n * The selected datum, source index, mapped coordinates, and distance from the query point.\n *\n * @see {@link nearestPoint}\n */\nexport interface NearestPoint<D> {\n  /** The original data item selected by this result. See {@link NearestPoint}. */\n  readonly datum: D;\n  /** Index of the selected datum in its source data. See {@link NearestPoint}. */\n  readonly index: number;\n  /**\n   * Horizontal coordinate or displacement in the containing coordinate system. See\n   * {@link NearestPoint}.\n   */\n  readonly x: number;\n  /**\n   * Vertical coordinate or displacement in the containing coordinate system. See\n   * {@link NearestPoint}.\n   */\n  readonly y: number;\n  /** Distance measured in this query or guide's coordinate system. See {@link NearestPoint}. */\n  readonly distance: number;\n}\nfunction finite(value: unknown, name: string): asserts value is number {\n  if (!finiteCoordinate(value)) throw new RangeError(`${name} must be finite.`);\n}\n/**\n * Finds the domain value nearest to a logical range coordinate; returns undefined for no\n * candidate.\n *\n * @param values - Candidate domain values.\n * @param rangeValue - Pointer coordinate in the scale's range.\n * @param scale - Scale mapping candidates into range coordinates. See {@link ResolvedLinearScale}.\n * @returns The nearest domain value, or undefined when no candidate can be selected.\n *\n * @see {@link ResolvedLinearScale}\n */\nexport function nearestDomainValue(\n  values: readonly number[],\n  rangeValue: number,\n  scale: ResolvedLinearScale,\n): number | undefined {\n  pointData(values, \"nearestDomainValue\");\n  finite(rangeValue, \"nearestDomainValue rangeValue\");\n  let best: number | undefined,\n    distance = Infinity;\n  for (const value of values) {\n    if (!finiteCoordinate(value)) continue;\n    const next = Math.abs(scale.map(value) - rangeValue);\n    finite(next, \"nearestDomainValue distance\");\n    if (next < distance) {\n      best = value;\n      distance = next;\n    }\n  }\n  return best;\n}\n/**\n * Finds the nearest defined datum in scaled coordinates, subject to an optional maximum distance.\n *\n * @param data - Candidate data records.\n * @param point - Query point in plotted range coordinates.\n * @param options - Accessors, scales, eligibility, and distance settings. See\n * {@link NearestPointOptions} .\n * @returns The nearest matching point, or undefined when no candidate qualifies. See\n * {@link NearestPoint} .\n *\n * @see {@link NearestPointOptions}\n * @see {@link NearestPoint}\n */\nexport function nearestPoint<D>(\n  data: readonly D[],\n  point: Readonly<{ x: number; y: number }>,\n  options: NearestPointOptions<D>,\n): NearestPoint<D> | undefined {\n  pointData(data, \"nearestPoint\");\n  finite(point.x, \"nearestPoint x\");\n  finite(point.y, \"nearestPoint y\");\n  const max = options.maxDistance;\n  if (max !== undefined) {\n    finite(max, \"nearestPoint maxDistance\");\n    if (max < 0)\n      throw new RangeError(\"nearestPoint maxDistance must be nonnegative.\");\n  }\n  const x = pointAccessor(options.x),\n    y = pointAccessor(options.y);\n  let best: NearestPoint<D> | undefined,\n    distance = Infinity;\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (options.defined && !options.defined(datum, i, data)) continue;\n    const xv = x(datum, i, data),\n      yv = y(datum, i, data);\n    if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) continue;\n    const px = options.xScale.map(xv),\n      py = options.yScale.map(yv);\n    const next = Math.hypot(px - point.x, py - point.y);\n    finite(next, \"nearestPoint distance\");\n    if (next < distance && (max === undefined || next <= max)) {\n      distance = next;\n      best = { datum, index: i, x: px, y: py, distance: next };\n    }\n  }\n  return best;\n}\n"],
+  "mappings": "AAEA,SAAS,kBAAkB,eAAe,iBAAiB;AAoD3D,SAAS,OAAO,OAAgB,MAAuC;AACrE,MAAI,CAAC,iBAAiB,KAAK,EAAG,OAAM,IAAI,WAAW,GAAG,IAAI,kBAAkB;AAC9E;AAYO,SAAS,mBACd,QACA,YACA,OACoB;AACpB,YAAU,QAAQ,oBAAoB;AACtC,SAAO,YAAY,+BAA+B;AAClD,MAAI,MACF,WAAW;AACb,aAAW,SAAS,QAAQ;AAC1B,QAAI,CAAC,iBAAiB,KAAK,EAAG;AAC9B,UAAM,OAAO,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,UAAU;AACnD,WAAO,MAAM,6BAA6B;AAC1C,QAAI,OAAO,UAAU;AACnB,aAAO;AACP,iBAAW;AAAA,IACb;AAAA,EACF;AACA,SAAO;AACT;AAcO,SAAS,aACd,MACA,OACA,SAC6B;AAC7B,YAAU,MAAM,cAAc;AAC9B,SAAO,MAAM,GAAG,gBAAgB;AAChC,SAAO,MAAM,GAAG,gBAAgB;AAChC,QAAM,MAAM,QAAQ;AACpB,MAAI,QAAQ,QAAW;AACrB,WAAO,KAAK,0BAA0B;AACtC,QAAI,MAAM;AACR,YAAM,IAAI,WAAW,+CAA+C;AAAA,EACxE;AACA,QAAM,IAAI,cAAc,QAAQ,CAAC,GAC/B,IAAI,cAAc,QAAQ,CAAC;AAC7B,MAAI,MACF,WAAW;AACb,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,QAAQ,KAAK,CAAC;AACpB,QAAI,QAAQ,WAAW,CAAC,QAAQ,QAAQ,OAAO,GAAG,IAAI,EAAG;AACzD,UAAM,KAAK,EAAE,OAAO,GAAG,IAAI,GACzB,KAAK,EAAE,OAAO,GAAG,IAAI;AACvB,QAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,EAAG;AACpD,UAAM,KAAK,QAAQ,OAAO,IAAI,EAAE,GAC9B,KAAK,QAAQ,OAAO,IAAI,EAAE;AAC5B,UAAM,OAAO,KAAK,MAAM,KAAK,MAAM,GAAG,KAAK,MAAM,CAAC;AAClD,WAAO,MAAM,uBAAuB;AACpC,QAAI,OAAO,aAAa,QAAQ,UAAa,QAAQ,MAAM;AACzD,iBAAW;AACX,aAAO,EAAE,OAAO,OAAO,GAAG,GAAG,IAAI,GAAG,IAAI,UAAU,KAAK;AAAA,IACzD;AAAA,EACF;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/features/viz/lib/paint.d.ts

@@ -0,0 +1,2 @@
+export declare function width(value: number, receiver: string): number;
+export declare function opacity(value: number, receiver: string): number;

package/dist/features/viz/lib/paint.js

@@ -0,0 +1,17 @@
+function width(value, receiver) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0)
+    throw new RangeError(
+      `${receiver}: stroke/interaction width must be finite and nonnegative.`
+    );
+  return value;
+}
+function opacity(value, receiver) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0 || value > 1)
+    throw new RangeError(`${receiver}: opacity must be between 0 and 1.`);
+  return value;
+}
+export {
+  opacity,
+  width
+};
+//# sourceMappingURL=paint.js.map

package/dist/features/viz/lib/paint.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/paint.ts"],
+  "sourcesContent": ["export function width(value: number, receiver: string): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value < 0)\n    throw new RangeError(\n      `${receiver}: stroke/interaction width must be finite and nonnegative.`,\n    );\n  return value;\n}\nexport function opacity(value: number, receiver: string): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isFinite(value) ||\n    value < 0 ||\n    value > 1\n  )\n    throw new RangeError(`${receiver}: opacity must be between 0 and 1.`);\n  return value;\n}\n"],
+  "mappings": "AAAO,SAAS,MAAM,OAAe,UAA0B;AAC7D,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ;AAClE,UAAM,IAAI;AAAA,MACR,GAAG,QAAQ;AAAA,IACb;AACF,SAAO;AACT;AACO,SAAS,QAAQ,OAAe,UAA0B;AAC/D,MACE,OAAO,UAAU,YACjB,CAAC,OAAO,SAAS,KAAK,KACtB,QAAQ,KACR,QAAQ;AAER,UAAM,IAAI,WAAW,GAAG,QAAQ,oCAAoC;AACtE,SAAO;AACT;",
+  "names": []
+}

package/dist/features/viz/lib/pie-layout.d.ts

@@ -0,0 +1,31 @@
+import type { PieLayoutProps, PieSliceProps, PieLabelProps } from "./pie-types.js";
+/**
+ * Computes pie geometry and label placement, then renders children for each resolved slice.
+ *
+ * @param props - Data, pie geometry, label policy, and child renderer. See {@link PieLayoutProps}.
+ * @returns Pibbl content arranged as pie slices.
+ *
+ * @see {@link PieLayoutProps}
+ */
+export declare function PieLayout<D>(props: PieLayoutProps<D>): import("../../../jsx-runtime.js").JSX.Element[];
+/**
+ * Draws a resolved pie slice using wedge geometry and the supplied paint style.
+ *
+ * @param props - Slice geometry, appearance, handlers, and children. See {@link PieSliceProps}.
+ * @returns Pibbl nodes drawing one pie slice and its children.
+ *
+ * @see {@link PieSliceProps}
+ */
+export declare function PieSlice<D>({ slice, style: input, children, ...events }: PieSliceProps<D>): import("../../../jsx-runtime.js").JSX.Element;
+/**
+ * Draws a resolved slice label and optional leader line; decorative labels ignore pointer
+ * targeting
+ * by default.
+ *
+ * @param props - Slice geometry, label appearance, and interaction options. See
+ * {@link PieLabelProps} .
+ * @returns Pibbl content drawing the slice label, or null when the label was not placed.
+ *
+ * @see {@link PieLabelProps}
+ */
+export declare function PieLabel<D>({ slice, style: input, pointerEvents, ...events }: PieLabelProps<D>): import("../../../jsx-runtime.js").JSX.Element | null;

package/dist/features/viz/lib/pie-layout.js

@@ -0,0 +1,324 @@
+import { jsx, jsxs } from "@pibbl/core/jsx-runtime";
+import {
+  Group,
+  Path,
+  Wedge,
+  definePrimitive,
+  Line,
+  Rectangle,
+  resolveSignalValue,
+  useComputed,
+  useCanvasContext,
+  useLayoutBox
+} from "@pibbl/core";
+import { resolveTexturePaint, withHooksForbidden } from "@pibbl/core/internal";
+import { pieSlices } from "./pie-slices.js";
+import { layoutPie } from "./layout-pie.js";
+function finite(value, name, nonnegative = false) {
+  if (!Number.isFinite(value) || nonnegative && value < 0)
+    throw new RangeError(
+      `PieLayout: ${name} must be finite${nonnegative ? " and nonnegative" : ""}.`
+    );
+  return value;
+}
+function PieLayout(props) {
+  const allocation = useLayoutBox();
+  const context = useCanvasContext();
+  const style = resolveSignalValue(props.style) ?? {};
+  const bounds = resolveSignalValue(props.bounds) ?? {
+    x: 0,
+    y: 0,
+    width: allocation.width,
+    height: allocation.height
+  };
+  const bx = finite(bounds.x, "bounds.x"), by = finite(bounds.y, "bounds.y");
+  const bw = finite(bounds.width, "bounds.width", true), bh = finite(bounds.height, "bounds.height", true);
+  finite(bx + bw, "bounds right");
+  finite(by + bh, "bounds bottom");
+  const cx = finite(resolveSignalValue(style.cx) ?? bx + bw / 2, "cx");
+  const cy = finite(resolveSignalValue(style.cy) ?? by + bh / 2, "cy");
+  const radius = finite(
+    resolveSignalValue(style.radius) ?? Math.min(bw * 0.28, bh * 0.4),
+    "radius",
+    true
+  );
+  const innerRadius = finite(
+    resolveSignalValue(style.innerRadius) ?? 0,
+    "innerRadius",
+    true
+  );
+  if (radius === 0 ? innerRadius !== 0 : innerRadius >= radius)
+    throw new RangeError(
+      "PieLayout: innerRadius must be zero when radius is zero, or less than radius."
+    );
+  const gap = finite(resolveSignalValue(style.labelGap) ?? 8, "labelGap", true);
+  finite(cx + radius + gap, "right label edge");
+  finite(cx - radius - gap, "left label edge");
+  finite(cy + radius, "bottom");
+  finite(cy - radius, "top");
+  const font = resolveSignalValue(style.labelFont) ?? "14px sans-serif";
+  if (typeof font !== "string" || !font.trim())
+    throw new TypeError("PieLayout: labelFont must be a Canvas font string.");
+  const placement = resolveSignalValue(props.placement) ?? "outside";
+  if (!["inside", "outside", "auto"].includes(placement))
+    throw new TypeError(
+      "PieLayout: placement must be inside, outside, or auto."
+    );
+  if (typeof props.children !== "function")
+    throw new TypeError(
+      "PieLayout: children must be a function returning Pibbl elements."
+    );
+  const revision = props.revision === void 0 ? void 0 : resolveSignalValue(props.revision);
+  if (revision !== void 0 && (!Number.isSafeInteger(revision) || revision < 0))
+    throw new RangeError(
+      "PieLayout: revision must be a finite nonnegative safe integer."
+    );
+  const cacheKey = revision === void 0 ? {} : revision;
+  const slices = useComputed(
+    () => pieSlices(resolveSignalValue(props.data), {
+      value: props.value,
+      keyBy: props.keyBy
+    }),
+    [cacheKey, props.data, props.value, props.keyBy]
+  );
+  const layout = useComputed(() => {
+    context.save();
+    try {
+      context.font = "10px serif";
+      context.font = font;
+      const normalized = context.font;
+      context.font = "11px monospace";
+      context.font = font;
+      if (context.font !== normalized)
+        throw new TypeError("PieLayout: labelFont must be a valid Canvas font.");
+      context.textAlign = "left";
+      context.textBaseline = "alphabetic";
+      return layoutPie(
+        slices.get(),
+        cx,
+        cy,
+        radius,
+        innerRadius,
+        { x: bx, y: by, width: bw, height: bh },
+        context.font,
+        gap,
+        placement,
+        props.label,
+        (text) => {
+          const m = context.measureText(text);
+          const width = Math.max(
+            m.width,
+            m.actualBoundingBoxLeft + m.actualBoundingBoxRight
+          );
+          const ascent = Math.max(0, m.actualBoundingBoxAscent), descent = Math.max(0, m.actualBoundingBoxDescent);
+          return {
+            width: finite(width, "label width", true),
+            height: finite(Math.max(1, ascent + descent), "label height", true),
+            left: Math.max(0, m.actualBoundingBoxLeft),
+            ascent
+          };
+        }
+      );
+    } finally {
+      context.restore();
+    }
+  }, [
+    slices,
+    cx,
+    cy,
+    radius,
+    innerRadius,
+    bx,
+    by,
+    bw,
+    bh,
+    font,
+    gap,
+    placement,
+    props.label,
+    context
+  ]);
+  return layout.get().map((slice) => /* @__PURE__ */ jsx(Group, { children: withHooksForbidden(
+    "PieLayout children cannot call hooks; return a component instead.",
+    () => props.children(slice)
+  ) }, slice.key));
+}
+function PieSlice({
+  slice,
+  style: input,
+  children,
+  ...events
+}) {
+  const style = resolveSignalValue(input) ?? {};
+  if (slice.innerRadius === 0) {
+    return /* @__PURE__ */ jsxs(Group, { children: [
+      /* @__PURE__ */ jsx(
+        Wedge,
+        {
+          ...events,
+          style: {
+            ...style,
+            cx: slice.cx,
+            cy: slice.cy,
+            radius: slice.radius,
+            startAngle: slice.startAngle,
+            endAngle: slice.endAngle
+          }
+        }
+      ),
+      children
+    ] });
+  }
+  const sweep = resolveClockwiseSweep(slice.startAngle, slice.endAngle);
+  const path = new Path2D();
+  path.arc(
+    slice.cx,
+    slice.cy,
+    slice.radius,
+    sweep.startAngle,
+    sweep.endAngle
+  );
+  if (slice.innerRadius > 0)
+    path.arc(
+      slice.cx,
+      slice.cy,
+      slice.innerRadius,
+      sweep.endAngle,
+      sweep.startAngle,
+      true
+    );
+  else path.lineTo(slice.cx, slice.cy);
+  path.closePath();
+  return /* @__PURE__ */ jsxs(Group, { children: [
+    /* @__PURE__ */ jsx(
+      Path,
+      {
+        ...events,
+        keyboardNavigationBounds: events.keyboardNavigationBounds ?? annularSliceBounds(slice, sweep),
+        style: {
+          ...style,
+          d: path
+        }
+      }
+    ),
+    children
+  ] });
+}
+function annularSliceBounds(slice, sweep) {
+  if (sweep.sweep === 0) return void 0;
+  if (sweep.fullCircle)
+    return {
+      x: slice.cx - slice.radius,
+      y: slice.cy - slice.radius,
+      width: slice.radius * 2,
+      height: slice.radius * 2
+    };
+  const angles = [sweep.startAngle, sweep.endAngle];
+  for (const cardinal of [0, Math.PI / 2, Math.PI, Math.PI * 1.5]) {
+    const angle = cardinal < sweep.startAngle ? cardinal + fullTurn : cardinal;
+    if (angle <= sweep.endAngle) angles.push(angle);
+  }
+  const xs = [];
+  const ys = [];
+  for (const angle of angles) {
+    const cosine = Math.cos(angle);
+    const sine = Math.sin(angle);
+    xs.push(
+      slice.cx + slice.radius * cosine,
+      slice.cx + slice.innerRadius * cosine
+    );
+    ys.push(
+      slice.cy + slice.radius * sine,
+      slice.cy + slice.innerRadius * sine
+    );
+  }
+  const left = Math.min(...xs);
+  const right = Math.max(...xs);
+  const top = Math.min(...ys);
+  const bottom = Math.max(...ys);
+  return { x: left, y: top, width: right - left, height: bottom - top };
+}
+const fullTurn = Math.PI * 2;
+function resolveClockwiseSweep(startAngle, endAngle) {
+  if (!Number.isFinite(startAngle) || !Number.isFinite(endAngle))
+    throw new RangeError("PieSlice: slice angles must be finite.");
+  const start = positiveModulo(startAngle, fullTurn);
+  if (endAngle - startAngle >= fullTurn)
+    return {
+      startAngle: start,
+      endAngle: start + fullTurn,
+      sweep: fullTurn,
+      fullCircle: true
+    };
+  const sweep = positiveModulo(
+    positiveModulo(endAngle, fullTurn) - start,
+    fullTurn
+  );
+  return {
+    startAngle: start,
+    endAngle: start + sweep,
+    sweep,
+    fullCircle: false
+  };
+}
+function positiveModulo(value, divisor) {
+  const result = value % divisor;
+  if (result === 0) return 0;
+  return result < 0 ? result + divisor : result;
+}
+const LabelText = definePrimitive(({ label }, style, context) => {
+  context.font = label.font;
+  context.textAlign = "left";
+  context.textBaseline = "alphabetic";
+  context.fillStyle = resolveTexturePaint(style.fill, context, { x: label.x, y: label.y, width: label.width, height: label.height });
+  context.fillText(label.text, label.textX, label.textY);
+});
+function PieLabel({
+  slice,
+  style: input,
+  pointerEvents = "none",
+  ...events
+}) {
+  const style = resolveSignalValue(input) ?? {};
+  const label = slice.label;
+  if (!label || label.status !== "placed") return null;
+  return /* @__PURE__ */ jsxs(Group, { ...events, children: [
+    label.leader && /* @__PURE__ */ jsx(
+      Line,
+      {
+        pointerEvents: "none",
+        style: {
+          coords: label.leader.map((p) => [p[0], p[1]]),
+          stroke: resolveSignalValue(style.leaderStroke) ?? "#94a3b8",
+          strokeWidth: resolveSignalValue(style.leaderWidth) ?? 1
+        }
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      Rectangle,
+      {
+        pointerEvents,
+        style: {
+          left: label.x,
+          top: label.y,
+          width: label.width,
+          height: label.height,
+          fill: "transparent"
+        }
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      LabelText,
+      {
+        label,
+        style: { fill: resolveSignalValue(style.fill) ?? "#182c42" }
+      }
+    )
+  ] });
+}
+export {
+  PieLabel,
+  PieLayout,
+  PieSlice
+};
+//# sourceMappingURL=pie-layout.js.map

package/dist/features/viz/lib/pie-layout.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/pie-layout.tsx"],
+  "sourcesContent": ["import {\n  Group,\n  Path,\n  Wedge,\n  definePrimitive,\n  Line,\n  Rectangle,\n  resolveSignalValue,\n  useComputed,\n  useCanvasContext,\n  useLayoutBox,\n} from \"@pibbl/core\";\nimport { resolveTexturePaint, withHooksForbidden } from \"@pibbl/core/internal\";\nimport type {\n  PieLayoutProps,\n  PieLayoutSlice,\n  PieSliceProps,\n  PieLabelProps,\n  PieLabelLayout,\n} from \"./pie-types.js\";\nimport { pieSlices } from \"./pie-slices.js\";\nimport { layoutPie } from \"./layout-pie.js\";\nfunction finite(value: number, name: string, nonnegative = false) {\n  if (!Number.isFinite(value) || (nonnegative && value < 0))\n    throw new RangeError(\n      `PieLayout: ${name} must be finite${nonnegative ? \" and nonnegative\" : \"\"}.`,\n    );\n  return value;\n}\n/**\n * Computes pie geometry and label placement, then renders children for each resolved slice.\n *\n * @param props - Data, pie geometry, label policy, and child renderer. See {@link PieLayoutProps}.\n * @returns Pibbl content arranged as pie slices.\n *\n * @see {@link PieLayoutProps}\n */\nexport function PieLayout<D>(props: PieLayoutProps<D>) {\n  const allocation = useLayoutBox();\n  const context = useCanvasContext();\n  const style = resolveSignalValue(props.style) ?? {};\n  const bounds = resolveSignalValue(props.bounds) ?? {\n    x: 0,\n    y: 0,\n    width: allocation.width,\n    height: allocation.height,\n  };\n  const bx = finite(bounds.x, \"bounds.x\"),\n    by = finite(bounds.y, \"bounds.y\");\n  const bw = finite(bounds.width, \"bounds.width\", true),\n    bh = finite(bounds.height, \"bounds.height\", true);\n  finite(bx + bw, \"bounds right\");\n  finite(by + bh, \"bounds bottom\");\n  const cx = finite(resolveSignalValue(style.cx) ?? bx + bw / 2, \"cx\");\n  const cy = finite(resolveSignalValue(style.cy) ?? by + bh / 2, \"cy\");\n  const radius = finite(\n    resolveSignalValue(style.radius) ?? Math.min(bw * 0.28, bh * 0.4),\n    \"radius\",\n    true,\n  );\n  const innerRadius = finite(\n    resolveSignalValue(style.innerRadius) ?? 0,\n    \"innerRadius\",\n    true,\n  );\n  if (radius === 0 ? innerRadius !== 0 : innerRadius >= radius)\n    throw new RangeError(\n      \"PieLayout: innerRadius must be zero when radius is zero, or less than radius.\",\n    );\n  const gap = finite(resolveSignalValue(style.labelGap) ?? 8, \"labelGap\", true);\n  finite(cx + radius + gap, \"right label edge\");\n  finite(cx - radius - gap, \"left label edge\");\n  finite(cy + radius, \"bottom\");\n  finite(cy - radius, \"top\");\n  const font = resolveSignalValue(style.labelFont) ?? \"14px sans-serif\";\n  if (typeof font !== \"string\" || !font.trim())\n    throw new TypeError(\"PieLayout: labelFont must be a Canvas font string.\");\n  const placement = resolveSignalValue(props.placement) ?? \"outside\";\n  if (![\"inside\", \"outside\", \"auto\"].includes(placement))\n    throw new TypeError(\n      \"PieLayout: placement must be inside, outside, or auto.\",\n    );\n  if (typeof props.children !== \"function\")\n    throw new TypeError(\n      \"PieLayout: children must be a function returning Pibbl elements.\",\n    );\n  const revision =\n    props.revision === undefined ? undefined : resolveSignalValue(props.revision);\n  if (\n    revision !== undefined &&\n    (!Number.isSafeInteger(revision) || revision < 0)\n  )\n    throw new RangeError(\n      \"PieLayout: revision must be a finite nonnegative safe integer.\",\n    );\n  // An omitted revision deliberately replaces this token on every evaluation.\n  // Stable callback identities alone are not evidence of stable results.\n  const cacheKey = revision === undefined ? {} : revision;\n  const slices = useComputed(\n    () =>\n      pieSlices(resolveSignalValue(props.data), {\n        value: props.value,\n        keyBy: props.keyBy,\n      }),\n    [cacheKey, props.data, props.value, props.keyBy],\n  );\n  const layout = useComputed(() => {\n    context.save();\n    try {\n      // Canvas silently ignores malformed fonts. Two distinct sentinels detect\n      // that without depending on the caller's inherited font or CSS spelling.\n      context.font = \"10px serif\";\n      context.font = font;\n      const normalized = context.font;\n      context.font = \"11px monospace\";\n      context.font = font;\n      if (context.font !== normalized)\n        throw new TypeError(\"PieLayout: labelFont must be a valid Canvas font.\");\n      context.textAlign = \"left\";\n      context.textBaseline = \"alphabetic\";\n      return layoutPie(\n        slices.get(),\n        cx,\n        cy,\n        radius,\n        innerRadius,\n        { x: bx, y: by, width: bw, height: bh },\n        context.font,\n        gap,\n        placement,\n        props.label,\n        (text) => {\n          const m = context.measureText(text);\n          const width = Math.max(\n            m.width,\n            m.actualBoundingBoxLeft + m.actualBoundingBoxRight,\n          );\n          const ascent = Math.max(0, m.actualBoundingBoxAscent),\n            descent = Math.max(0, m.actualBoundingBoxDescent);\n          return {\n            width: finite(width, \"label width\", true),\n            height: finite(Math.max(1, ascent + descent), \"label height\", true),\n            left: Math.max(0, m.actualBoundingBoxLeft),\n            ascent,\n          };\n        },\n      );\n    } finally {\n      context.restore();\n    }\n  }, [\n    slices,\n    cx,\n    cy,\n    radius,\n    innerRadius,\n    bx,\n    by,\n    bw,\n    bh,\n    font,\n    gap,\n    placement,\n    props.label,\n    context,\n  ]);\n  return layout\n    .get()\n    .map((slice) => (\n      <Group key={slice.key}>\n        {withHooksForbidden(\n          \"PieLayout children cannot call hooks; return a component instead.\",\n          () => props.children(slice),\n        )}\n      </Group>\n    ));\n}\n/**\n * Draws a resolved pie slice using wedge geometry and the supplied paint style.\n *\n * @param props - Slice geometry, appearance, handlers, and children. See {@link PieSliceProps}.\n * @returns Pibbl nodes drawing one pie slice and its children.\n *\n * @see {@link PieSliceProps}\n */\nexport function PieSlice<D>({\n  slice,\n  style: input,\n  children,\n  ...events\n}: PieSliceProps<D>) {\n  const style = resolveSignalValue(input) ?? {};\n  if (slice.innerRadius === 0) {\n    return (\n      <Group>\n        <Wedge\n          {...events}\n          style={{\n            ...style,\n            cx: slice.cx,\n            cy: slice.cy,\n            radius: slice.radius,\n            startAngle: slice.startAngle,\n            endAngle: slice.endAngle,\n          }}\n        />\n        {children}\n      </Group>\n    );\n  }\n  const sweep = resolveClockwiseSweep(slice.startAngle, slice.endAngle);\n  const path = new Path2D();\n  path.arc(\n    slice.cx,\n    slice.cy,\n    slice.radius,\n    sweep.startAngle,\n    sweep.endAngle,\n  );\n  if (slice.innerRadius > 0)\n    path.arc(\n      slice.cx,\n      slice.cy,\n      slice.innerRadius,\n      sweep.endAngle,\n      sweep.startAngle,\n      true,\n    );\n  else path.lineTo(slice.cx, slice.cy);\n  path.closePath();\n  return (\n    <Group>\n      <Path\n        {...events}\n        keyboardNavigationBounds={\n          events.keyboardNavigationBounds ??\n          annularSliceBounds(slice, sweep)\n        }\n        style={{\n          ...style,\n          d: path,\n        }}\n      />\n      {children}\n    </Group>\n  );\n}\n\n/** The outer and inner arcs both contribute to an annular path's focus box. */\nfunction annularSliceBounds(\n  slice: PieLayoutSlice<unknown>,\n  sweep: Readonly<ClockwiseSweep>,\n) {\n  if (sweep.sweep === 0) return undefined;\n  if (sweep.fullCircle)\n    return {\n      x: slice.cx - slice.radius,\n      y: slice.cy - slice.radius,\n      width: slice.radius * 2,\n      height: slice.radius * 2,\n    };\n  const angles = [sweep.startAngle, sweep.endAngle];\n  for (const cardinal of [0, Math.PI / 2, Math.PI, Math.PI * 1.5]) {\n    const angle = cardinal < sweep.startAngle ? cardinal + fullTurn : cardinal;\n    if (angle <= sweep.endAngle) angles.push(angle);\n  }\n  const xs: number[] = [];\n  const ys: number[] = [];\n  for (const angle of angles) {\n    const cosine = Math.cos(angle);\n    const sine = Math.sin(angle);\n    xs.push(\n      slice.cx + slice.radius * cosine,\n      slice.cx + slice.innerRadius * cosine,\n    );\n    ys.push(\n      slice.cy + slice.radius * sine,\n      slice.cy + slice.innerRadius * sine,\n    );\n  }\n  const left = Math.min(...xs);\n  const right = Math.max(...xs);\n  const top = Math.min(...ys);\n  const bottom = Math.max(...ys);\n  return { x: left, y: top, width: right - left, height: bottom - top };\n}\n\nconst fullTurn = Math.PI * 2;\n\ninterface ClockwiseSweep {\n  readonly startAngle: number;\n  readonly endAngle: number;\n  readonly sweep: number;\n  readonly fullCircle: boolean;\n}\n\n/** Matches Canvas's bounded clockwise arc rule without retaining unbounded turns. */\nfunction resolveClockwiseSweep(\n  startAngle: number,\n  endAngle: number,\n): ClockwiseSweep {\n  if (!Number.isFinite(startAngle) || !Number.isFinite(endAngle))\n    throw new RangeError(\"PieSlice: slice angles must be finite.\");\n  const start = positiveModulo(startAngle, fullTurn);\n  if (endAngle - startAngle >= fullTurn)\n    return {\n      startAngle: start,\n      endAngle: start + fullTurn,\n      sweep: fullTurn,\n      fullCircle: true,\n    };\n  const sweep = positiveModulo(\n    positiveModulo(endAngle, fullTurn) - start,\n    fullTurn,\n  );\n  return {\n    startAngle: start,\n    endAngle: start + sweep,\n    sweep,\n    fullCircle: false,\n  };\n}\n\nfunction positiveModulo(value: number, divisor: number) {\n  const result = value % divisor;\n  if (result === 0) return 0;\n  return result < 0 ? result + divisor : result;\n}\n\nconst LabelText = definePrimitive<\n  { label: Extract<PieLabelLayout, { status: \"placed\" }> },\n  { readonly custom?: never; fill: import(\"@pibbl/core\").FillStyle }\n>(({ label }, style, context) => {\n  context.font = label.font;\n  context.textAlign = \"left\";\n  context.textBaseline = \"alphabetic\";\n  context.fillStyle = resolveTexturePaint(style.fill, context, { x: label.x, y: label.y, width: label.width, height: label.height });\n  context.fillText(label.text, label.textX, label.textY);\n});\n\n/**\n * Draws a resolved slice label and optional leader line; decorative labels ignore pointer\n * targeting\n * by default.\n *\n * @param props - Slice geometry, label appearance, and interaction options. See\n * {@link PieLabelProps} .\n * @returns Pibbl content drawing the slice label, or null when the label was not placed.\n *\n * @see {@link PieLabelProps}\n */\nexport function PieLabel<D>({\n  slice,\n  style: input,\n  pointerEvents = \"none\",\n  ...events\n}: PieLabelProps<D>) {\n  const style = resolveSignalValue(input) ?? {};\n  const label = slice.label;\n  if (!label || label.status !== \"placed\") return null;\n  return (\n    <Group {...events}>\n      {label.leader && (\n        <Line\n          pointerEvents=\"none\"\n          style={{\n            coords: label.leader.map((p) => [p[0], p[1]]),\n            stroke: resolveSignalValue(style.leaderStroke) ?? \"#94a3b8\",\n            strokeWidth: resolveSignalValue(style.leaderWidth) ?? 1,\n          }}\n        />\n      )}\n      <Rectangle\n        pointerEvents={pointerEvents}\n        style={{\n          left: label.x,\n          top: label.y,\n          width: label.width,\n          height: label.height,\n          fill: \"transparent\",\n        }}\n      />\n      <LabelText\n        label={label}\n        style={{ fill: resolveSignalValue(style.fill) ?? \"#182c42\" }}\n      />\n    </Group>\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/features/viz/lib/pie-slices.d.ts

@@ -0,0 +1,51 @@
+import type { PieLayoutProps, PieLayoutSlice } from "./pie-types.js";
+import type { LineAccessor } from "./types.js";
+import type { PlotKeyAccessor } from "./plot-types.js";
+/**
+ * Value and stable-key accessors used to derive pie-slice geometry.
+ *
+ * @see {@link LineAccessor}
+ * @see {@link PlotKeyAccessor}
+ * @see {@link pieSlices}
+ * @see {@link PieLayoutProps}
+ */
+export interface PieOptions<D> {
+    /** Value associated with this sample, input, or result. See {@link LineAccessor}. */
+    readonly value: LineAccessor<D>;
+    /** Property or callback supplying stable identity for each datum. See {@link PlotKeyAccessor}. */
+    readonly keyBy?: PlotKeyAccessor<D>;
+}
+/**
+ * A datum's key, value, fraction, and angular interval in a pie layout.
+ *
+ * @see {@link pieSlices}
+ * @see {@link PieLayoutProps}
+ * @see {@link PieLayoutSlice}
+ */
+export interface PieSliceGeometry<D> {
+    /** The original data item selected by this result. See {@link PieSliceGeometry}. */
+    readonly datum: D;
+    /** Index of the selected datum in its source data. See {@link PieSliceGeometry}. */
+    readonly index: number;
+    /** Stable identity used by the containing protocol. See {@link PieSliceGeometry}. */
+    readonly key: string;
+    /** Value associated with this sample, input, or result. See {@link PieSliceGeometry}. */
+    readonly value: number;
+    /** Normalized share or position represented by this value. See {@link PieSliceGeometry}. */
+    readonly fraction: number;
+    /** Angle at which the arc or slice begins. See {@link PieSliceGeometry}. */
+    readonly startAngle: number;
+    /** Angle at which the arc or slice ends. See {@link PieSliceGeometry}. */
+    readonly endAngle: number;
+}
+/**
+ * Pure source-ordered full-circle layout. Angles use Canvas radians, clockwise from the top.
+ *
+ * @param data - Records whose values determine slice proportions.
+ * @param options - Value accessor and optional stable key accessor. See {@link PieOptions}.
+ * @returns Ordered slice geometry associated with the input records. See {@link PieSliceGeometry}.
+ *
+ * @see {@link PieOptions}
+ * @see {@link PieSliceGeometry}
+ */
+export declare function pieSlices<D>(data: readonly D[], { value: input, keyBy }: PieOptions<D>): readonly PieSliceGeometry<D>[];