create-ortha-app 0.4.0

package/dist/lib/template.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.render = render;
+exports.renderManifest = renderManifest;
+exports.renderTemplate = renderTemplate;
+exports.isNonEmptyDirectory = isNonEmptyDirectory;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const conditionals_1 = require("./conditionals");
+const features_1 = require("./features");
+/**
+ * Files renamed on their way out of the template.
+ *
+ * `.gitignore` is the one that matters: **npm refuses to publish a file by that
+ * name**, silently, so a template carrying one ships without it and every
+ * generated app starts by offering to commit `node_modules`. Storing it as
+ * `_gitignore` is the standard workaround (create-vite and create-next-app do
+ * the same). The `.tmpl` suffixes are a smaller thing — they keep a
+ * `package.json` out of the workspace globs that would otherwise read the
+ * template directory as a package of its own.
+ */
+const RENAMES = {
+    _gitignore: '.gitignore',
+    'env.tmpl': '.env',
+    'package.json.tmpl': 'package.json',
+    'README.md.tmpl': 'README.md'
+};
+/** Substitutes every `__PLACEHOLDER__` in `contents`. */
+function render(contents, values) {
+    const replacements = {
+        __APP_NAME__: values.appName,
+        __APP_TITLE__: values.appTitle,
+        __DATABASE_URL__: values.databaseUrl,
+        __DATABASE_NAME__: values.databaseName,
+        __ADMIN_EMAIL__: values.adminEmail,
+        __ADMIN_PASSWORD__: values.adminPassword,
+        __ORTHA_VERSION__: values.orthaVersion
+    };
+    return Object.entries(replacements).reduce((text, [token, value]) => text.split(token).join(value), contents);
+}
+/**
+ * Renders `package.json` for a selection.
+ *
+ * The dependency map is **rebuilt**, not patched: the template ships a manifest
+ * with the non-Ortha dependencies and an empty `@orthacms` set, and the chosen
+ * packages are merged in and re-sorted here. Every `@orthacms/*` range is the
+ * scaffolder's own version, exactly — no caret. Releases are lockstep, and a
+ * partial upgrade can leave two copies of a shared package in `node_modules`,
+ * which means two React context instances and an admin whose sidebar silently
+ * stops talking to its provider.
+ */
+function renderManifest(template, values) {
+    const manifest = JSON.parse(render(template, values));
+    const pin = (names) => Object.fromEntries(names.map((name) => [name, values.orthaVersion]));
+    manifest.dependencies = sortKeys({
+        ...manifest.dependencies,
+        ...pin((0, features_1.resolvePackages)(values.selection))
+    });
+    manifest.devDependencies = sortKeys({
+        ...manifest.devDependencies,
+        ...pin((0, features_1.resolveDevPackages)())
+    });
+    return `${JSON.stringify(manifest, null, 4)}\n`;
+}
+/** A copy of `record` with its keys in sorted order. */
+function sortKeys(record) {
+    return Object.fromEntries(Object.entries(record).sort(([a], [b]) => a.localeCompare(b)));
+}
+/** File extensions rendered as text; everything else is copied byte for byte. */
+const TEXT = /\.(ts|tsx|css|html|json|md|yml|yaml|tmpl|mjs|cjs|js)$|^_gitignore$/;
+/** Every file under `dir`, recursively, as paths relative to it. */
+function filesIn(dir, base = dir) {
+    return (0, node_fs_1.readdirSync)(dir, { withFileTypes: true }).flatMap((entry) => {
+        const path = (0, node_path_1.join)(dir, entry.name);
+        return entry.isDirectory()
+            ? filesIn(path, base)
+            : [(0, node_path_1.relative)(base, path)];
+    });
+}
+/**
+ * Copies the template into `target`: conditional blocks applied, placeholders
+ * substituted, renames performed.
+ *
+ * Binary files are copied verbatim — a distinction worth keeping even though
+ * today's template is all text, since running a favicon through a string
+ * replace corrupts it in a way that only shows up in a browser.
+ */
+function renderTemplate(templateDir, target, values) {
+    const flags = (0, features_1.resolveFlags)(values.selection);
+    for (const file of filesIn(templateDir)) {
+        const source = (0, node_path_1.join)(templateDir, file);
+        const name = file.split('/').pop() ?? file;
+        const renamed = RENAMES[name];
+        const destination = (0, node_path_1.join)(target, renamed ? (0, node_path_1.join)(file, '..', renamed) : file);
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(destination, '..'), { recursive: true });
+        if (!TEXT.test(name)) {
+            (0, node_fs_1.cpSync)(source, destination);
+            continue;
+        }
+        const raw = (0, node_fs_1.readFileSync)(source, 'utf8');
+        // The manifest takes the other path: its dependency set is assembled,
+        // not conditionally line-edited. See `renderManifest`.
+        if (name === 'package.json.tmpl') {
+            (0, node_fs_1.writeFileSync)(destination, renderManifest(raw, values));
+            continue;
+        }
+        (0, node_fs_1.writeFileSync)(destination, render((0, conditionals_1.applyConditionals)(raw, flags, file), values));
+    }
+}
+/** Whether `dir` exists and holds anything. */
+function isNonEmptyDirectory(dir) {
+    return ((0, node_fs_1.existsSync)(dir) &&
+        (0, node_fs_1.statSync)(dir).isDirectory() &&
+        (0, node_fs_1.readdirSync)(dir).length > 0);
+}

