@pibbl/core 0.0.1

package/dist/features/viz/lib/point-series.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/point-series.tsx"],
+  "sourcesContent": ["import { resolveTexturePaint } from '@pibbl/core/internal';\nimport {\n  Path,\n  isSignal,\n  resolveSignalValue,\n  useCanvasContext,\n} from \"@pibbl/core\";\nimport type { FillStyle, StrokeStyle } from \"@pibbl/core\";\nimport type {\n  PointMarkStyle,\n  PointSeriesProps,\n  PointSeriesStyle,\n} from \"./point-types.js\";\nimport { useScale } from \"./use-scale.js\";\nimport { finiteCoordinate, pointAccessor, pointData } from \"./point-data.js\";\nimport { appendPointTarget, pointPath } from \"./point-geometry.js\";\nimport { opacity, width } from \"./paint.js\";\nconst fields = [\"radius\", \"fill\", \"stroke\", \"strokeWidth\", \"opacity\", \"cursor\"];\nfunction paint(\n  value: unknown,\n  name: string,\n): FillStyle | StrokeStyle | undefined {\n  if (\n    value === undefined ||\n    typeof value === \"string\" ||\n    value instanceof CanvasGradient ||\n    value instanceof CanvasPattern\n  )\n    return value;\n  throw new TypeError(`PointSeries: invalid ${name}.`);\n}\nfunction styleObject(input: unknown, callback: boolean): PointSeriesStyle {\n  if (input === null || typeof input !== \"object\" || Array.isArray(input))\n    throw new TypeError(\"PointSeries: style must be an object.\");\n  const result: Record<string, unknown> = {};\n  for (const key of Object.keys(input)) {\n    if (!fields.includes(key) || (callback && key === \"cursor\"))\n      throw new TypeError(`PointSeries: unsupported style field ${key}.`);\n    const value = (input as Record<string, unknown>)[key];\n    if (callback && isSignal(value))\n      throw new TypeError(\n        \"PointSeries: datum styles must contain plain values; read signals explicitly.\",\n      );\n    result[key] = callback ? value : resolveSignalValue(value);\n  }\n  return result as PointSeriesStyle;\n}\nfunction normalized(style: PointSeriesStyle) {\n  const radius = width(style.radius ?? 3, \"PointSeries radius\");\n  if (style.cursor !== undefined && typeof style.cursor !== \"string\")\n    throw new TypeError(\"PointSeries: cursor must be a string.\");\n  return {\n    radius,\n    fill: paint(style.fill ?? \"#2563eb\", \"fill\"),\n    stroke: paint(style.stroke, \"stroke\"),\n    strokeWidth: width(style.strokeWidth ?? 1, \"PointSeries\"),\n    opacity: opacity(style.opacity ?? 1, \"PointSeries\"),\n    cursor: style.cursor,\n  };\n}\n/**\n * Batched circles in source paint order with one ordinary Pibbl target.\n *\n * @param props - Data, coordinate accessors, scales, and point styling. See\n * {@link PointSeriesProps} .\n * @returns Pibbl nodes drawing the point marks.\n *\n * @see {@link PointSeriesProps}\n */\nexport function PointSeries<D>({\n  data: input,\n  x: xInput,\n  y: yInput,\n  xScale: xId,\n  yScale: yId,\n  defined,\n  style: styleInput,\n  ...events\n}: PointSeriesProps<D>) {\n  const xs = useScale(xId).get(),\n    ys = useScale(yId).get();\n  const data = pointData(resolveSignalValue(input), \"PointSeries\");\n  const x = pointAccessor(xInput),\n    y = pointAccessor(yInput);\n  const specified = resolveSignalValue(styleInput);\n  const shared =\n    typeof specified === \"function\"\n      ? undefined\n      : normalized(styleObject(specified ?? {}, false));\n  const ctx = useCanvasContext();\n  const target = new Path2D();\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !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 = xs.map(xv),\n      py = ys.map(yv);\n    const style =\n      shared ??\n      normalized(\n        styleObject(\n          (specified as (d: D, i: number, a: readonly D[]) => PointMarkStyle)(\n            datum,\n            i,\n            data,\n          ),\n          true,\n        ),\n      );\n    if (style.radius === 0) continue;\n    appendPointTarget(\n      target,\n      px,\n      py,\n      style.radius,\n      !!style.fill,\n      style.stroke ? style.strokeWidth : 0,\n    );\n    const path = pointPath(px, py, style.radius);\n    ctx.save();\n    try {\n      ctx.globalAlpha *= style.opacity;\n      if (style.fill) {\n        ctx.fillStyle = resolveTexturePaint(style.fill, ctx, { x: px - style.radius, y: py - style.radius, width: style.radius * 2, height: style.radius * 2 });\n        ctx.fill(path);\n      }\n      if (style.stroke && style.strokeWidth > 0) {\n        ctx.strokeStyle = resolveTexturePaint(style.stroke, ctx, { x: px - style.radius, y: py - style.radius, width: style.radius * 2, height: style.radius * 2 });\n        ctx.lineWidth = style.strokeWidth;\n        ctx.stroke(path);\n      }\n    } finally {\n      ctx.restore();\n    }\n  }\n  return (\n    <Path\n      {...events}\n      style={{ d: target, fill: \"transparent\", cursor: shared?.cursor }}\n    />\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/features/viz/lib/point-types.d.ts

@@ -0,0 +1,94 @@
+import type { PlotSeriesProps } from "./plot-types.js";
+import type { PibblEventHandlers, PibblEventParticipationOptions, FillStyle, SignalValue, StrokeStyle } from "@pibbl/core";
+import type { SignalStyle } from "@pibbl/core/internal";
+import type { LineAccessor, ScaleId } from "./types.js";
+/**
+ * A data property or callback extracting a point coordinate.
+ *
+ * @see {@link LineAccessor}
+ * @see {@link PointSeriesProps}
+ * @see {@link PlotSeriesProps}
+ */
+export type PointAccessor<D> = LineAccessor<D>;
+/**
+ * Radius and paint applied to an individual plotted point.
+ *
+ * @see {@link FillStyle}
+ * @see {@link StrokeStyle}
+ * @see {@link PointSeriesStyle}
+ * @see {@link PointStyleResolver}
+ */
+export interface PointMarkStyle {
+    /** Radius in the coordinate system of this geometry or effect. See {@link PointMarkStyle}. */
+    readonly radius?: number;
+    /** Paint used for the interior. See {@link FillStyle}. */
+    readonly fill?: FillStyle;
+    /** Paint used for the outline. See {@link StrokeStyle}. */
+    readonly stroke?: StrokeStyle;
+    /** Width of the painted outline. See {@link PointMarkStyle}. */
+    readonly strokeWidth?: number;
+    /** Opacity of the painted result. See {@link PointMarkStyle}. */
+    readonly opacity?: number;
+}
+/**
+ * Supported geometry and presentation properties for PointSeries.
+ *
+ * @see {@link PointMarkStyle}
+ * @see {@link PointSeriesProps}
+ */
+export interface PointSeriesStyle extends PointMarkStyle {
+    /** Cursor shown while this target owns pointer presentation. See {@link PointSeriesStyle}. */
+    readonly cursor?: string;
+}
+/**
+ * Computes per-datum point styling from the datum, index, and source data.
+ *
+ * @param datum - Datum being styled.
+ * @param index - Zero-based index in the source data.
+ * @param data - Complete source data array.
+ * @returns Paint and radius overrides for this point. See {@link PointMarkStyle}.
+ *
+ * @see {@link PointMarkStyle}
+ * @see {@link PointSeriesProps}
+ */
+export type PointStyleResolver<D> = (datum: D, index: number, data: readonly D[]) => Readonly<PointMarkStyle>;
+/**
+ * Authored inputs for PointSeries, including the declared data and presentation options.
+ *
+ * @see {@link PibblEventHandlers}
+ * @see {@link PibblEventParticipationOptions}
+ * @see {@link SignalValue}
+ * @see {@link PointAccessor}
+ * @see {@link ScaleId}
+ * @see {@link SignalStyle}
+ * @see {@link PointSeriesStyle}
+ * @see {@link PointStyleResolver}
+ */
+export interface PointSeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /**
+     * Application data supplied to the component or reported by the event. See {@link SignalValue}.
+     */
+    readonly data: SignalValue<readonly 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 ScaleId}. */
+    readonly xScale: ScaleId;
+    /** The scale used to map vertical data coordinates. See {@link ScaleId}. */
+    readonly yScale: ScaleId;
+    /**
+     * Returns whether a datum contributes drawable or queryable coordinates. See
+     * {@link PointSeriesProps}.
+     * @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;
+    /**
+     * Declared presentation and layout properties. See {@link SignalValue}, {@link SignalStyle},
+     * {@link PointSeriesStyle}, {@link PointStyleResolver}.
+     */
+    readonly style?: SignalValue<SignalStyle<PointSeriesStyle> | PointStyleResolver<D>>;
+}

