@webda/create 0.0.0-stage → 4.0.0-beta.5

package/lib/index.js

@@ -0,0 +1,97 @@
+import { readFile } from "node:fs/promises";
+import { relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { checkTarget, generate, writeFiles } from "./generate.js";
+import { initGit, installDependencies, spawnRunner } from "./install.js";
+import { parseCliArgs } from "./options.js";
+import { clackPrompter, resolveOptions } from "./prompts.js";
+import { fromVersionsFile, fromWorkspace } from "./versions.js";
+const HELP = `Usage: npm create @webda <directory> [-- options]
+
+  --store memory|file|mongodb|postgres   default memory
+  --transports rest,graphql,grpc,mcp     default rest
+  --namespace <PascalCase>               default from the directory name
+  --pm pnpm|npm|yarn                     default: the package manager running this command
+  --no-install                           skip dependency installation
+  --no-git                               skip git init
+  -y, --yes                              accept defaults, never prompt`;
+/**
+ * Run the CLI
+ * @param deps - environment, injectable for tests
+ * @returns process exit code
+ */
+export async function main(deps) {
+    let writing = false;
+    let target = "";
+    try {
+        const args = parseCliArgs(deps.argv);
+        if (args.help) {
+            deps.log(HELP);
+            return 0;
+        }
+        const options = await resolveOptions(args, {
+            interactive: deps.interactive && !args.yes,
+            prompter: deps.prompter,
+            cwd: deps.cwd,
+            userAgent: deps.env.npm_config_user_agent
+        });
+        checkTarget(options.dir);
+        const resolveVersion = options.linkWorkspace
+            ? await fromWorkspace(resolve(deps.cwd, options.linkWorkspace))
+            : fromVersionsFile(deps.versions);
+        const files = await generate({ options, templatesDir: deps.templatesDir, agentDir: deps.agentDir, resolveVersion });
+        writing = true;
+        target = options.dir;
+        await writeFiles(options.dir, files);
+        writing = false;
+        deps.log(`Created ${options.dir}`);
+        if (options.install) {
+            const install = installDependencies(options.pm, options.dir, deps.run);
+            if (!install.ok) {
+                const reason = install.error ? ` (${install.error})` : "";
+                deps.log(`Installing dependencies failed${reason}. Retry with: cd ${options.dir} && ${options.pm} install`);
+                return 1;
+            }
+        }
+        if (options.git) {
+            const git = initGit(options.dir, deps.run);
+            if (git === "missing")
+                deps.log("git not found: skipped repository initialization");
+            if (git === "failed")
+                deps.log("git commands failed: skipped the initial commit");
+        }
+        const cd = relative(deps.cwd, options.dir) || ".";
+        deps.log([
+            "Next steps:",
+            `  cd ${cd}`,
+            `  ${options.pm} run debug        # build, then dev server on http://localhost:18080`,
+            "Open the project in your coding agent: it reads AGENTS.md; skills are in .agents/skills/"
+        ].join("\n"));
+        return 0;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        deps.log(writing ? `Writing files failed: ${message}. Remove ${target} before retrying.` : message);
+        return 1;
+    }
+}
+/**
+ * Dependencies for a real run
+ * @returns deps using the process, clack prompts and the packaged templates
+ */
+export async function defaultDeps() {
+    const versionsFile = fileURLToPath(new URL("./versions.json", import.meta.url));
+    return {
+        argv: process.argv.slice(2),
+        cwd: process.cwd(),
+        env: process.env,
+        interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY),
+        prompter: clackPrompter,
+        run: spawnRunner,
+        log: message => console.log(message),
+        templatesDir: fileURLToPath(new URL("../templates", import.meta.url)),
+        agentDir: fileURLToPath(new URL("../agent", import.meta.url)),
+        versions: JSON.parse(await readFile(versionsFile, "utf8"))
+    };
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/install.d.ts

@@ -0,0 +1,25 @@
+import type { PackageManager } from "./options.js";
+export type Runner = (cmd: string, args: string[], cwd: string) => {
+    status: number | null;
+    error?: NodeJS.ErrnoException;
+};
+export declare const spawnRunner: Runner;
+/**
+ * Install dependencies
+ * @param pm - package manager
+ * @param dir - application directory
+ * @param run - command runner
+ * @returns ok, and the runner error message when there is one
+ */
+export declare function installDependencies(pm: PackageManager, dir: string, run: Runner): {
+    ok: boolean;
+    error?: string;
+};
+/**
+ * Initialize a git repository with an initial commit
+ * @param dir - application directory
+ * @param run - command runner
+ * @returns `missing` when git is not installed, `failed` when a git command fails
+ */
+export declare function initGit(dir: string, run: Runner): "done" | "missing" | "failed";
+//# sourceMappingURL=install.d.ts.map

package/lib/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,MAAM,MAAM,GAAG,CACnB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,KACR;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CAAE,CAAC;AAG9D,eAAO,MAAM,WAAW,EAAE,MAGzB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAGjH;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAO/E"}

package/lib/install.js

@@ -0,0 +1,34 @@
+import { spawnSync } from "node:child_process";
+// pnpm/npm/yarn are .cmd shims on Windows and need a shell; git is an executable and its commit message contains spaces
+export const spawnRunner = (cmd, args, cwd) => {
+    const result = spawnSync(cmd, args, { cwd, stdio: "inherit", shell: process.platform === "win32" && cmd !== "git" });
+    return { status: result.status, error: result.error };
+};
+/**
+ * Install dependencies
+ * @param pm - package manager
+ * @param dir - application directory
+ * @param run - command runner
+ * @returns ok, and the runner error message when there is one
+ */
+export function installDependencies(pm, dir, run) {
+    const result = run(pm, ["install"], dir);
+    return { ok: result.status === 0, error: result.error?.message };
+}
+/**
+ * Initialize a git repository with an initial commit
+ * @param dir - application directory
+ * @param run - command runner
+ * @returns `missing` when git is not installed, `failed` when a git command fails
+ */
+export function initGit(dir, run) {
+    const version = run("git", ["--version"], dir);
+    if (version.error?.code === "ENOENT")
+        return "missing";
+    for (const args of [["init"], ["add", "-A"], ["commit", "-m", "Initial commit from @webda/create"]]) {
+        if (run("git", args, dir).status !== 0)
+            return "failed";
+    }
+    return "done";
+}
+//# sourceMappingURL=install.js.map

package/lib/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAS/C,wHAAwH;AACxH,MAAM,CAAC,MAAM,WAAW,GAAW,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACpD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;IACrH,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAA0C,EAAE,CAAC;AAC7F,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAkB,EAAE,GAAW,EAAE,GAAW;IAC9E,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;IACzC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,GAAW;IAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,KAAK,EAAE,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACvD,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,mCAAmC,CAAC,CAAC,EAAE,CAAC;QACpG,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC;IAC1D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/merge.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Deep merge `source` into a copy of `target`; arrays and primitives from `source` replace
+ * @param target - base value, not mutated
+ * @param source - fragment to merge
+ * @returns the merged copy
+ */
+export declare function deepMerge<T>(target: T, source: unknown): T;
+//# sourceMappingURL=merge.d.ts.map

package/lib/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,CAS1D"}

package/lib/merge.js

@@ -0,0 +1,25 @@
+/**
+ * Whether `value` is a plain object (not an array or null)
+ * @param value - value to test
+ * @returns true for `{...}` values
+ */
+function isObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/**
+ * Deep merge `source` into a copy of `target`; arrays and primitives from `source` replace
+ * @param target - base value, not mutated
+ * @param source - fragment to merge
+ * @returns the merged copy
+ */
+export function deepMerge(target, source) {
+    if (!isObject(target) || !isObject(source)) {
+        return structuredClone(source === undefined ? target : source);
+    }
+    const out = structuredClone(target);
+    for (const [key, value] of Object.entries(source)) {
+        out[key] = key in out ? deepMerge(out[key], value) : structuredClone(value);
+    }
+    return out;
+}
+//# sourceMappingURL=merge.js.map

package/lib/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAI,MAAS,EAAE,MAAe;IACrD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,OAAO,eAAe,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAM,CAAC;IACtE,CAAC;IACD,MAAM,GAAG,GAA4B,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,GAAQ,CAAC;AAClB,CAAC"}

package/lib/options.d.ts

@@ -0,0 +1,64 @@
+export type Store = "memory" | "file" | "mongodb" | "postgres";
+export declare const STORES: Store[];
+export type Transport = "rest" | "graphql" | "grpc" | "mcp";
+export declare const TRANSPORTS: Transport[];
+export type PackageManager = "pnpm" | "npm" | "yarn";
+export declare const PACKAGE_MANAGERS: PackageManager[];
+/**
+ * Fully resolved options used to generate an application
+ */
+export interface CreateOptions {
+    dir: string;
+    store: Store;
+    transports: Transport[];
+    namespace: string;
+    pm: PackageManager;
+    install: boolean;
+    git: boolean;
+    linkWorkspace?: string;
+}
+/**
+ * Command line arguments, before defaults and prompts
+ */
+export interface ParsedArgs {
+    dir?: string;
+    store?: Store;
+    transports?: Transport[];
+    namespace?: string;
+    pm?: PackageManager;
+    install: boolean;
+    git: boolean;
+    yes: boolean;
+    help: boolean;
+    linkWorkspace?: string;
+}
+/**
+ * Invalid or missing user input; the CLI prints the message and exits 1
+ */
+export declare class OptionsError extends Error {
+}
+/**
+ * Parse command line arguments
+ * @param argv - arguments without the node binary and script path
+ * @returns parsed arguments; values not given are undefined
+ */
+export declare function parseCliArgs(argv: string[]): ParsedArgs;
+/**
+ * Derive a PascalCase namespace from a directory name
+ * @param name - directory basename
+ * @returns a namespace matching /^[A-Z][A-Za-z0-9]*$/
+ */
+export declare function toNamespace(name: string): string;
+/**
+ * Derive a valid npm package name from a directory name
+ * @param name - directory basename
+ * @returns lowercase name using only a-z, 0-9, `-`, `_` and `.`
+ */
+export declare function toPackageName(name: string): string;
+/**
+ * Detect which package manager launched the command
+ * @param userAgent - `npm_config_user_agent`
+ * @returns the package manager, `npm` when unknown
+ */
+export declare function detectPackageManager(userAgent: string | undefined): PackageManager;
+//# sourceMappingURL=options.d.ts.map

package/lib/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAC/D,eAAO,MAAM,MAAM,EAAE,KAAK,EAA8C,CAAC;AACzE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC;AAC5D,eAAO,MAAM,UAAU,EAAE,SAAS,EAAuC,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AACrD,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAA4B,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,cAAc,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;CAAG;AAoC1C;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA2CvD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAGlF"}

package/lib/options.js

@@ -0,0 +1,125 @@
+import { parseArgs } from "node:util";
+export const STORES = ["memory", "file", "mongodb", "postgres"];
+export const TRANSPORTS = ["rest", "graphql", "grpc", "mcp"];
+export const PACKAGE_MANAGERS = ["pnpm", "npm", "yarn"];
+/**
+ * Invalid or missing user input; the CLI prints the message and exits 1
+ */
+export class OptionsError extends Error {
+}
+/**
+ * Check `value` is one of `allowed`
+ * @param flag - flag name used in the error message
+ * @param value - user value
+ * @param allowed - valid values
+ * @returns the value, typed
+ */
+function oneOf(flag, value, allowed) {
+    if (!allowed.includes(value)) {
+        throw new OptionsError(`Invalid --${flag} "${value}". Valid values: ${allowed.join(", ")}`);
+    }
+    return value;
+}
+/**
+ * Parse a comma separated transport list, trimming and removing duplicates
+ * @param value - raw `--transports` value
+ * @returns at least one valid transport
+ */
+function parseTransports(value) {
+    const list = [
+        ...new Set(value
+            .split(",")
+            .map(item => item.trim())
+            .filter(Boolean))
+    ];
+    if (list.length === 0) {
+        throw new OptionsError(`--transports needs at least one of: ${TRANSPORTS.join(", ")}`);
+    }
+    return list.map(item => oneOf("transports", item, TRANSPORTS));
+}
+/**
+ * Parse command line arguments
+ * @param argv - arguments without the node binary and script path
+ * @returns parsed arguments; values not given are undefined
+ */
+export function parseCliArgs(argv) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: argv,
+            allowPositionals: true,
+            strict: true,
+            options: {
+                store: { type: "string" },
+                transports: { type: "string" },
+                namespace: { type: "string" },
+                pm: { type: "string" },
+                "no-install": { type: "boolean" },
+                "no-git": { type: "boolean" },
+                yes: { type: "boolean", short: "y" },
+                help: { type: "boolean", short: "h" },
+                "link-workspace": { type: "string" }
+            }
+        });
+    }
+    catch (err) {
+        throw new OptionsError(err.message);
+    }
+    const values = parsed.values;
+    if (parsed.positionals.length > 1) {
+        throw new OptionsError(`Expected one directory, got: ${parsed.positionals.join(" ")}`);
+    }
+    const namespace = values.namespace;
+    if (namespace !== undefined && !/^[A-Z][A-Za-z0-9]*$/.test(namespace)) {
+        throw new OptionsError(`Invalid --namespace "${namespace}": use PascalCase letters and digits, e.g. MyApp`);
+    }
+    const result = {
+        dir: parsed.positionals[0],
+        store: values.store === undefined ? undefined : oneOf("store", values.store, STORES),
+        transports: values.transports === undefined ? undefined : parseTransports(values.transports),
+        namespace,
+        pm: values.pm === undefined ? undefined : oneOf("pm", values.pm, PACKAGE_MANAGERS),
+        install: !values["no-install"],
+        git: !values["no-git"],
+        yes: Boolean(values.yes),
+        help: Boolean(values.help),
+        linkWorkspace: values["link-workspace"]
+    };
+    return result;
+}
+/**
+ * Derive a PascalCase namespace from a directory name
+ * @param name - directory basename
+ * @returns a namespace matching /^[A-Z][A-Za-z0-9]*$/
+ */
+export function toNamespace(name) {
+    const pascal = name
+        .split(/[^A-Za-z0-9]+/)
+        .filter(Boolean)
+        .map(part => part[0].toUpperCase() + part.slice(1))
+        .join("");
+    return /^[A-Z]/.test(pascal) ? pascal : `App${pascal}`;
+}
+/**
+ * Derive a valid npm package name from a directory name
+ * @param name - directory basename
+ * @returns lowercase name using only a-z, 0-9, `-`, `_` and `.`
+ */
+export function toPackageName(name) {
+    const cleaned = name
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^[._-]+|[._-]+$/g, "");
+    return cleaned || "webda-app";
+}
+/**
+ * Detect which package manager launched the command
+ * @param userAgent - `npm_config_user_agent`
+ * @returns the package manager, `npm` when unknown
+ */
+export function detectPackageManager(userAgent) {
+    const name = userAgent?.split("/")[0];
+    return PACKAGE_MANAGERS.includes(name) ? name : "npm";
+}
+//# sourceMappingURL=options.js.map

