create-qpq-app 0.1.5

package/lib/esm/lib/args.d.ts

@@ -0,0 +1,2 @@
+export declare const getArgValue: (argv: string[], flag: string) => string | undefined;
+export declare const getPositionalArgs: (argv: string[], valueFlags: string[]) => string[];

package/lib/esm/lib/args.js

@@ -0,0 +1,16 @@
+// Flag parsing over the command's argv (everything after the command name).
+export const getArgValue = (argv, flag) => {
+    const eq = argv.find((a) => a.startsWith(`${flag}=`));
+    if (eq)
+        return eq.slice(`${flag}=`.length);
+    const idx = argv.indexOf(flag);
+    return idx >= 0 ? argv[idx + 1] : undefined;
+};
+// Positional args = non-flag args, skipping values consumed by known flags.
+export const getPositionalArgs = (argv, valueFlags) => argv.filter((arg, index) => {
+    if (arg.startsWith('--'))
+        return false;
+    const previous = argv[index - 1];
+    return !(previous && valueFlags.includes(previous));
+});
+//# sourceMappingURL=args.js.map

package/lib/esm/lib/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/lib/args.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAc,EAAE,IAAY,EAAsB,EAAE;IAC9E,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;IACtD,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC,CAAC;AAEF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAc,EAAE,UAAoB,EAAY,EAAE,CAClF,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;IACzB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACjC,OAAO,CAAC,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACtD,CAAC,CAAC,CAAC","sourcesContent":["// Flag parsing over the command's argv (everything after the command name).\nexport const getArgValue = (argv: string[], flag: string): string | undefined => {\n  const eq = argv.find((a) => a.startsWith(`${flag}=`));\n  if (eq) return eq.slice(`${flag}=`.length);\n  const idx = argv.indexOf(flag);\n  return idx >= 0 ? argv[idx + 1] : undefined;\n};\n\n// Positional args = non-flag args, skipping values consumed by known flags.\nexport const getPositionalArgs = (argv: string[], valueFlags: string[]): string[] =>\n  argv.filter((arg, index) => {\n    if (arg.startsWith('--')) return false;\n    const previous = argv[index - 1];\n    return !(previous && valueFlags.includes(previous));\n  });\n"]}

package/lib/esm/lib/files.d.ts

@@ -0,0 +1,5 @@
+export declare const listFilesRecursive: (root: string) => string[];
+export declare const replaceInFiles: (root: string, replacements: Array<[from: string, to: string]>) => void;
+export declare const replaceInFileExact: (filePath: string, from: string, to: string) => void;
+export declare const readJsonFile: <T = any>(filePath: string) => T;
+export declare const writeJsonFile: (filePath: string, value: unknown) => void;

package/lib/esm/lib/files.js

@@ -0,0 +1,54 @@
+import fs from 'fs';
+import path from 'path';
+// Extensions the rename sweeps are allowed to touch — everything else
+// (images, favicons, fonts) passes through untouched.
+const TEXT_FILE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.json', '.html', '.css', '.md', '.yml', '.yaml']);
+// Depth-first list of every file under root (root must exist).
+export const listFilesRecursive = (root) => {
+    const files = [];
+    const walk = (dir) => {
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(fullPath);
+            }
+            else {
+                files.push(fullPath);
+            }
+        }
+    };
+    walk(root);
+    return files;
+};
+// Apply literal (non-regex) string replacements to every text file under
+// root. Replacement tokens are chosen to be collision-free ('@todo/',
+// 'apps/todo/'), so this is a mechanical sweep, not a heuristic one.
+export const replaceInFiles = (root, replacements) => {
+    for (const filePath of listFilesRecursive(root)) {
+        if (!TEXT_FILE_EXTENSIONS.has(path.extname(filePath))) {
+            continue;
+        }
+        const original = fs.readFileSync(filePath, 'utf8');
+        let updated = original;
+        for (const [from, to] of replacements) {
+            updated = updated.split(from).join(to);
+        }
+        if (updated !== original) {
+            fs.writeFileSync(filePath, updated);
+        }
+    }
+};
+// Replace an exact string in one file, throwing if it isn't there — targeted
+// edits should fail loudly when the template drifts.
+export const replaceInFileExact = (filePath, from, to) => {
+    const original = fs.readFileSync(filePath, 'utf8');
+    if (!original.includes(from)) {
+        throw new Error(`Expected to find "${from}" in ${filePath} — has the template changed?`);
+    }
+    fs.writeFileSync(filePath, original.split(from).join(to));
+};
+export const readJsonFile = (filePath) => JSON.parse(fs.readFileSync(filePath, 'utf8'));
+export const writeJsonFile = (filePath, value) => {
+    fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`);
+};
+//# sourceMappingURL=files.js.map

package/lib/esm/lib/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../../src/lib/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,sEAAsE;AACtE,sDAAsD;AACtD,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEvI,+DAA+D;AAC/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAY,EAAE;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QACjC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,CAAC;IACX,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,yEAAyE;AACzE,sEAAsE;AACtE,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,YAA+C,EAAQ,EAAE;IACpG,KAAK,MAAM,QAAQ,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACtD,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,OAAO,GAAG,QAAQ,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC;YACtC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzB,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,6EAA6E;AAC7E,qDAAqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,QAAgB,EAAE,IAAY,EAAE,EAAU,EAAQ,EAAE;IACrF,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,QAAQ,QAAQ,8BAA8B,CAAC,CAAC;IAC3F,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAU,QAAgB,EAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAE5G,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAE,KAAc,EAAQ,EAAE;IACtE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC,CAAC","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\n// Extensions the rename sweeps are allowed to touch — everything else\n// (images, favicons, fonts) passes through untouched.\nconst TEXT_FILE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.json', '.html', '.css', '.md', '.yml', '.yaml']);\n\n// Depth-first list of every file under root (root must exist).\nexport const listFilesRecursive = (root: string): string[] => {\n  const files: string[] = [];\n\n  const walk = (dir: string): void => {\n    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {\n      const fullPath = path.join(dir, entry.name);\n      if (entry.isDirectory()) {\n        walk(fullPath);\n      } else {\n        files.push(fullPath);\n      }\n    }\n  };\n\n  walk(root);\n  return files;\n};\n\n// Apply literal (non-regex) string replacements to every text file under\n// root. Replacement tokens are chosen to be collision-free ('@todo/',\n// 'apps/todo/'), so this is a mechanical sweep, not a heuristic one.\nexport const replaceInFiles = (root: string, replacements: Array<[from: string, to: string]>): void => {\n  for (const filePath of listFilesRecursive(root)) {\n    if (!TEXT_FILE_EXTENSIONS.has(path.extname(filePath))) {\n      continue;\n    }\n\n    const original = fs.readFileSync(filePath, 'utf8');\n    let updated = original;\n    for (const [from, to] of replacements) {\n      updated = updated.split(from).join(to);\n    }\n\n    if (updated !== original) {\n      fs.writeFileSync(filePath, updated);\n    }\n  }\n};\n\n// Replace an exact string in one file, throwing if it isn't there — targeted\n// edits should fail loudly when the template drifts.\nexport const replaceInFileExact = (filePath: string, from: string, to: string): void => {\n  const original = fs.readFileSync(filePath, 'utf8');\n  if (!original.includes(from)) {\n    throw new Error(`Expected to find \"${from}\" in ${filePath} — has the template changed?`);\n  }\n  fs.writeFileSync(filePath, original.split(from).join(to));\n};\n\nexport const readJsonFile = <T = any>(filePath: string): T => JSON.parse(fs.readFileSync(filePath, 'utf8'));\n\nexport const writeJsonFile = (filePath: string, value: unknown): void => {\n  fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\\n`);\n};\n"]}

