@pibbl/core 0.0.1

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

@@ -0,0 +1,146 @@
+import { jsx, jsxs } from "@pibbl/core/jsx-runtime";
+import {
+  Group,
+  Rectangle,
+  definePrimitive,
+  resolveSignalValue,
+  resolveBox,
+  resolveLength
+} from "@pibbl/core";
+import {
+  pushLayoutBox,
+  setCurrentComponentAfterRender
+} from "@pibbl/core/internal";
+import {
+  placeHoverCard
+} from "./hover-placement.js";
+function Content({
+  width,
+  height,
+  children
+}) {
+  const box = { x: 0, y: 0, width, height };
+  const outer = pushLayoutBox(box);
+  let inner;
+  try {
+    inner = pushLayoutBox(box);
+    setCurrentComponentAfterRender(() => {
+      inner();
+      outer();
+    });
+  } catch (error) {
+    inner?.();
+    outer();
+    throw error;
+  }
+  return children;
+}
+const Card = definePrimitive(
+  function renderHoverCard(props, style, context) {
+    context.globalAlpha *= style.opacity;
+    const { borderBox: box, contentBox: content } = style.box;
+    const at = placeHoverCard({
+      anchor: props.anchor,
+      anchorRadius: props.anchorRadius,
+      gap: props.gap,
+      bounds: props.bounds ?? style.bounds,
+      width: box.width,
+      height: box.height,
+      strokeWidth: style.stroke ? style.strokeWidth : 0,
+      placement: props.placement ?? "auto"
+    });
+    return /* @__PURE__ */ jsxs(Group, { style: { translateX: at.x, translateY: at.y }, children: [
+      /* @__PURE__ */ jsx(
+        Rectangle,
+        {
+          pointerEvents: "none",
+          style: {
+            width: box.width,
+            height: box.height,
+            fill: style.fill,
+            stroke: style.stroke,
+            strokeWidth: style.strokeWidth,
+            cornerRadius: style.cornerRadius
+          }
+        }
+      ),
+      /* @__PURE__ */ jsx(Group, { style: { translateX: content.x, translateY: content.y }, children: /* @__PURE__ */ jsx(Content, { width: content.width, height: content.height, children: props.children }) })
+    ] });
+  },
+  {
+    resolveStyle(style, context) {
+      const width = resolveLength(
+        style.width,
+        context.allocation.width,
+        "width"
+      ), height = resolveLength(
+        style.height,
+        context.allocation.height,
+        "height"
+      );
+      if (width === void 0 || height === void 0)
+        throw new TypeError("HoverCard requires declared width and height.");
+      const box = resolveBox(
+        { width, height, padding: style.padding ?? 10 },
+        { minWidth: 0, maxWidth: Infinity, minHeight: 0, maxHeight: Infinity },
+        { 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 (opacity > 1)
+        throw new RangeError("HoverCard opacity must be in [0,1].");
+      return {
+        box,
+        bounds: {
+          x: 0,
+          y: 0,
+          width: context.allocation.width,
+          height: context.allocation.height
+        },
+        fill: style.fill ?? "rgba(255,255,255,0.92)",
+        stroke: style.stroke ?? "rgba(98,117,139,0.35)",
+        strokeWidth,
+        cornerRadius,
+        opacity
+      };
+    }
+  }
+);
+const fields = /* @__PURE__ */ new Set([
+  "width",
+  "height",
+  "padding",
+  "fill",
+  "stroke",
+  "strokeWidth",
+  "cornerRadius",
+  "opacity"
+]);
+function HoverCard(props) {
+  const style = resolveSignalValue(props.style);
+  if (!style || typeof style !== "object")
+    throw new TypeError("HoverCard requires a style with width and height.");
+  for (const field of Object.keys(style))
+    if (!fields.has(field))
+      throw new TypeError(`HoverCard does not support style.${field}.`);
+  return /* @__PURE__ */ jsx(
+    Card,
+    {
+      anchor: resolveSignalValue(props.anchor),
+      anchorRadius: resolveSignalValue(props.anchorRadius ?? 0),
+      gap: resolveSignalValue(props.gap ?? 8),
+      bounds: props.bounds === void 0 ? void 0 : resolveSignalValue(props.bounds),
+      placement: props.placement,
+      style,
+      children: props.children
+    }
+  );
+}
+export {
+  HoverCard
+};
+//# sourceMappingURL=hover-card.js.map

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

@@ -0,0 +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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",
+  "names": []
+}

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

@@ -0,0 +1,12 @@
+import type { PibblNode } from "@pibbl/core";
+import type { HoverDataProps } from "./hover-types.js";
+/**
+ * Evaluates an ordinary synchronous query under the current scale scope.
+ *
+ * @param props - Hover query and child renderer receiving its result. See {@link HoverDataProps}.
+ * @returns Content rendered from the current hover query result. See {@link PibblNode}.
+ *
+ * @see {@link HoverDataProps}
+ * @see {@link PibblNode}
+ */
+export declare function HoverData<T>({ query, children }: HoverDataProps<T>): PibblNode;

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

@@ -0,0 +1,50 @@
+import { withHooksForbidden } from "@pibbl/core/internal";
+import { readScale } from "./scale-context.js";
+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();
+  let active = true;
+  const context = {
+    scale(id) {
+      if (!active)
+        throw new Error(
+          "HoverData query context cannot be retained outside its invocation."
+        );
+      let snapshot = snapshots.get(id);
+      if (!snapshot) {
+        const value = readScale(id, "HoverData");
+        if (!value) throw new TypeError("HoverData requires a scale ID.");
+        const resolved = value.get();
+        if (resolved.type !== "linear")
+          throw new TypeError(
+            "HoverData numeric queries require linear scales."
+          );
+        snapshot = resolved;
+        snapshots.set(id, snapshot);
+      }
+      return snapshot;
+    }
+  };
+  let result;
+  try {
+    result = withHooksForbidden(
+      "Pibbl hooks cannot be called inside a HoverData query.",
+      () => query(context)
+    );
+    if (result != null && (typeof result === "object" || typeof result === "function") && typeof result.then === "function")
+      throw new TypeError(
+        "HoverData query must be synchronous; promises are unsupported."
+      );
+  } finally {
+    active = false;
+  }
+  return withHooksForbidden(
+    "Pibbl hooks cannot be called inside a HoverData render callback; return a component instead.",
+    () => children(result)
+  );
+}
+export {
+  HoverData
+};
+//# sourceMappingURL=hover-data.js.map

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

