@pibbl/core 0.0.1 → 0.0.3-alpha.85.1

package/dist/features/viz/lib/use-bar-scale.d.ts

@@ -0,0 +1,8 @@
+import type { Signal } from "@pibbl/core";
+import type { ResolvedBandScale, ScaleId } from "./types.js";
+/**
+ * Reads an ancestor band scale as a stable, shared readonly signal.
+ * @param id - Ancestor scale identity. See {@link ScaleId}.
+ * @returns The reactive mapping. See {@link ResolvedBandScale} and {@link Signal}.
+ */
+export declare function useBarScale(id: ScaleId): Signal<ResolvedBandScale>;

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

@@ -0,0 +1,9 @@
+import { scaleView } from "./scale-view.js";
+const views = /* @__PURE__ */ new WeakMap();
+function useBarScale(id) {
+  return scaleView(views, id, "useBarScale", (kind) => kind === "band");
+}
+export {
+  useBarScale
+};
+//# sourceMappingURL=use-bar-scale.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/use-bar-scale.ts"],
+  "sourcesContent": ["import type { Signal } from \"@pibbl/core\";\nimport type { ResolvedBandScale, ResolvedScale, ScaleId } from \"./types.js\";\nimport { scaleView } from \"./scale-view.js\";\nconst views = new WeakMap<Signal<ResolvedScale>, Signal<ResolvedBandScale>>();\n/**\n * Reads an ancestor band scale as a stable, shared readonly signal.\n * @param id - Ancestor scale identity. See {@link ScaleId}.\n * @returns The reactive mapping. See {@link ResolvedBandScale} and {@link Signal}.\n */\nexport function useBarScale(id: ScaleId): Signal<ResolvedBandScale> {\n  return scaleView(views, id, \"useBarScale\", (kind) => kind === \"band\");\n}\n"],
+  "mappings": "AAEA,SAAS,iBAAiB;AAC1B,MAAM,QAAQ,oBAAI,QAA0D;AAMrE,SAAS,YAAY,IAAwC;AAClE,SAAO,UAAU,OAAO,IAAI,eAAe,CAAC,SAAS,SAAS,MAAM;AACtE;",
+  "names": []
+}

package/dist/features/viz/lib/use-continuous-scale.d.ts

@@ -0,0 +1,8 @@
+import type { Signal } from "@pibbl/core";
+import type { ResolvedContinuousScale, ScaleId } from "./types.js";
+/**
+ * Reads an ancestor continuous scale as a stable, shared readonly signal.
+ * @param id - Ancestor scale identity. See {@link ScaleId}.
+ * @returns The reactive mapping. See {@link ResolvedContinuousScale} and {@link Signal}.
+ */
+export declare function useContinuousScale(id: ScaleId): Signal<ResolvedContinuousScale>;

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

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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/use-continuous-scale.ts"],
+  "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/use-linear-scale.d.ts

@@ -0,0 +1,8 @@
+import type { Signal } from "@pibbl/core";
+import type { ResolvedLinearScale, ScaleId } from "./types.js";
+/**
+ * Reads an ancestor linear scale as a stable, shared readonly signal.
+ * @param id - Ancestor scale identity. See {@link ScaleId}.
+ * @returns The reactive mapping. See {@link ResolvedLinearScale} and {@link Signal}.
+ */
+export declare function useLinearScale(id: ScaleId): Signal<ResolvedLinearScale>;

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

@@ -0,0 +1,9 @@
+import { scaleView } from "./scale-view.js";
+const views = /* @__PURE__ */ new WeakMap();
+function useLinearScale(id) {
+  return scaleView(views, id, "useLinearScale", (kind) => kind === "linear");
+}
+export {
+  useLinearScale
+};
+//# sourceMappingURL=use-linear-scale.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/use-linear-scale.ts"],
+  "sourcesContent": ["import type { Signal } from \"@pibbl/core\";\nimport type { ResolvedLinearScale, ResolvedScale, ScaleId } from \"./types.js\";\nimport { scaleView } from \"./scale-view.js\";\nconst views = new WeakMap<Signal<ResolvedScale>, Signal<ResolvedLinearScale>>();\n/**\n * Reads an ancestor linear scale as a stable, shared readonly signal.\n * @param id - Ancestor scale identity. See {@link ScaleId}.\n * @returns The reactive mapping. See {@link ResolvedLinearScale} and {@link Signal}.\n */\nexport function useLinearScale(id: ScaleId): Signal<ResolvedLinearScale> {\n  return scaleView(views, id, \"useLinearScale\", (kind) => kind === \"linear\");\n}\n"],
+  "mappings": "AAEA,SAAS,iBAAiB;AAC1B,MAAM,QAAQ,oBAAI,QAA4D;AAMvE,SAAS,eAAe,IAA0C;AACvE,SAAO,UAAU,OAAO,IAAI,kBAAkB,CAAC,SAAS,SAAS,QAAQ;AAC3E;",
+  "names": []
+}

