@pibbl/core 0.0.2 → 0.0.3-alpha.109.1

package/dist/features/viz/lib/hover-card.js

@@ -1,11 +1,11 @@
 import { jsx, jsxs } from "@pibbl/core/jsx-runtime";
+import { resolveScalarSizingLength } from "../../../lib/style/sizing-length.js";
 import {
   Group,
   Rectangle,
   definePrimitive,
   resolveSignalValue,
-  resolveBox,
-  resolveLength
+  resolveBox
 } from "@pibbl/core";
 import {
   pushLayoutBox,
@@ -69,11 +69,11 @@ const Card = definePrimitive(
   },
   {
     resolveStyle(style, context) {
-      const width = resolveLength(
+      const width = resolveScalarSizingLength(
         style.width,
         context.allocation.width,
         "width"
-      ), height = resolveLength(
+      ), height = resolveScalarSizingLength(
         style.height,
         context.allocation.height,
         "height"
@@ -86,11 +86,10 @@ const Card = definePrimitive(
         { component: "HoverCard" }
       );
       const strokeWidth = style.strokeWidth ?? 1, cornerRadius = style.cornerRadius ?? 7, opacity = style.opacity ?? 1;
-      for (const value of [strokeWidth, cornerRadius, opacity])
-        if (!Number.isFinite(value) || value < 0)
-          throw new RangeError(
-            "HoverCard paint dimensions must be finite and nonnegative."
-          );
+      if (!Number.isFinite(strokeWidth) || strokeWidth < 0 || !Number.isFinite(cornerRadius) || cornerRadius < 0 || !Number.isFinite(opacity) || opacity < 0)
+        throw new RangeError(
+          "HoverCard paint dimensions must be finite and nonnegative."
+        );
       if (opacity > 1)
         throw new RangeError("HoverCard opacity must be in [0,1].");
       return {

package/dist/features/viz/lib/hover-card.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/viz/lib/hover-card.tsx"],
-  "sourcesContent": ["import {\n  Group,\n  Rectangle,\n  definePrimitive,\n  resolveSignalValue,\n  resolveBox,\n  resolveLength,\n  type BoxStyle,\n  type PibblNode,\n  type FillStyle,\n  type StrokeStyle,\n  type SignalValue,\n} from \"@pibbl/core\";\nimport {\n  pushLayoutBox,\n  setCurrentComponentAfterRender,\n  type SignalStyle,\n} from \"@pibbl/core/internal\";\nimport type { HoverPoint } from \"./hover-types.js\";\nimport {\n  placeHoverCard,\n  type HoverBounds,\n  type HoverPlacement,\n} from \"./hover-placement.js\";\nexport type { HoverBounds, HoverPlacement } from \"./hover-placement.js\";\n/**\n * Supported geometry and presentation properties for HoverCard.\n *\n * @see {@link BoxStyle}\n * @see {@link FillStyle}\n * @see {@link StrokeStyle}\n * @see {@link HoverCardProps}\n */\nexport interface HoverCardStyle {\n  /** Horizontal extent in the units of the containing geometry or surface. See {@link BoxStyle}. */\n  readonly width: Exclude<BoxStyle[\"width\"], undefined | \"auto\">;\n  /** Vertical extent in the units of the containing geometry or surface. See {@link BoxStyle}. */\n  readonly height: Exclude<BoxStyle[\"height\"], undefined | \"auto\">;\n  /** Insets between the border box and content box. See {@link BoxStyle}. */\n  readonly padding?: BoxStyle[\"padding\"];\n  /** Paint used for the interior. See {@link FillStyle}. */\n  readonly fill?: FillStyle;\n  /** Paint used for the outline. See {@link StrokeStyle}. */\n  readonly stroke?: StrokeStyle;\n  /** Width of the painted outline. See {@link HoverCardStyle}. */\n  readonly strokeWidth?: number;\n  /**\n   * Uniform corner radius used where no per-corner override is supplied. See\n   * {@link HoverCardStyle}.\n   */\n  readonly cornerRadius?: number;\n  /** Opacity of the painted result. See {@link HoverCardStyle}. */\n  readonly opacity?: number;\n  /**\n   * Not accepted in this variant; use the alternative fields instead. See {@link HoverCardStyle}.\n   */\n  readonly filter?: never;\n  /**\n   * Not accepted in this variant; use the alternative fields instead. See {@link HoverCardStyle}.\n   */\n  readonly custom?: never;\n}\n/**\n * Authored inputs for HoverCard, including the declared data and presentation options.\n *\n * @see {@link SignalValue}\n * @see {@link HoverPoint}\n * @see {@link HoverBounds}\n * @see {@link HoverPlacement}\n * @see {@link SignalStyle}\n * @see {@link HoverCardStyle}\n * @see {@link PibblNode}\n * @see {@link HoverCard}\n */\nexport interface HoverCardProps {\n  /**\n   * Logical point to which the content or result is anchored. See {@link SignalValue},\n   * {@link HoverPoint}.\n   */\n  readonly anchor: SignalValue<HoverPoint>;\n  /** Clearance around the anchor before placing the item. See {@link SignalValue}. */\n  readonly anchorRadius?: SignalValue<number>;\n  /** Spacing between adjacent items. See {@link SignalValue}. */\n  readonly gap?: SignalValue<number>;\n  /**\n   * Logical region constraining the content or query. See {@link SignalValue},\n   * {@link HoverBounds}.\n   */\n  readonly bounds?: SignalValue<HoverBounds>;\n  /**\n   * Preferred placement relative to the anchor or containing geometry. See {@link HoverPlacement}\n   * .\n   */\n  readonly placement?: HoverPlacement;\n  /**\n   * Declared presentation and layout properties. See {@link SignalValue}, {@link SignalStyle},\n   * {@link HoverCardStyle}.\n   */\n  readonly style: SignalValue<SignalStyle<HoverCardStyle>>;\n  /** Descendant content or the callback that supplies it. See {@link PibblNode}. */\n  readonly children?: PibblNode;\n}\ntype CardInputs = Omit<\n  HoverCardProps,\n  \"style\" | \"anchor\" | \"anchorRadius\" | \"gap\" | \"bounds\"\n> & {\n  anchor: HoverPoint;\n  anchorRadius: number;\n  gap: number;\n  bounds?: HoverBounds;\n};\ninterface CardResolved {\n  readonly custom?: never;\n  readonly box: ReturnType<typeof resolveBox>;\n  readonly bounds: HoverBounds;\n  readonly fill: FillStyle;\n  readonly stroke: StrokeStyle;\n  readonly strokeWidth: number;\n  readonly cornerRadius: number;\n  readonly opacity: number;\n}\nfunction Content({\n  width,\n  height,\n  children,\n}: {\n  width: number;\n  height: number;\n  children?: PibblNode;\n}) {\n  // Establish both allocation and percentage basis for arbitrary composed nodes;\n  // this is a content box, not a layout parent that requires child dimensions.\n  const box = { x: 0, y: 0, width, height };\n  const outer = pushLayoutBox(box);\n  let inner: (() => void) | undefined;\n  try {\n    inner = pushLayoutBox(box);\n    setCurrentComponentAfterRender(() => {\n      inner!();\n      outer();\n    });\n  } catch (error) {\n    inner?.();\n    outer();\n    throw error;\n  }\n  return children;\n}\nconst Card = definePrimitive<\n  CardInputs,\n  HoverCardStyle,\n  HoverCardStyle,\n  CardResolved\n>(\n  function renderHoverCard(props, style, context) {\n    context.globalAlpha *= style.opacity;\n    const { borderBox: box, contentBox: content } = style.box;\n    const at = placeHoverCard({\n      anchor: props.anchor,\n      anchorRadius: props.anchorRadius,\n      gap: props.gap,\n      bounds: props.bounds ?? style.bounds,\n      width: box.width,\n      height: box.height,\n      strokeWidth: style.stroke ? style.strokeWidth : 0,\n      placement: props.placement ?? \"auto\",\n    });\n    return (\n      <Group style={{ translateX: at.x, translateY: at.y }}>\n        <Rectangle\n          pointerEvents=\"none\"\n          style={{\n            width: box.width,\n            height: box.height,\n            fill: style.fill,\n            stroke: style.stroke,\n            strokeWidth: style.strokeWidth,\n            cornerRadius: style.cornerRadius,\n          }}\n        />\n        <Group style={{ translateX: content.x, translateY: content.y }}>\n          <Content width={content.width} height={content.height}>\n            {props.children}\n          </Content>\n        </Group>\n      </Group>\n    );\n  },\n  {\n    resolveStyle(style, context) {\n      const width = resolveLength(\n          style.width,\n          context.allocation.width,\n          \"width\",\n        ),\n        height = resolveLength(\n          style.height,\n          context.allocation.height,\n          \"height\",\n        );\n      if (width === undefined || height === undefined)\n        throw new TypeError(\"HoverCard requires declared width and height.\");\n      const box = resolveBox(\n        { width, height, padding: style.padding ?? 10 },\n        { minWidth: 0, maxWidth: Infinity, minHeight: 0, maxHeight: Infinity },\n        { component: \"HoverCard\" },\n      );\n      const strokeWidth = style.strokeWidth ?? 1,\n        cornerRadius = style.cornerRadius ?? 7,\n        opacity = style.opacity ?? 1;\n      for (const value of [strokeWidth, cornerRadius, opacity])\n        if (!Number.isFinite(value) || value < 0)\n          throw new RangeError(\n            \"HoverCard paint dimensions must be finite and nonnegative.\",\n          );\n      if (opacity > 1)\n        throw new RangeError(\"HoverCard opacity must be in [0,1].\");\n      return {\n        box,\n        bounds: {\n          x: 0,\n          y: 0,\n          width: context.allocation.width,\n          height: context.allocation.height,\n        },\n        fill: style.fill ?? \"rgba(255,255,255,0.92)\",\n        stroke: style.stroke ?? \"rgba(98,117,139,0.35)\",\n        strokeWidth,\n        cornerRadius,\n        opacity,\n      };\n    },\n  },\n);\nconst fields = new Set([\n  \"width\",\n  \"height\",\n  \"padding\",\n  \"fill\",\n  \"stroke\",\n  \"strokeWidth\",\n  \"cornerRadius\",\n  \"opacity\",\n]);\n/**\n * Positions a declared card outside a protected anchor, allowing overflow if needed.\n *\n * @param props - Anchor, placement, style, and hover-card content. See {@link HoverCardProps}.\n * @returns Pibbl content placed as a hover card. See {@link PibblNode}.\n *\n * @see {@link HoverCardProps}\n * @see {@link PibblNode}\n */\nexport function HoverCard(props: HoverCardProps): PibblNode {\n  const style = resolveSignalValue(props.style);\n  if (!style || typeof style !== \"object\")\n    throw new TypeError(\"HoverCard requires a style with width and height.\");\n  for (const field of Object.keys(style))\n    if (!fields.has(field))\n      throw new TypeError(`HoverCard does not support style.${field}.`);\n  return (\n    <Card\n      anchor={resolveSignalValue(props.anchor)}\n      anchorRadius={resolveSignalValue(props.anchorRadius ?? 0)}\n      gap={resolveSignalValue(props.gap ?? 8)}\n      bounds={\n        props.bounds === undefined\n          ? undefined\n          : resolveSignalValue(props.bounds)\n      }\n      placement={props.placement}\n      style={style}\n    >\n      {props.children}\n    </Card>\n  );\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { resolveScalarSizingLength } from '../../../lib/style/sizing-length.js';\nimport {\n  Group,\n  Rectangle,\n  definePrimitive,\n  resolveSignalValue,\n  resolveBox,\n  type BoxStyle,\n  type PibblNode,\n  type FillStyle,\n  type StrokeStyle,\n  type SignalValue,\n} from \"@pibbl/core\";\nimport {\n  pushLayoutBox,\n  setCurrentComponentAfterRender,\n  type SignalStyle,\n} from \"@pibbl/core/internal\";\nimport type { HoverPoint } from \"./hover-types.js\";\nimport {\n  placeHoverCard,\n  type HoverBounds,\n  type HoverPlacement,\n} from \"./hover-placement.js\";\nexport type { HoverBounds, HoverPlacement } from \"./hover-placement.js\";\n/**\n * Supported geometry and presentation properties for HoverCard.\n *\n * @see {@link BoxStyle}\n * @see {@link FillStyle}\n * @see {@link StrokeStyle}\n * @see {@link HoverCardProps}\n */\nexport interface HoverCardStyle {\n  /** Horizontal extent in the units of the containing geometry or surface. See {@link BoxStyle}. */\n  readonly width: Exclude<BoxStyle[\"width\"], undefined | \"auto\">;\n  /** Vertical extent in the units of the containing geometry or surface. See {@link BoxStyle}. */\n  readonly height: Exclude<BoxStyle[\"height\"], undefined | \"auto\">;\n  /** Insets between the border box and content box. See {@link BoxStyle}. */\n  readonly padding?: BoxStyle[\"padding\"];\n  /** Paint used for the interior. See {@link FillStyle}. */\n  readonly fill?: FillStyle;\n  /** Paint used for the outline. See {@link StrokeStyle}. */\n  readonly stroke?: StrokeStyle;\n  /** Width of the painted outline. See {@link HoverCardStyle}. */\n  readonly strokeWidth?: number;\n  /**\n   * Uniform corner radius used where no per-corner override is supplied. See\n   * {@link HoverCardStyle}.\n   */\n  readonly cornerRadius?: number;\n  /** Opacity of the painted result. See {@link HoverCardStyle}. */\n  readonly opacity?: number;\n  /**\n   * Not accepted in this variant; use the alternative fields instead. See {@link HoverCardStyle}.\n   */\n  readonly filter?: never;\n  /**\n   * Not accepted in this variant; use the alternative fields instead. See {@link HoverCardStyle}.\n   */\n  readonly custom?: never;\n}\n/**\n * Authored inputs for HoverCard, including the declared data and presentation options.\n *\n * @see {@link SignalValue}\n * @see {@link HoverPoint}\n * @see {@link HoverBounds}\n * @see {@link HoverPlacement}\n * @see {@link SignalStyle}\n * @see {@link HoverCardStyle}\n * @see {@link PibblNode}\n * @see {@link HoverCard}\n */\nexport interface HoverCardProps {\n  /**\n   * Logical point to which the content or result is anchored. See {@link SignalValue},\n   * {@link HoverPoint}.\n   */\n  readonly anchor: SignalValue<HoverPoint>;\n  /** Clearance around the anchor before placing the item. See {@link SignalValue}. */\n  readonly anchorRadius?: SignalValue<number>;\n  /** Spacing between adjacent items. See {@link SignalValue}. */\n  readonly gap?: SignalValue<number>;\n  /**\n   * Logical region constraining the content or query. See {@link SignalValue},\n   * {@link HoverBounds}.\n   */\n  readonly bounds?: SignalValue<HoverBounds>;\n  /**\n   * Preferred placement relative to the anchor or containing geometry. See {@link HoverPlacement}\n   * .\n   */\n  readonly placement?: HoverPlacement;\n  /**\n   * Declared presentation and layout properties. See {@link SignalValue}, {@link SignalStyle},\n   * {@link HoverCardStyle}.\n   */\n  readonly style: SignalValue<SignalStyle<HoverCardStyle>>;\n  /** Descendant content or the callback that supplies it. See {@link PibblNode}. */\n  readonly children?: PibblNode;\n}\ntype CardInputs = Omit<\n  HoverCardProps,\n  \"style\" | \"anchor\" | \"anchorRadius\" | \"gap\" | \"bounds\"\n> & {\n  anchor: HoverPoint;\n  anchorRadius: number;\n  gap: number;\n  bounds?: HoverBounds;\n};\ninterface CardResolved {\n  readonly custom?: never;\n  readonly box: ReturnType<typeof resolveBox>;\n  readonly bounds: HoverBounds;\n  readonly fill: FillStyle;\n  readonly stroke: StrokeStyle;\n  readonly strokeWidth: number;\n  readonly cornerRadius: number;\n  readonly opacity: number;\n}\nfunction Content({\n  width,\n  height,\n  children,\n}: {\n  width: number;\n  height: number;\n  children?: PibblNode;\n}) {\n  // Establish both allocation and percentage basis for arbitrary composed nodes;\n  // this is a content box, not a layout parent that requires child dimensions.\n  const box = { x: 0, y: 0, width, height };\n  const outer = pushLayoutBox(box);\n  let inner: (() => void) | undefined;\n  try {\n    inner = pushLayoutBox(box);\n    setCurrentComponentAfterRender(() => {\n      inner!();\n      outer();\n    });\n  } catch (error) {\n    inner?.();\n    outer();\n    throw error;\n  }\n  return children;\n}\nconst Card = definePrimitive<\n  CardInputs,\n  HoverCardStyle,\n  HoverCardStyle,\n  CardResolved\n>(\n  function renderHoverCard(props, style, context) {\n    context.globalAlpha *= style.opacity;\n    const { borderBox: box, contentBox: content } = style.box;\n    const at = placeHoverCard({\n      anchor: props.anchor,\n      anchorRadius: props.anchorRadius,\n      gap: props.gap,\n      bounds: props.bounds ?? style.bounds,\n      width: box.width,\n      height: box.height,\n      strokeWidth: style.stroke ? style.strokeWidth : 0,\n      placement: props.placement ?? \"auto\",\n    });\n    return (\n      <Group style={{ translateX: at.x, translateY: at.y }}>\n        <Rectangle\n          pointerEvents=\"none\"\n          style={{\n            width: box.width,\n            height: box.height,\n            fill: style.fill,\n            stroke: style.stroke,\n            strokeWidth: style.strokeWidth,\n            cornerRadius: style.cornerRadius,\n          }}\n        />\n        <Group style={{ translateX: content.x, translateY: content.y }}>\n          <Content width={content.width} height={content.height}>\n            {props.children}\n          </Content>\n        </Group>\n      </Group>\n    );\n  },\n  {\n    resolveStyle(style, context) {\n      const width = resolveScalarSizingLength(\n          style.width,\n          context.allocation.width,\n          \"width\",\n        ),\n        height = resolveScalarSizingLength(\n          style.height,\n          context.allocation.height,\n          \"height\",\n        );\n      if (width === undefined || height === undefined)\n        throw new TypeError(\"HoverCard requires declared width and height.\");\n      const box = resolveBox(\n        { width, height, padding: style.padding ?? 10 },\n        { minWidth: 0, maxWidth: Infinity, minHeight: 0, maxHeight: Infinity },\n        { component: \"HoverCard\" },\n      );\n      const strokeWidth = style.strokeWidth ?? 1,\n        cornerRadius = style.cornerRadius ?? 7,\n        opacity = style.opacity ?? 1;\n      if (\n        !Number.isFinite(strokeWidth) ||\n        strokeWidth < 0 ||\n        !Number.isFinite(cornerRadius) ||\n        cornerRadius < 0 ||\n        !Number.isFinite(opacity) ||\n        opacity < 0\n      )\n        throw new RangeError(\n            \"HoverCard paint dimensions must be finite and nonnegative.\",\n          );\n      if (opacity > 1)\n        throw new RangeError(\"HoverCard opacity must be in [0,1].\");\n      return {\n        box,\n        bounds: {\n          x: 0,\n          y: 0,\n          width: context.allocation.width,\n          height: context.allocation.height,\n        },\n        fill: style.fill ?? \"rgba(255,255,255,0.92)\",\n        stroke: style.stroke ?? \"rgba(98,117,139,0.35)\",\n        strokeWidth,\n        cornerRadius,\n        opacity,\n      };\n    },\n  },\n);\nconst fields = new Set([\n  \"width\",\n  \"height\",\n  \"padding\",\n  \"fill\",\n  \"stroke\",\n  \"strokeWidth\",\n  \"cornerRadius\",\n  \"opacity\",\n]);\n/**\n * Positions a declared card outside a protected anchor, allowing overflow if needed.\n *\n * @param props - Anchor, placement, style, and hover-card content. See {@link HoverCardProps}.\n * @returns Pibbl content placed as a hover card. See {@link PibblNode}.\n *\n * @see {@link HoverCardProps}\n * @see {@link PibblNode}\n */\nexport function HoverCard(props: HoverCardProps): PibblNode {\n  const style = resolveSignalValue(props.style);\n  if (!style || typeof style !== \"object\")\n    throw new TypeError(\"HoverCard requires a style with width and height.\");\n  for (const field of Object.keys(style))\n    if (!fields.has(field))\n      throw new TypeError(`HoverCard does not support style.${field}.`);\n  return (\n    <Card\n      anchor={resolveSignalValue(props.anchor)}\n      anchorRadius={resolveSignalValue(props.anchorRadius ?? 0)}\n      gap={resolveSignalValue(props.gap ?? 8)}\n      bounds={\n        props.bounds === undefined\n          ? undefined\n          : resolveSignalValue(props.bounds)\n      }\n      placement={props.placement}\n      style={style}\n    >\n      {props.children}\n    </Card>\n  );\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/features/viz/lib/hover-data.d.ts

@@ -9,4 +9,4 @@ import type { HoverDataProps } from "./hover-types.js";
  * @see {@link HoverDataProps}
  * @see {@link PibblNode}
  */
-export declare function HoverData<T>({ query, children }: HoverDataProps<T>): PibblNode;
+export declare function HoverData<T>({ query, children, }: HoverDataProps<T>): PibblNode;

package/dist/features/viz/lib/hover-data.js

@@ -1,6 +1,9 @@
 import { withHooksForbidden } from "@pibbl/core/internal";
 import { readScale } from "./scale-context.js";
-function HoverData({ query, children }) {
+function HoverData({
+  query,
+  children
+}) {
   if (typeof query !== "function" || typeof children !== "function")
     throw new TypeError("HoverData requires query and children functions.");
   const snapshots = /* @__PURE__ */ new Map();
@@ -16,7 +19,7 @@ function HoverData({ query, children }) {
         const value = readScale(id, "HoverData");
         if (!value) throw new TypeError("HoverData requires a scale ID.");
         const resolved = value.get();
-        if (resolved.type === "band" || resolved.type === "point")
+        if (resolved.type === "band" || resolved.type === "point" || resolved.type === "trading-time")
           throw new TypeError(
             "HoverData numeric queries require continuous scales."
           );

package/dist/features/viz/lib/hover-data.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/viz/lib/hover-data.tsx"],
-  "sourcesContent": ["import type { PibblNode } from \"@pibbl/core\";\nimport { withHooksForbidden } from \"@pibbl/core/internal\";\nimport type { HoverDataProps, HoverQueryContext } from \"./hover-types.js\";\nimport type { ResolvedContinuousScale, ScaleId } from \"./types.js\";\nimport { readScale } from \"./scale-context.js\";\n/**\n * Evaluates an ordinary synchronous query under the current scale scope.\n *\n * @param props - Hover query and child renderer receiving its result. See {@link HoverDataProps}.\n * @returns Content rendered from the current hover query result. See {@link PibblNode}.\n *\n * @see {@link HoverDataProps}\n * @see {@link PibblNode}\n */\nexport function HoverData<T>({ query, children }: HoverDataProps<T>): PibblNode {\n  if (typeof query !== \"function\" || typeof children !== \"function\")\n    throw new TypeError(\"HoverData requires query and children functions.\");\n  const snapshots = new Map<ScaleId, ResolvedContinuousScale>();\n  let active = true;\n  const context: HoverQueryContext = {\n    scale(id) {\n      if (!active)\n        throw new Error(\n          \"HoverData query context cannot be retained outside its invocation.\",\n        );\n      let snapshot = snapshots.get(id);\n      if (!snapshot) {\n        const value = readScale(id, \"HoverData\");\n        if (!value) throw new TypeError(\"HoverData requires a scale ID.\");\n        const resolved = value.get();\n        if (resolved.type === \"band\" || resolved.type === \"point\")\n          throw new TypeError(\n            \"HoverData numeric queries require continuous scales.\",\n          );\n        snapshot = resolved;\n        snapshots.set(id, snapshot);\n      }\n      return snapshot;\n    },\n  };\n  let result: T | undefined;\n  try {\n    result = withHooksForbidden(\n      \"Pibbl hooks cannot be called inside a HoverData query.\",\n      () => query(context),\n    );\n    if (\n      result != null &&\n      (typeof result === \"object\" || typeof result === \"function\") &&\n      typeof (result as { then?: unknown }).then === \"function\"\n    )\n      throw new TypeError(\n        \"HoverData query must be synchronous; promises are unsupported.\",\n      );\n  } finally {\n    active = false;\n  }\n  return withHooksForbidden(\n    \"Pibbl hooks cannot be called inside a HoverData render callback; return a component instead.\",\n    () => children(result),\n  );\n}\n"],
-  "mappings": "AACA,SAAS,0BAA0B;AAGnC,SAAS,iBAAiB;AAUnB,SAAS,UAAa,EAAE,OAAO,SAAS,GAAiC;AAC9E,MAAI,OAAO,UAAU,cAAc,OAAO,aAAa;AACrD,UAAM,IAAI,UAAU,kDAAkD;AACxE,QAAM,YAAY,oBAAI,IAAsC;AAC5D,MAAI,SAAS;AACb,QAAM,UAA6B;AAAA,IACjC,MAAM,IAAI;AACR,UAAI,CAAC;AACH,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AACF,UAAI,WAAW,UAAU,IAAI,EAAE;AAC/B,UAAI,CAAC,UAAU;AACb,cAAM,QAAQ,UAAU,IAAI,WAAW;AACvC,YAAI,CAAC,MAAO,OAAM,IAAI,UAAU,gCAAgC;AAChE,cAAM,WAAW,MAAM,IAAI;AAC3B,YAAI,SAAS,SAAS,UAAU,SAAS,SAAS;AAChD,gBAAM,IAAI;AAAA,YACR;AAAA,UACF;AACF,mBAAW;AACX,kBAAU,IAAI,IAAI,QAAQ;AAAA,MAC5B;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACA,MAAI;AACJ,MAAI;AACF,aAAS;AAAA,MACP;AAAA,MACA,MAAM,MAAM,OAAO;AAAA,IACrB;AACA,QACE,UAAU,SACT,OAAO,WAAW,YAAY,OAAO,WAAW,eACjD,OAAQ,OAA8B,SAAS;AAE/C,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,EACJ,UAAE;AACA,aAAS;AAAA,EACX;AACA,SAAO;AAAA,IACL;AAAA,IACA,MAAM,SAAS,MAAM;AAAA,EACvB;AACF;",
+  "sourcesContent": ["import type { PibblNode } from \"@pibbl/core\";\nimport { withHooksForbidden } from \"@pibbl/core/internal\";\nimport type { HoverDataProps, HoverQueryContext } from \"./hover-types.js\";\nimport type { ResolvedContinuousScale, ScaleId } from \"./types.js\";\nimport { readScale } from \"./scale-context.js\";\n/**\n * Evaluates an ordinary synchronous query under the current scale scope.\n *\n * @param props - Hover query and child renderer receiving its result. See {@link HoverDataProps}.\n * @returns Content rendered from the current hover query result. See {@link PibblNode}.\n *\n * @see {@link HoverDataProps}\n * @see {@link PibblNode}\n */\nexport function HoverData<T>({\n  query,\n  children,\n}: HoverDataProps<T>): PibblNode {\n  if (typeof query !== \"function\" || typeof children !== \"function\")\n    throw new TypeError(\"HoverData requires query and children functions.\");\n  const snapshots = new Map<ScaleId, ResolvedContinuousScale>();\n  let active = true;\n  const context: HoverQueryContext = {\n    scale(id) {\n      if (!active)\n        throw new Error(\n          \"HoverData query context cannot be retained outside its invocation.\",\n        );\n      let snapshot = snapshots.get(id);\n      if (!snapshot) {\n        const value = readScale(id, \"HoverData\");\n        if (!value) throw new TypeError(\"HoverData requires a scale ID.\");\n        const resolved = value.get();\n        if (\n          resolved.type === \"band\" ||\n          resolved.type === \"point\" ||\n          resolved.type === \"trading-time\"\n        )\n          throw new TypeError(\n            \"HoverData numeric queries require continuous scales.\",\n          );\n        snapshot = resolved;\n        snapshots.set(id, snapshot);\n      }\n      return snapshot;\n    },\n  };\n  let result: T | undefined;\n  try {\n    result = withHooksForbidden(\n      \"Pibbl hooks cannot be called inside a HoverData query.\",\n      () => query(context),\n    );\n    if (\n      result != null &&\n      (typeof result === \"object\" || typeof result === \"function\") &&\n      typeof (result as { then?: unknown }).then === \"function\"\n    )\n      throw new TypeError(\n        \"HoverData query must be synchronous; promises are unsupported.\",\n      );\n  } finally {\n    active = false;\n  }\n  return withHooksForbidden(\n    \"Pibbl hooks cannot be called inside a HoverData render callback; return a component instead.\",\n    () => children(result),\n  );\n}\n"],
+  "mappings": "AACA,SAAS,0BAA0B;AAGnC,SAAS,iBAAiB;AAUnB,SAAS,UAAa;AAAA,EAC3B;AAAA,EACA;AACF,GAAiC;AAC/B,MAAI,OAAO,UAAU,cAAc,OAAO,aAAa;AACrD,UAAM,IAAI,UAAU,kDAAkD;AACxE,QAAM,YAAY,oBAAI,IAAsC;AAC5D,MAAI,SAAS;AACb,QAAM,UAA6B;AAAA,IACjC,MAAM,IAAI;AACR,UAAI,CAAC;AACH,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AACF,UAAI,WAAW,UAAU,IAAI,EAAE;AAC/B,UAAI,CAAC,UAAU;AACb,cAAM,QAAQ,UAAU,IAAI,WAAW;AACvC,YAAI,CAAC,MAAO,OAAM,IAAI,UAAU,gCAAgC;AAChE,cAAM,WAAW,MAAM,IAAI;AAC3B,YACE,SAAS,SAAS,UAClB,SAAS,SAAS,WAClB,SAAS,SAAS;AAElB,gBAAM,IAAI;AAAA,YACR;AAAA,UACF;AACF,mBAAW;AACX,kBAAU,IAAI,IAAI,QAAQ;AAAA,MAC5B;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACA,MAAI;AACJ,MAAI;AACF,aAAS;AAAA,MACP;AAAA,MACA,MAAM,MAAM,OAAO;AAAA,IACrB;AACA,QACE,UAAU,SACT,OAAO,WAAW,YAAY,OAAO,WAAW,eACjD,OAAQ,OAA8B,SAAS;AAE/C,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,EACJ,UAAE;AACA,aAAS;AAAA,EACX;AACA,SAAO;AAAA,IACL;AAAA,IACA,MAAM,SAAS,MAAM;AAAA,EACvB;AACF;",
   "names": []
 }

package/dist/features/viz/lib/interval-band-series.d.ts

@@ -0,0 +1,49 @@
+import type { Path } from "@pibbl/core";
+import type { PibblEventHandlers, PibblEventParticipationOptions, SignalValue } from "@pibbl/core";
+import type { SignalStyle } from "@pibbl/core/internal";
+import type { AreaSeriesStyle } from "./area-series.js";
+import type { LineAccessor, LineSeriesProps } from "./types.js";
+/**
+ * Authored inputs for {@link IntervalBandSeries}.
+ *
+ * The data, horizontal coordinate, scales, and defined predicate use the same contract as
+ * {@link LineSeriesProps}. Each contiguous run of at least two observations draws its upper
+ * boundary forward and lower boundary backward.
+ *
+ * @see {@link AreaSeriesStyle}
+ * @see {@link LineSeriesProps}
+ */
+export interface IntervalBandSeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /** Application data supplied directly or through a signal. */
+    readonly data: LineSeriesProps<D>["data"];
+    /** Property key or callback extracting the horizontal coordinate. */
+    readonly x: LineAccessor<D>;
+    /** Property key or callback extracting the lower bound. */
+    readonly lower: LineAccessor<D>;
+    /** Property key or callback extracting the upper bound. */
+    readonly upper: LineAccessor<D>;
+    /** Continuous scale used to map horizontal data coordinates. */
+    readonly xScale: LineSeriesProps<D>["xScale"];
+    /** Continuous scale used to map both data bounds. */
+    readonly yScale: LineSeriesProps<D>["yScale"];
+    /** Selects records that participate in a matching-bounds run. */
+    readonly defined?: LineSeriesProps<D>["defined"];
+    /** Curve used to connect successive matching bounds. */
+    readonly curve?: LineSeriesProps<D>["curve"];
+    /** Shared band presentation. Individual datum styling is not supported. */
+    readonly style?: SignalValue<SignalStyle<AreaSeriesStyle>>;
+}
+/**
+ * Draws a filled band between matching lower and upper observations.
+ *
+ * Missing, non-finite, and excluded coordinates split runs. A lower value above its upper
+ * value rejects the datum; equal bounds produce zero-area geometry. The component owns one
+ * ordinary {@link Path} target, so event participation follows standard Path defaults.
+ *
+ * @param props - Data, coordinate accessors, continuous scales, and presentation.
+ * @returns A Pibbl path node containing all drawable interval-band runs.
+ * @throws When data, presentation, or bounds are invalid.
+ *
+ * @see {@link IntervalBandSeriesProps}
+ */
+export declare function IntervalBandSeries<D>({ data: dataInput, x: xInput, lower: lowerInput, upper: upperInput, xScale: xId, yScale: yId, defined, curve, style: styleInput, ...eventProps }: IntervalBandSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;

package/dist/features/viz/lib/interval-band-series.js

@@ -0,0 +1,136 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import { useNumericPosition } from "./series-position.js";
+import { Path, resolveSignalValue } from "@pibbl/core";
+import {
+  useInternalValueMemoSlot,
+  validateTexturePaint
+} from "@pibbl/core/internal";
+import { opacity } from "./paint.js";
+import {
+  appendCurveForward,
+  appendCurveReverse,
+  curveGeometry,
+  resolveSeriesCurve,
+  validatePairedCurveGeometry
+} from "./curve-definition.js";
+import { useContinuousScale } from "./use-continuous-scale.js";
+function accessor(input) {
+  return typeof input === "function" ? input : (datum) => datum[input];
+}
+function fill(value) {
+  if (typeof value === "string" || value instanceof CanvasGradient || value instanceof CanvasPattern)
+    return value;
+  try {
+    validateTexturePaint(value);
+    return value;
+  } catch {
+    throw new TypeError("IntervalBandSeries: invalid fill.");
+  }
+}
+function IntervalBandSeries({
+  data: dataInput,
+  x: xInput,
+  lower: lowerInput,
+  upper: upperInput,
+  xScale: xId,
+  yScale: yId,
+  defined,
+  curve,
+  style: styleInput,
+  ...eventProps
+}) {
+  const xScale = useNumericPosition(xId);
+  const yScale = useContinuousScale(yId).get();
+  const curveDefinition = resolveSeriesCurve(curve);
+  const x = useInternalValueMemoSlot(
+    "vizIntervalBandXAccessor",
+    () => accessor(xInput),
+    [xInput]
+  );
+  const lower = useInternalValueMemoSlot(
+    "vizIntervalBandLowerAccessor",
+    () => accessor(lowerInput),
+    [lowerInput]
+  );
+  const upper = useInternalValueMemoSlot(
+    "vizIntervalBandUpperAccessor",
+    () => accessor(upperInput),
+    [upperInput]
+  );
+  const data = resolveSignalValue(dataInput);
+  if (!Array.isArray(data))
+    throw new TypeError(
+      "IntervalBandSeries data must be an array or a signal containing an array."
+    );
+  const style = resolveSignalValue(styleInput) ?? {};
+  if (style === null || typeof style !== "object" || Array.isArray(style))
+    throw new TypeError("IntervalBandSeries: style must be an object.");
+  const bandFill = fill(resolveSignalValue(style.fill) ?? "#2563eb");
+  const alpha = opacity(
+    resolveSignalValue(style.opacity) ?? 0.2,
+    "IntervalBandSeries"
+  );
+  const cursor = resolveSignalValue(style.cursor);
+  if (cursor !== void 0 && typeof cursor !== "string")
+    throw new TypeError("IntervalBandSeries: cursor must be a string.");
+  const path = new Path2D();
+  let run = [];
+  const closeRun = () => {
+    if (run.length >= 2) {
+      const upper2 = curveGeometry(
+        curveDefinition,
+        run.map(([x2, _lower, value]) => [x2, value])
+      );
+      const lower2 = curveGeometry(
+        curveDefinition,
+        run.map(([x2, value]) => [x2, value])
+      );
+      validatePairedCurveGeometry(upper2, lower2);
+      path.moveTo(upper2.start[0], upper2.start[1]);
+      appendCurveForward(path, upper2);
+      appendCurveReverse(path, lower2);
+      path.closePath();
+    }
+    run = [];
+  };
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    if (defined && !defined(datum, i, data)) {
+      closeRun();
+      continue;
+    }
+    const xv = x(datum, i, data);
+    const lowerValue = lower(datum, i, data);
+    const upperValue = upper(datum, i, data);
+    if (typeof xv !== "number" || typeof lowerValue !== "number" || typeof upperValue !== "number" || !Number.isFinite(xv) || !Number.isFinite(lowerValue) || !Number.isFinite(upperValue)) {
+      closeRun();
+      continue;
+    }
+    if (lowerValue > upperValue)
+      throw new RangeError(
+        `IntervalBandSeries datum at index ${i} has lower bound above upper bound.`
+      );
+    const point = [
+      xScale.map(xv),
+      yScale.map(lowerValue),
+      yScale.map(upperValue)
+    ];
+    if (!point.every(Number.isFinite)) {
+      closeRun();
+      continue;
+    }
+    run.push(point);
+  }
+  closeRun();
+  return /* @__PURE__ */ jsx(
+    Path,
+    {
+      ...eventProps,
+      style: { d: path, fill: bandFill, opacity: alpha, cursor }
+    }
+  );
+}
+export {
+  IntervalBandSeries
+};
+//# sourceMappingURL=interval-band-series.js.map

package/dist/features/viz/lib/interval-band-series.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/interval-band-series.tsx"],
+  "sourcesContent": ["import { useNumericPosition } from \"./series-position.js\";\nimport { Path, resolveSignalValue } from \"@pibbl/core\";\nimport type {\n  FillStyle,\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n  SignalValue,\n} from \"@pibbl/core\";\nimport {\n  useInternalValueMemoSlot,\n  validateTexturePaint,\n} from \"@pibbl/core/internal\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { AreaSeriesStyle } from \"./area-series.js\";\nimport { opacity } from \"./paint.js\";\nimport type { LineAccessor, LineCoordinate, LineSeriesProps } from \"./types.js\";\nimport {\n  appendCurveForward,\n  appendCurveReverse,\n  curveGeometry,\n  resolveSeriesCurve,\n  validatePairedCurveGeometry,\n} from \"./curve-definition.js\";\nimport { useContinuousScale } from \"./use-continuous-scale.js\";\n\n/**\n * Authored inputs for {@link IntervalBandSeries}.\n *\n * The data, horizontal coordinate, scales, and defined predicate use the same contract as\n * {@link LineSeriesProps}. Each contiguous run of at least two observations draws its upper\n * boundary forward and lower boundary backward.\n *\n * @see {@link AreaSeriesStyle}\n * @see {@link LineSeriesProps}\n */\nexport interface IntervalBandSeriesProps<D>\n  extends PibblEventHandlers, PibblEventParticipationOptions {\n  /** Application data supplied directly or through a signal. */\n  readonly data: LineSeriesProps<D>[\"data\"];\n  /** Property key or callback extracting the horizontal coordinate. */\n  readonly x: LineAccessor<D>;\n  /** Property key or callback extracting the lower bound. */\n  readonly lower: LineAccessor<D>;\n  /** Property key or callback extracting the upper bound. */\n  readonly upper: LineAccessor<D>;\n  /** Continuous scale used to map horizontal data coordinates. */\n  readonly xScale: LineSeriesProps<D>[\"xScale\"];\n  /** Continuous scale used to map both data bounds. */\n  readonly yScale: LineSeriesProps<D>[\"yScale\"];\n  /** Selects records that participate in a matching-bounds run. */\n  readonly defined?: LineSeriesProps<D>[\"defined\"];\n  /** Curve used to connect successive matching bounds. */\n  readonly curve?: LineSeriesProps<D>[\"curve\"];\n  /** Shared band presentation. Individual datum styling is not supported. */\n  readonly style?: SignalValue<SignalStyle<AreaSeriesStyle>>;\n}\n\nfunction accessor<D>(\n  input: LineAccessor<D>,\n): (datum: D, index: number, data: readonly D[]) => LineCoordinate {\n  return typeof input === \"function\"\n    ? input\n    : (datum) => datum[input] as LineCoordinate;\n}\n\nfunction fill(value: unknown): FillStyle {\n  if (\n    typeof value === \"string\" ||\n    value instanceof CanvasGradient ||\n    value instanceof CanvasPattern\n  )\n    return value;\n  try {\n    validateTexturePaint(value as never);\n    return value as FillStyle;\n  } catch {\n    throw new TypeError(\"IntervalBandSeries: invalid fill.\");\n  }\n}\n\n/**\n * Draws a filled band between matching lower and upper observations.\n *\n * Missing, non-finite, and excluded coordinates split runs. A lower value above its upper\n * value rejects the datum; equal bounds produce zero-area geometry. The component owns one\n * ordinary {@link Path} target, so event participation follows standard Path defaults.\n *\n * @param props - Data, coordinate accessors, continuous scales, and presentation.\n * @returns A Pibbl path node containing all drawable interval-band runs.\n * @throws When data, presentation, or bounds are invalid.\n *\n * @see {@link IntervalBandSeriesProps}\n */\nexport function IntervalBandSeries<D>({\n  data: dataInput,\n  x: xInput,\n  lower: lowerInput,\n  upper: upperInput,\n  xScale: xId,\n  yScale: yId,\n  defined,\n  curve,\n  style: styleInput,\n  ...eventProps\n}: IntervalBandSeriesProps<D>) {\n  const xScale = useNumericPosition(xId);\n  const yScale = useContinuousScale(yId).get();\n  const curveDefinition = resolveSeriesCurve(curve);\n  const x = useInternalValueMemoSlot(\n    \"vizIntervalBandXAccessor\",\n    () => accessor(xInput),\n    [xInput],\n  );\n  const lower = useInternalValueMemoSlot(\n    \"vizIntervalBandLowerAccessor\",\n    () => accessor(lowerInput),\n    [lowerInput],\n  );\n  const upper = useInternalValueMemoSlot(\n    \"vizIntervalBandUpperAccessor\",\n    () => accessor(upperInput),\n    [upperInput],\n  );\n  const data = resolveSignalValue(dataInput);\n  if (!Array.isArray(data))\n    throw new TypeError(\n      \"IntervalBandSeries data must be an array or a signal containing an array.\",\n    );\n  const style = resolveSignalValue(styleInput) ?? {};\n  if (style === null || typeof style !== \"object\" || Array.isArray(style))\n    throw new TypeError(\"IntervalBandSeries: style must be an object.\");\n  const bandFill = fill(resolveSignalValue(style.fill) ?? \"#2563eb\");\n  const alpha = opacity(\n    resolveSignalValue(style.opacity) ?? 0.2,\n    \"IntervalBandSeries\",\n  );\n  const cursor = resolveSignalValue(style.cursor);\n  if (cursor !== undefined && typeof cursor !== \"string\")\n    throw new TypeError(\"IntervalBandSeries: cursor must be a string.\");\n\n  const path = new Path2D();\n  let run: (readonly [number, number, number])[] = [];\n  const closeRun = () => {\n    if (run.length >= 2) {\n      const upper = curveGeometry(\n        curveDefinition,\n        run.map(([x, _lower, value]) => [x, value] as const),\n      );\n      const lower = curveGeometry(\n        curveDefinition,\n        run.map(([x, value]) => [x, value] as const),\n      );\n      validatePairedCurveGeometry(upper, lower);\n      path.moveTo(upper.start[0], upper.start[1]);\n      appendCurveForward(path, upper);\n      appendCurveReverse(path, lower);\n      path.closePath();\n    }\n    run = [];\n  };\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !defined(datum, i, data)) {\n      closeRun();\n      continue;\n    }\n    const xv = x(datum, i, data);\n    const lowerValue = lower(datum, i, data);\n    const upperValue = upper(datum, i, data);\n    if (\n      typeof xv !== \"number\" ||\n      typeof lowerValue !== \"number\" ||\n      typeof upperValue !== \"number\" ||\n      !Number.isFinite(xv) ||\n      !Number.isFinite(lowerValue) ||\n      !Number.isFinite(upperValue)\n    ) {\n      closeRun();\n      continue;\n    }\n    if (lowerValue > upperValue)\n      throw new RangeError(\n        `IntervalBandSeries datum at index ${i} has lower bound above upper bound.`,\n      );\n    const point = [\n      xScale.map(xv),\n      yScale.map(lowerValue),\n      yScale.map(upperValue),\n    ] as const;\n    if (!point.every(Number.isFinite)) {\n      closeRun();\n      continue;\n    }\n    run.push(point);\n  }\n  closeRun();\n  return (\n    <Path\n      {...eventProps}\n      style={{ d: path, fill: bandFill, opacity: alpha, cursor }}\n    />\n  );\n}\n"],
+  "mappings": "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",
+  "names": ["upper", "x", "lower"]
+}

package/dist/features/viz/lib/interval-diamond-series.d.ts

@@ -0,0 +1,43 @@
+import { type FillStyle, type PibblNode, type SignalValue, type StrokeStyle } from "@pibbl/core";
+import { type SignalStyle } from "@pibbl/core/internal";
+import type { IntervalSeriesProps } from "./interval-series.js";
+/** Local-pixel height and shared paint for supplied summary diamonds.
+ * @see {@link IntervalDiamondSeries}
+ */
+export interface IntervalDiamondSeriesStyle {
+    /** Full perpendicular height in local pixels; defaults to 12. Zero hides marks. */
+    readonly height?: number;
+    /** Diamond interior paint; defaults to #087f8c. */
+    readonly fill?: FillStyle;
+    /** Diamond outline paint; defaults to #087f8c. */
+    readonly stroke?: StrokeStyle;
+    /** Visible outline width in local pixels; defaults to 1.5. */
+    readonly strokeWidth?: number;
+    /** Outline targeting width in local pixels; defaults to strokeWidth. */
+    readonly lineInteractionWidth?: number;
+    /** Shared opacity from zero to one; defaults to 1. */
+    readonly opacity?: number;
+    /** Cursor shown over painted diamonds. */
+    readonly cursor?: string;
+}
+/** Supplied summary estimates and bounds placed horizontally at categorical centers.
+ * @see {@link IntervalSeriesProps}
+ * @see {@link IntervalDiamondSeriesStyle}
+ */
+export interface IntervalDiamondSeriesProps<D> extends Omit<IntervalSeriesProps<D>, "style"> {
+    /** Whole-object and shallow field signals are observed; per-datum styling is not supported. */
+    readonly style?: SignalValue<SignalStyle<IntervalDiamondSeriesStyle>>;
+}
+/**
+ * Draw supplied summary estimates as horizontal diamonds; no pooling or inference.
+ * Left/right tips map lower/upper, top/bottom map the estimate. Estimates must
+ * lie inside the supplied bounds. Missing/nonfinite rows and unknown categories
+ * are omitted; reversed bounds and invalid log values reject included rows.
+ * Diamonds share one ordinary Path target; handlers receive ordinary events.
+ * Mapping does not clamp or clip. Compose a Clip when required.
+ *
+ * @param props - Supplied rows, accessors, categorical/value scales, and shared paint.
+ * @returns One batched Pibbl Path containing the supplied diamonds in source order.
+ * @see {@link IntervalDiamondSeriesProps}
+ */
+export declare function IntervalDiamondSeries<D>(props: IntervalDiamondSeriesProps<D>): PibblNode;

package/dist/features/viz/lib/interval-diamond-series.js

@@ -0,0 +1,122 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import {
+  Path,
+  resolveSignalValue
+} from "@pibbl/core";
+import { withHooksForbidden } from "@pibbl/core/internal";
+import { lookupScale } from "./scale-context.js";
+import { useContinuousScale } from "./use-continuous-scale.js";
+import { finiteCoordinate, pointAccessor, pointData } from "./point-data.js";
+import { opacity, width } from "./paint.js";
+function IntervalDiamondSeries(props) {
+  const receiver = "IntervalDiamondSeries";
+  const {
+    data: input,
+    category: categoryInput,
+    estimate: estimateInput,
+    lower: lowerInput,
+    upper: upperInput,
+    categoryScale,
+    valueScale,
+    defined,
+    style: styleInput,
+    ...events
+  } = props;
+  const categories = lookupScale(categoryScale, receiver)?.get();
+  const values = useContinuousScale(valueScale).get();
+  if (!categories || categories.type !== "point" && categories.type !== "band")
+    throw new TypeError(
+      `${receiver}: categoryScale requires PointScale or BarScale.`
+    );
+  const data = pointData(resolveSignalValue(input), receiver);
+  const category = typeof categoryInput === "function" ? categoryInput : (datum) => datum[categoryInput];
+  const estimate = pointAccessor(estimateInput), lower = pointAccessor(lowerInput), upper = pointAccessor(upperInput);
+  const specified = resolveSignalValue(styleInput) ?? {};
+  if (typeof specified !== "object" || Array.isArray(specified))
+    throw new TypeError(`${receiver}: style must be an object.`);
+  const resolved = {};
+  for (const key of Object.keys(specified)) {
+    if (![
+      "height",
+      "fill",
+      "stroke",
+      "strokeWidth",
+      "lineInteractionWidth",
+      "opacity",
+      "cursor"
+    ].includes(key))
+      throw new TypeError(`${receiver}: unsupported style field ${key}.`);
+    resolved[key] = resolveSignalValue(
+      specified[key]
+    );
+  }
+  const style = resolved;
+  const halfHeight = width(style.height ?? 12, `${receiver} height`) / 2;
+  const strokeWidth = width(style.strokeWidth ?? 1.5, receiver);
+  const lineInteractionWidth = width(
+    style.lineInteractionWidth ?? strokeWidth,
+    receiver
+  );
+  const alpha = opacity(style.opacity ?? 1, receiver);
+  if (style.cursor !== void 0 && typeof style.cursor !== "string")
+    throw new TypeError(`${receiver}: cursor must be a string.`);
+  const path = new Path2D();
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    const row = withHooksForbidden(
+      `${receiver}: accessors cannot call hooks.`,
+      () => {
+        if (defined && !defined(datum, i, data)) return void 0;
+        return {
+          category: category(datum, i, data),
+          estimate: estimate(datum, i, data),
+          lower: lower(datum, i, data),
+          upper: upper(datum, i, data)
+        };
+      }
+    );
+    if (!row || row.category == null || !finiteCoordinate(row.estimate) || !finiteCoordinate(row.lower) || !finiteCoordinate(row.upper))
+      continue;
+    const start = categories.map(row.category);
+    if (start === void 0) continue;
+    if (row.lower > row.upper)
+      throw new RangeError(
+        `${receiver}: lower must not exceed upper (row ${i}).`
+      );
+    if (row.estimate < row.lower || row.estimate > row.upper)
+      throw new RangeError(
+        `${receiver}: estimate must lie inside supplied bounds (row ${i}).`
+      );
+    const center = start + (categories.type === "band" ? categories.bandwidth / 2 : 0);
+    const lo = values.map(row.lower), hi = values.map(row.upper), point = values.map(row.estimate);
+    if (!(Number.isFinite(center - halfHeight) && Number.isFinite(center + halfHeight) && Number.isFinite(lo) && Number.isFinite(hi) && Number.isFinite(point)))
+      throw new RangeError(
+        `${receiver}: mapped coordinates must be finite (row ${i}).`
+      );
+    if (halfHeight === 0) continue;
+    path.moveTo(lo, center);
+    path.lineTo(point, center - halfHeight);
+    path.lineTo(hi, center);
+    path.lineTo(point, center + halfHeight);
+    path.closePath();
+  }
+  return /* @__PURE__ */ jsx(
+    Path,
+    {
+      ...events,
+      style: {
+        d: path,
+        fill: style.fill ?? "#087f8c",
+        stroke: style.stroke ?? "#087f8c",
+        strokeWidth,
+        lineInteractionWidth,
+        opacity: alpha,
+        cursor: style.cursor
+      }
+    }
+  );
+}
+export {
+  IntervalDiamondSeries
+};
+//# sourceMappingURL=interval-diamond-series.js.map

package/dist/features/viz/lib/interval-diamond-series.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/interval-diamond-series.tsx"],
+  "sourcesContent": ["import {\n  Path,\n  resolveSignalValue,\n  type FillStyle,\n  type PibblNode,\n  type SignalValue,\n  type StrokeStyle,\n} from \"@pibbl/core\";\nimport { withHooksForbidden, type SignalStyle } from \"@pibbl/core/internal\";\nimport type { IntervalSeriesProps } from \"./interval-series.js\";\nimport type { BandCategory } from \"./types.js\";\nimport { lookupScale } from \"./scale-context.js\";\nimport { useContinuousScale } from \"./use-continuous-scale.js\";\nimport { finiteCoordinate, pointAccessor, pointData } from \"./point-data.js\";\nimport { opacity, width } from \"./paint.js\";\n\n/** Local-pixel height and shared paint for supplied summary diamonds.\n * @see {@link IntervalDiamondSeries}\n */\nexport interface IntervalDiamondSeriesStyle {\n  /** Full perpendicular height in local pixels; defaults to 12. Zero hides marks. */\n  readonly height?: number;\n  /** Diamond interior paint; defaults to #087f8c. */\n  readonly fill?: FillStyle;\n  /** Diamond outline paint; defaults to #087f8c. */\n  readonly stroke?: StrokeStyle;\n  /** Visible outline width in local pixels; defaults to 1.5. */\n  readonly strokeWidth?: number;\n  /** Outline targeting width in local pixels; defaults to strokeWidth. */\n  readonly lineInteractionWidth?: number;\n  /** Shared opacity from zero to one; defaults to 1. */\n  readonly opacity?: number;\n  /** Cursor shown over painted diamonds. */\n  readonly cursor?: string;\n}\n\n/** Supplied summary estimates and bounds placed horizontally at categorical centers.\n * @see {@link IntervalSeriesProps}\n * @see {@link IntervalDiamondSeriesStyle}\n */\nexport interface IntervalDiamondSeriesProps<D> extends Omit<\n  IntervalSeriesProps<D>,\n  \"style\"\n> {\n  /** Whole-object and shallow field signals are observed; per-datum styling is not supported. */\n  readonly style?: SignalValue<SignalStyle<IntervalDiamondSeriesStyle>>;\n}\n\n/**\n * Draw supplied summary estimates as horizontal diamonds; no pooling or inference.\n * Left/right tips map lower/upper, top/bottom map the estimate. Estimates must\n * lie inside the supplied bounds. Missing/nonfinite rows and unknown categories\n * are omitted; reversed bounds and invalid log values reject included rows.\n * Diamonds share one ordinary Path target; handlers receive ordinary events.\n * Mapping does not clamp or clip. Compose a Clip when required.\n *\n * @param props - Supplied rows, accessors, categorical/value scales, and shared paint.\n * @returns One batched Pibbl Path containing the supplied diamonds in source order.\n * @see {@link IntervalDiamondSeriesProps}\n */\nexport function IntervalDiamondSeries<D>(\n  props: IntervalDiamondSeriesProps<D>,\n): PibblNode {\n  const receiver = \"IntervalDiamondSeries\";\n  const {\n    data: input,\n    category: categoryInput,\n    estimate: estimateInput,\n    lower: lowerInput,\n    upper: upperInput,\n    categoryScale,\n    valueScale,\n    defined,\n    style: styleInput,\n    ...events\n  } = props;\n  const categories = lookupScale(categoryScale, receiver)?.get();\n  const values = useContinuousScale(valueScale).get();\n  if (\n    !categories ||\n    (categories.type !== \"point\" && categories.type !== \"band\")\n  )\n    throw new TypeError(\n      `${receiver}: categoryScale requires PointScale or BarScale.`,\n    );\n  const data = pointData(resolveSignalValue(input), receiver);\n  const category =\n    typeof categoryInput === \"function\"\n      ? categoryInput\n      : (datum: D) => datum[categoryInput] as BandCategory | null | undefined;\n  const estimate = pointAccessor(estimateInput),\n    lower = pointAccessor(lowerInput),\n    upper = pointAccessor(upperInput);\n  const specified = resolveSignalValue(styleInput) ?? {};\n  if (typeof specified !== \"object\" || Array.isArray(specified))\n    throw new TypeError(`${receiver}: style must be an object.`);\n  const resolved: Record<string, unknown> = {};\n  for (const key of Object.keys(specified)) {\n    if (\n      ![\n        \"height\",\n        \"fill\",\n        \"stroke\",\n        \"strokeWidth\",\n        \"lineInteractionWidth\",\n        \"opacity\",\n        \"cursor\",\n      ].includes(key)\n    )\n      throw new TypeError(`${receiver}: unsupported style field ${key}.`);\n    resolved[key] = resolveSignalValue(\n      specified[key as keyof typeof specified],\n    );\n  }\n  const style = resolved as IntervalDiamondSeriesStyle;\n  const halfHeight = width(style.height ?? 12, `${receiver} height`) / 2;\n  const strokeWidth = width(style.strokeWidth ?? 1.5, receiver);\n  const lineInteractionWidth = width(\n    style.lineInteractionWidth ?? strokeWidth,\n    receiver,\n  );\n  const alpha = opacity(style.opacity ?? 1, receiver);\n  if (style.cursor !== undefined && typeof style.cursor !== \"string\")\n    throw new TypeError(`${receiver}: cursor must be a string.`);\n  const path = new Path2D();\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    const row = withHooksForbidden(\n      `${receiver}: accessors cannot call hooks.`,\n      () => {\n        if (defined && !defined(datum, i, data)) return undefined;\n        return {\n          category: category(datum, i, data),\n          estimate: estimate(datum, i, data),\n          lower: lower(datum, i, data),\n          upper: upper(datum, i, data),\n        };\n      },\n    );\n    if (\n      !row ||\n      row.category == null ||\n      !finiteCoordinate(row.estimate) ||\n      !finiteCoordinate(row.lower) ||\n      !finiteCoordinate(row.upper)\n    )\n      continue;\n    const start = categories.map(row.category);\n    if (start === undefined) continue;\n    if (row.lower > row.upper)\n      throw new RangeError(\n        `${receiver}: lower must not exceed upper (row ${i}).`,\n      );\n    if (row.estimate < row.lower || row.estimate > row.upper)\n      throw new RangeError(\n        `${receiver}: estimate must lie inside supplied bounds (row ${i}).`,\n      );\n    const center =\n      start + (categories.type === \"band\" ? categories.bandwidth / 2 : 0);\n    const lo = values.map(row.lower),\n      hi = values.map(row.upper),\n      point = values.map(row.estimate);\n    if (!(\n      Number.isFinite(center - halfHeight) &&\n      Number.isFinite(center + halfHeight) &&\n      Number.isFinite(lo) &&\n      Number.isFinite(hi) &&\n      Number.isFinite(point)\n    ))\n      throw new RangeError(\n        `${receiver}: mapped coordinates must be finite (row ${i}).`,\n      );\n    if (halfHeight === 0) continue;\n    path.moveTo(lo, center);\n    path.lineTo(point, center - halfHeight);\n    path.lineTo(hi, center);\n    path.lineTo(point, center + halfHeight);\n    path.closePath();\n  }\n  return (\n    <Path\n      {...events}\n      style={{\n        d: path,\n        fill: style.fill ?? \"#087f8c\",\n        stroke: style.stroke ?? \"#087f8c\",\n        strokeWidth,\n        lineInteractionWidth,\n        opacity: alpha,\n        cursor: style.cursor,\n      }}\n    />\n  );\n}\n"],
+  "mappings": "AAoLI;AApLJ;AAAA,EACE;AAAA,EACA;AAAA,OAKK;AACP,SAAS,0BAA4C;AAGrD,SAAS,mBAAmB;AAC5B,SAAS,0BAA0B;AACnC,SAAS,kBAAkB,eAAe,iBAAiB;AAC3D,SAAS,SAAS,aAAa;AA8CxB,SAAS,sBACd,OACW;AACX,QAAM,WAAW;AACjB,QAAM;AAAA,IACJ,MAAM;AAAA,IACN,UAAU;AAAA,IACV,UAAU;AAAA,IACV,OAAO;AAAA,IACP,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO;AAAA,IACP,GAAG;AAAA,EACL,IAAI;AACJ,QAAM,aAAa,YAAY,eAAe,QAAQ,GAAG,IAAI;AAC7D,QAAM,SAAS,mBAAmB,UAAU,EAAE,IAAI;AAClD,MACE,CAAC,cACA,WAAW,SAAS,WAAW,WAAW,SAAS;AAEpD,UAAM,IAAI;AAAA,MACR,GAAG,QAAQ;AAAA,IACb;AACF,QAAM,OAAO,UAAU,mBAAmB,KAAK,GAAG,QAAQ;AAC1D,QAAM,WACJ,OAAO,kBAAkB,aACrB,gBACA,CAAC,UAAa,MAAM,aAAa;AACvC,QAAM,WAAW,cAAc,aAAa,GAC1C,QAAQ,cAAc,UAAU,GAChC,QAAQ,cAAc,UAAU;AAClC,QAAM,YAAY,mBAAmB,UAAU,KAAK,CAAC;AACrD,MAAI,OAAO,cAAc,YAAY,MAAM,QAAQ,SAAS;AAC1D,UAAM,IAAI,UAAU,GAAG,QAAQ,4BAA4B;AAC7D,QAAM,WAAoC,CAAC;AAC3C,aAAW,OAAO,OAAO,KAAK,SAAS,GAAG;AACxC,QACE,CAAC;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,SAAS,GAAG;AAEd,YAAM,IAAI,UAAU,GAAG,QAAQ,6BAA6B,GAAG,GAAG;AACpE,aAAS,GAAG,IAAI;AAAA,MACd,UAAU,GAA6B;AAAA,IACzC;AAAA,EACF;AACA,QAAM,QAAQ;AACd,QAAM,aAAa,MAAM,MAAM,UAAU,IAAI,GAAG,QAAQ,SAAS,IAAI;AACrE,QAAM,cAAc,MAAM,MAAM,eAAe,KAAK,QAAQ;AAC5D,QAAM,uBAAuB;AAAA,IAC3B,MAAM,wBAAwB;AAAA,IAC9B;AAAA,EACF;AACA,QAAM,QAAQ,QAAQ,MAAM,WAAW,GAAG,QAAQ;AAClD,MAAI,MAAM,WAAW,UAAa,OAAO,MAAM,WAAW;AACxD,UAAM,IAAI,UAAU,GAAG,QAAQ,4BAA4B;AAC7D,QAAM,OAAO,IAAI,OAAO;AACxB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,QAAQ,KAAK,CAAC;AACpB,UAAM,MAAM;AAAA,MACV,GAAG,QAAQ;AAAA,MACX,MAAM;AACJ,YAAI,WAAW,CAAC,QAAQ,OAAO,GAAG,IAAI,EAAG,QAAO;AAChD,eAAO;AAAA,UACL,UAAU,SAAS,OAAO,GAAG,IAAI;AAAA,UACjC,UAAU,SAAS,OAAO,GAAG,IAAI;AAAA,UACjC,OAAO,MAAM,OAAO,GAAG,IAAI;AAAA,UAC3B,OAAO,MAAM,OAAO,GAAG,IAAI;AAAA,QAC7B;AAAA,MACF;AAAA,IACF;AACA,QACE,CAAC,OACD,IAAI,YAAY,QAChB,CAAC,iBAAiB,IAAI,QAAQ,KAC9B,CAAC,iBAAiB,IAAI,KAAK,KAC3B,CAAC,iBAAiB,IAAI,KAAK;AAE3B;AACF,UAAM,QAAQ,WAAW,IAAI,IAAI,QAAQ;AACzC,QAAI,UAAU,OAAW;AACzB,QAAI,IAAI,QAAQ,IAAI;AAClB,YAAM,IAAI;AAAA,QACR,GAAG,QAAQ,sCAAsC,CAAC;AAAA,MACpD;AACF,QAAI,IAAI,WAAW,IAAI,SAAS,IAAI,WAAW,IAAI;AACjD,YAAM,IAAI;AAAA,QACR,GAAG,QAAQ,mDAAmD,CAAC;AAAA,MACjE;AACF,UAAM,SACJ,SAAS,WAAW,SAAS,SAAS,WAAW,YAAY,IAAI;AACnE,UAAM,KAAK,OAAO,IAAI,IAAI,KAAK,GAC7B,KAAK,OAAO,IAAI,IAAI,KAAK,GACzB,QAAQ,OAAO,IAAI,IAAI,QAAQ;AACjC,QAAI,EACF,OAAO,SAAS,SAAS,UAAU,KACnC,OAAO,SAAS,SAAS,UAAU,KACnC,OAAO,SAAS,EAAE,KAClB,OAAO,SAAS,EAAE,KAClB,OAAO,SAAS,KAAK;AAErB,YAAM,IAAI;AAAA,QACR,GAAG,QAAQ,4CAA4C,CAAC;AAAA,MAC1D;AACF,QAAI,eAAe,EAAG;AACtB,SAAK,OAAO,IAAI,MAAM;AACtB,SAAK,OAAO,OAAO,SAAS,UAAU;AACtC,SAAK,OAAO,IAAI,MAAM;AACtB,SAAK,OAAO,OAAO,SAAS,UAAU;AACtC,SAAK,UAAU;AAAA,EACjB;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,OAAO;AAAA,QACL,GAAG;AAAA,QACH,MAAM,MAAM,QAAQ;AAAA,QACpB,QAAQ,MAAM,UAAU;AAAA,QACxB;AAAA,QACA;AAAA,QACA,SAAS;AAAA,QACT,QAAQ,MAAM;AAAA,MAChB;AAAA;AAAA,EACF;AAEJ;",
+  "names": []
+}