ddd-ts-kit 0.0.0-stage → 0.1.0

package/dist/generate/label.d.ts

@@ -0,0 +1,6 @@
+import { type Name } from '../naming/index.js';
+import type { ConceptRole } from './concept-role.js';
+import type { Scope } from './scope.js';
+/** A name that is not a concept of the model (a port, an outside system): only its form is checked. */
+export declare function label(scope: Scope, input: string, role: ConceptRole): Name;
+//# sourceMappingURL=label.d.ts.map

package/dist/generate/label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../src/generate/label.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,uGAAuG;AACvG,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAE1E"}

package/dist/generate/label.js

@@ -0,0 +1,6 @@
+import { parseConceptName } from '../naming/index.js';
+/** A name that is not a concept of the model (a port, an outside system): only its form is checked. */
+export function label(scope, input, role) {
+    return parseConceptName(input, role.what, { allowName: scope.flags.allowName, strip: role.strip ?? [] });
+}
+//# sourceMappingURL=label.js.map

package/dist/generate/label.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.js","sourceRoot":"","sources":["../../src/generate/label.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAa,MAAM,oBAAoB,CAAC;AAIjE,uGAAuG;AACvG,MAAM,UAAU,KAAK,CAAC,KAAY,EAAE,KAAa,EAAE,IAAiB;IAClE,OAAO,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC;AAC3G,CAAC"}

package/dist/generate/learn-terms.d.ts

@@ -0,0 +1,4 @@
+import type { Scope } from './scope.js';
+/** Writes the `--term` rows into the glossary of the context. Called once per command, before any name is judged. */
+export declare function learnTerms(scope: Scope): void;
+//# sourceMappingURL=learn-terms.d.ts.map

package/dist/generate/learn-terms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn-terms.d.ts","sourceRoot":"","sources":["../../src/generate/learn-terms.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,qHAAqH;AACrH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAkB7C"}

package/dist/generate/learn-terms.js

@@ -0,0 +1,17 @@
+import { addGlossaryRows } from '../check/language/add-glossary-rows.js';
+import { CliError } from '../cli-error.js';
+import { parseTerms } from './parse-terms.js';
+/** Writes the `--term` rows into the glossary of the context. Called once per command, before any name is judged. */
+export function learnTerms(scope) {
+    const rows = parseTerms(scope.flags.term);
+    if (rows.length === 0) {
+        return;
+    }
+    const file = `${scope.dir}/CONTEXT.md`;
+    const next = addGlossaryRows(scope.ws.read(file) ?? '', rows);
+    if (next === undefined) {
+        throw new CliError(`${file} has no "## Ubiquitous language" table to add the terms to.`, 'Restore the section with a table whose first column is the term, then run the command again.');
+    }
+    scope.ws.update(file, next);
+}
+//# sourceMappingURL=learn-terms.js.map

package/dist/generate/learn-terms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn-terms.js","sourceRoot":"","sources":["../../src/generate/learn-terms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,qHAAqH;AACrH,MAAM,UAAU,UAAU,CAAC,KAAY;IACrC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE1C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,aAAa,CAAC;IACvC,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IAE9D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CAChB,GAAG,IAAI,6DAA6D,EACpE,8FAA8F,CAC/F,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/generate/named.d.ts

@@ -0,0 +1,5 @@
+import type { Name } from '../naming/index.js';
+import type { RenderContext } from '../templating/index.js';
+/** A name as the templates read it: `{{name.pascal}}`, `{{name.kebab}}`... */
+export declare function named(name: Name): RenderContext;
+//# sourceMappingURL=named.d.ts.map

package/dist/generate/named.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named.d.ts","sourceRoot":"","sources":["../../src/generate/named.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,8EAA8E;AAC9E,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,CAE/C"}

package/dist/generate/named.js

@@ -0,0 +1,5 @@
+/** A name as the templates read it: `{{name.pascal}}`, `{{name.kebab}}`... */
+export function named(name) {
+    return { ...name };
+}
+//# sourceMappingURL=named.js.map