package/lib/esm/lib/packageRoot.d.ts

@@ -0,0 +1,2 @@
+export declare const getOwnPackageRoot: () => string;
+export declare const getOwnVersion: () => string;

package/lib/esm/lib/packageRoot.js

@@ -0,0 +1,18 @@
+import fs from 'fs';
+import path from 'path';
+// This package's root (works from src under ts-node and from lib/commonjs).
+export const getOwnPackageRoot = () => {
+    let dir = __dirname;
+    while (!fs.existsSync(path.join(dir, 'package.json'))) {
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            throw new Error('Could not locate the create-qpq-app package root');
+        dir = parent;
+    }
+    return dir;
+};
+export const getOwnVersion = () => {
+    const packageJson = JSON.parse(fs.readFileSync(path.join(getOwnPackageRoot(), 'package.json'), 'utf8'));
+    return packageJson.version;
+};
+//# sourceMappingURL=packageRoot.js.map

package/lib/esm/lib/packageRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageRoot.js","sourceRoot":"","sources":["../../../src/lib/packageRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE;IAC5C,IAAI,GAAG,GAAG,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACxF,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,GAAW,EAAE;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACxG,OAAO,WAAW,CAAC,OAAO,CAAC;AAC7B,CAAC,CAAC","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\n// This package's root (works from src under ts-node and from lib/commonjs).\nexport const getOwnPackageRoot = (): string => {\n  let dir = __dirname;\n  while (!fs.existsSync(path.join(dir, 'package.json'))) {\n    const parent = path.dirname(dir);\n    if (parent === dir) throw new Error('Could not locate the create-qpq-app package root');\n    dir = parent;\n  }\n  return dir;\n};\n\nexport const getOwnVersion = (): string => {\n  const packageJson = JSON.parse(fs.readFileSync(path.join(getOwnPackageRoot(), 'package.json'), 'utf8'));\n  return packageJson.version;\n};\n"]}

package/lib/esm/lib/prompts.d.ts

@@ -0,0 +1 @@
+export declare const promptSelect: (message: string, choices: string[], defaultChoice?: string) => Promise<string>;

package/lib/esm/lib/prompts.js

@@ -0,0 +1,7 @@
+// Present a single-choice list prompt and return the selected value.
+// @inquirer/prompts is imported lazily so fully-flagged runs never pay for it.
+export const promptSelect = async (message, choices, defaultChoice) => {
+    const { select } = await import('@inquirer/prompts');
+    return select({ message, choices, default: defaultChoice });
+};
+//# sourceMappingURL=prompts.js.map

package/lib/esm/lib/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/lib/prompts.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,OAAe,EAAE,OAAiB,EAAE,aAAsB,EAAmB,EAAE;IAChH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;AAC9D,CAAC,CAAC","sourcesContent":["// Present a single-choice list prompt and return the selected value.\n// @inquirer/prompts is imported lazily so fully-flagged runs never pay for it.\nexport const promptSelect = async (message: string, choices: string[], defaultChoice?: string): Promise<string> => {\n  const { select } = await import('@inquirer/prompts');\n  return select({ message, choices, default: defaultChoice });\n};\n"]}

package/lib/esm/lib/runCommand.d.ts

@@ -0,0 +1,4 @@
+export type RunCommandOptions = {
+    cwd?: string;
+};
+export declare const runCommand: (command: string, args: string[], options?: RunCommandOptions) => Promise<void>;

package/lib/esm/lib/runCommand.js

@@ -0,0 +1,19 @@
+import { spawn } from 'child_process';
+// Spawn a command, inheriting stdio, resolving on success. A non-zero exit
+// REJECTS so a failed install/init stops the run.
+export const runCommand = (command, args, options = {}) => new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+        stdio: 'inherit',
+        shell: true,
+        cwd: options.cwd ?? process.cwd(),
+    });
+    child.on('error', (error) => reject(error));
+    child.on('exit', (code, signal) => {
+        if (signal)
+            return reject(new Error(`${command} was killed with signal ${signal}`));
+        if (code)
+            return reject(new Error(`${command} ${args.join(' ')} exited with code ${code}`));
+        return resolve();
+    });
+});
+//# sourceMappingURL=runCommand.js.map

