@pibbl/core 0.0.1 → 0.0.3-alpha.85.1

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

@@ -0,0 +1,38 @@
+import type { NumericDomain } from "./types.js";
+/** Readable linear tick density. See {@link linearTicks}. */
+export interface LinearTickOptions {
+    /** Target number of intervals, from 2 to 100; defaults to 5. */
+    readonly count?: number;
+}
+/**
+ * Generates bounded ticks at readable 1, 2, or 5 × powers-of-ten intervals.
+ * Endpoints are included only when aligned. Does not change scale geometry.
+ * @param domain - Distinct finite endpoints, ascending or descending.
+ * @param options - Target density; defaults to five intervals.
+ * @returns Frozen ticks in domain order. See {@link niceLinearDomain}.
+ */
+export declare function linearTicks(domain: NumericDomain, options?: LinearTickOptions): readonly number[];
+/**
+ * Expands a linear domain to readable tick boundaries, preserving direction.
+ * @param domain - Distinct finite numeric endpoints; never mutated.
+ * @param options - Target density; defaults to five intervals.
+ * @returns Frozen expanded endpoints. See {@link linearTicks}.
+ */
+export declare function niceLinearDomain(domain: NumericDomain, options?: LinearTickOptions): NumericDomain;
+/** Number formatting with explicit locale and literal unit affixes. See {@link formatNumber}. */
+export interface NumberFormatOptions extends Intl.NumberFormatOptions {
+    /** Locale for formatting; defaults to en-US. */
+    readonly locale?: string;
+    /** Literal prefix; defaults to empty. */
+    readonly prefix?: string;
+    /** Literal suffix, including any desired space; defaults to empty. */
+    readonly suffix?: string;
+}
+/**
+ * Formats a finite number with Intl precision, currency, percent, or unit options.
+ * Rounded negative zero is displayed as positive zero.
+ * @param value - Finite numeric value.
+ * @param options - Intl options plus locale and literal affixes; default maximum fraction digits is 3.
+ * @returns Formatted text. Invalid Intl options retain native errors. See {@link NumberFormatOptions}.
+ */
+export declare function formatNumber(value: number, options?: NumberFormatOptions): string;

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

@@ -0,0 +1,54 @@
+function parameters(domain, options) {
+  const count = options.count ?? 5;
+  if (!Number.isInteger(count) || count < 2 || count > 100)
+    throw new RangeError("Linear tick count must be an integer from 2 to 100.");
+  if (!Array.isArray(domain) || domain.length !== 2 || !domain.every(Number.isFinite))
+    throw new RangeError("Linear tick domain requires two finite endpoints.");
+  const lo = Math.min(...domain), hi = Math.max(...domain);
+  const span = hi - lo;
+  if (!Number.isFinite(span) || span === 0)
+    throw new RangeError("Linear tick domain must have a finite nonzero span.");
+  const raw = span / count;
+  const power = 10 ** Math.floor(Math.log10(raw));
+  const error = raw / power;
+  let step = power * (error >= Math.sqrt(50) ? 10 : error >= Math.sqrt(10) ? 5 : error >= Math.sqrt(2) ? 2 : 1);
+  if (!Number.isFinite(step) || step === 0 || !Number.isSafeInteger(Math.floor(lo / step)) || !Number.isSafeInteger(Math.ceil(hi / step)))
+    throw new RangeError("Linear tick spacing exceeds numeric precision.");
+  if (Math.floor(hi / step) - Math.ceil(lo / step) + 1 > 100) {
+    const magnitude = 10 ** Math.floor(Math.log10(step));
+    const factor = step / magnitude;
+    step = magnitude * (factor < 1.5 ? 2 : factor < 3 ? 5 : 10);
+  }
+  return { lo, hi, step };
+}
+function clean(value) {
+  return Number(value.toPrecision(15)) || 0;
+}
+function linearTicks(domain, options = {}) {
+  const { lo, hi, step } = parameters(domain, options);
+  const start = Math.ceil(lo / step), end = Math.floor(hi / step);
+  const values = Array.from({ length: Math.max(0, end - start + 1) }, (_, i) => clean((start + i) * step)).filter((v) => v >= lo && v <= hi);
+  return Object.freeze(domain[0] > domain[1] ? values.reverse() : values);
+}
+function niceLinearDomain(domain, options = {}) {
+  const { lo, hi, step } = parameters(domain, options);
+  const a = clean(Math.floor(lo / step) * step), b = clean(Math.ceil(hi / step) * step);
+  if (!Number.isFinite(a) || !Number.isFinite(b)) throw new RangeError("Nice linear domain exceeds finite numeric bounds.");
+  return Object.freeze(domain[0] > domain[1] ? [b, a] : [a, b]);
+}
+function formatNumber(value, options = {}) {
+  if (!Number.isFinite(value)) throw new RangeError("formatNumber value must be finite.");
+  const { locale = "en-US", prefix = "", suffix = "", ...intl } = options;
+  const formatter = new Intl.NumberFormat(locale, intl);
+  const parts = formatter.formatToParts(value);
+  const zeroDigit = Array.from(formatter.formatToParts(0).find((p) => p.type === "integer").value).at(-1);
+  const digits = parts.filter((p) => p.type === "integer" || p.type === "fraction");
+  const zero = digits.length > 0 && digits.every((p) => Array.from(p.value).every((digit) => digit === zeroDigit));
+  return prefix + formatter.format(zero ? 0 : value) + suffix;
+}
+export {
+  formatNumber,
+  linearTicks,
+  niceLinearDomain
+};
+//# sourceMappingURL=numeric-ticks.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/numeric-ticks.ts"],
+  "sourcesContent": ["import type { NumericDomain } from \"./types.js\";\n\n/** Readable linear tick density. See {@link linearTicks}. */\nexport interface LinearTickOptions {\n  /** Target number of intervals, from 2 to 100; defaults to 5. */\n  readonly count?: number;\n}\nfunction parameters(domain: NumericDomain, options: LinearTickOptions) {\n  const count = options.count ?? 5;\n  if (!Number.isInteger(count) || count < 2 || count > 100)\n    throw new RangeError(\"Linear tick count must be an integer from 2 to 100.\");\n  if (!Array.isArray(domain) || domain.length !== 2 || !domain.every(Number.isFinite))\n    throw new RangeError(\"Linear tick domain requires two finite endpoints.\");\n  const lo = Math.min(...domain), hi = Math.max(...domain);\n  const span = hi - lo;\n  if (!Number.isFinite(span) || span === 0)\n    throw new RangeError(\"Linear tick domain must have a finite nonzero span.\");\n  const raw = span / count;\n  const power = 10 ** Math.floor(Math.log10(raw));\n  const error = raw / power;\n  let step = power * (error >= Math.sqrt(50) ? 10 : error >= Math.sqrt(10) ? 5 : error >= Math.sqrt(2) ? 2 : 1);\n  if (!Number.isFinite(step) || step === 0 || !Number.isSafeInteger(Math.floor(lo / step)) || !Number.isSafeInteger(Math.ceil(hi / step)))\n    throw new RangeError(\"Linear tick spacing exceeds numeric precision.\");\n  if (Math.floor(hi / step) - Math.ceil(lo / step) + 1 > 100) {\n    const magnitude = 10 ** Math.floor(Math.log10(step));\n    const factor = step / magnitude;\n    step = magnitude * (factor < 1.5 ? 2 : factor < 3 ? 5 : 10);\n  }\n  return { lo, hi, step };\n}\nfunction clean(value: number) { return Number(value.toPrecision(15)) || 0; }\n/**\n * Generates bounded ticks at readable 1, 2, or 5 \u00D7 powers-of-ten intervals.\n * Endpoints are included only when aligned. Does not change scale geometry.\n * @param domain - Distinct finite endpoints, ascending or descending.\n * @param options - Target density; defaults to five intervals.\n * @returns Frozen ticks in domain order. See {@link niceLinearDomain}.\n */\nexport function linearTicks(domain: NumericDomain, options: LinearTickOptions = {}): readonly number[] {\n  const { lo, hi, step } = parameters(domain, options);\n  const start = Math.ceil(lo / step), end = Math.floor(hi / step);\n  const values = Array.from({ length: Math.max(0, end - start + 1) }, (_, i) => clean((start + i) * step)).filter(v => v >= lo && v <= hi);\n  return Object.freeze(domain[0] > domain[1] ? values.reverse() : values);\n}\n/**\n * Expands a linear domain to readable tick boundaries, preserving direction.\n * @param domain - Distinct finite numeric endpoints; never mutated.\n * @param options - Target density; defaults to five intervals.\n * @returns Frozen expanded endpoints. See {@link linearTicks}.\n */\nexport function niceLinearDomain(domain: NumericDomain, options: LinearTickOptions = {}): NumericDomain {\n  const { lo, hi, step } = parameters(domain, options);\n  const a = clean(Math.floor(lo / step) * step), b = clean(Math.ceil(hi / step) * step);\n  if (!Number.isFinite(a) || !Number.isFinite(b)) throw new RangeError(\"Nice linear domain exceeds finite numeric bounds.\");\n  return Object.freeze(domain[0] > domain[1] ? [b, a] : [a, b]);\n}\n/** Number formatting with explicit locale and literal unit affixes. See {@link formatNumber}. */\nexport interface NumberFormatOptions extends Intl.NumberFormatOptions {\n  /** Locale for formatting; defaults to en-US. */\n  readonly locale?: string;\n  /** Literal prefix; defaults to empty. */\n  readonly prefix?: string;\n  /** Literal suffix, including any desired space; defaults to empty. */\n  readonly suffix?: string;\n}\n/**\n * Formats a finite number with Intl precision, currency, percent, or unit options.\n * Rounded negative zero is displayed as positive zero.\n * @param value - Finite numeric value.\n * @param options - Intl options plus locale and literal affixes; default maximum fraction digits is 3.\n * @returns Formatted text. Invalid Intl options retain native errors. See {@link NumberFormatOptions}.\n */\nexport function formatNumber(value: number, options: NumberFormatOptions = {}): string {\n  if (!Number.isFinite(value)) throw new RangeError(\"formatNumber value must be finite.\");\n  const { locale = \"en-US\", prefix = \"\", suffix = \"\", ...intl } = options;\n  const formatter = new Intl.NumberFormat(locale, intl);\n  const parts = formatter.formatToParts(value);\n  const zeroDigit = Array.from(formatter.formatToParts(0).find(p => p.type === \"integer\")!.value).at(-1)!;\n  const digits = parts.filter(p => p.type === \"integer\" || p.type === \"fraction\");\n  const zero = digits.length > 0 && digits.every(p => Array.from(p.value).every(digit => digit === zeroDigit));\n  return prefix + formatter.format(zero ? 0 : value) + suffix;\n}\n"],
+  "mappings": "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",
+  "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;