package/dist/lib/ui.d.ts

@@ -0,0 +1,76 @@
+/**
+ * A small terminal UI — boxes, colour, and keyboard pickers.
+ *
+ * Hand-rolled rather than pulled from `prompts`/`clack`/`chalk`, because this
+ * package is what `npx` downloads before anything else exists: every dependency
+ * is weight on the very first thing a new user waits for, and a scaffolder that
+ * needs a dependency tree to ask four questions is not a good first impression.
+ * It is also the one package here with no runtime dependencies at all, which is
+ * worth keeping.
+ *
+ * Everything degrades. No TTY, `NO_COLOR`, a dumb terminal, `--yes` — the
+ * pickers never run and the defaults are used, so this behaves the same in CI
+ * as in a terminal.
+ */
+export declare const bold: (text: string) => string;
+export declare const dim: (text: string) => string;
+export declare const red: (text: string) => string;
+export declare const green: (text: string) => string;
+export declare const yellow: (text: string) => string;
+export declare const cyan: (text: string) => string;
+export declare const magenta: (text: string) => string;
+/** Visible width of `text`, ignoring the ANSI escapes inside it. */
+export declare function width(text: string): number;
+/** Prints a boxed banner. */
+export declare function banner(title: string, subtitle: string): void;
+/** Prints a section heading. */
+export declare function section(title: string): void;
+/** Prints an indented note. */
+export declare function note(text: string): void;
+/** Prints a success line. */
+export declare function success(text: string): void;
+/** Prints a warning line. */
+export declare function warn(text: string): void;
+/** Prints an error line to stderr. */
+export declare function error(text: string): void;
+/** Prints a boxed summary of label/value rows. */
+export declare function summary(title: string, rows: readonly (readonly [string, string])[]): void;
+/** Prints the numbered next steps. */
+export declare function nextSteps(steps: readonly string[]): void;
+/** One option in a picker. */
+export interface Choice {
+    /** Value returned when picked. */
+    value: string;
+    /** Shown on the row. */
+    label: string;
+    /** Shown under the label, dimmed. */
+    hint?: string;
+    /** Starts ticked (multi-select) or focused (single-select). */
+    selected?: boolean;
+    /** Rendered greyed out and skipped by the cursor. */
+    disabled?: boolean;
+    /**
+     * Always in the result, shown ticked but unselectable.
+     *
+     * Distinct from `disabled`, which means "cannot be had". A locked row is
+     * something you *do* get and cannot decline — REST, in the protocols
+     * question — and showing it keeps the answer readable as a complete set
+     * rather than a list of extras.
+     */
+    locked?: boolean;
+}
+/** Whether the pickers can run at all. */
+export declare function interactive(): boolean;
+/**
+ * A single-choice picker. Returns the chosen value, or `undefined` if the user
+ * cancelled with Escape or Ctrl-C.
+ */
+export declare function select(label: string, choices: readonly Choice[]): Promise<string | undefined>;
+/**
+ * A checkbox picker. Returns the ticked values — an empty array is a valid
+ * answer, and for the copilot providers it is the meaningful default.
+ *
+ * `undefined` means cancelled.
+ */
+export declare function multiselect(label: string, choices: readonly Choice[]): Promise<string[] | undefined>;
+//# sourceMappingURL=ui.d.ts.map

