@gjsify/create-app 0.64.14 → 0.64.15-next.287

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

@@ -22,16 +22,16 @@
         "@girs/gjs": "5.4.0",
         "@girs/gobject-2.0": "5.4.0",
         "@girs/gtk-4.0": "5.4.0",
-        "@gjsify/cli": "^0.64.14",
-        "@gjsify/dom-elements": "^0.64.14",
-        "@gjsify/oxlint-plugin-gjsify": "^0.64.14",
-        "@gjsify/rolldown-native": "^0.64.14",
-        "@gjsify/vite-plugin-blueprint": "^0.64.14",
+        "@gjsify/cli": "^0.64.15-next.287",
+        "@gjsify/dom-elements": "^0.64.15-next.287",
+        "@gjsify/oxlint-plugin-gjsify": "^0.64.15-next.287",
+        "@gjsify/rolldown-native": "^0.64.15-next.287",
+        "@gjsify/vite-plugin-blueprint": "^0.64.15-next.287",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
     "dependencies": {
-        "@gjsify/canvas2d": "^0.64.14",
+        "@gjsify/canvas2d": "^0.64.15-next.287",
         "@gjsify/node-gi": "^0.64.14"
     },
     "gjsify": {

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

@@ -22,20 +22,20 @@
         "@girs/gjs": "5.4.0",
         "@girs/gobject-2.0": "5.4.0",
         "@girs/gtk-4.0": "5.4.0",
-        "@gjsify/canvas2d": "^0.64.14",
-        "@gjsify/cli": "^0.64.14",
-        "@gjsify/dom-elements": "^0.64.14",
-        "@gjsify/dom-events": "^0.64.14",
-        "@gjsify/fetch": "^0.64.14",
-        "@gjsify/oxlint-plugin-gjsify": "^0.64.14",
-        "@gjsify/rolldown-native": "^0.64.14",
-        "@gjsify/vite-plugin-blueprint": "^0.64.14",
+        "@gjsify/canvas2d": "^0.64.15-next.287",
+        "@gjsify/cli": "^0.64.15-next.287",
+        "@gjsify/dom-elements": "^0.64.15-next.287",
+        "@gjsify/dom-events": "^0.64.15-next.287",
+        "@gjsify/fetch": "^0.64.15-next.287",
+        "@gjsify/oxlint-plugin-gjsify": "^0.64.15-next.287",
+        "@gjsify/rolldown-native": "^0.64.15-next.287",
+        "@gjsify/vite-plugin-blueprint": "^0.64.15-next.287",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
     "dependencies": {
         "@gjsify/node-gi": "^0.64.14",
-        "@gjsify/webgl": "^0.64.14",
+        "@gjsify/webgl": "^0.64.15-next.287",
         "excalibur": "0.32.0"
     },
     "gjsify": {

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

@@ -22,18 +22,18 @@
         "@girs/gjs": "5.4.0",
         "@girs/gobject-2.0": "5.4.0",
         "@girs/gtk-4.0": "5.4.0",
-        "@gjsify/cli": "^0.64.14",
-        "@gjsify/dom-elements": "^0.64.14",
-        "@gjsify/oxlint-plugin-gjsify": "^0.64.14",
-        "@gjsify/rolldown-native": "^0.64.14",
-        "@gjsify/vite-plugin-blueprint": "^0.64.14",
+        "@gjsify/cli": "^0.64.15-next.287",
+        "@gjsify/dom-elements": "^0.64.15-next.287",
+        "@gjsify/oxlint-plugin-gjsify": "^0.64.15-next.287",
+        "@gjsify/rolldown-native": "^0.64.15-next.287",
+        "@gjsify/vite-plugin-blueprint": "^0.64.15-next.287",
         "@types/node": "^25.9.2",
         "@types/three": "^0.185.0",
         "typescript": "^6.0.3"
     },
     "dependencies": {
         "@gjsify/node-gi": "^0.64.14",
-        "@gjsify/webgl": "^0.64.14",
+        "@gjsify/webgl": "^0.64.15-next.287",
         "three": "0.185.1"
     },
     "gjsify": {

package/dist-templates/cli/package.json

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

package/dist-templates/gtk-minimal/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 new-gjsify-app contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -16,6 +16,11 @@ 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.
 
+`src/style.css` is the app's stylesheet: it is imported as a **string** and handed to a
+`Gtk.CssProvider` in the `activate` handler, the first point at which a display exists, while
+`main-window.blp` names its class. `@gjsify/rolldown-plugin-gjsify/types` in `tsconfig.json` is
+what types that import — no hand-written `css.d.ts` needed.
+
 ## Install
 
 ```bash
@@ -41,6 +46,7 @@ npm run start:bun   # run on Bun
 npm run start:deno  # run on Deno
 npm run check       # type-check
 npm run clear       # remove build output
+npm run ship -- <os>  # package it (see Ship below)
 ```
 
 ## Runtimes
@@ -69,6 +75,31 @@ native on the other three. Templates that draw through a Canvas or WebGL request
 that surface explicitly (`--globals auto,dom`); asking for it here would inject
 registers nothing ever calls.
 
+## Ship
+
+`gjsify ship` wraps the built app into something a stranger can install — a
+`.app` on macOS, an `.exe`/`.msi` on Windows, a `.deb`/`.rpm` on Linux:
+
+```bash
+npm run ship -- darwin    # → ship/*.app, ship/*.zip
+npm run ship -- windows   # → ship/*/ (directory) + .zip
+npm run ship -- windows --target msi
+npm run ship -- linux     # → .deb + .rpm (needs gjs on the target)
+```
+
+`gjsify.ship` in `package.json` is the whole configuration: the application id,
+the icon in `data/icons`, and — for macOS and Windows, which have no system GJS —
+the `--app node` bundle plus the `@gjsify/node-runtime-*` package for that
+platform. Those three packages sit in `optionalDependencies`, so `npm install`
+takes the one matching your machine and skips the others instead of refusing the
+install; a project shipping for a platform therefore builds it on that platform's
+runner, or hands `gjsify` the interpreter through `GJSIFY_NODE_RUNTIME`. The
+cross target itself wants GTK for its own architecture, which `gjsify` fetches
+into its cache on first use.
+
+Replace the placeholder icon and put your own name and email in `author` before
+publishing anything.
+
 ## Operating systems
 
 gjsify targets Linux, macOS and Windows. What this project can actually do on

package/dist-templates/gtk-minimal/data/icons/hicolor/scalable/apps/org.gjsify.example.svg

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128">
+  <rect width="128" height="128" rx="24" fill="#241f31"/>
+  <rect x="24" y="34" width="80" height="60" rx="8" fill="#ffffff"/>
+  <rect x="24" y="34" width="80" height="16" rx="8" fill="#c0bfbc"/>
+  <circle cx="34" cy="42" r="3" fill="#e01b24"/>
+  <circle cx="44" cy="42" r="3" fill="#f5c211"/>
+  <circle cx="54" cy="42" r="3" fill="#33d17a"/>
+  <rect x="36" y="62" width="56" height="6" rx="3" fill="#9a9996"/>
+  <rect x="36" y="74" width="40" height="6" rx="3" fill="#9a9996"/>
+</svg>

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

@@ -4,6 +4,8 @@
     "version": "0.1.0",
     "type": "module",
     "private": true,
+    "license": "MIT",
+    "author": "new-gjsify-app contributors",
     "scripts": {
         "clear": "gjsify clear dist tsconfig.tsbuildinfo",
         "check": "gjsify tsc --noEmit",
@@ -14,13 +16,15 @@
         "start:node": "gjsify run dist/index.node.mjs --runtime node",
         "start:bun": "gjsify run dist/index.node.mjs --runtime bun",
         "start:deno": "gjsify run dist/index.node.mjs --runtime deno",
-        "dev": "gjsify dev --runtime gjs"
+        "dev": "gjsify dev --runtime gjs",
+        "ship": "gjsify ship"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.64.14",
-        "@gjsify/oxlint-plugin-gjsify": "^0.64.14",
-        "@gjsify/rolldown-native": "^0.64.14",
-        "@gjsify/vite-plugin-blueprint": "^0.64.14",
+        "@gjsify/cli": "^0.64.15-next.287",
+        "@gjsify/oxlint-plugin-gjsify": "^0.64.15-next.287",
+        "@gjsify/rolldown-native": "^0.64.15-next.287",
+        "@gjsify/rolldown-plugin-gjsify": "^0.64.15-next.287",
+        "@gjsify/vite-plugin-blueprint": "^0.64.15-next.287",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
@@ -31,6 +35,11 @@
         "@girs/gtk-4.0": "5.4.0",
         "@gjsify/node-gi": "^0.64.14"
     },
+    "optionalDependencies": {
+        "@gjsify/node-runtime-darwin-arm64": "^0.64.14",
+        "@gjsify/node-runtime-darwin-x64": "^0.64.14",
+        "@gjsify/node-runtime-win32-x64": "^0.64.14"
+    },
     "gjsify": {
         "main": "dist/index.gjs.js",
         "example": {
@@ -41,6 +50,18 @@
                 "deno"
             ],
             "node": "dist/index.node.mjs"
+        },
+        "ship": {
+            "appId": "org.gjsify.example",
+            "app": {
+                "darwin": "node",
+                "win32": "node"
+            },
+            "bundle": {
+                "darwin": "dist/index.node.mjs",
+                "win32": "dist/index.node.mjs"
+            },
+            "icon": "data/icons"
         }
     }
 }

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

