@pibbl/core 0.0.2 → 0.0.3-alpha.85.1

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

@@ -0,0 +1,71 @@
+import type { PibblEventHandlers, PibblEventParticipationOptions, SignalValue, StrokeStyle } from "@pibbl/core";
+import type { SignalStyle } from "@pibbl/core/internal";
+import type { LineAccessor, ScaleId, SeriesAccessor } from "./types.js";
+/** Shared path appearance for {@link TrajectorySeries}. */
+export interface TrajectorySeriesStyle {
+    /** Path paint. Defaults to `#2563eb`. */
+    readonly stroke?: StrokeStyle;
+    /** Visible path width in local units. Defaults to 2. */
+    readonly strokeWidth?: number;
+    /** Pointer targeting width. Defaults to `strokeWidth`. */
+    readonly lineInteractionWidth?: number;
+    /** Path opacity in [0, 1]. Defaults to 1. */
+    readonly opacity?: number;
+    /** Cursor while the batched path owns pointer presentation. */
+    readonly cursor?: string;
+}
+/**
+ * A participant or specimen identity property or callback.
+ *
+ * Nullish identities deliberately omit a row. Numeric identities must be finite.
+ * @param datum - Source observation.
+ * @param index - Zero-based source index.
+ * @param data - Complete source data array.
+ * @returns A finite numeric or string identity, or a nullish omitted identity.
+ * @see {@link TrajectorySeriesProps}
+ */
+export type TrajectoryGroupAccessor<D> = {
+    [K in keyof D]-?: D[K] extends string | number | null | undefined ? K : never;
+}[keyof D] | ((datum: D, index: number, data: readonly D[]) => string | number | null | undefined);
+/**
+ * Authoring inputs for {@link TrajectorySeries}.
+ *
+ * Rows are connected in source encounter order within each group. The component
+ * neither sorts time values nor invents visits, summaries, or missing values.
+ */
+export interface TrajectorySeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /** Source observations or a signal containing them. */
+    readonly data: SignalValue<readonly D[]>;
+    /** Stable participant or specimen identity. Nullish identities omit that row. */
+    readonly group: TrajectoryGroupAccessor<D>;
+    /** Encounter-time or scheduled-visit coordinate. */
+    readonly x: SeriesAccessor<D>;
+    /** Numeric observed outcome coordinate. */
+    readonly y: LineAccessor<D>;
+    /** Scale mapping encounter-time or visit coordinates. */
+    readonly xScale: ScaleId;
+    /** Numeric scale mapping outcomes. */
+    readonly yScale: ScaleId;
+    /**
+     * Ends that group's current run without reading coordinate accessors.
+     * @param datum - Candidate source datum.
+     * @param index - Zero-based source index.
+     * @param data - Complete source data array.
+     * @returns Whether this datum contributes a coordinate to its group.
+     */
+    readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;
+    /** Shared path style, including whole-object and shallow field signals. */
+    readonly style?: SignalValue<SignalStyle<TrajectorySeriesStyle>>;
+}
+/**
+ * Draws one shared-style path connecting each participant or specimen trajectory.
+ *
+ * A missing, excluded, or non-finite coordinate ends only that group's current
+ * run. Interleaved groups retain their source encounter order; trajectories are
+ * never sorted by either actual or scheduled time.
+ *
+ * @param props - Observations, identities, coordinates, scales, and shared path paint.
+ * @returns One batched ordinary Pibbl path containing source-ordered trajectory segments.
+ * @see {@link TrajectorySeriesProps}
+ */
+export declare function TrajectorySeries<D>({ data: input, group: groupInput, x: xInput, y: yInput, xScale: xId, yScale: yId, defined, style: styleInput, ...events }: TrajectorySeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;

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

@@ -0,0 +1,111 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import { Path, resolveSignalValue } from "@pibbl/core";
+import { withHooksForbidden } from "@pibbl/core/internal";
+import { opacity, width } from "./paint.js";
+import { pointAccessor, pointData } from "./point-data.js";
+import {
+  mapSeriesPosition,
+  seriesAccessor,
+  useNumericPosition,
+  useSeriesPosition
+} from "./series-position.js";
+function style(input) {
+  if (input === null || typeof input !== "object" || Array.isArray(input))
+    throw new TypeError("TrajectorySeries: style must be an object.");
+  const value = input;
+  for (const field of Object.keys(value))
+    if (![
+      "stroke",
+      "strokeWidth",
+      "lineInteractionWidth",
+      "opacity",
+      "cursor"
+    ].includes(field))
+      throw new TypeError(
+        `TrajectorySeries: unsupported style field ${field}.`
+      );
+  const stroke = resolveSignalValue(value.stroke) ?? "#2563eb";
+  const strokeWidth = width(
+    resolveSignalValue(value.strokeWidth) ?? 2,
+    "TrajectorySeries strokeWidth"
+  );
+  const lineInteractionWidth = width(
+    resolveSignalValue(value.lineInteractionWidth) ?? strokeWidth,
+    "TrajectorySeries lineInteractionWidth"
+  );
+  const cursor = resolveSignalValue(value.cursor);
+  if (cursor !== void 0 && typeof cursor !== "string")
+    throw new TypeError("TrajectorySeries: cursor must be a string.");
+  return {
+    stroke,
+    strokeWidth,
+    lineInteractionWidth,
+    opacity: opacity(
+      resolveSignalValue(value.opacity) ?? 1,
+      "TrajectorySeries opacity"
+    ),
+    cursor
+  };
+}
+function TrajectorySeries({
+  data: input,
+  group: groupInput,
+  x: xInput,
+  y: yInput,
+  xScale: xId,
+  yScale: yId,
+  defined,
+  style: styleInput,
+  ...events
+}) {
+  const xs = useSeriesPosition(xId);
+  const ys = useNumericPosition(yId);
+  const data = pointData(resolveSignalValue(input), "TrajectorySeries");
+  const x = seriesAccessor(xInput);
+  const y = pointAccessor(yInput);
+  const group = typeof groupInput === "function" ? groupInput : (datum) => datum[groupInput];
+  const resolved = style(resolveSignalValue(styleInput) ?? {});
+  const last = /* @__PURE__ */ new Map();
+  const path = new Path2D();
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    const row = withHooksForbidden(
+      "TrajectorySeries: accessors cannot call hooks.",
+      () => {
+        const identity = group(datum, i, data);
+        if (defined && !defined(datum, i, data)) return { group: identity };
+        return {
+          group: identity,
+          x: x(datum, i, data),
+          y: y(datum, i, data)
+        };
+      }
+    );
+    if (!row || row.group == null) continue;
+    if (typeof row.group !== "string" && typeof row.group !== "number" || typeof row.group === "number" && !Number.isFinite(row.group))
+      throw new TypeError(
+        "TrajectorySeries: group must be a string or number."
+      );
+    if (!("x" in row) || !("y" in row)) {
+      last.delete(row.group);
+      continue;
+    }
+    const px = mapSeriesPosition(xs, row.x);
+    const py = mapSeriesPosition(ys, row.y);
+    if (px === void 0 || py === void 0) {
+      last.delete(row.group);
+      continue;
+    }
+    const prior = last.get(row.group);
+    if (prior) {
+      path.moveTo(prior[0], prior[1]);
+      path.lineTo(px, py);
+    }
+    last.set(row.group, [px, py]);
+  }
+  return /* @__PURE__ */ jsx(Path, { ...events, style: { d: path, ...resolved } });
+}
+export {
+  TrajectorySeries
+};
+//# sourceMappingURL=trajectory-series.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/trajectory-series.tsx"],
+  "sourcesContent": ["import { Path, resolveSignalValue } from \"@pibbl/core\";\nimport type {\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n  SignalValue,\n  StrokeStyle,\n} from \"@pibbl/core\";\nimport { withHooksForbidden } from \"@pibbl/core/internal\";\nimport type { SignalStyle } from \"@pibbl/core/internal\";\nimport type { LineAccessor, ScaleId, SeriesAccessor } from \"./types.js\";\nimport { opacity, width } from \"./paint.js\";\nimport { pointAccessor, pointData } from \"./point-data.js\";\nimport {\n  mapSeriesPosition,\n  seriesAccessor,\n  useNumericPosition,\n  useSeriesPosition,\n} from \"./series-position.js\";\n\n/** Shared path appearance for {@link TrajectorySeries}. */\nexport interface TrajectorySeriesStyle {\n  /** Path paint. Defaults to `#2563eb`. */\n  readonly stroke?: StrokeStyle;\n  /** Visible path width in local units. Defaults to 2. */\n  readonly strokeWidth?: number;\n  /** Pointer targeting width. Defaults to `strokeWidth`. */\n  readonly lineInteractionWidth?: number;\n  /** Path opacity in [0, 1]. Defaults to 1. */\n  readonly opacity?: number;\n  /** Cursor while the batched path owns pointer presentation. */\n  readonly cursor?: string;\n}\n\n/**\n * A participant or specimen identity property or callback.\n *\n * Nullish identities deliberately omit a row. Numeric identities must be finite.\n * @param datum - Source observation.\n * @param index - Zero-based source index.\n * @param data - Complete source data array.\n * @returns A finite numeric or string identity, or a nullish omitted identity.\n * @see {@link TrajectorySeriesProps}\n */\nexport type TrajectoryGroupAccessor<D> =\n  | {\n      [K in keyof D]-?: D[K] extends string | number | null | undefined\n        ? K\n        : never;\n    }[keyof D]\n  | ((\n      datum: D,\n      index: number,\n      data: readonly D[],\n    ) => string | number | null | undefined);\n\n/**\n * Authoring inputs for {@link TrajectorySeries}.\n *\n * Rows are connected in source encounter order within each group. The component\n * neither sorts time values nor invents visits, summaries, or missing values.\n */\nexport interface TrajectorySeriesProps<D>\n  extends PibblEventHandlers, PibblEventParticipationOptions {\n  /** Source observations or a signal containing them. */\n  readonly data: SignalValue<readonly D[]>;\n  /** Stable participant or specimen identity. Nullish identities omit that row. */\n  readonly group: TrajectoryGroupAccessor<D>;\n  /** Encounter-time or scheduled-visit coordinate. */\n  readonly x: SeriesAccessor<D>;\n  /** Numeric observed outcome coordinate. */\n  readonly y: LineAccessor<D>;\n  /** Scale mapping encounter-time or visit coordinates. */\n  readonly xScale: ScaleId;\n  /** Numeric scale mapping outcomes. */\n  readonly yScale: ScaleId;\n  /**\n   * Ends that group's current run without reading coordinate accessors.\n   * @param datum - Candidate source datum.\n   * @param index - Zero-based source index.\n   * @param data - Complete source data array.\n   * @returns Whether this datum contributes a coordinate to its group.\n   */\n  readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;\n  /** Shared path style, including whole-object and shallow field signals. */\n  readonly style?: SignalValue<SignalStyle<TrajectorySeriesStyle>>;\n}\n\ninterface ResolvedTrajectoryStyle {\n  readonly stroke: StrokeStyle;\n  readonly strokeWidth: number;\n  readonly lineInteractionWidth: number;\n  readonly opacity: number;\n  readonly cursor?: string;\n}\n\nfunction style(input: unknown): ResolvedTrajectoryStyle {\n  if (input === null || typeof input !== \"object\" || Array.isArray(input))\n    throw new TypeError(\"TrajectorySeries: style must be an object.\");\n  const value = input as Record<string, unknown>;\n  for (const field of Object.keys(value))\n    if (\n      ![\n        \"stroke\",\n        \"strokeWidth\",\n        \"lineInteractionWidth\",\n        \"opacity\",\n        \"cursor\",\n      ].includes(field)\n    )\n      throw new TypeError(\n        `TrajectorySeries: unsupported style field ${field}.`,\n      );\n  const stroke = resolveSignalValue(value.stroke) ?? \"#2563eb\";\n  const strokeWidth = width(\n    (resolveSignalValue(value.strokeWidth) ?? 2) as number,\n    \"TrajectorySeries strokeWidth\",\n  );\n  const lineInteractionWidth = width(\n    (resolveSignalValue(value.lineInteractionWidth) ?? strokeWidth) as number,\n    \"TrajectorySeries lineInteractionWidth\",\n  );\n  const cursor = resolveSignalValue(value.cursor);\n  if (cursor !== undefined && typeof cursor !== \"string\")\n    throw new TypeError(\"TrajectorySeries: cursor must be a string.\");\n  return {\n    stroke: stroke as StrokeStyle,\n    strokeWidth,\n    lineInteractionWidth,\n    opacity: opacity(\n      (resolveSignalValue(value.opacity) ?? 1) as number,\n      \"TrajectorySeries opacity\",\n    ),\n    cursor,\n  };\n}\n\n/**\n * Draws one shared-style path connecting each participant or specimen trajectory.\n *\n * A missing, excluded, or non-finite coordinate ends only that group's current\n * run. Interleaved groups retain their source encounter order; trajectories are\n * never sorted by either actual or scheduled time.\n *\n * @param props - Observations, identities, coordinates, scales, and shared path paint.\n * @returns One batched ordinary Pibbl path containing source-ordered trajectory segments.\n * @see {@link TrajectorySeriesProps}\n */\nexport function TrajectorySeries<D>({\n  data: input,\n  group: groupInput,\n  x: xInput,\n  y: yInput,\n  xScale: xId,\n  yScale: yId,\n  defined,\n  style: styleInput,\n  ...events\n}: TrajectorySeriesProps<D>) {\n  const xs = useSeriesPosition(xId);\n  const ys = useNumericPosition(yId);\n  const data = pointData(resolveSignalValue(input), \"TrajectorySeries\");\n  const x = seriesAccessor(xInput);\n  const y = pointAccessor(yInput);\n  const group =\n    typeof groupInput === \"function\"\n      ? groupInput\n      : (datum: D) => datum[groupInput] as string | number | null | undefined;\n  const resolved = style(resolveSignalValue(styleInput) ?? {});\n  const last = new Map<string | number, readonly [number, number]>();\n  const path = new Path2D();\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    const row = withHooksForbidden(\n      \"TrajectorySeries: accessors cannot call hooks.\",\n      () => {\n        const identity = group(datum, i, data);\n        if (defined && !defined(datum, i, data)) return { group: identity };\n        return {\n          group: identity,\n          x: x(datum, i, data),\n          y: y(datum, i, data),\n        };\n      },\n    );\n    if (!row || row.group == null) continue;\n    if (\n      (typeof row.group !== \"string\" && typeof row.group !== \"number\") ||\n      (typeof row.group === \"number\" && !Number.isFinite(row.group))\n    )\n      throw new TypeError(\n        \"TrajectorySeries: group must be a string or number.\",\n      );\n    if (!(\"x\" in row) || !(\"y\" in row)) {\n      last.delete(row.group);\n      continue;\n    }\n    const px = mapSeriesPosition(xs, row.x);\n    const py = mapSeriesPosition(ys, row.y);\n    if (px === undefined || py === undefined) {\n      last.delete(row.group);\n      continue;\n    }\n    const prior = last.get(row.group);\n    if (prior) {\n      path.moveTo(prior[0], prior[1]);\n      path.lineTo(px, py);\n    }\n    last.set(row.group, [px, py]);\n  }\n  return <Path {...events} style={{ d: path, ...resolved }} />;\n}\n"],
+  "mappings": "AAiNS;AAjNT,SAAS,MAAM,0BAA0B;AAOzC,SAAS,0BAA0B;AAGnC,SAAS,SAAS,aAAa;AAC/B,SAAS,eAAe,iBAAiB;AACzC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA8EP,SAAS,MAAM,OAAyC;AACtD,MAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK;AACpE,UAAM,IAAI,UAAU,4CAA4C;AAClE,QAAM,QAAQ;AACd,aAAW,SAAS,OAAO,KAAK,KAAK;AACnC,QACE,CAAC;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,SAAS,KAAK;AAEhB,YAAM,IAAI;AAAA,QACR,6CAA6C,KAAK;AAAA,MACpD;AACJ,QAAM,SAAS,mBAAmB,MAAM,MAAM,KAAK;AACnD,QAAM,cAAc;AAAA,IACjB,mBAAmB,MAAM,WAAW,KAAK;AAAA,IAC1C;AAAA,EACF;AACA,QAAM,uBAAuB;AAAA,IAC1B,mBAAmB,MAAM,oBAAoB,KAAK;AAAA,IACnD;AAAA,EACF;AACA,QAAM,SAAS,mBAAmB,MAAM,MAAM;AAC9C,MAAI,WAAW,UAAa,OAAO,WAAW;AAC5C,UAAM,IAAI,UAAU,4CAA4C;AAClE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,MACN,mBAAmB,MAAM,OAAO,KAAK;AAAA,MACtC;AAAA,IACF;AAAA,IACA;AAAA,EACF;AACF;AAaO,SAAS,iBAAoB;AAAA,EAClC,MAAM;AAAA,EACN,OAAO;AAAA,EACP,GAAG;AAAA,EACH,GAAG;AAAA,EACH,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR;AAAA,EACA,OAAO;AAAA,EACP,GAAG;AACL,GAA6B;AAC3B,QAAM,KAAK,kBAAkB,GAAG;AAChC,QAAM,KAAK,mBAAmB,GAAG;AACjC,QAAM,OAAO,UAAU,mBAAmB,KAAK,GAAG,kBAAkB;AACpE,QAAM,IAAI,eAAe,MAAM;AAC/B,QAAM,IAAI,cAAc,MAAM;AAC9B,QAAM,QACJ,OAAO,eAAe,aAClB,aACA,CAAC,UAAa,MAAM,UAAU;AACpC,QAAM,WAAW,MAAM,mBAAmB,UAAU,KAAK,CAAC,CAAC;AAC3D,QAAM,OAAO,oBAAI,IAAgD;AACjE,QAAM,OAAO,IAAI,OAAO;AACxB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,QAAQ,KAAK,CAAC;AACpB,UAAM,MAAM;AAAA,MACV;AAAA,MACA,MAAM;AACJ,cAAM,WAAW,MAAM,OAAO,GAAG,IAAI;AACrC,YAAI,WAAW,CAAC,QAAQ,OAAO,GAAG,IAAI,EAAG,QAAO,EAAE,OAAO,SAAS;AAClE,eAAO;AAAA,UACL,OAAO;AAAA,UACP,GAAG,EAAE,OAAO,GAAG,IAAI;AAAA,UACnB,GAAG,EAAE,OAAO,GAAG,IAAI;AAAA,QACrB;AAAA,MACF;AAAA,IACF;AACA,QAAI,CAAC,OAAO,IAAI,SAAS,KAAM;AAC/B,QACG,OAAO,IAAI,UAAU,YAAY,OAAO,IAAI,UAAU,YACtD,OAAO,IAAI,UAAU,YAAY,CAAC,OAAO,SAAS,IAAI,KAAK;AAE5D,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AACF,QAAI,EAAE,OAAO,QAAQ,EAAE,OAAO,MAAM;AAClC,WAAK,OAAO,IAAI,KAAK;AACrB;AAAA,IACF;AACA,UAAM,KAAK,kBAAkB,IAAI,IAAI,CAAC;AACtC,UAAM,KAAK,kBAAkB,IAAI,IAAI,CAAC;AACtC,QAAI,OAAO,UAAa,OAAO,QAAW;AACxC,WAAK,OAAO,IAAI,KAAK;AACrB;AAAA,IACF;AACA,UAAM,QAAQ,KAAK,IAAI,IAAI,KAAK;AAChC,QAAI,OAAO;AACT,WAAK,OAAO,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;AAC9B,WAAK,OAAO,IAAI,EAAE;AAAA,IACpB;AACA,SAAK,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;AAAA,EAC9B;AACA,SAAO,oBAAC,QAAM,GAAG,QAAQ,OAAO,EAAE,GAAG,MAAM,GAAG,SAAS,GAAG;AAC5D;",
+  "names": []
+}

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

