create-qpq-app 0.1.11 → 0.1.13

package/template/docusaurus/docs/config/features/event-doc-routes.md

@@ -35,10 +35,12 @@ All paths are prefixed with the version segment `/v{version}` (default `/v1`):
 | `GET` | `{basePath}/{id}` | Get one document's summary record. |
 | `GET` | `{basePath}/{id}/events` | List a document's event log. |
 | `GET` | `{basePath}/{id}/render` | Render the document to HTML. **Only mounted when `eventRenderer` is set.** |
+| `GET` | `{basePath}/{id}/references` | List the `EventDocLink`s this document depends on. |
 | `POST` | `{basePath}` | Create a document. |
 | `POST` | `{basePath}/{id}/events` | Append an event to a document. |
 | `POST` | `{basePath}/{id}/assets` | Request an asset upload URL. |
 | `GET` | `{basePath}/{id}/assets/{assetId}` | Download an asset. |
+| `GET` | `{basePath}/{id}/assets` | List a document's stored assets. |
 | `DELETE` | `{basePath}/{id}` | Remove a document. |
 
 ## Signature
@@ -63,7 +65,8 @@ The single `options` argument is an `EventDocRoutesOptions`:
 | `onPublish` | `string` | – | Name of a registered inline function. When set, every successful append of a Publish event invokes it with `{ docId, event, summary }`, after the event is durably written and the summary re-derived. This is the seam for syncing a folded document into a materialized read model. Errors propagate to the caller: the event has landed but the side effect did not, so the caller learns the read model may be stale. |
 | `onAppend` | `string` | – | Name of a registered inline function. When set, EVERY successful append (domain events and lifecycle events alike) invokes it with `{ docId, event, summary, events }`, after the event is durably written and the summary re-derived. This is the seam for reacting to any mutation (e.g. broadcasting the doc's fresh fold). Runs after `onPublish` when both fire on the same Publish event. Errors propagate to the caller: the event has landed but the side effect did not. |
 | `scopeResolver` | `string` | – | Name of a registered inline function. When set, every route invokes it with `{ event }` before running; a non-null result becomes the ambient storage scope for the whole request, transparently partitioning the collection's stores and assets (e.g. per-tenant). Null means unscoped. Omit for collections that never partition. |
-| `excludeRoutes` | `EventDocRouteName[]` | `[]` | Route names to leave unmounted (`'list' \| 'get' \| 'listEvents' \| 'render' \| 'create' \| 'appendEvent' \| 'createAsset' \| 'getAsset' \| 'remove'`). For a collection that must own one of these itself instead of using the stock behavior — e.g. a `create` that must also perform some side effect the stock controller doesn't know about. |
+| `referenceResolver` | `string` | – | Name of a registered inline function. When set, `GET {basePath}/{id}/references` invokes it with the document's `{ events, docId }` log, which folds and returns the `EventDocLink`s that view depends on (e.g. a template's layout/style/content links). The transfer feature's manifest walk follows those links recursively. Omit for a leaf collection (a stylesheet, a layout) — the route is still mounted but always resolves to `[]`. |
+| `excludeRoutes` | `EventDocRouteName[]` | `[]` | Route names to leave unmounted (`'list' \| 'get' \| 'listEvents' \| 'render' \| 'references' \| 'create' \| 'appendEvent' \| 'createAsset' \| 'getAsset' \| 'listAssets' \| 'remove'`). For a collection that must own one of these itself instead of using the stock behavior — e.g. a `create` that must also perform some side effect the stock controller doesn't know about. |
 
 ### `RouteAuthSettings`
 