package/dist/features/viz/lib/scale-adjust.d.ts

@@ -0,0 +1,11 @@
+import type { ScaleAdjustProps } from "./types.js";
+/**
+ * Adjusts descendant placement using configured x and y scales.
+ *
+ * @param props - Scale identity and domain or range adjustments for descendants. See
+ * {@link ScaleAdjustProps} .
+ * @returns Child content evaluated with the adjusted scale.
+ *
+ * @see {@link ScaleAdjustProps}
+ */
+export declare function ScaleAdjust(props: ScaleAdjustProps): import("../../../jsx-runtime.js").JSX.Element;

package/dist/features/viz/lib/scale-adjust.js

@@ -0,0 +1,25 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import { Group, resolveSignalValue } from "@pibbl/core";
+import { lookupScale } from "./scale-context.js";
+function ScaleAdjust(props) {
+  const x = lookupScale(props.xScale, "ScaleAdjust");
+  const y = lookupScale(props.yScale, "ScaleAdjust");
+  if (props.x === void 0 !== (props.xScale === void 0) || props.y === void 0 !== (props.yScale === void 0))
+    throw new TypeError("ScaleAdjust coordinates require matching scale IDs.");
+  if (x && x.get().type !== "linear" || y && y.get().type !== "linear")
+    throw new TypeError("ScaleAdjust requires linear scales.");
+  return /* @__PURE__ */ jsx(
+    Group,
+    {
+      style: {
+        translateX: x ? x.get().map(resolveSignalValue(props.x)) : 0,
+        translateY: y ? y.get().map(resolveSignalValue(props.y)) : 0
+      },
+      children: props.children
+    }
+  );
+}
+export {
+  ScaleAdjust
+};
+//# sourceMappingURL=scale-adjust.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/scale-adjust.tsx"],
+  "sourcesContent": ["import { Group, resolveSignalValue } from \"@pibbl/core\";\nimport type { ScaleAdjustProps } from \"./types.js\";\nimport { lookupScale } from \"./scale-context.js\";\n/**\n * Adjusts descendant placement using configured x and y scales.\n *\n * @param props - Scale identity and domain or range adjustments for descendants. See\n * {@link ScaleAdjustProps} .\n * @returns Child content evaluated with the adjusted scale.\n *\n * @see {@link ScaleAdjustProps}\n */\nexport function ScaleAdjust(props: ScaleAdjustProps) {\n  const x = lookupScale(props.xScale, \"ScaleAdjust\");\n  const y = lookupScale(props.yScale, \"ScaleAdjust\");\n  if (\n    (props.x === undefined) !== (props.xScale === undefined) ||\n    (props.y === undefined) !== (props.yScale === undefined)\n  )\n    throw new TypeError(\"ScaleAdjust coordinates require matching scale IDs.\");\n  if ((x && x.get().type !== \"linear\") || (y && y.get().type !== \"linear\"))\n    throw new TypeError(\"ScaleAdjust requires linear scales.\");\n  return (\n    <Group\n      style={{\n        translateX: x ? x.get().map(resolveSignalValue(props.x!)) : 0,\n        translateY: y ? y.get().map(resolveSignalValue(props.y!)) : 0,\n      }}\n    >\n      {props.children}\n    </Group>\n  );\n}\n"],
+  "mappings": "AAuBI;AAvBJ,SAAS,OAAO,0BAA0B;AAE1C,SAAS,mBAAmB;AAUrB,SAAS,YAAY,OAAyB;AACnD,QAAM,IAAI,YAAY,MAAM,QAAQ,aAAa;AACjD,QAAM,IAAI,YAAY,MAAM,QAAQ,aAAa;AACjD,MACG,MAAM,MAAM,YAAgB,MAAM,WAAW,WAC7C,MAAM,MAAM,YAAgB,MAAM,WAAW;AAE9C,UAAM,IAAI,UAAU,qDAAqD;AAC3E,MAAK,KAAK,EAAE,IAAI,EAAE,SAAS,YAAc,KAAK,EAAE,IAAI,EAAE,SAAS;AAC7D,UAAM,IAAI,UAAU,qCAAqC;AAC3D,SACE;AAAA,IAAC;AAAA;AAAA,MACC,OAAO;AAAA,QACL,YAAY,IAAI,EAAE,IAAI,EAAE,IAAI,mBAAmB,MAAM,CAAE,CAAC,IAAI;AAAA,QAC5D,YAAY,IAAI,EAAE,IAAI,EAAE,IAAI,mBAAmB,MAAM,CAAE,CAAC,IAAI;AAAA,MAC9D;AAAA,MAEC,gBAAM;AAAA;AAAA,EACT;AAEJ;",
+  "names": []
+}