package/dist/generate/named.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named.js","sourceRoot":"","sources":["../../src/generate/named.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,MAAM,UAAU,KAAK,CAAC,IAAU;IAC9B,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;AACrB,CAAC"}

package/dist/generate/open-scope.d.ts

@@ -0,0 +1,5 @@
+import type { KindRequest } from './kind.js';
+import type { Scope } from './scope.js';
+/** Opens the context named by the first positional argument of a request. */
+export declare function openScope(request: KindRequest): Scope;
+//# sourceMappingURL=open-scope.d.ts.map

package/dist/generate/open-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-scope.d.ts","sourceRoot":"","sources":["../../src/generate/open-scope.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,KAAK,CASrD"}

package/dist/generate/open-scope.js

@@ -0,0 +1,19 @@
+import { CliError } from '../cli-error.js';
+import { toName } from '../naming/index.js';
+/** Opens the context named by the first positional argument of a request. */
+export function openScope(request) {
+    const { ws, config, flags } = request;
+    const context = toName(request.args[0] ?? '');
+    if (config.contexts[context.kebab] === undefined) {
+        throw unknownContext(config, context);
+    }
+    return { ws, config, context, dir: `${config.contextsDir}/${context.kebab}`, flags };
+}
+function unknownContext(config, context) {
+    const known = Object.keys(config.contexts);
+    const create = `\`ddd-ts-kit generate context ${context.kebab} --classification <core|supporting|generic>\``;
+    return new CliError(`Unknown context "${context.kebab}".`, known.length > 0
+        ? `Use one of: ${known.join(', ')}; or create it with ${create}.`
+        : `Create it first with ${create}.`);
+}
+//# sourceMappingURL=open-scope.js.map

package/dist/generate/open-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-scope.js","sourceRoot":"","sources":["../../src/generate/open-scope.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAa,MAAM,oBAAoB,CAAC;AAIvD,6EAA6E;AAC7E,MAAM,UAAU,SAAS,CAAC,OAAoB;IAC5C,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC;AACvF,CAAC;AAED,SAAS,cAAc,CAAC,MAAc,EAAE,OAAa;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,iCAAiC,OAAO,CAAC,KAAK,+CAA+C,CAAC;IAE7G,OAAO,IAAI,QAAQ,CACjB,oBAAoB,OAAO,CAAC,KAAK,IAAI,EACrC,KAAK,CAAC,MAAM,GAAG,CAAC;QACd,CAAC,CAAC,eAAe,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,MAAM,GAAG;QACjE,CAAC,CAAC,wBAAwB,MAAM,GAAG,CACtC,CAAC;AACJ,CAAC"}

package/dist/generate/parse-terms.d.ts

@@ -0,0 +1,7 @@
+export interface GlossaryRow {
+    readonly term: string;
+    readonly meaning: string;
+}
+/** The `--term "<Term>=<meaning>"` flags of a command, as rows of a glossary. */
+export declare function parseTerms(flags: readonly string[]): GlossaryRow[];
+//# sourceMappingURL=parse-terms.d.ts.map

package/dist/generate/parse-terms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-terms.d.ts","sourceRoot":"","sources":["../../src/generate/parse-terms.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,EAAE,CAalE"}

package/dist/generate/parse-terms.js

@@ -0,0 +1,12 @@
+import { CliError } from '../cli-error.js';
+/** The `--term "<Term>=<meaning>"` flags of a command, as rows of a glossary. */
+export function parseTerms(flags) {
+    return flags.map((flag) => {
+        const [term = '', ...meaning] = flag.split('=');
+        if (term.trim() === '' || meaning.join('=').trim() === '') {
+            throw new CliError(`--term "${flag}" is not a term with its meaning.`, 'Write it as --term "<Term>=<what it means for the business>", for example --term "Invoice=A request for payment sent to a customer".');
+        }
+        return { term: term.trim(), meaning: meaning.join('=').trim() };
+    });
+}
+//# sourceMappingURL=parse-terms.js.map

