@allbluecn/web-app 0.19.2 → 0.19.4

package/src/components/design/canvas/plugins/geo/shift-by-world.ts

@@ -0,0 +1,32 @@
+// SPDX-License-Identifier: MIT
+//
+// leafer 插件共享几何原语：world 位移 → local x/y。leafer-x 系列插件声明
+// 「自包含可搬移发布」，但同构几何内核此前在 align / clipboard 各手写一份，
+// 细节漂移（短路条件、变量命名不一）。收敛为单一来源，保持零业务依赖契约。
+
+import type { ILeaf } from "leafer-editor"
+
+type LeafLike = ILeaf & {
+  x?: number
+  y?: number
+  parent?: ILeaf
+}
+
+/**
+ * 把 leaf 的视觉位置平移 world 位移 (dx, dy)：位移向量经父容器 worldToLocal
+ * 官方转换后写入 local x/y（任意父级变换下成立；dx/dy 同零短路）。
+ */
+export function shiftByWorld(leaf: ILeaf, dx: number, dy: number): void {
+  if (dx === 0 && dy === 0) return
+  const target = leaf as LeafLike
+  const parent = target.parent
+  if (!parent) return
+  const world = { x: 0, y: 0 }
+  // 位移前后的两点各自转父空间，差值即 local 位移
+  const from = { ...world }
+  parent.worldToLocal(from)
+  const to = { x: world.x + dx, y: world.y + dy }
+  parent.worldToLocal(to)
+  if (target.x !== undefined) target.x += to.x - from.x
+  if (target.y !== undefined) target.y += to.y - from.y
+}

package/src/components/design/canvas/plugins/leafer-x-align/__tests__/align.test.ts

@@ -171,6 +171,28 @@ describe("leafer-x-align", async () => {
     lf.destroy()
   })
 
