@pibbl/core 0.0.2 → 0.0.3-alpha.109.1

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

@@ -0,0 +1,95 @@
+import {
+  invertNumericPosition
+} from "../lib/series-position.js";
+import { useRenderedRef } from "./owned-ref.js";
+import { nearestRecordedX } from "./queries.js";
+function useVolumeInspection(_inputs) {
+  return useRenderedRef("volumeInspection", (candidate, geometry) => {
+    const observations = Object.freeze(
+      candidate.marks.map(
+        (mark) => Object.freeze({
+          datum: mark.datum,
+          sourceIndex: mark.sourceIndex,
+          time: mark.time,
+          volume: mark.volume,
+          baseline: mark.baseline,
+          anchorLocal: mark.anchorLocal,
+          anchorRoot: geometry.rootAtLocal(mark.anchorLocal),
+          boundsLocal: mark.boundsLocal
+        })
+      )
+    );
+    const numeric = Object.freeze({
+      observations: Object.freeze(
+        observations.map(
+          (row) => Object.freeze({
+            ...row,
+            domainX: row.time,
+            domainY: row.volume,
+            run: 0
+          })
+        )
+      ),
+      assertLive: geometry.assertLive,
+      domainXAtRoot(point) {
+        const local = geometry.localAtRoot(point);
+        return local ? invertNumericPosition(candidate.xScale, local.x) : void 0;
+      },
+      anchorInsideClips: geometry.anchorInsideClips,
+      anchorAtDomain(point) {
+        geometry.assertLive();
+        const anchorLocal = Object.freeze({
+          x: candidate.xScale.map(point.domainX),
+          y: candidate.yScale.map(point.domainY)
+        });
+        return Object.freeze({
+          anchorLocal,
+          anchorRoot: geometry.rootAtLocal(anchorLocal)
+        });
+      }
+    });
+    return Object.freeze({
+      observations,
+      marks: Object.freeze(candidate.marks.slice()),
+      numeric,
+      assertLive: geometry.assertLive,
+      localAtRoot: geometry.localAtRoot,
+      anchorInsideClips: geometry.anchorInsideClips,
+      timeAtRoot: numeric.domainXAtRoot
+    });
+  });
+}
+function nearestRecordedVolumeX(rendered, options) {
+  const hit = nearestRecordedX(rendered.numeric, {
+    domainX: options.time,
+    filter: options.filter ? (candidate) => options.filter(
+      candidate
+    ) : void 0
+  });
+  if (!hit) return void 0;
+  const row = rendered.observations.find(
+    (row2) => row2.sourceIndex === hit.sourceIndex
+  );
+  return Object.freeze({ ...row, timeDelta: hit.domainDelta });
+}
+function paintedVolumeAt(rendered, options) {
+  rendered.assertLive();
+  if (!Number.isFinite(options.rootPoint.x) || !Number.isFinite(options.rootPoint.y))
+    throw new RangeError("paintedVolumeAt rootPoint must be finite.");
+  const p = rendered.localAtRoot(options.rootPoint);
+  if (!p || !rendered.anchorInsideClips(p)) return void 0;
+  for (let i = rendered.marks.length - 1; i >= 0; i--) {
+    const mark = rendered.marks[i], b = mark.boundsLocal, h = mark.strokeWidthLocal / 2;
+    if (b.height === 0) continue;
+    const inside = p.x >= b.x && p.x <= b.x + b.width && p.y >= b.y && p.y <= b.y + b.height;
+    const outline = h > 0 && p.x >= b.x - h && p.x <= b.x + b.width + h && p.y >= b.y - h && p.y <= b.y + b.height + h && !(p.x > b.x + h && p.x < b.x + b.width - h && p.y > b.y + h && p.y < b.y + b.height - h);
+    if (mark.fill && inside || outline) return rendered.observations[i];
+  }
+  return void 0;
+}
+export {
+  nearestRecordedVolumeX,
+  paintedVolumeAt,
+  useVolumeInspection
+};
+//# sourceMappingURL=volume.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/inspection/volume.ts"],
+  "sourcesContent": ["import {\n  invertNumericPosition,\n  type NumericPositionScale,\n} from \"../lib/series-position.js\";\nimport type { LayoutBox } from \"@pibbl/core\";\nimport type { VolumeSeriesProps } from \"../lib/volume-series.js\";\nimport type { ResolvedContinuousScale } from \"../lib/types.js\";\nimport type {\n  RenderedSeriesPoint,\n  NumericRenderedSeries,\n} from \"./query-types.js\";\nimport { useRenderedRef } from \"./owned-ref.js\";\nimport { nearestRecordedX } from \"./queries.js\";\n\n/** One original volume record and the values/geometry evaluated during paint.\n * @see {@link useVolumeInspection}\n */\nexport interface VolumeObservation<D> {\n  /** Caller-owned original record. */ readonly datum: D;\n  /** Original index including skipped rows. */ readonly sourceIndex: number;\n  /** Evaluated UTC milliseconds. */ readonly time: number;\n  /** Evaluated nonnegative volume. */ readonly volume: number;\n  /** Zero-volume baseline. */ readonly baseline: 0;\n  /** Volume endpoint in series-local logical coordinates. */ readonly anchorLocal: Readonly<RenderedSeriesPoint>;\n  /** Volume endpoint in root-logical coordinates. */ readonly anchorRoot: Readonly<RenderedSeriesPoint>;\n  /** Column bounds in series-local logical coordinates. */ readonly boundsLocal: Readonly<LayoutBox>;\n}\n/** A nearest-time candidate with an explicit optional clip predicate.\n * @see {@link useVolumeInspection}\n */\nexport interface VolumeInspectionCandidate<D> extends VolumeObservation<D> {\n  /** @returns Whether the endpoint lies inside every committed clip. */ anchorInsideClips(): boolean;\n}\n/** A recorded volume selected by timestamp proximity.\n * @see {@link useVolumeInspection}\n */\nexport interface NearestVolumeHit<D> extends VolumeObservation<D> {\n  /** Absolute UTC-millisecond distance from the requested time. */ readonly timeDelta: number;\n}\n/** A recorded volume whose painted column covers the query point.\n * @see {@link useVolumeInspection}\n */\nexport interface PaintedVolumeHit<D> extends VolumeObservation<D> {}\n/** @internal Immutable local renderer capture, without queries or transformed allocation.\n * @see {@link useVolumeInspection}\n */\nexport interface CapturedVolumeMark<D> extends Omit<\n  VolumeObservation<D>,\n  \"anchorRoot\"\n> {\n  /** Whether the rectangle paints its interior. */ readonly fill: boolean;\n  /** Outline width when painted, zero otherwise. */ readonly strokeWidthLocal: number;\n}\n/** Borrowed committed volume values; expires after a new root generation or disposal.\n * @see {@link useVolumeInspection}\n */\nexport interface VolumeRenderedSeries<D> {\n  /** Original observations and evaluated values in source order. */ readonly observations: readonly VolumeObservation<D>[];\n  /** Throws when borrowed values are stale or disposed. */ assertLive(): void;\n  /** Inverts a root-logical point to UTC milliseconds.\n   * @param pointRoot - Root-logical Canvas position.\n   * @returns Timestamp or undefined for unavailable inversion.\n   */ timeAtRoot(pointRoot: Readonly<RenderedSeriesPoint>): number | undefined;\n  /** Tests a local point against the committed clip stack.\n   * @param pointLocal - Series-local position.\n   * @returns Whether every clip includes it.\n   */ anchorInsideClips(pointLocal: Readonly<RenderedSeriesPoint>): boolean;\n  /** @internal Committed paint flags. */ readonly marks: readonly CapturedVolumeMark<D>[];\n  /** @internal Shared numeric query view. */ readonly numeric: NumericRenderedSeries<D>;\n  /** @internal Converts root coordinates to local coordinates.\n   * @param point - Root-logical position.\n   * @returns Local position or undefined for a singular transform.\n   */ localAtRoot(\n    point: Readonly<RenderedSeriesPoint>,\n  ): Readonly<RenderedSeriesPoint> | undefined;\n}\n/** Mount-owned optional volume capture.\n * @see {@link useVolumeInspection}\n */\nexport interface VolumeInspectionRef<D> {\n  /** @returns Borrowed committed values, or undefined before paint/after disposal. */ rendered():\n    VolumeRenderedSeries<D> | undefined;\n  /** @internal Records local values without executing a query.\n   * @param input - Immutable local marks and committed time mapping.\n   */ capture(input: {\n    /** Captured local paint marks. */ marks: readonly CapturedVolumeMark<D>[];\n    /** Committed horizontal mapping. */ xScale: NumericPositionScale;\n    /** Committed volume mapping. */ yScale: ResolvedContinuousScale;\n  }): void;\n}\n/**\n * Creates a stable optional volume receiver without reading data or subscribing.\n * @param _inputs - Data/accessors used only for original datum inference.\n * @returns Ref to pass to exactly one VolumeSeries inspection prop.\n * @see {@link VolumeInspectionRef}\n */\nexport function useVolumeInspection<D>(\n  _inputs: Pick<VolumeSeriesProps<D>, \"data\" | \"time\" | \"volume\">,\n): VolumeInspectionRef<D> {\n  return useRenderedRef<\n    {\n      marks: readonly CapturedVolumeMark<D>[];\n      xScale: NumericPositionScale;\n      yScale: ResolvedContinuousScale;\n    },\n    VolumeRenderedSeries<D>\n  >(\"volumeInspection\", (candidate, geometry) => {\n    const observations = Object.freeze(\n      candidate.marks.map((mark) =>\n        Object.freeze({\n          datum: mark.datum,\n          sourceIndex: mark.sourceIndex,\n          time: mark.time,\n          volume: mark.volume,\n          baseline: mark.baseline,\n          anchorLocal: mark.anchorLocal,\n          anchorRoot: geometry.rootAtLocal(mark.anchorLocal),\n          boundsLocal: mark.boundsLocal,\n        }),\n      ),\n    );\n    const numeric: NumericRenderedSeries<D> = Object.freeze({\n      observations: Object.freeze(\n        observations.map((row) =>\n          Object.freeze({\n            ...row,\n            domainX: row.time,\n            domainY: row.volume,\n            run: 0,\n          }),\n        ),\n      ),\n      assertLive: geometry.assertLive,\n      domainXAtRoot(point: Readonly<RenderedSeriesPoint>) {\n        const local = geometry.localAtRoot(point);\n        return local\n          ? invertNumericPosition(candidate.xScale, local.x)\n          : undefined;\n      },\n      anchorInsideClips: geometry.anchorInsideClips,\n      anchorAtDomain(point: Readonly<{ domainX: number; domainY: number }>) {\n        geometry.assertLive();\n        const anchorLocal = Object.freeze({\n          x: candidate.xScale.map(point.domainX),\n          y: candidate.yScale.map(point.domainY),\n        });\n        return Object.freeze({\n          anchorLocal,\n          anchorRoot: geometry.rootAtLocal(anchorLocal),\n        });\n      },\n    });\n    return Object.freeze({\n      observations,\n      marks: Object.freeze(candidate.marks.slice()),\n      numeric,\n      assertLive: geometry.assertLive,\n      localAtRoot: geometry.localAtRoot,\n      anchorInsideClips: geometry.anchorInsideClips,\n      timeAtRoot: numeric.domainXAtRoot,\n    });\n  });\n}\n/**\n * Selects a recorded volume by timestamp; equal distances choose first source index.\n * @param rendered - Borrowed committed volume values.\n * @param options - UTC-millisecond request and optional pure candidate filter.\n * @returns Captured original volume and time delta, or undefined when no candidate survives.\n * @see {@link NearestVolumeHit}\n */\nexport function nearestRecordedVolumeX<D>(\n  rendered: VolumeRenderedSeries<D>,\n  options: {\n    time: number;\n    filter?: (observation: VolumeInspectionCandidate<D>) => boolean;\n  },\n): NearestVolumeHit<D> | undefined {\n  const hit = nearestRecordedX(rendered.numeric, {\n    domainX: options.time,\n    filter: options.filter\n      ? (candidate) =>\n          options.filter!(\n            candidate as typeof candidate & VolumeInspectionCandidate<D>,\n          )\n      : undefined,\n  });\n  if (!hit) return undefined;\n  const row = rendered.observations.find(\n    (row) => row.sourceIndex === hit.sourceIndex,\n  )!;\n  return Object.freeze({ ...row, timeDelta: hit.domainDelta });\n}\n/**\n * Finds the last-painted volume column covering a root-logical point.\n * @param rendered - Borrowed committed volume values and paint geometry.\n * @param options - Root-logical point; respects clips, zero height and source paint order.\n * @returns Captured original volume, or undefined for gaps/singular transforms.\n * @see {@link PaintedVolumeHit}\n */\nexport function paintedVolumeAt<D>(\n  rendered: VolumeRenderedSeries<D>,\n  options: { rootPoint: Readonly<RenderedSeriesPoint> },\n): PaintedVolumeHit<D> | undefined {\n  rendered.assertLive();\n  if (\n    !Number.isFinite(options.rootPoint.x) ||\n    !Number.isFinite(options.rootPoint.y)\n  )\n    throw new RangeError(\"paintedVolumeAt rootPoint must be finite.\");\n  const p = rendered.localAtRoot(options.rootPoint);\n  if (!p || !rendered.anchorInsideClips(p)) return undefined;\n  for (let i = rendered.marks.length - 1; i >= 0; i--) {\n    const mark = rendered.marks[i],\n      b = mark.boundsLocal,\n      h = mark.strokeWidthLocal / 2;\n    if (b.height === 0) continue;\n    const inside =\n      p.x >= b.x && p.x <= b.x + b.width && p.y >= b.y && p.y <= b.y + b.height;\n    const outline =\n      h > 0 &&\n      p.x >= b.x - h &&\n      p.x <= b.x + b.width + h &&\n      p.y >= b.y - h &&\n      p.y <= b.y + b.height + h &&\n      !(\n        p.x > b.x + h &&\n        p.x < b.x + b.width - h &&\n        p.y > b.y + h &&\n        p.y < b.y + b.height - h\n      );\n    if ((mark.fill && inside) || outline) return rendered.observations[i];\n  }\n  return undefined;\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,OAEK;AAQP,SAAS,sBAAsB;AAC/B,SAAS,wBAAwB;AAoF1B,SAAS,oBACd,SACwB;AACxB,SAAO,eAOL,oBAAoB,CAAC,WAAW,aAAa;AAC7C,UAAM,eAAe,OAAO;AAAA,MAC1B,UAAU,MAAM;AAAA,QAAI,CAAC,SACnB,OAAO,OAAO;AAAA,UACZ,OAAO,KAAK;AAAA,UACZ,aAAa,KAAK;AAAA,UAClB,MAAM,KAAK;AAAA,UACX,QAAQ,KAAK;AAAA,UACb,UAAU,KAAK;AAAA,UACf,aAAa,KAAK;AAAA,UAClB,YAAY,SAAS,YAAY,KAAK,WAAW;AAAA,UACjD,aAAa,KAAK;AAAA,QACpB,CAAC;AAAA,MACH;AAAA,IACF;AACA,UAAM,UAAoC,OAAO,OAAO;AAAA,MACtD,cAAc,OAAO;AAAA,QACnB,aAAa;AAAA,UAAI,CAAC,QAChB,OAAO,OAAO;AAAA,YACZ,GAAG;AAAA,YACH,SAAS,IAAI;AAAA,YACb,SAAS,IAAI;AAAA,YACb,KAAK;AAAA,UACP,CAAC;AAAA,QACH;AAAA,MACF;AAAA,MACA,YAAY,SAAS;AAAA,MACrB,cAAc,OAAsC;AAClD,cAAM,QAAQ,SAAS,YAAY,KAAK;AACxC,eAAO,QACH,sBAAsB,UAAU,QAAQ,MAAM,CAAC,IAC/C;AAAA,MACN;AAAA,MACA,mBAAmB,SAAS;AAAA,MAC5B,eAAe,OAAuD;AACpE,iBAAS,WAAW;AACpB,cAAM,cAAc,OAAO,OAAO;AAAA,UAChC,GAAG,UAAU,OAAO,IAAI,MAAM,OAAO;AAAA,UACrC,GAAG,UAAU,OAAO,IAAI,MAAM,OAAO;AAAA,QACvC,CAAC;AACD,eAAO,OAAO,OAAO;AAAA,UACnB;AAAA,UACA,YAAY,SAAS,YAAY,WAAW;AAAA,QAC9C,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AACD,WAAO,OAAO,OAAO;AAAA,MACnB;AAAA,MACA,OAAO,OAAO,OAAO,UAAU,MAAM,MAAM,CAAC;AAAA,MAC5C;AAAA,MACA,YAAY,SAAS;AAAA,MACrB,aAAa,SAAS;AAAA,MACtB,mBAAmB,SAAS;AAAA,MAC5B,YAAY,QAAQ;AAAA,IACtB,CAAC;AAAA,EACH,CAAC;AACH;AAQO,SAAS,uBACd,UACA,SAIiC;AACjC,QAAM,MAAM,iBAAiB,SAAS,SAAS;AAAA,IAC7C,SAAS,QAAQ;AAAA,IACjB,QAAQ,QAAQ,SACZ,CAAC,cACC,QAAQ;AAAA,MACN;AAAA,IACF,IACF;AAAA,EACN,CAAC;AACD,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,MAAM,SAAS,aAAa;AAAA,IAChC,CAACA,SAAQA,KAAI,gBAAgB,IAAI;AAAA,EACnC;AACA,SAAO,OAAO,OAAO,EAAE,GAAG,KAAK,WAAW,IAAI,YAAY,CAAC;AAC7D;AAQO,SAAS,gBACd,UACA,SACiC;AACjC,WAAS,WAAW;AACpB,MACE,CAAC,OAAO,SAAS,QAAQ,UAAU,CAAC,KACpC,CAAC,OAAO,SAAS,QAAQ,UAAU,CAAC;AAEpC,UAAM,IAAI,WAAW,2CAA2C;AAClE,QAAM,IAAI,SAAS,YAAY,QAAQ,SAAS;AAChD,MAAI,CAAC,KAAK,CAAC,SAAS,kBAAkB,CAAC,EAAG,QAAO;AACjD,WAAS,IAAI,SAAS,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK;AACnD,UAAM,OAAO,SAAS,MAAM,CAAC,GAC3B,IAAI,KAAK,aACT,IAAI,KAAK,mBAAmB;AAC9B,QAAI,EAAE,WAAW,EAAG;AACpB,UAAM,SACJ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;AACrE,UAAM,UACJ,IAAI,KACJ,EAAE,KAAK,EAAE,IAAI,KACb,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,KACvB,EAAE,KAAK,EAAE,IAAI,KACb,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KACxB,EACE,EAAE,IAAI,EAAE,IAAI,KACZ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,KACtB,EAAE,IAAI,EAAE,IAAI,KACZ,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS;AAE3B,QAAK,KAAK,QAAQ,UAAW,QAAS,QAAO,SAAS,aAAa,CAAC;AAAA,EACtE;AACA,SAAO;AACT;",
+  "names": ["row"]
+}

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-title.js

