@pibbl/core 0.0.1 → 0.0.3-alpha.85.1

package/dist/features/viz/lib/line-series.js

@@ -1,11 +1,17 @@
 import { jsx } from "@pibbl/core/jsx-runtime";
 import { Path, resolveSignalValue } from "@pibbl/core";
 import { useInternalValueMemoSlot } from "@pibbl/core/internal";
-import { useScale } from "./use-scale.js";
+import {
+  appendCurveForward,
+  curveGeometry,
+  resolveSeriesCurve
+} from "./curve-definition.js";
+import {
+  useSeriesPosition,
+  seriesAccessor,
+  mapSeriesPosition
+} from "./series-position.js";
 import { width, opacity } from "./paint.js";
-function accessor(input) {
-  return typeof input === "function" ? input : (datum) => datum[input];
-}
 function LineSeries({
   data: dataInput,
   x: xInput,
@@ -13,20 +19,24 @@ function LineSeries({
   xScale: xId,
   yScale: yId,
   defined,
+  inspection,
   curve,
   style: styleInput,
   ...eventProps
 }) {
-  const xScale = useScale(xId).get();
-  const yScale = useScale(yId).get();
-  const x = useInternalValueMemoSlot("vizXAccessor", () => accessor(xInput), [
-    xInput
-  ]);
-  const y = useInternalValueMemoSlot("vizYAccessor", () => accessor(yInput), [
-    yInput
-  ]);
-  if (curve !== void 0 && curve !== "linear")
-    throw new TypeError('LineSeries supports curve="linear" only.');
+  const xScale = useSeriesPosition(xId);
+  const yScale = useSeriesPosition(yId);
+  const x = useInternalValueMemoSlot(
+    "vizXAccessor",
+    () => seriesAccessor(xInput),
+    [xInput]
+  );
+  const y = useInternalValueMemoSlot(
+    "vizYAccessor",
+    () => seriesAccessor(yInput),
+    [yInput]
+  );
+  const curveDefinition = resolveSeriesCurve(curve);
   const data = resolveSignalValue(dataInput);
   if (!Array.isArray(data))
     throw new TypeError(
@@ -45,29 +55,38 @@ function LineSeries({
     "LineSeries"
   );
   const path = new Path2D();
-  let previous;
-  let inRun = false;
+  const captured = inspection ? [] : void 0;
+  let runId = 0;
+  if (inspection && (xScale.type === "point" || yScale.type === "point")) throw new TypeError("Numeric line inspection requires numeric continuous scales.");
+  let run = [];
+  const flushRun = () => {
+    if (run.length >= 2) {
+      const geometry = curveGeometry(curveDefinition, run);
+      path.moveTo(geometry.start[0], geometry.start[1]);
+      appendCurveForward(path, geometry);
+    }
+    run = [];
+  };
   for (let i = 0; i < data.length; i++) {
     const datum = data[i];
     if (defined && !defined(datum, i, data)) {
-      previous = void 0;
-      inRun = false;
+      flushRun();
+      runId++;
       continue;
     }
     const xv = x(datum, i, data), yv = y(datum, i, data);
-    if (typeof xv !== "number" || typeof yv !== "number" || !Number.isFinite(xv) || !Number.isFinite(yv)) {
-      previous = void 0;
-      inRun = false;
+    const px = mapSeriesPosition(xScale, xv), py = mapSeriesPosition(yScale, yv);
+    if (px === void 0 || py === void 0) {
+      flushRun();
+      runId++;
       continue;
     }
-    const point = [xScale.map(xv), yScale.map(yv)];
-    if (previous) {
-      if (!inRun) path.moveTo(previous[0], previous[1]);
-      path.lineTo(point[0], point[1]);
-      inRun = true;
-    }
-    previous = point;
+    captured?.push(Object.freeze({ datum, sourceIndex: i, domainX: xv, domainY: yv, anchorLocal: Object.freeze({ x: px, y: py }), run: runId }));
+    const point = [px, py];
+    run.push(point);
   }
+  flushRun();
+  if (inspection && xScale.type !== "point" && yScale.type !== "point") inspection.capture({ observations: captured, xScale, yScale });
   return /* @__PURE__ */ jsx(
     Path,
     {

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/viz/lib/line-series.tsx"],
-  "sourcesContent": ["import { Path, resolveSignalValue } from \"@pibbl/core\";\nimport { useInternalValueMemoSlot } from \"@pibbl/core/internal\";\nimport type { LineAccessor, LineCoordinate, LineSeriesProps } from \"./types.js\";\nimport { useScale } from \"./use-scale.js\";\nimport { width, opacity } from \"./paint.js\";\nfunction accessor<D>(\n  input: LineAccessor<D>,\n): (datum: D, index: number, data: readonly D[]) => LineCoordinate {\n  return typeof input === \"function\"\n    ? input\n    : (datum) => datum[input] as LineCoordinate;\n}\n/**\n * Draws a scaled line through defined data values, leaving gaps for undefined values.\n *\n * @param props - Data, coordinate accessors, scales, and line styling. See {@link LineSeriesProps}\n * .\n * @returns Pibbl nodes drawing the data as a line series.\n *\n * @see {@link LineSeriesProps}\n */\nexport function LineSeries<D>({\n  data: dataInput,\n  x: xInput,\n  y: yInput,\n  xScale: xId,\n  yScale: yId,\n  defined,\n  curve,\n  style: styleInput,\n  ...eventProps\n}: LineSeriesProps<D>) {\n  const xScale = useScale(xId).get();\n  const yScale = useScale(yId).get();\n  const x = useInternalValueMemoSlot(\"vizXAccessor\", () => accessor(xInput), [\n    xInput,\n  ]);\n  const y = useInternalValueMemoSlot(\"vizYAccessor\", () => accessor(yInput), [\n    yInput,\n  ]);\n  if (curve !== undefined && curve !== \"linear\")\n    throw new TypeError('LineSeries supports curve=\"linear\" only.');\n  const data = resolveSignalValue(dataInput);\n  if (!Array.isArray(data))\n    throw new TypeError(\n      \"LineSeries data must be an array or a signal containing an array.\",\n    );\n  const style = resolveSignalValue(styleInput) ?? {};\n  const stroke = resolveSignalValue(style.stroke) ?? \"#2563eb\";\n  const strokeWidth = width(\n    resolveSignalValue(style.strokeWidth) ?? 2,\n    \"LineSeries\",\n  );\n  const alpha = opacity(resolveSignalValue(style.opacity) ?? 1, \"LineSeries\");\n  const cursor = resolveSignalValue(style.cursor);\n  const lineInteractionWidth = width(\n    resolveSignalValue(style.lineInteractionWidth) ?? strokeWidth,\n    \"LineSeries\",\n  );\n  const path = new Path2D();\n  let previous: readonly [number, number] | undefined;\n  let inRun = false;\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !defined(datum, i, data)) {\n      previous = undefined;\n      inRun = false;\n      continue;\n    }\n    const xv = x(datum, i, data),\n      yv = y(datum, i, data);\n    if (\n      typeof xv !== \"number\" ||\n      typeof yv !== \"number\" ||\n      !Number.isFinite(xv) ||\n      !Number.isFinite(yv)\n    ) {\n      previous = undefined;\n      inRun = false;\n      continue;\n    }\n    const point = [xScale.map(xv), yScale.map(yv)] as const;\n    if (previous) {\n      if (!inRun) path.moveTo(previous[0], previous[1]);\n      path.lineTo(point[0], point[1]);\n      inRun = true;\n    }\n    previous = point;\n  }\n  return (\n    <Path\n      {...eventProps}\n      style={{\n        d: path,\n        stroke,\n        strokeWidth,\n        opacity: alpha,\n        cursor,\n        lineInteractionWidth,\n      }}\n    />\n  );\n}\n"],
-  "mappings": "AA0FI;AA1FJ,SAAS,MAAM,0BAA0B;AACzC,SAAS,gCAAgC;AAEzC,SAAS,gBAAgB;AACzB,SAAS,OAAO,eAAe;AAC/B,SAAS,SACP,OACiE;AACjE,SAAO,OAAO,UAAU,aACpB,QACA,CAAC,UAAU,MAAM,KAAK;AAC5B;AAUO,SAAS,WAAc;AAAA,EAC5B,MAAM;AAAA,EACN,GAAG;AAAA,EACH,GAAG;AAAA,EACH,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP,GAAG;AACL,GAAuB;AACrB,QAAM,SAAS,SAAS,GAAG,EAAE,IAAI;AACjC,QAAM,SAAS,SAAS,GAAG,EAAE,IAAI;AACjC,QAAM,IAAI,yBAAyB,gBAAgB,MAAM,SAAS,MAAM,GAAG;AAAA,IACzE;AAAA,EACF,CAAC;AACD,QAAM,IAAI,yBAAyB,gBAAgB,MAAM,SAAS,MAAM,GAAG;AAAA,IACzE;AAAA,EACF,CAAC;AACD,MAAI,UAAU,UAAa,UAAU;AACnC,UAAM,IAAI,UAAU,0CAA0C;AAChE,QAAM,OAAO,mBAAmB,SAAS;AACzC,MAAI,CAAC,MAAM,QAAQ,IAAI;AACrB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,QAAM,QAAQ,mBAAmB,UAAU,KAAK,CAAC;AACjD,QAAM,SAAS,mBAAmB,MAAM,MAAM,KAAK;AACnD,QAAM,cAAc;AAAA,IAClB,mBAAmB,MAAM,WAAW,KAAK;AAAA,IACzC;AAAA,EACF;AACA,QAAM,QAAQ,QAAQ,mBAAmB,MAAM,OAAO,KAAK,GAAG,YAAY;AAC1E,QAAM,SAAS,mBAAmB,MAAM,MAAM;AAC9C,QAAM,uBAAuB;AAAA,IAC3B,mBAAmB,MAAM,oBAAoB,KAAK;AAAA,IAClD;AAAA,EACF;AACA,QAAM,OAAO,IAAI,OAAO;AACxB,MAAI;AACJ,MAAI,QAAQ;AACZ,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,QAAQ,KAAK,CAAC;AACpB,QAAI,WAAW,CAAC,QAAQ,OAAO,GAAG,IAAI,GAAG;AACvC,iBAAW;AACX,cAAQ;AACR;AAAA,IACF;AACA,UAAM,KAAK,EAAE,OAAO,GAAG,IAAI,GACzB,KAAK,EAAE,OAAO,GAAG,IAAI;AACvB,QACE,OAAO,OAAO,YACd,OAAO,OAAO,YACd,CAAC,OAAO,SAAS,EAAE,KACnB,CAAC,OAAO,SAAS,EAAE,GACnB;AACA,iBAAW;AACX,cAAQ;AACR;AAAA,IACF;AACA,UAAM,QAAQ,CAAC,OAAO,IAAI,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;AAC7C,QAAI,UAAU;AACZ,UAAI,CAAC,MAAO,MAAK,OAAO,SAAS,CAAC,GAAG,SAAS,CAAC,CAAC;AAChD,WAAK,OAAO,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;AAC9B,cAAQ;AAAA,IACV;AACA,eAAW;AAAA,EACb;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,OAAO;AAAA,QACL,GAAG;AAAA,QACH;AAAA,QACA;AAAA,QACA,SAAS;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA;AAAA,EACF;AAEJ;",
+  "sourcesContent": ["import { Path, resolveSignalValue } from \"@pibbl/core\";\nimport { useInternalValueMemoSlot } from \"@pibbl/core/internal\";\nimport type { LineSeriesProps } from \"./types.js\";\nimport {\n  appendCurveForward,\n  curveGeometry,\n  resolveSeriesCurve,\n} from \"./curve-definition.js\";\nimport {\n  useSeriesPosition,\n  seriesAccessor,\n  mapSeriesPosition,\n} from \"./series-position.js\";\nimport { width, opacity } from \"./paint.js\";\n/**\n * Draws a scaled line through defined data values, leaving gaps for undefined values.\n *\n * @param props - Data, coordinate accessors, scales, and line styling. See {@link LineSeriesProps}\n * .\n * @returns Pibbl nodes drawing the data as a line series.\n *\n * @see {@link LineSeriesProps}\n */\nexport function LineSeries<D>({\n  data: dataInput,\n  x: xInput,\n  y: yInput,\n  xScale: xId,\n  yScale: yId,\n  defined,\n  inspection,\n  curve,\n  style: styleInput,\n  ...eventProps\n}: LineSeriesProps<D>) {\n  const xScale = useSeriesPosition(xId);\n  const yScale = useSeriesPosition(yId);\n  const x = useInternalValueMemoSlot(\n    \"vizXAccessor\",\n    () => seriesAccessor(xInput),\n    [xInput],\n  );\n  const y = useInternalValueMemoSlot(\n    \"vizYAccessor\",\n    () => seriesAccessor(yInput),\n    [yInput],\n  );\n  const curveDefinition = resolveSeriesCurve(curve);\n  const data = resolveSignalValue(dataInput);\n  if (!Array.isArray(data))\n    throw new TypeError(\n      \"LineSeries data must be an array or a signal containing an array.\",\n    );\n  const style = resolveSignalValue(styleInput) ?? {};\n  const stroke = resolveSignalValue(style.stroke) ?? \"#2563eb\";\n  const strokeWidth = width(\n    resolveSignalValue(style.strokeWidth) ?? 2,\n    \"LineSeries\",\n  );\n  const alpha = opacity(resolveSignalValue(style.opacity) ?? 1, \"LineSeries\");\n  const cursor = resolveSignalValue(style.cursor);\n  const lineInteractionWidth = width(\n    resolveSignalValue(style.lineInteractionWidth) ?? strokeWidth,\n    \"LineSeries\",\n  );\n  const path = new Path2D();\n  const captured: import(\"../inspection/capture-types.js\").CapturedNumericObservation<D>[] | undefined = inspection ? [] : undefined;\n  let runId = 0;\n  if (inspection && (xScale.type === \"point\" || yScale.type === \"point\")) throw new TypeError(\"Numeric line inspection requires numeric continuous scales.\");\n  let run: (readonly [number, number])[] = [];\n  const flushRun = () => {\n    if (run.length >= 2) {\n      const geometry = curveGeometry(curveDefinition, run);\n      path.moveTo(geometry.start[0], geometry.start[1]);\n      appendCurveForward(path, geometry);\n    }\n    run = [];\n  };\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !defined(datum, i, data)) {\n      flushRun();\n      runId++;\n      continue;\n    }\n    const xv = x(datum, i, data),\n      yv = y(datum, i, data);\n    const px = mapSeriesPosition(xScale, xv),\n      py = mapSeriesPosition(yScale, yv);\n    if (px === undefined || py === undefined) {\n      flushRun();\n      runId++;\n      continue;\n    }\n    captured?.push(Object.freeze({datum,sourceIndex:i,domainX:xv as number,domainY:yv as number,anchorLocal:Object.freeze({x:px,y:py}),run:runId}));\n    const point = [px, py] as const;\n    run.push(point);\n  }\n  flushRun();\n  if (inspection && xScale.type !== \"point\" && yScale.type !== \"point\") inspection.capture({observations:captured!,xScale,yScale});\n  return (\n    <Path\n      {...eventProps}\n      style={{\n        d: path,\n        stroke,\n        strokeWidth,\n        opacity: alpha,\n        cursor,\n        lineInteractionWidth,\n      }}\n    />\n  );\n}\n"],
+  "mappings": "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",
   "names": []
 }

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

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

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

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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/linear-scale-component.ts"],
+  "sourcesContent": ["import { resolveSignalValue, useLayoutBox } from \"@pibbl/core\";\nimport type { LinearScaleProps } from \"./types.js\";\nimport { resolveLinearScale } from \"./linear-scale.js\";\nimport { useScaleProvider } from \"./scale-provider.js\";\n/**\n * Provides a named linear mapping to descendant visualization components.\n * @param props - Identity, domain, range, and children. See {@link LinearScaleProps}.\n * @returns Descendant content within the scale scope.\n */\nexport function LinearScale(props: LinearScaleProps) {\n  const { width, height } = useLayoutBox();\n  useScaleProvider(props.id, \"linear\", () => resolveLinearScale(\n    resolveSignalValue(props.domain), resolveSignalValue(props.range),\n    resolveSignalValue(props.reverse ?? false), width, height,\n  ), [props.domain, props.range, props.reverse, 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,EACrD,GAAG,CAAC,MAAM,QAAQ,MAAM,OAAO,MAAM,SAAS,OAAO,MAAM,CAAC;AAC5D,SAAO,MAAM;AACf;",
+  "names": []
+}

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

@@ -61,7 +61,7 @@ function resolveLinearScale(domainInput, rangeInput, reverse, width, height) {
   });
 }
 function equalScale(a, b) {
-  return a.type === b.type && a.domain.length === b.domain.length && a.domain.every((value, index) => Object.is(value, b.domain[index])) && (a.type !== "band" || b.type === "band" && a.bandwidth === b.bandwidth && a.step === b.step) && Object.is(a.range[0], b.range[0]) && Object.is(a.range[1], b.range[1]) && Object.is(a.frame.width, b.frame.width) && Object.is(a.frame.height, b.frame.height);
+  return a.type === b.type && (a.type !== "trading-time" || b.type === "trading-time" && a.logicalRange.every((v, i) => v === b.logicalRange[i])) && (a.type !== "symlog" || b.type === "symlog" && a.constant === b.constant) && (a.type !== "point" || b.type === "point" && a.padding === b.padding) && (a.type !== "log" || b.type === "log" && a.base === b.base) && a.domain.length === b.domain.length && a.domain.every((value, index) => Object.is(value, b.domain[index])) && (a.type !== "band" || b.type === "band" && a.bandwidth === b.bandwidth && a.step === b.step) && Object.is(a.range[0], b.range[0]) && Object.is(a.range[1], b.range[1]) && Object.is(a.frame.width, b.frame.width) && Object.is(a.frame.height, b.frame.height);
 }
 export {
   equalScale,

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

@@ -1,7 +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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",
+  "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.type !== \"trading-time\" ||\n      (b.type === \"trading-time\" &&\n        a.logicalRange.every((v, i) => v === b.logicalRange[i]))) &&\n    (a.type !== \"symlog\" ||\n      (b.type === \"symlog\" && a.constant === b.constant)) &&\n    (a.type !== \"point\" || (b.type === \"point\" && a.padding === b.padding)) &&\n    (a.type !== \"log\" || (b.type === \"log\" && a.base === b.base)) &&\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": "AAMA,SAAS,OAAO,OAAe,OAAuB;AACpD,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK;AACrD,UAAM,IAAI,WAAW,SAAS,KAAK,kBAAkB;AACvD,SAAO;AACT;AACA,SAAS,KACP,OACA,OAC2B;AAC3B,MAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,WAAW;AAC5C,UAAM,IAAI,WAAW,SAAS,KAAK,iCAAiC;AACtE,SAAO,OAAO,OAAO,CAAC,OAAO,MAAM,CAAC,GAAG,KAAK,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC;AACzE;AACO,SAAS,mBACd,aACA,YACA,SACA,OACA,QACqB;AACrB,SAAO,OAAO,aAAa;AAC3B,SAAO,QAAQ,cAAc;AAC7B,MAAI,QAAQ,KAAK,SAAS;AACxB,UAAM,IAAI,WAAW,uCAAuC;AAC9D,MAAI,OAAO,YAAY;AACrB,UAAM,IAAI,UAAU,gCAAgC;AACtD,QAAM,SAAS,KAAK,aAAa,QAAQ;AACzC,MAAI,OAAO,CAAC,MAAM,OAAO,CAAC;AACxB,UAAM,IAAI,WAAW,qCAAqC;AAC5D,QAAM,WAAW;AAAA,IACf,eAAe,UACX,CAAC,GAAG,KAAK,IACT,eAAe,WACb,CAAC,GAAG,MAAM,IACT;AAAA,IACP;AAAA,EACF;AACA,QAAM,QAAQ,UAAU,KAAK,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,OAAO,IAAI;AACpE,QAAM,aAAa,OAAO,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,aAAa;AAC9D,QAAM,YAAY,OAAO,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,YAAY;AAC1D,SAAO,OAAO,OAAO;AAAA,IACnB,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA,OAAO,OAAO,OAAO,EAAE,GAAG,GAAG,GAAG,GAAG,OAAO,OAAO,CAAC;AAAA,IAClD,IAAI,OAAe;AACjB,aAAO;AAAA,QACL,MAAM,CAAC,KACH,OAAO,OAAO,WAAW,IAAI,OAAO,CAAC,KAAK,aAAc;AAAA,QAC5D;AAAA,MACF;AAAA,IACF;AAAA,IACA,OAAO,OAAe;AACpB,UAAI,cAAc;AAChB,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AACF,aAAO;AAAA,QACL,OAAO,CAAC,KACJ,OAAO,OAAO,cAAc,IAAI,MAAM,CAAC,KAAK,YAAa;AAAA,QAC7D;AAAA,MACF;AAAA,IACF;AAAA,IACA,MAAM,QAAQ,GAAG;AACf,UAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,KAAK,QAAQ;AACnD,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AACF,aAAO,OAAO;AAAA,QACZ,MAAM;AAAA,UAAK,EAAE,QAAQ,MAAM;AAAA,UAAG,CAAC,GAAG,MAChC,MAAM,QAAQ,IACV,OAAO,CAAC,IACR,OAAO,OAAO,CAAC,IAAK,aAAa,KAAM,QAAQ,IAAI,MAAM;AAAA,QAC/D;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAC;AACH;AACO,SAAS,WAAW,GAAkB,GAA2B;AACtE,SACE,EAAE,SAAS,EAAE,SACZ,EAAE,SAAS,kBACT,EAAE,SAAS,kBACV,EAAE,aAAa,MAAM,CAAC,GAAG,MAAM,MAAM,EAAE,aAAa,CAAC,CAAC,OACzD,EAAE,SAAS,YACT,EAAE,SAAS,YAAY,EAAE,aAAa,EAAE,cAC1C,EAAE,SAAS,WAAY,EAAE,SAAS,WAAW,EAAE,YAAY,EAAE,aAC7D,EAAE,SAAS,SAAU,EAAE,SAAS,SAAS,EAAE,SAAS,EAAE,SACvD,EAAE,OAAO,WAAW,EAAE,OAAO,UAC7B,EAAE,OAAO,MAAM,CAAC,OAAO,UAAU,OAAO,GAAG,OAAO,EAAE,OAAO,KAAK,CAAC,CAAC,MACjE,EAAE,SAAS,UACT,EAAE,SAAS,UACV,EAAE,cAAc,EAAE,aAClB,EAAE,SAAS,EAAE,SACjB,OAAO,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,KAChC,OAAO,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,KAChC,OAAO,GAAG,EAAE,MAAM,OAAO,EAAE,MAAM,KAAK,KACtC,OAAO,GAAG,EAAE,MAAM,QAAQ,EAAE,MAAM,MAAM;AAE5C;",
   "names": []
 }

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

@@ -0,0 +1,7 @@
+import type { LogScaleProps } from "./types.js";
+/**
+ * Provides a named positive logarithmic mapping to descendant marks and axes.
+ * @param props - Identity, positive domain, range, and optional tick base. See {@link LogScaleProps}.
+ * @returns Descendant content within the logarithmic scale scope.
+ */
+export declare function LogScale(props: LogScaleProps): import("@pibbl/core").PibblNode;

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

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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/log-scale-component.ts"],
+  "sourcesContent": ["import { resolveSignalValue, useLayoutBox } from \"@pibbl/core\";\nimport type { LogScaleProps } from \"./types.js\";\nimport { resolveLogScale } from \"./log-scale.js\";\nimport { useScaleProvider } from \"./scale-provider.js\";\n/**\n * Provides a named positive logarithmic mapping to descendant marks and axes.\n * @param props - Identity, positive domain, range, and optional tick base. See {@link LogScaleProps}.\n * @returns Descendant content within the logarithmic scale scope.\n */\nexport function LogScale(props: LogScaleProps) {\n  const { width, height } = useLayoutBox();\n  useScaleProvider(props.id, \"log\", () => resolveLogScale(\n    resolveSignalValue(props.domain), resolveSignalValue(props.range),\n    resolveSignalValue(props.reverse ?? false), width, height, resolveSignalValue(props.base ?? 10),\n  ), [props.domain, props.range, props.reverse, props.base, width, height]);\n  return props.children;\n}\n"],
+  "mappings": "AAAA,SAAS,oBAAoB,oBAAoB;AAEjD,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AAM1B,SAAS,SAAS,OAAsB;AAC7C,QAAM,EAAE,OAAO,OAAO,IAAI,aAAa;AACvC,mBAAiB,MAAM,IAAI,OAAO,MAAM;AAAA,IACtC,mBAAmB,MAAM,MAAM;AAAA,IAAG,mBAAmB,MAAM,KAAK;AAAA,IAChE,mBAAmB,MAAM,WAAW,KAAK;AAAA,IAAG;AAAA,IAAO;AAAA,IAAQ,mBAAmB,MAAM,QAAQ,EAAE;AAAA,EAChG,GAAG,CAAC,MAAM,QAAQ,MAAM,OAAO,MAAM,SAAS,MAAM,MAAM,OAAO,MAAM,CAAC;AACxE,SAAO,MAAM;AACf;",
+  "names": []
+}

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

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

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

@@ -0,0 +1,53 @@
+import { resolveLinearScale } from "./linear-scale.js";
+function positive(value, field) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value <= 0)
+    throw new RangeError(`LogScale ${field} must be finite and positive.`);
+  return value;
+}
+function resolveLogScale(domainInput, range, reverse, width, height, base) {
+  if (typeof base !== "number" || !Number.isFinite(base) || base <= 1)
+    throw new RangeError("LogScale base must be finite and greater than one.");
+  if (!Array.isArray(domainInput) || domainInput.length !== 2)
+    throw new RangeError("LogScale domain requires two positive endpoints.");
+  const domain = Object.freeze([positive(domainInput[0], "domain"), positive(domainInput[1], "domain")]);
+  const logarithm = (value) => Math.log(positive(value, "map input"));
+  const mapping = resolveLinearScale([logarithm(domain[0]), logarithm(domain[1])], range, reverse, width, height);
+  return Object.freeze({
+    ...mapping,
+    type: "log",
+    domain,
+    base,
+    map(value) {
+      return mapping.map(logarithm(value));
+    },
+    invert(pixel) {
+      if (pixel === mapping.range[0] && mapping.range[0] !== mapping.range[1]) return domain[0];
+      if (pixel === mapping.range[1] && mapping.range[0] !== mapping.range[1]) return domain[1];
+      return positive(Math.exp(mapping.invert(pixel)), "inverted output");
+    },
+    ticks(count = 5) {
+      if (!Number.isInteger(count) || count < 2 || count > 100)
+        throw new RangeError("LogScale ticks count must be an integer from 2 to 100.");
+      if (count === 2) return Object.freeze([...domain]);
+      const lo = Math.min(...domain), hi = Math.max(...domain);
+      const first = Math.floor(Math.log(lo) / Math.log(base)) + 1;
+      const last = Math.ceil(Math.log(hi) / Math.log(base)) - 1;
+      if (!Number.isSafeInteger(first) || !Number.isSafeInteger(last))
+        throw new RangeError("LogScale tick exponents exceed numeric precision; choose a larger base.");
+      const stride = Math.max(1, Math.ceil((last - first + 1) / (count - 2)));
+      const ticks = [lo];
+      for (let i = 0; i < count - 2; i++) {
+        const exponent = first + i * stride;
+        if (exponent > last) break;
+        const value = base ** exponent;
+        if (Number.isFinite(value) && value > ticks[ticks.length - 1] && value < hi) ticks.push(value);
+      }
+      ticks.push(hi);
+      return Object.freeze(domain[0] > domain[1] ? ticks.reverse() : ticks);
+    }
+  });
+}
+export {
+  resolveLogScale
+};
+//# sourceMappingURL=log-scale.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/log-scale.ts"],
+  "sourcesContent": ["import type { LinearDomain, ResolvedLogScale, ScaleRange } from \"./types.js\";\nimport { resolveLinearScale } from \"./linear-scale.js\";\nfunction positive(value: number, field: string): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0)\n    throw new RangeError(`LogScale ${field} must be finite and positive.`);\n  return value;\n}\nexport function resolveLogScale(domainInput: LinearDomain, range: ScaleRange, reverse: boolean, width: number, height: number, base: number): ResolvedLogScale {\n  if (typeof base !== \"number\" || !Number.isFinite(base) || base <= 1)\n    throw new RangeError(\"LogScale base must be finite and greater than one.\");\n  if (!Array.isArray(domainInput) || domainInput.length !== 2)\n    throw new RangeError(\"LogScale domain requires two positive endpoints.\");\n  const domain = Object.freeze([positive(domainInput[0], \"domain\"), positive(domainInput[1], \"domain\")] as const);\n  const logarithm = (value: number) => Math.log(positive(value, \"map input\"));\n  const mapping = resolveLinearScale([logarithm(domain[0]), logarithm(domain[1])], range, reverse, width, height);\n  return Object.freeze({\n    ...mapping, type: \"log\", domain, base,\n    map(value: number) { return mapping.map(logarithm(value)); },\n    invert(pixel: number) {\n      if (pixel === mapping.range[0] && mapping.range[0] !== mapping.range[1]) return domain[0];\n      if (pixel === mapping.range[1] && mapping.range[0] !== mapping.range[1]) return domain[1];\n      return positive(Math.exp(mapping.invert(pixel)), \"inverted output\");\n    },\n    ticks(count = 5) {\n      if (!Number.isInteger(count) || count < 2 || count > 100)\n        throw new RangeError(\"LogScale ticks count must be an integer from 2 to 100.\");\n      if (count === 2) return Object.freeze([...domain]);\n      const lo = Math.min(...domain), hi = Math.max(...domain);\n      const first = Math.floor(Math.log(lo) / Math.log(base)) + 1;\n      const last = Math.ceil(Math.log(hi) / Math.log(base)) - 1;\n      if (!Number.isSafeInteger(first) || !Number.isSafeInteger(last))\n        throw new RangeError(\"LogScale tick exponents exceed numeric precision; choose a larger base.\");\n      const stride = Math.max(1, Math.ceil((last - first + 1) / (count - 2)));\n      const ticks: number[] = [lo];\n      for (let i = 0; i < count - 2; i++) {\n        const exponent = first + i * stride;\n        if (exponent > last) break;\n        const value = base ** exponent;\n        if (Number.isFinite(value) && value > ticks[ticks.length - 1] && value < hi) ticks.push(value);\n      }\n      ticks.push(hi);\n      return Object.freeze(domain[0] > domain[1] ? ticks.reverse() : ticks);\n    },\n  });\n}\n"],
+  "mappings": "AACA,SAAS,0BAA0B;AACnC,SAAS,SAAS,OAAe,OAAuB;AACtD,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,KAAK,SAAS;AACnE,UAAM,IAAI,WAAW,YAAY,KAAK,+BAA+B;AACvE,SAAO;AACT;AACO,SAAS,gBAAgB,aAA2B,OAAmB,SAAkB,OAAe,QAAgB,MAAgC;AAC7J,MAAI,OAAO,SAAS,YAAY,CAAC,OAAO,SAAS,IAAI,KAAK,QAAQ;AAChE,UAAM,IAAI,WAAW,oDAAoD;AAC3E,MAAI,CAAC,MAAM,QAAQ,WAAW,KAAK,YAAY,WAAW;AACxD,UAAM,IAAI,WAAW,kDAAkD;AACzE,QAAM,SAAS,OAAO,OAAO,CAAC,SAAS,YAAY,CAAC,GAAG,QAAQ,GAAG,SAAS,YAAY,CAAC,GAAG,QAAQ,CAAC,CAAU;AAC9G,QAAM,YAAY,CAAC,UAAkB,KAAK,IAAI,SAAS,OAAO,WAAW,CAAC;AAC1E,QAAM,UAAU,mBAAmB,CAAC,UAAU,OAAO,CAAC,CAAC,GAAG,UAAU,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,SAAS,OAAO,MAAM;AAC9G,SAAO,OAAO,OAAO;AAAA,IACnB,GAAG;AAAA,IAAS,MAAM;AAAA,IAAO;AAAA,IAAQ;AAAA,IACjC,IAAI,OAAe;AAAE,aAAO,QAAQ,IAAI,UAAU,KAAK,CAAC;AAAA,IAAG;AAAA,IAC3D,OAAO,OAAe;AACpB,UAAI,UAAU,QAAQ,MAAM,CAAC,KAAK,QAAQ,MAAM,CAAC,MAAM,QAAQ,MAAM,CAAC,EAAG,QAAO,OAAO,CAAC;AACxF,UAAI,UAAU,QAAQ,MAAM,CAAC,KAAK,QAAQ,MAAM,CAAC,MAAM,QAAQ,MAAM,CAAC,EAAG,QAAO,OAAO,CAAC;AACxF,aAAO,SAAS,KAAK,IAAI,QAAQ,OAAO,KAAK,CAAC,GAAG,iBAAiB;AAAA,IACpE;AAAA,IACA,MAAM,QAAQ,GAAG;AACf,UAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,KAAK,QAAQ;AACnD,cAAM,IAAI,WAAW,wDAAwD;AAC/E,UAAI,UAAU,EAAG,QAAO,OAAO,OAAO,CAAC,GAAG,MAAM,CAAC;AACjD,YAAM,KAAK,KAAK,IAAI,GAAG,MAAM,GAAG,KAAK,KAAK,IAAI,GAAG,MAAM;AACvD,YAAM,QAAQ,KAAK,MAAM,KAAK,IAAI,EAAE,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI;AAC1D,YAAM,OAAO,KAAK,KAAK,KAAK,IAAI,EAAE,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI;AACxD,UAAI,CAAC,OAAO,cAAc,KAAK,KAAK,CAAC,OAAO,cAAc,IAAI;AAC5D,cAAM,IAAI,WAAW,yEAAyE;AAChG,YAAM,SAAS,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,QAAQ,MAAM,QAAQ,EAAE,CAAC;AACtE,YAAM,QAAkB,CAAC,EAAE;AAC3B,eAAS,IAAI,GAAG,IAAI,QAAQ,GAAG,KAAK;AAClC,cAAM,WAAW,QAAQ,IAAI;AAC7B,YAAI,WAAW,KAAM;AACrB,cAAM,QAAQ,QAAQ;AACtB,YAAI,OAAO,SAAS,KAAK,KAAK,QAAQ,MAAM,MAAM,SAAS,CAAC,KAAK,QAAQ,GAAI,OAAM,KAAK,KAAK;AAAA,MAC/F;AACA,YAAM,KAAK,EAAE;AACb,aAAO,OAAO,OAAO,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,MAAM,QAAQ,IAAI,KAAK;AAAA,IACtE;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}

package/dist/features/viz/lib/monotone-curve.d.ts

@@ -0,0 +1,11 @@
+import { type SeriesCurve } from "./curve-definition.js";
+/**
+ * Returns the immutable monotone-X cubic Hermite definition.
+ *
+ * It uses weighted harmonic interior slopes and limited one-sided endpoint slopes, preserving every observation,
+ * flat segment, and local extremum without sorting data. Each run must have strictly ascending
+ * or strictly descending x coordinates.
+ *
+ * @returns The named {@link SeriesCurve} definition.
+ */
+export declare function monotoneX(): SeriesCurve;

package/dist/features/viz/lib/monotone-curve.js

@@ -0,0 +1,63 @@
+import {
+  createSeriesCurve
+} from "./curve-definition.js";
+function endpointSlope(h0, h1, first, second) {
+  let slope = ((2 * h0 + h1) * first - h0 * second) / (h0 + h1);
+  if (Math.sign(slope) !== Math.sign(first)) return 0;
+  if (Math.sign(first) !== Math.sign(second) && Math.abs(slope) > Math.abs(3 * first))
+    slope = 3 * first;
+  return slope;
+}
+function monotoneSegments(points) {
+  if (points.length < 2) return [];
+  const direction = points[1][0] > points[0][0] ? 1 : -1;
+  const x = points.map((point) => direction * point[0]);
+  const h = [];
+  const delta = [];
+  for (let i = 0; i < points.length - 1; i++) {
+    const width = x[i + 1] - x[i];
+    if (!Number.isFinite(width) || width <= 0)
+      throw new RangeError(
+        "monotoneX requires strictly ascending or descending finite x coordinates."
+      );
+    h.push(width);
+    delta.push((points[i + 1][1] - points[i][1]) / width);
+  }
+  const slopes = new Array(points.length);
+  if (points.length === 2) slopes[0] = slopes[1] = delta[0];
+  else {
+    slopes[0] = endpointSlope(h[0], h[1], delta[0], delta[1]);
+    slopes[points.length - 1] = endpointSlope(
+      h.at(-1),
+      h.at(-2),
+      delta.at(-1),
+      delta.at(-2)
+    );
+    for (let i = 1; i < points.length - 1; i++) {
+      const previous = delta[i - 1], next = delta[i];
+      slopes[i] = previous === 0 || next === 0 || Math.sign(previous) !== Math.sign(next) ? 0 : 3 * (h[i - 1] + h[i]) / ((2 * h[i] + h[i - 1]) / previous + (h[i] + 2 * h[i - 1]) / next);
+    }
+  }
+  return points.slice(1).map((end, index) => {
+    const start = points[index], width = h[index];
+    const control1 = [
+      start[0] + (end[0] - start[0]) / 3,
+      start[1] + slopes[index] * width / 3
+    ];
+    const control2 = [
+      end[0] - (end[0] - start[0]) / 3,
+      end[1] - slopes[index + 1] * width / 3
+    ];
+    if (![...control1, ...control2, ...end].every(Number.isFinite))
+      throw new RangeError("monotoneX generated non-finite cubic controls.");
+    return Object.freeze({ end, control1, control2 });
+  });
+}
+const monotone = /* @__PURE__ */ createSeriesCurve(monotoneSegments);
+function monotoneX() {
+  return monotone;
+}
+export {
+  monotoneX
+};
+//# sourceMappingURL=monotone-curve.js.map

package/dist/features/viz/lib/monotone-curve.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/monotone-curve.ts"],
+  "sourcesContent": ["import {\n  createSeriesCurve,\n  type SeriesCurve,\n  type SeriesCurvePoint,\n} from \"./curve-definition.js\";\n\nfunction endpointSlope(\n  h0: number,\n  h1: number,\n  first: number,\n  second: number,\n): number {\n  let slope = ((2 * h0 + h1) * first - h0 * second) / (h0 + h1);\n  if (Math.sign(slope) !== Math.sign(first)) return 0;\n  if (\n    Math.sign(first) !== Math.sign(second) &&\n    Math.abs(slope) > Math.abs(3 * first)\n  )\n    slope = 3 * first;\n  return slope;\n}\n\nfunction monotoneSegments(points: readonly SeriesCurvePoint[]) {\n  if (points.length < 2) return [];\n  const direction = points[1][0] > points[0][0] ? 1 : -1;\n  const x = points.map((point) => direction * point[0]);\n  const h: number[] = [];\n  const delta: number[] = [];\n  for (let i = 0; i < points.length - 1; i++) {\n    const width = x[i + 1] - x[i];\n    if (!Number.isFinite(width) || width <= 0)\n      throw new RangeError(\n        \"monotoneX requires strictly ascending or descending finite x coordinates.\",\n      );\n    h.push(width);\n    delta.push((points[i + 1][1] - points[i][1]) / width);\n  }\n  const slopes = new Array<number>(points.length);\n  if (points.length === 2) slopes[0] = slopes[1] = delta[0];\n  else {\n    slopes[0] = endpointSlope(h[0], h[1], delta[0], delta[1]);\n    slopes[points.length - 1] = endpointSlope(\n      h.at(-1)!,\n      h.at(-2)!,\n      delta.at(-1)!,\n      delta.at(-2)!,\n    );\n    for (let i = 1; i < points.length - 1; i++) {\n      const previous = delta[i - 1],\n        next = delta[i];\n      slopes[i] =\n        previous === 0 || next === 0 || Math.sign(previous) !== Math.sign(next)\n          ? 0\n          : (3 * (h[i - 1] + h[i])) /\n            ((2 * h[i] + h[i - 1]) / previous + (h[i] + 2 * h[i - 1]) / next);\n    }\n  }\n  return points.slice(1).map((end, index) => {\n    const start = points[index],\n      width = h[index];\n    const control1: SeriesCurvePoint = [\n      start[0] + (end[0] - start[0]) / 3,\n      start[1] + (slopes[index] * width) / 3,\n    ];\n    const control2: SeriesCurvePoint = [\n      end[0] - (end[0] - start[0]) / 3,\n      end[1] - (slopes[index + 1] * width) / 3,\n    ];\n    if (![...control1, ...control2, ...end].every(Number.isFinite))\n      throw new RangeError(\"monotoneX generated non-finite cubic controls.\");\n    return Object.freeze({ end, control1, control2 });\n  });\n}\n\nconst monotone = /* @__PURE__ */ createSeriesCurve(monotoneSegments);\n\n/**\n * Returns the immutable monotone-X cubic Hermite definition.\n *\n * It uses weighted harmonic interior slopes and limited one-sided endpoint slopes, preserving every observation,\n * flat segment, and local extremum without sorting data. Each run must have strictly ascending\n * or strictly descending x coordinates.\n *\n * @returns The named {@link SeriesCurve} definition.\n */\nexport function monotoneX(): SeriesCurve {\n  return monotone;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -1,10 +1,10 @@
-import type { ResolvedLinearScale } from "./types.js";
+import type { ResolvedContinuousScale } 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 ResolvedContinuousScale}
  * @see {@link nearestPoint}
  */
 export interface NearestPointOptions<D> {
@@ -12,10 +12,10 @@ export interface NearestPointOptions<D> {
     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;
+    /** The scale used to map horizontal data coordinates. See {@link ResolvedContinuousScale}. */
+    readonly xScale: ResolvedContinuousScale;
+    /** The scale used to map vertical data coordinates. See {@link ResolvedContinuousScale}. */
+    readonly yScale: ResolvedContinuousScale;
     /**
      * Returns whether a datum contributes drawable or queryable coordinates. See
      * {@link NearestPointOptions}.
@@ -57,12 +57,12 @@ export interface NearestPoint<D> {
  *
  * @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}.
+ * @param scale - Scale mapping candidates into range coordinates. See {@link ResolvedContinuousScale}.
  * @returns The nearest domain value, or undefined when no candidate can be selected.
  *
- * @see {@link ResolvedLinearScale}
+ * @see {@link ResolvedContinuousScale}
  */
-export declare function nearestDomainValue(values: readonly number[], rangeValue: number, scale: ResolvedLinearScale): number | undefined;
+export declare function nearestDomainValue(values: readonly number[], rangeValue: number, scale: ResolvedContinuousScale): number | undefined;
 /**
  * Finds the nearest defined datum in scaled coordinates, subject to an optional maximum distance.
  *

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

@@ -1,7 +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"],
+  "sourcesContent": ["import type { ResolvedContinuousScale } 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 ResolvedContinuousScale}\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 ResolvedContinuousScale}. */\n  readonly xScale: ResolvedContinuousScale;\n  /** The scale used to map vertical data coordinates. See {@link ResolvedContinuousScale}. */\n  readonly yScale: ResolvedContinuousScale;\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 ResolvedContinuousScale}.\n * @returns The nearest domain value, or undefined when no candidate can be selected.\n *\n * @see {@link ResolvedContinuousScale}\n */\nexport function nearestDomainValue(\n  values: readonly number[],\n  rangeValue: number,\n  scale: ResolvedContinuousScale,\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/numeric-range-interpolation.d.ts

@@ -0,0 +1,15 @@
+import type { NumericDomain } from "./types.js";
+/**
+ * Linearly interpolates both endpoints of a finite numeric range.
+ *
+ * The returned pair is frozen. It preserves ascending, descending, and flat
+ * endpoint order for progress within zero through one. Progress outside that
+ * interval deliberately extrapolates, matching Pibbl's numeric tween behavior.
+ *
+ * @param from - Starting finite endpoint pair.
+ * @param to - Ending finite endpoint pair.
+ * @param progress - Finite interpolation progress supplied by an animation definition.
+ * @returns A frozen finite endpoint pair.
+ * @see {@link NumericDomain}
+ */
+export declare function interpolateNumericRange(from: NumericDomain, to: NumericDomain, progress: number): NumericDomain;

package/dist/features/viz/lib/numeric-range-interpolation.js

@@ -0,0 +1,36 @@
+function endpoint(value, name) {
+  if (typeof value !== "number" || !Number.isFinite(value))
+    throw new RangeError(`Numeric range ${name} must be finite.`);
+  return value;
+}
+function range(value, name) {
+  if (!Array.isArray(value) || value.length !== 2)
+    throw new TypeError(`Numeric range ${name} requires two endpoints.`);
+  return [endpoint(value[0], `${name}[0]`), endpoint(value[1], `${name}[1]`)];
+}
+function interpolateEndpoint(from, to, progress) {
+  if (progress === 0 || from === to) return from;
+  if (progress === 1) return to;
+  const difference = to - from;
+  const direct = from + difference * progress;
+  if (Number.isFinite(direct)) return direct;
+  const scale = Math.max(Math.abs(from), Math.abs(to));
+  const scaled = (from / scale + (to / scale - from / scale) * progress) * scale;
+  if (!Number.isFinite(scaled))
+    throw new RangeError("Numeric range interpolation must produce finite endpoints.");
+  return scaled;
+}
+function interpolateNumericRange(from, to, progress) {
+  const start = range(from, "from");
+  const end = range(to, "to");
+  if (typeof progress !== "number" || !Number.isFinite(progress))
+    throw new RangeError("Numeric range interpolation progress must be finite.");
+  return Object.freeze([
+    interpolateEndpoint(start[0], end[0], progress),
+    interpolateEndpoint(start[1], end[1], progress)
+  ]);
+}
+export {
+  interpolateNumericRange
+};
+//# sourceMappingURL=numeric-range-interpolation.js.map

package/dist/features/viz/lib/numeric-range-interpolation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/numeric-range-interpolation.ts"],
+  "sourcesContent": ["import type { NumericDomain } from \"./types.js\";\n\nfunction endpoint(value: unknown, name: string): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value))\n    throw new RangeError(`Numeric range ${name} must be finite.`);\n  return value;\n}\n\nfunction range(value: NumericDomain, name: string): readonly [number, number] {\n  if (!Array.isArray(value) || value.length !== 2)\n    throw new TypeError(`Numeric range ${name} requires two endpoints.`);\n  return [endpoint(value[0], `${name}[0]`), endpoint(value[1], `${name}[1]`)];\n}\n\nfunction interpolateEndpoint(from: number, to: number, progress: number): number {\n  if (progress === 0 || from === to) return from;\n  if (progress === 1) return to;\n  const difference = to - from;\n  const direct = from + difference * progress;\n  if (Number.isFinite(direct)) return direct;\n\n  // Scaling avoids overflow in the subtraction for opposite, very large endpoints.\n  const scale = Math.max(Math.abs(from), Math.abs(to));\n  const scaled =\n    (from / scale + (to / scale - from / scale) * progress) * scale;\n  if (!Number.isFinite(scaled))\n    throw new RangeError(\"Numeric range interpolation must produce finite endpoints.\");\n  return scaled;\n}\n\n/**\n * Linearly interpolates both endpoints of a finite numeric range.\n *\n * The returned pair is frozen. It preserves ascending, descending, and flat\n * endpoint order for progress within zero through one. Progress outside that\n * interval deliberately extrapolates, matching Pibbl's numeric tween behavior.\n *\n * @param from - Starting finite endpoint pair.\n * @param to - Ending finite endpoint pair.\n * @param progress - Finite interpolation progress supplied by an animation definition.\n * @returns A frozen finite endpoint pair.\n * @see {@link NumericDomain}\n */\nexport function interpolateNumericRange(\n  from: NumericDomain,\n  to: NumericDomain,\n  progress: number,\n): NumericDomain {\n  const start = range(from, \"from\");\n  const end = range(to, \"to\");\n  if (typeof progress !== \"number\" || !Number.isFinite(progress))\n    throw new RangeError(\"Numeric range interpolation progress must be finite.\");\n  return Object.freeze([\n    interpolateEndpoint(start[0], end[0], progress),\n    interpolateEndpoint(start[1], end[1], progress),\n  ]);\n}\n"],
+  "mappings": "AAEA,SAAS,SAAS,OAAgB,MAAsB;AACtD,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK;AACrD,UAAM,IAAI,WAAW,iBAAiB,IAAI,kBAAkB;AAC9D,SAAO;AACT;AAEA,SAAS,MAAM,OAAsB,MAAyC;AAC5E,MAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,WAAW;AAC5C,UAAM,IAAI,UAAU,iBAAiB,IAAI,0BAA0B;AACrE,SAAO,CAAC,SAAS,MAAM,CAAC,GAAG,GAAG,IAAI,KAAK,GAAG,SAAS,MAAM,CAAC,GAAG,GAAG,IAAI,KAAK,CAAC;AAC5E;AAEA,SAAS,oBAAoB,MAAc,IAAY,UAA0B;AAC/E,MAAI,aAAa,KAAK,SAAS,GAAI,QAAO;AAC1C,MAAI,aAAa,EAAG,QAAO;AAC3B,QAAM,aAAa,KAAK;AACxB,QAAM,SAAS,OAAO,aAAa;AACnC,MAAI,OAAO,SAAS,MAAM,EAAG,QAAO;AAGpC,QAAM,QAAQ,KAAK,IAAI,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;AACnD,QAAM,UACH,OAAO,SAAS,KAAK,QAAQ,OAAO,SAAS,YAAY;AAC5D,MAAI,CAAC,OAAO,SAAS,MAAM;AACzB,UAAM,IAAI,WAAW,4DAA4D;AACnF,SAAO;AACT;AAeO,SAAS,wBACd,MACA,IACA,UACe;AACf,QAAM,QAAQ,MAAM,MAAM,MAAM;AAChC,QAAM,MAAM,MAAM,IAAI,IAAI;AAC1B,MAAI,OAAO,aAAa,YAAY,CAAC,OAAO,SAAS,QAAQ;AAC3D,UAAM,IAAI,WAAW,sDAAsD;AAC7E,SAAO,OAAO,OAAO;AAAA,IACnB,oBAAoB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,QAAQ;AAAA,IAC9C,oBAAoB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,QAAQ;AAAA,EAChD,CAAC;AACH;",
+  "names": []
+}