@pibbl/core 0.0.1

package/dist/features/textures/lib/water-waves.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/textures/lib/water-waves.ts"],
+  "sourcesContent": ["import {\n  defineTexture,\n  type TextureContext,\n  type TextureRecipe,\n} from \"@pibbl/core\";\nimport { bytes } from \"./wasm/water-waves-bytes.js\";\nimport { validateSeed } from \"./palette.js\";\n\n/**\n * Seed, animation speed, feature scale, ripple strength, and initial pause state of water waves.\n *\n * @see {@link waterWaves}\n */\nexport interface WaterWavesOptions {\n  /**\n   * Seed used for deterministic sampling or simulation initialization. See\n   * {@link WaterWavesOptions}.\n   */\n  readonly seed?: number;\n  /** Multiplier controlling the simulation's animation rate. See {@link WaterWavesOptions}. */\n  readonly speed?: number;\n  /** Spatial scale of the generated wave pattern. See {@link WaterWavesOptions}. */\n  readonly scale?: number;\n  /** Strength of injected wave disturbances. See {@link WaterWavesOptions}. */\n  readonly rippleStrength?: number;\n  /** Whether simulation or playback advancement is suspended. See {@link WaterWavesOptions}. */\n  readonly paused?: boolean;\n}\n\n/**\n * Ripple, pause, and reset commands for a water-wave texture.\n *\n * @see {@link waterWaves}\n */\nexport type WaterWavesMessage =\n  | {\n      /** The literal \"pause\" identifying this variant. See {@link WaterWavesMessage}. */\n      readonly type: \"pause\";\n      /** Whether simulation or playback advancement is suspended. See {@link WaterWavesMessage}. */\n      readonly paused: boolean;\n    }\n  | {\n      /** The literal \"reset\" identifying this variant. See {@link WaterWavesMessage}. */\n      readonly type: \"reset\";\n    }\n  | {\n      /** The literal \"ripple\" identifying this variant. See {@link WaterWavesMessage}. */\n      readonly type: \"ripple\";\n      /**\n       * Horizontal coordinate or displacement in the containing coordinate system. See\n       * {@link WaterWavesMessage}.\n       */\n      readonly x: number;\n      /**\n       * Vertical coordinate or displacement in the containing coordinate system. See\n       * {@link WaterWavesMessage}.\n       */\n      readonly y: number;\n    };\n\ninterface Config {\n  seed: number;\n  speed: number;\n  scale: number;\n  rippleStrength: number;\n  paused: boolean;\n}\ninterface State {\n  config: Config;\n  field: WaveField;\n  phase: number;\n  paused: boolean;\n  fresh: boolean;\n  rippleCount: number;\n}\ninterface WaveKernel {\n  initializeModes(ptr: number, seed: number, scale: number): void;\n  reset(): void;\n  ripple(x: number, y: number): void;\n  advance(elapsed: number): number;\n  raster(\n    pixels: number,\n    width: number,\n    height: number,\n    time: number,\n    strength: number,\n  ): void;\n}\nlet compiled: WebAssembly.Module | undefined;\nclass WaveField {\n  readonly kernel: WaveKernel;\n  readonly image: ImageData;\n  constructor(width: number, height: number, config: Config) {\n    const pages = Math.ceil((66024 + width * height * 4) / 65536);\n    const memory = new WebAssembly.Memory({ initial: pages, maximum: pages });\n    compiled ??= new WebAssembly.Module(\n      Uint8Array.from(atob(bytes), (c) => c.charCodeAt(0)),\n    );\n    this.kernel = new WebAssembly.Instance(compiled, {\n      env: {\n        memory,\n        abort() {\n          throw new Error(\"Water waves WASM aborted.\");\n        },\n      },\n    }).exports as unknown as WaveKernel;\n    this.image = new ImageData(\n      new Uint8ClampedArray(memory.buffer, 66024, width * height * 4),\n      width,\n      height,\n    );\n    this.configure(config);\n  }\n  configure(config: Config) {\n    this.kernel.initializeModes(65536, config.seed, config.scale);\n  }\n  raster(time: number, strength: number) {\n    this.kernel.raster(\n      66024,\n      this.image.width,\n      this.image.height,\n      time,\n      strength,\n    );\n  }\n}\n\nfunction config(input: WaterWavesOptions): Config {\n  const seed = validateSeed(input.seed ?? 0);\n  const speed = input.speed ?? 1;\n  const scale = input.scale ?? 4;\n  const rippleStrength = input.rippleStrength ?? 1;\n  if (!Number.isFinite(speed) || speed < 0)\n    throw new RangeError(\"Water wave speed must be finite and nonnegative.\");\n  if (!Number.isInteger(scale) || scale < 1 || scale > 32)\n    throw new RangeError(\"Water wave scale must be an integer from 1 to 32.\");\n  if (!Number.isFinite(rippleStrength) || rippleStrength < 0)\n    throw new RangeError(\n      \"Water ripple strength must be finite and nonnegative.\",\n    );\n  return { seed, speed, scale, rippleStrength, paused: input.paused ?? false };\n}\n\nfunction assertDataTexture(context: TextureContext): void {\n  if (context.palette !== undefined)\n    throw new TypeError(\n      \"waterWaves is a numeric displacement map and does not accept a palette.\",\n    );\n}\nfunction isAnimating(state: State): boolean {\n  return state.config.speed > 0 || state.rippleCount > 0;\n}\nfunction assertRippleCoordinate(value: number, name: \"x\" | \"y\"): void {\n  if (!Number.isFinite(value) || value < 0 || value > 1)\n    throw new RangeError(\n      `Water ripple ${name} must be finite and within [0, 1].`,\n    );\n}\n\nconst recipe = /* @__PURE__ */ defineTexture<\n  WaterWavesOptions,\n  State,\n  WaterWavesMessage\n>({\n  create(context, input) {\n    assertDataTexture(context);\n    const next = config(input);\n    if (!next.paused && next.speed > 0) context.requestFrame();\n    return {\n      config: next,\n      field: new WaveField(context.canvas.width, context.canvas.height, next),\n      phase: 0,\n      paused: next.paused,\n      fresh: true,\n      rippleCount: 0,\n    };\n  },\n  update(state, input, context) {\n    assertDataTexture(context);\n    const next = config(input);\n    const previous = state.config;\n    if (next.seed !== previous.seed || next.scale !== previous.scale) {\n      state.phase = 0;\n      state.field.configure(next);\n      context.invalidate();\n    }\n    if (next.rippleStrength !== previous.rippleStrength) context.invalidate();\n    if (next.paused !== previous.paused) state.paused = next.paused;\n    if (next.paused !== previous.paused || next.speed !== previous.speed)\n      state.fresh = true;\n    state.config = next;\n    if (!state.paused && isAnimating(state)) context.requestFrame();\n  },\n  receive(state, message, context) {\n    if (message.type === \"pause\") {\n      state.paused = message.paused;\n      state.fresh = true;\n      if (!state.paused && isAnimating(state)) context.requestFrame();\n      return;\n    }\n    if (message.type === \"reset\") {\n      state.phase = 0;\n      state.field.kernel.reset();\n      state.rippleCount = 0;\n      state.fresh = true;\n      context.invalidate();\n      return;\n    }\n    if (message.type === \"ripple\") {\n      assertRippleCoordinate(message.x, \"x\");\n      assertRippleCoordinate(message.y, \"y\");\n      if (!isAnimating(state)) state.fresh = true;\n      state.field.kernel.ripple(message.x, message.y);\n      state.rippleCount = Math.min(16, state.rippleCount + 1);\n      context.invalidate();\n      if (!state.paused) context.requestFrame();\n      return;\n    }\n    throw new TypeError(\"Unknown water wave message.\");\n  },\n  advance(state, frame, context) {\n    if (state.paused || !isAnimating(state)) return;\n    if (!state.fresh) {\n      const elapsed = frame.delta / 1000;\n      state.phase += elapsed * state.config.speed;\n      state.rippleCount = state.field.kernel.advance(elapsed);\n      context.invalidate();\n    }\n    state.fresh = false;\n    if (isAnimating(state)) context.requestFrame();\n  },\n  rasterize(state, context) {\n    const ctx = context.canvas.getContext(\"2d\")!;\n    state.field.raster(state.phase, state.config.rippleStrength);\n    ctx.putImageData(state.field.image, 0, 0);\n  },\n});\n\n/**\n * Creates an animated water-wave texture recipe that accepts ripple, pause, and reset commands.\n *\n * @param options - Wave simulation and rendering settings. See {@link WaterWavesOptions}.\n * @returns A water-wave texture recipe accepting wave messages. See {@link TextureRecipe} ,\n * {@link WaterWavesMessage} .\n *\n * @see {@link WaterWavesOptions}\n * @see {@link TextureRecipe}\n * @see {@link WaterWavesMessage}\n */\nexport function waterWaves(\n  options: WaterWavesOptions = {},\n): TextureRecipe<WaterWavesMessage> {\n  return recipe(options);\n}\n"],
+  "mappings": "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",
+  "names": ["config"]
+}