package/dist/features/viz/lib/use-log-scale.d.ts

@@ -0,0 +1,8 @@
+import type { Signal } from "@pibbl/core";
+import type { ResolvedLogScale, ScaleId } from "./types.js";
+/**
+ * Reads an ancestor logarithmic scale as a stable shared readonly signal.
+ * @param id - Ancestor scale identity. See {@link ScaleId}.
+ * @returns The reactive logarithmic mapping. See {@link ResolvedLogScale}.
+ */
+export declare function useLogScale(id: ScaleId): Signal<ResolvedLogScale>;

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

@@ -0,0 +1,9 @@
+import { scaleView } from "./scale-view.js";
+const views = /* @__PURE__ */ new WeakMap();
+function useLogScale(id) {
+  return scaleView(views, id, "useLogScale", (kind) => kind === "log");
+}
+export {
+  useLogScale
+};
+//# sourceMappingURL=use-log-scale.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/use-log-scale.ts"],
+  "sourcesContent": ["import type { Signal } from \"@pibbl/core\";\nimport type { ResolvedLogScale, ResolvedScale, ScaleId } from \"./types.js\";\nimport { scaleView } from \"./scale-view.js\";\nconst views = new WeakMap<Signal<ResolvedScale>, Signal<ResolvedLogScale>>();\n/**\n * Reads an ancestor logarithmic scale as a stable shared readonly signal.\n * @param id - Ancestor scale identity. See {@link ScaleId}.\n * @returns The reactive logarithmic mapping. See {@link ResolvedLogScale}.\n */\nexport function useLogScale(id: ScaleId): Signal<ResolvedLogScale> {\n  return scaleView(views, id, \"useLogScale\", kind => kind === \"log\");\n}\n"],
+  "mappings": "AAEA,SAAS,iBAAiB;AAC1B,MAAM,QAAQ,oBAAI,QAAyD;AAMpE,SAAS,YAAY,IAAuC;AACjE,SAAO,UAAU,OAAO,IAAI,eAAe,UAAQ,SAAS,KAAK;AACnE;",
+  "names": []
+}

package/dist/features/viz/lib/use-point-scale.d.ts

@@ -0,0 +1,8 @@
+import type { Signal } from "@pibbl/core";
+import type { ResolvedPointScale, ScaleId } from "./types.js";
+/**
+ * Reads an ancestor point scale as a stable shared readonly signal.
+ * @param id - Ancestor scale identity. See {@link ScaleId}.
+ * @returns The reactive mapping. See {@link ResolvedPointScale}.
+ */
+export declare function usePointScale(id: ScaleId): Signal<ResolvedPointScale>;

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

@@ -0,0 +1,9 @@
+import { scaleView } from "./scale-view.js";
+const views = /* @__PURE__ */ new WeakMap();
+function usePointScale(id) {
+  return scaleView(views, id, "usePointScale", (kind) => kind === "point");
+}
+export {
+  usePointScale
+};
+//# sourceMappingURL=use-point-scale.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/use-point-scale.ts"],
+  "sourcesContent": ["import type { Signal } from \"@pibbl/core\";\nimport type { ResolvedPointScale, ResolvedScale, ScaleId } from \"./types.js\";\nimport { scaleView } from \"./scale-view.js\";\nconst views = new WeakMap<Signal<ResolvedScale>, Signal<ResolvedPointScale>>();\n/**\n * Reads an ancestor point scale as a stable shared readonly signal.\n * @param id - Ancestor scale identity. See {@link ScaleId}.\n * @returns The reactive mapping. See {@link ResolvedPointScale}.\n */\nexport function usePointScale(id: ScaleId): Signal<ResolvedPointScale> {\n  return scaleView(views, id, \"usePointScale\", kind => kind === \"point\");\n}\n"],
+  "mappings": "AAEA,SAAS,iBAAiB;AAC1B,MAAM,QAAQ,oBAAI,QAA2D;AAMtE,SAAS,cAAc,IAAyC;AACrE,SAAO,UAAU,OAAO,IAAI,iBAAiB,UAAQ,SAAS,OAAO;AACvE;",
+  "names": []
+}

package/dist/features/viz/lib/use-symlog-scale.d.ts

@@ -0,0 +1,8 @@
+import type { Signal } from "@pibbl/core";
+import type { ResolvedSymlogScale, ScaleId } from "./types.js";
+/**
+ * Reads an ancestor symlog scale as a stable shared readonly signal.
+ * @param id - Ancestor scale identity. See {@link ScaleId}.
+ * @returns The reactive mapping. See {@link ResolvedSymlogScale}.
+ */
+export declare function useSymlogScale(id: ScaleId): Signal<ResolvedSymlogScale>;

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

