@opendata-ai/openchart-vanilla 8.4.0 → 8.5.0

package/dist/renderer-registry-B5tW6yAZ.d.ts

@@ -0,0 +1,376 @@
+import { AnimationEase, GraphSpec, ThemeConfig, DarkMode, TooltipContent } from '@opendata-ai/openchart-core';
+import { GraphCompilation } from '@opendata-ai/openchart-engine';
+import { Placement } from '@floating-ui/dom';
+
+/**
+ * Shared types for the graph adapter.
+ *
+ * These extend the engine's compiled types with positional information set by
+ * the force simulation at runtime. The engine produces CompiledGraphNode/Edge
+ * objects with visual properties but no x/y coords. After simulation, we get
+ * PositionedNode/Edge that the canvas renderer can draw.
+ */
+
+/**
+ * A programmatic highlight target. Resolved once at call time into a node id set
+ * and rendered through the focus model (eased crossfade). See
+ * `GraphInstance.highlight`.
+ *
+ * Lives here rather than in `graph-mount` so `graph/highlight.ts`, which both
+ * the 2D and 3D mounts consume, does not have to import upward from the layer
+ * that consumes it.
+ */
+type GraphHighlightTarget = {
+    nodeIds: string[];
+} | {
+    category: {
+        field: string;
+        value: string | string[];
+    };
+} | {
+    neighborsOf: string;
+    includeSelf?: boolean;
+};
+/**
+ * The camera payload both renderers report through `getCamera()` and
+ * `onCameraChange`.
+ *
+ * `x`/`y`/`k` are always present. In 2D they are the d3 zoom transform: `x`/`y`
+ * are the translate in pixels, `k` the zoom scalar. In 3D they describe a pose
+ * instead: `x`/`y` are the look-at point in world units and `k` is
+ * `FIT_DISTANCE / cameraDistance`, so the sign convention still matches.
+ *
+ * `position` and `target` are present ONLY in 3D, which is why they are
+ * optional here. Persisted camera state has to be keyed on the dimension it
+ * came from before it is restored.
+ */
+interface GraphCamera {
+    x: number;
+    y: number;
+    k: number;
+    /** 3D only: the camera's world-space position. */
+    position?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** 3D only: the world-space point the camera looks at. */
+    target?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+/**
+ * A `flyTo` destination: a `GraphCamera` with an optional `k` (omit it to keep
+ * the current zoom/distance). The 3D pose fields are accepted here so a
+ * `getCamera()` result round-trips unchanged; the 2D renderer ignores them.
+ */
+interface GraphFlyTarget extends Omit<GraphCamera, 'k'> {
+    k?: number;
+}
+
+/**
+ * Animated camera for the graph.
+ *
+ * Flights interpolate between two `ZoomTransform`s along d3's geodesic
+ * `interpolateZoom` path (smooth zoom-and-pan that pulls back to see both
+ * endpoints before diving in). A flight is a {@link GraphAnimation}, driven by
+ * the mount's AnimationScheduler.
+ *
+ * `interpolateZoom` operates on a `[cx, cy, width]` "view" — the graph-space
+ * center and the graph-space width visible across the viewport. We convert the
+ * ZoomTransform ⇄ view around a fixed viewport size.
+ */
+
+/** Options controlling a camera flight. */
+interface CameraFlightOptions {
+    /** Duration in ms, or `'auto'` to derive from the zoom distance. */
+    duration?: number | 'auto';
+    /** Easing preset. Default `'smooth'`. */
+    ease?: AnimationEase;
+}
+
+/**
+ * Graph mount API: the main entry point for vanilla JS graph usage.
+ *
+ * createGraph() takes a container, GraphSpec, and options, compiles the graph,
+ * creates a force simulation, canvas renderer, spatial index, interaction
+ * manager, and search manager, then runs an animation loop driven by
+ * simulation ticks. Returns a GraphInstance with update/search/zoom/destroy.
+ */
+
+/** A hovered node or edge, passed to a tooltip formatter. */
+interface GraphTooltipItem {
+    kind: 'node' | 'edge';
+    /** The raw datum (node record, or edge record with source/target). */
+    data: Record<string, unknown>;
+}
+/**
+ * Custom tooltip content builder. Receives the hovered item and the library's
+ * default {@link TooltipContent}, returns replacement content.
+ *
+ * Safety contract:
+ * - A returned `TooltipContent` or `string` is escaped by the library (strings
+ *   are inserted via `textContent`, never `innerHTML`).
+ * - A returned `HTMLElement` is trusted verbatim — the host owns sanitization.
+ * - `null` suppresses the tooltip for that item.
+ */
+type GraphTooltipFormatter = (item: GraphTooltipItem, defaults: TooltipContent) => TooltipContent | string | HTMLElement | null;
+/** Built-in legend data (headless mirror of the rendered legend). */
+interface GraphLegendData {
+    field: string | null;
+    nodes: Array<{
+        label: string;
+        color: string;
+        count?: number;
+        active: boolean;
+    }>;
+    edges: Array<{
+        label: string;
+        color: string;
+        count?: number;
+    }>;
+}
+interface GraphMountOptions {
+    theme?: ThemeConfig;
+    darkMode?: DarkMode;
+    /**
+     * Sink for advisory spec warnings from the compiler (unknown `seedNode` id,
+     * deprecations, and so on). Defaults to `console.warn`. Each distinct message
+     * is emitted at most once per instance, so a warning that survives every
+     * recompile doesn't spam the console on `update()`.
+     */
+    onWarn?: (message: string) => void;
+    responsive?: boolean;
+    /** Show the OpenData watermark. Defaults to true. */
+    watermark?: boolean;
+    /** Show the built-in tooltip; pass an object for a custom formatter. Defaults to true. */
+    tooltip?: boolean | {
+        formatter?: GraphTooltipFormatter;
+    };
+    /**
+     * Built-in legend. `true` (default) renders an interactive legend with counts.
+     * `false` renders none (set this if you render your own legend). An object
+     * toggles interactivity/counts.
+     */
+    legend?: boolean | {
+        interactive?: boolean;
+        counts?: boolean;
+    };
+    onNodeClick?: (node: Record<string, unknown>) => void;
+    onNodeDoubleClick?: (node: Record<string, unknown>) => void;
+    onNodeHover?: (node: Record<string, unknown> | null) => void;
+    onEdgeHover?: (edge: Record<string, unknown> | null) => void;
+    onSelectionChange?: (nodeIds: string[]) => void;
+    /** Fired when the user hovers a legend entry (null on leave). */
+    onLegendHover?: (entry: {
+        field: string;
+        value: string;
+    } | null) => void;
+    /** Fired when legend toggle state changes; `activeValues` is the active category set (empty = all). */
+    onLegendToggle?: (activeValues: string[]) => void;
+    /** Fired whenever the highlight set changes (programmatic or legend), null when cleared. */
+    onHighlightChange?: (nodeIds: string[] | null) => void;
+    /**
+     * Fit the graph to the viewport on the first tick. Default true. Set false to
+     * restore a saved camera (e.g. getCamera() + flyTo) without the initial fit.
+     */
+    fitOnLoad?: boolean;
+    /** Camera change callback, rAF-coalesced (fires at most once per rendered frame). */
+    onCameraChange?: (camera: GraphCamera) => void;
+    /** Skip the entrance reveal/flight on mount (spec unchanged; used by wrappers when recreating for a theme/darkMode-only change so the entrance doesn't replay). Warmup still runs. */
+    suppressEntrance?: boolean;
+}
+interface GraphInstance {
+    update(spec: GraphSpec): void;
+    /** Re-compile encoding/legend/chrome without restarting the simulation. Preserves node positions. */
+    updateVisuals(spec: GraphSpec): void;
+    search(query: string): void;
+    clearSearch(): void;
+    /** Fit all nodes into the viewport. Animated by default; `{ duration: 0 }` snaps. */
+    zoomToFit(opts?: CameraFlightOptions & {
+        padding?: number;
+    }): void;
+    /** Fly to a node and zoom in (default scale 2). Tracks the node while it settles. */
+    zoomToNode(nodeId: string, opts?: CameraFlightOptions & {
+        scale?: number;
+    }): void;
+    /** Fly the camera to a graph-space target. */
+    flyTo(target: GraphFlyTarget, opts?: CameraFlightOptions): void;
+    /** Center the camera on a graph-space point (keeps current zoom). */
+    centerAt(x: number, y: number, opts?: CameraFlightOptions): void;
+    /**
+     * Current camera. In 2D this is the zoom transform; in 3D the same `x`/`y`/`k`
+     * summary plus the `position`/`target` pose. See `GraphCamera`.
+     */
+    getCamera(): GraphCamera;
+    /** Select a node; `{ fly: true }` also flies to it (default follows interaction.select.flyTo). */
+    selectNode(nodeId: string, opts?: {
+        fly?: boolean;
+    } & CameraFlightOptions): void;
+    getSelectedNodes(): string[];
+    /** Node ids currently matching the active search query. */
+    getSearchMatches(): string[];
+    /**
+     * Emphasize a set of nodes; eased via the focus model. Layers over the
+     * standing category filter (`setActiveCategories`) rather than replacing it:
+     * the effective set is the intersection, or the highlight alone when the two
+     * are disjoint. Legend toggle state is untouched.
+     */
+    highlight(target: GraphHighlightTarget, opts?: {
+        dimOpacity?: number;
+    }): void;
+    /**
+     * Clear the transient highlight, returning to the standing category filter.
+     * Does NOT clear the filter — use `setActiveCategories([])` for that.
+     */
+    clearHighlight(): void;
+    /** The effective highlighted node ids, or null when nothing is highlighted. */
+    getHighlight(): string[] | null;
+    /** Headless snapshot of the legend (node categories + edge categories). */
+    getLegend(): GraphLegendData;
+    /** Set the active category filter declaratively (replaces legend toggle state). */
+    setActiveCategories(values: string[]): void;
+    /** Current active category values (empty = all active, no filter). */
+    getActiveCategories(): string[];
+    resize(): void;
+    destroy(): void;
+}
+/**
+ * Create a graph instance from a spec and mount it into a container.
+ *
+ * @param container - The DOM element to render into.
+ * @param spec - The graph spec.
+ * @param options - Mount options.
+ * @returns A GraphInstance with update/search/zoom/destroy methods.
+ */
+declare function createGraph(container: HTMLElement, spec: GraphSpec, options?: GraphMountOptions): GraphInstance;
+
+/**
+ * Tooltip manager: creates and positions a floating tooltip element.
+ *
+ * Shows tooltip content near the mouse/touch position with viewport
+ * edge avoidance via @floating-ui/dom. Touch support via tap-to-show,
+ * tap-outside-to-hide.
+ */
+
+interface TooltipShowOptions {
+    /**
+     * Floating-ui placement. Defaults to 'bottom-start' for mark hover
+     * (the legacy behavior). Line/area snap-tooltips pass 'right-start'
+     * so the card sits beside the snapped point and flips to 'left-start'
+     * via the flip middleware when crowding the right edge.
+     */
+    placement?: Placement;
+}
+/**
+ * Content accepted by {@link TooltipManager.show}. A structured
+ * {@link TooltipContent} is rendered by the manager; `{ text }` is inserted as
+ * plain text (escaped via textContent); `{ element }` is a caller-owned node
+ * trusted verbatim (the host owns sanitization).
+ */
+type TooltipInput = TooltipContent | {
+    text: string;
+} | {
+    element: HTMLElement;
+};
+interface TooltipManager {
+    /** Show the tooltip with content at a given position. */
+    show(content: TooltipInput, x: number, y: number, opts?: TooltipShowOptions): void;
+    /**
+     * Re-anchor the open tooltip without re-rendering its content.
+     *
+     * The 3D graph re-anchors on every engine tick and every camera change, and
+     * `show()` would re-run the host formatter and rewrite the DOM at frame rate
+     * for content that has not changed.
+     */
+    move(x: number, y: number, opts?: TooltipShowOptions): void;
+    /** Hide the tooltip. */
+    hide(): void;
+    /** Remove the tooltip element and clean up event listeners. */
+    destroy(): void;
+}
+/**
+ * Create a tooltip manager attached to a container element.
+ *
+ * The manager creates a floating div positioned relative to the container.
+ * Content is rendered as a title line with optional color indicator,
+ * followed by a compact list of field-value pairs.
+ *
+ * @param container - The parent element for the tooltip.
+ * @returns TooltipManager with show/hide/destroy methods.
+ */
+declare function createTooltipManager(container: HTMLElement): TooltipManager;
+
+/**
+ * Graph renderer registry.
+ *
+ * `createGraph()` builds the shared shell (wrapper, chrome, legend element,
+ * tooltip manager, resize wiring) and then hands off to a renderer. The 2D
+ * Canvas renderer is built in. The 3D WebGL renderer lives on the
+ * `@opendata-ai/openchart-vanilla/graph-3d` subpath and registers itself here
+ * as a side effect of being imported, so three.js never enters the default
+ * bundle. `createGraph()` never dynamically imports a renderer: mount is
+ * synchronous because every framework wrapper assumes it is.
+ */
+
+/**
+ * Everything a renderer needs from the shared mount shell. The shell owns the
+ * DOM wrapper and its chrome/legend/tooltip children; the renderer owns the
+ * surface it mounts between the chrome and the legend (a `<canvas>` for 2D,
+ * the 3d-force-graph scene container for 3D) plus all simulation, camera and
+ * interaction state.
+ */
+interface GraphShell {
+    /** The consumer's container element. */
+    container: HTMLElement;
+    /** `.oc-graph-wrapper` (carries `oc-dark` and the theme custom properties). */
+    wrapper: HTMLElement;
+    /** `.oc-graph-chrome` (title/subtitle HTML). */
+    chromeEl: HTMLElement;
+    /** `.oc-graph-legend`, or null when `options.legend === false`. */
+    legendEl: HTMLElement | null;
+    /** Shared DOM tooltip manager, or null when `options.tooltip === false`. */
+    tooltipManager: TooltipManager | null;
+    /** Resolved dark-mode flag used when the wrapper was built. */
+    isDark: boolean;
+    /**
+     * Insert the renderer's surface element into the wrapper between the chrome
+     * and the legend. Call exactly once.
+     */
+    mountSurface(el: HTMLElement): void;
+    /** Re-render chrome HTML from the current compilation (after `update()`). */
+    renderChrome(compilation: GraphCompilation): void;
+    /** Re-measure the chrome and update the inset custom property. */
+    syncChromeInset(): void;
+    /** Current container size (width/height in CSS px, height floored at 200). */
+    getSize(): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Subscribe to container resizes. Honours `options.responsive === false`
+     * (returns a no-op disconnect). The ResizeObserver fires once on first
+     * layout, so renderers must tolerate an immediate callback.
+     */
+    observeResize(callback: () => void): () => void;
+    /** Warn-once sink (`options.onWarn`, default `console.warn`). */
+    warn(message: string): void;
+    /** Remove the wrapper from the container and release the tooltip manager. */
+    destroy(): void;
+}
+interface GraphRendererContext {
+    shell: GraphShell;
+    spec: GraphSpec;
+    compilation: GraphCompilation;
+    options: GraphMountOptions | undefined;
+    /** Recompile a spec with the mount's compile options (theme, darkMode, onWarn). */
+    compile(spec: GraphSpec): GraphCompilation;
+}
+type GraphRendererFactory = (ctx: GraphRendererContext) => GraphInstance;
+/** Register a renderer for a dimension count. Later registrations replace earlier ones. */
+declare function registerGraphRenderer(dimensions: 3, factory: GraphRendererFactory): void;
+declare const GRAPH_3D_NOT_REGISTERED_ERROR = "createGraph: dimensions: 3 requires import \"@opendata-ai/openchart-vanilla/graph-3d\"";
+
+export { type CameraFlightOptions as C, GRAPH_3D_NOT_REGISTERED_ERROR as G, type TooltipManager as T, type GraphCamera as a, type GraphFlyTarget as b, type GraphHighlightTarget as c, type GraphInstance as d, type GraphLegendData as e, type GraphMountOptions as f, type GraphRendererContext as g, type GraphRendererFactory as h, type GraphShell as i, type GraphTooltipFormatter as j, type GraphTooltipItem as k, createGraph as l, createTooltipManager as m, registerGraphRenderer as r };

package/dist/static.js

@@ -1,14 +1,15 @@
 import {
   renderTileMapSVG
-} from "./chunk-LNPRDSK3.js";
+} from "./chunk-UAK6HWOC.js";
 import {
   renderChartSVG,
   resetSvgIdCounter
-} from "./chunk-YGYMB7KB.js";
+} from "./chunk-XGII4ZRT.js";
 import {
   SVG_NS,
   buildThemeStyleBlock
-} from "./chunk-HGRNXLDF.js";
+} from "./chunk-5RX6ZQGZ.js";
+import "./chunk-NG7CVCI2.js";
 
 // src/static.ts
 import { createRequire } from "module";