package/dist/features/viz/index.d.ts

@@ -0,0 +1,28 @@
+export { Scale } from "./lib/scale.js";
+export { useScale } from "./lib/use-scale.js";
+export type { ScaleId, LinearDomain, BandCategory, BandDomain, BandScaleProps, BandScaleRange, ResolvedBandScale, ScaleRange, ScaleLayoutStyle, LinearScaleProps, ScaleProps, ResolvedLinearScale, ResolvedScale, } from "./lib/types.js";
+export { Axis } from "./lib/axis.js";
+export { LineSeries } from "./lib/line-series.js";
+export { ScaleAdjust } from "./lib/scale-adjust.js";
+export type { AxisStyle, AxisProps, LineCoordinate, LineAccessor, LineCurve, LineSeriesStyle, LineSeriesProps, ScaleAdjustProps, } from "./lib/types.js";
+export { PointSeries } from "./lib/point-series.js";
+export type { PointAccessor, PointMarkStyle, PointSeriesStyle, PointStyleResolver, PointSeriesProps, } from "./lib/point-types.js";
+export { PlotSeries } from "./lib/plot-series.js";
+export type { PlotSeriesProps, PlotKeyAccessor } from "./lib/plot-types.js";
+export { nearestDomainValue, nearestPoint } from "./lib/nearest.js";
+export type { NearestPointOptions, NearestPoint } from "./lib/nearest.js";
+export { HoverData } from "./lib/hover-data.js";
+export { defineSeries, closestPoint } from "./lib/hover-queries.js";
+export type { HoverQueryContext, HoverQuery, HoverDataProps, HoverSeries, HoverPoint, HoverHit, HoverSeriesMap, ClosestPointHit, ClosestPointOptions, } from "./lib/hover-types.js";
+export { HoverCard } from "./lib/hover-card.js";
+export type { HoverCardProps, HoverCardStyle, HoverBounds, HoverPlacement, } from "./lib/hover-card.js";
+export { closestX, interpolateX, linearInterpolation, } from "./lib/hover-queries.js";
+export type { ClosestXOptions, ClosestXHit, HoverInterpolation, InterpolateXOptions, HoverSample, } from "./lib/hover-types.js";
+export { AnchoredLayout } from "./lib/anchored-layout.js";
+export type { AnchoredItem, AnchoredPlacement, AnchoredLayoutProps, } from "./lib/anchored-layout.js";
+export { BarSeries } from "./lib/bar-series.js";
+export type { BarThresholdFill, BarCategoryAccessor, BarSeriesStyle, BarStyleResolver, BarSeriesProps, } from "./lib/bar-series.js";
+export { pieSlices } from "./lib/pie-slices.js";
+export type { PieOptions, PieSliceGeometry } from "./lib/pie-slices.js";
+export { PieLayout, PieSlice, PieLabel } from "./lib/pie-layout.js";
+export type { PieLayoutProps, PieLayoutStyle, PieLayoutSlice, PieLabelPlacement, PieLabelLayout, PieSliceProps, PieSliceStyle, PieLabelProps, PieLabelStyle } from "./lib/pie-types.js";

package/dist/features/viz/index.js

@@ -0,0 +1,45 @@
+import { Scale } from "./lib/scale.js";
+import { useScale } from "./lib/use-scale.js";
+import { Axis } from "./lib/axis.js";
+import { LineSeries } from "./lib/line-series.js";
+import { ScaleAdjust } from "./lib/scale-adjust.js";
+import { PointSeries } from "./lib/point-series.js";
+import { PlotSeries } from "./lib/plot-series.js";
+import { nearestDomainValue, nearestPoint } from "./lib/nearest.js";
+import { HoverData } from "./lib/hover-data.js";
+import { defineSeries, closestPoint } from "./lib/hover-queries.js";
+import { HoverCard } from "./lib/hover-card.js";
+import {
+  closestX,
+  interpolateX,
+  linearInterpolation
+} from "./lib/hover-queries.js";
+import { AnchoredLayout } from "./lib/anchored-layout.js";
+import { BarSeries } from "./lib/bar-series.js";
+import { pieSlices } from "./lib/pie-slices.js";
+import { PieLayout, PieSlice, PieLabel } from "./lib/pie-layout.js";
+export {
+  AnchoredLayout,
+  Axis,
+  BarSeries,
+  HoverCard,
+  HoverData,
+  LineSeries,
+  PieLabel,
+  PieLayout,
+  PieSlice,
+  PlotSeries,
+  PointSeries,
+  Scale,
+  ScaleAdjust,
+  closestPoint,
+  closestX,
+  defineSeries,
+  interpolateX,
+  linearInterpolation,
+  nearestDomainValue,
+  nearestPoint,
+  pieSlices,
+  useScale
+};
+//# sourceMappingURL=index.js.map

