velo-plot 3.1.0 → 4.0.0-alpha.1

package/dist/{PluginRegistry-CzMHebYP.js → PluginRegistry-CDf_jcnp.js}

@@ -1,7 +1,7 @@
 var c = Object.defineProperty;
 var g = (i, e, r) => e in i ? c(i, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : i[e] = r;
 var u = (i, e, r) => g(i, typeof e != "symbol" ? e + "" : e, r);
-import { N as f } from "./ChartCore-AnR_3Xkb.js";
+import { N as f } from "./ChartCore-KYG2HTcK.js";
 function m(i) {
   return new f(i);
 }
@@ -151,4 +151,4 @@ export {
   p as r,
   $ as v
 };
-//# sourceMappingURL=PluginRegistry-CzMHebYP.js.map
+//# sourceMappingURL=PluginRegistry-CDf_jcnp.js.map

package/dist/{PluginRegistry-CzMHebYP.js.map → PluginRegistry-CDf_jcnp.js.map}

@@ -1 +1 @@
-{"version":3,"file":"PluginRegistry-CzMHebYP.js","sources":["../src/renderer/RendererInterface.ts","../src/plugins/PluginRegistry.ts"],"sourcesContent":["/**\n * WebGL Renderer Interface & Factory\n *\n * This module provides a common interface for WebGL rendering.\n * Currently optimized for NativeWebGLRenderer (zero dependencies).\n */\n\nimport type { Bounds } from '../types';\nimport { NativeWebGLRenderer } from './NativeWebGLRenderer';\n\n// ============================================\n// Common Types\n// ============================================\n\nexport interface SeriesRenderData {\n  id: string;\n  buffer: WebGLBuffer;\n  count: number;\n  style: any;\n  visible: boolean;\n  type: string;\n  zBounds?: { min: number; max: number };\n  colormapTexture?: WebGLTexture;\n}\n\nexport interface RenderOptions {\n  bounds: Bounds;\n  backgroundColor?: [number, number, number, number];\n}\n\n// ============================================\n// Renderer Interface\n// ============================================\n\n/**\n * Common interface for all WebGL renderer implementations\n */\nexport interface IWebGLRenderer {\n  /** Check if WebGL is available and initialized */\n  readonly available: boolean;\n\n  /**\n   * Create or update a GPU buffer with interleaved X,Y data\n   * @param id - Unique buffer identifier\n   * @param data - Interleaved Float32Array [x0, y0, x1, y1, ...]\n   */\n  createBuffer(id: string, data: Float32Array): void;\n\n  /**\n   * Get a buffer by ID\n   */\n  getBuffer(id: string): WebGLBuffer | undefined;\n\n  /**\n   * Delete a buffer and free GPU memory\n   */\n  deleteBuffer(id: string): void;\n  \n  /** \n   * Create a 1D texture for heatmaps \n   */\n  createColormapTexture(id: string, data: Uint8Array): WebGLTexture;\n\n  /**\n   * Render a frame with all visible series\n   */\n  render(series: SeriesRenderData[], options: RenderOptions): void;\n\n  /**\n   * Handle canvas resize\n   */\n  resize(): void;\n\n  /**\n   * Get WebGL capabilities/limits\n   */\n  getLimits(): Record<string, unknown>;\n\n  /**\n   * Cleanup and destroy all GPU resources\n   */\n  destroy(): void;\n}\n\n// ============================================\n// Factory Functions\n// ============================================\n\n/**\n * Create a WebGL renderer (Native WebGL)\n *\n * @param canvas - Target canvas element\n */\nexport function createRenderer(canvas: HTMLCanvasElement): IWebGLRenderer {\n  return new NativeWebGLRenderer(canvas);\n}\n\n/**\n * Create a renderer synchronously (native only)\n */\nexport { NativeWebGLRenderer as createNativeRenderer } from './NativeWebGLRenderer';\n","/**\n * Velo Plot - Global Plugin Registry\n * \n * Provides a global registry for third-party plugins that can be\n * discovered and loaded by name without explicit imports.\n * \n * @module plugins/PluginRegistry\n */\n\nimport type {\n    PluginFactory,\n    PluginManifest,\n    PluginCapability,\n    PluginRegistry,\n    PluginRegistryEntry,\n} from \"./types\";\n\n// ============================================\n// Global Registry Implementation\n// ============================================\n\nclass PluginRegistryImpl implements PluginRegistry {\n    private entries = new Map<string, PluginRegistryEntry>();\n\n    /**\n     * Register a plugin globally\n     */\n    register(entry: PluginRegistryEntry): void {\n        const name = entry.manifest.name;\n\n        if (this.entries.has(name)) {\n            console.warn(\n                `[VeloPlot Registry] Plugin \"${name}\" is already registered, overwriting`\n            );\n        }\n\n        this.entries.set(name, entry);\n    }\n\n    /**\n     * Unregister a plugin\n     */\n    unregister(name: string): boolean {\n        const existed = this.entries.has(name);\n        this.entries.delete(name);\n        return existed;\n    }\n\n    /**\n     * Get a registered plugin factory by name\n     */\n    get(name: string): PluginFactory | undefined {\n        return this.entries.get(name)?.factory;\n    }\n\n    /**\n     * List all registered plugins\n     */\n    list(): PluginManifest[] {\n        return Array.from(this.entries.values()).map((e) => e.manifest);\n    }\n\n    /**\n     * Search plugins by capability\n     */\n    findByCapability(capability: PluginCapability): PluginManifest[] {\n        const results: PluginManifest[] = [];\n\n        this.entries.forEach((entry) => {\n            if (entry.manifest.provides?.includes(capability)) {\n                results.push(entry.manifest);\n            }\n        });\n\n        return results;\n    }\n\n    /**\n     * Search plugins by tag\n     */\n    findByTag(tag: string): PluginManifest[] {\n        const results: PluginManifest[] = [];\n        const lowerTag = tag.toLowerCase();\n\n        this.entries.forEach((entry) => {\n            if (entry.manifest.tags?.some((t) => t.toLowerCase().includes(lowerTag))) {\n                results.push(entry.manifest);\n            }\n        });\n\n        return results;\n    }\n\n    /**\n     * Check if a plugin is registered\n     */\n    has(name: string): boolean {\n        return this.entries.has(name);\n    }\n\n    /**\n     * Get plugin count\n     */\n    get size(): number {\n        return this.entries.size;\n    }\n\n    /**\n     * Clear all registrations\n     */\n    clear(): void {\n        this.entries.clear();\n    }\n}\n\n// ============================================\n// Singleton Instance\n// ============================================\n\nlet registryInstance: PluginRegistryImpl | null = null;\n\n/**\n * Get the global plugin registry singleton\n */\nexport function getPluginRegistry(): PluginRegistry {\n    if (!registryInstance) {\n        registryInstance = new PluginRegistryImpl();\n    }\n    return registryInstance;\n}\n\n/**\n * Register a plugin in the global registry\n * Shorthand for getPluginRegistry().register()\n */\nexport function registerPlugin(entry: PluginRegistryEntry): void {\n    getPluginRegistry().register(entry);\n}\n\n/**\n * Create a plugin factory with manifest validation\n */\nexport function definePlugin<TConfig = unknown>(\n    manifest: PluginManifest,\n    factory: (config?: TConfig) => Omit<import(\"./types\").ChartPlugin<TConfig>, \"manifest\">\n): PluginFactory<TConfig> {\n    return (config?: TConfig) => {\n        const plugin = factory(config);\n        return {\n            ...plugin,\n            manifest,\n        };\n    };\n}\n\n/**\n * Register a plugin from definition\n */\nexport function defineAndRegister<TConfig = unknown>(\n    manifest: PluginManifest,\n    factory: (config?: TConfig) => Omit<import(\"./types\").ChartPlugin<TConfig>, \"manifest\">\n): PluginFactory<TConfig> {\n    const pluginFactory = definePlugin(manifest, factory);\n    registerPlugin({ manifest, factory: pluginFactory as PluginFactory });\n    return pluginFactory;\n}\n\n// ============================================\n// Plugin Discovery Helpers\n// ============================================\n\n/**\n * Load a plugin from the registry by name\n */\nexport async function loadPlugin<TConfig = unknown>(\n    name: string,\n    config?: TConfig\n): Promise<import(\"./types\").ChartPlugin<TConfig> | undefined> {\n    const factory = getPluginRegistry().get(name);\n    if (!factory) {\n        console.warn(`[VeloPlot] Plugin \"${name}\" not found in registry`);\n        return undefined;\n    }\n    return factory(config) as import(\"./types\").ChartPlugin<TConfig>;\n}\n\n/**\n * List available plugins by category\n */\nexport function listPluginsByCategory(): Record<PluginCapability, PluginManifest[]> {\n    const registry = getPluginRegistry();\n    const categories: PluginCapability[] = [\n        \"analysis\",\n        \"visualization\",\n        \"interaction\",\n        \"data-source\",\n        \"export\",\n        \"ui\",\n        \"annotation\",\n        \"theme\",\n    ];\n\n    const result: Record<string, PluginManifest[]> = {};\n    categories.forEach((cat) => {\n        result[cat] = registry.findByCapability(cat);\n    });\n\n    return result as Record<PluginCapability, PluginManifest[]>;\n}\n\n// ============================================\n// Plugin Validation\n// ============================================\n\n/**\n * Validate a plugin manifest\n */\nexport function validateManifest(manifest: PluginManifest): string[] {\n    const errors: string[] = [];\n\n    if (!manifest.name) {\n        errors.push(\"Missing required field: name\");\n    } else if (!/^[@a-z0-9-]+\\/[a-z0-9-]+$|^[a-z0-9-]+$/.test(manifest.name)) {\n        errors.push(\n            'Invalid name format. Use lowercase with hyphens, optionally scoped (e.g., \"@org/name\")'\n        );\n    }\n\n    if (!manifest.version) {\n        errors.push(\"Missing required field: version\");\n    } else if (!/^\\d+\\.\\d+\\.\\d+$/.test(manifest.version)) {\n        errors.push(\"Invalid version format. Use semantic versioning (e.g., 1.0.0)\");\n    }\n\n    if (manifest.dependencies) {\n        if (!Array.isArray(manifest.dependencies)) {\n            errors.push(\"dependencies must be an array\");\n        }\n    }\n\n    if (manifest.provides) {\n        if (!Array.isArray(manifest.provides)) {\n            errors.push(\"provides must be an array\");\n        }\n    }\n\n    return errors;\n}\n\n/**\n * Validate a plugin for compatibility\n */\nexport function checkPluginCompatibility(\n    manifest: PluginManifest,\n    engineVersion: string\n): { compatible: boolean; warnings: string[] } {\n    const warnings: string[] = [];\n\n    if (manifest.engineVersion) {\n        const [reqMajor] = manifest.engineVersion.split(\".\").map(Number);\n        const [curMajor] = engineVersion.split(\".\").map(Number);\n\n        if (reqMajor > curMajor) {\n            return {\n                compatible: false,\n                warnings: [\n                    `Plugin requires engine v${manifest.engineVersion}, current is v${engineVersion}`,\n                ],\n            };\n        }\n\n        if (reqMajor < curMajor) {\n            warnings.push(\n                `Plugin was built for engine v${manifest.engineVersion}, may have compatibility issues`\n            );\n        }\n    }\n\n    return { compatible: true, warnings };\n}\n"],"names":["createRenderer","canvas","NativeWebGLRenderer","PluginRegistryImpl","__publicField","entry","name","existed","_a","capability","results","tag","lowerTag","t","registryInstance","getPluginRegistry","registerPlugin","definePlugin","manifest","factory","config","defineAndRegister","pluginFactory","loadPlugin","listPluginsByCategory","registry","categories","result","cat","validateManifest","errors","checkPluginCompatibility","engineVersion","warnings","reqMajor","curMajor"],"mappings":"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"}
+{"version":3,"file":"PluginRegistry-CDf_jcnp.js","sources":["../src/renderer/RendererInterface.ts","../src/plugins/PluginRegistry.ts"],"sourcesContent":["/**\n * WebGL Renderer Interface & Factory\n *\n * This module provides a common interface for WebGL rendering.\n * Currently optimized for NativeWebGLRenderer (zero dependencies).\n */\n\nimport type { Bounds } from '../types';\nimport { NativeWebGLRenderer } from './NativeWebGLRenderer';\n\n// ============================================\n// Common Types\n// ============================================\n\nexport interface SeriesRenderData {\n  id: string;\n  buffer: WebGLBuffer;\n  count: number;\n  style: any;\n  visible: boolean;\n  type: string;\n  zBounds?: { min: number; max: number };\n  colormapTexture?: WebGLTexture;\n}\n\nexport interface RenderOptions {\n  bounds: Bounds;\n  backgroundColor?: [number, number, number, number];\n}\n\n// ============================================\n// Renderer Interface\n// ============================================\n\n/**\n * Common interface for all WebGL renderer implementations\n */\nexport interface IWebGLRenderer {\n  /** Check if WebGL is available and initialized */\n  readonly available: boolean;\n\n  /**\n   * Create or update a GPU buffer with interleaved X,Y data\n   * @param id - Unique buffer identifier\n   * @param data - Interleaved Float32Array [x0, y0, x1, y1, ...]\n   */\n  createBuffer(id: string, data: Float32Array): void;\n\n  /**\n   * Get a buffer by ID\n   */\n  getBuffer(id: string): WebGLBuffer | undefined;\n\n  /**\n   * Delete a buffer and free GPU memory\n   */\n  deleteBuffer(id: string): void;\n  \n  /** \n   * Create a 1D texture for heatmaps \n   */\n  createColormapTexture(id: string, data: Uint8Array): WebGLTexture;\n\n  /**\n   * Render a frame with all visible series\n   */\n  render(series: SeriesRenderData[], options: RenderOptions): void;\n\n  /**\n   * Handle canvas resize\n   */\n  resize(): void;\n\n  /**\n   * Get WebGL capabilities/limits\n   */\n  getLimits(): Record<string, unknown>;\n\n  /**\n   * Cleanup and destroy all GPU resources\n   */\n  destroy(): void;\n}\n\n// ============================================\n// Factory Functions\n// ============================================\n\n/**\n * Create a WebGL renderer (Native WebGL)\n *\n * @param canvas - Target canvas element\n */\nexport function createRenderer(canvas: HTMLCanvasElement): IWebGLRenderer {\n  return new NativeWebGLRenderer(canvas);\n}\n\n/**\n * Create a renderer synchronously (native only)\n */\nexport { NativeWebGLRenderer as createNativeRenderer } from './NativeWebGLRenderer';\n","/**\n * Velo Plot - Global Plugin Registry\n * \n * Provides a global registry for third-party plugins that can be\n * discovered and loaded by name without explicit imports.\n * \n * @module plugins/PluginRegistry\n */\n\nimport type {\n    PluginFactory,\n    PluginManifest,\n    PluginCapability,\n    PluginRegistry,\n    PluginRegistryEntry,\n} from \"./types\";\n\n// ============================================\n// Global Registry Implementation\n// ============================================\n\nclass PluginRegistryImpl implements PluginRegistry {\n    private entries = new Map<string, PluginRegistryEntry>();\n\n    /**\n     * Register a plugin globally\n     */\n    register(entry: PluginRegistryEntry): void {\n        const name = entry.manifest.name;\n\n        if (this.entries.has(name)) {\n            console.warn(\n                `[VeloPlot Registry] Plugin \"${name}\" is already registered, overwriting`\n            );\n        }\n\n        this.entries.set(name, entry);\n    }\n\n    /**\n     * Unregister a plugin\n     */\n    unregister(name: string): boolean {\n        const existed = this.entries.has(name);\n        this.entries.delete(name);\n        return existed;\n    }\n\n    /**\n     * Get a registered plugin factory by name\n     */\n    get(name: string): PluginFactory | undefined {\n        return this.entries.get(name)?.factory;\n    }\n\n    /**\n     * List all registered plugins\n     */\n    list(): PluginManifest[] {\n        return Array.from(this.entries.values()).map((e) => e.manifest);\n    }\n\n    /**\n     * Search plugins by capability\n     */\n    findByCapability(capability: PluginCapability): PluginManifest[] {\n        const results: PluginManifest[] = [];\n\n        this.entries.forEach((entry) => {\n            if (entry.manifest.provides?.includes(capability)) {\n                results.push(entry.manifest);\n            }\n        });\n\n        return results;\n    }\n\n    /**\n     * Search plugins by tag\n     */\n    findByTag(tag: string): PluginManifest[] {\n        const results: PluginManifest[] = [];\n        const lowerTag = tag.toLowerCase();\n\n        this.entries.forEach((entry) => {\n            if (entry.manifest.tags?.some((t) => t.toLowerCase().includes(lowerTag))) {\n                results.push(entry.manifest);\n            }\n        });\n\n        return results;\n    }\n\n    /**\n     * Check if a plugin is registered\n     */\n    has(name: string): boolean {\n        return this.entries.has(name);\n    }\n\n    /**\n     * Get plugin count\n     */\n    get size(): number {\n        return this.entries.size;\n    }\n\n    /**\n     * Clear all registrations\n     */\n    clear(): void {\n        this.entries.clear();\n    }\n}\n\n// ============================================\n// Singleton Instance\n// ============================================\n\nlet registryInstance: PluginRegistryImpl | null = null;\n\n/**\n * Get the global plugin registry singleton\n */\nexport function getPluginRegistry(): PluginRegistry {\n    if (!registryInstance) {\n        registryInstance = new PluginRegistryImpl();\n    }\n    return registryInstance;\n}\n\n/**\n * Register a plugin in the global registry\n * Shorthand for getPluginRegistry().register()\n */\nexport function registerPlugin(entry: PluginRegistryEntry): void {\n    getPluginRegistry().register(entry);\n}\n\n/**\n * Create a plugin factory with manifest validation\n */\nexport function definePlugin<TConfig = unknown>(\n    manifest: PluginManifest,\n    factory: (config?: TConfig) => Omit<import(\"./types\").ChartPlugin<TConfig>, \"manifest\">\n): PluginFactory<TConfig> {\n    return (config?: TConfig) => {\n        const plugin = factory(config);\n        return {\n            ...plugin,\n            manifest,\n        };\n    };\n}\n\n/**\n * Register a plugin from definition\n */\nexport function defineAndRegister<TConfig = unknown>(\n    manifest: PluginManifest,\n    factory: (config?: TConfig) => Omit<import(\"./types\").ChartPlugin<TConfig>, \"manifest\">\n): PluginFactory<TConfig> {\n    const pluginFactory = definePlugin(manifest, factory);\n    registerPlugin({ manifest, factory: pluginFactory as PluginFactory });\n    return pluginFactory;\n}\n\n// ============================================\n// Plugin Discovery Helpers\n// ============================================\n\n/**\n * Load a plugin from the registry by name\n */\nexport async function loadPlugin<TConfig = unknown>(\n    name: string,\n    config?: TConfig\n): Promise<import(\"./types\").ChartPlugin<TConfig> | undefined> {\n    const factory = getPluginRegistry().get(name);\n    if (!factory) {\n        console.warn(`[VeloPlot] Plugin \"${name}\" not found in registry`);\n        return undefined;\n    }\n    return factory(config) as import(\"./types\").ChartPlugin<TConfig>;\n}\n\n/**\n * List available plugins by category\n */\nexport function listPluginsByCategory(): Record<PluginCapability, PluginManifest[]> {\n    const registry = getPluginRegistry();\n    const categories: PluginCapability[] = [\n        \"analysis\",\n        \"visualization\",\n        \"interaction\",\n        \"data-source\",\n        \"export\",\n        \"ui\",\n        \"annotation\",\n        \"theme\",\n    ];\n\n    const result: Record<string, PluginManifest[]> = {};\n    categories.forEach((cat) => {\n        result[cat] = registry.findByCapability(cat);\n    });\n\n    return result as Record<PluginCapability, PluginManifest[]>;\n}\n\n// ============================================\n// Plugin Validation\n// ============================================\n\n/**\n * Validate a plugin manifest\n */\nexport function validateManifest(manifest: PluginManifest): string[] {\n    const errors: string[] = [];\n\n    if (!manifest.name) {\n        errors.push(\"Missing required field: name\");\n    } else if (!/^[@a-z0-9-]+\\/[a-z0-9-]+$|^[a-z0-9-]+$/.test(manifest.name)) {\n        errors.push(\n            'Invalid name format. Use lowercase with hyphens, optionally scoped (e.g., \"@org/name\")'\n        );\n    }\n\n    if (!manifest.version) {\n        errors.push(\"Missing required field: version\");\n    } else if (!/^\\d+\\.\\d+\\.\\d+$/.test(manifest.version)) {\n        errors.push(\"Invalid version format. Use semantic versioning (e.g., 1.0.0)\");\n    }\n\n    if (manifest.dependencies) {\n        if (!Array.isArray(manifest.dependencies)) {\n            errors.push(\"dependencies must be an array\");\n        }\n    }\n\n    if (manifest.provides) {\n        if (!Array.isArray(manifest.provides)) {\n            errors.push(\"provides must be an array\");\n        }\n    }\n\n    return errors;\n}\n\n/**\n * Validate a plugin for compatibility\n */\nexport function checkPluginCompatibility(\n    manifest: PluginManifest,\n    engineVersion: string\n): { compatible: boolean; warnings: string[] } {\n    const warnings: string[] = [];\n\n    if (manifest.engineVersion) {\n        const [reqMajor] = manifest.engineVersion.split(\".\").map(Number);\n        const [curMajor] = engineVersion.split(\".\").map(Number);\n\n        if (reqMajor > curMajor) {\n            return {\n                compatible: false,\n                warnings: [\n                    `Plugin requires engine v${manifest.engineVersion}, current is v${engineVersion}`,\n                ],\n            };\n        }\n\n        if (reqMajor < curMajor) {\n            warnings.push(\n                `Plugin was built for engine v${manifest.engineVersion}, may have compatibility issues`\n            );\n        }\n    }\n\n    return { compatible: true, warnings };\n}\n"],"names":["createRenderer","canvas","NativeWebGLRenderer","PluginRegistryImpl","__publicField","entry","name","existed","_a","capability","results","tag","lowerTag","t","registryInstance","getPluginRegistry","registerPlugin","definePlugin","manifest","factory","config","defineAndRegister","pluginFactory","loadPlugin","listPluginsByCategory","registry","categories","result","cat","validateManifest","errors","checkPluginCompatibility","engineVersion","warnings","reqMajor","curMajor"],"mappings":"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"}

package/dist/SVGDocumentBuilder-C-uLkcFW.js

@@ -0,0 +1,83 @@
+var u = Object.defineProperty;
+var f = (i, t, e) => t in i ? u(i, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : i[t] = e;
+var p = (i, t, e) => f(i, typeof t != "symbol" ? t + "" : t, e);
+let l = 0;
+function n(i) {
+  return i.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function $(i, t = 1) {
+  return i.toFixed(t);
+}
+class c {
+  constructor(t, e, r) {
+    p(this, "defs", []);
+    p(this, "layers", /* @__PURE__ */ new Map());
+    this.width = t, this.height = e, this.fontFamily = r;
+  }
+  resetGradientCounter() {
+    l = 0;
+  }
+  addDef(t) {
+    const e = `vp-def-${++l}`;
+    return this.defs.push(`<${t.includes("id=") ? t : `linearGradient id="${e}" ${t}`}>`), e;
+  }
+  registerLinearGradient(t, e, r, s, h) {
+    const o = `vp-grad-${++l}`, a = h.map(
+      (d) => `<stop offset="${d.offset}" stop-color="${d.color}"${d.opacity !== void 0 ? ` stop-opacity="${d.opacity}"` : ""}/>`
+    ).join("");
+    return this.defs.push(
+      `<linearGradient id="${o}" x1="${t}" y1="${e}" x2="${r}" y2="${s}">${a}</linearGradient>`
+    ), o;
+  }
+  registerClipPath(t, e) {
+    this.defs.push(`<clipPath id="${t}">${e}</clipPath>`);
+  }
+  registerArrowMarker(t, e) {
+    this.defs.push(
+      `<marker id="${t}" markerWidth="8" markerHeight="8" refX="6" refY="3" orient="auto" markerUnits="strokeWidth"><path d="M0,0 L8,3 L0,6 Z" fill="${n(e)}"/></marker>`
+    );
+  }
+  push(t, e) {
+    this.layers.has(t) || this.layers.set(t, []), this.layers.get(t).push(e);
+  }
+  pushRaw(t) {
+    this.push("default", t);
+  }
+  openGroup(t, e, r) {
+    const s = r ? " " + Object.entries(r).map(([o, a]) => `${o}="${n(a)}"`).join(" ") : "", h = `<g${e ? ` transform="${e}"` : ""}${s}>`;
+    return this.push(t, h), t;
+  }
+  closeGroup(t) {
+    this.push(t, "</g>");
+  }
+  build(t, e) {
+    const r = [
+      "background",
+      "grid",
+      "series",
+      "errorBars",
+      "plugins",
+      "axes",
+      "border",
+      "title",
+      "legend",
+      "cursor"
+    ], s = [
+      `<svg width="${this.width}" height="${this.height}" viewBox="0 0 ${this.width} ${this.height}" xmlns="http://www.w3.org/2000/svg" font-family="${n(this.fontFamily)}"${e ? ` role="img" aria-label="${n(e)}"` : ""}>`
+    ];
+    e && s.push(`<title>${n(e)}</title>`), s.push(`<rect width="100%" height="100%" fill="${t}" />`), this.defs.length > 0 && s.push(`<defs>${this.defs.join("")}</defs>`), s.push("<g>");
+    for (const o of r) {
+      const a = this.layers.get(o);
+      a && s.push(...a);
+    }
+    const h = this.layers.get("default");
+    return h && s.push(...h), s.push("</g>"), s.push("</svg>"), s.join(`
+`);
+  }
+}
+export {
+  c as S,
+  n as e,
+  $ as f
+};
+//# sourceMappingURL=SVGDocumentBuilder-C-uLkcFW.js.map

package/dist/SVGDocumentBuilder-C-uLkcFW.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SVGDocumentBuilder-C-uLkcFW.js","sources":["../src/core/chart/exporter/svg/SVGDocumentBuilder.ts"],"sourcesContent":["/**\n * SVG document construction utilities — XML escape, defs, gradients, clipPaths.\n */\n\nlet gradientIdCounter = 0;\n\nexport function escapeXml(text: string): string {\n  return text\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\");\n}\n\nexport function fmt(n: number, decimals = 1): string {\n  return n.toFixed(decimals);\n}\n\nexport class SVGDocumentBuilder {\n  private defs: string[] = [];\n  private layers: Map<string, string[]> = new Map();\n\n  constructor(\n    private width: number,\n    private height: number,\n    private fontFamily: string,\n  ) {}\n\n  resetGradientCounter(): void {\n    gradientIdCounter = 0;\n  }\n\n  addDef(content: string): string {\n    const id = `vp-def-${++gradientIdCounter}`;\n    this.defs.push(`<${content.includes(\"id=\") ? content : `linearGradient id=\"${id}\" ${content}`}>`);\n    return id;\n  }\n\n  registerLinearGradient(\n    x1: number,\n    y1: number,\n    x2: number,\n    y2: number,\n    stops: Array<{ offset: string; color: string; opacity?: number }>,\n  ): string {\n    const id = `vp-grad-${++gradientIdCounter}`;\n    const stopEls = stops\n      .map(\n        (s) =>\n          `<stop offset=\"${s.offset}\" stop-color=\"${s.color}\"${s.opacity !== undefined ? ` stop-opacity=\"${s.opacity}\"` : \"\"}/>`,\n      )\n      .join(\"\");\n    this.defs.push(\n      `<linearGradient id=\"${id}\" x1=\"${x1}\" y1=\"${y1}\" x2=\"${x2}\" y2=\"${y2}\">${stopEls}</linearGradient>`,\n    );\n    return id;\n  }\n\n  registerClipPath(id: string, content: string): void {\n    this.defs.push(`<clipPath id=\"${id}\">${content}</clipPath>`);\n  }\n\n  registerArrowMarker(id: string, color: string): void {\n    this.defs.push(\n      `<marker id=\"${id}\" markerWidth=\"8\" markerHeight=\"8\" refX=\"6\" refY=\"3\" orient=\"auto\" markerUnits=\"strokeWidth\">` +\n        `<path d=\"M0,0 L8,3 L0,6 Z\" fill=\"${escapeXml(color)}\"/></marker>`,\n    );\n  }\n\n  push(layer: string, element: string): void {\n    if (!this.layers.has(layer)) this.layers.set(layer, []);\n    this.layers.get(layer)!.push(element);\n  }\n\n  pushRaw(element: string): void {\n    this.push(\"default\", element);\n  }\n\n  openGroup(layer: string, transform?: string, attrs?: Record<string, string>): string {\n    const attrStr = attrs\n      ? \" \" + Object.entries(attrs).map(([k, v]) => `${k}=\"${escapeXml(v)}\"`).join(\" \")\n      : \"\";\n    const el = `<g${transform ? ` transform=\"${transform}\"` : \"\"}${attrStr}>`;\n    this.push(layer, el);\n    return layer;\n  }\n\n  closeGroup(layer: string): void {\n    this.push(layer, \"</g>\");\n  }\n\n  build(backgroundColor: string, ariaLabel?: string): string {\n    const layerOrder = [\n      \"background\",\n      \"grid\",\n      \"series\",\n      \"errorBars\",\n      \"plugins\",\n      \"axes\",\n      \"border\",\n      \"title\",\n      \"legend\",\n      \"cursor\",\n    ];\n\n    const svg: string[] = [\n      `<svg width=\"${this.width}\" height=\"${this.height}\" viewBox=\"0 0 ${this.width} ${this.height}\" xmlns=\"http://www.w3.org/2000/svg\" font-family=\"${escapeXml(this.fontFamily)}\"${ariaLabel ? ` role=\"img\" aria-label=\"${escapeXml(ariaLabel)}\"` : \"\"}>`,\n    ];\n\n    if (ariaLabel) {\n      svg.push(`<title>${escapeXml(ariaLabel)}</title>`);\n    }\n\n    svg.push(`<rect width=\"100%\" height=\"100%\" fill=\"${backgroundColor}\" />`);\n\n    if (this.defs.length > 0) {\n      svg.push(`<defs>${this.defs.join(\"\")}</defs>`);\n    }\n\n    svg.push(\"<g>\");\n    for (const layer of layerOrder) {\n      const items = this.layers.get(layer);\n      if (items) svg.push(...items);\n    }\n    const defaultLayer = this.layers.get(\"default\");\n    if (defaultLayer) svg.push(...defaultLayer);\n    svg.push(\"</g>\");\n    svg.push(\"</svg>\");\n\n    return svg.join(\"\\n\");\n  }\n}\n"],"names":["gradientIdCounter","escapeXml","text","fmt","n","decimals","SVGDocumentBuilder","width","height","fontFamily","__publicField","content","id","x1","y1","x2","y2","stops","stopEls","s","color","layer","element","transform","attrs","attrStr","k","v","el","backgroundColor","ariaLabel","layerOrder","svg","items","defaultLayer"],"mappings":"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"}

package/dist/angular-hooks.js

@@ -1,4 +1,4 @@
-import { V as l, c as o, b as u, a as e, u as r } from "./hooks-DH-3bewj.js";
+import { V as l, c as o, b as u, a as e, u as r } from "./hooks-4wQH27r9.js";
 export {
   l as VeloPlotHost,
   o as useChartSyncAngular,

package/dist/angular.js

@@ -22,11 +22,11 @@ var b = (e) => [, , , Q((e == null ? void 0 : e[$("metadata")]) ?? null)], q = [
 }, n = (e, t, s) => j(e, typeof t != "symbol" ? t + "" : t, s), D = (e, t, s) => t.has(e) || f("Cannot " + s), X = (e, t) => Object(t) !== t ? f('Cannot use the "in" operator on this value') : e.has(t), M = (e, t, s) => (D(e, t, "read from private field"), s ? s.call(e) : t.get(e));
 var P = (e, t, s, c) => (D(e, t, "write to private field"), c ? c.call(e, s) : t.set(e, s), s), Y = (e, t, s) => (D(e, t, "access private method"), s);
 import { input as d, output as _, viewChild as J, effect as tt, Component as K } from "@angular/core";
-import { c as et } from "./createStackedChart-DqcLCFGS.js";
+import { c as et } from "./createStackedChart-DjA3aJAu.js";
 import { p as I, o as st, s as it, d as rt } from "./optionsSync-QUiN4Inw.js";
-import { c as nt } from "./chartSyncBridge-D_rCtbFq.js";
-import { u as ht } from "./hooks-DH-3bewj.js";
-import { V as gt, c as mt, b as vt, a as kt } from "./hooks-DH-3bewj.js";
+import { c as nt } from "./chartSyncBridge-C1uRy0ZS.js";
+import { u as ht } from "./hooks-4wQH27r9.js";
+import { V as gt, c as mt, b as vt, a as kt } from "./hooks-4wQH27r9.js";
 function m(e) {
   return typeof e == "number" ? `${e}px` : e;
 }

package/dist/{chartSyncBridge-D_rCtbFq.js → chartSyncBridge-C1uRy0ZS.js}

@@ -1,5 +1,5 @@
-import { c as s } from "./ChartCore-AnR_3Xkb.js";
-import { a as d } from "./createStackedChart-DqcLCFGS.js";
+import { c as s } from "./ChartCore-KYG2HTcK.js";
+import { a as d } from "./createStackedChart-DjA3aJAu.js";
 import { c as u } from "./index-CaXWSOTk.js";
 function c(e) {
   const r = e.responsive ?? { reducedMotion: "auto" };
@@ -55,4 +55,4 @@ export {
   f as i,
   p as r
 };
-//# sourceMappingURL=chartSyncBridge-D_rCtbFq.js.map
+//# sourceMappingURL=chartSyncBridge-C1uRy0ZS.js.map

package/dist/{chartSyncBridge-D_rCtbFq.js.map → chartSyncBridge-C1uRy0ZS.js.map}

@@ -1 +1 @@
-{"version":3,"file":"chartSyncBridge-D_rCtbFq.js","sources":["../src/bindings/shared/chartLifecycle.ts","../src/bindings/shared/indicatorBridge.ts","../src/bindings/shared/chartSyncBridge.ts"],"sourcesContent":["/**\n * Framework-agnostic chart lifecycle helpers.\n */\n\nimport { createChart, type Chart } from \"../../core/Chart\";\nimport type { ChartOptions, Bounds } from \"../../types\";\nimport type { BindingChartOptions } from \"./types\";\n\nexport type ChartBindingOptions = Omit<ChartOptions, \"container\"> &\n  BindingChartOptions;\n\nexport interface ChartLifecycleHandle {\n  chart: Chart;\n  destroy: () => void;\n  getBounds: () => Bounds | null;\n}\n\nexport interface ChartLifecycleCallbacks {\n  onBoundsChange?: (bounds: Bounds) => void;\n  onError?: (error: Error) => void;\n}\n\nfunction defaultResponsive(\n  options: ChartBindingOptions,\n): ChartBindingOptions {\n  const responsive = options.responsive ?? { reducedMotion: \"auto\" as const };\n  return { ...options, responsive };\n}\n\nexport function createChartLifecycle(\n  container: HTMLDivElement,\n  options: ChartBindingOptions,\n  callbacks: ChartLifecycleCallbacks = {},\n): ChartLifecycleHandle {\n  const chart = createChart({\n    ...defaultResponsive(options),\n    container,\n  });\n\n  const onZoom = () => {\n    callbacks.onBoundsChange?.(chart.getViewBounds());\n  };\n  chart.on(\"zoom\", onZoom);\n\n  let resizeObserver: ResizeObserver | undefined;\n  if (options.autoResize !== false) {\n    resizeObserver = new ResizeObserver(() => {\n      chart.resize();\n    });\n    resizeObserver.observe(container);\n  }\n\n  return {\n    chart,\n    getBounds: () => chart.getViewBounds(),\n    destroy: () => {\n      resizeObserver?.disconnect();\n      chart.off(\"zoom\", onZoom);\n      chart.destroy();\n    },\n  };\n}\n\nexport function attachZoomListener(\n  chart: Chart,\n  onBoundsChange: (bounds: Bounds) => void,\n): () => void {\n  const handler = () => onBoundsChange(chart.getViewBounds());\n  chart.on(\"zoom\", handler);\n  return () => chart.off(\"zoom\", handler);\n}\n","/**\n * Indicator bridge for framework bindings.\n */\n\nimport type { Chart } from \"../../core/chart/types\";\nimport type { StackedChart } from \"../../core/stacked/types\";\nimport {\n  addIndicatorToChart,\n  type AddIndicatorOptions,\n  type AddIndicatorResult,\n} from \"../../core/indicator/addIndicator\";\nimport type { IndicatorPresetName } from \"../../core/indicator/indicatorPresets\";\n\nexport type IndicatorHost = Chart | StackedChart | null;\n\nexport function isStackedChart(host: IndicatorHost): host is StackedChart {\n  return (\n    host != null &&\n    \"getPanes\" in host &&\n    typeof (host as StackedChart).getPanes === \"function\"\n  );\n}\n\nexport async function addIndicatorToHost(\n  host: IndicatorHost,\n  preset: IndicatorPresetName,\n  options: AddIndicatorOptions = {},\n): Promise<AddIndicatorResult & { paneId?: string }> {\n  if (!host) {\n    throw new Error(\n      \"[useIndicator] Chart is not ready. Wait for isReady before adding indicators.\",\n    );\n  }\n\n  if (isStackedChart(host)) {\n    const result = await host.addIndicator(preset, options);\n    return result;\n  }\n\n  return addIndicatorToChart(host, preset, options);\n}\n\nexport function removeIndicatorFromChart(\n  chart: Chart,\n  rootId: string,\n): void {\n  for (const s of [...chart.getAllSeries()]) {\n    const sid = s.getId();\n    if (sid === rootId || sid.startsWith(`${rootId}-`)) {\n      chart.removeSeries(sid);\n    }\n  }\n}\n","/**\n * Chart sync bridge for framework bindings.\n */\n\nimport {\n  ChartGroup,\n  createChartGroup,\n  type ChartLike,\n  type SyncOptions,\n} from \"../../core/sync\";\n\nexport interface ChartSyncHandle {\n  group: ChartGroup;\n  destroy: () => void;\n}\n\nexport function createChartSync(\n  charts: ChartLike[],\n  options?: SyncOptions,\n): ChartSyncHandle {\n  const group = createChartGroup(charts, options);\n  return {\n    group,\n    destroy: () => group.destroy(),\n  };\n}\n\nexport function updateChartSync(\n  handle: ChartSyncHandle | null,\n  charts: ChartLike[],\n  options?: SyncOptions,\n): ChartSyncHandle {\n  handle?.destroy();\n  if (charts.length < 2) {\n    return { group: new ChartGroup(options), destroy: () => {} };\n  }\n  return createChartSync(charts, options);\n}\n"],"names":["defaultResponsive","options","responsive","createChartLifecycle","container","callbacks","chart","createChart","onZoom","_a","resizeObserver","isStackedChart","host","addIndicatorToHost","preset","addIndicatorToChart","removeIndicatorFromChart","rootId","s","sid","createChartSync","charts","group","createChartGroup"],"mappings":";;;AAsBA,SAASA,EACPC,GACqB;AACrB,QAAMC,IAAaD,EAAQ,cAAc,EAAE,eAAe,OAAA;AAC1D,SAAO,EAAE,GAAGA,GAAS,YAAAC,EAAA;AACvB;AAEO,SAASC,EACdC,GACAH,GACAI,IAAqC,CAAA,GACf;AACtB,QAAMC,IAAQC,EAAY;AAAA,IACxB,GAAGP,EAAkBC,CAAO;AAAA,IAC5B,WAAAG;AAAA,EAAA,CACD,GAEKI,IAAS,MAAM;;AACnB,KAAAC,IAAAJ,EAAU,mBAAV,QAAAI,EAAA,KAAAJ,GAA2BC,EAAM;EACnC;AACA,EAAAA,EAAM,GAAG,QAAQE,CAAM;AAEvB,MAAIE;AACJ,SAAIT,EAAQ,eAAe,OACzBS,IAAiB,IAAI,eAAe,MAAM;AACxC,IAAAJ,EAAM,OAAA;AAAA,EACR,CAAC,GACDI,EAAe,QAAQN,CAAS,IAG3B;AAAA,IACL,OAAAE;AAAA,IACA,WAAW,MAAMA,EAAM,cAAA;AAAA,IACvB,SAAS,MAAM;AACb,MAAAI,KAAA,QAAAA,EAAgB,cAChBJ,EAAM,IAAI,QAAQE,CAAM,GACxBF,EAAM,QAAA;AAAA,IACR;AAAA,EAAA;AAEJ;AC9CO,SAASK,EAAeC,GAA2C;AACxE,SACEA,KAAQ,QACR,cAAcA,KACd,OAAQA,EAAsB,YAAa;AAE/C;AAEA,eAAsBC,EACpBD,GACAE,GACAb,IAA+B,CAAA,GACoB;AACnD,MAAI,CAACW;AACH,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAIJ,SAAID,EAAeC,CAAI,IACN,MAAMA,EAAK,aAAaE,GAAQb,CAAO,IAIjDc,EAAoBH,GAAME,GAAQb,CAAO;AAClD;AAEO,SAASe,EACdV,GACAW,GACM;AACN,aAAWC,KAAK,CAAC,GAAGZ,EAAM,aAAA,CAAc,GAAG;AACzC,UAAMa,IAAMD,EAAE,MAAA;AACd,KAAIC,MAAQF,KAAUE,EAAI,WAAW,GAAGF,CAAM,GAAG,MAC/CX,EAAM,aAAaa,CAAG;AAAA,EAE1B;AACF;ACpCO,SAASC,EACdC,GACApB,GACiB;AACjB,QAAMqB,IAAQC,EAAiBF,GAAQpB,CAAO;AAC9C,SAAO;AAAA,IACL,OAAAqB;AAAA,IACA,SAAS,MAAMA,EAAM,QAAA;AAAA,EAAQ;AAEjC;"}
+{"version":3,"file":"chartSyncBridge-C1uRy0ZS.js","sources":["../src/bindings/shared/chartLifecycle.ts","../src/bindings/shared/indicatorBridge.ts","../src/bindings/shared/chartSyncBridge.ts"],"sourcesContent":["/**\n * Framework-agnostic chart lifecycle helpers.\n */\n\nimport { createChart, type Chart } from \"../../core/Chart\";\nimport type { ChartOptions, Bounds } from \"../../types\";\nimport type { BindingChartOptions } from \"./types\";\n\nexport type ChartBindingOptions = Omit<ChartOptions, \"container\"> &\n  BindingChartOptions;\n\nexport interface ChartLifecycleHandle {\n  chart: Chart;\n  destroy: () => void;\n  getBounds: () => Bounds | null;\n}\n\nexport interface ChartLifecycleCallbacks {\n  onBoundsChange?: (bounds: Bounds) => void;\n  onError?: (error: Error) => void;\n}\n\nfunction defaultResponsive(\n  options: ChartBindingOptions,\n): ChartBindingOptions {\n  const responsive = options.responsive ?? { reducedMotion: \"auto\" as const };\n  return { ...options, responsive };\n}\n\nexport function createChartLifecycle(\n  container: HTMLDivElement,\n  options: ChartBindingOptions,\n  callbacks: ChartLifecycleCallbacks = {},\n): ChartLifecycleHandle {\n  const chart = createChart({\n    ...defaultResponsive(options),\n    container,\n  });\n\n  const onZoom = () => {\n    callbacks.onBoundsChange?.(chart.getViewBounds());\n  };\n  chart.on(\"zoom\", onZoom);\n\n  let resizeObserver: ResizeObserver | undefined;\n  if (options.autoResize !== false) {\n    resizeObserver = new ResizeObserver(() => {\n      chart.resize();\n    });\n    resizeObserver.observe(container);\n  }\n\n  return {\n    chart,\n    getBounds: () => chart.getViewBounds(),\n    destroy: () => {\n      resizeObserver?.disconnect();\n      chart.off(\"zoom\", onZoom);\n      chart.destroy();\n    },\n  };\n}\n\nexport function attachZoomListener(\n  chart: Chart,\n  onBoundsChange: (bounds: Bounds) => void,\n): () => void {\n  const handler = () => onBoundsChange(chart.getViewBounds());\n  chart.on(\"zoom\", handler);\n  return () => chart.off(\"zoom\", handler);\n}\n","/**\n * Indicator bridge for framework bindings.\n */\n\nimport type { Chart } from \"../../core/chart/types\";\nimport type { StackedChart } from \"../../core/stacked/types\";\nimport {\n  addIndicatorToChart,\n  type AddIndicatorOptions,\n  type AddIndicatorResult,\n} from \"../../core/indicator/addIndicator\";\nimport type { IndicatorPresetName } from \"../../core/indicator/indicatorPresets\";\n\nexport type IndicatorHost = Chart | StackedChart | null;\n\nexport function isStackedChart(host: IndicatorHost): host is StackedChart {\n  return (\n    host != null &&\n    \"getPanes\" in host &&\n    typeof (host as StackedChart).getPanes === \"function\"\n  );\n}\n\nexport async function addIndicatorToHost(\n  host: IndicatorHost,\n  preset: IndicatorPresetName,\n  options: AddIndicatorOptions = {},\n): Promise<AddIndicatorResult & { paneId?: string }> {\n  if (!host) {\n    throw new Error(\n      \"[useIndicator] Chart is not ready. Wait for isReady before adding indicators.\",\n    );\n  }\n\n  if (isStackedChart(host)) {\n    const result = await host.addIndicator(preset, options);\n    return result;\n  }\n\n  return addIndicatorToChart(host, preset, options);\n}\n\nexport function removeIndicatorFromChart(\n  chart: Chart,\n  rootId: string,\n): void {\n  for (const s of [...chart.getAllSeries()]) {\n    const sid = s.getId();\n    if (sid === rootId || sid.startsWith(`${rootId}-`)) {\n      chart.removeSeries(sid);\n    }\n  }\n}\n","/**\n * Chart sync bridge for framework bindings.\n */\n\nimport {\n  ChartGroup,\n  createChartGroup,\n  type ChartLike,\n  type SyncOptions,\n} from \"../../core/sync\";\n\nexport interface ChartSyncHandle {\n  group: ChartGroup;\n  destroy: () => void;\n}\n\nexport function createChartSync(\n  charts: ChartLike[],\n  options?: SyncOptions,\n): ChartSyncHandle {\n  const group = createChartGroup(charts, options);\n  return {\n    group,\n    destroy: () => group.destroy(),\n  };\n}\n\nexport function updateChartSync(\n  handle: ChartSyncHandle | null,\n  charts: ChartLike[],\n  options?: SyncOptions,\n): ChartSyncHandle {\n  handle?.destroy();\n  if (charts.length < 2) {\n    return { group: new ChartGroup(options), destroy: () => {} };\n  }\n  return createChartSync(charts, options);\n}\n"],"names":["defaultResponsive","options","responsive","createChartLifecycle","container","callbacks","chart","createChart","onZoom","_a","resizeObserver","isStackedChart","host","addIndicatorToHost","preset","addIndicatorToChart","removeIndicatorFromChart","rootId","s","sid","createChartSync","charts","group","createChartGroup"],"mappings":";;;AAsBA,SAASA,EACPC,GACqB;AACrB,QAAMC,IAAaD,EAAQ,cAAc,EAAE,eAAe,OAAA;AAC1D,SAAO,EAAE,GAAGA,GAAS,YAAAC,EAAA;AACvB;AAEO,SAASC,EACdC,GACAH,GACAI,IAAqC,CAAA,GACf;AACtB,QAAMC,IAAQC,EAAY;AAAA,IACxB,GAAGP,EAAkBC,CAAO;AAAA,IAC5B,WAAAG;AAAA,EAAA,CACD,GAEKI,IAAS,MAAM;;AACnB,KAAAC,IAAAJ,EAAU,mBAAV,QAAAI,EAAA,KAAAJ,GAA2BC,EAAM;EACnC;AACA,EAAAA,EAAM,GAAG,QAAQE,CAAM;AAEvB,MAAIE;AACJ,SAAIT,EAAQ,eAAe,OACzBS,IAAiB,IAAI,eAAe,MAAM;AACxC,IAAAJ,EAAM,OAAA;AAAA,EACR,CAAC,GACDI,EAAe,QAAQN,CAAS,IAG3B;AAAA,IACL,OAAAE;AAAA,IACA,WAAW,MAAMA,EAAM,cAAA;AAAA,IACvB,SAAS,MAAM;AACb,MAAAI,KAAA,QAAAA,EAAgB,cAChBJ,EAAM,IAAI,QAAQE,CAAM,GACxBF,EAAM,QAAA;AAAA,IACR;AAAA,EAAA;AAEJ;AC9CO,SAASK,EAAeC,GAA2C;AACxE,SACEA,KAAQ,QACR,cAAcA,KACd,OAAQA,EAAsB,YAAa;AAE/C;AAEA,eAAsBC,EACpBD,GACAE,GACAb,IAA+B,CAAA,GACoB;AACnD,MAAI,CAACW;AACH,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAIJ,SAAID,EAAeC,CAAI,IACN,MAAMA,EAAK,aAAaE,GAAQb,CAAO,IAIjDc,EAAoBH,GAAME,GAAQb,CAAO;AAClD;AAEO,SAASe,EACdV,GACAW,GACM;AACN,aAAWC,KAAK,CAAC,GAAGZ,EAAM,aAAA,CAAc,GAAG;AACzC,UAAMa,IAAMD,EAAE,MAAA;AACd,KAAIC,MAAQF,KAAUE,EAAI,WAAW,GAAGF,CAAM,GAAG,MAC/CX,EAAM,aAAaa,CAAG;AAAA,EAE1B;AACF;ACpCO,SAASC,EACdC,GACApB,GACiB;AACjB,QAAMqB,IAAQC,EAAiBF,GAAQpB,CAAO;AAC9C,SAAO;AAAA,IACL,OAAAqB;AAAA,IACA,SAAS,MAAMA,EAAM,QAAA;AAAA,EAAQ;AAEjC;"}

package/dist/core/chart/ChartCore.d.ts

@@ -17,6 +17,7 @@ export declare class ChartImpl implements Chart {
     private container;
     private webglCanvas;
     private overlayCanvas;
+    private svgRoot;
     private overlayCtx;
     series: Map<string, Series>;
     events: EventEmitter<ChartEventMap>;
@@ -141,7 +142,7 @@ export declare class ChartImpl implements Chart {
     private getInteractedBounds;
     exportImage(type?: "png" | "jpeg"): string;
     setFeatureHooks(hooks: ChartFeatureHooks | null): void;
-    exportSVG(): string;
+    exportSVG(_options?: import('./exporter/SVGExporter').SVGExportOptions): string;
     private getSeriesContext;
     addSeries(options: SeriesOptions | HeatmapOptions): void;
     addBar(options: Omit<SeriesOptions, "type">): void;
@@ -235,8 +236,11 @@ export declare class ChartImpl implements Chart {
      * Get current device pixel ratio
      */
     getDPR(): number;
-    /** Runtime chart renderer backend in use. */
-    getActiveRenderer(): "webgl" | "webgpu";
+    getActiveRenderer(): "webgl" | "webgpu" | "svg";
+    /** Series id hovered from the legend — affects draw order in canvas and live SVG. */
+    getHoveredSeriesId(): string | null;
+    /** @internal Vector frame for `renderer: 'svg'` — patched on extended bundles. */
+    buildSVGFrame(): string;
     /**
      * Set device pixel ratio and re-render
      */

package/dist/core/chart/ChartRenderLoop.d.ts

@@ -50,6 +50,11 @@ export interface RenderLoopContext {
         direction?: string;
     }>;
     get yScale(): Scale;
+    /** Live SVG renderer root (when `renderer: 'svg'`). */
+    svgRoot?: SVGSVGElement | null;
+    /** Produce full SVG document string for vector renderer mode. */
+    buildSVGFrame?: () => string;
+    getActiveRenderer?: () => "webgl" | "webgpu" | "svg";
 }
 export declare class ChartRenderLoop {
     private ctx;

package/dist/core/chart/ChartRenderer.d.ts

@@ -7,6 +7,10 @@ import { OverlayRenderer } from '../OverlayRenderer';
 import { EventEmitter } from '../EventEmitter';
 import { SelectionManager } from '../selection';
 
+/** Match series/render ids related to a hovered legend entry (incl. candlestick splits). */
+export declare function matchesHoveredSeriesId(id: string, hoveredSeriesId: string): boolean;
+/** Move hovered series (and related ids) to the end so they paint on top. */
+export declare function reorderForHoveredSeries<T>(items: T[], hoveredSeriesId: string | null, getId: (item: T) => string): T[];
 export interface RenderContext {
     webglCanvas: HTMLCanvasElement;
     overlayCanvas: HTMLCanvasElement;
@@ -47,7 +51,12 @@ export interface RenderContext {
         price: number;
         direction?: string;
     }>;
+    getActiveRenderer?: () => "webgl" | "webgpu" | "svg";
+    /** When true, overlay draws only interactive UI (cursor, tooltips, plugins). */
+    vectorOverlayOnly?: boolean;
 }
+/** Map view bounds to pixel ranges — required before SVG export / vector frame build. */
+export declare function syncScalesForRender(plotArea: PlotArea, viewBounds: Bounds, xScale: Scale, yScales: Map<string, Scale>, yAxisOptionsMap: Map<string, AxisOptions>, xAxisOptions: AxisOptions, primaryYAxisId: string, layout: import('../layout').LayoutOptions): void;
 /**
  * Prepare series data for WebGL rendering
  */

package/dist/core/chart/ChartSetup.d.ts

@@ -20,6 +20,7 @@ export interface SetupResult {
     webglCanvas: HTMLCanvasElement;
     overlayCanvas: HTMLCanvasElement;
     overlayCtx: CanvasRenderingContext2D;
+    svgRoot: SVGSVGElement | null;
     layout: LayoutOptions;
 }
 /**

package/dist/core/chart/exporter/SVGExporter.d.ts

@@ -1,11 +1,13 @@
 import { Series } from '../../Series';
-import { AxisOptions, Bounds, PlotArea } from '../../../types';
+import { Bounds, PlotArea } from '../../../types';
 import { Scale } from '../../../scales';
 import { ChartTheme } from '../../../theme';
+import { SVGExportOptions, SVGExportInput, captureLayoutSnapshot } from './svg/SVGExportContext';
 
-export interface SVGExportOptions {
-    xAxis?: AxisOptions;
-    yAxis?: AxisOptions;
-    primaryYAxisId?: string;
-}
-export declare function exportToSVG(series: Series[], _viewBounds: Bounds, plotArea: PlotArea, xAxis: Scale, yAxes: Map<string, Scale>, theme: ChartTheme, width: number, height: number, axisOptions?: SVGExportOptions): string;
+export type { SVGExportOptions } from './svg/SVGExportContext';
+export { captureLayoutSnapshot, buildSVGExportContext } from './svg/SVGExportContext';
+export { renderSVG } from './svg/SVGOrchestrator';
+/** @deprecated Use buildSVGExportContext + renderSVG */
+export declare function exportToSVG(series: Series[], viewBounds: Bounds, plotArea: PlotArea, xAxis: Scale, yAxes: Map<string, Scale>, theme: ChartTheme, width: number, height: number, axisOptions?: SVGExportOptions): string;
+export declare function exportChartToSVG(input: SVGExportInput): string;
+export declare function exportChartSnapshot(chart: Parameters<typeof captureLayoutSnapshot>[0], options?: SVGExportOptions): string;

package/dist/core/chart/exporter/svg/SVGDocumentBuilder.d.ts

@@ -0,0 +1,27 @@
+/**
+ * SVG document construction utilities — XML escape, defs, gradients, clipPaths.
+ */
+export declare function escapeXml(text: string): string;
+export declare function fmt(n: number, decimals?: number): string;
+export declare class SVGDocumentBuilder {
+    private width;
+    private height;
+    private fontFamily;
+    private defs;
+    private layers;
+    constructor(width: number, height: number, fontFamily: string);
+    resetGradientCounter(): void;
+    addDef(content: string): string;
+    registerLinearGradient(x1: number, y1: number, x2: number, y2: number, stops: Array<{
+        offset: string;
+        color: string;
+        opacity?: number;
+    }>): string;
+    registerClipPath(id: string, content: string): void;
+    registerArrowMarker(id: string, color: string): void;
+    push(layer: string, element: string): void;
+    pushRaw(element: string): void;
+    openGroup(layer: string, transform?: string, attrs?: Record<string, string>): string;
+    closeGroup(layer: string): void;
+    build(backgroundColor: string, ariaLabel?: string): string;
+}

package/dist/core/chart/exporter/svg/SVGExportContext.d.ts

@@ -0,0 +1,147 @@
+import { Series } from '../../../Series';
+import { Scale } from '../../../../scales';
+import { ChartTheme } from '../../../../theme';
+import { AxisOptions, Bounds, PlotArea } from '../../../../types';
+import { ChartTitleOptions } from '../../../layout/types';
+import { LayoutOptions } from '../../../layout';
+import { BusinessDayMapping } from '../../../time/TimeScale';
+import { SVGExportPluginContext } from './plugins/types';
+
+export interface SVGExportOptions {
+    xAxis?: AxisOptions;
+    yAxis?: AxisOptions;
+    primaryYAxisId?: string;
+    /** Include plugin overlays (annotations, regression, etc.) */
+    includeOverlays?: boolean;
+    /** Include legend in SVG */
+    includeLegend?: boolean;
+    /** Include annotation plugin content */
+    includeAnnotations?: boolean;
+    /** Include crosshair at capture position */
+    includeCursor?: boolean;
+    /** Include selection rectangle */
+    includeSelection?: boolean;
+    /** Export state at specific timestamp (replay) */
+    at?: number;
+    /** Optional watermark text (snapshot / export) */
+    watermarkText?: string;
+    /** Embed web fonts in defs (P2) */
+    embedFonts?: boolean;
+    /** Accessible label for root SVG */
+    ariaLabel?: string;
+    /** 3D export mode — deferred */
+    svgExport3DMode?: "raster" | "project";
+    /** Legacy raster fallback during development */
+    svgExportMode?: "vector" | "legacy-raster";
+}
+export interface YAxisLayoutEntry {
+    id: string;
+    scale: Scale;
+    options?: AxisOptions;
+    position: "left" | "right";
+    offset: number;
+}
+export interface CursorSnapshot {
+    x: number;
+    y: number;
+}
+export interface SelectionSnapshot {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface PriceAlertSnapshot {
+    price: number;
+    direction?: string;
+}
+export interface SVGExportContext {
+    series: Series[];
+    viewBounds: Bounds;
+    plotArea: PlotArea;
+    xScale: Scale;
+    yAxes: Map<string, Scale>;
+    yAxisLayouts: YAxisLayoutEntry[];
+    theme: ChartTheme;
+    width: number;
+    height: number;
+    xAxisOptions?: AxisOptions;
+    yAxisOptionsMap: Map<string, AxisOptions>;
+    primaryYAxisId?: string;
+    titleOptions?: ChartTitleOptions;
+    layout: LayoutOptions;
+    businessDayMapping?: BusinessDayMapping | null;
+    showLegend: boolean;
+    legendSeries: Series[];
+    cursor?: CursorSnapshot | null;
+    selection?: SelectionSnapshot | null;
+    alerts?: PriceAlertSnapshot[];
+    options: SVGExportOptions;
+    pluginContexts: SVGExportPluginContext[];
+    pluginManager?: {
+        get: (name: string) => import('../../../../plugins/types').ChartPlugin | undefined;
+        notifyExportSVG?: (ctx: SVGExportPluginContext) => void;
+    };
+}
+export interface SVGExportInput {
+    series: Series[];
+    viewBounds: Bounds;
+    plotArea: PlotArea;
+    xScale: Scale;
+    yAxes: Map<string, Scale>;
+    theme: ChartTheme;
+    width: number;
+    height: number;
+    options?: SVGExportOptions;
+    xAxisOptions?: AxisOptions;
+    yAxisOptionsMap?: Map<string, AxisOptions>;
+    primaryYAxisId?: string;
+    titleOptions?: ChartTitleOptions;
+    layout?: LayoutOptions;
+    businessDayMapping?: BusinessDayMapping | null;
+    showLegend?: boolean;
+    cursor?: CursorSnapshot | null;
+    selection?: SelectionSnapshot | null;
+    alerts?: PriceAlertSnapshot[];
+    pluginContexts?: SVGExportPluginContext[];
+    pluginManager?: SVGExportContext["pluginManager"];
+}
+/** Build Y-axis layout entries with left/right offsets matching OverlayRenderer. */
+export declare function buildYAxisLayouts(_plotArea: PlotArea, yAxes: Map<string, Scale>, yAxisOptionsMap: Map<string, AxisOptions>, primaryYAxisId?: string): YAxisLayoutEntry[];
+export declare function buildSVGExportContext(input: SVGExportInput): SVGExportContext;
+/** Capture layout snapshot from a live ChartImpl instance. */
+export declare function captureLayoutSnapshot(chart: {
+    getAllSeries: () => Series[];
+    viewBounds: Bounds;
+    getPlotArea: () => PlotArea;
+    xScale: Scale;
+    yScales: Map<string, Scale>;
+    theme: ChartTheme;
+    container: HTMLElement;
+    xAxisOptions: AxisOptions;
+    yAxisOptionsMap: Map<string, AxisOptions>;
+    primaryYAxisId: string;
+    getLayout?: () => LayoutOptions;
+    getBusinessDayMapping?: () => BusinessDayMapping | null;
+    showLegend?: boolean;
+    getCursorPosition?: () => {
+        x: number;
+        y: number;
+    } | null;
+    selectionRect?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    getAlerts?: () => Array<{
+        price: number;
+        direction?: string;
+    }>;
+    getHoveredSeriesId?: () => string | null;
+    pluginManager?: {
+        get: (name: string) => unknown;
+        notifyExportSVG?: (ctx: SVGExportPluginContext) => void;
+    };
+    titleOptions?: ChartTitleOptions;
+}, exportOptions?: SVGExportOptions): SVGExportContext;

package/dist/core/chart/exporter/svg/SVGOrchestrator.d.ts

@@ -0,0 +1,3 @@
+import { SVGExportContext } from './SVGExportContext';
+
+export declare function renderSVG(ctx: SVGExportContext): string;

package/dist/core/chart/exporter/svg/SVGThemeAdapter.d.ts

@@ -0,0 +1,22 @@
+import { ChartTheme } from '../../../../theme';
+
+export declare function dashArrayToSvg(dash: number[] | undefined): string | undefined;
+export interface SvgStrokeStyle {
+    stroke: string;
+    strokeWidth: number;
+    strokeOpacity?: number;
+    strokeDasharray?: string;
+}
+export interface SvgTextStyle {
+    fill: string;
+    fontSize: number;
+    fontFamily: string;
+    fontWeight?: string | number;
+}
+export declare function gridMajorStyle(theme: ChartTheme): SvgStrokeStyle;
+export declare function gridMinorStyle(theme: ChartTheme): SvgStrokeStyle;
+export declare function axisLineStyle(theme: ChartTheme, orientation: "x" | "y"): SvgStrokeStyle;
+export declare function axisTickStyle(theme: ChartTheme, orientation: "x" | "y"): SvgStrokeStyle;
+export declare function axisLabelStyle(theme: ChartTheme, orientation: "x" | "y"): SvgTextStyle;
+export declare function strokeAttrs(style: SvgStrokeStyle): string;
+export declare function textAttrs(style: SvgTextStyle, anchor?: string, baseline?: string): string;

package/dist/core/chart/exporter/svg/__tests__/testFixtures.d.ts

@@ -0,0 +1,46 @@
+import { LinearScale } from '../../../../../scales';
+import { Series } from '../../../../Series';
+import { ChartTheme } from '../../../../../theme';
+import { Annotation } from '../../../../annotations/types';
+import { SVGExportInput } from '../SVGExportContext';
+
+export declare const testTheme: ChartTheme;
+export declare function testScales(): {
+    xScale: LinearScale;
+    yScale: LinearScale;
+};
+export declare function mockSeries(type: string, overrides?: Partial<{
+    id: string;
+    data: Record<string, Float32Array | Float32Array[]>;
+    style: Record<string, unknown>;
+    visible: boolean;
+    yAxisId: string;
+    heatmapData: {
+        xValues: Float32Array;
+        yValues: Float32Array;
+        zValues: Float32Array;
+    };
+    polarData: {
+        r: Float32Array;
+        theta: Float32Array;
+    };
+    gaugeData: {
+        value: number;
+        min: number;
+        max: number;
+    };
+    sankeyData: {
+        nodes: string[];
+        links: Array<{
+            source: string;
+            target: string;
+            value: number;
+        }>;
+    };
+    indicatorOptions: Record<string, unknown>;
+    hasError: boolean;
+    markers: unknown[];
+}>): Series;
+export declare function seriesFixtures(): Record<string, Series>;
+export declare function buildTestContext(series: Series[], extra?: Partial<SVGExportInput>): import('../SVGExportContext').SVGExportContext;
+export declare const sampleAnnotations: Annotation[];

package/dist/core/chart/exporter/svg/__tests__/visualTestUtils.d.ts

@@ -0,0 +1,12 @@
+export declare function fixturesPath(name: string): string;
+/** Normalize volatile SVG ids for golden string comparison. */
+export declare function normalizeSvg(svg: string): string;
+export declare function rasterizeSvg(svg: string, width?: number): Buffer;
+export declare function readGoldenText(name: string): string;
+export declare function readGoldenPng(name: string): Buffer;
+export declare function writeGolden(name: string, data: string | Buffer): void;
+export declare function updateGoldenEnabled(): boolean;
+export declare function assertGoldenText(name: string, actual: string): void;
+export declare function assertGoldenPng(name: string, actual: Buffer, maxDiffRatio?: number): void;
+export declare function comparePngBuffers(actual: Buffer, expected: Buffer, maxDiffRatio?: number): number;
+export declare function decodeDataUrlPng(dataUrl: string): Buffer;

package/dist/core/chart/exporter/svg/overlay/axes.d.ts

@@ -0,0 +1,4 @@
+import { SVGExportContext } from '../SVGExportContext';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+export declare function exportAxes(ctx: SVGExportContext, builder: SVGDocumentBuilder): void;

package/dist/core/chart/exporter/svg/overlay/border.d.ts

@@ -0,0 +1,4 @@
+import { SVGExportContext } from '../SVGExportContext';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+export declare function exportPlotBorder(ctx: SVGExportContext, builder: SVGDocumentBuilder): void;