@pibbl/core 0.0.1 → 0.0.3-alpha.85.1

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

@@ -0,0 +1,136 @@
+import { Fragment, jsx } from "@pibbl/core/jsx-runtime";
+import { Path, resolveSignalValue } from "@pibbl/core";
+import { useInternalValueMemoSlot, validateTexturePaint } from "@pibbl/core/internal";
+import { useNumericPosition } from "./series-position.js";
+import { opacity, width } from "./paint.js";
+import { finiteCoordinate, pointAccessor, pointData } from "./point-data.js";
+function fill(value, receiver) {
+  if (typeof value === "string" || value instanceof CanvasGradient || value instanceof CanvasPattern)
+    return value;
+  try {
+    validateTexturePaint(value);
+    return value;
+  } catch {
+    throw new TypeError(`${receiver}: invalid fill.`);
+  }
+}
+function side(value, baseline) {
+  return value >= baseline ? "above" : "below";
+}
+function BaselineSeries({
+  data: dataInput,
+  x: xInput,
+  y: yInput,
+  xScale: xId,
+  yScale: yId,
+  baseline: baselineInput,
+  defined,
+  inspection,
+  style: styleInput,
+  ...eventProps
+}) {
+  const xScale = useNumericPosition(xId), yScale = useNumericPosition(yId);
+  if (yScale.type !== "linear")
+    throw new TypeError("BaselineSeries requires LinearScale for yScale.");
+  const x = useInternalValueMemoSlot("vizBaselineXAccessor", () => pointAccessor(xInput), [xInput]);
+  const y = useInternalValueMemoSlot("vizBaselineYAccessor", () => pointAccessor(yInput), [yInput]);
+  const data = pointData(resolveSignalValue(dataInput), "BaselineSeries");
+  const baseline = resolveSignalValue(baselineInput);
+  if (typeof baseline !== "number" || !Number.isFinite(baseline))
+    throw new RangeError("BaselineSeries baseline must be finite.");
+  const baselineY = yScale.map(baseline);
+  if (!Number.isFinite(baselineY)) throw new RangeError("BaselineSeries baseline must map to a finite coordinate.");
+  const style = resolveSignalValue(styleInput) ?? {};
+  if (style === null || typeof style !== "object" || Array.isArray(style))
+    throw new TypeError("BaselineSeries style must be an object.");
+  const above = resolveSignalValue(style.above) ?? {}, below = resolveSignalValue(style.below) ?? {};
+  const aboveFill = fill(resolveSignalValue(above.fill) ?? "#087f8c", "BaselineSeries above");
+  const belowFill = fill(resolveSignalValue(below.fill) ?? "#d9674c", "BaselineSeries below");
+  const aboveStroke = resolveSignalValue(above.stroke) ?? "#087f8c";
+  const belowStroke = resolveSignalValue(below.stroke) ?? "#d9674c";
+  const fillOpacity = opacity(resolveSignalValue(style.fillOpacity) ?? 0.2, "BaselineSeries fill");
+  const strokeWidth = width(resolveSignalValue(style.strokeWidth) ?? 2, "BaselineSeries stroke");
+  const cursor = resolveSignalValue(style.cursor);
+  if (cursor !== void 0 && typeof cursor !== "string") throw new TypeError("BaselineSeries cursor must be a string.");
+  const pieces = [];
+  const captured = inspection ? [] : void 0;
+  let previous;
+  let run = 0;
+  const breakRun = () => {
+    previous = void 0;
+    run++;
+  };
+  const segment = (first, second) => {
+    const firstSide = side(first.domainY, baseline), secondSide = side(second.domainY, baseline);
+    const points = [
+      { point: first, side: firstSide }
+    ];
+    if (firstSide !== secondSide) {
+      const firstDistance = Math.abs(first.domainY - baseline);
+      const secondDistance = Math.abs(second.domainY - baseline);
+      const amount = firstDistance > secondDistance ? 1 / (1 + secondDistance / firstDistance) : firstDistance / secondDistance / (1 + firstDistance / secondDistance);
+      points.push({
+        point: { x: first.x + (second.x - first.x) * amount, y: baselineY, domainY: baseline },
+        side: firstSide
+      });
+      points.push({
+        point: { x: first.x + (second.x - first.x) * amount, y: baselineY, domainY: baseline },
+        side: secondSide
+      });
+    }
+    points.push({ point: second, side: secondSide });
+    for (let index = 1; index < points.length; index++) {
+      const start = points[index - 1], end = points[index];
+      const kind = start.side;
+      const a = start.point, b = end.point;
+      const stroke = new Path2D();
+      stroke.moveTo(a.x, a.y);
+      stroke.lineTo(b.x, b.y);
+      if (a.y === baselineY && b.y === baselineY) {
+        pieces.push({ side: kind, fill: void 0, stroke });
+        continue;
+      }
+      const fill2 = new Path2D();
+      fill2.moveTo(a.x, baselineY);
+      fill2.lineTo(a.x, a.y);
+      fill2.lineTo(b.x, b.y);
+      fill2.lineTo(b.x, baselineY);
+      fill2.closePath();
+      pieces.push({ side: kind, fill: fill2, stroke });
+    }
+  };
+  for (let index = 0; index < data.length; index++) {
+    const datum = data[index];
+    if (defined && !defined(datum, index, data)) {
+      breakRun();
+      continue;
+    }
+    const domainX = x(datum, index, data), domainY = y(datum, index, data);
+    if (!finiteCoordinate(domainX) || !finiteCoordinate(domainY)) {
+      breakRun();
+      continue;
+    }
+    const mappedX = xScale.map(domainX), mappedY = yScale.map(domainY);
+    if (!Number.isFinite(mappedX) || !Number.isFinite(mappedY)) {
+      breakRun();
+      continue;
+    }
+    const point = { datum, domainX, domainY, x: mappedX, y: mappedY };
+    captured?.push(Object.freeze({ datum, sourceIndex: index, domainX: point.domainX, domainY: point.domainY, anchorLocal: Object.freeze({ x: point.x, y: point.y }), run }));
+    if (previous) segment(previous, point);
+    previous = point;
+  }
+  if (inspection) inspection.capture({ observations: captured, xScale, yScale });
+  return /* @__PURE__ */ jsx(Fragment, { children: pieces.flatMap((piece, index) => {
+    const fill2 = piece.side === "above" ? aboveFill : belowFill;
+    const stroke = piece.side === "above" ? aboveStroke : belowStroke;
+    return [
+      ...piece.fill ? [/* @__PURE__ */ jsx(Path, { ...eventProps, style: { d: piece.fill, fill: fill2, opacity: fillOpacity, cursor } }, `${index}:fill`)] : [],
+      /* @__PURE__ */ jsx(Path, { ...eventProps, style: { d: piece.stroke, stroke, strokeWidth, cursor } }, `${index}:stroke`)
+    ];
+  }) });
+}
+export {
+  BaselineSeries
+};
+//# sourceMappingURL=baseline-series.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/baseline-series.tsx"],
+  "sourcesContent": ["import { Path, resolveSignalValue } from \"@pibbl/core\";\nimport type {\n  FillStyle,\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n  SignalValue,\n  StrokeStyle,\n} from \"@pibbl/core\";\nimport { useInternalValueMemoSlot, validateTexturePaint } from \"@pibbl/core/internal\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { LineAccessor, LineSeriesProps, ScaleId } from \"./types.js\";\nimport { useNumericPosition } from \"./series-position.js\";\nimport { opacity, width } from \"./paint.js\";\nimport { finiteCoordinate, pointAccessor, pointData } from \"./point-data.js\";\n\n/** Shared paint for one side of a baseline. See {@link BaselineSeries}. */\nexport interface BaselineSideStyle {\n  /** Area fill for this side of the baseline. */\n  readonly fill?: FillStyle;\n  /** Line stroke for this side of the baseline. */\n  readonly stroke?: StrokeStyle;\n}\n\n/** Shared presentation for a linear baseline series. See {@link BaselineSeries}. */\nexport interface BaselineSeriesStyle {\n  /** Paint for y values greater than or equal to baseline. */\n  readonly above?: BaselineSideStyle;\n  /** Paint for y values less than baseline. */\n  readonly below?: BaselineSideStyle;\n  /** Opacity for both area fills; defaults to 0.2. */\n  readonly fillOpacity?: number;\n  /** Width for both line strokes; defaults to 2. */\n  readonly strokeWidth?: number;\n  /** Cursor while a painted series path owns targeting. */\n  readonly cursor?: string;\n}\n\n/** A linear connected series split into independently painted regions at baseline crossings. See\n * {@link BaselineSeries}.\n */\nexport interface BaselineSeriesProps<D>\n  extends PibblEventHandlers, PibblEventParticipationOptions {\n  /** Application records or a signal of records; source order is retained. */\n  readonly data: SignalValue<readonly D[]>;\n  /** Property key or callback extracting horizontal coordinates. */\n  readonly x: LineAccessor<D>;\n  /** Property key or callback extracting vertical coordinates. */\n  readonly y: LineAccessor<D>;\n  /** Numeric or trading-time horizontal scale identity. */\n  readonly xScale: ScaleId;\n  /** Linear vertical scale identity. */\n  readonly yScale: ScaleId;\n  /** Finite data-space division between the above and below presentations. */\n  readonly baseline: SignalValue<number>;\n  /** Excludes a record before its accessors run. */\n  readonly defined?: LineSeriesProps<D>[\"defined\"];\n  /** Optional committed original-record capture on the standard numeric inspection foundation. */\n  readonly inspection?: import(\"../inspection/capture-types.js\").NumericInspectionRef<D>;\n  /** Shared above/below paint and interaction presentation. */\n  readonly style?: SignalValue<SignalStyle<BaselineSeriesStyle>>;\n}\n\ninterface Point<D> {\n  readonly datum: D;\n  readonly domainX: number;\n  readonly domainY: number;\n  readonly x: number;\n  readonly y: number;\n}\n\ninterface Piece {\n  readonly side: \"above\" | \"below\";\n  readonly fill: Path2D | undefined;\n  readonly stroke: Path2D;\n}\n\nfunction fill(value: unknown, receiver: string): FillStyle {\n  if (typeof value === \"string\" || value instanceof CanvasGradient || value instanceof CanvasPattern)\n    return value;\n  try {\n    validateTexturePaint(value as never);\n    return value as FillStyle;\n  } catch {\n    throw new TypeError(`${receiver}: invalid fill.`);\n  }\n}\n\nfunction side(value: number, baseline: number): \"above\" | \"below\" {\n  return value >= baseline ? \"above\" : \"below\";\n}\n\n/**\n * Draws a linear connected series with independently painted regions above and below a baseline.\n * Equal values belong to the above stroke; zero-area spans never receive a fill. Gaps split runs,\n * and optional inspection captures only original records.\n * @param props - Records, a numeric or trading-time x scale, linear price y scale, baseline, event props, and shared side paint.\n * @returns Filled and stroked Pibbl paths in source paint order.\n * @see {@link LineSeriesProps}\n */\nexport function BaselineSeries<D>({\n  data: dataInput,\n  x: xInput,\n  y: yInput,\n  xScale: xId,\n  yScale: yId,\n  baseline: baselineInput,\n  defined,\n  inspection,\n  style: styleInput,\n  ...eventProps\n}: BaselineSeriesProps<D>) {\n  const xScale = useNumericPosition(xId), yScale = useNumericPosition(yId);\n  if (yScale.type !== \"linear\")\n    throw new TypeError(\"BaselineSeries requires LinearScale for yScale.\");\n  const x = useInternalValueMemoSlot(\"vizBaselineXAccessor\", () => pointAccessor(xInput), [xInput]);\n  const y = useInternalValueMemoSlot(\"vizBaselineYAccessor\", () => pointAccessor(yInput), [yInput]);\n  const data = pointData(resolveSignalValue(dataInput), \"BaselineSeries\");\n  const baseline = resolveSignalValue(baselineInput);\n  if (typeof baseline !== \"number\" || !Number.isFinite(baseline))\n    throw new RangeError(\"BaselineSeries baseline must be finite.\");\n  const baselineY = yScale.map(baseline);\n  if (!Number.isFinite(baselineY)) throw new RangeError(\"BaselineSeries baseline must map to a finite coordinate.\");\n  const style = resolveSignalValue(styleInput) ?? {};\n  if (style === null || typeof style !== \"object\" || Array.isArray(style))\n    throw new TypeError(\"BaselineSeries style must be an object.\");\n  const above = resolveSignalValue(style.above) ?? {}, below = resolveSignalValue(style.below) ?? {};\n  const aboveFill = fill(resolveSignalValue(above.fill) ?? \"#087f8c\", \"BaselineSeries above\");\n  const belowFill = fill(resolveSignalValue(below.fill) ?? \"#d9674c\", \"BaselineSeries below\");\n  const aboveStroke = resolveSignalValue(above.stroke) ?? \"#087f8c\";\n  const belowStroke = resolveSignalValue(below.stroke) ?? \"#d9674c\";\n  const fillOpacity = opacity(resolveSignalValue(style.fillOpacity) ?? 0.2, \"BaselineSeries fill\");\n  const strokeWidth = width(resolveSignalValue(style.strokeWidth) ?? 2, \"BaselineSeries stroke\");\n  const cursor = resolveSignalValue(style.cursor);\n  if (cursor !== undefined && typeof cursor !== \"string\") throw new TypeError(\"BaselineSeries cursor must be a string.\");\n\n  const pieces: Piece[] = [];\n  const captured: import(\"../inspection/capture-types.js\").CapturedNumericObservation<D>[] | undefined = inspection ? [] : undefined;\n  let previous: Point<D> | undefined;\n  let run = 0;\n  const breakRun = () => { previous = undefined; run++; };\n  const segment = (first: Point<D>, second: Point<D>) => {\n    const firstSide = side(first.domainY, baseline), secondSide = side(second.domainY, baseline);\n    const points: { point: Point<D> | { x: number; y: number; domainY: number }; side: \"above\" | \"below\" }[] = [\n      { point: first, side: firstSide },\n    ];\n    if (firstSide !== secondSide) {\n      const firstDistance = Math.abs(first.domainY - baseline);\n      const secondDistance = Math.abs(second.domainY - baseline);\n      const amount = firstDistance > secondDistance\n        ? 1 / (1 + secondDistance / firstDistance)\n        : (firstDistance / secondDistance) / (1 + firstDistance / secondDistance);\n      points.push({\n        point: { x: first.x + (second.x - first.x) * amount, y: baselineY, domainY: baseline },\n        side: firstSide,\n      });\n      points.push({\n        point: { x: first.x + (second.x - first.x) * amount, y: baselineY, domainY: baseline },\n        side: secondSide,\n      });\n    }\n    points.push({ point: second, side: secondSide });\n    for (let index = 1; index < points.length; index++) {\n      const start = points[index - 1]!, end = points[index]!;\n      const kind = start.side;\n      const a = start.point, b = end.point;\n      const stroke = new Path2D();\n      stroke.moveTo(a.x, a.y);\n      stroke.lineTo(b.x, b.y);\n      if (a.y === baselineY && b.y === baselineY) {\n        pieces.push({ side: kind, fill: undefined, stroke });\n        continue;\n      }\n      const fill = new Path2D();\n      fill.moveTo(a.x, baselineY);\n      fill.lineTo(a.x, a.y);\n      fill.lineTo(b.x, b.y);\n      fill.lineTo(b.x, baselineY);\n      fill.closePath();\n      pieces.push({ side: kind, fill, stroke });\n    }\n  };\n  for (let index = 0; index < data.length; index++) {\n    const datum = data[index]!;\n    if (defined && !defined(datum, index, data)) { breakRun(); continue; }\n    const domainX = x(datum, index, data), domainY = y(datum, index, data);\n    if (!finiteCoordinate(domainX) || !finiteCoordinate(domainY)) { breakRun(); continue; }\n    const mappedX = xScale.map(domainX), mappedY = yScale.map(domainY);\n    if (!Number.isFinite(mappedX) || !Number.isFinite(mappedY)) { breakRun(); continue; }\n    const point: Point<D> = { datum, domainX, domainY, x: mappedX, y: mappedY };\n    captured?.push(Object.freeze({ datum, sourceIndex: index, domainX: point.domainX, domainY: point.domainY, anchorLocal: Object.freeze({ x: point.x, y: point.y }), run }));\n    if (previous) segment(previous, point);\n    previous = point;\n  }\n  if (inspection) inspection.capture({ observations: captured!, xScale, yScale });\n  return (\n    <>\n      {pieces.flatMap((piece, index) => {\n        const fill = piece.side === \"above\" ? aboveFill : belowFill;\n        const stroke = piece.side === \"above\" ? aboveStroke : belowStroke;\n        return [\n          ...(piece.fill ? [<Path key={`${index}:fill`} {...eventProps} style={{ d: piece.fill, fill, opacity: fillOpacity, cursor }} />] : []),\n          <Path key={`${index}:stroke`} {...eventProps} style={{ d: piece.stroke, stroke, strokeWidth, cursor }} />,\n        ];\n      })}\n    </>\n  );\n}\n"],
+  "mappings": "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",
+  "names": ["fill"]
+}

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

