@pibbl/core 0.0.1

package/dist/features/viz/lib/pie-slices.js

@@ -0,0 +1,50 @@
+import { pointAccessor, pointData } from "./point-data.js";
+function pieSlices(data, { value: input, keyBy }) {
+  pointData(data, "pieSlices");
+  const accessor = pointAccessor(input);
+  const keys = /* @__PURE__ */ new Set();
+  let total = 0;
+  const rows = data.map((datum, index) => {
+    const raw = accessor(datum, index, data);
+    const value = raw == null ? 0 : raw;
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0)
+      throw new RangeError(
+        `pieSlices: value at index ${index} must be finite and nonnegative, null, or undefined.`
+      );
+    total += value;
+    const rawKey = keyBy === void 0 ? index : typeof keyBy === "function" ? keyBy(datum, index, data) : datum[keyBy];
+    if (typeof rawKey !== "string" && (typeof rawKey !== "number" || !Number.isFinite(rawKey)))
+      throw new TypeError(
+        `pieSlices: keyBy at index ${index} must return a string or finite number.`
+      );
+    const key = String(rawKey);
+    if (keys.has(key)) throw new Error(`pieSlices: duplicate key "${key}".`);
+    keys.add(key);
+    return { datum, index, key, value };
+  });
+  if (!Number.isFinite(total))
+    throw new RangeError(
+      "pieSlices: value total must be finite; rescale the values."
+    );
+  const start = -Math.PI / 2;
+  let sum = 0;
+  let angle = start;
+  return Object.freeze(
+    rows.map((row) => {
+      const startAngle = angle;
+      sum += row.value;
+      if (total > 0 && row.value > 0)
+        angle = start + sum / total * Math.PI * 2;
+      return Object.freeze({
+        ...row,
+        fraction: total === 0 ? 0 : row.value / total,
+        startAngle,
+        endAngle: angle
+      });
+    })
+  );
+}
+export {
+  pieSlices
+};
+//# sourceMappingURL=pie-slices.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/pie-slices.ts"],
+  "sourcesContent": ["import type { PieLayoutProps, PieLayoutSlice } from './pie-types.js';\nimport type { LineAccessor } from \"./types.js\";\nimport type { PlotKeyAccessor } from \"./plot-types.js\";\nimport { pointAccessor, pointData } from \"./point-data.js\";\n\n/**\n * Value and stable-key accessors used to derive pie-slice geometry.\n *\n * @see {@link LineAccessor}\n * @see {@link PlotKeyAccessor}\n * @see {@link pieSlices}\n * @see {@link PieLayoutProps}\n */\nexport interface PieOptions<D> {\n  /** Value associated with this sample, input, or result. See {@link LineAccessor}. */\n  readonly value: LineAccessor<D>;\n  /** Property or callback supplying stable identity for each datum. See {@link PlotKeyAccessor}. */\n  readonly keyBy?: PlotKeyAccessor<D>;\n}\n\n/**\n * A datum's key, value, fraction, and angular interval in a pie layout.\n *\n * @see {@link pieSlices}\n * @see {@link PieLayoutProps}\n * @see {@link PieLayoutSlice}\n */\nexport interface PieSliceGeometry<D> {\n  /** The original data item selected by this result. See {@link PieSliceGeometry}. */\n  readonly datum: D;\n  /** Index of the selected datum in its source data. See {@link PieSliceGeometry}. */\n  readonly index: number;\n  /** Stable identity used by the containing protocol. See {@link PieSliceGeometry}. */\n  readonly key: string;\n  /** Value associated with this sample, input, or result. See {@link PieSliceGeometry}. */\n  readonly value: number;\n  /** Normalized share or position represented by this value. See {@link PieSliceGeometry}. */\n  readonly fraction: number;\n  /** Angle at which the arc or slice begins. See {@link PieSliceGeometry}. */\n  readonly startAngle: number;\n  /** Angle at which the arc or slice ends. See {@link PieSliceGeometry}. */\n  readonly endAngle: number;\n}\n\n/**\n * Pure source-ordered full-circle layout. Angles use Canvas radians, clockwise from the top.\n *\n * @param data - Records whose values determine slice proportions.\n * @param options - Value accessor and optional stable key accessor. See {@link PieOptions}.\n * @returns Ordered slice geometry associated with the input records. See {@link PieSliceGeometry}.\n *\n * @see {@link PieOptions}\n * @see {@link PieSliceGeometry}\n */\nexport function pieSlices<D>(\n  data: readonly D[],\n  { value: input, keyBy }: PieOptions<D>,\n): readonly PieSliceGeometry<D>[] {\n  pointData(data, \"pieSlices\");\n  const accessor = pointAccessor(input);\n  const keys = new Set<string>();\n  let total = 0;\n  const rows = data.map((datum, index) => {\n    const raw = accessor(datum, index, data);\n    const value = raw == null ? 0 : raw;\n    if (typeof value !== \"number\" || !Number.isFinite(value) || value < 0)\n      throw new RangeError(\n        `pieSlices: value at index ${index} must be finite and nonnegative, null, or undefined.`,\n      );\n    total += value;\n    const rawKey =\n      keyBy === undefined\n        ? index\n        : typeof keyBy === \"function\"\n          ? keyBy(datum, index, data)\n          : datum[keyBy];\n    if (\n      typeof rawKey !== \"string\" &&\n      (typeof rawKey !== \"number\" || !Number.isFinite(rawKey))\n    )\n      throw new TypeError(\n        `pieSlices: keyBy at index ${index} must return a string or finite number.`,\n      );\n    const key = String(rawKey);\n    if (keys.has(key)) throw new Error(`pieSlices: duplicate key \"${key}\".`);\n    keys.add(key);\n    return { datum, index, key, value };\n  });\n  if (!Number.isFinite(total))\n    throw new RangeError(\n      \"pieSlices: value total must be finite; rescale the values.\",\n    );\n  const start = -Math.PI / 2;\n  let sum = 0;\n  let angle = start;\n  return Object.freeze(\n    rows.map((row) => {\n      const startAngle = angle;\n      sum += row.value;\n      if (total > 0 && row.value > 0)\n        angle = start + (sum / total) * Math.PI * 2;\n      return Object.freeze({\n        ...row,\n        fraction: total === 0 ? 0 : row.value / total,\n        startAngle,\n        endAngle: angle,\n      });\n    }),\n  );\n}\n"],
+  "mappings": "AAGA,SAAS,eAAe,iBAAiB;AAmDlC,SAAS,UACd,MACA,EAAE,OAAO,OAAO,MAAM,GACU;AAChC,YAAU,MAAM,WAAW;AAC3B,QAAM,WAAW,cAAc,KAAK;AACpC,QAAM,OAAO,oBAAI,IAAY;AAC7B,MAAI,QAAQ;AACZ,QAAM,OAAO,KAAK,IAAI,CAAC,OAAO,UAAU;AACtC,UAAM,MAAM,SAAS,OAAO,OAAO,IAAI;AACvC,UAAM,QAAQ,OAAO,OAAO,IAAI;AAChC,QAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ;AAClE,YAAM,IAAI;AAAA,QACR,6BAA6B,KAAK;AAAA,MACpC;AACF,aAAS;AACT,UAAM,SACJ,UAAU,SACN,QACA,OAAO,UAAU,aACf,MAAM,OAAO,OAAO,IAAI,IACxB,MAAM,KAAK;AACnB,QACE,OAAO,WAAW,aACjB,OAAO,WAAW,YAAY,CAAC,OAAO,SAAS,MAAM;AAEtD,YAAM,IAAI;AAAA,QACR,6BAA6B,KAAK;AAAA,MACpC;AACF,UAAM,MAAM,OAAO,MAAM;AACzB,QAAI,KAAK,IAAI,GAAG,EAAG,OAAM,IAAI,MAAM,6BAA6B,GAAG,IAAI;AACvE,SAAK,IAAI,GAAG;AACZ,WAAO,EAAE,OAAO,OAAO,KAAK,MAAM;AAAA,EACpC,CAAC;AACD,MAAI,CAAC,OAAO,SAAS,KAAK;AACxB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,QAAM,QAAQ,CAAC,KAAK,KAAK;AACzB,MAAI,MAAM;AACV,MAAI,QAAQ;AACZ,SAAO,OAAO;AAAA,IACZ,KAAK,IAAI,CAAC,QAAQ;AAChB,YAAM,aAAa;AACnB,aAAO,IAAI;AACX,UAAI,QAAQ,KAAK,IAAI,QAAQ;AAC3B,gBAAQ,QAAS,MAAM,QAAS,KAAK,KAAK;AAC5C,aAAO,OAAO,OAAO;AAAA,QACnB,GAAG;AAAA,QACH,UAAU,UAAU,IAAI,IAAI,IAAI,QAAQ;AAAA,QACxC;AAAA,QACA,UAAU;AAAA,MACZ,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,215 @@
+import type { PieLabel, PieSlice } from "./pie-layout.js";
+import type { PibblNode, PibblEventHandlers, PibblEventParticipationOptions, SignalValue, FillStyle, StrokeStyle, WedgeProps, WedgeStyle } from "@pibbl/core";
+import type { SignalStyle } from "@pibbl/core/internal";
+import type { PieOptions, PieSliceGeometry } from "./pie-slices.js";
+import type { HoverBounds } from "./hover-placement.js";
+/**
+ * Places pie labels inside, outside, or automatically according to available space.
+ *
+ * @see {@link PieLayoutProps}
+ */
+export type PieLabelPlacement = "inside" | "outside" | "auto";
+/**
+ * A placed label with text geometry and optional leader, or a hidden label with its reason.
+ *
+ * @see {@link PieLayoutSlice}
+ */
+export type PieLabelLayout = Readonly<{
+    /** The literal "hidden" identifying this variant. See {@link PieLabelLayout}. */
+    status: "hidden";
+    /** Reason the operation could not produce its ordinary result. See {@link PieLabelLayout}. */
+    reason: "empty" | "inside-fit" | "space";
+    /** Text displayed by the placed label. See {@link PieLabelLayout}. */
+    text: string;
+}> | Readonly<{
+    /** The literal "placed" identifying this variant. See {@link PieLabelLayout}. */
+    status: "placed";
+    /**
+     * Preferred placement relative to the anchor or containing geometry. See
+     * {@link PieLabelLayout}.
+     */
+    placement: "inside" | "outside";
+    /** Text displayed by the placed label. See {@link PieLabelLayout}. */
+    text: string;
+    /** Canvas font string used to draw or measure text. See {@link PieLabelLayout}. */
+    font: string;
+    /**
+     * Horizontal coordinate or displacement in the containing coordinate system. See
+     * {@link PieLabelLayout}.
+     */
+    x: number;
+    /**
+     * Vertical coordinate or displacement in the containing coordinate system. See
+     * {@link PieLabelLayout}.
+     */
+    y: number;
+    /**
+     * Horizontal extent in the units of the containing geometry or surface. See
+     * {@link PieLabelLayout}.
+     */
+    width: number;
+    /**
+     * Vertical extent in the units of the containing geometry or surface. See
+     * {@link PieLabelLayout}.
+     */
+    height: number;
+    /** Horizontal origin used to paint the placed label text. See {@link PieLabelLayout}. */
+    textX: number;
+    /** Vertical origin used to paint the placed label text. See {@link PieLabelLayout}. */
+    textY: number;
+    /** Ordered logical points of the label's leader line. See {@link PieLabelLayout}. */
+    leader?: readonly (readonly [number, number])[];
+}>;
+/**
+ * Pie-slice data extended with center, radii, and optional label placement.
+ *
+ * @see {@link PieSliceGeometry}
+ * @see {@link PieLabelLayout}
+ * @see {@link PieLayoutProps}
+ * @see {@link PieSliceProps}
+ * @see {@link PieLabelProps}
+ */
+export interface PieLayoutSlice<D> extends PieSliceGeometry<D> {
+    /** Horizontal coordinate of the center. See {@link PieLayoutSlice}. */
+    readonly cx: number;
+    /** Vertical coordinate of the center. See {@link PieLayoutSlice}. */
+    readonly cy: number;
+    /** Radius in the coordinate system of this geometry or effect. See {@link PieLayoutSlice}. */
+    readonly radius: number;
+    /** Radius of the inner boundary. See {@link PieLayoutSlice}. */
+    readonly innerRadius: number;
+    /** Resolved label placement, or a reason that the label is hidden. See {@link PieLabelLayout}. */
+    readonly label?: PieLabelLayout;
+}
+/**
+ * Supported geometry and presentation properties for PieLayout.
+ *
+ * @see {@link PieLayoutProps}
+ */
+export interface PieLayoutStyle {
+    /** Horizontal coordinate of the center. See {@link PieLayoutStyle}. */
+    readonly cx?: number;
+    /** Vertical coordinate of the center. See {@link PieLayoutStyle}. */
+    readonly cy?: number;
+    /** Radius in the coordinate system of this geometry or effect. See {@link PieLayoutStyle}. */
+    readonly radius?: number;
+    /** Radius of the inner boundary. See {@link PieLayoutStyle}. */
+    readonly innerRadius?: number;
+    /** Canvas font used when measuring pie labels. See {@link PieLayoutStyle}. */
+    readonly labelFont?: string;
+    /** Clearance between pie geometry and its labels. See {@link PieLayoutStyle}. */
+    readonly labelGap?: number;
+}
+/**
+ * Authored inputs for PieLayout, including the declared data and presentation options.
+ *
+ * @see {@link PieOptions}
+ * @see {@link SignalValue}
+ * @see {@link PieSliceGeometry}
+ * @see {@link PieLabelPlacement}
+ * @see {@link HoverBounds}
+ * @see {@link SignalStyle}
+ * @see {@link PieLayoutStyle}
+ * @see {@link PieLayoutSlice}
+ * @see {@link PibblNode}
+ */
+export interface PieLayoutProps<D> extends PieOptions<D> {
+    /**
+     * Application data supplied to the component or reported by the event. See {@link SignalValue}.
+     */
+    readonly data: SignalValue<readonly D[]>;
+    /** Opts into cached geometry for mutable inputs; advance after nonreactive changes. */
+    readonly revision?: SignalValue<number>;
+    /**
+     * Formats the text associated with a pie slice. See {@link PieSliceGeometry}.
+     * @param slice - Slice whose label text is needed. See {@link PieSliceGeometry}.
+     * @returns Label text for the slice.
+     */
+    readonly label?: (slice: PieSliceGeometry<D>) => string;
+    /**
+     * Preferred placement relative to the anchor or containing geometry. See {@link SignalValue},
+     * {@link PieLabelPlacement}.
+     */
+    readonly placement?: SignalValue<PieLabelPlacement>;
+    /**
+     * Logical region constraining the content or query. See {@link SignalValue},
+     * {@link HoverBounds}.
+     */
+    readonly bounds?: SignalValue<HoverBounds>;
+    /**
+     * Declared presentation and layout properties. See {@link SignalValue}, {@link SignalStyle},
+     * {@link PieLayoutStyle}.
+     */
+    readonly style?: SignalValue<SignalStyle<PieLayoutStyle>>;
+    /**
+     * Descendant content or the callback that supplies it. See {@link PieLayoutSlice},
+     * {@link PibblNode}.
+     * @param slice - Slice geometry and layout metadata. See {@link PieLayoutSlice}.
+     * @returns Pibbl content representing the slice. See {@link PibblNode}.
+     */
+    readonly children: (slice: PieLayoutSlice<D>) => PibblNode;
+}
+/**
+ * Supported geometry and presentation properties for PieSlice.
+ *
+ * @see {@link WedgeStyle}
+ * @see {@link PieSliceProps}
+ */
+export type PieSliceStyle = Omit<WedgeStyle, "cx" | "cy" | "radius" | "startAngle" | "endAngle" | "counterclockwise">;
+/**
+ * Authored inputs for PieSlice, including the declared data and presentation options.
+ *
+ * @see {@link WedgeProps}
+ * @see {@link PieLayoutSlice}
+ * @see {@link SignalValue}
+ * @see {@link SignalStyle}
+ * @see {@link PieSliceStyle}
+ * @see {@link PibblNode}
+ * @see {@link PieSlice}
+ */
+export interface PieSliceProps<D> extends WedgeProps {
+    /** Resolved pie geometry and label placement to present. See {@link PieLayoutSlice}. */
+    readonly slice: PieLayoutSlice<D>;
+    /**
+     * Declared presentation and layout properties. See {@link SignalValue}, {@link SignalStyle},
+     * {@link PieSliceStyle}.
+     */
+    readonly style?: SignalValue<SignalStyle<PieSliceStyle>>;
+    /** Descendant content or the callback that supplies it. See {@link PibblNode}. */
+    readonly children?: PibblNode;
+}
+/**
+ * Supported geometry and presentation properties for PieLabel.
+ *
+ * @see {@link FillStyle}
+ * @see {@link StrokeStyle}
+ * @see {@link PieLabelProps}
+ */
+export interface PieLabelStyle {
+    /** Paint used for the interior. See {@link FillStyle}. */
+    readonly fill?: FillStyle;
+    /** Paint used for a pie label's leader line. See {@link StrokeStyle}. */
+    readonly leaderStroke?: StrokeStyle;
+    /** Stroke width of a pie label's leader line. See {@link PieLabelStyle}. */
+    readonly leaderWidth?: number;
+}
+/**
+ * Authored inputs for PieLabel, including the declared data and presentation options.
+ *
+ * @see {@link PibblEventHandlers}
+ * @see {@link PibblEventParticipationOptions}
+ * @see {@link PieLayoutSlice}
+ * @see {@link SignalValue}
+ * @see {@link SignalStyle}
+ * @see {@link PieLabelStyle}
+ * @see {@link PieLabel}
+ */
+export interface PieLabelProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /** Resolved pie geometry and label placement to present. See {@link PieLayoutSlice}. */
+    readonly slice: PieLayoutSlice<D>;
+    /**
+     * Declared presentation and layout properties. See {@link SignalValue}, {@link SignalStyle},
+     * {@link PieLabelStyle}.
+     */
+    readonly style?: SignalValue<SignalStyle<PieLabelStyle>>;
+}

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

