@pibbl/core 0.0.1 → 0.0.3-alpha.109.1

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 } from \"@pibbl/core\";\nimport type { AxisProps, BandCategory, ResolvedScale } from \"./types.js\";\nimport { lookupScale } from \"./scale-context.js\";\nimport { width, opacity } from \"./paint.js\";\n\ntype Tick = number | string;\n\nfunction ticks(scale: ResolvedScale, props: AxisProps): readonly Tick[] {\n  if (props.tickValues !== undefined && props.tickCount !== undefined)\n    throw new TypeError(\"Axis tickValues and tickCount are mutually exclusive.\");\n  const explicit = props.tickValues === undefined\n    ? undefined\n    : resolveSignalValue(props.tickValues);\n  if (explicit !== undefined) {\n    if (!Array.isArray(explicit) || explicit.length > 100)\n      throw new RangeError(\"Axis tickValues must be an array with at most 100 values.\");\n    const seen = new Set<Tick>();\n    for (const value of explicit) {\n      if (seen.has(value)) throw new RangeError(\"Axis tickValues must not contain duplicates.\");\n      seen.add(value);\n      if (scale.type === \"linear\") {\n        if (typeof value !== \"number\" || !Number.isFinite(value))\n          throw new TypeError(\"Axis tickValues for a linear scale must be finite numbers.\");\n        const [a, b] = scale.domain;\n        if (value < Math.min(a, b) || value > Math.max(a, b))\n          throw new RangeError(\"Axis tickValues must be within the scale domain.\");\n      } else if (\n        (typeof value !== \"string\" &&\n          (typeof value !== \"number\" || !Number.isFinite(value))) ||\n        scale.map(value as BandCategory) === undefined\n      ) {\n        throw new RangeError(\"Axis tickValues must be known band categories.\");\n      }\n    }\n    return explicit;\n  }\n  const count = resolveSignalValue(props.tickCount ?? 5);\n  if (!Number.isInteger(count) || count < 0 || count > 100)\n    throw new RangeError(\"Axis tickCount must be an integer from 0 to 100.\");\n  if (count === 0) return [];\n  if (scale.type === \"linear\")\n    return count === 1 ? [scale.domain[0]] : scale.ticks(count);\n  const n = scale.domain.length;\n  if (n === 0) return [];\n  if (count === 1) return [scale.domain[0]];\n  const m = Math.min(count, n);\n  if (m === 1) return [scale.domain[0]];\n  return Array.from(\n    { length: m },\n    (_, index) => scale.domain[Math.round((index * (n - 1)) / (m - 1))]!,\n  );\n}\n\nfunction position(scale: ResolvedScale, value: Tick): number {\n  return scale.type === \"band\"\n    ? scale.map(value as BandCategory)! + scale.bandwidth / 2\n    : scale.map(value as number);\n}\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 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    const label = props.tickFormat\n      ? props.tickFormat(value, index)\n      : typeof value === \"number\"\n        ? String(Number(value.toPrecision(6)))\n        : value;\n    if (typeof label !== \"string\")\n      throw new TypeError(\"Axis tickFormat must return a string.\");\n    return (\n      <Text\n        key={index}\n        pointerEvents=\"none\"\n        style={{\n          left: horizontal ? p : baseline + outward * 10,\n          top: horizontal ? baseline + outward * 10 : p,\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-scale.d.ts

@@ -0,0 +1,7 @@
+import type { BarScaleProps } from "./types.js";
+/**
+ * Provides categorical bands, including nested groups sized to a parent band.
+ * @param props - Categories, spacing, range, and children. See {@link BarScaleProps}.
+ * @returns Descendant content within the scale scope.
+ */
+export declare function BarScale(props: BarScaleProps): import("@pibbl/core").PibblNode;

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

