@agent-native/core 0.79.27 → 0.80.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (497) hide show
  1. package/corpus/README.md +2 -2
  2. package/corpus/core/CHANGELOG.md +34 -0
  3. package/corpus/core/docs/content/locales/ar-SA/skills-guide.mdx +5 -0
  4. package/corpus/core/docs/content/locales/ar-SA/template-design.mdx +55 -1
  5. package/corpus/core/docs/content/locales/de-DE/skills-guide.mdx +5 -0
  6. package/corpus/core/docs/content/locales/de-DE/template-design.mdx +66 -1
  7. package/corpus/core/docs/content/locales/es-ES/skills-guide.mdx +5 -0
  8. package/corpus/core/docs/content/locales/es-ES/template-design.mdx +65 -1
  9. package/corpus/core/docs/content/locales/fr-FR/skills-guide.mdx +5 -0
  10. package/corpus/core/docs/content/locales/fr-FR/template-design.mdx +64 -1
  11. package/corpus/core/docs/content/locales/hi-IN/skills-guide.mdx +5 -0
  12. package/corpus/core/docs/content/locales/hi-IN/template-design.mdx +59 -1
  13. package/corpus/core/docs/content/locales/ja-JP/skills-guide.mdx +5 -0
  14. package/corpus/core/docs/content/locales/ja-JP/template-design.mdx +62 -1
  15. package/corpus/core/docs/content/locales/ko-KR/skills-guide.mdx +5 -0
  16. package/corpus/core/docs/content/locales/ko-KR/template-design.mdx +58 -1
  17. package/corpus/core/docs/content/locales/pt-BR/skills-guide.mdx +5 -0
  18. package/corpus/core/docs/content/locales/pt-BR/template-design.mdx +62 -1
  19. package/corpus/core/docs/content/locales/zh-CN/skills-guide.mdx +5 -0
  20. package/corpus/core/docs/content/locales/zh-CN/template-design.mdx +50 -1
  21. package/corpus/core/docs/content/locales/zh-TW/skills-guide.mdx +5 -0
  22. package/corpus/core/docs/content/locales/zh-TW/template-design.mdx +52 -1
  23. package/corpus/core/docs/content/skills-guide.mdx +5 -0
  24. package/corpus/core/docs/content/template-design.mdx +59 -1
  25. package/corpus/core/package.json +2 -1
  26. package/corpus/core/src/agent/engine/index.ts +1 -0
  27. package/corpus/core/src/agent/engine/registry.ts +40 -0
  28. package/corpus/core/src/agent/production-agent.ts +6 -2
  29. package/corpus/core/src/application-state/handlers.ts +1 -1
  30. package/corpus/core/src/brand-kit/index.ts +1 -1
  31. package/corpus/core/src/cli/design-connect.ts +490 -0
  32. package/corpus/core/src/cli/index.ts +16 -0
  33. package/corpus/core/src/cli/skills.ts +144 -3
  34. package/corpus/core/src/client/AgentPanel.tsx +1 -1
  35. package/corpus/core/src/client/AssistantChat.tsx +43 -7
  36. package/corpus/core/src/client/MultiTabAssistantChat.tsx +1 -1
  37. package/corpus/core/src/client/agent-chat.ts +27 -3
  38. package/corpus/core/src/client/blocks/library/MermaidBlock.tsx +1 -1
  39. package/corpus/core/src/client/blocks/library/diagram.tsx +2 -2
  40. package/corpus/core/src/client/blocks/library/wireframe.tsx +1 -1
  41. package/corpus/core/src/client/chat/message-components.tsx +1 -1
  42. package/corpus/core/src/client/chat-model-groups.ts +1 -2
  43. package/corpus/core/src/client/components/LiveCursorOverlay.tsx +33 -66
  44. package/corpus/core/src/client/composer/TiptapComposer.tsx +99 -24
  45. package/corpus/core/src/client/composer/useVoiceDictation.ts +429 -260
  46. package/corpus/core/src/client/extensions/portable-extension.ts +1 -1
  47. package/corpus/core/src/client/frame-protocol.ts +17 -2
  48. package/corpus/core/src/client/rich-markdown-editor/RegistryBlockNode.tsx +2 -2
  49. package/corpus/core/src/client/sharing/ShareButton.tsx +20 -15
  50. package/corpus/core/src/client/use-agent-engine-configured.ts +80 -28
  51. package/corpus/core/src/code-agents/transcript-normalizer.ts +1 -1
  52. package/corpus/core/src/extensions/path.ts +1 -4
  53. package/corpus/core/src/integrations/a2a-continuation-processor.ts +1 -1
  54. package/corpus/core/src/mcp/build-server.ts +1 -1
  55. package/corpus/core/src/org/handlers.ts +5 -5
  56. package/corpus/core/src/org/plugin.ts +2 -2
  57. package/corpus/core/src/scripts/call-agent.ts +1 -1
  58. package/corpus/core/src/scripts/db/safety.ts +1 -1
  59. package/corpus/core/src/server/auth.ts +3 -0
  60. package/corpus/core/src/server/builder-design-systems.ts +308 -0
  61. package/corpus/core/src/server/core-routes-plugin.ts +29 -3
  62. package/corpus/core/src/server/index.ts +8 -0
  63. package/corpus/core/src/server/transcribe-voice.ts +57 -22
  64. package/corpus/core/src/shared/mcp-embed-headers.ts +23 -1
  65. package/corpus/core/src/styles/agent-native.css +60 -4
  66. package/corpus/core/src/templates/workspace-core/.agents/skills/voice-transcription/SKILL.md +10 -0
  67. package/corpus/core/src/usage/store.ts +2 -2
  68. package/corpus/core/src/vite/client.ts +2 -0
  69. package/corpus/core/src/voice/index.ts +18 -0
  70. package/corpus/core/src/voice/voice-cleanup-prompt.ts +38 -0
  71. package/corpus/core/src/voice/voice-context.ts +217 -0
  72. package/corpus/core/src/voice/voice-replacements.ts +75 -0
  73. package/corpus/templates/analytics/AGENTS.md +4 -3
  74. package/corpus/templates/analytics/actions/dashboard-mutation-api.ts +298 -15
  75. package/corpus/templates/analytics/actions/get-sql-dashboard.ts +9 -4
  76. package/corpus/templates/analytics/actions/list-session-recordings.ts +6 -1
  77. package/corpus/templates/analytics/actions/mutate-dashboard.ts +18 -2
  78. package/corpus/templates/analytics/actions/query-agent-native-analytics.ts +12 -2
  79. package/corpus/templates/analytics/app/components/layout/Sidebar.tsx +557 -400
  80. package/corpus/templates/analytics/app/global.css +0 -4
  81. package/corpus/templates/analytics/app/hooks/use-replay-storage-status.ts +66 -0
  82. package/corpus/templates/analytics/app/i18n/zh-TW.ts +39 -0
  83. package/corpus/templates/analytics/app/i18n-data.ts +424 -0
  84. package/corpus/templates/analytics/app/pages/Settings.tsx +333 -0
  85. package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/PanelEditorDialog.tsx +2 -1
  86. package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/dashboard-layout.ts +121 -3
  87. package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/index.tsx +82 -34
  88. package/corpus/templates/analytics/app/pages/sessions/SessionDetailPage.tsx +7 -0
  89. package/corpus/templates/analytics/app/pages/sessions/SessionsPage.tsx +144 -36
  90. package/corpus/templates/analytics/changelog/2026-06-28-ask-tab-now-matches-the-darker-app-background.md +6 -0
  91. package/corpus/templates/analytics/changelog/2026-06-28-dashboard-email-reports-now-use-cleaner-light-mode-snapshots.md +6 -0
  92. package/corpus/templates/analytics/changelog/2026-06-28-left-sidebar-collapses-into-an-animated-icon-rail.md +6 -0
  93. package/corpus/templates/analytics/changelog/2026-06-28-sessions-now-show-only-signed-in-recordings-with-playable-re.md +6 -0
  94. package/corpus/templates/analytics/changelog/2026-06-29-analytics-agents-can-now-place-new-charts-into-requested-das.md +6 -0
  95. package/corpus/templates/analytics/changelog/2026-06-29-analytics-queries-now-report-failed-source-query-errors-inst.md +6 -0
  96. package/corpus/templates/analytics/changelog/2026-06-29-charts-can-now-be-dropped-between-full-dashboard-rows-to-cre.md +6 -0
  97. package/corpus/templates/analytics/changelog/2026-06-29-dashboard-email-reports-include-the-full-dashboard-image-wit.md +6 -0
  98. package/corpus/templates/analytics/changelog/2026-06-29-main-surface-border-reaches-the-top.md +6 -0
  99. package/corpus/templates/analytics/changelog/2026-06-29-session-replay-now-records-playable-sessions-in-production-a.md +6 -0
  100. package/corpus/templates/analytics/changelog/2026-06-29-set-up-session-replay-storage-from-settings-connect-builder-.md +6 -0
  101. package/corpus/templates/analytics/scripts/cleanup-empty-session-recordings.ts +102 -0
  102. package/corpus/templates/analytics/seeds/dashboards/agent-native-templates-first-party.json +3 -3
  103. package/corpus/templates/analytics/server/lib/dashboard-report.ts +75 -30
  104. package/corpus/templates/analytics/server/lib/first-party-metric-catalog.ts +5 -2
  105. package/corpus/templates/analytics/server/lib/real-data-actions.ts +81 -20
  106. package/corpus/templates/analytics/server/lib/replay-storage.ts +79 -0
  107. package/corpus/templates/analytics/server/lib/s3-upload-provider.ts +255 -0
  108. package/corpus/templates/analytics/server/lib/session-replay.ts +53 -12
  109. package/corpus/templates/analytics/server/plugins/agent-chat.ts +11 -2
  110. package/corpus/templates/analytics/server/plugins/onboarding.ts +97 -0
  111. package/corpus/templates/assets/app/components/layout/Sidebar.tsx +4 -4
  112. package/corpus/templates/assets/changelog/2026-06-28-left-sidebar-collapse-motion-and-footer-chrome-are-quieter.md +6 -0
  113. package/corpus/templates/brain/app/components/layout/Layout.tsx +29 -2
  114. package/corpus/templates/brain/app/components/layout/Sidebar.tsx +131 -42
  115. package/corpus/templates/brain/app/i18n/zh-TW.ts +2 -0
  116. package/corpus/templates/brain/app/i18n-data.ts +20 -0
  117. package/corpus/templates/brain/changelog/2026-06-28-left-sidebar-collapses-into-an-animated-icon-rail.md +6 -0
  118. package/corpus/templates/calendar/app/components/layout/AppLayout.tsx +29 -1
  119. package/corpus/templates/calendar/app/components/layout/Sidebar.tsx +417 -299
  120. package/corpus/templates/calendar/app/i18n/zh-TW.ts +2 -0
  121. package/corpus/templates/calendar/app/i18n-data.ts +20 -0
  122. package/corpus/templates/calendar/changelog/2026-06-28-left-sidebar-collapses-into-an-animated-icon-rail.md +6 -0
  123. package/corpus/templates/chat/app/components/layout/Sidebar.tsx +6 -19
  124. package/corpus/templates/chat/changelog/2026-06-28-left-sidebar-collapse-motion-and-footer-chrome-are-quieter.md +6 -0
  125. package/corpus/templates/clips/AGENTS.md +4 -0
  126. package/corpus/templates/clips/actions/cleanup-transcript.ts +39 -9
  127. package/corpus/templates/clips/actions/finalize-meeting.ts +81 -12
  128. package/corpus/templates/clips/actions/lib/agents-md-context.ts +4 -1
  129. package/corpus/templates/clips/app/components/library/library-layout.tsx +3 -3
  130. package/corpus/templates/clips/app/components/meetings/share-meeting-dialog.tsx +1 -1
  131. package/corpus/templates/clips/app/components/player/share-dialog.tsx +2 -2
  132. package/corpus/templates/clips/changelog/2026-06-28-left-sidebar-footer-controls-use-less-divider-chrome.md +6 -0
  133. package/corpus/templates/clips/desktop/src/lib/personal-vocabulary.ts +13 -8
  134. package/corpus/templates/clips/desktop/src/lib/recorder.ts +24 -0
  135. package/corpus/templates/clips/desktop/src/lib/transcription-capture.ts +105 -5
  136. package/corpus/templates/clips/desktop/src/lib/voice-dictation.ts +60 -1
  137. package/corpus/templates/content/actions/set-image-alt-text.ts +1 -1
  138. package/corpus/templates/content/app/components/editor/DocumentDatabase.tsx +1 -1
  139. package/corpus/templates/content/app/components/editor/database/DatabaseView.tsx +1 -1
  140. package/corpus/templates/content/app/components/sidebar/DocumentSidebar.tsx +5 -5
  141. package/corpus/templates/content/changelog/2026-06-28-left-sidebar-collapse-motion-and-footer-chrome-are-quieter.md +6 -0
  142. package/corpus/templates/content/shared/document-export.ts +1 -1
  143. package/corpus/templates/design/.agents/skills/design-systems/SKILL.md +8 -18
  144. package/corpus/templates/design/.agents/skills/visual-edit/SKILL.md +154 -0
  145. package/corpus/templates/design/AGENTS.md +95 -5
  146. package/corpus/templates/design/DESIGN.md +82 -0
  147. package/corpus/templates/design/DEVELOPING.md +43 -0
  148. package/corpus/templates/design/actions/add-localhost-screens.ts +453 -0
  149. package/corpus/templates/design/actions/apply-shader.ts +277 -0
  150. package/corpus/templates/design/actions/apply-visual-edit.ts +303 -0
  151. package/corpus/templates/design/actions/connect-localhost.ts +183 -0
  152. package/corpus/templates/design/actions/edit-design.ts +195 -42
  153. package/corpus/templates/design/actions/generate-design.ts +71 -1
  154. package/corpus/templates/design/actions/generate-screens.ts +193 -0
  155. package/corpus/templates/design/actions/get-code-layer-projection.ts +191 -0
  156. package/corpus/templates/design/actions/get-shader.ts +119 -0
  157. package/corpus/templates/design/actions/index-design-system-with-builder.ts +259 -0
  158. package/corpus/templates/design/actions/list-localhost-connections.ts +95 -0
  159. package/corpus/templates/design/actions/navigate.ts +55 -2
  160. package/corpus/templates/design/actions/update-file.ts +9 -2
  161. package/corpus/templates/design/actions/view-screen.ts +68 -1
  162. package/corpus/templates/design/agent-native.app-skill.json +10 -0
  163. package/corpus/templates/design/app/components/design/CanvasContextMenu.tsx +719 -0
  164. package/corpus/templates/design/app/components/design/DesignCanvas.tsx +2120 -103
  165. package/corpus/templates/design/app/components/design/DesignEditorSkeleton.tsx +74 -38
  166. package/corpus/templates/design/app/components/design/DesignExtensionsPanel.tsx +401 -0
  167. package/corpus/templates/design/app/components/design/EditPanel.tsx +3966 -440
  168. package/corpus/templates/design/app/components/design/LayersPanel.tsx +1473 -0
  169. package/corpus/templates/design/app/components/design/MultiScreenCanvas.tsx +3940 -147
  170. package/corpus/templates/design/app/components/design/QuestionFlow.tsx +700 -13
  171. package/corpus/templates/design/app/components/design/TweaksPanel.tsx +105 -63
  172. package/corpus/templates/design/app/components/design/index.ts +0 -5
  173. package/corpus/templates/design/app/components/design/inspector/AlignmentMatrix.tsx +353 -0
  174. package/corpus/templates/design/app/components/design/inspector/AutoLayoutMatrix.tsx +1589 -0
  175. package/corpus/templates/design/app/components/design/inspector/ConstraintsWidget.tsx +511 -0
  176. package/corpus/templates/design/app/components/design/inspector/ExportSettingsPanel.tsx +395 -0
  177. package/corpus/templates/design/app/components/design/inspector/FigmaColorPicker.tsx +2010 -0
  178. package/corpus/templates/design/app/components/design/inspector/GradientEditor.tsx +601 -0
  179. package/corpus/templates/design/app/components/design/inspector/ImageFillControls.tsx +242 -0
  180. package/corpus/templates/design/app/components/design/inspector/SHADER_INTEGRATION.md +420 -0
  181. package/corpus/templates/design/app/components/design/inspector/ScrubInput.tsx +238 -0
  182. package/corpus/templates/design/app/components/design/inspector/ShaderControls.stories.tsx +71 -0
  183. package/corpus/templates/design/app/components/design/inspector/ShaderControls.tsx +575 -0
  184. package/corpus/templates/design/app/components/design/inspector/ShaderEffectRow.tsx +106 -0
  185. package/corpus/templates/design/app/components/design/inspector/ShaderFillsPanel.tsx +423 -0
  186. package/corpus/templates/design/app/components/design/inspector/figma-icons.tsx +741 -0
  187. package/corpus/templates/design/app/components/design/inspector/index.ts +87 -0
  188. package/corpus/templates/design/app/components/design/inspector/scrub-input-utils.ts +201 -0
  189. package/corpus/templates/design/app/components/design/types.ts +23 -0
  190. package/corpus/templates/design/app/components/layout/Layout.tsx +24 -13
  191. package/corpus/templates/design/app/components/layout/Sidebar.tsx +4 -4
  192. package/corpus/templates/design/app/components/visual-editor/CanvasCommentPins.tsx +474 -36
  193. package/corpus/templates/design/app/components/visual-editor/DrawOverlay.tsx +22 -5
  194. package/corpus/templates/design/app/components/visual-editor/SaveStatusIndicator.tsx +24 -11
  195. package/corpus/templates/design/app/global.css +149 -5
  196. package/corpus/templates/design/app/hooks/use-agent-generating.ts +4 -0
  197. package/corpus/templates/design/app/hooks/use-navigation-state.ts +130 -8
  198. package/corpus/templates/design/app/hooks/useDesignHotkeys.ts +329 -0
  199. package/corpus/templates/design/app/i18n/zh-TW.ts +277 -0
  200. package/corpus/templates/design/app/i18n-data.ts +3028 -1
  201. package/corpus/templates/design/app/pages/DesignEditor.tsx +5831 -904
  202. package/corpus/templates/design/app/pages/DesignSystemSetup.tsx +57 -221
  203. package/corpus/templates/design/changelog/2026-06-28-annotate-mode-now-combines-drawing-and-comment-pins-in-one-c.md +6 -0
  204. package/corpus/templates/design/changelog/2026-06-28-design-editor-panel-borders-are-cleaner-so-the-canvas-edge-s.md +6 -0
  205. package/corpus/templates/design/changelog/2026-06-28-drawing-prompts-now-reliably-open-and-submit-to-the-design-a.md +6 -0
  206. package/corpus/templates/design/changelog/2026-06-28-editor-app-menus-now-use-an-outline-agent-native-mark-with-b.md +6 -0
  207. package/corpus/templates/design/changelog/2026-06-28-figma-style-code-design-mode.md +6 -0
  208. package/corpus/templates/design/changelog/2026-06-28-layer-selection-now-updates-chat-context-without-opening-the.md +6 -0
  209. package/corpus/templates/design/changelog/2026-06-28-layer-selections-now-preserve-hidden-and-locked-canvas-state.md +6 -0
  210. package/corpus/templates/design/changelog/2026-06-28-left-sidebar-collapse-motion-and-footer-chrome-are-quieter.md +6 -0
  211. package/corpus/templates/design/changelog/2026-06-28-live-cursors-now-keep-names-beside-a-cleaner-pointer-marker.md +6 -0
  212. package/corpus/templates/design/changelog/2026-06-28-mode-switching-now-lives-in-a-compact-bottom-right-icon-dock.md +6 -0
  213. package/corpus/templates/design/changelog/2026-06-28-screen-overview-now-handles-zooming-drawing-opening-and-dele.md +6 -0
  214. package/corpus/templates/design/changelog/2026-06-28-screen-overview-now-selects-screens-on-click-and-opens-them-.md +6 -0
  215. package/corpus/templates/design/changelog/2026-06-28-screen-overview-zooms-into-the-active-screen-with-smoother-e.md +6 -0
  216. package/corpus/templates/design/changelog/2026-06-28-selected-element-chips-in-chat-are-shorter-and-easier-to-sca.md +6 -0
  217. package/corpus/templates/design/changelog/2026-06-28-the-design-editor-toolbar-is-more-compact-and-the-app-menu-m.md +6 -0
  218. package/corpus/templates/design/changelog/2026-06-28-tweaks-now-live-at-the-top-of-the-design-sidebar-instead-of-.md +6 -0
  219. package/corpus/templates/design/changelog/2026-06-28-tweaks-now-live-in-the-right-inspector-beside-the-design-tab.md +6 -0
  220. package/corpus/templates/design/changelog/2026-06-29-active-sidebar-rows-use-soft-highlights.md +6 -0
  221. package/corpus/templates/design/changelog/2026-06-29-agents-can-now-open-screen-overview-focus-screens-and-add.md +6 -0
  222. package/corpus/templates/design/changelog/2026-06-29-canvas-selection-no-longer-flashes-broken-prototype-html-whe.md +6 -0
  223. package/corpus/templates/design/changelog/2026-06-29-command-menu-selections-are-clearer-in-dark-mode.md +6 -0
  224. package/corpus/templates/design/changelog/2026-06-29-design-agents-now-edit-broad-copy-changes-more-reliably.md +6 -0
  225. package/corpus/templates/design/changelog/2026-06-29-design-editor-extensions-now-run-inline-beside-the-artboard.md +6 -0
  226. package/corpus/templates/design/changelog/2026-06-29-design-mode-top-chrome-now-groups-collaborators-preview-shar.md +6 -0
  227. package/corpus/templates/design/changelog/2026-06-29-element-selection-now-stays-on-the-intended-layer-after-sele.md +6 -0
  228. package/corpus/templates/design/changelog/2026-06-29-screen-overview-full-view-controls-now-sit-above-frames-inst.md +6 -0
  229. package/corpus/templates/design/changelog/2026-06-29-screen-overview-tools-can-draw-shapes-create-screens-and-kee.md +6 -0
  230. package/corpus/templates/design/changelog/2026-06-29-sidebars-use-darker-chrome-and-chat-warns-immediately.md +6 -0
  231. package/corpus/templates/design/changelog/2026-06-29-the-pen-tool-now-creates-anchor-based-bezier-vectors-with-ha.md +6 -0
  232. package/corpus/templates/design/changelog/2026-06-29-visual-edit-can-open-localhost-routes-as-url-backed-screens.md +6 -0
  233. package/corpus/templates/design/package.json +1 -0
  234. package/corpus/templates/design/server/db/schema.ts +26 -0
  235. package/corpus/templates/design/server/handlers/import-figma-system.ts +38 -85
  236. package/corpus/templates/design/server/lib/design-snapshot.ts +9 -1
  237. package/corpus/templates/design/server/plugins/agent-chat.ts +3 -0
  238. package/corpus/templates/design/shared/api.ts +27 -0
  239. package/corpus/templates/design/shared/canvas-frames.ts +103 -0
  240. package/corpus/templates/design/shared/canvas-math.ts +1058 -0
  241. package/corpus/templates/design/shared/code-layer.ts +2412 -0
  242. package/corpus/templates/design/shared/color-utils.ts +180 -0
  243. package/corpus/templates/design/shared/generation-session.ts +61 -0
  244. package/corpus/templates/design/shared/html-content.ts +21 -0
  245. package/corpus/templates/design/shared/pen-path.ts +207 -0
  246. package/corpus/templates/design/shared/shader-presets.ts +782 -0
  247. package/corpus/templates/design/shared/shader-safety.ts +137 -0
  248. package/corpus/templates/design/shared/source-mode.ts +237 -0
  249. package/corpus/templates/forms/app/components/layout/Sidebar.tsx +149 -6
  250. package/corpus/templates/forms/app/i18n/ar-SA.ts +2 -0
  251. package/corpus/templates/forms/app/i18n/de-DE.ts +2 -0
  252. package/corpus/templates/forms/app/i18n/en-US.ts +2 -0
  253. package/corpus/templates/forms/app/i18n/es-ES.ts +2 -0
  254. package/corpus/templates/forms/app/i18n/fr-FR.ts +2 -0
  255. package/corpus/templates/forms/app/i18n/hi-IN.ts +2 -0
  256. package/corpus/templates/forms/app/i18n/ja-JP.ts +2 -0
  257. package/corpus/templates/forms/app/i18n/ko-KR.ts +2 -0
  258. package/corpus/templates/forms/app/i18n/pt-BR.ts +2 -0
  259. package/corpus/templates/forms/app/i18n/zh-CN.ts +2 -0
  260. package/corpus/templates/forms/app/i18n/zh-TW.ts +2 -0
  261. package/corpus/templates/forms/changelog/2026-06-28-left-sidebar-collapses-into-an-animated-icon-rail.md +6 -0
  262. package/corpus/templates/macros/app/components/layout/AppLayout.tsx +2 -2
  263. package/corpus/templates/macros/changelog/2026-06-28-left-sidebar-footer-controls-use-less-divider-chrome.md +6 -0
  264. package/corpus/templates/mail/app/components/layout/AppLayout.tsx +408 -247
  265. package/corpus/templates/mail/app/i18n/ar-SA.ts +4 -0
  266. package/corpus/templates/mail/app/i18n/de-DE.ts +4 -0
  267. package/corpus/templates/mail/app/i18n/en-US.ts +4 -0
  268. package/corpus/templates/mail/app/i18n/es-ES.ts +4 -0
  269. package/corpus/templates/mail/app/i18n/fr-FR.ts +4 -0
  270. package/corpus/templates/mail/app/i18n/hi-IN.ts +4 -0
  271. package/corpus/templates/mail/app/i18n/ja-JP.ts +4 -0
  272. package/corpus/templates/mail/app/i18n/ko-KR.ts +4 -0
  273. package/corpus/templates/mail/app/i18n/pt-BR.ts +4 -0
  274. package/corpus/templates/mail/app/i18n/zh-CN.ts +4 -0
  275. package/corpus/templates/mail/app/i18n/zh-TW.ts +4 -0
  276. package/corpus/templates/mail/app/lib/utils.ts +2 -2
  277. package/corpus/templates/mail/changelog/2026-06-28-pinned-sidebar-collapses-into-an-animated-icon-rail.md +6 -0
  278. package/corpus/templates/plan/app/components/layout/Sidebar.tsx +6 -8
  279. package/corpus/templates/plan/app/components/plan/wireframe/Wireframe.tsx +1 -1
  280. package/corpus/templates/plan/app/global.css +61 -78
  281. package/corpus/templates/plan/app/pages/PlansPage.tsx +8 -0
  282. package/corpus/templates/plan/changelog/2026-06-28-left-sidebar-collapse-motion-and-footer-chrome-are-quieter.md +6 -0
  283. package/corpus/templates/plan/changelog/2026-06-28-plans-use-the-shared-neutral-light-and-dark-theme.md +6 -0
  284. package/corpus/templates/plan/changelog/2026-06-28-sending-open-feedback-from-a-plan-now-opens-the-inline-plan-.md +6 -0
  285. package/corpus/templates/slides/.agents/skills/design-systems/SKILL.md +9 -10
  286. package/corpus/templates/slides/AGENTS.md +3 -2
  287. package/corpus/templates/slides/actions/import-file.ts +26 -17
  288. package/corpus/templates/slides/actions/index-design-system-with-builder.ts +259 -0
  289. package/corpus/templates/slides/app/components/design-system/DesignSystemSetup.tsx +35 -167
  290. package/corpus/templates/slides/app/components/design-system/fig-import-response.ts +9 -13
  291. package/corpus/templates/slides/app/components/layout/Sidebar.tsx +5 -5
  292. package/corpus/templates/slides/app/context/DeckContext.tsx +1 -1
  293. package/corpus/templates/slides/app/i18n/ar-SA.ts +9 -37
  294. package/corpus/templates/slides/app/i18n/de-DE.ts +10 -25
  295. package/corpus/templates/slides/app/i18n/en-US.ts +9 -26
  296. package/corpus/templates/slides/app/i18n/es-ES.ts +10 -28
  297. package/corpus/templates/slides/app/i18n/fr-FR.ts +10 -28
  298. package/corpus/templates/slides/app/i18n/hi-IN.ts +9 -26
  299. package/corpus/templates/slides/app/i18n/ja-JP.ts +10 -22
  300. package/corpus/templates/slides/app/i18n/ko-KR.ts +9 -23
  301. package/corpus/templates/slides/app/i18n/pt-BR.ts +10 -28
  302. package/corpus/templates/slides/app/i18n/zh-CN.ts +9 -22
  303. package/corpus/templates/slides/app/i18n/zh-TW.ts +9 -22
  304. package/corpus/templates/slides/changelog/2026-06-28-left-sidebar-collapse-motion-and-footer-chrome-are-quieter.md +6 -0
  305. package/corpus/templates/slides/server/handlers/import-figma-system.ts +44 -12
  306. package/corpus/templates/slides/server/lib/chat-attachments.ts +1 -1
  307. package/corpus/templates/videos/app/components/NewCompositionPopover.tsx +1 -1
  308. package/corpus/templates/videos/app/components/Sidebar.tsx +2 -2
  309. package/corpus/templates/videos/app/components/layout/Layout.tsx +29 -2
  310. package/corpus/templates/videos/app/components/layout/NavSidebar.tsx +113 -30
  311. package/corpus/templates/videos/app/i18n/ar-SA.ts +2 -0
  312. package/corpus/templates/videos/app/i18n/de-DE.ts +2 -0
  313. package/corpus/templates/videos/app/i18n/en-US.ts +2 -0
  314. package/corpus/templates/videos/app/i18n/es-ES.ts +2 -0
  315. package/corpus/templates/videos/app/i18n/fr-FR.ts +2 -0
  316. package/corpus/templates/videos/app/i18n/hi-IN.ts +2 -0
  317. package/corpus/templates/videos/app/i18n/ja-JP.ts +2 -0
  318. package/corpus/templates/videos/app/i18n/ko-KR.ts +2 -0
  319. package/corpus/templates/videos/app/i18n/pt-BR.ts +2 -0
  320. package/corpus/templates/videos/app/i18n/zh-CN.ts +2 -0
  321. package/corpus/templates/videos/app/i18n/zh-TW.ts +2 -0
  322. package/corpus/templates/videos/changelog/2026-06-28-left-sidebar-collapses-into-an-animated-icon-rail.md +6 -0
  323. package/dist/agent/engine/index.d.ts +1 -1
  324. package/dist/agent/engine/index.d.ts.map +1 -1
  325. package/dist/agent/engine/index.js +1 -1
  326. package/dist/agent/engine/index.js.map +1 -1
  327. package/dist/agent/engine/registry.d.ts +9 -0
  328. package/dist/agent/engine/registry.d.ts.map +1 -1
  329. package/dist/agent/engine/registry.js +37 -0
  330. package/dist/agent/engine/registry.js.map +1 -1
  331. package/dist/agent/production-agent.d.ts.map +1 -1
  332. package/dist/agent/production-agent.js +4 -3
  333. package/dist/agent/production-agent.js.map +1 -1
  334. package/dist/application-state/handlers.js +1 -1
  335. package/dist/application-state/handlers.js.map +1 -1
  336. package/dist/brand-kit/index.d.ts +1 -1
  337. package/dist/brand-kit/index.js +1 -1
  338. package/dist/brand-kit/index.js.map +1 -1
  339. package/dist/cli/design-connect.d.ts +52 -0
  340. package/dist/cli/design-connect.d.ts.map +1 -0
  341. package/dist/cli/design-connect.js +409 -0
  342. package/dist/cli/design-connect.js.map +1 -0
  343. package/dist/cli/index.js +15 -0
  344. package/dist/cli/index.js.map +1 -1
  345. package/dist/cli/skills.d.ts +3 -0
  346. package/dist/cli/skills.d.ts.map +1 -1
  347. package/dist/cli/skills.js +139 -3
  348. package/dist/cli/skills.js.map +1 -1
  349. package/dist/client/AgentPanel.js +1 -1
  350. package/dist/client/AgentPanel.js.map +1 -1
  351. package/dist/client/AssistantChat.d.ts.map +1 -1
  352. package/dist/client/AssistantChat.js +38 -8
  353. package/dist/client/AssistantChat.js.map +1 -1
  354. package/dist/client/MultiTabAssistantChat.js +1 -1
  355. package/dist/client/MultiTabAssistantChat.js.map +1 -1
  356. package/dist/client/agent-chat.d.ts +6 -0
  357. package/dist/client/agent-chat.d.ts.map +1 -1
  358. package/dist/client/agent-chat.js +17 -3
  359. package/dist/client/agent-chat.js.map +1 -1
  360. package/dist/client/blocks/library/MermaidBlock.js +1 -1
  361. package/dist/client/blocks/library/MermaidBlock.js.map +1 -1
  362. package/dist/client/blocks/library/diagram.js +1 -1
  363. package/dist/client/blocks/library/diagram.js.map +1 -1
  364. package/dist/client/blocks/library/wireframe.js +1 -1
  365. package/dist/client/blocks/library/wireframe.js.map +1 -1
  366. package/dist/client/chat/message-components.js +1 -1
  367. package/dist/client/chat/message-components.js.map +1 -1
  368. package/dist/client/chat-model-groups.d.ts.map +1 -1
  369. package/dist/client/chat-model-groups.js +1 -2
  370. package/dist/client/chat-model-groups.js.map +1 -1
  371. package/dist/client/components/LiveCursorOverlay.d.ts +1 -2
  372. package/dist/client/components/LiveCursorOverlay.d.ts.map +1 -1
  373. package/dist/client/components/LiveCursorOverlay.js +19 -40
  374. package/dist/client/components/LiveCursorOverlay.js.map +1 -1
  375. package/dist/client/composer/TiptapComposer.d.ts +3 -1
  376. package/dist/client/composer/TiptapComposer.d.ts.map +1 -1
  377. package/dist/client/composer/TiptapComposer.js +86 -24
  378. package/dist/client/composer/TiptapComposer.js.map +1 -1
  379. package/dist/client/composer/useVoiceDictation.d.ts +9 -0
  380. package/dist/client/composer/useVoiceDictation.d.ts.map +1 -1
  381. package/dist/client/composer/useVoiceDictation.js +154 -32
  382. package/dist/client/composer/useVoiceDictation.js.map +1 -1
  383. package/dist/client/extensions/portable-extension.d.ts +1 -1
  384. package/dist/client/extensions/portable-extension.d.ts.map +1 -1
  385. package/dist/client/extensions/portable-extension.js.map +1 -1
  386. package/dist/client/frame-protocol.d.ts +17 -2
  387. package/dist/client/frame-protocol.d.ts.map +1 -1
  388. package/dist/client/frame-protocol.js.map +1 -1
  389. package/dist/client/rich-markdown-editor/RegistryBlockNode.js +2 -2
  390. package/dist/client/rich-markdown-editor/RegistryBlockNode.js.map +1 -1
  391. package/dist/client/sharing/ShareButton.d.ts +2 -0
  392. package/dist/client/sharing/ShareButton.d.ts.map +1 -1
  393. package/dist/client/sharing/ShareButton.js +7 -6
  394. package/dist/client/sharing/ShareButton.js.map +1 -1
  395. package/dist/client/use-agent-engine-configured.d.ts +5 -0
  396. package/dist/client/use-agent-engine-configured.d.ts.map +1 -1
  397. package/dist/client/use-agent-engine-configured.js +51 -25
  398. package/dist/client/use-agent-engine-configured.js.map +1 -1
  399. package/dist/code-agents/transcript-normalizer.js +1 -1
  400. package/dist/code-agents/transcript-normalizer.js.map +1 -1
  401. package/dist/collab/routes.d.ts +1 -1
  402. package/dist/extensions/path.d.ts +1 -1
  403. package/dist/extensions/path.d.ts.map +1 -1
  404. package/dist/extensions/path.js.map +1 -1
  405. package/dist/file-upload/actions/upload-image.d.ts +2 -2
  406. package/dist/integrations/a2a-continuation-processor.js +1 -1
  407. package/dist/integrations/a2a-continuation-processor.js.map +1 -1
  408. package/dist/mcp/build-server.d.ts +1 -1
  409. package/dist/mcp/build-server.d.ts.map +1 -1
  410. package/dist/mcp/build-server.js.map +1 -1
  411. package/dist/notifications/routes.d.ts +3 -3
  412. package/dist/observability/routes.d.ts +5 -5
  413. package/dist/org/handlers.js +5 -5
  414. package/dist/org/handlers.js.map +1 -1
  415. package/dist/org/plugin.js +2 -2
  416. package/dist/org/plugin.js.map +1 -1
  417. package/dist/scripts/call-agent.js +1 -1
  418. package/dist/scripts/call-agent.js.map +1 -1
  419. package/dist/scripts/db/safety.js +1 -1
  420. package/dist/scripts/db/safety.js.map +1 -1
  421. package/dist/server/agent-engine-api-key-route.d.ts +1 -1
  422. package/dist/server/auth.d.ts.map +1 -1
  423. package/dist/server/auth.js +3 -0
  424. package/dist/server/auth.js.map +1 -1
  425. package/dist/server/builder-design-systems.d.ts +28 -0
  426. package/dist/server/builder-design-systems.d.ts.map +1 -0
  427. package/dist/server/builder-design-systems.js +217 -0
  428. package/dist/server/builder-design-systems.js.map +1 -0
  429. package/dist/server/core-routes-plugin.d.ts +1 -0
  430. package/dist/server/core-routes-plugin.d.ts.map +1 -1
  431. package/dist/server/core-routes-plugin.js +20 -3
  432. package/dist/server/core-routes-plugin.js.map +1 -1
  433. package/dist/server/index.d.ts +1 -0
  434. package/dist/server/index.d.ts.map +1 -1
  435. package/dist/server/index.js +1 -0
  436. package/dist/server/index.js.map +1 -1
  437. package/dist/server/transcribe-voice.d.ts +1 -1
  438. package/dist/server/transcribe-voice.d.ts.map +1 -1
  439. package/dist/server/transcribe-voice.js +40 -24
  440. package/dist/server/transcribe-voice.js.map +1 -1
  441. package/dist/shared/mcp-embed-headers.d.ts +1 -0
  442. package/dist/shared/mcp-embed-headers.d.ts.map +1 -1
  443. package/dist/shared/mcp-embed-headers.js +20 -1
  444. package/dist/shared/mcp-embed-headers.js.map +1 -1
  445. package/dist/styles/agent-native.css +60 -4
  446. package/dist/templates/workspace-core/.agents/skills/voice-transcription/SKILL.md +10 -0
  447. package/dist/usage/store.js +2 -2
  448. package/dist/usage/store.js.map +1 -1
  449. package/dist/vite/client.d.ts.map +1 -1
  450. package/dist/vite/client.js +2 -0
  451. package/dist/vite/client.js.map +1 -1
  452. package/dist/voice/index.d.ts +5 -0
  453. package/dist/voice/index.d.ts.map +1 -0
  454. package/dist/voice/index.js +4 -0
  455. package/dist/voice/index.js.map +1 -0
  456. package/dist/voice/voice-cleanup-prompt.d.ts +6 -0
  457. package/dist/voice/voice-cleanup-prompt.d.ts.map +1 -0
  458. package/dist/voice/voice-cleanup-prompt.js +26 -0
  459. package/dist/voice/voice-cleanup-prompt.js.map +1 -0
  460. package/dist/voice/voice-context.d.ts +25 -0
  461. package/dist/voice/voice-context.d.ts.map +1 -0
  462. package/dist/voice/voice-context.js +156 -0
  463. package/dist/voice/voice-context.js.map +1 -0
  464. package/dist/voice/voice-replacements.d.ts +4 -0
  465. package/dist/voice/voice-replacements.d.ts.map +1 -0
  466. package/dist/voice/voice-replacements.js +52 -0
  467. package/dist/voice/voice-replacements.js.map +1 -0
  468. package/docs/content/locales/ar-SA/skills-guide.mdx +5 -0
  469. package/docs/content/locales/ar-SA/template-design.mdx +55 -1
  470. package/docs/content/locales/de-DE/skills-guide.mdx +5 -0
  471. package/docs/content/locales/de-DE/template-design.mdx +66 -1
  472. package/docs/content/locales/es-ES/skills-guide.mdx +5 -0
  473. package/docs/content/locales/es-ES/template-design.mdx +65 -1
  474. package/docs/content/locales/fr-FR/skills-guide.mdx +5 -0
  475. package/docs/content/locales/fr-FR/template-design.mdx +64 -1
  476. package/docs/content/locales/hi-IN/skills-guide.mdx +5 -0
  477. package/docs/content/locales/hi-IN/template-design.mdx +59 -1
  478. package/docs/content/locales/ja-JP/skills-guide.mdx +5 -0
  479. package/docs/content/locales/ja-JP/template-design.mdx +62 -1
  480. package/docs/content/locales/ko-KR/skills-guide.mdx +5 -0
  481. package/docs/content/locales/ko-KR/template-design.mdx +58 -1
  482. package/docs/content/locales/pt-BR/skills-guide.mdx +5 -0
  483. package/docs/content/locales/pt-BR/template-design.mdx +62 -1
  484. package/docs/content/locales/zh-CN/skills-guide.mdx +5 -0
  485. package/docs/content/locales/zh-CN/template-design.mdx +50 -1
  486. package/docs/content/locales/zh-TW/skills-guide.mdx +5 -0
  487. package/docs/content/locales/zh-TW/template-design.mdx +52 -1
  488. package/docs/content/skills-guide.mdx +5 -0
  489. package/docs/content/template-design.mdx +59 -1
  490. package/package.json +2 -1
  491. package/src/templates/workspace-core/.agents/skills/voice-transcription/SKILL.md +10 -0
  492. package/corpus/templates/design/actions/import-figma-file.ts +0 -166
  493. package/corpus/templates/design/app/components/design/DesignToolbar.tsx +0 -339
  494. package/corpus/templates/design/app/components/design/PresentMode.tsx +0 -68
  495. package/corpus/templates/design/app/components/design/ViewportTabs.tsx +0 -149
  496. package/corpus/templates/design/app/components/design/ZoomControls.tsx +0 -157
  497. package/corpus/templates/slides/server/lib/fig-design-system.ts +0 -110