package/lib/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"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"}

package/lib/prompts.d.ts

@@ -0,0 +1,27 @@
+import { CreateOptions, ParsedArgs } from "./options.js";
+/**
+ * Questions asked in interactive mode; abstracted for tests
+ */
+export interface Prompter {
+    text(message: string, initial: string): Promise<string>;
+    select<T extends string>(message: string, options: T[], initial: T): Promise<T>;
+    multiselect<T extends string>(message: string, options: T[], initial: T[]): Promise<T[]>;
+}
+export declare const clackPrompter: Prompter;
+/**
+ * Apply defaults and, in interactive mode, ask for missing values
+ * @param args - parsed command line
+ * @param context - interactivity, prompter, working directory and package manager user agent
+ * @param context.interactive - whether running in interactive mode
+ * @param context.prompter - prompter implementation for interactive input
+ * @param context.cwd - current working directory
+ * @param context.userAgent - package manager user agent
+ * @returns complete options with an absolute `dir`
+ */
+export declare function resolveOptions(args: ParsedArgs, context: {
+    interactive: boolean;
+    prompter: Prompter;
+    cwd: string;
+    userAgent?: string;
+}): Promise<CreateOptions>;
+//# sourceMappingURL=prompts.d.ts.map

package/lib/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EAGb,UAAU,EAMX,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChF,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CAC1F;AAcD,eAAO,MAAM,aAAa,EAAE,QAuB3B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACrF,OAAO,CAAC,aAAa,CAAC,CA2BxB"}