package/dist/lib/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/lib/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiBH,eAAO,MAAM,IAAI,SAJC,MAAM,KAAG,MAIG,CAAC;AAC/B,eAAO,MAAM,GAAG,SALE,MAAM,KAAG,MAKE,CAAC;AAC9B,eAAO,MAAM,GAAG,SANE,MAAM,KAAG,MAMG,CAAC;AAC/B,eAAO,MAAM,KAAK,SAPA,MAAM,KAAG,MAOK,CAAC;AACjC,eAAO,MAAM,MAAM,SARD,MAAM,KAAG,MAQM,CAAC;AAClC,eAAO,MAAM,IAAI,SATC,MAAM,KAAG,MASI,CAAC;AAChC,eAAO,MAAM,OAAO,SAVF,MAAM,KAAG,MAUO,CAAC;AAEnC,oEAAoE;AACpE,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AA+BD,6BAA6B;AAC7B,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAW5D;AAED,gCAAgC;AAChC,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG3C;AAED,+BAA+B;AAC/B,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED,6BAA6B;AAC7B,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,6BAA6B;AAC7B,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED,sCAAsC;AACtC,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExC;AAED,kDAAkD;AAClD,wBAAgB,OAAO,CACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAC7C,IAAI,CAaN;AAED,sCAAsC;AACtC,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAOxD;AAED,8BAA8B;AAC9B,MAAM,WAAW,MAAM;IACnB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,0CAA0C;AAC1C,wBAAgB,WAAW,IAAI,OAAO,CAErC;AA8DD;;;GAGG;AACH,wBAAsB,MAAM,CACxB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,MAAM,EAAE,GAC3B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgD7B;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,MAAM,EAAE,GAC3B,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAuE/B"}

package/dist/lib/ui.js