@@ -0,0 +1,13 @@
+import type { PibblNode } from "@pibbl/core";
+import type { PlotSeriesProps } from "./plot-types.js";
+/**
+ * Places keyed custom Pibbl subtrees at local data coordinates.
+ *
+ * @param props - Data, coordinate accessors, scales, keys, and per-datum renderer. See
+ * {@link PlotSeriesProps} .
+ * @returns Pibbl nodes placing each rendered datum at its mapped coordinates. See {@link PibblNode}.
+ *
+ * @see {@link PlotSeriesProps}
+ * @see {@link PibblNode}
+ */
+export declare function PlotSeries<D>({ data: input, x: xInput, y: yInput, xScale: xId, yScale: yId, defined, keyBy, render, ...events }: PlotSeriesProps<D>): PibblNode;

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

@@ -0,0 +1,53 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import { Group, resolveSignalValue } from "@pibbl/core";
+import { pointAccessor, pointData, finiteCoordinate } from "./point-data.js";
+import { useScale } from "./use-scale.js";
+function PlotRow({
+  datum,
+  index,
+  data,
+  render
+}) {
+  return render(datum, index, data);
+}
+function PlotSeries({
+  data: input,
+  x: xInput,
+  y: yInput,
+  xScale: xId,
+  yScale: yId,
+  defined,
+  keyBy,
+  render,
+  ...events
+}) {
+  const xs = useScale(xId).get(), ys = useScale(yId).get();
+  const data = pointData(resolveSignalValue(input), "PlotSeries");
+  if (typeof render !== "function")
+    throw new TypeError("PlotSeries: render must be a synchronous function.");
+  const x = pointAccessor(xInput), y = pointAccessor(yInput);
+  const keys = /* @__PURE__ */ new Set();
+  const nodes = [];
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    if (defined && !defined(datum, i, data)) continue;
+    const xv = x(datum, i, data), yv = y(datum, i, data);
+    if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) continue;
+    const px = xs.map(xv), py = ys.map(yv);
+    const key = keyBy === void 0 ? i : typeof keyBy === "function" ? keyBy(datum, i, data) : datum[keyBy];
+    if (typeof key !== "string" && typeof key !== "number")
+      throw new TypeError("PlotSeries: keyBy must return a string or number.");
+    const normalized = String(key);
+    if (keys.has(normalized))
+      throw new Error(`PlotSeries: duplicate key "${normalized}".`);
+    keys.add(normalized);
+    nodes.push(
+      /* @__PURE__ */ jsx(Group, { style: { translateX: px, translateY: py }, children: /* @__PURE__ */ jsx(PlotRow, { datum, index: i, data, render }) }, normalized)
+    );
+  }
+  return /* @__PURE__ */ jsx(Group, { ...events, children: nodes });
+}
+export {
+  PlotSeries
+};
+//# sourceMappingURL=plot-series.js.map

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

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

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

