@pibbl/core 0.0.1 → 0.0.2

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

@@ -1,7 +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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",
+  "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 { useContinuousScale } from \"./use-continuous-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 = useContinuousScale(xId).get(),\n    ys = useContinuousScale(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/reference-band.d.ts

@@ -0,0 +1,16 @@
+import { type SignalValue } from "@pibbl/core";
+import type { SignalStyle } from "@pibbl/core/internal";
+import type { AxisStyle } from "./types.js";
+import type { ChartLineProps } from "./chart-lines.js";
+/** A continuous domain interval painted across an explicit local pixel span. See {@link ReferenceBand}. */
+export interface ReferenceBandProps extends Omit<ChartLineProps, "style"> {
+    /** Two finite in-domain numeric endpoints; either order, including equal values. */
+    readonly values: SignalValue<readonly [number, number]>;
+    /** Fill defaults to #dce5e8; opacity defaults to 0.35. */
+    readonly style?: SignalValue<SignalStyle<Pick<AxisStyle, "fill" | "opacity">>>;
+}
+/** Paint a decorative interval without owning layout, labels, or hit geometry.
+ * @param props - Scale geometry and presentation. See {@link ReferenceBandProps}.
+ * @returns Decorative chart content in the caller's coordinate space.
+ */
+export declare function ReferenceBand(props: ReferenceBandProps): import("../../../jsx-runtime.js").JSX.Element;

package/dist/features/viz/lib/reference-band.js

@@ -0,0 +1,27 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import { Path, resolveSignalValue } from "@pibbl/core";
+import { lookupScale } from "./scale-context.js";
+import { opacity } from "./paint.js";
+function ReferenceBand(props) {
+  if (props.direction !== "horizontal" && props.direction !== "vertical") throw new TypeError("ReferenceBand direction must be horizontal or vertical.");
+  const source = lookupScale(props.scale, "ReferenceBand");
+  if (!source) throw new TypeError("ReferenceBand requires a scale ID.");
+  const scale = source.get();
+  if (scale.type === "point" || scale.type === "band") throw new TypeError("ReferenceBand requires a continuous scale.");
+  const values = resolveSignalValue(props.values), span = resolveSignalValue(props.span);
+  for (const pair of [values, span]) if (!Array.isArray(pair) || pair.length !== 2 || !pair.every((value) => typeof value === "number" && Number.isFinite(value))) throw new RangeError("ReferenceBand values and span require two finite endpoints.");
+  const lo = Math.min(...scale.domain), hi = Math.max(...scale.domain);
+  if (values.some((value) => value < lo || value > hi)) throw new RangeError("ReferenceBand values must be within the scale domain.");
+  const a = scale.map(values[0]), b = scale.map(values[1]);
+  const start = Math.min(...span), length = Math.abs(span[1] - span[0]);
+  if (!Number.isFinite(length)) throw new RangeError("ReferenceBand span length must be finite.");
+  const path = new Path2D();
+  if (props.direction === "horizontal") path.rect(start, Math.min(a, b), length, Math.abs(b - a));
+  else path.rect(Math.min(a, b), start, Math.abs(b - a), length);
+  const style = resolveSignalValue(props.style) ?? {};
+  return /* @__PURE__ */ jsx(Path, { pointerEvents: "none", style: { d: path, fill: resolveSignalValue(style.fill) ?? "#dce5e8", opacity: opacity(resolveSignalValue(style.opacity) ?? 0.35, "ReferenceBand") } });
+}
+export {
+  ReferenceBand
+};
+//# sourceMappingURL=reference-band.js.map

