@gjsify/create-app 0.51.1 → 0.53.0

package/dist-templates/adw-canvas2d/package.json

@@ -17,21 +17,21 @@
         "dev": "gjsify dev --runtime gjs"
     },
     "devDependencies": {
-        "@girs/adw-1": "5.0.0",
-        "@girs/gio-2.0": "5.0.0",
-        "@girs/gjs": "5.0.0",
-        "@girs/gobject-2.0": "5.0.0",
-        "@girs/gtk-4.0": "5.0.0",
-        "@gjsify/cli": "^0.51.1",
-        "@gjsify/dom-elements": "^0.51.1",
-        "@gjsify/rolldown-native": "^0.51.1",
-        "@gjsify/vite-plugin-blueprint": "^0.51.1",
+        "@girs/adw-1": "5.4.0",
+        "@girs/gio-2.0": "5.4.0",
+        "@girs/gjs": "5.4.0",
+        "@girs/gobject-2.0": "5.4.0",
+        "@girs/gtk-4.0": "5.4.0",
+        "@gjsify/cli": "^0.53.0",
+        "@gjsify/dom-elements": "^0.53.0",
+        "@gjsify/rolldown-native": "^0.53.0",
+        "@gjsify/vite-plugin-blueprint": "^0.53.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
     "dependencies": {
-        "@gjsify/canvas2d": "^0.51.1",
-        "@gjsify/node-gi": "^0.51.1"
+        "@gjsify/canvas2d": "^0.53.0",
+        "@gjsify/node-gi": "^0.53.0"
     },
     "gjsify": {
         "main": "dist/index.gjs.js",

package/dist-templates/adw-game/package.json

@@ -17,24 +17,24 @@
         "dev": "gjsify dev --runtime gjs"
     },
     "devDependencies": {
-        "@girs/adw-1": "5.0.0",
-        "@girs/gio-2.0": "5.0.0",
-        "@girs/gjs": "5.0.0",
-        "@girs/gobject-2.0": "5.0.0",
-        "@girs/gtk-4.0": "5.0.0",
-        "@gjsify/canvas2d": "^0.51.1",
-        "@gjsify/cli": "^0.51.1",
-        "@gjsify/dom-elements": "^0.51.1",
-        "@gjsify/dom-events": "^0.51.1",
-        "@gjsify/fetch": "^0.51.1",
-        "@gjsify/rolldown-native": "^0.51.1",
-        "@gjsify/vite-plugin-blueprint": "^0.51.1",
+        "@girs/adw-1": "5.4.0",
+        "@girs/gio-2.0": "5.4.0",
+        "@girs/gjs": "5.4.0",
+        "@girs/gobject-2.0": "5.4.0",
+        "@girs/gtk-4.0": "5.4.0",
+        "@gjsify/canvas2d": "^0.53.0",
+        "@gjsify/cli": "^0.53.0",
+        "@gjsify/dom-elements": "^0.53.0",
+        "@gjsify/dom-events": "^0.53.0",
+        "@gjsify/fetch": "^0.53.0",
+        "@gjsify/rolldown-native": "^0.53.0",
+        "@gjsify/vite-plugin-blueprint": "^0.53.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
     "dependencies": {
-        "@gjsify/node-gi": "^0.51.1",
-        "@gjsify/webgl": "^0.51.1",
+        "@gjsify/node-gi": "^0.53.0",
+        "@gjsify/webgl": "^0.53.0",
         "excalibur": "0.32.0"
     },
     "gjsify": {

package/dist-templates/adw-webgl/package.json

@@ -17,22 +17,22 @@
         "dev": "gjsify dev --runtime gjs"
     },
     "devDependencies": {
-        "@girs/adw-1": "5.0.0",
-        "@girs/gio-2.0": "5.0.0",
-        "@girs/gjs": "5.0.0",
-        "@girs/gobject-2.0": "5.0.0",
-        "@girs/gtk-4.0": "5.0.0",
-        "@gjsify/cli": "^0.51.1",
-        "@gjsify/dom-elements": "^0.51.1",
-        "@gjsify/rolldown-native": "^0.51.1",
-        "@gjsify/vite-plugin-blueprint": "^0.51.1",
+        "@girs/adw-1": "5.4.0",
+        "@girs/gio-2.0": "5.4.0",
+        "@girs/gjs": "5.4.0",
+        "@girs/gobject-2.0": "5.4.0",
+        "@girs/gtk-4.0": "5.4.0",
+        "@gjsify/cli": "^0.53.0",
+        "@gjsify/dom-elements": "^0.53.0",
+        "@gjsify/rolldown-native": "^0.53.0",
+        "@gjsify/vite-plugin-blueprint": "^0.53.0",
         "@types/node": "^25.9.2",
         "@types/three": "^0.185.0",
         "typescript": "^6.0.3"
     },
     "dependencies": {
-        "@gjsify/node-gi": "^0.51.1",
-        "@gjsify/webgl": "^0.51.1",
+        "@gjsify/node-gi": "^0.53.0",
+        "@gjsify/webgl": "^0.53.0",
         "three": "0.185.1"
     },
     "gjsify": {

package/dist-templates/cli/package.json

@@ -17,10 +17,10 @@
         "dev": "gjsify dev --runtime gjs"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.51.1",
-        "@gjsify/node-globals": "^0.51.1",
-        "@gjsify/rolldown-native": "^0.51.1",
-        "@gjsify/runtime": "^0.51.1",
+        "@gjsify/cli": "^0.53.0",
+        "@gjsify/node-globals": "^0.53.0",
+        "@gjsify/rolldown-native": "^0.53.0",
+        "@gjsify/runtime": "^0.53.0",
         "@types/node": "^25.9.2",
         "@types/yargs": "^17.0.35",
         "typescript": "^6.0.3"

package/dist-templates/gtk-minimal/README.md

@@ -1,6 +1,20 @@
 # new-gjsify-app
 
-A minimal GTK 4 app — `Gtk.Window` + `Gtk.Label`, no Adwaita, no Blueprint — scaffolded from the gjsify `gtk-minimal` template.
+A minimal GTK 4 app — `Gtk.ApplicationWindow` + `Gtk.Label`, no Adwaita — scaffolded from the
+gjsify `gtk-minimal` template.
+
+The window is declared in `src/main-window.blp` and `src/main-window.ts` holds only logic.
+That split is not decoration: a caption assigned from TypeScript cannot be marked
+`translatable`, so `xgettext` never sees it and the interface is untranslatable by
+construction.
+
+Blueprint needs **no system tool**. `@gjsify/vite-plugin-blueprint` parses the `.blp` and emits
+GtkBuilder XML in process, so `npm run build` asks nothing of your machine beyond GTK 4 itself,
+on any of Linux, macOS and Windows. The compiled interface is inlined into `dist/`, so the built
+app carries it too. The three `adw-*` templates work the same way.
+
+The parser holds a subset of the language, and a construct outside it fails the build naming the
+construct, the file and the line rather than emitting something plausible and wrong.
 
 ## Install
 

package/dist-templates/gtk-minimal/package.json

@@ -1,6 +1,6 @@
 {
     "name": "new-gjsify-app",
-    "description": "Minimal GTK4 app — Gtk.Window + Gtk.Label (no Adwaita, no Blueprint).",
+    "description": "Minimal GTK4 app — Gtk.ApplicationWindow + Gtk.Label, no Adwaita (Blueprint UI).",
     "version": "0.1.0",
     "type": "module",
     "private": true,
@@ -17,16 +17,18 @@
         "dev": "gjsify dev --runtime gjs"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.51.1",
-        "@gjsify/rolldown-native": "^0.51.1",
+        "@gjsify/cli": "^0.53.0",
+        "@gjsify/rolldown-native": "^0.53.0",
+        "@gjsify/vite-plugin-blueprint": "^0.53.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
     "dependencies": {
-        "@girs/gio-2.0": "5.0.0",
-        "@girs/glib-2.0": "5.0.0",
-        "@girs/gtk-4.0": "5.0.0",
-        "@gjsify/node-gi": "^0.51.1"
+        "@girs/gio-2.0": "5.4.0",
+        "@girs/glib-2.0": "5.4.0",
+        "@girs/gobject-2.0": "5.4.0",
+        "@girs/gtk-4.0": "5.4.0",
+        "@gjsify/node-gi": "^0.53.0"
     },
     "gjsify": {
         "main": "dist/index.gjs.js",

package/dist-templates/gtk-minimal/src/index.ts

@@ -1,5 +1,6 @@
 import Gtk from 'gi://Gtk?version=4.0';
 import Gio from 'gi://Gio?version=2.0';
+import { MainWindow } from './main-window.js';
 
 const app = new Gtk.Application({
     applicationId: 'org.gjsify.example',
@@ -7,34 +8,7 @@ const app = new Gtk.Application({
 });
 
 app.connect('activate', () => {
-    const window = new Gtk.ApplicationWindow({
-        application: app,
-        title: 'new-gjsify-app',
-        defaultWidth: 480,
-        defaultHeight: 280,
-    });
-
-    const box = new Gtk.Box({
-        orientation: Gtk.Orientation.VERTICAL,
-        spacing: 12,
-        marginTop: 24,
-        marginBottom: 24,
-        marginStart: 24,
-        marginEnd: 24,
-    });
-
-    const title = new Gtk.Label({ label: 'Hello from gjsify!' });
-    title.add_css_class('title-2');
-
-    const hint = new Gtk.Label({
-        label: `Running on ${process.platform} · PID ${process.pid}`,
-        xalign: 0.5,
-    });
-
-    box.append(title);
-    box.append(hint);
-    window.set_child(box);
-    window.present();
+    new MainWindow(app).present();
 });
 
 app.run([]);

package/dist-templates/gtk-minimal/src/main-window.blp

@@ -0,0 +1,33 @@
+using Gtk 4.0;
+
+template $MainWindow: Gtk.ApplicationWindow {
+  title: "new-gjsify-app";
+  default-width: 480;
+  default-height: 280;
+
+  child: Gtk.Box {
+    orientation: vertical;
+    spacing: 12;
+    margin-top: 24;
+    margin-bottom: 24;
+    margin-start: 24;
+    margin-end: 24;
+
+    Gtk.Label {
+      // `_()` is what makes this reachable for xgettext. The same words assigned from
+      // TypeScript could not be marked translatable at all — that is the whole reason the
+      // tree lives here and not in the callback that used to build it.
+      label: _("Hello from gjsify!");
+
+      styles [
+        "title-2",
+      ]
+    }
+
+    // Named, and left empty: the platform and PID are runtime FACTS, so TypeScript fills
+    // them in. Declaring the container here and populating it there is the intended split.
+    Gtk.Label hint {
+      xalign: 0.5;
+    }
+  };
+}

package/dist-templates/gtk-minimal/src/main-window.ts

@@ -0,0 +1,32 @@
+import GObject from 'gi://GObject?version=2.0';
+import Gtk from 'gi://Gtk?version=4.0';
+import Template from './main-window.blp';
+
+/**
+ * The application window.
+ *
+ * Its whole widget tree is declared in `main-window.blp` rather than built here. That is what
+ * makes the caption translatable — a string assigned from TypeScript is invisible to `xgettext`,
+ * so an interface assembled in code is untranslatABLE while merely looking untranslated.
+ */
+export class MainWindow extends Gtk.ApplicationWindow {
+    declare private _hint: Gtk.Label;
+
+    static {
+        GObject.registerClass(
+            {
+                GTypeName: 'MainWindow',
+                Template,
+                InternalChildren: ['hint'],
+            },
+            this,
+        );
+    }
+
+    constructor(application: Gtk.Application) {
+        super({ application });
+
+        // Runtime facts only. Prose belongs in the template, where extraction can see it.
+        this._hint.set_label(`${process.platform} · PID ${process.pid}`);
+    }
+}

package/dist-templates/gtk-minimal/tsconfig.json

@@ -5,7 +5,14 @@
         "target": "ESNext",
         "module": "NodeNext",
         "moduleResolution": "NodeNext",
-        "types": ["node", "@girs/gtk-4.0", "@girs/gio-2.0", "@girs/glib-2.0"],
+        "types": [
+            "node",
+            "@girs/gtk-4.0",
+            "@girs/gio-2.0",
+            "@girs/glib-2.0",
+            "@girs/gobject-2.0",
+            "@gjsify/vite-plugin-blueprint/types"
+        ],
         "esModuleInterop": true,
         "strict": true,
         "skipLibCheck": true

package/dist-templates/web-server-express/package.json

@@ -17,10 +17,10 @@
         "dev": "gjsify dev --runtime gjs"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.51.1",
-        "@gjsify/node-globals": "^0.51.1",
-        "@gjsify/rolldown-native": "^0.51.1",
-        "@gjsify/runtime": "^0.51.1",
+        "@gjsify/cli": "^0.53.0",
+        "@gjsify/node-globals": "^0.53.0",
+        "@gjsify/rolldown-native": "^0.53.0",
+        "@gjsify/runtime": "^0.53.0",
         "@types/express": "^5.0.6",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"

package/dist-templates/web-server-hono/package.json

@@ -17,10 +17,10 @@
         "dev": "gjsify dev --runtime gjs"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.51.1",
-        "@gjsify/node-globals": "^0.51.1",
-        "@gjsify/rolldown-native": "^0.51.1",
-        "@gjsify/runtime": "^0.51.1",
+        "@gjsify/cli": "^0.53.0",
+        "@gjsify/node-globals": "^0.53.0",
+        "@gjsify/rolldown-native": "^0.53.0",
+        "@gjsify/runtime": "^0.53.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },

package/lib/create.d.ts

@@ -2,7 +2,7 @@ import { type TemplateInfo } from './discover-templates.js';
 import { type PackageManager } from './runtimes.js';
 export { discoverTemplates, findTemplate } from './discover-templates.js';
 export type { TemplateInfo } from './discover-templates.js';
-export { PACKAGE_MANAGERS, INSTALL_ARGV, RUNTIME_PACKAGE_MANAGERS, RUNTIME_DESCRIPTIONS, packageManagersForRuntime, isKnownRuntime, hostRuntime, defaultRuntimeFor, runScriptCommand, startScriptFor, type PackageManager, } from './runtimes.js';
+export { PACKAGE_MANAGERS, INSTALL_ARGV, installCommandLine, RUNTIME_PACKAGE_MANAGERS, RUNTIME_DESCRIPTIONS, packageManagersForRuntime, isKnownRuntime, hostRuntime, defaultRuntimeFor, runScriptCommand, startScriptFor, type PackageManager, } from './runtimes.js';
 export { selectRuntime, selectPackageManager, type Selection } from './select.js';
 export interface CreateProjectOptions {
     projectName: string;

package/lib/create.js

@@ -2,9 +2,9 @@ import { spawnSync } from 'node:child_process';
 import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, cpSync } from 'node:fs';
 import { resolve, join } from 'node:path';
 import { discoverTemplates, findTemplate } from './discover-templates.js';
-import { INSTALL_ARGV, defaultRuntimeFor, hostRuntime, packageManagersForRuntime, runScriptCommand, startScriptFor, } from './runtimes.js';
+import { defaultRuntimeFor, installCommandLine, hostRuntime, packageManagersForRuntime, runScriptCommand, startScriptFor, } from './runtimes.js';
 export { discoverTemplates, findTemplate } from './discover-templates.js';
-export { PACKAGE_MANAGERS, INSTALL_ARGV, RUNTIME_PACKAGE_MANAGERS, RUNTIME_DESCRIPTIONS, packageManagersForRuntime, isKnownRuntime, hostRuntime, defaultRuntimeFor, runScriptCommand, startScriptFor, } from './runtimes.js';
+export { PACKAGE_MANAGERS, INSTALL_ARGV, installCommandLine, RUNTIME_PACKAGE_MANAGERS, RUNTIME_DESCRIPTIONS, packageManagersForRuntime, isKnownRuntime, hostRuntime, defaultRuntimeFor, runScriptCommand, startScriptFor, } from './runtimes.js';
 // Re-exported through the package's `.` entry (which is this file, not
 // `index.ts`) so `gjsify create` can reach the same decisions the standalone bin
 // makes instead of re-deriving them — a second derivation is a second answer.
@@ -110,8 +110,8 @@ export async function createProject(options) {
     cpSync(info.path, targetDir, { recursive: true });
     substituteTemplateSentinels(targetDir, projectName);
     if (install) {
-        const argv = [...INSTALL_ARGV[packageManager]];
-        console.log(`Running ${packageManager} ${argv[0]}...`);
+        const commandLine = installCommandLine(packageManager);
+        console.log(`Running ${commandLine}...`);
         // `shell: true` is what makes this work on Windows, where `npm` is
         // `npm.cmd`: `CreateProcess` appends only `.exe` when it searches PATH
         // for a bare name, so `spawnSync('npm', …)` is ENOENT there — and
@@ -122,8 +122,10 @@ export async function createProject(options) {
         // `@gjsify/cli`'s `utils/spawn.ts` sanctions for exactly this case. It
         // applies to every manager here: npm/yarn/pnpm/gjsify ship as `.cmd`
         // shims on Windows, and bun/deno as `.exe`, which the bare-name search
-        // finds — but the shell path is correct for both and costs nothing.
-        const result = spawnSync(packageManager, argv, {
+        // finds — but the shell path is correct for both and costs nothing. The
+        // command goes in as one LINE, not an argv: `shell` plus an args array is
+        // DEP0190 (see `installCommandLine`).
+        const result = spawnSync(commandLine, {
             cwd: targetDir,
             stdio: 'inherit',
             shell: true,

package/lib/discover-templates.js

@@ -42,7 +42,7 @@ function resolveTemplatesRoot() {
     return candidates.find((c) => existsSync(c));
 }
 const FALLBACK_DESCRIPTIONS = {
-    'gtk-minimal': 'Minimal GTK4 app — Gtk.Window + Gtk.Label (no Adwaita, no Blueprint).',
+    'gtk-minimal': 'Minimal GTK4 app — Gtk.ApplicationWindow + Gtk.Label, no Adwaita (Blueprint UI).',
     cli: 'Command-line tool using yargs (Node.js + GJS).',
     'adw-canvas2d': 'Adwaita app with HTML Canvas 2D rendering (Blueprint UI).',
     'adw-webgl': 'Adwaita app with WebGL + three.js (Blueprint UI).',

package/lib/runtimes.d.ts

@@ -14,6 +14,17 @@ export type PackageManager = (typeof PACKAGE_MANAGERS)[number];
  * install-a-script mode.
  */
 export declare const INSTALL_ARGV: Record<PackageManager, readonly string[]>;
+/**
+ * The install as ONE shell command line, for `spawnSync(line, { shell: true })`.
+ *
+ * The shell is what finds the `.cmd` shims npm/yarn/pnpm/gjsify are on Windows (see
+ * `createProject`). Handing it an argv array as well is Node's DEP0190: with
+ * `shell: true` the array is only concatenated, never escaped, so Node 24 warns on
+ * every call and a later major refuses it. Joining here is safe because every token
+ * is a fixed flag from {@link INSTALL_ARGV}, and the spec holds each one to a
+ * character set neither `sh` nor `cmd.exe` gives a meaning to.
+ */
+export declare function installCommandLine(manager: PackageManager): string;
 /** The command prefix that runs a package script under `manager`. */
 export declare function runScriptCommand(manager: PackageManager): string;
 /**

package/lib/runtimes.js

@@ -37,6 +37,19 @@ export const INSTALL_ARGV = {
     bun: ['install'],
     deno: ['install'],
 };
+/**
+ * The install as ONE shell command line, for `spawnSync(line, { shell: true })`.
+ *
+ * The shell is what finds the `.cmd` shims npm/yarn/pnpm/gjsify are on Windows (see
+ * `createProject`). Handing it an argv array as well is Node's DEP0190: with
+ * `shell: true` the array is only concatenated, never escaped, so Node 24 warns on
+ * every call and a later major refuses it. Joining here is safe because every token
+ * is a fixed flag from {@link INSTALL_ARGV}, and the spec holds each one to a
+ * character set neither `sh` nor `cmd.exe` gives a meaning to.
+ */
+export function installCommandLine(manager) {
+    return [manager, ...INSTALL_ARGV[manager]].join(' ');
+}
 /**
  * How each manager spells "run the package script `<name>`" — six managers, four
  * spellings. Printing the one the user's manager accepts is why the choice is

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/create-app",
-    "version": "0.51.1",
+    "version": "0.53.0",
     "description": "Create a new Gjsify project",
     "type": "module",
     "main": "lib/create.js",
@@ -28,7 +28,7 @@
         "test:gjs": "gjsify run test.gjs.mjs",
         "test:node": "node test.node.mjs",
         "test:bun": "bun test.node.mjs",
-        "test:deno": "deno run -A --no-lock --node-modules-dir=none test.node.mjs",
+        "test:deno": "deno run -A --no-lock --node-modules-dir=none --min-dep-age=0 test.node.mjs",
         "test:cross-runtime": "gjsify run build:test && gjsify run test:gjs && gjsify run test:node && gjsify run test:bun && gjsify run test:deno"
     },
     "keywords": [
@@ -46,9 +46,9 @@
         "yargs": "^18.0.0"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.51.1",
-        "@gjsify/rolldown-plugin-gjsify": "^0.51.1",
-        "@gjsify/unit": "^0.51.1",
+        "@gjsify/cli": "^0.53.0",
+        "@gjsify/rolldown-plugin-gjsify": "^0.53.0",
+        "@gjsify/unit": "^0.53.0",
         "@types/node": "^25.9.2",
         "@types/yargs": "^17.0.35",
         "typescript": "^6.0.3"