ddd-ts-kit 0.0.0-stage → 0.1.0

package/dist/init/stack/resolve-persistence.js

@@ -0,0 +1,26 @@
+import { DATABASE_STACKS, ORM_STACKS } from '../../config/index.js';
+import { CliError } from '../../cli-error.js';
+import { WITH_DATABASE } from '../../stack/with-database.js';
+import { choose } from './choose.js';
+const EVENT_CHOICES = ['in-memory', 'outbox'];
+/** The generated persistence is written for PostgreSQL, the dialect every adapter package tests. `custom` and `none` bring their own storage, or none. */
+export function resolvePersistence(options) {
+    const requested = choose(DATABASE_STACKS, options.database, 'database');
+    const orm = choose(ORM_STACKS, options.orm, 'orm') ?? (requested === 'none' ? 'none' : 'drizzle');
+    const needsPostgres = WITH_DATABASE.includes(orm);
+    const database = requested ?? (needsPostgres ? 'postgres' : 'none');
+    if (needsPostgres && database !== 'postgres') {
+        throw new CliError(`--orm ${orm} cannot be combined with --database ${database}.`, `With ${orm}, use --database postgres: the generated adapters are written for it. Pick --orm custom to bring your own for another database.`);
+    }
+    const events = choose(EVENT_CHOICES, options.events, 'events') ?? (orm === 'none' ? 'in-memory' : 'outbox');
+    assertOutboxWithDatabase({ orm, events }, options.allowNoOutbox);
+    return { orm, database, events };
+}
+/** docs/ARCHITECTURE.md, `events/outbox-required`: leaving the outbox out with a database is a recorded deviation, never a default. */
+function assertOutboxWithDatabase(stack, reason) {
+    if (stack.orm === 'none' || stack.events === 'outbox' || (reason !== undefined && reason.trim() !== '')) {
+        return;
+    }
+    throw new CliError(`--events ${stack.events} cannot be combined with --orm ${stack.orm}.`, 'With a database, integration events leave through the transactional outbox, or a state change and its event can part ways. Drop --events, or record the decision with --allow-no-outbox "<reason>": it writes a deviation entry and an ADR stub.');
+}
+//# sourceMappingURL=resolve-persistence.js.map

package/dist/init/stack/resolve-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-persistence.js","sourceRoot":"","sources":["../../../src/init/stack/resolve-persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,MAAM,aAAa,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAU,CAAC;AAQvD,0JAA0J;AAC1J,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAClG,MAAM,aAAa,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,SAAS,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAEpE,IAAI,aAAa,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC7C,MAAM,IAAI,QAAQ,CAChB,SAAS,GAAG,uCAAuC,QAAQ,GAAG,EAC9D,QAAQ,GAAG,iIAAiI,CAC7I,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE5G,wBAAwB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAEjE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC;AAED,uIAAuI;AACvI,SAAS,wBAAwB,CAAC,KAAsC,EAAE,MAA0B;IAClG,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACxG,OAAO;IACT,CAAC;IAED,MAAM,IAAI,QAAQ,CAChB,YAAY,KAAK,CAAC,MAAM,kCAAkC,KAAK,CAAC,GAAG,GAAG,EACtE,kPAAkP,CACnP,CAAC;AACJ,CAAC"}

package/dist/init/stack/resolve-stack.d.ts

@@ -0,0 +1,6 @@
+import { type Config } from '../../config/index.js';
+import type { StackOptions } from './stack-options.js';
+export type { StackOptions } from './stack-options.js';
+/** The stack of the project: the one its config records when it is already initialised, else the one the flags ask for. */
+export declare function resolveStack(root: string, options: StackOptions): Config;
+//# sourceMappingURL=resolve-stack.d.ts.map

package/dist/init/stack/resolve-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-stack.d.ts","sourceRoot":"","sources":["../../../src/init/stack/resolve-stack.ts"],"names":[],"mappings":"AAEA,OAAO,EAkBL,KAAK,MAAM,EACZ,MAAM,uBAAuB,CAAC;AAM/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,2HAA2H;AAC3H,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CA8BxE"}

package/dist/init/stack/resolve-stack.js