@@ -0,0 +1,719 @@
1
+ import {
2
+ forwardRef,
3
+ useCallback,
4
+ useImperativeHandle,
5
+ useMemo,
6
+ useState,
7
+ type CSSProperties,
8
+ type ReactNode,
9
+ } from "react";
10
+
11
+ import {
12
+ ContextMenu,
13
+ ContextMenuContent,
14
+ ContextMenuGroup,
15
+ ContextMenuItem,
16
+ ContextMenuSeparator,
17
+ ContextMenuShortcut,
18
+ ContextMenuSub,
19
+ ContextMenuSubContent,
20
+ ContextMenuSubTrigger,
21
+ ContextMenuTrigger,
22
+ } from "@/components/ui/context-menu";
23
+ import { cn } from "@/lib/utils";
24
+
25
+ export type CanvasContextMenuAction =
26
+ | "paste-here"
27
+ | "select-all"
28
+ | "zoom-to-fit"
29
+ | "zoom-to-selection"
30
+ | "copy"
31
+ | "paste"
32
+ | "paste-over"
33
+ | "duplicate"
34
+ | "delete"
35
+ | "bring-forward"
36
+ | "bring-to-front"
37
+ | "send-backward"
38
+ | "send-to-back"
39
+ | "group"
40
+ | "ungroup"
41
+ | "rename"
42
+ | "toggle-lock"
43
+ | "toggle-hide"
44
+ | "copy-props"
45
+ | "paste-props"
46
+ | "copy-as-code";
47
+
48
+ export interface CanvasContextMenuPoint {
49
+ clientX: number;
50
+ clientY: number;
51
+ canvasX?: number;
52
+ canvasY?: number;
53
+ }
54
+
55
+ export interface CanvasContextMenuHandle {
56
+ openAt: (point: CanvasContextMenuPoint) => void;
57
+ close: () => void;
58
+ }
59
+
60
+ export interface CanvasContextMenuActionDetails {
61
+ action: CanvasContextMenuAction;
62
+ point: CanvasContextMenuPoint | null;
63
+ selectedCount: number;
64
+ originalEvent: Event;
65
+ }
66
+
67
+ export type CanvasContextMenuActionHandler = (
68
+ details: CanvasContextMenuActionDetails,
69
+ ) => void;
70
+
71
+ export interface CanvasContextMenuLabels {
72
+ pasteHere: string;
73
+ selectAll: string;
74
+ zoomToFit: string;
75
+ zoomToSelection: string;
76
+ copy: string;
77
+ paste: string;
78
+ pasteOver: string;
79
+ duplicate: string;
80
+ delete: string;
81
+ order: string;
82
+ bringForward: string;
83
+ bringToFront: string;
84
+ sendBackward: string;
85
+ sendToBack: string;
86
+ group: string;
87
+ ungroup: string;
88
+ rename: string;
89
+ lock: string;
90
+ unlock: string;
91
+ hide: string;
92
+ show: string;
93
+ copyProps: string;
94
+ pasteProps: string;
95
+ copyAsCode: string;
96
+ }
97
+
98
+ export interface CanvasContextMenuShortcuts {
99
+ pasteHere: string;
100
+ selectAll: string;
101
+ zoomToFit: string;
102
+ zoomToSelection: string;
103
+ copy: string;
104
+ paste: string;
105
+ pasteOver: string;
106
+ duplicate: string;
107
+ delete: string;
108
+ bringForward: string;
109
+ bringToFront: string;
110
+ sendBackward: string;
111
+ sendToBack: string;
112
+ group: string;
113
+ ungroup: string;
114
+ rename: string;
115
+ copyProps: string;
116
+ pasteProps: string;
117
+ copyAsCode: string;
118
+ }
119
+
120
+ export interface CanvasContextMenuProps {
121
+ children: ReactNode;
122
+ disabled?: boolean;
123
+ className?: string;
124
+ contentClassName?: string;
125
+ selectedCount?: number;
126
+ hasClipboard?: boolean;
127
+ hasPropsClipboard?: boolean;
128
+ isLocked?: boolean;
129
+ isHidden?: boolean;
130
+ canPasteHere?: boolean;
131
+ canSelectAll?: boolean;
132
+ canZoomToFit?: boolean;
133
+ canZoomToSelection?: boolean;
134
+ canCopy?: boolean;
135
+ canPaste?: boolean;
136
+ canPasteOver?: boolean;
137
+ canDuplicate?: boolean;
138
+ canDelete?: boolean;
139
+ canReorder?: boolean;
140
+ canGroup?: boolean;
141
+ canUngroup?: boolean;
142
+ canRename?: boolean;
143
+ canToggleLocked?: boolean;
144
+ canToggleHidden?: boolean;
145
+ canCopyProps?: boolean;
146
+ canPasteProps?: boolean;
147
+ canCopyAsCode?: boolean;
148
+ hiddenActions?: readonly CanvasContextMenuAction[];
149
+ disabledActions?: readonly CanvasContextMenuAction[];
150
+ labels?: Partial<CanvasContextMenuLabels>;
151
+ shortcuts?: Partial<CanvasContextMenuShortcuts>;
152
+ getCanvasPoint?: (point: { clientX: number; clientY: number }) => {
153
+ x: number;
154
+ y: number;
155
+ };
156
+ onOpenChange?: (open: boolean) => void;
157
+ onAction?: (
158
+ action: CanvasContextMenuAction,
159
+ details: CanvasContextMenuActionDetails,
160
+ ) => void;
161
+ onPasteHere?: CanvasContextMenuActionHandler;
162
+ onSelectAll?: CanvasContextMenuActionHandler;
163
+ onZoomToFit?: CanvasContextMenuActionHandler;
164
+ onZoomToSelection?: CanvasContextMenuActionHandler;
165
+ onCopy?: CanvasContextMenuActionHandler;
166
+ onPaste?: CanvasContextMenuActionHandler;
167
+ onPasteOver?: CanvasContextMenuActionHandler;
168
+ onDuplicate?: CanvasContextMenuActionHandler;
169
+ onDelete?: CanvasContextMenuActionHandler;
170
+ onBringForward?: CanvasContextMenuActionHandler;
171
+ onBringToFront?: CanvasContextMenuActionHandler;
172
+ onSendBackward?: CanvasContextMenuActionHandler;
173
+ onSendToBack?: CanvasContextMenuActionHandler;
174
+ onGroup?: CanvasContextMenuActionHandler;
175
+ onUngroup?: CanvasContextMenuActionHandler;
176
+ onRename?: CanvasContextMenuActionHandler;
177
+ onToggleLocked?: CanvasContextMenuActionHandler;
178
+ onToggleHidden?: CanvasContextMenuActionHandler;
179
+ onCopyProps?: CanvasContextMenuActionHandler;
180
+ onPasteProps?: CanvasContextMenuActionHandler;
181
+ onCopyAsCode?: CanvasContextMenuActionHandler;
182
+ }
183
+
184
+ const DEFAULT_LABELS: CanvasContextMenuLabels = {
185
+ pasteHere: "Paste here",
186
+ selectAll: "Select all",
187
+ zoomToFit: "Zoom to fit",
188
+ zoomToSelection: "Zoom to selection",
189
+ copy: "Copy",
190
+ paste: "Paste",
191
+ pasteOver: "Paste over",
192
+ duplicate: "Duplicate",
193
+ delete: "Delete",
194
+ order: "Order",
195
+ bringForward: "Bring forward",
196
+ bringToFront: "Bring to front",
197
+ sendBackward: "Send backward",
198
+ sendToBack: "Send to back",
199
+ group: "Group",
200
+ ungroup: "Ungroup",
201
+ rename: "Rename",
202
+ lock: "Lock",
203
+ unlock: "Unlock",
204
+ hide: "Hide",
205
+ show: "Show",
206
+ copyProps: "Copy properties",
207
+ pasteProps: "Paste properties",
208
+ copyAsCode: "Copy as code",
209
+ };
210
+
211
+ const DEFAULT_SHORTCUTS: CanvasContextMenuShortcuts = {
212
+ pasteHere: "⌘V",
213
+ selectAll: "⌘A",
214
+ zoomToFit: "⇧1",
215
+ zoomToSelection: "⇧2",
216
+ copy: "⌘C",
217
+ paste: "⌘V",
218
+ pasteOver: "⇧⌘V",
219
+ duplicate: "⌘D",
220
+ delete: "⌫",
221
+ bringForward: "⌘]",
222
+ bringToFront: "⌥⌘]",
223
+ sendBackward: "⌘[",
224
+ sendToBack: "⌥⌘[",
225
+ group: "⌘G",
226
+ ungroup: "⇧⌘G",
227
+ rename: "⌘R",
228
+ copyProps: "⌥⌘C",
229
+ pasteProps: "⌥⌘V",
230
+ copyAsCode: "⇧⌘C",
231
+ };
232
+
233
+ type ActionCallbackMap = Partial<
234
+ Record<CanvasContextMenuAction, CanvasContextMenuActionHandler>
235
+ >;
236
+
237
+ // Figma-style menu chrome: compact, dark-border, subtle shadow, no animation jitter
238
+ const MENU_CONTENT_CLASS =
239
+ "w-52 min-w-[200px] rounded-[6px] border border-[var(--design-editor-control-border)] bg-[var(--design-editor-panel-bg)] py-[3px] px-[3px] text-[12px] text-foreground shadow-[0_4px_16px_rgba(0,0,0,0.16),0_0_0_0.5px_rgba(0,0,0,0.08)] outline-none data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-[0.97] data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 duration-100";
240
+ // Figma row height ~28px, full-width highlight on hover, no icon gap waste
241
+ const MENU_ITEM_CLASS =
242
+ "flex h-7 cursor-default select-none items-center rounded-[4px] px-2 py-0 text-[12px] leading-none gap-0 focus:bg-[var(--design-editor-selection-color)] focus:text-white data-[disabled]:pointer-events-none data-[disabled]:opacity-35";
243
+ // Submenu trigger mirrors item styles + chevron sizing
244
+ const MENU_SUB_TRIGGER_CLASS =
245
+ "flex h-7 cursor-default select-none items-center rounded-[4px] px-2 py-0 text-[12px] leading-none focus:bg-[var(--design-editor-selection-color)] focus:text-white data-[state=open]:bg-[var(--design-editor-selection-color)] data-[state=open]:text-white [&>svg:last-child]:ms-auto [&>svg:last-child]:size-3 [&>svg:last-child]:opacity-50";
246
+ // Separator: 1px, full-width flush, Figma-like muted line
247
+ const MENU_SEPARATOR_CLASS =
248
+ "mx-0 my-[3px] h-px bg-[var(--design-editor-control-border)] opacity-80";
249
+ // Shortcut: right-aligned, muted, use system UI for symbol rendering
250
+ const MENU_SHORTCUT_CLASS =
251
+ "ms-auto ps-4 font-normal text-[11px] tracking-normal text-muted-foreground/70 tabular-nums";
252
+
253
+ export const CanvasContextMenu = forwardRef<
254
+ CanvasContextMenuHandle,
255
+ CanvasContextMenuProps
256
+ >(function CanvasContextMenu(
257
+ {
258
+ children,
259
+ disabled,
260
+ className,
261
+ contentClassName,
262
+ selectedCount = 0,
263
+ hasClipboard = false,
264
+ hasPropsClipboard = false,
265
+ isLocked = false,
266
+ isHidden = false,
267
+ canPasteHere = hasClipboard,
268
+ canSelectAll = true,
269
+ canZoomToFit = true,
270
+ canZoomToSelection = selectedCount > 0,
271
+ canCopy = selectedCount > 0,
272
+ canPaste = hasClipboard,
273
+ canPasteOver = hasClipboard && selectedCount > 0,
274
+ canDuplicate = selectedCount > 0,
275
+ canDelete = selectedCount > 0,
276
+ canReorder = selectedCount > 0,
277
+ canGroup = selectedCount > 1,
278
+ canUngroup = false,
279
+ canRename = selectedCount === 1,
280
+ canToggleLocked = selectedCount > 0,
281
+ canToggleHidden = selectedCount > 0,
282
+ canCopyProps = selectedCount > 0,
283
+ canPasteProps = hasPropsClipboard && selectedCount > 0,
284
+ canCopyAsCode = selectedCount > 0,
285
+ hiddenActions = [],
286
+ disabledActions = [],
287
+ labels: labelsProp,
288
+ shortcuts: shortcutsProp,
289
+ getCanvasPoint,
290
+ onOpenChange,
291
+ onAction,
292
+ onPasteHere,
293
+ onSelectAll,
294
+ onZoomToFit,
295
+ onZoomToSelection,
296
+ onCopy,
297
+ onPaste,
298
+ onPasteOver,
299
+ onDuplicate,
300
+ onDelete,
301
+ onBringForward,
302
+ onBringToFront,
303
+ onSendBackward,
304
+ onSendToBack,
305
+ onGroup,
306
+ onUngroup,
307
+ onRename,
308
+ onToggleLocked,
309
+ onToggleHidden,
310
+ onCopyProps,
311
+ onPasteProps,
312
+ onCopyAsCode,
313
+ },
314
+ ref,
315
+ ) {
316
+ const labels = useMemo(
317
+ () => ({ ...DEFAULT_LABELS, ...labelsProp }),
318
+ [labelsProp],
319
+ );
320
+ const shortcuts = useMemo(
321
+ () => ({ ...DEFAULT_SHORTCUTS, ...shortcutsProp }),
322
+ [shortcutsProp],
323
+ );
324
+ const hiddenActionSet = useMemo(
325
+ () => new Set(hiddenActions),
326
+ [hiddenActions],
327
+ );
328
+ const disabledActionSet = useMemo(
329
+ () => new Set(disabledActions),
330
+ [disabledActions],
331
+ );
332
+ const [point, setPoint] = useState<CanvasContextMenuPoint | null>(null);
333
+ const [open, setOpen] = useState(false);
334
+ const [manualPoint, setManualPoint] = useState<CanvasContextMenuPoint | null>(
335
+ null,
336
+ );
337
+
338
+ const handleOpenChange = useCallback(
339
+ (nextOpen: boolean) => {
340
+ setOpen(nextOpen);
341
+ if (!nextOpen) setManualPoint(null);
342
+ onOpenChange?.(nextOpen);
343
+ },
344
+ [onOpenChange],
345
+ );
346
+
347
+ useImperativeHandle(
348
+ ref,
349
+ () => ({
350
+ openAt(nextPoint) {
351
+ setPoint(nextPoint);
352
+ setManualPoint(nextPoint);
353
+ setOpen(true);
354
+ },
355
+ close() {
356
+ handleOpenChange(false);
357
+ },
358
+ }),
359
+ [handleOpenChange],
360
+ );
361
+
362
+ const callbacks = useMemo<ActionCallbackMap>(
363
+ () => ({
364
+ "paste-here": onPasteHere,
365
+ "select-all": onSelectAll,
366
+ "zoom-to-fit": onZoomToFit,
367
+ "zoom-to-selection": onZoomToSelection,
368
+ copy: onCopy,
369
+ paste: onPaste,
370
+ "paste-over": onPasteOver,
371
+ duplicate: onDuplicate,
372
+ delete: onDelete,
373
+ "bring-forward": onBringForward,
374
+ "bring-to-front": onBringToFront,
375
+ "send-backward": onSendBackward,
376
+ "send-to-back": onSendToBack,
377
+ group: onGroup,
378
+ ungroup: onUngroup,
379
+ rename: onRename,
380
+ "toggle-lock": onToggleLocked,
381
+ "toggle-hide": onToggleHidden,
382
+ "copy-props": onCopyProps,
383
+ "paste-props": onPasteProps,
384
+ "copy-as-code": onCopyAsCode,
385
+ }),
386
+ [
387
+ onBringForward,
388
+ onBringToFront,
389
+ onCopy,
390
+ onCopyAsCode,
391
+ onCopyProps,
392
+ onDelete,
393
+ onDuplicate,
394
+ onGroup,
395
+ onPaste,
396
+ onPasteHere,
397
+ onPasteOver,
398
+ onPasteProps,
399
+ onRename,
400
+ onSelectAll,
401
+ onSendBackward,
402
+ onSendToBack,
403
+ onToggleHidden,
404
+ onToggleLocked,
405
+ onUngroup,
406
+ onZoomToFit,
407
+ onZoomToSelection,
408
+ ],
409
+ );
410
+
411
+ const runAction = useCallback(
412
+ (action: CanvasContextMenuAction, originalEvent: Event) => {
413
+ const details = {
414
+ action,
415
+ point,
416
+ selectedCount,
417
+ originalEvent,
418
+ };
419
+ onAction?.(action, details);
420
+ callbacks[action]?.(details);
421
+ },
422
+ [callbacks, onAction, point, selectedCount],
423
+ );
424
+
425
+ const canRun = useCallback(
426
+ (action: CanvasContextMenuAction, capability: boolean) =>
427
+ capability &&
428
+ !disabledActionSet.has(action) &&
429
+ Boolean(onAction || callbacks[action]),
430
+ [callbacks, disabledActionSet, onAction],
431
+ );
432
+
433
+ const isHiddenAction = useCallback(
434
+ (action: CanvasContextMenuAction) => hiddenActionSet.has(action),
435
+ [hiddenActionSet],
436
+ );
437
+
438
+ if (disabled) {
439
+ return <>{children}</>;
440
+ }
441
+
442
+ const manualContentStyle = manualPoint
443
+ ? ({
444
+ position: "fixed",
445
+ left: manualPoint.clientX,
446
+ top: manualPoint.clientY,
447
+ transform: "none",
448
+ zIndex: 250,
449
+ } satisfies CSSProperties)
450
+ : undefined;
451
+
452
+ return (
453
+ <ContextMenu open={open} onOpenChange={handleOpenChange}>
454
+ <ContextMenuTrigger asChild>
455
+ <div
456
+ className={cn("contents", className)}
457
+ onContextMenuCapture={(event) => {
458
+ const canvasPoint = getCanvasPoint?.({
459
+ clientX: event.clientX,
460
+ clientY: event.clientY,
461
+ });
462
+ setPoint({
463
+ clientX: event.clientX,
464
+ clientY: event.clientY,
465
+ canvasX: canvasPoint?.x,
466
+ canvasY: canvasPoint?.y,
467
+ });
468
+ }}
469
+ >
470
+ {children}
471
+ </div>
472
+ </ContextMenuTrigger>
473
+ <ContextMenuContent
474
+ className={cn(MENU_CONTENT_CLASS, contentClassName)}
475
+ style={manualContentStyle}
476
+ >
477
+ <ContextMenuGroup>
478
+ <CanvasMenuItem
479
+ hidden={isHiddenAction("paste-here")}
480
+ disabled={!canRun("paste-here", canPasteHere)}
481
+ label={labels.pasteHere}
482
+ shortcut={shortcuts.pasteHere}
483
+ onSelect={(event) => runAction("paste-here", event)}
484
+ />
485
+ <CanvasMenuItem
486
+ hidden={isHiddenAction("select-all")}
487
+ disabled={!canRun("select-all", canSelectAll)}
488
+ label={labels.selectAll}
489
+ shortcut={shortcuts.selectAll}
490
+ onSelect={(event) => runAction("select-all", event)}
491
+ />
492
+ </ContextMenuGroup>
493
+
494
+ <CanvasMenuSeparator />
495
+
496
+ <ContextMenuGroup>
497
+ <CanvasMenuItem
498
+ hidden={isHiddenAction("zoom-to-fit")}
499
+ disabled={!canRun("zoom-to-fit", canZoomToFit)}
500
+ label={labels.zoomToFit}
501
+ shortcut={shortcuts.zoomToFit}
502
+ onSelect={(event) => runAction("zoom-to-fit", event)}
503
+ />
504
+ <CanvasMenuItem
505
+ hidden={isHiddenAction("zoom-to-selection")}
506
+ disabled={!canRun("zoom-to-selection", canZoomToSelection)}
507
+ label={labels.zoomToSelection}
508
+ shortcut={shortcuts.zoomToSelection}
509
+ onSelect={(event) => runAction("zoom-to-selection", event)}
510
+ />
511
+ </ContextMenuGroup>
512
+
513
+ <CanvasMenuSeparator />
514
+
515
+ <ContextMenuGroup>
516
+ <CanvasMenuItem
517
+ hidden={isHiddenAction("copy")}
518
+ disabled={!canRun("copy", canCopy)}
519
+ label={labels.copy}
520
+ shortcut={shortcuts.copy}
521
+ onSelect={(event) => runAction("copy", event)}
522
+ />
523
+ <CanvasMenuItem
524
+ hidden={isHiddenAction("paste")}
525
+ disabled={!canRun("paste", canPaste)}
526
+ label={labels.paste}
527
+ shortcut={shortcuts.paste}
528
+ onSelect={(event) => runAction("paste", event)}
529
+ />
530
+ <CanvasMenuItem
531
+ hidden={isHiddenAction("paste-over")}
532
+ disabled={!canRun("paste-over", canPasteOver)}
533
+ label={labels.pasteOver}
534
+ shortcut={shortcuts.pasteOver}
535
+ onSelect={(event) => runAction("paste-over", event)}
536
+ />
537
+ <CanvasMenuItem
538
+ hidden={isHiddenAction("duplicate")}
539
+ disabled={!canRun("duplicate", canDuplicate)}
540
+ label={labels.duplicate}
541
+ shortcut={shortcuts.duplicate}
542
+ onSelect={(event) => runAction("duplicate", event)}
543
+ />
544
+ </ContextMenuGroup>
545
+
546
+ <CanvasMenuSeparator />
547
+
548
+ <ContextMenuGroup>
549
+ {!isHiddenAction("bring-forward") ||
550
+ !isHiddenAction("bring-to-front") ||
551
+ !isHiddenAction("send-backward") ||
552
+ !isHiddenAction("send-to-back") ? (
553
+ <ContextMenuSub>
554
+ <ContextMenuSubTrigger
555
+ disabled={
556
+ !(
557
+ canRun("bring-forward", canReorder) ||
558
+ canRun("bring-to-front", canReorder) ||
559
+ canRun("send-backward", canReorder) ||
560
+ canRun("send-to-back", canReorder)
561
+ )
562
+ }
563
+ className={MENU_SUB_TRIGGER_CLASS}
564
+ >
565
+ {labels.order}
566
+ </ContextMenuSubTrigger>
567
+ <ContextMenuSubContent className={cn(MENU_CONTENT_CLASS, "w-52")}>
568
+ <CanvasMenuItem
569
+ hidden={isHiddenAction("bring-forward")}
570
+ disabled={!canRun("bring-forward", canReorder)}
571
+ label={labels.bringForward}
572
+ shortcut={shortcuts.bringForward}
573
+ onSelect={(event) => runAction("bring-forward", event)}
574
+ />
575
+ <CanvasMenuItem
576
+ hidden={isHiddenAction("bring-to-front")}
577
+ disabled={!canRun("bring-to-front", canReorder)}
578
+ label={labels.bringToFront}
579
+ shortcut={shortcuts.bringToFront}
580
+ onSelect={(event) => runAction("bring-to-front", event)}
581
+ />
582
+ <CanvasMenuItem
583
+ hidden={isHiddenAction("send-backward")}
584
+ disabled={!canRun("send-backward", canReorder)}
585
+ label={labels.sendBackward}
586
+ shortcut={shortcuts.sendBackward}
587
+ onSelect={(event) => runAction("send-backward", event)}
588
+ />
589
+ <CanvasMenuItem
590
+ hidden={isHiddenAction("send-to-back")}
591
+ disabled={!canRun("send-to-back", canReorder)}
592
+ label={labels.sendToBack}
593
+ shortcut={shortcuts.sendToBack}
594
+ onSelect={(event) => runAction("send-to-back", event)}
595
+ />
596
+ </ContextMenuSubContent>
597
+ </ContextMenuSub>
598
+ ) : null}
599
+ <CanvasMenuItem
600
+ hidden={isHiddenAction("group")}
601
+ disabled={!canRun("group", canGroup)}
602
+ label={labels.group}
603
+ shortcut={shortcuts.group}
604
+ onSelect={(event) => runAction("group", event)}
605
+ />
606
+ <CanvasMenuItem
607
+ hidden={isHiddenAction("ungroup")}
608
+ disabled={!canRun("ungroup", canUngroup)}
609
+ label={labels.ungroup}
610
+ shortcut={shortcuts.ungroup}
611
+ onSelect={(event) => runAction("ungroup", event)}
612
+ />
613
+ </ContextMenuGroup>
614
+
615
+ <CanvasMenuSeparator />
616
+
617
+ <ContextMenuGroup>
618
+ <CanvasMenuItem
619
+ hidden={isHiddenAction("rename")}
620
+ disabled={!canRun("rename", canRename)}
621
+ label={labels.rename}
622
+ shortcut={shortcuts.rename}
623
+ onSelect={(event) => runAction("rename", event)}
624
+ />
625
+ <CanvasMenuItem
626
+ hidden={isHiddenAction("toggle-lock")}
627
+ disabled={!canRun("toggle-lock", canToggleLocked)}
628
+ label={isLocked ? labels.unlock : labels.lock}
629
+ onSelect={(event) => runAction("toggle-lock", event)}
630
+ />
631
+ <CanvasMenuItem
632
+ hidden={isHiddenAction("toggle-hide")}
633
+ disabled={!canRun("toggle-hide", canToggleHidden)}
634
+ label={isHidden ? labels.show : labels.hide}
635
+ onSelect={(event) => runAction("toggle-hide", event)}
636
+ />
637
+ </ContextMenuGroup>
638
+
639
+ <CanvasMenuSeparator />
640
+
641
+ <ContextMenuGroup>
642
+ <CanvasMenuItem
643
+ hidden={isHiddenAction("copy-props")}
644
+ disabled={!canRun("copy-props", canCopyProps)}
645
+ label={labels.copyProps}
646
+ shortcut={shortcuts.copyProps}
647
+ onSelect={(event) => runAction("copy-props", event)}
648
+ />
649
+ <CanvasMenuItem
650
+ hidden={isHiddenAction("paste-props")}
651
+ disabled={!canRun("paste-props", canPasteProps)}
652
+ label={labels.pasteProps}
653
+ shortcut={shortcuts.pasteProps}
654
+ onSelect={(event) => runAction("paste-props", event)}
655
+ />
656
+ <CanvasMenuItem
657
+ hidden={isHiddenAction("copy-as-code")}
658
+ disabled={!canRun("copy-as-code", canCopyAsCode)}
659
+ label={labels.copyAsCode}
660
+ shortcut={shortcuts.copyAsCode}
661
+ onSelect={(event) => runAction("copy-as-code", event)}
662
+ />
663
+ </ContextMenuGroup>
664
+
665
+ <CanvasMenuSeparator />
666
+
667
+ <CanvasMenuItem
668
+ hidden={isHiddenAction("delete")}
669
+ disabled={!canRun("delete", canDelete)}
670
+ label={labels.delete}
671
+ shortcut={shortcuts.delete}
672
+ destructive
673
+ onSelect={(event) => runAction("delete", event)}
674
+ />
675
+ </ContextMenuContent>
676
+ </ContextMenu>
677
+ );
678
+ });
679
+
680
+ function CanvasMenuItem({
681
+ hidden,
682
+ disabled,
683
+ destructive,
684
+ label,
685
+ shortcut,
686
+ onSelect,
687
+ }: {
688
+ hidden?: boolean;
689
+ disabled?: boolean;
690
+ destructive?: boolean;
691
+ label: string;
692
+ shortcut?: string;
693
+ onSelect: (event: Event) => void;
694
+ }) {
695
+ if (hidden) return null;
696
+
697
+ return (
698
+ <ContextMenuItem
699
+ disabled={disabled}
700
+ onSelect={onSelect}
701
+ className={cn(
702
+ MENU_ITEM_CLASS,
703
+ destructive &&
704
+ "text-destructive focus:bg-destructive/10 focus:text-destructive",
705
+ )}
706
+ >
707
+ <span className="flex-1 truncate">{label}</span>
708
+ {shortcut ? (
709
+ <ContextMenuShortcut className={MENU_SHORTCUT_CLASS}>
710
+ {shortcut}
711
+ </ContextMenuShortcut>
712
+ ) : null}
713
+ </ContextMenuItem>
714
+ );
715
+ }
716
+
717
+ function CanvasMenuSeparator() {
718
+ return <ContextMenuSeparator className={MENU_SEPARATOR_CLASS} />;
719
+ }