package/dist/features/viz/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/features/viz/index.ts"],
+  "sourcesContent": ["export { Scale } from \"./lib/scale.js\";\nexport { useScale } from \"./lib/use-scale.js\";\nexport type {\n  ScaleId,\n  LinearDomain,\n  BandCategory,\n  BandDomain,\n  BandScaleProps,\n  BandScaleRange,\n  ResolvedBandScale,\n  ScaleRange,\n  ScaleLayoutStyle,\n  LinearScaleProps,\n  ScaleProps,\n  ResolvedLinearScale,\n  ResolvedScale,\n} from \"./lib/types.js\";\nexport { Axis } from \"./lib/axis.js\";\nexport { LineSeries } from \"./lib/line-series.js\";\nexport { ScaleAdjust } from \"./lib/scale-adjust.js\";\nexport type {\n  AxisStyle,\n  AxisProps,\n  LineCoordinate,\n  LineAccessor,\n  LineCurve,\n  LineSeriesStyle,\n  LineSeriesProps,\n  ScaleAdjustProps,\n} from \"./lib/types.js\";\nexport { PointSeries } from \"./lib/point-series.js\";\nexport type {\n  PointAccessor,\n  PointMarkStyle,\n  PointSeriesStyle,\n  PointStyleResolver,\n  PointSeriesProps,\n} from \"./lib/point-types.js\";\nexport { PlotSeries } from \"./lib/plot-series.js\";\nexport type { PlotSeriesProps, PlotKeyAccessor } from \"./lib/plot-types.js\";\nexport { nearestDomainValue, nearestPoint } from \"./lib/nearest.js\";\nexport type { NearestPointOptions, NearestPoint } from \"./lib/nearest.js\";\n\nexport { HoverData } from \"./lib/hover-data.js\";\nexport { defineSeries, closestPoint } from \"./lib/hover-queries.js\";\nexport type {\n  HoverQueryContext,\n  HoverQuery,\n  HoverDataProps,\n  HoverSeries,\n  HoverPoint,\n  HoverHit,\n  HoverSeriesMap,\n  ClosestPointHit,\n  ClosestPointOptions,\n} from \"./lib/hover-types.js\";\n\nexport { HoverCard } from \"./lib/hover-card.js\";\nexport type {\n  HoverCardProps,\n  HoverCardStyle,\n  HoverBounds,\n  HoverPlacement,\n} from \"./lib/hover-card.js\";\n\nexport {\n  closestX,\n  interpolateX,\n  linearInterpolation,\n} from \"./lib/hover-queries.js\";\nexport type {\n  ClosestXOptions,\n  ClosestXHit,\n  HoverInterpolation,\n  InterpolateXOptions,\n  HoverSample,\n} from \"./lib/hover-types.js\";\n\nexport { AnchoredLayout } from \"./lib/anchored-layout.js\";\nexport type {\n  AnchoredItem,\n  AnchoredPlacement,\n  AnchoredLayoutProps,\n} from \"./lib/anchored-layout.js\";\n\nexport { BarSeries } from \"./lib/bar-series.js\";\nexport type {\n  BarThresholdFill,\n  BarCategoryAccessor,\n  BarSeriesStyle,\n  BarStyleResolver,\n  BarSeriesProps,\n} from \"./lib/bar-series.js\";\n\nexport { pieSlices } from \"./lib/pie-slices.js\";\nexport type { PieOptions, PieSliceGeometry } from \"./lib/pie-slices.js\";\n\nexport { PieLayout, PieSlice, PieLabel } from \"./lib/pie-layout.js\";\nexport type { PieLayoutProps, PieLayoutStyle, PieLayoutSlice, PieLabelPlacement, PieLabelLayout, PieSliceProps, PieSliceStyle, PieLabelProps, PieLabelStyle } from \"./lib/pie-types.js\";\n"],
+  "mappings": "AAAA,SAAS,aAAa;AACtB,SAAS,gBAAgB;AAgBzB,SAAS,YAAY;AACrB,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAW5B,SAAS,mBAAmB;AAQ5B,SAAS,kBAAkB;AAE3B,SAAS,oBAAoB,oBAAoB;AAGjD,SAAS,iBAAiB;AAC1B,SAAS,cAAc,oBAAoB;AAa3C,SAAS,iBAAiB;AAQ1B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,sBAAsB;AAO/B,SAAS,iBAAiB;AAS1B,SAAS,iBAAiB;AAG1B,SAAS,WAAW,UAAU,gBAAgB;",
+  "names": []
+}

package/dist/features/viz/index.mjs

@@ -0,0 +1 @@
+export * from './index.js';

package/dist/features/viz/lib/anchored-layout.d.ts