@@ -0,0 +1,9 @@
+import { scaleView } from "./scale-view.js";
+const views = /* @__PURE__ */ new WeakMap();
+function useSymlogScale(id) {
+  return scaleView(views, id, "useSymlogScale", (kind) => kind === "symlog");
+}
+export {
+  useSymlogScale
+};
+//# sourceMappingURL=use-symlog-scale.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/use-symlog-scale.ts"],
+  "sourcesContent": ["import type { Signal } from \"@pibbl/core\";\nimport type { ResolvedSymlogScale, ResolvedScale, ScaleId } from \"./types.js\";\nimport { scaleView } from \"./scale-view.js\";\nconst views = new WeakMap<Signal<ResolvedScale>, Signal<ResolvedSymlogScale>>();\n/**\n * Reads an ancestor symlog scale as a stable shared readonly signal.\n * @param id - Ancestor scale identity. See {@link ScaleId}.\n * @returns The reactive mapping. See {@link ResolvedSymlogScale}.\n */\nexport function useSymlogScale(id: ScaleId): Signal<ResolvedSymlogScale> {\n  return scaleView(views, id, \"useSymlogScale\", kind => kind === \"symlog\");\n}\n"],
+  "mappings": "AAEA,SAAS,iBAAiB;AAC1B,MAAM,QAAQ,oBAAI,QAA4D;AAMvE,SAAS,eAAe,IAA0C;AACvE,SAAO,UAAU,OAAO,IAAI,kBAAkB,UAAQ,SAAS,QAAQ;AACzE;",
+  "names": []
+}

package/dist/features/viz/lib/use-utc-scale.d.ts

@@ -0,0 +1,8 @@
+import type { Signal } from "@pibbl/core";
+import type { ResolvedUtcScale, ScaleId } from "./types.js";
+/**
+ * Reads an ancestor utc scale as a stable, shared readonly signal.
+ * @param id - Ancestor scale identity. See {@link ScaleId}.
+ * @returns The reactive mapping. See {@link ResolvedUtcScale} and {@link Signal}.
+ */
+export declare function useUTCScale(id: ScaleId): Signal<ResolvedUtcScale>;

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

@@ -0,0 +1,9 @@
+import { scaleView } from "./scale-view.js";
+const views = /* @__PURE__ */ new WeakMap();
+function useUTCScale(id) {
+  return scaleView(views, id, "useUTCScale", (kind) => kind === "utc");
+}
+export {
+  useUTCScale
+};
+//# sourceMappingURL=use-utc-scale.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/use-utc-scale.ts"],
+  "sourcesContent": ["import type { Signal } from \"@pibbl/core\";\nimport type { ResolvedUtcScale, ResolvedScale, ScaleId } from \"./types.js\";\nimport { scaleView } from \"./scale-view.js\";\nconst views = new WeakMap<Signal<ResolvedScale>, Signal<ResolvedUtcScale>>();\n/**\n * Reads an ancestor utc scale as a stable, shared readonly signal.\n * @param id - Ancestor scale identity. See {@link ScaleId}.\n * @returns The reactive mapping. See {@link ResolvedUtcScale} and {@link Signal}.\n */\nexport function useUTCScale(id: ScaleId): Signal<ResolvedUtcScale> {\n  return scaleView(views, id, \"useUTCScale\", (kind) => kind === \"utc\");\n}\n"],
+  "mappings": "AAEA,SAAS,iBAAiB;AAC1B,MAAM,QAAQ,oBAAI,QAAyD;AAMpE,SAAS,YAAY,IAAuC;AACjE,SAAO,UAAU,OAAO,IAAI,eAAe,CAAC,SAAS,SAAS,KAAK;AACrE;",
+  "names": []
+}

package/dist/features/viz/lib/utc-labels.d.ts

@@ -0,0 +1,12 @@
+/** Locale used for compact UTC tick text. See {@link utcTickLabels}. */
+export interface UTCTickLabelOptions {
+    /** BCP 47 locale, default en-US. Calendar is always Gregorian; time zone is UTC. */
+    readonly locale?: string;
+}
+/**
+ * Creates compact labels with calendar context retained on every tick.
+ * @param values - At most 100 safe integer epoch milliseconds within Date range, in any order.
+ * @param options - Explicit locale; default en-US.
+ * @returns Frozen labels in input order. No geometry or scale state changes. See {@link UTCTickLabelOptions}.
+ */
+export declare function utcTickLabels(values: readonly number[], options?: UTCTickLabelOptions): readonly string[];

package/dist/features/viz/lib/utc-labels.js

