modern-canvas 0.24.10 → 0.24.13

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

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

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

@@ -1,42 +1,12 @@
-import type { Foreground, NormalizedEffect, NormalizedForeground } from 'modern-idoc';
+import type { Foreground, NormalizedForeground } from 'modern-idoc';
 import { Element2DFill } from './Element2DFill';
-type Snapshotable = CanvasImageSource & {
-    width: number;
-    height: number;
-};
+/**
+ * 前景 = 带「图片处理管线」的填充。管线（描边/调色/抠图等图片样式）由基类
+ * `Element2DFill` 在图片加载时经注入的解析器烘焙到运行时纹理，本类只在 `Fill`
+ * 之上补充 `fillWithShape`（前景按形状裁切）。
+ */
 export declare class Element2DForeground extends Element2DFill implements NormalizedForeground {
     fillWithShape: NormalizedForeground['fillWithShape'];
-    /** 图片效果叠层（filling/strokes/offset...）；加载后烘焙到运行时 canvas，不持久化 */
-    effects?: NormalizedEffect[];
-    /**
-     * 原图的 CPU 副本（HTMLCanvas），供烘焙 effects 使用。
-     *
-     * 刻意不读 `this.texture.source`：那张 ImageBitmap 由纹理管线持有，会经 GPU
-     * 上传（premultiply）/ 资源 GC 而被消费或 `close()`，其内容与尺寸随运行环境
-     * （含 headless / 自定义 canvas factory）漂移——实测过空白、尺寸异常（如
-     * 3552×3552 全透明）。这份副本一律由 `_resolveSourceCanvas` 从 image 独立解码，
-     * 与 GPU 纹理生命周期彻底解耦。
-     */
-    protected _sourceCanvas?: HTMLCanvasElement;
-    /** `_sourceCanvas` 对应的图片地址，image 变更时用于失效旧副本 */
-    protected _sourceImage?: string;
     setProperties(properties?: Foreground): this;
     protected _updateProperty(key: string, value: any, oldValue: any): void;
-    loadTexture(): Promise<void>;
-    /** 把原图 + effects 烘焙成一张运行时纹理（gif/无 effects 时跳过） */
-    protected _applyEffects(): Promise<void>;
-    /**
-     * 预解码 effects 里 fill.image 用到的图案。烘焙是同步的，图案须先就绪；
-     * 按 url 在资源层缓存复用，未提供的图案在烘焙时会被跳过（不重上色）。
-     */
-    protected _resolvePatterns(): Promise<Record<string, HTMLCanvasElement>>;
-    /**
-     * 取得用于烘焙的 CPU 副本：始终从 image 独立解码一份（createImageBitmap 保证解码
-     * 就绪），快照进 canvas，按 url 在资源层缓存复用。不读 `this.texture.source`——见
-     * `_sourceCanvas` 注释。只缓存真正拿到的副本，避免把空/未就绪结果钉死。
-     */
-    protected _resolveSourceCanvas(): Promise<HTMLCanvasElement | undefined>;
-    /** 把一张存活的图源画进新 canvas（不会被 close，可反复用于烘焙） */
-    protected _snapshot(source: Snapshotable): HTMLCanvasElement | undefined;
 }
-export {};

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

@@ -0,0 +1,11 @@
+import type { ImagePipeline, PipelineImage } from 'modern-idoc';
+/**
+ * 图片处理管线解析器：给定管线步骤与原图像素，返回处理后的像素。
+ *
+ * 引擎本身不认识任何具名管线，只在图片填充加载时把 `pipelines + 像素` 交给注入的
+ * 解析器烘焙（仿 `setCanvasFactory`）。具体管线（描边/调色/抠图等）由上层
+ * （如 mce + @mce/bigesj）注册并实现。返回 `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;

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

@@ -13,3 +13,4 @@ export * from './Element2DStyle';
 export * from './Element2DTable';
 export * from './Element2DText';
 export * from './Flexbox';
+export * from './imagePipeline';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "modern-canvas",
   "type": "module",
-  "version": "0.24.10",
+  "version": "0.24.13",
   "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.1",
+    "modern-idoc": "^0.12.2",
     "modern-path2d": "^1.8.5",
     "modern-text": "^2.0.9"
   },

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

@@ -1,17 +0,0 @@
-import type { NormalizedEffect } from 'modern-idoc';
-type Drawable = CanvasImageSource & {
-    width: number;
-    height: number;
-};
-/**
- * 把 `原图 + effects` 烘焙到一张运行时 canvas（不持久化、不转存图片）。
- * 每层按顺序：fill 重上色 → outline 描边 → 按 transform 位移 / shadow 投影后合成。
- *
- * 合成统一用 destination-over：数组按「前 → 后」堆叠（第 0 层在最上，后续依次落到其后），
- * transform translate 只决定该层落点、不改变堆叠次序。于是「原图层 `{}` 在前 + 位移填充层在后」
- * 即得到「主图在上、彩色副本作为阴影/重影偏移到背后」——与来源编辑器的图片样式一致。
- *
- * 注意：图案填充（fill.image）需异步预加载，未在 patterns 中提供则跳过该填充。
- */
-export declare function bakeImageEffects(source: Drawable, effects: NormalizedEffect[], width: number, height: number, patterns?: Record<string, Drawable>): HTMLCanvasElement;
-export {};