package/dist/generate/parse-terms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-terms.js","sourceRoot":"","sources":["../../src/generate/parse-terms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAO3C,iFAAiF;AACjF,MAAM,UAAU,UAAU,CAAC,KAAwB;IACjD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,CAAC,IAAI,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEhD,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC1D,MAAM,IAAI,QAAQ,CAChB,WAAW,IAAI,mCAAmC,EAClD,sIAAsI,CACvI,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/generate/permission-named.d.ts

@@ -0,0 +1,4 @@
+import type { Scope } from './scope.js';
+/** A permission is named in the ubiquitous language, like everything else: `<aggregate>.<action>`. */
+export declare function permissionNamed(scope: Scope, permission: string): string;
+//# sourceMappingURL=permission-named.d.ts.map

package/dist/generate/permission-named.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-named.d.ts","sourceRoot":"","sources":["../../src/generate/permission-named.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAIxC,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAWxE"}

package/dist/generate/permission-named.js

@@ -0,0 +1,12 @@
+import { CliError } from '../cli-error.js';
+import { concept } from './concept.js';
+const PERMISSION_NAME = /^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)+$/;
+/** A permission is named in the ubiquitous language, like everything else: `<aggregate>.<action>`. */
+export function permissionNamed(scope, permission) {
+    if (!PERMISSION_NAME.test(permission)) {
+        throw new CliError(`"${permission}" is not a permission name.`, 'Write it as <aggregate>.<action> in kebab-case, for example --permission invoice.issue.');
+    }
+    concept(scope, permission.replaceAll('.', ' '), { what: 'permission' });
+    return permission;
+}
+//# sourceMappingURL=permission-named.js.map

package/dist/generate/permission-named.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-named.js","sourceRoot":"","sources":["../../src/generate/permission-named.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,MAAM,eAAe,GAAG,uCAAuC,CAAC;AAEhE,sGAAsG;AACtG,MAAM,UAAU,eAAe,CAAC,KAAY,EAAE,UAAkB;IAC9D,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,QAAQ,CAChB,IAAI,UAAU,6BAA6B,EAC3C,yFAAyF,CAC1F,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IAExE,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/generate/permissions-file.d.ts

@@ -0,0 +1,4 @@
+import type { Name } from '../naming/index.js';
+/** The file holding the permissions of a context, relative to the context. */
+export declare function permissionsFile(context: Name): string;
+//# sourceMappingURL=permissions-file.d.ts.map

package/dist/generate/permissions-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions-file.d.ts","sourceRoot":"","sources":["../../src/generate/permissions-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,CAErD"}

package/dist/generate/permissions-file.js

@@ -0,0 +1,5 @@
+/** The file holding the permissions of a context, relative to the context. */
+export function permissionsFile(context) {
+    return `application/authorization/${context.kebab}.permissions.ts`;
+}
+//# sourceMappingURL=permissions-file.js.map

package/dist/generate/permissions-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions-file.js","sourceRoot":"","sources":["../../src/generate/permissions-file.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,OAAa;IAC3C,OAAO,6BAA6B,OAAO,CAAC,KAAK,iBAAiB,CAAC;AACrE,CAAC"}

package/dist/generate/refresh-barrels.d.ts

@@ -0,0 +1,9 @@
+import type { Config } from '../config/index.js';
+import type { Workspace } from '../workspace/index.js';
+/**
+ * Rewrites the barrel of every declared context from its tree. Called at the end of every
+ * `generate` and by `docs`: the barrel is derived, like the documentation, and
+ * `declarations/barrel-current` reports one that was left behind.
+ */
+export declare function refreshBarrels(ws: Workspace, config: Config): void;
+//# sourceMappingURL=refresh-barrels.d.ts.map

