@synopackageland/templates 0.13.1 → 0.14.0

package/README.md

@@ -38,11 +38,11 @@ calls each one from the generated script of the same name (`synopkgland skill sh
 The placeholders `__PACKAGE__` (also the Go module path), `__DISPLAY_NAME__` and
 `__BACKGROUND_ENABLED__` are substituted by `init`.
 
-`backend/go.mod` requires `github.com/synopackageland/syno-pkg-land-sdk v0.13.1`; that line is
+`backend/go.mod` requires `github.com/synopackageland/syno-pkg-land-sdk v0.14.0`; that line is
 the single source of the SDK version and `frontend/package.json` pins
 `@synopackageland/sdk` to the same version. Python and Node.js name it in
 `backend.sdk`, Rust in the `syno-pkg-land-app` tag of `backend/Cargo.toml`
-(and `Cargo.lock`); all of them pin 0.13.1. The Vue frontend pins
+(and `Cargo.lock`); all of them pin 0.14.0. The Vue frontend pins
 `@synopackageland/ui` 0.11.0.
 
 ## Notice writer
@@ -106,3 +106,35 @@ SDK usage, protocol and API documentation: <https://github.com/synopackageland/s
 
 MIT, see [LICENSE](LICENSE). Generated projects receive
 `templates/_shared/LICENSES/TEMPLATE.txt`.
+
+## App launch mode
+
+Native Apps declare `ui.launch: dsm-window | new-page` in `dsm-package.yaml`.
+Use `dsm-window` for frontends built with `@synopackageland/ui`; use `new-page`
+for every other frontend. Plain/binary scaffolds explicitly choose new-page; Vue uses the native default. An omitted
+native `ui.launch` resolves to `dsm-window`; the CLI does not guess a frontend's
+framework from its build command. `new-page` registers DSM `type: "standalone"`,
+so the main menu and Package Center open a full page on the DSM origin.
+`ctx.fullPage`, `ctx.appIcon`, session/SynoToken, launch parameters and entry
+permissions use the same wrapper in both modes. The wrapper sets the standalone
+page title, favicon and device-width viewport. It retains ExtJS; `pureEnv` is
+not appropriate, and alternate Portal ports are not needed (`allowAltPort` is omitted).
+
+A full page does not need Application Portal. Omit `portal` unless an alias is
+explicitly wanted; only that opt-in adds `defaultAlias`, login styling, Portal
+panels and capabilities. No Portal is a healthy default for inspect/info/doctor.
+
+Web service Apps declare `integration.web.launch`; its built-in default is `new-page`.
+Native SDK Apps default to `dsm-window`; non-UI-SDK native frontends must
+explicitly set `ui.launch: new-page`. Headless Compose Apps have no launcher.
+The new-page main menu uses `type: "standalone"` with an explicit `url` at the existing trusted entry: the authenticated
+gateway, or a Web Station alias only with explicit `access: public`. DSM WindowLauncher opens that explicit URL directly; a web service does not
+need an AppInstance/AppWindow JS class.
+Authenticated web Apps do not create a Web Station alias or Application Portal.
+`dsm-window` remains an explicit web launch option with its URL launcher.
+
+Schema 2 `dsm-package.yaml` with `identity_gateway` and `compose` is also a web
+service: omitted `ui.launch` resolves to `new-page`, without Application Portal.
+Both Compose routes share `contract/app-launch.ts` for defaults and launcher types.
+An explicit `ui.launch` overrides this default. Native SDK Apps without a web
+service keep `dsm-window` when `ui.launch` is absent.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synopackageland/templates",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "description": "Project templates for synopkgland init: native-go, native-python, native-node and native-rust (plain or Vue, with jobs, delegate and root-ops overlays), binary and compose.",
   "license": "MIT",
   "repository": {"type": "git", "url": "git+https://github.com/synopackageland/syno-pkg-land-templates.git"},

package/templates/_shared/AGENTS.md

@@ -310,3 +310,35 @@ their capabilities with `synopkgland init --with`.
   `cargo clippy --locked --all-targets -- -D warnings` and `cargo fmt --check`;
   `test_support::call` plays the runtime. `rust-toolchain.toml` pins the
   toolchain and the DSM targets; keep `Cargo.lock` committed.
+
+## App launch mode
+
+Native Apps declare `ui.launch: dsm-window | new-page` in `dsm-package.yaml`.
+Use `dsm-window` for frontends built with `@synopackageland/ui`; use `new-page`
+for every other frontend. Plain/binary scaffolds explicitly choose new-page; Vue uses the native default. An omitted
+native `ui.launch` resolves to `dsm-window`; the CLI does not guess a frontend's
+framework from its build command. `new-page` registers DSM `type: "standalone"`,
+so the main menu and Package Center open a full page on the DSM origin.
+`ctx.fullPage`, `ctx.appIcon`, session/SynoToken, launch parameters and entry
+permissions use the same wrapper in both modes. The wrapper sets the standalone
+page title, favicon and device-width viewport. It retains ExtJS; `pureEnv` is
+not appropriate, and alternate Portal ports are not needed (`allowAltPort` is omitted).
+
+A full page does not need Application Portal. Omit `portal` unless an alias is
+explicitly wanted; only that opt-in adds `defaultAlias`, login styling, Portal
+panels and capabilities. No Portal is a healthy default for inspect/info/doctor.
+
+Web service Apps declare `integration.web.launch`; its built-in default is `new-page`.
+Native SDK Apps default to `dsm-window`; non-UI-SDK native frontends must
+explicitly set `ui.launch: new-page`. Headless Compose Apps have no launcher.
+The new-page main menu uses `type: "standalone"` with an explicit `url` at the existing trusted entry: the authenticated
+gateway, or a Web Station alias only with explicit `access: public`. DSM WindowLauncher opens that explicit URL directly; a web service does not
+need an AppInstance/AppWindow JS class.
+Authenticated web Apps do not create a Web Station alias or Application Portal.
+`dsm-window` remains an explicit web launch option with its URL launcher.
+
+Schema 2 `dsm-package.yaml` with `identity_gateway` and `compose` is also a web
+service: omitted `ui.launch` resolves to `new-page`, without Application Portal.
+Both Compose routes share `contract/app-launch.ts` for defaults and launcher types.
+An explicit `ui.launch` overrides this default. Native SDK Apps without a web
+service keep `dsm-window` when `ui.launch` is absent.

package/templates/binary/dsm-package.yaml

@@ -36,7 +36,7 @@ backend:
   files:
     x86_64: prebuilt/api-x86_64
     aarch64: prebuilt/api-aarch64
-ui: {dir: ui}
+ui: {dir: ui, launch: new-page}
 # UI languages: i18n/messages/<locale>.json for en, zh-TW, zh-CN, ja, ko, de,
 # fr, es and it (DSM's other languages fall back to English); ctx.t(key) reads them.
 i18n:

package/templates/compose/synology-app.yaml

@@ -14,3 +14,9 @@ install:
     type: shared_folder
   RUN_AS:
     type: dsm_user
+
+# For a web frontend, declare adminport/adminurl and explicitly choose:
+# integration:
+#   web:
+#     launch: new-page
+# No Application Portal declaration is needed. Omitted web launch means new-page.

package/templates/native-go/backend/THIRD_PARTY_NOTICES.txt

@@ -1,6 +1,6 @@
 Native Go package build dependencies
 
-github.com/synopackageland/syno-pkg-land-sdk v0.13.1 (MIT)
+github.com/synopackageland/syno-pkg-land-sdk v0.14.0 (MIT)
 
 Copyright (c) 2026 synopkgland
 

package/templates/native-go/backend/go.mod

@@ -4,6 +4,6 @@ go 1.25.0
 
 toolchain go1.26.9
 
-require github.com/synopackageland/syno-pkg-land-sdk v0.13.1
+require github.com/synopackageland/syno-pkg-land-sdk v0.14.0
 
 require golang.org/x/sys v0.44.0 // indirect

package/templates/native-go/backend/go.sum

@@ -1,4 +1,4 @@
-github.com/synopackageland/syno-pkg-land-sdk v0.13.1 h1:TzAYoaHqPomI6qaTDOiT2wbVU2540ZnFJ4Q90yNXpH4=
-github.com/synopackageland/syno-pkg-land-sdk v0.13.1/go.mod h1:hlsvaVuH2wsAoR8jzI1Rg/NeejQSFpAaN6zpIWsVbjI=
+github.com/synopackageland/syno-pkg-land-sdk v0.14.0 h1:xPsMRsmqtzFT+XWHe8esk1yHMAOztKbaPkCGr2I2DqI=
+github.com/synopackageland/syno-pkg-land-sdk v0.14.0/go.mod h1:hlsvaVuH2wsAoR8jzI1Rg/NeejQSFpAaN6zpIWsVbjI=
 golang.org/x/sys v0.44.0 h1:ildZl3J4uzeKP07r2F++Op7E9B29JRUy+a27EibtBTQ=
 golang.org/x/sys v0.44.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=

package/templates/native-go/dsm-package.yaml

@@ -44,6 +44,8 @@ backend:
   main: ./cmd/app
 
 ui:
+  # Non-UI-SDK frontends open a full page; Portal is a separate opt-in.
+  launch: new-page
   # Static files served at /webman/3rdparty/<package>/app/. app.js and app.css
   # are required; anything else (images, chunks) is copied as is.
   dir: ui

package/templates/native-go-vue/frontend/package-lock.json

@@ -7,8 +7,8 @@
       "name": "native-dsm-vue-app",
       "dependencies": {
         "@lucide/vue": "1.48.0",
-        "@synopackageland/sdk": "0.13.1",
-        "@synopackageland/ui": "0.11.0",
+        "@synopackageland/sdk": "0.14.0",
+        "@synopackageland/ui": "0.11.4",
         "vue": "3.5.43"
       },
       "devDependencies": {
@@ -1148,8 +1148,8 @@
       }
     },
     "node_modules/@synopackageland/sdk": {
-      "version": "0.13.1",
-      "resolved": "https://registry.npmjs.org/@synopackageland/sdk/-/sdk-0.13.1.tgz",
+      "version": "0.14.0",
+      "resolved": "https://registry.npmjs.org/@synopackageland/sdk/-/sdk-0.14.0.tgz",
       "integrity": "sha512-Uw7T2jMXTb7SQogej2GjVeCQC4baoneoDolt5cjxl+Buqjw5a+Sd4/8FpLTMTdIzKZSwJYTVVegagTXBh1r30Q==",
       "license": "MIT",
       "peerDependencies": {
@@ -1167,9 +1167,9 @@
       }
     },
     "node_modules/@synopackageland/ui": {
-      "version": "0.11.0",
-      "resolved": "https://registry.npmjs.org/@synopackageland/ui/-/ui-0.11.0.tgz",
-      "integrity": "sha512-uPy/GQhbXPMZ6C/2iW023EDNaMVjnPx7TH+Jp5n7yauPgf2fpSD/z/zjioNX7uO7lAGmq3FEV1VOMLRK6R4cXQ==",
+      "version": "0.11.4",
+      "resolved": "https://registry.npmjs.org/@synopackageland/ui/-/ui-0.11.4.tgz",
+      "integrity": "sha512-UODxAk0tL79e8tZbNALyjsLEWF9Rf0VgVllOgdUimAYy/xQwFSUKAXIL9KcVVsyXmElHV5NcgRYGLu/C2ggRzg==",
       "license": "MIT",
       "dependencies": {
         "@internationalized/date": "3.12.4",

package/templates/native-go-vue/frontend/package.json

@@ -8,8 +8,8 @@
   },
   "dependencies": {
     "@lucide/vue": "1.48.0",
-    "@synopackageland/sdk": "0.13.1",
-    "@synopackageland/ui": "0.11.0",
+    "@synopackageland/sdk": "0.14.0",
+    "@synopackageland/ui": "0.11.4",
     "vue": "3.5.43"
   },
   "devDependencies": {

package/templates/native-node/dsm-package.yaml

@@ -49,10 +49,12 @@ backend:
   runtime: node
   dir: backend/app
   entry: main.js
-  sdk: 0.13.1
+  sdk: 0.14.0
   node: { package: Node.js_v20 }
 
 ui:
+  # Non-UI-SDK frontends open a full page; Portal is a separate opt-in.
+  launch: new-page
   # Static files served at /webman/3rdparty/<package>/app/. app.js and app.css
   # are required; anything else (images, chunks) is copied as is.
   dir: ui

package/templates/native-python/dsm-package.yaml

@@ -47,9 +47,11 @@ backend:
   runtime: python
   dir: backend/app
   entry: main.py
-  sdk: 0.13.1
+  sdk: 0.14.0
 
 ui:
+  # Non-UI-SDK frontends open a full page; Portal is a separate opt-in.
+  launch: new-page
   # Static files served at /webman/3rdparty/<package>/app/. app.js and app.css
   # are required; anything else (images, chunks) is copied as is.
   dir: ui

package/templates/native-rust/backend/Cargo.lock

@@ -104,8 +104,8 @@ dependencies = [
 
 [[package]]
 name = "syno-pkg-land-app"
-version = "0.13.1"
-source = "git+https://github.com/synopackageland/syno-pkg-land-sdk?tag=v0.13.1#f1f6d41cfac35123b8833ffd131ad4dd5c41ecf3"
+version = "0.14.0"
+source = "git+https://github.com/synopackageland/syno-pkg-land-sdk?tag=v0.14.0#2f31d2af7eebc8efb97e628cf30e8993d19e1d67"
 dependencies = [
  "libc",
  "serde",

package/templates/native-rust/backend/Cargo.toml

@@ -9,7 +9,7 @@ libc = "0.2"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 # The SDK version is the tag; `synopkgland check` reads it from Cargo.lock.
-syno-pkg-land-app = { git = "https://github.com/synopackageland/syno-pkg-land-sdk", tag = "v0.13.1" }
+syno-pkg-land-app = { git = "https://github.com/synopackageland/syno-pkg-land-sdk", tag = "v0.14.0" }
 
 [profile.release]
 # A handler panic becomes an "internal" reply; abort would end the App without one.

package/templates/native-rust/dsm-package.yaml

@@ -51,6 +51,8 @@ backend:
   methods: [app.status, greeting.get, greeting.set]
 
 ui:
+  # Non-UI-SDK frontends open a full page; Portal is a separate opt-in.
+  launch: new-page
   # Static files served at /webman/3rdparty/<package>/app/. app.js and app.css
   # are required; anything else (images, chunks) is copied as is.
   dir: ui