@meonode/canvas 1.7.1 → 2.0.0

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

@@ -1,6 +1,7 @@
 import { FontLibrary, Canvas } from 'skia-canvas';
 import { ColumnNode, RowNode, BoxNode } from './layout.canvas.util.js';
-import { ImageNode, disposeImageCache, getImageCache } from './image.canvas.util.js';
+import { ImageNode } from './image.canvas.util.js';
+import { deleteDiskCache } from '../util/disk.cache.js';
 import { TextNode } from './text.canvas.util.js';
 import { ChartNode } from './chart.canvas.util.js';
 import { GridItemNode, GridNode } from './grid.canvas.util.js';
@@ -14,26 +15,48 @@ import { fileURLToPath } from 'node:url';
 
 /** Registry to track fonts that have already been loaded */
 const registeredFonts = new Map();
-/** Engine configuration */
-let _workerMode = true;
-let _workerPoolSize = Math.max(1, cpus().length - 1);
+/**
+ * FinalizationRegistry to clean up WorkerCanvas instances that were not explicitly released.
+ * This is a safety net — users should still call .release() explicitly.
+ */
+const canvasRegistry = new FinalizationRegistry(heldValue => {
+    // Best-effort cleanup — worker may already be terminated
+    try {
+        // Access workers via a public method or make it accessible
+        // For now, just try to send the message and let errors be caught
+        if (_workerPool) {
+            ;
+            _workerPool.workers?.[heldValue.workerIdx]?.postMessage({ type: 'release', canvasId: heldValue.canvasId });
+        }
+    }
+    catch {
+        // Worker already gone — nothing to clean up
+    }
+});
+/** Engine configuration — legacy support for configure() */
+let _defaultWorkerMode = true;
+let _defaultWorkerPoolSize = Math.max(1, cpus().length - 1);
 let _workerPool = null;
 /**
  * Configure the canvas rendering engine.
  * Call this once at application startup before rendering.
+ * @deprecated Pass workerMode and workers directly to Root() props instead.
  */
 function configure(options) {
     if (options.workerMode !== undefined)
-        _workerMode = options.workerMode;
+        _defaultWorkerMode = options.workerMode;
     if (options.workers !== undefined)
-        _workerPoolSize = options.workers;
-    if (options.imageCacheSize !== undefined) {
-        // Dispose existing cache and create a new one with the specified size
-        disposeImageCache();
-        getImageCache(options.imageCacheSize);
-    }
-    if (_workerMode) {
-        _workerPool = new WorkerPool(_workerPoolSize);
+        _defaultWorkerPoolSize = options.workers;
+}
+/**
+ * Terminate all worker pools and free worker thread resources.
+ * Call this when shutting down a long-running server to clean up immediately.
+ * After calling, you must call configure() again before rendering.
+ */
+function terminate() {
+    if (_workerPool) {
+        _workerPool.terminate();
+        _workerPool = null;
     }
 }
 /**
@@ -55,6 +78,8 @@ class WorkerCanvas {
         this._pool = opts.pool;
         this._workerIdx = opts.workerIdx;
         this._canvasId = opts.canvasId;
+        // Register for finalizer-based cleanup if user forgets to call .release()
+        canvasRegistry.register(this, { workerIdx: opts.workerIdx, canvasId: opts.canvasId }, this);
     }
     _call(method, ...args) {
         return this._pool.callOnCanvas(this._workerIdx, this._canvasId, method, args);
@@ -105,6 +130,8 @@ class WorkerCanvas {
     /** Release the Canvas from worker memory. Call when done with this object. */
     release() {
         this._pool.releaseCanvas(this._workerIdx, this._canvasId);
+        // Unregister from finalizer since we're explicitly cleaning up
+        canvasRegistry.unregister(this);
     }
 }
 /** Worker thread pool — routes render and canvas-call messages */