@@ -0,0 +1,34 @@
+import { resolveSignalValue, useComputed, useLayoutBox } from "@pibbl/core";
+import { resolveBandScale } from "./band-scale.js";
+import { captureScaleLookup } from "./scale-context.js";
+import { useScaleProvider } from "./scale-provider.js";
+function BarScale(props) {
+  const { width, height } = useLayoutBox();
+  const lookup = captureScaleLookup("BarScale bandwidthOf");
+  function resolveParent() {
+    const range = resolveSignalValue(props.range);
+    if (typeof range !== "object" || range === null || !("bandwidthOf" in range)) return void 0;
+    const parent2 = lookup(range.bandwidthOf)?.get();
+    if (!parent2 || parent2.type !== "band") throw new TypeError("BarScale bandwidthOf requires an ancestor band scale.");
+    return parent2;
+  }
+  const parent = useComputed(resolveParent, [props.range, lookup]).get();
+  useScaleProvider(props.id, "band", () => {
+    const currentParent = resolveParent();
+    const range = currentParent ? [0, currentParent.bandwidth] : resolveSignalValue(props.range);
+    return resolveBandScale(
+      resolveSignalValue(props.domain),
+      range,
+      resolveSignalValue(props.reverse ?? false),
+      width,
+      height,
+      resolveSignalValue(props.paddingInner ?? 0),
+      resolveSignalValue(props.paddingOuter ?? 0)
+    );
+  }, [parent, props.domain, props.range, props.reverse, props.paddingInner, props.paddingOuter, width, height]);
+  return props.children;
+}
+export {
+  BarScale
+};
+//# sourceMappingURL=bar-scale.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/bar-scale.ts"],
+  "sourcesContent": ["import { resolveSignalValue, useComputed, useLayoutBox } from \"@pibbl/core\";\nimport type { BarScaleProps, ScaleRange } from \"./types.js\";\nimport { resolveBandScale } from \"./band-scale.js\";\nimport { captureScaleLookup } from \"./scale-context.js\";\nimport { useScaleProvider } from \"./scale-provider.js\";\n/**\n * Provides categorical bands, including nested groups sized to a parent band.\n * @param props - Categories, spacing, range, and children. See {@link BarScaleProps}.\n * @returns Descendant content within the scale scope.\n */\nexport function BarScale(props: BarScaleProps) {\n  const { width, height } = useLayoutBox();\n  const lookup = captureScaleLookup(\"BarScale bandwidthOf\");\n  function resolveParent() {\n    const range = resolveSignalValue(props.range);\n    if (typeof range !== \"object\" || range === null || !(\"bandwidthOf\" in range)) return undefined;\n    const parent = lookup(range.bandwidthOf)?.get();\n    if (!parent || parent.type !== \"band\") throw new TypeError(\"BarScale bandwidthOf requires an ancestor band scale.\");\n    return parent;\n  }\n  const parent = useComputed(resolveParent, [props.range, lookup]).get();\n  useScaleProvider(props.id, \"band\", () => {\n    const currentParent = resolveParent();\n    const range: ScaleRange = currentParent ? [0, currentParent.bandwidth] : resolveSignalValue(props.range) as ScaleRange;\n    return resolveBandScale(resolveSignalValue(props.domain), range,\n      resolveSignalValue(props.reverse ?? false), width, height,\n      resolveSignalValue(props.paddingInner ?? 0), resolveSignalValue(props.paddingOuter ?? 0));\n  }, [parent, props.domain, props.range, props.reverse, props.paddingInner, props.paddingOuter, width, height]);\n  return props.children;\n}\n"],
+  "mappings": "AAAA,SAAS,oBAAoB,aAAa,oBAAoB;AAE9D,SAAS,wBAAwB;AACjC,SAAS,0BAA0B;AACnC,SAAS,wBAAwB;AAM1B,SAAS,SAAS,OAAsB;AAC7C,QAAM,EAAE,OAAO,OAAO,IAAI,aAAa;AACvC,QAAM,SAAS,mBAAmB,sBAAsB;AACxD,WAAS,gBAAgB;AACvB,UAAM,QAAQ,mBAAmB,MAAM,KAAK;AAC5C,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,EAAE,iBAAiB,OAAQ,QAAO;AACrF,UAAMA,UAAS,OAAO,MAAM,WAAW,GAAG,IAAI;AAC9C,QAAI,CAACA,WAAUA,QAAO,SAAS,OAAQ,OAAM,IAAI,UAAU,uDAAuD;AAClH,WAAOA;AAAA,EACT;AACA,QAAM,SAAS,YAAY,eAAe,CAAC,MAAM,OAAO,MAAM,CAAC,EAAE,IAAI;AACrE,mBAAiB,MAAM,IAAI,QAAQ,MAAM;AACvC,UAAM,gBAAgB,cAAc;AACpC,UAAM,QAAoB,gBAAgB,CAAC,GAAG,cAAc,SAAS,IAAI,mBAAmB,MAAM,KAAK;AACvG,WAAO;AAAA,MAAiB,mBAAmB,MAAM,MAAM;AAAA,MAAG;AAAA,MACxD,mBAAmB,MAAM,WAAW,KAAK;AAAA,MAAG;AAAA,MAAO;AAAA,MACnD,mBAAmB,MAAM,gBAAgB,CAAC;AAAA,MAAG,mBAAmB,MAAM,gBAAgB,CAAC;AAAA,IAAC;AAAA,EAC5F,GAAG,CAAC,QAAQ,MAAM,QAAQ,MAAM,OAAO,MAAM,SAAS,MAAM,cAAc,MAAM,cAAc,OAAO,MAAM,CAAC;AAC5G,SAAO,MAAM;AACf;",
+  "names": ["parent"]
+}

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

@@ -8,7 +8,8 @@ import {
 } from "@pibbl/core";
 import { withHooksForbidden } from "@pibbl/core/internal";
 import { lookupScale } from "./scale-context.js";
-import { useScale } from "./use-scale.js";
+import { useContinuousScale } from "./use-continuous-scale.js";
+import { useBarScale } from "./use-bar-scale.js";
 import { pointAccessor, pointData, finiteCoordinate } from "./point-data.js";
 import { opacity, width } from "./paint.js";
 import { barFill } from "./bar-fill.js";
@@ -27,11 +28,12 @@ function BarSeries({
   defined,
   style: styleInput,
   pointerEvents,
+  inspection,
   ...events
 }) {
-  const categories = useScale(categoryScale, "band").get();
-  const values = useScale(valueScale).get();
-  const groups = lookupScale(groupScale, "BarSeries groupScale", "band")?.get();
+  const categories = useBarScale(categoryScale).get();
+  const values = useContinuousScale(valueScale).get();
+  const groups = lookupScale(groupScale, "BarSeries groupScale")?.get();
   if (group === void 0 !== (groupScale === void 0))
     throw new TypeError("BarSeries requires group and groupScale together.");
   if (groups && groups.type !== "band")
@@ -97,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;
@@ -123,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,
@@ -133,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,
@@ -144,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 { useScale } from \"./use-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 = useScale(categoryScale, \"band\").get();\n  const values = useScale(valueScale).get();\n  const groups = lookupScale(groupScale, \"BarSeries groupScale\", \"band\")?.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": "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",
+  "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;

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

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

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

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

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

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