@gjsify/cli 0.1.7 → 0.1.9

package/lib/utils/check-system-deps.js

@@ -1,10 +1,20 @@
 // System dependency checker for gjsify CLI.
 // Uses execFileSync with explicit argument arrays — no shell injection possible.
 // All binary names are hardcoded constants, never derived from user input.
+//
+// Severity model:
+//   - 'required'  → must be present, exit code 1 if missing
+//   - 'optional'  → nice to have, only warned about, exit code stays 0
+//
+// Conditional checking: when a project's package.json is reachable from cwd,
+// optional system deps are only checked if the corresponding @gjsify/* package
+// is in the project's dependency tree. A user with only @gjsify/fs in their
+// project never sees a warning about libmanette.
 import { execFileSync } from 'node:child_process';
-import { join } from 'node:path';
+import { join, resolve } from 'node:path';
 import { createRequire } from 'node:module';
 import { pathToFileURL } from 'node:url';
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
 /** Run a binary and return its stdout trimmed, or null if it fails. */
 function tryExecFile(binary, args) {
     try {
@@ -15,41 +25,41 @@ function tryExecFile(binary, args) {
     }
 }
 /** Check if a binary exists and optionally capture its version output. */
-function checkBinary(id, name, binary, versionArgs, parseVersion) {
+function checkBinary(id, name, binary, versionArgs, severity, parseVersion, requiredBy) {
     const out = tryExecFile(binary, versionArgs);
     if (out === null)
-        return { id, name, found: false };
+        return { id, name, found: false, severity, requiredBy };
     const version = parseVersion ? parseVersion(out) : out.split('\n')[0] ?? out;
-    return { id, name, found: true, version };
+    return { id, name, found: true, version, severity, requiredBy };
 }
 /** Check a pkg-config library. pkg-config --modversion returns version on stdout. */
-function checkPkgConfig(id, name, libName) {
+function checkPkgConfig(id, name, libName, severity, requiredBy) {
     const version = tryExecFile('pkg-config', ['--modversion', libName]);
     if (version === null)
-        return { id, name, found: false };
-    return { id, name, found: true, version: version.split('\n')[0] };
+        return { id, name, found: false, severity, requiredBy };
+    return { id, name, found: true, version: version.split('\n')[0], severity, requiredBy };
 }
 /**
  * Check for an npm package. Tries the user's project first (cwd), then falls
  * back to the CLI's own node_modules. This way a locally installed version
  * takes precedence, but npx usage still works via the CLI's own dependencies.
  */
-function checkNpmPackage(id, name, packageName, cwd) {
+function checkNpmPackage(id, name, packageName, cwd, severity, requiredBy) {
     // 1. Try user's project
     try {
         const requireFromCwd = createRequire(pathToFileURL(join(cwd, '_check_.js')).href);
         requireFromCwd.resolve(packageName);
-        return { id, name, found: true };
+        return { id, name, found: true, severity, requiredBy };
     }
     catch { /* not in project, try CLI fallback */ }
     // 2. Fallback: CLI's own node_modules
     try {
         const requireFromCli = createRequire(import.meta.url);
         requireFromCli.resolve(packageName);
-        return { id, name, found: true };
+        return { id, name, found: true, severity, requiredBy };
     }
     catch {
-        return { id, name, found: false };
+        return { id, name, found: false, severity, requiredBy };
     }
 }
 export function detectPackageManager() {
@@ -61,56 +71,179 @@ export function detectPackageManager() {
     }
     return 'unknown';
 }
+/** Optional system deps keyed by their DepCheck id. */
+const OPTIONAL_DEPS = {
+    manette: { id: 'manette', name: 'libmanette', pkgName: 'manette-0.2' },
+    gstreamer: { id: 'gstreamer', name: 'GStreamer', pkgName: 'gstreamer-1.0' },
+    'gst-app': { id: 'gst-app', name: 'GStreamer App', pkgName: 'gstreamer-app-1.0' },
+    'gdk-pixbuf': { id: 'gdk-pixbuf', name: 'GdkPixbuf', pkgName: 'gdk-pixbuf-2.0' },
+    pango: { id: 'pango', name: 'Pango', pkgName: 'pango' },
+    pangocairo: { id: 'pangocairo', name: 'PangoCairo', pkgName: 'pangocairo' },
+    webkitgtk: { id: 'webkitgtk', name: 'WebKitGTK', pkgName: 'webkitgtk-6.0' },
+    cairo: { id: 'cairo', name: 'Cairo', pkgName: 'cairo' },
+};
+/**
+ * Map of @gjsify/* package name → ids of OPTIONAL_DEPS this package needs.
+ * Generated by walking each package's `gi://` imports (excluding the always-
+ * available trio GLib/GObject/Gio).
+ *
+ * Used to compute the set of optional deps to check for a given project.
+ */
+const PACKAGE_DEPS = {
+    '@gjsify/gamepad': ['manette'],
+    '@gjsify/webaudio': ['gstreamer', 'gst-app'],
+    '@gjsify/iframe': ['webkitgtk'],
+    '@gjsify/canvas2d': ['gdk-pixbuf', 'pango', 'pangocairo', 'cairo'],
+    '@gjsify/canvas2d-core': ['gdk-pixbuf', 'pango', 'pangocairo', 'cairo'],
+    '@gjsify/dom-elements': ['gdk-pixbuf'],
+    // @gjsify/webgl, @gjsify/event-bridge only need gtk4/gdk which are
+    // already in the required set, so they don't need optional entries.
+};
+/** Walk up from cwd looking for the nearest package.json. */
+function findProjectRoot(cwd) {
+    let dir = resolve(cwd);
+    while (true) {
+        if (existsSync(join(dir, 'package.json')))
+            return dir;
+        const parent = resolve(dir, '..');
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/**
+ * Discover which @gjsify/* packages a project depends on (transitively),
+ * by walking the node_modules tree from the project root. Returns a Set of
+ * package names like '@gjsify/webgl', '@gjsify/canvas2d'.
+ *
+ * If the project root cannot be determined or has no node_modules, returns
+ * `null` to signal "check all optional deps" — this matches the historical
+ * behaviour where `gjsify check` outside any project shows the full list.
+ */
+function discoverGjsifyPackages(cwd) {
+    const root = findProjectRoot(cwd);
+    if (!root)
+        return null;
+    const nodeModulesDir = join(root, 'node_modules', '@gjsify');
+    if (!existsSync(nodeModulesDir)) {
+        // Project exists but no @gjsify/* installed → only need core checks.
+        return new Set();
+    }
+    // Read top-level package.json to determine if @gjsify/cli is the only
+    // dep (in which case we still want to warn about everything the CLI
+    // transitively brings in). Otherwise scan node_modules for installed packages.
+    const pkgJsonPath = join(root, 'package.json');
+    let topPkg = {};
+    try {
+        topPkg = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
+    }
+    catch { /* ignore */ }
+    const directDeps = {
+        ...topPkg.dependencies,
+        ...topPkg.devDependencies,
+    };
+    const found = new Set();
+    try {
+        for (const entry of readdirSync(nodeModulesDir, { withFileTypes: true })) {
+            if (entry.isDirectory() || entry.isSymbolicLink()) {
+                found.add(`@gjsify/${entry.name}`);
+            }
+        }
+    }
+    catch { /* ignore */ }
+    // Also include direct deps even if node_modules walk failed
+    for (const dep of Object.keys(directDeps)) {
+        if (dep.startsWith('@gjsify/'))
+            found.add(dep);
+    }
+    return found;
+}
+/**
+ * Compute the set of optional dep ids that should be checked for the
+ * current project. Returns null to indicate "check all" (no project context).
+ */
+function computeNeededOptionalDeps(cwd) {
+    const installedPackages = discoverGjsifyPackages(cwd);
+    if (installedPackages === null)
+        return null; // no project → check everything
+    const needed = new Set();
+    for (const pkg of installedPackages) {
+        const deps = PACKAGE_DEPS[pkg];
+        if (deps)
+            for (const id of deps)
+                needed.add(id);
+    }
+    return needed;
+}
 /**
  * Run all dependency checks. Used by `gjsify check` to show full system status.
+ *
+ * Required deps (gjs, gtk4, libsoup3, libadwaita, gobject-introspection,
+ * blueprint-compiler, pkg-config, meson) are always checked.
+ *
+ * Optional deps are checked conditionally based on which @gjsify/* packages
+ * the project (resolved from cwd) actually consumes. If no project context
+ * is available, all optional deps are checked.
  */
 export function runAllChecks(cwd) {
-    return [...runMinimalChecks(), ...runExtraChecks(cwd)];
+    const needed = computeNeededOptionalDeps(cwd);
+    return [...runMinimalChecks(), ...runRequiredChecks(cwd), ...runOptionalChecks(needed, cwd)];
 }
 /**
- * Minimal checks needed to run any GJS example (GJS binary only).
+ * Minimal checks needed to run any GJS example (Node + GJS binaries only).
  * Used by `gjsify showcase` for examples that have no native deps.
  */
 export function runMinimalChecks() {
     const results = [];
     // Node.js — always present
-    results.push({ id: 'nodejs', name: 'Node.js', found: true, version: process.version });
+    results.push({ id: 'nodejs', name: 'Node.js', found: true, version: process.version, severity: 'required' });
     // GJS
-    results.push(checkBinary('gjs', 'GJS', 'gjs', ['--version'], (out) => out.replace(/^GJS\s+/i, '').split('\n')[0] ?? out));
+    results.push(checkBinary('gjs', 'GJS', 'gjs', ['--version'], 'required', (out) => out.replace(/^GJS\s+/i, '').split('\n')[0] ?? out));
     return results;
 }
-/** Check gwebgl npm package (project first, CLI fallback). */
+/** Check gwebgl npm package (project first, CLI fallback). Optional — only needed by @gjsify/webgl users. */
 export function checkGwebgl(cwd) {
-    return checkNpmPackage('gwebgl', 'gwebgl (@gjsify/webgl)', '@gjsify/webgl', cwd);
+    return checkNpmPackage('gwebgl', 'gwebgl (@gjsify/webgl)', '@gjsify/webgl', cwd, 'optional', ['@gjsify/webgl']);
 }
 /**
- * Extra checks for development and full system audit.
+ * Required system dependencies — always checked, missing → exit 1.
+ * Includes the core build toolchain (pkg-config, meson, blueprint-compiler)
+ * and the foundational libraries (gtk4, libadwaita, libsoup3,
+ * gobject-introspection) that nearly every gjsify app needs.
  */
-function runExtraChecks(cwd) {
+function runRequiredChecks(_cwd) {
     const results = [];
-    // Blueprint Compiler
-    results.push(checkBinary('blueprint-compiler', 'Blueprint Compiler', 'blueprint-compiler', ['--version']));
-    // pkg-config (needed for library checks)
-    results.push(checkBinary('pkg-config', 'pkg-config', 'pkg-config', ['--version']));
-    // Meson (for building native extensions)
-    results.push(checkBinary('meson', 'Meson', 'meson', ['--version']));
-    // GTK4
-    results.push(checkPkgConfig('gtk4', 'GTK4', 'gtk4'));
-    // libadwaita
-    results.push(checkPkgConfig('libadwaita', 'libadwaita', 'libadwaita-1'));
-    // libsoup3
-    results.push(checkPkgConfig('libsoup3', 'libsoup3', 'libsoup-3.0'));
-    // WebKitGTK — try 4.1 first, fall back to 4.0
-    const webkitCheck = checkPkgConfig('webkitgtk', 'WebKitGTK', 'webkit2gtk-4.1');
-    if (webkitCheck.found) {
-        results.push(webkitCheck);
-    }
-    else {
-        results.push(checkPkgConfig('webkitgtk', 'WebKitGTK', 'webkitgtk-6.0'));
-    }
-    // GObject Introspection
-    results.push(checkPkgConfig('gobject-introspection', 'GObject Introspection', 'gobject-introspection-1.0'));
-    // gwebgl — project first, CLI fallback.
+    // Build toolchain
+    results.push(checkBinary('blueprint-compiler', 'Blueprint Compiler', 'blueprint-compiler', ['--version'], 'required'));
+    results.push(checkBinary('pkg-config', 'pkg-config', 'pkg-config', ['--version'], 'required'));
+    results.push(checkBinary('meson', 'Meson', 'meson', ['--version'], 'required'));
+    // Foundational libraries
+    results.push(checkPkgConfig('gtk4', 'GTK4', 'gtk4', 'required'));
+    results.push(checkPkgConfig('libadwaita', 'libadwaita', 'libadwaita-1', 'required'));
+    results.push(checkPkgConfig('libsoup3', 'libsoup3', 'libsoup-3.0', 'required'));
+    results.push(checkPkgConfig('gobject-introspection', 'GObject Introspection', 'gobject-introspection-1.0', 'required'));
+    return results;
+}
+/**
+ * Optional system dependencies — only checked if the corresponding @gjsify/*
+ * package is in use. Missing optional deps generate warnings, not errors.
+ *
+ * @param needed Set of optional dep ids to check, or null to check all.
+ * @param cwd Used to resolve the gwebgl npm package check.
+ */
+function runOptionalChecks(needed, cwd) {
+    const results = [];
+    for (const [id, dep] of Object.entries(OPTIONAL_DEPS)) {
+        if (needed !== null && !needed.has(id))
+            continue;
+        const requiredBy = Object.entries(PACKAGE_DEPS)
+            .filter(([, ids]) => ids.includes(id))
+            .map(([pkg]) => pkg);
+        results.push(checkPkgConfig(dep.id, dep.name, dep.pkgName, 'optional', requiredBy));
+    }
+    // gwebgl npm package — special case (not a pkg-config lib).
+    // Always reported (the npm package is bundled with the CLI), but marked
+    // optional because only @gjsify/webgl users need it.
     results.push(checkGwebgl(cwd));
     return results;
 }
@@ -125,8 +258,15 @@ const PM_PACKAGES = {
         gtk4: 'libgtk-4-dev',
         libadwaita: 'libadwaita-1-dev',
         libsoup3: 'libsoup-3.0-dev',
-        webkitgtk: 'libwebkit2gtk-4.1-dev',
+        webkitgtk: 'libwebkit2gtk-6.0-dev',
         'gobject-introspection': 'gobject-introspection libgirepository1.0-dev',
+        manette: 'libmanette-0.2-0 gir1.2-manette-0.2',
+        gstreamer: 'libgstreamer1.0-dev',
+        'gst-app': 'libgstreamer-plugins-base1.0-dev gir1.2-gst-plugins-base-1.0',
+        'gdk-pixbuf': 'libgdk-pixbuf-2.0-dev',
+        pango: 'libpango1.0-dev',
+        pangocairo: 'libpango1.0-dev',
+        cairo: 'libcairo2-dev',
     },
     dnf: {
         gjs: 'gjs',
@@ -138,6 +278,13 @@ const PM_PACKAGES = {
         libsoup3: 'libsoup3-devel',
         webkitgtk: 'webkitgtk6.0-devel',
         'gobject-introspection': 'gobject-introspection-devel',
+        manette: 'libmanette-devel',
+        gstreamer: 'gstreamer1-devel',
+        'gst-app': 'gstreamer1-plugins-base-devel',
+        'gdk-pixbuf': 'gdk-pixbuf2-devel',
+        pango: 'pango-devel',
+        pangocairo: 'pango-devel',
+        cairo: 'cairo-devel',
     },
     pacman: {
         gjs: 'gjs',
@@ -147,8 +294,15 @@ const PM_PACKAGES = {
         gtk4: 'gtk4',
         libadwaita: 'libadwaita',
         libsoup3: 'libsoup3',
-        webkitgtk: 'webkit2gtk-4.1',
+        webkitgtk: 'webkitgtk-6.0',
         'gobject-introspection': 'gobject-introspection',
+        manette: 'libmanette',
+        gstreamer: 'gstreamer',
+        'gst-app': 'gst-plugins-base',
+        'gdk-pixbuf': 'gdk-pixbuf2',
+        pango: 'pango',
+        pangocairo: 'pango',
+        cairo: 'cairo',
     },
     zypper: {
         gjs: 'gjs',
@@ -158,8 +312,15 @@ const PM_PACKAGES = {
         gtk4: 'gtk4-devel',
         libadwaita: 'libadwaita-devel',
         libsoup3: 'libsoup-3_0-devel',
-        webkitgtk: 'webkit2gtk3-devel',
+        webkitgtk: 'webkitgtk6_0-devel',
         'gobject-introspection': 'gobject-introspection-devel',
+        manette: 'libmanette-0_2-0-devel',
+        gstreamer: 'gstreamer-devel',
+        'gst-app': 'gstreamer-plugins-base-devel',
+        'gdk-pixbuf': 'gdk-pixbuf-devel',
+        pango: 'pango-devel',
+        pangocairo: 'pango-devel',
+        cairo: 'cairo-devel',
     },
     apk: {
         gjs: 'gjs',
@@ -169,8 +330,15 @@ const PM_PACKAGES = {
         gtk4: 'gtk4.0-dev',
         libadwaita: 'libadwaita-dev',
         libsoup3: 'libsoup3-dev',
-        webkitgtk: 'webkit2gtk-4.1-dev',
+        webkitgtk: 'webkit2gtk-6.0-dev',
         'gobject-introspection': 'gobject-introspection-dev',
+        manette: 'libmanette-dev',
+        gstreamer: 'gstreamer-dev',
+        'gst-app': 'gst-plugins-base-dev',
+        'gdk-pixbuf': 'gdk-pixbuf-dev',
+        pango: 'pango-dev',
+        pangocairo: 'pango-dev',
+        cairo: 'cairo-dev',
     },
     unknown: {},
 };

package/lib/utils/detect-native-packages.d.ts

@@ -17,6 +17,10 @@ export declare function detectNativePackages(startDir: string): NativePackage[];
  * Reads the nearest package.json to discover dependencies, then checks each
  * for gjsify native prebuilds metadata.
  *
+ * Also checks the **nearest package.json itself** — a workspace package may
+ * have its own prebuilds (e.g. `@gjsify/webgl` running its own test) and
+ * never list itself in dependencies.
+ *
  * This complements detectNativePackages() (filesystem walk from CWD) by using
  * require.resolve() — which handles hoisting, workspaces, and nested node_modules.
  */

package/lib/utils/detect-native-packages.js

@@ -125,6 +125,10 @@ function findNearestPackageJson(startDir) {
  * Reads the nearest package.json to discover dependencies, then checks each
  * for gjsify native prebuilds metadata.
  *
+ * Also checks the **nearest package.json itself** — a workspace package may
+ * have its own prebuilds (e.g. `@gjsify/webgl` running its own test) and
+ * never list itself in dependencies.
+ *
  * This complements detectNativePackages() (filesystem walk from CWD) by using
  * require.resolve() — which handles hoisting, workspaces, and nested node_modules.
  */
@@ -140,6 +144,14 @@ export function resolveNativePackages(fromFilePath) {
         const pkg = readPackageJson(nearestPkgJson);
         if (!pkg)
             return results;
+        // Check the nearest package itself (e.g. @gjsify/webgl running its own
+        // test bundle — webgl never lists itself in dependencies)
+        const ownName = typeof pkg['name'] === 'string' ? pkg['name'] : '';
+        if (ownName) {
+            const ownNative = checkPackage(dirname(nearestPkgJson), ownName, arch);
+            if (ownNative)
+                results.push(ownNative);
+        }
         const deps = pkg['dependencies'];
         if (!deps)
             return results;

package/lib/utils/discover-showcases.d.ts

@@ -0,0 +1,19 @@
+export interface ShowcaseInfo {
+    /** Short name, e.g. "three-postprocessing-pixel" */
+    name: string;
+    /** Full npm package name, e.g. "@gjsify/example-dom-three-postprocessing-pixel" */
+    packageName: string;
+    /** Category: "dom" or "node" */
+    category: string;
+    /** Description from showcase's package.json */
+    description: string;
+    /** Absolute path to the GJS bundle (resolved from "main" field) */
+    bundlePath: string;
+}
+/**
+ * Discover all installed showcase packages by scanning the CLI's own dependencies.
+ * Returns showcases sorted by category then name.
+ */
+export declare function discoverShowcases(): ShowcaseInfo[];
+/** Find a single showcase by short name. */
+export declare function findShowcase(name: string): ShowcaseInfo | undefined;

package/lib/utils/{discover-examples.js → discover-showcases.js}

@@ -1,4 +1,4 @@
-// Dynamic discovery of installed @gjsify/example-* packages.
+// Dynamic discovery of installed showcase packages (@gjsify/example-*).
 // Scans the CLI's own package.json dependencies at runtime.
 import { readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
@@ -6,9 +6,8 @@ import { createRequire } from 'node:module';
 import { fileURLToPath } from 'node:url';
 const EXAMPLE_PREFIX = '@gjsify/example-';
 /** Extract short name and category from package name. */
-function parseExampleName(packageName) {
-    // @gjsify/example-dom-three-geometry-shapes → category=dom, name=three-geometry-shapes
-    // @gjsify/example-node-cli-node-path → category=node, name=cli-node-path
+function parseShowcaseName(packageName) {
+    // @gjsify/example-dom-three-postprocessing-pixel → category=dom, name=three-postprocessing-pixel
     const suffix = packageName.slice(EXAMPLE_PREFIX.length);
     const dashIdx = suffix.indexOf('-');
     if (dashIdx === -1)
@@ -19,10 +18,10 @@ function parseExampleName(packageName) {
     };
 }
 /**
- * Discover all installed example packages by scanning the CLI's own dependencies.
- * Returns examples sorted by category then name.
+ * Discover all installed showcase packages by scanning the CLI's own dependencies.
+ * Returns showcases sorted by category then name.
  */
-export function discoverExamples() {
+export function discoverShowcases() {
     const require = createRequire(import.meta.url);
     const cliPkgPath = join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'package.json');
     let cliPkg;
@@ -35,11 +34,11 @@ export function discoverExamples() {
     const deps = cliPkg['dependencies'];
     if (!deps)
         return [];
-    const examples = [];
+    const showcases = [];
     for (const packageName of Object.keys(deps)) {
         if (!packageName.startsWith(EXAMPLE_PREFIX))
             continue;
-        const parsed = parseExampleName(packageName);
+        const parsed = parseShowcaseName(packageName);
         if (!parsed)
             continue;
         try {
@@ -48,7 +47,7 @@ export function discoverExamples() {
             const main = pkg['main'];
             if (!main)
                 continue;
-            examples.push({
+            showcases.push({
                 name: parsed.name,
                 packageName,
                 category: parsed.category,
@@ -60,10 +59,10 @@ export function discoverExamples() {
             // Package listed as dep but not resolvable — skip silently
         }
     }
-    examples.sort((a, b) => a.category.localeCompare(b.category) || a.name.localeCompare(b.name));
-    return examples;
+    showcases.sort((a, b) => a.category.localeCompare(b.category) || a.name.localeCompare(b.name));
+    return showcases;
 }
-/** Find a single example by short name. */
-export function findExample(name) {
-    return discoverExamples().find(e => e.name === name);
+/** Find a single showcase by short name. */
+export function findShowcase(name) {
+    return discoverShowcases().find(e => e.name === name);
 }

package/lib/utils/run-gjs.js

@@ -29,6 +29,15 @@ export async function runGjsBundle(bundlePath, extraArgs = []) {
         ...nativeEnv,
     };
     const gjsArgs = ['-m', bundlePath, ...extraArgs];
+    // Print the exact command being executed so users can copy-paste it to
+    // run gjs directly without the wrapper. Env vars are only shown if we
+    // actually set any (i.e. native gjsify packages were detected).
+    const envPrefix = Object.entries(nativeEnv)
+        .filter(([, value]) => value !== undefined && value !== '')
+        .map(([key, value]) => `${key}=${value}`)
+        .join(' ');
+    const gjsCommand = ['gjs', ...gjsArgs.map(a => a.includes(' ') ? `"${a}"` : a)].join(' ');
+    console.log(`$ ${envPrefix ? `${envPrefix} ` : ''}${gjsCommand}`);
     const child = spawn('gjs', gjsArgs, { env, stdio: 'inherit' });
     await new Promise((resolvePromise, reject) => {
         child.on('close', (code) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gjsify/cli",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "CLI for Gjsify",
   "type": "module",
   "main": "lib/index.js",
@@ -23,55 +23,15 @@
     "cli"
   ],
   "dependencies": {
-    "@gjsify/esbuild-plugin-gjsify": "^0.1.7",
-    "@gjsify/example-dom-canvas2d-confetti": "^0.1.7",
-    "@gjsify/example-dom-canvas2d-fireworks": "^0.1.7",
-    "@gjsify/example-dom-canvas2d-text": "^0.1.7",
-    "@gjsify/example-dom-iframe-basic": "^0.1.7",
-    "@gjsify/example-dom-three-extrude-shapes": "^0.1.7",
-    "@gjsify/example-dom-three-geometry-cube": "^0.1.7",
-    "@gjsify/example-dom-three-geometry-shapes": "^0.1.7",
-    "@gjsify/example-dom-three-geometry-teapot": "^0.1.7",
-    "@gjsify/example-dom-three-loader-ldraw": "^0.1.7",
-    "@gjsify/example-dom-three-morphtargets": "^0.1.7",
-    "@gjsify/example-dom-three-multiple-rendertargets": "^0.1.7",
-    "@gjsify/example-dom-three-postprocessing-pixel": "^0.1.7",
-    "@gjsify/example-dom-webgl-demo-fade": "^0.1.7",
-    "@gjsify/example-dom-webgl-tutorial-01": "^0.1.7",
-    "@gjsify/example-dom-webgl-tutorial-02": "^0.1.7",
-    "@gjsify/example-dom-webgl-tutorial-03": "^0.1.7",
-    "@gjsify/example-dom-webgl-tutorial-04": "^0.1.7",
-    "@gjsify/example-dom-webgl-tutorial-05": "^0.1.7",
-    "@gjsify/example-dom-webgl-tutorial-06": "^0.1.7",
-    "@gjsify/example-dom-webgl-tutorial-07": "^0.1.7",
-    "@gjsify/example-node-cli-deepkit-di": "^0.1.7",
-    "@gjsify/example-node-cli-deepkit-events": "^0.1.7",
-    "@gjsify/example-node-cli-deepkit-types": "^0.1.7",
-    "@gjsify/example-node-cli-deepkit-validation": "^0.1.7",
-    "@gjsify/example-node-cli-deepkit-workflow": "^0.1.7",
-    "@gjsify/example-node-cli-dns-lookup": "^0.1.7",
-    "@gjsify/example-node-cli-esbuild-plugin-deepkit": "^0.1.7",
-    "@gjsify/example-node-cli-esbuild-plugin-transform-ext": "^0.1.7",
-    "@gjsify/example-node-cli-file-search": "^0.1.7",
-    "@gjsify/example-node-cli-gio-cat": "^0.1.7",
-    "@gjsify/example-node-cli-json-store": "^0.1.7",
-    "@gjsify/example-node-cli-node-buffer": "^0.1.7",
-    "@gjsify/example-node-cli-node-events": "^0.1.7",
-    "@gjsify/example-node-cli-node-fs": "^0.1.7",
-    "@gjsify/example-node-cli-node-os": "^0.1.7",
-    "@gjsify/example-node-cli-node-path": "^0.1.7",
-    "@gjsify/example-node-cli-node-url": "^0.1.7",
-    "@gjsify/example-node-cli-worker-pool": "^0.1.7",
-    "@gjsify/example-node-cli-yargs-demo": "^0.1.7",
-    "@gjsify/example-node-gtk-http-dashboard": "^0.1.7",
-    "@gjsify/example-node-net-express-hello": "^0.1.7",
-    "@gjsify/example-node-net-hono-rest": "^0.1.7",
-    "@gjsify/example-node-net-koa-blog": "^0.1.7",
-    "@gjsify/example-node-net-sse-chat": "^0.1.7",
-    "@gjsify/example-node-net-static-file-server": "^0.1.7",
-    "@gjsify/example-node-net-ws-chat": "^0.1.7",
-    "@gjsify/node-polyfills": "^0.1.7",
-    "@gjsify/web-polyfills": "^0.1.7",
+    "@gjsify/create-app": "^0.1.9",
+    "@gjsify/esbuild-plugin-gjsify": "^0.1.9",
+    "@gjsify/example-dom-canvas2d-fireworks": "^0.1.9",
+    "@gjsify/example-dom-excalibur-jelly-jumper": "^0.1.9",
+    "@gjsify/example-dom-three-geometry-teapot": "^0.1.9",
+    "@gjsify/example-dom-three-postprocessing-pixel": "^0.1.9",
+    "@gjsify/example-node-express-webserver": "^0.1.9",
+    "@gjsify/node-polyfills": "^0.1.9",
+    "@gjsify/web-polyfills": "^0.1.9",
     "cosmiconfig": "^9.0.1",
     "esbuild": "^0.28.0",
     "get-tsconfig": "^4.13.7",