package/dist/features/viz/lib/scale-context.d.ts

@@ -0,0 +1,8 @@
+import type { Signal } from "@pibbl/core";
+import type { ResolvedScale, ScaleId } from "./types.js";
+export declare function provideScale(id: ScaleId, value: Signal<ResolvedScale>, linear: Signal<ResolvedScale>, band: Signal<ResolvedScale>): void;
+export declare function lookupScale(id: ScaleId | undefined, receiver: string, type?: "linear" | "band"): Signal<ResolvedScale> | undefined;
+/** Invocation-scoped lookup for official viz receivers; does not allocate a hook. */
+export declare function readScale(id: ScaleId | undefined, receiver: string, type?: "linear" | "band"): Signal<ResolvedScale> | undefined;
+/** Captures visible ancestors so reactive formulas can resolve IDs outside traversal. */
+export declare function captureScaleLookup(receiver: string): (id: ScaleId | undefined, type?: "linear" | "band") => Signal<ResolvedScale> | undefined;

package/dist/features/viz/lib/scale-context.js

@@ -0,0 +1,61 @@
+import {
+  getCurrentBackendHostCanvas,
+  setCurrentComponentAfterRender,
+  useInternalHookSlot
+} from "@pibbl/core/internal";
+let current;
+function provideScale(id, value, linear, band) {
+  const parent = current;
+  const scope = {
+    id,
+    value,
+    linear,
+    band,
+    canvas: getCurrentBackendHostCanvas(),
+    parent
+  };
+  current = scope;
+  const restore = () => {
+    current = parent;
+  };
+  try {
+    setCurrentComponentAfterRender(restore);
+  } catch (error) {
+    restore();
+    throw error;
+  }
+}
+function lookupScale(id, receiver, type) {
+  useInternalHookSlot("vizScaleLookup", () => void 0);
+  return readScale(id, receiver, type);
+}
+function readScale(id, receiver, type) {
+  return findScale(current, getCurrentBackendHostCanvas(), id, receiver, type);
+}
+function captureScaleLookup(receiver) {
+  useInternalHookSlot("vizScaleLookup", () => void 0);
+  const parent = current;
+  const canvas = getCurrentBackendHostCanvas();
+  return (id, type) => findScale(parent, canvas, id, receiver, type);
+}
+function findScale(parent, canvas, id, receiver, type) {
+  if (id === void 0) return void 0;
+  for (let scope = parent; scope; scope = scope.parent) {
+    if (scope.id !== id) continue;
+    if (scope.canvas !== canvas)
+      throw new Error(
+        `${receiver}: scale ${String(id)} crosses a Layer boundary; place Scale inside the Layer.`
+      );
+    return type ? scope[type] : scope.value;
+  }
+  throw new Error(
+    `${receiver}: unknown scale ${String(id)}; add an ancestor Scale with this ID.`
+  );
+}
+export {
+  captureScaleLookup,
+  lookupScale,
+  provideScale,
+  readScale
+};
+//# sourceMappingURL=scale-context.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/scale-context.ts"],
+  "sourcesContent": ["import type { Canvas, Signal } from \"@pibbl/core\";\nimport {\n  getCurrentBackendHostCanvas,\n  setCurrentComponentAfterRender,\n  useInternalHookSlot,\n} from \"@pibbl/core/internal\";\nimport type { ResolvedScale, ScaleId } from \"./types.js\";\ninterface Scope {\n  id: ScaleId;\n  value: Signal<ResolvedScale>;\n  linear: Signal<ResolvedScale>;\n  band: Signal<ResolvedScale>;\n  canvas: Canvas;\n  parent: Scope | undefined;\n}\nlet current: Scope | undefined;\nexport function provideScale(\n  id: ScaleId,\n  value: Signal<ResolvedScale>,\n  linear: Signal<ResolvedScale>,\n  band: Signal<ResolvedScale>,\n): void {\n  const parent = current;\n  const scope: Scope = {\n    id,\n    value,\n    linear,\n    band,\n    canvas: getCurrentBackendHostCanvas(),\n    parent,\n  };\n  current = scope;\n  const restore = () => {\n    current = parent;\n  };\n  try {\n    setCurrentComponentAfterRender(restore);\n  } catch (error) {\n    restore();\n    throw error;\n  }\n}\nexport function lookupScale(\n  id: ScaleId | undefined,\n  receiver: string,\n  type?: \"linear\" | \"band\",\n): Signal<ResolvedScale> | undefined {\n  useInternalHookSlot(\"vizScaleLookup\", () => undefined);\n  return readScale(id, receiver, type);\n}\n/** Invocation-scoped lookup for official viz receivers; does not allocate a hook. */\nexport function readScale(\n  id: ScaleId | undefined,\n  receiver: string,\n  type?: \"linear\" | \"band\",\n): Signal<ResolvedScale> | undefined {\n  return findScale(current, getCurrentBackendHostCanvas(), id, receiver, type);\n}\n/** Captures visible ancestors so reactive formulas can resolve IDs outside traversal. */\nexport function captureScaleLookup(receiver: string) {\n  useInternalHookSlot(\"vizScaleLookup\", () => undefined);\n  const parent = current;\n  const canvas = getCurrentBackendHostCanvas();\n  return (id: ScaleId | undefined, type?: \"linear\" | \"band\") =>\n    findScale(parent, canvas, id, receiver, type);\n}\nfunction findScale(\n  parent: Scope | undefined,\n  canvas: Canvas,\n  id: ScaleId | undefined,\n  receiver: string,\n  type?: \"linear\" | \"band\",\n): Signal<ResolvedScale> | undefined {\n  if (id === undefined) return undefined;\n  for (let scope = parent; scope; scope = scope.parent) {\n    if (scope.id !== id) continue;\n    if (scope.canvas !== canvas)\n      throw new Error(\n        `${receiver}: scale ${String(id)} crosses a Layer boundary; place Scale inside the Layer.`,\n      );\n    return type ? scope[type] : scope.value;\n  }\n  throw new Error(\n    `${receiver}: unknown scale ${String(id)}; add an ancestor Scale with this ID.`,\n  );\n}\n"],
+  "mappings": "AACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAUP,IAAI;AACG,SAAS,aACd,IACA,OACA,QACA,MACM;AACN,QAAM,SAAS;AACf,QAAM,QAAe;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ,4BAA4B;AAAA,IACpC;AAAA,EACF;AACA,YAAU;AACV,QAAM,UAAU,MAAM;AACpB,cAAU;AAAA,EACZ;AACA,MAAI;AACF,mCAA+B,OAAO;AAAA,EACxC,SAAS,OAAO;AACd,YAAQ;AACR,UAAM;AAAA,EACR;AACF;AACO,SAAS,YACd,IACA,UACA,MACmC;AACnC,sBAAoB,kBAAkB,MAAM,MAAS;AACrD,SAAO,UAAU,IAAI,UAAU,IAAI;AACrC;AAEO,SAAS,UACd,IACA,UACA,MACmC;AACnC,SAAO,UAAU,SAAS,4BAA4B,GAAG,IAAI,UAAU,IAAI;AAC7E;AAEO,SAAS,mBAAmB,UAAkB;AACnD,sBAAoB,kBAAkB,MAAM,MAAS;AACrD,QAAM,SAAS;AACf,QAAM,SAAS,4BAA4B;AAC3C,SAAO,CAAC,IAAyB,SAC/B,UAAU,QAAQ,QAAQ,IAAI,UAAU,IAAI;AAChD;AACA,SAAS,UACP,QACA,QACA,IACA,UACA,MACmC;AACnC,MAAI,OAAO,OAAW,QAAO;AAC7B,WAAS,QAAQ,QAAQ,OAAO,QAAQ,MAAM,QAAQ;AACpD,QAAI,MAAM,OAAO,GAAI;AACrB,QAAI,MAAM,WAAW;AACnB,YAAM,IAAI;AAAA,QACR,GAAG,QAAQ,WAAW,OAAO,EAAE,CAAC;AAAA,MAClC;AACF,WAAO,OAAO,MAAM,IAAI,IAAI,MAAM;AAAA,EACpC;AACA,QAAM,IAAI;AAAA,IACR,GAAG,QAAQ,mBAAmB,OAAO,EAAE,CAAC;AAAA,EAC1C;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,11 @@
+import type { ScaleProps } from "./types.js";
+/**
+ * Declares a named linear or band scale in the current layout for descendant visualization
+ * components.
+ *
+ * @param props - Scale identity, domain, range, and child content. See {@link ScaleProps}.
+ * @returns The scale's child content with the scale registered for descendants.
+ *
+ * @see {@link ScaleProps}
+ */
+export declare function Scale(props: ScaleProps): import("@pibbl/core").PibblNode;

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