@@ -1,5 +1,7 @@
 import Gtk from 'gi://Gtk?version=4.0';
 import Gio from 'gi://Gio?version=2.0';
+import Gdk from 'gi://Gdk?version=4.0';
+import css from './style.css';
 import { MainWindow } from './main-window.js';
 
 const app = new Gtk.Application({
@@ -7,7 +9,22 @@ const app = new Gtk.Application({
     flags: Gio.ApplicationFlags.FLAGS_NONE,
 });
 
+// Only on `activate`: while this module is evaluated there is no display yet, so
+// `Gdk.Display.get_default()` is null and GTK aborts the call with "Argument display may not be
+// null". `css` is the stylesheet as a string — a bare `import './style.css'` would be a module
+// whose only effect is that default export, and the bundler would tree-shake it away.
+function applyStylesheet(): void {
+    const provider = new Gtk.CssProvider();
+    provider.load_from_string(css);
+    Gtk.StyleContext.add_provider_for_display(
+        Gdk.Display.get_default()!,
+        provider,
+        Gtk.STYLE_PROVIDER_PRIORITY_APPLICATION,
+    );
+}
+
 app.connect('activate', () => {
+    applyStylesheet();
     new MainWindow(app).present();
 });
 

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

@@ -26,8 +26,14 @@ template $MainWindow: Gtk.ApplicationWindow {
 
     // 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.
+    // `demo-status` comes from `src/style.css`, registered on `activate` — the class name is
+    // the whole contract between the two files.
     Gtk.Label hint {
       xalign: 0.5;
+
+      styles [
+        "demo-status",
+      ]
     }
   };
 }

package/dist-templates/gtk-minimal/src/style.css

@@ -0,0 +1,10 @@
+/* Imported as a STRING (`.css` → `export default "<css>"`, see the build), because GTK has no
+ * stylesheet module. `main-window.blp` puts this class on the hint label.
+ *
+ * Block comments only: CSS has no `//`, and lightningcss drops a rule that follows one, so a
+ * JS-style header would ship an app with an empty stylesheet and no error.
+ */
+.demo-status {
+    color: #9141ac;
+    font-weight: bold;
+}

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

@@ -11,7 +11,8 @@
             "@girs/gio-2.0",
             "@girs/glib-2.0",
             "@girs/gobject-2.0",
-            "@gjsify/vite-plugin-blueprint/types"
+            "@gjsify/vite-plugin-blueprint/types",
+            "@gjsify/rolldown-plugin-gjsify/types"
         ],
         "esModuleInterop": true,
         "strict": true,

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