@@ -0,0 +1,27 @@
+function utcTickLabels(values, options = {}) {
+  if (!Array.isArray(values) || values.length > 100 || values.some((v) => !Number.isSafeInteger(v) || Math.abs(v) > 864e13))
+    throw new RangeError("utcTickLabels requires at most 100 integer timestamps within Date range.");
+  const dates = values.map((value) => new Date(value));
+  const midnight = (date) => date.getUTCHours() === 0 && date.getUTCMinutes() === 0 && date.getUTCSeconds() === 0 && date.getUTCMilliseconds() === 0;
+  const months = dates.every((date) => midnight(date) && date.getUTCDate() === 1);
+  const years = months && dates.every((date) => date.getUTCMonth() === 0);
+  const days = dates.every(midnight);
+  const milliseconds = dates.some((date) => date.getUTCMilliseconds() !== 0);
+  const seconds = milliseconds || dates.some((date) => date.getUTCSeconds() !== 0);
+  const formatter = new Intl.DateTimeFormat(options.locale ?? "en-US", {
+    timeZone: "UTC",
+    calendar: "gregory",
+    year: "numeric",
+    ...years ? {} : { month: "short" },
+    ...months ? {} : { day: "numeric" },
+    ...days ? {} : { hour: "2-digit", minute: "2-digit", hourCycle: "h23" },
+    ...seconds ? { second: "2-digit" } : {},
+    ...milliseconds ? { fractionalSecondDigits: 3 } : {},
+    ...dates.some((date) => date.getUTCFullYear() <= 0) ? { era: "short" } : {}
+  });
+  return Object.freeze(dates.map((date) => formatter.format(date)));
+}
+export {
+  utcTickLabels
+};
+//# sourceMappingURL=utc-labels.js.map

package/dist/features/viz/lib/utc-labels.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/utc-labels.ts"],
+  "sourcesContent": ["/** Locale used for compact UTC tick text. See {@link utcTickLabels}. */\nexport interface UTCTickLabelOptions {\n  /** BCP 47 locale, default en-US. Calendar is always Gregorian; time zone is UTC. */\n  readonly locale?: string;\n}\n/**\n * Creates compact labels with calendar context retained on every tick.\n * @param values - At most 100 safe integer epoch milliseconds within Date range, in any order.\n * @param options - Explicit locale; default en-US.\n * @returns Frozen labels in input order. No geometry or scale state changes. See {@link UTCTickLabelOptions}.\n */\nexport function utcTickLabels(values: readonly number[], options: UTCTickLabelOptions = {}): readonly string[] {\n  if (!Array.isArray(values) || values.length > 100 || values.some(v => !Number.isSafeInteger(v) || Math.abs(v) > 8_640_000_000_000_000))\n    throw new RangeError(\"utcTickLabels requires at most 100 integer timestamps within Date range.\");\n  const dates = values.map(value => new Date(value));\n  const midnight = (date: Date) => date.getUTCHours() === 0 && date.getUTCMinutes() === 0 && date.getUTCSeconds() === 0 && date.getUTCMilliseconds() === 0;\n  const months = dates.every(date => midnight(date) && date.getUTCDate() === 1);\n  const years = months && dates.every(date => date.getUTCMonth() === 0);\n  const days = dates.every(midnight);\n  const milliseconds = dates.some(date => date.getUTCMilliseconds() !== 0);\n  const seconds = milliseconds || dates.some(date => date.getUTCSeconds() !== 0);\n  const formatter = new Intl.DateTimeFormat(options.locale ?? \"en-US\", {\n    timeZone: \"UTC\", calendar: \"gregory\", year: \"numeric\",\n    ...(years ? {} : { month: \"short\" as const }),\n    ...(months ? {} : { day: \"numeric\" as const }),\n    ...(days ? {} : { hour: \"2-digit\" as const, minute: \"2-digit\" as const, hourCycle: \"h23\" as const }),\n    ...(seconds ? { second: \"2-digit\" as const } : {}),\n    ...(milliseconds ? { fractionalSecondDigits: 3 as const } : {}),\n    ...(dates.some(date => date.getUTCFullYear() <= 0) ? { era: \"short\" as const } : {}),\n  });\n  return Object.freeze(dates.map(date => formatter.format(date)));\n}\n"],
+  "mappings": "AAWO,SAAS,cAAc,QAA2B,UAA+B,CAAC,GAAsB;AAC7G,MAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,SAAS,OAAO,OAAO,KAAK,OAAK,CAAC,OAAO,cAAc,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,MAAqB;AACnI,UAAM,IAAI,WAAW,0EAA0E;AACjG,QAAM,QAAQ,OAAO,IAAI,WAAS,IAAI,KAAK,KAAK,CAAC;AACjD,QAAM,WAAW,CAAC,SAAe,KAAK,YAAY,MAAM,KAAK,KAAK,cAAc,MAAM,KAAK,KAAK,cAAc,MAAM,KAAK,KAAK,mBAAmB,MAAM;AACvJ,QAAM,SAAS,MAAM,MAAM,UAAQ,SAAS,IAAI,KAAK,KAAK,WAAW,MAAM,CAAC;AAC5E,QAAM,QAAQ,UAAU,MAAM,MAAM,UAAQ,KAAK,YAAY,MAAM,CAAC;AACpE,QAAM,OAAO,MAAM,MAAM,QAAQ;AACjC,QAAM,eAAe,MAAM,KAAK,UAAQ,KAAK,mBAAmB,MAAM,CAAC;AACvE,QAAM,UAAU,gBAAgB,MAAM,KAAK,UAAQ,KAAK,cAAc,MAAM,CAAC;AAC7E,QAAM,YAAY,IAAI,KAAK,eAAe,QAAQ,UAAU,SAAS;AAAA,IACnE,UAAU;AAAA,IAAO,UAAU;AAAA,IAAW,MAAM;AAAA,IAC5C,GAAI,QAAQ,CAAC,IAAI,EAAE,OAAO,QAAiB;AAAA,IAC3C,GAAI,SAAS,CAAC,IAAI,EAAE,KAAK,UAAmB;AAAA,IAC5C,GAAI,OAAO,CAAC,IAAI,EAAE,MAAM,WAAoB,QAAQ,WAAoB,WAAW,MAAe;AAAA,IAClG,GAAI,UAAU,EAAE,QAAQ,UAAmB,IAAI,CAAC;AAAA,IAChD,GAAI,eAAe,EAAE,wBAAwB,EAAW,IAAI,CAAC;AAAA,IAC7D,GAAI,MAAM,KAAK,UAAQ,KAAK,eAAe,KAAK,CAAC,IAAI,EAAE,KAAK,QAAiB,IAAI,CAAC;AAAA,EACpF,CAAC;AACD,SAAO,OAAO,OAAO,MAAM,IAAI,UAAQ,UAAU,OAAO,IAAI,CAAC,CAAC;AAChE;",
+  "names": []
+}