package/dist/features/viz/lib/ohlc-bar-series.js

@@ -0,0 +1,168 @@
+import { jsx, jsxs } from "@pibbl/core/jsx-runtime";
+import {
+  Group,
+  Path,
+  resolveSignalValue
+} from "@pibbl/core";
+import { withHooksForbidden } from "@pibbl/core/internal";
+import { financialMarkWidth } from "./financial-geometry.js";
+import { opacity, width } from "./paint.js";
+import { finiteCoordinate, pointAccessor, pointData } from "./point-data.js";
+import { useNumericPosition } from "./series-position.js";
+import { useContinuousScale } from "./use-continuous-scale.js";
+function OhlcBarSeries({
+  data: input,
+  time: timeInput,
+  open: openInput,
+  high: highInput,
+  low: lowInput,
+  close: closeInput,
+  xScale,
+  yScale,
+  defined,
+  style: styleInput,
+  inspection,
+  pointerEvents,
+  ...events
+}) {
+  const xs = useNumericPosition(xScale), ys = useContinuousScale(yScale).get();
+  const data = pointData(resolveSignalValue(input), "OhlcBarSeries");
+  const time = pointAccessor(timeInput), open = pointAccessor(openInput), high = pointAccessor(highInput), low = pointAccessor(lowInput), close = pointAccessor(closeInput);
+  const rows = [];
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    if (defined && !defined(datum, i, data)) continue;
+    const t = time(datum, i, data), o = open(datum, i, data), h = high(datum, i, data), l = low(datum, i, data), c = close(datum, i, data);
+    if (!finiteCoordinate(t) || !finiteCoordinate(o) || !finiteCoordinate(h) || !finiteCoordinate(l) || !finiteCoordinate(c))
+      continue;
+    if (l > Math.min(o, c) || h < Math.max(o, c))
+      throw new RangeError(
+        `OhlcBarSeries: malformed OHLC at source index ${i}; require low <= open/close <= high.`
+      );
+    rows.push({
+      datum,
+      sourceIndex: i,
+      time: t,
+      open: o,
+      high: h,
+      low: l,
+      close: c,
+      x: xs.map(t)
+    });
+  }
+  const defaultWidth = financialMarkWidth(rows.map((row) => row.x));
+  const specified = typeof styleInput === "function" ? styleInput : resolveSignalValue(styleInput);
+  const marks = inspection ? [] : void 0;
+  const batches = [];
+  for (const row of rows) {
+    const style = typeof specified === "function" ? withHooksForbidden(
+      "OhlcBarSeries style callback",
+      () => specified(row.datum, row.sourceIndex, data)
+    ) : specified ?? {};
+    const markWidth = style.bandwidth === void 0 || style.bandwidth === "auto" ? defaultWidth : financialMarkWidth([], { width: style.bandwidth });
+    const halfWidth = markWidth / 2;
+    const stemLocal = Object.freeze({
+      x: row.x,
+      highY: ys.map(row.high),
+      lowY: ys.map(row.low)
+    });
+    const openTickLocal = Object.freeze({
+      x1: row.x - halfWidth,
+      x2: row.x,
+      y: ys.map(row.open)
+    });
+    const closeTickLocal = Object.freeze({
+      x1: row.x,
+      x2: row.x + halfWidth,
+      y: ys.map(row.close)
+    });
+    const stroke = style.stroke ?? "#173a35", strokeWidth = width(style.strokeWidth ?? 1, "OhlcBarSeries"), alpha = opacity(style.opacity ?? 1, "OhlcBarSeries");
+    marks?.push(
+      Object.freeze({
+        datum: row.datum,
+        sourceIndex: row.sourceIndex,
+        time: row.time,
+        open: row.open,
+        high: row.high,
+        low: row.low,
+        close: row.close,
+        anchorLocal: Object.freeze({ x: row.x, y: closeTickLocal.y }),
+        stemLocal,
+        openTickLocal,
+        closeTickLocal,
+        strokeWidthLocal: stroke && alpha > 0 ? strokeWidth : 0
+      })
+    );
+    if (alpha === 0 || !stroke) continue;
+    const xPad = strokeWidth / 2, minX = row.x - halfWidth - xPad, maxX = row.x + halfWidth + xPad;
+    let batch = batches.at(-1);
+    if (!batch || minX < batch.maxX && maxX > batch.minX || batch.stroke !== stroke || batch.strokeWidth !== strokeWidth || batch.opacity !== alpha || batch.cursor !== style.cursor) {
+      batch = {
+        stem: new Path2D(),
+        openTick: new Path2D(),
+        closeTick: new Path2D(),
+        stroke,
+        strokeWidth,
+        opacity: alpha,
+        cursor: style.cursor,
+        minX,
+        maxX
+      };
+      batches.push(batch);
+    }
+    batch.minX = Math.min(batch.minX, minX);
+    batch.maxX = Math.max(batch.maxX, maxX);
+    batch.stem.moveTo(stemLocal.x, stemLocal.highY);
+    batch.stem.lineTo(stemLocal.x, stemLocal.lowY);
+    batch.openTick.moveTo(openTickLocal.x1, openTickLocal.y);
+    batch.openTick.lineTo(openTickLocal.x2, openTickLocal.y);
+    batch.closeTick.moveTo(closeTickLocal.x1, closeTickLocal.y);
+    batch.closeTick.lineTo(closeTickLocal.x2, closeTickLocal.y);
+  }
+  inspection?.capture({ marks, xScale: xs, yScale: ys });
+  return /* @__PURE__ */ jsx(Group, { ...events, children: batches.map((batch, index) => /* @__PURE__ */ jsxs(Group, { children: [
+    /* @__PURE__ */ jsx(
+      Path,
+      {
+        pointerEvents,
+        style: {
+          d: batch.stem,
+          stroke: batch.stroke,
+          strokeWidth: batch.strokeWidth,
+          opacity: batch.opacity,
+          cursor: batch.cursor
+        }
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      Path,
+      {
+        pointerEvents,
+        style: {
+          d: batch.openTick,
+          stroke: batch.stroke,
+          strokeWidth: batch.strokeWidth,
+          opacity: batch.opacity,
+          cursor: batch.cursor
+        }
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      Path,
+      {
+        pointerEvents,
+        style: {
+          d: batch.closeTick,
+          stroke: batch.stroke,
+          strokeWidth: batch.strokeWidth,
+          opacity: batch.opacity,
+          cursor: batch.cursor
+        }
+      }
+    )
+  ] }, index)) });
+}
+export {
+  OhlcBarSeries
+};
+//# sourceMappingURL=ohlc-bar-series.js.map

package/dist/features/viz/lib/ohlc-bar-series.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/ohlc-bar-series.tsx"],
+  "sourcesContent": ["import {\n  Group,\n  Path,\n  resolveSignalValue,\n  type PibblEventHandlers,\n  type PibblEventParticipationOptions,\n  type PibblNode,\n  type SignalValue,\n  type StrokeStyle,\n} from \"@pibbl/core\";\nimport { withHooksForbidden } from \"@pibbl/core/internal\";\nimport type {\n  OhlcBarInspectionRef,\n  CapturedOhlcBarMark,\n} from \"../inspection/ohlc-bar.js\";\nimport { financialMarkWidth } from \"./financial-geometry.js\";\nimport { opacity, width } from \"./paint.js\";\nimport { finiteCoordinate, pointAccessor, pointData } from \"./point-data.js\";\nimport { useNumericPosition } from \"./series-position.js\";\nimport type { LineAccessor, ScaleId } from \"./types.js\";\nimport { useContinuousScale } from \"./use-continuous-scale.js\";\n\n/** Shared stroke presentation for an OHLC bar.\n * @see {@link OhlcBarSeries}\n */\nexport interface OhlcBarSeriesStyle {\n  /** Positive total width, or automatic 70% spacing capped at 12; singleton fallback 8. */ readonly bandwidth?:\n    number | \"auto\";\n  /** Stem and tick stroke; defaults to dark teal. Empty string disables painting. */ readonly stroke?: StrokeStyle;\n  /** Nonnegative local stroke width; default 1. */ readonly strokeWidth?: number;\n  /** Paint opacity from zero through one; default 1. */ readonly opacity?: number;\n  /** Cursor while the series owns targeting. */ readonly cursor?: string;\n}\n\n/** Source-ordered OHLC records rendered as a high/low stem with open/close ticks.\n * @see {@link OhlcBarSeries}\n */\nexport interface OhlcBarSeriesProps<D>\n  extends PibblEventHandlers, PibblEventParticipationOptions {\n  /** Original records or signal; never sorted or mutated. */\n  readonly data: SignalValue<readonly D[]>;\n  /** UTC-millisecond property or callback. */\n  readonly time: LineAccessor<D>;\n  /** Opening price property or callback. */\n  readonly open: LineAccessor<D>;\n  /** High price property or callback. */\n  readonly high: LineAccessor<D>;\n  /** Low price property or callback. */\n  readonly low: LineAccessor<D>;\n  /** Closing price property or callback. */\n  readonly close: LineAccessor<D>;\n  /** Numeric, UTC, or trading-time horizontal mapping identity. */\n  readonly xScale: ScaleId;\n  /** Continuous price mapping identity. */\n  readonly yScale: ScaleId;\n  /** Tests original rows before accessor evaluation.\n   * @param datum - Original row.\n   * @param index - Source index including skipped rows.\n   * @param data - Complete source array.\n   * @returns Whether the bar participates.\n   */\n  readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;\n  /** Shared presentation or a hook-free original-row resolver.\n   * @param datum - Original row.\n   * @param index - Source index.\n   * @param data - Complete source array.\n   * @returns Plain OHLC-bar style.\n   */\n  readonly style?:\n    | SignalValue<OhlcBarSeriesStyle>\n    | ((datum: D, index: number, data: readonly D[]) => OhlcBarSeriesStyle);\n  /** Optional committed capture; the renderer does not execute inspection queries. */ readonly inspection?: OhlcBarInspectionRef<D>;\n}\n\n/** Paints source-ordered OHLC bars with a high/low stem, left open tick, and right close tick.\n * @param props - Original OHLC accessors, scales, styles, events, and optional capture.\n * @returns Ordinary Pibbl composition; equal disjoint styles share paths.\n * @see {@link OhlcBarSeriesProps}\n */\nexport function OhlcBarSeries<D>({\n  data: input,\n  time: timeInput,\n  open: openInput,\n  high: highInput,\n  low: lowInput,\n  close: closeInput,\n  xScale,\n  yScale,\n  defined,\n  style: styleInput,\n  inspection,\n  pointerEvents,\n  ...events\n}: OhlcBarSeriesProps<D>): PibblNode {\n  const xs = useNumericPosition(xScale),\n    ys = useContinuousScale(yScale).get();\n  const data = pointData(resolveSignalValue(input), \"OhlcBarSeries\");\n  const time = pointAccessor(timeInput),\n    open = pointAccessor(openInput),\n    high = pointAccessor(highInput),\n    low = pointAccessor(lowInput),\n    close = pointAccessor(closeInput);\n  const rows: {\n    datum: D;\n    sourceIndex: number;\n    time: number;\n    open: number;\n    high: number;\n    low: number;\n    close: number;\n    x: number;\n  }[] = [];\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !defined(datum, i, data)) continue;\n    const t = time(datum, i, data),\n      o = open(datum, i, data),\n      h = high(datum, i, data),\n      l = low(datum, i, data),\n      c = close(datum, i, data);\n    if (\n      !finiteCoordinate(t) ||\n      !finiteCoordinate(o) ||\n      !finiteCoordinate(h) ||\n      !finiteCoordinate(l) ||\n      !finiteCoordinate(c)\n    )\n      continue;\n    if (l > Math.min(o, c) || h < Math.max(o, c))\n      throw new RangeError(\n        `OhlcBarSeries: malformed OHLC at source index ${i}; require low <= open/close <= high.`,\n      );\n    rows.push({\n      datum,\n      sourceIndex: i,\n      time: t,\n      open: o,\n      high: h,\n      low: l,\n      close: c,\n      x: xs.map(t),\n    });\n  }\n  const defaultWidth = financialMarkWidth(rows.map((row) => row.x));\n  const specified =\n    typeof styleInput === \"function\"\n      ? styleInput\n      : resolveSignalValue(styleInput);\n  const marks: CapturedOhlcBarMark<D>[] | undefined = inspection\n    ? []\n    : undefined;\n  const batches: {\n    stem: Path2D;\n    openTick: Path2D;\n    closeTick: Path2D;\n    stroke: StrokeStyle;\n    strokeWidth: number;\n    opacity: number;\n    cursor: string | undefined;\n    minX: number;\n    maxX: number;\n  }[] = [];\n  for (const row of rows) {\n    const style =\n      typeof specified === \"function\"\n        ? withHooksForbidden(\"OhlcBarSeries style callback\", () =>\n            specified(row.datum, row.sourceIndex, data),\n          )\n        : (specified ?? {});\n    const markWidth =\n      style.bandwidth === undefined || style.bandwidth === \"auto\"\n        ? defaultWidth\n        : financialMarkWidth([], { width: style.bandwidth });\n    const halfWidth = markWidth / 2;\n    const stemLocal = Object.freeze({\n      x: row.x,\n      highY: ys.map(row.high),\n      lowY: ys.map(row.low),\n    });\n    const openTickLocal = Object.freeze({\n      x1: row.x - halfWidth,\n      x2: row.x,\n      y: ys.map(row.open),\n    });\n    const closeTickLocal = Object.freeze({\n      x1: row.x,\n      x2: row.x + halfWidth,\n      y: ys.map(row.close),\n    });\n    const stroke = style.stroke ?? \"#173a35\",\n      strokeWidth = width(style.strokeWidth ?? 1, \"OhlcBarSeries\"),\n      alpha = opacity(style.opacity ?? 1, \"OhlcBarSeries\");\n    marks?.push(\n      Object.freeze({\n        datum: row.datum,\n        sourceIndex: row.sourceIndex,\n        time: row.time,\n        open: row.open,\n        high: row.high,\n        low: row.low,\n        close: row.close,\n        anchorLocal: Object.freeze({ x: row.x, y: closeTickLocal.y }),\n        stemLocal,\n        openTickLocal,\n        closeTickLocal,\n        strokeWidthLocal: stroke && alpha > 0 ? strokeWidth : 0,\n      }),\n    );\n    if (alpha === 0 || !stroke) continue;\n    const xPad = strokeWidth / 2,\n      minX = row.x - halfWidth - xPad,\n      maxX = row.x + halfWidth + xPad;\n    let batch = batches.at(-1);\n    if (\n      !batch ||\n      (minX < batch.maxX && maxX > batch.minX) ||\n      batch.stroke !== stroke ||\n      batch.strokeWidth !== strokeWidth ||\n      batch.opacity !== alpha ||\n      batch.cursor !== style.cursor\n    ) {\n      batch = {\n        stem: new Path2D(),\n        openTick: new Path2D(),\n        closeTick: new Path2D(),\n        stroke,\n        strokeWidth,\n        opacity: alpha,\n        cursor: style.cursor,\n        minX,\n        maxX,\n      };\n      batches.push(batch);\n    }\n    batch.minX = Math.min(batch.minX, minX);\n    batch.maxX = Math.max(batch.maxX, maxX);\n    batch.stem.moveTo(stemLocal.x, stemLocal.highY);\n    batch.stem.lineTo(stemLocal.x, stemLocal.lowY);\n    batch.openTick.moveTo(openTickLocal.x1, openTickLocal.y);\n    batch.openTick.lineTo(openTickLocal.x2, openTickLocal.y);\n    batch.closeTick.moveTo(closeTickLocal.x1, closeTickLocal.y);\n    batch.closeTick.lineTo(closeTickLocal.x2, closeTickLocal.y);\n  }\n  inspection?.capture({ marks: marks!, xScale: xs, yScale: ys });\n  return (\n    <Group {...events}>\n      {batches.map((batch, index) => (\n        <Group key={index}>\n          <Path\n            pointerEvents={pointerEvents}\n            style={{\n              d: batch.stem,\n              stroke: batch.stroke,\n              strokeWidth: batch.strokeWidth,\n              opacity: batch.opacity,\n              cursor: batch.cursor,\n            }}\n          />\n          <Path\n            pointerEvents={pointerEvents}\n            style={{\n              d: batch.openTick,\n              stroke: batch.stroke,\n              strokeWidth: batch.strokeWidth,\n              opacity: batch.opacity,\n              cursor: batch.cursor,\n            }}\n          />\n          <Path\n            pointerEvents={pointerEvents}\n            style={{\n              d: batch.closeTick,\n              stroke: batch.stroke,\n              strokeWidth: batch.strokeWidth,\n              opacity: batch.opacity,\n              cursor: batch.cursor,\n            }}\n          />\n        </Group>\n      ))}\n    </Group>\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,44 @@
+import type { PibblEventHandlers, PibblEventParticipationOptions, SignalValue } from "@pibbl/core";
+import type { SignalStyle } from "@pibbl/core/internal";
+import type { LineAccessor, ScaleId, SeriesCoordinate } from "./types.js";
+import type { TrajectorySeriesStyle } from "./trajectory-series.js";
+/** Shared connector appearance for {@link PairedSeries}. */
+export type PairedSeriesStyle = TrajectorySeriesStyle;
+/** Authored wide-record inputs for {@link PairedSeries}. */
+export interface PairedSeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /** Source records or a signal containing them. */
+    readonly data: SignalValue<readonly D[]>;
+    /** Numeric baseline or first-observation value. */
+    readonly before: LineAccessor<D>;
+    /** Numeric follow-up or second-observation value. */
+    readonly after: LineAccessor<D>;
+    /** Fixed x coordinate used for every `before` endpoint. */
+    readonly beforeX: SeriesCoordinate;
+    /** Fixed x coordinate used for every `after` endpoint. */
+    readonly afterX: SeriesCoordinate;
+    /** Scale mapping the two endpoint coordinates. */
+    readonly xScale: ScaleId;
+    /** Numeric scale mapping both endpoint values. */
+    readonly yScale: ScaleId;
+    /**
+     * Excludes a record before before/after accessors run.
+     * @param datum - Candidate source datum.
+     * @param index - Zero-based source index.
+     * @param data - Complete source data array.
+     * @returns Whether this record contributes a connector.
+     */
+    readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;
+    /** Shared connector style, including whole-object and shallow field signals. */
+    readonly style?: SignalValue<SignalStyle<PairedSeriesStyle>>;
+}
+/**
+ * Draws a connector for each complete wide-record before/after pair.
+ *
+ * The component does not manufacture point marks, calculate change, select a
+ * baseline, or impute missing observations. Compose `PointSeries` for endpoints.
+ *
+ * @param props - Wide records, endpoint accessors and coordinates, scales, and shared paint.
+ * @returns One batched ordinary Pibbl path containing source-ordered pair connectors.
+ * @see {@link PairedSeriesProps}
+ */
+export declare function PairedSeries<D>({ data: input, before: beforeInput, after: afterInput, beforeX, afterX, xScale: xId, yScale: yId, defined, style: styleInput, ...events }: PairedSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;

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

@@ -0,0 +1,93 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import { Path, resolveSignalValue } from "@pibbl/core";
+import { withHooksForbidden } from "@pibbl/core/internal";
+import { pointAccessor, pointData } from "./point-data.js";
+import { opacity, width } from "./paint.js";
+import {
+  mapSeriesPosition,
+  useNumericPosition,
+  useSeriesPosition
+} from "./series-position.js";
+function style(input) {
+  if (input === null || typeof input !== "object" || Array.isArray(input))
+    throw new TypeError("PairedSeries: style must be an object.");
+  const value = input;
+  for (const field of Object.keys(value))
+    if (![
+      "stroke",
+      "strokeWidth",
+      "lineInteractionWidth",
+      "opacity",
+      "cursor"
+    ].includes(field))
+      throw new TypeError(`PairedSeries: unsupported style field ${field}.`);
+  const stroke = resolveSignalValue(value.stroke) ?? "#2563eb";
+  const strokeWidth = width(
+    resolveSignalValue(value.strokeWidth) ?? 2,
+    "PairedSeries strokeWidth"
+  );
+  const lineInteractionWidth = width(
+    resolveSignalValue(value.lineInteractionWidth) ?? strokeWidth,
+    "PairedSeries lineInteractionWidth"
+  );
+  const cursor = resolveSignalValue(value.cursor);
+  if (cursor !== void 0 && typeof cursor !== "string")
+    throw new TypeError("PairedSeries: cursor must be a string.");
+  return {
+    stroke,
+    strokeWidth,
+    lineInteractionWidth,
+    opacity: opacity(
+      resolveSignalValue(value.opacity) ?? 1,
+      "PairedSeries opacity"
+    ),
+    cursor
+  };
+}
+function PairedSeries({
+  data: input,
+  before: beforeInput,
+  after: afterInput,
+  beforeX,
+  afterX,
+  xScale: xId,
+  yScale: yId,
+  defined,
+  style: styleInput,
+  ...events
+}) {
+  const xs = useSeriesPosition(xId);
+  const ys = useNumericPosition(yId);
+  const data = pointData(resolveSignalValue(input), "PairedSeries");
+  const before = pointAccessor(beforeInput);
+  const after = pointAccessor(afterInput);
+  const startX = mapSeriesPosition(xs, beforeX);
+  const endX = mapSeriesPosition(xs, afterX);
+  const resolved = style(resolveSignalValue(styleInput) ?? {});
+  const path = new Path2D();
+  if (startX !== void 0 && endX !== void 0)
+    for (let i = 0; i < data.length; i++) {
+      const datum = data[i];
+      const row = withHooksForbidden(
+        "PairedSeries: accessors cannot call hooks.",
+        () => {
+          if (defined && !defined(datum, i, data)) return void 0;
+          return {
+            before: before(datum, i, data),
+            after: after(datum, i, data)
+          };
+        }
+      );
+      if (!row) continue;
+      const startY = mapSeriesPosition(ys, row.before);
+      const endY = mapSeriesPosition(ys, row.after);
+      if (startY === void 0 || endY === void 0) continue;
+      path.moveTo(startX, startY);
+      path.lineTo(endX, endY);
+    }
+  return /* @__PURE__ */ jsx(Path, { ...events, style: { d: path, ...resolved } });
+}
+export {
+  PairedSeries
+};
+//# sourceMappingURL=paired-series.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/paired-series.tsx"],
+  "sourcesContent": ["import { Path, resolveSignalValue } from \"@pibbl/core\";\nimport type {\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n  SignalValue,\n  StrokeStyle,\n} from \"@pibbl/core\";\nimport { withHooksForbidden } from \"@pibbl/core/internal\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { LineAccessor, ScaleId, SeriesCoordinate } from \"./types.js\";\nimport type { TrajectorySeriesStyle } from \"./trajectory-series.js\";\nimport { pointAccessor, pointData } from \"./point-data.js\";\nimport { opacity, width } from \"./paint.js\";\nimport {\n  mapSeriesPosition,\n  useNumericPosition,\n  useSeriesPosition,\n} from \"./series-position.js\";\n\n/** Shared connector appearance for {@link PairedSeries}. */\nexport type PairedSeriesStyle = TrajectorySeriesStyle;\n\n/** Authored wide-record inputs for {@link PairedSeries}. */\nexport interface PairedSeriesProps<D>\n  extends PibblEventHandlers, PibblEventParticipationOptions {\n  /** Source records or a signal containing them. */\n  readonly data: SignalValue<readonly D[]>;\n  /** Numeric baseline or first-observation value. */\n  readonly before: LineAccessor<D>;\n  /** Numeric follow-up or second-observation value. */\n  readonly after: LineAccessor<D>;\n  /** Fixed x coordinate used for every `before` endpoint. */\n  readonly beforeX: SeriesCoordinate;\n  /** Fixed x coordinate used for every `after` endpoint. */\n  readonly afterX: SeriesCoordinate;\n  /** Scale mapping the two endpoint coordinates. */\n  readonly xScale: ScaleId;\n  /** Numeric scale mapping both endpoint values. */\n  readonly yScale: ScaleId;\n  /**\n   * Excludes a record before before/after accessors run.\n   * @param datum - Candidate source datum.\n   * @param index - Zero-based source index.\n   * @param data - Complete source data array.\n   * @returns Whether this record contributes a connector.\n   */\n  readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;\n  /** Shared connector style, including whole-object and shallow field signals. */\n  readonly style?: SignalValue<SignalStyle<PairedSeriesStyle>>;\n}\n\ninterface ResolvedPairedStyle {\n  readonly stroke: StrokeStyle;\n  readonly strokeWidth: number;\n  readonly lineInteractionWidth: number;\n  readonly opacity: number;\n  readonly cursor?: string;\n}\n\nfunction style(input: unknown): ResolvedPairedStyle {\n  if (input === null || typeof input !== \"object\" || Array.isArray(input))\n    throw new TypeError(\"PairedSeries: style must be an object.\");\n  const value = input as Record<string, unknown>;\n  for (const field of Object.keys(value))\n    if (\n      ![\n        \"stroke\",\n        \"strokeWidth\",\n        \"lineInteractionWidth\",\n        \"opacity\",\n        \"cursor\",\n      ].includes(field)\n    )\n      throw new TypeError(`PairedSeries: unsupported style field ${field}.`);\n  const stroke = resolveSignalValue(value.stroke) ?? \"#2563eb\";\n  const strokeWidth = width(\n    (resolveSignalValue(value.strokeWidth) ?? 2) as number,\n    \"PairedSeries strokeWidth\",\n  );\n  const lineInteractionWidth = width(\n    (resolveSignalValue(value.lineInteractionWidth) ?? strokeWidth) as number,\n    \"PairedSeries lineInteractionWidth\",\n  );\n  const cursor = resolveSignalValue(value.cursor);\n  if (cursor !== undefined && typeof cursor !== \"string\")\n    throw new TypeError(\"PairedSeries: cursor must be a string.\");\n  return {\n    stroke: stroke as StrokeStyle,\n    strokeWidth,\n    lineInteractionWidth,\n    opacity: opacity(\n      (resolveSignalValue(value.opacity) ?? 1) as number,\n      \"PairedSeries opacity\",\n    ),\n    cursor,\n  };\n}\n\n/**\n * Draws a connector for each complete wide-record before/after pair.\n *\n * The component does not manufacture point marks, calculate change, select a\n * baseline, or impute missing observations. Compose `PointSeries` for endpoints.\n *\n * @param props - Wide records, endpoint accessors and coordinates, scales, and shared paint.\n * @returns One batched ordinary Pibbl path containing source-ordered pair connectors.\n * @see {@link PairedSeriesProps}\n */\nexport function PairedSeries<D>({\n  data: input,\n  before: beforeInput,\n  after: afterInput,\n  beforeX,\n  afterX,\n  xScale: xId,\n  yScale: yId,\n  defined,\n  style: styleInput,\n  ...events\n}: PairedSeriesProps<D>) {\n  const xs = useSeriesPosition(xId);\n  const ys = useNumericPosition(yId);\n  const data = pointData(resolveSignalValue(input), \"PairedSeries\");\n  const before = pointAccessor(beforeInput);\n  const after = pointAccessor(afterInput);\n  const startX = mapSeriesPosition(xs, beforeX);\n  const endX = mapSeriesPosition(xs, afterX);\n  const resolved = style(resolveSignalValue(styleInput) ?? {});\n  const path = new Path2D();\n  if (startX !== undefined && endX !== undefined)\n    for (let i = 0; i < data.length; i++) {\n      const datum = data[i];\n      const row = withHooksForbidden(\n        \"PairedSeries: accessors cannot call hooks.\",\n        () => {\n          if (defined && !defined(datum, i, data)) return undefined;\n          return {\n            before: before(datum, i, data),\n            after: after(datum, i, data),\n          };\n        },\n      );\n      if (!row) continue;\n      const startY = mapSeriesPosition(ys, row.before);\n      const endY = mapSeriesPosition(ys, row.after);\n      if (startY === undefined || endY === undefined) continue;\n      path.moveTo(startX, startY);\n      path.lineTo(endX, endY);\n    }\n  return <Path {...events} style={{ d: path, ...resolved }} />;\n}\n"],
+  "mappings": "AAqJS;AArJT,SAAS,MAAM,0BAA0B;AAOzC,SAAS,0BAA0B;AAInC,SAAS,eAAe,iBAAiB;AACzC,SAAS,SAAS,aAAa;AAC/B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA0CP,SAAS,MAAM,OAAqC;AAClD,MAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK;AACpE,UAAM,IAAI,UAAU,wCAAwC;AAC9D,QAAM,QAAQ;AACd,aAAW,SAAS,OAAO,KAAK,KAAK;AACnC,QACE,CAAC;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,SAAS,KAAK;AAEhB,YAAM,IAAI,UAAU,yCAAyC,KAAK,GAAG;AACzE,QAAM,SAAS,mBAAmB,MAAM,MAAM,KAAK;AACnD,QAAM,cAAc;AAAA,IACjB,mBAAmB,MAAM,WAAW,KAAK;AAAA,IAC1C;AAAA,EACF;AACA,QAAM,uBAAuB;AAAA,IAC1B,mBAAmB,MAAM,oBAAoB,KAAK;AAAA,IACnD;AAAA,EACF;AACA,QAAM,SAAS,mBAAmB,MAAM,MAAM;AAC9C,MAAI,WAAW,UAAa,OAAO,WAAW;AAC5C,UAAM,IAAI,UAAU,wCAAwC;AAC9D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,MACN,mBAAmB,MAAM,OAAO,KAAK;AAAA,MACtC;AAAA,IACF;AAAA,IACA;AAAA,EACF;AACF;AAYO,SAAS,aAAgB;AAAA,EAC9B,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR;AAAA,EACA,OAAO;AAAA,EACP,GAAG;AACL,GAAyB;AACvB,QAAM,KAAK,kBAAkB,GAAG;AAChC,QAAM,KAAK,mBAAmB,GAAG;AACjC,QAAM,OAAO,UAAU,mBAAmB,KAAK,GAAG,cAAc;AAChE,QAAM,SAAS,cAAc,WAAW;AACxC,QAAM,QAAQ,cAAc,UAAU;AACtC,QAAM,SAAS,kBAAkB,IAAI,OAAO;AAC5C,QAAM,OAAO,kBAAkB,IAAI,MAAM;AACzC,QAAM,WAAW,MAAM,mBAAmB,UAAU,KAAK,CAAC,CAAC;AAC3D,QAAM,OAAO,IAAI,OAAO;AACxB,MAAI,WAAW,UAAa,SAAS;AACnC,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,YAAM,QAAQ,KAAK,CAAC;AACpB,YAAM,MAAM;AAAA,QACV;AAAA,QACA,MAAM;AACJ,cAAI,WAAW,CAAC,QAAQ,OAAO,GAAG,IAAI,EAAG,QAAO;AAChD,iBAAO;AAAA,YACL,QAAQ,OAAO,OAAO,GAAG,IAAI;AAAA,YAC7B,OAAO,MAAM,OAAO,GAAG,IAAI;AAAA,UAC7B;AAAA,QACF;AAAA,MACF;AACA,UAAI,CAAC,IAAK;AACV,YAAM,SAAS,kBAAkB,IAAI,IAAI,MAAM;AAC/C,YAAM,OAAO,kBAAkB,IAAI,IAAI,KAAK;AAC5C,UAAI,WAAW,UAAa,SAAS,OAAW;AAChD,WAAK,OAAO,QAAQ,MAAM;AAC1B,WAAK,OAAO,MAAM,IAAI;AAAA,IACxB;AACF,SAAO,oBAAC,QAAM,GAAG,QAAQ,OAAO,EAAE,GAAG,MAAM,GAAG,SAAS,GAAG;AAC5D;",
+  "names": []
+}

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

@@ -1,7 +1,11 @@
 import { jsx } from "@pibbl/core/jsx-runtime";
 import { Group, resolveSignalValue } from "@pibbl/core";
-import { pointAccessor, pointData, finiteCoordinate } from "./point-data.js";
-import { useScale } from "./use-scale.js";
+import { pointData } from "./point-data.js";
+import {
+  useSeriesPosition,
+  seriesAccessor,
+  mapSeriesPosition
+} from "./series-position.js";
 function PlotRow({
   datum,
   index,
@@ -21,19 +25,20 @@ function PlotSeries({
   render,
   ...events
 }) {
-  const xs = useScale(xId).get(), ys = useScale(yId).get();
+  const xs = useSeriesPosition(xId), ys = useSeriesPosition(yId);
   const data = pointData(resolveSignalValue(input), "PlotSeries");
   if (typeof render !== "function")
     throw new TypeError("PlotSeries: render must be a synchronous function.");
-  const x = pointAccessor(xInput), y = pointAccessor(yInput);
+  const x = seriesAccessor(xInput), y = seriesAccessor(yInput);
   const keys = /* @__PURE__ */ new Set();
   const nodes = [];
   for (let i = 0; i < data.length; i++) {
     const datum = data[i];
     if (defined && !defined(datum, i, data)) continue;
     const xv = x(datum, i, data), yv = y(datum, i, data);
-    if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) continue;
-    const px = xs.map(xv), py = ys.map(yv);
+    const mappedX = mapSeriesPosition(xs, xv), mappedY = mapSeriesPosition(ys, yv);
+    if (mappedX === void 0 || mappedY === void 0) continue;
+    const px = mappedX, py = mappedY;
     const key = keyBy === void 0 ? i : typeof keyBy === "function" ? keyBy(datum, i, data) : datum[keyBy];
     if (typeof key !== "string" && typeof key !== "number")
       throw new TypeError("PlotSeries: keyBy must return a string or number.");

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/viz/lib/plot-series.tsx"],
-  "sourcesContent": ["import { Group, resolveSignalValue } from \"@pibbl/core\";\nimport type { PibblNode } from \"@pibbl/core\";\nimport type { PlotSeriesProps } from \"./plot-types.js\";\nimport { pointAccessor, pointData, finiteCoordinate } from \"./point-data.js\";\nimport { useScale } from \"./use-scale.js\";\nfunction PlotRow<D>({\n  datum,\n  index,\n  data,\n  render,\n}: {\n  datum: D;\n  index: number;\n  data: readonly D[];\n  render: PlotSeriesProps<D>[\"render\"];\n}): PibblNode {\n  return render(datum, index, data);\n}\n/**\n * Places keyed custom Pibbl subtrees at local data coordinates.\n *\n * @param props - Data, coordinate accessors, scales, keys, and per-datum renderer. See\n * {@link PlotSeriesProps} .\n * @returns Pibbl nodes placing each rendered datum at its mapped coordinates. See {@link PibblNode}.\n *\n * @see {@link PlotSeriesProps}\n * @see {@link PibblNode}\n */\nexport function PlotSeries<D>({\n  data: input,\n  x: xInput,\n  y: yInput,\n  xScale: xId,\n  yScale: yId,\n  defined,\n  keyBy,\n  render,\n  ...events\n}: PlotSeriesProps<D>): PibblNode {\n  const xs = useScale(xId).get(),\n    ys = useScale(yId).get();\n  const data = pointData(resolveSignalValue(input), \"PlotSeries\");\n  if (typeof render !== \"function\")\n    throw new TypeError(\"PlotSeries: render must be a synchronous function.\");\n  const x = pointAccessor(xInput),\n    y = pointAccessor(yInput);\n  const keys = new Set<string>();\n  const nodes: PibblNode[] = [];\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !defined(datum, i, data)) continue;\n    const xv = x(datum, i, data),\n      yv = y(datum, i, data);\n    if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) continue;\n    const px = xs.map(xv),\n      py = ys.map(yv);\n    const key =\n      keyBy === undefined\n        ? i\n        : typeof keyBy === \"function\"\n          ? keyBy(datum, i, data)\n          : datum[keyBy];\n    if (typeof key !== \"string\" && typeof key !== \"number\")\n      throw new TypeError(\"PlotSeries: keyBy must return a string or number.\");\n    const normalized = String(key);\n    if (keys.has(normalized))\n      throw new Error(`PlotSeries: duplicate key \"${normalized}\".`);\n    keys.add(normalized);\n    nodes.push(\n      <Group key={normalized} style={{ translateX: px, translateY: py }}>\n        <PlotRow datum={datum} index={i} data={data} render={render} />\n      </Group>,\n    );\n  }\n  return <Group {...events}>{nodes}</Group>;\n}\n"],
-  "mappings": "AAsEQ;AAtER,SAAS,OAAO,0BAA0B;AAG1C,SAAS,eAAe,WAAW,wBAAwB;AAC3D,SAAS,gBAAgB;AACzB,SAAS,QAAW;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKc;AACZ,SAAO,OAAO,OAAO,OAAO,IAAI;AAClC;AAWO,SAAS,WAAc;AAAA,EAC5B,MAAM;AAAA,EACN,GAAG;AAAA,EACH,GAAG;AAAA,EACH,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAkC;AAChC,QAAM,KAAK,SAAS,GAAG,EAAE,IAAI,GAC3B,KAAK,SAAS,GAAG,EAAE,IAAI;AACzB,QAAM,OAAO,UAAU,mBAAmB,KAAK,GAAG,YAAY;AAC9D,MAAI,OAAO,WAAW;AACpB,UAAM,IAAI,UAAU,oDAAoD;AAC1E,QAAM,IAAI,cAAc,MAAM,GAC5B,IAAI,cAAc,MAAM;AAC1B,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,QAAqB,CAAC;AAC5B,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,QAAQ,KAAK,CAAC;AACpB,QAAI,WAAW,CAAC,QAAQ,OAAO,GAAG,IAAI,EAAG;AACzC,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,GAAG,IAAI,EAAE,GAClB,KAAK,GAAG,IAAI,EAAE;AAChB,UAAM,MACJ,UAAU,SACN,IACA,OAAO,UAAU,aACf,MAAM,OAAO,GAAG,IAAI,IACpB,MAAM,KAAK;AACnB,QAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ;AAC5C,YAAM,IAAI,UAAU,mDAAmD;AACzE,UAAM,aAAa,OAAO,GAAG;AAC7B,QAAI,KAAK,IAAI,UAAU;AACrB,YAAM,IAAI,MAAM,8BAA8B,UAAU,IAAI;AAC9D,SAAK,IAAI,UAAU;AACnB,UAAM;AAAA,MACJ,oBAAC,SAAuB,OAAO,EAAE,YAAY,IAAI,YAAY,GAAG,GAC9D,8BAAC,WAAQ,OAAc,OAAO,GAAG,MAAY,QAAgB,KADnD,UAEZ;AAAA,IACF;AAAA,EACF;AACA,SAAO,oBAAC,SAAO,GAAG,QAAS,iBAAM;AACnC;",
+  "sourcesContent": ["import { Group, resolveSignalValue } from \"@pibbl/core\";\nimport type { PibblNode } from \"@pibbl/core\";\nimport type { PlotSeriesProps } from \"./plot-types.js\";\nimport { pointData } from \"./point-data.js\";\nimport {\n  useSeriesPosition,\n  seriesAccessor,\n  mapSeriesPosition,\n} from \"./series-position.js\";\nfunction PlotRow<D>({\n  datum,\n  index,\n  data,\n  render,\n}: {\n  datum: D;\n  index: number;\n  data: readonly D[];\n  render: PlotSeriesProps<D>[\"render\"];\n}): PibblNode {\n  return render(datum, index, data);\n}\n/**\n * Places keyed custom Pibbl subtrees at local data coordinates.\n *\n * @param props - Data, coordinate accessors, scales, keys, and per-datum renderer. See\n * {@link PlotSeriesProps} .\n * @returns Pibbl nodes placing each rendered datum at its mapped coordinates. See {@link PibblNode}.\n *\n * @see {@link PlotSeriesProps}\n * @see {@link PibblNode}\n */\nexport function PlotSeries<D>({\n  data: input,\n  x: xInput,\n  y: yInput,\n  xScale: xId,\n  yScale: yId,\n  defined,\n  keyBy,\n  render,\n  ...events\n}: PlotSeriesProps<D>): PibblNode {\n  const xs = useSeriesPosition(xId),\n    ys = useSeriesPosition(yId);\n  const data = pointData(resolveSignalValue(input), \"PlotSeries\");\n  if (typeof render !== \"function\")\n    throw new TypeError(\"PlotSeries: render must be a synchronous function.\");\n  const x = seriesAccessor(xInput),\n    y = seriesAccessor(yInput);\n  const keys = new Set<string>();\n  const nodes: PibblNode[] = [];\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !defined(datum, i, data)) continue;\n    const xv = x(datum, i, data),\n      yv = y(datum, i, data);\n    const mappedX = mapSeriesPosition(xs, xv),\n      mappedY = mapSeriesPosition(ys, yv);\n    if (mappedX === undefined || mappedY === undefined) continue;\n    const px = mappedX,\n      py = mappedY;\n    const key =\n      keyBy === undefined\n        ? i\n        : typeof keyBy === \"function\"\n          ? keyBy(datum, i, data)\n          : datum[keyBy];\n    if (typeof key !== \"string\" && typeof key !== \"number\")\n      throw new TypeError(\"PlotSeries: keyBy must return a string or number.\");\n    const normalized = String(key);\n    if (keys.has(normalized))\n      throw new Error(`PlotSeries: duplicate key \"${normalized}\".`);\n    keys.add(normalized);\n    nodes.push(\n      <Group key={normalized} style={{ translateX: px, translateY: py }}>\n        <PlotRow datum={datum} index={i} data={data} render={render} />\n      </Group>,\n    );\n  }\n  return <Group {...events}>{nodes}</Group>;\n}\n"],
+  "mappings": "AA4EQ;AA5ER,SAAS,OAAO,0BAA0B;AAG1C,SAAS,iBAAiB;AAC1B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,QAAW;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKc;AACZ,SAAO,OAAO,OAAO,OAAO,IAAI;AAClC;AAWO,SAAS,WAAc;AAAA,EAC5B,MAAM;AAAA,EACN,GAAG;AAAA,EACH,GAAG;AAAA,EACH,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAkC;AAChC,QAAM,KAAK,kBAAkB,GAAG,GAC9B,KAAK,kBAAkB,GAAG;AAC5B,QAAM,OAAO,UAAU,mBAAmB,KAAK,GAAG,YAAY;AAC9D,MAAI,OAAO,WAAW;AACpB,UAAM,IAAI,UAAU,oDAAoD;AAC1E,QAAM,IAAI,eAAe,MAAM,GAC7B,IAAI,eAAe,MAAM;AAC3B,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,QAAqB,CAAC;AAC5B,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,QAAQ,KAAK,CAAC;AACpB,QAAI,WAAW,CAAC,QAAQ,OAAO,GAAG,IAAI,EAAG;AACzC,UAAM,KAAK,EAAE,OAAO,GAAG,IAAI,GACzB,KAAK,EAAE,OAAO,GAAG,IAAI;AACvB,UAAM,UAAU,kBAAkB,IAAI,EAAE,GACtC,UAAU,kBAAkB,IAAI,EAAE;AACpC,QAAI,YAAY,UAAa,YAAY,OAAW;AACpD,UAAM,KAAK,SACT,KAAK;AACP,UAAM,MACJ,UAAU,SACN,IACA,OAAO,UAAU,aACf,MAAM,OAAO,GAAG,IAAI,IACpB,MAAM,KAAK;AACnB,QAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ;AAC5C,YAAM,IAAI,UAAU,mDAAmD;AACzE,UAAM,aAAa,OAAO,GAAG;AAC7B,QAAI,KAAK,IAAI,UAAU;AACrB,YAAM,IAAI,MAAM,8BAA8B,UAAU,IAAI;AAC9D,SAAK,IAAI,UAAU;AACnB,UAAM;AAAA,MACJ,oBAAC,SAAuB,OAAO,EAAE,YAAY,IAAI,YAAY,GAAG,GAC9D,8BAAC,WAAQ,OAAc,OAAO,GAAG,MAAY,QAAgB,KADnD,UAEZ;AAAA,IACF;AAAA,EACF;AACA,SAAO,oBAAC,SAAO,GAAG,QAAS,iBAAM;AACnC;",
   "names": []
 }

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

@@ -1,7 +1,8 @@
 import type { PlotSeries } from "./plot-series.js";
 import type { PieOptions } from "./pie-slices.js";
-import type { PibblEventHandlers, PibblNode, SignalValue } from "@pibbl/core";
 import type { PointAccessor } from "./point-types.js";
+import type { SeriesAccessor } from "./types.js";
+import type { PibblEventHandlers, PibblNode, SignalValue } from "@pibbl/core";
 import type { ScaleId } from "./types.js";
 /**
  * A property or callback that provides stable identity for a plotted datum.
@@ -34,9 +35,9 @@ export interface PlotSeriesProps<D> extends PibblEventHandlers {
      */
     readonly data: SignalValue<readonly D[]>;
     /** Property key or callback extracting the horizontal domain coordinate. See {@link PointAccessor}. */
-    readonly x: PointAccessor<D>;
+    readonly x: SeriesAccessor<D>;
     /** Property key or callback extracting the vertical domain coordinate. See {@link PointAccessor}. */
-    readonly y: PointAccessor<D>;
+    readonly y: SeriesAccessor<D>;
     /** The scale used to map horizontal data coordinates. See {@link ScaleId}. */
     readonly xScale: ScaleId;
     /** The scale used to map vertical data coordinates. See {@link ScaleId}. */

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

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