package/lib/esm/lib/runCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCommand.js","sourceRoot":"","sources":["../../../src/lib/runCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAOtC,2EAA2E;AAC3E,kDAAkD;AAClD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,IAAc,EAAE,UAA6B,EAAE,EAAiB,EAAE,CAC5G,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;QACjC,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,IAAI;QACX,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;KAClC,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAE5C,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QAChC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,OAAO,2BAA2B,MAAM,EAAE,CAAC,CAAC,CAAC;QACpF,IAAI,IAAI;YAAE,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5F,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { spawn } from 'child_process';\n\nexport type RunCommandOptions = {\n  // Working directory for the child (defaults to cwd).\n  cwd?: string;\n};\n\n// Spawn a command, inheriting stdio, resolving on success. A non-zero exit\n// REJECTS so a failed install/init stops the run.\nexport const runCommand = (command: string, args: string[], options: RunCommandOptions = {}): Promise<void> =>\n  new Promise((resolve, reject) => {\n    const child = spawn(command, args, {\n      stdio: 'inherit',\n      shell: true,\n      cwd: options.cwd ?? process.cwd(),\n    });\n\n    child.on('error', (error) => reject(error));\n\n    child.on('exit', (code, signal) => {\n      if (signal) return reject(new Error(`${command} was killed with signal ${signal}`));\n      if (code) return reject(new Error(`${command} ${args.join(' ')} exited with code ${code}`));\n      return resolve();\n    });\n  });\n"]}

package/lib/esm/steps/001_preflight.d.ts

@@ -0,0 +1,2 @@
+import { CreateQpqAppStep } from '../types';
+export declare const preflight: CreateQpqAppStep;

package/lib/esm/steps/001_preflight.js

@@ -0,0 +1,21 @@
+import fs from 'fs';
+// npm-safe, unscoped, url-friendly: lowercase, starts with a letter,
+// letters/digits/hyphens only.
+const VALID_APP_NAME = /^[a-z][a-z0-9-]*$/;
+const MINIMUM_NODE_MAJOR = 22;
+export const preflight = {
+    name: 'Checking prerequisites',
+    run: async ({ targetDirectory, answers }) => {
+        if (!VALID_APP_NAME.test(answers.appName)) {
+            throw new Error(`"${answers.appName}" is not a valid app name — use lowercase letters, digits and hyphens, starting with a letter.`);
+        }
+        const nodeMajor = Number(process.versions.node.split('.')[0]);
+        if (nodeMajor < MINIMUM_NODE_MAJOR) {
+            throw new Error(`quidproquo apps require node >= ${MINIMUM_NODE_MAJOR} (you are on ${process.versions.node}) — upgrade node and re-run.`);
+        }
+        if (fs.existsSync(targetDirectory)) {
+            throw new Error(`${targetDirectory} already exists — pick a different name or remove it first.`);
+        }
+    },
+};
+//# sourceMappingURL=001_preflight.js.map

package/lib/esm/steps/001_preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"001_preflight.js","sourceRoot":"","sources":["../../../src/steps/001_preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAIpB,qEAAqE;AACrE,+BAA+B;AAC/B,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAE3C,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,MAAM,CAAC,MAAM,SAAS,GAAqB;IACzC,IAAI,EAAE,wBAAwB;IAE9B,GAAG,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,EAAE;QAC1C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,gGAAgG,CAAC,CAAC;QACvI,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,IAAI,SAAS,GAAG,kBAAkB,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,kBAAkB,gBAAgB,OAAO,CAAC,QAAQ,CAAC,IAAI,8BAA8B,CAAC,CAAC;QAC5I,CAAC;QAED,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,GAAG,eAAe,6DAA6D,CAAC,CAAC;QACnG,CAAC;IACH,CAAC;CACF,CAAC","sourcesContent":["import fs from 'fs';\n\nimport { CreateQpqAppStep } from '../types';\n\n// npm-safe, unscoped, url-friendly: lowercase, starts with a letter,\n// letters/digits/hyphens only.\nconst VALID_APP_NAME = /^[a-z][a-z0-9-]*$/;\n\nconst MINIMUM_NODE_MAJOR = 22;\n\nexport const preflight: CreateQpqAppStep = {\n  name: 'Checking prerequisites',\n\n  run: async ({ targetDirectory, answers }) => {\n    if (!VALID_APP_NAME.test(answers.appName)) {\n      throw new Error(`\"${answers.appName}\" is not a valid app name — use lowercase letters, digits and hyphens, starting with a letter.`);\n    }\n\n    const nodeMajor = Number(process.versions.node.split('.')[0]);\n    if (nodeMajor < MINIMUM_NODE_MAJOR) {\n      throw new Error(`quidproquo apps require node >= ${MINIMUM_NODE_MAJOR} (you are on ${process.versions.node}) — upgrade node and re-run.`);\n    }\n\n    if (fs.existsSync(targetDirectory)) {\n      throw new Error(`${targetDirectory} already exists — pick a different name or remove it first.`);\n    }\n  },\n};\n"]}

package/lib/esm/steps/002_copyTemplate.d.ts

@@ -0,0 +1,2 @@
+import { CreateQpqAppStep } from '../types';
+export declare const copyTemplate: CreateQpqAppStep;

package/lib/esm/steps/002_copyTemplate.js

@@ -0,0 +1,14 @@
+import fs from 'fs';
+// Dumb copy of the bundled template (a pruned snapshot of quidproquojs.com,
+// taken at publish time) into the target directory. All shaping happens in
+// the steps that follow.
+export const copyTemplate = {
+    name: 'Copying template',
+    run: async ({ templateDirectory, targetDirectory }) => {
+        if (!fs.existsSync(templateDirectory)) {
+            throw new Error(`Template snapshot missing at ${templateDirectory} — run "npm run snapshot-template" (dev checkout only; published packages ship it).`);
+        }
+        fs.cpSync(templateDirectory, targetDirectory, { recursive: true });
+    },
+};
+//# sourceMappingURL=002_copyTemplate.js.map

package/lib/esm/steps/002_copyTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"002_copyTemplate.js","sourceRoot":"","sources":["../../../src/steps/002_copyTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAIpB,4EAA4E;AAC5E,2EAA2E;AAC3E,yBAAyB;AACzB,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,IAAI,EAAE,kBAAkB;IAExB,GAAG,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,eAAe,EAAE,EAAE,EAAE;QACpD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,gCAAgC,iBAAiB,qFAAqF,CACvI,CAAC;QACJ,CAAC;QAED,EAAE,CAAC,MAAM,CAAC,iBAAiB,EAAE,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;CACF,CAAC","sourcesContent":["import fs from 'fs';\n\nimport { CreateQpqAppStep } from '../types';\n\n// Dumb copy of the bundled template (a pruned snapshot of quidproquojs.com,\n// taken at publish time) into the target directory. All shaping happens in\n// the steps that follow.\nexport const copyTemplate: CreateQpqAppStep = {\n  name: 'Copying template',\n\n  run: async ({ templateDirectory, targetDirectory }) => {\n    if (!fs.existsSync(templateDirectory)) {\n      throw new Error(\n        `Template snapshot missing at ${templateDirectory} — run \"npm run snapshot-template\" (dev checkout only; published packages ship it).`,\n      );\n    }\n\n    fs.cpSync(templateDirectory, targetDirectory, { recursive: true });\n  },\n};\n"]}

package/lib/esm/steps/003_deleteDocusaurus.d.ts

@@ -0,0 +1,2 @@
+import { CreateQpqAppStep } from '../types';
+export declare const deleteDocusaurus: CreateQpqAppStep;

package/lib/esm/steps/003_deleteDocusaurus.js

@@ -0,0 +1,16 @@
+import fs from 'fs';
+import path from 'path';
+import { readJsonFile, writeJsonFile } from '../lib/files';
+// The docusaurus workspace is the quidproquojs.com documentation site — new
+// apps don't want it. Remove the directory and its workspaces entry.
+export const deleteDocusaurus = {
+    name: 'Removing docusaurus docs site',
+    run: async ({ targetDirectory }) => {
+        fs.rmSync(path.join(targetDirectory, 'docusaurus'), { recursive: true, force: true });
+        const packageJsonPath = path.join(targetDirectory, 'package.json');
+        const packageJson = readJsonFile(packageJsonPath);
+        packageJson.workspaces = (packageJson.workspaces ?? []).filter((workspace) => workspace !== 'docusaurus');
+        writeJsonFile(packageJsonPath, packageJson);
+    },
+};
+//# sourceMappingURL=003_deleteDocusaurus.js.map

package/lib/esm/steps/003_deleteDocusaurus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"003_deleteDocusaurus.js","sourceRoot":"","sources":["../../../src/steps/003_deleteDocusaurus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG3D,4EAA4E;AAC5E,qEAAqE;AACrE,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD,IAAI,EAAE,+BAA+B;IAErC,GAAG,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;QACjC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtF,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;QACnE,MAAM,WAAW,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;QAClD,WAAW,CAAC,UAAU,GAAG,CAAC,WAAW,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,SAAiB,EAAE,EAAE,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC;QAClH,aAAa,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\nimport { readJsonFile, writeJsonFile } from '../lib/files';\nimport { CreateQpqAppStep } from '../types';\n\n// The docusaurus workspace is the quidproquojs.com documentation site — new\n// apps don't want it. Remove the directory and its workspaces entry.\nexport const deleteDocusaurus: CreateQpqAppStep = {\n  name: 'Removing docusaurus docs site',\n\n  run: async ({ targetDirectory }) => {\n    fs.rmSync(path.join(targetDirectory, 'docusaurus'), { recursive: true, force: true });\n\n    const packageJsonPath = path.join(targetDirectory, 'package.json');\n    const packageJson = readJsonFile(packageJsonPath);\n    packageJson.workspaces = (packageJson.workspaces ?? []).filter((workspace: string) => workspace !== 'docusaurus');\n    writeJsonFile(packageJsonPath, packageJson);\n  },\n};\n"]}

