@synopackageland/cli 0.24.1 → 0.25.1

package/skills/SKILL.md

@@ -27,6 +27,18 @@ Read [reference/ui-vue.md](reference/ui-vue.md) when editing Vue components in t
 
 Read [reference/ui-json.md](reference/ui-json.md) when generating or editing JSON UI; discover the installed catalog, validate the spec, then render and fix layout issues.
 
+## UI copywriting
+
+For UI/locale strings we author in the SDK, UI package, templates and our own
+Apps, remove the final sentence-ending period in every language, even from
+multi-sentence text; keep periods between sentences. Preserve question marks,
+exclamation marks, ellipses, abbreviations, version numbers, URLs and trailing
+`{key}` placeholders. In upstream forks, apply this only to UI copy we add under
+`synology/` (such as DSM install wizards and gateway pages); leave upstream
+UI/locale strings and release notes unchanged. See
+[Vue copy and i18n](reference/ui-vue.md#ui-copy-and-i18n) and
+[JSON copy and i18n](reference/ui-json.md#ui-copy-and-i18n) for examples.
+
 For UI discovery, run `npx --no syno-pkg-land-ui catalog --json` and
 `npx --no syno-pkg-land-ui describe Button --json` from the installed frontend.
 Read its prompt and exported Vue docs/types before choosing component APIs.
@@ -155,6 +167,15 @@ Application Portal 是獨立 opt-in：不想要別名就省略 `portal`，不生
 `defaultAlias`、Portal 面板／capability 或 Web Station alias；沒有 Portal
 不是 inspect／info／doctor 問題。明確啟用 `portal` 時才將其 alias 作為 `defaultAlias`。
 
+宣告 `console` 的 App 在主選單有兩個圖示，適用於包裝開源專案、又有額外整合操作的 App。
+原生圖示叫 `displayname`，是 `type: "url"`，經 `sso/open.cgi` 在新分頁開原生 UI。
+主控台預設叫「<displayname> for DSM」，是只給管理員的 `type: "app"` DSM 視窗，掛載 `ui.dir` 的 SDK UI。
+套件中心「開啟」（INFO `dsmapplaunchname`）開主控台；Application Privileges 只列出原生圖示。
+`console: {}` 用預設名稱，`console: { title: "<名稱>" }` 覆寫所有語系。
+省略 `console` 維持單一圖示。`console` 必須搭配 `identity_gateway` 與 SDK UI；
+compose App、沒有 gateway 的 App、`ui.launch` 或 `portal` 都會被 check 拒絕。
+冷登入由 url 圖示經 `open.cgi` 續接，`oidc.browser` 需要支援此續接的 SDK。
+
 Schema 2 Compose 使用 `dsm-package.yaml` 的 `compose.files`、`compose.web` 與
 `identity_gateway`；不使用 file/targets/address_env 或手寫 upstream。
 省略 `ui.launch` 時預設 `new-page`，使用 SDK standalone launcher，不帶 Application Portal。

package/skills/reference/portal.md

@@ -57,6 +57,15 @@ Application Portal 是獨立 opt-in：不想要別名就省略 `portal`，不生
 `defaultAlias`、Portal 面板／capability 或 Web Station alias；沒有 Portal
 不是 inspect／info／doctor 問題。明確啟用 `portal` 時才將其 alias 作為 `defaultAlias`。
 
+宣告 `console` 的 App 在主選單有兩個圖示，適用於包裝開源專案、又有額外整合操作的 App。
+原生圖示叫 `displayname`，是 `type: "url"`，經 `sso/open.cgi` 在新分頁開原生 UI。
+主控台預設叫「<displayname> for DSM」，是只給管理員的 `type: "app"` DSM 視窗，掛載 `ui.dir` 的 SDK UI。
+套件中心「開啟」（INFO `dsmapplaunchname`）開主控台；Application Privileges 只列出原生圖示。
+`console: {}` 用預設名稱，`console: { title: "<名稱>" }` 覆寫所有語系。
+省略 `console` 維持單一圖示。`console` 必須搭配 `identity_gateway` 與 SDK UI；
+compose App、沒有 gateway 的 App、`ui.launch` 或 `portal` 都會被 check 拒絕。
+冷登入由 url 圖示經 `open.cgi` 續接，`oidc.browser` 需要支援此續接的 SDK。
+
 Docker／web service App 設定 `integration.web.launch`，內建預設是 `new-page`；
 省略開啟方式時直接開新分頁，不宣告 Application Portal。SDK 原生 App
 省略時使用 `dsm-window`；非 UI SDK 原生 App 必須明確寫 `ui.launch: new-page`。

package/skills/reference/ui-json.md

@@ -25,6 +25,35 @@ every state path you bind. Use only catalog components and real app-owned action
 computed functions and message keys. Keep NAS pickers, native DSM bridges,
 authorization, polling and domain-specific views in Vue/TypeScript extensions.
 
+## UI copy and i18n
+
+Use the same [UI copy rule as Vue](ui-vue.md#ui-copy-and-i18n) for literal
+display text in JSON specs and the locale catalogs behind message keys. It
+applies to copy we author in the SDK, UI package, templates and our own Apps.
+In upstream forks, only our added UI copy under `synology/` (for example DSM
+install wizards and gateway pages) is in scope. Leave upstream UI/locale
+strings and release notes unchanged; any future checker must exclude upstream
+source and scan only our owned files.
+
+In every language, remove the final sentence-ending period (`.`, `。`, `．`),
+even when the string contains multiple sentences. Preserve periods between
+sentences. Keep question marks, exclamation marks, ellipses (`…`, `...`),
+abbreviations such as `etc.`, version numbers, URLs and trailing `{key}`
+placeholders intact. Apply the rule to each translation and plural form, not
+to message keys, action names, URLs or other non-display spec data.
+
+| Avoid (message value) | Use (message value) |
+| --- | --- |
+| `"Saved."` | `"Saved"` |
+| `"Try again. Contact support if it still fails."` | `"Try again. Contact support if it still fails"` |
+| `"請稍後再開。若一直打不開，請聯絡送審的人。"` | `"請稍後再開。若一直打不開，請聯絡送審的人"` |
+| `"保存しました。"` | `"保存しました"` |
+
+Keep `"Continue?"`, `"Done!"`, `"Loading…"`, `"Loading..."`, `"Images, etc."`,
+`"Version {version}"`, `"https://example.com"` and `"Saved to {folder}"` unchanged.
+Use a script for bulk corrections rather than editing entries one by one.
+This is authoring guidance; it does not add validation to the commands below.
+
 ## Validate, fix, render
 
 After saving the generated spec as `ui.json`, run:

package/skills/reference/ui-vue.md

@@ -73,6 +73,38 @@ the first screen waits for the startup chain, not the bundle:
 - Start polling on its schedule; do not repeat at mount a read startup just
   made. Delay background sampling that the first screen does not need.
 
+## UI copy and i18n
+
+Apply this rule to UI strings we author in the SDK, UI package, templates and
+our own Apps, whether in locale catalogs or inline Vue/TypeScript copy: buttons,
+titles, labels, field descriptions, hints, toasts and error messages. In an
+upstream fork, apply it only to our added UI copy under `synology/`, including
+DSM install wizards and gateway pages. Never rewrite upstream UI/locale strings
+to match this style; preserve them for future upstream merges. Release notes
+are outside this UI-copy rule.
+
+Remove only the final sentence-ending period, including `.` and fullwidth
+periods such as `。` and `．`, in every language. This applies to both single-
+and multi-sentence strings. Keep sentence-separating periods inside the string.
+Preserve question marks (`?`, `？`), exclamation marks (`!`, `！`), ellipses
+(`…`, `...`), abbreviations such as `etc.`, version numbers, URLs and trailing
+`{key}` placeholders; do not trim dots indiscriminately or alter substituted
+values.
+
+| Avoid | Use |
+| --- | --- |
+| `Save.` | `Save` |
+| `Try again later. If it still fails, contact support.` | `Try again later. If it still fails, contact support` |
+| `請稍後再開。若一直打不開，請聯絡送審的人。` | `請稍後再開。若一直打不開，請聯絡送審的人` |
+| `設定を保存しました。` | `設定を保存しました` |
+
+Keep these unchanged: `Continue?`, `Done!`, `Loading…`, `Loading...`,
+`Images, videos, etc.`, `Version {version}`, `https://example.com` and
+`Saved to {folder}`. Preserve internal punctuation in every translation and
+plural form. For bulk copy corrections, use a script rather than editing each
+entry by hand. Any future punctuation checker must scan only our owned files,
+excluding upstream source; this guidance does not add a CLI check or gate.
+
 ## Verify the actual Vue app
 
 From `frontend`, run:
@@ -124,6 +156,15 @@ Application Portal 是獨立 opt-in：不想要別名就省略 `portal`，不生
 `defaultAlias`、Portal 面板／capability 或 Web Station alias；沒有 Portal
 不是 inspect／info／doctor 問題。明確啟用 `portal` 時才將其 alias 作為 `defaultAlias`。
 
+宣告 `console` 的 App 在主選單有兩個圖示，適用於包裝開源專案、又有額外整合操作的 App。
+原生圖示叫 `displayname`，是 `type: "url"`，經 `sso/open.cgi` 在新分頁開原生 UI。
+主控台預設叫「<displayname> for DSM」，是只給管理員的 `type: "app"` DSM 視窗，掛載 `ui.dir` 的 SDK UI。
+套件中心「開啟」（INFO `dsmapplaunchname`）開主控台；Application Privileges 只列出原生圖示。
+`console: {}` 用預設名稱，`console: { title: "<名稱>" }` 覆寫所有語系。
+省略 `console` 維持單一圖示。`console` 必須搭配 `identity_gateway` 與 SDK UI；
+compose App、沒有 gateway 的 App、`ui.launch` 或 `portal` 都會被 check 拒絕。
+冷登入由 url 圖示經 `open.cgi` 續接，`oidc.browser` 需要支援此續接的 SDK。
+
 Docker／web service App 設定 `integration.web.launch`，內建預設是 `new-page`；
 省略開啟方式時直接開新分頁，不宣告 Application Portal。SDK 原生 App
 省略時使用 `dsm-window`；非 UI SDK 原生 App 必須明確寫 `ui.launch: new-page`。

package/skills/reference/upstream-fork.md

@@ -6,6 +6,11 @@ Never edit upstream README, Dockerfile, source, config, workflows or ignore file
 Do not rewrite the App or treat it as an SDK component. Use `.git/info/exclude`
 for local output when needed.
 
+Apply the [UI copy rule](ui-vue.md#ui-copy-and-i18n) only to UI strings we add
+under `synology/`, such as DSM install wizards and gateway pages; leave upstream
+UI/locale strings and release notes unchanged, and exclude upstream source from
+any future punctuation checker.
+
 ## Decide whether to expose AI control
 
 Ask whether the user needs AI control unless they have already explicitly requested it.