@pibbl/core 0.0.2 → 0.0.3-alpha.85.1

package/dist/features/viz/inspection.d.ts

@@ -0,0 +1,19 @@
+/** Optional committed-render inspection. Rendering entries do not import these algorithms. */
+export { useNumericInspection, usePointInspection, } from "./inspection/capture.js";
+export { withInspection } from "./inspection/handler.js";
+export { paintedPointAt } from "./inspection/painted-point.js";
+export { useBarInspection, paintedBarAt } from "./inspection/bar.js";
+export type { BarInspectionRef, BarRenderedSeries, PaintedBarHit, } from "./inspection/bar.js";
+export type { PaintedPointHit } from "./inspection/painted-point.js";
+export type { InspectionContext, InspectionRef } from "./inspection/handler.js";
+export type { NumericInspectionRef, PointInspectionRef, PointRenderedSeries, } from "./inspection/capture-types.js";
+export { nearestRecordedX, nearestRecordedPoint, sampleRecordedX, firstSourceObservation, lastSourceObservation, anchorInsideClips, } from "./inspection/queries.js";
+export type { NumericRenderedSeries, NumericRenderedObservation, RecordedNumericHit, NearestRecordedXHit, NearestRecordedPointHit, RecordedXSample, NumericRenderedFilter, NumericDuplicateResolver, NumericDomainInterpolation, RenderedSeriesPoint, } from "./inspection/query-types.js";
+export type { NumericRenderedSeries as RenderedSeries, InspectionCandidate, NumericRenderedAnchors, } from "./inspection/query-types.js";
+export type { NearestRecordedXOptions, NearestRecordedPointOptions, SampleRecordedXOptions, } from "./inspection/queries.js";
+export { useVolumeInspection, nearestRecordedVolumeX, paintedVolumeAt, } from "./inspection/volume.js";
+export type { VolumeObservation, VolumeInspectionCandidate, NearestVolumeHit, PaintedVolumeHit, VolumeInspectionRef, VolumeRenderedSeries, } from "./inspection/volume.js";
+export { useCandleInspection, nearestRecordedCandleX, paintedCandleAt, } from "./inspection/candle.js";
+export type { CandleObservation, CandleInspectionCandidate, NearestCandleHit, PaintedCandleHit, CandleInspectionRef, CandleRenderedSeries, } from "./inspection/candle.js";
+export { useOhlcBarInspection, nearestRecordedOhlcBarX, paintedOhlcBarAt, } from "./inspection/ohlc-bar.js";
+export type { OhlcBarObservation, OhlcBarInspectionCandidate, NearestOhlcBarHit, PaintedOhlcBarHit, OhlcBarInspectionRef, OhlcBarRenderedSeries, } from "./inspection/ohlc-bar.js";

package/dist/features/viz/inspection.js

@@ -0,0 +1,54 @@
+import {
+  useNumericInspection,
+  usePointInspection
+} from "./inspection/capture.js";
+import { withInspection } from "./inspection/handler.js";
+import { paintedPointAt } from "./inspection/painted-point.js";
+import { useBarInspection, paintedBarAt } from "./inspection/bar.js";
+import {
+  nearestRecordedX,
+  nearestRecordedPoint,
+  sampleRecordedX,
+  firstSourceObservation,
+  lastSourceObservation,
+  anchorInsideClips
+} from "./inspection/queries.js";
+import {
+  useVolumeInspection,
+  nearestRecordedVolumeX,
+  paintedVolumeAt
+} from "./inspection/volume.js";
+import {
+  useCandleInspection,
+  nearestRecordedCandleX,
+  paintedCandleAt
+} from "./inspection/candle.js";
+import {
+  useOhlcBarInspection,
+  nearestRecordedOhlcBarX,
+  paintedOhlcBarAt
+} from "./inspection/ohlc-bar.js";
+export {
+  anchorInsideClips,
+  firstSourceObservation,
+  lastSourceObservation,
+  nearestRecordedCandleX,
+  nearestRecordedOhlcBarX,
+  nearestRecordedPoint,
+  nearestRecordedVolumeX,
+  nearestRecordedX,
+  paintedBarAt,
+  paintedCandleAt,
+  paintedOhlcBarAt,
+  paintedPointAt,
+  paintedVolumeAt,
+  sampleRecordedX,
+  useBarInspection,
+  useCandleInspection,
+  useNumericInspection,
+  useOhlcBarInspection,
+  usePointInspection,
+  useVolumeInspection,
+  withInspection
+};
+//# sourceMappingURL=inspection.js.map

package/dist/features/viz/inspection.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/features/viz/inspection.ts"],
+  "sourcesContent": ["/** Optional committed-render inspection. Rendering entries do not import these algorithms. */\nexport {\n  useNumericInspection,\n  usePointInspection,\n} from \"./inspection/capture.js\";\nexport { withInspection } from \"./inspection/handler.js\";\nexport { paintedPointAt } from \"./inspection/painted-point.js\";\nexport { useBarInspection, paintedBarAt } from \"./inspection/bar.js\";\nexport type {\n  BarInspectionRef,\n  BarRenderedSeries,\n  PaintedBarHit,\n} from \"./inspection/bar.js\";\nexport type { PaintedPointHit } from \"./inspection/painted-point.js\";\nexport type { InspectionContext, InspectionRef } from \"./inspection/handler.js\";\nexport type {\n  NumericInspectionRef,\n  PointInspectionRef,\n  PointRenderedSeries,\n} from \"./inspection/capture-types.js\";\nexport {\n  nearestRecordedX,\n  nearestRecordedPoint,\n  sampleRecordedX,\n  firstSourceObservation,\n  lastSourceObservation,\n  anchorInsideClips,\n} from \"./inspection/queries.js\";\nexport type {\n  NumericRenderedSeries,\n  NumericRenderedObservation,\n  RecordedNumericHit,\n  NearestRecordedXHit,\n  NearestRecordedPointHit,\n  RecordedXSample,\n  NumericRenderedFilter,\n  NumericDuplicateResolver,\n  NumericDomainInterpolation,\n  RenderedSeriesPoint,\n} from \"./inspection/query-types.js\";\n\nexport type {\n  NumericRenderedSeries as RenderedSeries,\n  InspectionCandidate,\n  NumericRenderedAnchors,\n} from \"./inspection/query-types.js\";\nexport type {\n  NearestRecordedXOptions,\n  NearestRecordedPointOptions,\n  SampleRecordedXOptions,\n} from \"./inspection/queries.js\";\nexport {\n  useVolumeInspection,\n  nearestRecordedVolumeX,\n  paintedVolumeAt,\n} from \"./inspection/volume.js\";\nexport type {\n  VolumeObservation,\n  VolumeInspectionCandidate,\n  NearestVolumeHit,\n  PaintedVolumeHit,\n  VolumeInspectionRef,\n  VolumeRenderedSeries,\n} from \"./inspection/volume.js\";\nexport {\n  useCandleInspection,\n  nearestRecordedCandleX,\n  paintedCandleAt,\n} from \"./inspection/candle.js\";\nexport type {\n  CandleObservation,\n  CandleInspectionCandidate,\n  NearestCandleHit,\n  PaintedCandleHit,\n  CandleInspectionRef,\n  CandleRenderedSeries,\n} from \"./inspection/candle.js\";\nexport {\n  useOhlcBarInspection,\n  nearestRecordedOhlcBarX,\n  paintedOhlcBarAt,\n} from \"./inspection/ohlc-bar.js\";\nexport type {\n  OhlcBarObservation,\n  OhlcBarInspectionCandidate,\n  NearestOhlcBarHit,\n  PaintedOhlcBarHit,\n  OhlcBarInspectionRef,\n  OhlcBarRenderedSeries,\n} from \"./inspection/ohlc-bar.js\";\n"],
+  "mappings": "AACA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,sBAAsB;AAC/B,SAAS,sBAAsB;AAC/B,SAAS,kBAAkB,oBAAoB;AAa/C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAwBP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;",
+  "names": []
+}

package/dist/features/viz/inspection.mjs

@@ -0,0 +1 @@
+export * from './inspection.js';

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

