@openprd/cli 0.1.10 → 0.1.18

package/src/canvas-i18n.js

@@ -0,0 +1,274 @@
+/*
+ * Core purpose
+ * Provide locale copy for the OpenPrd canvas browser app.
+ *
+ * Inputs
+ * Receives locale strings from browser/system preferences or explicit user
+ * choice.
+ *
+ * Outputs
+ * Normalized locale codes and UI copy dictionaries for the canvas shell.
+ *
+ * Positioning
+ * This module keeps presentation copy outside canvas-app.html.js so adding
+ * locales does not expand the browser template logic.
+ *
+ * Maintenance rules
+ * Keep labels short because the canvas topbar is dense. Add new locale keys to
+ * both Chinese and English together.
+ */
+
+const CANVAS_LOCALE_STORAGE_KEY = 'openprd-canvas-locale';
+const CANVAS_DEFAULT_LOCALE = 'zh-CN';
+
+const CANVAS_LOCALES = {
+  'zh-CN': {
+    appSubtitle: '对话协同画布',
+    openingTitle: '正在打开 OpenPrd 画布',
+    openingBody: '画布会自动绑定当前对话记录。',
+    bootErrorTitle: '画布启动失败',
+    bootErrorBody: '请刷新页面；如果仍失败，把下面这段错误发给 Agent。',
+    loadingTitle: '正在同步画布',
+    loadingBody: '读取本次对话绑定的画布状态。',
+    loadErrorTitle: '画布加载失败',
+    canvasActionsTitle: '画布操作',
+    personalLibraryTitle: '个人素材库',
+    reviewBoardTitle: '评审协同',
+    reviewGuideStage: '第 {index}/{total} 步 · {title}',
+    reviewGuideNext: '下一步：{action}',
+    importReviewDirections: '导入评审方向',
+    importingReviewDirections: '正在导入...',
+    reviewDirectionsImported: '已把 {count} 个交互方向摆上画布，圈选批注后发送给 Codex。',
+    reviewDirectionsEmpty: '当前评审还没有交互方向，先让 Agent 生成 3 个方向。',
+    reviewDirectionsFailed: '暂时无法读取评审方向，请稍后再试。',
+    reviewDirectionSelectedTag: '已选定',
+    aiImageTemplatesTitle: 'AI 生图模板',
+    saveCanvas: '导出文件',
+    exportImage: '导出图片',
+    resetCanvas: '重置画布',
+    openLibrary: '个人素材库',
+    blankCard: '空白卡片',
+    savingCanvas: '正在导出文件...',
+    savedCanvas: '已导出到下载文件夹：{filename}',
+    openContainingFolder: '打开所在文件夹',
+    openingFolder: '正在打开...',
+    openFolderFailed: '暂时无法打开所在文件夹，请手动查看会话导出目录。',
+    exportingImage: '正在导出图片...',
+    exportedImage: '已导出到 {path}',
+    emptySceneExportBody: '画布里还没有可导出的内容。',
+    exportSelection: '导出选中内容',
+    sendToCodex: '发送给 Codex',
+    sendingToCodex: '正在发送',
+    downloadSelectedImage: '下载图片',
+    downloadingSelectedImage: '正在下载...',
+    downloadedSelectedImage: '已下载到下载文件夹：{filename}',
+    downloadSelectedImageFailed: '暂时无法下载选中图片，请稍后再试。',
+    sendDisabledTitle: '先在画布上选中一个或多个元素',
+    languageLabel: '语言',
+    currentConversationTitle: '当前对话',
+    copyThreadPrompt: '复制线程指令',
+    threadPromptCopied: '已复制线程指令，可粘贴到其他 Codex 对话中。',
+    threadPromptCopyFailed: '暂时无法复制，请手动复制线程 ID。',
+    threadPromptTemplate: '请在 Codex 中定位并操作这个 OpenPrd 画布绑定的对话线程。\n\n线程标题：{title}\n线程 ID：{id}\n\n请基于这个线程继续处理：<在这里补充你的具体指令>',
+    conversation: '对话',
+    placeholderText: '拖动空白卡片，或让 Agent 替换为图片',
+    libraryItemName: '素材 {index}',
+    libraryItemCount: '{count} 个元素',
+    insertedLibraryItem: '已添加到画布',
+    aiTemplateSquare: '头像 / 方图',
+    aiTemplatePortrait: '竖版卡片',
+    aiTemplateLandscape: '横版配图',
+    aiTemplateWide: '横版封面',
+    aiTemplateVertical: '手机竖图',
+    aiTemplateWechat: '公众号封面',
+    aiImageComposerTitle: 'AI 生图指令',
+    aiImageTemplateLabel: '画布卡片比例',
+    aiImageInstructionLabel: '生图指令',
+    aiImageInstructionPlaceholder: '描述你想生成的图片，例如：一张清爽的产品功能示意图，白色背景，蓝色主按钮，适合放在 PRD 里说明方案。',
+    createAiImageCard: '生成卡片',
+    imagePromptRequired: '先输入生图指令。',
+    imageRequestPrepared: '已创建 AI 生图卡片，指令已复制；Codex 可用 Image 2 生成后回填。',
+    imageRequestSent: '已创建 AI 生图卡片，并已发往当前 Codex 对话处理。',
+    imageRequestAgentBridge: '已创建 AI 生图卡片，自动发送暂不可用，已等待 Agent 接力发送。',
+    imageRequestPending: '已创建 AI 生图卡片，并正在发往当前 Codex 对话；如果长时间没有出现，请复制提示手动发送。',
+    imageRequestManualCopy: '已创建 AI 生图卡片，指令已写入卡片；Codex 可读取后生成并回填。',
+    agentBridgePending: '自动发送暂不可用，等待 Codex Agent 接力发送到当前对话。',
+    agentBridgeClaimed: 'Codex Agent 已领取，正在发送到当前对话。',
+    agentBridgeSent: 'Codex Agent 已前台发送到当前对话。',
+    agentBridgeFailed: 'Codex Agent 前台接力失败，请复制提示手动发送。',
+    aiGenerating: 'Codex 生成中...',
+    aiTemplateOnCanvas: '比例 {ratio}，等待图片回填',
+    aiImagePromptIntro: '请使用 Codex 原生生图能力生成一张图片，并回填到 OpenPrd Canvas 的这张 AI 生图卡片。',
+    aiImagePromptMeta: '画布会话：{binding}；卡片比例：{ratio}；占位卡 ID：{placeholderId}',
+    aiImagePromptReturn: '生成完成后，请回填到当前画布里的这张占位卡，回填信息如下：',
+    selectedCount: '已选中 {count} 个元素',
+    sendBarHint: '预览选区截图，输入指令后发送给 Codex。',
+    composerTitle: '发送给 Codex',
+    previewLabel: '选区截图',
+    composerPreviewAlt: 'OpenPrd 画布选区截图',
+    instructionLabel: '指令',
+    instructionPlaceholder: '告诉 Codex 你希望怎么处理这张截图，例如：按这个标注调整图片、解释这里的问题、继续生成下一版。',
+    copiedTitle: '已准备好发送给 Codex',
+    copiedBody: '选区图片已保存，提示已复制到剪贴板。',
+    copiedBodyWithRelay: '选区图片已保存，提示已复制；当前 Codex Agent 可按交接记录转发到本线程。',
+    copyFailedTitle: '选区图片已保存',
+    copyFailedBody: '浏览器未允许写入剪贴板，请手动复制下面这段提示。',
+    sentBody: '选区截图和指令已保存，提示已复制。',
+    sentBodyWithRelay: '选区截图和指令已发往当前 Codex 对话处理。',
+    sentBodyAgentBridge: '自动发送暂不可用，选区截图和指令已加入 Codex Agent 接力队列。',
+    sentBodyPending: '选区截图和指令正在发往当前 Codex 对话；如果长时间没有出现，请复制提示手动发送。',
+    sendManualCopyBody: '选区截图和指令已保存；浏览器未允许复制，请点击复制提示。',
+    sendErrorTitle: '发送准备失败',
+    emptySelectionTitle: '请先选中画布元素',
+    emptySelectionBody: '多选或圈选元素后，再点击发送给 Codex。',
+    resetConfirm: '确定要清空当前画布吗？此操作会同步保存到本次对话画布。',
+    saveFailed: '暂时无法保存，请稍后再试。',
+    exportFailed: '暂时无法导出，请稍后再试。',
+    exportPathLabel: '图片路径',
+    promptLabel: '可发送提示',
+    copyPrompt: '复制提示',
+    dismiss: '关闭',
+    codexPromptDefaultInstruction: '请根据这个画布选区继续协同。',
+    codexPromptIntro: '画布选区截图：',
+    codexPromptMeta: '来源：OpenPrd Canvas；选区元素：{count}；会话：{binding}',
+  },
+  en: {
+    appSubtitle: 'Conversation canvas',
+    openingTitle: 'Opening OpenPrd Canvas',
+    openingBody: 'The canvas is bound to the current conversation.',
+    bootErrorTitle: 'Canvas failed to start',
+    bootErrorBody: 'Refresh the page. If it still fails, send the error below to the agent.',
+    loadingTitle: 'Syncing canvas',
+    loadingBody: 'Reading the canvas state for this conversation.',
+    loadErrorTitle: 'Canvas failed to load',
+    canvasActionsTitle: 'Canvas actions',
+    personalLibraryTitle: 'Personal library',
+    reviewBoardTitle: 'Review board',
+    reviewGuideStage: 'Step {index}/{total} · {title}',
+    reviewGuideNext: 'Next: {action}',
+    importReviewDirections: 'Import design directions',
+    importingReviewDirections: 'Importing...',
+    reviewDirectionsImported: 'Placed {count} design directions on the canvas. Circle and annotate, then send to Codex.',
+    reviewDirectionsEmpty: 'No design directions in the current review yet. Ask the agent to generate 3 directions first.',
+    reviewDirectionsFailed: 'Could not load design directions. Try again later.',
+    reviewDirectionSelectedTag: 'Selected',
+    aiImageTemplatesTitle: 'AI image templates',
+    saveCanvas: 'Export file',
+    exportImage: 'Export image',
+    resetCanvas: 'Reset canvas',
+    openLibrary: 'Personal library',
+    blankCard: 'Blank card',
+    savingCanvas: 'Exporting file...',
+    savedCanvas: 'Exported to Downloads: {filename}',
+    openContainingFolder: 'Open folder',
+    openingFolder: 'Opening...',
+    openFolderFailed: 'Could not open the folder. Open the canvas export folder manually.',
+    exportingImage: 'Exporting image...',
+    exportedImage: 'Exported to {path}',
+    emptySceneExportBody: 'There is nothing on the canvas to export yet.',
+    exportSelection: 'Export selection',
+    sendToCodex: 'Send to Codex',
+    sendingToCodex: 'Sending',
+    downloadSelectedImage: 'Download image',
+    downloadingSelectedImage: 'Downloading...',
+    downloadedSelectedImage: 'Downloaded to Downloads: {filename}',
+    downloadSelectedImageFailed: 'Could not download the selected image. Try again in a moment.',
+    sendDisabledTitle: 'Select one or more canvas elements first',
+    languageLabel: 'Language',
+    currentConversationTitle: 'Current conversation',
+    copyThreadPrompt: 'Copy thread prompt',
+    threadPromptCopied: 'Thread prompt copied. You can paste it into another Codex conversation.',
+    threadPromptCopyFailed: 'Could not copy right now. Copy the thread ID manually.',
+    threadPromptTemplate: 'Please locate and work with this OpenPrd canvas conversation thread in Codex.\n\nThread title: {title}\nThread ID: {id}\n\nContinue with this thread: <add your instruction here>',
+    conversation: 'Conversation',
+    placeholderText: 'Drag this blank card, or ask the agent to replace it with an image',
+    libraryItemName: 'Library item {index}',
+    libraryItemCount: '{count} elements',
+    insertedLibraryItem: 'Added to canvas',
+    aiTemplateSquare: 'Avatar / square',
+    aiTemplatePortrait: 'Portrait card',
+    aiTemplateLandscape: 'Landscape image',
+    aiTemplateWide: 'Wide cover',
+    aiTemplateVertical: 'Phone vertical',
+    aiTemplateWechat: 'WeChat cover',
+    aiImageComposerTitle: 'AI image prompt',
+    aiImageTemplateLabel: 'Canvas card ratio',
+    aiImageInstructionLabel: 'Image prompt',
+    aiImageInstructionPlaceholder: 'Describe the image you want, such as: a clean product feature illustration, white background, blue primary button, suitable for a PRD.',
+    createAiImageCard: 'Create card',
+    imagePromptRequired: 'Enter an image prompt first.',
+    imageRequestPrepared: 'AI image card created. The prompt was copied; Codex can generate with Image 2 and fill it back in.',
+    imageRequestSent: 'AI image card created and sent to the current Codex conversation.',
+    imageRequestAgentBridge: 'AI image card created. Automatic sending is unavailable, so it is waiting for the Codex Agent relay.',
+    imageRequestPending: 'AI image card created and is being sent to the current Codex conversation. If it does not appear for a while, copy the prompt manually.',
+    imageRequestManualCopy: 'AI image card created. The prompt was stored on the card; Codex can read it and fill the image back in.',
+    agentBridgePending: 'Automatic sending is unavailable, so this is waiting for the Codex Agent to relay it into the current conversation.',
+    agentBridgeClaimed: 'The Codex Agent claimed this and is sending it into the current conversation.',
+    agentBridgeSent: 'The Codex Agent relayed this into the current conversation.',
+    agentBridgeFailed: 'The Codex Agent foreground relay failed. Copy the prompt manually.',
+    aiGenerating: 'Codex is generating...',
+    aiTemplateOnCanvas: 'Ratio {ratio}, waiting for image',
+    aiImagePromptIntro: 'Use Codex native image generation to create one image and fill this OpenPrd Canvas AI image card.',
+    aiImagePromptMeta: 'Canvas session: {binding}; card ratio: {ratio}; placeholder ID: {placeholderId}',
+    aiImagePromptReturn: 'When the image is ready, fill this placeholder card back into the current canvas with this information:',
+    selectedCount: '{count} selected',
+    sendBarHint: 'Preview the selection, add instructions, then send it to Codex.',
+    composerTitle: 'Send to Codex',
+    previewLabel: 'Selection image',
+    composerPreviewAlt: 'OpenPrd canvas selection image',
+    instructionLabel: 'Instruction',
+    instructionPlaceholder: 'Tell Codex what to do with this screenshot, such as adjust the image based on the markup, explain the issue, or generate the next version.',
+    copiedTitle: 'Ready to send to Codex',
+    copiedBody: 'The selection image was saved and the prompt was copied to your clipboard.',
+    copiedBodyWithRelay: 'The selection image was saved and the prompt was copied; the current Codex agent can relay the handoff into this thread.',
+    copyFailedTitle: 'Selection image saved',
+    copyFailedBody: 'The browser blocked clipboard access. Copy the prompt below manually.',
+    sentBody: 'The selection image and instruction were saved, and the prompt was copied.',
+    sentBodyWithRelay: 'The selection image and instruction were sent to the current Codex conversation.',
+    sentBodyAgentBridge: 'Automatic sending is unavailable, so the selection image and instruction were added to the Codex Agent relay queue.',
+    sentBodyPending: 'The selection image and instruction are being sent to the current Codex conversation. If they do not appear for a while, copy the prompt manually.',
+    sendManualCopyBody: 'The selection image and instruction were saved. The browser blocked clipboard access; use Copy prompt.',
+    sendErrorTitle: 'Could not prepare handoff',
+    emptySelectionTitle: 'Select canvas elements first',
+    emptySelectionBody: 'Select one or more elements, then send them to Codex.',
+    resetConfirm: 'Clear the current canvas? This will be saved to this conversation canvas.',
+    saveFailed: 'Could not save right now. Try again in a moment.',
+    exportFailed: 'Could not export right now. Try again in a moment.',
+    exportPathLabel: 'Image path',
+    promptLabel: 'Prompt to send',
+    copyPrompt: 'Copy prompt',
+    dismiss: 'Dismiss',
+    codexPromptDefaultInstruction: 'Please continue based on this canvas selection.',
+    codexPromptIntro: 'Canvas selection image:',
+    codexPromptMeta: 'Source: OpenPrd Canvas; selected elements: {count}; session: {binding}',
+  },
+};
+
+function normalizeCanvasLocale(locale) {
+  const value = String(locale ?? '').trim().toLowerCase();
+  if (value === 'en' || value.startsWith('en-')) {
+    return 'en';
+  }
+  if (value === 'zh' || value.startsWith('zh-')) {
+    return 'zh-CN';
+  }
+  return CANVAS_DEFAULT_LOCALE;
+}
+
+function defaultCanvasLocaleForLanguages(languages = []) {
+  const values = Array.isArray(languages) ? languages : [languages];
+  for (const value of values) {
+    if (String(value ?? '').trim()) {
+      return normalizeCanvasLocale(value);
+    }
+  }
+  return CANVAS_DEFAULT_LOCALE;
+}
+
+export {
+  CANVAS_DEFAULT_LOCALE,
+  CANVAS_LOCALE_STORAGE_KEY,
+  CANVAS_LOCALES,
+  defaultCanvasLocaleForLanguages,
+  normalizeCanvasLocale,
+};