@@ -0,0 +1,80 @@
+import { resolveSignalValue, useComputed, useLayoutBox } from "@pibbl/core";
+import { equalScale, resolveLinearScale } from "./linear-scale.js";
+import { resolveBandScale } from "./band-scale.js";
+import { captureScaleLookup, provideScale } from "./scale-context.js";
+function Scale(props) {
+  if ((typeof props.id !== "string" || props.id.length === 0) && typeof props.id !== "symbol")
+    throw new TypeError("Scale id requires a nonempty string or symbol.");
+  if (props.type !== "linear" && props.type !== "band")
+    throw new TypeError(`Scale supports type="linear" or type="band".`);
+  const { width, height } = useLayoutBox();
+  const lookup = captureScaleLookup("Scale bandwidthOf");
+  function resolveParent() {
+    const range = resolveSignalValue(props.range);
+    if (props.type !== "band" || typeof range !== "object" || range === null || !("bandwidthOf" in range))
+      return void 0;
+    const parent2 = lookup(range.bandwidthOf, "band")?.get();
+    if (!parent2 || parent2.type !== "band")
+      throw new TypeError("Scale bandwidthOf requires an ancestor band scale.");
+    return parent2;
+  }
+  const parent = useComputed(resolveParent, [
+    props.type,
+    props.range,
+    lookup
+  ]).get();
+  function resolvedRange() {
+    const currentParent = resolveParent();
+    return currentParent ? [0, currentParent.bandwidth] : resolveSignalValue(props.range);
+  }
+  const dependencies = [
+    parent,
+    props.type,
+    props.domain,
+    props.range,
+    props.reverse,
+    props.type === "band" ? props.paddingInner : void 0,
+    props.type === "band" ? props.paddingOuter : void 0,
+    width,
+    height
+  ];
+  const value = useComputed(
+    () => props.type === "band" ? resolveBandScale(
+      resolveSignalValue(props.domain),
+      resolvedRange(),
+      resolveSignalValue(props.reverse ?? false),
+      width,
+      height,
+      resolveSignalValue(props.paddingInner ?? 0),
+      resolveSignalValue(props.paddingOuter ?? 0)
+    ) : resolveLinearScale(
+      resolveSignalValue(props.domain),
+      resolvedRange(),
+      resolveSignalValue(props.reverse ?? false),
+      width,
+      height
+    ),
+    dependencies,
+    { equals: equalScale }
+  );
+  const linear = useComputed(() => {
+    const resolved = value.get();
+    if (resolved.type !== "linear")
+      throw new TypeError(
+        'useScale requires type=linear; use useScale(id, "band") for band scales.'
+      );
+    return resolved;
+  }, dependencies);
+  const band = useComputed(() => {
+    const resolved = value.get();
+    if (resolved.type !== "band")
+      throw new TypeError("useScale requires type=band.");
+    return resolved;
+  }, dependencies);
+  provideScale(props.id, value, linear, band);
+  return props.children;
+}
+export {
+  Scale
+};
+//# sourceMappingURL=scale.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/scale.ts"],
+  "sourcesContent": ["import { resolveSignalValue, useComputed, useLayoutBox } from \"@pibbl/core\";\nimport type { ScaleProps, ScaleRange } from \"./types.js\";\nimport { equalScale, resolveLinearScale } from \"./linear-scale.js\";\nimport { resolveBandScale } from \"./band-scale.js\";\nimport { captureScaleLookup, provideScale } from \"./scale-context.js\";\n/**\n * Declares a named linear or band scale in the current layout for descendant visualization\n * components.\n *\n * @param props - Scale identity, domain, range, and child content. See {@link ScaleProps}.\n * @returns The scale's child content with the scale registered for descendants.\n *\n * @see {@link ScaleProps}\n */\nexport function Scale(props: ScaleProps) {\n  if (\n    (typeof props.id !== \"string\" || props.id.length === 0) &&\n    typeof props.id !== \"symbol\"\n  )\n    throw new TypeError(\"Scale id requires a nonempty string or symbol.\");\n  if (props.type !== \"linear\" && props.type !== \"band\")\n    throw new TypeError(`Scale supports type=\"linear\" or type=\"band\".`);\n  const { width, height } = useLayoutBox();\n  const lookup = captureScaleLookup(\"Scale bandwidthOf\");\n  function resolveParent() {\n    const range = resolveSignalValue(props.range);\n    if (\n      props.type !== \"band\" ||\n      typeof range !== \"object\" ||\n      range === null ||\n      !(\"bandwidthOf\" in range)\n    )\n      return undefined;\n    const parent = lookup(range.bandwidthOf, \"band\")?.get();\n    if (!parent || parent.type !== \"band\")\n      throw new TypeError(\"Scale bandwidthOf requires an ancestor band scale.\");\n    return parent;\n  }\n  // This snapshot admits allocation changes into the current render transaction.\n  // The formula also reads the live ancestor, preserving synchronous signal reads.\n  const parent = useComputed(resolveParent, [\n    props.type,\n    props.range,\n    lookup,\n  ]).get();\n  function resolvedRange(): ScaleRange {\n    const currentParent = resolveParent();\n    return currentParent\n      ? [0, currentParent.bandwidth]\n      : (resolveSignalValue(props.range) as ScaleRange);\n  }\n  const dependencies = [\n    parent,\n    props.type,\n    props.domain,\n    props.range,\n    props.reverse,\n    props.type === \"band\" ? props.paddingInner : undefined,\n    props.type === \"band\" ? props.paddingOuter : undefined,\n    width,\n    height,\n  ];\n  const value = useComputed(\n    () =>\n      props.type === \"band\"\n        ? resolveBandScale(\n            resolveSignalValue(props.domain),\n            resolvedRange(),\n            resolveSignalValue(props.reverse ?? false),\n            width,\n            height,\n            resolveSignalValue(props.paddingInner ?? 0),\n            resolveSignalValue(props.paddingOuter ?? 0),\n          )\n        : resolveLinearScale(\n            resolveSignalValue(props.domain),\n            resolvedRange(),\n            resolveSignalValue(props.reverse ?? false),\n            width,\n            height,\n          ),\n    dependencies,\n    { equals: equalScale },\n  );\n  const linear = useComputed(() => {\n    const resolved = value.get();\n    if (resolved.type !== \"linear\")\n      throw new TypeError(\n        'useScale requires type=linear; use useScale(id, \"band\") for band scales.',\n      );\n    return resolved;\n  }, dependencies);\n  const band = useComputed(() => {\n    const resolved = value.get();\n    if (resolved.type !== \"band\")\n      throw new TypeError(\"useScale requires type=band.\");\n    return resolved;\n  }, dependencies);\n  provideScale(props.id, value, linear, band);\n  return props.children;\n}\n"],
+  "mappings": "AAAA,SAAS,oBAAoB,aAAa,oBAAoB;AAE9D,SAAS,YAAY,0BAA0B;AAC/C,SAAS,wBAAwB;AACjC,SAAS,oBAAoB,oBAAoB;AAU1C,SAAS,MAAM,OAAmB;AACvC,OACG,OAAO,MAAM,OAAO,YAAY,MAAM,GAAG,WAAW,MACrD,OAAO,MAAM,OAAO;AAEpB,UAAM,IAAI,UAAU,gDAAgD;AACtE,MAAI,MAAM,SAAS,YAAY,MAAM,SAAS;AAC5C,UAAM,IAAI,UAAU,8CAA8C;AACpE,QAAM,EAAE,OAAO,OAAO,IAAI,aAAa;AACvC,QAAM,SAAS,mBAAmB,mBAAmB;AACrD,WAAS,gBAAgB;AACvB,UAAM,QAAQ,mBAAmB,MAAM,KAAK;AAC5C,QACE,MAAM,SAAS,UACf,OAAO,UAAU,YACjB,UAAU,QACV,EAAE,iBAAiB;AAEnB,aAAO;AACT,UAAMA,UAAS,OAAO,MAAM,aAAa,MAAM,GAAG,IAAI;AACtD,QAAI,CAACA,WAAUA,QAAO,SAAS;AAC7B,YAAM,IAAI,UAAU,oDAAoD;AAC1E,WAAOA;AAAA,EACT;AAGA,QAAM,SAAS,YAAY,eAAe;AAAA,IACxC,MAAM;AAAA,IACN,MAAM;AAAA,IACN;AAAA,EACF,CAAC,EAAE,IAAI;AACP,WAAS,gBAA4B;AACnC,UAAM,gBAAgB,cAAc;AACpC,WAAO,gBACH,CAAC,GAAG,cAAc,SAAS,IAC1B,mBAAmB,MAAM,KAAK;AAAA,EACrC;AACA,QAAM,eAAe;AAAA,IACnB;AAAA,IACA,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM,SAAS,SAAS,MAAM,eAAe;AAAA,IAC7C,MAAM,SAAS,SAAS,MAAM,eAAe;AAAA,IAC7C;AAAA,IACA;AAAA,EACF;AACA,QAAM,QAAQ;AAAA,IACZ,MACE,MAAM,SAAS,SACX;AAAA,MACE,mBAAmB,MAAM,MAAM;AAAA,MAC/B,cAAc;AAAA,MACd,mBAAmB,MAAM,WAAW,KAAK;AAAA,MACzC;AAAA,MACA;AAAA,MACA,mBAAmB,MAAM,gBAAgB,CAAC;AAAA,MAC1C,mBAAmB,MAAM,gBAAgB,CAAC;AAAA,IAC5C,IACA;AAAA,MACE,mBAAmB,MAAM,MAAM;AAAA,MAC/B,cAAc;AAAA,MACd,mBAAmB,MAAM,WAAW,KAAK;AAAA,MACzC;AAAA,MACA;AAAA,IACF;AAAA,IACN;AAAA,IACA,EAAE,QAAQ,WAAW;AAAA,EACvB;AACA,QAAM,SAAS,YAAY,MAAM;AAC/B,UAAM,WAAW,MAAM,IAAI;AAC3B,QAAI,SAAS,SAAS;AACpB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AACF,WAAO;AAAA,EACT,GAAG,YAAY;AACf,QAAM,OAAO,YAAY,MAAM;AAC7B,UAAM,WAAW,MAAM,IAAI;AAC3B,QAAI,SAAS,SAAS;AACpB,YAAM,IAAI,UAAU,8BAA8B;AACpD,WAAO;AAAA,EACT,GAAG,YAAY;AACf,eAAa,MAAM,IAAI,OAAO,QAAQ,IAAI;AAC1C,SAAO,MAAM;AACf;",
+  "names": ["parent"]
+}