@@ -118,7 +145,7 @@ class WorkerPool {
         this.init(size);
     }
     init(size) {
-        const workerFile = path.join(path.dirname(fileURLToPath(import.meta.url)), '../render.worker.js');
+        const workerFile = path.join(path.dirname(fileURLToPath(import.meta.url)), '../worker/render.worker.js');
         for (let i = 0; i < size; i++) {
             const workerIdx = i;
             const worker = new Worker(workerFile);
@@ -295,6 +322,7 @@ class RootNode extends ColumnNode {
      * @returns Promise resolving to the rendered Canvas instance
      */
     async render() {
+        const diskCacheKeys = this.props.useDiskCache ? new Set() : undefined;
         try {
             // Step 1: Load all images with a concurrency limit to avoid overwhelming remote sources.
             // A per-render cache deduplicates identical src+color combinations within this render pass.
@@ -306,7 +334,7 @@ class RootNode extends ColumnNode {
                 const workers = Array.from({ length: Math.min(CONCURRENCY, queue.length) }, async () => {
                     while (queue.length > 0) {
                         const node = queue.shift();
-                        await node.load(imageCache);
+                        await node.load(imageCache, diskCacheKeys);
                     }
                 });
                 await Promise.allSettled(workers);
@@ -334,35 +362,26 @@ class RootNode extends ColumnNode {
             return this.canvas;
         }
         finally {
-            // Always clear the persistent image cache after render (success or error)
-            // so resolved CanvasImage references don't outlive the render pass.
-            disposeImageCache();
+            if (diskCacheKeys?.size) {
+                await Promise.allSettled([...diskCacheKeys].map(key => deleteDiskCache(key)));
+            }
         }
     }
 }
-/**
- * Creates and renders a new root node with the given properties.
- * When worker mode is enabled via configure(), rendering runs in a worker thread
- * and the returned object implements the same toBuffer/toBufferSync interface.
- * @param props Configuration properties for the root node
- * @returns Promise resolving to the rendered Canvas (or WorkerCanvas in worker mode)
- */
-const Root = async (props) => {
-    try {
-        if (_workerMode) {
-            if (!_workerPool) {
-                _workerPool = new WorkerPool(_workerPoolSize);
-            }
-            const result = await _workerPool.render(props);
-            return new WorkerCanvas({ ...result, pool: _workerPool });
+async function Root(props) {
+    // Determine worker mode: props override legacy configure()
+    const workerMode = props.workerMode ?? _defaultWorkerMode;
+    const workerPoolSize = props.workers ?? _defaultWorkerPoolSize;
+    if (workerMode) {
+        // Lazy initialize worker pool
+        if (!_workerPool) {
+            _workerPool = new WorkerPool(workerPoolSize);
         }
-        return await new RootNode(props).render();
+        const result = await _workerPool.render(props);
+        return new WorkerCanvas({ ...result, pool: _workerPool });
     }
-    catch (err) {
-        // Ensure cache is cleared even if Root-level orchestration fails
-        disposeImageCache();
-        throw err;
-    }
-};
+    // Non-worker mode — render directly and return Canvas
+    return new RootNode(props).render();
+}
 
-export { Root, RootNode, buildTree, configure };
+export { Root, RootNode, buildTree, configure, terminate };

package/dist/esm/index.d.ts

@@ -1,10 +1,11 @@
 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, disposeImageCache } from './canvas/image.canvas.util.js';
+export { Image } from './canvas/image.canvas.util.js';
 export { Text } from './canvas/text.canvas.util.js';
-export { Root, configure } from './canvas/root.canvas.util.js';
+export { Root, configure, terminate } from './canvas/root.canvas.util.js';
 export { GridItem } from './canvas/grid.canvas.util.js';
 export { Grid } from './canvas/grid.canvas.util.js';
 export { Chart } from './canvas/chart.canvas.util.js';
+export { clearDiskCache } from './util/disk.cache.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/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,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"}
+{"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,SAAS,EAAE,MAAM,8BAA8B,CAAA;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/esm/index.js

@@ -1,8 +1,9 @@
 export { Border, Style } from './constant/common.const.js';
 export { Box, Column, Row } from './canvas/layout.canvas.util.js';
-export { Image, disposeImageCache } from './canvas/image.canvas.util.js';
+export { Image } from './canvas/image.canvas.util.js';
 export { Text } from './canvas/text.canvas.util.js';
-export { Root, configure } from './canvas/root.canvas.util.js';
+export { Root, configure, terminate } from './canvas/root.canvas.util.js';
 export { Grid, GridItem } from './canvas/grid.canvas.util.js';
 export { Chart } from './canvas/chart.canvas.util.js';
+export { clearDiskCache } from './util/disk.cache.js';
 export * from 'yoga-layout';

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

@@ -0,0 +1,10 @@
+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>;
+export declare function deleteDiskCache(key: string): Promise<void>;
+/**
+ * Delete the entire disk cache directory.
+ * Called on process exit to clean up any orphaned cache files.
+ */
+export declare function clearDiskCache(): Promise<void>;
+//# sourceMappingURL=disk.cache.d.ts.map

package/dist/esm/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;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhE;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAMpD"}

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

@@ -0,0 +1,66 @@
+import { createHash } from 'crypto';
+import { promises } from 'fs';
+import { join } from 'path';
+
+const CACHE_DIR = join(process.cwd(), '.cache', 'files');
+let _dirEnsured = false;
+async function ensureDir() {
+    if (_dirEnsured)
+        return;
+    await promises.mkdir(CACHE_DIR, { recursive: true });
+    _dirEnsured = true;
+}
+function hashBuffer(buf) {
+    return createHash('sha256').update(buf).digest('hex');
+}
+async function readDiskCache(key) {
+    try {
+        await ensureDir();
+        return await promises.readFile(join(CACHE_DIR, key));
+    }
+    catch {
+        return null;
+    }
+}
+async function writeDiskCache(key, data) {
+    try {
+        await ensureDir();
+        await promises.writeFile(join(CACHE_DIR, key), data);
+    }
+    catch {
+        // best-effort — cache write failures are non-fatal
+    }
+}
+async function deleteDiskCache(key) {
+    try {
+        await promises.unlink(join(CACHE_DIR, key));
+    }
+    catch {
+        // non-fatal — file may not exist if write failed earlier
+    }
+}
+/**
+ * Delete the entire disk cache directory.
+ * Called on process exit to clean up any orphaned cache files.
+ */
+async function clearDiskCache() {
+    try {
+        await promises.rm(CACHE_DIR, { recursive: true, force: true });
+    }
+    catch {
+        // non-fatal — directory may not exist
+    }
+}
+// Clean up disk cache on process exit to handle crashes mid-render
+process.on('beforeExit', () => {
+    // Fire and forget — best effort cleanup
+    clearDiskCache();
+});
+// Also clean up on SIGINT/SIGTERM for graceful shutdowns
+const cleanupOnExit = () => {
+    clearDiskCache().finally(() => process.exit(0));
+};
+process.on('SIGINT', cleanupOnExit);
+process.on('SIGTERM', cleanupOnExit);
+
+export { clearDiskCache, deleteDiskCache, hashBuffer, readDiskCache, writeDiskCache };

package/dist/esm/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/esm/{render.worker.js → worker/render.worker.js}

@@ -1,5 +1,5 @@
 import { parentPort } from 'worker_threads';
-import { RootNode } from './canvas/root.canvas.util.js';
+import { RootNode } from '../canvas/root.canvas.util.js';
 
 /**
  * Worker thread entry point for off-main-thread canvas rendering.

package/dist/{cjs/canvas → esm/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meonode/canvas",
-  "version": "1.7.1",
+  "version": "2.0.0",
   "description": "A declarative, component-based library for server-side canvas image generation. Write complex visuals with simple functions, similar to the composition style of @meonode/ui.",
   "keywords": [
     "canvas",
@@ -42,6 +42,7 @@
     "lint": "eslint . --ext .ts,.tsx,.js,.jsx,.mjs --fix",
     "format": "prettier --write .",
     "generate:samples": "npx tsx scripts/generate_sample_charts.ts && npx tsx scripts/generate_sample_grids.ts && npx tsx scripts/generate_sample_nested_grids.ts",
+    "check:memory": "npx tsx --expose-gc scripts/check_memory.ts",
     "prepare": "husky"
   },
   "devDependencies": {

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"render.worker.js","sources":["../../../src/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 '@/canvas/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/render.worker.d.ts.map

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