package/lib/esm/steps/004_deleteQpqjsApp.d.ts

@@ -0,0 +1,2 @@
+import { CreateQpqAppStep } from '../types';
+export declare const deleteQpqjsApp: CreateQpqAppStep;

package/lib/esm/steps/004_deleteQpqjsApp.js

@@ -0,0 +1,11 @@
+import fs from 'fs';
+import path from 'path';
+// apps/qpqjs is the real quidproquojs.com website; the starter the user keeps
+// is apps/todo. This must run before applyAppIdentity renames apps/todo.
+export const deleteQpqjsApp = {
+    name: 'Removing the qpqjs website app',
+    run: async ({ targetDirectory }) => {
+        fs.rmSync(path.join(targetDirectory, 'apps', 'qpqjs'), { recursive: true, force: true });
+    },
+};
+//# sourceMappingURL=004_deleteQpqjsApp.js.map

package/lib/esm/steps/004_deleteQpqjsApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"004_deleteQpqjsApp.js","sourceRoot":"","sources":["../../../src/steps/004_deleteQpqjsApp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAIxB,8EAA8E;AAC9E,yEAAyE;AACzE,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,IAAI,EAAE,gCAAgC;IAEtC,GAAG,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;QACjC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3F,CAAC;CACF,CAAC","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\nimport { CreateQpqAppStep } from '../types';\n\n// apps/qpqjs is the real quidproquojs.com website; the starter the user keeps\n// is apps/todo. This must run before applyAppIdentity renames apps/todo.\nexport const deleteQpqjsApp: CreateQpqAppStep = {\n  name: 'Removing the qpqjs website app',\n\n  run: async ({ targetDirectory }) => {\n    fs.rmSync(path.join(targetDirectory, 'apps', 'qpqjs'), { recursive: true, force: true });\n  },\n};\n"]}

package/lib/esm/steps/005_applyAppIdentity.d.ts

@@ -0,0 +1,2 @@
+import { CreateQpqAppStep } from '../types';
+export declare const applyAppIdentity: CreateQpqAppStep;

package/lib/esm/steps/005_applyAppIdentity.js

@@ -0,0 +1,36 @@
+import fs from 'fs';
+import path from 'path';
+import { readJsonFile, replaceInFileExact, replaceInFiles, writeJsonFile } from '../lib/files';
+// Give the app its identity. Only targeted, collision-free tokens are
+// rewritten — the app FOLDER, the package SCOPE and the deploy PREFIX take
+// the app name, while template vocabulary (TodoServiceEnum, services/todo,
+// TodoList, TODO comments) is deliberately left alone so every generated app
+// shares the same internal layout.
+export const applyAppIdentity = {
+    name: 'Applying app identity',
+    run: async ({ targetDirectory, answers }) => {
+        const { appName } = answers;
+        const todoAppDirectory = path.join(targetDirectory, 'apps', 'todo');
+        const appDirectory = path.join(targetDirectory, 'apps', appName);
+        if (appName !== 'todo') {
+            fs.renameSync(todoAppDirectory, appDirectory);
+        }
+        replaceInFiles(targetDirectory, [
+            // Workspace package scope: @todo/constants -> @myapp/constants
+            ['@todo/', `@${appName}/`],
+            // Build/dist and federated-alias paths: dist/apps/todo/... -> dist/apps/myapp/...
+            ['apps/todo/', `apps/${appName}/`],
+        ]);
+        // The deploy prefix names every stack/resource — this is the app name.
+        const deployConfigPath = path.join(targetDirectory, 'apps', appName, 'deploy.config.json');
+        const deployConfig = readJsonFile(deployConfigPath);
+        deployConfig.prefix = appName;
+        writeJsonFile(deployConfigPath, deployConfig);
+        replaceInFileExact(path.join(appDirectory, 'packages', 'service-utils', 'src', 'defineTodoService.ts'), "const modulePrefix = 'todo';", `const modulePrefix = '${appName}';`);
+        const rootPackageJsonPath = path.join(targetDirectory, 'package.json');
+        const rootPackageJson = readJsonFile(rootPackageJsonPath);
+        rootPackageJson.name = appName;
+        writeJsonFile(rootPackageJsonPath, rootPackageJson);
+    },
+};
+//# sourceMappingURL=005_applyAppIdentity.js.map

