@gjsify/cli 0.4.14 → 0.4.15

package/lib/actions/barrels-generate.d.ts

@@ -0,0 +1,31 @@
+export type BarrelExtension = 'js' | 'ts' | 'none';
+export interface BarrelsArgs {
+    /** Directories to scan. Each gets an `index.ts` re-exporting its sibling source files. */
+    paths: string[];
+    /** Import-specifier extension. `js`/`ts`/`none`. */
+    extension: BarrelExtension;
+    /** Resolve `paths` against this directory. Default: `process.cwd()`. */
+    baseDir: string;
+    /** Skip files whose names match any regex. */
+    exclude: RegExp[];
+    /** Header comment prepended to every generated file. */
+    header: string;
+    /** Omit trailing `;` on each export line. */
+    noSemicolon: boolean;
+    /** Use `'` quotes (default). When false, uses `"`. */
+    singleQuotes: boolean;
+    /** Report drift without writing. Returns drift count from generator. */
+    check: boolean;
+    /** Log each file scanned + written. */
+    verbose: boolean;
+}
+export declare const DEFAULT_BARRELS_HEADER = "// Auto-generated by `gjsify barrels` \u2014 do not edit by hand.";
+export declare const DEFAULT_BARRELS_EXCLUDES: readonly string[];
+/**
+ * Regenerate `index.ts` in every directory in `args.paths`.
+ *
+ * Returns the number of files that drifted from the canonical output —
+ * always 0 when `check` is false (drift is rewritten in-place); non-zero
+ * under `check: true` signals CI failure.
+ */
+export declare function generateBarrels(args: BarrelsArgs): Promise<number>;

package/lib/actions/barrels-generate.js

@@ -0,0 +1,78 @@
+// `gjsify barrels` action — regenerate `index.ts` barrel files for one or
+// more directories. Pure async generator, decoupled from yargs so it can
+// be unit-tested in isolation.
+//
+// Adapted from beabee-communityrm/monorepo apps/dev-cli's `generate-index`
+// action (refs/dev-cli — not vendored here): same separation of action vs.
+// command module, same `types/`-dir auto-detection that emits
+// `export type *`, same `export {};` fallback for empty directories,
+// same sorted-output principle. Rewritten for gjsify's yargs CommandModule
+// and `@gjsify/unit` test framework; no external deps. Replaces
+// `barrelsby` (unmaintained since 2022) at consumer sites.
+//
+// Original: Copyright (c) Beabee Community Repo contributors. AGPL-3.0.
+// Reimplemented for gjsify under the project's MIT license.
+import { readdir, readFile, writeFile } from 'node:fs/promises';
+import { basename, extname, join, resolve } from 'node:path';
+export const DEFAULT_BARRELS_HEADER = '// Auto-generated by `gjsify barrels` — do not edit by hand.';
+export const DEFAULT_BARRELS_EXCLUDES = [
+    '\\.test\\.',
+    '\\.spec\\.',
+    '\\.test-data\\.',
+];
+const SOURCE_FILE_RE = /\.(ts|tsx|mts|cts)$/;
+/**
+ * Regenerate `index.ts` in every directory in `args.paths`.
+ *
+ * Returns the number of files that drifted from the canonical output —
+ * always 0 when `check` is false (drift is rewritten in-place); non-zero
+ * under `check: true` signals CI failure.
+ */
+export async function generateBarrels(args) {
+    const quote = args.singleQuotes ? "'" : '"';
+    const semicolon = args.noSemicolon ? '' : ';';
+    const extSuffix = args.extension === 'none' ? '' : `.${args.extension}`;
+    let drift = 0;
+    for (const p of args.paths) {
+        const dir = resolve(args.baseDir, p);
+        const isTypesDir = basename(dir) === 'types';
+        let entries;
+        try {
+            entries = (await readdir(dir, { withFileTypes: true }))
+                .filter((e) => e.isFile())
+                .filter((e) => SOURCE_FILE_RE.test(e.name))
+                .filter((e) => e.name !== 'index.ts')
+                .filter((e) => !args.exclude.some((r) => r.test(e.name)))
+                .sort((a, b) => a.name.localeCompare(b.name));
+        }
+        catch (err) {
+            if (args.verbose)
+                console.error(`[gjsify barrels] skip ${dir}: ${err.message}`);
+            continue;
+        }
+        const lines = entries.map((e) => {
+            const stem = basename(e.name, extname(e.name));
+            const keyword = isTypesDir ? 'export type *' : 'export *';
+            return `${keyword} from ${quote}./${stem}${extSuffix}${quote}${semicolon}`;
+        });
+        const body = lines.length ? `${lines.join('\n')}\n` : 'export {};\n';
+        const out = `${args.header}\n\n${body}`;
+        const indexPath = join(dir, 'index.ts');
+        const previous = await readFile(indexPath, 'utf-8').catch(() => '');
+        if (previous === out) {
+            if (args.verbose)
+                console.log(`[gjsify barrels] up-to-date: ${indexPath}`);
+            continue;
+        }
+        if (args.check) {
+            console.error(`[gjsify barrels] drift: ${indexPath}`);
+            drift++;
+        }
+        else {
+            await writeFile(indexPath, out, 'utf-8');
+            if (args.verbose)
+                console.log(`[gjsify barrels] wrote: ${indexPath}`);
+        }
+    }
+    return drift;
+}