package/dist/generate/refresh-barrels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-barrels.d.ts","sourceRoot":"","sources":["../../src/generate/refresh-barrels.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIvD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAoBlE"}

package/dist/generate/refresh-barrels.js

@@ -0,0 +1,29 @@
+import { contextAlias } from '../alias/index.js';
+import { barrelFile, renderBarrel } from '../declared/index.js';
+import { filesUnder } from './files-under.js';
+import { isDeclared } from './is-declared.js';
+/**
+ * Rewrites the barrel of every declared context from its tree. Called at the end of every
+ * `generate` and by `docs`: the barrel is derived, like the documentation, and
+ * `declarations/barrel-current` reports one that was left behind.
+ */
+export function refreshBarrels(ws, config) {
+    if (!isDeclared(config) || config.stack.assembly !== 'barrel') {
+        return;
+    }
+    for (const context of ws.directories(config.contextsDir)) {
+        if (config.contexts[context] === undefined) {
+            continue;
+        }
+        const directory = `${config.contextsDir}/${context}`;
+        const file = `${directory}/${barrelFile(context)}`;
+        const content = renderBarrel(filesUnder(ws, directory), contextAlias(config, context));
+        if (ws.exists(file)) {
+            ws.update(file, content);
+        }
+        else {
+            ws.create(file, content);
+        }
+    }
+}
+//# sourceMappingURL=refresh-barrels.js.map

package/dist/generate/refresh-barrels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-barrels.js","sourceRoot":"","sources":["../../src/generate/refresh-barrels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAa,EAAE,MAAc;IAC1D,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACzD,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3C,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,MAAM,CAAC,WAAW,IAAI,OAAO,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,GAAG,SAAS,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAEvF,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/generate/refuse-shared-writes.d.ts

@@ -0,0 +1,8 @@
+import type { Config } from '../config/index.js';
+import type { Workspace } from '../workspace/index.js';
+/**
+ * `--local-only`: a plan that reaches outside the given context (its directory and the
+ * end-to-end specs) is refused whole, before anything is written, naming the shared files.
+ */
+export declare function refuseSharedWrites(ws: Workspace, config: Config, context: string | undefined): void;
+//# sourceMappingURL=refuse-shared-writes.d.ts.map

package/dist/generate/refuse-shared-writes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refuse-shared-writes.d.ts","sourceRoot":"","sources":["../../src/generate/refuse-shared-writes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIvD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAgBnG"}

package/dist/generate/refuse-shared-writes.js

@@ -0,0 +1,16 @@
+import { CliError } from '../cli-error.js';
+const E2E_SPEC = /^test\/e2e\/[^/]+\.e2e\.spec\.ts$/;
+/**
+ * `--local-only`: a plan that reaches outside the given context (its directory and the
+ * end-to-end specs) is refused whole, before anything is written, naming the shared files.
+ */
+export function refuseSharedWrites(ws, config, context) {
+    const plan = ws.commit(true);
+    const local = (file) => E2E_SPEC.test(file) || (context !== undefined && file.startsWith(`${config.contextsDir}/${context}/`));
+    const shared = [...plan.created, ...plan.updated].filter((file) => !local(file)).sort();
+    if (shared.length === 0) {
+        return;
+    }
+    throw new CliError(`--local-only: this command would write ${shared.length} shared file${shared.length === 1 ? '' : 's'}: ${shared.join(', ')}.`, 'Nothing was written. Have it run on the trunk without --local-only (the conductor of a parallel build does it), merge the trunk, then go on; a generated document listed alone means the trunk is stale: run `ddd-ts-kit docs` there first.');
+}
+//# sourceMappingURL=refuse-shared-writes.js.map

