@pibbl/core 0.0.2 → 0.0.3-alpha.109.1

package/dist/features/viz/lib/pie-layout.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/viz/lib/pie-layout.tsx"],
-  "sourcesContent": ["import {\n  Group,\n  Path,\n  Wedge,\n  definePrimitive,\n  Line,\n  Rectangle,\n  resolveSignalValue,\n  useComputed,\n  useCanvasContext,\n  useLayoutBox,\n} from \"@pibbl/core\";\nimport { resolveTexturePaint, withHooksForbidden } from \"@pibbl/core/internal\";\nimport type {\n  PieLayoutProps,\n  PieLayoutSlice,\n  PieSliceProps,\n  PieLabelProps,\n  PieLabelLayout,\n} from \"./pie-types.js\";\nimport { pieSlices } from \"./pie-slices.js\";\nimport { layoutPie } from \"./layout-pie.js\";\nfunction finite(value: number, name: string, nonnegative = false) {\n  if (!Number.isFinite(value) || (nonnegative && value < 0))\n    throw new RangeError(\n      `PieLayout: ${name} must be finite${nonnegative ? \" and nonnegative\" : \"\"}.`,\n    );\n  return value;\n}\n/**\n * Computes pie geometry and label placement, then renders children for each resolved slice.\n *\n * @param props - Data, pie geometry, label policy, and child renderer. See {@link PieLayoutProps}.\n * @returns Pibbl content arranged as pie slices.\n *\n * @see {@link PieLayoutProps}\n */\nexport function PieLayout<D>(props: PieLayoutProps<D>) {\n  const allocation = useLayoutBox();\n  const context = useCanvasContext();\n  const style = resolveSignalValue(props.style) ?? {};\n  const bounds = resolveSignalValue(props.bounds) ?? {\n    x: 0,\n    y: 0,\n    width: allocation.width,\n    height: allocation.height,\n  };\n  const bx = finite(bounds.x, \"bounds.x\"),\n    by = finite(bounds.y, \"bounds.y\");\n  const bw = finite(bounds.width, \"bounds.width\", true),\n    bh = finite(bounds.height, \"bounds.height\", true);\n  finite(bx + bw, \"bounds right\");\n  finite(by + bh, \"bounds bottom\");\n  const cx = finite(resolveSignalValue(style.cx) ?? bx + bw / 2, \"cx\");\n  const cy = finite(resolveSignalValue(style.cy) ?? by + bh / 2, \"cy\");\n  const radius = finite(\n    resolveSignalValue(style.radius) ?? Math.min(bw * 0.28, bh * 0.4),\n    \"radius\",\n    true,\n  );\n  const innerRadius = finite(\n    resolveSignalValue(style.innerRadius) ?? 0,\n    \"innerRadius\",\n    true,\n  );\n  if (radius === 0 ? innerRadius !== 0 : innerRadius >= radius)\n    throw new RangeError(\n      \"PieLayout: innerRadius must be zero when radius is zero, or less than radius.\",\n    );\n  const gap = finite(resolveSignalValue(style.labelGap) ?? 8, \"labelGap\", true);\n  finite(cx + radius + gap, \"right label edge\");\n  finite(cx - radius - gap, \"left label edge\");\n  finite(cy + radius, \"bottom\");\n  finite(cy - radius, \"top\");\n  const font = resolveSignalValue(style.labelFont) ?? \"14px sans-serif\";\n  if (typeof font !== \"string\" || !font.trim())\n    throw new TypeError(\"PieLayout: labelFont must be a Canvas font string.\");\n  const placement = resolveSignalValue(props.placement) ?? \"outside\";\n  if (![\"inside\", \"outside\", \"auto\"].includes(placement))\n    throw new TypeError(\n      \"PieLayout: placement must be inside, outside, or auto.\",\n    );\n  if (typeof props.children !== \"function\")\n    throw new TypeError(\n      \"PieLayout: children must be a function returning Pibbl elements.\",\n    );\n  const revision =\n    props.revision === undefined ? undefined : resolveSignalValue(props.revision);\n  if (\n    revision !== undefined &&\n    (!Number.isSafeInteger(revision) || revision < 0)\n  )\n    throw new RangeError(\n      \"PieLayout: revision must be a finite nonnegative safe integer.\",\n    );\n  // An omitted revision deliberately replaces this token on every evaluation.\n  // Stable callback identities alone are not evidence of stable results.\n  const cacheKey = revision === undefined ? {} : revision;\n  const slices = useComputed(\n    () =>\n      pieSlices(resolveSignalValue(props.data), {\n        value: props.value,\n        keyBy: props.keyBy,\n      }),\n    [cacheKey, props.data, props.value, props.keyBy],\n  );\n  const layout = useComputed(() => {\n    context.save();\n    try {\n      // Canvas silently ignores malformed fonts. Two distinct sentinels detect\n      // that without depending on the caller's inherited font or CSS spelling.\n      context.font = \"10px serif\";\n      context.font = font;\n      const normalized = context.font;\n      context.font = \"11px monospace\";\n      context.font = font;\n      if (context.font !== normalized)\n        throw new TypeError(\"PieLayout: labelFont must be a valid Canvas font.\");\n      context.textAlign = \"left\";\n      context.textBaseline = \"alphabetic\";\n      return layoutPie(\n        slices.get(),\n        cx,\n        cy,\n        radius,\n        innerRadius,\n        { x: bx, y: by, width: bw, height: bh },\n        context.font,\n        gap,\n        placement,\n        props.label,\n        (text) => {\n          const m = context.measureText(text);\n          const width = Math.max(\n            m.width,\n            m.actualBoundingBoxLeft + m.actualBoundingBoxRight,\n          );\n          const ascent = Math.max(0, m.actualBoundingBoxAscent),\n            descent = Math.max(0, m.actualBoundingBoxDescent);\n          return {\n            width: finite(width, \"label width\", true),\n            height: finite(Math.max(1, ascent + descent), \"label height\", true),\n            left: Math.max(0, m.actualBoundingBoxLeft),\n            ascent,\n          };\n        },\n      );\n    } finally {\n      context.restore();\n    }\n  }, [\n    slices,\n    cx,\n    cy,\n    radius,\n    innerRadius,\n    bx,\n    by,\n    bw,\n    bh,\n    font,\n    gap,\n    placement,\n    props.label,\n    context,\n  ]);\n  return layout\n    .get()\n    .map((slice) => (\n      <Group key={slice.key}>\n        {withHooksForbidden(\n          \"PieLayout children cannot call hooks; return a component instead.\",\n          () => props.children(slice),\n        )}\n      </Group>\n    ));\n}\n/**\n * Draws a resolved pie slice using wedge geometry and the supplied paint style.\n *\n * @param props - Slice geometry, appearance, handlers, and children. See {@link PieSliceProps}.\n * @returns Pibbl nodes drawing one pie slice and its children.\n *\n * @see {@link PieSliceProps}\n */\nexport function PieSlice<D>({\n  slice,\n  style: input,\n  children,\n  ...events\n}: PieSliceProps<D>) {\n  const style = resolveSignalValue(input) ?? {};\n  if (slice.innerRadius === 0) {\n    return (\n      <Group>\n        <Wedge\n          {...events}\n          style={{\n            ...style,\n            cx: slice.cx,\n            cy: slice.cy,\n            radius: slice.radius,\n            startAngle: slice.startAngle,\n            endAngle: slice.endAngle,\n          }}\n        />\n        {children}\n      </Group>\n    );\n  }\n  const sweep = resolveClockwiseSweep(slice.startAngle, slice.endAngle);\n  const path = new Path2D();\n  path.arc(\n    slice.cx,\n    slice.cy,\n    slice.radius,\n    sweep.startAngle,\n    sweep.endAngle,\n  );\n  if (slice.innerRadius > 0)\n    path.arc(\n      slice.cx,\n      slice.cy,\n      slice.innerRadius,\n      sweep.endAngle,\n      sweep.startAngle,\n      true,\n    );\n  else path.lineTo(slice.cx, slice.cy);\n  path.closePath();\n  return (\n    <Group>\n      <Path\n        {...events}\n        keyboardNavigationBounds={\n          events.keyboardNavigationBounds ??\n          annularSliceBounds(slice, sweep)\n        }\n        style={{\n          ...style,\n          d: path,\n        }}\n      />\n      {children}\n    </Group>\n  );\n}\n\n/** The outer and inner arcs both contribute to an annular path's focus box. */\nfunction annularSliceBounds(\n  slice: PieLayoutSlice<unknown>,\n  sweep: Readonly<ClockwiseSweep>,\n) {\n  if (sweep.sweep === 0) return undefined;\n  if (sweep.fullCircle)\n    return {\n      x: slice.cx - slice.radius,\n      y: slice.cy - slice.radius,\n      width: slice.radius * 2,\n      height: slice.radius * 2,\n    };\n  const angles = [sweep.startAngle, sweep.endAngle];\n  for (const cardinal of [0, Math.PI / 2, Math.PI, Math.PI * 1.5]) {\n    const angle = cardinal < sweep.startAngle ? cardinal + fullTurn : cardinal;\n    if (angle <= sweep.endAngle) angles.push(angle);\n  }\n  const xs: number[] = [];\n  const ys: number[] = [];\n  for (const angle of angles) {\n    const cosine = Math.cos(angle);\n    const sine = Math.sin(angle);\n    xs.push(\n      slice.cx + slice.radius * cosine,\n      slice.cx + slice.innerRadius * cosine,\n    );\n    ys.push(\n      slice.cy + slice.radius * sine,\n      slice.cy + slice.innerRadius * sine,\n    );\n  }\n  const left = Math.min(...xs);\n  const right = Math.max(...xs);\n  const top = Math.min(...ys);\n  const bottom = Math.max(...ys);\n  return { x: left, y: top, width: right - left, height: bottom - top };\n}\n\nconst fullTurn = Math.PI * 2;\n\ninterface ClockwiseSweep {\n  readonly startAngle: number;\n  readonly endAngle: number;\n  readonly sweep: number;\n  readonly fullCircle: boolean;\n}\n\n/** Matches Canvas's bounded clockwise arc rule without retaining unbounded turns. */\nfunction resolveClockwiseSweep(\n  startAngle: number,\n  endAngle: number,\n): ClockwiseSweep {\n  if (!Number.isFinite(startAngle) || !Number.isFinite(endAngle))\n    throw new RangeError(\"PieSlice: slice angles must be finite.\");\n  const start = positiveModulo(startAngle, fullTurn);\n  if (endAngle - startAngle >= fullTurn)\n    return {\n      startAngle: start,\n      endAngle: start + fullTurn,\n      sweep: fullTurn,\n      fullCircle: true,\n    };\n  const sweep = positiveModulo(\n    positiveModulo(endAngle, fullTurn) - start,\n    fullTurn,\n  );\n  return {\n    startAngle: start,\n    endAngle: start + sweep,\n    sweep,\n    fullCircle: false,\n  };\n}\n\nfunction positiveModulo(value: number, divisor: number) {\n  const result = value % divisor;\n  if (result === 0) return 0;\n  return result < 0 ? result + divisor : result;\n}\n\nconst LabelText = definePrimitive<\n  { label: Extract<PieLabelLayout, { status: \"placed\" }> },\n  { readonly custom?: never; fill: import(\"@pibbl/core\").FillStyle }\n>(({ label }, style, context) => {\n  context.font = label.font;\n  context.textAlign = \"left\";\n  context.textBaseline = \"alphabetic\";\n  context.fillStyle = resolveTexturePaint(style.fill, context, { x: label.x, y: label.y, width: label.width, height: label.height });\n  context.fillText(label.text, label.textX, label.textY);\n});\n\n/**\n * Draws a resolved slice label and optional leader line; decorative labels ignore pointer\n * targeting\n * by default.\n *\n * @param props - Slice geometry, label appearance, and interaction options. See\n * {@link PieLabelProps} .\n * @returns Pibbl content drawing the slice label, or null when the label was not placed.\n *\n * @see {@link PieLabelProps}\n */\nexport function PieLabel<D>({\n  slice,\n  style: input,\n  pointerEvents = \"none\",\n  ...events\n}: PieLabelProps<D>) {\n  const style = resolveSignalValue(input) ?? {};\n  const label = slice.label;\n  if (!label || label.status !== \"placed\") return null;\n  return (\n    <Group {...events}>\n      {label.leader && (\n        <Line\n          pointerEvents=\"none\"\n          style={{\n            coords: label.leader.map((p) => [p[0], p[1]]),\n            stroke: resolveSignalValue(style.leaderStroke) ?? \"#94a3b8\",\n            strokeWidth: resolveSignalValue(style.leaderWidth) ?? 1,\n          }}\n        />\n      )}\n      <Rectangle\n        pointerEvents={pointerEvents}\n        style={{\n          left: label.x,\n          top: label.y,\n          width: label.width,\n          height: label.height,\n          fill: \"transparent\",\n        }}\n      />\n      <LabelText\n        label={label}\n        style={{ fill: resolveSignalValue(style.fill) ?? \"#182c42\" }}\n      />\n    </Group>\n  );\n}\n"],
-  "mappings": "AAyKM,cAyBA,YAzBA;AAzKN;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,qBAAqB,0BAA0B;AAQxD,SAAS,iBAAiB;AAC1B,SAAS,iBAAiB;AAC1B,SAAS,OAAO,OAAe,MAAc,cAAc,OAAO;AAChE,MAAI,CAAC,OAAO,SAAS,KAAK,KAAM,eAAe,QAAQ;AACrD,UAAM,IAAI;AAAA,MACR,cAAc,IAAI,kBAAkB,cAAc,qBAAqB,EAAE;AAAA,IAC3E;AACF,SAAO;AACT;AASO,SAAS,UAAa,OAA0B;AACrD,QAAM,aAAa,aAAa;AAChC,QAAM,UAAU,iBAAiB;AACjC,QAAM,QAAQ,mBAAmB,MAAM,KAAK,KAAK,CAAC;AAClD,QAAM,SAAS,mBAAmB,MAAM,MAAM,KAAK;AAAA,IACjD,GAAG;AAAA,IACH,GAAG;AAAA,IACH,OAAO,WAAW;AAAA,IAClB,QAAQ,WAAW;AAAA,EACrB;AACA,QAAM,KAAK,OAAO,OAAO,GAAG,UAAU,GACpC,KAAK,OAAO,OAAO,GAAG,UAAU;AAClC,QAAM,KAAK,OAAO,OAAO,OAAO,gBAAgB,IAAI,GAClD,KAAK,OAAO,OAAO,QAAQ,iBAAiB,IAAI;AAClD,SAAO,KAAK,IAAI,cAAc;AAC9B,SAAO,KAAK,IAAI,eAAe;AAC/B,QAAM,KAAK,OAAO,mBAAmB,MAAM,EAAE,KAAK,KAAK,KAAK,GAAG,IAAI;AACnE,QAAM,KAAK,OAAO,mBAAmB,MAAM,EAAE,KAAK,KAAK,KAAK,GAAG,IAAI;AACnE,QAAM,SAAS;AAAA,IACb,mBAAmB,MAAM,MAAM,KAAK,KAAK,IAAI,KAAK,MAAM,KAAK,GAAG;AAAA,IAChE;AAAA,IACA;AAAA,EACF;AACA,QAAM,cAAc;AAAA,IAClB,mBAAmB,MAAM,WAAW,KAAK;AAAA,IACzC;AAAA,IACA;AAAA,EACF;AACA,MAAI,WAAW,IAAI,gBAAgB,IAAI,eAAe;AACpD,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,QAAM,MAAM,OAAO,mBAAmB,MAAM,QAAQ,KAAK,GAAG,YAAY,IAAI;AAC5E,SAAO,KAAK,SAAS,KAAK,kBAAkB;AAC5C,SAAO,KAAK,SAAS,KAAK,iBAAiB;AAC3C,SAAO,KAAK,QAAQ,QAAQ;AAC5B,SAAO,KAAK,QAAQ,KAAK;AACzB,QAAM,OAAO,mBAAmB,MAAM,SAAS,KAAK;AACpD,MAAI,OAAO,SAAS,YAAY,CAAC,KAAK,KAAK;AACzC,UAAM,IAAI,UAAU,oDAAoD;AAC1E,QAAM,YAAY,mBAAmB,MAAM,SAAS,KAAK;AACzD,MAAI,CAAC,CAAC,UAAU,WAAW,MAAM,EAAE,SAAS,SAAS;AACnD,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,MAAI,OAAO,MAAM,aAAa;AAC5B,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,QAAM,WACJ,MAAM,aAAa,SAAY,SAAY,mBAAmB,MAAM,QAAQ;AAC9E,MACE,aAAa,WACZ,CAAC,OAAO,cAAc,QAAQ,KAAK,WAAW;AAE/C,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAGF,QAAM,WAAW,aAAa,SAAY,CAAC,IAAI;AAC/C,QAAM,SAAS;AAAA,IACb,MACE,UAAU,mBAAmB,MAAM,IAAI,GAAG;AAAA,MACxC,OAAO,MAAM;AAAA,MACb,OAAO,MAAM;AAAA,IACf,CAAC;AAAA,IACH,CAAC,UAAU,MAAM,MAAM,MAAM,OAAO,MAAM,KAAK;AAAA,EACjD;AACA,QAAM,SAAS,YAAY,MAAM;AAC/B,YAAQ,KAAK;AACb,QAAI;AAGF,cAAQ,OAAO;AACf,cAAQ,OAAO;AACf,YAAM,aAAa,QAAQ;AAC3B,cAAQ,OAAO;AACf,cAAQ,OAAO;AACf,UAAI,QAAQ,SAAS;AACnB,cAAM,IAAI,UAAU,mDAAmD;AACzE,cAAQ,YAAY;AACpB,cAAQ,eAAe;AACvB,aAAO;AAAA,QACL,OAAO,IAAI;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,EAAE,GAAG,IAAI,GAAG,IAAI,OAAO,IAAI,QAAQ,GAAG;AAAA,QACtC,QAAQ;AAAA,QACR;AAAA,QACA;AAAA,QACA,MAAM;AAAA,QACN,CAAC,SAAS;AACR,gBAAM,IAAI,QAAQ,YAAY,IAAI;AAClC,gBAAM,QAAQ,KAAK;AAAA,YACjB,EAAE;AAAA,YACF,EAAE,wBAAwB,EAAE;AAAA,UAC9B;AACA,gBAAM,SAAS,KAAK,IAAI,GAAG,EAAE,uBAAuB,GAClD,UAAU,KAAK,IAAI,GAAG,EAAE,wBAAwB;AAClD,iBAAO;AAAA,YACL,OAAO,OAAO,OAAO,eAAe,IAAI;AAAA,YACxC,QAAQ,OAAO,KAAK,IAAI,GAAG,SAAS,OAAO,GAAG,gBAAgB,IAAI;AAAA,YAClE,MAAM,KAAK,IAAI,GAAG,EAAE,qBAAqB;AAAA,YACzC;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF,UAAE;AACA,cAAQ,QAAQ;AAAA,IAClB;AAAA,EACF,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM;AAAA,IACN;AAAA,EACF,CAAC;AACD,SAAO,OACJ,IAAI,EACJ,IAAI,CAAC,UACJ,oBAAC,SACE;AAAA,IACC;AAAA,IACA,MAAM,MAAM,SAAS,KAAK;AAAA,EAC5B,KAJU,MAAM,GAKlB,CACD;AACL;AASO,SAAS,SAAY;AAAA,EAC1B;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA,GAAG;AACL,GAAqB;AACnB,QAAM,QAAQ,mBAAmB,KAAK,KAAK,CAAC;AAC5C,MAAI,MAAM,gBAAgB,GAAG;AAC3B,WACE,qBAAC,SACC;AAAA;AAAA,QAAC;AAAA;AAAA,UACE,GAAG;AAAA,UACJ,OAAO;AAAA,YACL,GAAG;AAAA,YACH,IAAI,MAAM;AAAA,YACV,IAAI,MAAM;AAAA,YACV,QAAQ,MAAM;AAAA,YACd,YAAY,MAAM;AAAA,YAClB,UAAU,MAAM;AAAA,UAClB;AAAA;AAAA,MACF;AAAA,MACC;AAAA,OACH;AAAA,EAEJ;AACA,QAAM,QAAQ,sBAAsB,MAAM,YAAY,MAAM,QAAQ;AACpE,QAAM,OAAO,IAAI,OAAO;AACxB,OAAK;AAAA,IACH,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,EACR;AACA,MAAI,MAAM,cAAc;AACtB,SAAK;AAAA,MACH,MAAM;AAAA,MACN,MAAM;AAAA,MACN,MAAM;AAAA,MACN,MAAM;AAAA,MACN,MAAM;AAAA,MACN;AAAA,IACF;AAAA,MACG,MAAK,OAAO,MAAM,IAAI,MAAM,EAAE;AACnC,OAAK,UAAU;AACf,SACE,qBAAC,SACC;AAAA;AAAA,MAAC;AAAA;AAAA,QACE,GAAG;AAAA,QACJ,0BACE,OAAO,4BACP,mBAAmB,OAAO,KAAK;AAAA,QAEjC,OAAO;AAAA,UACL,GAAG;AAAA,UACH,GAAG;AAAA,QACL;AAAA;AAAA,IACF;AAAA,IACC;AAAA,KACH;AAEJ;AAGA,SAAS,mBACP,OACA,OACA;AACA,MAAI,MAAM,UAAU,EAAG,QAAO;AAC9B,MAAI,MAAM;AACR,WAAO;AAAA,MACL,GAAG,MAAM,KAAK,MAAM;AAAA,MACpB,GAAG,MAAM,KAAK,MAAM;AAAA,MACpB,OAAO,MAAM,SAAS;AAAA,MACtB,QAAQ,MAAM,SAAS;AAAA,IACzB;AACF,QAAM,SAAS,CAAC,MAAM,YAAY,MAAM,QAAQ;AAChD,aAAW,YAAY,CAAC,GAAG,KAAK,KAAK,GAAG,KAAK,IAAI,KAAK,KAAK,GAAG,GAAG;AAC/D,UAAM,QAAQ,WAAW,MAAM,aAAa,WAAW,WAAW;AAClE,QAAI,SAAS,MAAM,SAAU,QAAO,KAAK,KAAK;AAAA,EAChD;AACA,QAAM,KAAe,CAAC;AACtB,QAAM,KAAe,CAAC;AACtB,aAAW,SAAS,QAAQ;AAC1B,UAAM,SAAS,KAAK,IAAI,KAAK;AAC7B,UAAM,OAAO,KAAK,IAAI,KAAK;AAC3B,OAAG;AAAA,MACD,MAAM,KAAK,MAAM,SAAS;AAAA,MAC1B,MAAM,KAAK,MAAM,cAAc;AAAA,IACjC;AACA,OAAG;AAAA,MACD,MAAM,KAAK,MAAM,SAAS;AAAA,MAC1B,MAAM,KAAK,MAAM,cAAc;AAAA,IACjC;AAAA,EACF;AACA,QAAM,OAAO,KAAK,IAAI,GAAG,EAAE;AAC3B,QAAM,QAAQ,KAAK,IAAI,GAAG,EAAE;AAC5B,QAAM,MAAM,KAAK,IAAI,GAAG,EAAE;AAC1B,QAAM,SAAS,KAAK,IAAI,GAAG,EAAE;AAC7B,SAAO,EAAE,GAAG,MAAM,GAAG,KAAK,OAAO,QAAQ,MAAM,QAAQ,SAAS,IAAI;AACtE;AAEA,MAAM,WAAW,KAAK,KAAK;AAU3B,SAAS,sBACP,YACA,UACgB;AAChB,MAAI,CAAC,OAAO,SAAS,UAAU,KAAK,CAAC,OAAO,SAAS,QAAQ;AAC3D,UAAM,IAAI,WAAW,wCAAwC;AAC/D,QAAM,QAAQ,eAAe,YAAY,QAAQ;AACjD,MAAI,WAAW,cAAc;AAC3B,WAAO;AAAA,MACL,YAAY;AAAA,MACZ,UAAU,QAAQ;AAAA,MAClB,OAAO;AAAA,MACP,YAAY;AAAA,IACd;AACF,QAAM,QAAQ;AAAA,IACZ,eAAe,UAAU,QAAQ,IAAI;AAAA,IACrC;AAAA,EACF;AACA,SAAO;AAAA,IACL,YAAY;AAAA,IACZ,UAAU,QAAQ;AAAA,IAClB;AAAA,IACA,YAAY;AAAA,EACd;AACF;AAEA,SAAS,eAAe,OAAe,SAAiB;AACtD,QAAM,SAAS,QAAQ;AACvB,MAAI,WAAW,EAAG,QAAO;AACzB,SAAO,SAAS,IAAI,SAAS,UAAU;AACzC;AAEA,MAAM,YAAY,gBAGhB,CAAC,EAAE,MAAM,GAAG,OAAO,YAAY;AAC/B,UAAQ,OAAO,MAAM;AACrB,UAAQ,YAAY;AACpB,UAAQ,eAAe;AACvB,UAAQ,YAAY,oBAAoB,MAAM,MAAM,SAAS,EAAE,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,OAAO,MAAM,OAAO,QAAQ,MAAM,OAAO,CAAC;AACjI,UAAQ,SAAS,MAAM,MAAM,MAAM,OAAO,MAAM,KAAK;AACvD,CAAC;AAaM,SAAS,SAAY;AAAA,EAC1B;AAAA,EACA,OAAO;AAAA,EACP,gBAAgB;AAAA,EAChB,GAAG;AACL,GAAqB;AACnB,QAAM,QAAQ,mBAAmB,KAAK,KAAK,CAAC;AAC5C,QAAM,QAAQ,MAAM;AACpB,MAAI,CAAC,SAAS,MAAM,WAAW,SAAU,QAAO;AAChD,SACE,qBAAC,SAAO,GAAG,QACR;AAAA,UAAM,UACL;AAAA,MAAC;AAAA;AAAA,QACC,eAAc;AAAA,QACd,OAAO;AAAA,UACL,QAAQ,MAAM,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAAA,UAC5C,QAAQ,mBAAmB,MAAM,YAAY,KAAK;AAAA,UAClD,aAAa,mBAAmB,MAAM,WAAW,KAAK;AAAA,QACxD;AAAA;AAAA,IACF;AAAA,IAEF;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA,OAAO;AAAA,UACL,MAAM,MAAM;AAAA,UACZ,KAAK,MAAM;AAAA,UACX,OAAO,MAAM;AAAA,UACb,QAAQ,MAAM;AAAA,UACd,MAAM;AAAA,QACR;AAAA;AAAA,IACF;AAAA,IACA;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA,OAAO,EAAE,MAAM,mBAAmB,MAAM,IAAI,KAAK,UAAU;AAAA;AAAA,IAC7D;AAAA,KACF;AAEJ;",
+  "sourcesContent": ["import {\n  Group,\n  Path,\n  Wedge,\n  definePrimitive,\n  Line,\n  Rectangle,\n  resolveSignalValue,\n  useComputed,\n  useCanvasContext,\n  useLayoutBox,\n} from \"@pibbl/core\";\nimport { resolveTexturePaint, withHooksForbidden } from \"@pibbl/core/internal\";\nimport type {\n  PieLayoutProps,\n  PieLayoutSlice,\n  PieSliceProps,\n  PieLabelProps,\n  PieLabelLayout,\n} from \"./pie-types.js\";\nimport { pieSlices } from \"./pie-slices.js\";\nimport { layoutPie } from \"./layout-pie.js\";\nfunction finite(value: number, name: string, nonnegative = false) {\n  if (!Number.isFinite(value) || (nonnegative && value < 0))\n    throw new RangeError(\n      `PieLayout: ${name} must be finite${nonnegative ? \" and nonnegative\" : \"\"}.`,\n    );\n  return value;\n}\n/**\n * Computes pie geometry and label placement, then renders children for each resolved slice.\n *\n * @param props - Data, pie geometry, label policy, and child renderer. See {@link PieLayoutProps}.\n * @returns Pibbl content arranged as pie slices.\n *\n * @see {@link PieLayoutProps}\n */\nexport function PieLayout<D>(props: PieLayoutProps<D>) {\n  const allocation = useLayoutBox();\n  const context = useCanvasContext();\n  const style = resolveSignalValue(props.style) ?? {};\n  const bounds = resolveSignalValue(props.bounds) ?? {\n    x: 0,\n    y: 0,\n    width: allocation.width,\n    height: allocation.height,\n  };\n  const bx = finite(bounds.x, \"bounds.x\"),\n    by = finite(bounds.y, \"bounds.y\");\n  const bw = finite(bounds.width, \"bounds.width\", true),\n    bh = finite(bounds.height, \"bounds.height\", true);\n  finite(bx + bw, \"bounds right\");\n  finite(by + bh, \"bounds bottom\");\n  const cx = finite(resolveSignalValue(style.cx) ?? bx + bw / 2, \"cx\");\n  const cy = finite(resolveSignalValue(style.cy) ?? by + bh / 2, \"cy\");\n  const radius = finite(\n    resolveSignalValue(style.radius) ?? Math.min(bw * 0.28, bh * 0.4),\n    \"radius\",\n    true,\n  );\n  const innerRadius = finite(\n    resolveSignalValue(style.innerRadius) ?? 0,\n    \"innerRadius\",\n    true,\n  );\n  if (radius === 0 ? innerRadius !== 0 : innerRadius >= radius)\n    throw new RangeError(\n      \"PieLayout: innerRadius must be zero when radius is zero, or less than radius.\",\n    );\n  const gap = finite(resolveSignalValue(style.labelGap) ?? 8, \"labelGap\", true);\n  finite(cx + radius + gap, \"right label edge\");\n  finite(cx - radius - gap, \"left label edge\");\n  finite(cy + radius, \"bottom\");\n  finite(cy - radius, \"top\");\n  const font = resolveSignalValue(style.labelFont) ?? \"14px sans-serif\";\n  if (typeof font !== \"string\" || !font.trim())\n    throw new TypeError(\"PieLayout: labelFont must be a Canvas font string.\");\n  const placement = resolveSignalValue(props.placement) ?? \"outside\";\n  if (![\"inside\", \"outside\", \"auto\"].includes(placement))\n    throw new TypeError(\n      \"PieLayout: placement must be inside, outside, or auto.\",\n    );\n  if (typeof props.children !== \"function\")\n    throw new TypeError(\n      \"PieLayout: children must be a function returning Pibbl elements.\",\n    );\n  const revision =\n    props.revision === undefined ? undefined : resolveSignalValue(props.revision);\n  if (\n    revision !== undefined &&\n    (!Number.isSafeInteger(revision) || revision < 0)\n  )\n    throw new RangeError(\n      \"PieLayout: revision must be a finite nonnegative safe integer.\",\n    );\n  // An omitted revision deliberately replaces this token on every evaluation.\n  // Stable callback identities alone are not evidence of stable results.\n  const cacheKey = revision === undefined ? {} : revision;\n  const slices = useComputed(\n    () =>\n      pieSlices(resolveSignalValue(props.data), {\n        value: props.value,\n        keyBy: props.keyBy,\n      }),\n    [cacheKey, props.data, props.value, props.keyBy],\n  );\n  const layout = useComputed(() => {\n    context.save();\n    try {\n      // Canvas silently ignores malformed fonts. Two distinct sentinels detect\n      // that without depending on the caller's inherited font or CSS spelling.\n      context.font = \"10px serif\";\n      context.font = font;\n      const normalized = context.font;\n      context.font = \"11px monospace\";\n      context.font = font;\n      if (context.font !== normalized)\n        throw new TypeError(\"PieLayout: labelFont must be a valid Canvas font.\");\n      context.textAlign = \"left\";\n      context.textBaseline = \"alphabetic\";\n      return layoutPie(\n        slices.get(),\n        cx,\n        cy,\n        radius,\n        innerRadius,\n        { x: bx, y: by, width: bw, height: bh },\n        context.font,\n        gap,\n        placement,\n        props.label,\n        (text) => {\n          const m = context.measureText(text);\n          const width = Math.max(\n            m.width,\n            m.actualBoundingBoxLeft + m.actualBoundingBoxRight,\n          );\n          const ascent = Math.max(0, m.actualBoundingBoxAscent),\n            descent = Math.max(0, m.actualBoundingBoxDescent);\n          return {\n            width: finite(width, \"label width\", true),\n            height: finite(Math.max(1, ascent + descent), \"label height\", true),\n            left: Math.max(0, m.actualBoundingBoxLeft),\n            ascent,\n          };\n        },\n      );\n    } finally {\n      context.restore();\n    }\n  }, [\n    slices,\n    cx,\n    cy,\n    radius,\n    innerRadius,\n    bx,\n    by,\n    bw,\n    bh,\n    font,\n    gap,\n    placement,\n    props.label,\n    context,\n  ]);\n  return layout\n    .get()\n    .map((slice) => (\n      <Group key={slice.key}>\n        {withHooksForbidden(\n          \"PieLayout children cannot call hooks; return a component instead.\",\n          () => props.children(slice),\n        )}\n      </Group>\n    ));\n}\n/**\n * Draws a resolved pie slice using wedge geometry and the supplied paint style.\n *\n * @param props - Slice geometry, appearance, handlers, and children. See {@link PieSliceProps}.\n * @returns Pibbl nodes drawing one pie slice and its children.\n *\n * @see {@link PieSliceProps}\n */\nexport function PieSlice<D>({\n  slice,\n  style: input,\n  children,\n  ...events\n}: PieSliceProps<D>) {\n  const style = resolveSignalValue(input) ?? {};\n  if (slice.innerRadius === 0) {\n    return (\n      <Group>\n        <Wedge\n          {...events}\n          style={{\n            ...style,\n            cx: slice.cx,\n            cy: slice.cy,\n            radius: slice.radius,\n            startAngle: slice.startAngle,\n            endAngle: slice.endAngle,\n          }}\n        />\n        {children}\n      </Group>\n    );\n  }\n  const sweep = resolveClockwiseSweep(slice.startAngle, slice.endAngle);\n  const path = new Path2D();\n  path.arc(\n    slice.cx,\n    slice.cy,\n    slice.radius,\n    sweep.startAngle,\n    sweep.endAngle,\n  );\n  if (slice.innerRadius > 0)\n    path.arc(\n      slice.cx,\n      slice.cy,\n      slice.innerRadius,\n      sweep.endAngle,\n      sweep.startAngle,\n      true,\n    );\n  else path.lineTo(slice.cx, slice.cy);\n  path.closePath();\n  return (\n    <Group>\n      <Path\n        {...events}\n        keyboardNavigationBounds={\n          events.keyboardNavigationBounds ??\n          annularSliceBounds(slice, sweep)\n        }\n        style={{\n          ...style,\n          d: path,\n        }}\n      />\n      {children}\n    </Group>\n  );\n}\n\n/** The outer and inner arcs both contribute to an annular path's focus box. */\nfunction annularSliceBounds(\n  slice: PieLayoutSlice<unknown>,\n  sweep: Readonly<ClockwiseSweep>,\n) {\n  if (sweep.sweep === 0) return undefined;\n  if (sweep.fullCircle)\n    return {\n      x: slice.cx - slice.radius,\n      y: slice.cy - slice.radius,\n      width: slice.radius * 2,\n      height: slice.radius * 2,\n    };\n  const angles = [sweep.startAngle, sweep.endAngle];\n  for (let cardinalIndex = 0; cardinalIndex < 4; cardinalIndex++) {\n    const cardinal = cardinalIndex * (Math.PI / 2);\n    const angle = cardinal < sweep.startAngle ? cardinal + fullTurn : cardinal;\n    if (angle <= sweep.endAngle) angles.push(angle);\n  }\n  const xs: number[] = [];\n  const ys: number[] = [];\n  for (const angle of angles) {\n    const cosine = Math.cos(angle);\n    const sine = Math.sin(angle);\n    xs.push(\n      slice.cx + slice.radius * cosine,\n      slice.cx + slice.innerRadius * cosine,\n    );\n    ys.push(\n      slice.cy + slice.radius * sine,\n      slice.cy + slice.innerRadius * sine,\n    );\n  }\n  const left = Math.min(...xs);\n  const right = Math.max(...xs);\n  const top = Math.min(...ys);\n  const bottom = Math.max(...ys);\n  return { x: left, y: top, width: right - left, height: bottom - top };\n}\n\nconst fullTurn = Math.PI * 2;\n\ninterface ClockwiseSweep {\n  readonly startAngle: number;\n  readonly endAngle: number;\n  readonly sweep: number;\n  readonly fullCircle: boolean;\n}\n\n/** Matches Canvas's bounded clockwise arc rule without retaining unbounded turns. */\nfunction resolveClockwiseSweep(\n  startAngle: number,\n  endAngle: number,\n): ClockwiseSweep {\n  if (!Number.isFinite(startAngle) || !Number.isFinite(endAngle))\n    throw new RangeError(\"PieSlice: slice angles must be finite.\");\n  const start = positiveModulo(startAngle, fullTurn);\n  if (endAngle - startAngle >= fullTurn)\n    return {\n      startAngle: start,\n      endAngle: start + fullTurn,\n      sweep: fullTurn,\n      fullCircle: true,\n    };\n  const sweep = positiveModulo(\n    positiveModulo(endAngle, fullTurn) - start,\n    fullTurn,\n  );\n  return {\n    startAngle: start,\n    endAngle: start + sweep,\n    sweep,\n    fullCircle: false,\n  };\n}\n\nfunction positiveModulo(value: number, divisor: number) {\n  const result = value % divisor;\n  if (result === 0) return 0;\n  return result < 0 ? result + divisor : result;\n}\n\nconst LabelText = definePrimitive<\n  { label: Extract<PieLabelLayout, { status: \"placed\" }> },\n  { readonly custom?: never; fill: import(\"@pibbl/core\").FillStyle }\n>(({ label }, style, context) => {\n  context.font = label.font;\n  context.textAlign = \"left\";\n  context.textBaseline = \"alphabetic\";\n  context.fillStyle = resolveTexturePaint(style.fill, context, { x: label.x, y: label.y, width: label.width, height: label.height });\n  context.fillText(label.text, label.textX, label.textY);\n});\n\n/**\n * Draws a resolved slice label and optional leader line; decorative labels ignore pointer\n * targeting\n * by default.\n *\n * @param props - Slice geometry, label appearance, and interaction options. See\n * {@link PieLabelProps} .\n * @returns Pibbl content drawing the slice label, or null when the label was not placed.\n *\n * @see {@link PieLabelProps}\n */\nexport function PieLabel<D>({\n  slice,\n  style: input,\n  pointerEvents = \"none\",\n  ...events\n}: PieLabelProps<D>) {\n  const style = resolveSignalValue(input) ?? {};\n  const label = slice.label;\n  if (!label || label.status !== \"placed\") return null;\n  return (\n    <Group {...events}>\n      {label.leader && (\n        <Line\n          pointerEvents=\"none\"\n          style={{\n            coords: label.leader.map((p) => [p[0], p[1]]),\n            stroke: resolveSignalValue(style.leaderStroke) ?? \"#94a3b8\",\n            strokeWidth: resolveSignalValue(style.leaderWidth) ?? 1,\n          }}\n        />\n      )}\n      <Rectangle\n        pointerEvents={pointerEvents}\n        style={{\n          left: label.x,\n          top: label.y,\n          width: label.width,\n          height: label.height,\n          fill: \"transparent\",\n        }}\n      />\n      <LabelText\n        label={label}\n        style={{ fill: resolveSignalValue(style.fill) ?? \"#182c42\" }}\n      />\n    </Group>\n  );\n}\n"],
+  "mappings": "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",
   "names": []
 }

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

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

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

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

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

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

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