package/lib/esm/steps/005_applyAppIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"005_applyAppIdentity.js","sourceRoot":"","sources":["../../../src/steps/005_applyAppIdentity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG/F,sEAAsE;AACtE,2EAA2E;AAC3E,2EAA2E;AAC3E,6EAA6E;AAC7E,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD,IAAI,EAAE,uBAAuB;IAE7B,GAAG,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,EAAE;QAC1C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAE5B,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACpE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACjE,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACvB,EAAE,CAAC,UAAU,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;QAChD,CAAC;QAED,cAAc,CAAC,eAAe,EAAE;YAC9B,+DAA+D;YAC/D,CAAC,QAAQ,EAAE,IAAI,OAAO,GAAG,CAAC;YAC1B,kFAAkF;YAClF,CAAC,YAAY,EAAE,QAAQ,OAAO,GAAG,CAAC;SACnC,CAAC,CAAC;QAEH,uEAAuE;QACvE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC;QAC3F,MAAM,YAAY,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;QACpD,YAAY,CAAC,MAAM,GAAG,OAAO,CAAC;QAC9B,aAAa,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;QAE9C,kBAAkB,CAChB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,sBAAsB,CAAC,EACnF,8BAA8B,EAC9B,yBAAyB,OAAO,IAAI,CACrC,CAAC;QAEF,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;QACvE,MAAM,eAAe,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;QAC1D,eAAe,CAAC,IAAI,GAAG,OAAO,CAAC;QAC/B,aAAa,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;IACtD,CAAC;CACF,CAAC","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\nimport { readJsonFile, replaceInFileExact, replaceInFiles, writeJsonFile } from '../lib/files';\nimport { CreateQpqAppStep } from '../types';\n\n// Give the app its identity. Only targeted, collision-free tokens are\n// rewritten — the app FOLDER, the package SCOPE and the deploy PREFIX take\n// the app name, while template vocabulary (TodoServiceEnum, services/todo,\n// TodoList, TODO comments) is deliberately left alone so every generated app\n// shares the same internal layout.\nexport const applyAppIdentity: CreateQpqAppStep = {\n  name: 'Applying app identity',\n\n  run: async ({ targetDirectory, answers }) => {\n    const { appName } = answers;\n\n    const todoAppDirectory = path.join(targetDirectory, 'apps', 'todo');\n    const appDirectory = path.join(targetDirectory, 'apps', appName);\n    if (appName !== 'todo') {\n      fs.renameSync(todoAppDirectory, appDirectory);\n    }\n\n    replaceInFiles(targetDirectory, [\n      // Workspace package scope: @todo/constants -> @myapp/constants\n      ['@todo/', `@${appName}/`],\n      // Build/dist and federated-alias paths: dist/apps/todo/... -> dist/apps/myapp/...\n      ['apps/todo/', `apps/${appName}/`],\n    ]);\n\n    // The deploy prefix names every stack/resource — this is the app name.\n    const deployConfigPath = path.join(targetDirectory, 'apps', appName, 'deploy.config.json');\n    const deployConfig = readJsonFile(deployConfigPath);\n    deployConfig.prefix = appName;\n    writeJsonFile(deployConfigPath, deployConfig);\n\n    replaceInFileExact(\n      path.join(appDirectory, 'packages', 'service-utils', 'src', 'defineTodoService.ts'),\n      \"const modulePrefix = 'todo';\",\n      `const modulePrefix = '${appName}';`,\n    );\n\n    const rootPackageJsonPath = path.join(targetDirectory, 'package.json');\n    const rootPackageJson = readJsonFile(rootPackageJsonPath);\n    rootPackageJson.name = appName;\n    writeJsonFile(rootPackageJsonPath, rootPackageJson);\n  },\n};\n"]}

package/lib/esm/steps/006_applyDomain.d.ts

@@ -0,0 +1,2 @@
+import { CreateQpqAppStep } from '../types';
+export declare const applyDomain: CreateQpqAppStep;

package/lib/esm/steps/006_applyDomain.js

@@ -0,0 +1,16 @@
+import path from 'path';
+import { readJsonFile, replaceInFileExact, writeJsonFile } from '../lib/files';
+// The template's domain, replaced wherever it's authoritative: the deploy
+// config and the app's domain constant (everything else derives from those).
+const TEMPLATE_DOMAIN = 'todo.quidproquojs.com';
+export const applyDomain = {
+    name: 'Applying domain',
+    run: async ({ targetDirectory, answers }) => {
+        const deployConfigPath = path.join(targetDirectory, 'apps', answers.appName, 'deploy.config.json');
+        const deployConfig = readJsonFile(deployConfigPath);
+        deployConfig.domain = answers.domain;
+        writeJsonFile(deployConfigPath, deployConfig);
+        replaceInFileExact(path.join(targetDirectory, 'apps', answers.appName, 'packages', 'constants', 'src', 'domain.ts'), TEMPLATE_DOMAIN, answers.domain);
+    },
+};
+//# sourceMappingURL=006_applyDomain.js.map