@@ -7,6 +7,7 @@ import type { PointAccessor } from "./point-types.js";
 import type { ScaleAdjust } from "./scale-adjust.js";
 import type { BoxStyle, PibblNode, LayoutItemStyle, LayoutBox, SignalValue } from "@pibbl/core";
 import type { SignalStyle } from "@pibbl/core/internal";
+import type { SeriesCurve } from "./curve-definition.js";
 /**
  * A string or symbol identifying a scale within visualization context.
  *
@@ -236,7 +237,7 @@ export interface ResolvedLogScale extends Omit<ResolvedLinearScale, "type"> {
     readonly base: number;
 }
 /** A numeric or categorical mapping snapshot. See {@link ResolvedContinuousScale}. */
-export type ResolvedScale = ResolvedContinuousScale | ResolvedBandScale | ResolvedPointScale;
+export type ResolvedScale = ResolvedContinuousScale | ResolvedBandScale | ResolvedPointScale | import("./trading-time-scale.js").ResolvedTradingTimeScale;
 /** Signed logarithmic scale inputs. See {@link LinearScaleProps}. */
 export interface SymlogScaleProps extends LinearScaleProps {
     /** Positive linear-to-log transition constant in domain units, default 1. */
@@ -369,12 +370,25 @@ export type LineCoordinate = number | null | undefined;
 export type LineAccessor<D> = {
     [K in keyof D]-?: D[K] extends LineCoordinate ? K : never;
 }[keyof D] | ((datum: D, index: number, data: readonly D[]) => LineCoordinate);
+/** A numeric or categorical position, or a missing value. @see {@link SeriesAccessor} */
+export type SeriesCoordinate = number | string | null | undefined;
+/**
+ * Extracts one position for a line, point, or custom mark.
+ * @param datum - Original record.
+ * @param index - Original record index.
+ * @param data - Complete source records.
+ * @returns A numeric or categorical position. See {@link SeriesCoordinate}.
+ * @see {@link LineSeriesProps}
+ */
+export type SeriesAccessor<D> = {
+    [K in keyof D]-?: D[K] extends SeriesCoordinate ? K : never;
+}[keyof D] | ((datum: D, index: number, data: readonly D[]) => SeriesCoordinate);
 /**
  * The supported interpolation mode for a line series.
  *
  * @see {@link LineSeriesProps}
  */
-export type LineCurve = "linear";
+export type LineCurve = "linear" | SeriesCurve;
 /**
  * Supported geometry and presentation properties for LineSeries.
  *
@@ -413,10 +427,12 @@ export interface LineSeriesProps<D> extends PibblEventHandlers, PibblEventPartic
      * Application data supplied to the component or reported by the event. See {@link SignalValue}.
      */
     readonly data: SignalValue<readonly D[]>;
+    /** Optional committed numeric observation capture; no query execution during paint. */
+    readonly inspection?: import("../inspection/capture-types.js").NumericInspectionRef<D>;
     /** Property key or callback extracting the horizontal domain coordinate. See {@link LineAccessor}. */
-    readonly x: LineAccessor<D>;
+    readonly x: SeriesAccessor<D>;
     /** Property key or callback extracting the vertical domain coordinate. See {@link LineAccessor}. */
-    readonly y: LineAccessor<D>;
+    readonly y: SeriesAccessor<D>;
     /** The scale used to map horizontal data coordinates. See {@link ScaleId}. */
     readonly xScale: ScaleId;
     /** The scale used to map vertical data coordinates. See {@link ScaleId}. */

package/dist/features/viz/lib/use-continuous-scale.js

@@ -1,7 +1,12 @@
 import { scaleView } from "./scale-view.js";
 const views = /* @__PURE__ */ new WeakMap();
 function useContinuousScale(id) {
-  return scaleView(views, id, "useContinuousScale", (kind) => kind !== "band" && kind !== "point");
+  return scaleView(
+    views,
+    id,
+    "useContinuousScale",
+    (kind) => kind !== "band" && kind !== "point" && kind !== "trading-time"
+  );
 }
 export {
   useContinuousScale

package/dist/features/viz/lib/use-continuous-scale.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/viz/lib/use-continuous-scale.ts"],
-  "sourcesContent": ["import type { Signal } from \"@pibbl/core\";\nimport type { ResolvedContinuousScale, ResolvedScale, ScaleId } from \"./types.js\";\nimport { scaleView } from \"./scale-view.js\";\nconst views = new WeakMap<Signal<ResolvedScale>, Signal<ResolvedContinuousScale>>();\n/**\n * Reads an ancestor continuous scale as a stable, shared readonly signal.\n * @param id - Ancestor scale identity. See {@link ScaleId}.\n * @returns The reactive mapping. See {@link ResolvedContinuousScale} and {@link Signal}.\n */\nexport function useContinuousScale(id: ScaleId): Signal<ResolvedContinuousScale> {\n  return scaleView(views, id, \"useContinuousScale\", (kind) => kind !== \"band\" && kind !== \"point\");\n}\n"],
-  "mappings": "AAEA,SAAS,iBAAiB;AAC1B,MAAM,QAAQ,oBAAI,QAAgE;AAM3E,SAAS,mBAAmB,IAA8C;AAC/E,SAAO,UAAU,OAAO,IAAI,sBAAsB,CAAC,SAAS,SAAS,UAAU,SAAS,OAAO;AACjG;",
+  "sourcesContent": ["import type { Signal } from \"@pibbl/core\";\nimport type {\n  ResolvedContinuousScale,\n  ResolvedScale,\n  ScaleId,\n} from \"./types.js\";\nimport { scaleView } from \"./scale-view.js\";\nconst views = new WeakMap<\n  Signal<ResolvedScale>,\n  Signal<ResolvedContinuousScale>\n>();\n/**\n * Reads an ancestor continuous scale as a stable, shared readonly signal.\n * @param id - Ancestor scale identity. See {@link ScaleId}.\n * @returns The reactive mapping. See {@link ResolvedContinuousScale} and {@link Signal}.\n */\nexport function useContinuousScale(\n  id: ScaleId,\n): Signal<ResolvedContinuousScale> {\n  return scaleView(\n    views,\n    id,\n    \"useContinuousScale\",\n    (kind) => kind !== \"band\" && kind !== \"point\" && kind !== \"trading-time\",\n  );\n}\n"],
+  "mappings": "AAMA,SAAS,iBAAiB;AAC1B,MAAM,QAAQ,oBAAI,QAGhB;AAMK,SAAS,mBACd,IACiC;AACjC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,CAAC,SAAS,SAAS,UAAU,SAAS,WAAW,SAAS;AAAA,EAC5D;AACF;",
   "names": []
 }

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

@@ -0,0 +1,59 @@
+import { type FillStyle, type StrokeStyle, type SignalValue, type PibblEventHandlers, type PibblEventParticipationOptions, type PibblNode } from "@pibbl/core";
+import type { LineAccessor, ScaleId } from "./types.js";
+import type { VolumeInspectionRef } from "../inspection/volume.js";
+/** Local column presentation; color meaning is supplied by the application.
+ * @see {@link VolumeSeries}
+ */
+export interface VolumeSeriesStyle {
+    /** Positive column width in local logical units; default 70% spacing capped at 12. */
+    readonly width?: number;
+    /** Interior paint; defaults to teal. */
+    readonly fill?: FillStyle;
+    /** Optional column outline paint. */
+    readonly stroke?: StrokeStyle;
+    /** Nonnegative outline width in local units; default 1. */
+    readonly strokeWidth?: number;
+    /** Paint opacity from zero through one; default 1. */
+    readonly opacity?: number;
+    /** Cursor when the series owns coordinate targeting. */
+    readonly cursor?: string;
+}
+/** Time-aligned volume columns with an independent numeric y-scale.
+ * @see {@link VolumeSeries}
+ */
+export interface VolumeSeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /** Original records or a signal of records; never sorted or mutated. */
+    readonly data: SignalValue<readonly D[]>;
+    /** UTC-millisecond property or callback; missing/nonfinite values skip the row. */
+    readonly time: LineAccessor<D>;
+    /** Nonnegative volume property or callback; missing/nonfinite values skip the row. */
+    readonly volume: LineAccessor<D>;
+    /** Selects source records before evaluating accessors.
+     * @param datum - Original record.
+     * @param index - Original source index.
+     * @param data - Complete source array.
+     * @returns Whether the row participates.
+     */
+    readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;
+    /** Numeric time scale identity. */
+    readonly xScale: ScaleId;
+    /** Independent numeric volume scale identity; the baseline is zero. */
+    readonly yScale: ScaleId;
+    /** Constant presentation or a hook-free per-record resolver.
+     * @param datum - Original record.
+     * @param index - Original source index.
+     * @param data - Complete source array.
+     * @returns Column presentation.
+     */
+    readonly style?: SignalValue<VolumeSeriesStyle> | ((datum: D, index: number, data: readonly D[]) => VolumeSeriesStyle);
+    /** Optional committed capture; importing the renderer does not import inspection queries. */
+    readonly inspection?: VolumeInspectionRef<D>;
+}
+/**
+ * Paints source-ordered time-aligned volume columns, batching adjacent equal styles.
+ * Zero volume is recorded but has no painted coverage. Finite negative volume rejects.
+ * @param props - Original records, numeric scales, accessors and optional capture.
+ * @returns Ordinary Pibbl paint/event composition.
+ * @see {@link VolumeSeriesProps}
+ */
+export declare function VolumeSeries<D>({ data: input, time: timeInput, volume: volumeInput, xScale, yScale, defined, style: styleInput, inspection, pointerEvents, ...events }: VolumeSeriesProps<D>): PibblNode;

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

