@synopackageland/cli 0.7.2 → 0.7.3

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## 0.7.3 (2026-10-11)
+
+Rebuild every package built with 0.7.2 that has `i18n.info` translations. In
+0.7.2 its DSM main-menu entry, desktop shortcut and window title showed the raw
+key `synopkgland:app_title` in every language.
+
+### Translated DSM title fix
+
+- `ui/config` entries that use the `synopkgland:app_title` and `app_desc`
+  strings now declare `"texts": "texts"`: the main-menu `app` entry, its window
+  `lib` entry and the `.url` entry of a `synology-app.yaml` app. DSM loads
+  `ui/texts/<DSM language>/strings` only for entries that declare `texts`, so
+  0.7.2 titles never resolved (seen on DSM 7.4 and 7.1.1). Without `i18n.info`
+  `ui/config` is unchanged.
+
+### Correction to 0.7.2
+
+- 0.7.2 said `synology-app.yaml` `i18n.info` localizes the DSM window title.
+  It localizes the DSM main-menu and desktop label only. `launch: dsm-window`
+  adds a main-menu and desktop entry that DSM always opens in a new browser
+  tab, as it does for every URL entry; the app has no DSM window and no window
+  title. This is not caused by DSM's CSRF protection setting. The container app
+  guide and the `synology-app.yaml` reference now say so.
+
+### 繁體中文摘要
+
+- 修正 0.7.2 的在地化標題：有 `i18n.info` 翻譯時，`ui/config` 中使用 `synopkgland:` 字串的
+  `app`、`lib` 與 `.url` 項目都加上 `"texts": "texts"`。0.7.2 少了這個欄位，DSM 不會載入
+  `ui/texts/<語言>/strings`，主選單、桌面捷徑與視窗標題在各語言都顯示 `synopkgland:app_title`。
+- 用 0.7.2 建置且含 `i18n.info` 的套件，請以 0.7.3 重新建置並遞增 build 後重新發佈；沒有
+  `i18n.info` 的套件不受影響。
+- 更正 0.7.2：`synology-app.yaml` 的 `i18n.info` 只翻譯 DSM 主選單與桌面標籤，沒有視窗標題。
+  `launch: dsm-window` 的項目一律由 DSM 在新的瀏覽器分頁開啟（DSM 對所有網址項目都如此），
+  與 CSRF 防護設定無關；容器 App 指南與 `synology-app.yaml` 參考已更正。
+
 ## 0.7.2 (2026-10-11)
 
 Rebuild packages to pick up the new default icon. Packages without `icon` now

package/dist/build-spk/ui-texts.d.ts

@@ -9,10 +9,13 @@ export interface AppTitle {
  * `ui/config` title fields. With translations they are `section:key`
  * references DSM resolves from `ui/texts/<lang>/strings` for the main menu
  * and the window title; without, the literal English text as before.
+ * DSM loads those strings only for entries that declare `texts`. Spread the
+ * result into an entry; absent fields stay out of the JSON.
  */
 export declare function uiTitleFields(app: AppTitle): {
     title: string;
     desc: string;
+    texts?: string;
     preloadTexts?: string[];
 };
 /** `ui/texts/<dsm lang>/strings` for English and every translated language; none without translations. */

package/dist/build-spk/ui-texts.js

@@ -4,6 +4,8 @@ import { DSM_LANGS, LOCALES } from "../standalone/i18n.js";
 const SECTION = "synopkgland";
 const TITLE = `${SECTION}:app_title`;
 const DESC = `${SECTION}:app_desc`;
+/** `ui/` subdirectory with the strings; a `ui/config` entry's `texts` names it relative to `ui/`. */
+const TEXTS_DIR = "texts";
 function translated(app) {
     return Object.values(app.info ?? {}).some((text) => text?.displayname || text?.description);
 }
@@ -11,10 +13,12 @@ function translated(app) {
  * `ui/config` title fields. With translations they are `section:key`
  * references DSM resolves from `ui/texts/<lang>/strings` for the main menu
  * and the window title; without, the literal English text as before.
+ * DSM loads those strings only for entries that declare `texts`. Spread the
+ * result into an entry; absent fields stay out of the JSON.
  */
 export function uiTitleFields(app) {
     return translated(app)
-        ? { title: TITLE, desc: DESC, preloadTexts: [TITLE, DESC] }
+        ? { title: TITLE, desc: DESC, texts: TEXTS_DIR, preloadTexts: [TITLE, DESC] }
         : { title: app.displayname, desc: app.description };
 }
 /** `ui/texts/<dsm lang>/strings` for English and every translated language; none without translations. */
@@ -34,8 +38,8 @@ export function renderUiTexts(app) {
 }
 export function writeUiTexts(uiRoot, app) {
     for (const [lang, strings] of renderUiTexts(app)) {
-        mkdirSync(join(uiRoot, "texts", lang), { recursive: true });
-        const path = join(uiRoot, "texts", lang, "strings");
+        mkdirSync(join(uiRoot, TEXTS_DIR, lang), { recursive: true });
+        const path = join(uiRoot, TEXTS_DIR, lang, "strings");
         writeFileSync(path, strings, "utf8");
         chmodSync(path, 0o644);
     }

package/dist/contract/web-launch.js

@@ -141,15 +141,12 @@ export function renderWebStationResource(contract) {
 }
 export function renderDsmWindowConfig(contract) {
     const packageId = String(contract.package);
-    const { title, desc, preloadTexts } = uiTitleFields(contractAppTitle(contract));
     return `${JSON.stringify({
         ".url": {
             [packageId]: {
                 type: "url",
                 allUsers: true,
-                title,
-                desc,
-                ...(preloadTexts ? { preloadTexts } : {}),
+                ...uiTitleFields(contractAppTitle(contract)),
                 icon: "images/app_{0}.png",
                 url: trustedAppEntryPath(contract),
             },

package/dist/standalone/dsm-window.js

@@ -69,14 +69,12 @@ export function appTitle(manifest) {
 /** `ui/config`: registers the DSM main-menu app and its window class. */
 export function renderUiConfig(manifest) {
     const ns = `SYNO.SDS.${manifest.package}`;
-    const { title, desc, preloadTexts } = uiTitleFields(appTitle(manifest));
+    const titleFields = uiTitleFields(appTitle(manifest));
     return `${JSON.stringify({
         [windowScriptName(manifest)]: {
             [`${ns}.Instance`]: {
                 type: "app",
-                title,
-                desc,
-                ...(preloadTexts ? { preloadTexts } : {}),
+                ...titleFields,
                 icon: "images/app_{0}.png",
                 appWindow: `${ns}.MainWindow`,
                 allowMultiInstance: false,
@@ -85,7 +83,8 @@ export function renderUiConfig(manifest) {
             },
             [`${ns}.MainWindow`]: {
                 type: "lib",
-                title,
+                title: titleFields.title,
+                texts: titleFields.texts,
                 icon: "images/app_{0}.png",
                 depend: [],
             },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synopackageland/cli",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Syno Package Land Developer Kit CLI",
   "type": "module",
   "bin": {