package/lib/commands/barrels.d.ts

@@ -0,0 +1,15 @@
+import type { Command } from '../types/index.js';
+import { type BarrelExtension } from '../actions/barrels-generate.js';
+interface BarrelsOptions {
+    paths?: string[];
+    ext?: BarrelExtension;
+    baseDir?: string;
+    exclude?: string[];
+    header?: string;
+    semicolon?: boolean;
+    singleQuotes?: boolean;
+    check?: boolean;
+    verbose?: boolean;
+}
+export declare const barrelsCommand: Command<unknown, BarrelsOptions>;
+export {};

package/lib/commands/barrels.js

@@ -0,0 +1,103 @@
+// `gjsify barrels` — regenerate `index.ts` barrel files for a set of
+// directories. Drop-in replacement for `barrelsby` (unmaintained 2022+).
+//
+// Examples:
+//   gjsify barrels src/systems src/components       # regenerate two barrels
+//   gjsify barrels --check src/types                # CI guard — exit 1 on drift
+//   gjsify barrels --ext js src/utils               # NodeNext-style import-extensions
+//
+// Conventions:
+//   - A directory literally named `types/` emits `export type *` (type-only
+//     re-export) — avoids dragging value imports through type-only barrels.
+//   - An empty directory yields `export {};` so TypeScript still parses the
+//     file as a module.
+//   - Output is sorted by file name (locale-compare) — deterministic diffs.
+//   - `--check` exits non-zero on drift without writing (pre-commit / CI use).
+import { DEFAULT_BARRELS_EXCLUDES, DEFAULT_BARRELS_HEADER, generateBarrels, } from '../actions/barrels-generate.js';
+export const barrelsCommand = {
+    command: 'barrels [paths..]',
+    description: 'Regenerate `index.ts` barrel files for the given directories. Drop-in replacement for `barrelsby`.',
+    builder: (yargs) => {
+        return yargs
+            .positional('paths', {
+            description: 'Directories whose `index.ts` to (re)generate. May also be passed via `--paths`.',
+            type: 'string',
+            array: true,
+        })
+            .option('paths', {
+            alias: 'p',
+            description: 'Alternative to positional — repeatable list of directories.',
+            type: 'string',
+            array: true,
+        })
+            .option('ext', {
+            description: 'Import-specifier extension. Default: `none` (bundler-mode resolution).',
+            type: 'string',
+            choices: ['js', 'ts', 'none'],
+            default: 'none',
+        })
+            .option('base-dir', {
+            alias: 'b',
+            description: 'Resolve `paths` against this directory. Default: cwd.',
+            type: 'string',
+        })
+            .option('exclude', {
+            description: 'Regex(es) of file names to skip. Repeatable. Defaults: `\\.test\\.`, `\\.spec\\.`, `\\.test-data\\.`.',
+            type: 'string',
+            array: true,
+        })
+            .option('header', {
+            description: 'Header comment prepended to every generated file.',
+            type: 'string',
+        })
+            .option('semicolon', {
+            description: 'Emit trailing `;` on each export line. Negate with `--no-semicolon`. Default: omitted.',
+            type: 'boolean',
+            default: false,
+        })
+            .option('single-quotes', {
+            description: 'Use `\'` for import specifiers. Default: true. Pass `--no-single-quotes` for `"`.',
+            type: 'boolean',
+            default: true,
+        })
+            .option('check', {
+            description: 'Report drift without modifying files; exit non-zero if any barrel is stale.',
+            type: 'boolean',
+            default: false,
+        })
+            .option('verbose', {
+            description: 'Log each file scanned + written.',
+            type: 'boolean',
+            default: false,
+        });
+    },
+    handler: async (args) => {
+        // Both positional (`gjsify barrels src/a src/b`) and the named option
+        // (`--paths src/a --paths src/b`) land in `args.paths` since they share
+        // the same name. Yargs concatenates when both are present.
+        const paths = Array.from(new Set((args.paths ?? []).filter(Boolean)));
+        if (paths.length === 0) {
+            console.error('[gjsify barrels] no paths provided. Pass directories as positional arguments or via --paths.');
+            process.exitCode = 1;
+            return;
+        }
+        const excludePatterns = args.exclude?.length
+            ? args.exclude
+            : [...DEFAULT_BARRELS_EXCLUDES];
+        const drift = await generateBarrels({
+            paths,
+            extension: args.ext ?? 'none',
+            baseDir: args.baseDir ?? process.cwd(),
+            exclude: excludePatterns.map((src) => new RegExp(src)),
+            header: args.header ?? DEFAULT_BARRELS_HEADER,
+            noSemicolon: args.semicolon === false || args.semicolon === undefined,
+            singleQuotes: args.singleQuotes !== false,
+            check: args.check ?? false,
+            verbose: args.verbose ?? false,
+        });
+        if (args.check && drift > 0) {
+            console.error(`[gjsify barrels] ${drift} barrel file(s) drifted. Run without --check to fix.`);
+            process.exitCode = 1;
+        }
+    },
+};