+  it("等距分布（混宽）：按中心距而非左缘等分", async () => {
+    const { lf, rect } = await makeTree(leafer)
+    const align = installWithModule(leafer, lf)
+    const a = rect(0, 0) // center 50
+    const b = rect(60, 0, 200, 50) // center 160
+    const c = rect(900, 0) // center 950
+    lf.add(a)
+    lf.add(b)
+    lf.add(c)
+    await sleep(30)
+
+    align.distribute([a, b, c], "h")
+
+    // 中心 50 → 950 等分，b 的目标中心 500
+    const bb = b.getBounds("box", "world")
+    expect(bb.x + bb.width / 2).toBeCloseTo(500, 5)
+    expect(a.getBounds("box", "world").x).toBeCloseTo(0, 5)
+    expect(c.getBounds("box", "world").x).toBeCloseTo(900, 5)
+
+    lf.destroy()
+  })
+
   it("水平翻转：视觉框原地镜像", async () => {
     const { lf, rect } = await makeTree(leafer)
     const align = installWithModule(leafer, lf)
@@ -189,6 +211,27 @@ describe("leafer-x-align", async () => {
     lf.destroy()
   })
 
+  it("水平翻转（scale≠1）：视觉框仍原地镜像", async () => {
+    // 回归哨兵：flip 位移曾按 `世界宽 × |scale|` 重复计入自身缩放，
+    // |scale| ≠ 1 时过量平移（视觉框不再原地镜像）
+    const { lf, rect } = await makeTree(leafer)
+    const align = installWithModule(leafer, lf)
+    const a = rect(100, 100, 100, 50)
+    ;(a as unknown as { scaleX: number }).scaleX = 2
+    lf.add(a)
+    await sleep(30)
+    const before = a.getBounds("box", "world")
+    expect(before.width).toBeCloseTo(200, 5)
+
+    align.flip([a], "h")
+
+    const after = a.getBounds("box", "world")
+    expect(after.x).toBeCloseTo(before.x, 5)
+    expect(after.width).toBeCloseTo(before.width, 5)
+
+    lf.destroy()
+  })
+
   it("少于 3 个分布无操作 / 空数组对齐安全", async () => {
     const { lf, rect } = await makeTree(leafer)
     const align = installWithModule(leafer, lf)

package/src/components/design/canvas/plugins/leafer-x-align/index.ts

@@ -17,6 +17,8 @@
 
 import type { ILeaf, IUI } from "leafer-editor"
 
+import { shiftByWorld } from "../geo/shift-by-world"
+
 export type AlignDir = "left" | "hcenter" | "right" | "top" | "vcenter" | "bottom"
 
 export type Axis = "h" | "v"
@@ -83,23 +85,6 @@ class AlignPlugin implements AlignModuleImpl {
     public root: ILeaf,
   ) {}
 
-  /** 把 leaf 的视觉左上平移 world 位移 (dx, dy)：位移向量经父容器
-   * worldToLocal 官方转换后写入 local x/y（正确处理父级变换） */
-  private shiftByWorld(leaf: ILeaf, dx: number, dy: number): void {
-    if (dx === 0 && dy === 0) return
-    const target = leaf as LeafLike
-    const parent = target.parent
-    if (!parent) return
-    const world = { x: 0, y: 0 }
-    // 位移前后的两点各自转父空间，差值即 local 位移（任意父变换下成立）
-    const from = { ...world }
-    parent.worldToLocal(from)
-    const to = { x: world.x + dx, y: world.y + dy }
-    parent.worldToLocal(to)
-    if (target.x !== undefined) target.x += to.x - from.x
-    if (target.y !== undefined) target.y += to.y - from.y
-  }
-
   align(leaves: IUI[], dir: AlignDir): void {
     if (!leaves.length) return
     const boundsList = leaves.map((leaf) => worldBounds(leaf))
@@ -120,12 +105,12 @@ class AlignPlugin implements AlignModuleImpl {
       const b = boundsList[i]
       const width = b.maxX - b.minX
       const height = b.maxY - b.minY
-      if (dir === "left") this.shiftByWorld(leaf, base.minX - b.minX, 0)
-      else if (dir === "right") this.shiftByWorld(leaf, base.maxX - b.maxX, 0)
-      else if (dir === "hcenter") this.shiftByWorld(leaf, (base.minX + base.maxX) / 2 - (b.minX + width / 2), 0)
-      else if (dir === "top") this.shiftByWorld(leaf, 0, base.minY - b.minY)
-      else if (dir === "bottom") this.shiftByWorld(leaf, 0, base.maxY - b.maxY)
-      else this.shiftByWorld(leaf, 0, (base.minY + base.maxY) / 2 - (b.minY + height / 2))
+      if (dir === "left") shiftByWorld(leaf, base.minX - b.minX, 0)
+      else if (dir === "right") shiftByWorld(leaf, base.maxX - b.maxX, 0)
+      else if (dir === "hcenter") shiftByWorld(leaf, (base.minX + base.maxX) / 2 - (b.minX + width / 2), 0)
+      else if (dir === "top") shiftByWorld(leaf, 0, base.minY - b.minY)
+      else if (dir === "bottom") shiftByWorld(leaf, 0, base.maxY - b.maxY)
+      else shiftByWorld(leaf, 0, (base.minY + base.maxY) / 2 - (b.minY + height / 2))
     })
   }
 
@@ -134,16 +119,18 @@ class AlignPlugin implements AlignModuleImpl {
     const items = leaves
       .map((leaf) => ({ leaf, b: worldBounds(leaf) }))
       .sort((a, b) => (axis === "h" ? a.b.minX - b.b.minX : a.b.minY - b.b.minY))
-    const first = items[0].b
-    const last = items[items.length - 1].b
-    const start = axis === "h" ? first.minX : first.minY
-    const end = axis === "h" ? last.minX : last.minY
+    // 等距分布按「中心距」口径（接口注释/Figma 惯例）：混宽元素按左缘等距
+    // 会导致中心间距不等
+    const center = (b: Bounds): number =>
+      axis === "h" ? (b.minX + b.maxX) / 2 : (b.minY + b.maxY) / 2
+    const start = center(items[0].b)
+    const end = center(items[items.length - 1].b)
     const step = (end - start) / (items.length - 1)
     items.forEach(({ leaf, b }, i) => {
       if (i === 0 || i === items.length - 1) return
       const pos = start + step * i
-      if (axis === "h") this.shiftByWorld(leaf, pos - b.minX, 0)
-      else this.shiftByWorld(leaf, 0, pos - b.minY)
+      if (axis === "h") shiftByWorld(leaf, pos - center(b), 0)
+      else shiftByWorld(leaf, 0, pos - center(b))
     })
   }
 
@@ -163,8 +150,8 @@ class AlignPlugin implements AlignModuleImpl {
     items.forEach(({ leaf, b }, i) => {
       if (i === 0 || i === items.length - 1) return
       cursor += size(items[i - 1].b) + gap
-      if (axis === "h") this.shiftByWorld(leaf, cursor - b.minX, 0)
-      else this.shiftByWorld(leaf, 0, cursor - b.minY)
+      if (axis === "h") shiftByWorld(leaf, cursor - b.minX, 0)
+      else shiftByWorld(leaf, 0, cursor - b.minY)
     })
   }
 
@@ -175,11 +162,12 @@ class AlignPlugin implements AlignModuleImpl {
       const current = leaf[key]
       const scale = typeof current === "number" && Number.isFinite(current) && current !== 0 ? current : 1
       const b = worldBounds(leaf)
-      // 取反自身 scale 绕自身原点（左上）翻转，视觉框跳到对侧——
-      // 平移 width·|scale| 使视觉框原地镜像（与读侧坐标规范化对称）
-      const shift = (axis === "h" ? b.maxX - b.minX : b.maxY - b.minY) * Math.abs(scale)
+      // 取反自身 scale 绕自身原点（左上）翻转，视觉框跳到对侧——所需世界位移
+      // 恰为翻转前世界包围盒的宽/高（b 已含 |scale| 与父级缩放，不再重复相乘：
+      // 旧实现 `宽 × |scale|` 在 |scale| ≠ 1 时过量平移，视觉框不再原地镜像）
+      const shift = axis === "h" ? b.maxX - b.minX : b.maxY - b.minY
       leaf[key] = -scale
-      this.shiftByWorld(leaf, axis === "h" ? shift : 0, axis === "h" ? 0 : shift)
+      shiftByWorld(leaf, axis === "h" ? shift : 0, axis === "h" ? 0 : shift)
     }
   }
 

package/src/components/design/canvas/plugins/leafer-x-clipboard/index.ts

@@ -14,6 +14,8 @@
 
 import type { ILeaf, IUI } from "leafer-editor"
 
+import { shiftByWorld } from "../geo/shift-by-world"
+
 export interface ClipboardSlotItem {
   /** 子树快照（官方 toJSON 产物） */
   json: Record<string, unknown>
@@ -107,9 +109,6 @@ class Clipboard implements ClipboardPlugin {
 
   paste(): IUI[] | null {
     if (!this.slot.length) return null
-    const bounds = this.slot.map((item) => item.world)
-    const minX = Math.min(...bounds.map((b) => b.x))
-    const minY = Math.min(...bounds.map((b) => b.y))
     const dx = this.offset * (this.pasteCount + 1)
     const dy = this.offset * (this.pasteCount + 1)
     this.pasteCount++
@@ -125,10 +124,10 @@ class Clipboard implements ClipboardPlugin {
         addAt?: (child: ILeaf, index: number) => void
       }
       branch.add?.(leaf)
-      // 相对位置保持：整体平移 dx/dy（世界空间差量，经父变换由 leafer 布局承担）
+      // 相对位置保持：整体平移 dx/dy，落点 = 复制时世界坐标 + 偏移
+      //（旧实现 `- minX + dx + minX` 的 -minX/+minX 自相消，已化简）
       const now = worldTopLeft(leaf)
-      const target = { x: item.world.x - minX + dx + minX, y: item.world.y - minY + dy + minY }
-      shiftByWorld(leaf, target.x - now.x, target.y - now.y)
+      shiftByWorld(leaf, item.world.x + dx - now.x, item.world.y + dy - now.y)
       created.push(leaf as unknown as IUI)
     }
     return created
@@ -148,20 +147,6 @@ class Clipboard implements ClipboardPlugin {
   }
 }
 
-function shiftByWorld(leaf: ILeaf, dx: number, dy: number): void {
-  if (dx === 0 && dy === 0) return
-  const target = leaf as LeafLike
-  const parent = target.parent
-  if (!parent) return
-  const from = { x: 0, y: 0 }
-  parent.worldToLocal(from)
-  const to = { x: dx, y: dy }
-  parent.worldToLocal(to)
-  const t = target as { x?: number; y?: number }
-  if (t.x !== undefined) t.x += to.x - from.x
-  if (t.y !== undefined) t.y += to.y - from.y
-}
-
 function resolveRoot(target: unknown, options: ClipboardOptions): ILeaf | null {
   if (options.root) return options.root
   const asApp = target as { tree?: ILeaf }

package/src/components/design/canvas/plugins/leafer-x-history-lite/index.ts

@@ -96,6 +96,12 @@ export interface HistoryLite {
 
 const DEFAULT_LIMIT = 50
 
+// alias 别名表软上限：每次 undo 重建都会新增 innerId → leaf 条目，仅在 clear()
+// 全清——长会话高频 undo/redo 下 Map 无界增长（条目持 leaf 引用还阻碍已删
+// 子树 GC）。超过上限时按插入序剔除最旧的一半：被未来 undo 需要的条目若被
+// 剔除，locate 回落 findByInnerId 按结构查找，行为退化为「无别名」，不致错乱。
+const ALIAS_SOFT_CAP = 500
+
 // ===== 事件载荷最小面（避免依赖 leafer 内部类型导出） =====
 
 interface PropEventPayload {
@@ -393,6 +399,16 @@ class HistoryLitePlugin implements HistoryLite {
     return findByInnerId(this.root, innerId)
   }
 
+  /** alias 别名表软上限清理：Map 保持插入序，剔除最旧一半（含失效条目） */
+  private pruneAlias(): void {
+    if (this.alias.size < ALIAS_SOFT_CAP) return
+    const entries = [...this.alias.entries()]
+    const drop = Math.floor(entries.length / 2)
+    for (const [innerId] of entries.slice(0, drop)) {
+      this.alias.delete(innerId)
+    }
+  }
+
   private detach(innerId: number): void {
     const leaf = this.locate(innerId)
     if (!leaf) return
@@ -418,6 +434,7 @@ class HistoryLitePlugin implements HistoryLite {
       return
     }
     this.alias.set(innerId, leaf)
+    this.pruneAlias()
     const branch = parent as unknown as {
       add?: (child: ILeaf) => void
       addAt?: (child: ILeaf, index: number) => void

package/src/components/design/canvas/react/__tests__/workbench.test.tsx

@@ -93,7 +93,6 @@ function makeFakeEngine() {
 }
 
 type RenderOptions = {
-  mode?: "design" | "doc"
   readOnly?: boolean
   initialDoc?: SceneDocument
   toolbar?: React.ReactNode
@@ -105,7 +104,6 @@ function renderWorkbench(options: RenderOptions = {}) {
   return render(
     <HotkeysProvider>
       <CanvasWorkbench
-        mode={options.mode}
         readOnly={options.readOnly}
         initialDoc={options.initialDoc}
         toolbar={options.toolbar}

package/src/components/design/canvas/react/workbench.tsx

@@ -30,14 +30,14 @@ import { CanvasToolbar } from "../panels/toolbar"
 
 import { useCanvasSnapshot } from "./canvas-hooks"
 import { CanvasProvider } from "./canvas-context"
-import { useEscapeTool } from "./hooks"
 import { CanvasRoot } from "./canvas-root"
 import { useUndoRedo, useZoomControls } from "./hooks"
 
-export type CanvasMode = "design" | "doc"
+// mode prop 已移除：CanvasMode 曾声明（"design" | "doc"）但从未被任何消费方
+// 传递或实现内消费，属死参数；Esc 退出绘制挂在 CanvasRoot（见 canvas-root.tsx
+// 注释「挂在此处而非 CanvasWorkbench」），Workbench 内不重复注册 useEscapeTool。
 
 export type CanvasWorkbenchProps = {
-  mode?: CanvasMode
   readOnly?: boolean
   initialDoc?: SceneDocument
   device?: DeviceType
@@ -181,8 +181,7 @@ function InnerWorkbench({
   toolbar,
   leftPanel,
   rightPanel,
-}: Pick<CanvasWorkbenchProps, "mode" | "readOnly" | "autoFit" | "className" | "toolbar" | "leftPanel" | "rightPanel">) {
-  useEscapeTool()
+}: Pick<CanvasWorkbenchProps, "readOnly" | "autoFit" | "className" | "toolbar" | "leftPanel" | "rightPanel">) {
   return (
     <div className={cn("flex h-full w-full overflow-hidden", className)}>
       {!readOnly && (
@@ -219,7 +218,6 @@ function InnerWorkbench({
 }
 
 export function CanvasWorkbench({
-  mode = "design",
   readOnly = false,
   initialDoc,
   device = "desktop",
@@ -233,7 +231,6 @@ export function CanvasWorkbench({
   return (
     <CanvasProvider readOnly={readOnly} device={device} initialDoc={initialDoc} onDocChange={onDocChange}>
       <InnerWorkbench
-        mode={mode}
         readOnly={readOnly}
         autoFit={autoFit}
         className={className}

package/src/components/design/canvas/registry/__tests__/registry.test.ts

@@ -16,6 +16,7 @@
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"
+import { m } from "@/paraglide/messages.js"
 import {
   getNodeFactory,
   hasNodeFactory,
@@ -267,22 +268,25 @@ describe("builtin 注册表（只测注册，不构造图形）", () => {
     expect(getNodeFactory("header")?.defaults).toEqual({ width: 0, height: 64 })
   })
 
-  it("各内置组件 propsSchema 声明文本属性及默认值", () => {
+  it("各内置组件 propsSchema 声明文本属性；文案默认值为空占位（locale 由创建入口注入）", () => {
+    // 文案类默认值曾硬编码中文（"按钮"/"输入内容"/…），注册期静态不可按
+    // locale 惰性求值——改为空占位，创建入口（buildComponentNode / buildTree
+    // 兜底）经 builtin/default-labels 运行时注入
     expect(getNodeFactory("button")?.propsSchema?.[0]).toEqual({
       type: "text",
-      default: "按钮",
+      default: "",
     })
     expect(getNodeFactory("input")?.propsSchema?.[0]).toEqual({
       type: "text",
-      default: "输入内容",
+      default: "",
     })
     expect(getNodeFactory("card")?.propsSchema?.[0]).toEqual({
       type: "text",
-      default: "卡片标题",
+      default: "",
     })
     expect(getNodeFactory("text")?.propsSchema?.[0]).toEqual({
       type: "text",
-      default: "文本",
+      default: "",
     })
     expect(getNodeFactory("pen-path")?.propsSchema?.[0]).toEqual({
       type: "text",
@@ -290,11 +294,35 @@ describe("builtin 注册表（只测注册，不构造图形）", () => {
     })
     expect(getNodeFactory("header")?.propsSchema?.[0]).toEqual({
       type: "text",
-      default: "标题",
+      default: "",
     })
     expect(getNodeFactory("rect")?.propsSchema).toBeUndefined()
   })
 
+  it("buildTree 文案兜底走 i18n（props.text 缺失/空串时经 default-labels 解析）", () => {
+    initText({
+      ...stubMod,
+      Text: class {
+        config: Record<string, unknown>
+        constructor(cfg: Record<string, unknown>) {
+          this.config = cfg
+        }
+      },
+    } as unknown as typeof import("leafer-editor"))
+    const leaf = getNodeFactory("text")!.buildTree({
+      id: "t2",
+      kind: "shape",
+      type: "text",
+      parentId: "board",
+      x: 0,
+      y: 0,
+      width: 200,
+      height: 24,
+      props: {},
+    }) as unknown as { config: Record<string, unknown> }
+    expect(leaf.config.text).toBe(m.canvas_defaultText())
+  })
+
   it("button 支持移动端尺寸降级", () => {
     expect(resolveDefaults("button", "mobile")).toEqual({
       width: 160,

package/src/components/design/canvas/registry/builtin/button.ts

@@ -18,6 +18,7 @@
 import type { ILeaf } from "leafer-editor"
 import { registerNode } from "../registry"
 import { resolveThemeColor } from "../../document/style/theme-color"
+import { builtinTextDefault } from "./default-labels"
 import type { SceneNode } from "../../document/types"
 
 let MOD: typeof import("leafer-editor") | null = null
@@ -30,7 +31,8 @@ export function registerButton() {
   registerNode("button", {
     defaults: { width: 200, height: 40 },
     defaultsByDevice: { mobile: { width: 160, height: 36 } },
-    propsSchema: [{ type: "text", default: "按钮" }],
+    // 默认文案经创建入口（buildComponentNode）按 locale 注入；schema 占位留空
+    propsSchema: [{ type: "text", default: "" }],
     buildTree(node: SceneNode): ILeaf {
       if (!MOD) throw new Error("leafer-editor not initialized")
       const { Group, Rect, Text } = MOD
@@ -65,7 +67,7 @@ export function registerButton() {
         fontWeight: 500,
         textAlign: "center",
         verticalAlign: "middle",
-        text: (node.props?.text as string) ?? "按钮",
+        text: (node.props?.text as string) || builtinTextDefault("button"),
       })
       g.add(rect)
       g.add(text)

package/src/components/design/canvas/registry/builtin/card.ts

@@ -18,6 +18,7 @@
 import type { ILeaf } from "leafer-editor"
 import { registerNode } from "../registry"
 import { resolveThemeColor } from "../../document/style/theme-color"
+import { builtinTextDefault } from "./default-labels"
 import type { SceneNode } from "../../document/types"
 
 let MOD: typeof import("leafer-editor") | null = null
@@ -33,7 +34,8 @@ export function registerCard() {
       mobile: { width: 311, height: 180 },
       tablet: { width: 300, height: 180 },
     },
-    propsSchema: [{ type: "text", default: "卡片标题" }],
+    // 默认文案经创建入口（buildComponentNode）按 locale 注入；schema 占位留空
+    propsSchema: [{ type: "text", default: "" }],
     buildTree(node: SceneNode): ILeaf {
       if (!MOD) throw new Error("leafer-editor not initialized")
       const { Group, Rect, Text } = MOD
@@ -68,7 +70,7 @@ export function registerCard() {
         fontSize: 12,
         fontWeight: 600,
         letterSpacing: 0.6,
-        text: ((node.props?.text as string) ?? "卡片标题").toUpperCase(),
+        text: ((node.props?.text as string) || builtinTextDefault("card")).toUpperCase(),
       })
       const bodyY = p + 16 + 8
       const body = new Rect({

package/src/components/design/canvas/registry/builtin/default-labels.ts

@@ -0,0 +1,22 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { m } from "@/paraglide/messages.js"
+
+/**
+ * 内置组件文案类默认值单一来源：propsSchema 的 default 为空占位（注册期静态
+ * 常量，不可按 locale 惰性求值），创建入口（component-library-data 的
+ * buildComponentNode / buildTree 兜底）在运行时按当前 locale 经此注入。
+ * shape-tools 的 DEFAULT_TEXT（曾与本表重复定义 "文本"）已收敛于此。
+ */
+export const BUILTIN_TEXT_DEFAULTS: Readonly<Record<string, () => string>> = {
+  text: m.canvas_defaultText,
+  button: m.canvas_defaultButton,
+  input: m.canvas_defaultInput,
+  card: m.canvas_defaultCardTitle,
+  header: m.canvas_defaultHeaderTitle,
+}
+
+/** 内置组件默认文案（运行时按当前 locale 解析；未知 type 返回空串） */
+export function builtinTextDefault(type: string): string {
+  return BUILTIN_TEXT_DEFAULTS[type]?.() ?? ""
+}

package/src/components/design/canvas/registry/builtin/input.ts

@@ -18,6 +18,7 @@
 import type { ILeaf } from "leafer-editor"
 import { registerNode } from "../registry"
 import { resolveThemeColor } from "../../document/style/theme-color"
+import { builtinTextDefault } from "./default-labels"
 import type { SceneNode } from "../../document/types"
 
 let MOD: typeof import("leafer-editor") | null = null
@@ -30,7 +31,8 @@ export function registerInput() {
   registerNode("input", {
     defaults: { width: 300, height: 36 },
     defaultsByDevice: { mobile: { width: 280, height: 36 } },
-    propsSchema: [{ type: "text", default: "输入内容" }],
+    // 默认文案经创建入口（buildComponentNode）按 locale 注入；schema 占位留空
+    propsSchema: [{ type: "text", default: "" }],
     buildTree(node: SceneNode): ILeaf {
       if (!MOD) throw new Error("leafer-editor not initialized")
       const { Group, Rect, Text } = MOD
@@ -63,7 +65,7 @@ export function registerInput() {
         fill: resolveThemeColor("--muted-foreground"),
         fontSize: 14,
         verticalAlign: "middle",
-        text: (node.props?.text as string) ?? "输入内容",
+        text: (node.props?.text as string) || builtinTextDefault("input"),
       })
       g.add(rect)
       g.add(text)

package/src/components/design/canvas/registry/builtin/rect-shapes.ts

@@ -18,6 +18,7 @@
 import type { ILeaf } from "leafer-editor"
 import { registerNode } from "../registry"
 import { resolveThemeColor } from "../../document/style/theme-color"
+import { builtinTextDefault } from "./default-labels"
 import { projectedCornerRadius } from "../../document/style/style-mapper"
 import type { SceneNode } from "../../document/types"
 
@@ -233,7 +234,8 @@ export function registerShapes() {
 
   registerNode("header", {
     defaults: { width: 0, height: 64 },
-    propsSchema: [{ type: "text", default: "标题" }],
+    // 默认文案经创建入口（buildComponentNode）按 locale 注入；schema 占位留空
+    propsSchema: [{ type: "text", default: "" }],
     buildTree(node: SceneNode): ILeaf {
       if (!MOD) throw new Error("leafer-editor not initialized")
       const { Group, Rect, Text, Line } = MOD
@@ -274,7 +276,7 @@ export function registerShapes() {
         fontSize: 16,
         fontWeight: 600,
         verticalAlign: "middle",
-        text: (node.props?.text as string) ?? "标题",
+        text: (node.props?.text as string) || builtinTextDefault("header"),
       })
       g.add(bg)
       g.add(border)

package/src/components/design/canvas/registry/builtin/text.ts

@@ -18,6 +18,7 @@
 import type { ILeaf } from "leafer-editor"
 import { registerNode } from "../registry"
 import { resolveThemeColor } from "../../document/style/theme-color"
+import { builtinTextDefault } from "./default-labels"
 import type { SceneNode } from "../../document/types"
 
 let MOD: typeof import("leafer-editor") | null = null
@@ -29,7 +30,8 @@ export function initText(mod: typeof import("leafer-editor")) {
 export function registerText() {
   registerNode("text", {
     defaults: { width: 200, height: 24 },
-    propsSchema: [{ type: "text", default: "文本" }],
+    // 默认文案经创建入口（buildComponentNode）按 locale 注入；schema 占位留空
+    propsSchema: [{ type: "text", default: "" }],
     buildTree(node: SceneNode): ILeaf {
       if (!MOD) throw new Error("leafer-editor not initialized")
       const { Text } = MOD
@@ -56,7 +58,7 @@ export function registerText() {
         // leafer lineHeight 单位语义：{type:'percent',value} = fontSize 倍率（number 为 px）
         // 与既有视觉默认（fontSize*2 px）一致，避免再产生 px 形态数据（旧数据由面板读侧归一兼容）
         lineHeight: { type: "percent", value: 2 },
-        text: (node.props?.text as string) ?? "文本",
+        text: (node.props?.text as string) || builtinTextDefault("text"),
       })
     },
   })

package/src/components/design/canvas/tools/__tests__/tools.test.ts

@@ -31,7 +31,6 @@ vi.mock("../../document/style/theme-color", () => ({
 import {
   DEFAULT_CORNER_RADIUS,
   DEFAULT_STROKE_WIDTH,
-  DEFAULT_TEXT,
   DEFAULT_TEXT_FONT_SIZE,
   DEFAULT_TEXT_HEIGHT,
   DEFAULT_TEXT_WIDTH,
@@ -52,6 +51,7 @@ import {
 } from "../shape-tools"
 import { buildPenNode, buildPenPath, createFreehandController } from "../pen-tool"
 import { buildTextNode, createTextController } from "../text-tool"
+import { m } from "@/paraglide/messages.js"
 import { BOARD_NODE_ID, type SceneDocument, type SceneNode } from "../../document/types"
 import { isNodePaint } from "../../document/style/paints"
 import type { LeaferEngine } from "@/design-engine/engine/app"
@@ -649,7 +649,7 @@ describe("text-tool", () => {
         fontSize: DEFAULT_TEXT_FONT_SIZE,
         fontWeight: 500,
       },
-      props: { text: DEFAULT_TEXT },
+      props: { text: m.canvas_defaultText() },
     })
     expect(isNodePaint(node.fills?.[0])).toBe(true)
   })
@@ -679,7 +679,7 @@ describe("text-tool", () => {
         },
       ],
       style: { fontSize: DEFAULT_TEXT_FONT_SIZE, fontWeight: 500 },
-      props: { text: DEFAULT_TEXT },
+      props: { text: m.canvas_defaultText() },
     })
     expect(engine.selected).toEqual([["n_1"]])
     expect(engine.tools).toEqual(["select"])

package/src/components/design/canvas/tools/frame-tool.ts

@@ -15,12 +15,17 @@
 // You should have received a copy of the GNU Affero General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
+import { m } from "@/paraglide/messages.js"
+
 import { createFrameNode, type FramePresetKind } from "../document/frames"
 import { BOARD_NODE_ID, type SceneDocument, type SceneNode } from "../document/types"
 import { installWithModule as installPages } from "../plugins/leafer-x-pages/index"
 
-// 画板排布/命名（Phase 3 业务集成）：命名模板注入替代 frames.ts 的 i18n 硬编码
-const pages = installPages(null, null)
+// 画板排布/命名（Phase 3 业务集成）：命名模板注入（i18n）替代插件内置中文兜底。
+// 模板惰性求值（调用时经 paraglide 运行时解析 locale），模块级装配安全。
+const pages = installPages(null, null, {
+  nameTemplate: (index) => m.canvas_frameDefaultName({ count: index }),
+})
 
 import {
   roundCoord,

package/src/components/design/canvas/tools/pen-tool.ts

@@ -29,6 +29,7 @@ import { BOARD_NODE_ID, type SceneNode } from "../document/types"
 
 import {
   DEFAULT_STROKE_WIDTH,
+  distOf,
   nextNodeId,
   pointsBBox,
   polylineHasSize,
@@ -164,10 +165,6 @@ export function isFreehandPen(variant?: string | null): boolean {
   return variant === "freehand"
 }
 
-function distOf(a: Point, b: Point): number {
-  return Math.hypot(a.x - b.x, a.y - b.y)
-}
-
 // buildAnchorPath：锚点数组 → SVG path 绝对坐标串（入参为节点局部坐标）。
 // 段判定：上一锚点 hOut 或当前锚点 hIn 存在 → C（缺失侧控制点回落端点），
 // 否则 L；closed 时补「末锚点 → 首锚点」闭合段并以 Z 结尾