@@ -0,0 +1,117 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import { useNumericPosition } from "./series-position.js";
+import {
+  Group,
+  Path,
+  resolveSignalValue
+} from "@pibbl/core";
+import { withHooksForbidden } from "@pibbl/core/internal";
+import { useContinuousScale } from "./use-continuous-scale.js";
+import { pointAccessor, pointData, finiteCoordinate } from "./point-data.js";
+import { financialMarkWidth, volumeGeometry } from "./financial-geometry.js";
+import { opacity, width } from "./paint.js";
+function VolumeSeries({
+  data: input,
+  time: timeInput,
+  volume: volumeInput,
+  xScale,
+  yScale,
+  defined,
+  style: styleInput,
+  inspection,
+  pointerEvents,
+  ...events
+}) {
+  const xs = useNumericPosition(xScale), ys = useContinuousScale(yScale).get();
+  const data = pointData(resolveSignalValue(input), "VolumeSeries");
+  const time = pointAccessor(timeInput), volume = pointAccessor(volumeInput);
+  const rows = [];
+  for (let i = 0; i < data.length; i++) {
+    const datum = data[i];
+    if (defined && !defined(datum, i, data)) continue;
+    const t = time(datum, i, data), v = volume(datum, i, data);
+    if (!finiteCoordinate(t) || !finiteCoordinate(v)) continue;
+    if (v < 0)
+      throw new RangeError(
+        `VolumeSeries: negative volume at source index ${i}.`
+      );
+    rows.push({
+      datum,
+      sourceIndex: i,
+      time: t,
+      volume: v,
+      x: xs.map(t),
+      y: ys.map(v)
+    });
+  }
+  const positions = rows.map((row) => row.x), baselineY = ys.map(0), defaultWidth = financialMarkWidth(positions);
+  const specified = typeof styleInput === "function" ? styleInput : resolveSignalValue(styleInput);
+  const marks = inspection ? [] : void 0;
+  const batches = [];
+  for (const row of rows) {
+    const style = typeof specified === "function" ? withHooksForbidden(
+      "VolumeSeries style callback",
+      () => specified(row.datum, row.sourceIndex, data)
+    ) : specified ?? {};
+    const markWidth = style.width === void 0 ? defaultWidth : financialMarkWidth([], { width: style.width });
+    const b = volumeGeometry({
+      centerX: row.x,
+      valueY: row.y,
+      baselineY,
+      width: markWidth
+    });
+    const fill = style.fill ?? "#087f8c", stroke = style.stroke, strokeWidth = width(style.strokeWidth ?? 1, "VolumeSeries"), alpha = opacity(style.opacity ?? 1, "VolumeSeries");
+    marks?.push(
+      Object.freeze({
+        datum: row.datum,
+        sourceIndex: row.sourceIndex,
+        time: row.time,
+        volume: row.volume,
+        baseline: 0,
+        anchorLocal: Object.freeze({ x: row.x, y: row.y }),
+        boundsLocal: b,
+        fill: !!fill && alpha > 0,
+        strokeWidthLocal: stroke && alpha > 0 ? strokeWidth : 0
+      })
+    );
+    if (b.height === 0 || alpha === 0) continue;
+    let batch = batches.at(-1);
+    const half = stroke ? strokeWidth / 2 : 0, minX = b.x - half, maxX = b.x + b.width + half;
+    if (!batch || minX < batch.maxX && maxX > batch.minX || batch.fill !== fill || batch.stroke !== stroke || batch.strokeWidth !== strokeWidth || batch.opacity !== alpha || batch.cursor !== style.cursor) {
+      batch = {
+        path: new Path2D(),
+        fill,
+        stroke,
+        strokeWidth,
+        opacity: alpha,
+        cursor: style.cursor,
+        minX,
+        maxX
+      };
+      batches.push(batch);
+    }
+    batch.minX = Math.min(batch.minX, minX);
+    batch.maxX = Math.max(batch.maxX, maxX);
+    batch.path.rect(b.x, b.y, b.width, b.height);
+  }
+  inspection?.capture({ marks, xScale: xs, yScale: ys });
+  return /* @__PURE__ */ jsx(Group, { ...events, children: batches.map((batch, index) => /* @__PURE__ */ jsx(
+    Path,
+    {
+      pointerEvents,
+      style: {
+        d: batch.path,
+        fill: batch.fill,
+        stroke: batch.stroke,
+        strokeWidth: batch.strokeWidth,
+        opacity: batch.opacity,
+        cursor: batch.cursor
+      }
+    },
+    index
+  )) });
+}
+export {
+  VolumeSeries
+};
+//# sourceMappingURL=volume-series.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/volume-series.tsx"],
+  "sourcesContent": ["import { useNumericPosition } from \"./series-position.js\";\nimport {\n  Group,\n  Path,\n  resolveSignalValue,\n  type FillStyle,\n  type StrokeStyle,\n  type SignalValue,\n  type PibblEventHandlers,\n  type PibblEventParticipationOptions,\n  type PibblNode,\n} from \"@pibbl/core\";\nimport { withHooksForbidden } from \"@pibbl/core/internal\";\nimport type { LineAccessor, ScaleId } from \"./types.js\";\nimport type {\n  VolumeInspectionRef,\n  CapturedVolumeMark,\n} from \"../inspection/volume.js\";\nimport { useContinuousScale } from \"./use-continuous-scale.js\";\nimport { pointAccessor, pointData, finiteCoordinate } from \"./point-data.js\";\nimport { financialMarkWidth, volumeGeometry } from \"./financial-geometry.js\";\nimport { opacity, width } from \"./paint.js\";\n\n/** Local column presentation; color meaning is supplied by the application.\n * @see {@link VolumeSeries}\n */\nexport interface VolumeSeriesStyle {\n  /** Positive column width in local logical units; default 70% spacing capped at 12. */\n  readonly width?: number;\n  /** Interior paint; defaults to teal. */\n  readonly fill?: FillStyle;\n  /** Optional column outline paint. */\n  readonly stroke?: StrokeStyle;\n  /** Nonnegative outline width in local units; default 1. */\n  readonly strokeWidth?: number;\n  /** Paint opacity from zero through one; default 1. */\n  readonly opacity?: number;\n  /** Cursor when the series owns coordinate targeting. */\n  readonly cursor?: string;\n}\n/** Time-aligned volume columns with an independent numeric y-scale.\n * @see {@link VolumeSeries}\n */\nexport interface VolumeSeriesProps<D>\n  extends PibblEventHandlers, PibblEventParticipationOptions {\n  /** Original records or a signal of records; never sorted or mutated. */\n  readonly data: SignalValue<readonly D[]>;\n  /** UTC-millisecond property or callback; missing/nonfinite values skip the row. */\n  readonly time: LineAccessor<D>;\n  /** Nonnegative volume property or callback; missing/nonfinite values skip the row. */\n  readonly volume: LineAccessor<D>;\n  /** Selects source records before evaluating accessors.\n   * @param datum - Original record.\n   * @param index - Original source index.\n   * @param data - Complete source array.\n   * @returns Whether the row participates.\n   */\n  readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;\n  /** Numeric time scale identity. */\n  readonly xScale: ScaleId;\n  /** Independent numeric volume scale identity; the baseline is zero. */\n  readonly yScale: ScaleId;\n  /** Constant presentation or a hook-free per-record resolver.\n   * @param datum - Original record.\n   * @param index - Original source index.\n   * @param data - Complete source array.\n   * @returns Column presentation.\n   */\n  readonly style?:\n    | SignalValue<VolumeSeriesStyle>\n    | ((datum: D, index: number, data: readonly D[]) => VolumeSeriesStyle);\n  /** Optional committed capture; importing the renderer does not import inspection queries. */\n  readonly inspection?: VolumeInspectionRef<D>;\n}\n/**\n * Paints source-ordered time-aligned volume columns, batching adjacent equal styles.\n * Zero volume is recorded but has no painted coverage. Finite negative volume rejects.\n * @param props - Original records, numeric scales, accessors and optional capture.\n * @returns Ordinary Pibbl paint/event composition.\n * @see {@link VolumeSeriesProps}\n */\nexport function VolumeSeries<D>({\n  data: input,\n  time: timeInput,\n  volume: volumeInput,\n  xScale,\n  yScale,\n  defined,\n  style: styleInput,\n  inspection,\n  pointerEvents,\n  ...events\n}: VolumeSeriesProps<D>): PibblNode {\n  const xs = useNumericPosition(xScale),\n    ys = useContinuousScale(yScale).get();\n  const data = pointData(resolveSignalValue(input), \"VolumeSeries\");\n  const time = pointAccessor(timeInput),\n    volume = pointAccessor(volumeInput);\n  const rows: {\n    datum: D;\n    sourceIndex: number;\n    time: number;\n    volume: number;\n    x: number;\n    y: number;\n  }[] = [];\n  for (let i = 0; i < data.length; i++) {\n    const datum = data[i];\n    if (defined && !defined(datum, i, data)) continue;\n    const t = time(datum, i, data),\n      v = volume(datum, i, data);\n    if (!finiteCoordinate(t) || !finiteCoordinate(v)) continue;\n    if (v < 0)\n      throw new RangeError(\n        `VolumeSeries: negative volume at source index ${i}.`,\n      );\n    rows.push({\n      datum,\n      sourceIndex: i,\n      time: t,\n      volume: v,\n      x: xs.map(t),\n      y: ys.map(v),\n    });\n  }\n  const positions = rows.map((row) => row.x),\n    baselineY = ys.map(0),\n    defaultWidth = financialMarkWidth(positions);\n  const specified =\n    typeof styleInput === \"function\"\n      ? styleInput\n      : resolveSignalValue(styleInput);\n  const marks: CapturedVolumeMark<D>[] | undefined = inspection\n    ? []\n    : undefined;\n  const batches: {\n    path: Path2D;\n    fill: FillStyle;\n    stroke: StrokeStyle | undefined;\n    strokeWidth: number;\n    opacity: number;\n    cursor: string | undefined;\n    minX: number;\n    maxX: number;\n  }[] = [];\n  for (const row of rows) {\n    const style =\n      typeof specified === \"function\"\n        ? withHooksForbidden(\"VolumeSeries style callback\", () =>\n            specified(row.datum, row.sourceIndex, data),\n          )\n        : (specified ?? {});\n    const markWidth =\n      style.width === undefined\n        ? defaultWidth\n        : financialMarkWidth([], { width: style.width });\n    const b = volumeGeometry({\n      centerX: row.x,\n      valueY: row.y,\n      baselineY,\n      width: markWidth,\n    });\n    const fill = style.fill ?? \"#087f8c\",\n      stroke = style.stroke,\n      strokeWidth = width(style.strokeWidth ?? 1, \"VolumeSeries\"),\n      alpha = opacity(style.opacity ?? 1, \"VolumeSeries\");\n    marks?.push(\n      Object.freeze({\n        datum: row.datum,\n        sourceIndex: row.sourceIndex,\n        time: row.time,\n        volume: row.volume,\n        baseline: 0,\n        anchorLocal: Object.freeze({ x: row.x, y: row.y }),\n        boundsLocal: b,\n        fill: !!fill && alpha > 0,\n        strokeWidthLocal: stroke && alpha > 0 ? strokeWidth : 0,\n      }),\n    );\n    if (b.height === 0 || alpha === 0) continue;\n    let batch = batches.at(-1);\n    const half = stroke ? strokeWidth / 2 : 0,\n      minX = b.x - half,\n      maxX = b.x + b.width + half;\n    if (\n      !batch ||\n      (minX < batch.maxX && maxX > batch.minX) ||\n      batch.fill !== fill ||\n      batch.stroke !== stroke ||\n      batch.strokeWidth !== strokeWidth ||\n      batch.opacity !== alpha ||\n      batch.cursor !== style.cursor\n    ) {\n      batch = {\n        path: new Path2D(),\n        fill,\n        stroke,\n        strokeWidth,\n        opacity: alpha,\n        cursor: style.cursor,\n        minX,\n        maxX,\n      };\n      batches.push(batch);\n    }\n    batch.minX = Math.min(batch.minX, minX);\n    batch.maxX = Math.max(batch.maxX, maxX);\n    batch.path.rect(b.x, b.y, b.width, b.height);\n  }\n  inspection?.capture({ marks: marks!, xScale: xs, yScale: ys });\n  return (\n    <Group {...events}>\n      {batches.map((batch, index) => (\n        <Path\n          key={index}\n          pointerEvents={pointerEvents}\n          style={{\n            d: batch.path,\n            fill: batch.fill,\n            stroke: batch.stroke,\n            strokeWidth: batch.strokeWidth,\n            opacity: batch.opacity,\n            cursor: batch.cursor,\n          }}\n        />\n      ))}\n    </Group>\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,71 @@
+import type { FillStyle, PibblEventHandlers, PibblEventParticipationOptions, SignalValue, StrokeStyle } from "@pibbl/core";
+import type { SignalStyle } from "@pibbl/core/internal";
+import type { LineAccessor, ScaleId, SeriesAccessor } from "./types.js";
+/**
+ * A data property or callback extracting a nonnegative research weight.
+ *
+ * @see {@link WeightedPointSeriesProps}
+ */
+export type WeightAccessor<D> = LineAccessor<D>;
+/** Shared presentation for {@link WeightedPointSeries}. */
+export interface WeightedPointSeriesStyle {
+    /** Paint used for point interiors. Defaults to `#087f8c`. */
+    readonly fill?: FillStyle;
+    /** Paint used for point outlines. Defaults to no outline. */
+    readonly stroke?: StrokeStyle;
+    /** Outline width in local coordinate units. Defaults to 1. */
+    readonly strokeWidth?: number;
+    /** Opacity in the inclusive range [0, 1]. Defaults to 1. */
+    readonly opacity?: number;
+    /** Pointer cursor while the series owns a target. */
+    readonly cursor?: string;
+}
+/**
+ * Authored inputs for {@link WeightedPointSeries}.
+ *
+ * Weights are supplied data, not calculated precision, sample size, or evidence.
+ * The zero baseline and squared-radius interpolation make displayed area linear in
+ * the supplied weight.
+ */
+export interface WeightedPointSeriesProps<D> extends PibblEventHandlers, PibblEventParticipationOptions {
+    /** Readonly data or a signal containing it. */
+    readonly data: SignalValue<readonly D[]>;
+    /** Horizontal coordinate property or synchronous accessor. */
+    readonly x: SeriesAccessor<D>;
+    /** Vertical coordinate property or synchronous accessor. */
+    readonly y: SeriesAccessor<D>;
+    /** Nonnegative supplied weight property or synchronous accessor. */
+    readonly weight: WeightAccessor<D>;
+    /** Scale used to map x coordinates. */
+    readonly xScale: ScaleId;
+    /** Scale used to map y coordinates. */
+    readonly yScale: ScaleId;
+    /** Supplied inclusive weight extent. The lower bound must be zero. */
+    readonly weightDomain: readonly [0, number];
+    /** Radius extent `[0, maximumRadius]`; defaults to `[0, 6]`. */
+    readonly radiusRange?: readonly [0, number];
+    /**
+     * Excludes a datum before coordinate and weight accessors run.
+     * @param datum - Candidate source datum.
+     * @param index - Zero-based source index.
+     * @param data - Complete source data array.
+     * @returns Whether this datum contributes a mark.
+     */
+    readonly defined?: (datum: D, index: number, data: readonly D[]) => boolean;
+    /** Shared presentation. Whole-object and shallow field signals are supported. */
+    readonly style?: SignalValue<SignalStyle<WeightedPointSeriesStyle>>;
+}
+/**
+ * Draws batched circles whose visible area is proportional to supplied weights.
+ *
+ * Nullish weights and zero weights omit their marks. Finite positive weights must
+ * fall inside `weightDomain`; the component never clamps or infers weights.
+ * `data` and shared style signals schedule ordinary Pibbl updates. The component
+ * owns no retained resources and returns one ordinary Pibbl pointer target.
+ *
+ * @param props - Supplied observations, coordinate and weight accessors, scales, and paint.
+ * See {@link WeightedPointSeriesProps}.
+ * @returns One batched Pibbl Path whose mark area is proportional to each supplied weight.
+ * @see {@link WeightedPointSeriesProps}
+ */
+export declare function WeightedPointSeries<D>({ data: input, x: xInput, y: yInput, weight: weightInput, xScale: xId, yScale: yId, weightDomain, radiusRange, defined, style: styleInput, ...events }: WeightedPointSeriesProps<D>): import("../../../jsx-runtime.js").JSX.Element;