@hankchen/canvas-editor 0.4.0 → 0.6.0

package/dist/index.d.ts

@@ -295,6 +295,31 @@ declare function resizeBox(start: ResizeBoxGeometry, handle: ResizeHandle, dx: n
  * 缩放期跟随动缘即可）。
  */
 declare function resizeSnapPoints(start: ResizeBoxGeometry, handle: ResizeHandle, dx: number, dy: number): SnapPoints;
+/** 等比缩放的驱动轴（image-ratio-preset 工单 01）：角柄取位移较大轴（|Δx| ≥
+ *  |Δy| 宽驱动，画拉比例钳同门）、边中柄恒取被拖轴。几何求位与吸附位点消费
+ *  同一判定（resizeBoxProportional 与 resizeProportionalSnapPoints 共读）。 */
+type ProportionalDrivingAxis = 'width' | 'height';
+declare function proportionalDrivingAxis(handle: ResizeHandle, dx: number, dy: number): ProportionalDrivingAxis;
+/**
+ * Shift 等比缩放求位（image-ratio-preset 工单 01，spec 决策 5）：参照 reference
+ * （手势起始盒的声明宽高比）保持宽高比——驱动维随指针（对缘/对角固定语义与
+ * resizeBox 同款），钳到 minSize 后派生维随动 = round(驱动维 × 短比)（Math.round
+ * 对正数 half-up）；派生维同样钳 minSize（极扁/极窄盒派生维可 round 到 0，不钳
+ * 会产出零尺寸不可见层）。仅接受双轴皆可写的柄（beginResize 的角色过滤已保证，
+ * 派生轴写不出去的面不该进等比模式）。driving 由调用方经 proportionalDrivingAxis
+ * 判定一次传入——与吸附位点（resizeProportionalSnapPoints）消费同一判定，吸附
+ * 修正并入位移后驱动轴不随修正值翻转（单一事实源）。
+ */
+declare function resizeBoxProportional(start: ResizeBoxGeometry, handle: ResizeHandle, reference: {
+    w: number;
+    h: number;
+}, driving: ProportionalDrivingAxis, dx: number, dy: number, minSize?: number): ResizeBoxResult;
+/**
+ * 等比缩放的吸附位点：只收驱动轴的移动缘——派生维是算术产物，不独立吸附
+ * （钳先于吸附同门：吸附修正施加在驱动轴位移上，进 resizeBoxProportional 后
+ * 派生维按比例跟随，吸附不破比例）。
+ */
+declare function resizeProportionalSnapPoints(start: ResizeBoxGeometry, handle: ResizeHandle, driving: ProportionalDrivingAxis, dx: number, dy: number): SnapPoints;
 /** 可缩放轴（width = 横向宽字段可写、height = 纵向高字段可写） */
 interface ResizeAxes {
     readonly width: boolean;
@@ -491,6 +516,46 @@ declare const TEXT_PRESETS: readonly {
 }[];
 /** 新层样式槽初值：自工厂 TextLayer 形态派生（工厂缺省是单一事实源，槽跟着走） */
 declare function defaultNextTextStyle(): NextTextStyle;
+/**
+ * 建层比例档位（spec 决策 1/2）：'free' = 自由钳（工厂行为兜底），其余五个具名
+ * 有理数比。v1 固定清单、无自定义输入。
+ */
+type RatioPresetId = 'free' | '1:1' | '4:3' | '3:4' | '16:9' | '9:16';
+/** 比例预设档位：具名 id + 有理数宽高比（free 档 ratio = null，即不钳） */
+interface RatioPreset {
+    readonly id: RatioPresetId;
+    readonly ratio: Readonly<{
+        w: number;
+        h: number;
+    }> | null;
+}
+/** 比例预设常量六档（顺序即面板平铺序：自由在前，其余按惯例短比在前） */
+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 键由调用方整体忽略（不进本函数视野）。
+ */
+declare function pickNextLayerRatio(raw: unknown): RatioPresetId;
+/**
+ * 死区点击缺省盒的比例派生（spec 决策 3）：长边 200 定短边——短边 = round(长边
+ * × 短比)（Math.round 对正数 half-up：16:9 → 200×113）。自由档不进本函数
+ * （调用方以 ratioValue 为 null 分流到工厂缺省 200×150）。
+ */
+declare function defaultSizeForRatio(ratio: {
+    w: number;
+    h: number;
+}): {
+    width: number;
+    height: number;
+};
 /**
  * 新层样式字段的宽容读逐字段收口（text-defaults 工单 01；评审合流——捕获与
  * prefs 恢复共用同一谓词，不再双写）：合法字段进合并集，缺字/类型不符忽略
@@ -514,10 +579,16 @@ declare function createDefaultLayer(type: LayerType, textDefaults?: Partial<Next
  * 高按解码归一为 0、宽 := 表宽关 autoWidth）+ 满宽 60 高缺省格带缺省文本内容
  * （内容宽度同步、零高度耦合，ADR 0006）。rowsPath 由调用方必填（解码
  * rows_path_missing 硬约束，创建表单校验前置）；缺省格 60 高保证空态预览行可见
- * 可点（合成高 = 最高格，03 票 E1 机制）。
+ * 可点（合成高 = 最高格，03 票 E1 机制）。shape（template-table-drag-create 工单
+ * 01）：画拉建层的手势矩形尺寸参数化——表壳宽高照落，行模板/格/内容宽 := 表宽
+ * 的既有耦合自然生效；缺省 400×120 不变。
  */
 declare function createTemplateTable(options: {
     rowsPath: string;
+    shape?: {
+        width: number;
+        height: number;
+    };
 }): TableLayer;
 /**
  * 「insert-before 原始序号 to」移动的公共守卫与落点折算：from/to 须为安全整数、
@@ -594,7 +665,7 @@ declare function deleteLayerInDraft(draft: Draft<Canvas>, path: LayerPath): Dele
  * D6 钉定：注入边界一次性转译为内部形状树（不在查询期惰性解析原始 schema，
  * 行业惯例见 schema-completion-research.md）。方言子集 = JSON Schema draft-07 的
  * 结构关键词（`properties` / `items` / `type`）+ 注解关键词（`description` /
- * `title` / `additionalProperties: true` / 白名单 `format`，见下）+ 引用关键词
+ * `title` / 白名单 `format`，见下）+ 引用关键词
  * （`$ref` 内部 JSON Pointer、`definitions`/`$defs` 命名池）；其余关键词
  * （`required`/`enum`/`const`/`allOf` 族/`patternProperties`/`$schema`/`$id` 及
  * 一切未识别键）宽松忽略，节点按已识别字段归一（可能变叶子）。
@@ -609,10 +680,14 @@ declare function deleteLayerInDraft(draft: Draft<Canvas>, path: LayerPath): Dele
  * 注解只影响建议面（date() 建议分桶），求值器/graph/wire 三端零感知。
  *
  * 降级分级（D7）：
- * - **整份拒绝**仅保留根级结构性问题（在原始文档上判定，拒绝面与 walker 时代
+ * - **整份拒绝**保留根级结构性问题（在原始文档上判定，拒绝面与 walker 时代
  *   全等）：根非对象 / 根缺 properties 层级（含根级 `$ref`——根不解引用）/
  *   `reserved_root_key`（根级键 `row` 或 `$` 前缀，前移填充期硬错误，对应
- *   `CanvasHydrator::assertReservedRootKeys`；仅根级保留，嵌套层同名键合法）。
+ *   `CanvasHydrator::assertReservedRootKeys`；仅根级保留，嵌套层同名键合法）+
+ *   开放映射契约废除（ADR 0020，resource-expression-single-ref 工单 04）：文档
+ *   任意层 `additionalProperties: true` 显式拒绝（`open_map_unsupported`，deref
+ *   前对原始文档扫描，$ref 目标与宽松忽略关键词容器内同不留活口）——错误信息
+ *   教学宿主：动态键由宿主组装成具体 properties 后注入。
  * - **局部故障**（`$ref` 断链 / 外部指针 / 环引用（活跃路径 seen-set 判定）/
  *   目标形态不符）→ 该节点降级为叶子（保留本地 type/description/title 注解）+
  *   diagnostics 逐条记录，树其余部分照常服务；注入期由
@@ -636,9 +711,9 @@ declare function deleteLayerInDraft(draft: Draft<Canvas>, path: LayerPath): Dele
  * （type 声明为 array 或声明了 items）收敛为叶子、不沿 items 链穿透：具名段下钻
  * 数组在求值器（InterpolationEvaluator::navigateValue）是静默空串（缺字段信号），
  * 补全不得怂恿写渲染为空白的表达式；类型徽标仍显示 array 本身，不特供「供表格
- * rowsPath 使用」文案（为表达式内置函数留前瞻口，spec D9）。open 节点
- * （additionalProperties: true）即随枚举结果携带 open 信号（D10，供工单 10 浮层
- * 占位提示；信号面与候选空否无关）。
+ * rowsPath 使用」文案（为表达式内置函数留前瞻口，spec D9）。开放映射信号面
+ * （D10）已随契约废除整体移除（ADR 0020，resource-expression-single-ref 工单
+ * 04）——schema 解析边界显式拒绝后，树内不存在动态键节点。
  *
  * 全模块零 DOM、零内部依赖（editor-shared-isolation）；除
  * normalizeExpressionSchemaSource 的 console 警告收口（注入期汇总一次）外均为纯函数。
@@ -650,8 +725,6 @@ interface ExpressionSchemaNode {
     /** 展示回落注解（D8）：浮层取 description ?? title */
     title?: string;
     description?: string;
-    /** 开放映射标记（D10）：`additionalProperties: true`；动态字段实际键由宿主合入 properties */
-    open?: boolean;
     /**
      * 日期标记注解（工单 11，D13）：`format: "date" | "date-time"` 白名单两值、
      * 仅 type 归一为 string 的节点挂；只影响 date() 建议分桶，永不触发诊断
@@ -665,8 +738,12 @@ interface ExpressionSchemaChildEntry {
     key: string;
     node: ExpressionSchemaNode;
 }
-/** 声明期拒绝原因：reserved_root_key = 前移的填充期硬错误；invalid_schema = 形态非法 */
-type ExpressionSchemaRejectReason = 'reserved_root_key' | 'invalid_schema';
+/**
+ * 声明期拒绝原因：reserved_root_key = 前移的填充期硬错误；invalid_schema = 形态
+ * 非法；open_map_unsupported = 开放映射契约废除（ADR 0020：additionalProperties:
+ * true 显式拒绝，动态键归宿主组装成具体 properties 后注入）
+ */
+type ExpressionSchemaRejectReason = 'reserved_root_key' | 'invalid_schema' | 'open_map_unsupported';
 /** 局部故障诊断码（D7 四类，全部 $ref 解析面；节点降叶子 + 树其余照常服务） */
 type ExpressionSchemaDiagnosticCode = 'broken_ref' | 'external_ref' | 'circular_ref' | 'target_shape_mismatch';
 /** 一条局部故障诊断：path = 降级节点在原始 schema 文档中的声明路径（JSON Pointer 风格） */
@@ -686,7 +763,8 @@ type ExpressionSchemaParse = {
 };
 /**
  * 声明期编译（D6 注入边界一次性转译）：合法 → 节点树 + diagnostics（局部故障
- * 逐条，可为空）；根级保留键 → reserved_root_key；根级结构非法 → invalid_schema。
+ * 逐条，可为空）；根级保留键 → reserved_root_key；根级结构非法 → invalid_schema；
+ * 开放映射（文档任意层 additionalProperties: true）→ open_map_unsupported。
  * 根级判定在原始文档上进行（根级 `$ref` 不解引用，拒绝面与 walker 时代全等）。
  */
 declare function parseExpressionSchema(raw: unknown): ExpressionSchemaParse;
@@ -703,14 +781,12 @@ declare function normalizeExpressionSchemaSource(raw: unknown): ExpressionSchema
  */
 declare function schemaNodeAtPath(node: ExpressionSchemaNode, segments: readonly string[]): ExpressionSchemaNode | null;
 /**
- * 一层子候选枚举结果（D9 候选视图的返回面）：候选条目 + open 信号。信号走结果
- * 面扩展，不污染候选条目契约（ExpressionSchemaChildEntry 不加字段）。
+ * 一层子候选枚举结果（D9 候选视图的返回面）。开放映射信号（D10）已随契约废除
+ * 移除（ADR 0020）——schema 解析边界显式拒绝后，视图只承载候选条目。
  */
 interface ExpressionSchemaChildView {
     /** 一层子候选（按声明序）；数组节点收敛为叶子 = 空（D9） */
     entries: readonly ExpressionSchemaChildEntry[];
-    /** 开放映射信号（D10）：节点标 open（additionalProperties: true）时为 true；非 open 恒缺省 */
-    open?: boolean;
 }
 /**
  * 一层子候选枚举（枚举层候选视图，D9 分叉点）：数组节点（type 声明为 array 或
@@ -718,7 +794,7 @@ interface ExpressionSchemaChildView {
  * （navigateValue 缺字段信号），补全不得怂恿写渲染为空白的表达式（spec §2 D9，
  * 2026-09-30 修订 D3）；声明自相矛盾（type array 而又带 properties/items）时从疑
  * 同样收敛，对齐 D7 疑点降叶哲学。其余节点取**自身** properties（按声明序），
- * 不沿 items 链穿透。open 信号（D10）随视图透出，供浮层占位提示（工单 10）。
+ * 不沿 items 链穿透。
  * 下钻层（schemaNodeAtPath/resolveRowSchema）机制不动，rowsPath/`row.*`/`$index`
  * 零影响（数组的数组穿透不回归）。
  */
@@ -812,6 +888,13 @@ interface ResizeGesture {
 interface CreateGesture {
     /** 本次画拉的层型（beginLayerCreate 时从 armedCreate 捕获，会话内定死） */
     type: LayerType;
+    /**
+     * 模板表风味的行路径载荷（canvas-web-template-table-drag-create 工单 01）：
+     * beginLayerCreate 时从 ui.armedCreateRowsPath 捕获（会话内定死），非空串 =
+     * 模板表风味（endCreate 分派 createTemplateTable）；undefined = 普通武装
+     * （G 快捷键 V1 空表语义原样）。
+     */
+    templateRowsPath?: string;
     /** 起点场景坐标（两点正规化与死区判定基准） */
     startScene: Point;
     /** 当前指针场景坐标 */
@@ -824,16 +907,26 @@ interface CreateGesture {
  * textarea（非受控），提交经 commitTextEdit 一次性落文档——「每个拼音音节一个
  * undo」被会话缓冲天然避免（impl 研究 §2.4）。
  *
- * expression 是内容类型会话标志（canvas-web-expression-editing 工单 01，spec 决策
- * 2）：beginTextEdit 按进入瞬间 `layer.expression !== null` 锚定的会话快照（与
- * verticalAnchorY「进入时计、编辑中稳定」同门），裁决提交去向（表达式会话含合法
- * 片段走标记写，字面会话恒字面写）与补全 enabled。住 ui 分支不进历史；面板编辑
- * 中改动 layer.expression 不回写标志（打标是显式动作，快照是提交去向的裁决依据）；
- * 内容类型 pill 切换仅翻转本标志（零文档变更零历史步）。
+ * expression 是内容模式**活标志**（canvas-web-expression-editing 工单 01 锚定；
+ * canvas-web-edit-overlay-toolbar 工单 02 + ADR 0019 改造为活标志，取代旧「进入
+ * 时快照冻结」）：初值按进入瞬间 `layer.expression !== null` 取定，此后不再冻结
+ * ——画布 pill 切换与内核 toggleDataMode 在会话期被调用都只翻本标志（零文档变更
+ * 零历史步，防御性路由），旁门内容写（updateData/updateDataExpression 命中编辑层）
+ * **不**翻标志、走草稿接管。会话在场时内容模式显示以本标志为单一事实源（pill、
+ * 属性面板锁定段、textEditLayout.expressionMode 同源），提交去向由退出时现态
+ * 裁决。住 ui 分支不进历史。
  */
 interface TextEditingSession {
     path: LayerPath;
     expression: boolean;
+    /**
+     * 草稿接管序号（工单 02，会话内容独占的内核底线面）：旁门内容写（查找替换等
+     * 程序化写）命中编辑层且文档确实变更时递增——绑定层监听该序号全量替换
+     * textarea 草稿为新文档值并刷新表达式诊断（「替换结果出现在正在编辑的框里」，
+     * 退出提交仍以草稿为准、任何方向不丢字）。进入编辑时缺省（undefined），首次
+     * 接管起计数；标志翻转（pill/toggleDataMode）与零变更事务不递增。
+     */
+    draftSeq?: number;
 }
 /**
  * 查找替换会话（canvas-web-find-replace 工单 01，CONTEXT「查找替换」词条）：
@@ -864,6 +957,14 @@ interface EditorUi {
      * 解除。无粘性工具态（spec 决策 2）；openDocument 重置。
      */
     armedCreate: LayerType | null;
+    /**
+     * 武装 token 的模板表风味载荷（canvas-web-template-table-drag-create 工单 01）：
+     * 行路径表单确认即武装（spec 决策 3）——armedCreate === 'TableLayer' 且本载荷
+     * 非空串 = 模板表风味（endCreate 按风味分派 createTemplateTable）；空串 = 普通
+     * 表武装（G 快捷键语义不受染指）。rowsPath 是 ui 瞬态载荷——不进 graph、
+     * 不进 wire（红线 3 延伸），beginLayerCreate 捕获进建层会话；openDocument 重置。
+     */
+    armedCreateRowsPath: string;
     /** 进行中的画拉建层橡皮筋会话（拖拽期纯视觉，文档零变更）；null = 无 */
     create: CreateGesture | null;
     /** 进行中的文本编辑会话；null = 非编辑态 */
@@ -887,6 +988,16 @@ interface EditorUi {
      * 置，永不进历史；随工程数据 prefs 桶跨会话持久（宿主通道，内核零 localStorage）。
      */
     nextTextStyle: NextTextStyle;
+    /**
+     * 建层比例槽（image-ratio-preset 工单 01，CONTEXT「建层比例」词条）：记忆
+     * 「下一个新建图片层用什么宽高比」的编辑器级偏好——六档、缺省自由，仅
+     * ImageLayer 消费（QR 恒方是层型硬钳，其余层型无此槽）。比例预设的应用 =
+     * 写槽再武装画拉（armLayerCreate），普通图片层项/快捷键 I 不带 preset、武装
+     * 后按槽值钳制——槽是唯一偏好源。与锚点折叠同款的面板偏好——openDocument
+     * 换文档不重置，永不进历史；随工程数据 prefs 桶跨会话持久（宿主通道，内核
+     * 零 localStorage）。
+     */
+    nextLayerRatio: RatioPresetId;
     /**
      * 数据源 schema 声明（content-completion 工单 03/08，D2 宿主随会话注入）：
      * 编译产物形状树或降级 null（根级结构性拒绝，注入期经
@@ -984,7 +1095,7 @@ declare class EditorStore {
     get canRedo(): boolean;
     /** 打开/替换文档：ui 选择/编辑/重命名会话与双向历史一并重置（新文档不继承旧路径/旧事务）；
      *  参考线/锁定集合/查找会话/建层武装与画拉会话随当次会话清空（对位轴/文档内容防护/
-     *  查询词/待命层型不跨文档），标尺显隐/锚点折叠/新层样式作为偏好保留 */
+     *  查询词/待命层型不跨文档），标尺显隐/锚点折叠/新层样式/建层比例作为偏好保留 */
     openDocument(canvas: Canvas): void;
     /**
      * 文档事务唯一入口：produceWithPatches 求新树，无变化即空转（不进历史不通知）；
@@ -1014,8 +1125,13 @@ declare class EditorStore {
     setDrag(gesture: DragGesture | null): void;
     /** 缩放会话开始/结束（null，工单 07）；会话对象住 ui 分支，文档只收缩放事务 */
     setResize(gesture: ResizeGesture | null): void;
-    /** 建层武装置/解除（null，drag-create 工单 01）；标量值等短路（重复武装同型不通知） */
-    setArmedCreate(type: LayerType | null): void;
+    /**
+     * 建层武装置/解除（null，drag-create 工单 01）；标量值等短路（重复武装同型
+     * 不通知）。rowsPath（template-table-drag-create 工单 01）：模板表风味载荷
+     * 与层型一体写——同层型同载荷才短路（重复武装同型换载荷要更新），解除
+     * （null）一律清载荷。
+     */
+    setArmedCreate(type: LayerType | null, rowsPath?: string): void;
     /** 画拉橡皮筋会话开始/更新/结束（null）；会话对象住 ui 分支，落库在 endCreate 单事务 */
     setCreate(gesture: CreateGesture | null): void;
     /** 文本编辑会话开始/结束（null）；会话住 ui 分支，文本经 commitTextEdit 一次性落文档 */
@@ -1029,6 +1145,11 @@ declare class EditorStore {
      * 写入口）：patch 并入现值，五字段值等短路（重复写同值零通知），不进历史。
      */
     setNextTextStyle(patch: Partial<NextTextStyle>): void;
+    /**
+     * 建层比例槽写入（image-ratio-preset 工单 01：比例预设应用 / prefs 恢复的
+     * 统一写入口）：值等短路（重复写同档零通知），仅 ui 通知、不进历史。
+     */
+    setNextLayerRatio(id: RatioPresetId): void;
     /**
      * 数据源 schema 声明替换（归一产物或降级 null，校验收口在注入缝不在这里）：
      * 同引用短路（重复注入同一归一产物不惊动订阅方）；仅 ui 通知，不参与重绘
@@ -1169,6 +1290,12 @@ interface EditorPrefsState {
      * 由 applyEditorPrefs 宽容读兜底为现值（会话内即工厂缺省）。
      */
     nextTextStyle: NextTextStyle;
+    /**
+     * 建层比例槽（image-ratio-preset 工单 01，CONTEXT「建层比例」词条）：随 prefs
+     * 桶跨会话持久（per-模板记忆，「自由」即显式重置档）。schemaVersion 不升——
+     * 加法演进，旧快照缺字段或脏值由 applyEditorPrefs 宽容读回落 'free'。
+     */
+    nextLayerRatio: RatioPresetId;
 }
 
 /**
@@ -1279,7 +1406,7 @@ type InvalidateTarget = 'content' | 'overlay' | 'both';
 interface TextEditLayout {
     /** 编辑中图层的绝对盒（场景坐标；textarea 覆盖整盒，文字按 padding 内缩） */
     box: LayerBox;
-    /** 进入编辑时的文档文本（textarea 初值） */
+    /** 当前文档文本（textarea 初值消费；live 键入只住草稿不落文档） */
     text: string;
     /** 原始字体引用（空串/纯数字 = 内置默认字体；URL 由绑定层解析注册族名） */
     font: string;
@@ -1301,10 +1428,9 @@ interface TextEditLayout {
     /** autowrap = textarea  pre-wrap 软换行，否则 pre 单行（断行允许与预览不同，决策 A） */
     autowrap: boolean;
     /**
-     * 内容类型会话模式（canvas-web-expression-editing 工单 01）：true = 表达式——
-     * 绑定层 pill 激活态与补全 enabled 的消费面。取会话标志（编辑中 pill 切换
-     * 实时跟随，不受层标记态影响——面板在会话窗口期显示的是提交前旧状态）；路径
-     * 无活动会话时按层标记态回落（进入编辑即锚定同值）。
+     * 内容模式活标志（ADR 0019）：true = 表达式——绑定层 pill 激活态与补全
+     * enabled 的消费面。取会话活标志（pill 切换与内核 toggleDataMode 会话期实时
+     * 翻转，面板锁定段同源随动）；路径无活动会话时按层标记态回落。
      */
     expressionMode: boolean;
 }
@@ -1569,8 +1695,17 @@ declare class EditorSession {
      *
      * 拖不动写不动的同门守卫：无会话、目标层被结构编辑移除（悬空路径）整体
      * 空转（不发事务、不发布命中轴）。
+     *
+     * Shift 等比（image-ratio-preset 工单 01，spec 决策 5）：仅 ImageLayer 生效
+     * （其余层型 shift 空转走现状——自适应与尺寸耦合面不被触碰），且须双轴皆在
+     * 可缩放面（格内容等强同步面派生轴写不出去，不进等比模式）、起始盒零维空转
+     * （无比例可参照，回落自由）。参照手势起始盒实际宽高比；驱动轴 = 角柄取位
+     * 移较大轴、边中柄取被拖轴；派生维 = round(驱动维 × 短比)（钳后驱动维跟随，
+     * 最小钳位随动）；对缘/对角固定照旧；吸附只在驱动轴移动缘候选（派生轴是算
+     * 术产物不独立吸附，钳先于吸附同门）。等比模式双轴都落声明值（派生轴写算
+     * 术积并清 auto 标志），canonicalize 以驱动轴键收口。
      */
-    resizeTo(sceneX: number, sceneY: number): void;
+    resizeTo(sceneX: number, sceneY: number, shift?: boolean): void;
     /**
      * 结束缩放：闭合合并事务（下一步历史定格），会话态与命中轴回显清空。
      * 无会话空转（幂等，pointercancel 与 pointerup 双路同达）。
@@ -1581,14 +1716,27 @@ declare class EditorSession {
      * 分支待命层型，下一次画布按下即开画拉；建层提交或 Esc 即解除——一次性
      * 待命态，无粘性工具（spec 决策 2）。重复武装同型值等短路零通知。
      *
-     * preset（text-defaults 工单 01，CONTEXT「文本预设」词条）：文本预设 = 写
-     * 新层样式槽的快捷方式——命中档位先把档位值并入槽（v1 只 fontSize），再
-     * 武装；仅 TextLayer 生效；未知 id = 跳过写槽、武装照常（评审口径统一：
-     * 「空转」只指写槽，武装层型本身仍合法）。
-     */
-    armLayerCreate(type: LayerType, preset?: TextPresetId): void;
-    /** 解除建层武装（取消入口）：仅清待命态，零副作用。 */
+     * preset（text-defaults 工单 01 + image-ratio-preset 工单 01）：层型相关预设 =
+     * 写槽的快捷方式——命中档位先把档位值并入对应偏好槽再武装；未知 id = 跳过
+     * 写槽、武装照常（评审口径统一：「空转」只指写槽，武装层型本身仍合法）。
+     * - TextLayer + 文本预设档：写新层样式槽（v1 只 fontSize）；
+     * - ImageLayer + 比例预设档：写建层比例槽（'free' 即显式重置档）；QR 恒方
+     *   是层型硬钳、无比例槽（spec 豁免面）；
+     * - 交叉类型（文本层带比例档/图片层带文本档）各在对方清单查无此档、天然
+     *   跳写槽。
+     */
+    armLayerCreate(type: LayerType, preset?: TextPresetId | RatioPresetId): void;
+    /** 解除建层武装（取消入口）：仅清待命态（含模板表风味载荷），零副作用。 */
     cancelArmLayerCreate(): void;
+    /**
+     * 武装模板表建层（canvas-web-template-table-drag-create 工单 01，spec 决策 3）：
+     * 行路径表单确认即武装——rowsPath 随武装进 ui 瞬态载荷（armedCreate 仍为
+     * 'TableLayer'、不新增 LayerType、不进 graph），下一次画拉或死区点击落模板表。
+     * 空串 no-op（内核防御，表单层已拦）；重复武装同 rowsPath 值等短路，换
+     * rowsPath 更新载荷。TableLayer 的 G 武装语义（V1 普通表，armLayerCreate 走
+     * 空载荷）不受染指。
+     */
+    armTemplateTableCreate(rowsPath: string): void;
     /**
      * 开始画拉会话：须已武装（未武装空转防御——画布手势态机的分派前置，此守卫
      * 兜其余调用来源），与拖动/缩放会话互斥（手势起点一次性定死，beginDrag/
@@ -1599,24 +1747,37 @@ declare class EditorSession {
     beginLayerCreate(sceneX: number, sceneY: number): boolean;
     /**
      * 画拉进行中：橡皮筋求位（spatial/create.createRubberBandRect——两点正规化
-     * + QR 钳 height := width + 左右/上下缘各两点进 resolveSnapPoints，吸附数学
-     * 零新增）写回会话 rect 供 overlay 直读（虚线矩形 + W×H 气泡），命中轴回写
-     * ui.snapAxes 走 GuidesOverlay 既有通道回显（dragTo 同门）。吸附排除面为空
-     * （snapAxesForGesture(null)——新层尚未入库，全部可见根层供轴，copyMode
-     * 首移同门）。零文档事务：修正只进会话几何，落库在 endCreate。
+     * + QR 钳 height := width / 比例钳长轴驱动 + 左右/上下缘各两点进
+     * resolveSnapPoints，吸附数学零新增）写回会话 rect 供 overlay 直读（虚线
+     * 矩形 + W×H 气泡），命中轴回写 ui.snapAxes 走 GuidesOverlay 既有通道回显
+     * （dragTo 同门）。吸附排除面为空（snapAxesForGesture(null)——新层尚未入库，
+     * 全部可见根层供轴，copyMode 首移同门）。零文档事务：修正只进会话几何，
+     * 落库在 endCreate。
+     *
+     * 建层比例槽（image-ratio-preset 工单 01，spec 决策 3/4）：仅 ImageLayer 按槽
+     * 钳制（QR 层不传 ratio、恒方语义不动，两钳互斥；其余层型无槽）；Shift 瞬时
+     * 反转槽态——槽非自由按 Shift = 临时自由、槽自由按 Shift = 临时钳 1:1，按住
+     * 生效松开还原（逐帧求位、不写槽、不改武装态，Figma 惯例的手势瞬时语义）。
      */
-    createTo(sceneX: number, sceneY: number): void;
+    createTo(sceneX: number, sceneY: number, shift?: boolean): void;
     /**
      * 结束画拉：按死区分流落库（一次手势 = 一步历史，undo 整体回退落位 + 尺寸
      * + priority）。先清会话再落文档（commitTextEdit 同门——退出路径级联时幂等）：
      * - 死区外：单事务写入「createDefaultLayer 缺省形态 + position 左上角对准
      *   橡皮筋矩形（含吸附修正）+ shape.width/height」并 insertRootLayerInDraft
-     *   置顶（priority min−1、push 数组尾）；
+     *   置顶（priority min−1、push 数组尾）——尺寸取手势末态钳制结果（含 Shift
+     *   反转末态，image-ratio-preset 工单 01 spec 决策 4）；
      * - 死区内（点击兜底，位移按 CREATE_DEAD_ZONE_SCREEN_PX 屏幕 px 随 zoom 折算，
-     *   ALT_DRAG_DEAD_ZONE_SCREEN_PX 同门）：缺省尺寸、左上角对准点击点。
+     *   ALT_DRAG_DEAD_ZONE_SCREEN_PX 同门）：左上角对准点击点；尺寸按槽派生缺省
+     *   盒（image-ratio-preset 工单 01：ImageLayer 长边 200 定短边，自由 = 工厂
+     *   200×150 现状；忽略 shift——无位移可供等比约束；其余层型保持工厂缺省）。
      * 落库后自动选中新层并解除武装；返回新层路径（绑定层消费：文本层据此自动
      * 进文本编辑，spec 决策 6）。无会话/无文档空转返回 null。点击兜底不产生
      * 零尺寸层（缺省形态自带可见尺寸）。
+     *
+     * 模板表风味（template-table-drag-create 工单 01）：会话载荷 templateRowsPath
+     * 非空即分派 createTemplateTable 工厂（死区外 shape = 手势正规化矩形，死区内
+     * 缺省壳 400×120、左上角对准点击点）；模板层不自动进文本编辑（文本层专属）。
      */
     endCreate(): LayerPath | null;
     /**
@@ -1715,7 +1876,9 @@ declare class EditorSession {
      * 应用偏好（会话建立时一次性，跨会话恢复 prefs 的写入口）：整体替换
      * rulersVisible/anchorExpanded，不进历史；值等写入经 store 短路零通知。
      * 新层样式（text-defaults 工单 01）走宽容读逐字段合并（pickNextTextStylePatch
-     * 共享谓词——与捕获同门，缺字/类型不符保留现值）。
+     * 共享谓词——与捕获同门，缺字/类型不符保留现值）；建层比例（image-ratio-preset
+     * 工单 01）走宽容读枚举收口（pickNextLayerRatio——非六档枚举值/旧快照缺字段
+     * 回落 'free'）。
      */
     applyEditorPrefs(prefs: EditorPrefsState): void;
     /**
@@ -1736,11 +1899,10 @@ declare class EditorSession {
      * 进入文本编辑：路径必须解析到 TextLayer。会话只进 ui 分支（不进历史），
      * live 文本住在绑定层的 textarea，内容层随即跳绘该层文本（防重影）。
      *
-     * 内容类型会话标志（canvas-web-expression-editing 工单 01，spec 决策 2）按
-     * 进入瞬间 `layer.expression !== null` 锚定进会话快照——「进入时计、编辑中
-     * 稳定」（verticalAnchorY 同门）：编辑中面板改标记不回写标志，提交去向由
-     * 快照裁决（打标是显式动作，内容判定制已否决）。同路径重复进入短路（快照
-     * 不重锚）；换层进入按新层现状重锚。
+     * 内容模式活标志（ADR 0019）初值按进入瞬间 `layer.expression !== null` 取定
+     * （与文档现态一致），此后不再冻结——pill 切换与内核 toggleDataMode 会话期
+     * 都只翻标志，提交去向由退出时现态裁决（见 commitTextEdit）。同路径重复进入
+     * 短路（会话不重建，接管序号延续）；换层进入按新层现状取初值。
      */
     beginTextEdit(path: LayerPath): boolean;
     /**
@@ -1749,22 +1911,24 @@ declare class EditorSession {
      * 提交与随后 blur 竞态），会话清空后后续调用幂等，保证一次退出恰一步历史。
      *
      * 提交矩阵（canvas-web-expression-editing 工单 01，spec 决策 3，空串判定先于
-     * 片段判定）：
-     * - 串与文档一致：不进历史（进出编辑零噪声），返回 false——对比对象随会话
-     *   模式取：表达式会话对比 `layer.expression`、字面会话对比 `layer.text`（现行
-     *   语义）；
+     * 片段判定；对比对象与去向裁决按会话标志**退出时现态**——活标志语义，ADR
+     * 0019，取代旧「进入时快照」）：
+     * - 串与文档一致：不进历史（进出编辑零噪声），返回 false——对比对象随退出时
+     *   会话标志取：表达式现态对比 `layer.expression`、静态现态对比 `layer.text`；
      * - 空串：删除该图层（复用 deleteLayer 的 splice/重映射语义），任何模式同语义；
-     * - 表达式会话且串含 ≥1 语法有效闭合片段（hasValidExpressionFragment）：
+     * - 表达式现态且串含 ≥1 语法有效闭合片段（hasValidExpressionFragment）：
      *   updateDataExpression 标记写（保持标记、text 自动重镜像）；
-     * - 其余（字面会话恒走此支；表达式会话无合法片段回落）：updateData 字面写、
+     * - 其余（静态现态恒走此支；表达式现态无合法片段回落）：updateData 字面写、
      *   字面接管解标——含 `{{...}}` 按字面保留，杜绝无片段标记层。
      */
     commitTextEdit(text: string): boolean;
     /**
      * 编辑 overlay 的布局描述：与绘制/命中同一套布局策略求出的盒几何与排版字段
      * （textarea 以盒左上对位、盒尺寸占位，字号/行高/内边距按场景像素交给 CSS
-     * transform 缩放）。verticalAnchorY 按进入编辑时的文档文本计算，编辑中保持
-     * 稳定不随键入跳动。非文本层/路径失效返回 null。
+     * transform 缩放）。对当前文档现算（canvas-web-edit-overlay-toolbar 工单 01，
+     * ADR 0019 布局现算）：会话期样式/几何权威写实时反映到查询值；verticalAnchorY
+     * 按当前文档文本计算——live 键入只住 textarea 草稿不落文档，键入不触发文档
+     * 变更，锚点天然稳定不跳。非文本层/路径失效返回 null。
      */
     textEditLayout(path: LayerPath): TextEditLayout | null;
     /** 编辑会话的目标图层查询：路径须解析到 TextLayer，其余（含无文档）返回 null */
@@ -1796,14 +1960,16 @@ declare class EditorSession {
      * 原地不动——事务后派生列表在被替换处缩一位，原下标即「下一处」（「替换后
      * 自动跳下一处」靠派生天然成立，末处替换则钳位停在尾）。写值经 replaceHitsInDraft
      * 与文本编辑提交同门（text 直写 + expression 保持 null）。无文档/空 query/
-     * 无命中空转返回 false。
+     * 无命中空转返回 false。命中编辑层时草稿接管（会话内容独占，工单 02——
+     * 替换结果出现在正在编辑的框里）。
      */
     replaceOne(): boolean;
     /**
      * 全部替换（查找条「全部替换」按钮）：命中（path + 偏移对）在事务前按原文
      * 快照一次算定，单事务内按同字段偏移降序应用、替换产物不重扫（replacement
      * 含查询串不死循环）——一次调用 = 一步历史，undo 一次全回。返回应用处数
-     * （计数反馈「已替换 N 处」）；无文档/空 query 空转返回 0。
+     * （计数反馈「已替换 N 处」）；无文档/空 query 空转返回 0。命中编辑层时
+     * 草稿接管（会话内容独占，工单 02）。
      */
     replaceAll(): number;
     /**
@@ -1834,6 +2000,10 @@ declare class EditorSession {
      * null，值与标记的镜像关系随之解除——标记态文档经字面编辑退化为字面态，
      * 不可自动恢复属预期（spec §3.7 兼容面）。
      * 表/行/格无数据字段，空转。
+     *
+     * 会话内容独占（工单 02，ADR 0019 内核底线面）：命中编辑层的写落文档的同时
+     * 草稿接管（draftSeq 递增，绑定层全量替换 textarea 草稿）——旁门程序化写的
+     * 结果进编辑框草稿而非被退出提交覆盖，任何方向不丢字。
      */
     updateData(path: LayerPath, value: string | null, options?: TransactOptions): void;
     /**
@@ -1846,20 +2016,48 @@ declare class EditorSession {
      *   字面态空值归一交给 updateData/decode 分支（这里不清值，字面接管语义）。
      * - 仅三内容层生效，表/行/格/行模板空转（与 updateData 同门）。
      * - updateData 语义不变：字面写解除标记仍成立（spec §1 明示两者并排）。
+     * - 命中编辑层的旁门打标同走草稿接管（draftSeq 递增；会话标志不随动——
+     *   活标志只归 pill/toggleDataMode 翻，见 toggleDataMode）。
      */
     updateDataExpression(path: LayerPath, expression: string | null, options?: TransactOptions): void;
+    /**
+     * 数据字段取值方式切换（静态 ⇆ 表达式，工单 02 自面板收编内核）：表达式现态
+     * → 字面接管（updateData，值保持现镜像）；静态现态 → 打标（updateDataExpression，
+     * 初值 = 值字段原文）。各为独立一步历史（无 mergeKey）。三内容层分派各取值
+     * 字段，表/行/格/悬空路径空转。
+     *
+     * 活标志防御路由（ADR 0019）：路径即编辑中的层时只翻会话活标志（零文档变更
+     * 零历史步）——会话期内容模式切换的唯一写入口是会话标志，文档面锁定归编辑框
+     * 草稿；面板锁定段/pill 显式调用与宿主旁路调用都安全收敛到同一语义。
+     */
+    toggleDataMode(path: LayerPath): void;
+    /**
+     * 内容写事务的统一形（会话内容独占工单 02）：transact 落库 + 命中编辑层的
+     * 草稿接管收口——updateData/updateDataExpression/replaceOne/replaceAll 四个
+     * 旁门写入口同门（接管判定见 takeoverDraftIfNeeded；零变更事务天然短路）。
+     */
+    private transactContent;
+    /**
+     * 草稿接管收口（工单 02）：paths 中有编辑层且文档确实变更（引用比较——零变更
+     * 事务 transact 空转不通知，接管序号也不动）时递增会话 draftSeq 并广播
+     * ui.editing。绑定层据此全量替换 textarea 草稿为文档新值并刷新表达式诊断。
+     * commitTextEdit 先清会话再落库，天然不复入接管。
+     */
+    private takeoverDraftIfNeeded;
     /** 更新画布级字段（未选中图层时面板的宽/高写入口）；键由类型收窄为 width/height */
     updateCanvasProp(key: 'width' | 'height', value: number, options?: TransactOptions): void;
     /**
      * 注入数据源 schema 声明（载荷形态，D1 钉定：声明即 compile(canvas, dataset)
      * 收到的 data 载荷形状，根上下文候选 = 载荷顶层键）。声明经
      * normalizeExpressionSchemaSource 一次性编译收口——根级结构性问题（保留键
-     * row/$ 前缀，前移填充期 reserved_root_key；根非对象/缺 properties 层级）降级
-     * 为无候选 + console 警告，局部故障（$ref 断链/外部指针/环引用/目标形态不符）
-     * 不拒绝：该节点降叶子 + 注入期汇总告警一次，树其余部分照常服务，不抛错不
-     * 弹错（辅助声明不作权威）；null/undefined = 清除声明。声明只住 store ui 分支：
-     * 不进 graph、不落 localStorage、不进 wire；openDocument 换文档不重置，
-     * 重注入/清除走同一入口。签名与「注入即整体替换」语义不变（D6）。
+     * row/$ 前缀，前移填充期 reserved_root_key；根非对象/缺 properties 层级）
+     * 与开放映射契约废除（open_map_unsupported，ADR 0020：文档任意层
+     * additionalProperties: true 显式拒绝，动态键归宿主组装成具体 properties 后
+     * 注入）降级为无候选 + console 警告，局部故障（$ref 断链/外部指针/环引用/
+     * 目标形态不符）不拒绝：该节点降叶子 + 注入期汇总告警一次，树其余部分照常
+     * 服务，不抛错不弹错（辅助声明不作权威）；null/undefined = 清除声明。声明只
+     * 住 store ui 分支：不进 graph、不落 localStorage、不进 wire；openDocument
+     * 换文档不重置，重注入/清除走同一入口。签名与「注入即整体替换」语义不变（D6）。
      */
     setDataSourceSchema(raw: unknown): void;
     /** 上传可用性：未注入 uploadHandler 时为 false（宿主据此隐藏/禁用上传入口） */
@@ -2084,12 +2282,6 @@ declare class EditorSession {
      * 一次调用 = 一步历史。
      */
     addTableCell(rowPath: LayerPath): void;
-    /**
-     * 新增模板表（「+」选择器入口，spec §2.1）：createTemplateTable 缺省形态 +
-     * 置顶 + 自动选中；一次调用 = 一步历史。rowsPath 必填（解码 rows_path_missing
-     * 硬约束的对齐兜底，表单校验前置），空串 no-op。
-     */
-    addTemplateTable(rowsPath: string): void;
     /**
      * 模板行加格（spec §3.1）：addTemplateCellInDraft 重建路径（末格宽/首格行宽、
      * 零高度耦合），自动选中新格；一次调用 = 一步历史。非模板态 no-op。
@@ -2217,10 +2409,11 @@ declare function hitTest(canvas: Canvas, sceneX: number, sceneY: number, policie
  *
  * 拖拽期两点正规化出橡皮筋矩形（x = min、width = |dx|，y 同，反向拖不翻转）；
  * QrCodeLayer 钳 height := width（高随宽从动保持方形，八柄缩放「QR 从动轴不
- * 采纳」同门）；橡皮筋左右/上下缘各两点进 resolveSnapPoints——吸附数学零新增，
- * 命中修正整矩形平移并入几何（两点正规化与 QR 方形在修正后原样保持）。死区常量
- * 屏幕像素口径同 SNAP_THRESHOLD_SCREEN_PX（场景阈值 = 阈值 / zoom，缩放无关）。
- * 全模块纯函数、无 DOM；会话编排（武装/落库/解除）在会话门面。
+ * 采纳」同门）；可选 ratio（image-ratio-preset 工单 01）长轴驱动钳制橡皮筋到
+ * 目标宽高比；橡皮筋左右/上下缘各两点进 resolveSnapPoints——吸附数学零新增，
+ * 命中修正整矩形平移并入几何（两点正规化、QR 方形与比例钳在修正后原样保持）。
+ * 死区常量屏幕像素口径同 SNAP_THRESHOLD_SCREEN_PX（场景阈值 = 阈值 / zoom，缩放
+ * 无关）。全模块纯函数、无 DOM；会话编排（武装/落库/解除）在会话门面。
  */
 
 /** 画拉死区阈值（css 像素，缩放无关；场景阈值 = 阈值 / zoom）：位移不越过即视作
@@ -2233,11 +2426,20 @@ interface CreateRectResult {
 }
 /**
  * 画拉橡皮筋求位：两点正规化（起点场景坐标 + 当前点 → 左上角原点矩形）→
- * QR 钳 height := width → 左右/上下缘各两点对轴集合求位（已有已对齐 delta=0
- * 也回显命中轴的语义，dragTo/resizeTo 同门）→ 修正整矩形平移并入。钳方先于
- * 吸附——QR 的方边（y + width）才是真实的下缘吸附位点。
- */
-declare function createRubberBandRect(type: LayerType, start: Point, current: Point, axes: readonly SnapAxis[], threshold: number): CreateRectResult;
+ * QR 钳 height := width / ratio 长轴驱动钳（两者互斥：QR 层忽略 ratio，恒方
+ * 语义不动——调用缝只对 ImageLayer 传 ratio）→ 左右/上下缘各两点对轴集合求位
+ * （已有已对齐 delta=0 也回显命中轴的语义，dragTo/resizeTo 同门）→ 修正整矩形
+ * 平移并入。钳先于吸附——QR 的方边与比例钳的派生边才是真实的吸附位点。
+ *
+ * ratio 钳（image-ratio-preset 工单 01，spec 决策 3）长轴驱动：|Δx| ≥ |Δy| 时
+ * 宽驱动（height = round(width × h ÷ w)，Math.round 对正数 half-up），否则高
+ * 驱动（width = round(height × w ÷ h)）；钳制在正规化后，反向拖取绝对值镜像
+ * 天然覆盖。
+ */
+declare function createRubberBandRect(type: LayerType, start: Point, current: Point, axes: readonly SnapAxis[], threshold: number, ratio?: {
+    w: number;
+    h: number;
+} | null): CreateRectResult;
 
 /**
  * 滚轮意图分类（工单 05，三态）。纯函数：输入只取事件修饰键快照，
@@ -2555,57 +2757,6 @@ type ExpressionPathParse = {
 /** 解析点路径：head 分类 + 余段；语法不合法（空片段/空段）返回错误信号 */
 declare function parseExpressionPath(expr: string): ExpressionPathParse;
 
-/** 字面直通段（不含任何 `{{`） */
-interface ExpressionScanLiteral {
-    kind: 'literal';
-    start: number;
-    end: number;
-    text: string;
-}
-/** 闭合片段（含 `{{ }}` 外壳区域；raw 为外壳内原文，expr 为 trim 后路径） */
-interface ExpressionScanFragment {
-    kind: 'fragment';
-    start: number;
-    end: number;
-    raw: string;
-    expr: string;
-    /** 空片段/路径空段信号（与求值器 expression_syntax_error 同码）；合法为 null */
-    error: ExpressionSyntaxError | null;
-}
-/** 未闭合 `{{` 起的输入中片段（求值期按字面；编辑器侧补全触发态） */
-interface ExpressionScanOpen {
-    kind: 'open';
-    start: number;
-    end: number;
-    /** 含 `{{` 外壳的原文（到串尾） */
-    text: string;
-    /** `{{` 之后内容的 trim 结果（待输入路径，可能为空串） */
-    expr: string;
-}
-type ExpressionScanPart = ExpressionScanLiteral | ExpressionScanFragment | ExpressionScanOpen;
-interface ExpressionScan {
-    template: string;
-    /** 有序切分；parts 拼回恒等于 template（空字面一律省略） */
-    parts: readonly ExpressionScanPart[];
-}
-/** PHP trim() 默认字符集（JS String.trim 的 Unicode 空白集与之不同，勿用）；
- *  编辑器侧补全的接受手术同用此集（导出防按值复刻漂移，工单 04） */
-declare const PHP_TRIM_CHARS = " \t\n\r\0\v";
-/**
- * PHP trim() 语义（六字符集）：片段 trim 与 vue 侧补全的 expr 前缀截取同用此集
- * （光标定位参数位，expression-type-methods 工单 12——单一事实源，勿按值复刻；
- * JS `String.trim()` 含全角空格等 Unicode 空白，会造成与 PHP 的双端漂移）。
- */
-declare function phpTrim(value: string): string;
-/** 扫描模板串的片段切分：闭合/未闭合/多片段/错误信号，语义对齐求值器扫描循环 */
-declare function scanExpressionFragments(template: string): ExpressionScan;
-/**
- * 光标所在片段判定（编辑器侧语义，PHP 无光标概念故不入跨端 fixture）：
- * closed 片段含光标 ⟺ start < cursor < end（`}}` 之后即离开——输入 `}}` 关闭浮层）；
- * open 片段含光标 ⟺ start < cursor <= end（串尾输入位恒在内）。
- */
-declare function expressionFragmentAtCursor(scan: ExpressionScan, cursor: number): ExpressionScanFragment | ExpressionScanOpen | null;
-
 /**
  * 最小调用形解析纯函数（expression-type-methods 工单 12，spec §1.1/§1.2 ⑦⑨）。
  *
@@ -2640,7 +2791,21 @@ type ExpressionCallParse = {
 } | {
     ok: false;
     error: ExpressionSyntaxError;
+    kind: ExpressionCallErrorKind;
+    at: ExpressionErrorRange;
 };
+/**
+ * 结构错子类（编辑器诊断面，expression-syntax-diagnostics 工单 01）：呈现轴，
+ * 不入跨端 fixture（位置本就由本端派生并由单测锁死）；中文措辞映射在 vue 层
+ * useExpressionDiagnostics。分类对齐权威端 InterpolationEvaluator 的消息面
+ * （spec §5.2），缺左括号从「括号不平衡」单列便于提示。
+ */
+type ExpressionCallErrorKind = 'missing_open_paren' | 'unbalanced_paren' | 'unterminated_string' | 'empty_arg_slot' | 'bad_arg_syntax' | 'trailing_after_call' | 'first_arg_not_path' | 'invalid_path_arg' | 'invalid_path';
+/** 出错子范围（expr 内坐标，end 独占） */
+interface ExpressionErrorRange {
+    start: number;
+    end: number;
+}
 /**
  * ⑦ 片段分类：首 token 后紧跟可选空白与 `(` 即调用。expr 须已 trim（片段扫描
  * 职责，与 parseExpressionPath 契约一致）。
@@ -2669,6 +2834,140 @@ interface ExpressionCallSlotContext {
  */
 declare function expressionCallSlotAtEnd(expr: string): ExpressionCallSlotContext | null;
 
+/**
+ * 片段扫描纯函数（content-completion 工单 01，spec §4 纯函数 ①）。
+ *
+ * 语义逐条对齐 php-canvas-next `InterpolationEvaluator::evaluate` 扫描循环（只读
+ * 对齐，不改求值器）：首个未闭合 `{{` 起剩余全字面、片段内容 trim、`{{}}` 不嵌套
+ * （首个 `}}` 收口，内容含 `{{`）、片段外字面直通；空片段/路径空段 =
+ * `expression_syntax_error` 信号（与求值器同码）。切片语义对调用片段零改动
+ * （spec §1.2 ⑤：首个 `}}` 收口、扫描器引号不感知——片段内禁 `}}` 字面）；闭合
+ * 片段的错误信号按 ⑦ 分类分流（路径/调用，expression-type-methods 工单 12）。
+ *
+ * 与求值器的一处表示分叉（编辑器侧补全所需）：未闭合 `{{` 在求值期按字面直通，
+ * 在扫描结果里另立 **open 片段**（kind: 'open'）——这正是「输入 `{{` 自动弹出」的
+ * 触发态（spec §3），其 expr 是待输入路径；closed 片段仍按求值语义带错误信号。
+ *
+ * 位置字段是 JS 码元索引（end 独占）——与 PHP 字节索引不同空间，跨端共享 fixture
+ * （expression-scan v1）只钉切分内容不钉位置，位置由本端派生并由单测锁死。
+ * trim 字符集对齐 PHP `trim()` 默认六字符（" \t\n\r\0\x0B"），**不是** JS 的
+ * `String.trim()`（后者含全角空格等 Unicode 空白，会造成双端漂移）。
+ *
+ * 全模块纯函数、无 DOM（editor-shared-isolation）。
+ */
+
+/** 字面直通段（不含任何 `{{`） */
+interface ExpressionScanLiteral {
+    kind: 'literal';
+    start: number;
+    end: number;
+    text: string;
+}
+/** 闭合片段（含 `{{ }}` 外壳区域；raw 为外壳内原文，expr 为 trim 后路径） */
+interface ExpressionScanFragment {
+    kind: 'fragment';
+    start: number;
+    end: number;
+    raw: string;
+    expr: string;
+    /** 空片段/路径空段信号（与求值器 expression_syntax_error 同码）；合法为 null */
+    error: ExpressionSyntaxError | null;
+    /**
+     * 结构错诊断（expression-syntax-diagnostics 工单 01）：kind + 出错子范围，
+     * 模板坐标（expr 坐标平移），at 供选中/定位；合法为 null。error 非空 ⟺
+     * diagnostic 非空（同一判定的两投影，error 供 fixture/既有消费面不动）。
+     */
+    diagnostic: ExpressionFragmentDiagnostic | null;
+}
+/**
+ * 片段诊断 kind（结构面呈现轴，spec §1.2 ⑨ JS 本端；= 调用面子类 + 空片段 +
+ * 资源门子类）。resource_* 两 kind 不由扫描面产出——资源单值门（resourcePath，
+ * ADR 0020）是整串判定，诊断沿本形态面出（kind 供 vue 措辞映射，复用空片段同款）。
+ */
+type ExpressionFragmentErrorKind = ExpressionCallErrorKind | 'empty_fragment' | 'resource_not_single_ref' | 'resource_function_call';
+/** 闭合片段的结构错诊断：位置由本端派生（不入跨端 fixture），措辞映射在 vue 层 */
+interface ExpressionFragmentDiagnostic {
+    kind: ExpressionFragmentErrorKind;
+    /** 片段外壳范围（模板坐标：start 含 {{，end 含 }}） */
+    start: number;
+    end: number;
+    /** 出错子范围（模板坐标，end 独占）——选中/定位用 */
+    at: ExpressionErrorRange;
+}
+/** 未闭合 `{{` 起的输入中片段（求值期按字面；编辑器侧补全触发态） */
+interface ExpressionScanOpen {
+    kind: 'open';
+    start: number;
+    end: number;
+    /** 含 `{{` 外壳的原文（到串尾） */
+    text: string;
+    /** `{{` 之后内容的 trim 结果（待输入路径，可能为空串） */
+    expr: string;
+}
+type ExpressionScanPart = ExpressionScanLiteral | ExpressionScanFragment | ExpressionScanOpen;
+interface ExpressionScan {
+    template: string;
+    /** 有序切分；parts 拼回恒等于 template（空字面一律省略） */
+    parts: readonly ExpressionScanPart[];
+}
+/** PHP trim() 默认字符集（JS String.trim 的 Unicode 空白集与之不同，勿用）；
+ *  编辑器侧补全的接受手术同用此集（导出防按值复刻漂移，工单 04） */
+declare const PHP_TRIM_CHARS = " \t\n\r\0\v";
+/**
+ * PHP trim() 语义（六字符集）：片段 trim 与 vue 侧补全的 expr 前缀截取同用此集
+ * （光标定位参数位，expression-type-methods 工单 12——单一事实源，勿按值复刻；
+ * JS `String.trim()` 含全角空格等 Unicode 空白，会造成与 PHP 的双端漂移）。
+ */
+declare function phpTrim(value: string): string;
+/** 扫描模板串的片段切分：闭合/未闭合/多片段/错误信号，语义对齐求值器扫描循环 */
+declare function scanExpressionFragments(template: string): ExpressionScan;
+/**
+ * 光标所在片段判定（编辑器侧语义，PHP 无光标概念故不入跨端 fixture）：
+ * closed 片段含光标 ⟺ start < cursor < end（`}}` 之后即离开——输入 `}}` 关闭浮层）；
+ * open 片段含光标 ⟺ start < cursor <= end（串尾输入位恒在内）。
+ */
+declare function expressionFragmentAtCursor(scan: ExpressionScan, cursor: number): ExpressionScanFragment | ExpressionScanOpen | null;
+
+/**
+ * 模板级表达式语法诊断汇总（expression-syntax-diagnostics 工单 01）：
+ * 编辑器「输入期标错」的统一取数口——扫描 + 收集全部闭合片段的结构错诊断
+ * （kind + 模板坐标出错子范围），供面板/画布提示消费。open 片段不算错（求值期
+ * 字面直通，spec §1.2 ⑤）；结构面 only、名单面不校验（§1.2 ⑨，防名单漂移假红）。
+ * 全模块纯函数、无 DOM。
+ */
+
+/** 汇总模板中全部片段的结构错诊断（按片段出现顺序） */
+declare function expressionDiagnostics(template: string): readonly ExpressionFragmentDiagnostic[];
+
+/**
+ * 资源表达式单值门诊断（resource-expression-single-ref 工单 03，ADR 0020）：
+ * 已标记的图片地址/二维码值表达式必须**恰为一个裸点路径片段**——禁多片段拼接、
+ * 禁片段外字面、禁内建函数（格式化标量不是数据端备好的资源引用）、禁空片段。
+ *
+ * 规则与求值端同源同语义（「约束是语法级的」）：逐条对齐 php-canvas-next
+ * `CanvasHydrator::assertSingleResourceRef`（权威端，只读对齐）——整串锚定
+ * `^\{\{([^{}]*)\}\}$` + 片段内容 PHP trim 后非空 + 无 `(`。诊断消费面与
+ * expressionDiagnostics 同构（ExpressionFragmentDiagnostic：kind + 模板坐标），
+ * 资源字段（QR/imageSrc）的面板标错据此路由（PropertyField 接线，工单 03 ③）。
+ *
+ * PCRE `$` 尾换行 parity（go-canvas 02 钉定的边角）：PCRE `$` 锚（无 `D` 修饰符）
+ * 容忍串尾恰一 `\n`，LF LF / CRLF 仍拦；JS 正则 `$` 只认串尾——锚定前显式剥
+ * 同款单尾 LF 对齐（求值端对 `{{x}}\n` 放行且尾换行按字面直通，编辑器标红即假红）。
+ *
+ * 与文本面扫描诊断（expressionScan）的分野：门是**整串判定**，不是片段级扫描——
+ * 违例的是「整个值」（多片段/字面残留/无片段时无片段外壳可指），诊断 span 恒为
+ * 整个模板串；空片段沿片段面 empty_fragment 同 kind（同一措辞复用）。
+ *
+ * 全模块纯函数、无 DOM；层内依赖仅 expressionScan（phpTrim + 诊断形态）。
+ */
+
+/**
+ * 资源表达式单值门（ADR 0020）：违例恰 1 条诊断、合法零诊断。门只做语法判定，
+ * 与数据集/schema 在场无关；`$index`/`$root.` 前缀同为裸点路径放行，片段内
+ * 空白属于键名不校验（trim 后非空 + 无 `(` 即过）。
+ */
+declare function resourcePathDiagnostics(template: string): readonly ExpressionFragmentDiagnostic[];
+
 /**
  * 内建函数已知名单与格式建议表（expression-type-methods 工单 12，spec §1.2 ⑨/§2/§3.4）。
  *
@@ -2732,6 +3031,15 @@ interface ExpressionCandidate {
      * 一起被浮层按 partial 过滤（segment 是整段调用文本，直接过滤永不匹配）
      */
     filterKey?: string;
+    /**
+     * 显式分桶判别（resource-expression-single-ref 工单 03，ADR 0020）：'path' =
+     * 字段/结构头路径候选，'function' = 函数名建议 + 形状分桶调用插入——资源面
+     * 选择器（工单 05）按 `kind === 'path'` 过滤函数桶，不用 filterKey/含 ( 启发
+     * 式（工单 12 内部约定不作契约）。缺省 = 两桶之外的建议面（date 格式快捷项
+     * ——资源面天然不出现）；rowsPath 候选面（RowsPathCandidate 同型别名）不产
+     * 此字段。
+     */
+    kind?: 'path' | 'function';
 }
 interface ExpressionCandidateQuery {
     context: ExpressionContextKind;
@@ -2751,12 +3059,6 @@ type ExpressionCandidateResult = {
     /** 正在输入的未完整段（'' = 尾点/空表达式态）；恒为 expr 的后缀 */
     partial: string;
     candidates: readonly ExpressionCandidate[];
-    /**
-     * 开放映射信号（D10）：候选来源节点（头部层 = 根 schema，下钻层 = 前缀
-     * 节点）标 open 时为 true，非 open 恒缺省——供浮层渲染「动态字段，键由
-     * 模板定义」占位提示（工单 10），不污染候选条目契约。
-     */
-    open?: boolean;
 } | {
     ok: false;
     reason: ExpressionSyntaxError;
@@ -2776,9 +3078,8 @@ declare function enumerateExpressionCandidates(schema: ExpressionSchemaNode | nu
  * - 数组内不下钻：具名段穿数组在水合端无意义（navigateRows 对列表键不命中），
  *   完成段任一落点为数组/标量 → null——数组之下不再产出任何候选（「枚举为空」
  *   以走不通同款收口：无补全态、浮层关闭、手输不受阻不阻断），与声明漂移/缺失
- *   同款，全程不抛错。
- * - open 节点（additionalProperties: true）：open 信号随结果透出（信号面与候选
- *   空否无关，对齐 schemaChildEntries 的 D10 面），供浮层渲染占位提示行。
+ *   同款，全程不抛错。开放映射信号面（D10）已随契约废除移除（ADR 0020）——
+ *   schema 解析边界显式拒绝后，无 properties 的对象节点按标量判别（不可导航）。
  * - 候选给当前层全量合法子项、不按 partial 预过滤（前缀过滤归工单 02 浮层面，与
  *   表达式枚举器分工同款）；单尾点 = 剥点列全量子段；partial 恒为输入串后缀。
  * - 元信息：path（起点相对完整点路径）+ description/title 两字段分离透传（展示
@@ -2806,18 +3107,12 @@ declare function enumerateExpressionCandidates(schema: ExpressionSchemaNode | nu
  * CompletionItem，浮层零改动复用）。
  */
 type RowsPathCandidate = ExpressionCandidate;
-/** 一次枚举结果（partial/candidates 契约同表达式面 + open 信号）；null = 无补全态 */
+/** 一次枚举结果（partial/candidates 契约同表达式面）；null = 无补全态 */
 interface RowsPathCandidateResult {
     /** 正在输入的未完整段（'' = 空输入/单尾点态）；恒为输入串后缀 */
     partial: string;
     /** 当前层全量合法子项（不按 partial 预过滤——前缀过滤归浮层） */
     candidates: readonly RowsPathCandidate[];
-    /**
-     * 开放映射信号（D10 同款）：枚举落点标 open（additionalProperties: true）时为
-     * true，非 open 恒缺省——浮层渲染「动态字段，键由模板定义」占位提示行，信号
-     * 在场时候选空也不关浮层。
-     */
-    open?: boolean;
 }
 /**
  * 枚举当前输入串的合法 rowsPath 候选。起点 schema null（判别件降级态）直接无
@@ -2880,4 +3175,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 ExpressionCallParse, type ExpressionCallSlotContext, type ExpressionCandidate, type ExpressionCandidateQuery, type ExpressionCandidateResult, type ExpressionContextKind, type ExpressionFormatSuggestion, 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, RESIZE_HANDLES, RESIZE_HANDLE_HIT_PX, RESIZE_MIN_SIZE_PX, 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, defaultNextTextStyle, deleteLayerInDraft, enumerateExpressionCandidates, enumerateRowsPathCandidates, expressionCallSlotAtEnd, 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, pickNextTextStylePatch, prepareRootPaste, readSpecField, remapPathAfterSplice, replaceHitsInDraft, resizableAxesAt, resizeBox, resizeHandleAt, resizeHandlePoint, resizeHandlesAt, resizeSnapPoints, resolveLayer, resolveRowSchema, resolveRowsPathStartSchema, resolveSnap, resolveSnapPoints, 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 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 };