modern-canvas 0.24.13 → 0.25.1

package/dist/render.d.ts

@@ -1,5 +1,6 @@
 import type { Fonts } from 'modern-font';
 import type { EngineData, EngineProperties } from './Engine';
+import type { ImagePipelineResolver } from './scene/2d/element/imagePipeline';
 import { Engine } from './Engine';
 export interface RenderOptions extends Partial<EngineProperties> {
     data: EngineData;
@@ -8,6 +9,8 @@ export interface RenderOptions extends Partial<EngineProperties> {
     debug?: boolean;
     fonts?: Fonts;
     keyframes?: number[];
+    /** 图片处理管线解析器：设到渲染引擎实例，使带 imagePipelines 的图片填充在渲染时烘焙。 */
+    imagePipelineResolver?: ImagePipelineResolver;
     onBefore?: (engine: Engine) => void | Promise<void>;
     onKeyframe?: (frame: Uint8ClampedArray<ArrayBuffer>, ctx: {
         currentTime: number;

package/dist/scene/2d/element/Element2DFill.d.ts

@@ -19,7 +19,7 @@ export declare class Element2DFill extends CoreObject implements NormalizedFill
     tile?: NormalizedFill['tile'];
     opacity?: NormalizedFill['opacity'];
     /** 图片处理管线；图片加载后交由注入的解析器烘焙到运行时纹理，不持久化 */
-    pipelines?: NormalizedFill['pipelines'];
+    imagePipelines?: NormalizedFill['imagePipelines'];
     texture?: Texture2D;
     animatedTexture?: AnimatedTexture;
     constructor(_parent: Element2D);
@@ -28,12 +28,12 @@ export declare class Element2DFill extends CoreObject implements NormalizedFill
     protected _updateProperty(key: string, value: any, oldValue: any): void;
     loadTexture(): Promise<void>;
     /**
-     * 把原图经 `pipelines` 烘焙成一张运行时纹理（无管线 / 无解析器 / gif 时跳过）。
+     * 把原图经 `imagePipelines` 烘焙成一张运行时纹理（无管线 / 无解析器 / gif 时跳过）。
      * 始终从 image 独立解码像素喂给管线，不读 `this.texture.source`（那张 ImageBitmap
      * 由纹理管线持有、会经 premultiply 上传/GC 而被消费）。结果按 `url + 管线` 缓存复用。
      */
-    protected _applyPipelines(url: string): Promise<void>;
-    protected _pipelineKey(pipelines: NonNullable<NormalizedFill['pipelines']>): string;
+    protected _applyImagePipelines(url: string): Promise<void>;
+    protected _imagePipelineKey(imagePipelines: NonNullable<NormalizedFill['imagePipelines']>): string;
     /** 从 image 独立解码为中立像素结构（不读 GPU 纹理 source） */
     protected _decodePipelineSource(url: string): Promise<PipelineImage | undefined>;
     protected _pipelineImageToCanvas(image: PipelineImage): HTMLCanvasElement | undefined;

package/dist/scene/2d/element/imagePipeline.d.ts

@@ -2,10 +2,9 @@ import type { ImagePipeline, PipelineImage } from 'modern-idoc';
 /**
  * 图片处理管线解析器：给定管线步骤与原图像素，返回处理后的像素。
  *
- * 引擎本身不认识任何具名管线，只在图片填充加载时把 `pipelines + 像素` 交给注入的
- * 解析器烘焙（仿 `setCanvasFactory`）。具体管线（描边/调色/抠图等）由上层
- * （如 mce + @mce/bigesj）注册并实现。返回 `undefined` 表示放弃处理、沿用原图。
+ * 引擎本身不认识任何具名管线，图片填充加载时把 `imagePipelines + 像素` 交给解析器烘焙。
+ * 解析器挂在引擎实例上（`SceneTree.imagePipelineResolver`，Engine 继承），由宿主
+ * 按实例注入——不走全局，多引擎实例互不影响。
+ * 返回 `undefined` 表示放弃处理、沿用原图。
  */
-export type ImagePipelineResolver = (pipelines: ImagePipeline[], image: PipelineImage) => Promise<PipelineImage | undefined>;
-export declare function setImagePipelineResolver(resolver: ImagePipelineResolver | undefined): void;
-export declare function getImagePipelineResolver(): ImagePipelineResolver | undefined;
+export type ImagePipelineResolver = (imagePipelines: ImagePipeline[], image: PipelineImage) => Promise<PipelineImage | undefined>;

package/dist/scene/main/SceneTree.d.ts

@@ -1,5 +1,6 @@
 import type { Fonts } from 'modern-font';
 import type { Hex8Color } from 'modern-idoc';
+import type { ImagePipelineResolver } from '../2d/element/imagePipeline';
 import type { InputEvents, MainLoopEvents, MainLoopProperties, WebGLRenderer } from '../../core';
 import type { Node } from './Node';
 import type { Viewport } from './Viewport';
@@ -45,6 +46,12 @@ export declare class SceneTree extends MainLoop {
     readonly renderStack: RenderStack;
     readonly root: Window;
     timeline: Timeline;
+    /**
+     * 图片处理管线解析器（实例级，非全局）。图片填充带 `imagePipelines` 时，
+     * 子节点经 `this.tree?.imagePipelineResolver` 取用，把图片烘焙到运行时纹理。
+     * 由宿主按引擎实例注入；未注入则不处理、沿用原图。
+     */
+    imagePipelineResolver?: ImagePipelineResolver;
     readonly nodeMap: Map<string, Node>;
     /** 已订阅 load 事件的 fonts 实例，用于在 fonts 切换 / 销毁时解绑。 */
     protected _boundFonts?: Fonts;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "modern-canvas",
   "type": "module",
-  "version": "0.24.13",
+  "version": "0.25.1",
   "packageManager": "pnpm@10.19.0",
   "description": "A JavaScript WebGL rendering engine. only the ESM.",
   "author": "wxm",
@@ -63,7 +63,7 @@
     "colord": "^2.9.3",
     "earcut": "^3.0.2",
     "modern-font": "^0.6.1",
-    "modern-idoc": "^0.12.2",
+    "modern-idoc": "^0.12.3",
     "modern-path2d": "^1.8.5",
     "modern-text": "^2.0.9"
   },