package/lib/prompts.js

@@ -0,0 +1,73 @@
+import * as clack from "@clack/prompts";
+import { basename, resolve } from "node:path";
+import { detectPackageManager, OptionsError, STORES, toNamespace, TRANSPORTS } from "./options.js";
+/**
+ * Throw on Ctrl-C, otherwise return the answer
+ * @param value - clack answer
+ * @returns the answer
+ */
+function answer(value) {
+    if (clack.isCancel(value)) {
+        throw new OptionsError("Cancelled");
+    }
+    return value;
+}
+export const clackPrompter = {
+    async text(message, initial) {
+        return answer(await clack.text({ message, initialValue: initial }));
+    },
+    async select(message, options, initial) {
+        return answer(await clack.select({
+            message,
+            options: options.map(value => ({ value, label: value })),
+            initialValue: initial
+        }));
+    },
+    async multiselect(message, options, initial) {
+        return answer(await clack.multiselect({
+            message,
+            options: options.map(value => ({ value, label: value })),
+            initialValues: initial,
+            required: false
+        }));
+    }
+};
+/**
+ * Apply defaults and, in interactive mode, ask for missing values
+ * @param args - parsed command line
+ * @param context - interactivity, prompter, working directory and package manager user agent
+ * @param context.interactive - whether running in interactive mode
+ * @param context.prompter - prompter implementation for interactive input
+ * @param context.cwd - current working directory
+ * @param context.userAgent - package manager user agent
+ * @returns complete options with an absolute `dir`
+ */
+export async function resolveOptions(args, context) {
+    const { interactive, prompter, cwd } = context;
+    let dir = args.dir;
+    if (dir === undefined) {
+        if (!interactive) {
+            throw new OptionsError("Missing project directory: npm create @webda <directory>");
+        }
+        dir = (await prompter.text("Project directory", "my-webda-app")).trim();
+        if (!dir)
+            throw new OptionsError("Missing project directory");
+    }
+    const store = args.store ?? (interactive ? await prompter.select("Which store?", STORES, "memory") : "memory");
+    const transports = args.transports ?? (interactive ? await prompter.multiselect("Which transports?", TRANSPORTS, ["rest"]) : ["rest"]);
+    if (transports.length === 0) {
+        throw new OptionsError(`Select at least one transport: ${TRANSPORTS.join(", ")}`);
+    }
+    const absolute = resolve(cwd, dir);
+    return {
+        dir: absolute,
+        store,
+        transports,
+        namespace: args.namespace ?? toNamespace(basename(absolute)),
+        pm: args.pm ?? detectPackageManager(context.userAgent),
+        install: args.install,
+        git: args.git,
+        linkWorkspace: args.linkWorkspace
+    };
+}
+//# sourceMappingURL=prompts.js.map

