@pibbl/core 0.0.2 → 0.0.3-alpha.90.1

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

@@ -0,0 +1,158 @@
+import { Fragment, jsx, jsxs } from "@pibbl/core/jsx-runtime";
+import { Circle, Group, Line, resolveSignalValue } from "@pibbl/core";
+import { withHooksForbidden } from "@pibbl/core/internal";
+import { lookupScale } from "./scale-context.js";
+import { useContinuousScale } from "./use-continuous-scale.js";
+import { finiteCoordinate, pointAccessor, pointData } from "./point-data.js";
+import { opacity, width } from "./paint.js";
+function intervalSeries(props, horizontal) {
+  const receiver = horizontal ? "HorizontalIntervalSeries" : "VerticalIntervalSeries";
+  const {
+    data: input,
+    category: categoryInput,
+    estimate: estimateInput,
+    lower: lowerInput,
+    upper: upperInput,
+    categoryScale,
+    valueScale,
+    defined,
+    style: styleInput,
+    pointerEvents,
+    ...events
+  } = props;
+  const categories = lookupScale(categoryScale, receiver)?.get();
+  const values = useContinuousScale(valueScale).get();
+  if (!categories || categories.type !== "point" && categories.type !== "band")
+    throw new TypeError(
+      `${receiver}: categoryScale requires PointScale or BarScale.`
+    );
+  const data = pointData(resolveSignalValue(input), receiver);
+  const category = typeof categoryInput === "function" ? categoryInput : (datum) => datum[categoryInput];
+  const estimate = pointAccessor(estimateInput), lower = pointAccessor(lowerInput), upper = pointAccessor(upperInput);
+  const specified = resolveSignalValue(styleInput) ?? {};
+  if (typeof specified !== "object" || Array.isArray(specified))
+    throw new TypeError(`${receiver}: style must be an object.`);
+  const style = {};
+  for (const key of Object.keys(specified)) {
+    if (![
+      "radius",
+      "capSize",
+      "fill",
+      "stroke",
+      "strokeWidth",
+      "lineInteractionWidth",
+      "opacity",
+      "cursor"
+    ].includes(key))
+      throw new TypeError(`${receiver}: unsupported style field ${key}.`);
+    style[key] = resolveSignalValue(specified[key]);
+  }
+  const resolved = style;
+  const radius = width(resolved.radius ?? 4, `${receiver} radius`);
+  const halfCap = width(resolved.capSize ?? 8, `${receiver} capSize`) / 2;
+  const strokeWidth = width(resolved.strokeWidth ?? 1.5, receiver);
+  const lineInteractionWidth = width(
+    resolved.lineInteractionWidth ?? strokeWidth,
+    receiver
+  );
+  const alpha = opacity(resolved.opacity ?? 1, receiver);
+  if (resolved.cursor !== void 0 && typeof resolved.cursor !== "string")
+    throw new TypeError(`${receiver}: cursor must be a string.`);
+  const stroke = resolved.stroke ?? "#087f8c";
+  const lineStyle = {
+    stroke,
+    strokeWidth,
+    lineInteractionWidth,
+    opacity: alpha,
+    cursor: resolved.cursor
+  };
+  const nodes = [];
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    const coordinates = withHooksForbidden(
+      `${receiver}: accessors cannot call hooks.`,
+      () => {
+        if (defined && !defined(datum, i, data)) return void 0;
+        return {
+          category: category(datum, i, data),
+          estimate: estimate(datum, i, data),
+          lower: lower(datum, i, data),
+          upper: upper(datum, i, data)
+        };
+      }
+    );
+    if (!coordinates || coordinates.category == null || !finiteCoordinate(coordinates.estimate) || !finiteCoordinate(coordinates.lower) || !finiteCoordinate(coordinates.upper))
+      continue;
+    const start = categories.map(coordinates.category);
+    if (start === void 0) continue;
+    if (coordinates.lower > coordinates.upper)
+      throw new RangeError(
+        `${receiver}: lower must not exceed upper (row ${i}).`
+      );
+    const center = start + (categories.type === "band" ? categories.bandwidth / 2 : 0);
+    const lo = values.map(coordinates.lower), hi = values.map(coordinates.upper), point = values.map(coordinates.estimate);
+    if (![center, lo, hi, point].every(Number.isFinite))
+      throw new RangeError(
+        `${receiver}: mapped coordinates must be finite (row ${i}).`
+      );
+    const position = (value, offset = 0) => horizontal ? [value, center + offset] : [center + offset, value];
+    nodes.push(
+      /* @__PURE__ */ jsxs(Group, { children: [
+        /* @__PURE__ */ jsx(
+          Line,
+          {
+            pointerEvents,
+            style: { ...lineStyle, coords: [position(lo), position(hi)] }
+          }
+        ),
+        halfCap > 0 && /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(
+            Line,
+            {
+              pointerEvents,
+              style: {
+                ...lineStyle,
+                coords: [position(lo, -halfCap), position(lo, halfCap)]
+              }
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            Line,
+            {
+              pointerEvents,
+              style: {
+                ...lineStyle,
+                coords: [position(hi, -halfCap), position(hi, halfCap)]
+              }
+            }
+          )
+        ] }),
+        radius > 0 && /* @__PURE__ */ jsx(
+          Circle,
+          {
+            pointerEvents,
+            style: {
+              ...lineStyle,
+              cx: horizontal ? point : center,
+              cy: horizontal ? center : point,
+              radius,
+              fill: resolved.fill ?? "#087f8c"
+            }
+          }
+        )
+      ] }, i)
+    );
+  }
+  return /* @__PURE__ */ jsx(Group, { ...events, children: nodes });
+}
+function HorizontalIntervalSeries(props) {
+  return intervalSeries(props, true);
+}
+function VerticalIntervalSeries(props) {
+  return intervalSeries(props, false);
+}
+export {
+  HorizontalIntervalSeries,
+  VerticalIntervalSeries
+};
+//# sourceMappingURL=interval-series.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/interval-series.tsx"],
+  "sourcesContent": ["import { Circle, Group, Line, resolveSignalValue } from \"@pibbl/core\";\nimport type {\n  FillStyle,\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n  PibblNode,\n  SignalValue,\n  StrokeStyle,\n} from \"@pibbl/core\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport { withHooksForbidden } from \"@pibbl/core/internal\";\nimport type { BarCategoryAccessor } from \"./bar-series.js\";\nimport type { BandCategory, LineAccessor, ScaleId } from \"./types.js\";\nimport { lookupScale } from \"./scale-context.js\";\nimport { useContinuousScale } from \"./use-continuous-scale.js\";\nimport { finiteCoordinate, pointAccessor, pointData } from \"./point-data.js\";\nimport { opacity, width } from \"./paint.js\";\n\n/** Shared local-pixel geometry and paint for estimate-and-interval marks.\n * @see {@link IntervalSeriesProps}\n */\nexport interface IntervalSeriesStyle {\n  /** Estimate circle radius in local pixels; defaults to 4. */\n  readonly radius?: number;\n  /** Full perpendicular length of each endpoint cap; defaults to 8 pixels. */\n  readonly capSize?: number;\n  /** Estimate circle fill; defaults to #087f8c. */\n  readonly fill?: FillStyle;\n  /** Interval, cap, and circle outline paint; defaults to #087f8c. */\n  readonly stroke?: StrokeStyle;\n  /** Visible stroke width in local pixels; defaults to 1.5. */\n  readonly strokeWidth?: number;\n  /** Stroke targeting width, independent of visible width; defaults to strokeWidth. */\n  readonly lineInteractionWidth?: number;\n  /** Shared paint opacity from zero to one; defaults to 1. */\n  readonly opacity?: number;\n  /** Cursor for painted mark targets. */\n  readonly cursor?: string;\n}\n\n/** Explicit supplied estimates and numeric bounds placed at categorical centers.\n * @see {@link HorizontalIntervalSeries}\n * @see {@link VerticalIntervalSeries}\n */\nexport interface IntervalSeriesProps<D>\n  extends PibblEventHandlers, PibblEventParticipationOptions {\n  /** Original records, or a signal of records; no estimation is performed. */\n  readonly data: SignalValue<readonly D[]>;\n  /** Property or callback supplying a category; missing/unknown categories omit rows. */\n  readonly category: BarCategoryAccessor<D>;\n  /** Property or callback supplying the numeric point estimate. */\n  readonly estimate: LineAccessor<D>;\n  /** Property or callback supplying the numeric lower bound. */\n  readonly lower: LineAccessor<D>;\n  /** Property or callback supplying the numeric upper bound. */\n  readonly upper: LineAccessor<D>;\n  /** Ancestor PointScale or BarScale; band categories use their centers. */\n  readonly categoryScale: ScaleId;\n  /** Ancestor continuous numeric scale mapping estimate and both bounds independently. */\n  readonly valueScale: ScaleId;\n  /** Optional synchronous predicate; excluded rows contribute no marks.\n   * @param datum - Original record being tested.\n   * @param index - Source index of the record.\n   * @param data - Complete supplied data array.\n   * @returns Whether to include this record's estimate and interval.\n   */\n  readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;\n  /** Shared style; whole-object and shallow field signals are observed by the series. */\n  readonly style?: SignalValue<SignalStyle<IntervalSeriesStyle>>;\n}\n\n/** Horizontal estimate-and-interval authoring inputs. See {@link HorizontalIntervalSeries}. */\nexport type HorizontalIntervalSeriesProps<D> = IntervalSeriesProps<D>;\n/** Vertical estimate-and-interval authoring inputs. See {@link VerticalIntervalSeries}. */\nexport type VerticalIntervalSeriesProps<D> = IntervalSeriesProps<D>;\n\nfunction intervalSeries<D>(\n  props: IntervalSeriesProps<D>,\n  horizontal: boolean,\n): PibblNode {\n  const receiver = horizontal\n    ? \"HorizontalIntervalSeries\"\n    : \"VerticalIntervalSeries\";\n  const {\n    data: input,\n    category: categoryInput,\n    estimate: estimateInput,\n    lower: lowerInput,\n    upper: upperInput,\n    categoryScale,\n    valueScale,\n    defined,\n    style: styleInput,\n    pointerEvents,\n    ...events\n  } = props;\n  const categories = lookupScale(categoryScale, receiver)?.get();\n  const values = useContinuousScale(valueScale).get();\n  if (\n    !categories ||\n    (categories.type !== \"point\" && categories.type !== \"band\")\n  )\n    throw new TypeError(\n      `${receiver}: categoryScale requires PointScale or BarScale.`,\n    );\n  const data = pointData(resolveSignalValue(input), receiver);\n  const category =\n    typeof categoryInput === \"function\"\n      ? categoryInput\n      : (datum: D) => datum[categoryInput] as BandCategory | null | undefined;\n  const estimate = pointAccessor(estimateInput),\n    lower = pointAccessor(lowerInput),\n    upper = pointAccessor(upperInput);\n  const specified = resolveSignalValue(styleInput) ?? {};\n  if (typeof specified !== \"object\" || Array.isArray(specified))\n    throw new TypeError(`${receiver}: style must be an object.`);\n  const style: Record<string, unknown> = {};\n  for (const key of Object.keys(specified)) {\n    if (\n      ![\n        \"radius\",\n        \"capSize\",\n        \"fill\",\n        \"stroke\",\n        \"strokeWidth\",\n        \"lineInteractionWidth\",\n        \"opacity\",\n        \"cursor\",\n      ].includes(key)\n    )\n      throw new TypeError(`${receiver}: unsupported style field ${key}.`);\n    style[key] = resolveSignalValue(specified[key as keyof typeof specified]);\n  }\n  const resolved = style as IntervalSeriesStyle;\n  const radius = width(resolved.radius ?? 4, `${receiver} radius`);\n  const halfCap = width(resolved.capSize ?? 8, `${receiver} capSize`) / 2;\n  const strokeWidth = width(resolved.strokeWidth ?? 1.5, receiver);\n  const lineInteractionWidth = width(\n    resolved.lineInteractionWidth ?? strokeWidth,\n    receiver,\n  );\n  const alpha = opacity(resolved.opacity ?? 1, receiver);\n  if (resolved.cursor !== undefined && typeof resolved.cursor !== \"string\")\n    throw new TypeError(`${receiver}: cursor must be a string.`);\n  const stroke = resolved.stroke ?? \"#087f8c\";\n  const lineStyle = {\n    stroke,\n    strokeWidth,\n    lineInteractionWidth,\n    opacity: alpha,\n    cursor: resolved.cursor,\n  };\n  const nodes: PibblNode[] = [];\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    const coordinates = withHooksForbidden(\n      `${receiver}: accessors cannot call hooks.`,\n      () => {\n        if (defined && !defined(datum, i, data)) return undefined;\n        return {\n          category: category(datum, i, data),\n          estimate: estimate(datum, i, data),\n          lower: lower(datum, i, data),\n          upper: upper(datum, i, data),\n        };\n      },\n    );\n    if (\n      !coordinates ||\n      coordinates.category == null ||\n      !finiteCoordinate(coordinates.estimate) ||\n      !finiteCoordinate(coordinates.lower) ||\n      !finiteCoordinate(coordinates.upper)\n    )\n      continue;\n    const start = categories.map(coordinates.category);\n    if (start === undefined) continue;\n    if (coordinates.lower > coordinates.upper)\n      throw new RangeError(\n        `${receiver}: lower must not exceed upper (row ${i}).`,\n      );\n    const center =\n      start + (categories.type === \"band\" ? categories.bandwidth / 2 : 0);\n    const lo = values.map(coordinates.lower),\n      hi = values.map(coordinates.upper),\n      point = values.map(coordinates.estimate);\n    if (![center, lo, hi, point].every(Number.isFinite))\n      throw new RangeError(\n        `${receiver}: mapped coordinates must be finite (row ${i}).`,\n      );\n    const position = (value: number, offset = 0): [number, number] =>\n      horizontal ? [value, center + offset] : [center + offset, value];\n    nodes.push(\n      <Group key={i}>\n        <Line\n          pointerEvents={pointerEvents}\n          style={{ ...lineStyle, coords: [position(lo), position(hi)] }}\n        />\n        {halfCap > 0 && (\n          <>\n            <Line\n              pointerEvents={pointerEvents}\n              style={{\n                ...lineStyle,\n                coords: [position(lo, -halfCap), position(lo, halfCap)],\n              }}\n            />\n            <Line\n              pointerEvents={pointerEvents}\n              style={{\n                ...lineStyle,\n                coords: [position(hi, -halfCap), position(hi, halfCap)],\n              }}\n            />\n          </>\n        )}\n        {radius > 0 && (\n          <Circle\n            pointerEvents={pointerEvents}\n            style={{\n              ...lineStyle,\n              cx: horizontal ? point : center,\n              cy: horizontal ? center : point,\n              radius,\n              fill: resolved.fill ?? \"#087f8c\",\n            }}\n          />\n        )}\n      </Group>,\n    );\n  }\n  return <Group {...events}>{nodes}</Group>;\n}\n\n/**\n * Draw supplied numeric intervals horizontally with an estimate circle per category.\n * Missing/non-finite coordinates omit the entire row; reversed bounds reject it.\n * Mapping does not clamp or clip; compose a Clip when required. Marks use ordinary\n * Line/Circle targets, with series handlers receiving their bubbled events.\n *\n * @param props - Supplied data, categorical/numeric scale IDs, and shared style.\n * @returns Ordinary Pibbl content in source order, interval then circle for each row.\n * @see {@link HorizontalIntervalSeriesProps}\n */\nexport function HorizontalIntervalSeries<D>(\n  props: HorizontalIntervalSeriesProps<D>,\n): PibblNode {\n  return intervalSeries(props, true);\n}\n\n/**\n * Draw supplied numeric intervals vertically with an estimate circle per category.\n * Shares the missing-data, bounds, paint, targeting, and clipping contract of\n * HorizontalIntervalSeries; orientation is explicit in the operation name.\n *\n * @param props - Supplied data, categorical/numeric scale IDs, and shared style.\n * @returns Ordinary Pibbl content in source order, interval then circle for each row.\n * @see {@link VerticalIntervalSeriesProps}\n */\nexport function VerticalIntervalSeries<D>(\n  props: VerticalIntervalSeriesProps<D>,\n): PibblNode {\n  return intervalSeries(props, false);\n}\n"],
+  "mappings": "AAkMQ,SAKE,UALF,KAKE,YALF;AAlMR,SAAS,QAAQ,OAAO,MAAM,0BAA0B;AAUxD,SAAS,0BAA0B;AAGnC,SAAS,mBAAmB;AAC5B,SAAS,0BAA0B;AACnC,SAAS,kBAAkB,eAAe,iBAAiB;AAC3D,SAAS,SAAS,aAAa;AA4D/B,SAAS,eACP,OACA,YACW;AACX,QAAM,WAAW,aACb,6BACA;AACJ,QAAM;AAAA,IACJ,MAAM;AAAA,IACN,UAAU;AAAA,IACV,UAAU;AAAA,IACV,OAAO;AAAA,IACP,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO;AAAA,IACP;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AACJ,QAAM,aAAa,YAAY,eAAe,QAAQ,GAAG,IAAI;AAC7D,QAAM,SAAS,mBAAmB,UAAU,EAAE,IAAI;AAClD,MACE,CAAC,cACA,WAAW,SAAS,WAAW,WAAW,SAAS;AAEpD,UAAM,IAAI;AAAA,MACR,GAAG,QAAQ;AAAA,IACb;AACF,QAAM,OAAO,UAAU,mBAAmB,KAAK,GAAG,QAAQ;AAC1D,QAAM,WACJ,OAAO,kBAAkB,aACrB,gBACA,CAAC,UAAa,MAAM,aAAa;AACvC,QAAM,WAAW,cAAc,aAAa,GAC1C,QAAQ,cAAc,UAAU,GAChC,QAAQ,cAAc,UAAU;AAClC,QAAM,YAAY,mBAAmB,UAAU,KAAK,CAAC;AACrD,MAAI,OAAO,cAAc,YAAY,MAAM,QAAQ,SAAS;AAC1D,UAAM,IAAI,UAAU,GAAG,QAAQ,4BAA4B;AAC7D,QAAM,QAAiC,CAAC;AACxC,aAAW,OAAO,OAAO,KAAK,SAAS,GAAG;AACxC,QACE,CAAC;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,SAAS,GAAG;AAEd,YAAM,IAAI,UAAU,GAAG,QAAQ,6BAA6B,GAAG,GAAG;AACpE,UAAM,GAAG,IAAI,mBAAmB,UAAU,GAA6B,CAAC;AAAA,EAC1E;AACA,QAAM,WAAW;AACjB,QAAM,SAAS,MAAM,SAAS,UAAU,GAAG,GAAG,QAAQ,SAAS;AAC/D,QAAM,UAAU,MAAM,SAAS,WAAW,GAAG,GAAG,QAAQ,UAAU,IAAI;AACtE,QAAM,cAAc,MAAM,SAAS,eAAe,KAAK,QAAQ;AAC/D,QAAM,uBAAuB;AAAA,IAC3B,SAAS,wBAAwB;AAAA,IACjC;AAAA,EACF;AACA,QAAM,QAAQ,QAAQ,SAAS,WAAW,GAAG,QAAQ;AACrD,MAAI,SAAS,WAAW,UAAa,OAAO,SAAS,WAAW;AAC9D,UAAM,IAAI,UAAU,GAAG,QAAQ,4BAA4B;AAC7D,QAAM,SAAS,SAAS,UAAU;AAClC,QAAM,YAAY;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT,QAAQ,SAAS;AAAA,EACnB;AACA,QAAM,QAAqB,CAAC;AAC5B,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,QAAQ,KAAK,CAAC;AACpB,UAAM,cAAc;AAAA,MAClB,GAAG,QAAQ;AAAA,MACX,MAAM;AACJ,YAAI,WAAW,CAAC,QAAQ,OAAO,GAAG,IAAI,EAAG,QAAO;AAChD,eAAO;AAAA,UACL,UAAU,SAAS,OAAO,GAAG,IAAI;AAAA,UACjC,UAAU,SAAS,OAAO,GAAG,IAAI;AAAA,UACjC,OAAO,MAAM,OAAO,GAAG,IAAI;AAAA,UAC3B,OAAO,MAAM,OAAO,GAAG,IAAI;AAAA,QAC7B;AAAA,MACF;AAAA,IACF;AACA,QACE,CAAC,eACD,YAAY,YAAY,QACxB,CAAC,iBAAiB,YAAY,QAAQ,KACtC,CAAC,iBAAiB,YAAY,KAAK,KACnC,CAAC,iBAAiB,YAAY,KAAK;AAEnC;AACF,UAAM,QAAQ,WAAW,IAAI,YAAY,QAAQ;AACjD,QAAI,UAAU,OAAW;AACzB,QAAI,YAAY,QAAQ,YAAY;AAClC,YAAM,IAAI;AAAA,QACR,GAAG,QAAQ,sCAAsC,CAAC;AAAA,MACpD;AACF,UAAM,SACJ,SAAS,WAAW,SAAS,SAAS,WAAW,YAAY,IAAI;AACnE,UAAM,KAAK,OAAO,IAAI,YAAY,KAAK,GACrC,KAAK,OAAO,IAAI,YAAY,KAAK,GACjC,QAAQ,OAAO,IAAI,YAAY,QAAQ;AACzC,QAAI,CAAC,CAAC,QAAQ,IAAI,IAAI,KAAK,EAAE,MAAM,OAAO,QAAQ;AAChD,YAAM,IAAI;AAAA,QACR,GAAG,QAAQ,4CAA4C,CAAC;AAAA,MAC1D;AACF,UAAM,WAAW,CAAC,OAAe,SAAS,MACxC,aAAa,CAAC,OAAO,SAAS,MAAM,IAAI,CAAC,SAAS,QAAQ,KAAK;AACjE,UAAM;AAAA,MACJ,qBAAC,SACC;AAAA;AAAA,UAAC;AAAA;AAAA,YACC;AAAA,YACA,OAAO,EAAE,GAAG,WAAW,QAAQ,CAAC,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC,EAAE;AAAA;AAAA,QAC9D;AAAA,QACC,UAAU,KACT,iCACE;AAAA;AAAA,YAAC;AAAA;AAAA,cACC;AAAA,cACA,OAAO;AAAA,gBACL,GAAG;AAAA,gBACH,QAAQ,CAAC,SAAS,IAAI,CAAC,OAAO,GAAG,SAAS,IAAI,OAAO,CAAC;AAAA,cACxD;AAAA;AAAA,UACF;AAAA,UACA;AAAA,YAAC;AAAA;AAAA,cACC;AAAA,cACA,OAAO;AAAA,gBACL,GAAG;AAAA,gBACH,QAAQ,CAAC,SAAS,IAAI,CAAC,OAAO,GAAG,SAAS,IAAI,OAAO,CAAC;AAAA,cACxD;AAAA;AAAA,UACF;AAAA,WACF;AAAA,QAED,SAAS,KACR;AAAA,UAAC;AAAA;AAAA,YACC;AAAA,YACA,OAAO;AAAA,cACL,GAAG;AAAA,cACH,IAAI,aAAa,QAAQ;AAAA,cACzB,IAAI,aAAa,SAAS;AAAA,cAC1B;AAAA,cACA,MAAM,SAAS,QAAQ;AAAA,YACzB;AAAA;AAAA,QACF;AAAA,WAjCQ,CAmCZ;AAAA,IACF;AAAA,EACF;AACA,SAAO,oBAAC,SAAO,GAAG,QAAS,iBAAM;AACnC;AAYO,SAAS,yBACd,OACW;AACX,SAAO,eAAe,OAAO,IAAI;AACnC;AAWO,SAAS,uBACd,OACW;AACX,SAAO,eAAe,OAAO,KAAK;AACpC;",
+  "names": []
+}