@@ -0,0 +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 { ResolvedLinearScale, 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, ResolvedLinearScale>();\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 !== \"linear\")\n          throw new TypeError(\n            \"HoverData numeric queries require linear 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,IAAkC;AACxD,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;AACpB,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/hover-placement.d.ts

@@ -0,0 +1,46 @@
+import type { HoverCardProps } from "./hover-card.js";
+import type { PieLayoutProps } from "./pie-types.js";
+import type { HoverPoint } from "./hover-types.js";
+/**
+ * Preferred side of an anchor, or automatic placement within available bounds.
+ *
+ * @see {@link HoverCardProps}
+ */
+export type HoverPlacement = "auto" | "above" | "below" | "right" | "left";
+/**
+ * Logical bounds used to constrain hover-card placement.
+ *
+ * @see {@link HoverCardProps}
+ * @see {@link PieLayoutProps}
+ */
+export interface HoverBounds {
+    /**
+     * Horizontal coordinate or displacement in the containing coordinate system. See
+     * {@link HoverBounds}.
+     */
+    readonly x: number;
+    /**
+     * Vertical coordinate or displacement in the containing coordinate system. See
+     * {@link HoverBounds}.
+     */
+    readonly y: number;
+    /**
+     * Horizontal extent in the units of the containing geometry or surface. See {@link HoverBounds}
+     * .
+     */
+    readonly width: number;
+    /**
+     * Vertical extent in the units of the containing geometry or surface. See {@link HoverBounds}.
+     */
+    readonly height: number;
+}
+export declare function placeHoverCard(input: {
+    anchor: HoverPoint;
+    anchorRadius: number;
+    gap: number;
+    bounds: HoverBounds;
+    width: number;
+    height: number;
+    strokeWidth: number;
+    placement: HoverPlacement;
+}): HoverPoint;

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

@@ -0,0 +1,51 @@
+function placeHoverCard(input) {
+  const {
+    anchor,
+    anchorRadius,
+    gap,
+    bounds,
+    width,
+    height,
+    strokeWidth,
+    placement
+  } = input;
+  for (const [name, value] of Object.entries({
+    x: anchor.x,
+    y: anchor.y,
+    boundsX: bounds.x,
+    boundsY: bounds.y,
+    anchorRadius,
+    gap,
+    width,
+    height,
+    strokeWidth,
+    boundsWidth: bounds.width,
+    boundsHeight: bounds.height
+  })) {
+    if (!Number.isFinite(value) || !["x", "y", "boundsX", "boundsY"].includes(name) && value < 0)
+      throw new RangeError(
+        `HoverCard ${name} must be finite${name.endsWith("X") || name.endsWith("Y") || name === "x" || name === "y" ? "" : " and nonnegative"}.`
+      );
+  }
+  const sides = ["above", "below", "right", "left"];
+  if (placement !== "auto" && !sides.includes(placement))
+    throw new TypeError("HoverCard placement is invalid.");
+  const order = placement === "auto" ? sides : [placement, ...sides.filter((s) => s !== placement)];
+  const half = strokeWidth / 2, clearance = anchorRadius + gap + half;
+  const slide = (value, start, available, size) => Math.max(start + half, Math.min(value, start + available - size - half));
+  const candidates = order.map((side) => {
+    const vertical = side === "above" || side === "below";
+    const x = vertical ? slide(anchor.x - width / 2, bounds.x, bounds.width, width) : side === "right" ? anchor.x + clearance : anchor.x - clearance - width;
+    const y = !vertical ? slide(anchor.y - height / 2, bounds.y, bounds.height, height) : side === "below" ? anchor.y + clearance : anchor.y - clearance - height;
+    if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(x + width + half) || !Number.isFinite(y + height + half))
+      throw new RangeError("HoverCard placement arithmetic must be finite.");
+    return { x, y };
+  });
+  return candidates.find(
+    (p) => p.x - half >= bounds.x && p.y - half >= bounds.y && p.x + width + half <= bounds.x + bounds.width && p.y + height + half <= bounds.y + bounds.height
+  ) ?? candidates[0];
+}
+export {
+  placeHoverCard
+};
+//# sourceMappingURL=hover-placement.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/hover-placement.ts"],
+  "sourcesContent": ["import type { HoverCardProps } from './hover-card.js';\nimport type { PieLayoutProps } from './pie-types.js';\nimport type { HoverPoint } from \"./hover-types.js\";\n/**\n * Preferred side of an anchor, or automatic placement within available bounds.\n *\n * @see {@link HoverCardProps}\n */\nexport type HoverPlacement = \"auto\" | \"above\" | \"below\" | \"right\" | \"left\";\n/**\n * Logical bounds used to constrain hover-card placement.\n *\n * @see {@link HoverCardProps}\n * @see {@link PieLayoutProps}\n */\nexport interface HoverBounds {\n  /**\n   * Horizontal coordinate or displacement in the containing coordinate system. See\n   * {@link HoverBounds}.\n   */\n  readonly x: number;\n  /**\n   * Vertical coordinate or displacement in the containing coordinate system. See\n   * {@link HoverBounds}.\n   */\n  readonly y: number;\n  /**\n   * Horizontal extent in the units of the containing geometry or surface. See {@link HoverBounds}\n   * .\n   */\n  readonly width: number;\n  /**\n   * Vertical extent in the units of the containing geometry or surface. See {@link HoverBounds}.\n   */\n  readonly height: number;\n}\nexport function placeHoverCard(input: {\n  anchor: HoverPoint;\n  anchorRadius: number;\n  gap: number;\n  bounds: HoverBounds;\n  width: number;\n  height: number;\n  strokeWidth: number;\n  placement: HoverPlacement;\n}): HoverPoint {\n  const {\n    anchor,\n    anchorRadius,\n    gap,\n    bounds,\n    width,\n    height,\n    strokeWidth,\n    placement,\n  } = input;\n  for (const [name, value] of Object.entries({\n    x: anchor.x,\n    y: anchor.y,\n    boundsX: bounds.x,\n    boundsY: bounds.y,\n    anchorRadius,\n    gap,\n    width,\n    height,\n    strokeWidth,\n    boundsWidth: bounds.width,\n    boundsHeight: bounds.height,\n  })) {\n    if (\n      !Number.isFinite(value) ||\n      (![\"x\", \"y\", \"boundsX\", \"boundsY\"].includes(name) && value < 0)\n    )\n      throw new RangeError(\n        `HoverCard ${name} must be finite${name.endsWith(\"X\") || name.endsWith(\"Y\") || name === \"x\" || name === \"y\" ? \"\" : \" and nonnegative\"}.`,\n      );\n  }\n  const sides = [\"above\", \"below\", \"right\", \"left\"] as const;\n  if (placement !== \"auto\" && !sides.includes(placement))\n    throw new TypeError(\"HoverCard placement is invalid.\");\n  const order =\n    placement === \"auto\"\n      ? sides\n      : [placement, ...sides.filter((s) => s !== placement)];\n  const half = strokeWidth / 2,\n    clearance = anchorRadius + gap + half;\n  const slide = (\n    value: number,\n    start: number,\n    available: number,\n    size: number,\n  ) => Math.max(start + half, Math.min(value, start + available - size - half));\n  const candidates = order.map((side) => {\n    const vertical = side === \"above\" || side === \"below\";\n    const x = vertical\n      ? slide(anchor.x - width / 2, bounds.x, bounds.width, width)\n      : side === \"right\"\n        ? anchor.x + clearance\n        : anchor.x - clearance - width;\n    const y = !vertical\n      ? slide(anchor.y - height / 2, bounds.y, bounds.height, height)\n      : side === \"below\"\n        ? anchor.y + clearance\n        : anchor.y - clearance - height;\n    if (\n      !Number.isFinite(x) ||\n      !Number.isFinite(y) ||\n      !Number.isFinite(x + width + half) ||\n      !Number.isFinite(y + height + half)\n    )\n      throw new RangeError(\"HoverCard placement arithmetic must be finite.\");\n    return { x, y };\n  });\n  return (\n    candidates.find(\n      (p) =>\n        p.x - half >= bounds.x &&\n        p.y - half >= bounds.y &&\n        p.x + width + half <= bounds.x + bounds.width &&\n        p.y + height + half <= bounds.y + bounds.height,\n    ) ?? candidates[0]\n  );\n}\n"],
+  "mappings": "AAoCO,SAAS,eAAe,OAShB;AACb,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AACJ,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ;AAAA,IACzC,GAAG,OAAO;AAAA,IACV,GAAG,OAAO;AAAA,IACV,SAAS,OAAO;AAAA,IAChB,SAAS,OAAO;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,aAAa,OAAO;AAAA,IACpB,cAAc,OAAO;AAAA,EACvB,CAAC,GAAG;AACF,QACE,CAAC,OAAO,SAAS,KAAK,KACrB,CAAC,CAAC,KAAK,KAAK,WAAW,SAAS,EAAE,SAAS,IAAI,KAAK,QAAQ;AAE7D,YAAM,IAAI;AAAA,QACR,aAAa,IAAI,kBAAkB,KAAK,SAAS,GAAG,KAAK,KAAK,SAAS,GAAG,KAAK,SAAS,OAAO,SAAS,MAAM,KAAK,kBAAkB;AAAA,MACvI;AAAA,EACJ;AACA,QAAM,QAAQ,CAAC,SAAS,SAAS,SAAS,MAAM;AAChD,MAAI,cAAc,UAAU,CAAC,MAAM,SAAS,SAAS;AACnD,UAAM,IAAI,UAAU,iCAAiC;AACvD,QAAM,QACJ,cAAc,SACV,QACA,CAAC,WAAW,GAAG,MAAM,OAAO,CAAC,MAAM,MAAM,SAAS,CAAC;AACzD,QAAM,OAAO,cAAc,GACzB,YAAY,eAAe,MAAM;AACnC,QAAM,QAAQ,CACZ,OACA,OACA,WACA,SACG,KAAK,IAAI,QAAQ,MAAM,KAAK,IAAI,OAAO,QAAQ,YAAY,OAAO,IAAI,CAAC;AAC5E,QAAM,aAAa,MAAM,IAAI,CAAC,SAAS;AACrC,UAAM,WAAW,SAAS,WAAW,SAAS;AAC9C,UAAM,IAAI,WACN,MAAM,OAAO,IAAI,QAAQ,GAAG,OAAO,GAAG,OAAO,OAAO,KAAK,IACzD,SAAS,UACP,OAAO,IAAI,YACX,OAAO,IAAI,YAAY;AAC7B,UAAM,IAAI,CAAC,WACP,MAAM,OAAO,IAAI,SAAS,GAAG,OAAO,GAAG,OAAO,QAAQ,MAAM,IAC5D,SAAS,UACP,OAAO,IAAI,YACX,OAAO,IAAI,YAAY;AAC7B,QACE,CAAC,OAAO,SAAS,CAAC,KAClB,CAAC,OAAO,SAAS,CAAC,KAClB,CAAC,OAAO,SAAS,IAAI,QAAQ,IAAI,KACjC,CAAC,OAAO,SAAS,IAAI,SAAS,IAAI;AAElC,YAAM,IAAI,WAAW,gDAAgD;AACvE,WAAO,EAAE,GAAG,EAAE;AAAA,EAChB,CAAC;AACD,SACE,WAAW;AAAA,IACT,CAAC,MACC,EAAE,IAAI,QAAQ,OAAO,KACrB,EAAE,IAAI,QAAQ,OAAO,KACrB,EAAE,IAAI,QAAQ,QAAQ,OAAO,IAAI,OAAO,SACxC,EAAE,IAAI,SAAS,QAAQ,OAAO,IAAI,OAAO;AAAA,EAC7C,KAAK,WAAW,CAAC;AAErB;",
+  "names": []
+}

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

