@hankchen/canvas-editor 0.6.0 → 0.7.0

package/dist/index.d.ts

@@ -509,16 +509,20 @@ interface NextTextStyle {
 }
 /** 文本预设档位（CONTEXT「文本预设」词条）：heading 40 / subheading 28 / body 16 */
 type TextPresetId = 'heading' | 'subheading' | 'body';
+/** 文本预设档位条目（评审整改 F2 查档返回面，RatioPreset 同形）：具名 id + 档位字号 */
+interface TextPreset {
+    readonly id: TextPresetId;
+    readonly fontSize: number;
+}
 /** 文本预设常量（spec 决策 4）：v1 只定字号——字体缺口由新层样式槽补 */
-declare const TEXT_PRESETS: readonly {
-    id: TextPresetId;
-    fontSize: number;
-}[];
+declare const TEXT_PRESETS: readonly TextPreset[];
 /** 新层样式槽初值：自工厂 TextLayer 形态派生（工厂缺省是单一事实源，槽跟着走） */
 declare function defaultNextTextStyle(): NextTextStyle;
 /**
  * 建层比例档位（spec 决策 1/2）：'free' = 自由钳（工厂行为兜底），其余五个具名
- * 有理数比。v1 固定清单、无自定义输入。
+ * 有理数比。v1 固定清单、无自定义输入。清单随建层比例槽退役保持不动
+ * （canvas-web-preset-submenu 工单 01，ADR 0021）：free 仍是「自由」枚举值与
+ * Shift 语义引用，具名档由武装预设载荷（armedCreatePreset）一次性携带消费。
  */
 type RatioPresetId = 'free' | '1:1' | '4:3' | '3:4' | '16:9' | '9:16';
 /** 比例预设档位：具名 id + 有理数宽高比（free 档 ratio = null，即不钳） */
@@ -531,19 +535,24 @@ interface RatioPreset {
 }
 /** 比例预设常量六档（顺序即面板平铺序：自由在前，其余按惯例短比在前） */
 declare const RATIO_PRESETS: readonly RatioPreset[];
-/** 建层比例槽初值：自由（工厂画拉行为兜底） */
-declare function defaultNextLayerRatio(): RatioPresetId;
 /** 档位 → 钳制用有理数比：'free' → null（不钳），具名档 → {w, h} 副本 */
 declare function ratioValue(id: RatioPresetId): {
     w: number;
     h: number;
 } | null;
 /**
- * 建层比例槽的宽容读（prefs 恢复唯一入口）：六档枚举值原样收，其余（旧快照
- * 缺字段/存储端脏值）回落 'free'。载荷来自宿主 JSON 快照，类型层的形状信任
- * 不了，运行时验；未知 prefs 键由调用方整体忽略（不进本函数视野）。
+ * 层型预设档位查档（canvas-web-preset-submenu 评审整改 F2）：武装/画拉会话载荷的
+ * 档位 id 按层型分流到对应清单单点查找——TextLayer 查 TEXT_PRESETS、ImageLayer 查
+ * RATIO_PRESETS，其余层型（无预设语义）与交叉类型（文本层带比例档/图片层带文本
+ * 档）在对方清单查无此档，返回 undefined（「未知 id = 不落载荷、武装照常」评审
+ * 口径的查表面）。session 建层管线的档位查找（armLayerCreate / endCreate）经此
+ * 消费，档比复制语义复用 ratioValue；presetId 收 string——store 载荷是 string
+ * 形态（ui 分支不翻译型），查档天然宽容（未知 id 查无）。重载让层型字面量收窄
+ * 返回面：TextLayer 只得文本档、ImageLayer 只得比例档。
  */
-declare function pickNextLayerRatio(raw: unknown): RatioPresetId;
+declare function findPresetEntry(type: LayerType, presetId: string): TextPreset | RatioPreset | undefined;
+declare function findPresetEntry(type: 'TextLayer', presetId: string): TextPreset | undefined;
+declare function findPresetEntry(type: 'ImageLayer', presetId: string): RatioPreset | undefined;
 /**
  * 死区点击缺省盒的比例派生（spec 决策 3）：长边 200 定短边——短边 = round(长边
  * × 短比)（Math.round 对正数 half-up：16:9 → 200×113）。自由档不进本函数
@@ -895,6 +904,14 @@ interface CreateGesture {
      * （G 快捷键 V1 空表语义原样）。
      */
     templateRowsPath?: string;
+    /**
+     * 建层预设载荷（canvas-web-preset-submenu 工单 01，ADR 0021）：beginLayerCreate
+     * 时从 ui.armedCreatePreset 捕获（templateRowsPath 同门，会话内定死）——文本层
+     * 载荷命中 TEXT_PRESETS = 档位字号直接生效（不经新层样式槽）；图片层载荷命中
+     * RATIO_PRESETS = 比例钳橡皮筋与死区缺省盒（Shift 瞬时反转源 = 本生效档）。
+     * undefined = 普通武装（文本按槽、图片恒自由）。
+     */
+    preset?: string;
     /** 起点场景坐标（两点正规化与死区判定基准） */
     startScene: Point;
     /** 当前指针场景坐标 */