@@ -0,0 +1,88 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { AUDIT_MODES, AUTHN_STACKS, AUTHZ_STACKS, BROKER_STACKS, CACHE_STACKS, CI_PLATFORMS, CONFIG_FILE, DEFAULT_IMPORT_ALIAS, DI_STACKS, DOCS_UIS, ERROR_REPORTERS, HTTP_STACKS, LOGGERS, parseConfig, readConfig, TEST_STACKS, VALIDATION_STACKS, } from '../../config/index.js';
+import { aliasProblem } from '../../alias/index.js';
+import { CliError } from '../../cli-error.js';
+import { choose } from './choose.js';
+import { resolvePersistence } from './resolve-persistence.js';
+import { resolveStyle } from './resolve-style.js';
+/** The stack of the project: the one its config records when it is already initialised, else the one the flags ask for. */
+export function resolveStack(root, options) {
+    if (fs.existsSync(path.join(root, CONFIG_FILE)) && !options.force) {
+        return supportedAlias(readConfig(root).config);
+    }
+    const http = choose(HTTP_STACKS, options.http, 'http') ?? 'express';
+    const di = choose(DI_STACKS, options.di, 'di') ?? (http === 'nest' ? 'nest' : 'tsyringe');
+    assertNestGoesWithNest(http, di);
+    const docsUi = http === 'none' ? 'none' : (choose(DOCS_UIS, options.docsUi, 'docs-ui') ?? 'swagger');
+    const persistence = resolvePersistence(options);
+    const broker = resolveBroker(options, persistence.orm);
+    const stack = {
+        http,
+        di,
+        ...resolveTooling(options),
+        ...persistence,
+        docsUi,
+        ...resolveSecurity(options),
+        broker,
+        ...resolveOperations(options, persistence.orm),
+        ...resolveStyle(options, di),
+    };
+    const alias = options.importAlias === undefined ? {} : { importAlias: options.importAlias };
+    const config = supportedAlias(parseConfig({ ...alias, stack, contexts: {}, rules: {} }));
+    return { ...config, worker: hasWorker(root, config) };
+}
+/** Every file `init` writes imports by the alias: one that some tool cannot resolve is refused before anything is written. */
+function supportedAlias(config) {
+    const problem = aliasProblem(config.importAlias);
+    if (problem === undefined) {
+        return config;
+    }
+    throw new CliError(`The import alias "${config.importAlias}" is not supported: ${problem}.`, `Use "${DEFAULT_IMPORT_ALIAS}" or "$<name>/" (--import-alias, or "importAlias" in ${CONFIG_FILE}).`);
+}
+/** `--force` writes the project anew: a worker that is already there keeps the jobs, so the API still starts with its jobs off. */
+function hasWorker(root, config) {
+    return fs.existsSync(path.join(root, config.sourceRoot, 'apps/worker/main.ts'));
+}
+/**
+ * The cache stays in the process unless asked otherwise; the audit trail is on as soon as there
+ * is a database to keep it in; unexpected failures are reported nowhere unless asked; the logger
+ * writes JSON lines on the standard output unless pino or winston is asked for. Error
+ * reporting hangs on the buses, the HTTP boundary, the jobs and the process, which every stack
+ * has: no other choice refuses it.
+ */
+function resolveOperations(options, orm) {
+    return {
+        cache: choose(CACHE_STACKS, options.cache, 'cache') ?? 'none',
+        audit: choose(AUDIT_MODES, options.audit, 'audit') ?? (orm === 'none' ? 'off' : 'on'),
+        errors: choose(ERROR_REPORTERS, options.errors, 'errors') ?? 'none',
+        logger: choose(LOGGERS, options.logger, 'logger') ?? 'stdout',
+    };
+}
+function resolveSecurity(options) {
+    return {
+        authn: choose(AUTHN_STACKS, options.authn, 'authn') ?? 'jwt',
+        authz: choose(AUTHZ_STACKS, options.authz, 'authz') ?? 'rbac',
+    };
+}
+function resolveBroker(options, orm) {
+    const broker = choose(BROKER_STACKS, options.broker, 'broker') ?? 'none';
+    if (broker === 'none' || orm !== 'none') {
+        return broker;
+    }
+    throw new CliError(`--broker ${broker} cannot be combined with --orm none.`, 'A broker is reached through the transactional outbox, which needs a database: pick an ORM, or keep --broker none.');
+}
+function resolveTooling(options) {
+    return {
+        validation: choose(VALIDATION_STACKS, options.validation, 'validation') ?? 'zod',
+        tests: choose(TEST_STACKS, options.tests, 'tests') ?? 'vitest',
+        ci: choose(CI_PLATFORMS, options.ci, 'ci') ?? 'github',
+    };
+}
+function assertNestGoesWithNest(http, di) {
+    if ((http === 'nest') === (di === 'nest')) {
+        return;
+    }
+    throw new CliError(`--http ${http} cannot be combined with --di ${di}.`, 'NestJS hosts the application as a whole: use --http nest together with --di nest, or pick express or fastify with tsyringe or manual.');
+}
+//# sourceMappingURL=resolve-stack.js.map