package/dist/features/viz/lib/reference-band.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/reference-band.tsx"],
+  "sourcesContent": ["import { Path, resolveSignalValue, type SignalValue } from \"@pibbl/core\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { AxisStyle } from \"./types.js\";\nimport type { ChartLineProps } from \"./chart-lines.js\";\nimport { lookupScale } from \"./scale-context.js\";\nimport { opacity } from \"./paint.js\";\n/** A continuous domain interval painted across an explicit local pixel span. See {@link ReferenceBand}. */\nexport interface ReferenceBandProps extends Omit<ChartLineProps, \"style\"> {\n  /** Two finite in-domain numeric endpoints; either order, including equal values. */\n  readonly values: SignalValue<readonly [number, number]>;\n  /** Fill defaults to #dce5e8; opacity defaults to 0.35. */\n  readonly style?: SignalValue<SignalStyle<Pick<AxisStyle, \"fill\" | \"opacity\">>>;\n}\n/** Paint a decorative interval without owning layout, labels, or hit geometry.\n * @param props - Scale geometry and presentation. See {@link ReferenceBandProps}.\n * @returns Decorative chart content in the caller's coordinate space.\n */\nexport function ReferenceBand(props: ReferenceBandProps) {\n  if (props.direction !== \"horizontal\" && props.direction !== \"vertical\") throw new TypeError(\"ReferenceBand direction must be horizontal or vertical.\");\n  const source = lookupScale(props.scale, \"ReferenceBand\");\n  if (!source) throw new TypeError(\"ReferenceBand requires a scale ID.\");\n  const scale = source.get();\n  if (scale.type === \"point\" || scale.type === \"band\") throw new TypeError(\"ReferenceBand requires a continuous scale.\");\n  const values = resolveSignalValue(props.values), span = resolveSignalValue(props.span);\n  for (const pair of [values, span]) if (!Array.isArray(pair) || pair.length !== 2 || !pair.every(value => typeof value === \"number\" && Number.isFinite(value))) throw new RangeError(\"ReferenceBand values and span require two finite endpoints.\");\n  const lo = Math.min(...scale.domain), hi = Math.max(...scale.domain);\n  if (values.some(value => value < lo || value > hi)) throw new RangeError(\"ReferenceBand values must be within the scale domain.\");\n  const a = scale.map(values[0]), b = scale.map(values[1]);\n  const start = Math.min(...span), length = Math.abs(span[1] - span[0]);\n  if (!Number.isFinite(length)) throw new RangeError(\"ReferenceBand span length must be finite.\");\n  const path = new Path2D();\n  if (props.direction === \"horizontal\") path.rect(start, Math.min(a, b), length, Math.abs(b - a));\n  else path.rect(Math.min(a, b), start, Math.abs(b - a), length);\n  const style = resolveSignalValue(props.style) ?? {};\n  return <Path pointerEvents=\"none\" style={{ d: path, fill: resolveSignalValue(style.fill) ?? \"#dce5e8\", opacity: opacity(resolveSignalValue(style.opacity) ?? 0.35, \"ReferenceBand\") }} />;\n}\n"],
+  "mappings": "AAkCS;AAlCT,SAAS,MAAM,0BAA4C;AAI3D,SAAS,mBAAmB;AAC5B,SAAS,eAAe;AAYjB,SAAS,cAAc,OAA2B;AACvD,MAAI,MAAM,cAAc,gBAAgB,MAAM,cAAc,WAAY,OAAM,IAAI,UAAU,yDAAyD;AACrJ,QAAM,SAAS,YAAY,MAAM,OAAO,eAAe;AACvD,MAAI,CAAC,OAAQ,OAAM,IAAI,UAAU,oCAAoC;AACrE,QAAM,QAAQ,OAAO,IAAI;AACzB,MAAI,MAAM,SAAS,WAAW,MAAM,SAAS,OAAQ,OAAM,IAAI,UAAU,4CAA4C;AACrH,QAAM,SAAS,mBAAmB,MAAM,MAAM,GAAG,OAAO,mBAAmB,MAAM,IAAI;AACrF,aAAW,QAAQ,CAAC,QAAQ,IAAI,EAAG,KAAI,CAAC,MAAM,QAAQ,IAAI,KAAK,KAAK,WAAW,KAAK,CAAC,KAAK,MAAM,WAAS,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,CAAC,EAAG,OAAM,IAAI,WAAW,6DAA6D;AACjP,QAAM,KAAK,KAAK,IAAI,GAAG,MAAM,MAAM,GAAG,KAAK,KAAK,IAAI,GAAG,MAAM,MAAM;AACnE,MAAI,OAAO,KAAK,WAAS,QAAQ,MAAM,QAAQ,EAAE,EAAG,OAAM,IAAI,WAAW,uDAAuD;AAChI,QAAM,IAAI,MAAM,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,MAAM,IAAI,OAAO,CAAC,CAAC;AACvD,QAAM,QAAQ,KAAK,IAAI,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;AACpE,MAAI,CAAC,OAAO,SAAS,MAAM,EAAG,OAAM,IAAI,WAAW,2CAA2C;AAC9F,QAAM,OAAO,IAAI,OAAO;AACxB,MAAI,MAAM,cAAc,aAAc,MAAK,KAAK,OAAO,KAAK,IAAI,GAAG,CAAC,GAAG,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC;AAAA,MACzF,MAAK,KAAK,KAAK,IAAI,GAAG,CAAC,GAAG,OAAO,KAAK,IAAI,IAAI,CAAC,GAAG,MAAM;AAC7D,QAAM,QAAQ,mBAAmB,MAAM,KAAK,KAAK,CAAC;AAClD,SAAO,oBAAC,QAAK,eAAc,QAAO,OAAO,EAAE,GAAG,MAAM,MAAM,mBAAmB,MAAM,IAAI,KAAK,WAAW,SAAS,QAAQ,mBAAmB,MAAM,OAAO,KAAK,MAAM,eAAe,EAAE,GAAG;AACzL;",
+  "names": []
+}

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

