@owlmeans/create-app 0.1.18-rc.6 → 0.1.18-rc.60

package/README.md

@@ -9,7 +9,7 @@ bun create @owlmeans/app my-app
 # or
 yarn create @owlmeans/app my-app
 # or
-npx @owlmeans/create-app my-app
+npx @owlmeans/create-app@^0.1.18-rc.60 my-app
 ```
 
 ## What it generates
@@ -18,12 +18,11 @@ A bun-workspace monorepo with three packages and **no authentication**:
 
 ```
 my-app/
-├── AGENTS.md                       # agent context, read by every coding agent
-├── CLAUDE.md                       # thin bridge: imports AGENTS.md, links skills for Claude Code
+├── AGENTS.md                       # agent context, read by every coding agent (Claude Code included)
 ├── .agents/skills/<name>/SKILL.md  # deployed agent skills
 ├── .agents/memory/MEMORY.md        # shared agent memory index
 ├── sources/
-│   ├── common/   # shared entrypoints (routes), schemas and types
+│   ├── common/   # shared protocol declarations (routes), schemas and types
 │   ├── api/      # @owlmeans/server-app backend; session data in an in-memory static resource
 │   └── web/      # @owlmeans/web-panel + shadcn UI: navigation, layout and screens
 ```
@@ -32,6 +31,13 @@ The web app ships a basic shadcn UI **navigation + layout** and a **Session** sc
 that creates, lists and removes items held in a **session-scoped in-memory resource**
 (`@owlmeans/static-resource`) on the backend — no database required.
 
+Logging goes through [`@owlmeans/log`](https://www.npmjs.com/package/@owlmeans/log), with the level
+set per environment and never in code: the api's `config.ts` reads `LOG_LEVEL` (default `info`) and
+`LOG_DEBUG` from the Bun runtime, the web's reads `VITE_LOG_LEVEL` (default `debug` under `vite`,
+`info` in a build) and `VITE_LOG_DEBUG` at build time. The shared `sources/common` config runs in
+both runtimes, so it sets no level and no `cfg.debug` flag. Local values go in the git-ignored
+`sources/api/.env` / `sources/web/.env`.
+
 By default the scaffolder also installs dependencies and **deploys agent guidance**
 into the project via [`@owlmeans/agent-skills`](https://www.npmjs.com/package/@owlmeans/agent-skills)
 (`.agents/skills/`).
@@ -39,7 +45,7 @@ into the project via [`@owlmeans/agent-skills`](https://www.npmjs.com/package/@o
 `AGENTS.md` carries the four mandatory sections a real OwlMeans monorepo uses — **Git Workflow**,
 **Reporting**, **Memory**, **Self-Education** — plus a project-purpose placeholder your agent fills
 in on its first session. GitHub Copilot and Codex read `AGENTS.md` and `.agents/skills/` natively;
-Claude Code reads `CLAUDE.md`, which imports `AGENTS.md` and keeps per-skill symlinks in
+Claude Code reads `AGENTS.md` too and keeps per-skill symlinks in
 `.claude/skills/` fresh through `sh .agents/scripts/link-skills.sh`. The harness guidance (memory
 protocol, self-education, git policy, skill authoring, reuse-first) ships with the template, so it
 is present even with `--no-install`.
@@ -49,6 +55,10 @@ is present even with `--no-install`.
 | Flag | Description |
 |------|-------------|
 | `--name <name>` | Human-readable app name (default: derived from the target dir) |
+| `--slug <slug>` | Package slug, `^[a-z0-9](?:[a-z0-9-]{0,30}[a-z0-9])?$` (default: derived from the target dir) |
+| `--lang <code>` | Language of the generated UI text and `<html lang>` (default: `en`) |
+| `--description <text>` | One-line description used in `README.md`, `AGENTS.md`, the Home screen and the `index.html` meta tags |
+| `--bare` | Scaffold the working shell with no example/demo code |
 | `--pm <bun\|npm\|yarn>` | Package manager (default: `bun`) |
 | `--no-install` | Skip dependency installation |
 | `--no-skills` | Skip the `@owlmeans/agent-skills` deploy |
@@ -56,6 +66,40 @@ is present even with `--no-install`.
 | `--yes`, `-y` | Proceed without prompts / into a non-empty directory |
 | `--help`, `-h` | Show help |
 
+## `--bare`
+
+`--bare` keeps the three workspaces, the config/context/entrypoint wiring, the layout, the nav
+skeleton and one Home screen, and drops every piece of example code — the `SessionItem` types and
+schemas, the api's `app/session/**` handlers and its static resource, the About and Session screens.
+`sources/common/src/entrypoints.ts` exports an immutable `appProtocols` tree with an empty `api`
+branch and the web routes. The API and web bind those branches locally, so the first feature adds a
+declaration to the tree, then a handler and a screen binding.
+
+What bare removes and what it swaps in is declared in `template/_bare.json`, next to the
+`.bare.`-infixed variants it points at — not in the scaffolder's code.
+
+## Programmatic use
+
+`scaffold` performs the filesystem copy and nothing else: no `git init`, no install, no
+agent-skills deploy, no logging. The destination directory may already exist.
+
+```ts
+import { scaffold } from '@owlmeans/create-app'
+
+scaffold({
+  dir: '/tmp/my-app',
+  slug: 'my-app',
+  name: 'My App',        // default: the titleized slug
+  lang: 'en',
+  description: 'What the app is for.',
+  bare: true,
+})
+```
+
+`templateHelper.templateDir()`, `templateHelper.copyTemplate(src, dest, replacements, { bare })` and
+`templateHelper.isEmptyDir(dir)` are exported for callers that want the pieces (`namingHelper` and
+`argsHelper` likewise); `run(args)` is the full CLI flow.
+
 ## Running the generated app
 
 ```sh

package/build/args/types.d.ts

@@ -0,0 +1,9 @@
+import type { CreateArgs } from '../types.js';
+/** The scaffolder CLI's command line. */
+export interface ArgsHelper {
+    /** The options of a process argv, or `null` (after an error on stderr) for an unusable one. */
+    parseArgs: (argv: string[]) => CreateArgs | null;
+    /** Print the usage text to stdout. */
+    printHelp: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/args/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/args/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,yCAAyC;AACzC,MAAM,WAAW,UAAU;IACzB,+FAA+F;IAC/F,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,UAAU,GAAG,IAAI,CAAA;IAChD,sCAAsC;IACtC,SAAS,EAAE,MAAM,IAAI,CAAA;CACtB"}

package/build/args/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/args/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/args/types.ts"],"names":[],"mappings":""}

package/build/args.d.ts

@@ -1,21 +1,4 @@
-export type PackageManager = 'bun' | 'npm' | 'yarn';
-export interface CreateArgs {
-    /** Target directory (positional). `null` means it must be prompted/derived. */
-    dir: string | null;
-    /** Human-readable app name. Defaults to the directory slug. */
-    name: string | null;
-    /** Package manager used to install deps and (for `bun`) run the project. */
-    pm: PackageManager;
-    /** Install dependencies after copying the template. */
-    install: boolean;
-    /** Deploy agent skills via @owlmeans/agent-skills after install. */
-    skills: boolean;
-    /** Run `git init` in the new project. */
-    git: boolean;
-    /** Skip confirmations / proceed into a non-empty directory. */
-    yes: boolean;
-    help: boolean;
-}
-export declare const parseArgs: (argv: string[]) => CreateArgs | null;
-export declare const printHelp: () => void;
+import type { ArgsHelper } from './args/types.js';
+export declare const createArgsHelper: () => ArgsHelper;
+export declare const argsHelper: ArgsHelper;
 //# sourceMappingURL=args.d.ts.map

package/build/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;AAEnD,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,4EAA4E;IAC5E,EAAE,EAAE,cAAc,CAAA;IAClB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAA;IAChB,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAA;IACf,yCAAyC;IACzC,GAAG,EAAE,OAAO,CAAA;IACZ,+DAA+D;IAC/D,GAAG,EAAE,OAAO,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;CACd;AA0BD,eAAO,MAAM,SAAS,SAAU,MAAM,EAAE,KAAG,UAAU,GAAG,IAsEvD,CAAA;AAED,eAAO,MAAM,SAAS,QAAO,IAE5B,CAAA"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,eAAO,MAAM,gBAAgB,QAAO,UA6HnC,CAAA;AAED,eAAO,MAAM,UAAU,YAAqB,CAAA"}