package/dist/init/stack/resolve-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-stack.js","sourceRoot":"","sources":["../../../src/init/stack/resolve-stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACX,UAAU,EACV,WAAW,EACX,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKlD,2HAA2H;AAC3H,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAAqB;IAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAClE,OAAO,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,SAAS,CAAC;IACpE,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAE1F,sBAAsB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAEjC,MAAM,MAAM,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,SAAS,CAAC,CAAC;IACrG,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IAEvD,MAAM,KAAK,GAAG;QACZ,IAAI;QACJ,EAAE;QACF,GAAG,cAAc,CAAC,OAAO,CAAC;QAC1B,GAAG,WAAW;QACd,MAAM;QACN,GAAG,eAAe,CAAC,OAAO,CAAC;QAC3B,MAAM;QACN,GAAG,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC;QAC9C,GAAG,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;KAC7B,CAAC;IAEF,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;IAC5F,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAEzF,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,8HAA8H;AAC9H,SAAS,cAAc,CAAC,MAAc;IACpC,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEjD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,QAAQ,CAChB,qBAAqB,MAAM,CAAC,WAAW,uBAAuB,OAAO,GAAG,EACxE,QAAQ,oBAAoB,wDAAwD,WAAW,IAAI,CACpG,CAAC;AACJ,CAAC;AAED,mIAAmI;AACnI,SAAS,SAAS,CAAC,IAAY,EAAE,MAAc;IAC7C,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CACxB,OAAqB,EACrB,GAAW;IAEX,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM;QAC7D,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACrF,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM;QACnE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,QAAQ;KAC9D,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAAqB;IAC5C,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,KAAK;QAC5D,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM;KAC9D,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAAqB,EAAE,GAAW;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC;IAEzE,IAAI,MAAM,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACxC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,QAAQ,CAChB,YAAY,MAAM,sCAAsC,EACxD,mHAAmH,CACpH,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,OAAqB;IAC3C,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,KAAK;QAChF,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,QAAQ;QAC9D,EAAE,EAAE,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,QAAQ;KACvD,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY,EAAE,EAAU;IACtD,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC;QAC1C,OAAO;IACT,CAAC;IAED,MAAM,IAAI,QAAQ,CAChB,UAAU,IAAI,iCAAiC,EAAE,GAAG,EACpD,uIAAuI,CACxI,CAAC;AACJ,CAAC"}

package/dist/init/stack/resolve-style.d.ts

@@ -0,0 +1,12 @@
+import type { StackOptions } from './stack-options.js';
+/**
+ * A class declares what it is wherever something reads the declarations: `@ddd-ts-kit/di`, on
+ * tsyringe. Hand wiring and a NestJS container read none of them, so their contexts keep a
+ * module file. A declared context is assembled from its barrel or by discovery, with or
+ * without a broker: its subscriber is the one of its name either way.
+ */
+export declare function resolveStyle(options: StackOptions, di: string): {
+    style: string;
+    assembly: string;
+};
+//# sourceMappingURL=resolve-style.d.ts.map

package/dist/init/stack/resolve-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-style.d.ts","sourceRoot":"","sources":["../../../src/init/stack/resolve-style.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAoBnG"}

package/dist/init/stack/resolve-style.js

@@ -0,0 +1,21 @@
+import { ASSEMBLIES, STYLES } from '../../config/index.js';
+import { CliError } from '../../cli-error.js';
+import { choose } from './choose.js';
+/**
+ * A class declares what it is wherever something reads the declarations: `@ddd-ts-kit/di`, on
+ * tsyringe. Hand wiring and a NestJS container read none of them, so their contexts keep a
+ * module file. A declared context is assembled from its barrel or by discovery, with or
+ * without a broker: its subscriber is the one of its name either way.
+ */
+export function resolveStyle(options, di) {
+    const style = choose(STYLES, options.style, 'style') ?? (di === 'tsyringe' ? 'declared' : 'explicit');
+    if (style === 'declared' && di !== 'tsyringe') {
+        throw new CliError(`--style declared cannot be combined with --di ${di}.`, 'The declarations of @ddd-ts-kit/kernel/declarations are turned into bindings by @ddd-ts-kit/di (contextModule, discoverContext), which runs on tsyringe: use --di tsyringe, or keep --style explicit, where every binding is written in <context>.module.ts.');
+    }
+    const assembly = choose(ASSEMBLIES, options.assembly, 'assembly');
+    if (assembly !== undefined && style !== 'declared') {
+        throw new CliError(`--assembly ${assembly} cannot be combined with --style explicit.`, 'An explicit context is assembled by its module file: drop --assembly, or use --style declared.');
+    }
+    return { style, assembly: assembly ?? 'barrel' };
+}
+//# sourceMappingURL=resolve-style.js.map