@@ -0,0 +1,104 @@
+import { type PibblNode, type SignalValue } from "@pibbl/core";
+/**
+ * Declared outer box and protected anchor, all in the parent's local coordinates.
+ *
+ * @see {@link AnchoredLayout}
+ * @see {@link AnchoredLayoutProps}
+ */
+export interface AnchoredItem {
+    /** Stable identity used by the containing protocol. See {@link AnchoredItem}. */
+    readonly key: string | number;
+    /** Logical point to which the content or result is anchored. See {@link AnchoredItem}. */
+    readonly anchor: Readonly<{
+        /**
+         * Horizontal coordinate or displacement in the containing coordinate system. See
+         * {@link AnchoredItem}.
+         */
+        x: number;
+        /**
+         * Vertical coordinate or displacement in the containing coordinate system. See
+         * {@link AnchoredItem}.
+         */
+        y: number;
+    }>;
+    /** Clearance around the anchor before placing the item. See {@link AnchoredItem}. */
+    readonly anchorRadius?: number;
+    /**
+     * Horizontal extent in the units of the containing geometry or surface. See {@link AnchoredItem}
+     * .
+     */
+    readonly width: number;
+    /**
+     * Vertical extent in the units of the containing geometry or surface. See {@link AnchoredItem}.
+     */
+    readonly height: number;
+}
+/**
+ * The resolved logical rectangle assigned to an anchored item.
+ *
+ * @see {@link AnchoredLayoutProps}
+ */
+export interface AnchoredPlacement {
+    /**
+     * Horizontal coordinate or displacement in the containing coordinate system. See
+     * {@link AnchoredPlacement}.
+     */
+    readonly x: number;
+    /**
+     * Vertical coordinate or displacement in the containing coordinate system. See
+     * {@link AnchoredPlacement}.
+     */
+    readonly y: number;
+    /**
+     * Horizontal extent in the units of the containing geometry or surface. See
+     * {@link AnchoredPlacement}.
+     */
+    readonly width: number;
+    /**
+     * Vertical extent in the units of the containing geometry or surface. See
+     * {@link AnchoredPlacement}.
+     */
+    readonly height: number;
+}
+/**
+ * Authored inputs for AnchoredLayout, including the declared data and presentation options.
+ *
+ * @see {@link AnchoredItem}
+ * @see {@link SignalValue}
+ * @see {@link AnchoredPlacement}
+ * @see {@link PibblNode}
+ * @see {@link AnchoredLayout}
+ */
+export interface AnchoredLayoutProps<T extends AnchoredItem> {
+    /** Items to place around their declared anchors. See {@link SignalValue}. */
+    readonly items: SignalValue<readonly T[]>;
+    /** Direction in which this operation proceeds. See {@link AnchoredLayoutProps}. */
+    readonly direction?: "vertical" | "horizontal";
+    /** Spacing between adjacent items. See {@link SignalValue}. */
+    readonly gap?: SignalValue<number>;
+    /**
+     * Logical region constraining the content or query. See {@link SignalValue},
+     * {@link AnchoredPlacement}.
+     */
+    readonly bounds?: SignalValue<AnchoredPlacement>;
+    /**
+     * Descendant content or the callback that supplies it. See {@link AnchoredPlacement},
+     * {@link PibblNode}.
+     * @param item - Item being placed.
+     * @param placement - Computed anchor and placement geometry. See {@link AnchoredPlacement}.
+     * @returns Pibbl content for that item. See {@link PibblNode}.
+     */
+    readonly children: (item: T, placement: AnchoredPlacement) => PibblNode;
+}
+/**
+ * Arranges keyed Pibbl content together, clear of every supplied anchor.
+ *
+ * @param props - Anchored items, placement constraints, and child renderer. See
+ * {@link AnchoredLayoutProps} .
+ * @returns Pibbl content positioned using the computed placements. See {@link PibblNode}.
+ *
+ * @see {@link AnchoredLayoutProps}
+ * @see {@link PibblNode}
+ * @see {@link AnchoredItem}
+ */
+export declare function AnchoredLayout<T extends AnchoredItem>(props: AnchoredLayoutProps<T>): PibblNode;

package/dist/features/viz/lib/anchored-layout.js

@@ -0,0 +1,166 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import {
+  Group,
+  resolveSignalValue,
+  useLayoutBox
+} from "@pibbl/core";
+import {
+  pushLayoutBox,
+  setCurrentComponentAfterRender,
+  withHooksForbidden
+} from "@pibbl/core/internal";
+function finite(value, name, nonnegative = false) {
+  if (!Number.isFinite(value) || nonnegative && value < 0)
+    throw new RangeError(
+      `AnchoredLayout ${name} must be finite${nonnegative ? " and nonnegative" : ""}.`
+    );
+  return value;
+}
+function arrange(items, bounds, gap, vertical) {
+  finite(gap, "gap", true);
+  finite(bounds.x, "bounds.x");
+  finite(bounds.y, "bounds.y");
+  finite(bounds.width, "bounds.width", true);
+  finite(bounds.height, "bounds.height", true);
+  finite(bounds.x + bounds.width, "bounds right");
+  finite(bounds.y + bounds.height, "bounds bottom");
+  const keys = /* @__PURE__ */ new Set();
+  const rows = items.map((item, index) => {
+    if (typeof item.key !== "string" && typeof item.key !== "number")
+      throw new TypeError("AnchoredLayout keys must be strings or numbers.");
+    const key = String(item.key);
+    if (keys.has(key))
+      throw new Error(`AnchoredLayout duplicate key "${key}".`);
+    keys.add(key);
+    finite(item.anchor.x, "anchor.x");
+    finite(item.anchor.y, "anchor.y");
+    finite(item.width, "width", true);
+    finite(item.height, "height", true);
+    const radius = finite(item.anchorRadius ?? 0, "anchorRadius", true);
+    return {
+      item,
+      index,
+      key,
+      radius,
+      along: vertical ? item.anchor.y : item.anchor.x,
+      across: vertical ? item.anchor.x : item.anchor.y,
+      size: vertical ? item.height : item.width,
+      breadth: vertical ? item.width : item.height,
+      position: 0
+    };
+  });
+  if (!rows.length) return [];
+  rows.sort(
+    (a, b) => a.along - b.along || (a.key < b.key ? -1 : a.key > b.key ? 1 : 0)
+  );
+  const start = vertical ? bounds.y : bounds.x;
+  const end = finite(
+    start + (vertical ? bounds.height : bounds.width),
+    "packing end"
+  );
+  const acrossStart = vertical ? bounds.x : bounds.y;
+  const acrossEnd = finite(
+    acrossStart + (vertical ? bounds.width : bounds.height),
+    "cross-axis end"
+  );
+  let positive = -Infinity, negative = Infinity, breadth = 0, cursor = start;
+  for (const row of rows) {
+    positive = Math.max(
+      positive,
+      finite(row.across + row.radius + gap, "anchor clearance")
+    );
+    negative = Math.min(
+      negative,
+      finite(row.across - row.radius - gap, "anchor clearance")
+    );
+    breadth = Math.max(breadth, row.breadth);
+    row.position = Math.max(start, row.along - row.size / 2, cursor);
+    cursor = finite(row.position + row.size + gap, "packing position");
+  }
+  let limit = end;
+  for (let i = rows.length - 1; i >= 0; i--) {
+    const row = rows[i];
+    row.position = Math.min(row.position, limit - row.size);
+    limit = finite(row.position - gap, "packing limit");
+  }
+  const shift = Math.max(0, start - rows[0].position);
+  const positiveFits = positive >= acrossStart && positive + breadth <= acrossEnd;
+  const negativeFits = negative - breadth >= acrossStart && negative <= acrossEnd;
+  const usePositive = positiveFits || !negativeFits;
+  const placements = new Array(items.length);
+  for (const row of rows) {
+    const along = finite(row.position + shift, "placement");
+    const across = finite(
+      usePositive ? positive : negative - row.breadth,
+      "placement"
+    );
+    const x = vertical ? across : along, y = vertical ? along : across;
+    finite(x + row.item.width, "placement right");
+    finite(y + row.item.height, "placement bottom");
+    placements[row.index] = {
+      x,
+      y,
+      width: row.item.width,
+      height: row.item.height
+    };
+  }
+  return placements;
+}
+function Item({
+  item,
+  placement,
+  render
+}) {
+  const box = { x: 0, y: 0, width: placement.width, height: placement.height };
+  const outer = pushLayoutBox(box);
+  let inner;
+  try {
+    inner = pushLayoutBox(box);
+    setCurrentComponentAfterRender(() => {
+      inner();
+      outer();
+    });
+  } catch (error) {
+    inner?.();
+    outer();
+    throw error;
+  }
+  return withHooksForbidden(
+    "Pibbl hooks cannot be called in AnchoredLayout children; return a component instead.",
+    () => render(item, placement)
+  );
+}
+function AnchoredLayout(props) {
+  const allocation = useLayoutBox();
+  const items = resolveSignalValue(props.items);
+  if (!Array.isArray(items))
+    throw new TypeError("AnchoredLayout items must be an array.");
+  if (typeof props.children !== "function")
+    throw new TypeError(
+      "AnchoredLayout children must be a synchronous function."
+    );
+  const direction = props.direction ?? "vertical";
+  if (direction !== "vertical" && direction !== "horizontal")
+    throw new TypeError(
+      "AnchoredLayout direction must be vertical or horizontal."
+    );
+  const bounds = props.bounds === void 0 ? { x: 0, y: 0, width: allocation.width, height: allocation.height } : resolveSignalValue(props.bounds);
+  const placements = arrange(
+    items,
+    bounds,
+    resolveSignalValue(props.gap ?? 8),
+    direction === "vertical"
+  );
+  return items.map((item, i) => /* @__PURE__ */ jsx(
+    Group,
+    {
+      style: { translateX: placements[i].x, translateY: placements[i].y },
+      children: /* @__PURE__ */ jsx(Item, { item, placement: placements[i], render: props.children })
+    },
+    String(item.key)
+  ));
+}
+export {
+  AnchoredLayout
+};
+//# sourceMappingURL=anchored-layout.js.map

