@pibbl/core 0.0.1

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/band-scale.ts"],
+  "sourcesContent": ["import type {\n  BandCategory,\n  BandDomain,\n  ResolvedBandScale,\n  ScaleRange,\n} from \"./types.js\";\nimport { resolveLinearScale } from \"./linear-scale.js\";\n\n/** Explicit category order; padding is measured in step units. */\nexport function resolveBandScale(\n  input: BandDomain,\n  rangeInput: ScaleRange,\n  reverse: boolean,\n  width: number,\n  height: number,\n  paddingInner: number,\n  paddingOuter: number,\n): ResolvedBandScale {\n  if (!Array.isArray(input))\n    throw new TypeError(\"Band scale domain must be an array.\");\n  const indices = new Map<BandCategory, number>();\n  for (const category of input) {\n    if (\n      typeof category !== \"string\" &&\n      (typeof category !== \"number\" || !Number.isFinite(category))\n    )\n      throw new TypeError(\n        \"Band scale categories must be strings or finite numbers.\",\n      );\n    if (indices.has(category))\n      throw new TypeError(\n        `Band scale duplicate category: ${String(category)}.`,\n      );\n    indices.set(category, indices.size);\n  }\n  if (!Number.isFinite(paddingInner) || paddingInner < 0 || paddingInner > 1)\n    throw new RangeError(\"Band scale paddingInner must be between 0 and 1.\");\n  if (!Number.isFinite(paddingOuter) || paddingOuter < 0)\n    throw new RangeError(\n      \"Band scale paddingOuter must be finite and nonnegative.\",\n    );\n  const { range, frame } = resolveLinearScale(\n    [0, 1],\n    rangeInput,\n    reverse,\n    width,\n    height,\n  );\n  const count = input.length;\n  const span = Math.abs(range[1] - range[0]);\n  const denominator = Math.max(1, count - paddingInner + 2 * paddingOuter);\n  if (!Number.isFinite(denominator))\n    throw new RangeError(\"Band scale padding arithmetic must be finite.\");\n  const step = count === 0 ? 0 : span / denominator;\n  const bandwidth = step * (1 - paddingInner);\n  const offset = (span - step * (count - paddingInner)) / 2;\n  const start = Math.min(...range) + offset;\n  const domain = Object.freeze([...input]);\n  return Object.freeze({\n    type: \"band\",\n    domain,\n    range,\n    frame,\n    bandwidth,\n    step,\n    map(value: BandCategory) {\n      const index = indices.get(value);\n      if (index === undefined) return undefined;\n      return start + (range[1] < range[0] ? count - 1 - index : index) * step;\n    },\n  });\n}\n"],
+  "mappings": "AAMA,SAAS,0BAA0B;AAG5B,SAAS,iBACd,OACA,YACA,SACA,OACA,QACA,cACA,cACmB;AACnB,MAAI,CAAC,MAAM,QAAQ,KAAK;AACtB,UAAM,IAAI,UAAU,qCAAqC;AAC3D,QAAM,UAAU,oBAAI,IAA0B;AAC9C,aAAW,YAAY,OAAO;AAC5B,QACE,OAAO,aAAa,aACnB,OAAO,aAAa,YAAY,CAAC,OAAO,SAAS,QAAQ;AAE1D,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AACF,QAAI,QAAQ,IAAI,QAAQ;AACtB,YAAM,IAAI;AAAA,QACR,kCAAkC,OAAO,QAAQ,CAAC;AAAA,MACpD;AACF,YAAQ,IAAI,UAAU,QAAQ,IAAI;AAAA,EACpC;AACA,MAAI,CAAC,OAAO,SAAS,YAAY,KAAK,eAAe,KAAK,eAAe;AACvE,UAAM,IAAI,WAAW,kDAAkD;AACzE,MAAI,CAAC,OAAO,SAAS,YAAY,KAAK,eAAe;AACnD,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,QAAM,EAAE,OAAO,MAAM,IAAI;AAAA,IACvB,CAAC,GAAG,CAAC;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,QAAM,QAAQ,MAAM;AACpB,QAAM,OAAO,KAAK,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC;AACzC,QAAM,cAAc,KAAK,IAAI,GAAG,QAAQ,eAAe,IAAI,YAAY;AACvE,MAAI,CAAC,OAAO,SAAS,WAAW;AAC9B,UAAM,IAAI,WAAW,+CAA+C;AACtE,QAAM,OAAO,UAAU,IAAI,IAAI,OAAO;AACtC,QAAM,YAAY,QAAQ,IAAI;AAC9B,QAAM,UAAU,OAAO,QAAQ,QAAQ,iBAAiB;AACxD,QAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI;AACnC,QAAM,SAAS,OAAO,OAAO,CAAC,GAAG,KAAK,CAAC;AACvC,SAAO,OAAO,OAAO;AAAA,IACnB,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,IAAI,OAAqB;AACvB,YAAM,QAAQ,QAAQ,IAAI,KAAK;AAC/B,UAAI,UAAU,OAAW,QAAO;AAChC,aAAO,SAAS,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,QAAQ,IAAI,QAAQ,SAAS;AAAA,IACrE;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}

package/dist/features/viz/lib/bar-fill.d.ts

@@ -0,0 +1,16 @@
+import type { BarSeriesStyle } from "./bar-series.js";
+import type { FillStyle } from "@pibbl/core";
+/**
+ * Domain thresholds divide the bar fill into sharp, ordered color intervals.
+ *
+ * @see {@link BarSeriesStyle}
+ */
+export interface BarThresholdFill {
+    /** The literal "threshold" identifying this variant. See {@link BarThresholdFill}. */
+    readonly type: "threshold";
+    /** Ordered numeric boundaries separating fill-color intervals. See {@link BarThresholdFill}. */
+    readonly thresholds: readonly number[];
+    /** Colors assigned to successive threshold intervals. See {@link BarThresholdFill}. */
+    readonly colors: readonly string[];
+}
+export declare function barFill(ctx: Pick<CanvasRenderingContext2D, "createLinearGradient">, fill: FillStyle | BarThresholdFill, map: (value: number) => number, orientation: "vertical" | "horizontal"): (start: number, end: number) => FillStyle;

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