package/dist/init/stack/resolve-style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-style.js","sourceRoot":"","sources":["../../../src/init/stack/resolve-style.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAqB,EAAE,EAAU;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAEtG,IAAI,KAAK,KAAK,UAAU,IAAI,EAAE,KAAK,UAAU,EAAE,CAAC;QAC9C,MAAM,IAAI,QAAQ,CAChB,iDAAiD,EAAE,GAAG,EACtD,8PAA8P,CAC/P,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAElE,IAAI,QAAQ,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACnD,MAAM,IAAI,QAAQ,CAChB,cAAc,QAAQ,4CAA4C,EAClE,gGAAgG,CACjG,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,IAAI,QAAQ,EAAE,CAAC;AACnD,CAAC"}

package/dist/init/stack/stack-options.d.ts

@@ -0,0 +1,27 @@
+/** The stack flags of `init`, as they were typed. */
+export interface StackOptions {
+    readonly http?: string;
+    readonly validation?: string;
+    readonly di?: string;
+    readonly tests?: string;
+    readonly orm?: string;
+    readonly database?: string;
+    readonly events?: string;
+    readonly docsUi?: string;
+    readonly ci?: string;
+    readonly authn?: string;
+    readonly authz?: string;
+    readonly broker?: string;
+    readonly cache?: string;
+    readonly audit?: string;
+    readonly errors?: string;
+    readonly logger?: string;
+    readonly style?: string;
+    readonly assembly?: string;
+    /** The prefix of the source root in imports, when it is not the default. */
+    readonly importAlias?: string;
+    /** The reason given for running an ORM without the transactional outbox. */
+    readonly allowNoOutbox?: string;
+    readonly force: boolean;
+}
+//# sourceMappingURL=stack-options.d.ts.map

package/dist/init/stack/stack-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-options.d.ts","sourceRoot":"","sources":["../../../src/init/stack/stack-options.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB"}

package/dist/init/stack/stack-options.js

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

package/dist/init/stack/stack-options.js.map

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

package/dist/init/template-vars.d.ts

@@ -0,0 +1,5 @@
+import type { Config } from '../config/index.js';
+import type { RenderContext } from '../templating/index.js';
+/** What the templates of `init` read: the variables of the stack, then the ones only a new project needs. */
+export declare function templateVars(config: Config, projectName: string): RenderContext;
+//# sourceMappingURL=template-vars.d.ts.map

package/dist/init/template-vars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-vars.d.ts","sourceRoot":"","sources":["../../src/init/template-vars.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAM5D,6GAA6G;AAC7G,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CA0B/E"}

package/dist/init/template-vars.js