@@ -0,0 +1,62 @@
+import type { Path } from "@pibbl/core";
+import type { FillStyle, PibblEventHandlers, PibblEventParticipationOptions, SignalValue } from "@pibbl/core";
+import type { SignalStyle } from "@pibbl/core/internal";
+import type { LineAccessor, LineSeriesProps } from "./types.js";
+/**
+ * Presentation properties for an {@link AreaSeries}.
+ *
+ * @see {@link FillStyle}
+ * @see {@link AreaSeriesProps}
+ */
+export interface AreaSeriesStyle {
+    /** Paint used for the area interior. */
+    readonly fill?: FillStyle;
+    /** Opacity of the painted area, from zero through one. */
+    readonly opacity?: number;
+    /** Cursor shown while the area target owns pointer presentation. */
+    readonly cursor?: string;
+}
+/**
+ * Authored inputs for {@link AreaSeries}.
+ *
+ * The data, coordinate accessors, scales, and defined predicate use the same
+ * contract as {@link LineSeriesProps}. Each contiguous run of at least two
+ * valid observations is closed to `baseline` in data space.
+ *
+ * @see {@link LineSeriesProps}
+ * @see {@link AreaSeriesStyle}
+ */
+export interface AreaSeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /** Application data supplied directly or through a signal. */
+    readonly data: LineSeriesProps<D>["data"];
+    /** Property key or callback extracting the horizontal coordinate. */
+    readonly x: LineAccessor<D>;
+    /** Property key or callback extracting the vertical coordinate. */
+    readonly y: LineAccessor<D>;
+    /** Continuous scale used to map horizontal data coordinates. */
+    readonly xScale: LineSeriesProps<D>["xScale"];
+    /** Continuous scale used to map vertical data coordinates and baseline. */
+    readonly yScale: LineSeriesProps<D>["yScale"];
+    /** Selects records that participate in an observed run. */
+    readonly defined?: LineSeriesProps<D>["defined"];
+    /** Curve used to connect successive observed samples. */
+    readonly curve?: LineSeriesProps<D>["curve"];
+    /** Finite data-space value to which each observed run closes. */
+    readonly baseline: SignalValue<number>;
+    /** Shared area presentation. Individual datum styling is not supported. */
+    readonly style?: SignalValue<SignalStyle<AreaSeriesStyle>>;
+}
+/**
+ * Draws each contiguous observed run as a filled polygon closed to an explicit baseline.
+ *
+ * Missing, non-finite, and excluded coordinates split runs. A lone observation has no area.
+ * The component owns one ordinary {@link Path} target, so event participation follows the
+ * standard Path defaults; callers may wrap it in `Clip` when clipping is needed.
+ *
+ * @param props - Data, coordinate accessors, continuous scales, baseline, and presentation.
+ * @returns A Pibbl path node containing all drawable area runs.
+ * @throws When `data` is not an array, the baseline is not finite, or presentation is invalid.
+ *
+ * @see {@link AreaSeriesProps}
+ */
+export declare function AreaSeries<D>({ data: dataInput, x: xInput, y: yInput, xScale: xId, yScale: yId, baseline: baselineInput, defined, curve, style: styleInput, ...eventProps }: AreaSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;

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

@@ -0,0 +1,120 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import { useNumericPosition } from "./series-position.js";
+import { Path, resolveSignalValue } from "@pibbl/core";
+import {
+  useInternalValueMemoSlot,
+  validateTexturePaint
+} from "@pibbl/core/internal";
+import {
+  appendCurveForward,
+  curveGeometry,
+  resolveSeriesCurve
+} from "./curve-definition.js";
+import { opacity } from "./paint.js";
+import { useContinuousScale } from "./use-continuous-scale.js";
+function accessor(input) {
+  return typeof input === "function" ? input : (datum) => datum[input];
+}
+function fill(value) {
+  if (typeof value === "string" || value instanceof CanvasGradient || value instanceof CanvasPattern)
+    return value;
+  try {
+    validateTexturePaint(value);
+    return value;
+  } catch {
+    throw new TypeError("AreaSeries: invalid fill.");
+  }
+}
+function AreaSeries({
+  data: dataInput,
+  x: xInput,
+  y: yInput,
+  xScale: xId,
+  yScale: yId,
+  baseline: baselineInput,
+  defined,
+  curve,
+  style: styleInput,
+  ...eventProps
+}) {
+  const xScale = useNumericPosition(xId);
+  const yScale = useContinuousScale(yId).get();
+  const curveDefinition = resolveSeriesCurve(curve);
+  const x = useInternalValueMemoSlot(
+    "vizAreaXAccessor",
+    () => accessor(xInput),
+    [xInput]
+  );
+  const y = useInternalValueMemoSlot(
+    "vizAreaYAccessor",
+    () => accessor(yInput),
+    [yInput]
+  );
+  const data = resolveSignalValue(dataInput);
+  if (!Array.isArray(data))
+    throw new TypeError(
+      "AreaSeries data must be an array or a signal containing an array."
+    );
+  const baseline = resolveSignalValue(baselineInput);
+  if (typeof baseline !== "number" || !Number.isFinite(baseline))
+    throw new RangeError("AreaSeries baseline must be finite.");
+  const baselineY = yScale.map(baseline);
+  if (!Number.isFinite(baselineY))
+    throw new RangeError(
+      "AreaSeries baseline must map to a finite coordinate."
+    );
+  const style = resolveSignalValue(styleInput) ?? {};
+  if (style === null || typeof style !== "object" || Array.isArray(style))
+    throw new TypeError("AreaSeries: style must be an object.");
+  const areaFill = fill(resolveSignalValue(style.fill) ?? "#2563eb");
+  const alpha = opacity(resolveSignalValue(style.opacity) ?? 0.2, "AreaSeries");
+  const cursor = resolveSignalValue(style.cursor);
+  if (cursor !== void 0 && typeof cursor !== "string")
+    throw new TypeError("AreaSeries: cursor must be a string.");
+  const path = new Path2D();
+  let run = [];
+  const closeRun = () => {
+    if (run.length >= 2) {
+      const first = run[0];
+      const last = run[run.length - 1];
+      const geometry = curveGeometry(curveDefinition, run);
+      path.moveTo(geometry.start[0], geometry.start[1]);
+      appendCurveForward(path, geometry);
+      path.lineTo(last[0], baselineY);
+      path.lineTo(first[0], baselineY);
+      path.closePath();
+    }
+    run = [];
+  };
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    if (defined && !defined(datum, i, data)) {
+      closeRun();
+      continue;
+    }
+    const xv = x(datum, i, data);
+    const yv = y(datum, i, data);
+    if (typeof xv !== "number" || typeof yv !== "number" || !Number.isFinite(xv) || !Number.isFinite(yv)) {
+      closeRun();
+      continue;
+    }
+    const point = [xScale.map(xv), yScale.map(yv)];
+    if (!Number.isFinite(point[0]) || !Number.isFinite(point[1])) {
+      closeRun();
+      continue;
+    }
+    run.push(point);
+  }
+  closeRun();
+  return /* @__PURE__ */ jsx(
+    Path,
+    {
+      ...eventProps,
+      style: { d: path, fill: areaFill, opacity: alpha, cursor }
+    }
+  );
+}
+export {
+  AreaSeries
+};
+//# sourceMappingURL=area-series.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/area-series.tsx"],
+  "sourcesContent": ["import { useNumericPosition } from \"./series-position.js\";\nimport { Path, resolveSignalValue } from \"@pibbl/core\";\nimport type {\n  FillStyle,\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n  SignalValue,\n} from \"@pibbl/core\";\nimport {\n  useInternalValueMemoSlot,\n  validateTexturePaint,\n} from \"@pibbl/core/internal\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { LineAccessor, LineCoordinate, LineSeriesProps } from \"./types.js\";\nimport {\n  appendCurveForward,\n  curveGeometry,\n  resolveSeriesCurve,\n} from \"./curve-definition.js\";\nimport { opacity } from \"./paint.js\";\nimport { useContinuousScale } from \"./use-continuous-scale.js\";\n\n/**\n * Presentation properties for an {@link AreaSeries}.\n *\n * @see {@link FillStyle}\n * @see {@link AreaSeriesProps}\n */\nexport interface AreaSeriesStyle {\n  /** Paint used for the area interior. */\n  readonly fill?: FillStyle;\n  /** Opacity of the painted area, from zero through one. */\n  readonly opacity?: number;\n  /** Cursor shown while the area target owns pointer presentation. */\n  readonly cursor?: string;\n}\n\n/**\n * Authored inputs for {@link AreaSeries}.\n *\n * The data, coordinate accessors, scales, and defined predicate use the same\n * contract as {@link LineSeriesProps}. Each contiguous run of at least two\n * valid observations is closed to `baseline` in data space.\n *\n * @see {@link LineSeriesProps}\n * @see {@link AreaSeriesStyle}\n */\nexport interface AreaSeriesProps<D>\n  extends PibblEventHandlers, PibblEventParticipationOptions {\n  /** Application data supplied directly or through a signal. */\n  readonly data: LineSeriesProps<D>[\"data\"];\n  /** Property key or callback extracting the horizontal coordinate. */\n  readonly x: LineAccessor<D>;\n  /** Property key or callback extracting the vertical coordinate. */\n  readonly y: LineAccessor<D>;\n  /** Continuous scale used to map horizontal data coordinates. */\n  readonly xScale: LineSeriesProps<D>[\"xScale\"];\n  /** Continuous scale used to map vertical data coordinates and baseline. */\n  readonly yScale: LineSeriesProps<D>[\"yScale\"];\n  /** Selects records that participate in an observed run. */\n  readonly defined?: LineSeriesProps<D>[\"defined\"];\n  /** Curve used to connect successive observed samples. */\n  readonly curve?: LineSeriesProps<D>[\"curve\"];\n  /** Finite data-space value to which each observed run closes. */\n  readonly baseline: SignalValue<number>;\n  /** Shared area presentation. Individual datum styling is not supported. */\n  readonly style?: SignalValue<SignalStyle<AreaSeriesStyle>>;\n}\n\nfunction accessor<D>(\n  input: LineAccessor<D>,\n): (datum: D, index: number, data: readonly D[]) => LineCoordinate {\n  return typeof input === \"function\"\n    ? input\n    : (datum) => datum[input] as LineCoordinate;\n}\n\nfunction fill(value: unknown): FillStyle {\n  if (\n    typeof value === \"string\" ||\n    value instanceof CanvasGradient ||\n    value instanceof CanvasPattern\n  )\n    return value;\n  try {\n    validateTexturePaint(value as never);\n    return value as FillStyle;\n  } catch {\n    throw new TypeError(\"AreaSeries: invalid fill.\");\n  }\n}\n\n/**\n * Draws each contiguous observed run as a filled polygon closed to an explicit baseline.\n *\n * Missing, non-finite, and excluded coordinates split runs. A lone observation has no area.\n * The component owns one ordinary {@link Path} target, so event participation follows the\n * standard Path defaults; callers may wrap it in `Clip` when clipping is needed.\n *\n * @param props - Data, coordinate accessors, continuous scales, baseline, and presentation.\n * @returns A Pibbl path node containing all drawable area runs.\n * @throws When `data` is not an array, the baseline is not finite, or presentation is invalid.\n *\n * @see {@link AreaSeriesProps}\n */\nexport function AreaSeries<D>({\n  data: dataInput,\n  x: xInput,\n  y: yInput,\n  xScale: xId,\n  yScale: yId,\n  baseline: baselineInput,\n  defined,\n  curve,\n  style: styleInput,\n  ...eventProps\n}: AreaSeriesProps<D>) {\n  const xScale = useNumericPosition(xId);\n  const yScale = useContinuousScale(yId).get();\n  const curveDefinition = resolveSeriesCurve(curve);\n  const x = useInternalValueMemoSlot(\n    \"vizAreaXAccessor\",\n    () => accessor(xInput),\n    [xInput],\n  );\n  const y = useInternalValueMemoSlot(\n    \"vizAreaYAccessor\",\n    () => accessor(yInput),\n    [yInput],\n  );\n  const data = resolveSignalValue(dataInput);\n  if (!Array.isArray(data))\n    throw new TypeError(\n      \"AreaSeries data must be an array or a signal containing an array.\",\n    );\n  const baseline = resolveSignalValue(baselineInput);\n  if (typeof baseline !== \"number\" || !Number.isFinite(baseline))\n    throw new RangeError(\"AreaSeries baseline must be finite.\");\n  const baselineY = yScale.map(baseline);\n  if (!Number.isFinite(baselineY))\n    throw new RangeError(\n      \"AreaSeries baseline must map to a finite coordinate.\",\n    );\n  const style = resolveSignalValue(styleInput) ?? {};\n  if (style === null || typeof style !== \"object\" || Array.isArray(style))\n    throw new TypeError(\"AreaSeries: style must be an object.\");\n  const areaFill = fill(resolveSignalValue(style.fill) ?? \"#2563eb\");\n  const alpha = opacity(resolveSignalValue(style.opacity) ?? 0.2, \"AreaSeries\");\n  const cursor = resolveSignalValue(style.cursor);\n  if (cursor !== undefined && typeof cursor !== \"string\")\n    throw new TypeError(\"AreaSeries: cursor must be a string.\");\n\n  const path = new Path2D();\n  let run: (readonly [number, number])[] = [];\n  const closeRun = () => {\n    if (run.length >= 2) {\n      const first = run[0];\n      const last = run[run.length - 1];\n      const geometry = curveGeometry(curveDefinition, run);\n      path.moveTo(geometry.start[0], geometry.start[1]);\n      appendCurveForward(path, geometry);\n      path.lineTo(last[0], baselineY);\n      path.lineTo(first[0], baselineY);\n      path.closePath();\n    }\n    run = [];\n  };\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !defined(datum, i, data)) {\n      closeRun();\n      continue;\n    }\n    const xv = x(datum, i, data);\n    const yv = y(datum, i, data);\n    if (\n      typeof xv !== \"number\" ||\n      typeof yv !== \"number\" ||\n      !Number.isFinite(xv) ||\n      !Number.isFinite(yv)\n    ) {\n      closeRun();\n      continue;\n    }\n    const point = [xScale.map(xv), yScale.map(yv)] as const;\n    if (!Number.isFinite(point[0]) || !Number.isFinite(point[1])) {\n      closeRun();\n      continue;\n    }\n    run.push(point);\n  }\n  closeRun();\n  return (\n    <Path\n      {...eventProps}\n      style={{ d: path, fill: areaFill, opacity: alpha, cursor }}\n    />\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/features/viz/lib/axis.js

@@ -38,7 +38,7 @@ function Axis(props) {
   const occupied = [];
   const visible = /* @__PURE__ */ new Set();
   const texts = selected.map((value, index) => {
-    const label = props.tickFormat ? props.tickFormat(value, index) : scale.type === "utc" ? scale.formatTick(value) : typeof value === "number" ? String(Number(value.toPrecision(6))) : value;
+    const label = props.tickFormat ? props.tickFormat(value, index) : scale.type === "utc" || scale.type === "trading-time" ? scale.formatTick(value) : typeof value === "number" ? String(Number(value.toPrecision(6))) : value;
     if (typeof label !== "string") throw new TypeError("Axis tickFormat must return a string.");
     return label;
   });

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/viz/lib/axis.tsx"],
-  "sourcesContent": ["import { Path, Text, resolveSignalValue, useCanvasContext } from \"@pibbl/core\";\nimport type { AxisProps } from \"./types.js\";\nimport { lookupScale } from \"./scale-context.js\";\nimport { width, opacity } from \"./paint.js\";\n\nimport { fitAxisLabel } from \"./axis-labels.js\";\n\nimport { ticks, position } from \"./scale-ticks.js\";\n\n/**\n * Draws ticks and labels using a named scale and the configured orientation and style.\n *\n * @param props - Scale, orientation, tick, label, and styling options. See {@link AxisProps}.\n * @returns Pibbl nodes drawing the axis.\n *\n * @see {@link AxisProps}\n */\nexport function Axis(props: AxisProps) {\n  if (\n    props.position !== \"bottom\" &&\n    props.position !== \"left\" &&\n    props.position !== \"top\" &&\n    props.position !== \"right\"\n  )\n    throw new TypeError(\"Axis position must be bottom, left, top, or right.\");\n  const source = lookupScale(props.scale, \"Axis\");\n  if (!source) throw new TypeError(\"Axis requires a scale ID.\");\n  const scale = source.get();\n  const style = resolveSignalValue(props.style) ?? {};\n  const stroke = resolveSignalValue(style.stroke) ?? \"#64748b\";\n  const strokeWidth = width(resolveSignalValue(style.strokeWidth) ?? 1, \"Axis\");\n  const fill = resolveSignalValue(style.fill) ?? \"#64748b\";\n  const font = resolveSignalValue(style.font) ?? \"12px sans-serif\";\n  const alpha = opacity(resolveSignalValue(style.opacity) ?? 1, \"Axis\");\n  const horizontal = props.position === \"bottom\" || props.position === \"top\";\n  const outward = props.position === \"bottom\" || props.position === \"right\" ? 1 : -1;\n  const baseline = horizontal\n    ? props.position === \"bottom\" ? scale.frame.height : 0\n    : props.position === \"right\" ? scale.frame.width : 0;\n  const selected = ticks(scale, props);\n  const context = useCanvasContext();\n  const overlap = resolveSignalValue(props.labelOverlap ?? \"allow\");\n  const gap = resolveSignalValue(props.labelGap ?? 8);\n  if (overlap !== \"allow\" && overlap !== \"skip\") throw new TypeError(\"Axis labelOverlap must be allow or skip.\");\n  if (!Number.isFinite(gap) || gap < 0) throw new RangeError(\"Axis labelGap must be finite and nonnegative.\");\n  const overflow = resolveSignalValue(props.labelOverflow ?? \"allow\");\n  const maxWidth = props.labelMaxWidth === undefined ? undefined : resolveSignalValue(props.labelMaxWidth);\n  const maxLines = resolveSignalValue(props.labelMaxLines ?? 2);\n  const lineHeightInput = props.labelLineHeight === undefined ? undefined : resolveSignalValue(props.labelLineHeight);\n  if (![\"allow\", \"wrap\", \"truncate\"].includes(overflow)) throw new TypeError(\"Axis labelOverflow must be allow, wrap, or truncate.\");\n  if ((overflow !== \"allow\" && maxWidth === undefined) || (maxWidth !== undefined && (!Number.isFinite(maxWidth) || maxWidth <= 0))) throw new RangeError(\"Axis labelMaxWidth must be positive and finite for wrap/truncate.\");\n  if (!Number.isInteger(maxLines) || maxLines < 1 || maxLines > 20) throw new RangeError(\"Axis labelMaxLines must be an integer from 1 to 20.\");\n  if (lineHeightInput !== undefined && (!Number.isFinite(lineHeightInput) || lineHeightInput <= 0)) throw new RangeError(\"Axis labelLineHeight must be positive and finite.\");\n  let lineHeight = 0;\n  const lines: (readonly string[])[] = [];\n  const occupied: { start: number; end: number }[] = [];\n  const visible = new Set<number>();\n  const texts = selected.map((value, index) => {\n    const label = props.tickFormat ? props.tickFormat(value, index)\n      : scale.type === \"utc\" ? scale.formatTick(value as number)\n      : typeof value === \"number\" ? String(Number(value.toPrecision(6))) : value;\n    if (typeof label !== \"string\") throw new TypeError(\"Axis tickFormat must return a string.\");\n    return label;\n  });\n  // Endpoints have priority; sort by physical position for reversed ranges too.\n  const order = selected.map((value, index) => ({ index, p: position(scale, value) })).sort((a, b) => a.p - b.p);\n  const priority = order.length > 1 ? [order[0], order[order.length - 1], ...order.slice(1, -1)] : order;\n  context.save();\n  try {\n    context.font = font;\n    const fontMetrics = context.measureText(\"Mg\");\n    lineHeight = lineHeightInput ?? Math.ceil(fontMetrics.actualBoundingBoxAscent + fontMetrics.actualBoundingBoxDescent + 4);\n    for (const text of texts) lines.push(fitAxisLabel(context, text, maxWidth ?? Infinity, overflow, maxLines));\n    for (const { index, p } of priority) {\n      const metrics = lines[index].map(text => context.measureText(text));\n      const size = horizontal ? Math.max(...metrics.map(m => m.width)) : (lines[index].length - 1) * lineHeight + Math.max(...metrics.map(m => m.actualBoundingBoxAscent + m.actualBoundingBoxDescent));\n      const interval = { start: p - size / 2, end: p + size / 2 };\n      if (overlap === \"allow\" || occupied.every(other => interval.end + gap <= other.start || interval.start >= other.end + gap)) {\n        visible.add(index); occupied.push(interval);\n      }\n    }\n  } finally { context.restore(); }\n  const path = new Path2D();\n  if (horizontal) {\n    path.moveTo(scale.range[0], baseline);\n    path.lineTo(scale.range[1], baseline);\n  } else {\n    path.moveTo(baseline, scale.range[0]);\n    path.lineTo(baseline, scale.range[1]);\n  }\n  const labels = selected.map((value, index) => {\n    const p = position(scale, value);\n    if (horizontal) {\n      path.moveTo(p, baseline);\n      path.lineTo(p, baseline + outward * 6);\n    } else {\n      path.moveTo(baseline, p);\n      path.lineTo(baseline + outward * 6, p);\n    }\n    if (!visible.has(index)) return null;\n    return lines[index].map((label, lineIndex) => (\n      <Text\n        key={`${index}:${lineIndex}`}\n        pointerEvents=\"none\"\n        style={{\n          left: horizontal ? p : baseline + outward * 10,\n          top: horizontal ? baseline + outward * 10 + (outward > 0 ? lineIndex : lineIndex - lines[index].length + 1) * lineHeight : p + (lineIndex - (lines[index].length - 1) / 2) * lineHeight,\n          fill,\n          font,\n          opacity: alpha,\n          textAlign: horizontal ? \"center\" : outward < 0 ? \"right\" : \"left\",\n          textBaseline: horizontal ? outward > 0 ? \"top\" : \"bottom\" : \"middle\",\n        }}\n      >\n        {label}\n      </Text>\n    ));\n  });\n  return [\n    <Path\n      key=\"axis\"\n      pointerEvents=\"none\"\n      style={{ d: path, stroke, strokeWidth, opacity: alpha }}\n    />,\n    labels,\n  ];\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { Path, Text, resolveSignalValue, useCanvasContext } from \"@pibbl/core\";\nimport type { AxisProps } from \"./types.js\";\nimport { lookupScale } from \"./scale-context.js\";\nimport { width, opacity } from \"./paint.js\";\n\nimport { fitAxisLabel } from \"./axis-labels.js\";\n\nimport { ticks, position } from \"./scale-ticks.js\";\n\n/**\n * Draws ticks and labels using a named scale and the configured orientation and style.\n *\n * @param props - Scale, orientation, tick, label, and styling options. See {@link AxisProps}.\n * @returns Pibbl nodes drawing the axis.\n *\n * @see {@link AxisProps}\n */\nexport function Axis(props: AxisProps) {\n  if (\n    props.position !== \"bottom\" &&\n    props.position !== \"left\" &&\n    props.position !== \"top\" &&\n    props.position !== \"right\"\n  )\n    throw new TypeError(\"Axis position must be bottom, left, top, or right.\");\n  const source = lookupScale(props.scale, \"Axis\");\n  if (!source) throw new TypeError(\"Axis requires a scale ID.\");\n  const scale = source.get();\n  const style = resolveSignalValue(props.style) ?? {};\n  const stroke = resolveSignalValue(style.stroke) ?? \"#64748b\";\n  const strokeWidth = width(resolveSignalValue(style.strokeWidth) ?? 1, \"Axis\");\n  const fill = resolveSignalValue(style.fill) ?? \"#64748b\";\n  const font = resolveSignalValue(style.font) ?? \"12px sans-serif\";\n  const alpha = opacity(resolveSignalValue(style.opacity) ?? 1, \"Axis\");\n  const horizontal = props.position === \"bottom\" || props.position === \"top\";\n  const outward = props.position === \"bottom\" || props.position === \"right\" ? 1 : -1;\n  const baseline = horizontal\n    ? props.position === \"bottom\" ? scale.frame.height : 0\n    : props.position === \"right\" ? scale.frame.width : 0;\n  const selected = ticks(scale, props);\n  const context = useCanvasContext();\n  const overlap = resolveSignalValue(props.labelOverlap ?? \"allow\");\n  const gap = resolveSignalValue(props.labelGap ?? 8);\n  if (overlap !== \"allow\" && overlap !== \"skip\") throw new TypeError(\"Axis labelOverlap must be allow or skip.\");\n  if (!Number.isFinite(gap) || gap < 0) throw new RangeError(\"Axis labelGap must be finite and nonnegative.\");\n  const overflow = resolveSignalValue(props.labelOverflow ?? \"allow\");\n  const maxWidth = props.labelMaxWidth === undefined ? undefined : resolveSignalValue(props.labelMaxWidth);\n  const maxLines = resolveSignalValue(props.labelMaxLines ?? 2);\n  const lineHeightInput = props.labelLineHeight === undefined ? undefined : resolveSignalValue(props.labelLineHeight);\n  if (![\"allow\", \"wrap\", \"truncate\"].includes(overflow)) throw new TypeError(\"Axis labelOverflow must be allow, wrap, or truncate.\");\n  if ((overflow !== \"allow\" && maxWidth === undefined) || (maxWidth !== undefined && (!Number.isFinite(maxWidth) || maxWidth <= 0))) throw new RangeError(\"Axis labelMaxWidth must be positive and finite for wrap/truncate.\");\n  if (!Number.isInteger(maxLines) || maxLines < 1 || maxLines > 20) throw new RangeError(\"Axis labelMaxLines must be an integer from 1 to 20.\");\n  if (lineHeightInput !== undefined && (!Number.isFinite(lineHeightInput) || lineHeightInput <= 0)) throw new RangeError(\"Axis labelLineHeight must be positive and finite.\");\n  let lineHeight = 0;\n  const lines: (readonly string[])[] = [];\n  const occupied: { start: number; end: number }[] = [];\n  const visible = new Set<number>();\n  const texts = selected.map((value, index) => {\n    const label = props.tickFormat ? props.tickFormat(value, index)\n      : (scale.type === \"utc\" || scale.type === \"trading-time\") ? scale.formatTick(value as number)\n      : typeof value === \"number\" ? String(Number(value.toPrecision(6))) : value;\n    if (typeof label !== \"string\") throw new TypeError(\"Axis tickFormat must return a string.\");\n    return label;\n  });\n  // Endpoints have priority; sort by physical position for reversed ranges too.\n  const order = selected.map((value, index) => ({ index, p: position(scale, value) })).sort((a, b) => a.p - b.p);\n  const priority = order.length > 1 ? [order[0], order[order.length - 1], ...order.slice(1, -1)] : order;\n  context.save();\n  try {\n    context.font = font;\n    const fontMetrics = context.measureText(\"Mg\");\n    lineHeight = lineHeightInput ?? Math.ceil(fontMetrics.actualBoundingBoxAscent + fontMetrics.actualBoundingBoxDescent + 4);\n    for (const text of texts) lines.push(fitAxisLabel(context, text, maxWidth ?? Infinity, overflow, maxLines));\n    for (const { index, p } of priority) {\n      const metrics = lines[index].map(text => context.measureText(text));\n      const size = horizontal ? Math.max(...metrics.map(m => m.width)) : (lines[index].length - 1) * lineHeight + Math.max(...metrics.map(m => m.actualBoundingBoxAscent + m.actualBoundingBoxDescent));\n      const interval = { start: p - size / 2, end: p + size / 2 };\n      if (overlap === \"allow\" || occupied.every(other => interval.end + gap <= other.start || interval.start >= other.end + gap)) {\n        visible.add(index); occupied.push(interval);\n      }\n    }\n  } finally { context.restore(); }\n  const path = new Path2D();\n  if (horizontal) {\n    path.moveTo(scale.range[0], baseline);\n    path.lineTo(scale.range[1], baseline);\n  } else {\n    path.moveTo(baseline, scale.range[0]);\n    path.lineTo(baseline, scale.range[1]);\n  }\n  const labels = selected.map((value, index) => {\n    const p = position(scale, value);\n    if (horizontal) {\n      path.moveTo(p, baseline);\n      path.lineTo(p, baseline + outward * 6);\n    } else {\n      path.moveTo(baseline, p);\n      path.lineTo(baseline + outward * 6, p);\n    }\n    if (!visible.has(index)) return null;\n    return lines[index].map((label, lineIndex) => (\n      <Text\n        key={`${index}:${lineIndex}`}\n        pointerEvents=\"none\"\n        style={{\n          left: horizontal ? p : baseline + outward * 10,\n          top: horizontal ? baseline + outward * 10 + (outward > 0 ? lineIndex : lineIndex - lines[index].length + 1) * lineHeight : p + (lineIndex - (lines[index].length - 1) / 2) * lineHeight,\n          fill,\n          font,\n          opacity: alpha,\n          textAlign: horizontal ? \"center\" : outward < 0 ? \"right\" : \"left\",\n          textBaseline: horizontal ? outward > 0 ? \"top\" : \"bottom\" : \"middle\",\n        }}\n      >\n        {label}\n      </Text>\n    ));\n  });\n  return [\n    <Path\n      key=\"axis\"\n      pointerEvents=\"none\"\n      style={{ d: path, stroke, strokeWidth, opacity: alpha }}\n    />,\n    labels,\n  ];\n}\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -63,6 +63,8 @@ interface BarSeriesBaseProps<D> extends PibblEventHandlers, PibblEventParticipat
      * Application data supplied to the component or reported by the event. See {@link SignalValue}.
      */
     readonly data: SignalValue<readonly D[]>;
+    /** Optional committed bar capture; rendering alone performs no inspection searches. */
+    readonly inspection?: import("../inspection/bar.js").BarInspectionRef<D>;
     /** Selects `"vertical"`, `"horizontal"` for orientation. See {@link BarSeriesBaseProps}. */
     readonly orientation?: "vertical" | "horizontal";
     /** Property or callback extracting a bar's discrete category. See {@link BarCategoryAccessor}. */
@@ -147,4 +149,4 @@ export type BarSeriesProps<D> = BarSeriesBaseProps<D> & ({
  *
  * @see {@link BarSeriesProps}
  */
-export declare function BarSeries<D>({ data: input, orientation, category: categoryInput, value: valueInput, valueStart, valueEnd, categoryScale, valueScale, baseline, group, groupScale, defined, style: styleInput, pointerEvents, ...events }: BarSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;
+export declare function BarSeries<D>({ data: input, orientation, category: categoryInput, value: valueInput, valueStart, valueEnd, categoryScale, valueScale, baseline, group, groupScale, defined, style: styleInput, pointerEvents, inspection, ...events }: BarSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;

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

@@ -28,6 +28,7 @@ function BarSeries({
   defined,
   style: styleInput,
   pointerEvents,
+  inspection,
   ...events
 }) {
   const categories = useBarScale(categoryScale).get();
@@ -98,6 +99,7 @@ function BarSeries({
   }
   const shared = typeof specified === "function" ? void 0 : normalize(specified ?? {}, false);
   const nodes = [];
+  const captured = inspection ? [] : void 0;
   for (let i = 0; i < data.length; i++) {
     const datum = data[i];
     if (defined && !defined(datum, i, data)) continue;
@@ -124,6 +126,18 @@ function BarSeries({
       throw new RangeError("BarSeries value extent must be finite.");
     if (extent === 0) continue;
     const vertical = orientation === "vertical";
+    const markFill = fill(from, v);
+    captured?.push(Object.freeze({
+      datum,
+      sourceIndex: i,
+      category: c,
+      group: g ?? void 0,
+      valueStart: from,
+      valueEnd: v,
+      boundsLocal: Object.freeze({ x: vertical ? start + (slotWidth - bandwidth) / 2 : Math.min(base, end), y: vertical ? Math.min(base, end) : start + (slotWidth - bandwidth) / 2, width: vertical ? bandwidth : extent, height: vertical ? extent : bandwidth }),
+      fill: !!markFill,
+      strokeWidthLocal: stroke ? strokeWidth : 0
+    }));
     nodes.push(
       /* @__PURE__ */ jsx(
         Rectangle,
@@ -134,7 +148,7 @@ function BarSeries({
             top: vertical ? Math.min(base, end) : start + (slotWidth - bandwidth) / 2,
             width: vertical ? bandwidth : extent,
             height: vertical ? extent : bandwidth,
-            fill: fill(from, v),
+            fill: markFill,
             stroke,
             strokeWidth,
             opacity: alpha,
@@ -145,6 +159,7 @@ function BarSeries({
       )
     );
   }
+  if (inspection) inspection.capture(captured);
   return /* @__PURE__ */ jsx(Group, { ...events, children: nodes });
 }
 export {

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/viz/lib/bar-series.tsx"],
-  "sourcesContent": ["import {\n  Group,\n  isSignal,\n  Rectangle,\n  resolveSignalValue,\n  useCanvasContext,\n} from \"@pibbl/core\";\nimport type {\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n  PibblNode,\n  FillStyle,\n  SignalValue,\n  StrokeStyle,\n} from \"@pibbl/core\";\nimport { withHooksForbidden } from \"@pibbl/core/internal\";\nimport { lookupScale } from \"./scale-context.js\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { BandCategory, LineAccessor, ScaleId } from \"./types.js\";\nimport { useContinuousScale } from \"./use-continuous-scale.js\";\nimport { useBarScale } from \"./use-bar-scale.js\";\nimport { pointAccessor, pointData, finiteCoordinate } from \"./point-data.js\";\nimport { opacity, width } from \"./paint.js\";\n/**\n * A data property or callback that extracts a category, with nullish values treated as missing.\n *\n * @param datum - Datum whose category is being read.\n * @param index - Zero-based index in the source data.\n * @param data - Complete source data array.\n * @returns The category, or null/undefined to indicate a missing category. See\n * {@link BandCategory} .\n *\n * @see {@link BandCategory}\n * @see {@link BarSeriesProps}\n */\nexport type BarCategoryAccessor<D> =\n  | {\n      [K in keyof D]-?: D[K] extends BandCategory | null | undefined\n        ? K\n        : never;\n    }[keyof D]\n  | ((\n      datum: D,\n      index: number,\n      data: readonly D[],\n    ) => BandCategory | null | undefined);\nimport { barFill, type BarThresholdFill } from \"./bar-fill.js\";\nexport type { BarThresholdFill } from \"./bar-fill.js\";\n/**\n * Supported geometry and presentation properties for BarSeries.\n *\n * @see {@link FillStyle}\n * @see {@link BarThresholdFill}\n * @see {@link StrokeStyle}\n * @see {@link BarStyleResolver}\n */\nexport interface BarSeriesStyle {\n  /** Width allocated to one categorical band. See {@link BarSeriesStyle}. */\n  readonly bandwidth?: number | \"auto\";\n  /** Paint used for the interior. See {@link FillStyle}, {@link BarThresholdFill}. */\n  readonly fill?: FillStyle | BarThresholdFill;\n  /** Paint used for the outline. See {@link StrokeStyle}. */\n  readonly stroke?: StrokeStyle;\n  /** Width of the painted outline. See {@link BarSeriesStyle}. */\n  readonly strokeWidth?: number;\n  /** Opacity of the painted result. See {@link BarSeriesStyle}. */\n  readonly opacity?: number;\n  /** Cursor shown while this target owns pointer presentation. See {@link BarSeriesStyle}. */\n  readonly cursor?: string;\n}\n/**\n * Computes bar styling from the datum, index, and source data.\n *\n * @param datum - Datum being styled.\n * @param index - Zero-based index in the source data.\n * @param data - Complete source data array.\n * @returns Style for this datum's bar. See {@link BarSeriesStyle}.\n *\n * @see {@link BarSeriesStyle}\n */\nexport type BarStyleResolver<D> = (\n  datum: D,\n  index: number,\n  data: readonly D[],\n) => BarSeriesStyle;\n/**\n * Shared data, category/value scales, orientation, filtering, and styling for bar variants.\n *\n * @see {@link BarCategoryAccessor}\n * @see {@link BarSeriesStyle}\n * @see {@link BarSeriesProps}\n */\ninterface BarSeriesBaseProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {\n  /**\n   * Application data supplied to the component or reported by the event. See {@link SignalValue}.\n   */\n  readonly data: SignalValue<readonly D[]>;\n  /** Selects `\"vertical\"`, `\"horizontal\"` for orientation. See {@link BarSeriesBaseProps}. */\n  readonly orientation?: \"vertical\" | \"horizontal\";\n  /** Property or callback extracting a bar's discrete category. See {@link BarCategoryAccessor}. */\n  readonly category: BarCategoryAccessor<D>;\n  /** Band scale used to place categories. See {@link ScaleId}. */\n  readonly categoryScale: ScaleId;\n  /** Numeric scale used to map bar values. See {@link ScaleId}. */\n  readonly valueScale: ScaleId;\n  /**\n   * Selects the records that participate in the bar series. See {@link BarSeriesProps}.\n   * @param datum - Record to test.\n   * @param index - Zero-based index in the source array.\n   * @param data - Complete source data array.\n   * @returns Whether this record should contribute a bar.\n   */\n  readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;\n  /**\n   * Declared presentation and layout properties. See {@link SignalValue}, {@link SignalStyle},\n   * {@link BarSeriesStyle}, {@link BarStyleResolver}.\n   */\n  readonly style?: SignalValue<SignalStyle<BarSeriesStyle> | BarStyleResolver<D>>;\n}\n/**\n * Authored inputs for BarSeries, including the declared data and presentation options.\n *\n * @see {@link LineAccessor}\n * @see {@link SignalValue}\n * @see {@link BarCategoryAccessor}\n * @see {@link ScaleId}\n * @see {@link BarSeries}\n */\nexport type BarSeriesProps<D> = BarSeriesBaseProps<D> &\n  (\n    | {\n        /** Value associated with this sample, input, or result. See {@link LineAccessor}. */\n        readonly value: LineAccessor<D>;\n        /** Numeric value from which each ordinary bar starts. See {@link SignalValue}. */\n        readonly baseline?: SignalValue<number>;\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly valueStart?: never;\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly valueEnd?: never;\n      }\n    | {\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly value?: never;\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly baseline?: never;\n        /** Accessor for the beginning of a range bar. See {@link LineAccessor}. */\n        readonly valueStart: LineAccessor<D>;\n        /** Accessor for the end of a range bar. See {@link LineAccessor}. */\n        readonly valueEnd: LineAccessor<D>;\n      }\n  ) &\n  (\n    | {\n        /** Accessor identifying the subgroup of each bar. See {@link BarCategoryAccessor}. */\n        readonly group: BarCategoryAccessor<D>;\n        /** Band scale used to place subgroups within a category. See {@link ScaleId}. */\n        readonly groupScale: ScaleId;\n      }\n    | {\n        /** Accessor identifying the subgroup of each bar. See {@link BarSeriesProps}. */\n        readonly group?: never;\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly groupScale?: never;\n      }\n  );\n/**\n * Value bars in source order; rectangles supply ordinary paint and event geometry.\n *\n * @param props - Data, category and value accessors, scales, grouping, and styling. See\n * {@link BarSeriesProps} .\n * @returns Pibbl nodes drawing the bars.\n *\n * @see {@link BarSeriesProps}\n */\nexport function BarSeries<D>({\n  data: input,\n  orientation = \"vertical\",\n  category: categoryInput,\n  value: valueInput,\n  valueStart,\n  valueEnd,\n  categoryScale,\n  valueScale,\n  baseline,\n  group,\n  groupScale,\n  defined,\n  style: styleInput,\n  pointerEvents,\n  ...events\n}: BarSeriesProps<D>) {\n  const categories = useBarScale(categoryScale).get();\n  const values = useContinuousScale(valueScale).get();\n  const groups = lookupScale(groupScale, \"BarSeries groupScale\")?.get();\n  if ((group === undefined) !== (groupScale === undefined))\n    throw new TypeError(\"BarSeries requires group and groupScale together.\");\n  if (groups && groups.type !== \"band\")\n    throw new TypeError(\"BarSeries groupScale requires a band scale.\");\n  const groupValue =\n    typeof group === \"function\"\n      ? group\n      : (datum: D) =>\n          group === undefined\n            ? undefined\n            : (datum[group] as BandCategory | null | undefined);\n  const slotWidth =\n    groups?.type === \"band\" ? groups.bandwidth : categories.bandwidth;\n  if (orientation !== \"vertical\" && orientation !== \"horizontal\")\n    throw new TypeError(\"BarSeries orientation must be vertical or horizontal.\");\n  const data = pointData(resolveSignalValue(input), \"BarSeries\");\n  const category =\n    typeof categoryInput === \"function\"\n      ? categoryInput\n      : (datum: D) =>\n          datum[categoryInput] as BandCategory | null | undefined;\n  const ranged = valueStart !== undefined || valueEnd !== undefined;\n  if (\n    ranged\n      ? valueInput !== undefined ||\n        baseline !== undefined ||\n        valueStart === undefined ||\n        valueEnd === undefined\n      : valueInput === undefined\n  )\n    throw new TypeError(\n      \"BarSeries requires either value with optional baseline, or both valueStart and valueEnd without value or baseline.\",\n    );\n  const value = pointAccessor((ranged ? valueEnd : valueInput)!);\n  const startValue = ranged ? pointAccessor(valueStart!) : undefined;\n  const baselineValue = resolveSignalValue(baseline ?? 0);\n  const sharedBase = ranged ? undefined : values.map(baselineValue);\n  const specified = resolveSignalValue(styleInput);\n  const ctx = useCanvasContext();\n  function normalize(input: unknown, callback: boolean) {\n    if (!input || typeof input !== \"object\" || Array.isArray(input))\n      throw new TypeError(\"BarSeries style must be an object.\");\n    if (\n      callback &&\n      Object.getPrototypeOf(input) !== Object.prototype &&\n      Object.getPrototypeOf(input) !== null\n    )\n      throw new TypeError(\n        \"BarSeries datum style must be a plain synchronous object.\",\n      );\n    const style: Record<string, unknown> = {};\n    for (const key of Object.keys(input)) {\n      if (\n        ![\n          \"bandwidth\",\n          \"fill\",\n          \"stroke\",\n          \"strokeWidth\",\n          \"opacity\",\n          \"cursor\",\n        ].includes(key)\n      )\n        throw new TypeError(`BarSeries: unsupported style field ${key}.`);\n      const value = (input as Record<string, unknown>)[key];\n      if (callback && isSignal(value))\n        throw new TypeError(\n          \"BarSeries datum styles require plain values; read signals explicitly.\",\n        );\n      style[key] = callback ? value : resolveSignalValue(value);\n    }\n    const resolved = style as BarSeriesStyle;\n    if (resolved.cursor !== undefined && typeof resolved.cursor !== \"string\")\n      throw new TypeError(\"BarSeries cursor must be a string.\");\n    return {\n      bandwidth:\n        resolved.bandwidth === undefined || resolved.bandwidth === \"auto\"\n          ? slotWidth\n          : width(resolved.bandwidth, \"BarSeries bandwidth\"),\n      fill: barFill(ctx, resolved.fill ?? \"#2563eb\", (value) =>\n        values.map(value),\n        orientation,\n      ),\n      stroke: resolved.stroke,\n      strokeWidth: width(resolved.strokeWidth ?? 1, \"BarSeries strokeWidth\"),\n      alpha: opacity(resolved.opacity ?? 1, \"BarSeries\"),\n      cursor: resolved.cursor,\n    };\n  }\n  const shared =\n    typeof specified === \"function\"\n      ? undefined\n      : normalize(specified ?? {}, false);\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 c = category(datum, i, data),\n      v = value(datum, i, data),\n      from = startValue ? startValue(datum, i, data) : baselineValue;\n    if (c == null || !finiteCoordinate(v) || !finiteCoordinate(from)) continue;\n    const categoryStart = categories.map(c);\n    const g = groups ? groupValue(datum, i, data) : undefined;\n    const offset = groups ? (g == null ? undefined : groups.map(g)) : 0;\n    if (categoryStart === undefined || offset === undefined || slotWidth === 0)\n      continue;\n    const start = categoryStart + offset;\n    const { bandwidth, fill, stroke, strokeWidth, alpha, cursor } =\n      shared ??\n      normalize(\n        withHooksForbidden(\"BarSeries style callback\", () =>\n          (specified as BarStyleResolver<D>)(datum, i, data),\n        ),\n        true,\n      );\n    if (bandwidth === 0) continue;\n    const base = sharedBase ?? values.map(from);\n    const end = values.map(v);\n    const extent = Math.abs(end - base);\n    if (!Number.isFinite(extent))\n      throw new RangeError(\"BarSeries value extent must be finite.\");\n    if (extent === 0) continue;\n    const vertical = orientation === \"vertical\";\n    nodes.push(\n      <Rectangle\n        key={i}\n        pointerEvents={pointerEvents}\n        style={{\n          left: vertical ? start + (slotWidth - bandwidth) / 2 : Math.min(base, end),\n          top: vertical ? Math.min(base, end) : start + (slotWidth - bandwidth) / 2,\n          width: vertical ? bandwidth : extent,\n          height: vertical ? extent : bandwidth,\n          fill: fill(from, v),\n          stroke,\n          strokeWidth,\n          opacity: alpha,\n          cursor,\n        }}\n      />,\n    );\n  }\n  return <Group {...events}>{nodes}</Group>;\n}\n"],
-  "mappings": "AA4UM;AA5UN;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,0BAA0B;AACnC,SAAS,mBAAmB;AAG5B,SAAS,0BAA0B;AACnC,SAAS,mBAAmB;AAC5B,SAAS,eAAe,WAAW,wBAAwB;AAC3D,SAAS,SAAS,aAAa;AAwB/B,SAAS,eAAsC;AA+IxC,SAAS,UAAa;AAAA,EAC3B,MAAM;AAAA,EACN,cAAc;AAAA,EACd,UAAU;AAAA,EACV,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA,GAAG;AACL,GAAsB;AACpB,QAAM,aAAa,YAAY,aAAa,EAAE,IAAI;AAClD,QAAM,SAAS,mBAAmB,UAAU,EAAE,IAAI;AAClD,QAAM,SAAS,YAAY,YAAY,sBAAsB,GAAG,IAAI;AACpE,MAAK,UAAU,YAAgB,eAAe;AAC5C,UAAM,IAAI,UAAU,mDAAmD;AACzE,MAAI,UAAU,OAAO,SAAS;AAC5B,UAAM,IAAI,UAAU,6CAA6C;AACnE,QAAM,aACJ,OAAO,UAAU,aACb,QACA,CAAC,UACC,UAAU,SACN,SACC,MAAM,KAAK;AACxB,QAAM,YACJ,QAAQ,SAAS,SAAS,OAAO,YAAY,WAAW;AAC1D,MAAI,gBAAgB,cAAc,gBAAgB;AAChD,UAAM,IAAI,UAAU,uDAAuD;AAC7E,QAAM,OAAO,UAAU,mBAAmB,KAAK,GAAG,WAAW;AAC7D,QAAM,WACJ,OAAO,kBAAkB,aACrB,gBACA,CAAC,UACC,MAAM,aAAa;AAC3B,QAAM,SAAS,eAAe,UAAa,aAAa;AACxD,MACE,SACI,eAAe,UACf,aAAa,UACb,eAAe,UACf,aAAa,SACb,eAAe;AAEnB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,QAAM,QAAQ,cAAe,SAAS,WAAW,UAAY;AAC7D,QAAM,aAAa,SAAS,cAAc,UAAW,IAAI;AACzD,QAAM,gBAAgB,mBAAmB,YAAY,CAAC;AACtD,QAAM,aAAa,SAAS,SAAY,OAAO,IAAI,aAAa;AAChE,QAAM,YAAY,mBAAmB,UAAU;AAC/C,QAAM,MAAM,iBAAiB;AAC7B,WAAS,UAAUA,QAAgB,UAAmB;AACpD,QAAI,CAACA,UAAS,OAAOA,WAAU,YAAY,MAAM,QAAQA,MAAK;AAC5D,YAAM,IAAI,UAAU,oCAAoC;AAC1D,QACE,YACA,OAAO,eAAeA,MAAK,MAAM,OAAO,aACxC,OAAO,eAAeA,MAAK,MAAM;AAEjC,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AACF,UAAM,QAAiC,CAAC;AACxC,eAAW,OAAO,OAAO,KAAKA,MAAK,GAAG;AACpC,UACE,CAAC;AAAA,QACC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,EAAE,SAAS,GAAG;AAEd,cAAM,IAAI,UAAU,sCAAsC,GAAG,GAAG;AAClE,YAAMC,SAASD,OAAkC,GAAG;AACpD,UAAI,YAAY,SAASC,MAAK;AAC5B,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AACF,YAAM,GAAG,IAAI,WAAWA,SAAQ,mBAAmBA,MAAK;AAAA,IAC1D;AACA,UAAM,WAAW;AACjB,QAAI,SAAS,WAAW,UAAa,OAAO,SAAS,WAAW;AAC9D,YAAM,IAAI,UAAU,oCAAoC;AAC1D,WAAO;AAAA,MACL,WACE,SAAS,cAAc,UAAa,SAAS,cAAc,SACvD,YACA,MAAM,SAAS,WAAW,qBAAqB;AAAA,MACrD,MAAM;AAAA,QAAQ;AAAA,QAAK,SAAS,QAAQ;AAAA,QAAW,CAACA,WAC9C,OAAO,IAAIA,MAAK;AAAA,QAChB;AAAA,MACF;AAAA,MACA,QAAQ,SAAS;AAAA,MACjB,aAAa,MAAM,SAAS,eAAe,GAAG,uBAAuB;AAAA,MACrE,OAAO,QAAQ,SAAS,WAAW,GAAG,WAAW;AAAA,MACjD,QAAQ,SAAS;AAAA,IACnB;AAAA,EACF;AACA,QAAM,SACJ,OAAO,cAAc,aACjB,SACA,UAAU,aAAa,CAAC,GAAG,KAAK;AACtC,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,IAAI,SAAS,OAAO,GAAG,IAAI,GAC/B,IAAI,MAAM,OAAO,GAAG,IAAI,GACxB,OAAO,aAAa,WAAW,OAAO,GAAG,IAAI,IAAI;AACnD,QAAI,KAAK,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,iBAAiB,IAAI,EAAG;AAClE,UAAM,gBAAgB,WAAW,IAAI,CAAC;AACtC,UAAM,IAAI,SAAS,WAAW,OAAO,GAAG,IAAI,IAAI;AAChD,UAAM,SAAS,SAAU,KAAK,OAAO,SAAY,OAAO,IAAI,CAAC,IAAK;AAClE,QAAI,kBAAkB,UAAa,WAAW,UAAa,cAAc;AACvE;AACF,UAAM,QAAQ,gBAAgB;AAC9B,UAAM,EAAE,WAAW,MAAM,QAAQ,aAAa,OAAO,OAAO,IAC1D,UACA;AAAA,MACE;AAAA,QAAmB;AAAA,QAA4B,MAC5C,UAAkC,OAAO,GAAG,IAAI;AAAA,MACnD;AAAA,MACA;AAAA,IACF;AACF,QAAI,cAAc,EAAG;AACrB,UAAM,OAAO,cAAc,OAAO,IAAI,IAAI;AAC1C,UAAM,MAAM,OAAO,IAAI,CAAC;AACxB,UAAM,SAAS,KAAK,IAAI,MAAM,IAAI;AAClC,QAAI,CAAC,OAAO,SAAS,MAAM;AACzB,YAAM,IAAI,WAAW,wCAAwC;AAC/D,QAAI,WAAW,EAAG;AAClB,UAAM,WAAW,gBAAgB;AACjC,UAAM;AAAA,MACJ;AAAA,QAAC;AAAA;AAAA,UAEC;AAAA,UACA,OAAO;AAAA,YACL,MAAM,WAAW,SAAS,YAAY,aAAa,IAAI,KAAK,IAAI,MAAM,GAAG;AAAA,YACzE,KAAK,WAAW,KAAK,IAAI,MAAM,GAAG,IAAI,SAAS,YAAY,aAAa;AAAA,YACxE,OAAO,WAAW,YAAY;AAAA,YAC9B,QAAQ,WAAW,SAAS;AAAA,YAC5B,MAAM,KAAK,MAAM,CAAC;AAAA,YAClB;AAAA,YACA;AAAA,YACA,SAAS;AAAA,YACT;AAAA,UACF;AAAA;AAAA,QAZK;AAAA,MAaP;AAAA,IACF;AAAA,EACF;AACA,SAAO,oBAAC,SAAO,GAAG,QAAS,iBAAM;AACnC;",
+  "sourcesContent": ["import {\n  Group,\n  isSignal,\n  Rectangle,\n  resolveSignalValue,\n  useCanvasContext,\n} from \"@pibbl/core\";\nimport type {\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n  PibblNode,\n  FillStyle,\n  SignalValue,\n  StrokeStyle,\n} from \"@pibbl/core\";\nimport { withHooksForbidden } from \"@pibbl/core/internal\";\nimport { lookupScale } from \"./scale-context.js\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { BandCategory, LineAccessor, ScaleId } from \"./types.js\";\nimport { useContinuousScale } from \"./use-continuous-scale.js\";\nimport { useBarScale } from \"./use-bar-scale.js\";\nimport { pointAccessor, pointData, finiteCoordinate } from \"./point-data.js\";\nimport { opacity, width } from \"./paint.js\";\n/**\n * A data property or callback that extracts a category, with nullish values treated as missing.\n *\n * @param datum - Datum whose category is being read.\n * @param index - Zero-based index in the source data.\n * @param data - Complete source data array.\n * @returns The category, or null/undefined to indicate a missing category. See\n * {@link BandCategory} .\n *\n * @see {@link BandCategory}\n * @see {@link BarSeriesProps}\n */\nexport type BarCategoryAccessor<D> =\n  | {\n      [K in keyof D]-?: D[K] extends BandCategory | null | undefined\n        ? K\n        : never;\n    }[keyof D]\n  | ((\n      datum: D,\n      index: number,\n      data: readonly D[],\n    ) => BandCategory | null | undefined);\nimport { barFill, type BarThresholdFill } from \"./bar-fill.js\";\nexport type { BarThresholdFill } from \"./bar-fill.js\";\n/**\n * Supported geometry and presentation properties for BarSeries.\n *\n * @see {@link FillStyle}\n * @see {@link BarThresholdFill}\n * @see {@link StrokeStyle}\n * @see {@link BarStyleResolver}\n */\nexport interface BarSeriesStyle {\n  /** Width allocated to one categorical band. See {@link BarSeriesStyle}. */\n  readonly bandwidth?: number | \"auto\";\n  /** Paint used for the interior. See {@link FillStyle}, {@link BarThresholdFill}. */\n  readonly fill?: FillStyle | BarThresholdFill;\n  /** Paint used for the outline. See {@link StrokeStyle}. */\n  readonly stroke?: StrokeStyle;\n  /** Width of the painted outline. See {@link BarSeriesStyle}. */\n  readonly strokeWidth?: number;\n  /** Opacity of the painted result. See {@link BarSeriesStyle}. */\n  readonly opacity?: number;\n  /** Cursor shown while this target owns pointer presentation. See {@link BarSeriesStyle}. */\n  readonly cursor?: string;\n}\n/**\n * Computes bar styling from the datum, index, and source data.\n *\n * @param datum - Datum being styled.\n * @param index - Zero-based index in the source data.\n * @param data - Complete source data array.\n * @returns Style for this datum's bar. See {@link BarSeriesStyle}.\n *\n * @see {@link BarSeriesStyle}\n */\nexport type BarStyleResolver<D> = (\n  datum: D,\n  index: number,\n  data: readonly D[],\n) => BarSeriesStyle;\n/**\n * Shared data, category/value scales, orientation, filtering, and styling for bar variants.\n *\n * @see {@link BarCategoryAccessor}\n * @see {@link BarSeriesStyle}\n * @see {@link BarSeriesProps}\n */\ninterface BarSeriesBaseProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {\n  /**\n   * Application data supplied to the component or reported by the event. See {@link SignalValue}.\n   */\n  readonly data: SignalValue<readonly D[]>;\n  /** Optional committed bar capture; rendering alone performs no inspection searches. */\n  readonly inspection?: import(\"../inspection/bar.js\").BarInspectionRef<D>;\n  /** Selects `\"vertical\"`, `\"horizontal\"` for orientation. See {@link BarSeriesBaseProps}. */\n  readonly orientation?: \"vertical\" | \"horizontal\";\n  /** Property or callback extracting a bar's discrete category. See {@link BarCategoryAccessor}. */\n  readonly category: BarCategoryAccessor<D>;\n  /** Band scale used to place categories. See {@link ScaleId}. */\n  readonly categoryScale: ScaleId;\n  /** Numeric scale used to map bar values. See {@link ScaleId}. */\n  readonly valueScale: ScaleId;\n  /**\n   * Selects the records that participate in the bar series. See {@link BarSeriesProps}.\n   * @param datum - Record to test.\n   * @param index - Zero-based index in the source array.\n   * @param data - Complete source data array.\n   * @returns Whether this record should contribute a bar.\n   */\n  readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;\n  /**\n   * Declared presentation and layout properties. See {@link SignalValue}, {@link SignalStyle},\n   * {@link BarSeriesStyle}, {@link BarStyleResolver}.\n   */\n  readonly style?: SignalValue<SignalStyle<BarSeriesStyle> | BarStyleResolver<D>>;\n}\n/**\n * Authored inputs for BarSeries, including the declared data and presentation options.\n *\n * @see {@link LineAccessor}\n * @see {@link SignalValue}\n * @see {@link BarCategoryAccessor}\n * @see {@link ScaleId}\n * @see {@link BarSeries}\n */\nexport type BarSeriesProps<D> = BarSeriesBaseProps<D> &\n  (\n    | {\n        /** Value associated with this sample, input, or result. See {@link LineAccessor}. */\n        readonly value: LineAccessor<D>;\n        /** Numeric value from which each ordinary bar starts. See {@link SignalValue}. */\n        readonly baseline?: SignalValue<number>;\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly valueStart?: never;\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly valueEnd?: never;\n      }\n    | {\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly value?: never;\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly baseline?: never;\n        /** Accessor for the beginning of a range bar. See {@link LineAccessor}. */\n        readonly valueStart: LineAccessor<D>;\n        /** Accessor for the end of a range bar. See {@link LineAccessor}. */\n        readonly valueEnd: LineAccessor<D>;\n      }\n  ) &\n  (\n    | {\n        /** Accessor identifying the subgroup of each bar. See {@link BarCategoryAccessor}. */\n        readonly group: BarCategoryAccessor<D>;\n        /** Band scale used to place subgroups within a category. See {@link ScaleId}. */\n        readonly groupScale: ScaleId;\n      }\n    | {\n        /** Accessor identifying the subgroup of each bar. See {@link BarSeriesProps}. */\n        readonly group?: never;\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly groupScale?: never;\n      }\n  );\n/**\n * Value bars in source order; rectangles supply ordinary paint and event geometry.\n *\n * @param props - Data, category and value accessors, scales, grouping, and styling. See\n * {@link BarSeriesProps} .\n * @returns Pibbl nodes drawing the bars.\n *\n * @see {@link BarSeriesProps}\n */\nexport function BarSeries<D>({\n  data: input,\n  orientation = \"vertical\",\n  category: categoryInput,\n  value: valueInput,\n  valueStart,\n  valueEnd,\n  categoryScale,\n  valueScale,\n  baseline,\n  group,\n  groupScale,\n  defined,\n  style: styleInput,\n  pointerEvents,\n  inspection,\n  ...events\n}: BarSeriesProps<D>) {\n  const categories = useBarScale(categoryScale).get();\n  const values = useContinuousScale(valueScale).get();\n  const groups = lookupScale(groupScale, \"BarSeries groupScale\")?.get();\n  if ((group === undefined) !== (groupScale === undefined))\n    throw new TypeError(\"BarSeries requires group and groupScale together.\");\n  if (groups && groups.type !== \"band\")\n    throw new TypeError(\"BarSeries groupScale requires a band scale.\");\n  const groupValue =\n    typeof group === \"function\"\n      ? group\n      : (datum: D) =>\n          group === undefined\n            ? undefined\n            : (datum[group] as BandCategory | null | undefined);\n  const slotWidth =\n    groups?.type === \"band\" ? groups.bandwidth : categories.bandwidth;\n  if (orientation !== \"vertical\" && orientation !== \"horizontal\")\n    throw new TypeError(\"BarSeries orientation must be vertical or horizontal.\");\n  const data = pointData(resolveSignalValue(input), \"BarSeries\");\n  const category =\n    typeof categoryInput === \"function\"\n      ? categoryInput\n      : (datum: D) =>\n          datum[categoryInput] as BandCategory | null | undefined;\n  const ranged = valueStart !== undefined || valueEnd !== undefined;\n  if (\n    ranged\n      ? valueInput !== undefined ||\n        baseline !== undefined ||\n        valueStart === undefined ||\n        valueEnd === undefined\n      : valueInput === undefined\n  )\n    throw new TypeError(\n      \"BarSeries requires either value with optional baseline, or both valueStart and valueEnd without value or baseline.\",\n    );\n  const value = pointAccessor((ranged ? valueEnd : valueInput)!);\n  const startValue = ranged ? pointAccessor(valueStart!) : undefined;\n  const baselineValue = resolveSignalValue(baseline ?? 0);\n  const sharedBase = ranged ? undefined : values.map(baselineValue);\n  const specified = resolveSignalValue(styleInput);\n  const ctx = useCanvasContext();\n  function normalize(input: unknown, callback: boolean) {\n    if (!input || typeof input !== \"object\" || Array.isArray(input))\n      throw new TypeError(\"BarSeries style must be an object.\");\n    if (\n      callback &&\n      Object.getPrototypeOf(input) !== Object.prototype &&\n      Object.getPrototypeOf(input) !== null\n    )\n      throw new TypeError(\n        \"BarSeries datum style must be a plain synchronous object.\",\n      );\n    const style: Record<string, unknown> = {};\n    for (const key of Object.keys(input)) {\n      if (\n        ![\n          \"bandwidth\",\n          \"fill\",\n          \"stroke\",\n          \"strokeWidth\",\n          \"opacity\",\n          \"cursor\",\n        ].includes(key)\n      )\n        throw new TypeError(`BarSeries: unsupported style field ${key}.`);\n      const value = (input as Record<string, unknown>)[key];\n      if (callback && isSignal(value))\n        throw new TypeError(\n          \"BarSeries datum styles require plain values; read signals explicitly.\",\n        );\n      style[key] = callback ? value : resolveSignalValue(value);\n    }\n    const resolved = style as BarSeriesStyle;\n    if (resolved.cursor !== undefined && typeof resolved.cursor !== \"string\")\n      throw new TypeError(\"BarSeries cursor must be a string.\");\n    return {\n      bandwidth:\n        resolved.bandwidth === undefined || resolved.bandwidth === \"auto\"\n          ? slotWidth\n          : width(resolved.bandwidth, \"BarSeries bandwidth\"),\n      fill: barFill(ctx, resolved.fill ?? \"#2563eb\", (value) =>\n        values.map(value),\n        orientation,\n      ),\n      stroke: resolved.stroke,\n      strokeWidth: width(resolved.strokeWidth ?? 1, \"BarSeries strokeWidth\"),\n      alpha: opacity(resolved.opacity ?? 1, \"BarSeries\"),\n      cursor: resolved.cursor,\n    };\n  }\n  const shared =\n    typeof specified === \"function\"\n      ? undefined\n      : normalize(specified ?? {}, false);\n  const nodes: PibblNode[] = [];\n  const captured: import(\"../inspection/bar.js\").CapturedBarMark<D>[] | undefined = inspection ? [] : undefined;\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !defined(datum, i, data)) continue;\n    const c = category(datum, i, data),\n      v = value(datum, i, data),\n      from = startValue ? startValue(datum, i, data) : baselineValue;\n    if (c == null || !finiteCoordinate(v) || !finiteCoordinate(from)) continue;\n    const categoryStart = categories.map(c);\n    const g = groups ? groupValue(datum, i, data) : undefined;\n    const offset = groups ? (g == null ? undefined : groups.map(g)) : 0;\n    if (categoryStart === undefined || offset === undefined || slotWidth === 0)\n      continue;\n    const start = categoryStart + offset;\n    const { bandwidth, fill, stroke, strokeWidth, alpha, cursor } =\n      shared ??\n      normalize(\n        withHooksForbidden(\"BarSeries style callback\", () =>\n          (specified as BarStyleResolver<D>)(datum, i, data),\n        ),\n        true,\n      );\n    if (bandwidth === 0) continue;\n    const base = sharedBase ?? values.map(from);\n    const end = values.map(v);\n    const extent = Math.abs(end - base);\n    if (!Number.isFinite(extent))\n      throw new RangeError(\"BarSeries value extent must be finite.\");\n    if (extent === 0) continue;\n    const vertical = orientation === \"vertical\";\n    const markFill = fill(from,v);\n    captured?.push(Object.freeze({datum,sourceIndex:i,category:c,group:g ?? undefined,valueStart:from,valueEnd:v,\n      boundsLocal:Object.freeze({x:vertical?start+(slotWidth-bandwidth)/2:Math.min(base,end),y:vertical?Math.min(base,end):start+(slotWidth-bandwidth)/2,width:vertical?bandwidth:extent,height:vertical?extent:bandwidth}),\n      fill:!!markFill,strokeWidthLocal:stroke?strokeWidth:0}));\n    nodes.push(\n      <Rectangle\n        key={i}\n        pointerEvents={pointerEvents}\n        style={{\n          left: vertical ? start + (slotWidth - bandwidth) / 2 : Math.min(base, end),\n          top: vertical ? Math.min(base, end) : start + (slotWidth - bandwidth) / 2,\n          width: vertical ? bandwidth : extent,\n          height: vertical ? extent : bandwidth,\n          fill: markFill,\n          stroke,\n          strokeWidth,\n          opacity: alpha,\n          cursor,\n        }}\n      />,\n    );\n  }\n  if (inspection) inspection.capture(captured!);\n  return <Group {...events}>{nodes}</Group>;\n}\n"],
+  "mappings": "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",
   "names": ["input", "value"]
 }

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

@@ -0,0 +1,55 @@
+import type { FillStyle, PibblEventHandlers, PibblEventParticipationOptions, SignalValue, StrokeStyle } from "@pibbl/core";
+import type { SignalStyle } from "@pibbl/core/internal";
+import type { LineAccessor, LineSeriesProps, ScaleId } from "./types.js";
+/** Shared paint for one side of a baseline. See {@link BaselineSeries}. */
+export interface BaselineSideStyle {
+    /** Area fill for this side of the baseline. */
+    readonly fill?: FillStyle;
+    /** Line stroke for this side of the baseline. */
+    readonly stroke?: StrokeStyle;
+}
+/** Shared presentation for a linear baseline series. See {@link BaselineSeries}. */
+export interface BaselineSeriesStyle {
+    /** Paint for y values greater than or equal to baseline. */
+    readonly above?: BaselineSideStyle;
+    /** Paint for y values less than baseline. */
+    readonly below?: BaselineSideStyle;
+    /** Opacity for both area fills; defaults to 0.2. */
+    readonly fillOpacity?: number;
+    /** Width for both line strokes; defaults to 2. */
+    readonly strokeWidth?: number;
+    /** Cursor while a painted series path owns targeting. */
+    readonly cursor?: string;
+}
+/** A linear connected series split into independently painted regions at baseline crossings. See
+ * {@link BaselineSeries}.
+ */
+export interface BaselineSeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /** Application records or a signal of records; source order is retained. */
+    readonly data: SignalValue<readonly D[]>;
+    /** Property key or callback extracting horizontal coordinates. */
+    readonly x: LineAccessor<D>;
+    /** Property key or callback extracting vertical coordinates. */
+    readonly y: LineAccessor<D>;
+    /** Numeric or trading-time horizontal scale identity. */
+    readonly xScale: ScaleId;
+    /** Linear vertical scale identity. */
+    readonly yScale: ScaleId;
+    /** Finite data-space division between the above and below presentations. */
+    readonly baseline: SignalValue<number>;
+    /** Excludes a record before its accessors run. */
+    readonly defined?: LineSeriesProps<D>["defined"];
+    /** Optional committed original-record capture on the standard numeric inspection foundation. */
+    readonly inspection?: import("../inspection/capture-types.js").NumericInspectionRef<D>;
+    /** Shared above/below paint and interaction presentation. */
+    readonly style?: SignalValue<SignalStyle<BaselineSeriesStyle>>;
+}
+/**
+ * Draws a linear connected series with independently painted regions above and below a baseline.
+ * Equal values belong to the above stroke; zero-area spans never receive a fill. Gaps split runs,
+ * and optional inspection captures only original records.
+ * @param props - Records, a numeric or trading-time x scale, linear price y scale, baseline, event props, and shared side paint.
+ * @returns Filled and stroked Pibbl paths in source paint order.
+ * @see {@link LineSeriesProps}
+ */
+export declare function BaselineSeries<D>({ data: dataInput, x: xInput, y: yInput, xScale: xId, yScale: yId, baseline: baselineInput, defined, inspection, style: styleInput, ...eventProps }: BaselineSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;