@@ -0,0 +1,63 @@
+import type { PlotSeries } from "./plot-series.js";
+import type { PieOptions } from "./pie-slices.js";
+import type { PibblEventHandlers, PibblNode, SignalValue } from "@pibbl/core";
+import type { PointAccessor } from "./point-types.js";
+import type { ScaleId } from "./types.js";
+/**
+ * A property or callback that provides stable identity for a plotted datum.
+ *
+ * @param datum - Datum requiring an identity.
+ * @param index - Zero-based index in the source data.
+ * @param data - Complete source data array.
+ * @returns A stable string or numeric key for the datum.
+ *
+ * @see {@link PlotSeriesProps}
+ * @see {@link PieOptions}
+ */
+export type PlotKeyAccessor<D> = {
+    [K in keyof D]-?: D[K] extends string | number ? K : never;
+}[keyof D] | ((datum: D, index: number, data: readonly D[]) => string | number);
+/**
+ * Authored inputs for PlotSeries, including the declared data and presentation options.
+ *
+ * @see {@link PibblEventHandlers}
+ * @see {@link SignalValue}
+ * @see {@link PointAccessor}
+ * @see {@link ScaleId}
+ * @see {@link PlotKeyAccessor}
+ * @see {@link PibblNode}
+ * @see {@link PlotSeries}
+ */
+export interface PlotSeriesProps<D> extends PibblEventHandlers {
+    /**
+     * Application data supplied to the component or reported by the event. See {@link SignalValue}.
+     */
+    readonly data: SignalValue<readonly D[]>;
+    /** Property key or callback extracting the horizontal domain coordinate. See {@link PointAccessor}. */
+    readonly x: PointAccessor<D>;
+    /** Property key or callback extracting the vertical domain coordinate. See {@link PointAccessor}. */
+    readonly y: PointAccessor<D>;
+    /** The scale used to map horizontal data coordinates. See {@link ScaleId}. */
+    readonly xScale: ScaleId;
+    /** The scale used to map vertical data coordinates. See {@link ScaleId}. */
+    readonly yScale: ScaleId;
+    /**
+     * Returns whether a datum contributes drawable or queryable coordinates. See
+     * {@link PlotSeriesProps}.
+     * @param datum - Datum to test.
+     * @param index - Zero-based index in the source data.
+     * @param data - Complete source data array.
+     * @returns Whether this datum should participate in the series or query.
+     */
+    readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;
+    /** Property or callback supplying stable identity for each datum. See {@link PlotKeyAccessor}. */
+    readonly keyBy?: PlotKeyAccessor<D>;
+    /**
+     * Renders the current data or resources using the supplied context. See {@link PibblNode}.
+     * @param datum - Datum to render.
+     * @param index - Zero-based index in the source data.
+     * @param data - Complete source data array.
+     * @returns Pibbl content to place at the datum's mapped coordinates. See {@link PibblNode}.
+     */
+    readonly render: (datum: D, index: number, data: readonly D[]) => PibblNode;
+}

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