@@ -0,0 +1,48 @@
+import { stackVars } from '../stack/stack-vars.js';
+import { WITH_DATABASE } from '../stack/with-database.js';
+import { knipVars } from './knip-vars.js';
+/** The Keycloak release the compose service runs and the realm file was written and imported for. */
+const KEYCLOAK_VERSION = '26.8.0';
+/** What the templates of `init` read: the variables of the stack, then the ones only a new project needs. */
+export function templateVars(config, projectName) {
+    const { database, docsUi, ci, cache, broker, errors } = config.stack;
+    return {
+        ...stackVars(config),
+        project: { name: projectName },
+        docs: { any: docsUi !== 'none', ui: docsUi },
+        knip: knipVars(config),
+        ci: { github: ci === 'github' || ci === 'both', gitlab: ci === 'gitlab' || ci === 'both', any: ci !== 'none' },
+        needs: { url: readsUrl(config), text: readsText(config) },
+        keycloak: { version: KEYCLOAK_VERSION },
+        compose: {
+            volumes: database === 'postgres' ||
+                database === 'mysql' ||
+                cache === 'redis' ||
+                ['redis', 'nats'].includes(broker) ||
+                errors === 'sentry',
+        },
+        database: {
+            postgres: database === 'postgres',
+            mysql: database === 'mysql',
+            sqlite: database === 'sqlite',
+            server: database === 'postgres' || database === 'mysql',
+        },
+    };
+}
+/** Whether the validated configuration holds at least one URL: the reader of URLs is written only then. */
+function readsUrl(config) {
+    const { orm, broker, cache } = config.stack;
+    return (WITH_DATABASE.includes(orm) ||
+        verifiesTokens(config) ||
+        ['rabbitmq', 'nats', 'redis'].includes(broker) ||
+        cache === 'redis');
+}
+/** Whether the validated configuration holds a required text that is not a URL: the names a token is checked against, a list of brokers. */
+function readsText(config) {
+    return verifiesTokens(config) || config.stack.broker === 'kafka';
+}
+function verifiesTokens(config) {
+    const { authn, http } = config.stack;
+    return (authn === 'jwt' || authn === 'keycloak') && http !== 'none';
+}
+//# sourceMappingURL=template-vars.js.map

package/dist/init/template-vars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-vars.js","sourceRoot":"","sources":["../../src/init/template-vars.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,qGAAqG;AACrG,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAElC,6GAA6G;AAC7G,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,WAAmB;IAC9D,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;IAErE,OAAO;QACL,GAAG,SAAS,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;QAC9B,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE;QAC5C,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC;QACtB,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,MAAM,EAAE;QAC9G,KAAK,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE;QACzD,QAAQ,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE;QACvC,OAAO,EAAE;YACP,OAAO,EACL,QAAQ,KAAK,UAAU;gBACvB,QAAQ,KAAK,OAAO;gBACpB,KAAK,KAAK,OAAO;gBACjB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAClC,MAAM,KAAK,QAAQ;SACtB;QACD,QAAQ,EAAE;YACR,QAAQ,EAAE,QAAQ,KAAK,UAAU;YACjC,KAAK,EAAE,QAAQ,KAAK,OAAO;YAC3B,MAAM,EAAE,QAAQ,KAAK,QAAQ;YAC7B,MAAM,EAAE,QAAQ,KAAK,UAAU,IAAI,QAAQ,KAAK,OAAO;SACxD;KACF,CAAC;AACJ,CAAC;AAED,2GAA2G;AAC3G,SAAS,QAAQ,CAAC,MAAc;IAC9B,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;IAE5C,OAAO,CACL,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC3B,cAAc,CAAC,MAAM,CAAC;QACtB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC9C,KAAK,KAAK,OAAO,CAClB,CAAC;AACJ,CAAC;AAED,4IAA4I;AAC5I,SAAS,SAAS,CAAC,MAAc;IAC/B,OAAO,cAAc,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC;AACnE,CAAC;AAED,SAAS,cAAc,CAAC,MAAc;IACpC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;IAErC,OAAO,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,UAAU,CAAC,IAAI,IAAI,KAAK,MAAM,CAAC;AACtE,CAAC"}

package/dist/init/write-agent-settings.d.ts

@@ -0,0 +1,4 @@
+import type { Workspace } from '../workspace/index.js';
+/** Creates the settings, or adds the missing permissions to the ones the project already has, and says which. */
+export declare function writeAgentSettings(ws: Workspace): void;
+//# sourceMappingURL=write-agent-settings.d.ts.map

package/dist/init/write-agent-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-agent-settings.d.ts","sourceRoot":"","sources":["../../src/init/write-agent-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AA4DvD,iHAAiH;AACjH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAwBtD"}

package/dist/init/write-agent-settings.js

