@meonode/canvas 2.0.4 → 3.0.0

package/dist/esm/canvas/layout.canvas.js

@@ -1,10 +1,9 @@
 import { Canvas } from 'skia-canvas';
 import { parsePercentage, parseBorderRadius, drawRoundedRectPath, drawBorders } from './canvas.helper.js';
-import { omit } from 'lodash-es';
-import tinycolor from 'tinycolor2';
 import { Style } from '../constant/common.const.js';
 import YogaTypes__default from 'yoga-layout';
 
+const _HEX_ALPHA_RE = /^#([0-9a-fA-F]{8})$/;
 /**
  * @class BoxNode
  * @classdesc Base node class for rendering rectangular boxes with layout, styling, and children.
@@ -123,7 +122,8 @@ class BoxNode {
             console.warn('Attempted to append an invalid child node.', child);
             return;
         }
-        child.resolveInheritedStyles(omit(this.props, 'children'));
+        const { children: _c, ...inheritedProps } = this.props;
+        child.resolveInheritedStyles(inheritedProps);
         child.applyDefaults();
         this.children.push(child);
         this.node.insertChild(child.node, index);
@@ -212,69 +212,12 @@ class BoxNode {
                 }
             }
         }
-        if (gap) {
-            if (typeof gap === 'number') {
-                this.node.setGap(Style.Gutter.All, gap);
-            }
-            else if (typeof gap === 'string' && gap.endsWith('%')) {
-                this.node.setGapPercent(Style.Gutter.All, parseFloat(gap));
-            }
-            else {
-                for (const [gutter, value] of Object.entries(gap)) {
-                    if (gutter in Style.Gutter) {
-                        const gutterKey = gutter;
-                        if (typeof value === 'string' && value.endsWith('%')) {
-                            this.node.setGapPercent(Style.Gutter[gutterKey], parseFloat(value));
-                        }
-                        else {
-                            this.node.setGap(Style.Gutter[gutterKey], value);
-                        }
-                    }
-                }
-            }
-        }
-        if (margin) {
-            if (typeof margin === 'number' || margin === 'auto') {
-                this.node.setMargin(Style.Edge.All, margin);
-            }
-            else if (typeof margin === 'string' && margin.endsWith('%')) {
-                this.node.setMarginPercent(Style.Edge.All, parseFloat(margin));
-            }
-            else {
-                for (const [edge, value] of Object.entries(margin)) {
-                    if (edge in Style.Edge) {
-                        const edgeKey = edge;
-                        if (typeof value === 'string' && value.endsWith('%')) {
-                            this.node.setMarginPercent(Style.Edge[edgeKey], parseFloat(value));
-                        }
-                        else {
-                            this.node.setMargin(Style.Edge[edgeKey], value);
-                        }
-                    }
-                }
-            }
-        }
-        if (padding) {
-            if (typeof padding === 'number') {
-                this.node.setPadding(Style.Edge.All, padding);
-            }
-            else if (typeof padding === 'string' && padding.endsWith('%')) {
-                this.node.setPaddingPercent(Style.Edge.All, parseFloat(padding));
-            }
-            else {
-                for (const [edge, value] of Object.entries(padding)) {
-                    if (edge in Style.Edge) {
-                        const edgeKey = edge;
-                        if (typeof value === 'string' && value.endsWith('%')) {
-                            this.node.setPaddingPercent(Style.Edge[edgeKey], parseFloat(value));
-                        }
-                        else {
-                            this.node.setPadding(Style.Edge[edgeKey], value);
-                        }
-                    }
-                }
-            }
-        }
+        if (gap)
+            _setEdgeValues(gap, Style.Gutter, (e, v) => this.node.setGap(e, v), (e, v) => this.node.setGapPercent(e, v));
+        if (margin)
+            _setEdgeValues(margin, Style.Edge, (e, v) => this.node.setMargin(e, v), (e, v) => this.node.setMarginPercent(e, v), true);
+        if (padding)
+            _setEdgeValues(padding, Style.Edge, (e, v) => this.node.setPadding(e, v), (e, v) => this.node.setPaddingPercent(e, v));
         if (border) {
             if (typeof border === 'number') {
                 this.node.setBorder(Style.Edge.All, border);
@@ -495,8 +438,7 @@ class BoxNode {
         const backgroundColor = this.props.backgroundColor;
         let isOpaque = false;
         if (backgroundColor && !this.props.gradient) {
-            const rgba = tinycolor(backgroundColor).toRgb();
-            isOpaque = rgba && rgba.a === 1;
+            isOpaque = _isColorOpaque(backgroundColor);
         }
         // Render outset shadows if present
         if (outsetShadows.length > 0) {
@@ -734,6 +676,54 @@ function normalizeDescriptorChildren(children) {
     const arr = (Array.isArray(children) ? children : [children]).filter(Boolean);
     return arr.length > 0 ? arr : undefined;
 }
+/**
+ * Generic helper to set gap/margin/padding edge values on a Yoga node.
+ * Handles scalar (number | string), percent strings, and per-edge object notation.
+ */
+function _setEdgeValues(value, keys, setFn, percentFn, allowAuto = false) {
+    if (typeof value === 'number' || (allowAuto && value === 'auto')) {
+        setFn(keys.All, value);
+    }
+    else if (typeof value === 'string' && percentFn && value.endsWith('%')) {
+        percentFn(keys.All, parseFloat(value));
+    }
+    else if (typeof value === 'object') {
+        for (const [key, val] of Object.entries(value)) {
+            if (key in keys) {
+                const edgeKey = keys[key];
+                if (typeof val === 'string' && percentFn && val.endsWith('%')) {
+                    percentFn(edgeKey, parseFloat(val));
+                }
+                else {
+                    setFn(edgeKey, val);
+                }
+            }
+        }
+    }
+}
+/**
+ * Checks if a CSS color string represents a fully opaque color (alpha = 1).
+ * Handles hex (#RGB, #RRGGBB, #RRGGBBAA), rgb()/rgba(), and transparent.
+ */
+function _isColorOpaque(color) {
+    if (color === 'transparent')
+        return false;
+    const hexAlpha = _HEX_ALPHA_RE.exec(color);
+    if (hexAlpha) {
+        return parseInt(hexAlpha[1].slice(6), 16) === 255;
+    }
+    // #RGB or #RRGGBB are always opaque
+    if (color.startsWith('#'))
+        return true;
+    // rgba(r, g, b, a)
+    const rgba = /rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(?:,\s*([\d.]+))?\s*\)/.exec(color);
+    if (rgba) {
+        const a = rgba[4] !== undefined ? parseFloat(rgba[4]) : 1;
+        return a === 1;
+    }
+    // Unknown format — assume opaque (covers named colors like 'black', 'white', etc.)
+    return true;
+}
 /**
  * Creates a new BoxNode instance.
  * @param {BoxProps} props Box properties and configuration.
@@ -795,4 +785,4 @@ const Row = ({ children, ...rest }) => ({
     children: normalizeDescriptorChildren(children),
 });
 
-export { Box, BoxNode, Column, ColumnNode, Row, RowNode };
+export { Box, BoxNode, Column, ColumnNode, Row, RowNode, normalizeDescriptorChildren };

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

@@ -1,23 +1,9 @@
 import { Canvas, type CanvasRenderingContext2D } from 'skia-canvas';
-import { ColumnNode, BoxNode } from '../canvas/layout.canvas.js';
-import type { BaseProps, RootProps, CanvasElement, RootPropsWithWorker, RootPropsWithoutWorker } from '../canvas/canvas.type.js';
-export declare const _clearRegisteredFonts: () => void;
-export interface CanvasEngineConfig {
-    /** Run rendering in worker threads to avoid blocking the event loop (default: true) */
-    workerMode?: boolean;
-    /** Number of worker threads in the pool (default: os.cpus().length - 1) */
-    workers?: number;
-}
-/**
- * Configure the canvas rendering engine.
- * Call this once at application startup before rendering.
- * @deprecated Pass workerMode and workers directly to Root() props instead.
- */
-export declare function configure(options: CanvasEngineConfig): void;
+import { ColumnNode, BoxNode } from './layout.canvas.js';
+import type { BaseProps, RootProps, CanvasElement, RootPropsWithWorker, RootPropsWithoutWorker } from './canvas.type.js';
 /**
  * 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.
  */
 export declare function terminate(): void;
 /**
@@ -42,6 +28,8 @@ export declare class RootNode extends ColumnNode {
     private readonly targetHeight;
     /** Scale factor for rendering (e.g. 2 for 2x resolution) */
     private readonly scale;