@@ -0,0 +1,5 @@
+import type { PointAccessor } from "./point-types.js";
+import type { LineCoordinate } from "./types.js";
+export declare function pointAccessor<D>(input: PointAccessor<D>): (datum: D, index: number, data: readonly D[]) => LineCoordinate;
+export declare function finiteCoordinate(value: unknown): value is number;
+export declare function pointData<D>(data: readonly D[], receiver: string): readonly D[];

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

@@ -0,0 +1,17 @@
+function pointAccessor(input) {
+  return typeof input === "function" ? input : (datum) => datum[input];
+}
+function finiteCoordinate(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+function pointData(data, receiver) {
+  if (!Array.isArray(data))
+    throw new TypeError(`${receiver}: data must be an array.`);
+  return data;
+}
+export {
+  finiteCoordinate,
+  pointAccessor,
+  pointData
+};
+//# sourceMappingURL=point-data.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/point-data.ts"],
+  "sourcesContent": ["import type { PointAccessor } from \"./point-types.js\";\nimport type { LineCoordinate } from \"./types.js\";\nexport function pointAccessor<D>(\n  input: PointAccessor<D>,\n): (datum: D, index: number, data: readonly D[]) => LineCoordinate {\n  return typeof input === \"function\"\n    ? input\n    : (datum) => datum[input] as LineCoordinate;\n}\nexport function finiteCoordinate(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\nexport function pointData<D>(\n  data: readonly D[],\n  receiver: string,\n): readonly D[] {\n  if (!Array.isArray(data))\n    throw new TypeError(`${receiver}: data must be an array.`);\n  return data;\n}\n"],
+  "mappings": "AAEO,SAAS,cACd,OACiE;AACjE,SAAO,OAAO,UAAU,aACpB,QACA,CAAC,UAAU,MAAM,KAAK;AAC5B;AACO,SAAS,iBAAiB,OAAiC;AAChE,SAAO,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK;AAC3D;AACO,SAAS,UACd,MACA,UACc;AACd,MAAI,CAAC,MAAM,QAAQ,IAAI;AACrB,UAAM,IAAI,UAAU,GAAG,QAAQ,0BAA0B;AAC3D,SAAO;AACT;",
+  "names": []
+}

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