@@ -0,0 +1,62 @@
+import { type FillStyle, type StrokeStyle, type SignalValue, type PibblEventHandlers, type PibblEventParticipationOptions, type PibblNode } from "@pibbl/core";
+import type { LineAccessor, ScaleId } from "./types.js";
+import type { CandleInspectionRef } from "../inspection/candle.js";
+/** Open/close body paint, independent from wick paint.
+ * @see {@link CandlestickSeries}
+ */
+export interface CandleBodyStyle {
+    /** Interior; default teal for close >= open, coral otherwise. Empty string disables fill. */ readonly fill?: FillStyle;
+    /** Optional body outline. */ readonly stroke?: StrokeStyle;
+    /** Nonnegative local outline width; default 1. */ readonly strokeWidth?: number;
+}
+/** High/low wick paint.
+ * @see {@link CandlestickSeries}
+ */
+export interface CandleWickStyle {
+    /** Wick paint; default dark teal. Empty string disables wick paint. */ readonly stroke?: StrokeStyle;
+    /** Nonnegative local width; default 1. */ readonly strokeWidth?: number;
+}
+/** Accepted named body/wick presentation for OHLC marks.
+ * @see {@link CandlestickSeries}
+ */
+export interface CandlestickSeriesStyle {
+    /** Positive local body width, or automatic 70% spacing capped at 12; singleton fallback 8. */ readonly bandwidth?: number | "auto";
+    /** Independent open/close body appearance. */ readonly body?: CandleBodyStyle;
+    /** Independent high/low wick appearance. */ readonly wick?: CandleWickStyle;
+    /** Opacity zero through one; default 1. */ readonly opacity?: number;
+    /** Cursor while the series owns targeting. */ readonly cursor?: string;
+}
+/** Source-ordered OHLC records with named accessors and optional shared inspection.
+ * @see {@link CandlestickSeries}
+ */
+export interface CandlestickSeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /** Original records/signal; never sorted or mutated. */ readonly data: SignalValue<readonly D[]>;
+    /** UTC-millisecond property or callback. */ readonly time: LineAccessor<D>;
+    /** Open 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>;
+    /** Close price property or callback. */ readonly close: LineAccessor<D>;
+    /** Numeric/UTC/trading horizontal mapping identity. */ readonly xScale: ScaleId;
+    /** Independent numeric 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 - Original complete array.
+     * @returns Whether the candle participates.
+     */ readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;
+    /** Named body/wick appearance or a hook-free datum resolver.
+     * @param datum - Original row.
+     * @param index - Original source index.
+     * @param data - Complete source array.
+     * @returns Plain named candle styles.
+     */ readonly style?: SignalValue<CandlestickSeriesStyle> | ((datum: D, index: number, data: readonly D[]) => CandlestickSeriesStyle);
+    /** Optional capture on the ordinary inspection foundation; no queries while painting. */ readonly inspection?: CandleInspectionRef<D>;
+}
+/**
+ * Paints OHLC bodies and wicks, preserving source order and skipping complete missing candles.
+ * Finite malformed OHLC rejects; equal open/close paints a one-local-unit doji.
+ * @param props - Named OHLC accessors, scales, styles and optional inspection.
+ * @returns Ordinary Pibbl composition; disjoint equal styles share paint paths.
+ * @see {@link CandlestickSeriesProps}
+ */
+export declare function CandlestickSeries<D>({ data: input, time: timeInput, open: openInput, high: highInput, low: lowInput, close: closeInput, xScale, yScale, defined, style: styleInput, inspection, pointerEvents, ...events }: CandlestickSeriesProps<D>): PibblNode;

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

