@gjsify/create-app 0.52.0 → 0.54.0

package/README.md

@@ -57,10 +57,10 @@ one flag whose default would reach your disk.
 
 | Template | |
 |---|---|
-| `gtk-minimal` | `Gtk.Window` + `Gtk.Label`; no Adwaita, no Blueprint. |
+| `gtk-minimal` | `Gtk.ApplicationWindow` declared in Blueprint; no Adwaita. |
 | `adw-canvas2d` | Adwaita app rendering through the HTML Canvas 2D API (Blueprint UI). |
 | `adw-webgl` | Adwaita app rendering through WebGL + three.js (Blueprint UI). |
-| `adw-game` | Adwaita game shell on Excalibur.js; WebGL with a Canvas 2D fallback. |
+| `adw-game` | Adwaita game shell on Excalibur.js; WebGL with a Canvas 2D fallback (Blueprint UI). |
 | `cli` | Command-line tool using yargs. |
 | `web-server-hono` | HTTP server using Hono (Web-standard fetch-style API). |
 | `web-server-express` | HTTP server using Express. |

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

@@ -0,0 +1,13 @@
+{
+    "$schema": "./node_modules/oxlint/configuration_schema.json",
+    "categories": {
+        "correctness": "error"
+    },
+    "jsPlugins": [
+        "@gjsify/oxlint-plugin-gjsify"
+    ],
+    "rules": {
+        "gjsify/prefer-blueprint-template": "error",
+        "gjsify/no-literal-widget-label": "error"
+    }
+}

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

@@ -22,16 +22,17 @@
         "@girs/gjs": "5.4.0",
         "@girs/gobject-2.0": "5.4.0",
         "@girs/gtk-4.0": "5.4.0",
