@hankchen/canvas-editor 0.1.1 → 0.3.0

package/dist/index.js

@@ -938,7 +938,35 @@ function buildLayerOutline(doc, lockedPaths = []) {
   }
   return roots;
 }
-function createDefaultLayer(type) {
+var TEXT_PRESETS = [
+  { id: "heading", fontSize: 40 },
+  { id: "subheading", fontSize: 28 },
+  { id: "body", fontSize: 16 }
+];
+function defaultNextTextStyle() {
+  const base = createDefaultLayer("TextLayer");
+  return {
+    font: base.font,
+    fontSize: base.fontSize,
+    fontColor: base.fontColor,
+    autowrap: base.autowrap,
+    lineHeight: base.shape.lineHeight
+  };
+}
+function pickNextTextStylePatch(raw) {
+  const out = {};
+  if (raw === null || typeof raw !== "object") return out;
+  const source = raw;
+  if (typeof source.font === "string") out.font = source.font;
+  if (typeof source.fontSize === "number" && Number.isFinite(source.fontSize)) out.fontSize = source.fontSize;
+  if (typeof source.fontColor === "string") out.fontColor = source.fontColor;
+  if (typeof source.autowrap === "boolean") out.autowrap = source.autowrap;
+  if (typeof source.lineHeight === "number" && Number.isFinite(source.lineHeight) && source.lineHeight > 0) {
+    out.lineHeight = source.lineHeight;
+  }
+  return out;
+}
+function createDefaultLayer(type, textDefaults) {
   const base = {
     // name/visible 缺省态（layer-panel-ux 工单 01）：未命名 + 可见，wire 键省略
     name: "",
@@ -958,19 +986,26 @@ function createDefaultLayer(type) {
     position: { anchor: "top-left", x: 0, y: 0 }
   };
   switch (type) {
-    case "TextLayer":
-      return {
+    case "TextLayer": {
+      const layer = {
         ...base,
         type,
-        shape: { ...base.shape, width: 200, height: 60 },
+        shape: {
+          ...base.shape,
+          width: 200,
+          height: 60,
+          lineHeight: textDefaults?.lineHeight ?? base.shape.lineHeight
+        },
         text: "\u6587\u672C",
         expression: null,
-        font: "",
-        fontSize: 24,
-        fontColor: "#111827",
+        font: textDefaults?.font ?? "",
+        fontSize: textDefaults?.fontSize ?? 24,
+        fontColor: textDefaults?.fontColor ?? "#111827",
         angle: 0,
-        autowrap: false
+        autowrap: textDefaults?.autowrap ?? false
       };
+      return layer;
+    }
     case "ImageLayer":
       return { ...base, type, shape: { ...base.shape, width: 200, height: 150 }, src: null, expression: null };
     case "QrCodeLayer":
@@ -1051,8 +1086,8 @@ function moveTableRowInDraft(draft, tablePath, fromRow, toRow) {
   rows.splice(reduced, 0, moved);
   return { from: fromRow, to: reduced };
 }
-function addRootLayerInDraft(draft, type) {
-  return insertRootLayerInDraft(draft, createDefaultLayer(type));
+function addRootLayerInDraft(draft, type, textDefaults) {
+  return insertRootLayerInDraft(draft, createDefaultLayer(type, textDefaults));
 }
 function insertRootLayerInDraft(draft, layer) {
   let min = Number.POSITIVE_INFINITY;
@@ -1407,6 +1442,9 @@ function resourceStatusesEqual(a, b) {
   }
   return true;
 }
+function nextTextStyleEqual(a, b) {
+  return a.font === b.font && a.fontSize === b.fontSize && a.fontColor === b.fontColor && a.autowrap === b.autowrap && a.lineHeight === b.lineHeight;
+}
 var EditorStore = class {
   docValue = null;
   uiValue = {
@@ -1420,6 +1458,7 @@ var EditorStore = class {
     editing: null,
     renaming: null,
     anchorExpanded: false,
+    nextTextStyle: defaultNextTextStyle(),
     dataSourceSchema: null,
     guides: [],
     rulersVisible: true,
@@ -1451,7 +1490,7 @@ var EditorStore = class {
   }
   /** 打开/替换文档：ui 选择/编辑/重命名会话与双向历史一并重置（新文档不继承旧路径/旧事务）；
    *  参考线/锁定集合/查找会话/建层武装与画拉会话随当次会话清空（对位轴/文档内容防护/
-   *  查询词/待命层型不跨文档），标尺显隐作为偏好保留 */
+   *  查询词/待命层型不跨文档），标尺显隐/锚点折叠/新层样式作为偏好保留 */
   openDocument(canvas) {
     this.docValue = canvas;
     this.undoSteps = [];
@@ -1585,6 +1624,16 @@ var EditorStore = class {
     this.uiValue = { ...this.uiValue, anchorExpanded: open };
     this.notify({ scope: "ui", branch: "anchorExpanded" });
   }
+  /**
+   * 新层样式槽逐字段合并（text-defaults 工单 01：捕获/预设/prefs 恢复的统一
+   * 写入口）：patch 并入现值，五字段值等短路（重复写同值零通知），不进历史。
+   */
+  setNextTextStyle(patch) {
+    const next = { ...this.uiValue.nextTextStyle, ...patch };
+    if (nextTextStyleEqual(this.uiValue.nextTextStyle, next)) return;
+    this.uiValue = { ...this.uiValue, nextTextStyle: next };
+    this.notify({ scope: "ui", branch: "nextTextStyle" });
+  }
   /**
    * 数据源 schema 声明替换（归一产物或降级 null，校验收口在注入缝不在这里）：
    * 同引用短路（重复注入同一归一产物不惊动订阅方）；仅 ui 通知，不参与重绘
@@ -1797,6 +1846,27 @@ function classifyEditorShortcut(input, bindings = DEFAULT_EDITOR_SHORTCUTS) {
   return null;
 }
 
+// src/session/editorState.ts
+var EDITOR_STATE_SCHEMA_VERSION = 1;
+function parseCanvasEditorState(state) {
+  const raw = state;
+  if (raw === null || typeof raw !== "object") return null;
+  const source = raw;
+  if (!Array.isArray(source.guides) || !Array.isArray(source.lockedPaths)) return null;
+  const guides = [];
+  for (const entry of source.guides) {
+    if (entry === null || typeof entry !== "object" || Array.isArray(entry)) return null;
+    const { orientation, position } = entry;
+    if (orientation !== "horizontal" && orientation !== "vertical") return null;
+    if (typeof position !== "number" || !Number.isFinite(position)) return null;
+    guides.push({ orientation, position });
+  }
+  for (const path of source.lockedPaths) {
+    if (!Array.isArray(path)) return null;
+  }
+  return { guides, lockedPaths: source.lockedPaths };
+}
+
 // src/editing/fontCatalog.ts
 var FontCatalog = class {
   builtin;
@@ -1931,6 +2001,12 @@ function clampFindCursor(cursor, count) {
   if (count <= 0) return 0;
   return Math.min(Math.max(cursor, 0), count - 1);
 }
+function captureFieldOfKey(key) {
+  const single = key.length === 1 ? key[0] : null;
+  if (single === "font" || single === "fontSize" || single === "fontColor" || single === "autowrap") return single;
+  if (key.length === 2 && key[0] === "shape" && key[1] === "lineHeight") return "lineHeight";
+  return null;
+}
 function hasValidExpressionFragment(template) {
   return scanExpressionFragments(template).parts.some(
     (part) => part.kind === "fragment" && part.error === null
@@ -2024,9 +2100,16 @@ var EditorSession = class {
     return this.surfaceSize;
   }
   // ---- 相机动作（视口 {x, y, zoom} 走 ui 分支，不进历史） ----
-  /** 打开/替换文档（转发 store；解码在宿主侧完成，内核只消费领域结构） */
-  openDocument(canvas) {
+  /**
+   * 打开/替换文档（转发 store；解码在宿主侧完成，内核只消费领域结构）。
+   * state 传切片即按 restoreEditorState 同一管线原子应用（reset → apply 切片 →
+   * prune）——「开了就恢复」，宿主切帧处不可能忘记重放；切片形状不合法整体拒
+   * （画布照常以默认态打开），现网单参调用零破坏。
+   */
+  openDocument(canvas, state) {
     this.store.openDocument(canvas);
+    if (state === void 0) return;
+    this.restoreEditorState(state);
   }
   /**
    * 预览视图（只读衍生）：模板态表格在视图中获得一行预览行（文本格 = 表达式
@@ -2508,8 +2591,17 @@ var EditorSession = class {
    * 武装建层（面板新增项/层型快捷键的统一入口，CONTEXT「武装」词条）：置 ui
    * 分支待命层型，下一次画布按下即开画拉；建层提交或 Esc 即解除——一次性
    * 待命态，无粘性工具（spec 决策 2）。重复武装同型值等短路零通知。
+   *
+   * preset（text-defaults 工单 01，CONTEXT「文本预设」词条）：文本预设 = 写
+   * 新层样式槽的快捷方式——命中档位先把档位值并入槽（v1 只 fontSize），再
+   * 武装；仅 TextLayer 生效；未知 id = 跳过写槽、武装照常（评审口径统一：
+   * 「空转」只指写槽，武装层型本身仍合法）。
    */
-  armLayerCreate(type) {
+  armLayerCreate(type, preset) {
+    if (preset !== void 0 && type === "TextLayer") {
+      const entry = TEXT_PRESETS.find((candidate) => candidate.id === preset);
+      if (entry) this.store.setNextTextStyle({ fontSize: entry.fontSize });
+    }
     this.store.setArmedCreate(type);
   }
   /** 解除建层武装（取消入口）：仅清待命态，零副作用。 */
@@ -2587,7 +2679,7 @@ var EditorSession = class {
     const clicked = Math.hypot(dx, dy) <= deadZoneScene;
     const index = { v: -1 };
     this.store.transact((draft) => {
-      const layer = createDefaultLayer(gesture.type);
+      const layer = createDefaultLayer(gesture.type, this.store.ui.nextTextStyle);
       if (clicked) {
         layer.position = { ...layer.position, x: gesture.startScene.x, y: gesture.startScene.y };
       } else {
@@ -2738,6 +2830,58 @@ var EditorSession = class {
   toggleRulers() {
     this.store.setRulersVisible(!this.store.ui.rulersVisible);
   }
+  // ---- 编辑器状态导出与恢复（project-data 工单 01，spec §5）：与 addGuide/toggleLayerLock 同门——ui 分支写、不进历史、不写 graph ----
+  /**
+   * 导出当前打开画布的编辑器状态切片：guides 原样带出（id 是会话内自增值，
+   * 宿主不持久化其语义——restore 端重排重取号）、lockedPaths 原样。无文档也可
+   * 导出（ui 分支自成事实，addGuide 无 doc 守卫同门）。内核帧盲：宿主把各帧
+   * 切片按帧名组装成 frames 容器，加上 schemaVersion（EDITOR_STATE_SCHEMA_VERSION）
+   * 与 getEditorPrefs() 才是完整工程数据快照，经宿主层存储——容器不进内核。
+   */
+  exportEditorState() {
+    return { guides: this.store.ui.guides, lockedPaths: this.store.ui.lockedPaths };
+  }
+  /**
+   * 恢复当前画布的状态切片（prefs 不在此——内核跨 openDocument 自持）：轻结构
+   * 校验（形状不合法整体拒，返 false 宿主记因）→ 整体替换 lockedPaths →
+   * pruneDanglingPaths（悬空锁路径剔除——合法但内容悬空不算拒，prune 兜底）→
+   * guide id 重排（清空后逐条 addGuide 重取号：快照 id 无持久语义，原样入栈必
+   * 与新会话 guideIdSeq 撞号致 removeGuide 误删）。不进历史、不写 graph（红线
+   * 同门）。
+   */
+  restoreEditorState(state) {
+    const slice = parseCanvasEditorState(state);
+    if (slice === null) return false;
+    this.store.setLockedPaths(slice.lockedPaths);
+    this.pruneDanglingPaths();
+    if (this.store.ui.guides.length > 0) this.store.setGuides([]);
+    for (const guide of slice.guides) this.addGuide(guide);
+    return true;
+  }
+  /**
+   * 只读偏好（保存 prefs 的读取口）：与 store.ui 同源，给宿主一个不用下钻
+   * store 的口。读 = getEditorPrefs，写 = applyEditorPrefs，对称成对；帧切片
+   * 走 restoreEditorState，两不相混。
+   */
+  getEditorPrefs() {
+    const ui = this.store.ui;
+    return {
+      rulersVisible: ui.rulersVisible,
+      anchorExpanded: ui.anchorExpanded,
+      nextTextStyle: ui.nextTextStyle
+    };
+  }
+  /**
+   * 应用偏好（会话建立时一次性，跨会话恢复 prefs 的写入口）：整体替换
+   * rulersVisible/anchorExpanded，不进历史；值等写入经 store 短路零通知。
+   * 新层样式（text-defaults 工单 01）走宽容读逐字段合并（pickNextTextStylePatch
+   * 共享谓词——与捕获同门，缺字/类型不符保留现值）。
+   */
+  applyEditorPrefs(prefs) {
+    this.store.setRulersVisible(prefs.rulersVisible);
+    this.store.setAnchorExpanded(prefs.anchorExpanded);
+    this.store.setNextTextStyle(pickNextTextStylePatch(prefs.nextTextStyle));
+  }
   // ---- 对齐画布（layer-align-snap 工单 01）：图层盒整体对齐画布几何 ----
   /**
    * 对齐画布 action 族（对齐画布/贴边/贴角，ADR 0011）：把 path 处图层盒整体
@@ -2964,6 +3108,23 @@ var EditorSession = class {
       renormalizeAutoHeightInDraft(layer);
       canonicalizeTableSyncInDraft(draft, path, key, this.textPolicies);
     }, options);
+    this.captureNextTextStyle(path, key, value);
+  }
+  /**
+   * 新层样式捕获（text-defaults 工单 01，CONTEXT「新层样式」词条）：属性面板
+   * 对 TextLayer 文本族五字段的权威写顺带更新偏好槽——「用户改过一次，下一个
+   * 新层沿用」。捕获口唯一（updateSpec 漏斗）：内容写（updateData）、样式粘贴
+   * （搬运不是偏好）、撤销重做都不经过此口。字段合法性走 editing 域共享谓词
+   * pickNextTextStylePatch（与 prefs 宽容读同门，评审合流不再双写）：目标层非
+   * TextLayer、键不命中或值类型不符即空转，符合字段经值等短路入槽。
+   */
+  captureNextTextStyle(path, key, value) {
+    const layer = this.store.doc ? resolveLayer(this.store.doc, path) : null;
+    if (!layer || layer.type !== "TextLayer") return;
+    const field = captureFieldOfKey(key);
+    if (field === null) return;
+    const patch = pickNextTextStylePatch({ [field]: value });
+    if (patch[field] !== void 0) this.store.setNextTextStyle(patch);
   }
   /**
    * 更新图层数据字段（wire data.value 的领域展开，按 type 分派）：
@@ -3150,7 +3311,7 @@ var EditorSession = class {
     if (!this.store.doc) return;
     const index = { v: -1 };
     this.store.transact((draft) => {
-      index.v = addRootLayerInDraft(draft, type);
+      index.v = addRootLayerInDraft(draft, type, this.store.ui.nextTextStyle);
     });
     if (index.v >= 0) this.store.setSelection(["layers", index.v]);
   }
@@ -4161,6 +4322,7 @@ export {
   CREATE_DEAD_ZONE_SCREEN_PX,
   DEFAULT_EDITOR_SHORTCUTS,
   DEFAULT_ZOOM_BOUNDS,
+  EDITOR_STATE_SCHEMA_VERSION,
   EditorSession,
   EditorStore,
   FontCatalog,
@@ -4176,6 +4338,7 @@ export {
   RESIZE_MIN_SIZE_PX,
   SNAP_THRESHOLD_SCREEN_PX,
   STYLE_FIELD_KEYS_BY_TYPE,
+  TEXT_PRESETS,
   UploadHandlerMissingError,
   VERTICAL_ALIGNS,
   WHEEL_ZOOM_STEP,
@@ -4199,6 +4362,7 @@ export {
   createDefaultLayer,
   createRubberBandRect,
   createTemplateTable,
+  defaultNextTextStyle,
   deleteLayerInDraft,
   enumerateExpressionCandidates,
   enumerateRowsPathCandidates,
@@ -4234,6 +4398,7 @@ export {
   pastePosition,
   pathStartsWith,
   pathsEqual,
+  pickNextTextStylePatch,
   prepareRootPaste,
   readSpecField,
   remapPathAfterSplice,