mce 0.26.1 → 0.27.0

package/dist/locale/en.d.ts

@@ -86,6 +86,7 @@ declare const _default: {
     collapse: string;
     removeKeyframe: string;
     custom: string;
+    default: string;
     saveEasingPreset: string;
     playbackRate: string;
     loopMode: string;
@@ -98,16 +99,6 @@ declare const _default: {
     animGroupIn: string;
     animGroupOut: string;
     animGroupEmphasis: string;
-    fadeIn: string;
-    slideInLeft: string;
-    slideInRight: string;
-    slideInUp: string;
-    slideInDown: string;
-    popIn: string;
-    fadeOut: string;
-    slideOutDown: string;
-    pulse: string;
-    spin: string;
     interactions: string;
     preview: string;
     exitPreview: string;

package/dist/locale/zh-Hans.d.ts

@@ -87,6 +87,7 @@ declare const _default: {
     collapse: string;
     removeKeyframe: string;
     custom: string;
+    default: string;
     saveEasingPreset: string;
     playbackRate: string;
     loopMode: string;
@@ -99,16 +100,6 @@ declare const _default: {
     animGroupIn: string;
     animGroupOut: string;
     animGroupEmphasis: string;
-    fadeIn: string;
-    slideInLeft: string;
-    slideInRight: string;
-    slideInUp: string;
-    slideInDown: string;
-    popIn: string;
-    fadeOut: string;
-    slideOutDown: string;
-    pulse: string;
-    spin: string;
     interactions: string;
     preview: string;
     exitPreview: string;

package/dist/mixins/extensions.d.ts

@@ -1,5 +1,6 @@
 import type { Element2D } from 'modern-canvas';
 import type { Component, Ref } from 'vue';
+import type { AnimationPreset } from '../utils';
 declare global {
     namespace Mce {
         /**
@@ -93,6 +94,14 @@ declare global {
              */
             toolbeltItems: Ref<ToolbeltItem[]>;
             registerToolbeltItem: (item: ToolbeltItem) => void;
+            /**
+             * 插件注册的动画预设（进入 / 退出 / 强调）。核心不内置任何预设——
+             * Timeline / Trackhead 的「添加动画」菜单据此生成，为空时不显示添加入口。
+             * 注册同 id 则覆盖。预设的显示名走 i18n（`t(preset.id)`），由注册方提供文案。
+             */
+            animationPresets: Ref<AnimationPreset[]>;
+            registerAnimationPreset: (preset: AnimationPreset) => void;
+            getAnimationPreset: (id: string) => AnimationPreset | undefined;
         }
     }
 }

package/dist/plugin.d.ts

@@ -11,7 +11,7 @@ export interface PluginPanelComponent extends PluginBaseComponent {
     name: string;
     position: 'float' | 'top' | 'right' | 'bottom' | 'left';
     size?: number;
-    /** 停靠面板是否可拖拽调整尺寸（默认 true；细条如 statusbar 设 false）。 */
+    /** 停靠面板是否可拖拽调整尺寸（默认 false；尺寸跟随 size，需拖拽时显式设 true）。 */
     resizable?: boolean;
     /** 停靠面板拖拽尺寸下限 / 上限。 */
     minSize?: number;

package/dist/utils/animationPresets.d.ts

@@ -1,8 +1,11 @@
 import type { Keyframe } from './keyframes';
 /**
- * 预设动画库（纯数据 / 纯函数）。每个预设按元素「当前基础样式」生成扁平关键帧
- * （而非写死绝对值），分为进入 / 退出 / 强调三类。利用 modern-canvas Animation 的
- * 两端填充特性：进入动画收尾停在基础值、退出动画收尾保持终值，无需额外 fill 配置。
+ * 动画预设的类型契约（核心只提供类型，不内置任何预设）。
+ * 预设由插件 / 宿主经 `editor.registerAnimationPreset` 注册，分进入 / 退出 / 强调三类。
+ *
+ * 约定：`build` 依据元素「当前基础样式」生成扁平关键帧（而非写死绝对值），
+ * 利用 modern-canvas Animation 的两端填充——进入收尾停在基础值、退出收尾保持终值，
+ * 无需额外 fill 配置。
  */
 export type PresetCategory = 'in' | 'out' | 'emphasis';
 export interface PresetChannels {
@@ -23,5 +26,3 @@ export interface AnimationPreset {
     /** 依据元素基础样式生成关键帧。 */
     build: (base: PresetChannels) => Keyframe[];
 }
-export declare const ANIMATION_PRESETS: AnimationPreset[];
-export declare function getPreset(id: string): AnimationPreset | undefined;

package/dist/utils/index.d.ts

@@ -14,5 +14,6 @@ export * from './lottie';
 export * from './propsFactory';
 export * from './remapTextSelection';
 export * from './saveAs';
+export * from './transform';
 export * from './traverse';
 export * from './variables';

package/dist/utils/transform.d.ts

@@ -0,0 +1,28 @@
+/**
+ * CSS transform 字符串的解析 / 序列化（用于关键帧编辑：WAAPI 风格的 transform 关键帧
+ * 拆成可编辑分量，改完再拼回字符串，存储仍是原始 transform 字符串）。纯函数，可单测。
+ */
+export interface TransformFn {
+    name: string;
+    /** 各参数的数值与单位（如 100 + '%'、-30 + 'deg'、1 + ''）。 */
+    args: {
+        value: number;
+        unit: string;
+    }[];
+}
+/** 解析 transform 字符串为有序函数列表；保留函数顺序与各参数单位。 */
+export declare function parseTransform(input: string): TransformFn[];
+/** 把函数列表拼回 transform 字符串（顺序、单位与解析时一致）。 */
+export declare function serializeTransform(fns: TransformFn[]): string;
+/** 单个可编辑分量：定位到某函数的某个参数，带友好标签。 */
+export interface TransformField {
+    label: string;
+    value: number;
+    unit: string;
+    fnIndex: number;
+    argIndex: number;
+}
+/** 从 transform 字符串提取可编辑分量列表（仅暴露有意义的参数）。 */
+export declare function transformFields(fns: TransformFn[]): TransformField[];
+/** 不可变地更新某分量的数值，返回新的 transform 字符串。 */
+export declare function setTransformField(fns: TransformFn[], fnIndex: number, argIndex: number, value: number): string;

package/dist/utils/transform.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mce",
   "type": "module",
-  "version": "0.26.1",
+  "version": "0.27.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",
@@ -60,9 +60,9 @@
     "@vueuse/core": "^14.3.0",
     "diff": "^9.0.0",
     "lodash-es": "^4.18.1",
-    "modern-canvas": "^0.24.1",
+    "modern-canvas": "^0.24.2",
     "modern-font": "^0.6.1",
-    "modern-idoc": "^0.12.0",
+    "modern-idoc": "^0.12.1",
     "modern-text": "^2.0.6",
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.31"