package/lib/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}

package/lib/template.d.ts

@@ -0,0 +1,25 @@
+export type FileMap = Map<string, string>;
+/**
+ * A base app or a feature overlay
+ */
+export interface Template {
+    name: string;
+    files: FileMap;
+    packageJson: Record<string, any>;
+    config: Record<string, any>;
+    agents: string;
+}
+/**
+ * Read every file under `dir`
+ * @param dir - folder to read; a missing folder gives an empty map
+ * @returns POSIX relative path → content
+ */
+export declare function readTree(dir: string): Promise<FileMap>;
+/**
+ * Load a template folder: `files/`, `package.json`, `webda.config.json` and `agents.md`, all optional
+ * @param dir - template folder
+ * @param name - template name used in error messages
+ * @returns the template
+ */
+export declare function loadTemplate(dir: string, name: string): Promise<Template>;
+//# sourceMappingURL=template.d.ts.map

package/lib/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU5D;AAWD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAS/E"}

package/lib/template.js

@@ -0,0 +1,46 @@
+import { existsSync } from "node:fs";
+import { readdir, readFile } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+/**
+ * Read every file under `dir`
+ * @param dir - folder to read; a missing folder gives an empty map
+ * @returns POSIX relative path → content
+ */
+export async function readTree(dir) {
+    const files = new Map();
+    if (!existsSync(dir))
+        return files;
+    const entries = await readdir(dir, { recursive: true, withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        const full = join(entry.parentPath ?? entry.path, entry.name);
+        files.set(relative(dir, full).split(sep).join("/"), await readFile(full, "utf8"));
+    }
+    return files;
+}
+/**
+ * Read an optional JSON file
+ * @param file - path
+ * @returns parsed content, `{}` when the file does not exist
+ */
+async function readJson(file) {
+    return existsSync(file) ? JSON.parse(await readFile(file, "utf8")) : {};
+}
+/**
+ * Load a template folder: `files/`, `package.json`, `webda.config.json` and `agents.md`, all optional
+ * @param dir - template folder
+ * @param name - template name used in error messages
+ * @returns the template
+ */
+export async function loadTemplate(dir, name) {
+    const agentsFile = join(dir, "agents.md");
+    return {
+        name,
+        files: await readTree(join(dir, "files")),
+        packageJson: await readJson(join(dir, "package.json")),
+        config: await readJson(join(dir, "webda.config.json")),
+        agents: existsSync(agentsFile) ? await readFile(agentsFile, "utf8") : ""
+    };
+}
+//# sourceMappingURL=template.js.map

package/lib/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAehD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW;IACxC,MAAM,KAAK,GAAY,IAAI,GAAG,EAAE,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,SAAS;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,IAAK,KAAa,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,QAAQ,CAAC,IAAY;IAClC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,IAAY;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC1C,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACzC,WAAW,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACtD,MAAM,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;QACtD,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;KACzE,CAAC;AACJ,CAAC"}

package/lib/versions.d.ts

@@ -0,0 +1,22 @@
+export type VersionResolver = (name: string) => string | undefined;
+/** Tool versions taken from @webda/core devDependencies so apps build like the monorepo */
+export declare const EXTERNAL_TOOLS: string[];
+/**
+ * Replace template versions (`workspace:*` for @webda packages, `managed` for tools)
+ * @param pkg - package.json content, mutated
+ * @param resolve - version lookup
+ */
+export declare function applyVersions(pkg: Record<string, any>, resolve: VersionResolver): void;
+/**
+ * Resolve versions from the `versions.json` written at build time
+ * @param versions - package name → version
+ * @returns the resolver
+ */
+export declare function fromVersionsFile(versions: Record<string, string>): VersionResolver;
+/**
+ * Resolve @webda packages to `link:` paths in a monorepo checkout, tools from @webda/core devDependencies
+ * @param root - monorepo root
+ * @returns the resolver
+ */
+export declare function fromWorkspace(root: string): Promise<VersionResolver>;
+//# sourceMappingURL=versions.d.ts.map

package/lib/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAEnE,2FAA2F;AAC3F,eAAO,MAAM,cAAc,UAA2D,CAAC;AAEvF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAYtF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,CAElF;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAW1E"}