package/dist/generate/refuse-shared-writes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refuse-shared-writes.js","sourceRoot":"","sources":["../../src/generate/refuse-shared-writes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAI3C,MAAM,QAAQ,GAAG,mCAAmC,CAAC;AAErD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAa,EAAE,MAAc,EAAE,OAA2B;IAC3F,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE7B,MAAM,KAAK,GAAG,CAAC,IAAY,EAAW,EAAE,CACtC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,WAAW,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;IAEzG,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAExF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,QAAQ,CAChB,0CAA0C,MAAM,CAAC,MAAM,eAAe,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAC7H,6OAA6O,CAC9O,CAAC;AACJ,CAAC"}

package/dist/generate/relative-to.d.ts

@@ -0,0 +1,3 @@
+/** The relative specifier from one directory of the project to another, always starting with a dot. */
+export declare function relativeTo(from: string, to: string): string;
+//# sourceMappingURL=relative-to.d.ts.map

package/dist/generate/relative-to.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-to.d.ts","sourceRoot":"","sources":["../../src/generate/relative-to.ts"],"names":[],"mappings":"AAEA,uGAAuG;AACvG,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAI3D"}

package/dist/generate/relative-to.js

@@ -0,0 +1,7 @@
+import path from 'node:path';
+/** The relative specifier from one directory of the project to another, always starting with a dot. */
+export function relativeTo(from, to) {
+    const result = path.posix.relative(from, to);
+    return result.startsWith('.') ? result : `./${result}`;
+}
+//# sourceMappingURL=relative-to.js.map

package/dist/generate/relative-to.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-to.js","sourceRoot":"","sources":["../../src/generate/relative-to.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,uGAAuG;AACvG,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,EAAU;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAE7C,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;AACzD,CAAC"}

package/dist/generate/require-file.d.ts

@@ -0,0 +1,10 @@
+import type { Scope } from './scope.js';
+export interface Prerequisite {
+    /** Path inside the context. */
+    readonly file: string;
+    readonly what: string;
+    readonly createdBy: string;
+}
+/** Stops with the command that creates what a kind builds on, when it is missing. */
+export declare function requireFile(scope: Scope, prerequisite: Prerequisite): void;
+//# sourceMappingURL=require-file.d.ts.map

package/dist/generate/require-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-file.d.ts","sourceRoot":"","sources":["../../src/generate/require-file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,GAAG,IAAI,CAW1E"}

package/dist/generate/require-file.js

@@ -0,0 +1,10 @@
+import { CliError } from '../cli-error.js';
+/** Stops with the command that creates what a kind builds on, when it is missing. */
+export function requireFile(scope, prerequisite) {
+    const target = `${scope.dir}/${prerequisite.file}`;
+    if (scope.ws.exists(target)) {
+        return;
+    }
+    throw new CliError(`${prerequisite.what} does not exist in "${scope.context.kebab}" (${target}).`, `Create it first with \`${prerequisite.createdBy}\`.`);
+}
+//# sourceMappingURL=require-file.js.map

package/dist/generate/require-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-file.js","sourceRoot":"","sources":["../../src/generate/require-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAU3C,qFAAqF;AACrF,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,YAA0B;IAClE,MAAM,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;IAEnD,IAAI,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,MAAM,IAAI,QAAQ,CAChB,GAAG,YAAY,CAAC,IAAI,uBAAuB,KAAK,CAAC,OAAO,CAAC,KAAK,MAAM,MAAM,IAAI,EAC9E,0BAA0B,YAAY,CAAC,SAAS,KAAK,CACtD,CAAC;AACJ,CAAC"}

package/dist/generate/schedule/cron-field-values.d.ts

@@ -0,0 +1,4 @@
+import type { CronField } from './cron-field.js';
+/** The values a field of a cron expression names, sorted, or undefined when one of its parts cannot be read. */
+export declare function cronFieldValues(text: string, field: CronField): number[] | undefined;
+//# sourceMappingURL=cron-field-values.d.ts.map

package/dist/generate/schedule/cron-field-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-field-values.d.ts","sourceRoot":"","sources":["../../../src/generate/schedule/cron-field-values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD,gHAAgH;AAChH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAKpF"}