@@ -100,5 +103,6 @@ export default [
 
 - [defineEventDocSummary](./event-doc-summary.md) — declares the store these routes serve (required before mounting routes).
 - [defineEventDoc](./event-doc.md) — declares the store *and* these routes in one call for the single-type case.
+- [defineEventDocTransfer](./event-doc-transfer.md) — mounts the export/import routes that read every registered collection's `referenceResolver` to build a transfer manifest.
 - [defineRoute](../webserver/route.md) — the underlying webserver route config (source of `RouteAuthSettings`).
 - **Custom routes over the same store:** wrap your controllers in `askEventDocProvideStore({ storeName, type }, ...)` (from quidproquo-features) so the generic [reads](../../actions/features/event-doc/ask-event-doc-get-by-id.md) resolve the collection, then compose actions like [askEventDocCreate](../../actions/features/event-doc/ask-event-doc-create.md).

package/template/docusaurus/docs/config/features/event-doc-summary.md

@@ -5,15 +5,16 @@ description: Declare the stores for an event-sourced document collection — its
 
 # defineEventDocSummary
 
-Declares the **stores** that back an event-document collection, without any routes. It returns a `QPQConfig` (an array of config settings) that expands to three underlying core stores:
+Declares the **stores** that back an event-document collection, without any routes. It returns a `QPQConfig` (an array of config settings) that expands to four underlying core stores:
 
-1. A **summary key-value store** (partition key `type`, sort key `id`) — the queryable record for each document, derived by folding the identity/lifecycle events of its log. Rows are the [`EventDocSummary`](../../actions/features/event-doc/ask-event-doc-get-by-id.md) shape and carry the version history. A secondary index on `(type, updatedAt)` supports the recently-updated ordering [askEventDocList](../../actions/features/event-doc/ask-event-doc-list.md) returns.
-2. An **append-only events store** (`<storeName>Events`, partition key `pk`, numeric sort key `sk`) — the ordered log every document is folded from. It has **no** secondary index on purpose: the local dev-server query processor can't target one, so all event reads go through the main table.
-3. A **storage drive** (`<storeName>edocs`, lower-cased) — the collection's blob bucket, holding each document's immutable uploaded assets (and later its derived runtime artifacts) under per-document prefixes.
+1. A **summary key-value store** (partition key `type`, sort key `id`) — the queryable record for each document, derived by folding the identity/lifecycle events of its log. Rows are the [`EventDocSummary`](../../actions/features/event-doc/ask-event-doc-get-by-id.md) shape and carry the version history. A secondary index on `(type, updatedAt)` supports the recently-updated ordering [askEventDocList](../../actions/features/event-doc/ask-event-doc-list.md) returns. It is a pure projection: nothing on the append path writes it directly. The events store below declares an [`onStream`](../core/key-value-store.md#change-data-capture-onstream) handler that rebuilds a document's summary row from its log whenever an event is appended, so the summary is eventually (not immediately) consistent with the log.
+2. An **append-only events store** (`<storeName>EventLog`, partition key `pk`, string sort key `sk`) — the live ordered log every document is folded from, keyed on a sortable event id (UUIDv7). It has **no** secondary index on purpose: the local dev-server query processor can't target one, so all event reads go through the main table.
+3. A **legacy events store** (`<storeName>Events`, partition key `pk`, numeric sort key `sk`) — the pre-sortable-id log, kept declared but unread/unwritten at runtime so its data stays reachable until it is migrated into the events store above.
+4. A **storage drive** (`<storeName>edocs`, lower-cased) — the collection's blob bucket, holding each document's immutable uploaded assets (and later its derived runtime artifacts) under per-document prefixes.
 
-Point-in-time recovery is enabled on both tables.
+Point-in-time recovery is enabled on all three tables.
 
-- **On AWS:** deploys two DynamoDB tables (via [defineKeyValueStore](../core/key-value-store.md)) and one S3 bucket (via [defineStorageDrive](../core/storage-drive.md)). All physical names are derived from `keyValueStoreName`, so a collection needs only that one name.
+- **On AWS:** deploys three DynamoDB tables (via [defineKeyValueStore](../core/key-value-store.md)) and one S3 bucket (via [defineStorageDrive](../core/storage-drive.md)). All physical names are derived from `keyValueStoreName`, so a collection needs only that one name.
 
 ```typescript
 import { defineEventDocSummary } from 'quidproquo-features';

package/template/docusaurus/docs/config/features/event-doc-transfer.md

@@ -0,0 +1,81 @@
+---
+title: defineEventDocTransfer
+description: Mount export/import routes that move event-doc collections between environments as portable bundles.
+---
+
+# defineEventDocTransfer
+
+Mounts the export/import **routes** for a service's event-doc collections: a staging storage drive plus five routes that build, stage, plan, and apply portable bundles of one or more documents (and everything they reference). It returns a `QPQConfig` (an array of config settings) that you spread into a service's infrastructure default export, alongside its `defineEventDoc` calls.
+
+An export walks a doc's `referenceResolver` (see [defineEventDocRoutes](./event-doc-routes.md#parameters)) to pull in every doc it depends on — a template's layout, styles, and content — so a bundle is self-contained. An import replays that bundle's event log against the target's own collections, either as a fresh doc or appended onto one that already exists there, and reports what it would do (or did) per document.
+
+The route controllers ship inside `quidproquo-features` and read the collection registry from per-route globals, so a service needs no controller wiring of its own.
+
+- **On AWS:** deploys a storage drive for staged bundle files and the routes below, each backed by a Lambda running the corresponding built-in controller. It creates no data infrastructure for the collections themselves — those come from each collection's own `defineEventDoc`/`defineEventDocSummary`.
+
+```typescript
+import { defineEventDoc, defineEventDocTransfer } from 'quidproquo-features';
+
+const collections = [
+  { storeName: 'templates', type: 'template', referenceResolver: 'collectTemplateReferences' },
+  { storeName: 'content', type: 'article' },
+];
+
+export default [
+  ...defineEventDoc({ storeName: 'templates', type: 'template', basePath: '/templates', referenceResolver: 'collectTemplateReferences' }),
+  ...defineEventDoc({ storeName: 'content', type: 'article', basePath: '/articles' }),
+
+  ...defineEventDocTransfer({
+    service: 'cms',
+    collections,
+    routeAuthSettings: { userDirectoryName: 'editors' },
+  }),
+];
+```
+
+## Routes mounted
+
+All paths are prefixed with the version segment `/v{version}` (default `/v1`):
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `POST` | `/transfer/manifest` | Every doc that would travel with a given `{ docs: [{ service, type, id }, ...] }` selection, merged and deduped across all of them (follows `referenceResolver` links), without building anything. Feeds an export UI's "these will be included" preview. |
+| `POST` | `/transfer/export` | Stage one bundle for `{ docs: [...] }` and return its download url. |
+| `POST` | `/transfer/upload` | A presigned PUT url for uploading a bundle file, plus the id used to plan/import it. |
+| `POST` | `/transfer/plan` | What importing an uploaded bundle (`{ transferId }`) would do to each of its docs (`new`, `fastForward`, `same`, or a blocking `diverged`/`codeConflict`) without writing anything. |
+| `POST` | `/transfer/import` | Apply an uploaded bundle (`{ transferId, force? }`) and report what happened per doc. `force` opts into overwriting docs the target has edited directly (the divergent tail is backed up to the transfer drive and discarded); off unless the caller asks for it explicitly. |
+
+## Signature
+
+```typescript
+function defineEventDocTransfer(options: EventDocTransferOptions): QPQConfig;
+```
+
+## Parameters
+
+The single `options` argument is an `EventDocTransferOptions`:
+
+| Property | Type | Default | Description |
+| --- | --- | --- | --- |
+| `service` | `string` | – (required) | The service name `EventDocLink`s use to address this service's collections (`link.eventDocService`). Transfers never leave it: the stores live here, so a reference into another service throws rather than being silently dropped from a manifest. |
+| `collections` | `EventDocTransferCollection[]` | – (required) | The collections a transfer may read and write. Feed this the same array the service maps over for its `defineEventDoc` calls, so the two cannot drift; the extra fields on a routes-options object (`basePath`, auth, `version`) are simply unused here. |
+| `scopeResolver` | `string` | – | Name of a registered inline function. Establishes the ambient storage scope for the whole request, exactly like a collection's own `scopeResolver`. Needed separately because a transfer spans collections, so there is no single store to read the resolver name from. Omit only if none of the collections partition. |
+| `routeAuthSettings` | `RouteAuthSettings` | – | Auth settings applied to every mounted route (from quidproquo-webserver — see [route](../webserver/route.md)). Import writes unvalidated history and export reads across every registered collection, so gate these harder than the collections' own routes. |
+| `version` | `number` | `1` | Version number for the `/v{version}` path prefix on every route. |
+
+### `EventDocTransferCollection`
+
+A subset of a collection's own `EventDocRoutesOptions`, so a service can declare its collections once and feed the same array to both `defineEventDoc` and `defineEventDocTransfer`:
+
+| Property | Type | Description |
+| --- | --- | --- |
+| `storeName` | `string` | Must match the collection's own `storeName`. |
+| `type` | `string` | Must match the collection's own `type`. |
+| `onPublish` | `string` | Carried so an imported publish behaves exactly as it does on the collection's own routes. |
+| `onAppend` | `string` | Carried so an imported append fires the same reaction as it does on the collection's own routes. |
+| `referenceResolver` | `string` | Carried so the manifest walk can follow this collection's links. `eventValidator` is deliberately **not** carried — replayed history was already validated at its origin, so imports skip it. |
+
+## Related
+
+- [defineEventDoc](./event-doc.md) / [defineEventDocRoutes](./event-doc-routes.md) — declare the collections a transfer reads and writes, including the `referenceResolver` the manifest walk follows.
+- [defineTenantedEventDocTransfer](./tenanted-event-doc-transfer.md) — the same routes with the tenant scope resolver pre-wired, so export/import never cross tenant partitions.

package/template/docusaurus/docs/config/features/event-doc.md

@@ -50,6 +50,7 @@ function defineEventDoc(options: EventDocRoutesOptions): QPQConfig;
 | `onPublish` | `string` | no | Inline-function name invoked with `{ docId, event, summary }` after every successful Publish append: the seam for syncing the folded document into a materialized read model. |
 | `onAppend` | `string` | no | Inline-function name invoked with `{ docId, event, summary, events }` after EVERY successful append (domain events and lifecycle events alike): the seam for reacting to any mutation. Runs after `onPublish` when both fire on the same Publish event. |
 | `scopeResolver` | `string` | no | Inline-function name every route invokes with `{ event }` to resolve the request's ambient storage scope (e.g. per-tenant); null means unscoped. |
+| `referenceResolver` | `string` | no | Inline-function name `GET {basePath}/{id}/references` invokes with the document's `{ events, docId }` log to return the `EventDocLink`s that view depends on. Omit for a leaf collection — the route still resolves, just always to `[]`. |
 
 ## Examples
 

package/template/docusaurus/docs/config/features/tenanted-event-doc-transfer.md

@@ -0,0 +1,59 @@
+---
+title: defineTenantedEventDocTransfer
+description: A defineEventDocTransfer with the tenant scope resolver pre-wired, so export/import never cross tenant partitions.
+---
+
+# defineTenantedEventDocTransfer
+
+A [defineEventDocTransfer](./event-doc-transfer.md) with the tenant scope resolver pre-wired as its `scopeResolver`, so an export reads and an import writes inside the caller's own tenant partition, never unscoped and never across tenants. It takes the same arguments as `defineEventDocTransfer` minus `scopeResolver`, which it fills in for you.
+
+The pairing matters: transferring collections declared with [defineTenantedEventDoc](./tenanted-event-doc.md) through an unscoped transfer would read an empty collection and write into the wrong partition. The deploying service must still register the resolver implementation by calling [defineTenant](./tenant.md) (with the same `owner` used everywhere else). Use plain [defineEventDocTransfer](./event-doc-transfer.md) for services whose collections never partition by tenant.
+
+```typescript
+import { defineTenant, defineTenantedEventDoc, defineTenantedEventDocTransfer } from 'quidproquo-features';
+
+const collections = [{ storeName: 'content', type: 'article' }];
+
+export default [
+  ...defineTenant({
+    owner: { module: 'cms' },
+    basePath: '/tenants',
+    routeAuthSettings: { userDirectoryName: 'users' },
+  }),
+
+  ...defineTenantedEventDoc({
+    storeName: 'content',
+    type: 'article',
+    basePath: '/articles',
+    routeAuthSettings: { userDirectoryName: 'users' },
+  }),
+
+  ...defineTenantedEventDocTransfer({
+    service: 'cms',
+    collections,
+    routeAuthSettings: { userDirectoryName: 'users' },
+  }),
+];
+```
+
+## Signature
+
+```typescript
+function defineTenantedEventDocTransfer(options: TenantedEventDocTransferOptions): QPQConfig;
+```
+
+`TenantedEventDocTransferOptions` is `EventDocTransferOptions` with `scopeResolver` omitted — see [defineEventDocTransfer](./event-doc-transfer.md#parameters) for the remaining options.
+
+## Parameters
+
+Same as [defineEventDocTransfer](./event-doc-transfer.md#parameters): `service`, `collections`, `routeAuthSettings`, `version` (without `scopeResolver`, which this always sets to `TENANT_SCOPE_RESOLVER_FN`).
+
+## Returns
+
+Same as [defineEventDocTransfer](./event-doc-transfer.md) — a `QPQConfig` array with the transfer's `scopeResolver` already pointed at the tenant scope resolver.
+
+## Related
+
+- [defineEventDocTransfer](./event-doc-transfer.md) — the underlying define this pre-configures.
+- [defineTenant](./tenant.md) — registers `TENANT_SCOPE_RESOLVER_FN`, the inline function this wires in by name.
+- [defineTenantedEventDoc](./tenanted-event-doc.md) — the same pattern applied to a collection's own routes; pair the two so a transfer's partitioning matches its collections'.

package/template/docusaurus/docs/config/features/tenanted-event-doc.md

@@ -49,3 +49,4 @@ Same as [defineEventDoc](./event-doc.md) — a `QPQConfig` array with the collec
 - [defineEventDoc](./event-doc.md) — the underlying define this pre-configures.
 - [defineTenant](./tenant.md) — registers `TENANT_SCOPE_RESOLVER_FN`, the inline function this wires in by name.
 - [defineTenantedWebSocketQueue](./tenanted-web-socket-queue.md) — the same pattern applied to a WebSocket queue's `connectionScopeResolver`.
+- [defineTenantedEventDocTransfer](./tenanted-event-doc-transfer.md) — the same pattern applied to a collection's export/import routes.

package/template/docusaurus/docs/config/webserver/migration.md

@@ -32,6 +32,10 @@ The generated deploy event fires on each qualifying stack status change:
 - **On the first (Create) deploy** every migration is recorded as *already run* without executing it — a freshly created service is expected to start from clean [seed](./seed.md) data, so there is nothing to migrate.
 - **On later (Update) deploys** each migration whose `deployType` matches the stack that changed and that has **not** already been recorded is enqueued on the `qpqMigrations` queue (which runs its story) and then recorded as run. Migrations already recorded are skipped, so re-deploying is safe.
 
+## Testing locally
+
+Nothing local ever deploys, so a migration never runs on its own while you develop against `go:dev`. Run `qpq migrate` to execute every pending migration against the local dev store, once, through the same queue the deployed path uses. It records what it ran in the same tracking store, so a second call is a no-op until you add a new migration.
+
 ## Signature
 
 ```typescript

package/template/package.json

@@ -109,6 +109,7 @@
   "overrides": {
     "js-yaml": "4.3.0",
     "uuid": "^11.1.1",
+    "adm-zip": "^0.6.0",
     "@chakra-ui/cli": {
       "esbuild": "^0.28.1"
     }

package/lib/commonjs/lib/args.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPositionalArgs = exports.getArgValue = void 0;
-// Flag parsing over the command's argv (everything after the command name).
-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;
-};
-exports.getArgValue = getArgValue;
-// Positional args = non-flag args, skipping values consumed by known flags.
-const getPositionalArgs = (argv, valueFlags) => argv.filter((arg, index) => {
-    if (arg.startsWith('--'))
-        return false;
-    const previous = argv[index - 1];
-    return !(previous && valueFlags.includes(previous));
-});
-exports.getPositionalArgs = getPositionalArgs;
-//# sourceMappingURL=args.js.map

package/lib/commonjs/lib/args.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/lib/args.ts"],"names":[],"mappings":";;;AAAA,4EAA4E;AACrE,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;AALW,QAAA,WAAW,eAKtB;AAEF,4EAA4E;AACrE,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;AALQ,QAAA,iBAAiB,qBAKzB","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/commonjs/lib/files.d.ts

@@ -1,5 +0,0 @@
-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/commonjs/lib/files.js

@@ -1,65 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.writeJsonFile = exports.readJsonFile = exports.replaceInFileExact = exports.replaceInFiles = exports.listFilesRecursive = void 0;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("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).
-const listFilesRecursive = (root) => {
-    const files = [];
-    const walk = (dir) => {
-        for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
-            const fullPath = path_1.default.join(dir, entry.name);
-            if (entry.isDirectory()) {
-                walk(fullPath);
-            }
-            else {
-                files.push(fullPath);
-            }
-        }
-    };
-    walk(root);
-    return files;
-};
-exports.listFilesRecursive = listFilesRecursive;
-// 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.
-const replaceInFiles = (root, replacements) => {
-    for (const filePath of (0, exports.listFilesRecursive)(root)) {
-        if (!TEXT_FILE_EXTENSIONS.has(path_1.default.extname(filePath))) {
-            continue;
-        }
-        const original = fs_1.default.readFileSync(filePath, 'utf8');
-        let updated = original;
-        for (const [from, to] of replacements) {
-            updated = updated.split(from).join(to);
-        }
-        if (updated !== original) {
-            fs_1.default.writeFileSync(filePath, updated);
-        }
-    }
-};
-exports.replaceInFiles = replaceInFiles;
-// Replace an exact string in one file, throwing if it isn't there — targeted
-// edits should fail loudly when the template drifts.
-const replaceInFileExact = (filePath, from, to) => {
-    const original = fs_1.default.readFileSync(filePath, 'utf8');
-    if (!original.includes(from)) {
-        throw new Error(`Expected to find "${from}" in ${filePath} — has the template changed?`);
-    }
-    fs_1.default.writeFileSync(filePath, original.split(from).join(to));
-};
-exports.replaceInFileExact = replaceInFileExact;
-const readJsonFile = (filePath) => JSON.parse(fs_1.default.readFileSync(filePath, 'utf8'));
-exports.readJsonFile = readJsonFile;
-const writeJsonFile = (filePath, value) => {
-    fs_1.default.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`);
-};
-exports.writeJsonFile = writeJsonFile;
-//# sourceMappingURL=files.js.map

package/lib/commonjs/lib/files.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"packageRoot.js","sourceRoot":"","sources":["../../../src/lib/packageRoot.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AAExB,4EAA4E;AACrE,MAAM,iBAAiB,GAAG,GAAW,EAAE;IAC5C,IAAI,GAAG,GAAG,SAAS,CAAC;IACpB,OAAO,CAAC,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,cAAI,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;AARW,QAAA,iBAAiB,qBAQ5B;AAEK,MAAM,aAAa,GAAG,GAAW,EAAE;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,cAAI,CAAC,IAAI,CAAC,IAAA,yBAAiB,GAAE,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACxG,OAAO,WAAW,CAAC,OAAO,CAAC;AAC7B,CAAC,CAAC;AAHW,QAAA,aAAa,iBAGxB","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/commonjs/lib/prompts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/lib/prompts.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qEAAqE;AACrE,+EAA+E;AACxE,MAAM,YAAY,GAAG,CAAO,OAAe,EAAE,OAAiB,EAAE,aAAsB,EAAmB,EAAE;IAChH,MAAM,EAAE,MAAM,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;IACrD,OAAO,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;AAC9D,CAAC,CAAA,CAAC;AAHW,QAAA,YAAY,gBAGvB","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/commonjs/types.d.ts

@@ -1,22 +0,0 @@
-export declare enum AppLanguage {
-    typescript = "typescript",
-    javascript = "javascript"
-}
-export interface CreateQpqAppAnswers {
-    appName: string;
-    language: AppLanguage;
-    domain: string;
-    initialiseGit: boolean;
-    installDependencies: boolean;
-}
-export interface StepContext {
-    targetDirectory: string;
-    templateDirectory: string;
-    ownVersion: string;
-    answers: CreateQpqAppAnswers;
-}
-export interface CreateQpqAppStep {
-    name: string;
-    shouldRun?: (answers: CreateQpqAppAnswers) => boolean;
-    run: (context: StepContext) => Promise<void>;
-}

package/lib/commonjs/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";;;AAAA,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,wCAAyB,CAAA;AAC3B,CAAC,EAHW,WAAW,2BAAX,WAAW,QAGtB","sourcesContent":["export enum AppLanguage {\n  typescript = 'typescript',\n  javascript = 'javascript',\n}\n\n// Everything the pipeline needs to know, collected ONCE (flags first, prompts\n// for whatever is still missing) before any step runs — steps never prompt.\nexport interface CreateQpqAppAnswers {\n  appName: string;\n  language: AppLanguage;\n  domain: string;\n  initialiseGit: boolean;\n  installDependencies: boolean;\n}\n\nexport interface StepContext {\n  // Absolute path of the directory being scaffolded (<cwd>/<appName>).\n  targetDirectory: string;\n  // Absolute path of the bundled template snapshot (a pruned quidproquojs.com).\n  templateDirectory: string;\n  // create-qpq-app's own version — the generated app pins its quidproquo-*\n  // dependencies to this (the packages are published in lockstep).\n  ownVersion: string;\n  answers: CreateQpqAppAnswers;\n}\n\n// A self-contained scaffolding step. The pipeline always runs the same list\n// top to bottom; each step owns its applicability via shouldRun.\nexport interface CreateQpqAppStep {\n  name: string;\n  shouldRun?: (answers: CreateQpqAppAnswers) => boolean;\n  run: (context: StepContext) => Promise<void>;\n}\n"]}

package/lib/esm/lib/args.js

@@ -1,16 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"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

@@ -1,5 +0,0 @@
-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

@@ -1,54 +0,0 @@
-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

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

@@ -1 +0,0 @@
-{"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.js.map

@@ -1 +0,0 @@
-{"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/types.d.ts

@@ -1,22 +0,0 @@
-export declare enum AppLanguage {
-    typescript = "typescript",
-    javascript = "javascript"
-}
-export interface CreateQpqAppAnswers {
-    appName: string;
-    language: AppLanguage;
-    domain: string;
-    initialiseGit: boolean;
-    installDependencies: boolean;
-}
-export interface StepContext {
-    targetDirectory: string;
-    templateDirectory: string;
-    ownVersion: string;
-    answers: CreateQpqAppAnswers;
-}
-export interface CreateQpqAppStep {
-    name: string;
-    shouldRun?: (answers: CreateQpqAppAnswers) => boolean;
-    run: (context: StepContext) => Promise<void>;
-}

package/lib/esm/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,wCAAyB,CAAA;AAC3B,CAAC,EAHW,WAAW,KAAX,WAAW,QAGtB","sourcesContent":["export enum AppLanguage {\n  typescript = 'typescript',\n  javascript = 'javascript',\n}\n\n// Everything the pipeline needs to know, collected ONCE (flags first, prompts\n// for whatever is still missing) before any step runs — steps never prompt.\nexport interface CreateQpqAppAnswers {\n  appName: string;\n  language: AppLanguage;\n  domain: string;\n  initialiseGit: boolean;\n  installDependencies: boolean;\n}\n\nexport interface StepContext {\n  // Absolute path of the directory being scaffolded (<cwd>/<appName>).\n  targetDirectory: string;\n  // Absolute path of the bundled template snapshot (a pruned quidproquojs.com).\n  templateDirectory: string;\n  // create-qpq-app's own version — the generated app pins its quidproquo-*\n  // dependencies to this (the packages are published in lockstep).\n  ownVersion: string;\n  answers: CreateQpqAppAnswers;\n}\n\n// A self-contained scaffolding step. The pipeline always runs the same list\n// top to bottom; each step owns its applicability via shouldRun.\nexport interface CreateQpqAppStep {\n  name: string;\n  shouldRun?: (answers: CreateQpqAppAnswers) => boolean;\n  run: (context: StepContext) => Promise<void>;\n}\n"]}