modern-canvas 0.23.0 → 0.23.2

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

@@ -1,4 +1,4 @@
-import type { Background, Chart, Connection, Display, Fill, Foreground, Outline, Shadow, Shape, Table, Text } from 'modern-idoc';
+import type { Background, Chart, Connection, Display, Fill, Foreground, NormalizedFilter, Outline, Shadow, Shape, Table, Text } from 'modern-idoc';
 import type { Path2D, Vector2Like } from 'modern-path2d';
 import type { InputEvent, InputEventKey } from '../../../core';
 import type { Node, Rectangulable, RectangulableEvents, SceneTree, Viewport } from '../../main';
@@ -41,6 +41,8 @@ export interface Element2DProperties extends Node2DProperties {
     connection: Connection;
     table: Table;
     chart: Chart;
+    /** 元素级结构化滤镜（Effect.filter），转成 CSS filter 后与 style.filter 合并 */
+    filter: NormalizedFilter;
 }
 export declare class Element2D extends Node2D implements Rectangulable {
     readonly flexbox: Flexbox;
@@ -109,7 +111,12 @@ export declare class Element2D extends Node2D implements Rectangulable {
     protected _updateConnection(): void;
     protected _cullsRender(): boolean;
     protected _intersectsViewport(viewport: Viewport): boolean;
+    protected _styleFilter?: string;
+    protected _elementFilter?: string;
     protected _updateStyleFilter(value?: string): void;
+    /** 元素级结构化滤镜 Effect.filter → CSS filter，与 style.filter 合并 */
+    protected _updateElementFilter(filter?: NormalizedFilter): void;
+    protected _applyColorFilter(): void;
     protected _updateStyleMaskImage(value?: string): void;
     protected _getPointArray(): Vector2Like[];
     getRect(): Aabb2D;

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

@@ -1,7 +1,19 @@
-import type { Foreground, NormalizedForeground } from 'modern-idoc';
+import type { Foreground, NormalizedEffect, NormalizedForeground } from 'modern-idoc';
 import { Element2DFill } from './Element2DFill';
 export declare class Element2DForeground extends Element2DFill implements NormalizedForeground {
     fillWithShape: NormalizedForeground['fillWithShape'];
+    /** 图片效果叠层（filling/strokes/offset...）；加载后烘焙到运行时 canvas，不持久化 */
+    effects?: NormalizedEffect[];
+    /**
+     * 原图的 CPU 副本（HTMLCanvas），在纹理刚加载、source 仍存活时拍下。
+     * 用于烘焙 effects：纹理的 ImageBitmap source 上传 GPU 后可能被
+     * `close()`（detached，width/height 归零），此时直接 drawImage 会抛
+     * InvalidStateError，故始终从这份不会失效的副本烘焙。
+     */
+    protected _sourceCanvas?: HTMLCanvasElement;
     setProperties(properties?: Foreground): this;
     protected _updateProperty(key: string, value: any, oldValue: any): void;
+    loadTexture(): Promise<void>;
+    /** 把原纹理 + effects 烘焙成一张运行时 canvas，包成 CanvasTexture（gif/无 effects 时跳过） */
+    protected _applyEffects(): void;
 }

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

@@ -0,0 +1,13 @@
+import type { NormalizedEffect } from 'modern-idoc';
+type Drawable = CanvasImageSource & {
+    width: number;
+    height: number;
+};
+/**
+ * 把 `原图 + effects` 烘焙到一张运行时 canvas（不持久化、不转存图片）。
+ * 每层按顺序：fill 重上色 → outline 描边 → 按 transform 位移 / shadow 投影合成。
+ *
+ * 注意：图案填充（fill.image）需异步预加载，未在 patterns 中提供则跳过该填充。
+ */
+export declare function bakeImageEffects(source: Drawable, effects: NormalizedEffect[], width: number, height: number, patterns?: Record<string, Drawable>): HTMLCanvasElement;
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "modern-canvas",
   "type": "module",
-  "version": "0.23.0",
+  "version": "0.23.2",
   "packageManager": "pnpm@10.19.0",
   "description": "A JavaScript WebGL rendering engine. only the ESM.",
   "author": "wxm",
@@ -54,7 +54,7 @@
     "dev": "vite playground",
     "lint": "eslint src playground test",
     "version": "conventional-changelog -p angular -i CHANGELOG.md -s && git add CHANGELOG.md",
-    "release": "pnpm typecheck && pnpm lint && pnpm test --run && bumpp package.json --commit \"release: v%s\" --push --all --tag",
+    "release": "pnpm typecheck && pnpm lint && pnpm vitest run && bumpp package.json --commit \"release: v%s\" --push --all --tag",
     "start": "esno src/index.ts",
     "test": "vitest",
     "typecheck": "tsc --noEmit"
@@ -63,7 +63,7 @@
     "colord": "^2.9.3",
     "earcut": "^3.0.2",
     "modern-font": "^0.6.0",
-    "modern-idoc": "^0.11.8",
+    "modern-idoc": "^0.11.9",
     "modern-path2d": "^1.8.5",
     "modern-text": "^2.0.3"
   },