package/dist/features/viz/lib/anchored-layout.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/anchored-layout.tsx"],
+  "sourcesContent": ["import {\n  Group,\n  resolveSignalValue,\n  useLayoutBox,\n  type PibblNode,\n  type SignalValue,\n} from \"@pibbl/core\";\nimport {\n  pushLayoutBox,\n  setCurrentComponentAfterRender,\n  withHooksForbidden,\n} from \"@pibbl/core/internal\";\n\n/**\n * Declared outer box and protected anchor, all in the parent's local coordinates.\n *\n * @see {@link AnchoredLayout}\n * @see {@link AnchoredLayoutProps}\n */\nexport interface AnchoredItem {\n  /** Stable identity used by the containing protocol. See {@link AnchoredItem}. */\n  readonly key: string | number;\n  /** Logical point to which the content or result is anchored. See {@link AnchoredItem}. */\n  readonly anchor: Readonly<{\n    /**\n     * Horizontal coordinate or displacement in the containing coordinate system. See\n     * {@link AnchoredItem}.\n     */\n    x: number;\n    /**\n     * Vertical coordinate or displacement in the containing coordinate system. See\n     * {@link AnchoredItem}.\n     */\n    y: number;\n  }>;\n  /** Clearance around the anchor before placing the item. See {@link AnchoredItem}. */\n  readonly anchorRadius?: number;\n  /**\n   * Horizontal extent in the units of the containing geometry or surface. See {@link AnchoredItem}\n   * .\n   */\n  readonly width: number;\n  /**\n   * Vertical extent in the units of the containing geometry or surface. See {@link AnchoredItem}.\n   */\n  readonly height: number;\n}\n/**\n * The resolved logical rectangle assigned to an anchored item.\n *\n * @see {@link AnchoredLayoutProps}\n */\nexport interface AnchoredPlacement {\n  /**\n   * Horizontal coordinate or displacement in the containing coordinate system. See\n   * {@link AnchoredPlacement}.\n   */\n  readonly x: number;\n  /**\n   * Vertical coordinate or displacement in the containing coordinate system. See\n   * {@link AnchoredPlacement}.\n   */\n  readonly y: number;\n  /**\n   * Horizontal extent in the units of the containing geometry or surface. See\n   * {@link AnchoredPlacement}.\n   */\n  readonly width: number;\n  /**\n   * Vertical extent in the units of the containing geometry or surface. See\n   * {@link AnchoredPlacement}.\n   */\n  readonly height: number;\n}\n/**\n * Authored inputs for AnchoredLayout, including the declared data and presentation options.\n *\n * @see {@link AnchoredItem}\n * @see {@link SignalValue}\n * @see {@link AnchoredPlacement}\n * @see {@link PibblNode}\n * @see {@link AnchoredLayout}\n */\nexport interface AnchoredLayoutProps<T extends AnchoredItem> {\n  /** Items to place around their declared anchors. See {@link SignalValue}. */\n  readonly items: SignalValue<readonly T[]>;\n  /** Direction in which this operation proceeds. See {@link AnchoredLayoutProps}. */\n  readonly direction?: \"vertical\" | \"horizontal\";\n  /** Spacing between adjacent items. See {@link SignalValue}. */\n  readonly gap?: SignalValue<number>;\n  /**\n   * Logical region constraining the content or query. See {@link SignalValue},\n   * {@link AnchoredPlacement}.\n   */\n  readonly bounds?: SignalValue<AnchoredPlacement>;\n  /**\n   * Descendant content or the callback that supplies it. See {@link AnchoredPlacement},\n   * {@link PibblNode}.\n   * @param item - Item being placed.\n   * @param placement - Computed anchor and placement geometry. See {@link AnchoredPlacement}.\n   * @returns Pibbl content for that item. See {@link PibblNode}.\n   */\n  readonly children: (item: T, placement: AnchoredPlacement) => PibblNode;\n}\nfunction finite(value: number, name: string, nonnegative = false) {\n  if (!Number.isFinite(value) || (nonnegative && value < 0))\n    throw new RangeError(\n      `AnchoredLayout ${name} must be finite${nonnegative ? \" and nonnegative\" : \"\"}.`,\n    );\n  return value;\n}\nfunction arrange(\n  items: readonly AnchoredItem[],\n  bounds: AnchoredPlacement,\n  gap: number,\n  vertical: boolean,\n): AnchoredPlacement[] {\n  finite(gap, \"gap\", true);\n  finite(bounds.x, \"bounds.x\");\n  finite(bounds.y, \"bounds.y\");\n  finite(bounds.width, \"bounds.width\", true);\n  finite(bounds.height, \"bounds.height\", true);\n  finite(bounds.x + bounds.width, \"bounds right\");\n  finite(bounds.y + bounds.height, \"bounds bottom\");\n  const keys = new Set<string>();\n  const rows = items.map((item, index) => {\n    if (typeof item.key !== \"string\" && typeof item.key !== \"number\")\n      throw new TypeError(\"AnchoredLayout keys must be strings or numbers.\");\n    const key = String(item.key);\n    if (keys.has(key))\n      throw new Error(`AnchoredLayout duplicate key \"${key}\".`);\n    keys.add(key);\n    finite(item.anchor.x, \"anchor.x\");\n    finite(item.anchor.y, \"anchor.y\");\n    finite(item.width, \"width\", true);\n    finite(item.height, \"height\", true);\n    const radius = finite(item.anchorRadius ?? 0, \"anchorRadius\", true);\n    return {\n      item,\n      index,\n      key,\n      radius,\n      along: vertical ? item.anchor.y : item.anchor.x,\n      across: vertical ? item.anchor.x : item.anchor.y,\n      size: vertical ? item.height : item.width,\n      breadth: vertical ? item.width : item.height,\n      position: 0,\n    };\n  });\n  if (!rows.length) return [];\n  // Sort a private working list; preserve source paint order when rendering.\n  rows.sort(\n    (a, b) => a.along - b.along || (a.key < b.key ? -1 : a.key > b.key ? 1 : 0),\n  );\n  const start = vertical ? bounds.y : bounds.x;\n  const end = finite(\n    start + (vertical ? bounds.height : bounds.width),\n    \"packing end\",\n  );\n  const acrossStart = vertical ? bounds.x : bounds.y;\n  const acrossEnd = finite(\n    acrossStart + (vertical ? bounds.width : bounds.height),\n    \"cross-axis end\",\n  );\n  let positive = -Infinity,\n    negative = Infinity,\n    breadth = 0,\n    cursor = start;\n  for (const row of rows) {\n    positive = Math.max(\n      positive,\n      finite(row.across + row.radius + gap, \"anchor clearance\"),\n    );\n    negative = Math.min(\n      negative,\n      finite(row.across - row.radius - gap, \"anchor clearance\"),\n    );\n    breadth = Math.max(breadth, row.breadth);\n    row.position = Math.max(start, row.along - row.size / 2, cursor);\n    cursor = finite(row.position + row.size + gap, \"packing position\");\n  }\n  // Back-pack at the far edge, then preserve separation by overflowing if needed.\n  let limit = end;\n  for (let i = rows.length - 1; i >= 0; i--) {\n    const row = rows[i];\n    row.position = Math.min(row.position, limit - row.size);\n    limit = finite(row.position - gap, \"packing limit\");\n  }\n  const shift = Math.max(0, start - rows[0].position);\n  const positiveFits =\n    positive >= acrossStart && positive + breadth <= acrossEnd;\n  const negativeFits =\n    negative - breadth >= acrossStart && negative <= acrossEnd;\n  const usePositive = positiveFits || !negativeFits;\n  const placements: AnchoredPlacement[] = new Array(items.length);\n  for (const row of rows) {\n    const along = finite(row.position + shift, \"placement\");\n    const across = finite(\n      usePositive ? positive : negative - row.breadth,\n      \"placement\",\n    );\n    const x = vertical ? across : along,\n      y = vertical ? along : across;\n    finite(x + row.item.width, \"placement right\");\n    finite(y + row.item.height, \"placement bottom\");\n    placements[row.index] = {\n      x,\n      y,\n      width: row.item.width,\n      height: row.item.height,\n    };\n  }\n  return placements;\n}\nfunction Item<T extends AnchoredItem>({\n  item,\n  placement,\n  render,\n}: {\n  item: T;\n  placement: AnchoredPlacement;\n  render: AnchoredLayoutProps<T>[\"children\"];\n}): PibblNode {\n  const box = { x: 0, y: 0, width: placement.width, height: placement.height };\n  // Both the received allocation and percentage basis belong to the declared box.\n  const outer = pushLayoutBox(box);\n  let inner: (() => void) | undefined;\n  try {\n    inner = pushLayoutBox(box);\n    setCurrentComponentAfterRender(() => {\n      inner!();\n      outer();\n    });\n  } catch (error) {\n    inner?.();\n    outer();\n    throw error;\n  }\n  return withHooksForbidden(\n    \"Pibbl hooks cannot be called in AnchoredLayout children; return a component instead.\",\n    () => render(item, placement),\n  );\n}\n/**\n * Arranges keyed Pibbl content together, clear of every supplied anchor.\n *\n * @param props - Anchored items, placement constraints, and child renderer. See\n * {@link AnchoredLayoutProps} .\n * @returns Pibbl content positioned using the computed placements. See {@link PibblNode}.\n *\n * @see {@link AnchoredLayoutProps}\n * @see {@link PibblNode}\n * @see {@link AnchoredItem}\n */\nexport function AnchoredLayout<T extends AnchoredItem>(\n  props: AnchoredLayoutProps<T>,\n): PibblNode {\n  const allocation = useLayoutBox();\n  const items = resolveSignalValue(props.items);\n  if (!Array.isArray(items))\n    throw new TypeError(\"AnchoredLayout items must be an array.\");\n  if (typeof props.children !== \"function\")\n    throw new TypeError(\n      \"AnchoredLayout children must be a synchronous function.\",\n    );\n  const direction = props.direction ?? \"vertical\";\n  if (direction !== \"vertical\" && direction !== \"horizontal\")\n    throw new TypeError(\n      \"AnchoredLayout direction must be vertical or horizontal.\",\n    );\n  const bounds =\n    props.bounds === undefined\n      ? { x: 0, y: 0, width: allocation.width, height: allocation.height }\n      : resolveSignalValue(props.bounds);\n  const placements = arrange(\n    items,\n    bounds,\n    resolveSignalValue(props.gap ?? 8),\n    direction === \"vertical\",\n  );\n  return items.map((item, i) => (\n    <Group\n      key={String(item.key)}\n      style={{ translateX: placements[i].x, translateY: placements[i].y }}\n    >\n      <Item item={item} placement={placements[i]} render={props.children} />\n    </Group>\n  ));\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,10 @@
+import type { AxisProps } from "./types.js";
+/**
+ * Draws ticks and labels using a named scale and the configured orientation and style.
+ *
+ * @param props - Scale, orientation, tick, label, and styling options. See {@link AxisProps}.
+ * @returns Pibbl nodes drawing the axis.
+ *
+ * @see {@link AxisProps}
+ */
+export declare function Axis(props: AxisProps): (import("../../../jsx-runtime.js").JSX.Element[] | import("../../../jsx-runtime.js").JSX.Element)[];

package/dist/features/viz/lib/axis.js

@@ -0,0 +1,116 @@
+import { jsx } from "@pibbl/core/jsx-runtime";
+import { Path, Text, resolveSignalValue } from "@pibbl/core";
+import { lookupScale } from "./scale-context.js";
+import { width, opacity } from "./paint.js";
+function ticks(scale, props) {
+  if (props.tickValues !== void 0 && props.tickCount !== void 0)
+    throw new TypeError("Axis tickValues and tickCount are mutually exclusive.");
+  const explicit = props.tickValues === void 0 ? void 0 : resolveSignalValue(props.tickValues);
+  if (explicit !== void 0) {
+    if (!Array.isArray(explicit) || explicit.length > 100)
+      throw new RangeError("Axis tickValues must be an array with at most 100 values.");
+    const seen = /* @__PURE__ */ new Set();
+    for (const value of explicit) {
+      if (seen.has(value)) throw new RangeError("Axis tickValues must not contain duplicates.");
+      seen.add(value);
+      if (scale.type === "linear") {
+        if (typeof value !== "number" || !Number.isFinite(value))
+          throw new TypeError("Axis tickValues for a linear scale must be finite numbers.");
+        const [a, b] = scale.domain;
+        if (value < Math.min(a, b) || value > Math.max(a, b))
+          throw new RangeError("Axis tickValues must be within the scale domain.");
+      } else if (typeof value !== "string" && (typeof value !== "number" || !Number.isFinite(value)) || scale.map(value) === void 0) {
+        throw new RangeError("Axis tickValues must be known band categories.");
+      }
+    }
+    return explicit;
+  }
+  const count = resolveSignalValue(props.tickCount ?? 5);
+  if (!Number.isInteger(count) || count < 0 || count > 100)
+    throw new RangeError("Axis tickCount must be an integer from 0 to 100.");
+  if (count === 0) return [];
+  if (scale.type === "linear")
+    return count === 1 ? [scale.domain[0]] : scale.ticks(count);
+  const n = scale.domain.length;
+  if (n === 0) return [];
+  if (count === 1) return [scale.domain[0]];
+  const m = Math.min(count, n);
+  if (m === 1) return [scale.domain[0]];
+  return Array.from(
+    { length: m },
+    (_, index) => scale.domain[Math.round(index * (n - 1) / (m - 1))]
+  );
+}
+function position(scale, value) {
+  return scale.type === "band" ? scale.map(value) + scale.bandwidth / 2 : scale.map(value);
+}
+function Axis(props) {
+  if (props.position !== "bottom" && props.position !== "left" && props.position !== "top" && props.position !== "right")
+    throw new TypeError("Axis position must be bottom, left, top, or right.");
+  const source = lookupScale(props.scale, "Axis");
+  if (!source) throw new TypeError("Axis requires a scale ID.");
+  const scale = source.get();
+  const style = resolveSignalValue(props.style) ?? {};
+  const stroke = resolveSignalValue(style.stroke) ?? "#64748b";
+  const strokeWidth = width(resolveSignalValue(style.strokeWidth) ?? 1, "Axis");
+  const fill = resolveSignalValue(style.fill) ?? "#64748b";
+  const font = resolveSignalValue(style.font) ?? "12px sans-serif";
+  const alpha = opacity(resolveSignalValue(style.opacity) ?? 1, "Axis");
+  const horizontal = props.position === "bottom" || props.position === "top";
+  const outward = props.position === "bottom" || props.position === "right" ? 1 : -1;
+  const baseline = horizontal ? props.position === "bottom" ? scale.frame.height : 0 : props.position === "right" ? scale.frame.width : 0;
+  const selected = ticks(scale, props);
+  const path = new Path2D();
+  if (horizontal) {
+    path.moveTo(scale.range[0], baseline);
+    path.lineTo(scale.range[1], baseline);
+  } else {
+    path.moveTo(baseline, scale.range[0]);
+    path.lineTo(baseline, scale.range[1]);
+  }
+  const labels = selected.map((value, index) => {
+    const p = position(scale, value);
+    if (horizontal) {
+      path.moveTo(p, baseline);
+      path.lineTo(p, baseline + outward * 6);
+    } else {
+      path.moveTo(baseline, p);
+      path.lineTo(baseline + outward * 6, p);
+    }
+    const label = props.tickFormat ? props.tickFormat(value, index) : typeof value === "number" ? String(Number(value.toPrecision(6))) : value;
+    if (typeof label !== "string")
+      throw new TypeError("Axis tickFormat must return a string.");
+    return /* @__PURE__ */ jsx(
+      Text,
+      {
+        pointerEvents: "none",
+        style: {
+          left: horizontal ? p : baseline + outward * 10,
+          top: horizontal ? baseline + outward * 10 : p,
+          fill,
+          font,
+          opacity: alpha,
+          textAlign: horizontal ? "center" : outward < 0 ? "right" : "left",
+          textBaseline: horizontal ? outward > 0 ? "top" : "bottom" : "middle"
+        },
+        children: label
+      },
+      index
+    );
+  });
+  return [
+    /* @__PURE__ */ jsx(
+      Path,
+      {
+        pointerEvents: "none",
+        style: { d: path, stroke, strokeWidth, opacity: alpha }
+      },
+      "axis"
+    ),
+    labels
+  ];
+}
+export {
+  Axis
+};
+//# sourceMappingURL=axis.js.map

package/dist/features/viz/lib/axis.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/viz/lib/axis.tsx"],
+  "sourcesContent": ["import { Path, Text, resolveSignalValue } from \"@pibbl/core\";\nimport type { AxisProps, BandCategory, ResolvedScale } from \"./types.js\";\nimport { lookupScale } from \"./scale-context.js\";\nimport { width, opacity } from \"./paint.js\";\n\ntype Tick = number | string;\n\nfunction ticks(scale: ResolvedScale, props: AxisProps): readonly Tick[] {\n  if (props.tickValues !== undefined && props.tickCount !== undefined)\n    throw new TypeError(\"Axis tickValues and tickCount are mutually exclusive.\");\n  const explicit = props.tickValues === undefined\n    ? undefined\n    : resolveSignalValue(props.tickValues);\n  if (explicit !== undefined) {\n    if (!Array.isArray(explicit) || explicit.length > 100)\n      throw new RangeError(\"Axis tickValues must be an array with at most 100 values.\");\n    const seen = new Set<Tick>();\n    for (const value of explicit) {\n      if (seen.has(value)) throw new RangeError(\"Axis tickValues must not contain duplicates.\");\n      seen.add(value);\n      if (scale.type === \"linear\") {\n        if (typeof value !== \"number\" || !Number.isFinite(value))\n          throw new TypeError(\"Axis tickValues for a linear scale must be finite numbers.\");\n        const [a, b] = scale.domain;\n        if (value < Math.min(a, b) || value > Math.max(a, b))\n          throw new RangeError(\"Axis tickValues must be within the scale domain.\");\n      } else if (\n        (typeof value !== \"string\" &&\n          (typeof value !== \"number\" || !Number.isFinite(value))) ||\n        scale.map(value as BandCategory) === undefined\n      ) {\n        throw new RangeError(\"Axis tickValues must be known band categories.\");\n      }\n    }\n    return explicit;\n  }\n  const count = resolveSignalValue(props.tickCount ?? 5);\n  if (!Number.isInteger(count) || count < 0 || count > 100)\n    throw new RangeError(\"Axis tickCount must be an integer from 0 to 100.\");\n  if (count === 0) return [];\n  if (scale.type === \"linear\")\n    return count === 1 ? [scale.domain[0]] : scale.ticks(count);\n  const n = scale.domain.length;\n  if (n === 0) return [];\n  if (count === 1) return [scale.domain[0]];\n  const m = Math.min(count, n);\n  if (m === 1) return [scale.domain[0]];\n  return Array.from(\n    { length: m },\n    (_, index) => scale.domain[Math.round((index * (n - 1)) / (m - 1))]!,\n  );\n}\n\nfunction position(scale: ResolvedScale, value: Tick): number {\n  return scale.type === \"band\"\n    ? scale.map(value as BandCategory)! + scale.bandwidth / 2\n    : scale.map(value as number);\n}\n\n/**\n * Draws ticks and labels using a named scale and the configured orientation and style.\n *\n * @param props - Scale, orientation, tick, label, and styling options. See {@link AxisProps}.\n * @returns Pibbl nodes drawing the axis.\n *\n * @see {@link AxisProps}\n */\nexport function Axis(props: AxisProps) {\n  if (\n    props.position !== \"bottom\" &&\n    props.position !== \"left\" &&\n    props.position !== \"top\" &&\n    props.position !== \"right\"\n  )\n    throw new TypeError(\"Axis position must be bottom, left, top, or right.\");\n  const source = lookupScale(props.scale, \"Axis\");\n  if (!source) throw new TypeError(\"Axis requires a scale ID.\");\n  const scale = source.get();\n  const style = resolveSignalValue(props.style) ?? {};\n  const stroke = resolveSignalValue(style.stroke) ?? \"#64748b\";\n  const strokeWidth = width(resolveSignalValue(style.strokeWidth) ?? 1, \"Axis\");\n  const fill = resolveSignalValue(style.fill) ?? \"#64748b\";\n  const font = resolveSignalValue(style.font) ?? \"12px sans-serif\";\n  const alpha = opacity(resolveSignalValue(style.opacity) ?? 1, \"Axis\");\n  const horizontal = props.position === \"bottom\" || props.position === \"top\";\n  const outward = props.position === \"bottom\" || props.position === \"right\" ? 1 : -1;\n  const baseline = horizontal\n    ? props.position === \"bottom\" ? scale.frame.height : 0\n    : props.position === \"right\" ? scale.frame.width : 0;\n  const selected = ticks(scale, props);\n  const path = new Path2D();\n  if (horizontal) {\n    path.moveTo(scale.range[0], baseline);\n    path.lineTo(scale.range[1], baseline);\n  } else {\n    path.moveTo(baseline, scale.range[0]);\n    path.lineTo(baseline, scale.range[1]);\n  }\n  const labels = selected.map((value, index) => {\n    const p = position(scale, value);\n    if (horizontal) {\n      path.moveTo(p, baseline);\n      path.lineTo(p, baseline + outward * 6);\n    } else {\n      path.moveTo(baseline, p);\n      path.lineTo(baseline + outward * 6, p);\n    }\n    const label = props.tickFormat\n      ? props.tickFormat(value, index)\n      : typeof value === \"number\"\n        ? String(Number(value.toPrecision(6)))\n        : value;\n    if (typeof label !== \"string\")\n      throw new TypeError(\"Axis tickFormat must return a string.\");\n    return (\n      <Text\n        key={index}\n        pointerEvents=\"none\"\n        style={{\n          left: horizontal ? p : baseline + outward * 10,\n          top: horizontal ? baseline + outward * 10 : p,\n          fill,\n          font,\n          opacity: alpha,\n          textAlign: horizontal ? \"center\" : outward < 0 ? \"right\" : \"left\",\n          textBaseline: horizontal ? outward > 0 ? \"top\" : \"bottom\" : \"middle\",\n        }}\n      >\n        {label}\n      </Text>\n    );\n  });\n  return [\n    <Path\n      key=\"axis\"\n      pointerEvents=\"none\"\n      style={{ d: path, stroke, strokeWidth, opacity: alpha }}\n    />,\n    labels,\n  ];\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,3 @@
+import type { BandDomain, ResolvedBandScale, ScaleRange } from "./types.js";
+/** Explicit category order; padding is measured in step units. */
+export declare function resolveBandScale(input: BandDomain, rangeInput: ScaleRange, reverse: boolean, width: number, height: number, paddingInner: number, paddingOuter: number): ResolvedBandScale;

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

@@ -0,0 +1,57 @@
+import { resolveLinearScale } from "./linear-scale.js";
+function resolveBandScale(input, rangeInput, reverse, width, height, paddingInner, paddingOuter) {
+  if (!Array.isArray(input))
+    throw new TypeError("Band scale domain must be an array.");
+  const indices = /* @__PURE__ */ new Map();
+  for (const category of input) {
+    if (typeof category !== "string" && (typeof category !== "number" || !Number.isFinite(category)))
+      throw new TypeError(
+        "Band scale categories must be strings or finite numbers."
+      );
+    if (indices.has(category))
+      throw new TypeError(
+        `Band scale duplicate category: ${String(category)}.`
+      );
+    indices.set(category, indices.size);
+  }
+  if (!Number.isFinite(paddingInner) || paddingInner < 0 || paddingInner > 1)
+    throw new RangeError("Band scale paddingInner must be between 0 and 1.");
+  if (!Number.isFinite(paddingOuter) || paddingOuter < 0)
+    throw new RangeError(
+      "Band scale paddingOuter must be finite and nonnegative."
+    );
+  const { range, frame } = resolveLinearScale(
+    [0, 1],
+    rangeInput,
+    reverse,
+    width,
+    height
+  );
+  const count = input.length;
+  const span = Math.abs(range[1] - range[0]);
+  const denominator = Math.max(1, count - paddingInner + 2 * paddingOuter);
+  if (!Number.isFinite(denominator))
+    throw new RangeError("Band scale padding arithmetic must be finite.");
+  const step = count === 0 ? 0 : span / denominator;
+  const bandwidth = step * (1 - paddingInner);
+  const offset = (span - step * (count - paddingInner)) / 2;
+  const start = Math.min(...range) + offset;
+  const domain = Object.freeze([...input]);
+  return Object.freeze({
+    type: "band",
+    domain,
+    range,
+    frame,
+    bandwidth,
+    step,
+    map(value) {
+      const index = indices.get(value);
+      if (index === void 0) return void 0;
+      return start + (range[1] < range[0] ? count - 1 - index : index) * step;
+    }
+  });
+}
+export {
+  resolveBandScale
+};
+//# sourceMappingURL=band-scale.js.map