package/lib/esm/steps/006_applyDomain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"006_applyDomain.js","sourceRoot":"","sources":["../../../src/steps/006_applyDomain.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG/E,0EAA0E;AAC1E,6EAA6E;AAC7E,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEhD,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,IAAI,EAAE,iBAAiB;IAEvB,GAAG,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,EAAE;QAC1C,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QACnG,MAAM,YAAY,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;QACpD,YAAY,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QACrC,aAAa,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;QAE9C,kBAAkB,CAChB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC,EAChG,eAAe,EACf,OAAO,CAAC,MAAM,CACf,CAAC;IACJ,CAAC;CACF,CAAC","sourcesContent":["import path from 'path';\n\nimport { readJsonFile, replaceInFileExact, writeJsonFile } from '../lib/files';\nimport { CreateQpqAppStep } from '../types';\n\n// The template's domain, replaced wherever it's authoritative: the deploy\n// config and the app's domain constant (everything else derives from those).\nconst TEMPLATE_DOMAIN = 'todo.quidproquojs.com';\n\nexport const applyDomain: CreateQpqAppStep = {\n  name: 'Applying domain',\n\n  run: async ({ targetDirectory, answers }) => {\n    const deployConfigPath = path.join(targetDirectory, 'apps', answers.appName, 'deploy.config.json');\n    const deployConfig = readJsonFile(deployConfigPath);\n    deployConfig.domain = answers.domain;\n    writeJsonFile(deployConfigPath, deployConfig);\n\n    replaceInFileExact(\n      path.join(targetDirectory, 'apps', answers.appName, 'packages', 'constants', 'src', 'domain.ts'),\n      TEMPLATE_DOMAIN,\n      answers.domain,\n    );\n  },\n};\n"]}

package/lib/esm/steps/007_pinRegistryVersions.d.ts

@@ -0,0 +1,2 @@
+import { CreateQpqAppStep } from '../types';
+export declare const pinRegistryVersions: CreateQpqAppStep;

package/lib/esm/steps/007_pinRegistryVersions.js

@@ -0,0 +1,22 @@
+import path from 'path';
+import { readJsonFile, writeJsonFile } from '../lib/files';
+// quidproquojs.com lives beside the quidproquo monorepo and consumes it via
+// file:../ refs; a generated app lives anywhere, so those become registry
+// versions pinned to create-qpq-app's own version — the whole family is
+// published in lockstep, so the versions always exist together.
+export const pinRegistryVersions = {
+    name: 'Pinning quidproquo versions',
+    run: async ({ targetDirectory, ownVersion }) => {
+        const packageJsonPath = path.join(targetDirectory, 'package.json');
+        const packageJson = readJsonFile(packageJsonPath);
+        for (const dependencyBlock of [packageJson.dependencies, packageJson.devDependencies]) {
+            for (const [name, version] of Object.entries(dependencyBlock ?? {})) {
+                if (name.startsWith('quidproquo') && String(version).startsWith('file:')) {
+                    dependencyBlock[name] = ownVersion;
+                }
+            }
+        }
+        writeJsonFile(packageJsonPath, packageJson);
+    },
+};
+//# sourceMappingURL=007_pinRegistryVersions.js.map

package/lib/esm/steps/007_pinRegistryVersions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"007_pinRegistryVersions.js","sourceRoot":"","sources":["../../../src/steps/007_pinRegistryVersions.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG3D,4EAA4E;AAC5E,0EAA0E;AAC1E,wEAAwE;AACxE,gEAAgE;AAChE,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD,IAAI,EAAE,6BAA6B;IAEnC,GAAG,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,EAAE,EAAE;QAC7C,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;QACnE,MAAM,WAAW,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;QAElD,KAAK,MAAM,eAAe,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,WAAW,CAAC,eAAe,CAAC,EAAE,CAAC;YACtF,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,CAAC;gBACpE,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBACzE,eAAe,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;gBACrC,CAAC;YACH,CAAC;QACH,CAAC;QAED,aAAa,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC","sourcesContent":["import path from 'path';\n\nimport { readJsonFile, writeJsonFile } from '../lib/files';\nimport { CreateQpqAppStep } from '../types';\n\n// quidproquojs.com lives beside the quidproquo monorepo and consumes it via\n// file:../ refs; a generated app lives anywhere, so those become registry\n// versions pinned to create-qpq-app's own version — the whole family is\n// published in lockstep, so the versions always exist together.\nexport const pinRegistryVersions: CreateQpqAppStep = {\n  name: 'Pinning quidproquo versions',\n\n  run: async ({ targetDirectory, ownVersion }) => {\n    const packageJsonPath = path.join(targetDirectory, 'package.json');\n    const packageJson = readJsonFile(packageJsonPath);\n\n    for (const dependencyBlock of [packageJson.dependencies, packageJson.devDependencies]) {\n      for (const [name, version] of Object.entries(dependencyBlock ?? {})) {\n        if (name.startsWith('quidproquo') && String(version).startsWith('file:')) {\n          dependencyBlock[name] = ownVersion;\n        }\n      }\n    }\n\n    writeJsonFile(packageJsonPath, packageJson);\n  },\n};\n"]}

package/lib/esm/steps/008_transpileToJavaScript.d.ts

@@ -0,0 +1,2 @@
+import { CreateQpqAppStep } from '../types';
+export declare const transpileToJavaScript: CreateQpqAppStep;

package/lib/esm/steps/008_transpileToJavaScript.js

@@ -0,0 +1,12 @@
+import { AppLanguage } from '../types';
+// Placeholder for the JavaScript flavour — a later pass will transpile the
+// scaffolded TypeScript sources here. For now it's an honest no-op so the
+// language answer already threads through the pipeline.
+export const transpileToJavaScript = {
+    name: 'Converting to JavaScript',
+    shouldRun: (answers) => answers.language === AppLanguage.javascript,
+    run: async () => {
+        console.log('  JavaScript output is not available yet — generating TypeScript for now.');
+    },
+};
+//# sourceMappingURL=008_transpileToJavaScript.js.map