@@ -0,0 +1,310 @@
+"use strict";
+/**
+ * A small terminal UI — boxes, colour, and keyboard pickers.
+ *
+ * Hand-rolled rather than pulled from `prompts`/`clack`/`chalk`, because this
+ * package is what `npx` downloads before anything else exists: every dependency
+ * is weight on the very first thing a new user waits for, and a scaffolder that
+ * needs a dependency tree to ask four questions is not a good first impression.
+ * It is also the one package here with no runtime dependencies at all, which is
+ * worth keeping.
+ *
+ * Everything degrades. No TTY, `NO_COLOR`, a dumb terminal, `--yes` — the
+ * pickers never run and the defaults are used, so this behaves the same in CI
+ * as in a terminal.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.magenta = exports.cyan = exports.yellow = exports.green = exports.red = exports.dim = exports.bold = void 0;
+exports.width = width;
+exports.banner = banner;
+exports.section = section;
+exports.note = note;
+exports.success = success;
+exports.warn = warn;
+exports.error = error;
+exports.summary = summary;
+exports.nextSteps = nextSteps;
+exports.interactive = interactive;
+exports.select = select;
+exports.multiselect = multiselect;
+const ESC = '\u001b';
+const CSI = `${ESC}[`;
+/** Whether ANSI colour should be emitted at all. */
+const COLOR = process.stdout.isTTY === true &&
+    !process.env['NO_COLOR'] &&
+    process.env['TERM'] !== 'dumb';
+/** Wraps `text` in an SGR pair, or returns it untouched when colour is off. */
+function sgr(open, close) {
+    return (text) => COLOR ? `${CSI}${open}m${text}${CSI}${close}m` : text;
+}
+exports.bold = sgr(1, 22);
+exports.dim = sgr(2, 22);
+exports.red = sgr(31, 39);
+exports.green = sgr(32, 39);
+exports.yellow = sgr(33, 39);
+exports.cyan = sgr(36, 39);
+exports.magenta = sgr(35, 39);
+/** Visible width of `text`, ignoring the ANSI escapes inside it. */
+function width(text) {
+    return text.replace(new RegExp(`${ESC}\\[[0-9;]*m`, 'g'), '').length;
+}
+/**
+ * Clips `text` to `size` visible columns.
+ *
+ * `keep: 'end'` drops characters from the front, which is what a long path
+ * wants — the tail (`…/scratchpad/v2/minimal`) is the part that identifies it,
+ * and clipping the other way leaves every line reading the same.
+ *
+ * Only ever called on plain text. Clipping a coloured string could cut an ANSI
+ * escape in half and leak the rest of the line's colour into the box border.
+ */
+function truncate(text, size, keep) {
+    if (text.length <= size)
+        return text;
+    if (size <= 1)
+        return '…';
+    return keep === 'end'
+        ? `…${text.slice(text.length - (size - 1))}`
+        : `${text.slice(0, size - 1)}…`;
+}
+/** Pads `text` to exactly `size` visible columns, clipping if it overflows. */
+function pad(text, size) {
+    const visible = width(text);
+    if (visible > size)
+        return truncate(text, size, 'start');
+    return text + ' '.repeat(Math.max(0, size - visible));
+}
+const BOX = 66;
+/** Prints a boxed banner. */
+function banner(title, subtitle) {
+    const inner = BOX - 2;
+    console.log('');
+    console.log((0, exports.magenta)(`╭${'─'.repeat(inner)}╮`));
+    console.log(`${(0, exports.magenta)('│')} ${pad((0, exports.bold)(title), inner - 2)} ${(0, exports.magenta)('│')}`);
+    console.log(`${(0, exports.magenta)('│')} ${pad((0, exports.dim)(truncate(subtitle, inner - 2, 'end')), inner - 2)} ${(0, exports.magenta)('│')}`);
+    console.log((0, exports.magenta)(`╰${'─'.repeat(inner)}╯`));
+}
+/** Prints a section heading. */
+function section(title) {
+    console.log('');
+    console.log(`${(0, exports.cyan)('◆')} ${(0, exports.bold)(title)}`);
+}
+/** Prints an indented note. */
+function note(text) {
+    console.log(`  ${(0, exports.dim)(text)}`);
+}
+/** Prints a success line. */
+function success(text) {
+    console.log(`${(0, exports.green)('✔')} ${text}`);
+}
+/** Prints a warning line. */
+function warn(text) {
+    console.log(`${(0, exports.yellow)('!')} ${text}`);
+}
+/** Prints an error line to stderr. */
+function error(text) {
+    console.error(`${(0, exports.red)('✖')} ${text}`);
+}
+/** Prints a boxed summary of label/value rows. */
+function summary(title, rows) {
+    const inner = BOX - 2;
+    const rule = '─'.repeat(Math.max(0, inner - width(title) - 3));
+    console.log('');
+    console.log((0, exports.dim)(`╭─ ${title} ${rule}╮`));
+    for (const [label, value] of rows) {
+        const room = inner - 2 - 21;
+        const clipped = width(value) > room ? truncate(value, room, 'start') : value;
+        const line = `${pad((0, exports.dim)(label), 20)} ${clipped}`;
+        console.log(`${(0, exports.dim)('│')} ${pad(line, inner - 2)} ${(0, exports.dim)('│')}`);
+    }
+    console.log((0, exports.dim)(`╰${'─'.repeat(inner)}╯`));
+}
+/** Prints the numbered next steps. */
+function nextSteps(steps) {
+    console.log('');
+    console.log((0, exports.bold)('Next steps'));
+    for (const step of steps) {
+        console.log(`  ${(0, exports.cyan)('›')} ${step}`);
+    }
+    console.log('');
+}
+/** Whether the pickers can run at all. */
+function interactive() {
+    return process.stdin.isTTY === true && process.stdout.isTTY === true;
+}
+/**
+ * Reads single keypresses until `handle` says it is done.
+ *
+ * Raw mode is what makes arrow keys and space work without Enter. The `finally`
+ * restores it, because a process that exits while still in raw mode leaves the
+ * user's terminal with no echo, and they have to type `reset` blind to get it
+ * back.
+ */
+async function readKeys(handle) {
+    const { stdin } = process;
+    const wasRaw = stdin.isRaw;
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding('utf8');
+    try {
+        for await (const chunk of stdin) {
+            const outcome = handle(String(chunk));
+            if (outcome !== 'continue')
+                return outcome;
+        }
+        return 'cancel';
+    }
+    finally {
+        stdin.setRawMode(wasRaw === true);
+        stdin.pause();
+    }
+}
+const UP = [`${CSI}A`, 'k'];
+const DOWN = [`${CSI}B`, 'j'];
+const ENTER = ['\r', '\n'];
+/** Ctrl-C and Escape. */
+const CANCEL = ['\u0003', ESC];
+/** Moves `cursor` by `step`, skipping disabled rows and wrapping. */
+function advance(choices, cursor, step) {
+    let next = cursor;
+    for (let i = 0; i < choices.length; i += 1) {
+        next = (next + step + choices.length) % choices.length;
+        const choice = choices[next];
+        if (choice && !choice.disabled && !choice.locked)
+            return next;
+    }
+    return cursor;
+}
+/** Rewrites the picker in place, returning how many lines it painted. */
+function repaint(lines, previous) {
+    if (previous > 0)
+        process.stdout.write(`${CSI}${previous}A`);
+    for (const line of lines) {
+        process.stdout.write(`${CSI}2K${line}\n`);
+    }
+    return lines.length;
+}
+/**
+ * A single-choice picker. Returns the chosen value, or `undefined` if the user
+ * cancelled with Escape or Ctrl-C.
+ */
+async function select(label, choices) {
+    let cursor = choices.findIndex((choice) => !choice.disabled);
+    if (cursor === -1)
+        return undefined;
+    const initial = choices.findIndex((choice) => choice.selected);
+    if (initial !== -1 && !choices[initial]?.disabled)
+        cursor = initial;
+    let painted = 0;
+    const paint = () => {
+        painted = repaint([
+            `${(0, exports.cyan)('◆')} ${(0, exports.bold)(label)}`,
+            ...choices.flatMap((choice, index) => {
+                const focused = index === cursor;
+                const marker = choice.disabled
+                    ? (0, exports.dim)('○')
+                    : focused
+                        ? (0, exports.green)('●')
+                        : '○';
+                const text = choice.disabled
+                    ? (0, exports.dim)(`${choice.label} (unavailable)`)
+                    : focused
+                        ? (0, exports.bold)(choice.label)
+                        : choice.label;
+                return [
+                    `  ${marker} ${text}`,
+                    ...(choice.hint ? [`    ${(0, exports.dim)(choice.hint)}`] : [])
+                ];
+            }),
+            (0, exports.dim)('  ↑↓ move · enter select')
+        ], painted);
+    };
+    paint();
+    const outcome = await readKeys((key) => {
+        if (CANCEL.includes(key))
+            return 'cancel';
+        if (ENTER.includes(key))
+            return 'done';
+        if (UP.includes(key))
+            cursor = advance(choices, cursor, -1);
+        else if (DOWN.includes(key))
+            cursor = advance(choices, cursor, 1);
+        else
+            return 'continue';
+        paint();
+        return 'continue';
+    });
+    return outcome === 'done' ? choices[cursor]?.value : undefined;
+}
+/**
+ * A checkbox picker. Returns the ticked values — an empty array is a valid
+ * answer, and for the copilot providers it is the meaningful default.
+ *
+ * `undefined` means cancelled.
+ */
+async function multiselect(label, choices) {
+    const ticked = new Set(choices
+        .filter((choice) => (choice.selected || choice.locked) && !choice.disabled)
+        .map((choice) => choice.value));
+    let cursor = choices.findIndex((choice) => !choice.disabled && !choice.locked);
+    // Every row is locked or unavailable: there is nothing to ask, so answer
+    // with what is already ticked rather than painting a picker nobody can move.
+    if (cursor === -1)
+        return [...ticked];
+    let painted = 0;
+    const paint = () => {
+        painted = repaint([
+            `${(0, exports.cyan)('◆')} ${(0, exports.bold)(label)}`,
+            ...choices.flatMap((choice, index) => {
+                const focused = index === cursor;
+                const box = choice.disabled
+                    ? (0, exports.dim)('[ ]')
+                    : choice.locked
+                        ? (0, exports.dim)('[x]')
+                        : ticked.has(choice.value)
+                            ? (0, exports.green)('[x]')
+                            : '[ ]';
+                const text = choice.disabled
+                    ? (0, exports.dim)(`${choice.label} (unavailable)`)
+                    : choice.locked
+                        ? (0, exports.dim)(`${choice.label} (always on)`)
+                        : focused
+                            ? (0, exports.bold)(choice.label)
+                            : choice.label;
+                const pointer = focused && !choice.disabled && !choice.locked
+                    ? (0, exports.cyan)('›')
+                    : ' ';
+                return [
+                    `  ${pointer} ${box} ${text}`,
+                    ...(choice.hint ? [`      ${(0, exports.dim)(choice.hint)}`] : [])
+                ];
+            }),
+            (0, exports.dim)('  ↑↓ move · space toggle · enter confirm · none is fine')
+        ], painted);
+    };
+    paint();
+    const outcome = await readKeys((key) => {
+        if (CANCEL.includes(key))
+            return 'cancel';
+        if (ENTER.includes(key))
+            return 'done';
+        if (UP.includes(key))
+            cursor = advance(choices, cursor, -1);
+        else if (DOWN.includes(key))
+            cursor = advance(choices, cursor, 1);
+        else if (key === ' ') {
+            const choice = choices[cursor];
+            if (choice && !choice.disabled && !choice.locked) {
+                if (ticked.has(choice.value))
+                    ticked.delete(choice.value);
+                else
+                    ticked.add(choice.value);
+            }
+        }
+        else
+            return 'continue';
+        paint();
+        return 'continue';
+    });
+    return outcome === 'done' ? [...ticked] : undefined;
+}