package/dist/features/viz/lib/utc-scale-component.d.ts

@@ -0,0 +1,7 @@
+import type { UTCScaleProps } from "./types.js";
+/**
+ * Provides a named utc mapping to descendant visualization components.
+ * @param props - Identity, domain, range, and children. See {@link UTCScaleProps}.
+ * @returns Descendant content within the scale scope.
+ */
+export declare function UTCScale(props: UTCScaleProps): import("@pibbl/core").PibblNode;

package/dist/features/viz/lib/utc-scale-component.js

@@ -0,0 +1,18 @@
+import { resolveSignalValue, useLayoutBox } from "@pibbl/core";
+import { resolveUtcScale } from "./utc-scale.js";
+import { useScaleProvider } from "./scale-provider.js";
+function UTCScale(props) {
+  const { width, height } = useLayoutBox();
+  useScaleProvider(props.id, "utc", () => resolveUtcScale(
+    resolveSignalValue(props.domain),
+    resolveSignalValue(props.range),
+    resolveSignalValue(props.reverse ?? false),
+    width,
+    height
+  ), [props.domain, props.range, props.reverse, width, height]);
+  return props.children;
+}
+export {
+  UTCScale
+};
+//# sourceMappingURL=utc-scale-component.js.map

package/dist/features/viz/lib/utc-scale-component.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/utc-scale-component.ts"],
+  "sourcesContent": ["import { resolveSignalValue, useLayoutBox } from \"@pibbl/core\";\nimport type { UTCScaleProps } from \"./types.js\";\nimport { resolveUtcScale } from \"./utc-scale.js\";\nimport { useScaleProvider } from \"./scale-provider.js\";\n/**\n * Provides a named utc mapping to descendant visualization components.\n * @param props - Identity, domain, range, and children. See {@link UTCScaleProps}.\n * @returns Descendant content within the scale scope.\n */\nexport function UTCScale(props: UTCScaleProps) {\n  const { width, height } = useLayoutBox();\n  useScaleProvider(props.id, \"utc\", () => resolveUtcScale(\n    resolveSignalValue(props.domain), resolveSignalValue(props.range),\n    resolveSignalValue(props.reverse ?? false), width, height,\n  ), [props.domain, props.range, props.reverse, width, height]);\n  return props.children;\n}\n"],
+  "mappings": "AAAA,SAAS,oBAAoB,oBAAoB;AAEjD,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AAM1B,SAAS,SAAS,OAAsB;AAC7C,QAAM,EAAE,OAAO,OAAO,IAAI,aAAa;AACvC,mBAAiB,MAAM,IAAI,OAAO,MAAM;AAAA,IACtC,mBAAmB,MAAM,MAAM;AAAA,IAAG,mBAAmB,MAAM,KAAK;AAAA,IAChE,mBAAmB,MAAM,WAAW,KAAK;AAAA,IAAG;AAAA,IAAO;AAAA,EACrD,GAAG,CAAC,MAAM,QAAQ,MAAM,OAAO,MAAM,SAAS,OAAO,MAAM,CAAC;AAC5D,SAAO,MAAM;AACf;",
+  "names": []
+}

