@meonode/canvas 1.7.0 → 1.7.2

package/dist/cjs/canvas/root.canvas.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"root.canvas.util.js","sources":["../../../../src/canvas/root.canvas.util.ts"],"sourcesContent":["import { Canvas, FontLibrary, type CanvasRenderingContext2D } from 'skia-canvas'\nimport type { ExportFormat, ExportOptions, SaveOptions, RenderOptions } from 'skia-canvas'\nimport { ColumnNode, BoxNode, RowNode } from '@/canvas/layout.canvas.util.js'\nimport type { BaseProps, RootProps, CanvasElement } from '@/canvas/canvas.type.js'\nimport type { CanvasCallMethod, CallArgs, CallResult, WorkerCallRequest, WorkerResponse, WorkerRequest } from '@/canvas/worker.types.js'\nimport { ImageNode, type RenderImageCache } from '@/canvas/image.canvas.util.js'\nimport { TextNode } from '@/canvas/text.canvas.util.js'\nimport { ChartNode } from '@/canvas/chart.canvas.util.js'\nimport { GridNode, GridItemNode } from '@/canvas/grid.canvas.util.js'\nimport { Style } from '@/constant/common.const.js'\nimport { WorkerPreProcessor } from '@/canvas/canvas.helper.js'\nimport * as path from 'node:path'\nimport * as fs from 'node:fs'\nimport { cpus } from 'node:os'\nimport { Worker } from 'node:worker_threads'\nimport { fileURLToPath } from 'node:url'\n\n/** Registry to track fonts that have already been loaded */\nconst registeredFonts = new Map<string, Set<string>>()\n\n// Exported for testing purposes only\nexport const _clearRegisteredFonts = () => {\n  registeredFonts.clear()\n}\n\n/** Engine configuration */\nlet _workerMode = true\nlet _workerPoolSize = Math.max(1, cpus().length - 1)\nlet _workerPool: WorkerPool | null = null\n\nexport interface CanvasEngineConfig {\n  /** Run rendering in worker threads to avoid blocking the event loop (default: true) */\n  workerMode?: boolean\n  /** Number of worker threads in the pool (default: os.cpus().length - 1) */\n  workers?: number\n}\n\n/**\n * Configure the canvas rendering engine.\n * Call this once at application startup before rendering.\n */\nexport function configure(options: CanvasEngineConfig) {\n  if (options.workerMode !== undefined) _workerMode = options.workerMode\n  if (options.workers !== undefined) _workerPoolSize = options.workers\n  if (_workerMode) {\n    _workerPool = new WorkerPool(_workerPoolSize)\n  }\n}\n\ninterface PendingTask {\n  resolve: (value: unknown) => void\n  reject: (err: Error) => void\n}\n\ninterface PoolRenderResult {\n  buffer: Buffer\n  canvasId: number\n  workerIdx: number\n  width: number\n  height: number\n}\n\n/**\n * Proxies all skia-canvas Canvas APIs to a Canvas instance living inside a worker thread.\n * Sync methods (toBufferSync, toURLSync) return from a pre-encoded PNG buffer.\n * Async methods (toBuffer, toURL, toFile, getters) delegate to the worker.\n */\nclass WorkerCanvas {\n  readonly width: number\n  readonly height: number\n  private readonly _buffer: Buffer // pre-encoded PNG for sync use\n  private readonly _pool: WorkerPool\n  private readonly _workerIdx: number\n  private readonly _canvasId: number\n\n  constructor(opts: PoolRenderResult & { pool: WorkerPool }) {\n    this._buffer = opts.buffer\n    this.width = opts.width\n    this.height = opts.height\n    this._pool = opts.pool\n    this._workerIdx = opts.workerIdx\n    this._canvasId = opts.canvasId\n  }\n\n  private _call<M extends CanvasCallMethod>(method: M, ...args: CallArgs<M>): Promise<CallResult<M>> {\n    return this._pool.callOnCanvas(this._workerIdx, this._canvasId, method, args)\n  }\n\n  // --- Sync methods: return from pre-encoded PNG buffer ---\n\n  toBufferSync(_format?: ExportFormat, _options?: ExportOptions): Buffer {\n    return this._buffer\n  }\n\n  toURLSync(_format?: ExportFormat, _options?: ExportOptions): string {\n    return `data:image/png;base64,${this._buffer.toString('base64')}`\n  }\n\n  // --- Async methods: delegate to worker ---\n\n  toBuffer(format: ExportFormat, options?: ExportOptions): Promise<Buffer> {\n    return this._call('toBuffer', format, options)\n  }\n\n  toURL(format: ExportFormat, options?: ExportOptions): Promise<string> {\n    return this._call('toURL', format, options)\n  }\n\n  toFile(filename: string, options?: SaveOptions): Promise<void> {\n    return this._call('toFile', filename, options)\n  }\n\n  /** Returns a Buffer (Sharp instance cannot be transferred across threads) */\n  toSharp(options?: RenderOptions): Promise<Buffer> {\n    return this._call('toSharp', options)\n  }\n\n  toSharpSync(_options?: RenderOptions): never {\n    throw new Error('[canvas] toSharpSync() is not available in worker mode — use toSharp() instead')\n  }\n\n  // --- Async convenience getters ---\n\n  get png(): Promise<Buffer> {\n    return this._call('toBuffer', 'png')\n  }\n  get webp(): Promise<Buffer> {\n    return this._call('toBuffer', 'webp')\n  }\n  get jpg(): Promise<Buffer> {\n    return this._call('toBuffer', 'jpg')\n  }\n  get svg(): Promise<Buffer> {\n    return this._call('toBuffer', 'svg')\n  }\n  get pdf(): Promise<Buffer> {\n    return this._call('toBuffer', 'pdf')\n  }\n  get raw(): Promise<Buffer> {\n    return this._call('toBuffer', 'raw')\n  }\n\n  /** Release the Canvas from worker memory. Call when done with this object. */\n  release(): void {\n    this._pool.releaseCanvas(this._workerIdx, this._canvasId)\n  }\n}\n\n/** Worker thread pool — routes render and canvas-call messages */\nclass WorkerPool {\n  private workers: Worker[] = []\n  private idle: Worker[] = []\n  private queue: Array<{ id: number; props: RootProps }> = []\n  private pending = new Map<number, PendingTask>()\n  private nextId = 0\n\n  constructor(size: number) {\n    this.init(size)\n  }\n\n  private init(size: number) {\n    const workerFile = path.join(path.dirname(fileURLToPath(import.meta.url)), '../render.worker.js')\n\n    for (let i = 0; i < size; i++) {\n      const workerIdx = i\n      const worker = new Worker(workerFile)\n      worker.on('message', (msg: WorkerResponse) => {\n        const task = this.pending.get(msg.taskId)\n        if (!task) return\n        this.pending.delete(msg.taskId)\n\n        if ('error' in msg) {\n          task.reject(new Error(msg.error))\n          return\n        }\n\n        if ('canvasId' in msg) {\n          // Render complete — put worker back to idle\n          this.idle.push(worker)\n          this.drain()\n          const result: PoolRenderResult = { buffer: msg.buffer, canvasId: msg.canvasId, workerIdx, width: msg.width, height: msg.height }\n          task.resolve(result)\n        } else {\n          // Canvas method call complete\n          task.resolve(msg.result)\n        }\n      })\n      this.workers.push(worker)\n      this.idle.push(worker)\n    }\n  }\n\n  private drain() {\n    while (this.queue.length > 0 && this.idle.length > 0) {\n      const task = this.queue.shift()!\n      const worker = this.idle.pop()!\n      const request: WorkerRequest = { type: 'render', taskId: task.id, props: task.props }\n      worker.postMessage(request)\n    }\n  }\n\n  render(props: RootProps): Promise<PoolRenderResult> {\n    const sanitizedProps = WorkerPreProcessor.process(props)\n    return new Promise<PoolRenderResult>((resolve, reject) => {\n      const id = this.nextId++\n      this.pending.set(id, { resolve: resolve as (v: unknown) => void, reject })\n      if (this.idle.length > 0) {\n        const worker = this.idle.pop()!\n        const request: WorkerRequest = { type: 'render', taskId: id, props: sanitizedProps }\n        worker.postMessage(request)\n      } else {\n        this.queue.push({ id, props: sanitizedProps })\n      }\n    })\n  }\n\n  callOnCanvas<M extends CanvasCallMethod>(workerIdx: number, canvasId: number, method: M, args: CallArgs<M>): Promise<CallResult<M>> {\n    return new Promise<CallResult<M>>((resolve, reject) => {\n      const id = this.nextId++\n      this.pending.set(id, { resolve: resolve as (v: unknown) => void, reject })\n      const request = { type: 'call' as const, taskId: id, canvasId, method, args } as WorkerCallRequest\n      this.workers[workerIdx].postMessage(request)\n    })\n  }\n\n  releaseCanvas(workerIdx: number, canvasId: number): void {\n    const request: WorkerRequest = { type: 'release', canvasId }\n    this.workers[workerIdx]?.postMessage(request)\n  }\n\n  terminate() {\n    this.workers.forEach(w => w.terminate())\n  }\n}\n\n/**\n * Converts a CanvasElement tree into actual BoxNode instances.\n * Used both for non-worker rendering (inline tree building) and inside\n * the render worker (reconstructing the tree from serialized descriptors).\n */\nexport function buildTree(descriptor: CanvasElement): BoxNode {\n  switch (descriptor.__type) {\n    case 'Box':\n      return new BoxNode({ ...descriptor.props, children: descriptor.children?.map(buildTree) })\n    case 'Column':\n      return new ColumnNode({ ...descriptor.props, children: descriptor.children?.map(buildTree) })\n    case 'Row':\n      return new RowNode({ ...descriptor.props, children: descriptor.children?.map(buildTree) })\n    case 'Grid':\n      return new GridNode({ ...descriptor.props, children: descriptor.children?.map(buildTree) as any })\n    case 'GridItem':\n      return new GridItemNode({ ...descriptor.props, children: descriptor.children?.map(buildTree) as any })\n    case 'Image':\n      return new ImageNode(descriptor.props as any)\n    case 'Text':\n      return new TextNode(descriptor.text, descriptor.props)\n    case 'Chart':\n      return new ChartNode(descriptor.props as any)\n  }\n}\n\n/**\n * Root node that manages the canvas rendering context and coordinates overall layout and drawing.\n * Inherits from ColumnNode to provide vertical layout capabilities.\n */\nexport class RootNode extends ColumnNode {\n  /** The canvas instance used for rendering */\n  private canvas: Canvas | undefined\n  /** The 2D rendering context for the canvas */\n  private ctx: CanvasRenderingContext2D | null = null\n  /** Target width for the canvas in pixels */\n  private readonly targetWidth: number\n  /** Target height for the canvas in pixels */\n  private readonly targetHeight: number\n  /** Scale factor for rendering (e.g. 2 for 2x resolution) */\n  private readonly scale: number\n\n  /**\n   * Creates a new root node for canvas rendering\n   * @param props Configuration properties for the root node\n   * @throws Error if width property is not provided\n   */\n  constructor(props: RootProps & BaseProps) {\n    // Call the parent constructor with root name and props\n    super({ name: 'Root', ...props })\n\n    this.props = props\n\n    // Validate the required width property\n    if (!props.width) {\n      throw new Error('Width and height are required for Root')\n    }\n\n    // Register provided fonts with caching\n    if (props.fonts?.length) {\n      for (const font of props.fonts) {\n        const family = font.family\n        const paths = font.paths.map(p => path.resolve(p))\n\n        if (!registeredFonts.has(family)) {\n          registeredFonts.set(family, new Set())\n        }\n\n        const cachedPaths = registeredFonts.get(family)!\n        const newPaths = paths.filter(p => !cachedPaths.has(p) && fs.existsSync(p))\n\n        if (newPaths.length > 0) {\n          FontLibrary.use({ [family]: newPaths })\n          newPaths.forEach(p => cachedPaths.add(p))\n        }\n      }\n    }\n\n    // Set up scale and width\n    this.scale = props.scale || 1\n    this.targetWidth = props.width\n    this.targetHeight = props.height\n    this.node.setWidth(this.targetWidth)\n\n    // Convert any CanvasElement children to actual BoxNode instances\n    if (this.props.children) {\n      const childArray = Array.isArray(this.props.children) ? this.props.children : [this.props.children]\n      this.props.children = childArray.map(child => {\n        if (child && typeof child === 'object' && '__type' in child) {\n          return buildTree(child as CanvasElement)\n        }\n        return child\n      }) as any\n    }\n\n    // Initialize children nodes\n    this.processInitialChildren()\n  }\n\n  /**\n   * Traverses the node tree to find all ImageNode instances using breadth-first search\n   * @returns Array of all ImageNode instances found in the tree\n   */\n  private findAllImageNodes(): ImageNode[] {\n    const imageNodes: ImageNode[] = []\n    const queue: BoxNode[] = [this]\n    while (queue.length > 0) {\n      const node = queue.shift()!\n      if (node instanceof ImageNode) {\n        imageNodes.push(node)\n      }\n      queue.push(...node.children)\n    }\n    return imageNodes\n  }\n\n  /**\n   * Renders the entire node tree to a canvas, handling image loading, layout calculation,\n   * and final drawing\n   * @returns Promise resolving to the rendered Canvas instance\n   */\n  async render(): Promise<Canvas> {\n    // Step 1: Load all images with a concurrency limit to avoid overwhelming remote sources.\n    // A per-render cache deduplicates identical src+color combinations within this render pass.\n    const imageNodes = this.findAllImageNodes()\n    if (imageNodes.length > 0) {\n      const imageCache: RenderImageCache = new Map()\n      const CONCURRENCY = 5\n      const queue = [...imageNodes]\n      const workers = Array.from({ length: Math.min(CONCURRENCY, queue.length) }, async () => {\n        while (queue.length > 0) {\n          const node = queue.shift()!\n          await node.load(imageCache)\n        }\n      })\n      await Promise.allSettled(workers)\n    }\n\n    // Step 2: Calculate initial layout\n    this.node.calculateLayout(this.targetWidth, undefined, Style.Direction.LTR)\n\n    // Step 3: Allow nodes to finalize their layout\n    const needRecalculate = this.finalizeLayout()\n    if (needRecalculate) {\n      this.node.calculateLayout(this.targetWidth, undefined, Style.Direction.LTR)\n    }\n\n    // Step 4: Create a canvas with calculated dimensions\n    const calculatedContentHeight = this.node.getComputedHeight()\n    const finalCanvasWidth = Math.ceil(this.targetWidth * this.scale)\n    const finalCanvasHeight = this.targetHeight ? Math.ceil(this.targetHeight * this.scale) : Math.max(1, Math.ceil(calculatedContentHeight * this.scale))\n\n    // Step 5: Set up canvas context\n    this.canvas = new Canvas(finalCanvasWidth, finalCanvasHeight)\n    this.ctx = this.canvas.getContext('2d')\n    this.ctx.scale(this.scale, this.scale)\n\n    // Step 6: Render content\n    super.render(this.ctx, 0, 0)\n\n    if (!this.canvas) {\n      throw new Error('Canvas not initialized')\n    }\n\n    return this.canvas\n  }\n}\n\n/**\n * Creates and renders a new root node with the given properties.\n * When worker mode is enabled via configure(), rendering runs in a worker thread\n * and the returned object implements the same toBuffer/toBufferSync interface.\n * @param props Configuration properties for the root node\n * @returns Promise resolving to the rendered Canvas (or WorkerCanvas in worker mode)\n */\nexport const Root = async (props: RootProps): Promise<Canvas> => {\n  if (_workerMode) {\n    if (!_workerPool) {\n      _workerPool = new WorkerPool(_workerPoolSize)\n    }\n    const result = await _workerPool.render(props)\n    return new WorkerCanvas({ ...result, pool: _workerPool }) as unknown as Canvas\n  }\n  return new RootNode(props).render()\n}\n"],"names":["cpus","path","fileURLToPath","Worker","WorkerPreProcessor","BoxNode","ColumnNode","RowNode","GridNode","GridItemNode","ImageNode","TextNode","ChartNode","fs","FontLibrary","Style","Canvas"],"mappings":"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"}
+{"version":3,"file":"root.canvas.util.js","sources":["../../../../src/canvas/root.canvas.util.ts"],"sourcesContent":["import { Canvas, FontLibrary, type CanvasRenderingContext2D } from 'skia-canvas'\nimport type { ExportFormat, ExportOptions, SaveOptions, RenderOptions } from 'skia-canvas'\nimport { ColumnNode, BoxNode, RowNode } from '@/canvas/layout.canvas.util.js'\nimport type { BaseProps, RootProps, CanvasElement } from '@/canvas/canvas.type.js'\nimport type { CanvasCallMethod, CallArgs, CallResult, WorkerCallRequest, WorkerResponse, WorkerRequest } from '@/worker/worker.types.js'\nimport { ImageNode, type RenderImageCache, disposeImageCache, getImageCache } from '@/canvas/image.canvas.util.js'\nimport { TextNode } from '@/canvas/text.canvas.util.js'\nimport { ChartNode } from '@/canvas/chart.canvas.util.js'\nimport { GridNode, GridItemNode } from '@/canvas/grid.canvas.util.js'\nimport { Style } from '@/constant/common.const.js'\nimport { WorkerPreProcessor } from '@/canvas/canvas.helper.js'\nimport * as path from 'node:path'\nimport * as fs from 'node:fs'\nimport { cpus } from 'node:os'\nimport { Worker } from 'node:worker_threads'\nimport { fileURLToPath } from 'node:url'\n\n/** Registry to track fonts that have already been loaded */\nconst registeredFonts = new Map<string, Set<string>>()\n\n// Exported for testing purposes only\nexport const _clearRegisteredFonts = () => {\n  registeredFonts.clear()\n}\n\n/** Engine configuration */\nlet _workerMode = true\nlet _workerPoolSize = Math.max(1, cpus().length - 1)\nlet _workerPool: WorkerPool | null = null\n\nexport interface CanvasEngineConfig {\n  /** Run rendering in worker threads to avoid blocking the event loop (default: true) */\n  workerMode?: boolean\n  /** Number of worker threads in the pool (default: os.cpus().length - 1) */\n  workers?: number\n  /** Maximum number of resolved images to keep in the persistent LRU cache (default: 128) */\n  imageCacheSize?: number\n}\n\n/**\n * Configure the canvas rendering engine.\n * Call this once at application startup before rendering.\n */\nexport function configure(options: CanvasEngineConfig) {\n  if (options.workerMode !== undefined) _workerMode = options.workerMode\n  if (options.workers !== undefined) _workerPoolSize = options.workers\n  if (options.imageCacheSize !== undefined) {\n    // Dispose existing cache and create a new one with the specified size\n    disposeImageCache()\n    getImageCache(options.imageCacheSize)\n  }\n  if (_workerMode) {\n    _workerPool = new WorkerPool(_workerPoolSize)\n  }\n}\n\ninterface PendingTask {\n  resolve: (value: unknown) => void\n  reject: (err: Error) => void\n}\n\ninterface PoolRenderResult {\n  buffer: Buffer\n  canvasId: number\n  workerIdx: number\n  width: number\n  height: number\n}\n\n/**\n * Proxies all skia-canvas Canvas APIs to a Canvas instance living inside a worker thread.\n * Sync methods (toBufferSync, toURLSync) return from a pre-encoded PNG buffer.\n * Async methods (toBuffer, toURL, toFile, getters) delegate to the worker.\n */\nclass WorkerCanvas {\n  readonly width: number\n  readonly height: number\n  private readonly _buffer: Buffer // pre-encoded PNG for sync use\n  private readonly _pool: WorkerPool\n  private readonly _workerIdx: number\n  private readonly _canvasId: number\n\n  constructor(opts: PoolRenderResult & { pool: WorkerPool }) {\n    this._buffer = opts.buffer\n    this.width = opts.width\n    this.height = opts.height\n    this._pool = opts.pool\n    this._workerIdx = opts.workerIdx\n    this._canvasId = opts.canvasId\n  }\n\n  private _call<M extends CanvasCallMethod>(method: M, ...args: CallArgs<M>): Promise<CallResult<M>> {\n    return this._pool.callOnCanvas(this._workerIdx, this._canvasId, method, args)\n  }\n\n  // --- Sync methods: return from pre-encoded PNG buffer ---\n\n  toBufferSync(_format?: ExportFormat, _options?: ExportOptions): Buffer {\n    return this._buffer\n  }\n\n  toURLSync(_format?: ExportFormat, _options?: ExportOptions): string {\n    return `data:image/png;base64,${this._buffer.toString('base64')}`\n  }\n\n  // --- Async methods: delegate to worker ---\n\n  toBuffer(format: ExportFormat, options?: ExportOptions): Promise<Buffer> {\n    return this._call('toBuffer', format, options)\n  }\n\n  toURL(format: ExportFormat, options?: ExportOptions): Promise<string> {\n    return this._call('toURL', format, options)\n  }\n\n  toFile(filename: string, options?: SaveOptions): Promise<void> {\n    return this._call('toFile', filename, options)\n  }\n\n  /** Returns a Buffer (Sharp instance cannot be transferred across threads) */\n  toSharp(options?: RenderOptions): Promise<Buffer> {\n    return this._call('toSharp', options)\n  }\n\n  toSharpSync(_options?: RenderOptions): never {\n    throw new Error('[canvas] toSharpSync() is not available in worker mode — use toSharp() instead')\n  }\n\n  // --- Async convenience getters ---\n\n  get png(): Promise<Buffer> {\n    return this._call('toBuffer', 'png')\n  }\n  get webp(): Promise<Buffer> {\n    return this._call('toBuffer', 'webp')\n  }\n  get jpg(): Promise<Buffer> {\n    return this._call('toBuffer', 'jpg')\n  }\n  get svg(): Promise<Buffer> {\n    return this._call('toBuffer', 'svg')\n  }\n  get pdf(): Promise<Buffer> {\n    return this._call('toBuffer', 'pdf')\n  }\n  get raw(): Promise<Buffer> {\n    return this._call('toBuffer', 'raw')\n  }\n\n  /** Release the Canvas from worker memory. Call when done with this object. */\n  release(): void {\n    this._pool.releaseCanvas(this._workerIdx, this._canvasId)\n  }\n}\n\n/** Worker thread pool — routes render and canvas-call messages */\nclass WorkerPool {\n  private workers: Worker[] = []\n  private idle: Worker[] = []\n  private queue: Array<{ id: number; props: RootProps }> = []\n  private pending = new Map<number, PendingTask>()\n  private nextId = 0\n\n  constructor(size: number) {\n    this.init(size)\n  }\n\n  private init(size: number) {\n    const workerFile = path.join(path.dirname(fileURLToPath(import.meta.url)), '../worker/render.worker.js')\n\n    for (let i = 0; i < size; i++) {\n      const workerIdx = i\n      const worker = new Worker(workerFile)\n      worker.on('message', (msg: WorkerResponse) => {\n        const task = this.pending.get(msg.taskId)\n        if (!task) return\n        this.pending.delete(msg.taskId)\n\n        if ('error' in msg) {\n          task.reject(new Error(msg.error))\n          return\n        }\n\n        if ('canvasId' in msg) {\n          // Render complete — put worker back to idle\n          this.idle.push(worker)\n          this.drain()\n          const result: PoolRenderResult = { buffer: msg.buffer, canvasId: msg.canvasId, workerIdx, width: msg.width, height: msg.height }\n          task.resolve(result)\n        } else {\n          // Canvas method call complete\n          task.resolve(msg.result)\n        }\n      })\n      this.workers.push(worker)\n      this.idle.push(worker)\n    }\n  }\n\n  private drain() {\n    while (this.queue.length > 0 && this.idle.length > 0) {\n      const task = this.queue.shift()!\n      const worker = this.idle.pop()!\n      const request: WorkerRequest = { type: 'render', taskId: task.id, props: task.props }\n      worker.postMessage(request)\n    }\n  }\n\n  render(props: RootProps): Promise<PoolRenderResult> {\n    const sanitizedProps = WorkerPreProcessor.process(props)\n    return new Promise<PoolRenderResult>((resolve, reject) => {\n      const id = this.nextId++\n      this.pending.set(id, { resolve: resolve as (v: unknown) => void, reject })\n      if (this.idle.length > 0) {\n        const worker = this.idle.pop()!\n        const request: WorkerRequest = { type: 'render', taskId: id, props: sanitizedProps }\n        worker.postMessage(request)\n      } else {\n        this.queue.push({ id, props: sanitizedProps })\n      }\n    })\n  }\n\n  callOnCanvas<M extends CanvasCallMethod>(workerIdx: number, canvasId: number, method: M, args: CallArgs<M>): Promise<CallResult<M>> {\n    return new Promise<CallResult<M>>((resolve, reject) => {\n      const id = this.nextId++\n      this.pending.set(id, { resolve: resolve as (v: unknown) => void, reject })\n      const request = { type: 'call' as const, taskId: id, canvasId, method, args } as WorkerCallRequest\n      this.workers[workerIdx].postMessage(request)\n    })\n  }\n\n  releaseCanvas(workerIdx: number, canvasId: number): void {\n    const request: WorkerRequest = { type: 'release', canvasId }\n    this.workers[workerIdx]?.postMessage(request)\n  }\n\n  terminate() {\n    this.workers.forEach(w => w.terminate())\n  }\n}\n\n/**\n * Converts a CanvasElement tree into actual BoxNode instances.\n * Used both for non-worker rendering (inline tree building) and inside\n * the render worker (reconstructing the tree from serialized descriptors).\n */\nexport function buildTree(descriptor: CanvasElement): BoxNode {\n  switch (descriptor.__type) {\n    case 'Box':\n      return new BoxNode({ ...descriptor.props, children: descriptor.children?.map(buildTree) })\n    case 'Column':\n      return new ColumnNode({ ...descriptor.props, children: descriptor.children?.map(buildTree) })\n    case 'Row':\n      return new RowNode({ ...descriptor.props, children: descriptor.children?.map(buildTree) })\n    case 'Grid':\n      return new GridNode({ ...descriptor.props, children: descriptor.children?.map(buildTree) as any })\n    case 'GridItem':\n      return new GridItemNode({ ...descriptor.props, children: descriptor.children?.map(buildTree) as any })\n    case 'Image':\n      return new ImageNode(descriptor.props as any)\n    case 'Text':\n      return new TextNode(descriptor.text, descriptor.props)\n    case 'Chart':\n      return new ChartNode(descriptor.props as any)\n  }\n}\n\n/**\n * Root node that manages the canvas rendering context and coordinates overall layout and drawing.\n * Inherits from ColumnNode to provide vertical layout capabilities.\n */\nexport class RootNode extends ColumnNode {\n  /** The canvas instance used for rendering */\n  private canvas: Canvas | undefined\n  /** The 2D rendering context for the canvas */\n  private ctx: CanvasRenderingContext2D | null = null\n  /** Target width for the canvas in pixels */\n  private readonly targetWidth: number\n  /** Target height for the canvas in pixels */\n  private readonly targetHeight: number\n  /** Scale factor for rendering (e.g. 2 for 2x resolution) */\n  private readonly scale: number\n\n  /**\n   * Creates a new root node for canvas rendering\n   * @param props Configuration properties for the root node\n   * @throws Error if width property is not provided\n   */\n  constructor(props: RootProps & BaseProps) {\n    // Call the parent constructor with root name and props\n    super({ name: 'Root', ...props })\n\n    this.props = props\n\n    // Validate the required width property\n    if (!props.width) {\n      throw new Error('Width and height are required for Root')\n    }\n\n    // Register provided fonts with caching\n    if (props.fonts?.length) {\n      for (const font of props.fonts) {\n        const family = font.family\n        const paths = font.paths.map(p => path.resolve(p))\n\n        if (!registeredFonts.has(family)) {\n          registeredFonts.set(family, new Set())\n        }\n\n        const cachedPaths = registeredFonts.get(family)!\n        const newPaths = paths.filter(p => !cachedPaths.has(p) && fs.existsSync(p))\n\n        if (newPaths.length > 0) {\n          FontLibrary.use({ [family]: newPaths })\n          newPaths.forEach(p => cachedPaths.add(p))\n        }\n      }\n    }\n\n    // Set up scale and width\n    this.scale = props.scale || 1\n    this.targetWidth = props.width\n    this.targetHeight = props.height\n    this.node.setWidth(this.targetWidth)\n\n    // Convert any CanvasElement children to actual BoxNode instances\n    if (this.props.children) {\n      const childArray = Array.isArray(this.props.children) ? this.props.children : [this.props.children]\n      this.props.children = childArray.map(child => {\n        if (child && typeof child === 'object' && '__type' in child) {\n          return buildTree(child as CanvasElement)\n        }\n        return child\n      }) as any\n    }\n\n    // Initialize children nodes\n    this.processInitialChildren()\n  }\n\n  /**\n   * Traverses the node tree to find all ImageNode instances using breadth-first search\n   * @returns Array of all ImageNode instances found in the tree\n   */\n  private findAllImageNodes(): ImageNode[] {\n    const imageNodes: ImageNode[] = []\n    const queue: BoxNode[] = [this]\n    while (queue.length > 0) {\n      const node = queue.shift()!\n      if (node instanceof ImageNode) {\n        imageNodes.push(node)\n      }\n      queue.push(...node.children)\n    }\n    return imageNodes\n  }\n\n  /**\n   * Renders the entire node tree to a canvas, handling image loading, layout calculation,\n   * and final drawing\n   * @returns Promise resolving to the rendered Canvas instance\n   */\n  async render(): Promise<Canvas> {\n    try {\n      // Step 1: Load all images with a concurrency limit to avoid overwhelming remote sources.\n      // A per-render cache deduplicates identical src+color combinations within this render pass.\n      const imageNodes = this.findAllImageNodes()\n      if (imageNodes.length > 0) {\n        const imageCache: RenderImageCache = new Map()\n        const CONCURRENCY = 5\n        const queue = [...imageNodes]\n        const workers = Array.from({ length: Math.min(CONCURRENCY, queue.length) }, async () => {\n          while (queue.length > 0) {\n            const node = queue.shift()!\n            await node.load(imageCache)\n          }\n        })\n        await Promise.allSettled(workers)\n      }\n\n      // Step 2: Calculate initial layout\n      this.node.calculateLayout(this.targetWidth, undefined, Style.Direction.LTR)\n\n      // Step 3: Allow nodes to finalize their layout\n      const needRecalculate = this.finalizeLayout()\n      if (needRecalculate) {\n        this.node.calculateLayout(this.targetWidth, undefined, Style.Direction.LTR)\n      }\n\n      // Step 4: Create a canvas with calculated dimensions\n      const calculatedContentHeight = this.node.getComputedHeight()\n      const finalCanvasWidth = Math.ceil(this.targetWidth * this.scale)\n      const finalCanvasHeight = this.targetHeight ? Math.ceil(this.targetHeight * this.scale) : Math.max(1, Math.ceil(calculatedContentHeight * this.scale))\n\n      // Step 5: Set up canvas context\n      this.canvas = new Canvas(finalCanvasWidth, finalCanvasHeight)\n      this.ctx = this.canvas.getContext('2d')\n      this.ctx.scale(this.scale, this.scale)\n\n      // Step 6: Render content\n      super.render(this.ctx, 0, 0)\n\n      if (!this.canvas) {\n        throw new Error('Canvas not initialized')\n      }\n\n      return this.canvas\n    } finally {\n      // Always clear the persistent image cache after render (success or error)\n      // so resolved CanvasImage references don't outlive the render pass.\n      disposeImageCache()\n    }\n  }\n}\n\n/**\n * Creates and renders a new root node with the given properties.\n * When worker mode is enabled via configure(), rendering runs in a worker thread\n * and the returned object implements the same toBuffer/toBufferSync interface.\n * @param props Configuration properties for the root node\n * @returns Promise resolving to the rendered Canvas (or WorkerCanvas in worker mode)\n */\nexport const Root = async (props: RootProps): Promise<Canvas> => {\n  try {\n    if (_workerMode) {\n      if (!_workerPool) {\n        _workerPool = new WorkerPool(_workerPoolSize)\n      }\n      const result = await _workerPool.render(props)\n      return new WorkerCanvas({ ...result, pool: _workerPool }) as unknown as Canvas\n    }\n    return await new RootNode(props).render()\n  } catch (err) {\n    // Ensure cache is cleared even if Root-level orchestration fails\n    disposeImageCache()\n    throw err\n  }\n}\n"],"names":["cpus","disposeImageCache","getImageCache","path","fileURLToPath","Worker","WorkerPreProcessor","BoxNode","ColumnNode","RowNode","GridNode","GridItemNode","ImageNode","TextNode","ChartNode","fs","FontLibrary","Style","Canvas"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiBA;AACA,MAAM,eAAe,GAAG,IAAI,GAAG,EAAuB;AAOtD;AACA,IAAI,WAAW,GAAG,IAAI;AACtB,IAAI,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAEA,YAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACpD,IAAI,WAAW,GAAsB,IAAI;AAWzC;;;AAGG;AACG,SAAU,SAAS,CAAC,OAA2B,EAAA;AACnD,IAAA,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;AAAE,QAAA,WAAW,GAAG,OAAO,CAAC,UAAU;AACtE,IAAA,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;AAAE,QAAA,eAAe,GAAG,OAAO,CAAC,OAAO;AACpE,IAAA,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE;;AAExC,QAAAC,mCAAiB,EAAE;AACnB,QAAAC,+BAAa,CAAC,OAAO,CAAC,cAAc,CAAC;IACvC;IACA,IAAI,WAAW,EAAE;AACf,QAAA,WAAW,GAAG,IAAI,UAAU,CAAC,eAAe,CAAC;IAC/C;AACF;AAeA;;;;AAIG;AACH,MAAM,YAAY,CAAA;AACP,IAAA,KAAK;AACL,IAAA,MAAM;IACE,OAAO,CAAQ;AACf,IAAA,KAAK;AACL,IAAA,UAAU;AACV,IAAA,SAAS;AAE1B,IAAA,WAAA,CAAY,IAA6C,EAAA;AACvD,QAAA,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM;AAC1B,QAAA,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;AACvB,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;AACzB,QAAA,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI;AACtB,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS;AAChC,QAAA,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ;IAChC;AAEQ,IAAA,KAAK,CAA6B,MAAS,EAAE,GAAG,IAAiB,EAAA;AACvE,QAAA,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC;IAC/E;;IAIA,YAAY,CAAC,OAAsB,EAAE,QAAwB,EAAA;QAC3D,OAAO,IAAI,CAAC,OAAO;IACrB;IAEA,SAAS,CAAC,OAAsB,EAAE,QAAwB,EAAA;QACxD,OAAO,CAAA,sBAAA,EAAyB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA,CAAE;IACnE;;IAIA,QAAQ,CAAC,MAAoB,EAAE,OAAuB,EAAA;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC;IAChD;IAEA,KAAK,CAAC,MAAoB,EAAE,OAAuB,EAAA;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;IAC7C;IAEA,MAAM,CAAC,QAAgB,EAAE,OAAqB,EAAA;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC;IAChD;;AAGA,IAAA,OAAO,CAAC,OAAuB,EAAA;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC;IACvC;AAEA,IAAA,WAAW,CAAC,QAAwB,EAAA;AAClC,QAAA,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC;IACnG;;AAIA,IAAA,IAAI,GAAG,GAAA;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC;IACtC;AACA,IAAA,IAAI,IAAI,GAAA;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC;IACvC;AACA,IAAA,IAAI,GAAG,GAAA;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC;IACtC;AACA,IAAA,IAAI,GAAG,GAAA;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC;IACtC;AACA,IAAA,IAAI,GAAG,GAAA;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC;IACtC;AACA,IAAA,IAAI,GAAG,GAAA;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC;IACtC;;IAGA,OAAO,GAAA;AACL,QAAA,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC;IAC3D;AACD;AAED;AACA,MAAM,UAAU,CAAA;IACN,OAAO,GAAa,EAAE;IACtB,IAAI,GAAa,EAAE;IACnB,KAAK,GAA4C,EAAE;AACnD,IAAA,OAAO,GAAG,IAAI,GAAG,EAAuB;IACxC,MAAM,GAAG,CAAC;AAElB,IAAA,WAAA,CAAY,IAAY,EAAA;AACtB,QAAA,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACjB;AAEQ,IAAA,IAAI,CAAC,IAAY,EAAA;QACvB,MAAM,UAAU,GAAGC,eAAI,CAAC,IAAI,CAACA,eAAI,CAAC,OAAO,CAACC,sBAAa,CAAC,4QAAe,CAAC,CAAC,EAAE,4BAA4B,CAAC;AAExG,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE;YAC7B,MAAM,SAAS,GAAG,CAAC;AACnB,YAAA,MAAM,MAAM,GAAG,IAAIC,0BAAM,CAAC,UAAU,CAAC;YACrC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAmB,KAAI;AAC3C,gBAAA,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;AACzC,gBAAA,IAAI,CAAC,IAAI;oBAAE;gBACX,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;AAE/B,gBAAA,IAAI,OAAO,IAAI,GAAG,EAAE;oBAClB,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBACjC;gBACF;AAEA,gBAAA,IAAI,UAAU,IAAI,GAAG,EAAE;;AAErB,oBAAA,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;oBACtB,IAAI,CAAC,KAAK,EAAE;AACZ,oBAAA,MAAM,MAAM,GAAqB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE;AAChI,oBAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;gBACtB;qBAAO;;AAEL,oBAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gBAC1B;AACF,YAAA,CAAC,CAAC;AACF,YAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;AACzB,YAAA,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QACxB;IACF;IAEQ,KAAK,GAAA;AACX,QAAA,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE;YACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG;YAChC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAG;AAC/B,YAAA,MAAM,OAAO,GAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;AACrF,YAAA,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;QAC7B;IACF;AAEA,IAAA,MAAM,CAAC,KAAgB,EAAA;QACrB,MAAM,cAAc,GAAGC,gCAAkB,CAAC,OAAO,CAAC,KAAK,CAAC;QACxD,OAAO,IAAI,OAAO,CAAmB,CAAC,OAAO,EAAE,MAAM,KAAI;AACvD,YAAA,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE;AACxB,YAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAA+B,EAAE,MAAM,EAAE,CAAC;YAC1E,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE;gBACxB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAG;AAC/B,gBAAA,MAAM,OAAO,GAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE;AACpF,gBAAA,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;YAC7B;iBAAO;AACL,gBAAA,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;YAChD;AACF,QAAA,CAAC,CAAC;IACJ;AAEA,IAAA,YAAY,CAA6B,SAAiB,EAAE,QAAgB,EAAE,MAAS,EAAE,IAAiB,EAAA;QACxG,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,MAAM,KAAI;AACpD,YAAA,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE;AACxB,YAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAA+B,EAAE,MAAM,EAAE,CAAC;AAC1E,YAAA,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,MAAe,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAuB;YAClG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC;AAC9C,QAAA,CAAC,CAAC;IACJ;IAEA,aAAa,CAAC,SAAiB,EAAE,QAAgB,EAAA;QAC/C,MAAM,OAAO,GAAkB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE;QAC5D,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IAC/C;IAEA,SAAS,GAAA;AACP,QAAA,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;IAC1C;AACD;AAED;;;;AAIG;AACG,SAAU,SAAS,CAAC,UAAyB,EAAA;AACjD,IAAA,QAAQ,UAAU,CAAC,MAAM;AACvB,QAAA,KAAK,KAAK;YACR,OAAO,IAAIC,0BAAO,CAAC,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;AAC5F,QAAA,KAAK,QAAQ;YACX,OAAO,IAAIC,6BAAU,CAAC,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;AAC/F,QAAA,KAAK,KAAK;YACR,OAAO,IAAIC,0BAAO,CAAC,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;AAC5F,QAAA,KAAK,MAAM;YACT,OAAO,IAAIC,yBAAQ,CAAC,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAQ,EAAE,CAAC;AACpG,QAAA,KAAK,UAAU;YACb,OAAO,IAAIC,6BAAY,CAAC,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAQ,EAAE,CAAC;AACxG,QAAA,KAAK,OAAO;AACV,YAAA,OAAO,IAAIC,2BAAS,CAAC,UAAU,CAAC,KAAY,CAAC;AAC/C,QAAA,KAAK,MAAM;YACT,OAAO,IAAIC,yBAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC;AACxD,QAAA,KAAK,OAAO;AACV,YAAA,OAAO,IAAIC,2BAAS,CAAC,UAAU,CAAC,KAAY,CAAC;;AAEnD;AAEA;;;AAGG;AACG,MAAO,QAAS,SAAQN,6BAAU,CAAA;;AAE9B,IAAA,MAAM;;IAEN,GAAG,GAAoC,IAAI;;AAElC,IAAA,WAAW;;AAEX,IAAA,YAAY;;AAEZ,IAAA,KAAK;AAEtB;;;;AAIG;AACH,IAAA,WAAA,CAAY,KAA4B,EAAA;;QAEtC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;AAEjC,QAAA,IAAI,CAAC,KAAK,GAAG,KAAK;;AAGlB,QAAA,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE;AAChB,YAAA,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC;QAC3D;;AAGA,QAAA,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE;AACvB,YAAA,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE;AAC9B,gBAAA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM;AAC1B,gBAAA,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAIL,eAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAElD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;oBAChC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;gBACxC;gBAEA,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAE;gBAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAIY,aAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAE3E,gBAAA,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;oBACvBC,sBAAW,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;AACvC,oBAAA,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC3C;YACF;QACF;;QAGA,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC;AAC7B,QAAA,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,KAAK;AAC9B,QAAA,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,MAAM;QAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC;;AAGpC,QAAA,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;AACvB,YAAA,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACnG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,IAAG;gBAC3C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK,EAAE;AAC3D,oBAAA,OAAO,SAAS,CAAC,KAAsB,CAAC;gBAC1C;AACA,gBAAA,OAAO,KAAK;AACd,YAAA,CAAC,CAAQ;QACX;;QAGA,IAAI,CAAC,sBAAsB,EAAE;IAC/B;AAEA;;;AAGG;IACK,iBAAiB,GAAA;QACvB,MAAM,UAAU,GAAgB,EAAE;AAClC,QAAA,MAAM,KAAK,GAAc,CAAC,IAAI,CAAC;AAC/B,QAAA,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;AACvB,YAAA,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAG;AAC3B,YAAA,IAAI,IAAI,YAAYJ,2BAAS,EAAE;AAC7B,gBAAA,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YACvB;YACA,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B;AACA,QAAA,OAAO,UAAU;IACnB;AAEA;;;;AAIG;AACH,IAAA,MAAM,MAAM,GAAA;AACV,QAAA,IAAI;;;AAGF,YAAA,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE;AAC3C,YAAA,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE;AACzB,gBAAA,MAAM,UAAU,GAAqB,IAAI,GAAG,EAAE;gBAC9C,MAAM,WAAW,GAAG,CAAC;AACrB,gBAAA,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,CAAC;gBAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,YAAW;AACrF,oBAAA,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;AACvB,wBAAA,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAG;AAC3B,wBAAA,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;oBAC7B;AACF,gBAAA,CAAC,CAAC;AACF,gBAAA,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;YACnC;;AAGA,YAAA,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAEK,kBAAK,CAAC,SAAS,CAAC,GAAG,CAAC;;AAG3E,YAAA,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,EAAE;YAC7C,IAAI,eAAe,EAAE;AACnB,gBAAA,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAEA,kBAAK,CAAC,SAAS,CAAC,GAAG,CAAC;YAC7E;;YAGA,MAAM,uBAAuB,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE;AAC7D,YAAA,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC;AACjE,YAAA,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;;YAGtJ,IAAI,CAAC,MAAM,GAAG,IAAIC,iBAAM,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;YAC7D,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;AACvC,YAAA,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC;;YAGtC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;AAE5B,YAAA,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;AAChB,gBAAA,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC;YAC3C;YAEA,OAAO,IAAI,CAAC,MAAM;QACpB;gBAAU;;;AAGR,YAAAjB,mCAAiB,EAAE;QACrB;IACF;AACD;AAED;;;;;;AAMG;MACU,IAAI,GAAG,OAAO,KAAgB,KAAqB;AAC9D,IAAA,IAAI;QACF,IAAI,WAAW,EAAE;YACf,IAAI,CAAC,WAAW,EAAE;AAChB,gBAAA,WAAW,GAAG,IAAI,UAAU,CAAC,eAAe,CAAC;YAC/C;YACA,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;AAC9C,YAAA,OAAO,IAAI,YAAY,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAsB;QAChF;QACA,OAAO,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE;IAC3C;IAAE,OAAO,GAAG,EAAE;;AAEZ,QAAAA,mCAAiB,EAAE;AACnB,QAAA,MAAM,GAAG;IACX;AACF;;;;;;;"}

package/dist/cjs/index.d.ts

@@ -1,7 +1,7 @@
 export * from './constant/common.const.js';
 export * from './canvas/canvas.type.js';
 export { Box, Column, Row, type BoxNode } from './canvas/layout.canvas.util.js';
-export { Image } from './canvas/image.canvas.util.js';
+export { Image, disposeImageCache } from './canvas/image.canvas.util.js';
 export { Text } from './canvas/text.canvas.util.js';
 export { Root, configure } from './canvas/root.canvas.util.js';
 export { GridItem } from './canvas/grid.canvas.util.js';

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,OAAO,EAAE,MAAM,gCAAgC,CAAA;AAC/E,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,OAAO,EAAE,MAAM,gCAAgC,CAAA;AAC/E,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA"}

package/dist/cjs/index.js

@@ -20,6 +20,7 @@ exports.Box = layout_canvas_util.Box;
 exports.Column = layout_canvas_util.Column;
 exports.Row = layout_canvas_util.Row;
 exports.Image = image_canvas_util.Image;
+exports.disposeImageCache = image_canvas_util.disposeImageCache;
 exports.Text = text_canvas_util.Text;
 exports.Root = root_canvas_util.Root;
 exports.configure = root_canvas_util.configure;

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/util/disk.cache.d.ts

@@ -0,0 +1,4 @@
+export declare function hashBuffer(buf: Buffer): string;
+export declare function readDiskCache(key: string): Promise<Buffer | null>;
+export declare function writeDiskCache(key: string, data: Buffer): Promise<void>;
+//# sourceMappingURL=disk.cache.d.ts.map

package/dist/cjs/util/disk.cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk.cache.d.ts","sourceRoot":"","sources":["../../../src/util/disk.cache.ts"],"names":[],"mappings":"AAaA,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOvE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO7E"}

package/dist/cjs/util/disk.cache.js

@@ -0,0 +1,40 @@
+'use strict';
+
+var crypto = require('crypto');
+var fs = require('fs');
+var path = require('path');
+
+const CACHE_DIR = path.join(process.cwd(), '.cache', 'files');
+let _dirEnsured = false;
+async function ensureDir() {
+    if (_dirEnsured)
+        return;
+    await fs.promises.mkdir(CACHE_DIR, { recursive: true });
+    _dirEnsured = true;
+}
+function hashBuffer(buf) {
+    return crypto.createHash('sha256').update(buf).digest('hex');
+}
+async function readDiskCache(key) {
+    try {
+        await ensureDir();
+        return await fs.promises.readFile(path.join(CACHE_DIR, key));
+    }
+    catch {
+        return null;
+    }
+}
+async function writeDiskCache(key, data) {
+    try {
+        await ensureDir();
+        await fs.promises.writeFile(path.join(CACHE_DIR, key), data);
+    }
+    catch {
+        // best-effort — cache write failures are non-fatal
+    }
+}
+
+exports.hashBuffer = hashBuffer;
+exports.readDiskCache = readDiskCache;
+exports.writeDiskCache = writeDiskCache;
+//# sourceMappingURL=disk.cache.js.map

package/dist/cjs/util/disk.cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk.cache.js","sources":["../../../../src/util/disk.cache.ts"],"sourcesContent":["import { createHash } from 'crypto'\nimport { promises as fs } from 'fs'\nimport { join } from 'path'\n\nconst CACHE_DIR = join(process.cwd(), '.cache', 'files')\nlet _dirEnsured = false\n\nasync function ensureDir(): Promise<void> {\n  if (_dirEnsured) return\n  await fs.mkdir(CACHE_DIR, { recursive: true })\n  _dirEnsured = true\n}\n\nexport function hashBuffer(buf: Buffer): string {\n  return createHash('sha256').update(buf).digest('hex')\n}\n\nexport async function readDiskCache(key: string): Promise<Buffer | null> {\n  try {\n    await ensureDir()\n    return await fs.readFile(join(CACHE_DIR, key))\n  } catch {\n    return null\n  }\n}\n\nexport async function writeDiskCache(key: string, data: Buffer): Promise<void> {\n  try {\n    await ensureDir()\n    await fs.writeFile(join(CACHE_DIR, key), data)\n  } catch {\n    // best-effort — cache write failures are non-fatal\n  }\n}\n"],"names":["join","fs","createHash"],"mappings":";;;;;;AAIA,MAAM,SAAS,GAAGA,SAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC;AACxD,IAAI,WAAW,GAAG,KAAK;AAEvB,eAAe,SAAS,GAAA;AACtB,IAAA,IAAI,WAAW;QAAE;AACjB,IAAA,MAAMC,WAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC9C,WAAW,GAAG,IAAI;AACpB;AAEM,SAAU,UAAU,CAAC,GAAW,EAAA;AACpC,IAAA,OAAOC,iBAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;AACvD;AAEO,eAAe,aAAa,CAAC,GAAW,EAAA;AAC7C,IAAA,IAAI;QACF,MAAM,SAAS,EAAE;AACjB,QAAA,OAAO,MAAMD,WAAE,CAAC,QAAQ,CAACD,SAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAChD;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF;AAEO,eAAe,cAAc,CAAC,GAAW,EAAE,IAAY,EAAA;AAC5D,IAAA,IAAI;QACF,MAAM,SAAS,EAAE;AACjB,QAAA,MAAMC,WAAE,CAAC,SAAS,CAACD,SAAI,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC;IAChD;AAAE,IAAA,MAAM;;IAER;AACF;;;;;;"}

package/dist/cjs/worker/render.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.worker.d.ts","sourceRoot":"","sources":["../../../src/worker/render.worker.ts"],"names":[],"mappings":""}

package/dist/cjs/{render.worker.js → worker/render.worker.js}

@@ -1,7 +1,7 @@
 'use strict';
 
 var worker_threads = require('worker_threads');
-var root_canvas_util = require('./canvas/root.canvas.util.js');
+var root_canvas_util = require('../canvas/root.canvas.util.js');
 
 /**
  * Worker thread entry point for off-main-thread canvas rendering.

package/dist/cjs/worker/render.worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.worker.js","sources":["../../../../src/worker/render.worker.ts"],"sourcesContent":["/**\n * Worker thread entry point for off-main-thread canvas rendering.\n *\n * Message protocol (main → worker):\n *   { type: 'render', taskId, props }                      — render and keep Canvas alive\n *   { type: 'call',   taskId, canvasId, method, args }     — call a method on a live Canvas\n *   { type: 'release', canvasId }                          — free Canvas from memory\n *\n * Responses (worker → main):\n *   WorkerRenderResponse  — render complete (includes pre-encoded PNG buffer)\n *   WorkerCallResponse    — method call result\n *   WorkerErrorResponse   — any failure\n */\nimport { parentPort } from 'worker_threads'\nimport { RootNode } from '@/canvas/root.canvas.util.js'\nimport type { Canvas } from 'skia-canvas'\nimport type { WorkerRequest, WorkerRenderResponse, WorkerCallResponse, WorkerErrorResponse } from '@/worker/worker.types.js'\n\nif (!parentPort) {\n  throw new Error('[render.worker] Must be run as a worker thread')\n}\n\nconst canvases = new Map<number, Canvas>()\nlet nextCanvasId = 0\n\nfunction reply(msg: WorkerRenderResponse | WorkerCallResponse | WorkerErrorResponse) {\n  parentPort!.postMessage(msg)\n}\n\nparentPort.on('message', async (msg: WorkerRequest) => {\n  if (msg.type === 'render') {\n    try {\n      const canvas = await new RootNode(msg.props).render()\n      const canvasId = nextCanvasId++\n      canvases.set(canvasId, canvas)\n      reply({ taskId: msg.taskId, canvasId, buffer: canvas.toBufferSync('png'), width: canvas.width, height: canvas.height })\n    } catch (err) {\n      reply({ taskId: msg.taskId, error: String(err) })\n    }\n  } else if (msg.type === 'call') {\n    const canvas = canvases.get(msg.canvasId)\n    if (!canvas) {\n      reply({ taskId: msg.taskId, error: `[render.worker] Canvas ${msg.canvasId} not found` })\n      return\n    }\n    try {\n      let result: Buffer | string | void\n      switch (msg.method) {\n        case 'toBuffer':\n          result = await canvas.toBuffer(...msg.args)\n          break\n        case 'toURL':\n          result = await canvas.toURL(...msg.args)\n          break\n        case 'toFile':\n          result = await canvas.toFile(...msg.args)\n          break\n        case 'toSharp':\n          // Sharp instances can't be transferred across threads — serialize to buffer\n          result = await canvas.toSharp(...msg.args).toBuffer()\n          break\n      }\n      reply({ taskId: msg.taskId, result })\n    } catch (err) {\n      reply({ taskId: msg.taskId, error: String(err) })\n    }\n  } else {\n    // type === 'release'\n    canvases.delete(msg.canvasId)\n  }\n})\n"],"names":["parentPort","RootNode"],"mappings":";;;;;AAAA;;;;;;;;;;;;AAYG;AAMH,IAAI,CAACA,yBAAU,EAAE;AACf,IAAA,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC;AACnE;AAEA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB;AAC1C,IAAI,YAAY,GAAG,CAAC;AAEpB,SAAS,KAAK,CAAC,GAAoE,EAAA;AACjF,IAAAA,yBAAW,CAAC,WAAW,CAAC,GAAG,CAAC;AAC9B;AAEAA,yBAAU,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,GAAkB,KAAI;AACpD,IAAA,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE;AACzB,QAAA,IAAI;AACF,YAAA,MAAM,MAAM,GAAG,MAAM,IAAIC,yBAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE;AACrD,YAAA,MAAM,QAAQ,GAAG,YAAY,EAAE;AAC/B,YAAA,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;AAC9B,YAAA,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACzH;QAAE,OAAO,GAAG,EAAE;AACZ,YAAA,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD;IACF;AAAO,SAAA,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE;QAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE;AACX,YAAA,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,0BAA0B,GAAG,CAAC,QAAQ,CAAA,UAAA,CAAY,EAAE,CAAC;YACxF;QACF;AACA,QAAA,IAAI;AACF,YAAA,IAAI,MAA8B;AAClC,YAAA,QAAQ,GAAG,CAAC,MAAM;AAChB,gBAAA,KAAK,UAAU;oBACb,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;oBAC3C;AACF,gBAAA,KAAK,OAAO;oBACV,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;oBACxC;AACF,gBAAA,KAAK,QAAQ;oBACX,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;oBACzC;AACF,gBAAA,KAAK,SAAS;;AAEZ,oBAAA,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;oBACrD;;YAEJ,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACvC;QAAE,OAAO,GAAG,EAAE;AACZ,YAAA,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD;IACF;SAAO;;AAEL,QAAA,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC/B;AACF,CAAC,CAAC;;"}

package/dist/{esm/canvas → cjs/worker}/worker.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.types.d.ts","sourceRoot":"","sources":["../../../src/canvas/worker.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"worker.types.d.ts","sourceRoot":"","sources":["../../../src/worker/worker.types.ts"],"names":[],"mappings":"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"}

package/dist/esm/canvas/image.canvas.util.d.ts

@@ -6,6 +6,36 @@ import { BoxNode } from '../canvas/layout.canvas.util.js';
  * Scoped to a single RootNode.render() call; discarded after rendering.
  */
 export type RenderImageCache = Map<string, Promise<CanvasImage>>;
+/**
+ * A simple LRU cache for resolved `CanvasImage` objects.
+ *
+ * - Persists across render passes so repeated renders of the same tree don't
+ *   re-fetch every image.
+ * - Bounded by `maxSize` entries; least-recently-used entries are evicted first.
+ * - Call `dispose()` to eagerly release all held images, or rely on the
+ *   automatic `process.on('exit')` hook that clears the singleton.
+ */
+export declare class ImageLRUCache {
+    private readonly map;
+    readonly maxSize: number;
+    constructor(maxSize: number);
+    get(key: string): CanvasImage | undefined;
+    set(key: string, image: CanvasImage): void;
+    has(key: string): boolean;
+    get size(): number;
+    dispose(): void;
+}
+/**
+ * Returns the singleton `ImageLRUCache`, creating it on first access.
+ * Registers a one-time process cleanup hook to clear the cache
+ * so native image buffers are freed when the process shuts down.
+ */
+export declare function getImageCache(maxSize?: number): ImageLRUCache;
+/**
+ * Explicitly disposes the global image cache.
+ * Useful in tests or when tearing down the rendering engine.
+ */
+export declare function disposeImageCache(): void;
 /**
  * Renders images with configurable sizing, positioning, and effects.
  * Supports object-fit modes, positioning, border radius, and saturation filters.
@@ -21,11 +51,21 @@ export declare class ImageNode extends BoxNode {
     /**
      * Fetches and processes the image source into a CanvasImage.
      * Does not touch node state — pure fetch logic.
+     *
+     * If `diskCacheKey` is provided, the resolved image buffer is written to the
+     * disk cache at `.cache/files/<diskCacheKey>` (best-effort, fire-and-forget).
      */
     private _fetchCanvasImage;
     /**
-     * Loads and processes an image, using the render-scoped cache to avoid
-     * re-fetching the same source within a single render pass.
+     * Loads and processes an image.
+     *
+     * Resolution order:
+     *   1. Persistent LRU cache (cross-render) — instant hit, no I/O.
+     *   2. Disk cache at `.cache/files/<hash>` — survives process restarts.
+     *   3. Per-render dedup cache — avoids duplicate in-flight fetches within a single render.
+     *   4. Fresh fetch via `_fetchCanvasImage()` — writes buffer to disk cache after fetch.
+     *
+     * Buffer sources use a SHA-256 hash as their cache key (same as string sources).
      */
     private _loadImage;
     getLoadingPromise(): Promise<void>;

package/dist/esm/canvas/image.canvas.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image.canvas.util.d.ts","sourceRoot":"","sources":["../../../src/canvas/image.canvas.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACnF,OAAO,EAAE,KAAK,wBAAwB,EAAE,KAAK,IAAI,WAAW,EAAa,MAAM,aAAa,CAAA;AAC5F,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA;AAsBxD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAA;AAEhE;;;GAGG;AACH,qBAAa,SAAU,SAAQ,OAAO;IAC5B,KAAK,EAAE,UAAU,GAAG,SAAS,CAAA;IACrC,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,cAAc,CAA6B;gBAEvC,KAAK,EAAE,UAAU;IAYtB,IAAI,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpD;;;OAGG;YACW,iBAAiB;IAmE/B;;;OAGG;IACH,OAAO,CAAC,UAAU;IAgDX,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzC;;;OAGG;cACgB,cAAc,CAAC,GAAG,EAAE,wBAAwB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAoJrH;AAED;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,UAAU,KAAG,aAGxC,CAAA"}
+{"version":3,"file":"image.canvas.util.d.ts","sourceRoot":"","sources":["../../../src/canvas/image.canvas.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACnF,OAAO,EAAE,KAAK,wBAAwB,EAAE,KAAK,IAAI,WAAW,EAAa,MAAM,aAAa,CAAA;AAC5F,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA;AAuBxD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAA;AAWhE;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA8B;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;gBAEZ,OAAO,EAAE,MAAM;IAI3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IASzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAa1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,IAAI,IAAI;CAGhB;AAUD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAA2B,GAAG,aAAa,CAejF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED;;;GAGG;AACH,qBAAa,SAAU,SAAQ,OAAO;IAC5B,KAAK,EAAE,UAAU,GAAG,SAAS,CAAA;IACrC,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,cAAc,CAA6B;gBAEvC,KAAK,EAAE,UAAU;IAYtB,IAAI,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpD;;;;;;OAMG;YACW,iBAAiB;IAyE/B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,UAAU;IA2FX,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzC;;;OAGG;cACgB,cAAc,CAAC,GAAG,EAAE,wBAAwB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAoJrH;AAED;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,UAAU,KAAG,aAGxC,CAAA"}

package/dist/esm/canvas/image.canvas.util.js

@@ -3,6 +3,7 @@ import { BoxNode } from './layout.canvas.util.js';
 import { parseBorderRadius, drawRoundedRectPath } from './canvas.helper.js';
 import { promises } from 'fs';
 import { Style } from '../constant/common.const.js';
+import { writeDiskCache, hashBuffer, readDiskCache } from '../util/disk.cache.js';
 
 /**
  * Calculates pixel offset for image positioning based on percentage or pixel values.
@@ -20,6 +21,86 @@ function calculateOffsetFromValue(positionValue, availableSpace) {
     console.warn(`[ImageNode] Invalid objectPosition value format: ${value}. Defaulting to 50%.`);
     return availableSpace * 0.5;
 }
+/**
+ * A simple LRU cache for resolved `CanvasImage` objects.
+ *
+ * - Persists across render passes so repeated renders of the same tree don't
+ *   re-fetch every image.
+ * - Bounded by `maxSize` entries; least-recently-used entries are evicted first.
+ * - Call `dispose()` to eagerly release all held images, or rely on the
+ *   automatic `process.on('exit')` hook that clears the singleton.
+ */
+class ImageLRUCache {
+    map = new Map();
+    maxSize;
+    constructor(maxSize) {
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        const entry = this.map.get(key);
+        if (!entry)
+            return undefined;
+        // Move to end (most-recently used)
+        this.map.delete(key);
+        this.map.set(key, entry);
+        return entry.image;
+    }
+    set(key, image) {
+        // If key already exists, refresh it
+        if (this.map.has(key)) {
+            this.map.delete(key);
+        }
+        // Evict oldest if at capacity
+        while (this.map.size >= this.maxSize) {
+            const oldest = this.map.keys().next().value;
+            this.map.delete(oldest);
+        }
+        this.map.set(key, { image, key });
+    }
+    has(key) {
+        return this.map.has(key);
+    }
+    get size() {
+        return this.map.size;
+    }
+    dispose() {
+        this.map.clear();
+    }
+}
+/** Module-level singleton — lazily created on first render. */
+let _globalImageCache = null;
+const DEFAULT_CACHE_SIZE = 128;
+// Symbol key on process to track hook registration across module reloads (e.g. Jest resetModules)
+const HOOK_KEY = Symbol.for('__meonode_canvas_image_cache_hook__');
+/**
+ * Returns the singleton `ImageLRUCache`, creating it on first access.
+ * Registers a one-time process cleanup hook to clear the cache
+ * so native image buffers are freed when the process shuts down.
+ */
+function getImageCache(maxSize = DEFAULT_CACHE_SIZE) {
+    if (!_globalImageCache) {
+        _globalImageCache = new ImageLRUCache(maxSize);
+    }
+    if (!globalThis[HOOK_KEY]) {
+        globalThis[HOOK_KEY] = true;
+        const cleanup = () => {
+            _globalImageCache?.dispose();
+            _globalImageCache = null;
+        };
+        process.once('exit', cleanup);
+        process.once('SIGINT', cleanup);
+        process.once('SIGTERM', cleanup);
+    }
+    return _globalImageCache;
+}
+/**
+ * Explicitly disposes the global image cache.
+ * Useful in tests or when tearing down the rendering engine.
+ */
+function disposeImageCache() {
+    _globalImageCache?.dispose();
+    _globalImageCache = null;
+}
 /**
  * Renders images with configurable sizing, positioning, and effects.
  * Supports object-fit modes, positioning, border radius, and saturation filters.
@@ -48,8 +129,11 @@ class ImageNode extends BoxNode {
     /**
      * Fetches and processes the image source into a CanvasImage.
      * Does not touch node state — pure fetch logic.
+     *
+     * If `diskCacheKey` is provided, the resolved image buffer is written to the
+     * disk cache at `.cache/files/<diskCacheKey>` (best-effort, fire-and-forget).
      */
-    async _fetchCanvasImage() {
+    async _fetchCanvasImage(diskCacheKey) {
         const { fileTypeFromBuffer, fileTypeFromFile } = await import('file-type');
         let finalSource = this.props.src;
         let isSvg = false;
@@ -108,11 +192,24 @@ class ImageNode extends BoxNode {
             const modifiedSvgString = svgString.replace(/fill="[^"]*"/g, `fill="${this.props.color}"`);
             finalSource = modifiedSvgString !== svgString ? Buffer.from(modifiedSvgString) : contentBuffer;
         }
+        // Write resolved buffer to disk cache (fire-and-forget, non-fatal)
+        if (diskCacheKey) {
+            const cacheBuffer = Buffer.isBuffer(finalSource) ? finalSource : contentBuffer;
+            if (cacheBuffer)
+                writeDiskCache(diskCacheKey, cacheBuffer);
+        }
         return loadImage(finalSource);
     }
     /**
-     * Loads and processes an image, using the render-scoped cache to avoid
-     * re-fetching the same source within a single render pass.
+     * Loads and processes an image.
+     *
+     * Resolution order:
+     *   1. Persistent LRU cache (cross-render) — instant hit, no I/O.
+     *   2. Disk cache at `.cache/files/<hash>` — survives process restarts.
+     *   3. Per-render dedup cache — avoids duplicate in-flight fetches within a single render.
+     *   4. Fresh fetch via `_fetchCanvasImage()` — writes buffer to disk cache after fetch.
+     *
+     * Buffer sources use a SHA-256 hash as their cache key (same as string sources).
      */
     _loadImage(cache) {
         if (!this.props.src) {
@@ -125,18 +222,56 @@ class ImageNode extends BoxNode {
         return new Promise(resolve => {
             const load = async () => {
                 try {
+                    const lru = getImageCache();
+                    const cacheKey = typeof this.props.src === 'string'
+                        ? this.props.color
+                            ? `${this.props.src}|${this.props.color}`
+                            : this.props.src
+                        : this.props.color
+                            ? `${hashBuffer(this.props.src)}|${this.props.color}`
+                            : hashBuffer(this.props.src);
+                    // 1. Check persistent LRU cache
+                    const cached = lru.get(cacheKey);
+                    if (cached) {
+                        this.loadedImage = cached;
+                        this.naturalWidth = cached.width;
+                        this.naturalHeight = cached.height;
+                        const calculatedAspectRatio = cached.width > 0 && cached.height > 0 ? cached.width / cached.height : undefined;
+                        const finalAspectRatio = typeof this.props.aspectRatio === 'number' && this.props.aspectRatio > 0 ? this.props.aspectRatio : calculatedAspectRatio;
+                        this.node.setAspectRatio(finalAspectRatio);
+                        this.props.onLoad?.();
+                        resolve();
+                        return;
+                    }
+                    // 2. Check disk cache (persists across process restarts)
+                    const diskBuffer = await readDiskCache(cacheKey);
+                    if (diskBuffer) {
+                        const img = await loadImage(diskBuffer);
+                        lru.set(cacheKey, img);
+                        this.loadedImage = img;
+                        this.naturalWidth = img.width;
+                        this.naturalHeight = img.height;
+                        const calculatedAspectRatio = img.width > 0 && img.height > 0 ? img.width / img.height : undefined;
+                        const finalAspectRatio = typeof this.props.aspectRatio === 'number' && this.props.aspectRatio > 0 ? this.props.aspectRatio : calculatedAspectRatio;
+                        this.node.setAspectRatio(finalAspectRatio);
+                        this.props.onLoad?.();
+                        resolve();
+                        return;
+                    }
+                    // 3. Per-render dedup cache or fresh fetch (writes to disk internally)
                     let imagePromise;
-                    if (cache && typeof this.props.src === 'string') {
-                        const cacheKey = this.props.color ? `${this.props.src}|${this.props.color}` : this.props.src;
+                    if (cache) {
                         if (!cache.has(cacheKey)) {
-                            cache.set(cacheKey, this._fetchCanvasImage());
+                            cache.set(cacheKey, this._fetchCanvasImage(cacheKey));
                         }
                         imagePromise = cache.get(cacheKey);
                     }
                     else {
-                        imagePromise = this._fetchCanvasImage();
+                        imagePromise = this._fetchCanvasImage(cacheKey);
                     }
                     const img = await imagePromise;
+                    // 4. Store in persistent LRU cache
+                    lru.set(cacheKey, img);
                     this.loadedImage = img;
                     this.naturalWidth = img.width;
                     this.naturalHeight = img.height;
@@ -317,4 +452,4 @@ const Image = (props) => ({
     props: props,
 });
 
-export { Image, ImageNode };
+export { Image, ImageLRUCache, ImageNode, disposeImageCache, getImageCache };

package/dist/esm/canvas/root.canvas.util.d.ts

@@ -7,6 +7,8 @@ export interface CanvasEngineConfig {
     workerMode?: boolean;
     /** Number of worker threads in the pool (default: os.cpus().length - 1) */
     workers?: number;
+    /** Maximum number of resolved images to keep in the persistent LRU cache (default: 128) */
+    imageCacheSize?: number;
 }
 /**
  * Configure the canvas rendering engine.

package/dist/esm/canvas/root.canvas.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"root.canvas.util.d.ts","sourceRoot":"","sources":["../../../src/canvas/root.canvas.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA8C,MAAM,aAAa,CAAA;AAEhF,OAAO,EAAE,UAAU,EAAE,OAAO,EAAW,MAAM,gCAAgC,CAAA;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAkBlF,eAAO,MAAM,qBAAqB,YAEjC,CAAA;AAOD,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,kBAAkB,QAMpD;AA4LD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAmB5D;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,UAAU;IACtC,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAoB;IAClC,8CAA8C;IAC9C,OAAO,CAAC,GAAG,CAAwC;IACnD,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAE9B;;;;OAIG;gBACS,KAAK,EAAE,SAAS,GAAG,SAAS;IAoDxC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;CA6ChC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAU,OAAO,SAAS,KAAG,OAAO,CAAC,MAAM,CAS3D,CAAA"}
+{"version":3,"file":"root.canvas.util.d.ts","sourceRoot":"","sources":["../../../src/canvas/root.canvas.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA8C,MAAM,aAAa,CAAA;AAEhF,OAAO,EAAE,UAAU,EAAE,OAAO,EAAW,MAAM,gCAAgC,CAAA;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAkBlF,eAAO,MAAM,qBAAqB,YAEjC,CAAA;AAOD,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,kBAAkB,QAWpD;AA4LD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAmB5D;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,UAAU;IACtC,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAoB;IAClC,8CAA8C;IAC9C,OAAO,CAAC,GAAG,CAAwC;IACnD,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAE9B;;;;OAIG;gBACS,KAAK,EAAE,SAAS,GAAG,SAAS;IAoDxC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;CAmDhC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAU,OAAO,SAAS,KAAG,OAAO,CAAC,MAAM,CAe3D,CAAA"}