@agent-native/core 0.92.10 → 0.92.12

package/corpus/templates/design/app/hooks/useDesignHotkeys.ts

@@ -144,6 +144,11 @@ export interface UseDesignHotkeysProps {
   onZoomToSelection?: DesignHotkeyHandler;
   /** Figma's Cmd+Alt+K — create component from the current selection. */
   onCreateComponent?: DesignHotkeyHandler;
+  /**
+   * Figma's Cmd+Alt+B — Detach instance: convert the selected component
+   * instance into a plain, unlinked element.
+   */
+  onDetachInstance?: DesignHotkeyHandler;
   /**
    * Figma's plain digit 1-9 / 0 — set selection opacity (10-90%, 0 = 100%).
    * Only fires when a layer is selected (caller decides via presence of the
@@ -156,6 +161,12 @@ export interface UseDesignHotkeysProps {
   onToggleHidden?: DesignHotkeyHandler;
   /** Figma's Cmd+Shift+L — toggle lock/unlock for the current selection. */
   onToggleLocked?: DesignHotkeyHandler;
+  /** Figma's Cmd+U — toggle underline on the current text selection. */
+  onToggleUnderline?: DesignHotkeyHandler;
+  /** Figma's Cmd+Shift+X — toggle strikethrough on the current text
+   *  selection. Checked before plain Cmd+X (cut) so the shift-held combo
+   *  doesn't fall through to cut. */
+  onToggleStrikethrough?: DesignHotkeyHandler;
   /** Figma's Shift+H — flip the current selection horizontally. */
   onFlipHorizontal?: DesignHotkeyHandler;
   /** Figma's Shift+V — flip the current selection vertically. */
@@ -197,6 +208,8 @@ export interface UseDesignHotkeysProps {
   onToggleUi?: DesignHotkeyHandler;
   /** Figma's Shift+C — toggle Show/Hide comments (comment pins). */
   onToggleComments?: DesignHotkeyHandler;
+  /** Figma's Ctrl+Shift+? — open the keyboard-shortcuts reference panel. */
+  onShowKeyboardShortcuts?: DesignHotkeyHandler;
 }
 
 const TOOL_SHORTCUTS: Record<
@@ -269,6 +282,15 @@ export function isDesignHotkeyEditableTarget(target: EventTarget | null) {
   return tagName === "input" || tagName === "textarea" || tagName === "select";
 }
 
+export function isShowKeyboardShortcutsHotkey(event: KeyboardEvent) {
+  return (
+    (event.ctrlKey || event.metaKey) &&
+    event.shiftKey &&
+    !event.altKey &&
+    normalizedKey(event) === "?"
+  );
+}
+
 function isFocusableChromeTarget(target: EventTarget | null) {
   if (!target || typeof Element === "undefined") return false;
   if (!(target instanceof Element)) return false;
@@ -317,7 +339,8 @@ export function useDesignHotkeys(props: UseDesignHotkeysProps) {
         return;
       if (
         current.ignoreEditableTargets !== false &&
-        isDesignHotkeyEditableTarget(event.target)
+        isDesignHotkeyEditableTarget(event.target) &&
+        !isShowKeyboardShortcutsHotkey(event)
       ) {
         return;
       }
@@ -336,7 +359,7 @@ export function useDesignHotkeys(props: UseDesignHotkeysProps) {
   }, [props.capture, props.enabled, props.target]);
 }
 
-function handleDesignHotkey(
+export function handleDesignHotkey(
   event: KeyboardEvent,
   props: UseDesignHotkeysProps,
 ) {
@@ -398,6 +421,12 @@ function handleDesignHotkey(
     return true;
   };
 
+  // Keep shortcut help global, including while an inspector field or code
+  // editor owns focus. No other editing shortcut bypasses the editable guard.
+  if (isShowKeyboardShortcutsHotkey(event)) {
+    return run(props.onShowKeyboardShortcuts);
+  }
+
   if (!primary && !event.altKey && event.shiftKey) {
     // H1: shift+key variant (e.g. Shift+L → arrow tool) takes priority over
     // the base binding for the same key while shift is held.
@@ -425,7 +454,18 @@ function handleDesignHotkey(
   }
 
   if (event.key === "Escape") return run(props.onEscape);
-  if (event.key === "Enter") return run(props.onEnter);
+  if (event.key === "Enter") {
+    // Figma: Enter drills into the selection (selects its first child /
+    // begins text editing); Shift+Enter is its sibling — select the
+    // selection's PARENT. Checked before the plain onEnter fallback so
+    // Shift+Enter doesn't just drill in again; falls back to onEnter when
+    // onSelectParent isn't wired so callers that haven't adopted it yet see
+    // unchanged behavior.
+    if (event.shiftKey && props.onSelectParent) {
+      return run(props.onSelectParent);
+    }
+    return run(props.onEnter);
+  }
   if (!primary && !event.altKey && !event.shiftKey && key === "\\") {
     return run(props.onSelectParent);
   }
@@ -450,9 +490,9 @@ function handleDesignHotkey(
     return run(props.onDelete);
   }
 
-  // Current Figma: Cmd+Backspace ungroups. This intentionally differs from
-  // the historical Shift+Cmd+G binding and must be checked after plain
-  // Backspace deletion has been ruled out.
+  // Current Figma: Cmd+Backspace ungroups. Checked after plain Backspace
+  // deletion has been ruled out. Shift+Cmd+G (below, in the Cmd+G family) is
+  // a second, equally-supported binding for the same onUngroup handler.
   if (primary && !event.altKey && !event.shiftKey && key === "Backspace") {
     return run(props.onUngroup);
   }
@@ -476,7 +516,16 @@ function handleDesignHotkey(
   if (primary && !event.altKey && !event.shiftKey && key === "a") {
     return run(props.onSelectAll);
   }
+  // Figma's Cmd+Shift+X — toggle strikethrough. Must be checked before plain
+  // Cmd+X (cut) below, since that check doesn't itself gate on shiftKey.
+  if (primary && event.shiftKey && key === "x") {
+    return run(props.onToggleStrikethrough);
+  }
   if (primary && key === "x") return run(props.onCut);
+  // Figma's Cmd+U — toggle underline. No existing binding claims plain "u".
+  if (primary && !event.altKey && !event.shiftKey && key === "u") {
+    return run(props.onToggleUnderline);
+  }
 
   // Current Figma: Ctrl+Alt+H / Ctrl+Alt+V — distribute evenly. These use
   // literal Control even on macOS, so resolve them before the primary+V
@@ -527,11 +576,14 @@ function handleDesignHotkey(
     return run(props.onToggleLocked);
   }
   if (primary && key === "g") {
-    // Figma: ⌥⌘G is "Frame selection". Current Figma ungroups with
-    // Cmd+Backspace, so the historical Shift+Cmd+G binding is deliberately
-    // left unhandled.
+    // Figma: ⌥⌘G is "Frame selection". Current Figma's primary ungroup chord
+    // is Cmd+Backspace (see below), but Shift+Cmd+G is the long-standing
+    // historical ungroup binding and the app's own context-menu "Ungroup"
+    // item performs the identical action (handleUngroupSelection) — leaving
+    // this chord dead while the menu item works is a regression users hit,
+    // not an intentional gap. Support both bindings for ungroup.
     if (event.altKey) return run(props.onFrameSelection);
-    if (event.shiftKey) return false;
+    if (event.shiftKey) return run(props.onUngroup);
     return run(props.onGroup);
   }
 
@@ -563,6 +615,11 @@ function handleDesignHotkey(
     return run(props.onCreateComponent);
   }
 
+  // Figma's Cmd+Alt+B — Detach instance.
+  if (primary && event.altKey && key === "b") {
+    return run(props.onDetachInstance);
+  }
+
   const digit = digitFromEvent(event);
   // Figma navigation tabs use literal Option/Alt, on both platforms. Resolve
   // these before digit opacity so the physical Digit1/Digit2 keys never leak

package/corpus/templates/design/app/i18n/zh-TW.ts

@@ -1,3 +1,9 @@
+import {
+  attachLocalizedKeyboardShortcuts,
+  keyboardKeyLabels,
+  keyboardShortcutLabels,
+} from "../i18n-keyboard-shortcuts";
+
 const messages = {
   root: {
     commandActions: "操作",
@@ -256,6 +262,22 @@ const messages = {
       right: "正確的",
       justify: "證明合法",
     },
+    textDecorations: {
+      underline: "底線",
+      strikethrough: "刪除線",
+    },
+    textCases: {
+      none: "無",
+      uppercase: "大寫",
+      lowercase: "小寫",
+      capitalize: "單字首字母大寫",
+    },
+    typographyDetails: {
+      basicsTab: "基本",
+      detailsTab: "詳細資料",
+      decorationLabel: "文字裝飾",
+      caseLabel: "大小寫",
+    },
     flexDirections: {
       row: "排",
       column: "柱子",
@@ -322,6 +344,41 @@ const messages = {
   },
   designEditor: {
     askAgent: "詢問代理",
+    componentInstances: {
+      selectLayer: "選取圖層",
+      goToMain: "前往主要元件",
+      swap: "交換實例",
+      detach: "卸離實例",
+      searchComponents: "搜尋元件…",
+      loading: "載入中…",
+      noOtherComponents: "找不到其他元件",
+      goToMainUnavailable: "目前無法前往主要元件。",
+      onlyKnownInstance: "這是此元件唯一已知的實例。",
+      resolveMainFailed: "無法解析主要元件。",
+      detachFailed: "無法卸離此實例。",
+      detached: "實例已卸離。",
+      swapFailed: "無法交換此實例。",
+      swappedFor: "已交換為「{{name}}」。",
+      openPanelNudge: "請使用「元件」面板中的「交換實例」選擇器。",
+      openPanelFailed: "無法開啟元件面板。",
+    },
+    makeItRealCard: {
+      open: "開啟",
+      choose: "選擇",
+      connect: "連接",
+      generating: "生成中",
+      generate: "生成",
+      migrationFailed: "遷移失敗，請再試一次。",
+    },
+    componentProps: {
+      alpineTooComplexToEdit:
+        "無法安全地就地編輯此屬性——此元件的 Alpine 狀態過於複雜。請改為編輯原始碼。",
+      label: "屬性",
+    },
+    componentSource: {
+      editSource: "編輯元件原始碼",
+      needsConnectedApp: "跳轉原始碼需要連接應用程式",
+    },
     breakpointBar: {
       base: "基礎",
       editBaseWidth: "編輯基礎寬度",
@@ -427,6 +484,11 @@ const messages = {
       figmaPasteDescription:
         "在 Figma 複製畫框或圖層，然後貼到 Design 畫布。Design 會匯入可見的剪貼簿 HTML。",
       figmaPasteTarget: "貼到畫布",
+      figmaPasteApiKeyHint: "連結您的 Figma 存取權杖以取得精確的節點匯入。",
+      figmaPasteMatchGuidance:
+        "無法比對到特定的 Figma 節點。請改貼上畫框連結以進行精確匯入。",
+      figmaPasteRestLabel: "透過 Figma API 匯入",
+      figmaPasteHtmlLabel: "從剪貼簿預覽匯入",
       figUploadTitle: "上傳 .fig",
       figUploadDescription:
         "只匯出需要的畫框。含有許多嵌入圖片的大型檔案可能超過匯入限制。",
@@ -648,6 +710,12 @@ const messages = {
       openScreenSvg: "匯出 SVG 前請先開啟一個螢幕",
       svgDownloaded: "SVG 已下載",
       svgExportError: "無法匯出 SVG",
+      figmaSvgCopied: "已複製為 Figma SVG",
+      figmaSvgUnsupported: "此瀏覽器無法將 SVG 圖像複製到剪貼簿",
+      figmaSvgBlocked: "請允許存取剪貼簿以複製此 SVG",
+      figmaSvgWriteError: "無法將 SVG 複製到剪貼簿",
+      figmaSvgRenderError: "無法建立 Figma SVG",
+      figmaSvgExportError: "無法匯出 Figma SVG",
       screenDuplicated: "畫面已複製",
       screenDuplicateError: "無法複製畫面",
       copied: "已複製",
@@ -665,6 +733,8 @@ const messages = {
       undoSkippedConcurrentEdit: "已略過復原 — 其他人移動了該項目",
       redoSkippedConcurrentEdit: "已略過重做 — 其他人移動了該項目",
       autoLayoutScreensUnsupported: "新增自動布局不適用於畫面",
+      reactSourceAnchorsLoading:
+        "React 原始碼錨點仍在載入中。請等本機應用程式完成渲染後再試一次。",
     },
   },
   layersPanel: {
@@ -701,6 +771,14 @@ const messages = {
     frameSelection: "將選取範圍建立畫框",
     flipHorizontal: "水平翻轉",
     flipVertical: "垂直翻轉",
+    dragGhostCount: "{{count}} 個圖層",
+  },
+  designCanvas: {
+    localBridge: {
+      confirmationRetryExhausted: "多次嘗試後，即時編輯器橋接器仍未確認連線。",
+      connectionNotConfirmed:
+        "即時編輯器橋接器未確認連線。本機開發伺服器是否仍在執行？",
+    },
   },
   multiScreenCanvas: {
     duplicate: "複製",
@@ -756,6 +834,8 @@ const messages = {
     assetsNoImageUrl: "Assets 未回傳圖片 URL。",
     assetAdded: "新增資產",
     failedToUploadFile: "上傳檔案失敗",
+    failedToSubmitPrompt: "無法提交提示",
+    skipPrompt: "略過提示",
     designSystem: "Design系統",
     noDesignSystem: "沒有設計系統",
     newDesignSystem: "新",
@@ -784,8 +864,11 @@ const messages = {
     offline: "離線",
     saving: "儲存...",
     clearedAllAnnotations: "已清除所有批注",
+    annotationsDiscardedOnViewChange:
+      "離開此檢視畫面時，{{count}} 則未傳送的批注已被捨棄。",
     undo: "復原",
     send: "傳送",
+    sendingDrawing: "正在傳送…",
     commentSent: "評論已傳送",
     comment: "評論",
     annotationQueue: "註記佇列",
@@ -799,6 +882,9 @@ const messages = {
     nearText: "靠近「{{text}}」",
     submitShortcut: "{{mod}}+Enter 送出",
     queue: "排隊",
+    queuedCommentsDiscarded:
+      "{{count}} 個未傳送的評論草稿已在你離開此檢視時捨棄。",
+    staleAnchorDetail: "在畫布上已找不到原始元素。",
     pinStatus: {
       deterministic: {
         label: "確定性",
@@ -1085,4 +1171,8 @@ const messages = {
   },
 };
 
-export default messages;
+export default attachLocalizedKeyboardShortcuts(
+  messages,
+  keyboardShortcutLabels["zh-TW"],
+  keyboardKeyLabels["zh-TW"],
+);