@@ -0,0 +1,53 @@
+function barFill(ctx, fill, map, orientation) {
+  if (typeof fill === "string" || fill instanceof CanvasGradient || fill instanceof CanvasPattern)
+    return () => fill;
+  if (fill && !("type" in fill)) return () => fill;
+  if (!fill || fill.type !== "threshold")
+    throw new TypeError("BarSeries fill must be a paint or a threshold fill.");
+  const { thresholds, colors } = fill;
+  if (!Array.isArray(thresholds) || !Array.isArray(colors) || colors.length !== thresholds.length + 1)
+    throw new TypeError(
+      "BarSeries threshold fill requires one more color than thresholds."
+    );
+  for (let i = 0; i < thresholds.length; i++) {
+    if (typeof thresholds[i] !== "number" || !Number.isFinite(thresholds[i]) || i > 0 && thresholds[i] <= thresholds[i - 1])
+      throw new RangeError(
+        "BarSeries fill thresholds must be finite and strictly increasing."
+      );
+  }
+  const validation = ctx.createLinearGradient(0, 0, 0, 1);
+  for (const color of colors) {
+    if (typeof color !== "string")
+      throw new TypeError(
+        "BarSeries threshold colors must be CSS color strings."
+      );
+    validation.addColorStop(0, color);
+  }
+  return (start, end) => {
+    const low = Math.min(start, end), high = Math.max(start, end);
+    let index = 0;
+    while (index < thresholds.length && thresholds[index] <= low) index++;
+    const valueStart = map(low), valueEnd = map(high);
+    if (valueStart === valueEnd) return colors[index];
+    const origin = Math.min(valueStart, valueEnd);
+    const gradient = orientation === "vertical" ? ctx.createLinearGradient(0, valueStart - origin, 0, valueEnd - origin) : ctx.createLinearGradient(valueStart - origin, 0, valueEnd - origin, 0);
+    gradient.addColorStop(0, colors[index]);
+    for (; index < thresholds.length && thresholds[index] < high; index++) {
+      const offset = Math.max(
+        0,
+        Math.min(
+          1,
+          (map(thresholds[index]) - valueStart) / (valueEnd - valueStart)
+        )
+      );
+      gradient.addColorStop(offset, colors[index]);
+      gradient.addColorStop(offset, colors[index + 1]);
+    }
+    gradient.addColorStop(1, colors[index]);
+    return gradient;
+  };
+}
+export {
+  barFill
+};
+//# sourceMappingURL=bar-fill.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/bar-fill.ts"],
+  "sourcesContent": ["import type { BarSeriesStyle } from './bar-series.js';\nimport type { FillStyle } from \"@pibbl/core\";\n\n/**\n * Domain thresholds divide the bar fill into sharp, ordered color intervals.\n *\n * @see {@link BarSeriesStyle}\n */\nexport interface BarThresholdFill {\n  /** The literal \"threshold\" identifying this variant. See {@link BarThresholdFill}. */\n  readonly type: \"threshold\";\n  /** Ordered numeric boundaries separating fill-color intervals. See {@link BarThresholdFill}. */\n  readonly thresholds: readonly number[];\n  /** Colors assigned to successive threshold intervals. See {@link BarThresholdFill}. */\n  readonly colors: readonly string[];\n}\n\nexport function barFill(\n  ctx: Pick<CanvasRenderingContext2D, \"createLinearGradient\">,\n  fill: FillStyle | BarThresholdFill,\n  map: (value: number) => number,\n  orientation: \"vertical\" | \"horizontal\",\n): (start: number, end: number) => FillStyle {\n  if (\n    typeof fill === \"string\" ||\n    fill instanceof CanvasGradient ||\n    fill instanceof CanvasPattern\n  )\n    return () => fill;\n  if (fill && !(\"type\" in fill)) return () => fill;\n  if (!fill || fill.type !== \"threshold\")\n    throw new TypeError(\"BarSeries fill must be a paint or a threshold fill.\");\n  const { thresholds, colors } = fill;\n  if (\n    !Array.isArray(thresholds) ||\n    !Array.isArray(colors) ||\n    colors.length !== thresholds.length + 1\n  )\n    throw new TypeError(\n      \"BarSeries threshold fill requires one more color than thresholds.\",\n    );\n  for (let i = 0; i < thresholds.length; i++) {\n    if (\n      typeof thresholds[i] !== \"number\" ||\n      !Number.isFinite(thresholds[i]) ||\n      (i > 0 && thresholds[i] <= thresholds[i - 1])\n    )\n      throw new RangeError(\n        \"BarSeries fill thresholds must be finite and strictly increasing.\",\n      );\n  }\n  // Validate even colors whose intervals are not present in the current data.\n  const validation = ctx.createLinearGradient(0, 0, 0, 1);\n  for (const color of colors) {\n    if (typeof color !== \"string\")\n      throw new TypeError(\n        \"BarSeries threshold colors must be CSS color strings.\",\n      );\n    validation.addColorStop(0, color);\n  }\n  return (start, end) => {\n    const low = Math.min(start, end),\n      high = Math.max(start, end);\n    let index = 0;\n    while (index < thresholds.length && thresholds[index] <= low) index++;\n    const valueStart = map(low),\n      valueEnd = map(high);\n    if (valueStart === valueEnd) return colors[index];\n    // Rectangle placement translates its local paint coordinates.\n    const origin = Math.min(valueStart, valueEnd);\n    const gradient = orientation === \"vertical\"\n      ? ctx.createLinearGradient(0, valueStart - origin, 0, valueEnd - origin)\n      : ctx.createLinearGradient(valueStart - origin, 0, valueEnd - origin, 0);\n    gradient.addColorStop(0, colors[index]);\n    for (; index < thresholds.length && thresholds[index] < high; index++) {\n      const offset = Math.max(\n        0,\n        Math.min(\n          1,\n          (map(thresholds[index]) - valueStart) / (valueEnd - valueStart),\n        ),\n      );\n      gradient.addColorStop(offset, colors[index]);\n      gradient.addColorStop(offset, colors[index + 1]);\n    }\n    gradient.addColorStop(1, colors[index]);\n    return gradient;\n  };\n}\n"],
+  "mappings": "AAiBO,SAAS,QACd,KACA,MACA,KACA,aAC2C;AAC3C,MACE,OAAO,SAAS,YAChB,gBAAgB,kBAChB,gBAAgB;AAEhB,WAAO,MAAM;AACf,MAAI,QAAQ,EAAE,UAAU,MAAO,QAAO,MAAM;AAC5C,MAAI,CAAC,QAAQ,KAAK,SAAS;AACzB,UAAM,IAAI,UAAU,qDAAqD;AAC3E,QAAM,EAAE,YAAY,OAAO,IAAI;AAC/B,MACE,CAAC,MAAM,QAAQ,UAAU,KACzB,CAAC,MAAM,QAAQ,MAAM,KACrB,OAAO,WAAW,WAAW,SAAS;AAEtC,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,WAAS,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;AAC1C,QACE,OAAO,WAAW,CAAC,MAAM,YACzB,CAAC,OAAO,SAAS,WAAW,CAAC,CAAC,KAC7B,IAAI,KAAK,WAAW,CAAC,KAAK,WAAW,IAAI,CAAC;AAE3C,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,EACJ;AAEA,QAAM,aAAa,IAAI,qBAAqB,GAAG,GAAG,GAAG,CAAC;AACtD,aAAW,SAAS,QAAQ;AAC1B,QAAI,OAAO,UAAU;AACnB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AACF,eAAW,aAAa,GAAG,KAAK;AAAA,EAClC;AACA,SAAO,CAAC,OAAO,QAAQ;AACrB,UAAM,MAAM,KAAK,IAAI,OAAO,GAAG,GAC7B,OAAO,KAAK,IAAI,OAAO,GAAG;AAC5B,QAAI,QAAQ;AACZ,WAAO,QAAQ,WAAW,UAAU,WAAW,KAAK,KAAK,IAAK;AAC9D,UAAM,aAAa,IAAI,GAAG,GACxB,WAAW,IAAI,IAAI;AACrB,QAAI,eAAe,SAAU,QAAO,OAAO,KAAK;AAEhD,UAAM,SAAS,KAAK,IAAI,YAAY,QAAQ;AAC5C,UAAM,WAAW,gBAAgB,aAC7B,IAAI,qBAAqB,GAAG,aAAa,QAAQ,GAAG,WAAW,MAAM,IACrE,IAAI,qBAAqB,aAAa,QAAQ,GAAG,WAAW,QAAQ,CAAC;AACzE,aAAS,aAAa,GAAG,OAAO,KAAK,CAAC;AACtC,WAAO,QAAQ,WAAW,UAAU,WAAW,KAAK,IAAI,MAAM,SAAS;AACrE,YAAM,SAAS,KAAK;AAAA,QAClB;AAAA,QACA,KAAK;AAAA,UACH;AAAA,WACC,IAAI,WAAW,KAAK,CAAC,IAAI,eAAe,WAAW;AAAA,QACtD;AAAA,MACF;AACA,eAAS,aAAa,QAAQ,OAAO,KAAK,CAAC;AAC3C,eAAS,aAAa,QAAQ,OAAO,QAAQ,CAAC,CAAC;AAAA,IACjD;AACA,aAAS,aAAa,GAAG,OAAO,KAAK,CAAC;AACtC,WAAO;AAAA,EACT;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,150 @@
+import type { PibblEventHandlers, PibblEventParticipationOptions, FillStyle, SignalValue, StrokeStyle } from "@pibbl/core";
+import type { SignalStyle } from "@pibbl/core/internal";
+import type { BandCategory, LineAccessor, ScaleId } from "./types.js";
+/**
+ * A data property or callback that extracts a category, with nullish values treated as missing.
+ *
+ * @param datum - Datum whose category is being read.
+ * @param index - Zero-based index in the source data.
+ * @param data - Complete source data array.
+ * @returns The category, or null/undefined to indicate a missing category. See
+ * {@link BandCategory} .
+ *
+ * @see {@link BandCategory}
+ * @see {@link BarSeriesProps}
+ */
+export type BarCategoryAccessor<D> = {
+    [K in keyof D]-?: D[K] extends BandCategory | null | undefined ? K : never;
+}[keyof D] | ((datum: D, index: number, data: readonly D[]) => BandCategory | null | undefined);
+import { type BarThresholdFill } from "./bar-fill.js";
+export type { BarThresholdFill } from "./bar-fill.js";
+/**
+ * Supported geometry and presentation properties for BarSeries.
+ *
+ * @see {@link FillStyle}
+ * @see {@link BarThresholdFill}
+ * @see {@link StrokeStyle}
+ * @see {@link BarStyleResolver}
+ */
+export interface BarSeriesStyle {
+    /** Width allocated to one categorical band. See {@link BarSeriesStyle}. */
+    readonly bandwidth?: number | "auto";
+    /** Paint used for the interior. See {@link FillStyle}, {@link BarThresholdFill}. */
+    readonly fill?: FillStyle | BarThresholdFill;
+    /** Paint used for the outline. See {@link StrokeStyle}. */
+    readonly stroke?: StrokeStyle;
+    /** Width of the painted outline. See {@link BarSeriesStyle}. */
+    readonly strokeWidth?: number;
+    /** Opacity of the painted result. See {@link BarSeriesStyle}. */
+    readonly opacity?: number;
+    /** Cursor shown while this target owns pointer presentation. See {@link BarSeriesStyle}. */
+    readonly cursor?: string;
+}
+/**
+ * Computes bar styling from the datum, index, and source data.
+ *
+ * @param datum - Datum being styled.
+ * @param index - Zero-based index in the source data.
+ * @param data - Complete source data array.
+ * @returns Style for this datum's bar. See {@link BarSeriesStyle}.
+ *
+ * @see {@link BarSeriesStyle}
+ */
+export type BarStyleResolver<D> = (datum: D, index: number, data: readonly D[]) => BarSeriesStyle;
+/**
+ * Shared data, category/value scales, orientation, filtering, and styling for bar variants.
+ *
+ * @see {@link BarCategoryAccessor}
+ * @see {@link BarSeriesStyle}
+ * @see {@link BarSeriesProps}
+ */
+interface BarSeriesBaseProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /**
+     * Application data supplied to the component or reported by the event. See {@link SignalValue}.
+     */
+    readonly data: SignalValue<readonly D[]>;
+    /** Selects `"vertical"`, `"horizontal"` for orientation. See {@link BarSeriesBaseProps}. */
+    readonly orientation?: "vertical" | "horizontal";
+    /** Property or callback extracting a bar's discrete category. See {@link BarCategoryAccessor}. */
+    readonly category: BarCategoryAccessor<D>;
+    /** Band scale used to place categories. See {@link ScaleId}. */
+    readonly categoryScale: ScaleId;
+    /** Numeric scale used to map bar values. See {@link ScaleId}. */
+    readonly valueScale: ScaleId;
+    /**
+     * Selects the records that participate in the bar series. See {@link BarSeriesProps}.
+     * @param datum - Record to test.
+     * @param index - Zero-based index in the source array.
+     * @param data - Complete source data array.
+     * @returns Whether this record should contribute a bar.
+     */
+    readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;
+    /**
+     * Declared presentation and layout properties. See {@link SignalValue}, {@link SignalStyle},
+     * {@link BarSeriesStyle}, {@link BarStyleResolver}.
+     */
+    readonly style?: SignalValue<SignalStyle<BarSeriesStyle> | BarStyleResolver<D>>;
+}
+/**
+ * Authored inputs for BarSeries, including the declared data and presentation options.
+ *
+ * @see {@link LineAccessor}
+ * @see {@link SignalValue}
+ * @see {@link BarCategoryAccessor}
+ * @see {@link ScaleId}
+ * @see {@link BarSeries}
+ */
+export type BarSeriesProps<D> = BarSeriesBaseProps<D> & ({
+    /** Value associated with this sample, input, or result. See {@link LineAccessor}. */
+    readonly value: LineAccessor<D>;
+    /** Numeric value from which each ordinary bar starts. See {@link SignalValue}. */
+    readonly baseline?: SignalValue<number>;
+    /**
+     * Not accepted in this variant; use the alternative fields instead. See
+     * {@link BarSeriesProps}.
+     */
+    readonly valueStart?: never;
+    /**
+     * Not accepted in this variant; use the alternative fields instead. See
+     * {@link BarSeriesProps}.
+     */
+    readonly valueEnd?: never;
+} | {
+    /**
+     * Not accepted in this variant; use the alternative fields instead. See
+     * {@link BarSeriesProps}.
+     */
+    readonly value?: never;
+    /**
+     * Not accepted in this variant; use the alternative fields instead. See
+     * {@link BarSeriesProps}.
+     */
+    readonly baseline?: never;
+    /** Accessor for the beginning of a range bar. See {@link LineAccessor}. */
+    readonly valueStart: LineAccessor<D>;
+    /** Accessor for the end of a range bar. See {@link LineAccessor}. */
+    readonly valueEnd: LineAccessor<D>;
+}) & ({
+    /** Accessor identifying the subgroup of each bar. See {@link BarCategoryAccessor}. */
+    readonly group: BarCategoryAccessor<D>;
+    /** Band scale used to place subgroups within a category. See {@link ScaleId}. */
+    readonly groupScale: ScaleId;
+} | {
+    /** Accessor identifying the subgroup of each bar. See {@link BarSeriesProps}. */
+    readonly group?: never;
+    /**
+     * Not accepted in this variant; use the alternative fields instead. See
+     * {@link BarSeriesProps}.
+     */
+    readonly groupScale?: never;
+});
+/**
+ * Value bars in source order; rectangles supply ordinary paint and event geometry.
+ *
+ * @param props - Data, category and value accessors, scales, grouping, and styling. See
+ * {@link BarSeriesProps} .
+ * @returns Pibbl nodes drawing the bars.
+ *
+ * @see {@link BarSeriesProps}
+ */
+export declare function BarSeries<D>({ data: input, orientation, category: categoryInput, value: valueInput, valueStart, valueEnd, categoryScale, valueScale, baseline, group, groupScale, defined, style: styleInput, pointerEvents, ...events }: BarSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;

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

@@ -0,0 +1,152 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import {
+  Group,
+  isSignal,
+  Rectangle,
+  resolveSignalValue,
+  useCanvasContext
+} from "@pibbl/core";
+import { withHooksForbidden } from "@pibbl/core/internal";
+import { lookupScale } from "./scale-context.js";
+import { useScale } from "./use-scale.js";
+import { pointAccessor, pointData, finiteCoordinate } from "./point-data.js";
+import { opacity, width } from "./paint.js";
+import { barFill } from "./bar-fill.js";
+function BarSeries({
+  data: input,
+  orientation = "vertical",
+  category: categoryInput,
+  value: valueInput,
+  valueStart,
+  valueEnd,
+  categoryScale,
+  valueScale,
+  baseline,
+  group,
+  groupScale,
+  defined,
+  style: styleInput,
+  pointerEvents,
+  ...events
+}) {
+  const categories = useScale(categoryScale, "band").get();
+  const values = useScale(valueScale).get();
+  const groups = lookupScale(groupScale, "BarSeries groupScale", "band")?.get();
+  if (group === void 0 !== (groupScale === void 0))
+    throw new TypeError("BarSeries requires group and groupScale together.");
+  if (groups && groups.type !== "band")
+    throw new TypeError("BarSeries groupScale requires a band scale.");
+  const groupValue = typeof group === "function" ? group : (datum) => group === void 0 ? void 0 : datum[group];
+  const slotWidth = groups?.type === "band" ? groups.bandwidth : categories.bandwidth;
+  if (orientation !== "vertical" && orientation !== "horizontal")
+    throw new TypeError("BarSeries orientation must be vertical or horizontal.");
+  const data = pointData(resolveSignalValue(input), "BarSeries");
+  const category = typeof categoryInput === "function" ? categoryInput : (datum) => datum[categoryInput];
+  const ranged = valueStart !== void 0 || valueEnd !== void 0;
+  if (ranged ? valueInput !== void 0 || baseline !== void 0 || valueStart === void 0 || valueEnd === void 0 : valueInput === void 0)
+    throw new TypeError(
+      "BarSeries requires either value with optional baseline, or both valueStart and valueEnd without value or baseline."
+    );
+  const value = pointAccessor(ranged ? valueEnd : valueInput);
+  const startValue = ranged ? pointAccessor(valueStart) : void 0;
+  const baselineValue = resolveSignalValue(baseline ?? 0);
+  const sharedBase = ranged ? void 0 : values.map(baselineValue);
+  const specified = resolveSignalValue(styleInput);
+  const ctx = useCanvasContext();
+  function normalize(input2, callback) {
+    if (!input2 || typeof input2 !== "object" || Array.isArray(input2))
+      throw new TypeError("BarSeries style must be an object.");
+    if (callback && Object.getPrototypeOf(input2) !== Object.prototype && Object.getPrototypeOf(input2) !== null)
+      throw new TypeError(
+        "BarSeries datum style must be a plain synchronous object."
+      );
+    const style = {};
+    for (const key of Object.keys(input2)) {
+      if (![
+        "bandwidth",
+        "fill",
+        "stroke",
+        "strokeWidth",
+        "opacity",
+        "cursor"
+      ].includes(key))
+        throw new TypeError(`BarSeries: unsupported style field ${key}.`);
+      const value2 = input2[key];
+      if (callback && isSignal(value2))
+        throw new TypeError(
+          "BarSeries datum styles require plain values; read signals explicitly."
+        );
+      style[key] = callback ? value2 : resolveSignalValue(value2);
+    }
+    const resolved = style;
+    if (resolved.cursor !== void 0 && typeof resolved.cursor !== "string")
+      throw new TypeError("BarSeries cursor must be a string.");
+    return {
+      bandwidth: resolved.bandwidth === void 0 || resolved.bandwidth === "auto" ? slotWidth : width(resolved.bandwidth, "BarSeries bandwidth"),
+      fill: barFill(
+        ctx,
+        resolved.fill ?? "#2563eb",
+        (value2) => values.map(value2),
+        orientation
+      ),
+      stroke: resolved.stroke,
+      strokeWidth: width(resolved.strokeWidth ?? 1, "BarSeries strokeWidth"),
+      alpha: opacity(resolved.opacity ?? 1, "BarSeries"),
+      cursor: resolved.cursor
+    };
+  }
+  const shared = typeof specified === "function" ? void 0 : normalize(specified ?? {}, false);
+  const nodes = [];
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    if (defined && !defined(datum, i, data)) continue;
+    const c = category(datum, i, data), v = value(datum, i, data), from = startValue ? startValue(datum, i, data) : baselineValue;
+    if (c == null || !finiteCoordinate(v) || !finiteCoordinate(from)) continue;
+    const categoryStart = categories.map(c);
+    const g = groups ? groupValue(datum, i, data) : void 0;
+    const offset = groups ? g == null ? void 0 : groups.map(g) : 0;
+    if (categoryStart === void 0 || offset === void 0 || slotWidth === 0)
+      continue;
+    const start = categoryStart + offset;
+    const { bandwidth, fill, stroke, strokeWidth, alpha, cursor } = shared ?? normalize(
+      withHooksForbidden(
+        "BarSeries style callback",
+        () => specified(datum, i, data)
+      ),
+      true
+    );
+    if (bandwidth === 0) continue;
+    const base = sharedBase ?? values.map(from);
+    const end = values.map(v);
+    const extent = Math.abs(end - base);
+    if (!Number.isFinite(extent))
+      throw new RangeError("BarSeries value extent must be finite.");
+    if (extent === 0) continue;
+    const vertical = orientation === "vertical";
+    nodes.push(
+      /* @__PURE__ */ jsx(
+        Rectangle,
+        {
+          pointerEvents,
+          style: {
+            left: vertical ? start + (slotWidth - bandwidth) / 2 : Math.min(base, end),
+            top: vertical ? Math.min(base, end) : start + (slotWidth - bandwidth) / 2,
+            width: vertical ? bandwidth : extent,
+            height: vertical ? extent : bandwidth,
+            fill: fill(from, v),
+            stroke,
+            strokeWidth,
+            opacity: alpha,
+            cursor
+          }
+        },
+        i
+      )
+    );
+  }
+  return /* @__PURE__ */ jsx(Group, { ...events, children: nodes });
+}
+export {
+  BarSeries
+};
+//# sourceMappingURL=bar-series.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/bar-series.tsx"],
+  "sourcesContent": ["import {\n  Group,\n  isSignal,\n  Rectangle,\n  resolveSignalValue,\n  useCanvasContext,\n} from \"@pibbl/core\";\nimport type {\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n  PibblNode,\n  FillStyle,\n  SignalValue,\n  StrokeStyle,\n} from \"@pibbl/core\";\nimport { withHooksForbidden } from \"@pibbl/core/internal\";\nimport { lookupScale } from \"./scale-context.js\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { BandCategory, LineAccessor, ScaleId } from \"./types.js\";\nimport { useScale } from \"./use-scale.js\";\nimport { pointAccessor, pointData, finiteCoordinate } from \"./point-data.js\";\nimport { opacity, width } from \"./paint.js\";\n/**\n * A data property or callback that extracts a category, with nullish values treated as missing.\n *\n * @param datum - Datum whose category is being read.\n * @param index - Zero-based index in the source data.\n * @param data - Complete source data array.\n * @returns The category, or null/undefined to indicate a missing category. See\n * {@link BandCategory} .\n *\n * @see {@link BandCategory}\n * @see {@link BarSeriesProps}\n */\nexport type BarCategoryAccessor<D> =\n  | {\n      [K in keyof D]-?: D[K] extends BandCategory | null | undefined\n        ? K\n        : never;\n    }[keyof D]\n  | ((\n      datum: D,\n      index: number,\n      data: readonly D[],\n    ) => BandCategory | null | undefined);\nimport { barFill, type BarThresholdFill } from \"./bar-fill.js\";\nexport type { BarThresholdFill } from \"./bar-fill.js\";\n/**\n * Supported geometry and presentation properties for BarSeries.\n *\n * @see {@link FillStyle}\n * @see {@link BarThresholdFill}\n * @see {@link StrokeStyle}\n * @see {@link BarStyleResolver}\n */\nexport interface BarSeriesStyle {\n  /** Width allocated to one categorical band. See {@link BarSeriesStyle}. */\n  readonly bandwidth?: number | \"auto\";\n  /** Paint used for the interior. See {@link FillStyle}, {@link BarThresholdFill}. */\n  readonly fill?: FillStyle | BarThresholdFill;\n  /** Paint used for the outline. See {@link StrokeStyle}. */\n  readonly stroke?: StrokeStyle;\n  /** Width of the painted outline. See {@link BarSeriesStyle}. */\n  readonly strokeWidth?: number;\n  /** Opacity of the painted result. See {@link BarSeriesStyle}. */\n  readonly opacity?: number;\n  /** Cursor shown while this target owns pointer presentation. See {@link BarSeriesStyle}. */\n  readonly cursor?: string;\n}\n/**\n * Computes bar styling from the datum, index, and source data.\n *\n * @param datum - Datum being styled.\n * @param index - Zero-based index in the source data.\n * @param data - Complete source data array.\n * @returns Style for this datum's bar. See {@link BarSeriesStyle}.\n *\n * @see {@link BarSeriesStyle}\n */\nexport type BarStyleResolver<D> = (\n  datum: D,\n  index: number,\n  data: readonly D[],\n) => BarSeriesStyle;\n/**\n * Shared data, category/value scales, orientation, filtering, and styling for bar variants.\n *\n * @see {@link BarCategoryAccessor}\n * @see {@link BarSeriesStyle}\n * @see {@link BarSeriesProps}\n */\ninterface BarSeriesBaseProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {\n  /**\n   * Application data supplied to the component or reported by the event. See {@link SignalValue}.\n   */\n  readonly data: SignalValue<readonly D[]>;\n  /** Selects `\"vertical\"`, `\"horizontal\"` for orientation. See {@link BarSeriesBaseProps}. */\n  readonly orientation?: \"vertical\" | \"horizontal\";\n  /** Property or callback extracting a bar's discrete category. See {@link BarCategoryAccessor}. */\n  readonly category: BarCategoryAccessor<D>;\n  /** Band scale used to place categories. See {@link ScaleId}. */\n  readonly categoryScale: ScaleId;\n  /** Numeric scale used to map bar values. See {@link ScaleId}. */\n  readonly valueScale: ScaleId;\n  /**\n   * Selects the records that participate in the bar series. See {@link BarSeriesProps}.\n   * @param datum - Record to test.\n   * @param index - Zero-based index in the source array.\n   * @param data - Complete source data array.\n   * @returns Whether this record should contribute a bar.\n   */\n  readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;\n  /**\n   * Declared presentation and layout properties. See {@link SignalValue}, {@link SignalStyle},\n   * {@link BarSeriesStyle}, {@link BarStyleResolver}.\n   */\n  readonly style?: SignalValue<SignalStyle<BarSeriesStyle> | BarStyleResolver<D>>;\n}\n/**\n * Authored inputs for BarSeries, including the declared data and presentation options.\n *\n * @see {@link LineAccessor}\n * @see {@link SignalValue}\n * @see {@link BarCategoryAccessor}\n * @see {@link ScaleId}\n * @see {@link BarSeries}\n */\nexport type BarSeriesProps<D> = BarSeriesBaseProps<D> &\n  (\n    | {\n        /** Value associated with this sample, input, or result. See {@link LineAccessor}. */\n        readonly value: LineAccessor<D>;\n        /** Numeric value from which each ordinary bar starts. See {@link SignalValue}. */\n        readonly baseline?: SignalValue<number>;\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly valueStart?: never;\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly valueEnd?: never;\n      }\n    | {\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly value?: never;\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly baseline?: never;\n        /** Accessor for the beginning of a range bar. See {@link LineAccessor}. */\n        readonly valueStart: LineAccessor<D>;\n        /** Accessor for the end of a range bar. See {@link LineAccessor}. */\n        readonly valueEnd: LineAccessor<D>;\n      }\n  ) &\n  (\n    | {\n        /** Accessor identifying the subgroup of each bar. See {@link BarCategoryAccessor}. */\n        readonly group: BarCategoryAccessor<D>;\n        /** Band scale used to place subgroups within a category. See {@link ScaleId}. */\n        readonly groupScale: ScaleId;\n      }\n    | {\n        /** Accessor identifying the subgroup of each bar. See {@link BarSeriesProps}. */\n        readonly group?: never;\n        /**\n         * Not accepted in this variant; use the alternative fields instead. See\n         * {@link BarSeriesProps}.\n         */\n        readonly groupScale?: never;\n      }\n  );\n/**\n * Value bars in source order; rectangles supply ordinary paint and event geometry.\n *\n * @param props - Data, category and value accessors, scales, grouping, and styling. See\n * {@link BarSeriesProps} .\n * @returns Pibbl nodes drawing the bars.\n *\n * @see {@link BarSeriesProps}\n */\nexport function BarSeries<D>({\n  data: input,\n  orientation = \"vertical\",\n  category: categoryInput,\n  value: valueInput,\n  valueStart,\n  valueEnd,\n  categoryScale,\n  valueScale,\n  baseline,\n  group,\n  groupScale,\n  defined,\n  style: styleInput,\n  pointerEvents,\n  ...events\n}: BarSeriesProps<D>) {\n  const categories = useScale(categoryScale, \"band\").get();\n  const values = useScale(valueScale).get();\n  const groups = lookupScale(groupScale, \"BarSeries groupScale\", \"band\")?.get();\n  if ((group === undefined) !== (groupScale === undefined))\n    throw new TypeError(\"BarSeries requires group and groupScale together.\");\n  if (groups && groups.type !== \"band\")\n    throw new TypeError(\"BarSeries groupScale requires a band scale.\");\n  const groupValue =\n    typeof group === \"function\"\n      ? group\n      : (datum: D) =>\n          group === undefined\n            ? undefined\n            : (datum[group] as BandCategory | null | undefined);\n  const slotWidth =\n    groups?.type === \"band\" ? groups.bandwidth : categories.bandwidth;\n  if (orientation !== \"vertical\" && orientation !== \"horizontal\")\n    throw new TypeError(\"BarSeries orientation must be vertical or horizontal.\");\n  const data = pointData(resolveSignalValue(input), \"BarSeries\");\n  const category =\n    typeof categoryInput === \"function\"\n      ? categoryInput\n      : (datum: D) =>\n          datum[categoryInput] as BandCategory | null | undefined;\n  const ranged = valueStart !== undefined || valueEnd !== undefined;\n  if (\n    ranged\n      ? valueInput !== undefined ||\n        baseline !== undefined ||\n        valueStart === undefined ||\n        valueEnd === undefined\n      : valueInput === undefined\n  )\n    throw new TypeError(\n      \"BarSeries requires either value with optional baseline, or both valueStart and valueEnd without value or baseline.\",\n    );\n  const value = pointAccessor((ranged ? valueEnd : valueInput)!);\n  const startValue = ranged ? pointAccessor(valueStart!) : undefined;\n  const baselineValue = resolveSignalValue(baseline ?? 0);\n  const sharedBase = ranged ? undefined : values.map(baselineValue);\n  const specified = resolveSignalValue(styleInput);\n  const ctx = useCanvasContext();\n  function normalize(input: unknown, callback: boolean) {\n    if (!input || typeof input !== \"object\" || Array.isArray(input))\n      throw new TypeError(\"BarSeries style must be an object.\");\n    if (\n      callback &&\n      Object.getPrototypeOf(input) !== Object.prototype &&\n      Object.getPrototypeOf(input) !== null\n    )\n      throw new TypeError(\n        \"BarSeries datum style must be a plain synchronous object.\",\n      );\n    const style: Record<string, unknown> = {};\n    for (const key of Object.keys(input)) {\n      if (\n        ![\n          \"bandwidth\",\n          \"fill\",\n          \"stroke\",\n          \"strokeWidth\",\n          \"opacity\",\n          \"cursor\",\n        ].includes(key)\n      )\n        throw new TypeError(`BarSeries: unsupported style field ${key}.`);\n      const value = (input as Record<string, unknown>)[key];\n      if (callback && isSignal(value))\n        throw new TypeError(\n          \"BarSeries datum styles require plain values; read signals explicitly.\",\n        );\n      style[key] = callback ? value : resolveSignalValue(value);\n    }\n    const resolved = style as BarSeriesStyle;\n    if (resolved.cursor !== undefined && typeof resolved.cursor !== \"string\")\n      throw new TypeError(\"BarSeries cursor must be a string.\");\n    return {\n      bandwidth:\n        resolved.bandwidth === undefined || resolved.bandwidth === \"auto\"\n          ? slotWidth\n          : width(resolved.bandwidth, \"BarSeries bandwidth\"),\n      fill: barFill(ctx, resolved.fill ?? \"#2563eb\", (value) =>\n        values.map(value),\n        orientation,\n      ),\n      stroke: resolved.stroke,\n      strokeWidth: width(resolved.strokeWidth ?? 1, \"BarSeries strokeWidth\"),\n      alpha: opacity(resolved.opacity ?? 1, \"BarSeries\"),\n      cursor: resolved.cursor,\n    };\n  }\n  const shared =\n    typeof specified === \"function\"\n      ? undefined\n      : normalize(specified ?? {}, false);\n  const nodes: PibblNode[] = [];\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !defined(datum, i, data)) continue;\n    const c = category(datum, i, data),\n      v = value(datum, i, data),\n      from = startValue ? startValue(datum, i, data) : baselineValue;\n    if (c == null || !finiteCoordinate(v) || !finiteCoordinate(from)) continue;\n    const categoryStart = categories.map(c);\n    const g = groups ? groupValue(datum, i, data) : undefined;\n    const offset = groups ? (g == null ? undefined : groups.map(g)) : 0;\n    if (categoryStart === undefined || offset === undefined || slotWidth === 0)\n      continue;\n    const start = categoryStart + offset;\n    const { bandwidth, fill, stroke, strokeWidth, alpha, cursor } =\n      shared ??\n      normalize(\n        withHooksForbidden(\"BarSeries style callback\", () =>\n          (specified as BarStyleResolver<D>)(datum, i, data),\n        ),\n        true,\n      );\n    if (bandwidth === 0) continue;\n    const base = sharedBase ?? values.map(from);\n    const end = values.map(v);\n    const extent = Math.abs(end - base);\n    if (!Number.isFinite(extent))\n      throw new RangeError(\"BarSeries value extent must be finite.\");\n    if (extent === 0) continue;\n    const vertical = orientation === \"vertical\";\n    nodes.push(\n      <Rectangle\n        key={i}\n        pointerEvents={pointerEvents}\n        style={{\n          left: vertical ? start + (slotWidth - bandwidth) / 2 : Math.min(base, end),\n          top: vertical ? Math.min(base, end) : start + (slotWidth - bandwidth) / 2,\n          width: vertical ? bandwidth : extent,\n          height: vertical ? extent : bandwidth,\n          fill: fill(from, v),\n          stroke,\n          strokeWidth,\n          opacity: alpha,\n          cursor,\n        }}\n      />,\n    );\n  }\n  return <Group {...events}>{nodes}</Group>;\n}\n"],
+  "mappings": "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",
+  "names": ["input", "value"]
+}

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