@@ -0,0 +1,60 @@
+import type { ClosestPointHit, ClosestPointOptions, HoverQuery, HoverSeries, HoverSeriesMap } from "./hover-types.js";
+/**
+ * Creates a data descriptor without observing or copying its dataset.
+ *
+ * @param options - Data, accessors, and scales describing a hoverable series. See
+ * {@link HoverSeries} .
+ * @returns The series descriptor with its datum type preserved. See {@link HoverSeries}.
+ *
+ * @see {@link HoverSeries}
+ */
+export declare function defineSeries<D>(options: HoverSeries<D>): HoverSeries<D>;
+/**
+ * Creates an ordinary query function for the closest mapped recorded point.
+ *
+ * @param options - Series and distance policy for the hover query. See {@link ClosestPointOptions}
+ * .
+ * @returns A query that selects the closest eligible point, or yields undefined when none
+ * qualifies. See {@link HoverQuery} , {@link ClosestPointHit} .
+ *
+ * @see {@link ClosestPointOptions}
+ * @see {@link HoverQuery}
+ * @see {@link ClosestPointHit}
+ * @see {@link HoverSeriesMap}
+ */
+export declare function closestPoint<S extends HoverSeriesMap>(options: ClosestPointOptions<S>): HoverQuery<ClosestPointHit<S>>;
+import type { ClosestXOptions, ClosestXHit, HoverInterpolation, InterpolateXOptions, HoverSample } from "./hover-types.js";
+/**
+ * Selects a recorded observation by domain-x distance, independently of pointer y.
+ *
+ * @param options - Series and horizontal-distance policy. See {@link ClosestXOptions}.
+ * @returns A query selecting the nearest horizontal match, or undefined when none qualifies. See
+ * {@link HoverQuery} , {@link ClosestXHit} .
+ *
+ * @see {@link ClosestXOptions}
+ * @see {@link HoverQuery}
+ * @see {@link ClosestXHit}
+ */
+export declare function closestX<D>(options: ClosestXOptions<D>): HoverQuery<ClosestXHit<D>>;
+/**
+ * Returns a plain data-space linear interpolation function.
+ *
+ * @returns A linear interpolator for values bracketing a sample position. See
+ * {@link HoverInterpolation} .
+ *
+ * @see {@link HoverInterpolation}
+ */
+export declare function linearInterpolation(): HoverInterpolation;
+/**
+ * Samples sorted recorded observations without bridging explicit data gaps.
+ *
+ * @param options - Series, horizontal sampling, and interpolation policy. See
+ * {@link InterpolateXOptions} .
+ * @returns A query producing an interpolated sample, or undefined when sampling is unavailable.
+ * See {@link HoverQuery} , {@link HoverSample} .
+ *
+ * @see {@link InterpolateXOptions}
+ * @see {@link HoverQuery}
+ * @see {@link HoverSample}
+ */
+export declare function interpolateX<D>(options: InterpolateXOptions<D>): HoverQuery<HoverSample<D>>;

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