package/dist/generate/schedule/cron-field-values.js

@@ -0,0 +1,32 @@
+const EVERY_VALUE = /^\*(?:\/(\d+))?$/;
+const VALUE_OR_RANGE = /^([a-z0-9]+)(?:-([a-z0-9]+)(?:\/(\d+))?)?$/;
+/** The values a field of a cron expression names, sorted, or undefined when one of its parts cannot be read. */
+export function cronFieldValues(text, field) {
+    const parts = text.split(',').map((part) => partValues(part.toLowerCase(), field));
+    const values = parts.flatMap((part) => part ?? []);
+    return parts.includes(undefined) ? undefined : [...new Set(values)].sort((left, right) => left - right);
+}
+/** One element of a list: `*`, a value or a range, `*` and a range taking a step. */
+function partValues(part, field) {
+    const every = EVERY_VALUE.exec(part);
+    if (every !== null) {
+        return stepping(field.min, field.max, every[1]);
+    }
+    const [, start, end, step] = VALUE_OR_RANGE.exec(part) ?? [];
+    const from = start === undefined ? undefined : valueOf(start, field);
+    const to = from === undefined ? undefined : valueOf(end ?? start ?? '', field);
+    return from === undefined || to === undefined ? undefined : stepping(from, to, step);
+}
+function stepping(from, to, step) {
+    const stride = Number(step ?? 1);
+    if (from > to || stride < 1) {
+        return undefined;
+    }
+    return Array.from({ length: Math.floor((to - from) / stride) + 1 }, (_, index) => from + index * stride);
+}
+function valueOf(text, field) {
+    const named = field.names.indexOf(text);
+    const value = named === -1 ? Number(/^\d+$/.test(text) ? text : Number.NaN) : named + (field.label === 'month' ? 1 : 0);
+    return Number.isNaN(value) || value < field.min || value > field.max ? undefined : value;
+}
+//# sourceMappingURL=cron-field-values.js.map

package/dist/generate/schedule/cron-field-values.js.map

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

package/dist/generate/schedule/cron-field.d.ts

@@ -0,0 +1,8 @@
+/** One of the five fields of a cron expression: its bounds and the names it accepts in place of numbers. */
+export interface CronField {
+    readonly label: string;
+    readonly min: number;
+    readonly max: number;
+    readonly names: readonly string[];
+}
+//# sourceMappingURL=cron-field.d.ts.map

package/dist/generate/schedule/cron-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-field.d.ts","sourceRoot":"","sources":["../../../src/generate/schedule/cron-field.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC"}

package/dist/generate/schedule/cron-field.js

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

package/dist/generate/schedule/cron-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-field.js","sourceRoot":"","sources":["../../../src/generate/schedule/cron-field.ts"],"names":[],"mappings":""}

package/dist/generate/schedule/cron-problem.d.ts

@@ -0,0 +1,3 @@
+/** Why a text is not a cron expression a job can run on, or undefined. The same judgement as the kernel makes when the job is declared. */
+export declare function cronProblem(expression: string): string | undefined;
+//# sourceMappingURL=cron-problem.d.ts.map

package/dist/generate/schedule/cron-problem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-problem.d.ts","sourceRoot":"","sources":["../../../src/generate/schedule/cron-problem.ts"],"names":[],"mappings":"AAiBA,2IAA2I;AAC3I,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBlE"}

package/dist/generate/schedule/cron-problem.js

