@pibbl/core 0.0.1 → 0.0.2

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

@@ -1,7 +1,7 @@
 import type { BarCategoryAccessor } from "./bar-series.js";
-import type { Scale } from "./scale.js";
+import type { LinearScale } from "./linear-scale-component.js";
 import type { nearestDomainValue } from "./nearest.js";
-import type { useScale } from "./use-scale.js";
+import type { useLinearScale } from "./use-linear-scale.js";
 import type { Axis } from "./axis.js";
 import type { PointAccessor } from "./point-types.js";
 import type { ScaleAdjust } from "./scale-adjust.js";
@@ -34,7 +34,7 @@ export type ScaleRange = "width" | "height" | readonly [number, number];
  *
  * @see {@link ScaleRange}
  * @see {@link ScaleId}
- * @see {@link BandScaleProps}
+ * @see {@link BarScaleProps}
  */
 export type BandScaleRange = ScaleRange | {
     /** Identifier of a parent band scale whose bandwidth supplies this range. See {@link ScaleId}. */
@@ -58,13 +58,11 @@ export type ScaleLayoutStyle = Pick<BoxStyle, "width" | "height"> & LayoutItemSt
  * @see {@link SignalStyle}
  * @see {@link ScaleLayoutStyle}
  * @see {@link PibblNode}
- * @see {@link BandScaleProps}
+ * @see {@link BarScaleProps}
  */
 export interface LinearScaleProps {
     /** Stable identifier of this resource or connection. See {@link ScaleId}. */
     readonly id: ScaleId;
-    /** The literal "linear" identifying this variant. See {@link LinearScaleProps}. */
-    readonly type: "linear";
     /**
      * Data values or endpoints accepted by the scale. See {@link SignalValue}, {@link LinearDomain}
      * .
@@ -97,7 +95,7 @@ export type BandCategory = string | number;
  * The ordered categories allocated by a band scale.
  *
  * @see {@link BandCategory}
- * @see {@link BandScaleProps}
+ * @see {@link BarScaleProps}
  * @see {@link ResolvedBandScale}
  */
 export type BandDomain = readonly BandCategory[];
@@ -108,11 +106,9 @@ export type BandDomain = readonly BandCategory[];
  * @see {@link SignalValue}
  * @see {@link BandDomain}
  * @see {@link BandScaleRange}
- * @see {@link ScaleProps}
+ * @see {@link LinearScaleProps}
  */
-export interface BandScaleProps extends Omit<LinearScaleProps, "type" | "domain" | "range"> {
-    /** The literal "band" identifying this variant. See {@link BandScaleProps}. */
-    readonly type: "band";
+export interface BarScaleProps extends Omit<LinearScaleProps, "domain" | "range"> {
     /**
      * Data values or endpoints accepted by the scale. See {@link SignalValue}, {@link BandDomain}.
      */
@@ -131,10 +127,15 @@ export interface BandScaleProps extends Omit<LinearScaleProps, "type" | "domain"
  * Authored inputs for Scale, including the declared data and presentation options.
  *
  * @see {@link LinearScaleProps}
- * @see {@link BandScaleProps}
- * @see {@link Scale}
+ * @see {@link BarScaleProps}
+ * @see {@link LinearScale}
  */
-export type ScaleProps = LinearScaleProps | BandScaleProps;
+/** UTC timestamps use numeric epoch milliseconds. See {@link LinearDomain}. */
+export type UtcDomain = LinearDomain;
+/** Numeric endpoints shared by continuous scales. See {@link LinearDomain}. */
+export type NumericDomain = LinearDomain;
+/** Calendar-aware UTC scale inputs. See {@link LinearScaleProps}. */
+export type UTCScaleProps = LinearScaleProps;
 /**
  * A resolved categorical mapping with its frame, bandwidth, and step.
  *
@@ -207,9 +208,73 @@ export interface ResolvedLinearScale {
  *
  * @see {@link ResolvedLinearScale}
  * @see {@link ResolvedBandScale}
- * @see {@link useScale}
+ * @see {@link useLinearScale}
  */
-export type ResolvedScale = ResolvedLinearScale | ResolvedBandScale;
+/** UTC continuous mapping with stateless ISO formatting. See {@link ResolvedLinearScale}. */
+export interface ResolvedUtcScale extends Omit<ResolvedLinearScale, "type"> {
+    /** UTC calendar scale discriminant. See {@link UTCScaleProps}. */
+    readonly type: "utc";
+    /**
+     * Formats a timestamp as full UTC ISO text without changing tick geometry.
+     * @param value - Finite epoch milliseconds inside the Date range.
+     * @returns ISO text with millisecond precision. See {@link ResolvedUtcScale}.
+     */
+    formatTick(value: number): string;
+}
+/** Any supported numeric mapping. See {@link ResolvedUtcScale}. */
+export type ResolvedContinuousScale = ResolvedLinearScale | ResolvedUtcScale | ResolvedLogScale | ResolvedSymlogScale;
+/** Positive logarithmic provider inputs. See {@link LinearScaleProps}. */
+export interface LogScaleProps extends LinearScaleProps {
+    /** Base for power ticks; finite and greater than one, default 10. Mapping is base-independent. */
+    readonly base?: SignalValue<number>;
+}
+/** Positive logarithmic mapping with numeric inverse. See {@link ResolvedLinearScale}. */
+export interface ResolvedLogScale extends Omit<ResolvedLinearScale, "type"> {
+    /** Logarithmic mapping discriminant. See {@link LogScaleProps}. */
+    readonly type: "log";
+    /** Resolved base used for power ticks. See {@link LogScaleProps}. */
+    readonly base: number;
+}
+/** A numeric or categorical mapping snapshot. See {@link ResolvedContinuousScale}. */
+export type ResolvedScale = ResolvedContinuousScale | ResolvedBandScale | ResolvedPointScale;
+/** Signed logarithmic scale inputs. See {@link LinearScaleProps}. */
+export interface SymlogScaleProps extends LinearScaleProps {
+    /** Positive linear-to-log transition constant in domain units, default 1. */
+    readonly constant?: SignalValue<number>;
+}
+/** Signed logarithmic mapping through zero. See {@link ResolvedLinearScale}. */
+export interface ResolvedSymlogScale extends Omit<ResolvedLinearScale, "type"> {
+    /** Signed logarithmic discriminant. See {@link SymlogScaleProps}. */
+    readonly type: "symlog";
+    /** Positive transition constant. See {@link SymlogScaleProps}. */
+    readonly constant: number;
+}
+/** Equally spaced categorical positions. See {@link LinearScaleProps}. */
+export interface PointScaleProps extends Omit<LinearScaleProps, "domain"> {
+    /** Ordered unique string or finite numeric categories; accepts signals. See {@link BandDomain}. */
+    readonly domain: SignalValue<BandDomain>;
+    /** Nonnegative outer padding in step units, default 0. */
+    readonly padding?: SignalValue<number>;
+}
+/** Zero-width categorical point positions. See {@link ResolvedBandScale}. */
+export interface ResolvedPointScale extends Omit<ResolvedBandScale, "type" | "bandwidth"> {
+    /** Categorical point discriminant. See {@link PointScaleProps}. */
+    readonly type: "point";
+    /** Resolved outer padding. See {@link PointScaleProps}. */
+    readonly padding: number;
+    /**
+     * Finds the nearest category, clamping outside coordinates; ties choose first domain order.
+     * @param pixel - Finite range coordinate.
+     * @returns Category or undefined for an empty domain. See {@link BandCategory}.
+     */
+    invert(pixel: number): BandCategory | undefined;
+    /**
+     * Selects evenly spaced categories including endpoints when count permits.
+     * @param count - Integer maximum count 0–100, default 5.
+     * @returns Frozen categories in domain order. See {@link BandDomain}.
+     */
+    ticks(count?: number): BandDomain;
+}
 import type { PibblEventHandlers, PibblEventParticipationOptions, FillStyle, StrokeStyle } from "@pibbl/core";
 /**
  * Supported geometry and presentation properties for Axis.
@@ -247,6 +312,18 @@ interface AxisBaseProps {
      * @returns Text to draw for the tick label.
      */
     readonly tickFormat?: (value: number | string, index: number) => string;
+    /** Label collision policy; allow preserves all labels (default), skip measures and omits overlaps without removing ticks. */
+    readonly labelOverlap?: SignalValue<"allow" | "skip">;
+    /** Minimum distance between visible labels in logical pixels; defaults to 8. */
+    readonly labelGap?: SignalValue<number>;
+    /** Long-label policy, default allow. Wrap/truncate require labelMaxWidth; coordinates remain unchanged. */
+    readonly labelOverflow?: SignalValue<"allow" | "wrap" | "truncate">;
+    /** Maximum measured line width in logical pixels, positive and finite. Required for wrap/truncate. */
+    readonly labelMaxWidth?: SignalValue<number>;
+    /** Maximum wrapped lines, integer 1–20; default 2. Excess text receives an ellipsis. */
+    readonly labelMaxLines?: SignalValue<number>;
+    /** Positive line advance in logical pixels; default is measured font height plus 4. */
+    readonly labelLineHeight?: SignalValue<number>;
     /**
      * Declared presentation and layout properties. See {@link SignalValue}, {@link SignalStyle},
      * {@link AxisStyle}.
@@ -372,7 +449,7 @@ type ScaleAdjustX = {
      * Horizontal coordinate or displacement in the containing coordinate system. See
      * {@link SignalValue}.
      */
-    readonly x: SignalValue<number>;
+    readonly x: SignalValue<BandCategory>;
     /** The scale used to map horizontal data coordinates. See {@link ScaleId}. */
     readonly xScale: ScaleId;
 } | {
@@ -392,7 +469,7 @@ type ScaleAdjustY = {
      * Vertical coordinate or displacement in the containing coordinate system. See
      * {@link SignalValue}.
      */
-    readonly y: SignalValue<number>;
+    readonly y: SignalValue<BandCategory>;
     /** The scale used to map vertical data coordinates. See {@link ScaleId}. */
     readonly yScale: ScaleId;
 } | {

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,9 @@
+import { scaleView } from "./scale-view.js";
+const views = /* @__PURE__ */ new WeakMap();
+function useContinuousScale(id) {
+  return scaleView(views, id, "useContinuousScale", (kind) => kind !== "band" && kind !== "point");
+}
+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 { 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;",
+  "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;