@@ -0,0 +1,150 @@
+import { jsx, jsxs } from "@pibbl/core/jsx-runtime";
+import {
+  Group,
+  Path,
+  resolveSignalValue
+} from "@pibbl/core";
+import { withHooksForbidden } from "@pibbl/core/internal";
+import { useNumericPosition } from "./series-position.js";
+import { useContinuousScale } from "./use-continuous-scale.js";
+import { pointAccessor, pointData, finiteCoordinate } from "./point-data.js";
+import { financialMarkWidth, candleGeometry } from "./financial-geometry.js";
+import { opacity, width } from "./paint.js";
+function CandlestickSeries({
+  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), "CandlestickSeries");
+  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(
+        `CandlestickSeries: 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(
+      "CandlestickSeries style callback",
+      () => specified(row.datum, row.sourceIndex, data)
+    ) : specified ?? {};
+    const markWidth = style.bandwidth === void 0 || style.bandwidth === "auto" ? defaultWidth : financialMarkWidth([], { width: style.bandwidth });
+    const g = candleGeometry({
+      centerX: row.x,
+      openY: ys.map(row.open),
+      closeY: ys.map(row.close),
+      highY: ys.map(row.high),
+      lowY: ys.map(row.low),
+      width: markWidth,
+      dojiHeight: 1
+    });
+    const fill = style.body?.fill ?? (row.close >= row.open ? "#087f8c" : "#d9674c"), bodyStroke = style.body?.stroke, bodyWidth = width(style.body?.strokeWidth ?? 1, "CandlestickSeries body"), wickStroke = style.wick?.stroke ?? "#173a35", wickWidth = width(style.wick?.strokeWidth ?? 1, "CandlestickSeries wick"), alpha = opacity(style.opacity ?? 1, "CandlestickSeries");
+    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: ys.map(row.close) }),
+        bodyBoundsLocal: g.bodyBoundsLocal,
+        wickLocal: g.wickLocal,
+        bodyFill: !!fill && alpha > 0,
+        bodyStrokeWidthLocal: bodyStroke && alpha > 0 ? bodyWidth : 0,
+        wickStrokeWidthLocal: wickStroke && alpha > 0 ? wickWidth : 0
+      })
+    );
+    if (alpha === 0) continue;
+    const half = Math.max(bodyStroke ? bodyWidth : 0, wickStroke ? wickWidth : 0) / 2, minX = g.bodyBoundsLocal.x - half, maxX = g.bodyBoundsLocal.x + markWidth + half;
+    let batch = batches.at(-1);
+    if (!batch || minX < batch.maxX && maxX > batch.minX || batch.fill !== fill || batch.bodyStroke !== bodyStroke || batch.bodyWidth !== bodyWidth || batch.wickStroke !== wickStroke || batch.wickWidth !== wickWidth || batch.opacity !== alpha || batch.cursor !== style.cursor) {
+      batch = {
+        body: new Path2D(),
+        wick: new Path2D(),
+        fill,
+        bodyStroke,
+        bodyWidth,
+        wickStroke,
+        wickWidth,
+        opacity: alpha,
+        cursor: style.cursor,
+        minX,
+        maxX
+      };
+      batches.push(batch);
+    }
+    batch.minX = Math.min(batch.minX, minX);
+    batch.maxX = Math.max(batch.maxX, maxX);
+    const b = g.bodyBoundsLocal;
+    batch.body.rect(b.x, b.y, b.width, b.height);
+    batch.wick.moveTo(g.wickLocal.x, g.wickLocal.highY);
+    batch.wick.lineTo(g.wickLocal.x, g.wickLocal.lowY);
+  }
+  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.wick,
+          stroke: batch.wickStroke,
+          strokeWidth: batch.wickWidth,
+          opacity: batch.opacity,
+          cursor: batch.cursor
+        }
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      Path,
+      {
+        pointerEvents,
+        style: {
+          d: batch.body,
+          fill: batch.fill,
+          stroke: batch.bodyStroke,
+          strokeWidth: batch.bodyWidth,
+          opacity: batch.opacity,
+          cursor: batch.cursor
+        }
+      }
+    )
+  ] }, index)) });
+}
+export {
+  CandlestickSeries
+};
+//# sourceMappingURL=candlestick-series.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/candlestick-series.tsx"],
+  "sourcesContent": ["import {\n  Group,\n  Path,\n  resolveSignalValue,\n  type FillStyle,\n  type StrokeStyle,\n  type SignalValue,\n  type PibblEventHandlers,\n  type PibblEventParticipationOptions,\n  type PibblNode,\n} from \"@pibbl/core\";\nimport { withHooksForbidden } from \"@pibbl/core/internal\";\nimport type { LineAccessor, ScaleId } from \"./types.js\";\nimport type {\n  CandleInspectionRef,\n  CapturedCandleMark,\n} from \"../inspection/candle.js\";\nimport { useNumericPosition } from \"./series-position.js\";\nimport { useContinuousScale } from \"./use-continuous-scale.js\";\nimport { pointAccessor, pointData, finiteCoordinate } from \"./point-data.js\";\nimport { financialMarkWidth, candleGeometry } from \"./financial-geometry.js\";\nimport { opacity, width } from \"./paint.js\";\n/** Open/close body paint, independent from wick paint.\n * @see {@link CandlestickSeries}\n */\nexport interface CandleBodyStyle {\n  /** Interior; default teal for close >= open, coral otherwise. Empty string disables fill. */ readonly fill?: FillStyle;\n  /** Optional body outline. */ readonly stroke?: StrokeStyle;\n  /** Nonnegative local outline width; default 1. */ readonly strokeWidth?: number;\n}\n/** High/low wick paint.\n * @see {@link CandlestickSeries}\n */\nexport interface CandleWickStyle {\n  /** Wick paint; default dark teal. Empty string disables wick paint. */ readonly stroke?: StrokeStyle;\n  /** Nonnegative local width; default 1. */ readonly strokeWidth?: number;\n}\n/** Accepted named body/wick presentation for OHLC marks.\n * @see {@link CandlestickSeries}\n */\nexport interface CandlestickSeriesStyle {\n  /** Positive local body width, or automatic 70% spacing capped at 12; singleton fallback 8. */ readonly bandwidth?:\n    number | \"auto\";\n  /** Independent open/close body appearance. */ readonly body?: CandleBodyStyle;\n  /** Independent high/low wick appearance. */ readonly wick?: CandleWickStyle;\n  /** Opacity zero through one; default 1. */ readonly opacity?: number;\n  /** Cursor while the series owns targeting. */ readonly cursor?: string;\n}\n/** Source-ordered OHLC records with named accessors and optional shared inspection.\n * @see {@link CandlestickSeries}\n */\nexport interface CandlestickSeriesProps<D>\n  extends PibblEventHandlers, PibblEventParticipationOptions {\n  /** Original records/signal; never sorted or mutated. */ readonly data: SignalValue<\n    readonly D[]\n  >;\n  /** UTC-millisecond property or callback. */ readonly time: LineAccessor<D>;\n  /** Open price property or callback. */ readonly open: LineAccessor<D>;\n  /** High price property or callback. */ readonly high: LineAccessor<D>;\n  /** Low price property or callback. */ readonly low: LineAccessor<D>;\n  /** Close price property or callback. */ readonly close: LineAccessor<D>;\n  /** Numeric/UTC/trading horizontal mapping identity. */ readonly xScale: ScaleId;\n  /** Independent numeric price mapping identity. */ 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 - Original complete array.\n   * @returns Whether the candle participates.\n   */ readonly defined?: (\n    datum: D,\n    index: number,\n    data: readonly D[],\n  ) => boolean;\n  /** Named body/wick appearance or a hook-free datum resolver.\n   * @param datum - Original row.\n   * @param index - Original source index.\n   * @param data - Complete source array.\n   * @returns Plain named candle styles.\n   */ readonly style?:\n    | SignalValue<CandlestickSeriesStyle>\n    | ((datum: D, index: number, data: readonly D[]) => CandlestickSeriesStyle);\n  /** Optional capture on the ordinary inspection foundation; no queries while painting. */ readonly inspection?: CandleInspectionRef<D>;\n}\n/**\n * Paints OHLC bodies and wicks, preserving source order and skipping complete missing candles.\n * Finite malformed OHLC rejects; equal open/close paints a one-local-unit doji.\n * @param props - Named OHLC accessors, scales, styles and optional inspection.\n * @returns Ordinary Pibbl composition; disjoint equal styles share paint paths.\n * @see {@link CandlestickSeriesProps}\n */\nexport function CandlestickSeries<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}: CandlestickSeriesProps<D>): PibblNode {\n  const xs = useNumericPosition(xScale),\n    ys = useContinuousScale(yScale).get();\n  const data = pointData(resolveSignalValue(input), \"CandlestickSeries\");\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        `CandlestickSeries: 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: CapturedCandleMark<D>[] | undefined = inspection\n    ? []\n    : undefined;\n  const batches: {\n    body: Path2D;\n    wick: Path2D;\n    fill: FillStyle;\n    bodyStroke: StrokeStyle | undefined;\n    bodyWidth: number;\n    wickStroke: StrokeStyle;\n    wickWidth: 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(\"CandlestickSeries 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 g = candleGeometry({\n      centerX: row.x,\n      openY: ys.map(row.open),\n      closeY: ys.map(row.close),\n      highY: ys.map(row.high),\n      lowY: ys.map(row.low),\n      width: markWidth,\n      dojiHeight: 1,\n    });\n    const fill =\n        style.body?.fill ?? (row.close >= row.open ? \"#087f8c\" : \"#d9674c\"),\n      bodyStroke = style.body?.stroke,\n      bodyWidth = width(style.body?.strokeWidth ?? 1, \"CandlestickSeries body\"),\n      wickStroke = style.wick?.stroke ?? \"#173a35\",\n      wickWidth = width(style.wick?.strokeWidth ?? 1, \"CandlestickSeries wick\"),\n      alpha = opacity(style.opacity ?? 1, \"CandlestickSeries\");\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: ys.map(row.close) }),\n        bodyBoundsLocal: g.bodyBoundsLocal,\n        wickLocal: g.wickLocal,\n        bodyFill: !!fill && alpha > 0,\n        bodyStrokeWidthLocal: bodyStroke && alpha > 0 ? bodyWidth : 0,\n        wickStrokeWidthLocal: wickStroke && alpha > 0 ? wickWidth : 0,\n      }),\n    );\n    if (alpha === 0) continue;\n    const half =\n        Math.max(bodyStroke ? bodyWidth : 0, wickStroke ? wickWidth : 0) / 2,\n      minX = g.bodyBoundsLocal.x - half,\n      maxX = g.bodyBoundsLocal.x + markWidth + half;\n    let batch = batches.at(-1);\n    if (\n      !batch ||\n      (minX < batch.maxX && maxX > batch.minX) ||\n      batch.fill !== fill ||\n      batch.bodyStroke !== bodyStroke ||\n      batch.bodyWidth !== bodyWidth ||\n      batch.wickStroke !== wickStroke ||\n      batch.wickWidth !== wickWidth ||\n      batch.opacity !== alpha ||\n      batch.cursor !== style.cursor\n    ) {\n      batch = {\n        body: new Path2D(),\n        wick: new Path2D(),\n        fill,\n        bodyStroke,\n        bodyWidth,\n        wickStroke,\n        wickWidth,\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    const b = g.bodyBoundsLocal;\n    batch.body.rect(b.x, b.y, b.width, b.height);\n    batch.wick.moveTo(g.wickLocal.x, g.wickLocal.highY);\n    batch.wick.lineTo(g.wickLocal.x, g.wickLocal.lowY);\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.wick,\n              stroke: batch.wickStroke,\n              strokeWidth: batch.wickWidth,\n              opacity: batch.opacity,\n              cursor: batch.cursor,\n            }}\n          />\n          <Path\n            pointerEvents={pointerEvents}\n            style={{\n              d: batch.body,\n              fill: batch.fill,\n              stroke: batch.bodyStroke,\n              strokeWidth: batch.bodyWidth,\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/censored-point-series.d.ts

@@ -0,0 +1,71 @@
+import type { FillStyle, PibblEventHandlers, PibblEventParticipationOptions, SignalValue, StrokeStyle } from "@pibbl/core";
+import type { SignalStyle } from "@pibbl/core/internal";
+import type { LineAccessor, ScaleId } from "./types.js";
+/** A supplied assay reporting status. `below` and `above` retain the supplied reporting limit.
+ * @see {@link CensoredPointSeriesProps}
+ */
+export type CensoringStatus = "observed" | "below" | "above";
+/** Extracts an observation's supplied reporting status.
+ * @param datum - Original record being read.
+ * @param index - Zero-based source index.
+ * @param data - Complete supplied record array.
+ * @returns The supplied status, or a nullish sentinel that omits the record.
+ * @see {@link CensoringStatus}
+ */
+export type CensoringAccessor<D> = {
+    [K in keyof D]-?: D[K] extends CensoringStatus | null | undefined ? K : never;
+}[keyof D] | ((datum: D, index: number, data: readonly D[]) => CensoringStatus | null | undefined);
+/** Shared mark paint and local-pixel geometry for {@link CensoredPointSeries}. */
+export interface CensoredPointSeriesStyle {
+    /** Circle and open censor marker radius in local pixels; defaults to 4. */
+    readonly radius?: number;
+    /** Fill for observed circles; defaults to #087f8c. Censor markers remain open. */
+    readonly fill?: FillStyle;
+    /** Outline for circles and open directional censor markers; defaults to #087f8c. */
+    readonly stroke?: StrokeStyle;
+    /** Outline width in local pixels; defaults to 1.5. */
+    readonly strokeWidth?: number;
+    /** Shared paint opacity from zero to one; defaults to 1. */
+    readonly opacity?: number;
+    /** Cursor for painted mark targets. */
+    readonly cursor?: string;
+}
+/** Authored inputs for supplied observed and censored numeric observations.
+ * @see {@link CensoredPointSeries}
+ */
+export interface CensoredPointSeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /** Original records, or a signal of records. The series performs no imputation or inference. */
+    readonly data: SignalValue<readonly D[]>;
+    /** Property or callback supplying the numeric horizontal coordinate. */
+    readonly x: LineAccessor<D>;
+    /** Property or callback supplying the numeric vertical value or reporting limit. */
+    readonly y: LineAccessor<D>;
+    /** Property or callback yielding `observed`, `below`, or `above`. */
+    readonly censoring: CensoringAccessor<D>;
+    /** Ancestor continuous numeric scale mapping x. */
+    readonly xScale: ScaleId;
+    /** Ancestor continuous numeric scale mapping y and its reporting limit. */
+    readonly yScale: ScaleId;
+    /** Optional synchronous predicate; excluded rows contribute no mark.
+     * @param datum - Original record being tested.
+     * @param index - Zero-based source index.
+     * @param data - Complete supplied record array.
+     * @returns Whether this record contributes a mark.
+     */
+    readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;
+    /** Shared style; whole-object and shallow field signals are observed by the series. */
+    readonly style?: SignalValue<SignalStyle<CensoredPointSeriesStyle>>;
+}
+/**
+ * Draws supplied numeric observations as circles and below/above reporting limits as open arrows.
+ *
+ * `below` points toward decreasing y-domain values and `above` toward increasing y-domain values,
+ * including when the y scale uses a reversed domain or range. The supplied `y` value remains the
+ * reporting limit; this component never substitutes a measurement, imputes a value, or fits a model.
+ *
+ * @param props - Supplied observations, coordinates, reporting statuses, scales, and paint.
+ * See {@link CensoredPointSeriesProps}.
+ * @returns Two ordinary batched paths for observed and open censored marks.
+ * @see {@link CensoredPointSeriesProps}
+ */
+export declare function CensoredPointSeries<D>({ data: input, x: xInput, y: yInput, censoring: censoringInput, xScale: xId, yScale: yId, defined, style: styleInput, pointerEvents, ...events }: CensoredPointSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;

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

@@ -0,0 +1,129 @@
+import { Fragment, jsx, jsxs } from "@pibbl/core/jsx-runtime";
+import { Path, resolveSignalValue } from "@pibbl/core";
+import { validateTexturePaint, withHooksForbidden } from "@pibbl/core/internal";
+import { finiteCoordinate, pointAccessor, pointData } from "./point-data.js";
+import { opacity, width } from "./paint.js";
+import { useContinuousScale } from "./use-continuous-scale.js";
+const fields = ["radius", "fill", "stroke", "strokeWidth", "opacity", "cursor"];
+function paint(value, name) {
+  if (value === void 0 || typeof value === "string" || value instanceof CanvasGradient || value instanceof CanvasPattern)
+    return value;
+  try {
+    validateTexturePaint(value);
+    return value;
+  } catch {
+  }
+  throw new TypeError(`CensoredPointSeries: invalid ${name}.`);
+}
+function triangle(path, x, y, radius, direction) {
+  path.moveTo(x, y + direction * radius);
+  path.lineTo(x - radius * 0.78, y - direction * radius * 0.55);
+  path.lineTo(x + radius * 0.78, y - direction * radius * 0.55);
+  path.closePath();
+}
+function CensoredPointSeries({
+  data: input,
+  x: xInput,
+  y: yInput,
+  censoring: censoringInput,
+  xScale: xId,
+  yScale: yId,
+  defined,
+  style: styleInput,
+  pointerEvents,
+  ...events
+}) {
+  const xScale = useContinuousScale(xId).get();
+  const yScale = useContinuousScale(yId).get();
+  const data = pointData(resolveSignalValue(input), "CensoredPointSeries");
+  const x = pointAccessor(xInput), y = pointAccessor(yInput);
+  const censoring = typeof censoringInput === "function" ? censoringInput : (datum) => datum[censoringInput];
+  const specified = resolveSignalValue(styleInput) ?? {};
+  if (specified === null || typeof specified !== "object" || Array.isArray(specified))
+    throw new TypeError("CensoredPointSeries: style must be an object.");
+  const style = {};
+  for (const key of Object.keys(specified)) {
+    if (!fields.includes(key))
+      throw new TypeError(
+        `CensoredPointSeries: unsupported style field ${key}.`
+      );
+    style[key] = resolveSignalValue(
+      specified[key]
+    );
+  }
+  const resolved = style;
+  const radius = width(resolved.radius ?? 4, "CensoredPointSeries radius");
+  const strokeWidth = width(resolved.strokeWidth ?? 1.5, "CensoredPointSeries");
+  const alpha = opacity(resolved.opacity ?? 1, "CensoredPointSeries");
+  if (resolved.cursor !== void 0 && typeof resolved.cursor !== "string")
+    throw new TypeError("CensoredPointSeries: cursor must be a string.");
+  const fill = paint(resolved.fill ?? "#087f8c", "fill");
+  const stroke = paint(resolved.stroke ?? "#087f8c", "stroke");
+  const observed = new Path2D();
+  const censored = new Path2D();
+  const increasingY = Math.sign(
+    (yScale.domain[1] - yScale.domain[0]) * (yScale.range[1] - yScale.range[0])
+  );
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    const coordinates = withHooksForbidden(
+      "CensoredPointSeries: accessors cannot call hooks.",
+      () => {
+        if (defined && !defined(datum, i, data)) return void 0;
+        return {
+          x: x(datum, i, data),
+          y: y(datum, i, data),
+          censoring: censoring(datum, i, data)
+        };
+      }
+    );
+    if (!coordinates || !finiteCoordinate(coordinates.x) || !finiteCoordinate(coordinates.y) || coordinates.censoring == null)
+      continue;
+    if (!["observed", "below", "above"].includes(coordinates.censoring))
+      throw new TypeError(
+        `CensoredPointSeries: unknown censoring status ${String(coordinates.censoring)} (row ${i}).`
+      );
+    const px = xScale.map(coordinates.x), py = yScale.map(coordinates.y);
+    if (!Number.isFinite(px) || !Number.isFinite(py))
+      throw new RangeError(
+        `CensoredPointSeries: mapped coordinates must be finite (row ${i}).`
+      );
+    if (radius === 0) continue;
+    if (coordinates.censoring === "observed") {
+      observed.moveTo(px + radius, py);
+      observed.arc(px, py, radius, 0, Math.PI * 2);
+      observed.closePath();
+    } else {
+      const direction = coordinates.censoring === "above" ? increasingY : -increasingY;
+      triangle(censored, px, py, radius, direction || 1);
+    }
+  }
+  const common = {
+    stroke,
+    strokeWidth,
+    opacity: alpha,
+    cursor: resolved.cursor
+  };
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(
+      Path,
+      {
+        ...events,
+        pointerEvents,
+        style: { d: observed, fill, ...common }
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      Path,
+      {
+        ...events,
+        pointerEvents,
+        style: { d: censored, fill: "transparent", ...common }
+      }
+    )
+  ] });
+}
+export {
+  CensoredPointSeries
+};
+//# sourceMappingURL=censored-point-series.js.map