-        "@gjsify/cli": "^0.52.0",
-        "@gjsify/dom-elements": "^0.52.0",
-        "@gjsify/rolldown-native": "^0.52.0",
-        "@gjsify/vite-plugin-blueprint": "^0.52.0",
+        "@gjsify/cli": "^0.54.0",
+        "@gjsify/dom-elements": "^0.54.0",
+        "@gjsify/oxlint-plugin-gjsify": "^0.54.0",
+        "@gjsify/rolldown-native": "^0.54.0",
+        "@gjsify/vite-plugin-blueprint": "^0.54.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
     "dependencies": {
-        "@gjsify/canvas2d": "^0.52.0",
-        "@gjsify/node-gi": "^0.52.0"
+        "@gjsify/canvas2d": "^0.54.0",
+        "@gjsify/node-gi": "^0.54.0"
     },
     "gjsify": {
         "main": "dist/index.gjs.js",

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

@@ -0,0 +1,13 @@
+{
+    "$schema": "./node_modules/oxlint/configuration_schema.json",
+    "categories": {
+        "correctness": "error"
+    },
+    "jsPlugins": [
+        "@gjsify/oxlint-plugin-gjsify"
+    ],
+    "rules": {
+        "gjsify/prefer-blueprint-template": "error",
+        "gjsify/no-literal-widget-label": "error"
+    }
+}

package/dist-templates/adw-game/README.md

@@ -2,6 +2,15 @@
 
 An Adwaita game shell built on Excalibur.js, WebGL with a Canvas 2D fallback, scaffolded from the gjsify `adw-game` template.
 
+The window is declared in `src/main-window.blp` and `src/main-window.ts` holds only logic. That
+split is what makes the caption translatable: a string assigned from TypeScript carries no
+`translatable` attribute, so `xgettext` never sees it and the interface is untranslatable by
+construction. The drawing surface is the deliberate exception — it is a runtime object with no
+place in a template, so the `.blp` declares the empty container and the constructor appends it.
+
+Blueprint needs **no system tool**. `@gjsify/vite-plugin-blueprint` parses the `.blp` in process and
+emits GtkBuilder XML, so `npm run build` asks nothing of your machine beyond GTK 4 itself.
+
 ## Install
 
 ```bash

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

@@ -1,6 +1,6 @@
 {
     "name": "new-gjsify-app",
-    "description": "Adwaita game shell using Excalibur.js, WebGL → Canvas2D fallback.",
+    "description": "Adwaita game shell using Excalibur.js, WebGL → Canvas2D fallback (Blueprint UI).",
     "version": "0.1.0",
     "type": "module",
     "private": true,
@@ -22,19 +22,20 @@
         "@girs/gjs": "5.4.0",
         "@girs/gobject-2.0": "5.4.0",
         "@girs/gtk-4.0": "5.4.0",
-        "@gjsify/canvas2d": "^0.52.0",
-        "@gjsify/cli": "^0.52.0",
-        "@gjsify/dom-elements": "^0.52.0",
-        "@gjsify/dom-events": "^0.52.0",
-        "@gjsify/fetch": "^0.52.0",
-        "@gjsify/rolldown-native": "^0.52.0",
-        "@gjsify/vite-plugin-blueprint": "^0.52.0",
+        "@gjsify/canvas2d": "^0.54.0",
+        "@gjsify/cli": "^0.54.0",
+        "@gjsify/dom-elements": "^0.54.0",
+        "@gjsify/dom-events": "^0.54.0",
+        "@gjsify/fetch": "^0.54.0",
+        "@gjsify/oxlint-plugin-gjsify": "^0.54.0",
+        "@gjsify/rolldown-native": "^0.54.0",
+        "@gjsify/vite-plugin-blueprint": "^0.54.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
     "dependencies": {
-        "@gjsify/node-gi": "^0.52.0",
-        "@gjsify/webgl": "^0.52.0",
+        "@gjsify/node-gi": "^0.54.0",
+        "@gjsify/webgl": "^0.54.0",
         "excalibur": "0.32.0"
     },
     "gjsify": {

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

@@ -0,0 +1,13 @@
+{
+    "$schema": "./node_modules/oxlint/configuration_schema.json",
+    "categories": {
+        "correctness": "error"
+    },
+    "jsPlugins": [
+        "@gjsify/oxlint-plugin-gjsify"
+    ],
+    "rules": {
+        "gjsify/prefer-blueprint-template": "error",
+        "gjsify/no-literal-widget-label": "error"
+    }
+}

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

@@ -22,17 +22,18 @@
         "@girs/gjs": "5.4.0",
         "@girs/gobject-2.0": "5.4.0",
         "@girs/gtk-4.0": "5.4.0",
-        "@gjsify/cli": "^0.52.0",
-        "@gjsify/dom-elements": "^0.52.0",
-        "@gjsify/rolldown-native": "^0.52.0",
-        "@gjsify/vite-plugin-blueprint": "^0.52.0",
+        "@gjsify/cli": "^0.54.0",
+        "@gjsify/dom-elements": "^0.54.0",
+        "@gjsify/oxlint-plugin-gjsify": "^0.54.0",
+        "@gjsify/rolldown-native": "^0.54.0",
+        "@gjsify/vite-plugin-blueprint": "^0.54.0",
         "@types/node": "^25.9.2",
         "@types/three": "^0.185.0",
         "typescript": "^6.0.3"
     },
     "dependencies": {
-        "@gjsify/node-gi": "^0.52.0",
-        "@gjsify/webgl": "^0.52.0",
+        "@gjsify/node-gi": "^0.54.0",
+        "@gjsify/webgl": "^0.54.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.52.0",
-        "@gjsify/node-globals": "^0.52.0",
-        "@gjsify/rolldown-native": "^0.52.0",
-        "@gjsify/runtime": "^0.52.0",
+        "@gjsify/cli": "^0.54.0",
+        "@gjsify/node-globals": "^0.54.0",
+        "@gjsify/rolldown-native": "^0.54.0",
+        "@gjsify/runtime": "^0.54.0",
         "@types/node": "^25.9.2",
         "@types/yargs": "^17.0.35",
         "typescript": "^6.0.3"

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

@@ -0,0 +1,13 @@
+{
+    "$schema": "./node_modules/oxlint/configuration_schema.json",
+    "categories": {
+        "correctness": "error"
+    },
+    "jsPlugins": [
+        "@gjsify/oxlint-plugin-gjsify"
+    ],
+    "rules": {
+        "gjsify/prefer-blueprint-template": "error",
+        "gjsify/no-literal-widget-label": "error"
+    }
+}

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

@@ -17,9 +17,10 @@
         "dev": "gjsify dev --runtime gjs"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.52.0",
-        "@gjsify/rolldown-native": "^0.52.0",
-        "@gjsify/vite-plugin-blueprint": "^0.52.0",
+        "@gjsify/cli": "^0.54.0",
+        "@gjsify/oxlint-plugin-gjsify": "^0.54.0",
+        "@gjsify/rolldown-native": "^0.54.0",
+        "@gjsify/vite-plugin-blueprint": "^0.54.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
@@ -28,7 +29,7 @@
         "@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.52.0"
+        "@gjsify/node-gi": "^0.54.0"
     },
     "gjsify": {
         "main": "dist/index.gjs.js",

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

@@ -17,10 +17,10 @@
         "dev": "gjsify dev --runtime gjs"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.52.0",
-        "@gjsify/node-globals": "^0.52.0",
-        "@gjsify/rolldown-native": "^0.52.0",
-        "@gjsify/runtime": "^0.52.0",
+        "@gjsify/cli": "^0.54.0",
+        "@gjsify/node-globals": "^0.54.0",
+        "@gjsify/rolldown-native": "^0.54.0",
+        "@gjsify/runtime": "^0.54.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.52.0",
-        "@gjsify/node-globals": "^0.52.0",
-        "@gjsify/rolldown-native": "^0.52.0",
-        "@gjsify/runtime": "^0.52.0",
+        "@gjsify/cli": "^0.54.0",
+        "@gjsify/node-globals": "^0.54.0",
+        "@gjsify/rolldown-native": "^0.54.0",
+        "@gjsify/runtime": "^0.54.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/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.52.0",
+    "version": "0.54.0",
     "description": "Create a new Gjsify project",
     "type": "module",
     "main": "lib/create.js",
@@ -46,9 +46,9 @@
         "yargs": "^18.0.0"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.52.0",
-        "@gjsify/rolldown-plugin-gjsify": "^0.52.0",
-        "@gjsify/unit": "^0.52.0",
+        "@gjsify/cli": "^0.54.0",
+        "@gjsify/rolldown-plugin-gjsify": "^0.54.0",
+        "@gjsify/unit": "^0.54.0",
         "@types/node": "^25.9.2",
         "@types/yargs": "^17.0.35",
         "typescript": "^6.0.3"