package/dist/static.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/static.ts"],"sourcesContent":["// Node.js only — do not import from browser code.\nimport { createRequire } from 'node:module';\nimport type {\n  ChartLayout,\n  ChartSpec,\n  CompileOptions,\n  DarkMode,\n  LayerSpec,\n  ResolvedTheme,\n  ThemeConfig,\n  TileMapSpec,\n} from '@opendata-ai/openchart-core';\nimport { isLayerSpec, isTileMapSpec } from '@opendata-ai/openchart-core';\nimport { compileChart, compileLayer, compileTileMap } from '@opendata-ai/openchart-engine';\nimport { SVG_NS } from './renderers/svg-dom';\nimport { resetSvgIdCounter } from './svg-ids';\nimport { renderChartSVG } from './svg-renderer';\nimport { buildThemeStyleBlock } from './theme-style-block';\nimport { renderTileMapSVG } from './tilemap-renderer';\n\nconst esmRequire = createRequire(import.meta.url);\n\nlet cachedWindow: typeof import('happy-dom').Window | undefined;\nfunction getHappyDomWindow(): typeof import('happy-dom').Window {\n  if (cachedWindow) return cachedWindow;\n  try {\n    ({ Window: cachedWindow } = esmRequire('happy-dom') as typeof import('happy-dom'));\n  } catch {\n    throw new Error(\n      \"renderStaticSVG requires 'happy-dom' as a peer dependency. Install it with: npm add happy-dom\",\n    );\n  }\n  return cachedWindow;\n}\n\nlet rendering = false;\n\nexport interface StaticRenderOptions {\n  width?: number;\n  height?: number;\n  theme?: ThemeConfig;\n  /**\n   * Dark mode setting. In static rendering `'auto'` resolves to light mode\n   * since there is no `matchMedia` to query. Use `'force'` for dark output.\n   */\n  darkMode?: DarkMode;\n  /** Rendering backend for point marks; see `MountOptions.renderer`. */\n  renderer?: 'auto' | 'svg' | 'canvas';\n  watermark?: boolean;\n}\n\nfunction resolveStaticDarkMode(mode?: DarkMode): boolean {\n  if (mode === 'force') return true;\n  return false;\n}\n\nfunction stripInteractiveElements(svg: Element): void {\n  const selectors = ['[data-voronoi-overlay]', '[data-crosshair]', '[data-snap-dots]'];\n  for (const selector of selectors) {\n    const els = svg.querySelectorAll(selector);\n    for (const el of els) {\n      el.parentNode?.removeChild(el);\n    }\n  }\n}\n\n/**\n * Render a chart spec to a standalone SVG string without a browser DOM.\n *\n * Requires `happy-dom` as a peer dependency (`bun add happy-dom`).\n *\n * Not safe for concurrent invocation: the render pipeline relies on a global\n * SVG ID counter and a temporary global `document` swap, both of which are\n * single-threaded. In a server handling parallel requests, serialize calls\n * through a queue or mutex.\n *\n * The entire render pipeline is synchronous; the global swap is safe as long\n * as no code schedules microtasks that outlive the call.\n */\nexport function renderStaticSVG(\n  spec: ChartSpec | LayerSpec | TileMapSpec,\n  options?: StaticRenderOptions,\n): string {\n  if (rendering) {\n    throw new Error('renderStaticSVG is not reentrant — serialize calls through a queue or mutex');\n  }\n  rendering = true;\n\n  const Window = getHappyDomWindow();\n  const win = new Window({ url: 'about:blank' });\n\n  const prevDocument = globalThis.document;\n  const prevWindow = (globalThis as Record<string, unknown>).window;\n\n  try {\n    (globalThis as Record<string, unknown>).document = win.document;\n    (globalThis as Record<string, unknown>).window = win;\n\n    resetSvgIdCounter();\n\n    const width = options?.width ?? 640;\n    const height = options?.height ?? 420;\n    const darkMode = resolveStaticDarkMode(options?.darkMode);\n\n    const compileOpts: CompileOptions = {\n      width,\n      height,\n      theme: options?.theme,\n      darkMode,\n      renderer: options?.renderer,\n      watermark: options?.watermark,\n    };\n\n    let svg: SVGElement;\n    let themeForStyle: ResolvedTheme;\n\n    if (isTileMapSpec(spec)) {\n      const tileMapLayout = compileTileMap(spec, compileOpts);\n      svg = renderTileMapSVG(tileMapLayout, { animate: false });\n      themeForStyle = tileMapLayout.theme;\n    } else {\n      let layout: ChartLayout;\n      if (isLayerSpec(spec)) {\n        layout = compileLayer(spec, compileOpts);\n      } else {\n        layout = compileChart(spec, compileOpts);\n      }\n\n      const container = win.document.createElement('div');\n      Object.defineProperty(container, 'getBoundingClientRect', {\n        value: () => ({\n          width,\n          height,\n          top: 0,\n          left: 0,\n          right: width,\n          bottom: height,\n          x: 0,\n          y: 0,\n          toJSON: () => ({}),\n        }),\n      });\n\n      svg = renderChartSVG(layout, container as unknown as HTMLElement, {\n        animate: false,\n        crosshair: false,\n      });\n\n      stripInteractiveElements(svg);\n      themeForStyle = layout.theme;\n    }\n\n    const doc = win.document as unknown as Document;\n    let defs = svg.querySelector('defs');\n    if (!defs) {\n      defs = doc.createElementNS(SVG_NS, 'defs');\n      svg.insertBefore(defs as unknown as Node, svg.firstChild);\n    }\n    const styleEl = doc.createElementNS(SVG_NS, 'style');\n    styleEl.textContent = buildThemeStyleBlock(themeForStyle);\n    defs.insertBefore(styleEl as unknown as Node, defs.firstChild);\n\n    const serializer = new (\n      win as unknown as { XMLSerializer: typeof XMLSerializer }\n    ).XMLSerializer();\n    return serializer.serializeToString(svg as unknown as Node);\n  } finally {\n    rendering = false;\n    if (prevDocument !== undefined) {\n      (globalThis as Record<string, unknown>).document = prevDocument;\n    } else {\n      delete (globalThis as Record<string, unknown>).document;\n    }\n    if (prevWindow !== undefined) {\n      (globalThis as Record<string, unknown>).window = prevWindow;\n    } else {\n      delete (globalThis as Record<string, unknown>).window;\n    }\n    win.close();\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/static.ts"],"sourcesContent":["// Node.js only — do not import from browser code.\nimport { createRequire } from 'node:module';\nimport type {\n  ChartLayout,\n  ChartSpec,\n  CompileOptions,\n  DarkMode,\n  LayerSpec,\n  ResolvedTheme,\n  ThemeConfig,\n  TileMapSpec,\n} from '@opendata-ai/openchart-core';\nimport { isLayerSpec, isTileMapSpec } from '@opendata-ai/openchart-core';\nimport { compileChart, compileLayer, compileTileMap } from '@opendata-ai/openchart-engine';\nimport { SVG_NS } from './renderers/svg-dom';\nimport { resetSvgIdCounter } from './svg-ids';\nimport { renderChartSVG } from './svg-renderer';\nimport { buildThemeStyleBlock } from './theme-style-block';\nimport { renderTileMapSVG } from './tilemap-renderer';\n\nconst esmRequire = createRequire(import.meta.url);\n\nlet cachedWindow: typeof import('happy-dom').Window | undefined;\nfunction getHappyDomWindow(): typeof import('happy-dom').Window {\n  if (cachedWindow) return cachedWindow;\n  try {\n    ({ Window: cachedWindow } = esmRequire('happy-dom') as typeof import('happy-dom'));\n  } catch {\n    throw new Error(\n      \"renderStaticSVG requires 'happy-dom' as a peer dependency. Install it with: npm add happy-dom\",\n    );\n  }\n  return cachedWindow;\n}\n\nlet rendering = false;\n\nexport interface StaticRenderOptions {\n  width?: number;\n  height?: number;\n  theme?: ThemeConfig;\n  /**\n   * Dark mode setting. In static rendering `'auto'` resolves to light mode\n   * since there is no `matchMedia` to query. Use `'force'` for dark output.\n   */\n  darkMode?: DarkMode;\n  /** Rendering backend for point marks; see `MountOptions.renderer`. */\n  renderer?: 'auto' | 'svg' | 'canvas';\n  watermark?: boolean;\n}\n\nfunction resolveStaticDarkMode(mode?: DarkMode): boolean {\n  if (mode === 'force') return true;\n  return false;\n}\n\nfunction stripInteractiveElements(svg: Element): void {\n  const selectors = ['[data-voronoi-overlay]', '[data-crosshair]', '[data-snap-dots]'];\n  for (const selector of selectors) {\n    const els = svg.querySelectorAll(selector);\n    for (const el of els) {\n      el.parentNode?.removeChild(el);\n    }\n  }\n}\n\n/**\n * Render a chart spec to a standalone SVG string without a browser DOM.\n *\n * Requires `happy-dom` as a peer dependency (`bun add happy-dom`).\n *\n * Not safe for concurrent invocation: the render pipeline relies on a global\n * SVG ID counter and a temporary global `document` swap, both of which are\n * single-threaded. In a server handling parallel requests, serialize calls\n * through a queue or mutex.\n *\n * The entire render pipeline is synchronous; the global swap is safe as long\n * as no code schedules microtasks that outlive the call.\n */\nexport function renderStaticSVG(\n  spec: ChartSpec | LayerSpec | TileMapSpec,\n  options?: StaticRenderOptions,\n): string {\n  if (rendering) {\n    throw new Error('renderStaticSVG is not reentrant — serialize calls through a queue or mutex');\n  }\n  rendering = true;\n\n  const Window = getHappyDomWindow();\n  const win = new Window({ url: 'about:blank' });\n\n  const prevDocument = globalThis.document;\n  const prevWindow = (globalThis as Record<string, unknown>).window;\n\n  try {\n    (globalThis as Record<string, unknown>).document = win.document;\n    (globalThis as Record<string, unknown>).window = win;\n\n    resetSvgIdCounter();\n\n    const width = options?.width ?? 640;\n    const height = options?.height ?? 420;\n    const darkMode = resolveStaticDarkMode(options?.darkMode);\n\n    const compileOpts: CompileOptions = {\n      width,\n      height,\n      theme: options?.theme,\n      darkMode,\n      renderer: options?.renderer,\n      watermark: options?.watermark,\n    };\n\n    let svg: SVGElement;\n    let themeForStyle: ResolvedTheme;\n\n    if (isTileMapSpec(spec)) {\n      const tileMapLayout = compileTileMap(spec, compileOpts);\n      svg = renderTileMapSVG(tileMapLayout, { animate: false });\n      themeForStyle = tileMapLayout.theme;\n    } else {\n      let layout: ChartLayout;\n      if (isLayerSpec(spec)) {\n        layout = compileLayer(spec, compileOpts);\n      } else {\n        layout = compileChart(spec, compileOpts);\n      }\n\n      const container = win.document.createElement('div');\n      Object.defineProperty(container, 'getBoundingClientRect', {\n        value: () => ({\n          width,\n          height,\n          top: 0,\n          left: 0,\n          right: width,\n          bottom: height,\n          x: 0,\n          y: 0,\n          toJSON: () => ({}),\n        }),\n      });\n\n      svg = renderChartSVG(layout, container as unknown as HTMLElement, {\n        animate: false,\n        crosshair: false,\n      });\n\n      stripInteractiveElements(svg);\n      themeForStyle = layout.theme;\n    }\n\n    const doc = win.document as unknown as Document;\n    let defs = svg.querySelector('defs');\n    if (!defs) {\n      defs = doc.createElementNS(SVG_NS, 'defs');\n      svg.insertBefore(defs as unknown as Node, svg.firstChild);\n    }\n    const styleEl = doc.createElementNS(SVG_NS, 'style');\n    styleEl.textContent = buildThemeStyleBlock(themeForStyle);\n    defs.insertBefore(styleEl as unknown as Node, defs.firstChild);\n\n    const serializer = new (\n      win as unknown as { XMLSerializer: typeof XMLSerializer }\n    ).XMLSerializer();\n    return serializer.serializeToString(svg as unknown as Node);\n  } finally {\n    rendering = false;\n    if (prevDocument !== undefined) {\n      (globalThis as Record<string, unknown>).document = prevDocument;\n    } else {\n      delete (globalThis as Record<string, unknown>).document;\n    }\n    if (prevWindow !== undefined) {\n      (globalThis as Record<string, unknown>).window = prevWindow;\n    } else {\n      delete (globalThis as Record<string, unknown>).window;\n    }\n    win.close();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAW9B,SAAS,aAAa,qBAAqB;AAC3C,SAAS,cAAc,cAAc,sBAAsB;AAO3D,IAAM,aAAa,cAAc,YAAY,GAAG;AAEhD,IAAI;AACJ,SAAS,oBAAuD;AAC9D,MAAI,aAAc,QAAO;AACzB,MAAI;AACF,KAAC,EAAE,QAAQ,aAAa,IAAI,WAAW,WAAW;AAAA,EACpD,QAAQ;AACN,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEA,IAAI,YAAY;AAgBhB,SAAS,sBAAsB,MAA0B;AACvD,MAAI,SAAS,QAAS,QAAO;AAC7B,SAAO;AACT;AAEA,SAAS,yBAAyB,KAAoB;AACpD,QAAM,YAAY,CAAC,0BAA0B,oBAAoB,kBAAkB;AACnF,aAAW,YAAY,WAAW;AAChC,UAAM,MAAM,IAAI,iBAAiB,QAAQ;AACzC,eAAW,MAAM,KAAK;AACpB,SAAG,YAAY,YAAY,EAAE;AAAA,IAC/B;AAAA,EACF;AACF;AAeO,SAAS,gBACd,MACA,SACQ;AACR,MAAI,WAAW;AACb,UAAM,IAAI,MAAM,kFAA6E;AAAA,EAC/F;AACA,cAAY;AAEZ,QAAM,SAAS,kBAAkB;AACjC,QAAM,MAAM,IAAI,OAAO,EAAE,KAAK,cAAc,CAAC;AAE7C,QAAM,eAAe,WAAW;AAChC,QAAM,aAAc,WAAuC;AAE3D,MAAI;AACF,IAAC,WAAuC,WAAW,IAAI;AACvD,IAAC,WAAuC,SAAS;AAEjD,sBAAkB;AAElB,UAAM,QAAQ,SAAS,SAAS;AAChC,UAAM,SAAS,SAAS,UAAU;AAClC,UAAM,WAAW,sBAAsB,SAAS,QAAQ;AAExD,UAAM,cAA8B;AAAA,MAClC;AAAA,MACA;AAAA,MACA,OAAO,SAAS;AAAA,MAChB;AAAA,MACA,UAAU,SAAS;AAAA,MACnB,WAAW,SAAS;AAAA,IACtB;AAEA,QAAI;AACJ,QAAI;AAEJ,QAAI,cAAc,IAAI,GAAG;AACvB,YAAM,gBAAgB,eAAe,MAAM,WAAW;AACtD,YAAM,iBAAiB,eAAe,EAAE,SAAS,MAAM,CAAC;AACxD,sBAAgB,cAAc;AAAA,IAChC,OAAO;AACL,UAAI;AACJ,UAAI,YAAY,IAAI,GAAG;AACrB,iBAAS,aAAa,MAAM,WAAW;AAAA,MACzC,OAAO;AACL,iBAAS,aAAa,MAAM,WAAW;AAAA,MACzC;AAEA,YAAM,YAAY,IAAI,SAAS,cAAc,KAAK;AAClD,aAAO,eAAe,WAAW,yBAAyB;AAAA,QACxD,OAAO,OAAO;AAAA,UACZ;AAAA,UACA;AAAA,UACA,KAAK;AAAA,UACL,MAAM;AAAA,UACN,OAAO;AAAA,UACP,QAAQ;AAAA,UACR,GAAG;AAAA,UACH,GAAG;AAAA,UACH,QAAQ,OAAO,CAAC;AAAA,QAClB;AAAA,MACF,CAAC;AAED,YAAM,eAAe,QAAQ,WAAqC;AAAA,QAChE,SAAS;AAAA,QACT,WAAW;AAAA,MACb,CAAC;AAED,+BAAyB,GAAG;AAC5B,sBAAgB,OAAO;AAAA,IACzB;AAEA,UAAM,MAAM,IAAI;AAChB,QAAI,OAAO,IAAI,cAAc,MAAM;AACnC,QAAI,CAAC,MAAM;AACT,aAAO,IAAI,gBAAgB,QAAQ,MAAM;AACzC,UAAI,aAAa,MAAyB,IAAI,UAAU;AAAA,IAC1D;AACA,UAAM,UAAU,IAAI,gBAAgB,QAAQ,OAAO;AACnD,YAAQ,cAAc,qBAAqB,aAAa;AACxD,SAAK,aAAa,SAA4B,KAAK,UAAU;AAE7D,UAAM,aAAa,IACjB,IACA,cAAc;AAChB,WAAO,WAAW,kBAAkB,GAAsB;AAAA,EAC5D,UAAE;AACA,gBAAY;AACZ,QAAI,iBAAiB,QAAW;AAC9B,MAAC,WAAuC,WAAW;AAAA,IACrD,OAAO;AACL,aAAQ,WAAuC;AAAA,IACjD;AACA,QAAI,eAAe,QAAW;AAC5B,MAAC,WAAuC,SAAS;AAAA,IACnD,OAAO;AACL,aAAQ,WAAuC;AAAA,IACjD;AACA,QAAI,MAAM;AAAA,EACZ;AACF;","names":[]}

package/dist/story/index.js

@@ -5,22 +5,25 @@ import {
   cameraTransform,
   camerasClose,
   canTransitionSpecShape,
-  clamp01,
   createChart,
   createGeoMap,
-  createTween2 as createTween,
+  createTween,
   damp,
   dampCamera,
   easingFns,
   fitTarget,
   interpolateCamera,
-  lerp,
   scrubCamera,
   storyMotion
-} from "../chunk-45XZOWYC.js";
-import "../chunk-UOB422LY.js";
-import "../chunk-YGYMB7KB.js";
-import "../chunk-HGRNXLDF.js";
+} from "../chunk-5KV3ZBBL.js";
+import "../chunk-6B5OBGIO.js";
+import "../chunk-XGII4ZRT.js";
+import "../chunk-5RX6ZQGZ.js";
+import {
+  clamp01,
+  lerp
+} from "../chunk-2OJZBMXM.js";
+import "../chunk-NG7CVCI2.js";
 
 // src/story/create-chart-story.ts
 import { deepMergeSpec, isGeoMapSpec } from "@opendata-ai/openchart-core";