mce 0.28.1 → 0.29.0

package/dist/mixins/2.box.d.ts

@@ -9,6 +9,20 @@ declare global {
             obbToDrawboardObb: (aabb: Obb2D) => Obb2D;
             getAabb: (node: Node | Node[] | undefined, inTarget?: 'drawboard' | 'frame' | 'parent') => Aabb2D;
             aabbToDrawboardAabb: (aabb: Aabb2D) => Aabb2D;
+            globalToDrawboard: (point: {
+                x: number;
+                y: number;
+            }) => {
+                x: number;
+                y: number;
+            };
+            drawboardToGlobal: (point: {
+                x: number;
+                y: number;
+            }) => {
+                x: number;
+                y: number;
+            };
             viewportAabb: ComputedRef<Aabb2D>;
             rootAabb: ComputedRef<Aabb2D>;
             selectionAabb: ComputedRef<Aabb2D>;

package/dist/mixins/exporter.d.ts

@@ -15,6 +15,18 @@ declare global {
             saveAs?: boolean | ((exported: any) => Blob);
             handle: ExporterHandle;
         }
+        interface RenderFramesOptions {
+            /** to('json') 的导出数据，需含 meta.startTime / meta.endTime。 */
+            data: any;
+            width: number;
+            height: number;
+            /** 帧间隔（毫秒）。 */
+            step: number;
+            onFrame: (pixels: Uint8ClampedArray, info: {
+                duration: number;
+                progress: number;
+            }) => void | Promise<void>;
+        }
         interface Editor {
             exporters: Reactive<Map<string, Exporter>>;
             registerExporter: (value: Exporter | Exporter[]) => void;
@@ -23,6 +35,8 @@ declare global {
             to: <K extends keyof Exporters>(name: K, options?: ExportOptions) => Exporters[K];
             exporting: Ref<boolean>;
             exportProgress: Ref<number>;
+            /** 按 step 逐帧渲染时间轴并回调像素，供 gif/mp4 等视频导出复用。 */
+            renderFrames: (options: RenderFramesOptions) => Promise<void>;
         }
     }
 }

package/dist/utils/base64.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 将 base64 字符串（或 data URL）解码为字节数组。
+ * 统一各插件中重复的 `atob(...).charCodeAt` 解码样板。
+ */
+export declare function base64ToBytes(base64: string): Uint8Array;
+/** 将 base64 字符串解码为 UTF-8 文本。 */
+export declare function base64ToText(base64: string): string;

package/dist/utils/components.d.ts

@@ -20,11 +20,6 @@ export type InstanceOverrides = Record<string, any>;
  * （addElement 的 regenId 只清顶层 id，子节点 id 会冲突。）
  */
 export declare function stripNodeIds<T>(node: T): T;
-/**
- * 按 path → value 应用一组覆盖。返回新对象，不改输入。
- * 值为普通对象时与原值**深合并**（便于只覆盖 `style` 的部分字段而不丢其余）；
- * 基本类型 / 数组则整值替换。
- */
 export declare function applyOverrides<T>(node: T, overrides?: InstanceOverrides): T;
 /**
  * 从 master 定义实例化一份节点 JSON：先剥 id（保证新实例独立），再叠加 override。

package/dist/utils/index.d.ts

@@ -1,5 +1,6 @@
 export * from './animationPresets';
 export * from './arrow';
+export * from './base64';
 export * from './box';
 export * from './components';
 export * from './console';
@@ -12,8 +13,10 @@ export * from './image';
 export * from './keyframes';
 export * from './lottie';
 export * from './propsFactory';
+export * from './registry';
 export * from './remapTextSelection';
 export * from './saveAs';
+export * from './source';
 export * from './transform';
 export * from './traverse';
 export * from './variables';

package/dist/utils/registry.d.ts

@@ -0,0 +1,11 @@
+import type { Reactive } from 'vue';
+export interface MapRegistry<T> {
+    map: Reactive<Map<string, T>>;
+    register: (value: T | T[]) => void;
+    unregister: (key: string) => void;
+}
+/**
+ * 创建一个以字符串为键的响应式注册表。
+ * 统一「reactive(Map) + 数组展平 register + delete unregister」样板。
+ */
+export declare function createMapRegistry<T>(keyFn: (item: T) => string): MapRegistry<T>;

package/dist/utils/source.d.ts

@@ -0,0 +1,12 @@
+export interface MatchSourceOptions {
+    /** 文件名扩展名匹配（针对 File）。 */
+    ext?: RegExp;
+    /** MIME 前缀匹配（针对 Blob/File，命中任一即可）。 */
+    mime?: string | string[];
+}
+/**
+ * 生成 loader 的 `test` 谓词，统一各导入插件中重复的 `instanceof File/Blob` + 扩展名/MIME 判定。
+ * - File：先按扩展名匹配，再回退 MIME 前缀；
+ * - 其它 Blob：按 MIME 前缀匹配。
+ */
+export declare function matchSource(options: MatchSourceOptions): (source: any) => boolean;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mce",
   "type": "module",
-  "version": "0.28.1",
+  "version": "0.29.0",
   "description": "A headless infinite canvas editor framework built on WebGL rendering, supports exporting to image, video, and PPT. Only the ESM.",
   "author": "wxm",
   "license": "MIT",