package/lib/esm/steps/008_transpileToJavaScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"008_transpileToJavaScript.js","sourceRoot":"","sources":["../../../src/steps/008_transpileToJavaScript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,UAAU,CAAC;AAEzD,2EAA2E;AAC3E,0EAA0E;AAC1E,wDAAwD;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,IAAI,EAAE,0BAA0B;IAEhC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,WAAW,CAAC,UAAU;IAEnE,GAAG,EAAE,KAAK,IAAI,EAAE;QACd,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;IAC3F,CAAC;CACF,CAAC","sourcesContent":["import { AppLanguage, CreateQpqAppStep } from '../types';\n\n// Placeholder for the JavaScript flavour — a later pass will transpile the\n// scaffolded TypeScript sources here. For now it's an honest no-op so the\n// language answer already threads through the pipeline.\nexport const transpileToJavaScript: CreateQpqAppStep = {\n  name: 'Converting to JavaScript',\n\n  shouldRun: (answers) => answers.language === AppLanguage.javascript,\n\n  run: async () => {\n    console.log('  JavaScript output is not available yet — generating TypeScript for now.');\n  },\n};\n"]}

package/lib/esm/steps/009_restoreGitignore.d.ts

@@ -0,0 +1,2 @@
+import { CreateQpqAppStep } from '../types';
+export declare const restoreGitignore: CreateQpqAppStep;

package/lib/esm/steps/009_restoreGitignore.js

@@ -0,0 +1,16 @@
+import fs from 'fs';
+import path from 'path';
+import { listFilesRecursive } from '../lib/files';
+// npm strips .gitignore files from published tarballs, so the snapshot stores
+// them dotless (the create-react-app trick); restore the dots here.
+export const restoreGitignore = {
+    name: 'Restoring .gitignore files',
+    run: async ({ targetDirectory }) => {
+        for (const filePath of listFilesRecursive(targetDirectory)) {
+            if (path.basename(filePath) === 'gitignore') {
+                fs.renameSync(filePath, path.join(path.dirname(filePath), '.gitignore'));
+            }
+        }
+    },
+};
+//# sourceMappingURL=009_restoreGitignore.js.map

package/lib/esm/steps/009_restoreGitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"009_restoreGitignore.js","sourceRoot":"","sources":["../../../src/steps/009_restoreGitignore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,8EAA8E;AAC9E,oEAAoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD,IAAI,EAAE,4BAA4B;IAElC,GAAG,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;QACjC,KAAK,MAAM,QAAQ,IAAI,kBAAkB,CAAC,eAAe,CAAC,EAAE,CAAC;YAC3D,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,WAAW,EAAE,CAAC;gBAC5C,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\nimport { listFilesRecursive } from '../lib/files';\nimport { CreateQpqAppStep } from '../types';\n\n// npm strips .gitignore files from published tarballs, so the snapshot stores\n// them dotless (the create-react-app trick); restore the dots here.\nexport const restoreGitignore: CreateQpqAppStep = {\n  name: 'Restoring .gitignore files',\n\n  run: async ({ targetDirectory }) => {\n    for (const filePath of listFilesRecursive(targetDirectory)) {\n      if (path.basename(filePath) === 'gitignore') {\n        fs.renameSync(filePath, path.join(path.dirname(filePath), '.gitignore'));\n      }\n    }\n  },\n};\n"]}

package/lib/esm/steps/010_gitInit.d.ts

@@ -0,0 +1,2 @@
+import { CreateQpqAppStep } from '../types';
+export declare const gitInit: CreateQpqAppStep;

package/lib/esm/steps/010_gitInit.js

@@ -0,0 +1,18 @@
+import { runCommand } from '../lib/runCommand';
+// A fresh repo with one clean commit. Failure here (no git installed, odd
+// global config) shouldn't lose the scaffold — warn and carry on.
+export const gitInit = {
+    name: 'Initialising git repository',
+    shouldRun: (answers) => answers.initialiseGit,
+    run: async ({ targetDirectory }) => {
+        try {
+            await runCommand('git', ['init'], { cwd: targetDirectory });
+            await runCommand('git', ['add', '-A'], { cwd: targetDirectory });
+            await runCommand('git', ['commit', '-m', '"Initial commit from create-qpq-app"'], { cwd: targetDirectory });
+        }
+        catch (error) {
+            console.warn(`  Skipping git init: ${error.message}`);
+        }
+    },
+};
+//# sourceMappingURL=010_gitInit.js.map

package/lib/esm/steps/010_gitInit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"010_gitInit.js","sourceRoot":"","sources":["../../../src/steps/010_gitInit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,0EAA0E;AAC1E,kEAAkE;AAClE,MAAM,CAAC,MAAM,OAAO,GAAqB;IACvC,IAAI,EAAE,6BAA6B;IAEnC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa;IAE7C,GAAG,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;QACjC,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC,CAAC;YAC5D,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC,CAAC;YACjE,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,sCAAsC,CAAC,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC,CAAC;QAC9G,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,wBAAyB,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF,CAAC","sourcesContent":["import { runCommand } from '../lib/runCommand';\nimport { CreateQpqAppStep } from '../types';\n\n// A fresh repo with one clean commit. Failure here (no git installed, odd\n// global config) shouldn't lose the scaffold — warn and carry on.\nexport const gitInit: CreateQpqAppStep = {\n  name: 'Initialising git repository',\n\n  shouldRun: (answers) => answers.initialiseGit,\n\n  run: async ({ targetDirectory }) => {\n    try {\n      await runCommand('git', ['init'], { cwd: targetDirectory });\n      await runCommand('git', ['add', '-A'], { cwd: targetDirectory });\n      await runCommand('git', ['commit', '-m', '\"Initial commit from create-qpq-app\"'], { cwd: targetDirectory });\n    } catch (error) {\n      console.warn(`  Skipping git init: ${(error as Error).message}`);\n    }\n  },\n};\n"]}

package/lib/esm/steps/011_npmInstall.d.ts

@@ -0,0 +1,2 @@
+import { CreateQpqAppStep } from '../types';
+export declare const npmInstall: CreateQpqAppStep;

package/lib/esm/steps/011_npmInstall.js

@@ -0,0 +1,9 @@
+import { runCommand } from '../lib/runCommand';
+export const npmInstall = {
+    name: 'Installing dependencies',
+    shouldRun: (answers) => answers.installDependencies,
+    run: async ({ targetDirectory }) => {
+        await runCommand('npm', ['install'], { cwd: targetDirectory });
+    },
+};
+//# sourceMappingURL=011_npmInstall.js.map