@@ -17,10 +17,10 @@
         "dev": "gjsify dev --runtime gjs"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.64.14",
-        "@gjsify/node-globals": "^0.64.14",
-        "@gjsify/rolldown-native": "^0.64.14",
-        "@gjsify/runtime": "^0.64.14",
+        "@gjsify/cli": "^0.64.15-next.287",
+        "@gjsify/node-globals": "^0.64.15-next.287",
+        "@gjsify/rolldown-native": "^0.64.15-next.287",
+        "@gjsify/runtime": "^0.64.15-next.287",
         "@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.64.14",
-        "@gjsify/node-globals": "^0.64.14",
-        "@gjsify/rolldown-native": "^0.64.14",
-        "@gjsify/runtime": "^0.64.14",
+        "@gjsify/cli": "^0.64.15-next.287",
+        "@gjsify/node-globals": "^0.64.15-next.287",
+        "@gjsify/rolldown-native": "^0.64.15-next.287",
+        "@gjsify/runtime": "^0.64.15-next.287",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },

package/lib/create.js

@@ -1,5 +1,5 @@
 import { spawnSync } from 'node:child_process';
-import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, cpSync } from 'node:fs';
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, cpSync, renameSync } from 'node:fs';
 import { resolve, join } from 'node:path';
 import { discoverTemplates, findTemplate } from './discover-templates.js';
 import { defaultRuntimeFor, installCommandLine, hostRuntime, packageManagersForRuntime, runScriptCommand, startScriptFor, } from './runtimes.js';
@@ -48,7 +48,20 @@ const TEXT_FILE_EXT = new Set([
     '.xml',
     '.ui',
     '.txt',
+    // An icon is an XML document like `.ui` is, and the application-id sentinel
+    // is its FILENAME as well as its `inkscape:label` — so the bytes need the
+    // same substitution the name gets.
+    '.svg',
 ]);