package/lib/commands/index.d.ts

@@ -22,3 +22,4 @@ export * from './format.js';
 export * from './lint.js';
 export * from './fix.js';
 export * from './upgrade.js';
+export * from './barrels.js';

package/lib/commands/index.js

@@ -22,3 +22,4 @@ export * from './format.js';
 export * from './lint.js';
 export * from './fix.js';
 export * from './upgrade.js';
+export * from './barrels.js';

package/lib/commands/install.js

@@ -11,9 +11,12 @@
 // subprocess flow (useful as escape-hatch for projects that hit a
 // missing native-backend feature).
 //
-// Workspace-aware install (`gjsify install` in a monorepo root with a
-// `"workspaces"` field) is Phase D.3 — for now we detect and surface a
-// clear error pointing at the in-progress work.
+// Workspace install (`gjsify install` in a monorepo root with a
+// `"workspaces"` field) hoists every workspace's externals into the root
+// `node_modules/` and symlinks `workspace:*` / `workspace:^` / `workspace:~`
+// refs to their target source. Open follow-ups (see STATUS.md "Open TODOs"):
+// per-workspace dedup of conflicting transitive version ranges (first-match
+// wins today).
 import { chmodSync, existsSync, lstatSync, mkdirSync, readFileSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
 import { dirname, join, relative } from 'node:path';
 import { spawn } from 'node:child_process';
@@ -115,7 +118,7 @@ async function projectInstallNative(args) {
             'not PnP-aware yet. Use `yarn install` or set ' +
             'GJSIFY_INSTALL_BACKEND=npm.');
     }
-    // Workspace install (no args, root pkg.json has `workspaces`) — Phase D.3.
+    // Workspace install (no args, root pkg.json has `workspaces`).
     // Project-local `gjsify install <pkg>` inside a workspace child still
     // goes through the single-package code path below (this branch only
     // fires for the root no-args case, which is the `yarn install`
