@meonode/canvas 2.0.5 → 3.0.0

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

@@ -12,6 +12,7 @@ import { cpus } from 'node:os';
 
 /** Registry to track fonts that have already been loaded */
 const registeredFonts = new Map();
+let _fontRegistrationLock = null;
 /**
  * FinalizationRegistry to clean up WorkerCanvas instances that were not explicitly released.
  * This is a safety net — users should still call .release() explicitly.
@@ -24,25 +25,10 @@ const canvasRegistry = new FinalizationRegistry(heldValue => {
         // 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)
-        _defaultWorkerMode = options.workerMode;
-    if (options.workers !== undefined)
-        _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) {
@@ -159,6 +145,8 @@ class RootNode extends ColumnNode {
     targetHeight;
     /** Scale factor for rendering (e.g. 2 for 2x resolution) */
     scale;
+    /** Max concurrent image fetches during render (default: 5) */
+    imageConcurrency;
     /**
      * Creates a new root node for canvas rendering
      * @param props Configuration properties for the root node
@@ -172,36 +160,22 @@ class RootNode extends ColumnNode {
         if (!props.width) {
             throw new Error('Width and height are required for Root');
         }
-        // Register provided fonts with caching
-        if (props.fonts?.length) {
-            for (const font of props.fonts) {
-                const family = font.family;
-                const paths = font.paths.map(p => path.resolve(p));
-                if (!registeredFonts.has(family)) {
-                    registeredFonts.set(family, new Set());
-                }
-                const cachedPaths = registeredFonts.get(family);
-                const newPaths = paths.filter(p => !cachedPaths.has(p) && fs.existsSync(p));
-                if (newPaths.length > 0) {
-                    FontLibrary.use({ [family]: newPaths });
-                    newPaths.forEach(p => cachedPaths.add(p));
-                }
-            }
-        }
         // Set up scale and width
         this.scale = props.scale || 1;
         this.targetWidth = props.width;
         this.targetHeight = props.height;
+        this.imageConcurrency = props.imageConcurrency ?? 5;
         this.node.setWidth(this.targetWidth);
         // Convert any CanvasElement children to actual BoxNode instances
         if (this.props.children) {
             const childArray = Array.isArray(this.props.children) ? this.props.children : [this.props.children];
-            this.props.children = childArray.map(child => {
+            const converted = childArray.map(child => {
                 if (child && typeof child === 'object' && '__type' in child) {
                     return buildTree(child);
                 }
                 return child;
             });
+            this.props.children = converted;
         }
         // Initialize children nodes
         this.processInitialChildren();
@@ -213,8 +187,9 @@ class RootNode extends ColumnNode {
     findAllImageNodes() {
         const imageNodes = [];
         const queue = [this];
-        while (queue.length > 0) {
-            const node = queue.shift();
+        let head = 0;
+        while (head < queue.length) {
+            const node = queue[head++];
             if (node instanceof ImageNode) {
                 imageNodes.push(node);
             }
@@ -222,12 +197,46 @@ class RootNode extends ColumnNode {
         }
         return imageNodes;
     }
+    /**
+     * Registers fonts with serialization to prevent duplicate FontLibrary.use() calls
+     * when multiple Root() instances are created concurrently.
+     */
+    async _registerFonts() {
+        if (!this.props.fonts?.length)
+            return;
+        // Wait for any in-flight registration to complete
+        if (_fontRegistrationLock)
+            await _fontRegistrationLock;
+        _fontRegistrationLock = (async () => {
+            try {
+                for (const font of this.props.fonts) {
+                    const family = font.family;
+                    const paths = font.paths.map(p => path.resolve(p));
+                    if (!registeredFonts.has(family)) {
+                        registeredFonts.set(family, new Set());
+                    }
+                    const cachedPaths = registeredFonts.get(family);
+                    const newPaths = paths.filter(p => !cachedPaths.has(p) && fs.existsSync(p));
+                    if (newPaths.length > 0) {
+                        FontLibrary.use({ [family]: newPaths });
+                        newPaths.forEach(p => cachedPaths.add(p));
+                    }
+                }
+            }
+            finally {
+                _fontRegistrationLock = null;
+            }
+        })();
+        await _fontRegistrationLock;
+    }
     async render(ctx, offsetX = 0, offsetY = 0) {
         // If ctx is provided, delegate to parent render (used when called as a child node)
         if (ctx) {
             await super.render(ctx, offsetX, offsetY);
             return;
         }
+        // Register fonts with serialization to prevent duplicate FontLibrary.use() across concurrent Root() calls
+        await this._registerFonts();
         const diskCacheKeys = this.props.useDiskCache ? new Set() : undefined;
         try {
             // Step 1: Load all images with a concurrency limit to avoid overwhelming remote sources.
@@ -235,15 +244,20 @@ class RootNode extends ColumnNode {
             const imageNodes = this.findAllImageNodes();
             if (imageNodes.length > 0) {
                 const imageCache = new Map();
-                const CONCURRENCY = 5;
                 const queue = [...imageNodes];
-                const workers = Array.from({ length: Math.min(CONCURRENCY, queue.length) }, async () => {
-                    while (queue.length > 0) {
-                        const node = queue.shift();
+                let qIdx = 0;
+                const workers = Array.from({ length: Math.min(this.imageConcurrency, queue.length) }, async () => {
+                    while (qIdx < queue.length) {
+                        const node = queue[qIdx++];
                         await node.load(imageCache, diskCacheKeys);
                     }
                 });
-                await Promise.allSettled(workers);
+                await Promise.allSettled(workers).then(results => {
+                    results.forEach(r => {
+                        if (r.status === 'rejected')
+                            console.warn('[RootNode] Image load worker failed:', r.reason);
+                    });
+                });
             }
             // Step 2: Calculate initial layout
             this.node.calculateLayout(this.targetWidth, undefined, Style.Direction.LTR);
@@ -275,9 +289,9 @@ class RootNode extends ColumnNode {
     }
 }
 async function Root(props) {
-    // Determine worker mode: props override legacy configure()
-    const workerMode = props.workerMode ?? _defaultWorkerMode;
-    const workerPoolSize = props.workers ?? _defaultWorkerPoolSize;
+    // Determine worker mode
+    const workerMode = props.workerMode ?? true;
+    const workerPoolSize = props.workers ?? Math.max(1, cpus().length - 1);
     if (workerMode) {
         // Lazy initialize worker pool — dynamic import to avoid loading Comlink in non-worker contexts
         if (!_workerPool) {
@@ -291,4 +305,4 @@ async function Root(props) {
     return new RootNode(props).render();
 }
 
-export { Root, RootNode, buildTree, configure, terminate };
+export { Root, RootNode, buildTree, terminate };

package/dist/esm/canvas/text.canvas.d.ts

@@ -1,6 +1,6 @@
-import type { TextProps, CanvasElement } from '../canvas/canvas.type.js';
+import type { TextProps, CanvasElement } from './canvas.type.js';
 import { type CanvasRenderingContext2D } from 'skia-canvas';
-import { BoxNode } from '../canvas/layout.canvas.js';
+import { BoxNode } from './layout.canvas.js';
 /**
  * Node for rendering text content with rich text styling support
  * Supports color and weight variations through HTML-like tags
@@ -140,7 +140,11 @@ export declare class TextNode extends BoxNode {
      */
     private measureSpaceWidth;
     /**
-     * Renders multi-line text content with rich text styling and layout features
+     * Applies this.props.fontVariant to the context, or resets to 'normal'.
+     * Centralizes the type guard + warn pattern repeated across measure/render paths.
+     */
+    private _applyFontVariant;
+    /**
      *
      * Core features:
      * - Dynamic line heights with leading/spacing controls

package/dist/esm/canvas/text.canvas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.canvas.d.ts","sourceRoot":"","sources":["../../../src/canvas/text.canvas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAe,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACpF,OAAO,EAAU,KAAK,wBAAwB,EAA2B,MAAM,aAAa,CAAA;AAC5F,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAGnD;;;GAGG;AACH,qBAAa,QAAS,SAAQ,OAAO;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAwC;IACzE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,kBAAkB,CAAe;IAEjC,KAAK,EAAE,SAAS,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;gBAElC,IAAI,GAAE,MAAM,GAAG,MAAW,EAAE,KAAK,GAAE,SAAc;IAuB7D;;;;;;;;OAQG;WACW,gBAAgB,CAC5B,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,GAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,UAAU,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAA;QACpC,SAAS,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAA;QAClC,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,SAAS,CAAC,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAA;QACjD,YAAY,CAAC,EAAE,wBAAwB,CAAC,cAAc,CAAC,CAAA;KACnD;cAwBW,aAAa,IAAI,IAAI;IAoDxC;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,sBAAsB;IA8B9B;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,aAAa;IA+ErB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,gBAAgB;IAyBxB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;IAiCrB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAQjC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,WAAW;IA+NnB;;;;;;;;;OASG;IACH,OAAO,CAAC,YAAY;IA6KpB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAmErB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;;;;;;;;;;;;;OAgBG;cACsB,cAAc,CAAC,GAAG,EAAE,wBAAwB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAkX3H;AAED;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,GAAG,MAAM,EAAE,QAAQ,SAAS,KAAG,aAI9D,CAAA"}
+{"version":3,"file":"text.canvas.d.ts","sourceRoot":"","sources":["../../../src/canvas/text.canvas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAe,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACpF,OAAO,EAAU,KAAK,wBAAwB,EAA2B,MAAM,aAAa,CAAA;AAC5F,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAGnD;;;GAGG;AACH,qBAAa,QAAS,SAAQ,OAAO;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAwC;IACzE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,kBAAkB,CAAe;IAEjC,KAAK,EAAE,SAAS,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;gBAElC,IAAI,GAAE,MAAM,GAAG,MAAW,EAAE,KAAK,GAAE,SAAc;IAuB7D;;;;;;;;OAQG;WACW,gBAAgB,CAC5B,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,GAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,UAAU,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAA;QACpC,SAAS,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAA;QAClC,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,SAAS,CAAC,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAA;QACjD,YAAY,CAAC,EAAE,wBAAwB,CAAC,cAAc,CAAC,CAAA;KACnD;cAwBW,aAAa,IAAI,IAAI;IAoDxC;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,sBAAsB;IA8B9B;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,aAAa;IA+ErB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,gBAAgB;IAyBxB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;IAiCrB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAQjC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,WAAW;IA4LnB;;;;;;;;;OASG;IACH,OAAO,CAAC,YAAY;IA6KpB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAmErB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;;;;;;;;;;;;;OAeG;cACsB,cAAc,CAAC,GAAG,EAAE,wBAAwB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAoW3H;AAED;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,GAAG,MAAM,EAAE,QAAQ,SAAS,KAAG,aAI9D,CAAA"}

package/dist/esm/canvas/text.canvas.js

@@ -352,18 +352,7 @@ class TextNode extends BoxNode {
         // Pre-measure each text segment width with its specific styling
         for (const segment of this.segments) {
             ctx.font = this.getFontString(segment);
-            if (typeof this.props.fontVariant === 'string') {
-                ctx.fontVariant = this.props.fontVariant;
-            }
-            else if (this.props.fontVariant !== undefined) {
-                console.warn(`[TextNode ${this.key || ''}] Invalid fontVariant prop type in measureText (segment width):`, this.props.fontVariant);
-                if (ctx.fontVariant !== 'normal')
-                    ctx.fontVariant = 'normal';
-            }
-            else {
-                if (ctx.fontVariant !== 'normal')
-                    ctx.fontVariant = 'normal';
-            }
+            this._applyFontVariant(ctx, 'measureText (segment width)');
             segment.width = this.addLetterSpacingExtra(segment.text, ctx.measureText(segment.text).width, parsedLetterSpacingPx);
         }
         // Calculate available layout width
@@ -387,18 +376,7 @@ class TextNode extends BoxNode {
             // Handle empty line metrics
             if (line.length === 0) {
                 ctx.font = this.getFontString();
-                if (typeof this.props.fontVariant === 'string') {
-                    ctx.fontVariant = this.props.fontVariant;
-                }
-                else if (this.props.fontVariant !== undefined) {
-                    console.warn(`[TextNode ${this.key || ''}] Invalid fontVariant prop type in measureText (empty line):`, this.props.fontVariant);
-                    if (ctx.fontVariant !== 'normal')
-                        ctx.fontVariant = 'normal';
-                }
-                else {
-                    if (ctx.fontVariant !== 'normal')
-                        ctx.fontVariant = 'normal';
-                }
+                this._applyFontVariant(ctx, 'measureText (empty line)');
                 const metrics = ctx.measureText(this.metricsString);
                 maxAscent = metrics.actualBoundingBoxAscent ?? baseFontSize * 0.8;
                 maxDescent = metrics.actualBoundingBoxDescent ?? baseFontSize * 0.2;
@@ -412,18 +390,7 @@ class TextNode extends BoxNode {
                     const segmentSize = segment.size || baseFontSize;
                     maxFontSizeOnLine = Math.max(maxFontSizeOnLine, segmentSize);
                     ctx.font = this.getFontString(segment);
-                    if (typeof this.props.fontVariant === 'string') {
-                        ctx.fontVariant = this.props.fontVariant;
-                    }
-                    else if (this.props.fontVariant !== undefined) {
-                        console.warn(`[TextNode ${this.key || ''}] Invalid fontVariant prop type in measureText (segment height):`, this.props.fontVariant);
-                        if (ctx.fontVariant !== 'normal')
-                            ctx.fontVariant = 'normal';
-                    }
-                    else {
-                        if (ctx.fontVariant !== 'normal')
-                            ctx.fontVariant = 'normal';
-                    }
+                    this._applyFontVariant(ctx, 'measureText (segment height)');
                     const metrics = ctx.measureText(this.metricsString);
                     const ascent = metrics.actualBoundingBoxAscent ?? segmentSize * 0.8;
                     const descent = metrics.actualBoundingBoxDescent ?? segmentSize * 0.2;
@@ -434,18 +401,7 @@ class TextNode extends BoxNode {
             // Fallback metrics for lines with only whitespace
             if (maxAscent === 0 && maxDescent === 0 && line.length > 0) {
                 ctx.font = this.getFontString();
-                if (typeof this.props.fontVariant === 'string') {
-                    ctx.fontVariant = this.props.fontVariant;
-                }
-                else if (this.props.fontVariant !== undefined) {
-                    console.warn(`[TextNode ${this.key || ''}] Invalid fontVariant prop type in measureText (fallback):`, this.props.fontVariant);
-                    if (ctx.fontVariant !== 'normal')
-                        ctx.fontVariant = 'normal';
-                }
-                else {
-                    if (ctx.fontVariant !== 'normal')
-                        ctx.fontVariant = 'normal';
-                }
+                this._applyFontVariant(ctx, 'measureText (fallback)');
                 const metrics = ctx.measureText(this.metricsString);
                 maxAscent = metrics.actualBoundingBoxAscent ?? baseFontSize * 0.8;
                 maxDescent = metrics.actualBoundingBoxDescent ?? baseFontSize * 0.2;
@@ -478,18 +434,7 @@ class TextNode extends BoxNode {
                 if (/^\s+$/.test(word))
                     continue;
                 ctx.font = this.getFontString(segment);
-                if (typeof this.props.fontVariant === 'string') {
-                    ctx.fontVariant = this.props.fontVariant;
-                }
-                else if (this.props.fontVariant !== undefined) {
-                    console.warn(`[TextNode ${this.key || ''}] Invalid fontVariant prop type in measureText (single line width):`, this.props.fontVariant);
-                    if (ctx.fontVariant !== 'normal')
-                        ctx.fontVariant = 'normal';
-                }
-                else {
-                    if (ctx.fontVariant !== 'normal')
-                        ctx.fontVariant = 'normal';
-                }
+                this._applyFontVariant(ctx, 'measureText (single line width)');
                 const wordWidth = this.addLetterSpacingExtra(word, ctx.measureText(word).width, parsedLetterSpacingPx);
                 if (!firstWordInSingleLine) {
                     singleLineWidth += spaceWidth + parsedWordSpacingPx;
@@ -800,7 +745,24 @@ class TextNode extends BoxNode {
         return width > 0 ? width : (this.props.fontSize || 16) * 0.3;
     }
     /**
-     * Renders multi-line text content with rich text styling and layout features
+     * Applies this.props.fontVariant to the context, or resets to 'normal'.
+     * Centralizes the type guard + warn pattern repeated across measure/render paths.
+     */
+    _applyFontVariant(ctx, context) {
+        if (typeof this.props.fontVariant === 'string') {
+            ctx.fontVariant = this.props.fontVariant;
+        }
+        else if (this.props.fontVariant !== undefined) {
+            console.warn(`[TextNode ${this.key || ''}] Invalid fontVariant prop type in ${context}:`, this.props.fontVariant);
+            if (ctx.fontVariant !== 'normal')
+                ctx.fontVariant = 'normal';
+        }
+        else {
+            if (ctx.fontVariant !== 'normal')
+                ctx.fontVariant = 'normal';
+        }
+    }
+    /**
      *
      * Core features:
      * - Dynamic line heights with leading/spacing controls
@@ -1040,18 +1002,7 @@ class TextNode extends BoxNode {
                     // Apply segment styles
                     ctx.font = this.getFontString(segment);
                     ctx.fillStyle = segment.color || this.props.color || 'black';
-                    if (typeof this.props.fontVariant === 'string') {
-                        ctx.fontVariant = this.props.fontVariant;
-                    }
-                    else if (this.props.fontVariant !== undefined) {
-                        console.warn(`[TextNode ${this.key || ''}] Invalid fontVariant prop type in _renderContent (segment render):`, this.props.fontVariant);
-                        if (ctx.fontVariant !== 'normal')
-                            ctx.fontVariant = 'normal';
-                    }
-                    else {
-                        if (ctx.fontVariant !== 'normal')
-                            ctx.fontVariant = 'normal';
-                    }
+                    this._applyFontVariant(ctx, '_renderContent (segment render)');
                     // Handle text truncation and ellipsis
                     let textToDraw = segment.text;
                     let currentSegmentRenderWidth = segmentWidth;
@@ -1119,18 +1070,7 @@ class TextNode extends BoxNode {
                         if (ellipsisRemainingWidth >= ellipsisWidth) {
                             ctx.save();
                             ctx.font = this.getFontString(ellipsisStyle);
-                            if (typeof this.props.fontVariant === 'string') {
-                                ctx.fontVariant = this.props.fontVariant;
-                            }
-                            else if (this.props.fontVariant !== undefined) {
-                                console.warn(`[TextNode ${this.key || ''}] Invalid fontVariant prop type in _renderContent (ellipsis draw):`, this.props.fontVariant);
-                                if (ctx.fontVariant !== 'normal')
-                                    ctx.fontVariant = 'normal';
-                            }
-                            else {
-                                if (ctx.fontVariant !== 'normal')
-                                    ctx.fontVariant = 'normal';
-                            }
+                            this._applyFontVariant(ctx, '_renderContent (ellipsis draw)');
                             ctx.fillStyle = ellipsisStyle?.color || this.props.color || 'black';
                             ctx.fillText(ellipsisChar, currentX, lineY, Math.max(0, ellipsisRemainingWidth + 1));
                             ctx.restore();

package/dist/esm/index.d.ts

@@ -3,9 +3,9 @@ export * from './canvas/canvas.type.js';
 export { Box, Column, Row, type BoxNode } from './canvas/layout.canvas.js';
 export { Image } from './canvas/image.canvas.js';
 export { Text } from './canvas/text.canvas.js';
-export { Root, configure, terminate } from './canvas/root.canvas.js';
+export { Root, terminate } from './canvas/root.canvas.js';
 export { GridItem } from './canvas/grid.canvas.js';
 export { Grid } from './canvas/grid.canvas.js';
 export { Chart } from './canvas/chart.canvas.js';
-export { clearDiskCache } from './util/disk.cache.js';
+export { clearDiskCache, setDiskCacheDir } 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,2BAA2B,CAAA;AAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,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,2BAA2B,CAAA;AAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/esm/index.js

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

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

@@ -1,3 +1,8 @@
+/**
+ * Override the default disk cache directory.
+ * Must be called before any cache read/write operations.
+ */
+export declare function setDiskCacheDir(dir: string): void;
 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>;

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

@@ -1 +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,CAOpD"}
+{"version":3,"file":"disk.cache.d.ts","sourceRoot":"","sources":["../../../src/util/disk.cache.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGjD;AAQD,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,CAShE;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAUpD"}

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

@@ -2,12 +2,20 @@ import { createHash } from 'crypto';
 import { promises } from 'fs';
 import { join } from 'path';
 
-const CACHE_DIR = join(process.cwd(), '.cache', 'files');
+let _cacheDir = join(process.cwd(), '.cache', 'files');
 let _dirEnsured = false;
+/**
+ * Override the default disk cache directory.
+ * Must be called before any cache read/write operations.
+ */
+function setDiskCacheDir(dir) {
+    _cacheDir = dir;
+    _dirEnsured = false;
+}
 async function ensureDir() {
     if (_dirEnsured)
         return;
-    await promises.mkdir(CACHE_DIR, { recursive: true });
+    await promises.mkdir(_cacheDir, { recursive: true });
     _dirEnsured = true;
 }
 function hashBuffer(buf) {
@@ -16,7 +24,7 @@ function hashBuffer(buf) {
 async function readDiskCache(key) {
     try {
         await ensureDir();
-        return await promises.readFile(join(CACHE_DIR, key));
+        return await promises.readFile(join(_cacheDir, key));
     }
     catch {
         return null;
@@ -25,7 +33,7 @@ async function readDiskCache(key) {
 async function writeDiskCache(key, data) {
     try {
         await ensureDir();
-        await promises.writeFile(join(CACHE_DIR, key), data);
+        await promises.writeFile(join(_cacheDir, key), data);
     }
     catch {
         // best-effort — cache write failures are non-fatal
@@ -33,10 +41,13 @@ async function writeDiskCache(key, data) {
 }
 async function deleteDiskCache(key) {
     try {
-        await promises.unlink(join(CACHE_DIR, key));
+        await promises.unlink(join(_cacheDir, key));
     }
-    catch {
+    catch (err) {
         // non-fatal — file may not exist if write failed earlier
+        if (err.code !== 'ENOENT') {
+            console.warn(`[disk.cache] Failed to delete cache entry "${key}":`, err.message);
+        }
     }
 }
 /**
@@ -46,10 +57,13 @@ async function deleteDiskCache(key) {
 async function clearDiskCache() {
     _dirEnsured = false;
     try {
-        await promises.rm(CACHE_DIR, { recursive: true, force: true });
+        await promises.rm(_cacheDir, { recursive: true, force: true });
     }
-    catch {
+    catch (err) {
         // non-fatal — directory may not exist
+        if (err.code !== 'ENOENT') {
+            console.warn('[disk.cache] Failed to clear cache directory:', err.message);
+        }
     }
 }
 // Clean up disk cache on process exit to handle crashes mid-render.
@@ -69,4 +83,4 @@ const cleanupOnExit = () => {
 process.on('SIGINT', cleanupOnExit);
 process.on('SIGTERM', cleanupOnExit);
 
-export { clearDiskCache, deleteDiskCache, hashBuffer, readDiskCache, writeDiskCache };
+export { clearDiskCache, deleteDiskCache, hashBuffer, readDiskCache, setDiskCacheDir, writeDiskCache };

package/dist/esm/worker/comlink.pool.d.ts

@@ -1,4 +1,4 @@
-import type { RenderResult } from '../worker/worker.types.js';
+import type { RenderResult } from './worker.types.js';
 import type { RootProps } from '../canvas/canvas.type.js';
 export interface PoolRenderResult extends RenderResult {
     workerIdx: number;

package/dist/esm/worker/comlink.pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comlink.pool.d.ts","sourceRoot":"","sources":["../../../src/worker/comlink.pool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAa,YAAY,EAAU,MAAM,0BAA0B,CAAA;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,SAAS,EAAE,MAAM,CAAA;CAClB;AASD,oFAAoF;AACpF,eAAO,MAAM,SAAS,kBAAkB,CAAA;AAExC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,EAAE,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,CAAC,CAuB7H;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAuB3G;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,KAAK,CAAmB;gBAEpB,IAAI,EAAE,MAAM;IAYxB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,KAAK;YAQC,aAAa;IAiBrB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuDzD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAInH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIxD,SAAS;CAOV"}
+{"version":3,"file":"comlink.pool.d.ts","sourceRoot":"","sources":["../../../src/worker/comlink.pool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAa,YAAY,EAAU,MAAM,0BAA0B,CAAA;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,SAAS,EAAE,MAAM,CAAA;CAClB;AASD,oFAAoF;AACpF,eAAO,MAAM,SAAS,kBAAkB,CAAA;AAExC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,EAAE,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,CAAC,CAuB7H;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAuB3G;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,KAAK,CAAmB;gBAEpB,IAAI,EAAE,MAAM;IAYxB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,KAAK;YAQC,aAAa;IAiBrB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2DzD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAInH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIxD,SAAS;CAOV"}

package/dist/esm/worker/comlink.pool.js

@@ -114,6 +114,9 @@ class ComlinkPool {
         }
     }
     async render(props) {
+        if (this.endpoints.length === 0) {
+            throw new Error('[ComlinkPool] Pool has been terminated');
+        }
         // Extract functions from props, replacing them with serializable sentinels.
         // A single Comlink.proxy() callback is created at the top level so Comlink
         // can correctly transfer it via its proxy transfer handler.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meonode/canvas",
-  "version": "2.0.5",
+  "version": "3.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",
@@ -37,9 +37,10 @@
     }
   },
   "scripts": {
-    "build": "rm -rf ./dist && rollup -c --bundleConfigAsCjs && tsc-alias -p tsconfig.esm.json && tsc-alias -p tsconfig.cjs.json",
-    "test": "node --no-experimental-webstorage --experimental-vm-modules $(yarn bin jest)",
-    "lint": "eslint . --ext .ts,.tsx,.js,.jsx,.mjs --fix",
+    "build": "bun -e \"fs.rmSync('./dist', {recursive:true, force:true})\" && rollup -c --bundleConfigAsCjs && bun scripts/rewrite-dts-aliases.ts",
+    "test": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --ext .ts,.tsx,.js,.jsx,.mjs --fix && bun run typecheck",
     "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",
@@ -47,7 +48,6 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.4",
-    "@jest/globals": "^30.3.0",
     "@rollup/plugin-commonjs": "^29.0.2",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-typescript": "^12.3.0",
@@ -56,37 +56,30 @@
     "@semantic-release/gitlab": "^13.3.2",
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.0",
-    "@types/jest": "^30.0.0",
-    "@types/lodash-es": "^4.17.12",
     "@types/node": "^25.5.0",
     "@types/sharp": "^0.32.0",
-    "@types/tinycolor2": "^1.4.6",
     "@typescript-eslint/eslint-plugin": "^8.57.2",
     "@typescript-eslint/parser": "^8.57.2",
+    "@vitest/coverage-v8": "^3.2.4",
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-jsdoc": "^62.8.1",
     "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-unused-imports": "^4.4.1",
     "husky": "^9.1.7",
-    "jest": "^30.3.0",
     "prettier": "^3.8.1",
     "rollup": "^4.60.0",
     "rollup-plugin-tsconfig-paths": "^1.5.2",
-    "semantic-release": "^25.0.3",
-    "ts-jest": "^29.4.6",
-    "tsc-alias": "^1.8.16",
+    "semantic-release": "24.2.9",
     "typescript": "^6.0.2",
-    "typescript-eslint": "^8.57.2"
+    "typescript-eslint": "^8.57.2",
+    "vitest": "^3.2.4"
   },
-  "packageManager": "yarn@4.11.0",
   "dependencies": {
     "comlink": "^4.4.2",
     "file-type": "^22.0.0",
-    "lodash-es": "^4.17.23",
     "sharp": "^0.34.5",
     "skia-canvas": "^3.0.8",
-    "tinycolor2": "^1.6.0",
     "tslib": "^2.8.1",
     "yoga-layout": "^3.2.1"
   },