@pibbl/core 0.0.1 → 0.0.3-alpha.85.1

package/dist/features/textures/lib/reaction-diffusion.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/textures/lib/reaction-diffusion.ts"],
-  "sourcesContent": ["import { defineRenderLayer, type PibblRenderLayerInput } from \"@pibbl/core\";\nimport { TextureRaster, type TextureRenderer } from \"./presentation.js\";\nimport { InkSimulation } from \"./simulation.js\";\nimport {\n  paletteLut,\n  texturePalettes,\n  validateResolution,\n  validateSeed,\n  type TexturePalette,\n  type TextureResolution,\n} from \"./palette.js\";\n\n/**\n * Radius and strength of a reaction-diffusion brush stroke.\n *\n * @see {@link ReactionDiffusionProps}\n */\nexport interface TextureBrush {\n  /** Radius in the coordinate system of this geometry or effect. See {@link TextureBrush}. */\n  readonly radius: number;\n  /** Magnitude of the displacement or brush effect. See {@link TextureBrush}. */\n  readonly strength: number;\n}\n/**\n * Authored inputs for ReactionDiffusion, including the declared data and presentation options.\n *\n * @see {@link TextureRenderer}\n * @see {@link TextureResolution}\n * @see {@link TexturePalette}\n * @see {@link TextureBrush}\n * @see {@link ReactionDiffusion}\n */\nexport interface ReactionDiffusionProps {\n  /**\n   * Renders the current data or resources using the supplied context. See {@link TextureRenderer}\n   * .\n   */\n  readonly render?: TextureRenderer;\n  /** Dimensions of the simulation or raster grid. See {@link TextureResolution}. */\n  readonly resolution?: TextureResolution;\n  /**\n   * Seed used for deterministic sampling or simulation initialization. See\n   * {@link ReactionDiffusionProps}.\n   */\n  readonly seed?: number;\n  /**\n   * Named pattern configuration used to initialize the simulation. See\n   * {@link ReactionDiffusionProps}.\n   */\n  readonly preset?: \"spots\" | \"stripes\";\n  /** Ordered colors used to present texture intensity. See {@link TexturePalette}. */\n  readonly palette?: TexturePalette;\n  /**\n   * Whether simulation or playback advancement is suspended. See {@link ReactionDiffusionProps}.\n   */\n  readonly paused?: boolean;\n  /**\n   * Changing this revision requests a fresh simulation initialization. See\n   * {@link ReactionDiffusionProps}.\n   */\n  readonly resetRevision?: number;\n  /**\n   * Brush configuration for interactive reaction-diffusion input, or false to disable it. See\n   * {@link TextureBrush}.\n   */\n  readonly brush?: TextureBrush | false;\n}\ninterface Options {\n  resolution: TextureResolution;\n  seed: number;\n  preset: \"spots\" | \"stripes\";\n  palette: TexturePalette;\n  paused: boolean;\n  resetRevision: number;\n  brush: TextureBrush | false;\n}\nfunction options(props: ReactionDiffusionProps): Options {\n  const preset = props.preset ?? \"spots\";\n  if (preset !== \"spots\" && preset !== \"stripes\")\n    throw new TypeError(\"Unknown reaction-diffusion preset.\");\n  const brush = props.brush ?? { radius: 6, strength: 0.8 };\n  if (\n    brush &&\n    (!Number.isFinite(brush.radius) ||\n      brush.radius <= 0 ||\n      brush.radius > 128 ||\n      !Number.isFinite(brush.strength) ||\n      brush.strength < 0 ||\n      brush.strength > 1)\n  )\n    throw new RangeError(\n      \"Brush radius must be in (0,128] and strength in [0,1].\",\n    );\n  if (!Number.isSafeInteger(props.resetRevision ?? 0))\n    throw new RangeError(\"resetRevision must be a safe integer.\");\n  return {\n    resolution: validateResolution(props.resolution),\n    seed: validateSeed(props.seed),\n    preset,\n    palette: [...(props.palette ?? texturePalettes.lagoon)],\n    paused: props.paused ?? false,\n    resetRevision: props.resetRevision ?? 0,\n    brush: brush && { ...brush },\n  };\n}\ninterface Stroke {\n  x: number;\n  y: number;\n  radius: number;\n  strength: number;\n}\ninterface Resources {\n  render?: TextureRenderer;\n  config: Options;\n  simulation: InkSimulation;\n  raster: TextureRaster;\n  output: OffscreenCanvasRenderingContext2D;\n  lut: Uint8ClampedArray;\n  elapsed: number;\n  fresh: boolean;\n  dirty: boolean;\n  disposed: boolean;\n  target: object;\n  strokes: Stroke[];\n  pointer?: { id: number; x: number; y: number; release: () => void };\n  invalidate: () => void;\n}\nfunction reset(r: Resources, config: Options) {\n  const { width, height } = config.resolution;\n  const simulation = new InkSimulation(\n    width,\n    height,\n    config.seed,\n    config.preset,\n  );\n  let raster: TextureRaster;\n  try {\n    raster = new TextureRaster(width, height);\n  } catch (error) {\n    simulation.dispose();\n    throw error;\n  }\n  r.simulation.dispose();\n  r.simulation = simulation;\n  r.raster.dispose();\n  r.raster = raster;\n  r.strokes.length = 0;\n  r.pointer?.release();\n  r.pointer = undefined;\n  r.elapsed = 0;\n  r.fresh = true;\n  r.dirty = true;\n}\nfunction input(\n  r: Resources,\n  event: Readonly<PibblRenderLayerInput<object>>,\n  width: number,\n  height: number,\n) {\n  if (r.disposed) return;\n  const original = event.originalEvent as PointerEvent;\n  if (event.type === \"pointerup\" || event.type === \"pointercancel\") {\n    if (r.pointer?.id === original.pointerId) {\n      r.pointer.release();\n      r.pointer = undefined;\n    }\n    return;\n  }\n  const brush = r.config.brush;\n  if (!brush || width <= 0 || height <= 0) return;\n  const x = (event.point.x / width) * r.simulation.width;\n  const y = (event.point.y / height) * r.simulation.height;\n  if (event.type === \"pointerdown\") {\n    if (r.pointer || original.button !== 0 || original.isPrimary === false)\n      return;\n    event.setPointerCapture(original.pointerId);\n    r.pointer = {\n      id: original.pointerId,\n      x,\n      y,\n      release: () => event.releasePointerCapture(original.pointerId),\n    };\n  } else if (\n    event.type !== \"pointermove\" ||\n    r.pointer?.id !== original.pointerId\n  )\n    return;\n  const previous = r.pointer!;\n  const distance = Math.hypot(x - previous.x, y - previous.y);\n  // Bound work for off-surface capture. Stamps outside the field are ignored, never clamped to its edge.\n  const count = Math.min(\n    4096,\n    Math.max(1, Math.ceil(distance / Math.max(0.5, brush.radius * 0.3))),\n  );\n  for (let i = 1; i <= count; i++) {\n    const px = previous.x + ((x - previous.x) * i) / count,\n      py = previous.y + ((y - previous.y) * i) / count;\n    if (\n      px >= 0 &&\n      py >= 0 &&\n      px < r.simulation.width &&\n      py < r.simulation.height &&\n      r.strokes.length < 8192\n    )\n      r.strokes.push({ x: px, y: py, ...brush });\n  }\n  previous.x = x;\n  previous.y = y;\n  r.invalidate();\n}\n\n/**\n * An independently sized, persistent Gray\u2013Scott surface, advanced by Pibbl's scheduler.\n *\n * @param props - Authored component inputs, supplied through JSX or createElement. See the linked\n * props and style types.\n * @throws When called directly; Pibbl mounts this component through JSX or createElement.\n *\n * @see {@link ReactionDiffusionProps}\n */\nexport const ReactionDiffusion = /* @__PURE__ */ defineRenderLayer<\n  ReactionDiffusionProps,\n  Resources\n>({\n  create(context, props) {\n    const config = options(props),\n      lut = paletteLut(config.palette);\n    const output = context.canvas.getContext(\"2d\");\n    if (!output) throw new Error(\"ReactionDiffusion requires Canvas 2D.\");\n    const { width, height } = config.resolution;\n    const raster = new TextureRaster(width, height);\n    try {\n      return {\n        config,\n        lut,\n        raster,\n        output,\n        render: props.render,\n        simulation: new InkSimulation(\n          width,\n          height,\n          config.seed,\n          config.preset,\n        ),\n        elapsed: 0,\n        fresh: true,\n        dirty: true,\n        disposed: false,\n        target: {},\n        strokes: [],\n        invalidate: context.invalidate,\n      };\n    } catch (error) {\n      raster.dispose();\n      throw error;\n    }\n  },\n  update(r, props) {\n    const next = options(props),\n      old = r.config;\n    if (next.palette.join() !== old.palette.join()) {\n      r.lut = paletteLut(next.palette);\n      r.dirty = true;\n    }\n    if (\n      next.seed !== old.seed ||\n      next.preset !== old.preset ||\n      next.resetRevision !== old.resetRevision ||\n      next.resolution.width !== old.resolution.width ||\n      next.resolution.height !== old.resolution.height\n    )\n      reset(r, next);\n    if (next.paused !== old.paused) {\n      r.elapsed = 0;\n      r.fresh = true;\n    }\n    if (!next.brush) {\n      r.pointer?.release();\n      r.pointer = undefined;\n    }\n    r.config = next;\n    r.render = props.render;\n  },\n  render(r, frame, context) {\n    // The frame invalidator does not gate the committed input snapshot between brush samples.\n    r.invalidate = frame.invalidate;\n    for (const stroke of r.strokes)\n      r.simulation.paint(stroke.x, stroke.y, stroke.radius, stroke.strength);\n    if (r.strokes.length) r.dirty = true;\n    r.strokes.length = 0;\n    if (!r.config.paused && !r.fresh) {\n      r.elapsed += Math.max(0, Math.min(50, frame.delta));\n      const steps = Math.min(24, Math.floor(r.elapsed * 0.48 + 1e-9));\n      r.elapsed -= steps / 0.48;\n      if (steps) {\n        r.simulation.advance(steps);\n        r.dirty = true;\n      }\n    }\n    r.fresh = false;\n    if (r.dirty) {\n      r.raster.update(r.simulation.b, r.lut, 650 / 255);\n      r.dirty = false;\n    }\n    r.raster.draw(\n      r.output,\n      context.size.width,\n      context.size.height,\n      context.size.backingWidth,\n      context.size.backingHeight,\n      r.render,\n    );\n    if (!r.config.paused) frame.invalidate();\n  },\n  interaction: {\n    settle(r, _props, size) {\n      return {\n        targets: [\n          {\n            target: r.target,\n            cursor: r.config.brush ? \"crosshair\" : \"default\",\n          },\n        ],\n        hitTest: () => ({ kind: \"target\", target: r.target }),\n        onInput: (event) => input(r, event, size.width, size.height),\n      };\n    },\n  },\n  dispose(r) {\n    if (r.disposed) return;\n    r.disposed = true;\n    r.pointer?.release();\n    r.pointer = undefined;\n    r.strokes.length = 0;\n    r.invalidate = () => {};\n    r.simulation.dispose();\n    r.raster.dispose();\n    r.render = undefined;\n  },\n});\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  grayScottConfig,\n  type ReactionDiffusionOptions,\n  type ReactionDiffusionPreset,\n} from \"./gray-scott.js\";\nimport { defineRenderLayer, type PibblRenderLayerInput } from \"@pibbl/core\";\nimport { TextureRaster, type TextureRenderer } from \"./presentation.js\";\nimport { InkSimulation } from \"./simulation.js\";\nimport {\n  paletteLut,\n  texturePalettes,\n  validateResolution,\n  type TexturePalette,\n  type TextureResolution,\n} from \"./palette.js\";\n\n/**\n * Radius and strength of a reaction-diffusion brush stroke.\n *\n * @see {@link ReactionDiffusionProps}\n */\nexport interface TextureBrush {\n  /** Radius in the coordinate system of this geometry or effect. See {@link TextureBrush}. */\n  readonly radius: number;\n  /** Magnitude of the displacement or brush effect. See {@link TextureBrush}. */\n  readonly strength: number;\n}\n/**\n * Authored inputs for ReactionDiffusion, including the declared data and presentation options.\n *\n * @see {@link TextureRenderer}\n * @see {@link TextureResolution}\n * @see {@link TexturePalette}\n * @see {@link TextureBrush}\n * @see {@link ReactionDiffusion}\n */\nexport interface ReactionDiffusionProps extends ReactionDiffusionOptions {\n  /**\n   * Renders the current data or resources using the supplied context. See {@link TextureRenderer}\n   * .\n   */\n  readonly render?: TextureRenderer;\n  /** Dimensions of the simulation or raster grid. See {@link TextureResolution}. */\n  readonly resolution?: TextureResolution;\n  /**\n   * Seed used for deterministic sampling or simulation initialization. See\n   * {@link ReactionDiffusionProps}.\n   */\n  readonly seed?: number;\n  /**\n   * Named pattern configuration used to initialize the simulation. See\n   * {@link ReactionDiffusionProps}.\n   */\n  readonly preset?: ReactionDiffusionPreset;\n  /** Ordered colors used to present texture intensity. See {@link TexturePalette}. */\n  readonly palette?: TexturePalette;\n  /**\n   * Whether simulation or playback advancement is suspended. See {@link ReactionDiffusionProps}.\n   */\n  readonly paused?: boolean;\n  /**\n   * Changing this revision requests a fresh simulation initialization. See\n   * {@link ReactionDiffusionProps}.\n   */\n  readonly resetRevision?: number;\n  /**\n   * Brush configuration for interactive reaction-diffusion input, or false to disable it. See\n   * {@link TextureBrush}.\n   */\n  readonly brush?: TextureBrush | false;\n}\ninterface Options {\n  resolution: TextureResolution;\n  seed: number;\n  preset: ReactionDiffusionPreset;\n  feed: number;\n  kill: number;\n  warmupSteps: number;\n  palette: TexturePalette;\n  paused: boolean;\n  resetRevision: number;\n  brush: TextureBrush | false;\n}\nfunction options(props: ReactionDiffusionProps): Options {\n  const chemistry = grayScottConfig(props);\n  const brush = props.brush ?? { radius: 6, strength: 0.8 };\n  if (\n    brush &&\n    (!Number.isFinite(brush.radius) ||\n      brush.radius <= 0 ||\n      brush.radius > 128 ||\n      !Number.isFinite(brush.strength) ||\n      brush.strength < 0 ||\n      brush.strength > 1)\n  )\n    throw new RangeError(\n      \"Brush radius must be in (0,128] and strength in [0,1].\",\n    );\n  if (!Number.isSafeInteger(props.resetRevision ?? 0))\n    throw new RangeError(\"resetRevision must be a safe integer.\");\n  return {\n    resolution: validateResolution(props.resolution),\n    ...chemistry,\n    palette: [...(props.palette ?? texturePalettes.lagoon)],\n    paused: props.paused ?? false,\n    resetRevision: props.resetRevision ?? 0,\n    brush: brush && { ...brush },\n  };\n}\ninterface Stroke {\n  x: number;\n  y: number;\n  radius: number;\n  strength: number;\n}\ninterface Resources {\n  render?: TextureRenderer;\n  config: Options;\n  simulation: InkSimulation;\n  raster: TextureRaster;\n  output: OffscreenCanvasRenderingContext2D;\n  lut: Uint8ClampedArray;\n  elapsed: number;\n  fresh: boolean;\n  dirty: boolean;\n  disposed: boolean;\n  target: object;\n  strokes: Stroke[];\n  pointer?: { id: number; x: number; y: number; release: () => void };\n  invalidate: () => void;\n}\nfunction reset(r: Resources, config: Options) {\n  const { width, height } = config.resolution;\n  const simulation = new InkSimulation({ width, height, ...config });\n  let raster: TextureRaster;\n  try {\n    raster = new TextureRaster(width, height);\n  } catch (error) {\n    simulation.dispose();\n    throw error;\n  }\n  r.simulation.dispose();\n  r.simulation = simulation;\n  r.raster.dispose();\n  r.raster = raster;\n  r.strokes.length = 0;\n  r.pointer?.release();\n  r.pointer = undefined;\n  r.elapsed = 0;\n  r.fresh = true;\n  r.dirty = true;\n}\nfunction input(\n  r: Resources,\n  event: Readonly<PibblRenderLayerInput<object>>,\n  width: number,\n  height: number,\n) {\n  if (r.disposed) return;\n  const original = event.originalEvent as PointerEvent;\n  if (event.type === \"pointerup\" || event.type === \"pointercancel\") {\n    if (r.pointer?.id === original.pointerId) {\n      r.pointer.release();\n      r.pointer = undefined;\n    }\n    return;\n  }\n  const brush = r.config.brush;\n  if (!brush || width <= 0 || height <= 0) return;\n  const x = (event.point.x / width) * r.simulation.width;\n  const y = (event.point.y / height) * r.simulation.height;\n  if (event.type === \"pointerdown\") {\n    if (r.pointer || original.button !== 0 || original.isPrimary === false)\n      return;\n    event.setPointerCapture(original.pointerId);\n    r.pointer = {\n      id: original.pointerId,\n      x,\n      y,\n      release: () => event.releasePointerCapture(original.pointerId),\n    };\n  } else if (\n    event.type !== \"pointermove\" ||\n    r.pointer?.id !== original.pointerId\n  )\n    return;\n  const previous = r.pointer!;\n  const distance = Math.hypot(x - previous.x, y - previous.y);\n  // Bound work for off-surface capture. Stamps outside the field are ignored, never clamped to its edge.\n  const count = Math.min(\n    4096,\n    Math.max(1, Math.ceil(distance / Math.max(0.5, brush.radius * 0.3))),\n  );\n  for (let i = 1; i <= count; i++) {\n    const px = previous.x + ((x - previous.x) * i) / count,\n      py = previous.y + ((y - previous.y) * i) / count;\n    if (\n      px >= 0 &&\n      py >= 0 &&\n      px < r.simulation.width &&\n      py < r.simulation.height &&\n      r.strokes.length < 8192\n    )\n      r.strokes.push({ x: px, y: py, ...brush });\n  }\n  previous.x = x;\n  previous.y = y;\n  r.invalidate();\n}\n\n/**\n * An independently sized, persistent Gray\u2013Scott surface, advanced by Pibbl's scheduler.\n *\n * @param props - Authored component inputs, supplied through JSX or createElement. See the linked\n * props and style types.\n * @throws When called directly; Pibbl mounts this component through JSX or createElement.\n *\n * @see {@link ReactionDiffusionProps}\n */\nexport const ReactionDiffusion = /* @__PURE__ */ defineRenderLayer<\n  ReactionDiffusionProps,\n  Resources\n>({\n  create(context, props) {\n    const config = options(props),\n      lut = paletteLut(config.palette);\n    const output = context.canvas.getContext(\"2d\");\n    if (!output) throw new Error(\"ReactionDiffusion requires Canvas 2D.\");\n    const { width, height } = config.resolution;\n    const raster = new TextureRaster(width, height);\n    try {\n      return {\n        config,\n        lut,\n        raster,\n        output,\n        render: props.render,\n        simulation: new InkSimulation({ width, height, ...config }),\n        elapsed: 0,\n        fresh: true,\n        dirty: true,\n        disposed: false,\n        target: {},\n        strokes: [],\n        invalidate: context.invalidate,\n      };\n    } catch (error) {\n      raster.dispose();\n      throw error;\n    }\n  },\n  update(r, props) {\n    const next = options(props),\n      old = r.config;\n    if (next.palette.join() !== old.palette.join()) {\n      r.lut = paletteLut(next.palette);\n      r.dirty = true;\n    }\n    if (\n      next.seed !== old.seed ||\n      next.preset !== old.preset ||\n      next.feed !== old.feed ||\n      next.kill !== old.kill ||\n      next.warmupSteps !== old.warmupSteps ||\n      next.resetRevision !== old.resetRevision ||\n      next.resolution.width !== old.resolution.width ||\n      next.resolution.height !== old.resolution.height\n    )\n      reset(r, next);\n    if (next.paused !== old.paused) {\n      r.elapsed = 0;\n      r.fresh = true;\n    }\n    if (!next.brush) {\n      r.pointer?.release();\n      r.pointer = undefined;\n    }\n    r.config = next;\n    r.render = props.render;\n  },\n  render(r, frame, context) {\n    // The frame invalidator does not gate the committed input snapshot between brush samples.\n    r.invalidate = frame.invalidate;\n    for (const stroke of r.strokes)\n      r.simulation.paint(stroke.x, stroke.y, stroke.radius, stroke.strength);\n    if (r.strokes.length) r.dirty = true;\n    r.strokes.length = 0;\n    if (!r.config.paused && !r.fresh) {\n      r.elapsed += Math.max(0, Math.min(50, frame.delta));\n      const steps = Math.min(24, Math.floor(r.elapsed * 0.48 + 1e-9));\n      r.elapsed -= steps / 0.48;\n      if (steps) {\n        r.simulation.advance(steps);\n        r.dirty = true;\n      }\n    }\n    r.fresh = false;\n    if (r.dirty) {\n      r.raster.update(r.simulation.b, r.lut, 650 / 255);\n      r.dirty = false;\n    }\n    r.raster.draw(\n      r.output,\n      context.size.width,\n      context.size.height,\n      context.size.backingWidth,\n      context.size.backingHeight,\n      r.render,\n    );\n    if (!r.config.paused) frame.invalidate();\n  },\n  interaction: {\n    settle(r, _props, size) {\n      return {\n        targets: [\n          {\n            target: r.target,\n            cursor: r.config.brush ? \"crosshair\" : \"default\",\n          },\n        ],\n        hitTest: () => ({ kind: \"target\", target: r.target }),\n        onInput: (event) => input(r, event, size.width, size.height),\n      };\n    },\n  },\n  dispose(r) {\n    if (r.disposed) return;\n    r.disposed = true;\n    r.pointer?.release();\n    r.pointer = undefined;\n    r.strokes.length = 0;\n    r.invalidate = () => {};\n    r.simulation.dispose();\n    r.raster.dispose();\n    r.render = undefined;\n  },\n});\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/features/textures/lib/simulation.d.ts

@@ -1,14 +1,20 @@
+import { grayScottConfig, type ReactionDiffusionOptions } from "./gray-scott.js";
 /** Private WASM Gray–Scott state. Pibbl owns the clock and resource lifetime. */
 export declare class InkSimulation {
-    readonly width: number;
-    readonly height: number;
-    readonly preset: "spots" | "stripes";
     a: Float32Array;
     b: Float32Array;
     private owner?;
     private parity;
     steps: number;
-    constructor(width: number, height: number, seed: number, preset: "spots" | "stripes");
+    readonly width: number;
+    readonly height: number;
+    readonly preset: ReturnType<typeof grayScottConfig>["preset"];
+    private readonly feed;
+    private readonly kill;
+    constructor(options: ReactionDiffusionOptions & {
+        width: number;
+        height: number;
+    });
     paint(x: number, y: number, radius: number, strength: number): void;
     stir(x: number, y: number, dx: number, dy: number, radius: number): void;
     advance(count: number): void;

package/dist/features/textures/lib/simulation.js

@@ -1,11 +1,28 @@
+import {
+  grayScottConfig
+} from "./gray-scott.js";
 import { FieldMemory, lazyKernel } from "./wasm/memory.js";
 import { bytes } from "./wasm/ink-bytes.js";
 const module = /* @__PURE__ */ lazyKernel(bytes);
 class InkSimulation {
-  constructor(width, height, seed, preset) {
+  a;
+  b;
+  owner;
+  parity = 0;
+  steps = 0;
+  width;
+  height;
+  preset;
+  feed;
+  kill;
+  constructor(options) {
+    const { width, height } = options;
+    const config = grayScottConfig(options);
     this.width = width;
     this.height = height;
-    this.preset = preset;
+    this.preset = config.preset;
+    this.feed = config.feed;
+    this.kill = config.kill;
     const owner = this.owner = new FieldMemory(module(), width, height, 4);
     [this.a, this.b] = owner.fields;
     owner.kernel.initialize(
@@ -13,17 +30,10 @@ class InkSimulation {
       this.b.byteOffset,
       width,
       height,
-      seed
+      config.seed
     );
+    if (config.warmupSteps) this.advance(config.warmupSteps);
   }
-  width;
-  height;
-  preset;
-  a;
-  b;
-  owner;
-  parity = 0;
-  steps = 0;
   paint(x, y, radius, strength) {
     const owner = this.owner;
     owner.stamps[0] = x;
@@ -65,8 +75,8 @@ class InkSimulation {
       this.width,
       this.height,
       count,
-      this.preset === "spots" ? 0.0367 : 0.029,
-      this.preset === "spots" ? 0.0649 : 0.057
+      this.feed,
+      this.kill
     );
     if (count % 2) this.parity = next;
     this.a = owner.fields[this.parity];

package/dist/features/textures/lib/simulation.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/features/textures/lib/simulation.ts"],
-  "sourcesContent": ["import { FieldMemory, lazyKernel } from \"./wasm/memory.js\";\nimport { bytes } from \"./wasm/ink-bytes.js\";\nconst module = /* @__PURE__ */ lazyKernel(bytes);\n/** Private WASM Gray\u2013Scott state. Pibbl owns the clock and resource lifetime. */\nexport class InkSimulation {\n  a: Float32Array;\n  b: Float32Array;\n  private owner?: FieldMemory;\n  private parity = 0;\n  steps = 0;\n  constructor(\n    readonly width: number,\n    readonly height: number,\n    seed: number,\n    readonly preset: \"spots\" | \"stripes\",\n  ) {\n    const owner = (this.owner = new FieldMemory(module(), width, height, 4));\n    [this.a, this.b] = owner.fields;\n    owner.kernel.initialize(\n      this.a.byteOffset,\n      this.b.byteOffset,\n      width,\n      height,\n      seed,\n    );\n  }\n  paint(x: number, y: number, radius: number, strength: number) {\n    const owner = this.owner!;\n    owner.stamps[0] = x;\n    owner.stamps[1] = y;\n    owner.stamps[2] = radius;\n    owner.stamps[3] = strength;\n    owner.kernel.paintBatch(\n      this.a.byteOffset,\n      this.b.byteOffset,\n      this.width,\n      this.height,\n      owner.stamps.byteOffset,\n      1,\n    );\n  }\n  stir(x: number, y: number, dx: number, dy: number, radius: number) {\n    const owner = this.owner!,\n      next = 2 - this.parity;\n    owner.kernel.stir(\n      this.a.byteOffset,\n      this.b.byteOffset,\n      owner.fields[next].byteOffset,\n      owner.fields[next + 1].byteOffset,\n      this.width,\n      this.height,\n      x,\n      y,\n      dx,\n      dy,\n      radius,\n    );\n  }\n  advance(count: number) {\n    const owner = this.owner!,\n      next = 2 - this.parity;\n    owner.kernel.advance(\n      this.a.byteOffset,\n      this.b.byteOffset,\n      owner.fields[next].byteOffset,\n      owner.fields[next + 1].byteOffset,\n      this.width,\n      this.height,\n      count,\n      this.preset === \"spots\" ? 0.0367 : 0.029,\n      this.preset === \"spots\" ? 0.0649 : 0.057,\n    );\n    if (count % 2) this.parity = next;\n    this.a = owner.fields[this.parity];\n    this.b = owner.fields[this.parity + 1];\n    this.steps += count;\n  }\n  dispose() {\n    this.owner?.dispose();\n    this.owner = undefined;\n    this.a = this.b = new Float32Array(0);\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,aAAa,kBAAkB;AACxC,SAAS,aAAa;AACtB,MAAM,SAAyB,2BAAW,KAAK;AAExC,MAAM,cAAc;AAAA,EAMzB,YACW,OACA,QACT,MACS,QACT;AAJS;AACA;AAEA;AAET,UAAM,QAAS,KAAK,QAAQ,IAAI,YAAY,OAAO,GAAG,OAAO,QAAQ,CAAC;AACtE,KAAC,KAAK,GAAG,KAAK,CAAC,IAAI,MAAM;AACzB,UAAM,OAAO;AAAA,MACX,KAAK,EAAE;AAAA,MACP,KAAK,EAAE;AAAA,MACP;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAdW;AAAA,EACA;AAAA,EAEA;AAAA,EATX;AAAA,EACA;AAAA,EACQ;AAAA,EACA,SAAS;AAAA,EACjB,QAAQ;AAAA,EAiBR,MAAM,GAAW,GAAW,QAAgB,UAAkB;AAC5D,UAAM,QAAQ,KAAK;AACnB,UAAM,OAAO,CAAC,IAAI;AAClB,UAAM,OAAO,CAAC,IAAI;AAClB,UAAM,OAAO,CAAC,IAAI;AAClB,UAAM,OAAO,CAAC,IAAI;AAClB,UAAM,OAAO;AAAA,MACX,KAAK,EAAE;AAAA,MACP,KAAK,EAAE;AAAA,MACP,KAAK;AAAA,MACL,KAAK;AAAA,MACL,MAAM,OAAO;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK,GAAW,GAAW,IAAY,IAAY,QAAgB;AACjE,UAAM,QAAQ,KAAK,OACjB,OAAO,IAAI,KAAK;AAClB,UAAM,OAAO;AAAA,MACX,KAAK,EAAE;AAAA,MACP,KAAK,EAAE;AAAA,MACP,MAAM,OAAO,IAAI,EAAE;AAAA,MACnB,MAAM,OAAO,OAAO,CAAC,EAAE;AAAA,MACvB,KAAK;AAAA,MACL,KAAK;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EACA,QAAQ,OAAe;AACrB,UAAM,QAAQ,KAAK,OACjB,OAAO,IAAI,KAAK;AAClB,UAAM,OAAO;AAAA,MACX,KAAK,EAAE;AAAA,MACP,KAAK,EAAE;AAAA,MACP,MAAM,OAAO,IAAI,EAAE;AAAA,MACnB,MAAM,OAAO,OAAO,CAAC,EAAE;AAAA,MACvB,KAAK;AAAA,MACL,KAAK;AAAA,MACL;AAAA,MACA,KAAK,WAAW,UAAU,SAAS;AAAA,MACnC,KAAK,WAAW,UAAU,SAAS;AAAA,IACrC;AACA,QAAI,QAAQ,EAAG,MAAK,SAAS;AAC7B,SAAK,IAAI,MAAM,OAAO,KAAK,MAAM;AACjC,SAAK,IAAI,MAAM,OAAO,KAAK,SAAS,CAAC;AACrC,SAAK,SAAS;AAAA,EAChB;AAAA,EACA,UAAU;AACR,SAAK,OAAO,QAAQ;AACpB,SAAK,QAAQ;AACb,SAAK,IAAI,KAAK,IAAI,IAAI,aAAa,CAAC;AAAA,EACtC;AACF;",
+  "sourcesContent": ["import {\n  grayScottConfig,\n  type ReactionDiffusionOptions,\n} from \"./gray-scott.js\";\nimport { FieldMemory, lazyKernel } from \"./wasm/memory.js\";\nimport { bytes } from \"./wasm/ink-bytes.js\";\nconst module = /* @__PURE__ */ lazyKernel(bytes);\n/** Private WASM Gray\u2013Scott state. Pibbl owns the clock and resource lifetime. */\nexport class InkSimulation {\n  a: Float32Array;\n  b: Float32Array;\n  private owner?: FieldMemory;\n  private parity = 0;\n  steps = 0;\n  readonly width: number;\n  readonly height: number;\n  readonly preset: ReturnType<typeof grayScottConfig>[\"preset\"];\n  private readonly feed: number;\n  private readonly kill: number;\n  constructor(\n    options: ReactionDiffusionOptions & { width: number; height: number },\n  ) {\n    const { width, height } = options;\n    const config = grayScottConfig(options);\n    this.width = width;\n    this.height = height;\n    this.preset = config.preset;\n    this.feed = config.feed;\n    this.kill = config.kill;\n    const owner = (this.owner = new FieldMemory(module(), width, height, 4));\n    [this.a, this.b] = owner.fields;\n    owner.kernel.initialize(\n      this.a.byteOffset,\n      this.b.byteOffset,\n      width,\n      height,\n      config.seed,\n    );\n    if (config.warmupSteps) this.advance(config.warmupSteps);\n  }\n  paint(x: number, y: number, radius: number, strength: number) {\n    const owner = this.owner!;\n    owner.stamps[0] = x;\n    owner.stamps[1] = y;\n    owner.stamps[2] = radius;\n    owner.stamps[3] = strength;\n    owner.kernel.paintBatch(\n      this.a.byteOffset,\n      this.b.byteOffset,\n      this.width,\n      this.height,\n      owner.stamps.byteOffset,\n      1,\n    );\n  }\n  stir(x: number, y: number, dx: number, dy: number, radius: number) {\n    const owner = this.owner!,\n      next = 2 - this.parity;\n    owner.kernel.stir(\n      this.a.byteOffset,\n      this.b.byteOffset,\n      owner.fields[next].byteOffset,\n      owner.fields[next + 1].byteOffset,\n      this.width,\n      this.height,\n      x,\n      y,\n      dx,\n      dy,\n      radius,\n    );\n  }\n  advance(count: number) {\n    const owner = this.owner!,\n      next = 2 - this.parity;\n    owner.kernel.advance(\n      this.a.byteOffset,\n      this.b.byteOffset,\n      owner.fields[next].byteOffset,\n      owner.fields[next + 1].byteOffset,\n      this.width,\n      this.height,\n      count,\n      this.feed,\n      this.kill,\n    );\n    if (count % 2) this.parity = next;\n    this.a = owner.fields[this.parity];\n    this.b = owner.fields[this.parity + 1];\n    this.steps += count;\n  }\n  dispose() {\n    this.owner?.dispose();\n    this.owner = undefined;\n    this.a = this.b = new Float32Array(0);\n  }\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,OAEK;AACP,SAAS,aAAa,kBAAkB;AACxC,SAAS,aAAa;AACtB,MAAM,SAAyB,2BAAW,KAAK;AAExC,MAAM,cAAc;AAAA,EACzB;AAAA,EACA;AAAA,EACQ;AAAA,EACA,SAAS;AAAA,EACjB,QAAQ;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EACQ;AAAA,EACA;AAAA,EACjB,YACE,SACA;AACA,UAAM,EAAE,OAAO,OAAO,IAAI;AAC1B,UAAM,SAAS,gBAAgB,OAAO;AACtC,SAAK,QAAQ;AACb,SAAK,SAAS;AACd,SAAK,SAAS,OAAO;AACrB,SAAK,OAAO,OAAO;AACnB,SAAK,OAAO,OAAO;AACnB,UAAM,QAAS,KAAK,QAAQ,IAAI,YAAY,OAAO,GAAG,OAAO,QAAQ,CAAC;AACtE,KAAC,KAAK,GAAG,KAAK,CAAC,IAAI,MAAM;AACzB,UAAM,OAAO;AAAA,MACX,KAAK,EAAE;AAAA,MACP,KAAK,EAAE;AAAA,MACP;AAAA,MACA;AAAA,MACA,OAAO;AAAA,IACT;AACA,QAAI,OAAO,YAAa,MAAK,QAAQ,OAAO,WAAW;AAAA,EACzD;AAAA,EACA,MAAM,GAAW,GAAW,QAAgB,UAAkB;AAC5D,UAAM,QAAQ,KAAK;AACnB,UAAM,OAAO,CAAC,IAAI;AAClB,UAAM,OAAO,CAAC,IAAI;AAClB,UAAM,OAAO,CAAC,IAAI;AAClB,UAAM,OAAO,CAAC,IAAI;AAClB,UAAM,OAAO;AAAA,MACX,KAAK,EAAE;AAAA,MACP,KAAK,EAAE;AAAA,MACP,KAAK;AAAA,MACL,KAAK;AAAA,MACL,MAAM,OAAO;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK,GAAW,GAAW,IAAY,IAAY,QAAgB;AACjE,UAAM,QAAQ,KAAK,OACjB,OAAO,IAAI,KAAK;AAClB,UAAM,OAAO;AAAA,MACX,KAAK,EAAE;AAAA,MACP,KAAK,EAAE;AAAA,MACP,MAAM,OAAO,IAAI,EAAE;AAAA,MACnB,MAAM,OAAO,OAAO,CAAC,EAAE;AAAA,MACvB,KAAK;AAAA,MACL,KAAK;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EACA,QAAQ,OAAe;AACrB,UAAM,QAAQ,KAAK,OACjB,OAAO,IAAI,KAAK;AAClB,UAAM,OAAO;AAAA,MACX,KAAK,EAAE;AAAA,MACP,KAAK,EAAE;AAAA,MACP,MAAM,OAAO,IAAI,EAAE;AAAA,MACnB,MAAM,OAAO,OAAO,CAAC,EAAE;AAAA,MACvB,KAAK;AAAA,MACL,KAAK;AAAA,MACL;AAAA,MACA,KAAK;AAAA,MACL,KAAK;AAAA,IACP;AACA,QAAI,QAAQ,EAAG,MAAK,SAAS;AAC7B,SAAK,IAAI,MAAM,OAAO,KAAK,MAAM;AACjC,SAAK,IAAI,MAAM,OAAO,KAAK,SAAS,CAAC;AACrC,SAAK,SAAS;AAAA,EAChB;AAAA,EACA,UAAU;AACR,SAAK,OAAO,QAAQ;AACpB,SAAK,QAAQ;AACb,SAAK,IAAI,KAAK,IAAI,IAAI,aAAa,CAAC;AAAA,EACtC;AACF;",
   "names": []
 }

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

@@ -1,10 +1,23 @@
-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 { LinearScale } from "./lib/linear-scale-component.js";
+export { BarScale } from "./lib/bar-scale.js";
+export { UTCScale } from "./lib/utc-scale-component.js";
+export { useLinearScale } from "./lib/use-linear-scale.js";
+export { useBarScale } from "./lib/use-bar-scale.js";
+export { useUTCScale } from "./lib/use-utc-scale.js";
+export type { ScaleId, LinearDomain, BandCategory, BandDomain, BarScaleProps, BandScaleRange, ResolvedBandScale, ScaleRange, ScaleLayoutStyle, LinearScaleProps, ResolvedLinearScale, ResolvedScale, } from "./lib/types.js";
 export { Axis } from "./lib/axis.js";
 export { LineSeries } from "./lib/line-series.js";
+export { AreaSeries } from "./lib/area-series.js";
+export type { AreaSeriesProps, AreaSeriesStyle } from "./lib/area-series.js";
+export { IntervalBandSeries } from "./lib/interval-band-series.js";
+export type { IntervalBandSeriesProps } from "./lib/interval-band-series.js";
+export { HorizontalIntervalSeries, VerticalIntervalSeries, } from "./lib/interval-series.js";
+export type { IntervalSeriesStyle, IntervalSeriesProps, HorizontalIntervalSeriesProps, VerticalIntervalSeriesProps, } from "./lib/interval-series.js";
+export type { SeriesCurve } from "./lib/curve-definition.js";
+export { stepBefore, stepAfter, stepMidpoint } from "./lib/step-curves.js";
+export { monotoneX } from "./lib/monotone-curve.js";
 export { ScaleAdjust } from "./lib/scale-adjust.js";
-export type { AxisStyle, AxisProps, LineCoordinate, LineAccessor, LineCurve, LineSeriesStyle, LineSeriesProps, ScaleAdjustProps, } from "./lib/types.js";
+export type { AxisStyle, AxisProps, LineCoordinate, LineAccessor, SeriesAccessor, SeriesCoordinate, 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";
@@ -25,4 +38,65 @@ export type { BarThresholdFill, BarCategoryAccessor, BarSeriesStyle, BarStyleRes
 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";
+export type { PieLayoutProps, PieLayoutStyle, PieLayoutSlice, PieLabelPlacement, PieLabelLayout, PieSliceProps, PieSliceStyle, PieLabelProps, PieLabelStyle, } from "./lib/pie-types.js";
+export { extent, niceUTCDomain } from "./lib/utc-scale.js";
+export type { NumericDomain, UtcDomain, UTCScaleProps, ResolvedUtcScale, ResolvedContinuousScale, } from "./lib/types.js";
+export { linearTicks, niceLinearDomain, formatNumber, } from "./lib/numeric-ticks.js";
+export type { LinearTickOptions, NumberFormatOptions, } from "./lib/numeric-ticks.js";
+export { interpolateNumericRange } from "./lib/numeric-range-interpolation.js";
+export { visibleOhlcPriceExtent, padLinearDomain, } from "./lib/financial-autoscale.js";
+export type { VisibleOhlcPriceExtentOptions, PadLinearDomainOptions, } from "./lib/financial-autoscale.js";
+export { percentageReturns, indexTo100 } from "./lib/financial-comparison.js";
+export type { ComparisonBaseOptions, PercentageReturnPoint, IndexedValuePoint, } from "./lib/financial-comparison.js";
+export { aggregateOhlcv, sessionVwap } from "./lib/financial-aggregation.js";
+export type { OhlcvBucket, OhlcvSource, AggregatedOhlcvPoint, AggregateOhlcvOptions, SessionIdentifier, SessionAccessor, SessionVwapOptions, SessionVwapPoint, } from "./lib/financial-aggregation.js";
+export { RangeNavigator, EditableReferenceLine, EditableReferenceBand, EditableTrendLine, } from "./lib/editable-chart-elements.js";
+export type { ChartAnchor, RangeNavigatorProps, RangeNavigatorStyle, EditableReferenceLineProps, EditableReferenceLineStyle, EditableReferenceBandProps, EditableReferenceBandStyle, EditableTrendLineProps, EditableTrendLineStyle, } from "./lib/editable-chart-elements.js";
+export { simpleMovingAverage, exponentialMovingAverage, bollingerBands, } from "./lib/financial-indicators.js";
+export type { MovingAverageOptions, BollingerBandsOptions, MovingAveragePoint, BollingerBandPoint, } from "./lib/financial-indicators.js";
+export { relativeStrengthIndex, movingAverageConvergenceDivergence, stochasticOscillator, } from "./lib/financial-oscillators.js";
+export type { OscillatorOptions, RelativeStrengthIndexOptions, MovingAverageConvergenceDivergenceOptions, StochasticOscillatorOptions, RelativeStrengthIndexPoint, MovingAverageConvergenceDivergencePoint, StochasticOscillatorPoint, } from "./lib/financial-oscillators.js";
+export { utcTickLabels } from "./lib/utc-labels.js";
+export type { UTCTickLabelOptions } from "./lib/utc-labels.js";
+export { LogScale } from "./lib/log-scale-component.js";
+export { useLogScale } from "./lib/use-log-scale.js";
+export type { LogScaleProps, ResolvedLogScale } from "./lib/types.js";
+export { SymlogScale } from "./lib/symlog-scale-component.js";
+export { useSymlogScale } from "./lib/use-symlog-scale.js";
+export type { SymlogScaleProps, ResolvedSymlogScale } from "./lib/types.js";
+export { PointScale } from "./lib/point-scale-component.js";
+export { usePointScale } from "./lib/use-point-scale.js";
+export type { PointScaleProps, ResolvedPointScale } from "./lib/types.js";
+export { GridLines, ReferenceLine } from "./lib/chart-lines.js";
+export type { ChartLineProps, GridLinesProps, ReferenceLineProps, } from "./lib/chart-lines.js";
+export { ReferenceBand } from "./lib/reference-band.js";
+export type { ReferenceBandProps } from "./lib/reference-band.js";
+export { AxisTitle } from "./lib/axis-title.js";
+export type { AxisTitleProps } from "./lib/axis-title.js";
+export { panDomain, zoomDomain } from "./lib/domain-navigation.js";
+export type { DomainNavigationConstraints, PanDomainOptions, ZoomDomainOptions, } from "./lib/domain-navigation.js";
+export { SequentialColorScale, useSequentialColorScale, } from "./lib/sequential-color-scale.js";
+export { DivergingColorScale, useDivergingColorScale, } from "./lib/diverging-color-scale.js";
+export type { ColorScaleStop, SequentialColorScaleProps, DivergingColorScaleProps, ResolvedSequentialColorScale, ResolvedDivergingColorScale, } from "./lib/color-types.js";
+export { ThresholdColorScale, useThresholdColorScale, } from "./lib/threshold-color-scale.js";
+export type { ThresholdColorBand, ThresholdColorScaleProps, ResolvedThresholdColorScale, } from "./lib/threshold-color-scale.js";
+export { VolumeSeries } from "./lib/volume-series.js";
+export type { VolumeSeriesProps, VolumeSeriesStyle, } from "./lib/volume-series.js";
+export { TradingTimeScale, useTradingTimeScale, } from "./lib/trading-time-scale.js";
+export type { TradingTimeScaleProps, ResolvedTradingTimeScale, } from "./lib/trading-time-scale.js";
+export { CandlestickSeries } from "./lib/candlestick-series.js";
+export type { CandlestickSeriesProps, CandlestickSeriesStyle, CandleBodyStyle, CandleWickStyle, } from "./lib/candlestick-series.js";
+export { OhlcBarSeries } from "./lib/ohlc-bar-series.js";
+export type { OhlcBarSeriesProps, OhlcBarSeriesStyle, } from "./lib/ohlc-bar-series.js";
+export { BaselineSeries } from "./lib/baseline-series.js";
+export type { BaselineSeriesProps, BaselineSeriesStyle, BaselineSideStyle, } from "./lib/baseline-series.js";
+export { IntervalDiamondSeries } from "./lib/interval-diamond-series.js";
+export type { IntervalDiamondSeriesProps, IntervalDiamondSeriesStyle, } from "./lib/interval-diamond-series.js";
+export { CensoredPointSeries } from "./lib/censored-point-series.js";
+export type { CensoringStatus, CensoringAccessor, CensoredPointSeriesProps, CensoredPointSeriesStyle, } from "./lib/censored-point-series.js";
+export { WeightedPointSeries } from "./lib/weighted-point-series.js";
+export type { WeightedPointSeriesProps, WeightedPointSeriesStyle, WeightAccessor, } from "./lib/weighted-point-series.js";
+export { TrajectorySeries } from "./lib/trajectory-series.js";
+export type { TrajectorySeriesProps, TrajectorySeriesStyle, TrajectoryGroupAccessor, } from "./lib/trajectory-series.js";
+export { PairedSeries } from "./lib/paired-series.js";
+export type { PairedSeriesProps, PairedSeriesStyle, } from "./lib/paired-series.js";

package/dist/features/viz/index.js

@@ -1,7 +1,19 @@
-import { Scale } from "./lib/scale.js";
-import { useScale } from "./lib/use-scale.js";
+import { LinearScale } from "./lib/linear-scale-component.js";
+import { BarScale } from "./lib/bar-scale.js";
+import { UTCScale } from "./lib/utc-scale-component.js";
+import { useLinearScale } from "./lib/use-linear-scale.js";
+import { useBarScale } from "./lib/use-bar-scale.js";
+import { useUTCScale } from "./lib/use-utc-scale.js";
 import { Axis } from "./lib/axis.js";
 import { LineSeries } from "./lib/line-series.js";
+import { AreaSeries } from "./lib/area-series.js";
+import { IntervalBandSeries } from "./lib/interval-band-series.js";
+import {
+  HorizontalIntervalSeries,
+  VerticalIntervalSeries
+} from "./lib/interval-series.js";
+import { stepBefore, stepAfter, stepMidpoint } from "./lib/step-curves.js";
+import { monotoneX } from "./lib/monotone-curve.js";
 import { ScaleAdjust } from "./lib/scale-adjust.js";
 import { PointSeries } from "./lib/point-series.js";
 import { PlotSeries } from "./lib/plot-series.js";
@@ -18,28 +30,157 @@ 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";
+import { extent, niceUTCDomain } from "./lib/utc-scale.js";
+import {
+  linearTicks,
+  niceLinearDomain,
+  formatNumber
+} from "./lib/numeric-ticks.js";
+import { interpolateNumericRange } from "./lib/numeric-range-interpolation.js";
+import {
+  visibleOhlcPriceExtent,
+  padLinearDomain
+} from "./lib/financial-autoscale.js";
+import { percentageReturns, indexTo100 } from "./lib/financial-comparison.js";
+import { aggregateOhlcv, sessionVwap } from "./lib/financial-aggregation.js";
+import {
+  RangeNavigator,
+  EditableReferenceLine,
+  EditableReferenceBand,
+  EditableTrendLine
+} from "./lib/editable-chart-elements.js";
+import {
+  simpleMovingAverage,
+  exponentialMovingAverage,
+  bollingerBands
+} from "./lib/financial-indicators.js";
+import {
+  relativeStrengthIndex,
+  movingAverageConvergenceDivergence,
+  stochasticOscillator
+} from "./lib/financial-oscillators.js";
+import { utcTickLabels } from "./lib/utc-labels.js";
+import { LogScale } from "./lib/log-scale-component.js";
+import { useLogScale } from "./lib/use-log-scale.js";
+import { SymlogScale } from "./lib/symlog-scale-component.js";
+import { useSymlogScale } from "./lib/use-symlog-scale.js";
+import { PointScale } from "./lib/point-scale-component.js";
+import { usePointScale } from "./lib/use-point-scale.js";
+import { GridLines, ReferenceLine } from "./lib/chart-lines.js";
+import { ReferenceBand } from "./lib/reference-band.js";
+import { AxisTitle } from "./lib/axis-title.js";
+import { panDomain, zoomDomain } from "./lib/domain-navigation.js";
+import {
+  SequentialColorScale,
+  useSequentialColorScale
+} from "./lib/sequential-color-scale.js";
+import {
+  DivergingColorScale,
+  useDivergingColorScale
+} from "./lib/diverging-color-scale.js";
+import {
+  ThresholdColorScale,
+  useThresholdColorScale
+} from "./lib/threshold-color-scale.js";
+import { VolumeSeries } from "./lib/volume-series.js";
+import {
+  TradingTimeScale,
+  useTradingTimeScale
+} from "./lib/trading-time-scale.js";
+import { CandlestickSeries } from "./lib/candlestick-series.js";
+import { OhlcBarSeries } from "./lib/ohlc-bar-series.js";
+import { BaselineSeries } from "./lib/baseline-series.js";
+import { IntervalDiamondSeries } from "./lib/interval-diamond-series.js";
+import { CensoredPointSeries } from "./lib/censored-point-series.js";
+import { WeightedPointSeries } from "./lib/weighted-point-series.js";
+import { TrajectorySeries } from "./lib/trajectory-series.js";
+import { PairedSeries } from "./lib/paired-series.js";
 export {
   AnchoredLayout,
+  AreaSeries,
   Axis,
+  AxisTitle,
+  BarScale,
   BarSeries,
+  BaselineSeries,
+  CandlestickSeries,
+  CensoredPointSeries,
+  DivergingColorScale,
+  EditableReferenceBand,
+  EditableReferenceLine,
+  EditableTrendLine,
+  GridLines,
+  HorizontalIntervalSeries,
   HoverCard,
   HoverData,
+  IntervalBandSeries,
+  IntervalDiamondSeries,
   LineSeries,
+  LinearScale,
+  LogScale,
+  OhlcBarSeries,
+  PairedSeries,
   PieLabel,
   PieLayout,
   PieSlice,
   PlotSeries,
+  PointScale,
   PointSeries,
-  Scale,
+  RangeNavigator,
+  ReferenceBand,
+  ReferenceLine,
   ScaleAdjust,
+  SequentialColorScale,
+  SymlogScale,
+  ThresholdColorScale,
+  TradingTimeScale,
+  TrajectorySeries,
+  UTCScale,
+  VerticalIntervalSeries,
+  VolumeSeries,
+  WeightedPointSeries,
+  aggregateOhlcv,
+  bollingerBands,
   closestPoint,
   closestX,
   defineSeries,
+  exponentialMovingAverage,
+  extent,
+  formatNumber,
+  indexTo100,
+  interpolateNumericRange,
   interpolateX,
   linearInterpolation,
+  linearTicks,
+  monotoneX,
+  movingAverageConvergenceDivergence,
   nearestDomainValue,
   nearestPoint,
+  niceLinearDomain,
+  niceUTCDomain,
+  padLinearDomain,
+  panDomain,
+  percentageReturns,
   pieSlices,
-  useScale
+  relativeStrengthIndex,
+  sessionVwap,
+  simpleMovingAverage,
+  stepAfter,
+  stepBefore,
+  stepMidpoint,
+  stochasticOscillator,
+  useBarScale,
+  useDivergingColorScale,
+  useLinearScale,
+  useLogScale,
+  usePointScale,
+  useSequentialColorScale,
+  useSymlogScale,
+  useThresholdColorScale,
+  useTradingTimeScale,
+  useUTCScale,
+  utcTickLabels,
+  visibleOhlcPriceExtent,
+  zoomDomain
 };
 //# sourceMappingURL=index.js.map

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

@@ -1,7 +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;",
+  "sourcesContent": ["export { LinearScale } from \"./lib/linear-scale-component.js\";\nexport { BarScale } from \"./lib/bar-scale.js\";\nexport { UTCScale } from \"./lib/utc-scale-component.js\";\nexport { useLinearScale } from \"./lib/use-linear-scale.js\";\nexport { useBarScale } from \"./lib/use-bar-scale.js\";\nexport { useUTCScale } from \"./lib/use-utc-scale.js\";\nexport type {\n  ScaleId,\n  LinearDomain,\n  BandCategory,\n  BandDomain,\n  BarScaleProps,\n  BandScaleRange,\n  ResolvedBandScale,\n  ScaleRange,\n  ScaleLayoutStyle,\n  LinearScaleProps,\n  ResolvedLinearScale,\n  ResolvedScale,\n} from \"./lib/types.js\";\nexport { Axis } from \"./lib/axis.js\";\nexport { LineSeries } from \"./lib/line-series.js\";\nexport { AreaSeries } from \"./lib/area-series.js\";\nexport type { AreaSeriesProps, AreaSeriesStyle } from \"./lib/area-series.js\";\nexport { IntervalBandSeries } from \"./lib/interval-band-series.js\";\nexport type { IntervalBandSeriesProps } from \"./lib/interval-band-series.js\";\nexport {\n  HorizontalIntervalSeries,\n  VerticalIntervalSeries,\n} from \"./lib/interval-series.js\";\nexport type {\n  IntervalSeriesStyle,\n  IntervalSeriesProps,\n  HorizontalIntervalSeriesProps,\n  VerticalIntervalSeriesProps,\n} from \"./lib/interval-series.js\";\nexport type { SeriesCurve } from \"./lib/curve-definition.js\";\nexport { stepBefore, stepAfter, stepMidpoint } from \"./lib/step-curves.js\";\nexport { monotoneX } from \"./lib/monotone-curve.js\";\nexport { ScaleAdjust } from \"./lib/scale-adjust.js\";\nexport type {\n  AxisStyle,\n  AxisProps,\n  LineCoordinate,\n  LineAccessor,\n  SeriesAccessor,\n  SeriesCoordinate,\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 {\n  PieLayoutProps,\n  PieLayoutStyle,\n  PieLayoutSlice,\n  PieLabelPlacement,\n  PieLabelLayout,\n  PieSliceProps,\n  PieSliceStyle,\n  PieLabelProps,\n  PieLabelStyle,\n} from \"./lib/pie-types.js\";\n\nexport { extent, niceUTCDomain } from \"./lib/utc-scale.js\";\nexport type {\n  NumericDomain,\n  UtcDomain,\n  UTCScaleProps,\n  ResolvedUtcScale,\n  ResolvedContinuousScale,\n} from \"./lib/types.js\";\n\nexport {\n  linearTicks,\n  niceLinearDomain,\n  formatNumber,\n} from \"./lib/numeric-ticks.js\";\nexport type {\n  LinearTickOptions,\n  NumberFormatOptions,\n} from \"./lib/numeric-ticks.js\";\nexport { interpolateNumericRange } from \"./lib/numeric-range-interpolation.js\";\nexport {\n  visibleOhlcPriceExtent,\n  padLinearDomain,\n} from \"./lib/financial-autoscale.js\";\nexport type {\n  VisibleOhlcPriceExtentOptions,\n  PadLinearDomainOptions,\n} from \"./lib/financial-autoscale.js\";\nexport { percentageReturns, indexTo100 } from \"./lib/financial-comparison.js\";\nexport type {\n  ComparisonBaseOptions,\n  PercentageReturnPoint,\n  IndexedValuePoint,\n} from \"./lib/financial-comparison.js\";\nexport { aggregateOhlcv, sessionVwap } from \"./lib/financial-aggregation.js\";\nexport type {\n  OhlcvBucket,\n  OhlcvSource,\n  AggregatedOhlcvPoint,\n  AggregateOhlcvOptions,\n  SessionIdentifier,\n  SessionAccessor,\n  SessionVwapOptions,\n  SessionVwapPoint,\n} from \"./lib/financial-aggregation.js\";\nexport {\n  RangeNavigator,\n  EditableReferenceLine,\n  EditableReferenceBand,\n  EditableTrendLine,\n} from \"./lib/editable-chart-elements.js\";\nexport type {\n  ChartAnchor,\n  RangeNavigatorProps,\n  RangeNavigatorStyle,\n  EditableReferenceLineProps,\n  EditableReferenceLineStyle,\n  EditableReferenceBandProps,\n  EditableReferenceBandStyle,\n  EditableTrendLineProps,\n  EditableTrendLineStyle,\n} from \"./lib/editable-chart-elements.js\";\nexport {\n  simpleMovingAverage,\n  exponentialMovingAverage,\n  bollingerBands,\n} from \"./lib/financial-indicators.js\";\nexport type {\n  MovingAverageOptions,\n  BollingerBandsOptions,\n  MovingAveragePoint,\n  BollingerBandPoint,\n} from \"./lib/financial-indicators.js\";\nexport {\n  relativeStrengthIndex,\n  movingAverageConvergenceDivergence,\n  stochasticOscillator,\n} from \"./lib/financial-oscillators.js\";\nexport type {\n  OscillatorOptions,\n  RelativeStrengthIndexOptions,\n  MovingAverageConvergenceDivergenceOptions,\n  StochasticOscillatorOptions,\n  RelativeStrengthIndexPoint,\n  MovingAverageConvergenceDivergencePoint,\n  StochasticOscillatorPoint,\n} from \"./lib/financial-oscillators.js\";\n\nexport { utcTickLabels } from \"./lib/utc-labels.js\";\nexport type { UTCTickLabelOptions } from \"./lib/utc-labels.js\";\n\nexport { LogScale } from \"./lib/log-scale-component.js\";\nexport { useLogScale } from \"./lib/use-log-scale.js\";\nexport type { LogScaleProps, ResolvedLogScale } from \"./lib/types.js\";\n\nexport { SymlogScale } from \"./lib/symlog-scale-component.js\";\nexport { useSymlogScale } from \"./lib/use-symlog-scale.js\";\nexport type { SymlogScaleProps, ResolvedSymlogScale } from \"./lib/types.js\";\n\nexport { PointScale } from \"./lib/point-scale-component.js\";\nexport { usePointScale } from \"./lib/use-point-scale.js\";\nexport type { PointScaleProps, ResolvedPointScale } from \"./lib/types.js\";\nexport { GridLines, ReferenceLine } from \"./lib/chart-lines.js\";\nexport type {\n  ChartLineProps,\n  GridLinesProps,\n  ReferenceLineProps,\n} from \"./lib/chart-lines.js\";\nexport { ReferenceBand } from \"./lib/reference-band.js\";\nexport type { ReferenceBandProps } from \"./lib/reference-band.js\";\nexport { AxisTitle } from \"./lib/axis-title.js\";\nexport type { AxisTitleProps } from \"./lib/axis-title.js\";\n\nexport { panDomain, zoomDomain } from \"./lib/domain-navigation.js\";\nexport type {\n  DomainNavigationConstraints,\n  PanDomainOptions,\n  ZoomDomainOptions,\n} from \"./lib/domain-navigation.js\";\n\nexport {\n  SequentialColorScale,\n  useSequentialColorScale,\n} from \"./lib/sequential-color-scale.js\";\nexport {\n  DivergingColorScale,\n  useDivergingColorScale,\n} from \"./lib/diverging-color-scale.js\";\nexport type {\n  ColorScaleStop,\n  SequentialColorScaleProps,\n  DivergingColorScaleProps,\n  ResolvedSequentialColorScale,\n  ResolvedDivergingColorScale,\n} from \"./lib/color-types.js\";\n\nexport {\n  ThresholdColorScale,\n  useThresholdColorScale,\n} from \"./lib/threshold-color-scale.js\";\nexport type {\n  ThresholdColorBand,\n  ThresholdColorScaleProps,\n  ResolvedThresholdColorScale,\n} from \"./lib/threshold-color-scale.js\";\n\nexport { VolumeSeries } from \"./lib/volume-series.js\";\nexport type {\n  VolumeSeriesProps,\n  VolumeSeriesStyle,\n} from \"./lib/volume-series.js\";\n\nexport {\n  TradingTimeScale,\n  useTradingTimeScale,\n} from \"./lib/trading-time-scale.js\";\nexport type {\n  TradingTimeScaleProps,\n  ResolvedTradingTimeScale,\n} from \"./lib/trading-time-scale.js\";\nexport { CandlestickSeries } from \"./lib/candlestick-series.js\";\nexport type {\n  CandlestickSeriesProps,\n  CandlestickSeriesStyle,\n  CandleBodyStyle,\n  CandleWickStyle,\n} from \"./lib/candlestick-series.js\";\nexport { OhlcBarSeries } from \"./lib/ohlc-bar-series.js\";\nexport type {\n  OhlcBarSeriesProps,\n  OhlcBarSeriesStyle,\n} from \"./lib/ohlc-bar-series.js\";\n\nexport { BaselineSeries } from \"./lib/baseline-series.js\";\nexport type {\n  BaselineSeriesProps,\n  BaselineSeriesStyle,\n  BaselineSideStyle,\n} from \"./lib/baseline-series.js\";\nexport { IntervalDiamondSeries } from \"./lib/interval-diamond-series.js\";\nexport type {\n  IntervalDiamondSeriesProps,\n  IntervalDiamondSeriesStyle,\n} from \"./lib/interval-diamond-series.js\";\nexport { CensoredPointSeries } from \"./lib/censored-point-series.js\";\nexport type {\n  CensoringStatus,\n  CensoringAccessor,\n  CensoredPointSeriesProps,\n  CensoredPointSeriesStyle,\n} from \"./lib/censored-point-series.js\";\nexport { WeightedPointSeries } from \"./lib/weighted-point-series.js\";\nexport type {\n  WeightedPointSeriesProps,\n  WeightedPointSeriesStyle,\n  WeightAccessor,\n} from \"./lib/weighted-point-series.js\";\nexport { TrajectorySeries } from \"./lib/trajectory-series.js\";\nexport type {\n  TrajectorySeriesProps,\n  TrajectorySeriesStyle,\n  TrajectoryGroupAccessor,\n} from \"./lib/trajectory-series.js\";\nexport { PairedSeries } from \"./lib/paired-series.js\";\nexport type {\n  PairedSeriesProps,\n  PairedSeriesStyle,\n} from \"./lib/paired-series.js\";\n"],
+  "mappings": "AAAA,SAAS,mBAAmB;AAC5B,SAAS,gBAAgB;AACzB,SAAS,gBAAgB;AACzB,SAAS,sBAAsB;AAC/B,SAAS,mBAAmB;AAC5B,SAAS,mBAAmB;AAe5B,SAAS,YAAY;AACrB,SAAS,kBAAkB;AAC3B,SAAS,kBAAkB;AAE3B,SAAS,0BAA0B;AAEnC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAQP,SAAS,YAAY,WAAW,oBAAoB;AACpD,SAAS,iBAAiB;AAC1B,SAAS,mBAAmB;AAa5B,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;AAa9C,SAAS,QAAQ,qBAAqB;AAStC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAKP,SAAS,+BAA+B;AACxC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAKP,SAAS,mBAAmB,kBAAkB;AAM9C,SAAS,gBAAgB,mBAAmB;AAW5C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAYP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAOP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAWP,SAAS,qBAAqB;AAG9B,SAAS,gBAAgB;AACzB,SAAS,mBAAmB;AAG5B,SAAS,mBAAmB;AAC5B,SAAS,sBAAsB;AAG/B,SAAS,kBAAkB;AAC3B,SAAS,qBAAqB;AAE9B,SAAS,WAAW,qBAAqB;AAMzC,SAAS,qBAAqB;AAE9B,SAAS,iBAAiB;AAG1B,SAAS,WAAW,kBAAkB;AAOtC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AASP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAOP,SAAS,oBAAoB;AAM7B;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAKP,SAAS,yBAAyB;AAOlC,SAAS,qBAAqB;AAM9B,SAAS,sBAAsB;AAM/B,SAAS,6BAA6B;AAKtC,SAAS,2BAA2B;AAOpC,SAAS,2BAA2B;AAMpC,SAAS,wBAAwB;AAMjC,SAAS,oBAAoB;",
   "names": []
 }

package/dist/features/viz/inspection/bar.d.ts

@@ -0,0 +1,79 @@
+import type { LayoutBox } from "@pibbl/core";
+import type { BarSeriesProps } from "../lib/bar-series.js";
+import type { BandCategory } from "../lib/types.js";
+import type { RenderedSeriesPoint } from "./query-types.js";
+/** Original range/value/grouped bar with its captured endpoints and local paint bounds.
+ * @see {@link BarRenderedSeries}
+ */
+export interface PaintedBarHit<D> {
+    /** Caller-owned original record. */
+    readonly datum: D;
+    /** Original zero-based source position. */
+    readonly sourceIndex: number;
+    /** Original discrete category, without numeric coercion. */
+    readonly category: BandCategory;
+    /** Original subgroup when grouping is enabled. */
+    readonly group: BandCategory | undefined;
+    /** Data-space starting endpoint, including an ordinary bar's baseline. */
+    readonly valueStart: number;
+    /** Data-space ending endpoint. */
+    readonly valueEnd: number;
+    /** Logical rectangle bounds before world transforms. */
+    readonly boundsLocal: Readonly<LayoutBox>;
+}
+/** @internal Captured rectangle paint flags used only for geometric lookup. */
+export interface CapturedBarMark<D> extends PaintedBarHit<D> {
+    /** Whether this rectangle paints its interior. */
+    readonly fill: boolean;
+    /** Painted stroke width in local logical units. */
+    readonly strokeWidthLocal: number;
+}
+/** A borrowed committed categorical bar generation; contains no numeric category mapping.
+ * @see {@link PaintedBarHit}
+ */
+export interface BarRenderedSeries<D> {
+    /** Original records and geometry in source paint order. */
+    readonly marks: readonly CapturedBarMark<D>[];
+    /** Throws after replacement or disposal. */
+    assertLive(): void;
+    /** Converts root logical units into this generation's local geometry.
+     * @param point - Root-logical Canvas point.
+     * @returns Local point or undefined for a singular transform.
+     */
+    localAtRoot(point: Readonly<RenderedSeriesPoint>): Readonly<RenderedSeriesPoint> | undefined;
+    /** Tests a local point against every committed clip/layer bound.
+     * @param point - Local-logical Canvas point.
+     * @returns Whether the point is inside every clip and layer bound.
+     */
+    anchorInsideClips(point: Readonly<RenderedSeriesPoint>): boolean;
+}
+/** Mount-owned optional categorical-bar capture.
+ * @see {@link BarRenderedSeries}
+ */
+export interface BarInspectionRef<D> {
+    /** Returns the last successful generation.
+     * @returns Borrowed bar geometry or undefined before paint/after disposal.
+     */
+    rendered(): BarRenderedSeries<D> | undefined;
+    /** @internal Records candidate values and paint geometry without executing a search.
+     * @param input - Source-ordered captured rectangle marks.
+     */
+    capture(input: readonly CapturedBarMark<D>[]): void;
+}
+/**
+ * Owns opt-in capture for ordinary, range or grouped categorical bars.
+ * @param _inputs - Bar inputs used for datum inference; no data is read or subscribed here.
+ * @returns A stable ref to pass to one BarSeries inspection prop; captured endpoints share one fixed contract.
+ * @see {@link BarInspectionRef}
+ */
+export declare function useBarInspection<D>(_inputs: Pick<BarSeriesProps<D>, "data" | "category">): BarInspectionRef<D>;
+/**
+ * Finds the last-painted bar covering a root-logical point in this explicit series.
+ * @param rendered - Borrowed committed categorical bar values and rectangle geometry.
+ * @param options - Root-logical query point; respects every clip, fill/stroke and source order.
+ * @returns Original record, category/group, endpoints and local bounds, or undefined for gaps and singular transforms.
+ * @see {@link PaintedBarHit}
+ */
+export declare function paintedBarAt<D>(rendered: BarRenderedSeries<D>, options: {
+    rootPoint: Readonly<RenderedSeriesPoint>;
+}): PaintedBarHit<D> | undefined;