@@ -199,8 +202,7 @@ function syncLockfileRequested(cwd, specs) {
     }
 }
 /**
- * Phase D.3 — workspace-aware install. Mirrors what `yarn install` does
- * at a monorepo root:
+ * Workspace-aware install. Mirrors what `yarn install` does at a monorepo root:
  *   1. Discover every workspace under the root.
  *   2. Aggregate the union of their external (non-`workspace:`) deps.
  *   3. Run the native install backend ONCE at the root prefix so all
@@ -211,9 +213,9 @@ function syncLockfileRequested(cwd, specs) {
  *      directory into the requesting workspace's `node_modules/<dep>`
  *      so `import '@gjsify/utils'` resolves to the local source.
  *
- * Hoisting strategy is intentionally minimal — D.3 ships the working
- * baseline; per-workspace dedup + nested `node_modules/` for version
- * conflicts are tracked as a follow-up in STATUS.md "Open TODOs".
+ * Hoisting strategy is intentionally minimal — per-workspace dedup +
+ * nested `node_modules/` for version conflicts are tracked as a follow-up
+ * in STATUS.md "Open TODOs".
  */
 async function workspaceInstall(cwd, args) {
     const workspaces = discoverWorkspaces(cwd, { includeRoot: true });

package/lib/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
-import { buildCommand as build, testCommand as test, runCommand as run, infoCommand as info, checkCommand as check, showcaseCommand as showcase, createCommand as create, gresourceCommand as gresource, gettextCommand as gettext, gsettingsCommand as gsettings, flatpakCommand as flatpak, dlxCommand as dlx, installCommand as install, foreachCommand as foreach, workspaceCommand as workspace, packCommand as pack, publishCommand as publish, selfUpdateCommand as selfUpdate, generateInstallerCommand as generateInstaller, uninstallCommand as uninstall, formatCommand as format, lintCommand as lint, fixCommand as fix, upgradeCommand as upgrade, } from './commands/index.js';
+import { buildCommand as build, testCommand as test, runCommand as run, infoCommand as info, checkCommand as check, showcaseCommand as showcase, createCommand as create, gresourceCommand as gresource, gettextCommand as gettext, gsettingsCommand as gsettings, flatpakCommand as flatpak, dlxCommand as dlx, installCommand as install, foreachCommand as foreach, workspaceCommand as workspace, packCommand as pack, publishCommand as publish, selfUpdateCommand as selfUpdate, generateInstallerCommand as generateInstaller, uninstallCommand as uninstall, formatCommand as format, lintCommand as lint, fixCommand as fix, upgradeCommand as upgrade, barrelsCommand as barrels, } from './commands/index.js';
 import { APP_NAME } from './constants.js';
 // `parseAsync()` instead of `.argv` so the top-level await keeps the
 // process alive until command handlers complete. Under Node this is
@@ -35,6 +35,7 @@ await yargs(hideBin(process.argv))
     .command(format.command, format.description, format.builder, format.handler)
     .command(lint.command, lint.description, lint.builder, lint.handler)
     .command(fix.command, fix.description, fix.builder, fix.handler)
+    .command(barrels.command, barrels.description, barrels.builder, barrels.handler)
     .demandCommand(1)
     .help()
     .parseAsync();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/cli",
-    "version": "0.4.14",
+    "version": "0.4.15",
     "description": "CLI for Gjsify",
     "type": "module",
     "main": "lib/index.js",
@@ -37,18 +37,18 @@
         "cli"
     ],
     "dependencies": {
-        "@gjsify/buffer": "^0.4.14",
-        "@gjsify/create-app": "^0.4.14",
-        "@gjsify/node-globals": "^0.4.14",
-        "@gjsify/node-polyfills": "^0.4.14",
-        "@gjsify/npm-registry": "^0.4.14",
-        "@gjsify/resolve-npm": "^0.4.14",
-        "@gjsify/rolldown-plugin-gjsify": "^0.4.14",
-        "@gjsify/rolldown-plugin-pnp": "^0.4.14",
-        "@gjsify/semver": "^0.4.14",
-        "@gjsify/tar": "^0.4.14",
-        "@gjsify/web-polyfills": "^0.4.14",
-        "@gjsify/workspace": "^0.4.14",
+        "@gjsify/buffer": "^0.4.15",
+        "@gjsify/create-app": "^0.4.15",
+        "@gjsify/node-globals": "^0.4.15",
+        "@gjsify/node-polyfills": "^0.4.15",
+        "@gjsify/npm-registry": "^0.4.15",
+        "@gjsify/resolve-npm": "^0.4.15",
+        "@gjsify/rolldown-plugin-gjsify": "^0.4.15",
+        "@gjsify/rolldown-plugin-pnp": "^0.4.15",
+        "@gjsify/semver": "^0.4.15",
+        "@gjsify/tar": "^0.4.15",
+        "@gjsify/web-polyfills": "^0.4.15",
+        "@gjsify/workspace": "^0.4.15",
         "cosmiconfig": "^9.0.1",
         "get-tsconfig": "^4.14.0",
         "pkg-types": "^2.3.1",
@@ -56,12 +56,12 @@
         "yargs": "^18.0.0"
     },
     "devDependencies": {
-        "@gjsify/unit": "^0.4.14",
+        "@gjsify/unit": "^0.4.15",
         "@types/yargs": "^17.0.35",
         "typescript": "^6.0.3"
     },
     "peerDependencies": {
-        "@gjsify/rolldown-native": "^0.4.14"
+        "@gjsify/rolldown-native": "^0.4.15"
     },
     "peerDependenciesMeta": {
         "@gjsify/rolldown-native": {

package/showcases.json

@@ -29,6 +29,20 @@
             "description": "Three.js postprocessing pixel demo",
             "needsWebgl": true
         },
+        {
+            "name": "webrtc-loopback",
+            "category": "dom",
+            "package": "@gjsify/example-dom-webrtc-loopback",
+            "description": "WebRTC data-channel loopback: two local peers exchange offer/answer + ICE, then echo messages over an RTCDataChannel",
+            "needsWebgl": false
+        },
+        {
+            "name": "minimalist-browser",
+            "category": "dom",
+            "package": "@gjsify/example-dom-minimalist-browser",
+            "description": "Minimalist browser with URL bar + back/forward + iframe content area; same code runs in browser (real iframe) and GJS (IFrameBridge over WebKit.WebView)",
+            "needsWebgl": false
+        },
         {
             "name": "express-webserver",
             "category": "node",