package/lib/esm/steps/011_npmInstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"011_npmInstall.js","sourceRoot":"","sources":["../../../src/steps/011_npmInstall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,MAAM,CAAC,MAAM,UAAU,GAAqB;IAC1C,IAAI,EAAE,yBAAyB;IAE/B,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,mBAAmB;IAEnD,GAAG,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;QACjC,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC,CAAC;IACjE,CAAC;CACF,CAAC","sourcesContent":["import { runCommand } from '../lib/runCommand';\nimport { CreateQpqAppStep } from '../types';\n\nexport const npmInstall: CreateQpqAppStep = {\n  name: 'Installing dependencies',\n\n  shouldRun: (answers) => answers.installDependencies,\n\n  run: async ({ targetDirectory }) => {\n    await runCommand('npm', ['install'], { cwd: targetDirectory });\n  },\n};\n"]}

package/lib/esm/steps/012_buildWorkspaces.d.ts

@@ -0,0 +1,2 @@
+import { CreateQpqAppStep } from '../types';
+export declare const buildWorkspaces: CreateQpqAppStep;

package/lib/esm/steps/012_buildWorkspaces.js

@@ -0,0 +1,12 @@
+import { runCommand } from '../lib/runCommand';
+// The workspace lib packages resolve through their built dist/ (package.json
+// main), so a fresh scaffold can't `go:dev` until they're tsc'd once. Only
+// possible when dependencies were installed.
+export const buildWorkspaces = {
+    name: 'Building workspace packages',
+    shouldRun: (answers) => answers.installDependencies,
+    run: async ({ targetDirectory }) => {
+        await runCommand('npm', ['run', 'build'], { cwd: targetDirectory });
+    },
+};
+//# sourceMappingURL=012_buildWorkspaces.js.map

package/lib/esm/steps/012_buildWorkspaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"012_buildWorkspaces.js","sourceRoot":"","sources":["../../../src/steps/012_buildWorkspaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,6EAA6E;AAC7E,2EAA2E;AAC3E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C,IAAI,EAAE,6BAA6B;IAEnC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,mBAAmB;IAEnD,GAAG,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;QACjC,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC,CAAC;IACtE,CAAC;CACF,CAAC","sourcesContent":["import { runCommand } from '../lib/runCommand';\nimport { CreateQpqAppStep } from '../types';\n\n// The workspace lib packages resolve through their built dist/ (package.json\n// main), so a fresh scaffold can't `go:dev` until they're tsc'd once. Only\n// possible when dependencies were installed.\nexport const buildWorkspaces: CreateQpqAppStep = {\n  name: 'Building workspace packages',\n\n  shouldRun: (answers) => answers.installDependencies,\n\n  run: async ({ targetDirectory }) => {\n    await runCommand('npm', ['run', 'build'], { cwd: targetDirectory });\n  },\n};\n"]}

package/lib/esm/steps/013_printNextSteps.d.ts

@@ -0,0 +1,2 @@
+import { CreateQpqAppStep } from '../types';
+export declare const printNextSteps: CreateQpqAppStep;

package/lib/esm/steps/013_printNextSteps.js

@@ -0,0 +1,21 @@
+export const printNextSteps = {
+    name: 'Done',
+    run: async ({ answers }) => {
+        const install = answers.installDependencies ? '' : '  npm install\n  npm run build\n';
+        console.log(`
+Created ${answers.appName}!
+
+Your app has five services — admin, auth, design, shell and todo — and
+deploys as a single docker image.
+
+Next steps:
+
+  cd ${answers.appName}
+${install}  npm run go:dev     # local dev server on http://localhost:8080
+  npm run go         # build the docker image (then run the printed docker command)
+
+Deploy config lives in apps/${answers.appName}/deploy.config.json (domain: ${answers.domain}).
+`);
+    },
+};
+//# sourceMappingURL=013_printNextSteps.js.map

package/lib/esm/steps/013_printNextSteps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"013_printNextSteps.js","sourceRoot":"","sources":["../../../src/steps/013_printNextSteps.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,IAAI,EAAE,MAAM;IAEZ,GAAG,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACzB,MAAM,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kCAAkC,CAAC;QAEtF,OAAO,CAAC,GAAG,CAAC;UACN,OAAO,CAAC,OAAO;;;;;;;OAOlB,OAAO,CAAC,OAAO;EACpB,OAAO;;;8BAGqB,OAAO,CAAC,OAAO,gCAAgC,OAAO,CAAC,MAAM;CAC1F,CAAC,CAAC;IACD,CAAC;CACF,CAAC","sourcesContent":["import { CreateQpqAppStep } from '../types';\n\nexport const printNextSteps: CreateQpqAppStep = {\n  name: 'Done',\n\n  run: async ({ answers }) => {\n    const install = answers.installDependencies ? '' : '  npm install\\n  npm run build\\n';\n\n    console.log(`\nCreated ${answers.appName}!\n\nYour app has five services — admin, auth, design, shell and todo — and\ndeploys as a single docker image.\n\nNext steps:\n\n  cd ${answers.appName}\n${install}  npm run go:dev     # local dev server on http://localhost:8080\n  npm run go         # build the docker image (then run the printed docker command)\n\nDeploy config lives in apps/${answers.appName}/deploy.config.json (domain: ${answers.domain}).\n`);\n  },\n};\n"]}

package/lib/esm/steps/index.d.ts

@@ -0,0 +1,16 @@
+import { CreateQpqAppStep } from '../types';
+import { preflight } from './001_preflight';
+import { copyTemplate } from './002_copyTemplate';
+import { deleteDocusaurus } from './003_deleteDocusaurus';
+import { deleteQpqjsApp } from './004_deleteQpqjsApp';
+import { applyAppIdentity } from './005_applyAppIdentity';
+import { applyDomain } from './006_applyDomain';
+import { pinRegistryVersions } from './007_pinRegistryVersions';
+import { transpileToJavaScript } from './008_transpileToJavaScript';
+import { restoreGitignore } from './009_restoreGitignore';
+import { gitInit } from './010_gitInit';
+import { npmInstall } from './011_npmInstall';
+import { buildWorkspaces } from './012_buildWorkspaces';
+import { printNextSteps } from './013_printNextSteps';
+export declare const createQpqAppSteps: CreateQpqAppStep[];
+export { applyAppIdentity, applyDomain, buildWorkspaces, copyTemplate, deleteDocusaurus, deleteQpqjsApp, gitInit, npmInstall, pinRegistryVersions, preflight, printNextSteps, restoreGitignore, transpileToJavaScript, };