@@ -7,7 +7,8 @@ function AxisTitle(props) {
   const source = lookupScale(props.scale, "AxisTitle");
   if (!source) throw new TypeError("AxisTitle requires a scale ID.");
   const scale = source.get(), label = resolveSignalValue(props.label), unit = resolveSignalValue(props.unit) ?? "";
-  if ([label, unit].some((value) => typeof value !== "string" || /[\r\n]/.test(value))) throw new TypeError("AxisTitle label and unit must be single-line strings.");
+  if (typeof label !== "string" || /[\r\n]/.test(label) || typeof unit !== "string" || /[\r\n]/.test(unit))
+    throw new TypeError("AxisTitle label and unit must be single-line strings.");
   const offset = resolveSignalValue(props.offset) ?? 40;
   if (typeof offset !== "number" || !Number.isFinite(offset) || offset < 0) throw new RangeError("AxisTitle offset must be finite and nonnegative.");
   const horizontal = props.position === "top" || props.position === "bottom";

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/viz/lib/axis-title.tsx"],
-  "sourcesContent": ["import { Group, Text, resolveSignalValue, type SignalValue } from \"@pibbl/core\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { AxisProps, AxisStyle, ScaleId } from \"./types.js\";\nimport { lookupScale } from \"./scale-context.js\";\nimport { opacity } from \"./paint.js\";\n/** Scale-aligned axis text; callers reserve the margin outside the plot. See {@link AxisTitle}. */\nexport interface AxisTitleProps {\n  /** Ancestor scale whose range supplies the title midpoint. */\n  readonly scale: ScaleId;\n  /** Plot edge; left/right titles rotate along the axis. */\n  readonly position: AxisProps[\"position\"];\n  /** Single-line title. */\n  readonly label: SignalValue<string>;\n  /** Optional unit appended in parentheses; empty string omits it. */\n  readonly unit?: SignalValue<string>;\n  /** Nonnegative finite distance outside the plot edge, default 40 pixels. */\n  readonly offset?: SignalValue<number>;\n  /** Font defaults to 12px sans-serif, fill to #617783, opacity to 1. */\n  readonly style?: SignalValue<SignalStyle<Pick<AxisStyle, \"font\" | \"fill\" | \"opacity\">>>;\n}\n/** Paint an axis title with optional units, without allocating margins or changing ticks.\n * @param props - Scale geometry and presentation. See {@link AxisTitleProps}.\n * @returns Decorative chart content in the caller's coordinate space.\n */\nexport function AxisTitle(props: AxisTitleProps) {\n  if (![\"top\", \"bottom\", \"left\", \"right\"].includes(props.position)) throw new TypeError(\"AxisTitle position must be top, bottom, left, or right.\");\n  const source = lookupScale(props.scale, \"AxisTitle\");\n  if (!source) throw new TypeError(\"AxisTitle requires a scale ID.\");\n  const scale = source.get(), label = resolveSignalValue(props.label), unit = resolveSignalValue(props.unit) ?? \"\";\n  if ([label, unit].some(value => typeof value !== \"string\" || /[\\r\\n]/.test(value))) throw new TypeError(\"AxisTitle label and unit must be single-line strings.\");\n  const offset = resolveSignalValue(props.offset) ?? 40;\n  if (typeof offset !== \"number\" || !Number.isFinite(offset) || offset < 0) throw new RangeError(\"AxisTitle offset must be finite and nonnegative.\");\n  const horizontal = props.position === \"top\" || props.position === \"bottom\";\n  const midpoint = scale.range[0] / 2 + scale.range[1] / 2;\n  const x = horizontal ? midpoint : props.position === \"left\" ? -offset : scale.frame.width + offset;\n  const y = horizontal ? props.position === \"top\" ? -offset : scale.frame.height + offset : midpoint;\n  const style = resolveSignalValue(props.style) ?? {};\n  return <Group style={{ translateX: x, translateY: y }}><Group style={{ rotationDegrees: horizontal ? 0 : props.position === \"left\" ? -90 : 90 }}>\n    <Text pointerEvents=\"none\" style={{ textAlign: \"center\", textBaseline: \"middle\", font: resolveSignalValue(style.font) ?? \"12px sans-serif\", fill: resolveSignalValue(style.fill) ?? \"#617783\", opacity: opacity(resolveSignalValue(style.opacity) ?? 1, \"AxisTitle\") }}>{unit ? `${label} (${unit})` : label}</Text>\n  </Group></Group>;\n}\n"],
-  "mappings": "AAsCI;AAtCJ,SAAS,OAAO,MAAM,0BAA4C;AAGlE,SAAS,mBAAmB;AAC5B,SAAS,eAAe;AAoBjB,SAAS,UAAU,OAAuB;AAC/C,MAAI,CAAC,CAAC,OAAO,UAAU,QAAQ,OAAO,EAAE,SAAS,MAAM,QAAQ,EAAG,OAAM,IAAI,UAAU,yDAAyD;AAC/I,QAAM,SAAS,YAAY,MAAM,OAAO,WAAW;AACnD,MAAI,CAAC,OAAQ,OAAM,IAAI,UAAU,gCAAgC;AACjE,QAAM,QAAQ,OAAO,IAAI,GAAG,QAAQ,mBAAmB,MAAM,KAAK,GAAG,OAAO,mBAAmB,MAAM,IAAI,KAAK;AAC9G,MAAI,CAAC,OAAO,IAAI,EAAE,KAAK,WAAS,OAAO,UAAU,YAAY,SAAS,KAAK,KAAK,CAAC,EAAG,OAAM,IAAI,UAAU,uDAAuD;AAC/J,QAAM,SAAS,mBAAmB,MAAM,MAAM,KAAK;AACnD,MAAI,OAAO,WAAW,YAAY,CAAC,OAAO,SAAS,MAAM,KAAK,SAAS,EAAG,OAAM,IAAI,WAAW,kDAAkD;AACjJ,QAAM,aAAa,MAAM,aAAa,SAAS,MAAM,aAAa;AAClE,QAAM,WAAW,MAAM,MAAM,CAAC,IAAI,IAAI,MAAM,MAAM,CAAC,IAAI;AACvD,QAAM,IAAI,aAAa,WAAW,MAAM,aAAa,SAAS,CAAC,SAAS,MAAM,MAAM,QAAQ;AAC5F,QAAM,IAAI,aAAa,MAAM,aAAa,QAAQ,CAAC,SAAS,MAAM,MAAM,SAAS,SAAS;AAC1F,QAAM,QAAQ,mBAAmB,MAAM,KAAK,KAAK,CAAC;AAClD,SAAO,oBAAC,SAAM,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,GAAG,8BAAC,SAAM,OAAO,EAAE,iBAAiB,aAAa,IAAI,MAAM,aAAa,SAAS,MAAM,GAAG,GAC5I,8BAAC,QAAK,eAAc,QAAO,OAAO,EAAE,WAAW,UAAU,cAAc,UAAU,MAAM,mBAAmB,MAAM,IAAI,KAAK,mBAAmB,MAAM,mBAAmB,MAAM,IAAI,KAAK,WAAW,SAAS,QAAQ,mBAAmB,MAAM,OAAO,KAAK,GAAG,WAAW,EAAE,GAAI,iBAAO,GAAG,KAAK,KAAK,IAAI,MAAM,OAAM,GAC/S,GAAQ;AACV;",
+  "sourcesContent": ["import { Group, Text, resolveSignalValue, type SignalValue } from \"@pibbl/core\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { AxisProps, AxisStyle, ScaleId } from \"./types.js\";\nimport { lookupScale } from \"./scale-context.js\";\nimport { opacity } from \"./paint.js\";\n/** Scale-aligned axis text; callers reserve the margin outside the plot. See {@link AxisTitle}. */\nexport interface AxisTitleProps {\n  /** Ancestor scale whose range supplies the title midpoint. */\n  readonly scale: ScaleId;\n  /** Plot edge; left/right titles rotate along the axis. */\n  readonly position: AxisProps[\"position\"];\n  /** Single-line title. */\n  readonly label: SignalValue<string>;\n  /** Optional unit appended in parentheses; empty string omits it. */\n  readonly unit?: SignalValue<string>;\n  /** Nonnegative finite distance outside the plot edge, default 40 pixels. */\n  readonly offset?: SignalValue<number>;\n  /** Font defaults to 12px sans-serif, fill to #617783, opacity to 1. */\n  readonly style?: SignalValue<SignalStyle<Pick<AxisStyle, \"font\" | \"fill\" | \"opacity\">>>;\n}\n/** Paint an axis title with optional units, without allocating margins or changing ticks.\n * @param props - Scale geometry and presentation. See {@link AxisTitleProps}.\n * @returns Decorative chart content in the caller's coordinate space.\n */\nexport function AxisTitle(props: AxisTitleProps) {\n  if (![\"top\", \"bottom\", \"left\", \"right\"].includes(props.position)) throw new TypeError(\"AxisTitle position must be top, bottom, left, or right.\");\n  const source = lookupScale(props.scale, \"AxisTitle\");\n  if (!source) throw new TypeError(\"AxisTitle requires a scale ID.\");\n  const scale = source.get(), label = resolveSignalValue(props.label), unit = resolveSignalValue(props.unit) ?? \"\";\n  if (\n    typeof label !== \"string\" ||\n    /[\\r\\n]/.test(label) ||\n    typeof unit !== \"string\" ||\n    /[\\r\\n]/.test(unit)\n  )\n    throw new TypeError(\"AxisTitle label and unit must be single-line strings.\");\n  const offset = resolveSignalValue(props.offset) ?? 40;\n  if (typeof offset !== \"number\" || !Number.isFinite(offset) || offset < 0) throw new RangeError(\"AxisTitle offset must be finite and nonnegative.\");\n  const horizontal = props.position === \"top\" || props.position === \"bottom\";\n  const midpoint = scale.range[0] / 2 + scale.range[1] / 2;\n  const x = horizontal ? midpoint : props.position === \"left\" ? -offset : scale.frame.width + offset;\n  const y = horizontal ? props.position === \"top\" ? -offset : scale.frame.height + offset : midpoint;\n  const style = resolveSignalValue(props.style) ?? {};\n  return (\n    <Group style={{ translateX: x, translateY: y }}>\n      <Group style={{ rotationDegrees: horizontal ? 0 : props.position === \"left\" ? -90 : 90 }}>\n        <Text pointerEvents=\"none\" style={{ textAlign: \"center\", textBaseline: \"middle\", font: resolveSignalValue(style.font) ?? \"12px sans-serif\", fill: resolveSignalValue(style.fill) ?? \"#617783\", opacity: opacity(resolveSignalValue(style.opacity) ?? 1, \"AxisTitle\") }}>\n          {unit ? `${label} (${unit})` : label}\n        </Text>\n      </Group>\n    </Group>\n  );\n}\n"],
+  "mappings": "AA8CQ;AA9CR,SAAS,OAAO,MAAM,0BAA4C;AAGlE,SAAS,mBAAmB;AAC5B,SAAS,eAAe;AAoBjB,SAAS,UAAU,OAAuB;AAC/C,MAAI,CAAC,CAAC,OAAO,UAAU,QAAQ,OAAO,EAAE,SAAS,MAAM,QAAQ,EAAG,OAAM,IAAI,UAAU,yDAAyD;AAC/I,QAAM,SAAS,YAAY,MAAM,OAAO,WAAW;AACnD,MAAI,CAAC,OAAQ,OAAM,IAAI,UAAU,gCAAgC;AACjE,QAAM,QAAQ,OAAO,IAAI,GAAG,QAAQ,mBAAmB,MAAM,KAAK,GAAG,OAAO,mBAAmB,MAAM,IAAI,KAAK;AAC9G,MACE,OAAO,UAAU,YACjB,SAAS,KAAK,KAAK,KACnB,OAAO,SAAS,YAChB,SAAS,KAAK,IAAI;AAElB,UAAM,IAAI,UAAU,uDAAuD;AAC7E,QAAM,SAAS,mBAAmB,MAAM,MAAM,KAAK;AACnD,MAAI,OAAO,WAAW,YAAY,CAAC,OAAO,SAAS,MAAM,KAAK,SAAS,EAAG,OAAM,IAAI,WAAW,kDAAkD;AACjJ,QAAM,aAAa,MAAM,aAAa,SAAS,MAAM,aAAa;AAClE,QAAM,WAAW,MAAM,MAAM,CAAC,IAAI,IAAI,MAAM,MAAM,CAAC,IAAI;AACvD,QAAM,IAAI,aAAa,WAAW,MAAM,aAAa,SAAS,CAAC,SAAS,MAAM,MAAM,QAAQ;AAC5F,QAAM,IAAI,aAAa,MAAM,aAAa,QAAQ,CAAC,SAAS,MAAM,MAAM,SAAS,SAAS;AAC1F,QAAM,QAAQ,mBAAmB,MAAM,KAAK,KAAK,CAAC;AAClD,SACE,oBAAC,SAAM,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,GAC3C,8BAAC,SAAM,OAAO,EAAE,iBAAiB,aAAa,IAAI,MAAM,aAAa,SAAS,MAAM,GAAG,GACrF,8BAAC,QAAK,eAAc,QAAO,OAAO,EAAE,WAAW,UAAU,cAAc,UAAU,MAAM,mBAAmB,MAAM,IAAI,KAAK,mBAAmB,MAAM,mBAAmB,MAAM,IAAI,KAAK,WAAW,SAAS,QAAQ,mBAAmB,MAAM,OAAO,KAAK,GAAG,WAAW,EAAE,GAClQ,iBAAO,GAAG,KAAK,KAAK,IAAI,MAAM,OACjC,GACF,GACF;AAEJ;",
   "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": "AAqGM;AArGN,SAAS,MAAM,MAAM,oBAAoB,wBAAwB;AAEjE,SAAS,mBAAmB;AAC5B,SAAS,OAAO,eAAe;AAE/B,SAAS,oBAAoB;AAE7B,SAAS,OAAO,gBAAgB;AAUzB,SAAS,KAAK,OAAkB;AACrC,MACE,MAAM,aAAa,YACnB,MAAM,aAAa,UACnB,MAAM,aAAa,SACnB,MAAM,aAAa;AAEnB,UAAM,IAAI,UAAU,oDAAoD;AAC1E,QAAM,SAAS,YAAY,MAAM,OAAO,MAAM;AAC9C,MAAI,CAAC,OAAQ,OAAM,IAAI,UAAU,2BAA2B;AAC5D,QAAM,QAAQ,OAAO,IAAI;AACzB,QAAM,QAAQ,mBAAmB,MAAM,KAAK,KAAK,CAAC;AAClD,QAAM,SAAS,mBAAmB,MAAM,MAAM,KAAK;AACnD,QAAM,cAAc,MAAM,mBAAmB,MAAM,WAAW,KAAK,GAAG,MAAM;AAC5E,QAAM,OAAO,mBAAmB,MAAM,IAAI,KAAK;AAC/C,QAAM,OAAO,mBAAmB,MAAM,IAAI,KAAK;AAC/C,QAAM,QAAQ,QAAQ,mBAAmB,MAAM,OAAO,KAAK,GAAG,MAAM;AACpE,QAAM,aAAa,MAAM,aAAa,YAAY,MAAM,aAAa;AACrE,QAAM,UAAU,MAAM,aAAa,YAAY,MAAM,aAAa,UAAU,IAAI;AAChF,QAAM,WAAW,aACb,MAAM,aAAa,WAAW,MAAM,MAAM,SAAS,IACnD,MAAM,aAAa,UAAU,MAAM,MAAM,QAAQ;AACrD,QAAM,WAAW,MAAM,OAAO,KAAK;AACnC,QAAM,UAAU,iBAAiB;AACjC,QAAM,UAAU,mBAAmB,MAAM,gBAAgB,OAAO;AAChE,QAAM,MAAM,mBAAmB,MAAM,YAAY,CAAC;AAClD,MAAI,YAAY,WAAW,YAAY,OAAQ,OAAM,IAAI,UAAU,0CAA0C;AAC7G,MAAI,CAAC,OAAO,SAAS,GAAG,KAAK,MAAM,EAAG,OAAM,IAAI,WAAW,+CAA+C;AAC1G,QAAM,WAAW,mBAAmB,MAAM,iBAAiB,OAAO;AAClE,QAAM,WAAW,MAAM,kBAAkB,SAAY,SAAY,mBAAmB,MAAM,aAAa;AACvG,QAAM,WAAW,mBAAmB,MAAM,iBAAiB,CAAC;AAC5D,QAAM,kBAAkB,MAAM,oBAAoB,SAAY,SAAY,mBAAmB,MAAM,eAAe;AAClH,MAAI,CAAC,CAAC,SAAS,QAAQ,UAAU,EAAE,SAAS,QAAQ,EAAG,OAAM,IAAI,UAAU,sDAAsD;AACjI,MAAK,aAAa,WAAW,aAAa,UAAe,aAAa,WAAc,CAAC,OAAO,SAAS,QAAQ,KAAK,YAAY,GAAK,OAAM,IAAI,WAAW,mEAAmE;AAC3N,MAAI,CAAC,OAAO,UAAU,QAAQ,KAAK,WAAW,KAAK,WAAW,GAAI,OAAM,IAAI,WAAW,qDAAqD;AAC5I,MAAI,oBAAoB,WAAc,CAAC,OAAO,SAAS,eAAe,KAAK,mBAAmB,GAAI,OAAM,IAAI,WAAW,mDAAmD;AAC1K,MAAI,aAAa;AACjB,QAAM,QAA+B,CAAC;AACtC,QAAM,WAA6C,CAAC;AACpD,QAAM,UAAU,oBAAI,IAAY;AAChC,QAAM,QAAQ,SAAS,IAAI,CAAC,OAAO,UAAU;AAC3C,UAAM,QAAQ,MAAM,aAAa,MAAM,WAAW,OAAO,KAAK,IACzD,MAAM,SAAS,SAAS,MAAM,SAAS,iBAAkB,MAAM,WAAW,KAAe,IAC1F,OAAO,UAAU,WAAW,OAAO,OAAO,MAAM,YAAY,CAAC,CAAC,CAAC,IAAI;AACvE,QAAI,OAAO,UAAU,SAAU,OAAM,IAAI,UAAU,uCAAuC;AAC1F,WAAO;AAAA,EACT,CAAC;AAED,QAAM,QAAQ,SAAS,IAAI,CAAC,OAAO,WAAW,EAAE,OAAO,GAAG,SAAS,OAAO,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;AAC7G,QAAM,WAAW,MAAM,SAAS,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,MAAM,SAAS,CAAC,GAAG,GAAG,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI;AACjG,UAAQ,KAAK;AACb,MAAI;AACF,YAAQ,OAAO;AACf,UAAM,cAAc,QAAQ,YAAY,IAAI;AAC5C,iBAAa,mBAAmB,KAAK,KAAK,YAAY,0BAA0B,YAAY,2BAA2B,CAAC;AACxH,eAAW,QAAQ,MAAO,OAAM,KAAK,aAAa,SAAS,MAAM,YAAY,UAAU,UAAU,QAAQ,CAAC;AAC1G,eAAW,EAAE,OAAO,EAAE,KAAK,UAAU;AACnC,YAAM,UAAU,MAAM,KAAK,EAAE,IAAI,UAAQ,QAAQ,YAAY,IAAI,CAAC;AAClE,YAAM,OAAO,aAAa,KAAK,IAAI,GAAG,QAAQ,IAAI,OAAK,EAAE,KAAK,CAAC,KAAK,MAAM,KAAK,EAAE,SAAS,KAAK,aAAa,KAAK,IAAI,GAAG,QAAQ,IAAI,OAAK,EAAE,0BAA0B,EAAE,wBAAwB,CAAC;AAChM,YAAM,WAAW,EAAE,OAAO,IAAI,OAAO,GAAG,KAAK,IAAI,OAAO,EAAE;AAC1D,UAAI,YAAY,WAAW,SAAS,MAAM,WAAS,SAAS,MAAM,OAAO,MAAM,SAAS,SAAS,SAAS,MAAM,MAAM,GAAG,GAAG;AAC1H,gBAAQ,IAAI,KAAK;AAAG,iBAAS,KAAK,QAAQ;AAAA,MAC5C;AAAA,IACF;AAAA,EACF,UAAE;AAAU,YAAQ,QAAQ;AAAA,EAAG;AAC/B,QAAM,OAAO,IAAI,OAAO;AACxB,MAAI,YAAY;AACd,SAAK,OAAO,MAAM,MAAM,CAAC,GAAG,QAAQ;AACpC,SAAK,OAAO,MAAM,MAAM,CAAC,GAAG,QAAQ;AAAA,EACtC,OAAO;AACL,SAAK,OAAO,UAAU,MAAM,MAAM,CAAC,CAAC;AACpC,SAAK,OAAO,UAAU,MAAM,MAAM,CAAC,CAAC;AAAA,EACtC;AACA,QAAM,SAAS,SAAS,IAAI,CAAC,OAAO,UAAU;AAC5C,UAAM,IAAI,SAAS,OAAO,KAAK;AAC/B,QAAI,YAAY;AACd,WAAK,OAAO,GAAG,QAAQ;AACvB,WAAK,OAAO,GAAG,WAAW,UAAU,CAAC;AAAA,IACvC,OAAO;AACL,WAAK,OAAO,UAAU,CAAC;AACvB,WAAK,OAAO,WAAW,UAAU,GAAG,CAAC;AAAA,IACvC;AACA,QAAI,CAAC,QAAQ,IAAI,KAAK,EAAG,QAAO;AAChC,WAAO,MAAM,KAAK,EAAE,IAAI,CAAC,OAAO,cAC9B;AAAA,MAAC;AAAA;AAAA,QAEC,eAAc;AAAA,QACd,OAAO;AAAA,UACL,MAAM,aAAa,IAAI,WAAW,UAAU;AAAA,UAC5C,KAAK,aAAa,WAAW,UAAU,MAAM,UAAU,IAAI,YAAY,YAAY,MAAM,KAAK,EAAE,SAAS,KAAK,aAAa,KAAK,aAAa,MAAM,KAAK,EAAE,SAAS,KAAK,KAAK;AAAA,UAC7K;AAAA,UACA;AAAA,UACA,SAAS;AAAA,UACT,WAAW,aAAa,WAAW,UAAU,IAAI,UAAU;AAAA,UAC3D,cAAc,aAAa,UAAU,IAAI,QAAQ,WAAW;AAAA,QAC9D;AAAA,QAEC;AAAA;AAAA,MAZI,GAAG,KAAK,IAAI,SAAS;AAAA,IAa5B,CACD;AAAA,EACH,CAAC;AACD,SAAO;AAAA,IACL;AAAA,MAAC;AAAA;AAAA,QAEC,eAAc;AAAA,QACd,OAAO,EAAE,GAAG,MAAM,QAAQ,aAAa,SAAS,MAAM;AAAA;AAAA,MAFlD;AAAA,IAGN;AAAA,IACA;AAAA,EACF;AACF;",
   "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 {