@@ -0,0 +1,41 @@
+import { cronFieldValues } from './cron-field-values.js';
+const MONTH_NAMES = ['jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug', 'sep', 'oct', 'nov', 'dec'];
+const DAY_NAMES = ['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'];
+/** Minute, hour, day of month, month, day of week: the five standard fields, in order. */
+const FIELDS = [
+    { label: 'minute', min: 0, max: 59, names: [] },
+    { label: 'hour', min: 0, max: 23, names: [] },
+    { label: 'day of month', min: 1, max: 31, names: [] },
+    { label: 'month', min: 1, max: 12, names: MONTH_NAMES },
+    { label: 'day of week', min: 0, max: 7, names: DAY_NAMES },
+];
+const LONGEST_MONTH = [31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+/** Why a text is not a cron expression a job can run on, or undefined. The same judgement as the kernel makes when the job is declared. */
+export function cronProblem(expression) {
+    const texts = expression.trim().split(/\s+/);
+    if (texts.length !== FIELDS.length) {
+        return `Cron "${expression}" has ${texts.length} field(s): five are expected (minute, hour, day of month, month, day of week).`;
+    }
+    const values = FIELDS.map((field, index) => cronFieldValues(texts[index] ?? '', field));
+    const unreadable = values.indexOf(undefined);
+    if (unreadable !== -1) {
+        return unreadableField(texts[unreadable] ?? '', FIELDS[unreadable]);
+    }
+    return neverFires(texts, values)
+        ? `Cron "${texts.join(' ')}" never fires: none of its months has such a day.`
+        : undefined;
+}
+function unreadableField(text, field) {
+    const names = field === undefined || field.names.length === 0 ? '' : ` or a name (${field.names.join(', ')})`;
+    return `"${text}" is not a ${field?.label ?? 'field'} of a cron expression: write *, a value from ${field?.min ?? 0} to ${field?.max ?? 0}${names}, a range a-b, a step */n or a-b/n, or a list of those.`;
+}
+/** The expression no date satisfies, such as the 31st of February: a day of month given alone, later than every month it names lasts. */
+function neverFires(texts, values) {
+    const [, , dayOfMonth = '', , dayOfWeek = ''] = texts;
+    const [, , days, months] = values;
+    if (dayOfMonth.startsWith('*') || !dayOfWeek.startsWith('*')) {
+        return false;
+    }
+    return !(months ?? []).some((month) => ((days ?? [])[0] ?? 1) <= (LONGEST_MONTH[month - 1] ?? 0));
+}
+//# sourceMappingURL=cron-problem.js.map

package/dist/generate/schedule/cron-problem.js.map

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

package/dist/generate/schedule/duration-problem.d.ts

@@ -0,0 +1,3 @@
+/** Why a text is not an interval of a job, or undefined: a positive whole number of milliseconds, or `30s`, `15m`, `2h`, `1d`. */
+export declare function durationProblem(text: string): string | undefined;
+//# sourceMappingURL=duration-problem.d.ts.map

package/dist/generate/schedule/duration-problem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration-problem.d.ts","sourceRoot":"","sources":["../../../src/generate/schedule/duration-problem.ts"],"names":[],"mappings":"AAGA,kIAAkI;AAClI,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYhE"}

package/dist/generate/schedule/duration-problem.js

@@ -0,0 +1,14 @@
+const UNIT_MS = { ms: 1, s: 1_000, m: 60_000, h: 3_600_000, d: 86_400_000 };
+const DURATION = /^(\d+)(ms|s|m|h|d)$/;
+/** Why a text is not an interval of a job, or undefined: a positive whole number of milliseconds, or `30s`, `15m`, `2h`, `1d`. */
+export function durationProblem(text) {
+    const [, amount, unit] = DURATION.exec(text.trim()) ?? [];
+    const ms = /^\d+$/.test(text.trim())
+        ? Number(text)
+        : Number(amount ?? Number.NaN) * (UNIT_MS[unit ?? ''] ?? Number.NaN);
+    if (Number.isSafeInteger(ms) && ms > 0) {
+        return undefined;
+    }
+    return `"${text}" is not a duration: write a positive whole number of milliseconds, or a text such as 30s, 15m, 2h, 1d.`;
+}
+//# sourceMappingURL=duration-problem.js.map

package/dist/generate/schedule/duration-problem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration-problem.js","sourceRoot":"","sources":["../../../src/generate/schedule/duration-problem.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAqC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC;AAC9G,MAAM,QAAQ,GAAG,qBAAqB,CAAC;AAEvC,kIAAkI;AAClI,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IAE1D,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QACd,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;IAEvE,IAAI,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,IAAI,yGAAyG,CAAC;AAC3H,CAAC"}

package/dist/generate/schedule/job-schedule-problem.d.ts

@@ -0,0 +1,7 @@
+import type { JobSchedule } from './job-schedule.js';
+/**
+ * Why a schedule cannot be written in a job, or undefined. The CLI has no dependency, so this is
+ * the judgement of `parseJobSchedule` of the kernel written again; a test holds the two together.
+ */
+export declare function jobScheduleProblem({ every, cron, timeZone }: JobSchedule): string | undefined;
+//# sourceMappingURL=job-schedule-problem.d.ts.map

package/dist/generate/schedule/job-schedule-problem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-schedule-problem.d.ts","sourceRoot":"","sources":["../../../src/generate/schedule/job-schedule-problem.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAU7F"}

package/dist/generate/schedule/job-schedule-problem.js

@@ -0,0 +1,25 @@
+import { cronProblem } from './cron-problem.js';
+import { durationProblem } from './duration-problem.js';
+/**
+ * Why a schedule cannot be written in a job, or undefined. The CLI has no dependency, so this is
+ * the judgement of `parseJobSchedule` of the kernel written again; a test holds the two together.
+ */
+export function jobScheduleProblem({ every, cron, timeZone }) {
+    if (every !== undefined) {
+        return durationProblem(every);
+    }
+    if (cron === undefined) {
+        return 'A schedule is an interval or a cron expression.';
+    }
+    return cronProblem(cron) ?? timeZoneProblem(timeZone ?? 'UTC');
+}
+function timeZoneProblem(timeZone) {
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone });
+        return undefined;
+    }
+    catch {
+        return `"${timeZone}" is not a time zone this runtime knows: write an IANA name such as Europe/Paris.`;
+    }
+}
+//# sourceMappingURL=job-schedule-problem.js.map