@@ -0,0 +1,185 @@
+import { resolveSignalValue } from "@pibbl/core";
+import { finiteCoordinate, pointAccessor, pointData } from "./point-data.js";
+function defineSeries(options) {
+  return Object.freeze({ ...options });
+}
+function finite(value, name) {
+  if (!finiteCoordinate(value)) throw new RangeError(`${name} must be finite.`);
+}
+function limit(value, name) {
+  if (value === void 0) return;
+  finite(value, name);
+  if (value < 0) throw new RangeError(`${name} must be nonnegative.`);
+}
+function closestPoint(options) {
+  return (context) => {
+    limit(options.maxDistance, "closestPoint maxDistance");
+    const position = resolveSignalValue(options.position);
+    if (position === null) return void 0;
+    finite(position.x, "closestPoint position.x");
+    finite(position.y, "closestPoint position.y");
+    const xs = context.scale(options.xScale), ys = context.scale(options.yScale);
+    let best, distance = Infinity;
+    for (const key of Object.keys(options.series)) {
+      const series = options.series[key];
+      const data = pointData(resolveSignalValue(series.data), "closestPoint");
+      const x = pointAccessor(series.x), y = pointAccessor(series.y);
+      for (let index = 0; index < data.length; index++) {
+        const datum = data[index];
+        if (series.defined && !series.defined(datum, index, data)) continue;
+        const xv = x(datum, index, data), yv = y(datum, index, data);
+        if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) continue;
+        const anchor = { x: xs.map(xv), y: ys.map(yv) };
+        const next = Math.hypot(anchor.x - position.x, anchor.y - position.y);
+        finite(next, "closestPoint distance");
+        if (next < distance && (options.maxDistance === void 0 || next <= options.maxDistance)) {
+          distance = next;
+          best = {
+            series: key,
+            datum,
+            index,
+            x: xv,
+            y: yv,
+            anchor,
+            distance
+          };
+        }
+      }
+    }
+    return best;
+  };
+}
+function closestX(options) {
+  return (context) => {
+    limit(options.maxDelta, "closestX maxDelta");
+    const query = resolveSignalValue(options.x);
+    if (query === null) return void 0;
+    finite(query, "closestX x");
+    const xs = context.scale(options.xScale), ys = context.scale(options.yScale);
+    const series = options.series, data = pointData(resolveSignalValue(series.data), "closestX");
+    const x = pointAccessor(series.x), y = pointAccessor(series.y);
+    let best, delta = Infinity;
+    for (let index = 0; index < data.length; index++) {
+      const datum = data[index];
+      if (series.defined && !series.defined(datum, index, data)) continue;
+      const xv = x(datum, index, data), yv = y(datum, index, data);
+      if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) continue;
+      const distance = Math.abs(query - xv);
+      finite(distance, "closestX delta");
+      if (distance < delta && (options.maxDelta === void 0 || distance <= options.maxDelta)) {
+        delta = distance;
+        best = {
+          datum,
+          index,
+          x: xv,
+          y: yv,
+          anchor: { x: xs.map(xv), y: ys.map(yv) },
+          delta
+        };
+      }
+    }
+    return best;
+  };
+}
+function linearInterpolation() {
+  return (before, after, fraction) => {
+    finite(before, "linearInterpolation before");
+    finite(after, "linearInterpolation after");
+    finite(fraction, "linearInterpolation fraction");
+    const result = before * (1 - fraction) + after * fraction;
+    finite(result, "linearInterpolation result");
+    return result;
+  };
+}
+function interpolateX(options) {
+  return (context) => {
+    limit(options.maxGap, "interpolateX maxGap");
+    const policy = options.duplicateX ?? "error";
+    if (!["error", "first", "last"].includes(policy))
+      throw new TypeError(
+        "interpolateX duplicateX must be error, first, or last."
+      );
+    if (typeof options.interpolation !== "function")
+      throw new TypeError("interpolateX requires an interpolation function.");
+    const query = resolveSignalValue(options.x);
+    if (query === null) return void 0;
+    finite(query, "interpolateX x");
+    const xs = context.scale(options.xScale), ys = context.scale(options.yScale);
+    const series = options.series, data = pointData(resolveSignalValue(series.data), "interpolateX");
+    const x = pointAccessor(series.x), y = pointAccessor(series.y);
+    const segments = [];
+    let segment = [], previousX = -Infinity;
+    const breakSegment = () => {
+      if (segment.length) segments.push(segment);
+      segment = [];
+    };
+    for (let index = 0; index < data.length; index++) {
+      const datum = data[index];
+      if (series.defined && !series.defined(datum, index, data)) {
+        breakSegment();
+        continue;
+      }
+      const xv = x(datum, index, data), yv = y(datum, index, data);
+      if (finiteCoordinate(xv)) {
+        if (xv < previousX)
+          throw new RangeError(
+            "interpolateX requires nondecreasing source x order."
+          );
+        previousX = xv;
+      }
+      if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) {
+        breakSegment();
+        continue;
+      }
+      const row = { datum, index, x: xv, y: yv }, previous = segment.at(-1);
+      if (previous?.x === xv) {
+        if (policy === "error")
+          throw new RangeError(
+            "interpolateX duplicate x requires an explicit first/last policy."
+          );
+        if (policy === "last") segment[segment.length - 1] = row;
+      } else segment.push(row);
+    }
+    breakSegment();
+    for (const rows of segments) {
+      for (let i = 0; i < rows.length; i++) {
+        const before = rows[i];
+        if (before.x === query)
+          return {
+            kind: "exact",
+            ...before,
+            anchor: { x: xs.map(query), y: ys.map(before.y) }
+          };
+        const after = rows[i + 1];
+        if (!after || query <= before.x || query >= after.x) continue;
+        const span = after.x - before.x, offset = query - before.x;
+        finite(span, "interpolateX interval");
+        finite(offset, "interpolateX offset");
+        if (options.maxGap !== void 0 && span > options.maxGap)
+          return void 0;
+        const fraction = offset / span, value = options.interpolation(before.y, after.y, fraction);
+        finite(value, "interpolateX interpolator result");
+        return {
+          kind: "interpolated",
+          x: query,
+          y: value,
+          before: before.datum,
+          after: after.datum,
+          beforeIndex: before.index,
+          afterIndex: after.index,
+          fraction,
+          anchor: { x: xs.map(query), y: ys.map(value) }
+        };
+      }
+    }
+    return void 0;
+  };
+}
+export {
+  closestPoint,
+  closestX,
+  defineSeries,
+  interpolateX,
+  linearInterpolation
+};
+//# sourceMappingURL=hover-queries.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/hover-queries.ts"],
+  "sourcesContent": ["import { resolveSignalValue } from \"@pibbl/core\";\nimport { finiteCoordinate, pointAccessor, pointData } from \"./point-data.js\";\nimport type {\n  ClosestPointHit,\n  ClosestPointOptions,\n  HoverQuery,\n  HoverSeries,\n  HoverSeriesMap,\n} from \"./hover-types.js\";\n/**\n * Creates a data descriptor without observing or copying its dataset.\n *\n * @param options - Data, accessors, and scales describing a hoverable series. See\n * {@link HoverSeries} .\n * @returns The series descriptor with its datum type preserved. See {@link HoverSeries}.\n *\n * @see {@link HoverSeries}\n */\nexport function defineSeries<D>(options: HoverSeries<D>): HoverSeries<D> {\n  return Object.freeze({ ...options });\n}\nfunction finite(value: unknown, name: string): asserts value is number {\n  if (!finiteCoordinate(value)) throw new RangeError(`${name} must be finite.`);\n}\nfunction limit(value: number | undefined, name: string): void {\n  if (value === undefined) return;\n  finite(value, name);\n  if (value < 0) throw new RangeError(`${name} must be nonnegative.`);\n}\n/**\n * Creates an ordinary query function for the closest mapped recorded point.\n *\n * @param options - Series and distance policy for the hover query. See {@link ClosestPointOptions}\n * .\n * @returns A query that selects the closest eligible point, or yields undefined when none\n * qualifies. See {@link HoverQuery} , {@link ClosestPointHit} .\n *\n * @see {@link ClosestPointOptions}\n * @see {@link HoverQuery}\n * @see {@link ClosestPointHit}\n * @see {@link HoverSeriesMap}\n */\nexport function closestPoint<S extends HoverSeriesMap>(\n  options: ClosestPointOptions<S>,\n): HoverQuery<ClosestPointHit<S>> {\n  return (context) => {\n    limit(options.maxDistance, \"closestPoint maxDistance\");\n    const position = resolveSignalValue(options.position);\n    if (position === null) return undefined;\n    finite(position.x, \"closestPoint position.x\");\n    finite(position.y, \"closestPoint position.y\");\n    const xs = context.scale(options.xScale),\n      ys = context.scale(options.yScale);\n    let best: ClosestPointHit<S> | undefined,\n      distance = Infinity;\n    for (const key of Object.keys(options.series)) {\n      const series = options.series[key];\n      const data = pointData(resolveSignalValue(series.data), \"closestPoint\");\n      const x = pointAccessor(series.x),\n        y = pointAccessor(series.y);\n      for (let index = 0; index < data.length; index++) {\n        const datum = data[index];\n        if (series.defined && !series.defined(datum, index, data)) continue;\n        const xv = x(datum, index, data),\n          yv = y(datum, index, data);\n        if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) continue;\n        const anchor = { x: xs.map(xv), y: ys.map(yv) };\n        const next = Math.hypot(anchor.x - position.x, anchor.y - position.y);\n        finite(next, \"closestPoint distance\");\n        if (\n          next < distance &&\n          (options.maxDistance === undefined || next <= options.maxDistance)\n        ) {\n          distance = next;\n          best = {\n            series: key,\n            datum,\n            index,\n            x: xv,\n            y: yv,\n            anchor,\n            distance,\n          } as ClosestPointHit<S>;\n        }\n      }\n    }\n    return best;\n  };\n}\n\nimport type {\n  ClosestXOptions,\n  ClosestXHit,\n  HoverInterpolation,\n  InterpolateXOptions,\n  HoverSample,\n} from \"./hover-types.js\";\n/**\n * Selects a recorded observation by domain-x distance, independently of pointer y.\n *\n * @param options - Series and horizontal-distance policy. See {@link ClosestXOptions}.\n * @returns A query selecting the nearest horizontal match, or undefined when none qualifies. See\n * {@link HoverQuery} , {@link ClosestXHit} .\n *\n * @see {@link ClosestXOptions}\n * @see {@link HoverQuery}\n * @see {@link ClosestXHit}\n */\nexport function closestX<D>(\n  options: ClosestXOptions<D>,\n): HoverQuery<ClosestXHit<D>> {\n  return (context) => {\n    limit(options.maxDelta, \"closestX maxDelta\");\n    const query = resolveSignalValue(options.x);\n    if (query === null) return undefined;\n    finite(query, \"closestX x\");\n    const xs = context.scale(options.xScale),\n      ys = context.scale(options.yScale);\n    const series = options.series,\n      data = pointData(resolveSignalValue(series.data), \"closestX\");\n    const x = pointAccessor(series.x),\n      y = pointAccessor(series.y);\n    let best: ClosestXHit<D> | undefined,\n      delta = Infinity;\n    for (let index = 0; index < data.length; index++) {\n      const datum = data[index];\n      if (series.defined && !series.defined(datum, index, data)) continue;\n      const xv = x(datum, index, data),\n        yv = y(datum, index, data);\n      if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) continue;\n      const distance = Math.abs(query - xv);\n      finite(distance, \"closestX delta\");\n      if (\n        distance < delta &&\n        (options.maxDelta === undefined || distance <= options.maxDelta)\n      ) {\n        delta = distance;\n        best = {\n          datum,\n          index,\n          x: xv,\n          y: yv,\n          anchor: { x: xs.map(xv), y: ys.map(yv) },\n          delta,\n        };\n      }\n    }\n    return best;\n  };\n}\n/**\n * Returns a plain data-space linear interpolation function.\n *\n * @returns A linear interpolator for values bracketing a sample position. See\n * {@link HoverInterpolation} .\n *\n * @see {@link HoverInterpolation}\n */\nexport function linearInterpolation(): HoverInterpolation {\n  return (before, after, fraction) => {\n    finite(before, \"linearInterpolation before\");\n    finite(after, \"linearInterpolation after\");\n    finite(fraction, \"linearInterpolation fraction\");\n    const result = before * (1 - fraction) + after * fraction;\n    finite(result, \"linearInterpolation result\");\n    return result;\n  };\n}\n/**\n * Samples sorted recorded observations without bridging explicit data gaps.\n *\n * @param options - Series, horizontal sampling, and interpolation policy. See\n * {@link InterpolateXOptions} .\n * @returns A query producing an interpolated sample, or undefined when sampling is unavailable.\n * See {@link HoverQuery} , {@link HoverSample} .\n *\n * @see {@link InterpolateXOptions}\n * @see {@link HoverQuery}\n * @see {@link HoverSample}\n */\nexport function interpolateX<D>(\n  options: InterpolateXOptions<D>,\n): HoverQuery<HoverSample<D>> {\n  return (context) => {\n    limit(options.maxGap, \"interpolateX maxGap\");\n    const policy = options.duplicateX ?? \"error\";\n    if (![\"error\", \"first\", \"last\"].includes(policy))\n      throw new TypeError(\n        \"interpolateX duplicateX must be error, first, or last.\",\n      );\n    if (typeof options.interpolation !== \"function\")\n      throw new TypeError(\"interpolateX requires an interpolation function.\");\n    const query = resolveSignalValue(options.x);\n    if (query === null) return undefined;\n    finite(query, \"interpolateX x\");\n    const xs = context.scale(options.xScale),\n      ys = context.scale(options.yScale);\n    const series = options.series,\n      data = pointData(resolveSignalValue(series.data), \"interpolateX\");\n    const x = pointAccessor(series.x),\n      y = pointAccessor(series.y);\n    type Row = { datum: D; index: number; x: number; y: number };\n    const segments: Row[][] = [];\n    let segment: Row[] = [],\n      previousX = -Infinity;\n    const breakSegment = () => {\n      if (segment.length) segments.push(segment);\n      segment = [];\n    };\n    // Validate the complete source before answering even an exact query.\n    for (let index = 0; index < data.length; index++) {\n      const datum = data[index];\n      if (series.defined && !series.defined(datum, index, data)) {\n        breakSegment();\n        continue;\n      }\n      const xv = x(datum, index, data),\n        yv = y(datum, index, data);\n      if (finiteCoordinate(xv)) {\n        if (xv < previousX)\n          throw new RangeError(\n            \"interpolateX requires nondecreasing source x order.\",\n          );\n        previousX = xv;\n      }\n      if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) {\n        breakSegment();\n        continue;\n      }\n      const row = { datum, index, x: xv, y: yv },\n        previous = segment.at(-1);\n      if (previous?.x === xv) {\n        if (policy === \"error\")\n          throw new RangeError(\n            \"interpolateX duplicate x requires an explicit first/last policy.\",\n          );\n        if (policy === \"last\") segment[segment.length - 1] = row;\n      } else segment.push(row);\n    }\n    breakSegment();\n    for (const rows of segments) {\n      for (let i = 0; i < rows.length; i++) {\n        const before = rows[i];\n        if (before.x === query)\n          return {\n            kind: \"exact\",\n            ...before,\n            anchor: { x: xs.map(query), y: ys.map(before.y) },\n          };\n        const after = rows[i + 1];\n        if (!after || query <= before.x || query >= after.x) continue;\n        const span = after.x - before.x,\n          offset = query - before.x;\n        finite(span, \"interpolateX interval\");\n        finite(offset, \"interpolateX offset\");\n        if (options.maxGap !== undefined && span > options.maxGap)\n          return undefined;\n        const fraction = offset / span,\n          value = options.interpolation(before.y, after.y, fraction);\n        finite(value, \"interpolateX interpolator result\");\n        return {\n          kind: \"interpolated\",\n          x: query,\n          y: value,\n          before: before.datum,\n          after: after.datum,\n          beforeIndex: before.index,\n          afterIndex: after.index,\n          fraction,\n          anchor: { x: xs.map(query), y: ys.map(value) },\n        };\n      }\n    }\n    return undefined;\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}