package/dist/features/viz/lib/utc-scale.d.ts

@@ -0,0 +1,21 @@
+import type { UTCScale } from "./utc-scale-component.js";
+import type { LinearDomain, ResolvedUtcScale, ScaleRange } from "./types.js";
+export declare function resolveUtcScale(domain: LinearDomain, range: ScaleRange, reverse: boolean, width: number, height: number): ResolvedUtcScale;
+/**
+ * Expands a numeric timestamp domain to enclosing UTC calendar boundaries.
+ * @param domain - Safe integer epoch-millisecond endpoints, possibly equal or descending.
+ * @param options - Optional bounded target tick count (default 5).
+ * @returns A frozen outward-rounded domain preserving its direction. See {@link LinearDomain}.
+ * @see {@link UTCScale}
+ */
+export declare function niceUTCDomain(domain: LinearDomain, options?: {
+    readonly count?: number;
+}): LinearDomain;
+/**
+ * Computes a finite numeric extent in source order, skipping only null and undefined.
+ * @param data - Source rows, which are never sorted or mutated.
+ * @param value - Accessor called once per row with its index and original array.
+ * @returns A frozen minimum/maximum pair, or undefined when every row is missing.
+ * @see {@link niceUTCDomain}
+ */
+export declare function extent<D>(data: readonly D[], value: (datum: D, index: number, data: readonly D[]) => number | null | undefined): LinearDomain | undefined;

package/dist/features/viz/lib/utc-scale.js