+    /** Max concurrent image fetches during render (default: 5) */
+    private readonly imageConcurrency;
     /**
      * Creates a new root node for canvas rendering
      * @param props Configuration properties for the root node
@@ -53,6 +41,11 @@ export declare class RootNode extends ColumnNode {
      * @returns Array of all ImageNode instances found in the tree
      */
     private findAllImageNodes;
+    /**
+     * Registers fonts with serialization to prevent duplicate FontLibrary.use() calls
+     * when multiple Root() instances are created concurrently.
+     */
+    private _registerFonts;
     /**
      * Renders the entire node tree to a canvas, handling image loading, layout calculation,
      * and final drawing

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

@@ -1 +1 @@
-{"version":3,"file":"root.canvas.d.ts","sourceRoot":"","sources":["../../../src/canvas/root.canvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAe,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAEhF,OAAO,EAAE,UAAU,EAAE,OAAO,EAAW,MAAM,2BAA2B,CAAA;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAgB/H,eAAO,MAAM,qBAAqB,YAEjC,CAAA;AAmBD,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,kBAAkB,QAGpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,SAKxB;AAqFD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAmB5D;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,UAAU;IAC9B,KAAK,EAAE,SAAS,GAAG,SAAS,CAAA;IACpC,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,CAAoB;IACjD,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAE9B;;;;OAIG;gBACS,KAAK,EAAE,SAAS,GAAG,SAAS;IAoDxC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;;OAIG;IACY,MAAM,CAAC,GAAG,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjG,MAAM,CAAC,GAAG,CAAC,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA4DlG;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CAAC,CAAA;AACvF,wBAAgB,IAAI,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA"}
+{"version":3,"file":"root.canvas.d.ts","sourceRoot":"","sources":["../../../src/canvas/root.canvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAe,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAEhF,OAAO,EAAE,UAAU,EAAE,OAAO,EAAW,MAAM,2BAA2B,CAAA;AACxE,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EAKvB,MAAM,yBAAyB,CAAA;AAoChC;;;GAGG;AACH,wBAAgB,SAAS,SAKxB;AAqFD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAmB5D;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,UAAU;IAC9B,KAAK,EAAE,SAAS,GAAG,SAAS,CAAA;IACpC,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,CAAoB;IACjD,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IAEzC;;;;OAIG;gBACS,KAAK,EAAE,SAAS,GAAG,SAAS;IAkCxC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAczB;;;OAGG;YACW,cAAc;IAgC5B;;;;OAIG;IACY,MAAM,CAAC,GAAG,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjG,MAAM,CAAC,GAAG,CAAC,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAmElG;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CAAC,CAAA;AACvF,wBAAgB,IAAI,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA"}

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"}