@@ -6,14 +6,19 @@ function ScaleAdjust(props) {
   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.");
+  const coordinate = (scale, value) => {
+    if (scale.type === "band") throw new TypeError("ScaleAdjust requires continuous or point scales.");
+    if (scale.type !== "point" && typeof value !== "number") throw new TypeError("ScaleAdjust continuous coordinates must be numbers.");
+    const result = scale.type === "point" ? scale.map(value) : scale.map(value);
+    if (result === void 0) throw new RangeError("ScaleAdjust point category is not in the domain.");
+    return result;
+  };
   return /* @__PURE__ */ jsx(
     Group,
     {
       style: {
-        translateX: x ? x.get().map(resolveSignalValue(props.x)) : 0,
-        translateY: y ? y.get().map(resolveSignalValue(props.y)) : 0
+        translateX: x ? coordinate(x.get(), resolveSignalValue(props.x)) : 0,
+        translateY: y ? coordinate(y.get(), resolveSignalValue(props.y)) : 0
       },
       children: props.children
     }

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

@@ -1,7 +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;",
+  "sourcesContent": ["import { Group, resolveSignalValue } from \"@pibbl/core\";\nimport type { ScaleAdjustProps, ResolvedScale, BandCategory } 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  const coordinate = (scale: ResolvedScale, value: BandCategory) => {\n    if (scale.type === \"band\") throw new TypeError(\"ScaleAdjust requires continuous or point scales.\");\n    if (scale.type !== \"point\" && typeof value !== \"number\") throw new TypeError(\"ScaleAdjust continuous coordinates must be numbers.\");\n    const result = scale.type === \"point\" ? scale.map(value) : scale.map(value as number);\n    if (result === undefined) throw new RangeError(\"ScaleAdjust point category is not in the domain.\");\n    return result;\n  };\n  return (\n    <Group\n      style={{\n        translateX: x ? coordinate(x.get(), resolveSignalValue(props.x!)) : 0,\n        translateY: y ? coordinate(y.get(), resolveSignalValue(props.y!)) : 0,\n      }}\n    >\n      {props.children}\n    </Group>\n  );\n}\n"],
+  "mappings": "AA4BI;AA5BJ,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,QAAM,aAAa,CAAC,OAAsB,UAAwB;AAChE,QAAI,MAAM,SAAS,OAAQ,OAAM,IAAI,UAAU,kDAAkD;AACjG,QAAI,MAAM,SAAS,WAAW,OAAO,UAAU,SAAU,OAAM,IAAI,UAAU,qDAAqD;AAClI,UAAM,SAAS,MAAM,SAAS,UAAU,MAAM,IAAI,KAAK,IAAI,MAAM,IAAI,KAAe;AACpF,QAAI,WAAW,OAAW,OAAM,IAAI,WAAW,kDAAkD;AACjG,WAAO;AAAA,EACT;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACC,OAAO;AAAA,QACL,YAAY,IAAI,WAAW,EAAE,IAAI,GAAG,mBAAmB,MAAM,CAAE,CAAC,IAAI;AAAA,QACpE,YAAY,IAAI,WAAW,EAAE,IAAI,GAAG,mBAAmB,MAAM,CAAE,CAAC,IAAI;AAAA,MACtE;AAAA,MAEC,gBAAM;AAAA;AAAA,EACT;AAEJ;",
   "names": []
 }

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

@@ -1,8 +1,9 @@
 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;
+export declare function scaleKind(value: Signal<ResolvedScale>): "band" | "linear" | "log" | "point" | "symlog" | "utc" | undefined;
+export declare function provideScale(id: ScaleId, value: Signal<ResolvedScale>, kind: ResolvedScale["type"]): void;
+export declare function lookupScale(id: ScaleId | undefined, receiver: string): 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;
+export declare function readScale(id: ScaleId | undefined, receiver: string): 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;
+export declare function captureScaleLookup(receiver: string): (id: ScaleId | undefined) => Signal<ResolvedScale> | undefined;

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

@@ -4,13 +4,16 @@ import {
   useInternalHookSlot
 } from "@pibbl/core/internal";
 let current;
-function provideScale(id, value, linear, band) {
+const kinds = /* @__PURE__ */ new WeakMap();
+function scaleKind(value) {
+  return kinds.get(value);
+}
+function provideScale(id, value, kind) {
+  kinds.set(value, kind);
   const parent = current;
   const scope = {
     id,
     value,
-    linear,
-    band,
     canvas: getCurrentBackendHostCanvas(),
     parent
   };
@@ -25,20 +28,20 @@ function provideScale(id, value, linear, band) {
     throw error;
   }
 }
-function lookupScale(id, receiver, type) {
+function lookupScale(id, receiver) {
   useInternalHookSlot("vizScaleLookup", () => void 0);
-  return readScale(id, receiver, type);
+  return readScale(id, receiver);
 }
-function readScale(id, receiver, type) {
-  return findScale(current, getCurrentBackendHostCanvas(), id, receiver, type);
+function readScale(id, receiver) {
+  return findScale(current, getCurrentBackendHostCanvas(), id, receiver);
 }
 function captureScaleLookup(receiver) {
   useInternalHookSlot("vizScaleLookup", () => void 0);
   const parent = current;
   const canvas = getCurrentBackendHostCanvas();
-  return (id, type) => findScale(parent, canvas, id, receiver, type);
+  return (id) => findScale(parent, canvas, id, receiver);
 }
-function findScale(parent, canvas, id, receiver, type) {
+function findScale(parent, canvas, id, receiver) {
   if (id === void 0) return void 0;
   for (let scope = parent; scope; scope = scope.parent) {
     if (scope.id !== id) continue;
@@ -46,7 +49,7 @@ function findScale(parent, canvas, id, receiver, type) {
       throw new Error(
         `${receiver}: scale ${String(id)} crosses a Layer boundary; place Scale inside the Layer.`
       );
-    return type ? scope[type] : scope.value;
+    return scope.value;
   }
   throw new Error(
     `${receiver}: unknown scale ${String(id)}; add an ancestor Scale with this ID.`
@@ -56,6 +59,7 @@ export {
   captureScaleLookup,
   lookupScale,
   provideScale,
-  readScale
+  readScale,
+  scaleKind
 };
 //# sourceMappingURL=scale-context.js.map

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

@@ -1,7 +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;",
+  "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  canvas: Canvas;\n  parent: Scope | undefined;\n}\nlet current: Scope | undefined;\nconst kinds = new WeakMap<Signal<ResolvedScale>, ResolvedScale[\"type\"]>();\nexport function scaleKind(value: Signal<ResolvedScale>) { return kinds.get(value); }\nexport function provideScale(\n  id: ScaleId,\n  value: Signal<ResolvedScale>,\n  kind: ResolvedScale[\"type\"],\n): void {\n  kinds.set(value, kind);\n  const parent = current;\n  const scope: Scope = {\n    id,\n    value,\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): Signal<ResolvedScale> | undefined {\n  useInternalHookSlot(\"vizScaleLookup\", () => undefined);\n  return readScale(id, receiver);\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): Signal<ResolvedScale> | undefined {\n  return findScale(current, getCurrentBackendHostCanvas(), id, receiver);\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) =>\n    findScale(parent, canvas, id, receiver);\n}\nfunction findScale(\n  parent: Scope | undefined,\n  canvas: Canvas,\n  id: ScaleId | undefined,\n  receiver: string,\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 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;AAQP,IAAI;AACJ,MAAM,QAAQ,oBAAI,QAAsD;AACjE,SAAS,UAAU,OAA8B;AAAE,SAAO,MAAM,IAAI,KAAK;AAAG;AAC5E,SAAS,aACd,IACA,OACA,MACM;AACN,QAAM,IAAI,OAAO,IAAI;AACrB,QAAM,SAAS;AACf,QAAM,QAAe;AAAA,IACnB;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,UACmC;AACnC,sBAAoB,kBAAkB,MAAM,MAAS;AACrD,SAAO,UAAU,IAAI,QAAQ;AAC/B;AAEO,SAAS,UACd,IACA,UACmC;AACnC,SAAO,UAAU,SAAS,4BAA4B,GAAG,IAAI,QAAQ;AACvE;AAEO,SAAS,mBAAmB,UAAkB;AACnD,sBAAoB,kBAAkB,MAAM,MAAS;AACrD,QAAM,SAAS;AACf,QAAM,SAAS,4BAA4B;AAC3C,SAAO,CAAC,OACN,UAAU,QAAQ,QAAQ,IAAI,QAAQ;AAC1C;AACA,SAAS,UACP,QACA,QACA,IACA,UACmC;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,MAAM;AAAA,EACf;AACA,QAAM,IAAI;AAAA,IACR,GAAG,QAAQ,mBAAmB,OAAO,EAAE,CAAC;AAAA,EAC1C;AACF;",
   "names": []
 }

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

@@ -0,0 +1,2 @@
+import type { ResolvedScale, ScaleId } from "./types.js";
+export declare function useScaleProvider(id: ScaleId, kind: ResolvedScale["type"], resolve: () => ResolvedScale, dependencies: readonly unknown[]): void;

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

@@ -0,0 +1,13 @@
+import { useComputed } from "@pibbl/core";
+import { equalScale } from "./linear-scale.js";
+import { provideScale } from "./scale-context.js";
+function useScaleProvider(id, kind, resolve, dependencies) {
+  if ((typeof id !== "string" || id.length === 0) && typeof id !== "symbol")
+    throw new TypeError("Scale id requires a nonempty string or symbol.");
+  const value = useComputed(resolve, dependencies, { equals: equalScale });
+  provideScale(id, value, kind);
+}
+export {
+  useScaleProvider
+};
+//# sourceMappingURL=scale-provider.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/scale-provider.ts"],
+  "sourcesContent": ["import { useComputed } from \"@pibbl/core\";\nimport { equalScale } from \"./linear-scale.js\";\nimport { provideScale } from \"./scale-context.js\";\nimport type { ResolvedScale, ScaleId } from \"./types.js\";\nexport function useScaleProvider(id: ScaleId, kind: ResolvedScale[\"type\"], resolve: () => ResolvedScale, dependencies: readonly unknown[]): void {\n  if ((typeof id !== \"string\" || id.length === 0) && typeof id !== \"symbol\")\n    throw new TypeError(\"Scale id requires a nonempty string or symbol.\");\n  const value = useComputed(resolve, dependencies, { equals: equalScale });\n  provideScale(id, value, kind);\n}\n"],
+  "mappings": "AAAA,SAAS,mBAAmB;AAC5B,SAAS,kBAAkB;AAC3B,SAAS,oBAAoB;AAEtB,SAAS,iBAAiB,IAAa,MAA6B,SAA8B,cAAwC;AAC/I,OAAK,OAAO,OAAO,YAAY,GAAG,WAAW,MAAM,OAAO,OAAO;AAC/D,UAAM,IAAI,UAAU,gDAAgD;AACtE,QAAM,QAAQ,YAAY,SAAS,cAAc,EAAE,QAAQ,WAAW,CAAC;AACvE,eAAa,IAAI,OAAO,IAAI;AAC9B;",
+  "names": []
+}

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

@@ -0,0 +1,5 @@
+import type { AxisProps, ResolvedScale } from "./types.js";
+type Tick = number | string;
+export declare function ticks(scale: ResolvedScale, props: Pick<AxisProps, "tickValues" | "tickCount">): readonly Tick[];
+export declare function position(scale: ResolvedScale, value: Tick): number;
+export {};

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

@@ -0,0 +1,49 @@
+import { resolveSignalValue } from "@pibbl/core";
+function ticks(scale, props) {
+  if (props.tickValues !== void 0 && props.tickCount !== void 0)
+    throw new TypeError("Axis tickValues and tickCount are mutually exclusive.");
+  const explicit = props.tickValues === void 0 ? void 0 : resolveSignalValue(props.tickValues);
+  if (explicit !== void 0) {
+    if (!Array.isArray(explicit) || explicit.length > 100)
+      throw new RangeError("Axis tickValues must be an array with at most 100 values.");
+    const seen = /* @__PURE__ */ new Set();
+    for (const value of explicit) {
+      if (seen.has(value)) throw new RangeError("Axis tickValues must not contain duplicates.");
+      seen.add(value);
+      if (scale.type !== "band" && scale.type !== "point") {
+        if (typeof value !== "number" || !Number.isFinite(value))
+          throw new TypeError("Axis tickValues for a continuous scale must be finite numbers.");
+        const [a, b] = scale.domain;
+        if (value < Math.min(a, b) || value > Math.max(a, b))
+          throw new RangeError("Axis tickValues must be within the scale domain.");
+      } else if (typeof value !== "string" && (typeof value !== "number" || !Number.isFinite(value)) || scale.map(value) === void 0) {
+        throw new RangeError("Axis tickValues must be known band categories.");
+      }
+    }
+    return explicit;
+  }
+  const count = resolveSignalValue(props.tickCount ?? 5);
+  if (!Number.isInteger(count) || count < 0 || count > 100)
+    throw new RangeError("Axis tickCount must be an integer from 0 to 100.");
+  if (count === 0) return [];
+  if (scale.type !== "band" && scale.type !== "point")
+    return count === 1 ? [scale.domain[0]] : scale.ticks(count);
+  const n = scale.domain.length;
+  if (n === 0) return [];
+  if (count === 1) return [scale.domain[0]];
+  const m = Math.min(count, n);
+  if (m === 1) return [scale.domain[0]];
+  return Array.from(
+    { length: m },
+    (_, index) => scale.domain[Math.round(index * (n - 1) / (m - 1))]
+  );
+}
+function position(scale, value) {
+  if (scale.type === "point") return scale.map(value);
+  return scale.type === "band" ? scale.map(value) + scale.bandwidth / 2 : scale.map(value);
+}
+export {
+  position,
+  ticks
+};
+//# sourceMappingURL=scale-ticks.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/scale-ticks.ts"],
+  "sourcesContent": ["import { resolveSignalValue } from \"@pibbl/core\";\nimport type { AxisProps, BandCategory, ResolvedScale } from \"./types.js\";\ntype Tick = number | string;\n\nexport function ticks(scale: ResolvedScale, props: Pick<AxisProps, \"tickValues\" | \"tickCount\">): readonly Tick[] {\n  if (props.tickValues !== undefined && props.tickCount !== undefined)\n    throw new TypeError(\"Axis tickValues and tickCount are mutually exclusive.\");\n  const explicit = props.tickValues === undefined\n    ? undefined\n    : resolveSignalValue(props.tickValues);\n  if (explicit !== undefined) {\n    if (!Array.isArray(explicit) || explicit.length > 100)\n      throw new RangeError(\"Axis tickValues must be an array with at most 100 values.\");\n    const seen = new Set<Tick>();\n    for (const value of explicit) {\n      if (seen.has(value)) throw new RangeError(\"Axis tickValues must not contain duplicates.\");\n      seen.add(value);\n      if (scale.type !== \"band\" && scale.type !== \"point\") {\n        if (typeof value !== \"number\" || !Number.isFinite(value))\n          throw new TypeError(\"Axis tickValues for a continuous scale must be finite numbers.\");\n        const [a, b] = scale.domain;\n        if (value < Math.min(a, b) || value > Math.max(a, b))\n          throw new RangeError(\"Axis tickValues must be within the scale domain.\");\n      } else if (\n        (typeof value !== \"string\" &&\n          (typeof value !== \"number\" || !Number.isFinite(value))) ||\n        scale.map(value as BandCategory) === undefined\n      ) {\n        throw new RangeError(\"Axis tickValues must be known band categories.\");\n      }\n    }\n    return explicit;\n  }\n  const count = resolveSignalValue(props.tickCount ?? 5);\n  if (!Number.isInteger(count) || count < 0 || count > 100)\n    throw new RangeError(\"Axis tickCount must be an integer from 0 to 100.\");\n  if (count === 0) return [];\n  if (scale.type !== \"band\" && scale.type !== \"point\")\n    return count === 1 ? [scale.domain[0]] : scale.ticks(count);\n  const n = scale.domain.length;\n  if (n === 0) return [];\n  if (count === 1) return [scale.domain[0]];\n  const m = Math.min(count, n);\n  if (m === 1) return [scale.domain[0]];\n  return Array.from(\n    { length: m },\n    (_, index) => scale.domain[Math.round((index * (n - 1)) / (m - 1))]!,\n  );\n}\n\nexport function position(scale: ResolvedScale, value: Tick): number {\n  if (scale.type === \"point\") return scale.map(value as BandCategory)!;\n  return scale.type === \"band\"\n    ? scale.map(value as BandCategory)! + scale.bandwidth / 2\n    : scale.map(value as number);\n}\n\n"],
+  "mappings": "AAAA,SAAS,0BAA0B;AAI5B,SAAS,MAAM,OAAsB,OAAqE;AAC/G,MAAI,MAAM,eAAe,UAAa,MAAM,cAAc;AACxD,UAAM,IAAI,UAAU,uDAAuD;AAC7E,QAAM,WAAW,MAAM,eAAe,SAClC,SACA,mBAAmB,MAAM,UAAU;AACvC,MAAI,aAAa,QAAW;AAC1B,QAAI,CAAC,MAAM,QAAQ,QAAQ,KAAK,SAAS,SAAS;AAChD,YAAM,IAAI,WAAW,2DAA2D;AAClF,UAAM,OAAO,oBAAI,IAAU;AAC3B,eAAW,SAAS,UAAU;AAC5B,UAAI,KAAK,IAAI,KAAK,EAAG,OAAM,IAAI,WAAW,8CAA8C;AACxF,WAAK,IAAI,KAAK;AACd,UAAI,MAAM,SAAS,UAAU,MAAM,SAAS,SAAS;AACnD,YAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK;AACrD,gBAAM,IAAI,UAAU,gEAAgE;AACtF,cAAM,CAAC,GAAG,CAAC,IAAI,MAAM;AACrB,YAAI,QAAQ,KAAK,IAAI,GAAG,CAAC,KAAK,QAAQ,KAAK,IAAI,GAAG,CAAC;AACjD,gBAAM,IAAI,WAAW,kDAAkD;AAAA,MAC3E,WACG,OAAO,UAAU,aACf,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,MACtD,MAAM,IAAI,KAAqB,MAAM,QACrC;AACA,cAAM,IAAI,WAAW,gDAAgD;AAAA,MACvE;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,mBAAmB,MAAM,aAAa,CAAC;AACrD,MAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,KAAK,QAAQ;AACnD,UAAM,IAAI,WAAW,kDAAkD;AACzE,MAAI,UAAU,EAAG,QAAO,CAAC;AACzB,MAAI,MAAM,SAAS,UAAU,MAAM,SAAS;AAC1C,WAAO,UAAU,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC,IAAI,MAAM,MAAM,KAAK;AAC5D,QAAM,IAAI,MAAM,OAAO;AACvB,MAAI,MAAM,EAAG,QAAO,CAAC;AACrB,MAAI,UAAU,EAAG,QAAO,CAAC,MAAM,OAAO,CAAC,CAAC;AACxC,QAAM,IAAI,KAAK,IAAI,OAAO,CAAC;AAC3B,MAAI,MAAM,EAAG,QAAO,CAAC,MAAM,OAAO,CAAC,CAAC;AACpC,SAAO,MAAM;AAAA,IACX,EAAE,QAAQ,EAAE;AAAA,IACZ,CAAC,GAAG,UAAU,MAAM,OAAO,KAAK,MAAO,SAAS,IAAI,MAAO,IAAI,EAAE,CAAC;AAAA,EACpE;AACF;AAEO,SAAS,SAAS,OAAsB,OAAqB;AAClE,MAAI,MAAM,SAAS,QAAS,QAAO,MAAM,IAAI,KAAqB;AAClE,SAAO,MAAM,SAAS,SAClB,MAAM,IAAI,KAAqB,IAAK,MAAM,YAAY,IACtD,MAAM,IAAI,KAAe;AAC/B;",
+  "names": []
+}

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

@@ -0,0 +1,4 @@
+import { type Signal } from "@pibbl/core";
+import type { ResolvedScale, ScaleId } from "./types.js";
+/** A lazy shared view: one readonly signal per provider and supported hook. */
+export declare function scaleView<T extends ResolvedScale>(cache: WeakMap<Signal<ResolvedScale>, Signal<T>>, id: ScaleId, receiver: string, accepts: (kind: ResolvedScale["type"] | undefined) => boolean): Signal<T>;

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

@@ -0,0 +1,21 @@
+import { computed } from "@pibbl/core";
+import { lookupScale, scaleKind } from "./scale-context.js";
+function scaleView(cache, id, receiver, accepts) {
+  const source = lookupScale(id, receiver);
+  if (!source) throw new TypeError(`${receiver} requires a scale ID.`);
+  if (accepts(scaleKind(source))) return source;
+  let view = cache.get(source);
+  if (!view) {
+    view = computed(() => {
+      const value = source.get();
+      if (!accepts(value.type)) throw new TypeError(`${receiver} cannot read a ${value.type} scale.`);
+      return value;
+    });
+    cache.set(source, view);
+  }
+  return view;
+}
+export {
+  scaleView
+};
+//# sourceMappingURL=scale-view.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/scale-view.ts"],
+  "sourcesContent": ["import { computed, type Signal } from \"@pibbl/core\";\nimport { lookupScale, scaleKind } from \"./scale-context.js\";\nimport type { ResolvedScale, ScaleId } from \"./types.js\";\n/** A lazy shared view: one readonly signal per provider and supported hook. */\nexport function scaleView<T extends ResolvedScale>(\n  cache: WeakMap<Signal<ResolvedScale>, Signal<T>>,\n  id: ScaleId,\n  receiver: string,\n  accepts: (kind: ResolvedScale[\"type\"] | undefined) => boolean,\n): Signal<T> {\n  const source = lookupScale(id, receiver);\n  if (!source) throw new TypeError(`${receiver} requires a scale ID.`);\n  // Return the provider transaction directly; an extra computed cache would hide\n  // candidate formulas during layout/reflow until the render commits.\n  if (accepts(scaleKind(source))) return source as Signal<T>;\n  let view = cache.get(source);\n  if (!view) {\n    view = computed(() => {\n      const value = source.get();\n      if (!accepts(value.type)) throw new TypeError(`${receiver} cannot read a ${value.type} scale.`);\n      return value as T;\n    });\n    cache.set(source, view);\n  }\n  return view;\n}\n"],
+  "mappings": "AAAA,SAAS,gBAA6B;AACtC,SAAS,aAAa,iBAAiB;AAGhC,SAAS,UACd,OACA,IACA,UACA,SACW;AACX,QAAM,SAAS,YAAY,IAAI,QAAQ;AACvC,MAAI,CAAC,OAAQ,OAAM,IAAI,UAAU,GAAG,QAAQ,uBAAuB;AAGnE,MAAI,QAAQ,UAAU,MAAM,CAAC,EAAG,QAAO;AACvC,MAAI,OAAO,MAAM,IAAI,MAAM;AAC3B,MAAI,CAAC,MAAM;AACT,WAAO,SAAS,MAAM;AACpB,YAAM,QAAQ,OAAO,IAAI;AACzB,UAAI,CAAC,QAAQ,MAAM,IAAI,EAAG,OAAM,IAAI,UAAU,GAAG,QAAQ,kBAAkB,MAAM,IAAI,SAAS;AAC9F,aAAO;AAAA,IACT,CAAC;AACD,UAAM,IAAI,QAAQ,IAAI;AAAA,EACxB;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/features/viz/lib/symlog-scale-component.d.ts

@@ -0,0 +1,7 @@
+import type { SymlogScaleProps } from "./types.js";
+/**
+ * Provides a named symlog mapping to descendant visualization components.
+ * @param props - Identity, domain, range, and constant. See {@link SymlogScaleProps}.
+ * @returns Descendant content within the scale scope.
+ */
+export declare function SymlogScale(props: SymlogScaleProps): import("@pibbl/core").PibblNode;

package/dist/features/viz/lib/symlog-scale-component.js

@@ -0,0 +1,19 @@
+import { resolveSignalValue, useLayoutBox } from "@pibbl/core";
+import { resolveSymlogScale } from "./symlog-scale.js";
+import { useScaleProvider } from "./scale-provider.js";
+function SymlogScale(props) {
+  const { width, height } = useLayoutBox();
+  useScaleProvider(props.id, "symlog", () => resolveSymlogScale(
+    resolveSignalValue(props.domain),
+    resolveSignalValue(props.range),
+    resolveSignalValue(props.reverse ?? false),
+    width,
+    height,
+    resolveSignalValue(props.constant ?? 1)
+  ), [props.domain, props.range, props.reverse, props.constant, width, height]);
+  return props.children;
+}
+export {
+  SymlogScale
+};
+//# sourceMappingURL=symlog-scale-component.js.map

package/dist/features/viz/lib/symlog-scale-component.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/symlog-scale-component.ts"],
+  "sourcesContent": ["import { resolveSignalValue, useLayoutBox } from \"@pibbl/core\";\nimport type { SymlogScaleProps } from \"./types.js\";\nimport { resolveSymlogScale } from \"./symlog-scale.js\";\nimport { useScaleProvider } from \"./scale-provider.js\";\n/**\n * Provides a named symlog mapping to descendant visualization components.\n * @param props - Identity, domain, range, and constant. See {@link SymlogScaleProps}.\n * @returns Descendant content within the scale scope.\n */\nexport function SymlogScale(props: SymlogScaleProps) {\n  const { width, height } = useLayoutBox();\n  useScaleProvider(props.id, \"symlog\", () => resolveSymlogScale(\n    resolveSignalValue(props.domain), resolveSignalValue(props.range),\n    resolveSignalValue(props.reverse ?? false), width, height, resolveSignalValue(props.constant ?? 1),\n  ), [props.domain, props.range, props.reverse, props.constant, width, height]);\n  return props.children;\n}\n"],
+  "mappings": "AAAA,SAAS,oBAAoB,oBAAoB;AAEjD,SAAS,0BAA0B;AACnC,SAAS,wBAAwB;AAM1B,SAAS,YAAY,OAAyB;AACnD,QAAM,EAAE,OAAO,OAAO,IAAI,aAAa;AACvC,mBAAiB,MAAM,IAAI,UAAU,MAAM;AAAA,IACzC,mBAAmB,MAAM,MAAM;AAAA,IAAG,mBAAmB,MAAM,KAAK;AAAA,IAChE,mBAAmB,MAAM,WAAW,KAAK;AAAA,IAAG;AAAA,IAAO;AAAA,IAAQ,mBAAmB,MAAM,YAAY,CAAC;AAAA,EACnG,GAAG,CAAC,MAAM,QAAQ,MAAM,OAAO,MAAM,SAAS,MAAM,UAAU,OAAO,MAAM,CAAC;AAC5E,SAAO,MAAM;AACf;",
+  "names": []
+}

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

@@ -0,0 +1,2 @@
+import type { LinearDomain, ResolvedSymlogScale, ScaleRange } from "./types.js";
+export declare function resolveSymlogScale(domain: LinearDomain, range: ScaleRange, reverse: boolean, width: number, height: number, constant: number): ResolvedSymlogScale;

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

@@ -0,0 +1,38 @@
+import { resolveLinearScale } from "./linear-scale.js";
+import { linearTicks } from "./numeric-ticks.js";
+function resolveSymlogScale(domain, range, reverse, width, height, constant) {
+  if (typeof constant !== "number" || !Number.isFinite(constant) || constant <= 0)
+    throw new RangeError("SymlogScale constant must be finite and positive.");
+  const original = resolveLinearScale(domain, range, reverse, width, height);
+  const transform = (value) => {
+    if (typeof value !== "number" || !Number.isFinite(value)) throw new RangeError("SymlogScale map input must be finite.");
+    const ratio = Math.abs(value) / constant;
+    return Math.sign(value) * (Number.isFinite(ratio) ? Math.log1p(ratio) : Math.log(Math.abs(value)) - Math.log(constant));
+  };
+  const mapping = resolveLinearScale([transform(domain[0]), transform(domain[1])], original.range, false, width, height);
+  return Object.freeze({
+    ...original,
+    type: "symlog",
+    constant,
+    map(value) {
+      return mapping.map(transform(value));
+    },
+    invert(pixel) {
+      if (mapping.range[0] !== mapping.range[1]) {
+        if (pixel === mapping.range[0]) return original.domain[0];
+        if (pixel === mapping.range[1]) return original.domain[1];
+      }
+      const t = mapping.invert(pixel), magnitude = Math.abs(t);
+      const value = Math.sign(t) * (magnitude < 700 ? constant * Math.expm1(magnitude) : Math.exp(magnitude + Math.log(constant)) - constant);
+      if (!Number.isFinite(value)) throw new RangeError("SymlogScale inverted output must be finite.");
+      return value || 0;
+    },
+    ticks(count = 5) {
+      return linearTicks(original.domain, { count });
+    }
+  });
+}
+export {
+  resolveSymlogScale
+};
+//# sourceMappingURL=symlog-scale.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/symlog-scale.ts"],
+  "sourcesContent": ["import type { LinearDomain, ResolvedSymlogScale, ScaleRange } from \"./types.js\";\nimport { resolveLinearScale } from \"./linear-scale.js\";\nimport { linearTicks } from \"./numeric-ticks.js\";\nexport function resolveSymlogScale(domain: LinearDomain, range: ScaleRange, reverse: boolean, width: number, height: number, constant: number): ResolvedSymlogScale {\n  if (typeof constant !== \"number\" || !Number.isFinite(constant) || constant <= 0)\n    throw new RangeError(\"SymlogScale constant must be finite and positive.\");\n  const original = resolveLinearScale(domain, range, reverse, width, height);\n  const transform = (value: number) => {\n    if (typeof value !== \"number\" || !Number.isFinite(value)) throw new RangeError(\"SymlogScale map input must be finite.\");\n    const ratio = Math.abs(value) / constant;\n    return Math.sign(value) * (Number.isFinite(ratio) ? Math.log1p(ratio) : Math.log(Math.abs(value)) - Math.log(constant));\n  };\n  const mapping = resolveLinearScale([transform(domain[0]), transform(domain[1])], original.range, false, width, height);\n  return Object.freeze({\n    ...original, type: \"symlog\", constant,\n    map(value: number) { return mapping.map(transform(value)); },\n    invert(pixel: number) {\n      if (mapping.range[0] !== mapping.range[1]) {\n        if (pixel === mapping.range[0]) return original.domain[0];\n        if (pixel === mapping.range[1]) return original.domain[1];\n      }\n      const t = mapping.invert(pixel), magnitude = Math.abs(t);\n      const value = Math.sign(t) * (magnitude < 700 ? constant * Math.expm1(magnitude) : Math.exp(magnitude + Math.log(constant)) - constant);\n      if (!Number.isFinite(value)) throw new RangeError(\"SymlogScale inverted output must be finite.\");\n      return value || 0;\n    },\n    ticks(count = 5) { return linearTicks(original.domain, { count }); },\n  });\n}\n"],
+  "mappings": "AACA,SAAS,0BAA0B;AACnC,SAAS,mBAAmB;AACrB,SAAS,mBAAmB,QAAsB,OAAmB,SAAkB,OAAe,QAAgB,UAAuC;AAClK,MAAI,OAAO,aAAa,YAAY,CAAC,OAAO,SAAS,QAAQ,KAAK,YAAY;AAC5E,UAAM,IAAI,WAAW,mDAAmD;AAC1E,QAAM,WAAW,mBAAmB,QAAQ,OAAO,SAAS,OAAO,MAAM;AACzE,QAAM,YAAY,CAAC,UAAkB;AACnC,QAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,EAAG,OAAM,IAAI,WAAW,uCAAuC;AACtH,UAAM,QAAQ,KAAK,IAAI,KAAK,IAAI;AAChC,WAAO,KAAK,KAAK,KAAK,KAAK,OAAO,SAAS,KAAK,IAAI,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,QAAQ;AAAA,EACvH;AACA,QAAM,UAAU,mBAAmB,CAAC,UAAU,OAAO,CAAC,CAAC,GAAG,UAAU,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,OAAO,OAAO,OAAO,MAAM;AACrH,SAAO,OAAO,OAAO;AAAA,IACnB,GAAG;AAAA,IAAU,MAAM;AAAA,IAAU;AAAA,IAC7B,IAAI,OAAe;AAAE,aAAO,QAAQ,IAAI,UAAU,KAAK,CAAC;AAAA,IAAG;AAAA,IAC3D,OAAO,OAAe;AACpB,UAAI,QAAQ,MAAM,CAAC,MAAM,QAAQ,MAAM,CAAC,GAAG;AACzC,YAAI,UAAU,QAAQ,MAAM,CAAC,EAAG,QAAO,SAAS,OAAO,CAAC;AACxD,YAAI,UAAU,QAAQ,MAAM,CAAC,EAAG,QAAO,SAAS,OAAO,CAAC;AAAA,MAC1D;AACA,YAAM,IAAI,QAAQ,OAAO,KAAK,GAAG,YAAY,KAAK,IAAI,CAAC;AACvD,YAAM,QAAQ,KAAK,KAAK,CAAC,KAAK,YAAY,MAAM,WAAW,KAAK,MAAM,SAAS,IAAI,KAAK,IAAI,YAAY,KAAK,IAAI,QAAQ,CAAC,IAAI;AAC9H,UAAI,CAAC,OAAO,SAAS,KAAK,EAAG,OAAM,IAAI,WAAW,6CAA6C;AAC/F,aAAO,SAAS;AAAA,IAClB;AAAA,IACA,MAAM,QAAQ,GAAG;AAAE,aAAO,YAAY,SAAS,QAAQ,EAAE,MAAM,CAAC;AAAA,IAAG;AAAA,EACrE,CAAC;AACH;",
+  "names": []
+}