package/dist/generate/schedule/job-schedule-problem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-schedule-problem.js","sourceRoot":"","sources":["../../../src/generate/schedule/job-schedule-problem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAe;IACvE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,iDAAiD,CAAC;IAC3D,CAAC;IAED,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE/C,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,QAAQ,mFAAmF,CAAC;IACzG,CAAC;AACH,CAAC"}

package/dist/generate/schedule/job-schedule.d.ts

@@ -0,0 +1,7 @@
+/** The schedule of a job as the flags of `generate job` give it: `--every`, or `--cron` and `--time-zone`. */
+export interface JobSchedule {
+    readonly every?: string;
+    readonly cron?: string;
+    readonly timeZone?: string;
+}
+//# sourceMappingURL=job-schedule.d.ts.map

package/dist/generate/schedule/job-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-schedule.d.ts","sourceRoot":"","sources":["../../../src/generate/schedule/job-schedule.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/dist/generate/schedule/job-schedule.js

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

package/dist/generate/schedule/job-schedule.js.map

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

package/dist/generate/scope.d.ts

@@ -0,0 +1,14 @@
+import type { Config } from '../config/index.js';
+import type { Name } from '../naming/index.js';
+import type { Workspace } from '../workspace/index.js';
+import type { KindFlags } from './kind.js';
+/** What every generator works with: the project, its stack and one bounded context. */
+export interface Scope {
+    readonly ws: Workspace;
+    readonly config: Config;
+    readonly context: Name;
+    /** Directory of the context, relative to the project root. */
+    readonly dir: string;
+    readonly flags: KindFlags;
+}
+//# sourceMappingURL=scope.d.ts.map

package/dist/generate/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/generate/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,uFAAuF;AACvF,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B"}

package/dist/generate/scope.js

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

package/dist/generate/scope.js.map

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