@@ -0,0 +1,92 @@
+import { type BoxStyle, type PibblNode, type FillStyle, type StrokeStyle, type SignalValue } from "@pibbl/core";
+import { type SignalStyle } from "@pibbl/core/internal";
+import type { HoverPoint } from "./hover-types.js";
+import { type HoverBounds, type HoverPlacement } from "./hover-placement.js";
+export type { HoverBounds, HoverPlacement } from "./hover-placement.js";
+/**
+ * Supported geometry and presentation properties for HoverCard.
+ *
+ * @see {@link BoxStyle}
+ * @see {@link FillStyle}
+ * @see {@link StrokeStyle}
+ * @see {@link HoverCardProps}
+ */
+export interface HoverCardStyle {
+    /** Horizontal extent in the units of the containing geometry or surface. See {@link BoxStyle}. */
+    readonly width: Exclude<BoxStyle["width"], undefined | "auto">;
+    /** Vertical extent in the units of the containing geometry or surface. See {@link BoxStyle}. */
+    readonly height: Exclude<BoxStyle["height"], undefined | "auto">;
+    /** Insets between the border box and content box. See {@link BoxStyle}. */
+    readonly padding?: BoxStyle["padding"];
+    /** Paint used for the interior. See {@link FillStyle}. */
+    readonly fill?: FillStyle;
+    /** Paint used for the outline. See {@link StrokeStyle}. */
+    readonly stroke?: StrokeStyle;
+    /** Width of the painted outline. See {@link HoverCardStyle}. */
+    readonly strokeWidth?: number;
+    /**
+     * Uniform corner radius used where no per-corner override is supplied. See
+     * {@link HoverCardStyle}.
+     */
+    readonly cornerRadius?: number;
+    /** Opacity of the painted result. See {@link HoverCardStyle}. */
+    readonly opacity?: number;
+    /**
+     * Not accepted in this variant; use the alternative fields instead. See {@link HoverCardStyle}.
+     */
+    readonly filter?: never;
+    /**
+     * Not accepted in this variant; use the alternative fields instead. See {@link HoverCardStyle}.
+     */
+    readonly custom?: never;
+}
+/**
+ * Authored inputs for HoverCard, including the declared data and presentation options.
+ *
+ * @see {@link SignalValue}
+ * @see {@link HoverPoint}
+ * @see {@link HoverBounds}
+ * @see {@link HoverPlacement}
+ * @see {@link SignalStyle}
+ * @see {@link HoverCardStyle}
+ * @see {@link PibblNode}
+ * @see {@link HoverCard}
+ */
+export interface HoverCardProps {
+    /**
+     * Logical point to which the content or result is anchored. See {@link SignalValue},
+     * {@link HoverPoint}.
+     */
+    readonly anchor: SignalValue<HoverPoint>;
+    /** Clearance around the anchor before placing the item. See {@link SignalValue}. */
+    readonly anchorRadius?: SignalValue<number>;
+    /** Spacing between adjacent items. See {@link SignalValue}. */
+    readonly gap?: SignalValue<number>;
+    /**
+     * Logical region constraining the content or query. See {@link SignalValue},
+     * {@link HoverBounds}.
+     */
+    readonly bounds?: SignalValue<HoverBounds>;
+    /**
+     * Preferred placement relative to the anchor or containing geometry. See {@link HoverPlacement}
+     * .
+     */
+    readonly placement?: HoverPlacement;
+    /**
+     * Declared presentation and layout properties. See {@link SignalValue}, {@link SignalStyle},
+     * {@link HoverCardStyle}.
+     */
+    readonly style: SignalValue<SignalStyle<HoverCardStyle>>;
+    /** Descendant content or the callback that supplies it. See {@link PibblNode}. */
+    readonly children?: PibblNode;
+}
+/**
+ * Positions a declared card outside a protected anchor, allowing overflow if needed.
+ *
+ * @param props - Anchor, placement, style, and hover-card content. See {@link HoverCardProps}.
+ * @returns Pibbl content placed as a hover card. See {@link PibblNode}.
+ *
+ * @see {@link HoverCardProps}
+ * @see {@link PibblNode}
+ */
+export declare function HoverCard(props: HoverCardProps): PibblNode;