@@ -0,0 +1,95 @@
+import { isRecord } from './is-record.js';
+import { formatJson } from '../json/format-json.js';
+const AGENT_SETTINGS = '.claude/settings.json';
+/**
+ * What an agent may do in the project without asking, what it never does, and what it asks
+ * for. Permissions only: nothing here changes how the agent behaves otherwise.
+ */
+const PERMISSIONS = {
+    allow: [
+        'Bash(npx ddd-ts-kit check *)',
+        'Bash(npx ddd-ts-kit list *)',
+        'Bash(npx ddd-ts-kit generate *)',
+        'Bash(npx ddd-ts-kit docs *)',
+        'Bash(npx ddd-ts-kit explain *)',
+        'Bash(npx ddd-ts-kit rules)',
+        'Bash(npm run verify)',
+        'Bash(npm run typecheck)',
+        'Bash(npm run lint *)',
+        'Bash(npm test *)',
+        'Bash(npm run test:e2e *)',
+        'Bash(npm run docs:generate)',
+        'Bash(npm run docs:check)',
+        'Bash(npm run openapi:generate)',
+        'Bash(npm run openapi:check)',
+        'Bash(npm run events:generate)',
+        'Bash(npm run events:check)',
+    ],
+    // Secrets, then the generated contracts: those are regenerated, never edited. In a deny
+    // list, a pattern starting with `!` carves its matches out of the rules before it
+    // (gitignore negation), which keeps `.env.example`, documentation, readable.
+    deny: [
+        'Read(./.env)',
+        'Read(./.env.*)',
+        'Read(!./.env.example)',
+        'Edit(./openapi/openapi.json)',
+        'Edit(./docs/integration/asyncapi.json)',
+        'Edit(./docs/integration/event-catalog.md)',
+    ],
+    // Then the files that hold the rules and the pipeline: changing one is a decision of the
+    // project owner, the same list as the editor hook of the plugin asks about.
+    ask: [
+        'Bash(git push *)',
+        'Bash(npm publish *)',
+        'Edit(./ddd-ts-kit.config.json)',
+        'Edit(./eslint.config.mjs)',
+        'Edit(./biome.json)',
+        'Edit(./.dependency-cruiser.cjs)',
+        'Edit(./knip.json)',
+        'Edit(./lefthook.yml)',
+        'Edit(./.gitlab-ci.yml)',
+        'Edit(./.github/workflows/**)',
+        'Edit(./.claude/settings.json)',
+    ],
+};
+/** Creates the settings, or adds the missing permissions to the ones the project already has, and says which. */
+export function writeAgentSettings(ws) {
+    const existing = ws.read(AGENT_SETTINGS);
+    if (existing === undefined) {
+        ws.create(AGENT_SETTINGS, serialize({ permissions: PERMISSIONS }));
+        return;
+    }
+    const settings = parse(existing);
+    if (settings === undefined) {
+        ws.note(`${AGENT_SETTINGS} is not a JSON object: it was left as it is.`);
+        return;
+    }
+    const merged = mergePermissions(settings);
+    ws.update(AGENT_SETTINGS, serialize(merged.settings));
+    if (merged.added.length > 0) {
+        ws.note(`${AGENT_SETTINGS} gained ${merged.added.length} permission(s): ${merged.added.join(', ')}.`);
+    }
+}
+const serialize = (settings) => formatJson(settings);
+function parse(text) {
+    try {
+        const parsed = JSON.parse(text);
+        return isRecord(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function mergePermissions(settings) {
+    const current = isRecord(settings['permissions']) ? settings['permissions'] : {};
+    const added = [];
+    const permissions = { ...current };
+    for (const [kind, wanted] of Object.entries(PERMISSIONS)) {
+        const present = Array.isArray(current[kind]) ? current[kind] : [];
+        const missing = wanted.filter((rule) => !present.includes(rule));
+        permissions[kind] = [...present, ...missing];
+        added.push(...missing.map((rule) => `${kind} ${rule}`));
+    }
+    return { settings: { ...settings, permissions }, added };
+}
+//# sourceMappingURL=write-agent-settings.js.map

package/dist/init/write-agent-settings.js.map

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

package/dist/init/write-type-script-configs.d.ts

@@ -0,0 +1,9 @@
+import type { Config } from '../config/index.js';
+import type { Workspace } from '../workspace/index.js';
+/**
+ * `tsconfig.json` for the editor and the type check, `tsconfig.build.json` for what ships: no test,
+ * no test database. `paths` declares the import alias for the compiler and for every tool that
+ * reads tsconfig; the build config extends the other, so the two cannot disagree.
+ */
+export declare function writeTypeScriptConfigs(ws: Workspace, config: Config): void;
+//# sourceMappingURL=write-type-script-configs.d.ts.map

package/dist/init/write-type-script-configs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-type-script-configs.d.ts","sourceRoot":"","sources":["../../src/init/write-type-script-configs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAY1E"}

package/dist/init/write-type-script-configs.js

@@ -0,0 +1,39 @@
+import { aliasRoots, compilerPaths, DEFAULT_BUILD_LAYOUT } from '../alias/index.js';
+import { usesLegacyDecorators } from '../stack/uses-legacy-decorators.js';
+import { formatJson } from '../json/format-json.js';
+/**
+ * `tsconfig.json` for the editor and the type check, `tsconfig.build.json` for what ships: no test,
+ * no test database. `paths` declares the import alias for the compiler and for every tool that
+ * reads tsconfig; the build config extends the other, so the two cannot disagree.
+ */
+export function writeTypeScriptConfigs(ws, config) {
+    const include = [config.sourceRoot, 'scripts', 'test', ...(config.stack.orm === 'prisma' ? ['generated'] : [])];
+    ws.create('tsconfig.json', serialize({ compilerOptions: compilerOptions(config), include }));
+    ws.create('tsconfig.build.json', serialize({
+        extends: './tsconfig.json',
+        exclude: ['test', '**/test/**', '**/*.spec.ts', '**/open-test-database.ts'],
+    }));
+}
+function compilerOptions(config) {
+    return {
+        target: 'ES2023',
+        lib: ['ES2023'],
+        module: 'NodeNext',
+        moduleResolution: 'NodeNext',
+        strict: true,
+        noUncheckedIndexedAccess: true,
+        exactOptionalPropertyTypes: true,
+        noImplicitOverride: true,
+        verbatimModuleSyntax: true,
+        skipLibCheck: true,
+        ...(usesLegacyDecorators(config) ? { experimentalDecorators: true, emitDecoratorMetadata: true } : {}),
+        types: ['node'],
+        rootDir: DEFAULT_BUILD_LAYOUT.rootDir,
+        outDir: DEFAULT_BUILD_LAYOUT.outDir,
+        paths: compilerPaths(aliasRoots(config)),
+    };
+}
+function serialize(value) {
+    return formatJson(value);
+}
+//# sourceMappingURL=write-type-script-configs.js.map

package/dist/init/write-type-script-configs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-type-script-configs.js","sourceRoot":"","sources":["../../src/init/write-type-script-configs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAa,EAAE,MAAc;IAClE,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEhH,EAAE,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,CAAC,EAAE,eAAe,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAE7F,EAAE,CAAC,MAAM,CACP,qBAAqB,EACrB,SAAS,CAAC;QACR,OAAO,EAAE,iBAAiB;QAC1B,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,0BAA0B,CAAC;KAC5E,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO;QACL,MAAM,EAAE,QAAQ;QAChB,GAAG,EAAE,CAAC,QAAQ,CAAC;QACf,MAAM,EAAE,UAAU;QAClB,gBAAgB,EAAE,UAAU;QAC5B,MAAM,EAAE,IAAI;QACZ,wBAAwB,EAAE,IAAI;QAC9B,0BAA0B,EAAE,IAAI;QAChC,kBAAkB,EAAE,IAAI;QACxB,oBAAoB,EAAE,IAAI;QAC1B,YAAY,EAAE,IAAI;QAClB,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtG,KAAK,EAAE,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,oBAAoB,CAAC,OAAO;QACrC,MAAM,EAAE,oBAAoB,CAAC,MAAM;QACnC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/json/format-json.d.ts

@@ -0,0 +1,7 @@
+/**
+ * JSON as the formatter of a project lays it out (`biome.json`, width 120), so that a file the
+ * CLI writes is already formatted: an object is written one key per line, a list on one line
+ * when it holds no object and fits, one entry per line otherwise.
+ */
+export declare function formatJson(value: unknown): string;
+//# sourceMappingURL=format-json.d.ts.map

package/dist/json/format-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-json.d.ts","sourceRoot":"","sources":["../../src/json/format-json.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD"}

package/dist/json/format-json.js

@@ -0,0 +1,57 @@
+const LINE_WIDTH = 120;
+const INDENT = '  ';
+/**
+ * JSON as the formatter of a project lays it out (`biome.json`, width 120), so that a file the
+ * CLI writes is already formatted: an object is written one key per line, a list on one line
+ * when it holds no object and fits, one entry per line otherwise.
+ */
+export function formatJson(value) {
+    return `${print(value, { depth: 0, before: 0, after: 0 })}\n`;
+}
+function print(value, place) {
+    if (Array.isArray(value)) {
+        return printList(value, place);
+    }
+    if (typeof value === 'object' && value !== null) {
+        return printObject(writtenEntries(value), place.depth);
+    }
+    return value === undefined ? 'null' : JSON.stringify(value);
+}
+function printList(entries, place) {
+    const onOneLine = entries.every(isInline) ? inline(entries) : undefined;
+    if (onOneLine !== undefined && place.before + onOneLine.length + place.after <= LINE_WIDTH) {
+        return onOneLine;
+    }
+    const inner = INDENT.repeat(place.depth + 1);
+    const lines = entries.map((entry, index) => `${inner}${print(entry, within(place, inner.length, index < entries.length - 1))}`);
+    return `[\n${lines.join(',\n')}\n${INDENT.repeat(place.depth)}]`;
+}
+function printObject(entries, depth) {
+    if (entries.length === 0) {
+        return '{}';
+    }
+    const inner = INDENT.repeat(depth + 1);
+    const lines = entries.map(([key, entry], index) => {
+        const name = `${inner}${JSON.stringify(key)}: `;
+        return `${name}${print(entry, within({ depth, before: 0, after: 0 }, name.length, index < entries.length - 1))}`;
+    });
+    return `{\n${lines.join(',\n')}\n${INDENT.repeat(depth)}}`;
+}
+/** As `JSON.stringify` does, a key without a value is left out. */
+function writtenEntries(value) {
+    return Object.entries(value).filter(([, entry]) => entry !== undefined);
+}
+function within(place, before, isFollowed) {
+    return { depth: place.depth + 1, before, after: isFollowed ? 1 : 0 };
+}
+/** A plain value, or a list of plain values: what a line can hold without opening a block. */
+function isInline(value) {
+    if (Array.isArray(value)) {
+        return value.every(isInline);
+    }
+    return typeof value !== 'object' || value === null;
+}
+function inline(entries) {
+    return `[${entries.map((entry) => (Array.isArray(entry) ? inline(entry) : JSON.stringify(entry))).join(', ')}]`;
+}
+//# sourceMappingURL=format-json.js.map

package/dist/json/format-json.js.map

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

package/dist/layout/chain-links.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The links of a call chain written on one line: what the chain starts from, then each call made
+ * on the answer of the previous one (`builder`, `.bind(Port)`, `.toClass(Adapter)`). Members read
+ * before the first call belong to the start (`platform.commands`, `.register(...)`).
+ */
+export declare function chainLinks(statement: string): string[];
+//# sourceMappingURL=chain-links.d.ts.map

package/dist/layout/chain-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-links.d.ts","sourceRoot":"","sources":["../../src/layout/chain-links.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CActD"}

package/dist/layout/chain-links.js

@@ -0,0 +1,19 @@
+import { nesting } from './nesting.js';
+/**
+ * The links of a call chain written on one line: what the chain starts from, then each call made
+ * on the answer of the previous one (`builder`, `.bind(Port)`, `.toClass(Adapter)`). Members read
+ * before the first call belong to the start (`platform.commands`, `.register(...)`).
+ */
+export function chainLinks(statement) {
+    const depths = nesting(statement);
+    const cuts = statement
+        .split('')
+        .map((char, index) => (char === '.' && depths[index] === 0 && statement[index - 1] === ')' ? index : -1))
+        .filter((index) => index > 0);
+    const first = statement.slice(0, cuts[0] ?? statement.length);
+    const calls = cuts.map((cut, index) => statement.slice(cut, cuts[index + 1] ?? statement.length));
+    const called = first.split('').findIndex((char, index) => char === '(' && depths[index] === 0);
+    const member = called === -1 ? -1 : first.lastIndexOf('.', called);
+    return member === -1 ? [first, ...calls] : [first.slice(0, member), first.slice(member), ...calls];
+}
+//# sourceMappingURL=chain-links.js.map

package/dist/layout/chain-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-links.js","sourceRoot":"","sources":["../../src/layout/chain-links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAElC,MAAM,IAAI,GAAG,SAAS;SACnB,KAAK,CAAC,EAAE,CAAC;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACxG,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAEhC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAClG,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/F,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAEnE,OAAO,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;AACrG,CAAC"}

package/dist/layout/fit-block.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Lays out what a template adds to a region, statement by statement, at the indentation of the
+ * region. A statement that takes several lines is set apart from its neighbours by a blank line,
+ * as the layout rules of a generated project ask.
+ */
+export declare function fitBlock(lines: readonly string[], indent: string): string[];
+//# sourceMappingURL=fit-block.d.ts.map

package/dist/layout/fit-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit-block.d.ts","sourceRoot":"","sources":["../../src/layout/fit-block.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAc3E"}