@clypra/engine 1.1.0 → 1.1.2

package/dist/index.d.cts

@@ -202,6 +202,96 @@ interface Preset {
     category?: "3d" | "Neon" | "Metallic" | "Glitch" | "Retro" | "Gradient" | "Grunge" | "Outline" | "Shadow" | "Elements" | "Luxury" | "Classic" | "Experimental" | string;
     createdAt?: number;
 }
+interface EffectIndexItem {
+    id: string;
+    name: string;
+    category: string;
+    description?: string;
+    tags?: string[];
+    isPremium?: boolean;
+    previewType?: 'static' | 'video' | 'lottie';
+    thumbnailUrl?: string;
+    thumbnail?: string;
+    previewUrl?: string;
+    durationMs?: number;
+}
+interface EffectFullDefinition extends EffectIndexItem {
+    version?: string;
+    description: string;
+    tags: string[];
+    font: {
+        family: string;
+        weight: number;
+        style: "normal" | "italic";
+        letterSpacing: number;
+        lineHeight: number;
+    };
+    fills: any[];
+    strokes: any[];
+    shadows: any[];
+    bevel?: any;
+    glow?: any;
+    glows?: any[];
+    panel?: any;
+    glitch?: any;
+    animation?: {
+        type: "none" | "typewriter" | "wave" | "fade" | "glitch";
+        speed?: number;
+        amplitude?: number;
+        frequency?: number;
+    };
+    background?: any;
+    stack?: any;
+}
+interface TextEffectDefinition extends EffectFullDefinition {
+    text?: string;
+    description: string;
+    tags: string[];
+}
+interface EvaluatedTextLayer {
+    readonly layerId: string;
+    readonly clipId: string;
+    readonly role: string;
+    readonly zIndex: number;
+    readonly layerType: "text";
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly rotation: number;
+    readonly opacity: number;
+    readonly inTransition: boolean;
+    readonly blendMode: string;
+    readonly time?: number;
+    readonly clipStartTime?: number;
+    readonly clipDuration?: number;
+    readonly text: string;
+    readonly fontFamily: string;
+    readonly fontSize: number;
+    readonly color: string;
+    readonly fontWeight: "normal" | "bold" | number;
+    readonly fontStyle: "normal" | "italic";
+    readonly textAlign: "left" | "center" | "right";
+    readonly verticalAlign: "top" | "middle" | "bottom";
+    readonly lineHeight: number;
+    readonly letterSpacing: number;
+    readonly stroke?: {
+        color: string;
+        width: number;
+    };
+    readonly shadow?: {
+        color: string;
+        blur: number;
+        offsetX: number;
+        offsetY: number;
+    };
+    readonly background?: {
+        color: string;
+        padding: number;
+        borderRadius: number;
+    };
+    readonly styleId?: string;
+}
 
 declare function renderTextEffectCore(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, cfg: TextEffectConfig): void;
 declare class TextEffectRenderer {
@@ -235,9 +325,48 @@ declare function injectFontVariantRules(): void;
  */
 declare function initializeFontSystem(): Promise<void>;
 /**
- * Checks if a font variant is available for rendering
+ * Checks if a font variant is available for rendering.
+ * Uses document.fonts.check() which is the correct API for font availability —
+ * unlike measureText() which silently falls back to the system font and always
+ * returns a non-zero width regardless of whether the named font loaded.
  */
 declare function checkFontVariant(variantName: string): boolean;
+/**
+ * Font descriptor for loading.
+ */
+interface FontDescriptor {
+    family: string;
+    weight?: string | number;
+    style?: "normal" | "italic";
+}
+/**
+ * Font loading result.
+ */
+interface FontLoadResult {
+    font: FontDescriptor;
+    loaded: boolean;
+    error?: string;
+    loadTimeMs: number;
+}
+declare class FontLoader {
+    private state;
+    ensureFont(descriptor: FontDescriptor): Promise<FontLoadResult>;
+    ensureFonts(descriptors: FontDescriptor[]): Promise<FontLoadResult[]>;
+    waitForFontsReady(): Promise<void>;
+    isLoaded(descriptor: FontDescriptor): boolean;
+    getStats(): {
+        loaded: number;
+        loading: number;
+        failed: number;
+    };
+    clear(): void;
+    private loadFont;
+    private getFontKey;
+    private normalizeFontWeight;
+}
+declare function getFontLoader(): FontLoader;
+declare function resetFontLoader(): void;
+declare function ensureFontsLoaded(descriptors: FontDescriptor[]): Promise<FontLoadResult[]>;
 
 declare function resolveCustomEngineId(cfg: TextEffectConfig): CustomEngineId | null;
 /** Lossless migration from flat TextEffectConfig to SceneDocument */
@@ -252,6 +381,15 @@ interface CompositorFromScene {
 }
 /** Apply engine params from scene onto config without require() */
 declare function mergeSceneIntoConfig(doc: SceneDocument, base: TextEffectConfig): TextEffectConfig;
+declare function resolveFontFamilyName(fontFamily: string): string;
+declare function _buildConfig(effect: TextEffectDefinition, text: string, fontSize: number, canvasWidth: number, canvasHeight: number, time?: number, clipStartTime?: number, clipDuration?: number): TextEffectConfig & {
+    width: number;
+    height: number;
+};
+declare function layerToTextEffectConfig(layer: EvaluatedTextLayer): TextEffectConfig & {
+    width: number;
+    height: number;
+};
 
 declare class WebGLCompositor {
     private gl;
@@ -270,6 +408,11 @@ interface EvaluateOptions {
     compositor?: WebGLCompositor | null;
     skipPostFx?: boolean;
 }
+/**
+ * Dispose the shared module-level compositor and release GPU resources.
+ * Call on hot-module-reload or application teardown to prevent WebGL context leaks.
+ */
+declare function disposeSharedCompositor(): void;
 /**
  * Single source of truth for rendering a scene at time t.
  */
@@ -958,14 +1101,35 @@ declare function createCanvas(width: number, height: number): HTMLCanvasElement
  * Release a DOM canvas created via createCanvas() when OffscreenCanvas
  * was unavailable. No-op for OffscreenCanvas instances.
  *
- * Call this after extracting ImageBitmap / ImageData from an intermediate
- * canvas to prevent DOM leak at 30fps render loops.
+ * Sets width/height to 0 to release the backing store immediately rather
+ * than waiting for GC. Call this after extracting ImageBitmap/ImageData.
  */
 declare function releaseCanvas(canvas: HTMLCanvasElement | OffscreenCanvas): void;
 /**
  * Reset all cached capability flags (for testing only).
  */
 declare function _resetPlatformCache(): void;
+/**
+ * Unified resource allocator and manager for OffscreenCanvas and DOM Canvas pools.
+ * Prevents GC thrashing and backing store leaks across WKWebView and standard browsers.
+ */
+declare class CanvasDevice {
+    private static canvases;
+    private static maxPoolSize;
+    /**
+     * Acquire a Canvas context from the pool or create a new one.
+     * If a canvas is pulled from the pool, it is resized to the target dimensions.
+     */
+    static acquire(width: number, height: number): HTMLCanvasElement | OffscreenCanvas;
+    /**
+     * Release a canvas back to the pool, or free its resources immediately if pool is full.
+     */
+    static release(canvas: HTMLCanvasElement | OffscreenCanvas): void;
+    /**
+     * Disposes all pooled canvases to release GPU/memory backing stores.
+     */
+    static clearPool(): void;
+}
 
 /**
  * Canvas 2D utility helpers
@@ -1019,4 +1183,4 @@ declare class InkBrushEngine {
     drawFrame(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D): void;
 }
 
-export { type AnimBuildOpts, type AnimKeyframe, type AnimTrack, type AnimTrackDef, type AnimatableParamDef, type AnimationCategory, type BatchInjection, COMPOSITION_PRESETS, CUSTOM_ENGINE_IDS, type CompositionPreset, type CompositorFromScene, type CompositorSettings, type CustomEngineId, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, DEFAULT_DURATION, DEFAULT_FONT_SIZE, DEFAULT_FPS, DEFAULT_TEXT_STYLE, type DotLottieManifest, type DrawPerCharTextOptions, EMPHASIS_PRESETS, ENGINE_ID_TO_LEGACY, ENTRANCE_PRESETS, EXIT_PRESETS, type EasingControlPoint, type EffectLayer, type EffectLayerType, type EvaluateOptions, FONT_WEIGHT_OPTIONS, type FillType, type FontVariant, type GifExportOptions, type GifFrame, type GlowLayer, type GradientDir, type GradientStop, InkBrushEngine, type Keyframe, LEGACY_RENDERER_MAP, LOOP_PRESETS, LOTTIE_ANIM_PRESETS, LOTTIE_TEMPLATE_PRESETS, type LayerTarget, type LottieAnimPreset, type LottieFileInfo, type LottieFontEntry, type LottieFontUsage, type LottieGradientStop, type LottieKeyframe, type LottiePropertyPath, type LottieTemplatePreset, type ParsedTextLayer, type PngSequenceFrame, type PngSequenceOptions, type Preset, SCENE_VERSION, SUPPORTED_FONT_FAMILIES, type SceneCanvas, type SceneDocument, type SceneText, type StyleRecipe, TEMPLATE_CATEGORIES, type TemplatePresetCategory, type TextAlign, type TextCustomization, type TextEffectConfig, TextEffectRenderer, type TextLayerConfig, type TextLayerStyle, type TextLayoutBounds, type TextLayoutResult, type TextStyleOverride, type Timeline, WEBM_EXPORT_MAX_FRAMES, WebGLCompositor, type WebMExportOptions, _resetPlatformCache, addImageLayer, addKeyframeAtTime, addOrUpdateKeyframe, addShapeLayer, addSolidLayer, addTextLayer, addTrack, addVectorShape, advanceSceneTime, alignToLottieJ, applyFillColorToAll, applyLetterSpacing, applyMaskReveal, applyRecipeToScene, applyStyleToLottie, applyStyleToLottieLayer, applyTimelineAtTime, bakeAnimationIntoLayer, blendConfigs, blendScenes, buildDotLottie, buildFontEntries, buildLottieFontName, buildPngSequenceZip, builtInPresets, builtInRecipes, captureLottieFrames, checkFontVariant, clearAnimationFromLayer, clearFontCache, clearRecipeCache, cloneSceneWithNewIds, computeAutoFitFontSize, computeFitZoom, computeTextLayout, countTextGlyphs, createBlankLottie, createCanvas, createDefaultRevealTrack, createEmptyScene, createPulseOpacityTrack, defaultConfig, deleteKeyframe, downloadDotLottie, downloadLottieJson, downloadPngSequenceZip, downloadSceneWebM, drawPerCharText, drawRoundedRect, duplicateTrackAtPlayhead, ease, enableKeyframing, encodeGif, ensureDefaultTimeline, ensureFontInLottie, evaluateConfig, evaluateScene, findTrackIndex, getAnimPreset, getAnimatableParamDef, getAnimatableParamsForLayer, getDefaultText, getLayerById, getPresetScene, getSceneTime, getSupportedWebMMimeType, getTemplatePreset, getTemplatesByCategory, getWebMFrameCount, hexToLottieColor, hexToLottieRgb, initializeFontSystem, injectBatch, injectColor, injectFontVariantRules, injectGlobalTextStyle, injectSolidColor, injectText, injectTextStyle, isWebMExportSupported, loadLottieFonts, lottieColorToHex, lottieJToAlign, measureTextFits, mergeSceneIntoConfig, moveKeyframe, newLayerId, parseHistorySnapshot, parseLottieJson, preloadGoogleFont, presetToRecipe, pruneTracksForLayer, rainbowCharFillColors, readLayerScalar, readStyleFromLottieLayer, reindexLayers, releaseCanvas, removeKeyframe, removeTrack, renderPngSequence, renderSceneWebM, renderTextEffectCore, resetSceneTime, resizeCharFillColors, resolveAnimatedScalar, resolveCustomEngineId, restoreLetterSpacing, scanLottieFonts, scanTextLayers, sceneToConfig, setCharFillColor, setSceneTime, setTracks, shouldUsePerCharFill, snapshotScene, sortKeyframes, supportsCtxFilter, supportsLetterSpacing, supportsOffscreenCanvas, supportsRoundRect, supportsWebGL2, syncCompositorFromScene, textEffectConfigToScene, trackId, updateKeyframe, updateStaticProperty, updateTimeline, updateTrack, updateTrackMatte, upsertKeyframe, waitForFontsReady, wrapTextToWidth };
+export { type AnimBuildOpts, type AnimKeyframe, type AnimTrack, type AnimTrackDef, type AnimatableParamDef, type AnimationCategory, type BatchInjection, COMPOSITION_PRESETS, CUSTOM_ENGINE_IDS, CanvasDevice, type CompositionPreset, type CompositorFromScene, type CompositorSettings, type CustomEngineId, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, DEFAULT_DURATION, DEFAULT_FONT_SIZE, DEFAULT_FPS, DEFAULT_TEXT_STYLE, type DotLottieManifest, type DrawPerCharTextOptions, EMPHASIS_PRESETS, ENGINE_ID_TO_LEGACY, ENTRANCE_PRESETS, EXIT_PRESETS, type EasingControlPoint, type EffectFullDefinition, type EffectIndexItem, type EffectLayer, type EffectLayerType, type EvaluateOptions, type EvaluatedTextLayer, FONT_WEIGHT_OPTIONS, type FillType, type FontDescriptor, type FontLoadResult, FontLoader, type FontVariant, type GifExportOptions, type GifFrame, type GlowLayer, type GradientDir, type GradientStop, InkBrushEngine, type Keyframe, LEGACY_RENDERER_MAP, LOOP_PRESETS, LOTTIE_ANIM_PRESETS, LOTTIE_TEMPLATE_PRESETS, type LayerTarget, type LottieAnimPreset, type LottieFileInfo, type LottieFontEntry, type LottieFontUsage, type LottieGradientStop, type LottieKeyframe, type LottiePropertyPath, type LottieTemplatePreset, type ParsedTextLayer, type PngSequenceFrame, type PngSequenceOptions, type Preset, SCENE_VERSION, SUPPORTED_FONT_FAMILIES, type SceneCanvas, type SceneDocument, type SceneText, type StyleRecipe, TEMPLATE_CATEGORIES, type TemplatePresetCategory, type TextAlign, type TextCustomization, type TextEffectConfig, type TextEffectDefinition, TextEffectRenderer, type TextLayerConfig, type TextLayerStyle, type TextLayoutBounds, type TextLayoutResult, type TextStyleOverride, type Timeline, WEBM_EXPORT_MAX_FRAMES, WebGLCompositor, type WebMExportOptions, _buildConfig, _resetPlatformCache, addImageLayer, addKeyframeAtTime, addOrUpdateKeyframe, addShapeLayer, addSolidLayer, addTextLayer, addTrack, addVectorShape, advanceSceneTime, alignToLottieJ, applyFillColorToAll, applyLetterSpacing, applyMaskReveal, applyRecipeToScene, applyStyleToLottie, applyStyleToLottieLayer, applyTimelineAtTime, bakeAnimationIntoLayer, blendConfigs, blendScenes, buildDotLottie, buildFontEntries, buildLottieFontName, buildPngSequenceZip, builtInPresets, builtInRecipes, captureLottieFrames, checkFontVariant, clearAnimationFromLayer, clearFontCache, clearRecipeCache, cloneSceneWithNewIds, computeAutoFitFontSize, computeFitZoom, computeTextLayout, countTextGlyphs, createBlankLottie, createCanvas, createDefaultRevealTrack, createEmptyScene, createPulseOpacityTrack, defaultConfig, deleteKeyframe, disposeSharedCompositor, downloadDotLottie, downloadLottieJson, downloadPngSequenceZip, downloadSceneWebM, drawPerCharText, drawRoundedRect, duplicateTrackAtPlayhead, ease, enableKeyframing, encodeGif, ensureDefaultTimeline, ensureFontInLottie, ensureFontsLoaded, evaluateConfig, evaluateScene, findTrackIndex, getAnimPreset, getAnimatableParamDef, getAnimatableParamsForLayer, getDefaultText, getFontLoader, getLayerById, getPresetScene, getSceneTime, getSupportedWebMMimeType, getTemplatePreset, getTemplatesByCategory, getWebMFrameCount, hexToLottieColor, hexToLottieRgb, initializeFontSystem, injectBatch, injectColor, injectFontVariantRules, injectGlobalTextStyle, injectSolidColor, injectText, injectTextStyle, isWebMExportSupported, layerToTextEffectConfig, loadLottieFonts, lottieColorToHex, lottieJToAlign, measureTextFits, mergeSceneIntoConfig, moveKeyframe, newLayerId, parseHistorySnapshot, parseLottieJson, preloadGoogleFont, presetToRecipe, pruneTracksForLayer, rainbowCharFillColors, readLayerScalar, readStyleFromLottieLayer, reindexLayers, releaseCanvas, removeKeyframe, removeTrack, renderPngSequence, renderSceneWebM, renderTextEffectCore, resetFontLoader, resetSceneTime, resizeCharFillColors, resolveAnimatedScalar, resolveCustomEngineId, resolveFontFamilyName, restoreLetterSpacing, scanLottieFonts, scanTextLayers, sceneToConfig, setCharFillColor, setSceneTime, setTracks, shouldUsePerCharFill, snapshotScene, sortKeyframes, supportsCtxFilter, supportsLetterSpacing, supportsOffscreenCanvas, supportsRoundRect, supportsWebGL2, syncCompositorFromScene, textEffectConfigToScene, trackId, updateKeyframe, updateStaticProperty, updateTimeline, updateTrack, updateTrackMatte, upsertKeyframe, waitForFontsReady, wrapTextToWidth };

package/dist/index.d.ts

@@ -202,6 +202,96 @@ interface Preset {
     category?: "3d" | "Neon" | "Metallic" | "Glitch" | "Retro" | "Gradient" | "Grunge" | "Outline" | "Shadow" | "Elements" | "Luxury" | "Classic" | "Experimental" | string;
     createdAt?: number;
 }
+interface EffectIndexItem {
+    id: string;
+    name: string;
+    category: string;
+    description?: string;
+    tags?: string[];
+    isPremium?: boolean;
+    previewType?: 'static' | 'video' | 'lottie';
+    thumbnailUrl?: string;
+    thumbnail?: string;
+    previewUrl?: string;
+    durationMs?: number;
+}
+interface EffectFullDefinition extends EffectIndexItem {
+    version?: string;
+    description: string;
+    tags: string[];
+    font: {
+        family: string;
+        weight: number;
+        style: "normal" | "italic";
+        letterSpacing: number;
+        lineHeight: number;
+    };
+    fills: any[];
+    strokes: any[];
+    shadows: any[];
+    bevel?: any;
+    glow?: any;
+    glows?: any[];
+    panel?: any;
+    glitch?: any;
+    animation?: {
+        type: "none" | "typewriter" | "wave" | "fade" | "glitch";
+        speed?: number;
+        amplitude?: number;
+        frequency?: number;
+    };
+    background?: any;
+    stack?: any;
+}
+interface TextEffectDefinition extends EffectFullDefinition {
+    text?: string;
+    description: string;
+    tags: string[];
+}
+interface EvaluatedTextLayer {
+    readonly layerId: string;
+    readonly clipId: string;
+    readonly role: string;
+    readonly zIndex: number;
+    readonly layerType: "text";
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly rotation: number;
+    readonly opacity: number;
+    readonly inTransition: boolean;
+    readonly blendMode: string;
+    readonly time?: number;
+    readonly clipStartTime?: number;
+    readonly clipDuration?: number;
+    readonly text: string;
+    readonly fontFamily: string;
+    readonly fontSize: number;
+    readonly color: string;
+    readonly fontWeight: "normal" | "bold" | number;
+    readonly fontStyle: "normal" | "italic";
+    readonly textAlign: "left" | "center" | "right";
+    readonly verticalAlign: "top" | "middle" | "bottom";
+    readonly lineHeight: number;
+    readonly letterSpacing: number;
+    readonly stroke?: {
+        color: string;
+        width: number;
+    };
+    readonly shadow?: {
+        color: string;
+        blur: number;
+        offsetX: number;
+        offsetY: number;
+    };
+    readonly background?: {
+        color: string;
+        padding: number;
+        borderRadius: number;
+    };
+    readonly styleId?: string;
+}
 
 declare function renderTextEffectCore(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, cfg: TextEffectConfig): void;
 declare class TextEffectRenderer {
@@ -235,9 +325,48 @@ declare function injectFontVariantRules(): void;
  */
 declare function initializeFontSystem(): Promise<void>;
 /**
- * Checks if a font variant is available for rendering
+ * Checks if a font variant is available for rendering.
+ * Uses document.fonts.check() which is the correct API for font availability —
+ * unlike measureText() which silently falls back to the system font and always
+ * returns a non-zero width regardless of whether the named font loaded.
  */
 declare function checkFontVariant(variantName: string): boolean;
+/**
+ * Font descriptor for loading.
+ */
+interface FontDescriptor {
+    family: string;
+    weight?: string | number;
+    style?: "normal" | "italic";
+}
+/**
+ * Font loading result.
+ */
+interface FontLoadResult {
+    font: FontDescriptor;
+    loaded: boolean;
+    error?: string;
+    loadTimeMs: number;
+}
+declare class FontLoader {
+    private state;
+    ensureFont(descriptor: FontDescriptor): Promise<FontLoadResult>;
+    ensureFonts(descriptors: FontDescriptor[]): Promise<FontLoadResult[]>;
+    waitForFontsReady(): Promise<void>;
+    isLoaded(descriptor: FontDescriptor): boolean;
+    getStats(): {
+        loaded: number;
+        loading: number;
+        failed: number;
+    };
+    clear(): void;
+    private loadFont;
+    private getFontKey;
+    private normalizeFontWeight;
+}
+declare function getFontLoader(): FontLoader;
+declare function resetFontLoader(): void;
+declare function ensureFontsLoaded(descriptors: FontDescriptor[]): Promise<FontLoadResult[]>;
 
 declare function resolveCustomEngineId(cfg: TextEffectConfig): CustomEngineId | null;
 /** Lossless migration from flat TextEffectConfig to SceneDocument */
@@ -252,6 +381,15 @@ interface CompositorFromScene {
 }
 /** Apply engine params from scene onto config without require() */
 declare function mergeSceneIntoConfig(doc: SceneDocument, base: TextEffectConfig): TextEffectConfig;
+declare function resolveFontFamilyName(fontFamily: string): string;
+declare function _buildConfig(effect: TextEffectDefinition, text: string, fontSize: number, canvasWidth: number, canvasHeight: number, time?: number, clipStartTime?: number, clipDuration?: number): TextEffectConfig & {
+    width: number;
+    height: number;
+};
+declare function layerToTextEffectConfig(layer: EvaluatedTextLayer): TextEffectConfig & {
+    width: number;
+    height: number;
+};
 
 declare class WebGLCompositor {
     private gl;
@@ -270,6 +408,11 @@ interface EvaluateOptions {
     compositor?: WebGLCompositor | null;
     skipPostFx?: boolean;
 }
+/**
+ * Dispose the shared module-level compositor and release GPU resources.
+ * Call on hot-module-reload or application teardown to prevent WebGL context leaks.
+ */
+declare function disposeSharedCompositor(): void;
 /**
  * Single source of truth for rendering a scene at time t.
  */
@@ -958,14 +1101,35 @@ declare function createCanvas(width: number, height: number): HTMLCanvasElement
  * Release a DOM canvas created via createCanvas() when OffscreenCanvas
  * was unavailable. No-op for OffscreenCanvas instances.
  *
- * Call this after extracting ImageBitmap / ImageData from an intermediate
- * canvas to prevent DOM leak at 30fps render loops.
+ * Sets width/height to 0 to release the backing store immediately rather
+ * than waiting for GC. Call this after extracting ImageBitmap/ImageData.
  */
 declare function releaseCanvas(canvas: HTMLCanvasElement | OffscreenCanvas): void;
 /**
  * Reset all cached capability flags (for testing only).
  */
 declare function _resetPlatformCache(): void;
+/**
+ * Unified resource allocator and manager for OffscreenCanvas and DOM Canvas pools.
+ * Prevents GC thrashing and backing store leaks across WKWebView and standard browsers.
+ */
+declare class CanvasDevice {
+    private static canvases;
+    private static maxPoolSize;
+    /**
+     * Acquire a Canvas context from the pool or create a new one.
+     * If a canvas is pulled from the pool, it is resized to the target dimensions.
+     */
+    static acquire(width: number, height: number): HTMLCanvasElement | OffscreenCanvas;
+    /**
+     * Release a canvas back to the pool, or free its resources immediately if pool is full.
+     */
+    static release(canvas: HTMLCanvasElement | OffscreenCanvas): void;
+    /**
+     * Disposes all pooled canvases to release GPU/memory backing stores.
+     */
+    static clearPool(): void;
+}
 
 /**
  * Canvas 2D utility helpers
@@ -1019,4 +1183,4 @@ declare class InkBrushEngine {
     drawFrame(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D): void;
 }
 
-export { type AnimBuildOpts, type AnimKeyframe, type AnimTrack, type AnimTrackDef, type AnimatableParamDef, type AnimationCategory, type BatchInjection, COMPOSITION_PRESETS, CUSTOM_ENGINE_IDS, type CompositionPreset, type CompositorFromScene, type CompositorSettings, type CustomEngineId, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, DEFAULT_DURATION, DEFAULT_FONT_SIZE, DEFAULT_FPS, DEFAULT_TEXT_STYLE, type DotLottieManifest, type DrawPerCharTextOptions, EMPHASIS_PRESETS, ENGINE_ID_TO_LEGACY, ENTRANCE_PRESETS, EXIT_PRESETS, type EasingControlPoint, type EffectLayer, type EffectLayerType, type EvaluateOptions, FONT_WEIGHT_OPTIONS, type FillType, type FontVariant, type GifExportOptions, type GifFrame, type GlowLayer, type GradientDir, type GradientStop, InkBrushEngine, type Keyframe, LEGACY_RENDERER_MAP, LOOP_PRESETS, LOTTIE_ANIM_PRESETS, LOTTIE_TEMPLATE_PRESETS, type LayerTarget, type LottieAnimPreset, type LottieFileInfo, type LottieFontEntry, type LottieFontUsage, type LottieGradientStop, type LottieKeyframe, type LottiePropertyPath, type LottieTemplatePreset, type ParsedTextLayer, type PngSequenceFrame, type PngSequenceOptions, type Preset, SCENE_VERSION, SUPPORTED_FONT_FAMILIES, type SceneCanvas, type SceneDocument, type SceneText, type StyleRecipe, TEMPLATE_CATEGORIES, type TemplatePresetCategory, type TextAlign, type TextCustomization, type TextEffectConfig, TextEffectRenderer, type TextLayerConfig, type TextLayerStyle, type TextLayoutBounds, type TextLayoutResult, type TextStyleOverride, type Timeline, WEBM_EXPORT_MAX_FRAMES, WebGLCompositor, type WebMExportOptions, _resetPlatformCache, addImageLayer, addKeyframeAtTime, addOrUpdateKeyframe, addShapeLayer, addSolidLayer, addTextLayer, addTrack, addVectorShape, advanceSceneTime, alignToLottieJ, applyFillColorToAll, applyLetterSpacing, applyMaskReveal, applyRecipeToScene, applyStyleToLottie, applyStyleToLottieLayer, applyTimelineAtTime, bakeAnimationIntoLayer, blendConfigs, blendScenes, buildDotLottie, buildFontEntries, buildLottieFontName, buildPngSequenceZip, builtInPresets, builtInRecipes, captureLottieFrames, checkFontVariant, clearAnimationFromLayer, clearFontCache, clearRecipeCache, cloneSceneWithNewIds, computeAutoFitFontSize, computeFitZoom, computeTextLayout, countTextGlyphs, createBlankLottie, createCanvas, createDefaultRevealTrack, createEmptyScene, createPulseOpacityTrack, defaultConfig, deleteKeyframe, downloadDotLottie, downloadLottieJson, downloadPngSequenceZip, downloadSceneWebM, drawPerCharText, drawRoundedRect, duplicateTrackAtPlayhead, ease, enableKeyframing, encodeGif, ensureDefaultTimeline, ensureFontInLottie, evaluateConfig, evaluateScene, findTrackIndex, getAnimPreset, getAnimatableParamDef, getAnimatableParamsForLayer, getDefaultText, getLayerById, getPresetScene, getSceneTime, getSupportedWebMMimeType, getTemplatePreset, getTemplatesByCategory, getWebMFrameCount, hexToLottieColor, hexToLottieRgb, initializeFontSystem, injectBatch, injectColor, injectFontVariantRules, injectGlobalTextStyle, injectSolidColor, injectText, injectTextStyle, isWebMExportSupported, loadLottieFonts, lottieColorToHex, lottieJToAlign, measureTextFits, mergeSceneIntoConfig, moveKeyframe, newLayerId, parseHistorySnapshot, parseLottieJson, preloadGoogleFont, presetToRecipe, pruneTracksForLayer, rainbowCharFillColors, readLayerScalar, readStyleFromLottieLayer, reindexLayers, releaseCanvas, removeKeyframe, removeTrack, renderPngSequence, renderSceneWebM, renderTextEffectCore, resetSceneTime, resizeCharFillColors, resolveAnimatedScalar, resolveCustomEngineId, restoreLetterSpacing, scanLottieFonts, scanTextLayers, sceneToConfig, setCharFillColor, setSceneTime, setTracks, shouldUsePerCharFill, snapshotScene, sortKeyframes, supportsCtxFilter, supportsLetterSpacing, supportsOffscreenCanvas, supportsRoundRect, supportsWebGL2, syncCompositorFromScene, textEffectConfigToScene, trackId, updateKeyframe, updateStaticProperty, updateTimeline, updateTrack, updateTrackMatte, upsertKeyframe, waitForFontsReady, wrapTextToWidth };
+export { type AnimBuildOpts, type AnimKeyframe, type AnimTrack, type AnimTrackDef, type AnimatableParamDef, type AnimationCategory, type BatchInjection, COMPOSITION_PRESETS, CUSTOM_ENGINE_IDS, CanvasDevice, type CompositionPreset, type CompositorFromScene, type CompositorSettings, type CustomEngineId, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, DEFAULT_DURATION, DEFAULT_FONT_SIZE, DEFAULT_FPS, DEFAULT_TEXT_STYLE, type DotLottieManifest, type DrawPerCharTextOptions, EMPHASIS_PRESETS, ENGINE_ID_TO_LEGACY, ENTRANCE_PRESETS, EXIT_PRESETS, type EasingControlPoint, type EffectFullDefinition, type EffectIndexItem, type EffectLayer, type EffectLayerType, type EvaluateOptions, type EvaluatedTextLayer, FONT_WEIGHT_OPTIONS, type FillType, type FontDescriptor, type FontLoadResult, FontLoader, type FontVariant, type GifExportOptions, type GifFrame, type GlowLayer, type GradientDir, type GradientStop, InkBrushEngine, type Keyframe, LEGACY_RENDERER_MAP, LOOP_PRESETS, LOTTIE_ANIM_PRESETS, LOTTIE_TEMPLATE_PRESETS, type LayerTarget, type LottieAnimPreset, type LottieFileInfo, type LottieFontEntry, type LottieFontUsage, type LottieGradientStop, type LottieKeyframe, type LottiePropertyPath, type LottieTemplatePreset, type ParsedTextLayer, type PngSequenceFrame, type PngSequenceOptions, type Preset, SCENE_VERSION, SUPPORTED_FONT_FAMILIES, type SceneCanvas, type SceneDocument, type SceneText, type StyleRecipe, TEMPLATE_CATEGORIES, type TemplatePresetCategory, type TextAlign, type TextCustomization, type TextEffectConfig, type TextEffectDefinition, TextEffectRenderer, type TextLayerConfig, type TextLayerStyle, type TextLayoutBounds, type TextLayoutResult, type TextStyleOverride, type Timeline, WEBM_EXPORT_MAX_FRAMES, WebGLCompositor, type WebMExportOptions, _buildConfig, _resetPlatformCache, addImageLayer, addKeyframeAtTime, addOrUpdateKeyframe, addShapeLayer, addSolidLayer, addTextLayer, addTrack, addVectorShape, advanceSceneTime, alignToLottieJ, applyFillColorToAll, applyLetterSpacing, applyMaskReveal, applyRecipeToScene, applyStyleToLottie, applyStyleToLottieLayer, applyTimelineAtTime, bakeAnimationIntoLayer, blendConfigs, blendScenes, buildDotLottie, buildFontEntries, buildLottieFontName, buildPngSequenceZip, builtInPresets, builtInRecipes, captureLottieFrames, checkFontVariant, clearAnimationFromLayer, clearFontCache, clearRecipeCache, cloneSceneWithNewIds, computeAutoFitFontSize, computeFitZoom, computeTextLayout, countTextGlyphs, createBlankLottie, createCanvas, createDefaultRevealTrack, createEmptyScene, createPulseOpacityTrack, defaultConfig, deleteKeyframe, disposeSharedCompositor, downloadDotLottie, downloadLottieJson, downloadPngSequenceZip, downloadSceneWebM, drawPerCharText, drawRoundedRect, duplicateTrackAtPlayhead, ease, enableKeyframing, encodeGif, ensureDefaultTimeline, ensureFontInLottie, ensureFontsLoaded, evaluateConfig, evaluateScene, findTrackIndex, getAnimPreset, getAnimatableParamDef, getAnimatableParamsForLayer, getDefaultText, getFontLoader, getLayerById, getPresetScene, getSceneTime, getSupportedWebMMimeType, getTemplatePreset, getTemplatesByCategory, getWebMFrameCount, hexToLottieColor, hexToLottieRgb, initializeFontSystem, injectBatch, injectColor, injectFontVariantRules, injectGlobalTextStyle, injectSolidColor, injectText, injectTextStyle, isWebMExportSupported, layerToTextEffectConfig, loadLottieFonts, lottieColorToHex, lottieJToAlign, measureTextFits, mergeSceneIntoConfig, moveKeyframe, newLayerId, parseHistorySnapshot, parseLottieJson, preloadGoogleFont, presetToRecipe, pruneTracksForLayer, rainbowCharFillColors, readLayerScalar, readStyleFromLottieLayer, reindexLayers, releaseCanvas, removeKeyframe, removeTrack, renderPngSequence, renderSceneWebM, renderTextEffectCore, resetFontLoader, resetSceneTime, resizeCharFillColors, resolveAnimatedScalar, resolveCustomEngineId, resolveFontFamilyName, restoreLetterSpacing, scanLottieFonts, scanTextLayers, sceneToConfig, setCharFillColor, setSceneTime, setTracks, shouldUsePerCharFill, snapshotScene, sortKeyframes, supportsCtxFilter, supportsLetterSpacing, supportsOffscreenCanvas, supportsRoundRect, supportsWebGL2, syncCompositorFromScene, textEffectConfigToScene, trackId, updateKeyframe, updateStaticProperty, updateTimeline, updateTrack, updateTrackMatte, upsertKeyframe, waitForFontsReady, wrapTextToWidth };