@@ -965,6 +982,17 @@ interface EditorUi {
      * 不进 wire（红线 3 延伸），beginLayerCreate 捕获进建层会话；openDocument 重置。
      */
     armedCreateRowsPath: string;
+    /**
+     * 武装 token 的预设载荷（canvas-web-preset-submenu 工单 01，ADR 0021）：预设
+     * 随武装一次性携带、不再写任何偏好槽——armedCreate === 'TextLayer' 且本载荷
+     * 命中 TEXT_PRESETS = 文本预设风味（endCreate 按档位字号直接生效，不经新层
+     * 样式槽）；armedCreate === 'ImageLayer' 且本载荷命中 RATIO_PRESETS = 比例
+     * 预设风味（createTo 钳橡皮筋、endCreate 死区缺省盒）。空串 = 普通武装
+     * （文本按新层样式槽、图片恒自由），与 armedCreateRowsPath 同款空值语义。
+     * ui 瞬态载荷——不进 graph、不进 wire、不进 prefs（红线 3 延伸），
+     * beginLayerCreate 捕获进建层会话；openDocument 重置。
+     */
+    armedCreatePreset: string;
     /** 进行中的画拉建层橡皮筋会话（拖拽期纯视觉，文档零变更）；null = 无 */
     create: CreateGesture | null;
     /** 进行中的文本编辑会话；null = 非编辑态 */
@@ -986,18 +1014,10 @@ interface EditorUi {
      * 族字段的权威写（updateSpec 捕获）更新槽，建层（endCreate/addRootLayer）
      * 以槽值覆盖工厂缺省。与锚点折叠同款的面板偏好——openDocument 换文档不重
      * 置，永不进历史；随工程数据 prefs 桶跨会话持久（宿主通道，内核零 localStorage）。
+     * 文本预设档不写槽（canvas-web-preset-submenu 工单 01，ADR 0021：预设随武装
+     * 载荷一次性携带，槽只保留属性面板信号一种语义）。
      */
     nextTextStyle: NextTextStyle;
-    /**
-     * 建层比例槽（image-ratio-preset 工单 01，CONTEXT「建层比例」词条）：记忆
-     * 「下一个新建图片层用什么宽高比」的编辑器级偏好——六档、缺省自由，仅
-     * ImageLayer 消费（QR 恒方是层型硬钳，其余层型无此槽）。比例预设的应用 =
-     * 写槽再武装画拉（armLayerCreate），普通图片层项/快捷键 I 不带 preset、武装
-     * 后按槽值钳制——槽是唯一偏好源。与锚点折叠同款的面板偏好——openDocument
-     * 换文档不重置，永不进历史；随工程数据 prefs 桶跨会话持久（宿主通道，内核
-     * 零 localStorage）。
-     */
-    nextLayerRatio: RatioPresetId;
     /**
      * 数据源 schema 声明（content-completion 工单 03/08，D2 宿主随会话注入）：
      * 编译产物形状树或降级 null（根级结构性拒绝，注入期经
@@ -1095,7 +1115,7 @@ declare class EditorStore {
     get canRedo(): boolean;
     /** 打开/替换文档：ui 选择/编辑/重命名会话与双向历史一并重置（新文档不继承旧路径/旧事务）；
      *  参考线/锁定集合/查找会话/建层武装与画拉会话随当次会话清空（对位轴/文档内容防护/
-     *  查询词/待命层型不跨文档），标尺显隐/锚点折叠/新层样式/建层比例作为偏好保留 */
+     *  查询词/待命层型不跨文档），标尺显隐/锚点折叠/新层样式作为偏好保留 */
     openDocument(canvas: Canvas): void;
     /**
      * 文档事务唯一入口：produceWithPatches 求新树，无变化即空转（不进历史不通知）；
@@ -1128,10 +1148,11 @@ declare class EditorStore {
     /**
      * 建层武装置/解除（null，drag-create 工单 01）；标量值等短路（重复武装同型
      * 不通知）。rowsPath（template-table-drag-create 工单 01）：模板表风味载荷
-     * 与层型一体写——同层型同载荷才短路（重复武装同型换载荷要更新），解除
-     * （null）一律清载荷。
+     * 与层型一体写；preset（canvas-web-preset-submenu 工单 01）：预设载荷与层型
+     * 一体写——同层型同载荷才短路（重复武装同型换载荷要更新），解除（null）
+     * 一律清载荷（rowsPath 与 preset 双清）。
      */
-    setArmedCreate(type: LayerType | null, rowsPath?: string): void;
+    setArmedCreate(type: LayerType | null, rowsPath?: string, preset?: string): void;
     /** 画拉橡皮筋会话开始/更新/结束（null）；会话对象住 ui 分支，落库在 endCreate 单事务 */
     setCreate(gesture: CreateGesture | null): void;
     /** 文本编辑会话开始/结束（null）；会话住 ui 分支，文本经 commitTextEdit 一次性落文档 */
@@ -1141,15 +1162,11 @@ declare class EditorStore {
     /** 锚点折叠区开合：布尔值等短路（重复点击同一态不重绘） */
     setAnchorExpanded(open: boolean): void;
     /**
-     * 新层样式槽逐字段合并（text-defaults 工单 01：捕获/预设/prefs 恢复的统一
-     * 写入口）：patch 并入现值，五字段值等短路（重复写同值零通知），不进历史。
+     * 新层样式槽逐字段合并（text-defaults 工单 01：捕获/prefs 恢复的统一写入口；
+     * canvas-web-preset-submenu 工单 01 起预设不再写槽）：patch 并入现值，五字段
+     * 值等短路（重复写同值零通知），不进历史。
      */
     setNextTextStyle(patch: Partial<NextTextStyle>): void;
-    /**
-     * 建层比例槽写入（image-ratio-preset 工单 01：比例预设应用 / prefs 恢复的
-     * 统一写入口）：值等短路（重复写同档零通知），仅 ui 通知、不进历史。
-     */
-    setNextLayerRatio(id: RatioPresetId): void;
     /**
      * 数据源 schema 声明替换（归一产物或降级 null，校验收口在注入缝不在这里）：
      * 同引用短路（重复注入同一归一产物不惊动订阅方）；仅 ui 通知，不参与重绘
@@ -1268,7 +1285,12 @@ declare function classifyEditorShortcut(input: EditorShortcutInput, bindings?: r
  * 仍是内核唯一保存物。
  */
 
-/** 快照格式版本：随格式演化单调递增；v1 = 1（宽容读贯彻，restore 不分支此值） */
+/**
+ * 快照格式版本：随格式演化单调递增；v1 = 1（宽容读贯彻，restore 不分支此值）。
+ * prefs 桶的 nextLayerRatio 键已随 canvas-web-preset-submenu 工单 01（ADR 0021）
+ * 退役：停写停读、版本不升——旧快照的该键由调用方按宽容读惯例整体忽略（键在
+ * 载荷里多余但无害），加法演进同门前例（text-defaults 工单 01）。
+ */
 declare const EDITOR_STATE_SCHEMA_VERSION = 1;
 /** 帧作用域切片：当前打开画布的编辑器状态（工程数据快照的 frames[帧名] 值） */
 interface CanvasEditorState {
@@ -1290,12 +1312,6 @@ interface EditorPrefsState {
      * 由 applyEditorPrefs 宽容读兜底为现值（会话内即工厂缺省）。
      */
     nextTextStyle: NextTextStyle;
-    /**
-     * 建层比例槽（image-ratio-preset 工单 01，CONTEXT「建层比例」词条）：随 prefs
-     * 桶跨会话持久（per-模板记忆，「自由」即显式重置档）。schemaVersion 不升——
-     * 加法演进，旧快照缺字段或脏值由 applyEditorPrefs 宽容读回落 'free'。
-     */
-    nextLayerRatio: RatioPresetId;
 }
 
 /**
@@ -1714,19 +1730,20 @@ declare class EditorSession {
     /**
      * 武装建层（面板新增项/层型快捷键的统一入口，CONTEXT「武装」词条）：置 ui
      * 分支待命层型，下一次画布按下即开画拉；建层提交或 Esc 即解除——一次性
-     * 待命态，无粘性工具（spec 决策 2）。重复武装同型值等短路零通知。
+     * 待命态，无粘性工具（spec 决策 2）。重复武装同型同载荷值等短路零通知。
      *
-     * preset（text-defaults 工单 01 + image-ratio-preset 工单 01）：层型相关预设 =
-     * 写槽的快捷方式——命中档位先把档位值并入对应偏好槽再武装；未知 id = 跳过
-     * 写槽、武装照常（评审口径统一：「空转」只指写槽，武装层型本身仍合法）。
-     * - TextLayer + 文本预设档：写新层样式槽（v1 只 fontSize）；
-     * - ImageLayer + 比例预设档：写建层比例槽（'free' 即显式重置档）；QR 恒方
-     *   是层型硬钳、无比例槽（spec 豁免面）；
-     * - 交叉类型（文本层带比例档/图片层带文本档）各在对方清单查无此档、天然
-     *   跳写槽。
+     * preset（canvas-web-preset-submenu 工单 01，ADR 0021）：层型相关预设随武装
+     * 载荷一次性携带、**不再写任何偏好槽**——命中档位把档位 id 写进
+     * ui.armedCreatePreset（endCreate 落库一次性消费，取消路零残留）；未知 id =
+     * 不落载荷、武装照常（评审口径统一：「空转」只指载荷，武装层型本身仍合法）。
+     * - TextLayer + 文本预设档：载荷命中 TEXT_PRESETS（endCreate 档位字号直接
+     *   生效，不经新层样式槽——普通武装文本按槽的语义不受染指）；
+     * - ImageLayer + 比例预设档：载荷命中 RATIO_PRESETS（'free' 档载荷行为等价
+     *   自由；QR 恒方是层型硬钳、无比例语义，spec 豁免面）；
+     * - 交叉类型（文本层带比例档/图片层带文本档）各在对方清单查无此档、不落载荷。
      */
     armLayerCreate(type: LayerType, preset?: TextPresetId | RatioPresetId): void;
-    /** 解除建层武装（取消入口）：仅清待命态（含模板表风味载荷），零副作用。 */
+    /** 解除建层武装（取消入口）：仅清待命态（含模板表风味与预设载荷），零副作用。 */
     cancelArmLayerCreate(): void;
     /**
      * 武装模板表建层（canvas-web-template-table-drag-create 工单 01，spec 决策 3）：
@@ -1754,10 +1771,12 @@ declare class EditorSession {
      * 全部可见根层供轴，copyMode 首移同门）。零文档事务：修正只进会话几何，
      * 落库在 endCreate。
      *
-     * 建层比例槽（image-ratio-preset 工单 01，spec 决策 3/4）：仅 ImageLayer 按槽
-     * 钳制（QR 层不传 ratio、恒方语义不动，两钳互斥；其余层型无槽）；Shift 瞬时
-     * 反转槽态——槽非自由按 Shift = 临时自由、槽自由按 Shift = 临时钳 1:1，按住
-     * 生效松开还原（逐帧求位、不写槽、不改武装态，Figma 惯例的手势瞬时语义）。
+     * 建层预设档（canvas-web-preset-submenu 工单 01，ADR 0021，取代建层比例槽）：
+     * 仅 ImageLayer 按会话载荷档钳制（QR 层不传 ratio、恒方语义不动，两钳互斥；
+     * 其余层型无比例语义）；无载荷或 free 档 = 自由钳（普通武装恒自由）。
+     * Shift 瞬时反转源 = 生效档（载荷档或自由）：档具名按 Shift = 临时自由、
+     * 生效档自由（含无载荷）按 Shift = 临时钳 1:1，按住生效松开还原（逐帧求位、
+     * 不写载荷不改武装态，Figma 惯例的手势瞬时语义）。
      */
     createTo(sceneX: number, sceneY: number, shift?: boolean): void;
     /**
@@ -1766,24 +1785,29 @@ declare class EditorSession {
      * - 死区外：单事务写入「createDefaultLayer 缺省形态 + position 左上角对准
      *   橡皮筋矩形（含吸附修正）+ shape.width/height」并 insertRootLayerInDraft
      *   置顶（priority min−1、push 数组尾）——尺寸取手势末态钳制结果（含 Shift
-     *   反转末态，image-ratio-preset 工单 01 spec 决策 4）；
+     *   反转末态，钳制源 = 会话预设档，canvas-web-preset-submenu 工单 01）；
      * - 死区内（点击兜底，位移按 CREATE_DEAD_ZONE_SCREEN_PX 屏幕 px 随 zoom 折算，
-     *   ALT_DRAG_DEAD_ZONE_SCREEN_PX 同门）：左上角对准点击点；尺寸按槽派生缺省
-     *   盒（image-ratio-preset 工单 01：ImageLayer 长边 200 定短边，自由 = 工厂
-     *   200×150 现状；忽略 shift——无位移可供等比约束；其余层型保持工厂缺省）。
+     *   ALT_DRAG_DEAD_ZONE_SCREEN_PX 同门）：左上角对准点击点；尺寸按会话预设档
+     *   派生缺省盒（ImageLayer 长边 200 定短边，自由/无载荷 = 工厂 200×150 现状；
+     *   忽略 shift——无位移可供等比约束；其余层型保持工厂缺省）。
      * 落库后自动选中新层并解除武装；返回新层路径（绑定层消费：文本层据此自动
      * 进文本编辑，spec 决策 6）。无会话/无文档空转返回 null。点击兜底不产生
      * 零尺寸层（缺省形态自带可见尺寸）。
      *
+     * 预设档一次性消费（canvas-web-preset-submenu 工单 01，ADR 0021）：文本档
+     * 字号直接生效（不经新层样式槽——字体/行高等槽外字段仍按槽，普通武装语义
+     * 保留）；图片档比供死区缺省盒派生。档位随会话捕获，落库后武装与载荷双清
+     * （一次性语义，取消路零残留）。
+     *
      * 模板表风味（template-table-drag-create 工单 01）：会话载荷 templateRowsPath
      * 非空即分派 createTemplateTable 工厂（死区外 shape = 手势正规化矩形，死区内
      * 缺省壳 400×120、左上角对准点击点）；模板层不自动进文本编辑（文本层专属）。
      */
     endCreate(): LayerPath | null;
     /**
-     * 取消画拉（Esc 语义）：清橡皮筋会话、命中轴回显与武装态——零文档写入、
-     * 零历史步（拖拽期纯视觉因此取消零回退成本，spec 决策 4）。幂等：无会话时
-     * 仅解除武装（待命态 Esc 同走此口）。
+     * 取消画拉（Esc 语义）：清橡皮筋会话、命中轴回显与武装态（含模板表风味与
+     * 预设载荷）——零文档写入、零历史步（拖拽期纯视觉因此取消零回退成本，spec
+     * 决策 4）。幂等：无会话时仅解除武装（待命态 Esc 同走此口）。
      */
     cancelCreate(): void;
     /**
@@ -1869,16 +1893,18 @@ declare class EditorSession {
     /**
      * 只读偏好（保存 prefs 的读取口）：与 store.ui 同源，给宿主一个不用下钻
      * store 的口。读 = getEditorPrefs，写 = applyEditorPrefs，对称成对；帧切片
-     * 走 restoreEditorState，两不相混。
+     * 走 restoreEditorState，两不相混。建层比例（nextLayerRatio）已退役不在此
+     * 带出（canvas-web-preset-submenu 工单 01，ADR 0021——预设随武装载荷一次性
+     * 携带，prefs 停写）。
      */
     getEditorPrefs(): EditorPrefsState;
     /**
      * 应用偏好（会话建立时一次性，跨会话恢复 prefs 的写入口）：整体替换
      * rulersVisible/anchorExpanded，不进历史；值等写入经 store 短路零通知。
      * 新层样式（text-defaults 工单 01）走宽容读逐字段合并（pickNextTextStylePatch
-     * 共享谓词——与捕获同门，缺字/类型不符保留现值）；建层比例（image-ratio-preset
-     * 工单 01）走宽容读枚举收口（pickNextLayerRatio——非六档枚举值/旧快照缺字段
-     * 回落 'free'）。
+     * 共享谓词——与捕获同门，缺字/类型不符保留现值）。旧快照的 nextLayerRatio
+     * 遗留键宽容忽略（canvas-web-preset-submenu 工单 01：槽退役停读，载荷上多余
+     * 的键无害；schemaVersion 加法演进）。
      */
     applyEditorPrefs(prefs: EditorPrefsState): void;
     /**
@@ -3175,4 +3201,4 @@ declare function memoizeTextPolicies(policies?: TextLayoutPolicies, options?: Me
  */
 declare const PACKAGE_NAME: "@hankchen/canvas-editor";
 
-export { ALIGN_CORNER_MARGIN_PX, ALT_DRAG_DEAD_ZONE_SCREEN_PX, ARM_CREATE_LAYER_TYPES, type AlignBoxGeometry, type AlignToCanvasMode, type AlignToCanvasOptions, type ArmCreateShortcutAction, CREATE_DEAD_ZONE_SCREEN_PX, type CanvasEditorState, type CreateGesture, type CreateRectResult, DATE_FORMAT_SUGGESTIONS, DEFAULT_EDITOR_SHORTCUTS, DEFAULT_ZOOM_BOUNDS, type DeletedLayerRef, type DocRecipe, type DragGesture, EDITOR_STATE_SCHEMA_VERSION, EXPRESSION_FUNCTIONS, type EditorChange, type EditorPrefsState, EditorSession, type EditorSessionOptions, type EditorShortcutAction, type EditorShortcutBinding, type EditorShortcutGroup, type EditorShortcutInput, EditorStore, type EditorUi, type ExpressionCallArg, type ExpressionCallErrorKind, type ExpressionCallParse, type ExpressionCallSlotContext, type ExpressionCandidate, type ExpressionCandidateQuery, type ExpressionCandidateResult, type ExpressionContextKind, type ExpressionErrorRange, type ExpressionFormatSuggestion, type ExpressionFragmentDiagnostic, type ExpressionFragmentErrorKind, type ExpressionFunctionMeta, type ExpressionPathHead, type ExpressionPathParse, type ExpressionScan, type ExpressionScanFragment, type ExpressionScanLiteral, type ExpressionScanOpen, type ExpressionScanPart, type ExpressionSchemaChildEntry, type ExpressionSchemaChildView, type ExpressionSchemaDiagnostic, type ExpressionSchemaDiagnosticCode, type ExpressionSchemaNode, type ExpressionSchemaParse, type ExpressionSchemaRejectReason, type ExpressionSyntaxError, type FindSession, type FindTextHit, FontCatalog, type FontCatalogEntry, type FrameScheduler, type Guide, type GuideOrientation, type HistoryStep, type HitTestOptions, type InvalidateTarget, type LayerOutlineNode, type LayerOutlineRole, type LayerPath, MAX_HISTORY_STEPS, type MemoTextPoliciesOptions, type MovedSubtreeRef, NUMBER_FUNCTION_SUGGESTIONS, type NextTextStyle, type OverlayPaintArgs, type OverlayPainter, PACKAGE_NAME, PAN_TO_BOX_MARGIN_PX, PASTE_OFFSET_PX, PHP_TRIM_CHARS, type Point, type ProportionalDrivingAxis, RATIO_PRESETS, RESIZE_HANDLES, RESIZE_HANDLE_HIT_PX, RESIZE_MIN_SIZE_PX, type RatioPreset, type RatioPresetId, type Rect, type ResizeAxes, type ResizeBoxGeometry, type ResizeBoxResult, type ResizeHandle, type ResourceStatus, type ResourceStatusMap, type RowsPathCandidate, type RowsPathCandidateResult, SNAP_THRESHOLD_SCREEN_PX, STYLE_FIELD_KEYS_BY_TYPE, type ShortcutCombo, type Size, type SnapAxis, type SnapAxisSource, type SnapBoxGeometry, type SnapPoints, type SnapResolution, type StyleSnapshot, TEXT_PRESETS, type TextEditLayout, type TextEditingSession, type TextPresetId, type TransactOptions, type UploadFile, type UploadHandler, UploadHandlerMissingError, type UploadImagePlacement, type Viewport, WHEEL_ZOOM_STEP, type WheelInput, type WheelIntent, type ZoomBounds, addRootLayerInDraft, addTableCellInDraft, addTableRowInDraft, addTemplateCellInDraft, alignToCanvasTarget, applyStyleFieldsInDraft, buildLayerOutline, canCopyLayerAt, canonicalizeTableSyncInDraft, captureStyleSnapshot, clampZoom, classifyEditorShortcut, classifyWheel, cloneLayerSubtree, convertTableToRowsInDraft, convertTableToTemplateInDraft, createDefaultLayer, createRubberBandRect, createTemplateTable, defaultNextLayerRatio, defaultNextTextStyle, defaultSizeForRatio, deleteLayerInDraft, enumerateExpressionCandidates, enumerateRowsPathCandidates, expressionCallSlotAtEnd, expressionDiagnostics, expressionFragmentAtCursor, fitRect, fitViewport, growRowToCellInDraft, handleResizesHeight, handleResizesWidth, hitTest, insertRootLayerAdjacentInDraft, insertRootLayerInDraft, isCallFragment, isImageContentUndrawn, isLayerPath, isLockedPath, isRootLayerPath, isRootPasteableType, isTemplateSubtreePath, layerBoxByPath, memoizeTextPolicies, moveGuard, moveRootLayerInDraft, moveTableCellInDraft, moveTableCellToRowInDraft, moveTableRowInDraft, moveTableRowToTableInDraft, nextZoomByWheel, normalizeExpressionSchemaSource, panBy, panToBox, parseExpressionCall, parseExpressionPath, parseExpressionSchema, pastePosition, pathStartsWith, pathsEqual, phpTrim, pickNextLayerRatio, pickNextTextStylePatch, prepareRootPaste, proportionalDrivingAxis, ratioValue, readSpecField, remapPathAfterSplice, replaceHitsInDraft, resizableAxesAt, resizeBox, resizeBoxProportional, resizeHandleAt, resizeHandlePoint, resizeHandlesAt, resizeProportionalSnapPoints, resizeSnapPoints, resolveLayer, resolveRowSchema, resolveRowsPathStartSchema, resolveSnap, resolveSnapPoints, resourcePathDiagnostics, rootLayerOf, scanExpressionFragments, scanTextMatches, sceneToScreen, schemaChildEntries, schemaNodeAtPath, screenToScene, selectionParentPath, setCellAutoHeightInDraft, snapAxesFromBoxes, snapThresholdScene, snapViewportToPhysicalPixels, syncContentIntoCellInDraft, syncRowWidthInDraft, uploadDisplayName, visibleRootBoxes, writeSpecField, zoomAtPoint };
+export { ALIGN_CORNER_MARGIN_PX, ALT_DRAG_DEAD_ZONE_SCREEN_PX, ARM_CREATE_LAYER_TYPES, type AlignBoxGeometry, type AlignToCanvasMode, type AlignToCanvasOptions, type ArmCreateShortcutAction, CREATE_DEAD_ZONE_SCREEN_PX, type CanvasEditorState, type CreateGesture, type CreateRectResult, DATE_FORMAT_SUGGESTIONS, DEFAULT_EDITOR_SHORTCUTS, DEFAULT_ZOOM_BOUNDS, type DeletedLayerRef, type DocRecipe, type DragGesture, EDITOR_STATE_SCHEMA_VERSION, EXPRESSION_FUNCTIONS, type EditorChange, type EditorPrefsState, EditorSession, type EditorSessionOptions, type EditorShortcutAction, type EditorShortcutBinding, type EditorShortcutGroup, type EditorShortcutInput, EditorStore, type EditorUi, type ExpressionCallArg, type ExpressionCallErrorKind, type ExpressionCallParse, type ExpressionCallSlotContext, type ExpressionCandidate, type ExpressionCandidateQuery, type ExpressionCandidateResult, type ExpressionContextKind, type ExpressionErrorRange, type ExpressionFormatSuggestion, type ExpressionFragmentDiagnostic, type ExpressionFragmentErrorKind, type ExpressionFunctionMeta, type ExpressionPathHead, type ExpressionPathParse, type ExpressionScan, type ExpressionScanFragment, type ExpressionScanLiteral, type ExpressionScanOpen, type ExpressionScanPart, type ExpressionSchemaChildEntry, type ExpressionSchemaChildView, type ExpressionSchemaDiagnostic, type ExpressionSchemaDiagnosticCode, type ExpressionSchemaNode, type ExpressionSchemaParse, type ExpressionSchemaRejectReason, type ExpressionSyntaxError, type FindSession, type FindTextHit, FontCatalog, type FontCatalogEntry, type FrameScheduler, type Guide, type GuideOrientation, type HistoryStep, type HitTestOptions, type InvalidateTarget, type LayerOutlineNode, type LayerOutlineRole, type LayerPath, MAX_HISTORY_STEPS, type MemoTextPoliciesOptions, type MovedSubtreeRef, NUMBER_FUNCTION_SUGGESTIONS, type NextTextStyle, type OverlayPaintArgs, type OverlayPainter, PACKAGE_NAME, PAN_TO_BOX_MARGIN_PX, PASTE_OFFSET_PX, PHP_TRIM_CHARS, type Point, type ProportionalDrivingAxis, RATIO_PRESETS, RESIZE_HANDLES, RESIZE_HANDLE_HIT_PX, RESIZE_MIN_SIZE_PX, type RatioPreset, type RatioPresetId, type Rect, type ResizeAxes, type ResizeBoxGeometry, type ResizeBoxResult, type ResizeHandle, type ResourceStatus, type ResourceStatusMap, type RowsPathCandidate, type RowsPathCandidateResult, SNAP_THRESHOLD_SCREEN_PX, STYLE_FIELD_KEYS_BY_TYPE, type ShortcutCombo, type Size, type SnapAxis, type SnapAxisSource, type SnapBoxGeometry, type SnapPoints, type SnapResolution, type StyleSnapshot, TEXT_PRESETS, type TextEditLayout, type TextEditingSession, type TextPreset, type TextPresetId, type TransactOptions, type UploadFile, type UploadHandler, UploadHandlerMissingError, type UploadImagePlacement, type Viewport, WHEEL_ZOOM_STEP, type WheelInput, type WheelIntent, type ZoomBounds, addRootLayerInDraft, addTableCellInDraft, addTableRowInDraft, addTemplateCellInDraft, alignToCanvasTarget, applyStyleFieldsInDraft, buildLayerOutline, canCopyLayerAt, canonicalizeTableSyncInDraft, captureStyleSnapshot, clampZoom, classifyEditorShortcut, classifyWheel, cloneLayerSubtree, convertTableToRowsInDraft, convertTableToTemplateInDraft, createDefaultLayer, createRubberBandRect, createTemplateTable, defaultNextTextStyle, defaultSizeForRatio, deleteLayerInDraft, enumerateExpressionCandidates, enumerateRowsPathCandidates, expressionCallSlotAtEnd, expressionDiagnostics, expressionFragmentAtCursor, findPresetEntry, fitRect, fitViewport, growRowToCellInDraft, handleResizesHeight, handleResizesWidth, hitTest, insertRootLayerAdjacentInDraft, insertRootLayerInDraft, isCallFragment, isImageContentUndrawn, isLayerPath, isLockedPath, isRootLayerPath, isRootPasteableType, isTemplateSubtreePath, layerBoxByPath, memoizeTextPolicies, moveGuard, moveRootLayerInDraft, moveTableCellInDraft, moveTableCellToRowInDraft, moveTableRowInDraft, moveTableRowToTableInDraft, nextZoomByWheel, normalizeExpressionSchemaSource, panBy, panToBox, parseExpressionCall, parseExpressionPath, parseExpressionSchema, pastePosition, pathStartsWith, pathsEqual, phpTrim, pickNextTextStylePatch, prepareRootPaste, proportionalDrivingAxis, ratioValue, readSpecField, remapPathAfterSplice, replaceHitsInDraft, resizableAxesAt, resizeBox, resizeBoxProportional, resizeHandleAt, resizeHandlePoint, resizeHandlesAt, resizeProportionalSnapPoints, resizeSnapPoints, resolveLayer, resolveRowSchema, resolveRowsPathStartSchema, resolveSnap, resolveSnapPoints, resourcePathDiagnostics, rootLayerOf, scanExpressionFragments, scanTextMatches, sceneToScreen, schemaChildEntries, schemaNodeAtPath, screenToScene, selectionParentPath, setCellAutoHeightInDraft, snapAxesFromBoxes, snapThresholdScene, snapViewportToPhysicalPixels, syncContentIntoCellInDraft, syncRowWidthInDraft, uploadDisplayName, visibleRootBoxes, writeSpecField, zoomAtPoint };

package/dist/index.js

@@ -1226,15 +1226,14 @@ var RATIO_PRESETS = [
   { id: "16:9", ratio: { w: 16, h: 9 } },
   { id: "9:16", ratio: { w: 9, h: 16 } }
 ];
-function defaultNextLayerRatio() {
-  return "free";
-}
 function ratioValue(id) {
   const entry = RATIO_PRESETS.find((candidate) => candidate.id === id);
   return entry?.ratio ? { ...entry.ratio } : null;
 }
-function pickNextLayerRatio(raw) {
-  return RATIO_PRESETS.some((candidate) => candidate.id === raw) ? raw : "free";
+function findPresetEntry(type, presetId) {
+  if (type === "TextLayer") return TEXT_PRESETS.find((candidate) => candidate.id === presetId);
+  if (type === "ImageLayer") return RATIO_PRESETS.find((candidate) => candidate.id === presetId);
+  return void 0;
 }
 function defaultSizeForRatio(ratio) {
   return ratio.w >= ratio.h ? { width: 200, height: Math.round(200 * ratio.h / ratio.w) } : { width: Math.round(200 * ratio.w / ratio.h), height: 200 };
@@ -1742,12 +1741,12 @@ var EditorStore = class {
     resize: null,
     armedCreate: null,
     armedCreateRowsPath: "",
+    armedCreatePreset: "",
     create: null,
     editing: null,
     renaming: null,
     anchorExpanded: false,
     nextTextStyle: defaultNextTextStyle(),
-    nextLayerRatio: defaultNextLayerRatio(),
     dataSourceSchema: null,
     guides: [],
     rulersVisible: true,
@@ -1779,7 +1778,7 @@ var EditorStore = class {
   }
   /** 打开/替换文档：ui 选择/编辑/重命名会话与双向历史一并重置（新文档不继承旧路径/旧事务）；
    *  参考线/锁定集合/查找会话/建层武装与画拉会话随当次会话清空（对位轴/文档内容防护/
-   *  查询词/待命层型不跨文档），标尺显隐/锚点折叠/新层样式/建层比例作为偏好保留 */
+   *  查询词/待命层型不跨文档），标尺显隐/锚点折叠/新层样式作为偏好保留 */
   openDocument(canvas) {
     this.docValue = canvas;
     this.undoSteps = [];
@@ -1792,6 +1791,7 @@ var EditorStore = class {
       resize: null,
       armedCreate: null,
       armedCreateRowsPath: "",
+      armedCreatePreset: "",
       create: null,
       editing: null,
       renaming: null,
@@ -1891,12 +1891,20 @@ var EditorStore = class {
   /**
    * 建层武装置/解除（null，drag-create 工单 01）；标量值等短路（重复武装同型
    * 不通知）。rowsPath（template-table-drag-create 工单 01）：模板表风味载荷
-   * 与层型一体写——同层型同载荷才短路（重复武装同型换载荷要更新），解除
-   * （null）一律清载荷。
+   * 与层型一体写；preset（canvas-web-preset-submenu 工单 01）：预设载荷与层型
+   * 一体写——同层型同载荷才短路（重复武装同型换载荷要更新），解除（null）
+   * 一律清载荷（rowsPath 与 preset 双清）。
    */
-  setArmedCreate(type, rowsPath = "") {
-    if (this.uiValue.armedCreate === type && this.uiValue.armedCreateRowsPath === rowsPath) return;
-    this.uiValue = { ...this.uiValue, armedCreate: type, armedCreateRowsPath: type === null ? "" : rowsPath };
+  setArmedCreate(type, rowsPath = "", preset = "") {
+    if (this.uiValue.armedCreate === type && this.uiValue.armedCreateRowsPath === rowsPath && this.uiValue.armedCreatePreset === preset) {
+      return;
+    }
+    this.uiValue = {
+      ...this.uiValue,
+      armedCreate: type,
+      armedCreateRowsPath: type === null ? "" : rowsPath,
+      armedCreatePreset: type === null ? "" : preset
+    };
     this.notify({ scope: "ui", branch: "armedCreate" });
   }
   /** 画拉橡皮筋会话开始/更新/结束（null）；会话对象住 ui 分支，落库在 endCreate 单事务 */
@@ -1920,8 +1928,9 @@ var EditorStore = class {
     this.notify({ scope: "ui", branch: "anchorExpanded" });
   }
   /**
-   * 新层样式槽逐字段合并（text-defaults 工单 01：捕获/预设/prefs 恢复的统一
-   * 写入口）：patch 并入现值，五字段值等短路（重复写同值零通知），不进历史。
+   * 新层样式槽逐字段合并（text-defaults 工单 01：捕获/prefs 恢复的统一写入口；
+   * canvas-web-preset-submenu 工单 01 起预设不再写槽）：patch 并入现值，五字段
+   * 值等短路（重复写同值零通知），不进历史。
    */
   setNextTextStyle(patch) {
     const next = { ...this.uiValue.nextTextStyle, ...patch };
@@ -1929,15 +1938,6 @@ var EditorStore = class {
     this.uiValue = { ...this.uiValue, nextTextStyle: next };
     this.notify({ scope: "ui", branch: "nextTextStyle" });
   }
-  /**
-   * 建层比例槽写入（image-ratio-preset 工单 01：比例预设应用 / prefs 恢复的
-   * 统一写入口）：值等短路（重复写同档零通知），仅 ui 通知、不进历史。
-   */
-  setNextLayerRatio(id) {
-    if (this.uiValue.nextLayerRatio === id) return;
-    this.uiValue = { ...this.uiValue, nextLayerRatio: id };
-    this.notify({ scope: "ui", branch: "nextLayerRatio" });
-  }
   /**
    * 数据源 schema 声明替换（归一产物或降级 null，校验收口在注入缝不在这里）：
    * 同引用短路（重复注入同一归一产物不惊动订阅方）；仅 ui 通知，不参与重绘
@@ -2912,29 +2912,23 @@ var EditorSession = class {
   /**
    * 武装建层（面板新增项/层型快捷键的统一入口，CONTEXT「武装」词条）：置 ui
    * 分支待命层型，下一次画布按下即开画拉；建层提交或 Esc 即解除——一次性
-   * 待命态，无粘性工具（spec 决策 2）。重复武装同型值等短路零通知。
+   * 待命态，无粘性工具（spec 决策 2）。重复武装同型同载荷值等短路零通知。
    *
-   * preset（text-defaults 工单 01 + image-ratio-preset 工单 01）：层型相关预设 =
-   * 写槽的快捷方式——命中档位先把档位值并入对应偏好槽再武装；未知 id = 跳过
-   * 写槽、武装照常（评审口径统一：「空转」只指写槽，武装层型本身仍合法）。
-   * - TextLayer + 文本预设档：写新层样式槽（v1 只 fontSize）；
-   * - ImageLayer + 比例预设档：写建层比例槽（'free' 即显式重置档）；QR 恒方
-   *   是层型硬钳、无比例槽（spec 豁免面）；
-   * - 交叉类型（文本层带比例档/图片层带文本档）各在对方清单查无此档、天然
-   *   跳写槽。
+   * preset（canvas-web-preset-submenu 工单 01，ADR 0021）：层型相关预设随武装
+   * 载荷一次性携带、**不再写任何偏好槽**——命中档位把档位 id 写进
+   * ui.armedCreatePreset（endCreate 落库一次性消费，取消路零残留）；未知 id =
+   * 不落载荷、武装照常（评审口径统一：「空转」只指载荷，武装层型本身仍合法）。
+   * - TextLayer + 文本预设档：载荷命中 TEXT_PRESETS（endCreate 档位字号直接
+   *   生效，不经新层样式槽——普通武装文本按槽的语义不受染指）；
+   * - ImageLayer + 比例预设档：载荷命中 RATIO_PRESETS（'free' 档载荷行为等价
+   *   自由；QR 恒方是层型硬钳、无比例语义，spec 豁免面）；
+   * - 交叉类型（文本层带比例档/图片层带文本档）各在对方清单查无此档、不落载荷。
    */
   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 });
-    }
-    if (preset !== void 0 && type === "ImageLayer") {
-      const entry = RATIO_PRESETS.find((candidate) => candidate.id === preset);
-      if (entry) this.store.setNextLayerRatio(entry.id);
-    }
-    this.store.setArmedCreate(type);
+    const entry = preset === void 0 ? void 0 : findPresetEntry(type, preset);
+    this.store.setArmedCreate(type, "", entry !== void 0 ? entry.id : "");
   }
-  /** 解除建层武装（取消入口）：仅清待命态（含模板表风味载荷），零副作用。 */
+  /** 解除建层武装（取消入口）：仅清待命态（含模板表风味与预设载荷），零副作用。 */
   cancelArmLayerCreate() {
     this.store.setArmedCreate(null);
   }
@@ -2963,9 +2957,11 @@ var EditorSession = class {
     if (!this.store.doc) return false;
     const point = { x: sceneX, y: sceneY };
     const templateRowsPath = armed === "TableLayer" && this.store.ui.armedCreateRowsPath !== "" ? this.store.ui.armedCreateRowsPath : void 0;
+    const preset = (armed === "TextLayer" || armed === "ImageLayer") && this.store.ui.armedCreatePreset !== "" ? this.store.ui.armedCreatePreset : void 0;
     this.store.setCreate({
       type: armed,
       templateRowsPath,
+      preset,
       startScene: point,
       currentScene: point,
       rect: { x: sceneX, y: sceneY, width: 0, height: 0 }
@@ -2981,17 +2977,19 @@ var EditorSession = class {
    * 全部可见根层供轴，copyMode 首移同门）。零文档事务：修正只进会话几何，
    * 落库在 endCreate。
    *
-   * 建层比例槽（image-ratio-preset 工单 01，spec 决策 3/4）：仅 ImageLayer 按槽
-   * 钳制（QR 层不传 ratio、恒方语义不动，两钳互斥；其余层型无槽）；Shift 瞬时
-   * 反转槽态——槽非自由按 Shift = 临时自由、槽自由按 Shift = 临时钳 1:1，按住
-   * 生效松开还原（逐帧求位、不写槽、不改武装态，Figma 惯例的手势瞬时语义）。
+   * 建层预设档（canvas-web-preset-submenu 工单 01，ADR 0021，取代建层比例槽）：
+   * 仅 ImageLayer 按会话载荷档钳制（QR 层不传 ratio、恒方语义不动，两钳互斥；
+   * 其余层型无比例语义）；无载荷或 free 档 = 自由钳（普通武装恒自由）。
+   * Shift 瞬时反转源 = 生效档（载荷档或自由）：档具名按 Shift = 临时自由、
+   * 生效档自由（含无载荷）按 Shift = 临时钳 1:1，按住生效松开还原（逐帧求位、
+   * 不写载荷不改武装态，Figma 惯例的手势瞬时语义）。
    */
   createTo(sceneX, sceneY, shift = false) {
     const gesture = this.store.ui.create;
     const doc = this.store.doc;
     if (!gesture || !doc) return;
-    const slotRatio = gesture.type === "ImageLayer" ? ratioValue(this.store.ui.nextLayerRatio) : null;
-    const ratio = gesture.type === "ImageLayer" ? shift ? slotRatio === null ? { w: 1, h: 1 } : null : slotRatio : null;
+    const presetRatio = gesture.type === "ImageLayer" && gesture.preset !== void 0 ? ratioValue(gesture.preset) : null;
+    const ratio = gesture.type === "ImageLayer" ? shift ? presetRatio === null ? { w: 1, h: 1 } : null : presetRatio : null;
     const resolution = createRubberBandRect(
       gesture.type,
       gesture.startScene,
@@ -3013,15 +3011,20 @@ var EditorSession = class {
    * - 死区外：单事务写入「createDefaultLayer 缺省形态 + position 左上角对准
    *   橡皮筋矩形（含吸附修正）+ shape.width/height」并 insertRootLayerInDraft
    *   置顶（priority min−1、push 数组尾）——尺寸取手势末态钳制结果（含 Shift
-   *   反转末态，image-ratio-preset 工单 01 spec 决策 4）；
+   *   反转末态，钳制源 = 会话预设档，canvas-web-preset-submenu 工单 01）；
    * - 死区内（点击兜底，位移按 CREATE_DEAD_ZONE_SCREEN_PX 屏幕 px 随 zoom 折算，
-   *   ALT_DRAG_DEAD_ZONE_SCREEN_PX 同门）：左上角对准点击点；尺寸按槽派生缺省
-   *   盒（image-ratio-preset 工单 01：ImageLayer 长边 200 定短边，自由 = 工厂
-   *   200×150 现状；忽略 shift——无位移可供等比约束；其余层型保持工厂缺省）。
+   *   ALT_DRAG_DEAD_ZONE_SCREEN_PX 同门）：左上角对准点击点；尺寸按会话预设档
+   *   派生缺省盒（ImageLayer 长边 200 定短边，自由/无载荷 = 工厂 200×150 现状；
+   *   忽略 shift——无位移可供等比约束；其余层型保持工厂缺省）。
    * 落库后自动选中新层并解除武装；返回新层路径（绑定层消费：文本层据此自动
    * 进文本编辑，spec 决策 6）。无会话/无文档空转返回 null。点击兜底不产生
    * 零尺寸层（缺省形态自带可见尺寸）。
    *
+   * 预设档一次性消费（canvas-web-preset-submenu 工单 01，ADR 0021）：文本档
+   * 字号直接生效（不经新层样式槽——字体/行高等槽外字段仍按槽，普通武装语义
+   * 保留）；图片档比供死区缺省盒派生。档位随会话捕获，落库后武装与载荷双清
+   * （一次性语义，取消路零残留）。
+   *
    * 模板表风味（template-table-drag-create 工单 01）：会话载荷 templateRowsPath
    * 非空即分派 createTemplateTable 工厂（死区外 shape = 手势正规化矩形，死区内
    * 缺省壳 400×120、左上角对准点击点）；模板层不自动进文本编辑（文本层专属）。
@@ -3039,21 +3042,21 @@ var EditorSession = class {
     const clicked = Math.hypot(dx, dy) <= deadZoneScene;
     const index = { v: -1 };
     const templateRowsPath = gesture.templateRowsPath;
+    const presetTextEntry = gesture.type === "TextLayer" && gesture.preset !== void 0 ? findPresetEntry(gesture.type, gesture.preset) : void 0;
+    const textDefaults = presetTextEntry ? { ...this.store.ui.nextTextStyle, fontSize: presetTextEntry.fontSize } : this.store.ui.nextTextStyle;
+    const presetRatio = gesture.type === "ImageLayer" && gesture.preset !== void 0 ? ratioValue(gesture.preset) : null;
     this.store.transact((draft) => {
       const layer = templateRowsPath !== void 0 ? createTemplateTable(
         clicked ? { rowsPath: templateRowsPath } : {
           rowsPath: templateRowsPath,
           shape: { width: gesture.rect.width, height: gesture.rect.height }
         }
-      ) : createDefaultLayer(gesture.type, this.store.ui.nextTextStyle);
+      ) : createDefaultLayer(gesture.type, textDefaults);
       if (clicked) {
-        if (gesture.type === "ImageLayer") {
-          const ratio = ratioValue(this.store.ui.nextLayerRatio);
-          if (ratio) {
-            const size = defaultSizeForRatio(ratio);
-            layer.shape.width = size.width;
-            layer.shape.height = size.height;
-          }
+        if (gesture.type === "ImageLayer" && presetRatio) {
+          const size = defaultSizeForRatio(presetRatio);
+          layer.shape.width = size.width;
+          layer.shape.height = size.height;
         }
         layer.position = { ...layer.position, x: gesture.startScene.x, y: gesture.startScene.y };
       } else {
@@ -3069,9 +3072,9 @@ var EditorSession = class {
     return path;
   }
   /**
-   * 取消画拉（Esc 语义）：清橡皮筋会话、命中轴回显与武装态——零文档写入、
-   * 零历史步（拖拽期纯视觉因此取消零回退成本，spec 决策 4）。幂等：无会话时
-   * 仅解除武装（待命态 Esc 同走此口）。
+   * 取消画拉（Esc 语义）：清橡皮筋会话、命中轴回显与武装态（含模板表风味与
+   * 预设载荷）——零文档写入、零历史步（拖拽期纯视觉因此取消零回退成本，spec
+   * 决策 4）。幂等：无会话时仅解除武装（待命态 Esc 同走此口）。
    */
   cancelCreate() {
     this.store.setCreate(null);
@@ -3235,30 +3238,30 @@ var EditorSession = class {
   /**
    * 只读偏好（保存 prefs 的读取口）：与 store.ui 同源，给宿主一个不用下钻
    * store 的口。读 = getEditorPrefs，写 = applyEditorPrefs，对称成对；帧切片
-   * 走 restoreEditorState，两不相混。
+   * 走 restoreEditorState，两不相混。建层比例（nextLayerRatio）已退役不在此
+   * 带出（canvas-web-preset-submenu 工单 01，ADR 0021——预设随武装载荷一次性
+   * 携带，prefs 停写）。
    */
   getEditorPrefs() {
     const ui = this.store.ui;
     return {
       rulersVisible: ui.rulersVisible,
       anchorExpanded: ui.anchorExpanded,
-      nextTextStyle: ui.nextTextStyle,
-      nextLayerRatio: ui.nextLayerRatio
+      nextTextStyle: ui.nextTextStyle
     };
   }
   /**
    * 应用偏好（会话建立时一次性，跨会话恢复 prefs 的写入口）：整体替换
    * rulersVisible/anchorExpanded，不进历史；值等写入经 store 短路零通知。
    * 新层样式（text-defaults 工单 01）走宽容读逐字段合并（pickNextTextStylePatch
-   * 共享谓词——与捕获同门，缺字/类型不符保留现值）；建层比例（image-ratio-preset
-   * 工单 01）走宽容读枚举收口（pickNextLayerRatio——非六档枚举值/旧快照缺字段
-   * 回落 'free'）。
+   * 共享谓词——与捕获同门，缺字/类型不符保留现值）。旧快照的 nextLayerRatio
+   * 遗留键宽容忽略（canvas-web-preset-submenu 工单 01：槽退役停读，载荷上多余
+   * 的键无害；schemaVersion 加法演进）。
    */
   applyEditorPrefs(prefs) {
     this.store.setRulersVisible(prefs.rulersVisible);
     this.store.setAnchorExpanded(prefs.anchorExpanded);
     this.store.setNextTextStyle(pickNextTextStylePatch(prefs.nextTextStyle));
-    this.store.setNextLayerRatio(pickNextLayerRatio(prefs.nextLayerRatio));
   }
   // ---- 对齐画布（layer-align-snap 工单 01）：图层盒整体对齐画布几何 ----
   /**
@@ -4921,7 +4924,6 @@ export {
   createDefaultLayer,
   createRubberBandRect,
   createTemplateTable,
-  defaultNextLayerRatio,
   defaultNextTextStyle,
   defaultSizeForRatio,
   deleteLayerInDraft,
@@ -4930,6 +4932,7 @@ export {
   expressionCallSlotAtEnd,
   expressionDiagnostics,
   expressionFragmentAtCursor,
+  findPresetEntry,
   fitRect,
   fitViewport,
   growRowToCellInDraft,
@@ -4964,7 +4967,6 @@ export {
   pathStartsWith,
   pathsEqual,
   phpTrim2 as phpTrim,
-  pickNextLayerRatio,
   pickNextTextStylePatch,
   prepareRootPaste,
   proportionalDrivingAxis,