@@ -0,0 +1,2 @@
+export declare function pointPath(x: number, y: number, radius: number): Path2D;
+export declare function appendPointTarget(path: Path2D, x: number, y: number, radius: number, fill: boolean, strokeWidth: number): void;

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

@@ -0,0 +1,24 @@
+function circle(path, x, y, radius, reverse = false) {
+  path.moveTo(x + radius, y);
+  path.arc(x, y, radius, 0, Math.PI * 2, reverse);
+  path.closePath();
+}
+function pointPath(x, y, radius) {
+  const path = new Path2D();
+  circle(path, x, y, radius);
+  return path;
+}
+function appendPointTarget(path, x, y, radius, fill, strokeWidth) {
+  if (radius === 0 || !fill && strokeWidth === 0) return;
+  const outer = radius + strokeWidth / 2;
+  if (!Number.isFinite(outer) || !Number.isFinite(x + outer) || !Number.isFinite(y + outer))
+    throw new RangeError("PointSeries: circle geometry overflow.");
+  circle(path, x, y, outer);
+  const inner = radius - strokeWidth / 2;
+  if (!fill && inner > 0) circle(path, x, y, inner, true);
+}
+export {
+  appendPointTarget,
+  pointPath
+};
+//# sourceMappingURL=point-geometry.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/point-geometry.ts"],
+  "sourcesContent": ["/** Separate contours avoid line segments between circles; opposite inner winding makes rings. */\nfunction circle(\n  path: Path2D,\n  x: number,\n  y: number,\n  radius: number,\n  reverse = false,\n) {\n  path.moveTo(x + radius, y);\n  path.arc(x, y, radius, 0, Math.PI * 2, reverse);\n  path.closePath();\n}\nexport function pointPath(x: number, y: number, radius: number): Path2D {\n  const path = new Path2D();\n  circle(path, x, y, radius);\n  return path;\n}\nexport function appendPointTarget(\n  path: Path2D,\n  x: number,\n  y: number,\n  radius: number,\n  fill: boolean,\n  strokeWidth: number,\n): void {\n  if (radius === 0 || (!fill && strokeWidth === 0)) return;\n  const outer = radius + strokeWidth / 2;\n  if (\n    !Number.isFinite(outer) ||\n    !Number.isFinite(x + outer) ||\n    !Number.isFinite(y + outer)\n  )\n    throw new RangeError(\"PointSeries: circle geometry overflow.\");\n  circle(path, x, y, outer);\n  const inner = radius - strokeWidth / 2;\n  if (!fill && inner > 0) circle(path, x, y, inner, true);\n}\n"],
+  "mappings": "AACA,SAAS,OACP,MACA,GACA,GACA,QACA,UAAU,OACV;AACA,OAAK,OAAO,IAAI,QAAQ,CAAC;AACzB,OAAK,IAAI,GAAG,GAAG,QAAQ,GAAG,KAAK,KAAK,GAAG,OAAO;AAC9C,OAAK,UAAU;AACjB;AACO,SAAS,UAAU,GAAW,GAAW,QAAwB;AACtE,QAAM,OAAO,IAAI,OAAO;AACxB,SAAO,MAAM,GAAG,GAAG,MAAM;AACzB,SAAO;AACT;AACO,SAAS,kBACd,MACA,GACA,GACA,QACA,MACA,aACM;AACN,MAAI,WAAW,KAAM,CAAC,QAAQ,gBAAgB,EAAI;AAClD,QAAM,QAAQ,SAAS,cAAc;AACrC,MACE,CAAC,OAAO,SAAS,KAAK,KACtB,CAAC,OAAO,SAAS,IAAI,KAAK,KAC1B,CAAC,OAAO,SAAS,IAAI,KAAK;AAE1B,UAAM,IAAI,WAAW,wCAAwC;AAC/D,SAAO,MAAM,GAAG,GAAG,KAAK;AACxB,QAAM,QAAQ,SAAS,cAAc;AACrC,MAAI,CAAC,QAAQ,QAAQ,EAAG,QAAO,MAAM,GAAG,GAAG,OAAO,IAAI;AACxD;",
+  "names": []
+}

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