@@ -8,4 +8,4 @@ import type { PointSeriesProps } from "./point-types.js";
  *
  * @see {@link PointSeriesProps}
  */
-export declare function PointSeries<D>({ data: input, x: xInput, y: yInput, xScale: xId, yScale: yId, defined, style: styleInput, ...events }: PointSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;
+export declare function PointSeries<D>({ data: input, x: xInput, y: yInput, xScale: xId, yScale: yId, defined, inspection, style: styleInput, ...events }: PointSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;

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

@@ -6,8 +6,12 @@ import {
   resolveSignalValue,
   useCanvasContext
 } from "@pibbl/core";
-import { useContinuousScale } from "./use-continuous-scale.js";
-import { finiteCoordinate, pointAccessor, pointData } from "./point-data.js";
+import {
+  useSeriesPosition,
+  seriesAccessor,
+  mapSeriesPosition
+} from "./series-position.js";
+import { pointData } from "./point-data.js";
 import { appendPointTarget, pointPath } from "./point-geometry.js";
 import { opacity, width } from "./paint.js";
 const fields = ["radius", "fill", "stroke", "strokeWidth", "opacity", "cursor"];
@@ -52,22 +56,33 @@ function PointSeries({
   xScale: xId,
   yScale: yId,
   defined,
+  inspection,
   style: styleInput,
   ...events
 }) {
-  const xs = useContinuousScale(xId).get(), ys = useContinuousScale(yId).get();
+  const xs = useSeriesPosition(xId), ys = useSeriesPosition(yId);
   const data = pointData(resolveSignalValue(input), "PointSeries");
-  const x = pointAccessor(xInput), y = pointAccessor(yInput);
+  const x = seriesAccessor(xInput), y = seriesAccessor(yInput);
   const specified = resolveSignalValue(styleInput);
   const shared = typeof specified === "function" ? void 0 : normalized(styleObject(specified ?? {}, false));
   const ctx = useCanvasContext();
   const target = new Path2D();
+  const captured = inspection ? [] : void 0;
+  let run = 0;
+  if (inspection && (xs.type === "point" || ys.type === "point")) throw new TypeError("Numeric point inspection requires numeric continuous scales.");
   for (let i = 0; i < data.length; i++) {
     const datum = data[i];
-    if (defined && !defined(datum, i, data)) continue;
+    if (defined && !defined(datum, i, data)) {
+      run++;
+      continue;
+    }
     const xv = x(datum, i, data), yv = y(datum, i, data);
-    if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) continue;
-    const px = xs.map(xv), py = ys.map(yv);
+    const mappedX = mapSeriesPosition(xs, xv), mappedY = mapSeriesPosition(ys, yv);
+    if (mappedX === void 0 || mappedY === void 0) {
+      run++;
+      continue;
+    }
+    const px = mappedX, py = mappedY;
     const style = shared ?? normalized(
       styleObject(
         specified(
@@ -78,6 +93,7 @@ function PointSeries({
         true
       )
     );
+    captured?.push(Object.freeze({ datum, sourceIndex: i, domainX: xv, domainY: yv, anchorLocal: Object.freeze({ x: px, y: py }), run, radiusLocal: style.radius, fill: !!style.fill, strokeWidthLocal: style.stroke ? style.strokeWidth : 0 }));
     if (style.radius === 0) continue;
     appendPointTarget(
       target,
@@ -92,11 +108,21 @@ function PointSeries({
     try {
       ctx.globalAlpha *= style.opacity;
       if (style.fill) {
-        ctx.fillStyle = resolveTexturePaint(style.fill, ctx, { x: px - style.radius, y: py - style.radius, width: style.radius * 2, height: style.radius * 2 });
+        ctx.fillStyle = resolveTexturePaint(style.fill, ctx, {
+          x: px - style.radius,
+          y: py - style.radius,
+          width: style.radius * 2,
+          height: style.radius * 2
+        });
         ctx.fill(path);
       }
       if (style.stroke && style.strokeWidth > 0) {
-        ctx.strokeStyle = resolveTexturePaint(style.stroke, ctx, { x: px - style.radius, y: py - style.radius, width: style.radius * 2, height: style.radius * 2 });
+        ctx.strokeStyle = resolveTexturePaint(style.stroke, ctx, {
+          x: px - style.radius,
+          y: py - style.radius,
+          width: style.radius * 2,
+          height: style.radius * 2
+        });
         ctx.lineWidth = style.strokeWidth;
         ctx.stroke(path);
       }
@@ -104,6 +130,7 @@ function PointSeries({
       ctx.restore();
     }
   }
+  if (inspection && xs.type !== "point" && ys.type !== "point") inspection.capture({ observations: captured, xScale: xs, yScale: ys });
   return /* @__PURE__ */ jsx(
     Path,
     {

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/viz/lib/point-series.tsx"],
-  "sourcesContent": ["import { resolveTexturePaint } from '@pibbl/core/internal';\nimport {\n  Path,\n  isSignal,\n  resolveSignalValue,\n  useCanvasContext,\n} from \"@pibbl/core\";\nimport type { FillStyle, StrokeStyle } from \"@pibbl/core\";\nimport type {\n  PointMarkStyle,\n  PointSeriesProps,\n  PointSeriesStyle,\n} from \"./point-types.js\";\nimport { useContinuousScale } from \"./use-continuous-scale.js\";\nimport { finiteCoordinate, pointAccessor, pointData } from \"./point-data.js\";\nimport { appendPointTarget, pointPath } from \"./point-geometry.js\";\nimport { opacity, width } from \"./paint.js\";\nconst fields = [\"radius\", \"fill\", \"stroke\", \"strokeWidth\", \"opacity\", \"cursor\"];\nfunction paint(\n  value: unknown,\n  name: string,\n): FillStyle | StrokeStyle | undefined {\n  if (\n    value === undefined ||\n    typeof value === \"string\" ||\n    value instanceof CanvasGradient ||\n    value instanceof CanvasPattern\n  )\n    return value;\n  throw new TypeError(`PointSeries: invalid ${name}.`);\n}\nfunction styleObject(input: unknown, callback: boolean): PointSeriesStyle {\n  if (input === null || typeof input !== \"object\" || Array.isArray(input))\n    throw new TypeError(\"PointSeries: style must be an object.\");\n  const result: Record<string, unknown> = {};\n  for (const key of Object.keys(input)) {\n    if (!fields.includes(key) || (callback && key === \"cursor\"))\n      throw new TypeError(`PointSeries: unsupported style field ${key}.`);\n    const value = (input as Record<string, unknown>)[key];\n    if (callback && isSignal(value))\n      throw new TypeError(\n        \"PointSeries: datum styles must contain plain values; read signals explicitly.\",\n      );\n    result[key] = callback ? value : resolveSignalValue(value);\n  }\n  return result as PointSeriesStyle;\n}\nfunction normalized(style: PointSeriesStyle) {\n  const radius = width(style.radius ?? 3, \"PointSeries radius\");\n  if (style.cursor !== undefined && typeof style.cursor !== \"string\")\n    throw new TypeError(\"PointSeries: cursor must be a string.\");\n  return {\n    radius,\n    fill: paint(style.fill ?? \"#2563eb\", \"fill\"),\n    stroke: paint(style.stroke, \"stroke\"),\n    strokeWidth: width(style.strokeWidth ?? 1, \"PointSeries\"),\n    opacity: opacity(style.opacity ?? 1, \"PointSeries\"),\n    cursor: style.cursor,\n  };\n}\n/**\n * Batched circles in source paint order with one ordinary Pibbl target.\n *\n * @param props - Data, coordinate accessors, scales, and point styling. See\n * {@link PointSeriesProps} .\n * @returns Pibbl nodes drawing the point marks.\n *\n * @see {@link PointSeriesProps}\n */\nexport function PointSeries<D>({\n  data: input,\n  x: xInput,\n  y: yInput,\n  xScale: xId,\n  yScale: yId,\n  defined,\n  style: styleInput,\n  ...events\n}: PointSeriesProps<D>) {\n  const xs = useContinuousScale(xId).get(),\n    ys = useContinuousScale(yId).get();\n  const data = pointData(resolveSignalValue(input), \"PointSeries\");\n  const x = pointAccessor(xInput),\n    y = pointAccessor(yInput);\n  const specified = resolveSignalValue(styleInput);\n  const shared =\n    typeof specified === \"function\"\n      ? undefined\n      : normalized(styleObject(specified ?? {}, false));\n  const ctx = useCanvasContext();\n  const target = new Path2D();\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !defined(datum, i, data)) continue;\n    const xv = x(datum, i, data),\n      yv = y(datum, i, data);\n    if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) continue;\n    const px = xs.map(xv),\n      py = ys.map(yv);\n    const style =\n      shared ??\n      normalized(\n        styleObject(\n          (specified as (d: D, i: number, a: readonly D[]) => PointMarkStyle)(\n            datum,\n            i,\n            data,\n          ),\n          true,\n        ),\n      );\n    if (style.radius === 0) continue;\n    appendPointTarget(\n      target,\n      px,\n      py,\n      style.radius,\n      !!style.fill,\n      style.stroke ? style.strokeWidth : 0,\n    );\n    const path = pointPath(px, py, style.radius);\n    ctx.save();\n    try {\n      ctx.globalAlpha *= style.opacity;\n      if (style.fill) {\n        ctx.fillStyle = resolveTexturePaint(style.fill, ctx, { x: px - style.radius, y: py - style.radius, width: style.radius * 2, height: style.radius * 2 });\n        ctx.fill(path);\n      }\n      if (style.stroke && style.strokeWidth > 0) {\n        ctx.strokeStyle = resolveTexturePaint(style.stroke, ctx, { x: px - style.radius, y: py - style.radius, width: style.radius * 2, height: style.radius * 2 });\n        ctx.lineWidth = style.strokeWidth;\n        ctx.stroke(path);\n      }\n    } finally {\n      ctx.restore();\n    }\n  }\n  return (\n    <Path\n      {...events}\n      style={{ d: target, fill: \"transparent\", cursor: shared?.cursor }}\n    />\n  );\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { resolveTexturePaint } from \"@pibbl/core/internal\";\nimport {\n  Path,\n  isSignal,\n  resolveSignalValue,\n  useCanvasContext,\n} from \"@pibbl/core\";\nimport type { FillStyle, StrokeStyle } from \"@pibbl/core\";\nimport type {\n  PointMarkStyle,\n  PointSeriesProps,\n  PointSeriesStyle,\n} from \"./point-types.js\";\nimport {\n  useSeriesPosition,\n  seriesAccessor,\n  mapSeriesPosition,\n} from \"./series-position.js\";\nimport { pointData } from \"./point-data.js\";\nimport { appendPointTarget, pointPath } from \"./point-geometry.js\";\nimport { opacity, width } from \"./paint.js\";\nconst fields = [\"radius\", \"fill\", \"stroke\", \"strokeWidth\", \"opacity\", \"cursor\"];\nfunction paint(\n  value: unknown,\n  name: string,\n): FillStyle | StrokeStyle | undefined {\n  if (\n    value === undefined ||\n    typeof value === \"string\" ||\n    value instanceof CanvasGradient ||\n    value instanceof CanvasPattern\n  )\n    return value;\n  throw new TypeError(`PointSeries: invalid ${name}.`);\n}\nfunction styleObject(input: unknown, callback: boolean): PointSeriesStyle {\n  if (input === null || typeof input !== \"object\" || Array.isArray(input))\n    throw new TypeError(\"PointSeries: style must be an object.\");\n  const result: Record<string, unknown> = {};\n  for (const key of Object.keys(input)) {\n    if (!fields.includes(key) || (callback && key === \"cursor\"))\n      throw new TypeError(`PointSeries: unsupported style field ${key}.`);\n    const value = (input as Record<string, unknown>)[key];\n    if (callback && isSignal(value))\n      throw new TypeError(\n        \"PointSeries: datum styles must contain plain values; read signals explicitly.\",\n      );\n    result[key] = callback ? value : resolveSignalValue(value);\n  }\n  return result as PointSeriesStyle;\n}\nfunction normalized(style: PointSeriesStyle) {\n  const radius = width(style.radius ?? 3, \"PointSeries radius\");\n  if (style.cursor !== undefined && typeof style.cursor !== \"string\")\n    throw new TypeError(\"PointSeries: cursor must be a string.\");\n  return {\n    radius,\n    fill: paint(style.fill ?? \"#2563eb\", \"fill\"),\n    stroke: paint(style.stroke, \"stroke\"),\n    strokeWidth: width(style.strokeWidth ?? 1, \"PointSeries\"),\n    opacity: opacity(style.opacity ?? 1, \"PointSeries\"),\n    cursor: style.cursor,\n  };\n}\n/**\n * Batched circles in source paint order with one ordinary Pibbl target.\n *\n * @param props - Data, coordinate accessors, scales, and point styling. See\n * {@link PointSeriesProps} .\n * @returns Pibbl nodes drawing the point marks.\n *\n * @see {@link PointSeriesProps}\n */\nexport function PointSeries<D>({\n  data: input,\n  x: xInput,\n  y: yInput,\n  xScale: xId,\n  yScale: yId,\n  defined,\n  inspection,\n  style: styleInput,\n  ...events\n}: PointSeriesProps<D>) {\n  const xs = useSeriesPosition(xId),\n    ys = useSeriesPosition(yId);\n  const data = pointData(resolveSignalValue(input), \"PointSeries\");\n  const x = seriesAccessor(xInput),\n    y = seriesAccessor(yInput);\n  const specified = resolveSignalValue(styleInput);\n  const shared =\n    typeof specified === \"function\"\n      ? undefined\n      : normalized(styleObject(specified ?? {}, false));\n  const ctx = useCanvasContext();\n  const target = new Path2D();\n  const captured: import(\"../inspection/capture-types.js\").CapturedNumericObservation<D>[] | undefined = inspection ? [] : undefined;\n  let run = 0;\n  if (inspection && (xs.type === \"point\" || ys.type === \"point\")) throw new TypeError(\"Numeric point inspection requires numeric continuous scales.\");\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !defined(datum, i, data)) { run++; continue; }\n    const xv = x(datum, i, data),\n      yv = y(datum, i, data);\n    const mappedX = mapSeriesPosition(xs, xv),\n      mappedY = mapSeriesPosition(ys, yv);\n    if (mappedX === undefined || mappedY === undefined) { run++; continue; }\n    const px = mappedX,\n      py = mappedY;\n    const style =\n      shared ??\n      normalized(\n        styleObject(\n          (specified as (d: D, i: number, a: readonly D[]) => PointMarkStyle)(\n            datum,\n            i,\n            data,\n          ),\n          true,\n        ),\n      );\n    captured?.push(Object.freeze({datum,sourceIndex:i,domainX:xv as number,domainY:yv as number,anchorLocal:Object.freeze({x:px,y:py}),run,radiusLocal:style.radius,fill:!!style.fill,strokeWidthLocal:style.stroke ? style.strokeWidth : 0}));\n    if (style.radius === 0) continue;\n    appendPointTarget(\n      target,\n      px,\n      py,\n      style.radius,\n      !!style.fill,\n      style.stroke ? style.strokeWidth : 0,\n    );\n    const path = pointPath(px, py, style.radius);\n    ctx.save();\n    try {\n      ctx.globalAlpha *= style.opacity;\n      if (style.fill) {\n        ctx.fillStyle = resolveTexturePaint(style.fill, ctx, {\n          x: px - style.radius,\n          y: py - style.radius,\n          width: style.radius * 2,\n          height: style.radius * 2,\n        });\n        ctx.fill(path);\n      }\n      if (style.stroke && style.strokeWidth > 0) {\n        ctx.strokeStyle = resolveTexturePaint(style.stroke, ctx, {\n          x: px - style.radius,\n          y: py - style.radius,\n          width: style.radius * 2,\n          height: style.radius * 2,\n        });\n        ctx.lineWidth = style.strokeWidth;\n        ctx.stroke(path);\n      }\n    } finally {\n      ctx.restore();\n    }\n  }\n  if (inspection && xs.type !== \"point\" && ys.type !== \"point\") inspection.capture({observations:captured!,xScale:xs,yScale:ys});\n  return (\n    <Path\n      {...events}\n      style={{ d: target, fill: \"transparent\", cursor: shared?.cursor }}\n    />\n  );\n}\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -1,4 +1,5 @@
 import type { PlotSeriesProps } from "./plot-types.js";
+import type { SeriesAccessor } from "./types.js";
 import type { PibblEventHandlers, PibblEventParticipationOptions, FillStyle, SignalValue, StrokeStyle } from "@pibbl/core";
 import type { SignalStyle } from "@pibbl/core/internal";
 import type { LineAccessor, ScaleId } from "./types.js";
@@ -69,10 +70,12 @@ export interface PointSeriesProps<D> extends PibblEventHandlers, PibblEventParti
      * Application data supplied to the component or reported by the event. See {@link SignalValue}.
      */
     readonly data: SignalValue<readonly D[]>;
+    /** Optional committed numeric inspection capture; rendering alone performs no queries. */
+    readonly inspection?: import("../inspection/capture-types.js").NumericInspectionRef<D>;
     /** Property key or callback extracting the horizontal domain coordinate. See {@link PointAccessor}. */
-    readonly x: PointAccessor<D>;
+    readonly x: SeriesAccessor<D>;
     /** Property key or callback extracting the vertical domain coordinate. See {@link PointAccessor}. */
-    readonly y: PointAccessor<D>;
+    readonly y: SeriesAccessor<D>;
     /** The scale used to map horizontal data coordinates. See {@link ScaleId}. */
     readonly xScale: ScaleId;
     /** The scale used to map vertical data coordinates. See {@link ScaleId}. */

package/dist/features/viz/lib/reference-band.js

@@ -9,7 +9,10 @@ function ReferenceBand(props) {
   const scale = source.get();
   if (scale.type === "point" || scale.type === "band") throw new TypeError("ReferenceBand requires a continuous scale.");
   const values = resolveSignalValue(props.values), span = resolveSignalValue(props.span);
-  for (const pair of [values, span]) if (!Array.isArray(pair) || pair.length !== 2 || !pair.every((value) => typeof value === "number" && Number.isFinite(value))) throw new RangeError("ReferenceBand values and span require two finite endpoints.");
+  if (!Array.isArray(values) || values.length !== 2 || !values.every(
+    (value) => typeof value === "number" && Number.isFinite(value)
+  ) || !Array.isArray(span) || span.length !== 2 || !span.every((value) => typeof value === "number" && Number.isFinite(value)))
+    throw new RangeError("ReferenceBand values and span require two finite endpoints.");
   const lo = Math.min(...scale.domain), hi = Math.max(...scale.domain);
   if (values.some((value) => value < lo || value > hi)) throw new RangeError("ReferenceBand values must be within the scale domain.");
   const a = scale.map(values[0]), b = scale.map(values[1]);

package/dist/features/viz/lib/reference-band.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/viz/lib/reference-band.tsx"],
-  "sourcesContent": ["import { Path, resolveSignalValue, type SignalValue } from \"@pibbl/core\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { AxisStyle } from \"./types.js\";\nimport type { ChartLineProps } from \"./chart-lines.js\";\nimport { lookupScale } from \"./scale-context.js\";\nimport { opacity } from \"./paint.js\";\n/** A continuous domain interval painted across an explicit local pixel span. See {@link ReferenceBand}. */\nexport interface ReferenceBandProps extends Omit<ChartLineProps, \"style\"> {\n  /** Two finite in-domain numeric endpoints; either order, including equal values. */\n  readonly values: SignalValue<readonly [number, number]>;\n  /** Fill defaults to #dce5e8; opacity defaults to 0.35. */\n  readonly style?: SignalValue<SignalStyle<Pick<AxisStyle, \"fill\" | \"opacity\">>>;\n}\n/** Paint a decorative interval without owning layout, labels, or hit geometry.\n * @param props - Scale geometry and presentation. See {@link ReferenceBandProps}.\n * @returns Decorative chart content in the caller's coordinate space.\n */\nexport function ReferenceBand(props: ReferenceBandProps) {\n  if (props.direction !== \"horizontal\" && props.direction !== \"vertical\") throw new TypeError(\"ReferenceBand direction must be horizontal or vertical.\");\n  const source = lookupScale(props.scale, \"ReferenceBand\");\n  if (!source) throw new TypeError(\"ReferenceBand requires a scale ID.\");\n  const scale = source.get();\n  if (scale.type === \"point\" || scale.type === \"band\") throw new TypeError(\"ReferenceBand requires a continuous scale.\");\n  const values = resolveSignalValue(props.values), span = resolveSignalValue(props.span);\n  for (const pair of [values, span]) if (!Array.isArray(pair) || pair.length !== 2 || !pair.every(value => typeof value === \"number\" && Number.isFinite(value))) throw new RangeError(\"ReferenceBand values and span require two finite endpoints.\");\n  const lo = Math.min(...scale.domain), hi = Math.max(...scale.domain);\n  if (values.some(value => value < lo || value > hi)) throw new RangeError(\"ReferenceBand values must be within the scale domain.\");\n  const a = scale.map(values[0]), b = scale.map(values[1]);\n  const start = Math.min(...span), length = Math.abs(span[1] - span[0]);\n  if (!Number.isFinite(length)) throw new RangeError(\"ReferenceBand span length must be finite.\");\n  const path = new Path2D();\n  if (props.direction === \"horizontal\") path.rect(start, Math.min(a, b), length, Math.abs(b - a));\n  else path.rect(Math.min(a, b), start, Math.abs(b - a), length);\n  const style = resolveSignalValue(props.style) ?? {};\n  return <Path pointerEvents=\"none\" style={{ d: path, fill: resolveSignalValue(style.fill) ?? \"#dce5e8\", opacity: opacity(resolveSignalValue(style.opacity) ?? 0.35, \"ReferenceBand\") }} />;\n}\n"],
-  "mappings": "AAkCS;AAlCT,SAAS,MAAM,0BAA4C;AAI3D,SAAS,mBAAmB;AAC5B,SAAS,eAAe;AAYjB,SAAS,cAAc,OAA2B;AACvD,MAAI,MAAM,cAAc,gBAAgB,MAAM,cAAc,WAAY,OAAM,IAAI,UAAU,yDAAyD;AACrJ,QAAM,SAAS,YAAY,MAAM,OAAO,eAAe;AACvD,MAAI,CAAC,OAAQ,OAAM,IAAI,UAAU,oCAAoC;AACrE,QAAM,QAAQ,OAAO,IAAI;AACzB,MAAI,MAAM,SAAS,WAAW,MAAM,SAAS,OAAQ,OAAM,IAAI,UAAU,4CAA4C;AACrH,QAAM,SAAS,mBAAmB,MAAM,MAAM,GAAG,OAAO,mBAAmB,MAAM,IAAI;AACrF,aAAW,QAAQ,CAAC,QAAQ,IAAI,EAAG,KAAI,CAAC,MAAM,QAAQ,IAAI,KAAK,KAAK,WAAW,KAAK,CAAC,KAAK,MAAM,WAAS,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,CAAC,EAAG,OAAM,IAAI,WAAW,6DAA6D;AACjP,QAAM,KAAK,KAAK,IAAI,GAAG,MAAM,MAAM,GAAG,KAAK,KAAK,IAAI,GAAG,MAAM,MAAM;AACnE,MAAI,OAAO,KAAK,WAAS,QAAQ,MAAM,QAAQ,EAAE,EAAG,OAAM,IAAI,WAAW,uDAAuD;AAChI,QAAM,IAAI,MAAM,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,MAAM,IAAI,OAAO,CAAC,CAAC;AACvD,QAAM,QAAQ,KAAK,IAAI,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;AACpE,MAAI,CAAC,OAAO,SAAS,MAAM,EAAG,OAAM,IAAI,WAAW,2CAA2C;AAC9F,QAAM,OAAO,IAAI,OAAO;AACxB,MAAI,MAAM,cAAc,aAAc,MAAK,KAAK,OAAO,KAAK,IAAI,GAAG,CAAC,GAAG,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC;AAAA,MACzF,MAAK,KAAK,KAAK,IAAI,GAAG,CAAC,GAAG,OAAO,KAAK,IAAI,IAAI,CAAC,GAAG,MAAM;AAC7D,QAAM,QAAQ,mBAAmB,MAAM,KAAK,KAAK,CAAC;AAClD,SAAO,oBAAC,QAAK,eAAc,QAAO,OAAO,EAAE,GAAG,MAAM,MAAM,mBAAmB,MAAM,IAAI,KAAK,WAAW,SAAS,QAAQ,mBAAmB,MAAM,OAAO,KAAK,MAAM,eAAe,EAAE,GAAG;AACzL;",
+  "sourcesContent": ["import { Path, resolveSignalValue, type SignalValue } from \"@pibbl/core\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { AxisStyle } from \"./types.js\";\nimport type { ChartLineProps } from \"./chart-lines.js\";\nimport { lookupScale } from \"./scale-context.js\";\nimport { opacity } from \"./paint.js\";\n/** A continuous domain interval painted across an explicit local pixel span. See {@link ReferenceBand}. */\nexport interface ReferenceBandProps extends Omit<ChartLineProps, \"style\"> {\n  /** Two finite in-domain numeric endpoints; either order, including equal values. */\n  readonly values: SignalValue<readonly [number, number]>;\n  /** Fill defaults to #dce5e8; opacity defaults to 0.35. */\n  readonly style?: SignalValue<SignalStyle<Pick<AxisStyle, \"fill\" | \"opacity\">>>;\n}\n/** Paint a decorative interval without owning layout, labels, or hit geometry.\n * @param props - Scale geometry and presentation. See {@link ReferenceBandProps}.\n * @returns Decorative chart content in the caller's coordinate space.\n */\nexport function ReferenceBand(props: ReferenceBandProps) {\n  if (props.direction !== \"horizontal\" && props.direction !== \"vertical\") throw new TypeError(\"ReferenceBand direction must be horizontal or vertical.\");\n  const source = lookupScale(props.scale, \"ReferenceBand\");\n  if (!source) throw new TypeError(\"ReferenceBand requires a scale ID.\");\n  const scale = source.get();\n  if (scale.type === \"point\" || scale.type === \"band\") throw new TypeError(\"ReferenceBand requires a continuous scale.\");\n  const values = resolveSignalValue(props.values), span = resolveSignalValue(props.span);\n  if (\n    !Array.isArray(values) ||\n    values.length !== 2 ||\n    !values.every(\n      value => typeof value === \"number\" && Number.isFinite(value),\n    ) ||\n    !Array.isArray(span) ||\n    span.length !== 2 ||\n    !span.every(value => typeof value === \"number\" && Number.isFinite(value))\n  )\n    throw new RangeError(\"ReferenceBand values and span require two finite endpoints.\");\n  const lo = Math.min(...scale.domain), hi = Math.max(...scale.domain);\n  if (values.some(value => value < lo || value > hi)) throw new RangeError(\"ReferenceBand values must be within the scale domain.\");\n  const a = scale.map(values[0]), b = scale.map(values[1]);\n  const start = Math.min(...span), length = Math.abs(span[1] - span[0]);\n  if (!Number.isFinite(length)) throw new RangeError(\"ReferenceBand span length must be finite.\");\n  const path = new Path2D();\n  if (props.direction === \"horizontal\") path.rect(start, Math.min(a, b), length, Math.abs(b - a));\n  else path.rect(Math.min(a, b), start, Math.abs(b - a), length);\n  const style = resolveSignalValue(props.style) ?? {};\n  return <Path pointerEvents=\"none\" style={{ d: path, fill: resolveSignalValue(style.fill) ?? \"#dce5e8\", opacity: opacity(resolveSignalValue(style.opacity) ?? 0.35, \"ReferenceBand\") }} />;\n}\n"],
+  "mappings": "AA4CS;AA5CT,SAAS,MAAM,0BAA4C;AAI3D,SAAS,mBAAmB;AAC5B,SAAS,eAAe;AAYjB,SAAS,cAAc,OAA2B;AACvD,MAAI,MAAM,cAAc,gBAAgB,MAAM,cAAc,WAAY,OAAM,IAAI,UAAU,yDAAyD;AACrJ,QAAM,SAAS,YAAY,MAAM,OAAO,eAAe;AACvD,MAAI,CAAC,OAAQ,OAAM,IAAI,UAAU,oCAAoC;AACrE,QAAM,QAAQ,OAAO,IAAI;AACzB,MAAI,MAAM,SAAS,WAAW,MAAM,SAAS,OAAQ,OAAM,IAAI,UAAU,4CAA4C;AACrH,QAAM,SAAS,mBAAmB,MAAM,MAAM,GAAG,OAAO,mBAAmB,MAAM,IAAI;AACrF,MACE,CAAC,MAAM,QAAQ,MAAM,KACrB,OAAO,WAAW,KAClB,CAAC,OAAO;AAAA,IACN,WAAS,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK;AAAA,EAC7D,KACA,CAAC,MAAM,QAAQ,IAAI,KACnB,KAAK,WAAW,KAChB,CAAC,KAAK,MAAM,WAAS,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,CAAC;AAExE,UAAM,IAAI,WAAW,6DAA6D;AACpF,QAAM,KAAK,KAAK,IAAI,GAAG,MAAM,MAAM,GAAG,KAAK,KAAK,IAAI,GAAG,MAAM,MAAM;AACnE,MAAI,OAAO,KAAK,WAAS,QAAQ,MAAM,QAAQ,EAAE,EAAG,OAAM,IAAI,WAAW,uDAAuD;AAChI,QAAM,IAAI,MAAM,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,MAAM,IAAI,OAAO,CAAC,CAAC;AACvD,QAAM,QAAQ,KAAK,IAAI,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;AACpE,MAAI,CAAC,OAAO,SAAS,MAAM,EAAG,OAAM,IAAI,WAAW,2CAA2C;AAC9F,QAAM,OAAO,IAAI,OAAO;AACxB,MAAI,MAAM,cAAc,aAAc,MAAK,KAAK,OAAO,KAAK,IAAI,GAAG,CAAC,GAAG,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC;AAAA,MACzF,MAAK,KAAK,KAAK,IAAI,GAAG,CAAC,GAAG,OAAO,KAAK,IAAI,IAAI,CAAC,GAAG,MAAM;AAC7D,QAAM,QAAQ,mBAAmB,MAAM,KAAK,KAAK,CAAC;AAClD,SAAO,oBAAC,QAAK,eAAc,QAAO,OAAO,EAAE,GAAG,MAAM,MAAM,mBAAmB,MAAM,IAAI,KAAK,WAAW,SAAS,QAAQ,mBAAmB,MAAM,OAAO,KAAK,MAAM,eAAe,EAAE,GAAG;AACzL;",
   "names": []
 }

package/dist/features/viz/lib/scale-context.d.ts

@@ -1,6 +1,6 @@
 import type { Signal } from "@pibbl/core";
 import type { ResolvedScale, ScaleId } from "./types.js";
-export declare function scaleKind(value: Signal<ResolvedScale>): "band" | "linear" | "log" | "point" | "symlog" | "utc" | undefined;
+export declare function scaleKind(value: Signal<ResolvedScale>): "band" | "linear" | "log" | "point" | "symlog" | "trading-time" | "utc" | undefined;
 export declare function provideScale(id: ScaleId, value: Signal<ResolvedScale>, kind: ResolvedScale["type"]): void;
 export declare function lookupScale(id: ScaleId | undefined, receiver: string): Signal<ResolvedScale> | undefined;
 /** Invocation-scoped lookup for official viz receivers; does not allocate a hook. */

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

@@ -1,21 +1,35 @@
 import { resolveSignalValue } from "@pibbl/core";
 function ticks(scale, props) {
   if (props.tickValues !== void 0 && props.tickCount !== void 0)
-    throw new TypeError("Axis tickValues and tickCount are mutually exclusive.");
+    throw new TypeError(
+      "Axis tickValues and tickCount are mutually exclusive."
+    );
   const explicit = props.tickValues === void 0 ? void 0 : resolveSignalValue(props.tickValues);
   if (explicit !== void 0) {
     if (!Array.isArray(explicit) || explicit.length > 100)
-      throw new RangeError("Axis tickValues must be an array with at most 100 values.");
+      throw new RangeError(
+        "Axis tickValues must be an array with at most 100 values."
+      );
     const seen = /* @__PURE__ */ new Set();
     for (const value of explicit) {
-      if (seen.has(value)) throw new RangeError("Axis tickValues must not contain duplicates.");
+      if (seen.has(value))
+        throw new RangeError("Axis tickValues must not contain duplicates.");
       seen.add(value);
-      if (scale.type !== "band" && scale.type !== "point") {
+      if (scale.type === "trading-time") {
+        if (typeof value !== "number" || scale.slotAtTime(value) === void 0)
+          throw new RangeError(
+            "Axis trading-time ticks must be supplied timestamps."
+          );
+      } else if (scale.type !== "band" && scale.type !== "point") {
         if (typeof value !== "number" || !Number.isFinite(value))
-          throw new TypeError("Axis tickValues for a continuous scale must be finite numbers.");
+          throw new TypeError(
+            "Axis tickValues for a continuous scale must be finite numbers."
+          );
         const [a, b] = scale.domain;
         if (value < Math.min(a, b) || value > Math.max(a, b))
-          throw new RangeError("Axis tickValues must be within the scale domain.");
+          throw new RangeError(
+            "Axis tickValues must be within the scale domain."
+          );
       } else if (typeof value !== "string" && (typeof value !== "number" || !Number.isFinite(value)) || scale.map(value) === void 0) {
         throw new RangeError("Axis tickValues must be known band categories.");
       }
@@ -26,6 +40,7 @@ function ticks(scale, props) {
   if (!Number.isInteger(count) || count < 0 || count > 100)
     throw new RangeError("Axis tickCount must be an integer from 0 to 100.");
   if (count === 0) return [];
+  if (scale.type === "trading-time") return scale.ticks(count);
   if (scale.type !== "band" && scale.type !== "point")
     return count === 1 ? [scale.domain[0]] : scale.ticks(count);
   const n = scale.domain.length;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/viz/lib/scale-ticks.ts"],
-  "sourcesContent": ["import { resolveSignalValue } from \"@pibbl/core\";\nimport type { AxisProps, BandCategory, ResolvedScale } from \"./types.js\";\ntype Tick = number | string;\n\nexport function ticks(scale: ResolvedScale, props: Pick<AxisProps, \"tickValues\" | \"tickCount\">): 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 !== \"band\" && scale.type !== \"point\") {\n        if (typeof value !== \"number\" || !Number.isFinite(value))\n          throw new TypeError(\"Axis tickValues for a continuous 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 !== \"band\" && scale.type !== \"point\")\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\nexport function position(scale: ResolvedScale, value: Tick): number {\n  if (scale.type === \"point\") return scale.map(value as BandCategory)!;\n  return scale.type === \"band\"\n    ? scale.map(value as BandCategory)! + scale.bandwidth / 2\n    : scale.map(value as number);\n}\n\n"],
-  "mappings": "AAAA,SAAS,0BAA0B;AAI5B,SAAS,MAAM,OAAsB,OAAqE;AAC/G,MAAI,MAAM,eAAe,UAAa,MAAM,cAAc;AACxD,UAAM,IAAI,UAAU,uDAAuD;AAC7E,QAAM,WAAW,MAAM,eAAe,SAClC,SACA,mBAAmB,MAAM,UAAU;AACvC,MAAI,aAAa,QAAW;AAC1B,QAAI,CAAC,MAAM,QAAQ,QAAQ,KAAK,SAAS,SAAS;AAChD,YAAM,IAAI,WAAW,2DAA2D;AAClF,UAAM,OAAO,oBAAI,IAAU;AAC3B,eAAW,SAAS,UAAU;AAC5B,UAAI,KAAK,IAAI,KAAK,EAAG,OAAM,IAAI,WAAW,8CAA8C;AACxF,WAAK,IAAI,KAAK;AACd,UAAI,MAAM,SAAS,UAAU,MAAM,SAAS,SAAS;AACnD,YAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK;AACrD,gBAAM,IAAI,UAAU,gEAAgE;AACtF,cAAM,CAAC,GAAG,CAAC,IAAI,MAAM;AACrB,YAAI,QAAQ,KAAK,IAAI,GAAG,CAAC,KAAK,QAAQ,KAAK,IAAI,GAAG,CAAC;AACjD,gBAAM,IAAI,WAAW,kDAAkD;AAAA,MAC3E,WACG,OAAO,UAAU,aACf,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,MACtD,MAAM,IAAI,KAAqB,MAAM,QACrC;AACA,cAAM,IAAI,WAAW,gDAAgD;AAAA,MACvE;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,mBAAmB,MAAM,aAAa,CAAC;AACrD,MAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,KAAK,QAAQ;AACnD,UAAM,IAAI,WAAW,kDAAkD;AACzE,MAAI,UAAU,EAAG,QAAO,CAAC;AACzB,MAAI,MAAM,SAAS,UAAU,MAAM,SAAS;AAC1C,WAAO,UAAU,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC,IAAI,MAAM,MAAM,KAAK;AAC5D,QAAM,IAAI,MAAM,OAAO;AACvB,MAAI,MAAM,EAAG,QAAO,CAAC;AACrB,MAAI,UAAU,EAAG,QAAO,CAAC,MAAM,OAAO,CAAC,CAAC;AACxC,QAAM,IAAI,KAAK,IAAI,OAAO,CAAC;AAC3B,MAAI,MAAM,EAAG,QAAO,CAAC,MAAM,OAAO,CAAC,CAAC;AACpC,SAAO,MAAM;AAAA,IACX,EAAE,QAAQ,EAAE;AAAA,IACZ,CAAC,GAAG,UAAU,MAAM,OAAO,KAAK,MAAO,SAAS,IAAI,MAAO,IAAI,EAAE,CAAC;AAAA,EACpE;AACF;AAEO,SAAS,SAAS,OAAsB,OAAqB;AAClE,MAAI,MAAM,SAAS,QAAS,QAAO,MAAM,IAAI,KAAqB;AAClE,SAAO,MAAM,SAAS,SAClB,MAAM,IAAI,KAAqB,IAAK,MAAM,YAAY,IACtD,MAAM,IAAI,KAAe;AAC/B;",
+  "sourcesContent": ["import { resolveSignalValue } from \"@pibbl/core\";\nimport type { AxisProps, BandCategory, ResolvedScale } from \"./types.js\";\ntype Tick = number | string;\n\nexport function ticks(\n  scale: ResolvedScale,\n  props: Pick<AxisProps, \"tickValues\" | \"tickCount\">,\n): readonly Tick[] {\n  if (props.tickValues !== undefined && props.tickCount !== undefined)\n    throw new TypeError(\n      \"Axis tickValues and tickCount are mutually exclusive.\",\n    );\n  const explicit =\n    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(\n        \"Axis tickValues must be an array with at most 100 values.\",\n      );\n    const seen = new Set<Tick>();\n    for (const value of explicit) {\n      if (seen.has(value))\n        throw new RangeError(\"Axis tickValues must not contain duplicates.\");\n      seen.add(value);\n      if (scale.type === \"trading-time\") {\n        if (typeof value !== \"number\" || scale.slotAtTime(value) === undefined)\n          throw new RangeError(\n            \"Axis trading-time ticks must be supplied timestamps.\",\n          );\n      } else if (scale.type !== \"band\" && scale.type !== \"point\") {\n        if (typeof value !== \"number\" || !Number.isFinite(value))\n          throw new TypeError(\n            \"Axis tickValues for a continuous scale must be finite numbers.\",\n          );\n        const [a, b] = scale.domain;\n        if (value < Math.min(a, b) || value > Math.max(a, b))\n          throw new RangeError(\n            \"Axis tickValues must be within the scale domain.\",\n          );\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 === \"trading-time\") return scale.ticks(count);\n  if (scale.type !== \"band\" && scale.type !== \"point\")\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\nexport function position(scale: ResolvedScale, value: Tick): number {\n  if (scale.type === \"point\") return scale.map(value as BandCategory)!;\n  return scale.type === \"band\"\n    ? scale.map(value as BandCategory)! + scale.bandwidth / 2\n    : scale.map(value as number);\n}\n"],
+  "mappings": "AAAA,SAAS,0BAA0B;AAI5B,SAAS,MACd,OACA,OACiB;AACjB,MAAI,MAAM,eAAe,UAAa,MAAM,cAAc;AACxD,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,QAAM,WACJ,MAAM,eAAe,SACjB,SACA,mBAAmB,MAAM,UAAU;AACzC,MAAI,aAAa,QAAW;AAC1B,QAAI,CAAC,MAAM,QAAQ,QAAQ,KAAK,SAAS,SAAS;AAChD,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AACF,UAAM,OAAO,oBAAI,IAAU;AAC3B,eAAW,SAAS,UAAU;AAC5B,UAAI,KAAK,IAAI,KAAK;AAChB,cAAM,IAAI,WAAW,8CAA8C;AACrE,WAAK,IAAI,KAAK;AACd,UAAI,MAAM,SAAS,gBAAgB;AACjC,YAAI,OAAO,UAAU,YAAY,MAAM,WAAW,KAAK,MAAM;AAC3D,gBAAM,IAAI;AAAA,YACR;AAAA,UACF;AAAA,MACJ,WAAW,MAAM,SAAS,UAAU,MAAM,SAAS,SAAS;AAC1D,YAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK;AACrD,gBAAM,IAAI;AAAA,YACR;AAAA,UACF;AACF,cAAM,CAAC,GAAG,CAAC,IAAI,MAAM;AACrB,YAAI,QAAQ,KAAK,IAAI,GAAG,CAAC,KAAK,QAAQ,KAAK,IAAI,GAAG,CAAC;AACjD,gBAAM,IAAI;AAAA,YACR;AAAA,UACF;AAAA,MACJ,WACG,OAAO,UAAU,aACf,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,MACtD,MAAM,IAAI,KAAqB,MAAM,QACrC;AACA,cAAM,IAAI,WAAW,gDAAgD;AAAA,MACvE;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,mBAAmB,MAAM,aAAa,CAAC;AACrD,MAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,KAAK,QAAQ;AACnD,UAAM,IAAI,WAAW,kDAAkD;AACzE,MAAI,UAAU,EAAG,QAAO,CAAC;AACzB,MAAI,MAAM,SAAS,eAAgB,QAAO,MAAM,MAAM,KAAK;AAC3D,MAAI,MAAM,SAAS,UAAU,MAAM,SAAS;AAC1C,WAAO,UAAU,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC,IAAI,MAAM,MAAM,KAAK;AAC5D,QAAM,IAAI,MAAM,OAAO;AACvB,MAAI,MAAM,EAAG,QAAO,CAAC;AACrB,MAAI,UAAU,EAAG,QAAO,CAAC,MAAM,OAAO,CAAC,CAAC;AACxC,QAAM,IAAI,KAAK,IAAI,OAAO,CAAC;AAC3B,MAAI,MAAM,EAAG,QAAO,CAAC,MAAM,OAAO,CAAC,CAAC;AACpC,SAAO,MAAM;AAAA,IACX,EAAE,QAAQ,EAAE;AAAA,IACZ,CAAC,GAAG,UAAU,MAAM,OAAO,KAAK,MAAO,SAAS,IAAI,MAAO,IAAI,EAAE,CAAC;AAAA,EACpE;AACF;AAEO,SAAS,SAAS,OAAsB,OAAqB;AAClE,MAAI,MAAM,SAAS,QAAS,QAAO,MAAM,IAAI,KAAqB;AAClE,SAAO,MAAM,SAAS,SAClB,MAAM,IAAI,KAAqB,IAAK,MAAM,YAAY,IACtD,MAAM,IAAI,KAAe;AAC/B;",
   "names": []
 }

package/dist/features/viz/lib/sequential-color-scale.d.ts

@@ -0,0 +1,11 @@
+import { type Signal } from "@pibbl/core";
+import type { SequentialColorScaleProps, ResolvedSequentialColorScale } from "./color-types.js";
+import type { ScaleId } from "./types.js";
+/** Provides an allocation-independent sequential color mapping.
+ * @param props - Explicit domain, colors, identity, and children. See {@link SequentialColorScaleProps}.
+ * @returns Descendant content. */
+export declare function SequentialColorScale(props: SequentialColorScaleProps): import("@pibbl/core").PibblNode;
+/** Reads the dedicated ancestor sequential mapping.
+ * @param id - Color-scale identity. See {@link ScaleId}.
+ * @returns Shared readonly mapping signal. See {@link ResolvedSequentialColorScale}. */
+export declare function useSequentialColorScale(id: ScaleId): Signal<ResolvedSequentialColorScale>;

package/dist/features/viz/lib/sequential-color-scale.js

@@ -0,0 +1,49 @@
+import { resolveSignalValue } from "@pibbl/core";
+import { provideColor, useColor } from "./color-context.js";
+import {
+  colorMix,
+  colorPosition,
+  finiteColorValue,
+  hexColor
+} from "./color-math.js";
+function resolve(props) {
+  const input = resolveSignalValue(props.domain), paint = resolveSignalValue(props.colors);
+  if (!Array.isArray(input) || input.length !== 2 || !Array.isArray(paint) || paint.length !== 2)
+    throw new RangeError(
+      "Sequential color scales require two domain endpoints and two colors."
+    );
+  const domain = Object.freeze(
+    Array.from(input, finiteColorValue)
+  ), colors = Object.freeze(Array.from(paint, hexColor));
+  const stops = Object.freeze(
+    domain.map((value, i) => Object.freeze({ value, color: colors[i] }))
+  );
+  return Object.freeze({
+    domain,
+    colors,
+    stops,
+    map(value) {
+      finiteColorValue(value);
+      return colorMix(
+        colors[0],
+        colors[1],
+        colorPosition(value, domain[0], domain[1])
+      );
+    }
+  });
+}
+function SequentialColorScale(props) {
+  provideColor(props.id, "sequential", () => resolve(props), [
+    props.domain,
+    props.colors
+  ]);
+  return props.children;
+}
+function useSequentialColorScale(id) {
+  return useColor(id, "sequential");
+}
+export {
+  SequentialColorScale,
+  useSequentialColorScale
+};
+//# sourceMappingURL=sequential-color-scale.js.map

package/dist/features/viz/lib/sequential-color-scale.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/sequential-color-scale.ts"],
+  "sourcesContent": ["import { resolveSignalValue, type Signal } from \"@pibbl/core\";\nimport type {\n  SequentialColorScaleProps,\n  ResolvedSequentialColorScale,\n} from \"./color-types.js\";\nimport type { ScaleId } from \"./types.js\";\nimport { provideColor, useColor } from \"./color-context.js\";\nimport {\n  colorMix,\n  colorPosition,\n  finiteColorValue,\n  hexColor,\n} from \"./color-math.js\";\nfunction resolve(\n  props: SequentialColorScaleProps,\n): ResolvedSequentialColorScale {\n  const input = resolveSignalValue(props.domain),\n    paint = resolveSignalValue(props.colors);\n  if (\n    !Array.isArray(input) ||\n    input.length !== 2 ||\n    !Array.isArray(paint) ||\n    paint.length !== 2\n  )\n    throw new RangeError(\n      \"Sequential color scales require two domain endpoints and two colors.\",\n    );\n  const domain = Object.freeze(\n      Array.from(input, finiteColorValue),\n    ) as readonly [number, number],\n    colors = Object.freeze(Array.from(paint, hexColor)) as readonly [\n      string,\n      string,\n    ];\n  const stops = Object.freeze(\n    domain.map((value, i) => Object.freeze({ value, color: colors[i] })),\n  );\n  return Object.freeze({\n    domain,\n    colors,\n    stops,\n    map(value: number) {\n      finiteColorValue(value);\n      return colorMix(\n        colors[0],\n        colors[1],\n        colorPosition(value, domain[0], domain[1]),\n      );\n    },\n  });\n}\n/** Provides an allocation-independent sequential color mapping.\n * @param props - Explicit domain, colors, identity, and children. See {@link SequentialColorScaleProps}.\n * @returns Descendant content. */\nexport function SequentialColorScale(props: SequentialColorScaleProps) {\n  provideColor(props.id, \"sequential\", () => resolve(props), [\n    props.domain,\n    props.colors,\n  ]);\n  return props.children;\n}\n/** Reads the dedicated ancestor sequential mapping.\n * @param id - Color-scale identity. See {@link ScaleId}.\n * @returns Shared readonly mapping signal. See {@link ResolvedSequentialColorScale}. */\nexport function useSequentialColorScale(\n  id: ScaleId,\n): Signal<ResolvedSequentialColorScale> {\n  return useColor(id, \"sequential\");\n}\n"],
+  "mappings": "AAAA,SAAS,0BAAuC;AAMhD,SAAS,cAAc,gBAAgB;AACvC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,QACP,OAC8B;AAC9B,QAAM,QAAQ,mBAAmB,MAAM,MAAM,GAC3C,QAAQ,mBAAmB,MAAM,MAAM;AACzC,MACE,CAAC,MAAM,QAAQ,KAAK,KACpB,MAAM,WAAW,KACjB,CAAC,MAAM,QAAQ,KAAK,KACpB,MAAM,WAAW;AAEjB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,QAAM,SAAS,OAAO;AAAA,IAClB,MAAM,KAAK,OAAO,gBAAgB;AAAA,EACpC,GACA,SAAS,OAAO,OAAO,MAAM,KAAK,OAAO,QAAQ,CAAC;AAIpD,QAAM,QAAQ,OAAO;AAAA,IACnB,OAAO,IAAI,CAAC,OAAO,MAAM,OAAO,OAAO,EAAE,OAAO,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC;AAAA,EACrE;AACA,SAAO,OAAO,OAAO;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,IACA,IAAI,OAAe;AACjB,uBAAiB,KAAK;AACtB,aAAO;AAAA,QACL,OAAO,CAAC;AAAA,QACR,OAAO,CAAC;AAAA,QACR,cAAc,OAAO,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AAAA,MAC3C;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAIO,SAAS,qBAAqB,OAAkC;AACrE,eAAa,MAAM,IAAI,cAAc,MAAM,QAAQ,KAAK,GAAG;AAAA,IACzD,MAAM;AAAA,IACN,MAAM;AAAA,EACR,CAAC;AACD,SAAO,MAAM;AACf;AAIO,SAAS,wBACd,IACsC;AACtC,SAAO,SAAS,IAAI,YAAY;AAClC;",
+  "names": []
+}

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

@@ -0,0 +1,12 @@
+import type { ResolvedContinuousScale, ResolvedPointScale, ScaleId, SeriesAccessor, SeriesCoordinate } from "./types.js";
+export type NumericPositionScale = ResolvedContinuousScale | import("./trading-time-scale.js").ResolvedTradingTimeScale;
+type PositionScale = NumericPositionScale | ResolvedPointScale;
+/** Private position receiver; public scale hooks retain their dedicated contracts. */
+export declare function useSeriesPosition(id: ScaleId): PositionScale;
+export declare function seriesAccessor<D>(input: SeriesAccessor<D>): (datum: D, index: number, data: readonly D[]) => SeriesCoordinate;
+export declare function mapSeriesPosition(scale: PositionScale, value: SeriesCoordinate): number | undefined;
+/** Private numeric/trading receiver; public continuous hook stays unchanged. */
+export declare function useNumericPosition(id: ScaleId): NumericPositionScale;
+/** Returns explicit supplied time for trading positions, continuous inverse otherwise. */
+export declare function invertNumericPosition(scale: NumericPositionScale, position: number): number | undefined;
+export {};