package/dist/lib/validate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Rejects a directory name npm could not use as a package name.
+ *
+ * The generated `package.json` takes this verbatim, and npm refuses to install
+ * into a project whose own name is invalid — which surfaces as a confusing
+ * error about the app rather than about the name that was typed.
+ */
+export declare function validateAppName(name: string): string | undefined;
+/** Rejects a connection string that is not a postgres URL. */
+export declare function validateDatabaseUrl(url: string): string | undefined;
+/** The database name inside a postgres connection string. */
+export declare function databaseNameFrom(url: string): string;
+//# sourceMappingURL=validate.d.ts.map

package/dist/lib/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/lib/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUhE;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAenE;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMpD"}

package/dist/lib/validate.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAppName = validateAppName;
+exports.validateDatabaseUrl = validateDatabaseUrl;
+exports.databaseNameFrom = databaseNameFrom;
+/**
+ * Rejects a directory name npm could not use as a package name.
+ *
+ * The generated `package.json` takes this verbatim, and npm refuses to install
+ * into a project whose own name is invalid — which surfaces as a confusing
+ * error about the app rather than about the name that was typed.
+ */
+function validateAppName(name) {
+    if (!name)
+        return 'A name is required.';
+    if (name.length > 214)
+        return 'That name is longer than npm allows (214).';
+    if (name.startsWith('.') || name.startsWith('_')) {
+        return 'A package name cannot start with "." or "_".';
+    }
+    if (!/^[a-z0-9][a-z0-9._-]*$/.test(name)) {
+        return 'Use lowercase letters, digits, dots, hyphens and underscores.';
+    }
+    return undefined;
+}
+/** Rejects a connection string that is not a postgres URL. */
+function validateDatabaseUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return 'That is not a valid URL.';
+    }
+    if (parsed.protocol !== 'postgresql:' && parsed.protocol !== 'postgres:') {
+        return 'Expected a postgresql:// connection string.';
+    }
+    if (!parsed.pathname.replace(/^\//, '')) {
+        return 'The URL needs a database name, e.g. postgresql://…/my_cms.';
+    }
+    return undefined;
+}
+/** The database name inside a postgres connection string. */
+function databaseNameFrom(url) {
+    try {
+        return new URL(url).pathname.replace(/^\//, '') || 'ortha';
+    }
+    catch {
+        return 'ortha';
+    }
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+    "name": "create-ortha-app",
+    "version": "0.4.0",
+    "description": "Create an Ortha CMS app: npx create-ortha-app my-cms",
+    "license": "MIT",
+    "homepage": "https://github.com/ortha-source/ortha-cms/tree/main/packages/create-ortha-app",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/ortha-source/ortha-cms.git",
+        "directory": "packages/create-ortha-app"
+    },
+    "bugs": {
+        "url": "https://github.com/ortha-source/ortha-cms/issues"
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "bin": {
+        "create-ortha-app": "./dist/cli.js"
+    },
+    "files": [
+        "dist",
+        "templates"
+    ],
+    "dependencies": {
+        "tslib": "^2.3.0"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}