@@ -0,0 +1,11 @@
+import type { PointSeriesProps } from "./point-types.js";
+/**
+ * Batched circles in source paint order with one ordinary Pibbl target.
+ *
+ * @param props - Data, coordinate accessors, scales, and point styling. See
+ * {@link PointSeriesProps} .
+ * @returns Pibbl nodes drawing the point marks.
+ *
+ * @see {@link PointSeriesProps}
+ */
+export declare function PointSeries<D>({ data: input, x: xInput, y: yInput, xScale: xId, yScale: yId, defined, style: styleInput, ...events }: PointSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;

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

@@ -0,0 +1,118 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import { resolveTexturePaint } from "@pibbl/core/internal";
+import {
+  Path,
+  isSignal,
+  resolveSignalValue,
+  useCanvasContext
+} from "@pibbl/core";
+import { useScale } from "./use-scale.js";
+import { finiteCoordinate, pointAccessor, pointData } from "./point-data.js";
+import { appendPointTarget, pointPath } from "./point-geometry.js";
+import { opacity, width } from "./paint.js";
+const fields = ["radius", "fill", "stroke", "strokeWidth", "opacity", "cursor"];
+function paint(value, name) {
+  if (value === void 0 || typeof value === "string" || value instanceof CanvasGradient || value instanceof CanvasPattern)
+    return value;
+  throw new TypeError(`PointSeries: invalid ${name}.`);
+}
+function styleObject(input, callback) {
+  if (input === null || typeof input !== "object" || Array.isArray(input))
+    throw new TypeError("PointSeries: style must be an object.");
+  const result = {};
+  for (const key of Object.keys(input)) {
+    if (!fields.includes(key) || callback && key === "cursor")
+      throw new TypeError(`PointSeries: unsupported style field ${key}.`);
+    const value = input[key];
+    if (callback && isSignal(value))
+      throw new TypeError(
+        "PointSeries: datum styles must contain plain values; read signals explicitly."
+      );
+    result[key] = callback ? value : resolveSignalValue(value);
+  }
+  return result;
+}
+function normalized(style) {
+  const radius = width(style.radius ?? 3, "PointSeries radius");
+  if (style.cursor !== void 0 && typeof style.cursor !== "string")
+    throw new TypeError("PointSeries: cursor must be a string.");
+  return {
+    radius,
+    fill: paint(style.fill ?? "#2563eb", "fill"),
+    stroke: paint(style.stroke, "stroke"),
+    strokeWidth: width(style.strokeWidth ?? 1, "PointSeries"),
+    opacity: opacity(style.opacity ?? 1, "PointSeries"),
+    cursor: style.cursor
+  };
+}
+function PointSeries({
+  data: input,
+  x: xInput,
+  y: yInput,
+  xScale: xId,
+  yScale: yId,
+  defined,
+  style: styleInput,
+  ...events
+}) {
+  const xs = useScale(xId).get(), ys = useScale(yId).get();
+  const data = pointData(resolveSignalValue(input), "PointSeries");
+  const x = pointAccessor(xInput), y = pointAccessor(yInput);
+  const specified = resolveSignalValue(styleInput);
+  const shared = typeof specified === "function" ? void 0 : normalized(styleObject(specified ?? {}, false));
+  const ctx = useCanvasContext();
+  const target = new Path2D();
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    if (defined && !defined(datum, i, data)) continue;
+    const xv = x(datum, i, data), yv = y(datum, i, data);
+    if (!finiteCoordinate(xv) || !finiteCoordinate(yv)) continue;
+    const px = xs.map(xv), py = ys.map(yv);
+    const style = shared ?? normalized(
+      styleObject(
+        specified(
+          datum,
+          i,
+          data
+        ),
+        true
+      )
+    );
+    if (style.radius === 0) continue;
+    appendPointTarget(
+      target,
+      px,
+      py,
+      style.radius,
+      !!style.fill,
+      style.stroke ? style.strokeWidth : 0
+    );
+    const path = pointPath(px, py, style.radius);
+    ctx.save();
+    try {
+      ctx.globalAlpha *= style.opacity;
+      if (style.fill) {
+        ctx.fillStyle = resolveTexturePaint(style.fill, ctx, { x: px - style.radius, y: py - style.radius, width: style.radius * 2, height: style.radius * 2 });
+        ctx.fill(path);
+      }
+      if (style.stroke && style.strokeWidth > 0) {
+        ctx.strokeStyle = resolveTexturePaint(style.stroke, ctx, { x: px - style.radius, y: py - style.radius, width: style.radius * 2, height: style.radius * 2 });
+        ctx.lineWidth = style.strokeWidth;
+        ctx.stroke(path);
+      }
+    } finally {
+      ctx.restore();
+    }
+  }
+  return /* @__PURE__ */ jsx(
+    Path,
+    {
+      ...events,
+      style: { d: target, fill: "transparent", cursor: shared?.cursor }
+    }
+  );
+}
+export {
+  PointSeries
+};
+//# sourceMappingURL=point-series.js.map