+/**
+ * Extensionless files that are still text, by exact basename.
+ *
+ * `LICENSE` is the case that forced this: it is the file every package format
+ * and every forge looks for, it carries the project name in its copyright line,
+ * and it has no extension to recognise it by. A suffix test cannot see it, so
+ * the walk skipped exactly the one file `gjsify ship` requires.
+ */
+const TEXT_BASENAMES = new Set(['LICENSE', 'LICENCE', 'COPYING', 'NOTICE']);
 /** npm package names: lowercase, digits, -, _, .; no leading . or _. */
 export function sanitizeProjectName(raw) {
     const trimmed = raw.trim();
@@ -145,18 +158,50 @@ export async function createProject(options) {
 /**
  * Walk the scaffolded tree and replace every template sentinel in every text file.
  * Skips node_modules / dist / lib and non-text files by extension.
+ *
+ * NAMES as well as contents: `data/icons/…/org.gjsify.example.svg` is a path a
+ * scaffolded project has to be able to keep, and leaving the sentinel in the
+ * filename put an icon named after the template in a project that `gjsify ship`
+ * then packages under its own id.
  */
 function substituteTemplateSentinels(rootDir, projectName) {
     const sentinels = [
         [PROJECT_NAME_SENTINEL, projectName],
         [APPLICATION_ID_SENTINEL, applicationIdFor(projectName)],
     ];
+    // Paths first: the content pass below reads `full` from the same walk, so a
+    // file renamed afterwards would be read under a name that no longer exists.
+    renameSentinelPaths(rootDir, sentinels);
+    substituteSentinelContents(rootDir, sentinels);
+}
+/**
+ * Rename every file and directory whose NAME holds a sentinel.
+ *
+ * A directory is renamed before it is walked, so its children are visited at
+ * their new location; the recursion therefore carries the renamed path rather
+ * than the one the entry was read under.
+ */
+function renameSentinelPaths(dir, sentinels) {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        let name = entry.name;
+        for (const [sentinel, value] of sentinels)
+            name = name.replaceAll(sentinel, value);
+        const before = join(dir, entry.name);
+        const after = join(dir, name);
+        if (after !== before)
+            renameSync(before, after);
+        if (entry.isDirectory())
+            renameSentinelPaths(after, sentinels);
+    }
+}
+/** The content half of {@link substituteTemplateSentinels}. */
+function substituteSentinelContents(dir, sentinels) {
     const skipDirs = new Set(['node_modules', 'dist', 'lib']);
-    const stack = [rootDir];
+    const stack = [dir];
     while (stack.length > 0) {
-        const dir = stack.pop();
-        for (const entry of readdirSync(dir, { withFileTypes: true })) {
-            const full = join(dir, entry.name);
+        const current = stack.pop();
+        for (const entry of readdirSync(current, { withFileTypes: true })) {
+            const full = join(current, entry.name);
             if (entry.isDirectory()) {
                 if (!skipDirs.has(entry.name))
                     stack.push(full);
@@ -166,7 +211,7 @@ function substituteTemplateSentinels(rootDir, projectName) {
                 continue;
             const dot = entry.name.lastIndexOf('.');
             const ext = dot >= 0 ? entry.name.slice(dot) : '';
-            if (!TEXT_FILE_EXT.has(ext))
+            if (!TEXT_FILE_EXT.has(ext) && !TEXT_BASENAMES.has(entry.name))
                 continue;
             const content = readFileSync(full, 'utf-8');
             let replaced = content;
@@ -211,6 +256,14 @@ function printNextSteps(projectName, template, installed, packageManager, runtim
             console.log(`  ${run} ${startScriptFor(rt)}`);
         console.log('');
     }
+    // Only for a template that actually ships a `ship` script: printing the
+    // command for one that does not sends the reader to a script that is not
+    // there, which is worse than not mentioning packaging at all.
+    if (scripts['ship']) {
+        console.log('Package it for a machine without gjsify:');
+        console.log(`  ${run} ship -- darwin`);
+        console.log('');
+    }
 }
 /** The template manifest, or `{}` when it cannot be read. */
 function templateManifest(template) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/create-app",
-    "version": "0.64.14",
+    "version": "0.64.15-next.287",
     "description": "Create a new Gjsify project",
     "type": "module",
     "main": "lib/create.js",
@@ -46,9 +46,9 @@
         "yargs": "^18.0.0"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.64.14",
-        "@gjsify/rolldown-plugin-gjsify": "^0.64.14",
-        "@gjsify/unit": "^0.64.14",
+        "@gjsify/cli": "0.64.15-next.287",
+        "@gjsify/rolldown-plugin-gjsify": "0.64.15-next.287",
+        "@gjsify/unit": "0.64.15-next.287",
         "@types/node": "^25.9.2",
         "@types/yargs": "^17.0.35",
         "typescript": "^6.0.3"
@@ -65,5 +65,6 @@
     "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/infra/create-gjsify#readme",
     "gjsify": {
         "tier": 1
-    }
+    },
+    "gitHead": "5742b282a8a2bc8633dd8384ef436768447f6a83"
 }