package/dist/features/viz/lib/line-series.d.ts

@@ -8,4 +8,4 @@ import type { LineSeriesProps } from "./types.js";
  *
  * @see {@link LineSeriesProps}
  */
-export declare function LineSeries<D>({ data: dataInput, x: xInput, y: yInput, xScale: xId, yScale: yId, defined, curve, style: styleInput, ...eventProps }: LineSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;
+export declare function LineSeries<D>({ data: dataInput, x: xInput, y: yInput, xScale: xId, yScale: yId, defined, inspection, curve, style: styleInput, ...eventProps }: LineSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;

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 { useContinuousScale } from "./use-continuous-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 = useContinuousScale(xId).get();
-  const yScale = useContinuousScale(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 { useContinuousScale } from \"./use-continuous-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 = useContinuousScale(xId).get();\n  const yScale = useContinuousScale(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,0BAA0B;AACnC,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,mBAAmB,GAAG,EAAE,IAAI;AAC3C,QAAM,SAAS,mBAAmB,GAAG,EAAE,IAAI;AAC3C,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.js

@@ -61,7 +61,7 @@ function resolveLinearScale(domainInput, rangeInput, reverse, width, height) {
   });
 }
 function equalScale(a, b) {
-  return a.type === b.type && (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);
+  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.type !== \"symlog\" || (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": "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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": "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",
   "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/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": []
+}

package/dist/features/viz/lib/ohlc-bar-series.d.ts

@@ -0,0 +1,55 @@
+import { type PibblEventHandlers, type PibblEventParticipationOptions, type PibblNode, type SignalValue, type StrokeStyle } from "@pibbl/core";
+import type { OhlcBarInspectionRef } from "../inspection/ohlc-bar.js";
+import type { LineAccessor, ScaleId } from "./types.js";
+/** Shared stroke presentation for an OHLC bar.
+ * @see {@link OhlcBarSeries}
+ */
+export interface OhlcBarSeriesStyle {
+    /** Positive total width, or automatic 70% spacing capped at 12; singleton fallback 8. */ readonly bandwidth?: number | "auto";
+    /** Stem and tick stroke; defaults to dark teal. Empty string disables painting. */ readonly stroke?: StrokeStyle;
+    /** Nonnegative local stroke width; default 1. */ readonly strokeWidth?: number;
+    /** Paint opacity from zero through one; default 1. */ readonly opacity?: number;
+    /** Cursor while the series owns targeting. */ readonly cursor?: string;
+}
+/** Source-ordered OHLC records rendered as a high/low stem with open/close ticks.
+ * @see {@link OhlcBarSeries}
+ */
+export interface OhlcBarSeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /** Original records or signal; never sorted or mutated. */
+    readonly data: SignalValue<readonly D[]>;
+    /** UTC-millisecond property or callback. */
+    readonly time: LineAccessor<D>;
+    /** Opening price property or callback. */
+    readonly open: LineAccessor<D>;
+    /** High price property or callback. */
+    readonly high: LineAccessor<D>;
+    /** Low price property or callback. */
+    readonly low: LineAccessor<D>;
+    /** Closing price property or callback. */
+    readonly close: LineAccessor<D>;
+    /** Numeric, UTC, or trading-time horizontal mapping identity. */
+    readonly xScale: ScaleId;
+    /** Continuous price mapping identity. */
+    readonly yScale: ScaleId;
+    /** Tests original rows before accessor evaluation.
+     * @param datum - Original row.
+     * @param index - Source index including skipped rows.
+     * @param data - Complete source array.
+     * @returns Whether the bar participates.
+     */
+    readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;
+    /** Shared presentation or a hook-free original-row resolver.
+     * @param datum - Original row.
+     * @param index - Source index.
+     * @param data - Complete source array.
+     * @returns Plain OHLC-bar style.
+     */
+    readonly style?: SignalValue<OhlcBarSeriesStyle> | ((datum: D, index: number, data: readonly D[]) => OhlcBarSeriesStyle);
+    /** Optional committed capture; the renderer does not execute inspection queries. */ readonly inspection?: OhlcBarInspectionRef<D>;
+}
+/** Paints source-ordered OHLC bars with a high/low stem, left open tick, and right close tick.
+ * @param props - Original OHLC accessors, scales, styles, events, and optional capture.
+ * @returns Ordinary Pibbl composition; equal disjoint styles share paths.
+ * @see {@link OhlcBarSeriesProps}
+ */
+export declare function OhlcBarSeries<D>({ data: input, time: timeInput, open: openInput, high: highInput, low: lowInput, close: closeInput, xScale, yScale, defined, style: styleInput, inspection, pointerEvents, ...events }: OhlcBarSeriesProps<D>): PibblNode;