package/build/args.js

@@ -1,96 +1,129 @@
-const HELP = `@owlmeans/create-app — scaffold a fullstack OwlMeans Common app
-
-Usage:
-  npm create @owlmeans/app@latest <dir> [options]
-  bun create @owlmeans/app <dir> [options]
-  yarn create @owlmeans/app <dir> [options]
-  npx @owlmeans/create-app <dir> [options]
-
-Generates three workspaces (common + api + web) with shadcn UI navigation and
-layout, no authentication, and a session-scoped in-memory resource on the
-backend. Agent skills are deployed into the project by default.
-
-Options:
-  --name <name>       human-readable app name (default: derived from <dir>)
-  --pm <bun|npm|yarn> package manager (default: bun)
-  --no-install        do not install dependencies
-  --no-skills         do not deploy agent skills via @owlmeans/agent-skills
-  --no-git            do not run "git init"
-  --yes, -y           proceed without prompts / into a non-empty directory
-  --help, -h          show this help
-`;
-const PMS = ['bun', 'npm', 'yarn'];
-export const parseArgs = (argv) => {
-    const args = argv.slice(2);
-    const result = {
-        dir: null,
-        name: null,
-        pm: 'bun',
-        install: true,
-        skills: true,
-        git: true,
-        yes: false,
-        help: false,
-    };
-    let i = 0;
-    while (i < args.length) {
-        const a = args[i];
-        switch (a) {
-            case '--help':
-            case '-h':
-                result.help = true;
-                break;
-            case '--yes':
-            case '-y':
-                result.yes = true;
-                break;
-            case '--no-install':
-                result.install = false;
-                break;
-            case '--no-skills':
-                result.skills = false;
-                break;
-            case '--no-git':
-                result.git = false;
-                break;
-            case '--name': {
-                const v = args[i + 1];
-                if (v == null || v.startsWith('-')) {
-                    process.stderr.write('error: --name requires a value\n');
-                    return null;
-                }
-                result.name = v;
-                i++;
-                break;
+import { namingHelper } from './naming.js';
+import { DEFAULT_LANG, SLUG_PATTERN } from './consts.js';
+import { HELP, PMS } from './consts.local.js';
+export const createArgsHelper = () => {
+    const parseArgs = (argv) => {
+        const args = argv.slice(2);
+        const result = {
+            dir: null,
+            name: null,
+            slug: null,
+            lang: DEFAULT_LANG,
+            description: null,
+            bare: false,
+            pm: 'bun',
+            install: true,
+            skills: true,
+            git: true,
+            yes: false,
+            help: false,
+        };
+        // A value may legitimately start with `-` only for free-form text, so `--description`
+        // takes whatever follows it; the identifier-shaped flags stay strict.
+        const value = (i, flag, free = false) => {
+            const v = args[i + 1];
+            if (v == null || (!free && v.startsWith('-'))) {
+                process.stderr.write(`error: ${flag} requires a value\n`);
+                return null;
             }
-            case '--pm': {
-                const v = args[i + 1];
-                if (v == null || !PMS.includes(v)) {
-                    process.stderr.write(`error: --pm must be one of ${PMS.join(', ')}\n`);
-                    return null;
+            return v;
+        };
+        let i = 0;
+        while (i < args.length) {
+            const a = args[i];
+            switch (a) {
+                case '--help':
+                case '-h':
+                    result.help = true;
+                    break;
+                case '--yes':
+                case '-y':
+                    result.yes = true;
+                    break;
+                case '--bare':
+                    result.bare = true;
+                    break;
+                case '--no-install':
+                    result.install = false;
+                    break;
+                case '--no-skills':
+                    result.skills = false;
+                    break;
+                case '--no-git':
+                    result.git = false;
+                    break;
+                case '--name': {
+                    const v = value(i, '--name');
+                    if (v == null)
+                        return null;
+                    result.name = v;
+                    i++;
+                    break;
                 }
-                result.pm = v;
-                i++;
-                break;
-            }
-            default:
-                if (a.startsWith('-')) {
-                    process.stderr.write(`error: unknown flag ${a}\n`);
-                    return null;
+                case '--slug': {
+                    const v = value(i, '--slug');
+                    if (v == null)
+                        return null;
+                    if (!namingHelper.isValidSlug(v)) {
+                        process.stderr.write(`error: --slug must match ${SLUG_PATTERN.source}`
+                            + ' — lowercase letters, digits and inner dashes, 1-32 characters\n');
+                        return null;
+                    }
+                    result.slug = v;
+                    i++;
+                    break;
+                }
+                case '--lang': {
+                    const v = value(i, '--lang');
+                    if (v == null)
+                        return null;
+                    if (!namingHelper.isValidLang(v)) {
+                        process.stderr.write(`error: --lang must be a language code such as en or pt-BR\n`);
+                        return null;
+                    }
+                    result.lang = v;
+                    i++;
+                    break;
                 }
-                if (result.dir == null) {
-                    result.dir = a;
+                case '--description': {
+                    const v = value(i, '--description', true);
+                    if (v == null)
+                        return null;
+                    result.description = v;
+                    i++;
+                    break;
                 }
-                else {
-                    process.stderr.write(`error: unexpected argument ${a}\n`);
-                    return null;
+                case '--pm': {
+                    const v = args[i + 1];
+                    if (v == null || !PMS.includes(v)) {
+                        process.stderr.write(`error: --pm must be one of ${PMS.join(', ')}\n`);
+                        return null;
+                    }
+                    result.pm = v;
+                    i++;
+                    break;
                 }
+                default:
+                    if (a.startsWith('-')) {
+                        process.stderr.write(`error: unknown flag ${a}\n`);
+                        return null;
+                    }
+                    if (result.dir == null) {
+                        result.dir = a;
+                    }
+                    else {
+                        process.stderr.write(`error: unexpected argument ${a}\n`);
+                        return null;
+                    }
+            }
+            i++;
         }
-        i++;
-    }
-    return result;
-};
-export const printHelp = () => {
-    process.stdout.write(HELP);
+        return result;
+    };
+    const printHelp = () => {
+        process.stdout.write(HELP);
+    };
+    return { parseArgs, printHelp };
 };
+export const argsHelper = createArgsHelper();
 //# sourceMappingURL=args.js.map

package/build/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAI7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAe,EAAE;IAC/C,MAAM,SAAS,GAAG,CAAC,IAAc,EAAqB,EAAE;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QAC1B,MAAM,MAAM,GAAe;YACzB,GAAG,EAAE,IAAI;YACT,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,IAAI;YACjB,IAAI,EAAE,KAAK;YACX,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI;YACZ,GAAG,EAAE,IAAI;YACT,GAAG,EAAE,KAAK;YACV,IAAI,EAAE,KAAK;SACZ,CAAA;QAED,sFAAsF;QACtF,sEAAsE;QACtE,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,IAAY,EAAE,IAAI,GAAG,KAAK,EAAiB,EAAE;YACrE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YACrB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,qBAAqB,CAAC,CAAA;gBACzD,OAAO,IAAI,CAAA;YACb,CAAC;YACD,OAAO,CAAC,CAAA;QACV,CAAC,CAAA;QAED,IAAI,CAAC,GAAG,CAAC,CAAA;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,QAAQ,CAAC,EAAE,CAAC;gBACV,KAAK,QAAQ,CAAC;gBACd,KAAK,IAAI;oBACP,MAAM,CAAC,IAAI,GAAG,IAAI,CAAA;oBAClB,MAAK;gBACP,KAAK,OAAO,CAAC;gBACb,KAAK,IAAI;oBACP,MAAM,CAAC,GAAG,GAAG,IAAI,CAAA;oBACjB,MAAK;gBACP,KAAK,QAAQ;oBACX,MAAM,CAAC,IAAI,GAAG,IAAI,CAAA;oBAClB,MAAK;gBACP,KAAK,cAAc;oBACjB,MAAM,CAAC,OAAO,GAAG,KAAK,CAAA;oBACtB,MAAK;gBACP,KAAK,aAAa;oBAChB,MAAM,CAAC,MAAM,GAAG,KAAK,CAAA;oBACrB,MAAK;gBACP,KAAK,UAAU;oBACb,MAAM,CAAC,GAAG,GAAG,KAAK,CAAA;oBAClB,MAAK;gBACP,KAAK,QAAQ,EAAE,CAAC;oBACd,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;oBAC5B,IAAI,CAAC,IAAI,IAAI;wBAAE,OAAO,IAAI,CAAA;oBAC1B,MAAM,CAAC,IAAI,GAAG,CAAC,CAAA;oBACf,CAAC,EAAE,CAAA;oBACH,MAAK;gBACP,CAAC;gBACD,KAAK,QAAQ,EAAE,CAAC;oBACd,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;oBAC5B,IAAI,CAAC,IAAI,IAAI;wBAAE,OAAO,IAAI,CAAA;oBAC1B,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;wBACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4BAA4B,YAAY,CAAC,MAAM,EAAE;8BAC/C,kEAAkE,CACrE,CAAA;wBACD,OAAO,IAAI,CAAA;oBACb,CAAC;oBACD,MAAM,CAAC,IAAI,GAAG,CAAC,CAAA;oBACf,CAAC,EAAE,CAAA;oBACH,MAAK;gBACP,CAAC;gBACD,KAAK,QAAQ,EAAE,CAAC;oBACd,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;oBAC5B,IAAI,CAAC,IAAI,IAAI;wBAAE,OAAO,IAAI,CAAA;oBAC1B,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;wBACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAA;wBACnF,OAAO,IAAI,CAAA;oBACb,CAAC;oBACD,MAAM,CAAC,IAAI,GAAG,CAAC,CAAA;oBACf,CAAC,EAAE,CAAA;oBACH,MAAK;gBACP,CAAC;gBACD,KAAK,eAAe,EAAE,CAAC;oBACrB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,CAAA;oBACzC,IAAI,CAAC,IAAI,IAAI;wBAAE,OAAO,IAAI,CAAA;oBAC1B,MAAM,CAAC,WAAW,GAAG,CAAC,CAAA;oBACtB,CAAC,EAAE,CAAA;oBACH,MAAK;gBACP,CAAC;gBACD,KAAK,MAAM,EAAE,CAAC;oBACZ,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAA+B,CAAA;oBACnD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;wBAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;wBACtE,OAAO,IAAI,CAAA;oBACb,CAAC;oBACD,MAAM,CAAC,EAAE,GAAG,CAAC,CAAA;oBACb,CAAC,EAAE,CAAA;oBACH,MAAK;gBACP,CAAC;gBACD;oBACE,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;wBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAA;wBAClD,OAAO,IAAI,CAAA;oBACb,CAAC;oBACD,IAAI,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;wBACvB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAA;oBAChB,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,IAAI,CAAC,CAAA;wBACzD,OAAO,IAAI,CAAA;oBACb,CAAC;YACL,CAAC;YACD,CAAC,EAAE,CAAA;QACL,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;IAED,MAAM,SAAS,GAAG,GAAS,EAAE;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC,CAAA;IAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAA;AACjC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAA"}

package/build/bin.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
-import { parseArgs, printHelp } from './args.js';
+import { argsHelper } from './args.js';
 import { run } from './run.js';
-const args = parseArgs(process.argv);
+const args = argsHelper.parseArgs(process.argv);
 if (args == null) {
     process.stderr.write('Run with --help for usage.\n');
     process.exit(2);
 }
 else if (args.help) {
-    printHelp();
+    argsHelper.printHelp();
     process.exit(0);
 }
 else {

package/build/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAEpC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;KAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,SAAS,EAAE,CAAA;IACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;KAAM,CAAC;IACN,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACpB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAE/C,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;KAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,UAAU,CAAC,SAAS,EAAE,CAAA;IACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;KAAM,CAAC;IACN,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACpB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/build/consts.d.ts

@@ -0,0 +1,6 @@
+/** npm-safe package slug: lowercase alphanumerics and inner dashes, 1–32 chars. */
+export declare const SLUG_PATTERN: RegExp;
+/** Loose BCP-47 shape — enough to keep junk out of `<html lang>` without shipping a registry. */
+export declare const LANG_PATTERN: RegExp;
+export declare const DEFAULT_LANG = "en";
+//# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,YAAY,QAA2C,CAAA;AAEpE,iGAAiG;AACjG,eAAO,MAAM,YAAY,QAA0C,CAAA;AAEnE,eAAO,MAAM,YAAY,OAAO,CAAA"}

package/build/consts.js

@@ -0,0 +1,6 @@
+/** npm-safe package slug: lowercase alphanumerics and inner dashes, 1–32 chars. */
+export const SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,30}[a-z0-9])?$/;
+/** Loose BCP-47 shape — enough to keep junk out of `<html lang>` without shipping a registry. */
+export const LANG_PATTERN = /^[a-zA-Z]{2,8}(?:-[a-zA-Z0-9]{1,8})*$/;
+export const DEFAULT_LANG = 'en';
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAAG,wCAAwC,CAAA;AAEpE,iGAAiG;AACjG,MAAM,CAAC,MAAM,YAAY,GAAG,uCAAuC,CAAA;AAEnE,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAA"}

package/build/consts.local.d.ts

@@ -0,0 +1,12 @@
+import type { PackageManager } from './types.js';
+export declare const HELP = "@owlmeans/create-app \u2014 scaffold a fullstack OwlMeans Common app\n\nUsage:\n  npm create @owlmeans/app@latest <dir> [options]\n  bun create @owlmeans/app <dir> [options]\n  yarn create @owlmeans/app <dir> [options]\n  npx @owlmeans/create-app@^0.1.18-rc.60 <dir> [options]\n\nGenerates three workspaces (common + api + web) with shadcn UI navigation and\nlayout, no authentication, and a session-scoped in-memory resource on the\nbackend. With --bare the demo is left out and only the working shell remains.\nAgent skills are deployed into the project by default.\n\nOptions:\n  --name <name>       human-readable app name (default: derived from <dir>)\n  --slug <slug>       package slug (default: derived from <dir>)\n  --lang <code>       language of the generated UI text (default: en)\n  --description <t>   one-line project description for the generated docs\n  --bare              scaffold the shell only \u2014 no example/demo code\n  --pm <bun|npm|yarn> package manager (default: bun)\n  --no-install        do not install dependencies\n  --no-skills         do not deploy agent skills via @owlmeans/agent-skills\n  --no-git            do not run \"git init\"\n  --yes, -y           proceed without prompts / into a non-empty directory\n  --help, -h          show this help\n";
+export declare const PMS: PackageManager[];
+/** Dotfiles/dirs are shipped with an underscore prefix so npm does not strip them from the tarball. */
+export declare const DOTFILE_RENAMES: Record<string, string>;
+/** Files whose contents are binary or must not be string-substituted. */
+export declare const BINARY_EXT: Set<string>;
+/** Template-root manifest describing what the bare shell drops and what it swaps in. */
+export declare const BARE_MANIFEST = "_bare.json";
+/** Stand-in for the globstar segment while the single-`*` pass runs; cannot occur in a path. */
+export declare const GLOBSTAR = "\0";
+//# sourceMappingURL=consts.local.d.ts.map

package/build/consts.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.d.ts","sourceRoot":"","sources":["../src/consts.local.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,eAAO,MAAM,IAAI,6wCAyBhB,CAAA;AAED,eAAO,MAAM,GAAG,EAAE,cAAc,EAA2B,CAAA;AAE3D,uGAAuG;AACvG,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAYlD,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,UAAU,aAAiF,CAAA;AAExG,wFAAwF;AACxF,eAAO,MAAM,aAAa,eAAe,CAAA;AAEzC,gGAAgG;AAChG,eAAO,MAAM,QAAQ,OAAW,CAAA"}

package/build/consts.local.js

@@ -0,0 +1,49 @@
+import { DEFAULT_LANG } from './consts.js';
+export const HELP = `@owlmeans/create-app — scaffold a fullstack OwlMeans Common app
+
+Usage:
+  npm create @owlmeans/app@latest <dir> [options]
+  bun create @owlmeans/app <dir> [options]
+  yarn create @owlmeans/app <dir> [options]
+  npx @owlmeans/create-app@^0.1.18-rc.60 <dir> [options]
+
+Generates three workspaces (common + api + web) with shadcn UI navigation and
+layout, no authentication, and a session-scoped in-memory resource on the
+backend. With --bare the demo is left out and only the working shell remains.
+Agent skills are deployed into the project by default.
+
+Options:
+  --name <name>       human-readable app name (default: derived from <dir>)
+  --slug <slug>       package slug (default: derived from <dir>)
+  --lang <code>       language of the generated UI text (default: ${DEFAULT_LANG})
+  --description <t>   one-line project description for the generated docs
+  --bare              scaffold the shell only — no example/demo code
+  --pm <bun|npm|yarn> package manager (default: bun)
+  --no-install        do not install dependencies
+  --no-skills         do not deploy agent skills via @owlmeans/agent-skills
+  --no-git            do not run "git init"
+  --yes, -y           proceed without prompts / into a non-empty directory
+  --help, -h          show this help
+`;
+export const PMS = ['bun', 'npm', 'yarn'];
+/** Dotfiles/dirs are shipped with an underscore prefix so npm does not strip them from the tarball. */
+export const DOTFILE_RENAMES = {
+    '_gitignore': '.gitignore',
+    '_npmrc': '.npmrc',
+    '_env': '.env',
+    '_github': '.github',
+    // `_agents` carries the canonical harness — AGENTS.md's skills, the shared memory
+    // store and the link-skills bridge; the template seed (sync-agent-meta) writes
+    // `_agents/skills/` into this tree. `_claude` carries only the Claude Code skill-link
+    // bridge (SessionStart hook + the gitkept symlink dir). Entries whose source dir is
+    // absent are inert.
+    '_agents': '.agents',
+    '_claude': '.claude',
+};
+/** Files whose contents are binary or must not be string-substituted. */
+export const BINARY_EXT = new Set(['.ico', '.png', '.jpg', '.jpeg', '.gif', '.webp', '.woff', '.woff2']);
+/** Template-root manifest describing what the bare shell drops and what it swaps in. */
+export const BARE_MANIFEST = '_bare.json';
+/** Stand-in for the globstar segment while the single-`*` pass runs; cannot occur in a path. */
+export const GLOBSTAR = '\u0000';
+//# sourceMappingURL=consts.local.js.map

package/build/consts.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.js","sourceRoot":"","sources":["../src/consts.local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;oEAgBgD,YAAY;;;;;;;;;CAS/E,CAAA;AAED,MAAM,CAAC,MAAM,GAAG,GAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;AAE3D,uGAAuG;AACvG,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,YAAY,EAAE,YAAY;IAC1B,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,SAAS;IACpB,kFAAkF;IAClF,+EAA+E;IAC/E,sFAAsF;IACtF,oFAAoF;IACpF,oBAAoB;IACpB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;CACrB,CAAA;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;AAExG,wFAAwF;AACxF,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAA;AAEzC,gGAAgG;AAChG,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAA"}

package/build/index.d.ts

@@ -1,6 +1,13 @@
 export { run } from './run.js';
-export { parseArgs, printHelp } from './args.js';
-export type { CreateArgs, PackageManager } from './args.js';
-export { copyTemplate, templateDir, isEmptyDir } from './template.js';
-export type { TemplateReplacements } from './template.js';
+export { argsHelper, createArgsHelper } from './args.js';
+export type { ArgsHelper } from './args/types.js';
+export type { CreateArgs, PackageManager } from './types.js';
+export { scaffold } from './scaffold.js';
+export type { ScaffoldOptions } from './types.js';
+export { createTemplateHelper, templateHelper } from './template.js';
+export type { TemplateHelper } from './template/types.js';
+export type { BareManifest, CopyTemplateOptions, TemplateReplacements } from './types.js';
+export { createNamingHelper, namingHelper } from './naming.js';
+export type { NamingHelper } from './naming/types.js';
+export { DEFAULT_LANG, LANG_PATTERN, SLUG_PATTERN } from './consts.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAChD,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AACrE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACpE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACzF,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC9D,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/build/index.js

@@ -1,4 +1,7 @@
 export { run } from './run.js';
-export { parseArgs, printHelp } from './args.js';
-export { copyTemplate, templateDir, isEmptyDir } from './template.js';
+export { argsHelper, createArgsHelper } from './args.js';
+export { scaffold } from './scaffold.js';
+export { createTemplateHelper, templateHelper } from './template.js';
+export { createNamingHelper, namingHelper } from './naming.js';
+export { DEFAULT_LANG, LANG_PATTERN, SLUG_PATTERN } from './consts.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAEhD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAGxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAGpE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE9D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/build/naming/types.d.ts

@@ -0,0 +1,14 @@
+/** The names a scaffolded app is given: its package slug, language, title and description. */
+export interface NamingHelper {
+    /** Whether a string is an npm-safe package slug (`SLUG_PATTERN`). */
+    isValidSlug: (slug: string) => boolean;
+    /** Whether a string has the loose BCP-47 shape of `LANG_PATTERN`. */
+    isValidLang: (lang: string) => boolean;
+    /** A package slug derived from a target directory; `owlmeans-app` when nothing usable is left. */
+    slugify: (input: string) => string;
+    /** `my-app` → `My App`. */
+    titleize: (slug: string) => string;
+    /** The one-line description an app gets when none is given. */
+    defaultDescription: (name: string) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/naming/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/naming/types.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACtC,qEAAqE;IACrE,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACtC,kGAAkG;IAClG,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAClC,2BAA2B;IAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAClC,+DAA+D;IAC/D,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAC7C"}

package/build/naming/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/naming/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/naming/types.ts"],"names":[],"mappings":""}

package/build/naming.d.ts

@@ -0,0 +1,4 @@
+import type { NamingHelper } from './naming/types.js';
+export declare const createNamingHelper: () => NamingHelper;
+export declare const namingHelper: NamingHelper;
+//# sourceMappingURL=naming.d.ts.map

package/build/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,eAAO,MAAM,kBAAkB,QAAO,YAqBrC,CAAA;AAED,eAAO,MAAM,YAAY,cAAuB,CAAA"}

package/build/naming.js

@@ -0,0 +1,18 @@
+import { basename } from 'node:path';
+import { LANG_PATTERN, SLUG_PATTERN } from './consts.js';
+export const createNamingHelper = () => {
+    const isValidSlug = (slug) => SLUG_PATTERN.test(slug);
+    const isValidLang = (lang) => LANG_PATTERN.test(lang);
+    const slugify = (input) => basename(input)
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, '-')
+        .replace(/^-+/g, '')
+        .slice(0, 32)
+        .replace(/-+$/g, '')
+        || 'owlmeans-app';
+    const titleize = (slug) => slug.split('-').filter(Boolean).map(w => w[0].toUpperCase() + w.slice(1)).join(' ');
+    const defaultDescription = (name) => `${name} — a fullstack OwlMeans Common app.`;
+    return { isValidSlug, isValidLang, slugify, titleize, defaultDescription };
+};
+export const namingHelper = createNamingHelper();
+//# sourceMappingURL=naming.js.map

package/build/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAGxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAiB,EAAE;IACnD,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEtE,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEtE,MAAM,OAAO,GAAG,CAAC,KAAa,EAAU,EAAE,CACxC,QAAQ,CAAC,KAAK,CAAC;SACZ,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;WACjB,cAAc,CAAA;IAErB,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CACxC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAErF,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAU,EAAE,CAClD,GAAG,IAAI,qCAAqC,CAAA;IAE9C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAA;AAC5E,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAA"}

package/build/run.d.ts

@@ -1,3 +1,3 @@
-import type { CreateArgs } from './args.js';
+import type { CreateArgs } from './types.js';
 export declare const run: (args: CreateArgs) => Promise<number>;
 //# sourceMappingURL=run.d.ts.map