@@ -0,0 +1,123 @@
+import { resolveLinearScale } from "./linear-scale.js";
+const LIMIT = 864e13;
+const DAY = 864e5;
+function timestamp(value, integer = false) {
+  if (typeof value !== "number" || !Number.isFinite(value) || Math.abs(value) > LIMIT || integer && !Number.isSafeInteger(value))
+    throw new RangeError("UTC timestamps must be finite milliseconds within Date range; domain endpoints must be safe integers.");
+  return value;
+}
+function validateDomain(domain) {
+  if (!Array.isArray(domain) || domain.length !== 2)
+    throw new RangeError("UTC domain requires two endpoints.");
+  timestamp(domain[0], true);
+  timestamp(domain[1], true);
+}
+function monthAt(ordinal) {
+  const date = /* @__PURE__ */ new Date(0);
+  date.setUTCFullYear(Math.floor(ordinal / 12), (ordinal % 12 + 12) % 12, 1);
+  return date.getTime();
+}
+const fixedSteps = [
+  1,
+  2,
+  5,
+  10,
+  20,
+  50,
+  100,
+  200,
+  500,
+  ...[1, 2, 5, 10, 15, 30].map((n) => n * 1e3),
+  ...[1, 2, 5, 10, 15, 30].map((n) => n * 6e4),
+  ...[1, 2, 3, 6, 12].map((n) => n * 36e5),
+  DAY,
+  2 * DAY
+];
+function selectCadence(lo, hi, count) {
+  for (const step of [...fixedSteps, 7 * DAY]) {
+    const offset = step === 7 * DAY ? -3 * DAY : 0;
+    const first = Math.floor((lo - offset) / step) + 1;
+    const last = Math.ceil((hi - offset) / step) - 1;
+    if (Math.max(0, last - first + 1) <= count - 2)
+      return { first, last, at: (index) => index * step + offset };
+  }
+  const start = new Date(lo), stop = new Date(hi);
+  const lowMonth = start.getUTCFullYear() * 12 + start.getUTCMonth();
+  const highMonth = stop.getUTCFullYear() * 12 + stop.getUTCMonth();
+  const highBoundary = stop.getUTCDate() === 1 && stop.getUTCHours() === 0 && stop.getUTCMinutes() === 0 && stop.getUTCSeconds() === 0 && stop.getUTCMilliseconds() === 0;
+  const steps = [
+    1,
+    2,
+    3,
+    6,
+    ...Array.from({ length: 7 }, (_, exponent) => [1, 2, 5].map((n) => 12 * n * 10 ** exponent)).flat()
+  ];
+  for (const step of steps) {
+    const first = Math.floor(lowMonth / step) + 1;
+    const last = Math.floor(highMonth / step) - (highBoundary && highMonth % step === 0 ? 1 : 0);
+    if (Math.max(0, last - first + 1) <= count - 2)
+      return { first, last, at: (index) => monthAt(index * step) };
+  }
+  if (count === 2) return { first: lo + 1, last: hi - 1, at: (index) => index };
+  throw new RangeError("UTC could not select a bounded cadence.");
+}
+function tickCount(count) {
+  if (!Number.isInteger(count) || count < 2 || count > 100)
+    throw new RangeError("UTC ticks count must be an integer from 2 to 100.");
+}
+function utcTicks(domain, count) {
+  tickCount(count);
+  if (count === 2) return Object.freeze([...domain]);
+  const lo = Math.min(...domain), hi = Math.max(...domain);
+  const cadence = selectCadence(lo, hi, count);
+  const ticks = [lo];
+  for (let i = cadence.first; i <= cadence.last; i++) {
+    const value = cadence.at(i);
+    if (value > lo && value < hi) ticks.push(timestamp(value, true));
+  }
+  ticks.push(hi);
+  return Object.freeze(domain[0] > domain[1] ? ticks.reverse() : ticks);
+}
+function resolveUtcScale(domain, range, reverse, width, height) {
+  validateDomain(domain);
+  const linear = resolveLinearScale(domain, range, reverse, width, height);
+  return Object.freeze({
+    ...linear,
+    type: "utc",
+    map: (value) => linear.map(timestamp(value)),
+    ticks: (count = 5) => utcTicks(linear.domain, count),
+    formatTick: (value) => new Date(timestamp(value)).toISOString()
+  });
+}
+function niceUTCDomain(domain, options = {}) {
+  validateDomain(domain);
+  const count = options.count ?? 5;
+  tickCount(count);
+  if (domain[0] === domain[1]) {
+    const lo2 = Math.max(-LIMIT, Math.min(LIMIT - 2, domain[0] - 1));
+    return Object.freeze([lo2, lo2 + 2]);
+  }
+  const lo = Math.min(...domain), hi = Math.max(...domain);
+  const cadence = selectCadence(lo, hi, count);
+  const start = timestamp(cadence.at(cadence.first - 1), true);
+  const stop = timestamp(cadence.at(cadence.last + 1), true);
+  return Object.freeze(domain[0] > domain[1] ? [stop, start] : [start, stop]);
+}
+function extent(data, value) {
+  if (!Array.isArray(data) || typeof value !== "function") throw new TypeError("extent requires an array and accessor.");
+  let min = Infinity, max = -Infinity;
+  for (let i = 0; i < data.length; i++) {
+    const v = value(data[i], i, data);
+    if (v === null || v === void 0) continue;
+    if (typeof v !== "number" || !Number.isFinite(v)) throw new TypeError("extent values must be finite numbers or missing.");
+    min = Math.min(min, v);
+    max = Math.max(max, v);
+  }
+  return min === Infinity ? void 0 : Object.freeze([min, max]);
+}
+export {
+  extent,
+  niceUTCDomain,
+  resolveUtcScale
+};
+//# sourceMappingURL=utc-scale.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/utc-scale.ts"],
+  "sourcesContent": ["import type { UTCScale } from \"./utc-scale-component.js\";\nimport type { LinearDomain, ResolvedUtcScale, ScaleRange } from \"./types.js\";\nimport { resolveLinearScale } from \"./linear-scale.js\";\nconst LIMIT = 8_640_000_000_000_000;\nconst DAY = 86_400_000;\n\nfunction timestamp(value: number, integer = false): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || Math.abs(value) > LIMIT || (integer && !Number.isSafeInteger(value)))\n    throw new RangeError(\"UTC timestamps must be finite milliseconds within Date range; domain endpoints must be safe integers.\");\n  return value;\n}\nfunction validateDomain(domain: LinearDomain): void {\n  if (!Array.isArray(domain) || domain.length !== 2)\n    throw new RangeError(\"UTC domain requires two endpoints.\");\n  timestamp(domain[0], true);\n  timestamp(domain[1], true);\n}\ninterface Cadence {\n  first: number;\n  last: number;\n  at(index: number): number;\n}\nfunction monthAt(ordinal: number): number {\n  const date = new Date(0);\n  date.setUTCFullYear(Math.floor(ordinal / 12), ((ordinal % 12) + 12) % 12, 1);\n  return date.getTime();\n}\nconst fixedSteps = [1, 2, 5, 10, 20, 50, 100, 200, 500,\n  ...[1, 2, 5, 10, 15, 30].map(n => n * 1000),\n  ...[1, 2, 5, 10, 15, 30].map(n => n * 60_000),\n  ...[1, 2, 3, 6, 12].map(n => n * 3_600_000), DAY, 2 * DAY];\nfunction selectCadence(lo: number, hi: number, count: number): Cadence {\n  for (const step of [...fixedSteps, 7 * DAY]) {\n    const offset = step === 7 * DAY ? -3 * DAY : 0;\n    const first = Math.floor((lo - offset) / step) + 1;\n    const last = Math.ceil((hi - offset) / step) - 1;\n    if (Math.max(0, last - first + 1) <= count - 2)\n      return { first, last, at: index => index * step + offset };\n  }\n  // Two Date objects for endpoint ordinals; candidate counting is arithmetic.\n  const start = new Date(lo), stop = new Date(hi);\n  const lowMonth = start.getUTCFullYear() * 12 + start.getUTCMonth();\n  const highMonth = stop.getUTCFullYear() * 12 + stop.getUTCMonth();\n  const highBoundary = stop.getUTCDate() === 1 && stop.getUTCHours() === 0 &&\n    stop.getUTCMinutes() === 0 && stop.getUTCSeconds() === 0 && stop.getUTCMilliseconds() === 0;\n  const steps = [1, 2, 3, 6,\n    ...Array.from({ length: 7 }, (_, exponent) => [1, 2, 5].map(n => 12 * n * 10 ** exponent)).flat()];\n  for (const step of steps) {\n    const first = Math.floor(lowMonth / step) + 1;\n    const last = Math.floor(highMonth / step) - (highBoundary && highMonth % step === 0 ? 1 : 0);\n    if (Math.max(0, last - first + 1) <= count - 2)\n      return { first, last, at: index => monthAt(index * step) };\n  }\n  // Every epoch-aligned cadence crosses year zero for a straddling domain.\n  // Two-tick output is endpoints-only; keep already integral millisecond bounds\n  // rather than overflow Date trying ever coarser calendar boundaries.\n  if (count === 2) return { first: lo + 1, last: hi - 1, at: index => index };\n  throw new RangeError(\"UTC could not select a bounded cadence.\");\n}\nfunction tickCount(count: number): void {\n  if (!Number.isInteger(count) || count < 2 || count > 100)\n    throw new RangeError(\"UTC ticks count must be an integer from 2 to 100.\");\n}\nfunction utcTicks(domain: LinearDomain, count: number): readonly number[] {\n  tickCount(count);\n  if (count === 2) return Object.freeze([...domain]);\n  const lo = Math.min(...domain), hi = Math.max(...domain);\n  const cadence = selectCadence(lo, hi, count);\n  const ticks = [lo];\n  for (let i = cadence.first; i <= cadence.last; i++) {\n    const value = cadence.at(i);\n    if (value > lo && value < hi) ticks.push(timestamp(value, true));\n  }\n  ticks.push(hi);\n  return Object.freeze(domain[0] > domain[1] ? ticks.reverse() : ticks);\n}\nexport function resolveUtcScale(domain: LinearDomain, range: ScaleRange, reverse: boolean, width: number, height: number): ResolvedUtcScale {\n  validateDomain(domain);\n  const linear = resolveLinearScale(domain, range, reverse, width, height);\n  return Object.freeze({\n    ...linear,\n    type: \"utc\",\n    map: (value: number) => linear.map(timestamp(value)),\n    ticks: (count = 5) => utcTicks(linear.domain, count),\n    formatTick: (value: number) => new Date(timestamp(value)).toISOString(),\n  });\n}\n\n/**\n * Expands a numeric timestamp domain to enclosing UTC calendar boundaries.\n * @param domain - Safe integer epoch-millisecond endpoints, possibly equal or descending.\n * @param options - Optional bounded target tick count (default 5).\n * @returns A frozen outward-rounded domain preserving its direction. See {@link LinearDomain}.\n * @see {@link UTCScale}\n */\nexport function niceUTCDomain(domain: LinearDomain, options: { readonly count?: number } = {}): LinearDomain {\n  validateDomain(domain);\n  const count = options.count ?? 5;\n  tickCount(count);\n  if (domain[0] === domain[1]) {\n    const lo = Math.max(-LIMIT, Math.min(LIMIT - 2, domain[0] - 1));\n    return Object.freeze([lo, lo + 2]);\n  }\n  const lo = Math.min(...domain), hi = Math.max(...domain);\n  const cadence = selectCadence(lo, hi, count);\n  const start = timestamp(cadence.at(cadence.first - 1), true);\n  const stop = timestamp(cadence.at(cadence.last + 1), true);\n  return Object.freeze(domain[0] > domain[1] ? [stop, start] : [start, stop]);\n}\n\n/**\n * Computes a finite numeric extent in source order, skipping only null and undefined.\n * @param data - Source rows, which are never sorted or mutated.\n * @param value - Accessor called once per row with its index and original array.\n * @returns A frozen minimum/maximum pair, or undefined when every row is missing.\n * @see {@link niceUTCDomain}\n */\nexport function extent<D>(data: readonly D[], value: (datum: D, index: number, data: readonly D[]) => number | null | undefined): LinearDomain | undefined {\n  if (!Array.isArray(data) || typeof value !== \"function\") throw new TypeError(\"extent requires an array and accessor.\");\n  let min = Infinity, max = -Infinity;\n  for (let i = 0; i < data.length; i++) {\n    const v = value(data[i], i, data);\n    if (v === null || v === undefined) continue;\n    if (typeof v !== \"number\" || !Number.isFinite(v)) throw new TypeError(\"extent values must be finite numbers or missing.\");\n    min = Math.min(min, v); max = Math.max(max, v);\n  }\n  return min === Infinity ? undefined : Object.freeze([min, max]);\n}\n"],
+  "mappings": "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",
+  "names": ["lo"]
+}

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;