ddd-ts-kit 0.16.1 → 0.18.0

package/README.fr.md

@@ -1,5 +1,5 @@
 [English](README.md) · **Français**
-<!-- translation-of: README.md sha256:eae59eb228d7b41f -->
+<!-- translation-of: README.md sha256:bed804ca4ed40c91 -->
 
 # ddd-ts-kit
 
@@ -200,11 +200,11 @@ export class IssueInvoiceHandler implements CommandHandler<IssueInvoiceCommand>
   ) {}
 
   async execute(command: IssueInvoiceCommand): Promise<string> {
-    const target = Invoice.create(this.ids.next(), this.clock.now());
+    const invoice = Invoice.create(this.ids.next(), this.clock.now());
 
-    await this.invoiceRepository.save(target);
+    await this.invoiceRepository.save(invoice);
 
-    return target.id;
+    return invoice.id;
   }
 }
 ```
@@ -520,10 +520,11 @@ choix sont enregistrés sous `stack` dans la configuration, `docsUi`, `ci` et `l
 | `knip.json` | code mort : les points d'entrée sont `main.ts` et `apps/*/main.ts`, les scripts, les *specs* et les *fakes*, les fichiers de module dans le style explicite, les fichiers de rôle sous discovery (*jobs* et *publishers* compris) |
 | `vitest.config.ts` | projets unitaires et d'intégration, les seuils de couverture lus dans `ddd-ts-kit.config.json` (`governedCoverage`), par contexte et par couche, dans le mode des décorateurs standard `decorators()` de `@ddd-ts-kit/testing/vitest`, qui compile les fichiers contenant un décorateur avec le compilateur du projet (Vitest ne transforme pas les décorateurs standard ; il transforme lui-même les anciens, si bien qu'un projet avec `experimentalDecorators` ne reçoit pas de *plugin*), et sous `--assembly discovery` `server.deps.inline: ['@ddd-ts-kit/di']` |
 | `lefthook.yml`, `commitlint.config.mjs` | *hooks* pre-commit (ESLint, la vérification du format et `check` sur les fichiers indexés, `check --commit-size --staged`, qui ne bloque jamais), pre-push (types, tests unitaires) et commit-msg (`npm run hooks:install`), *commits* conventionnels |
-| `--ci github` | `.github/workflows/ci.yml`, `pr-title.yml`, `.github/dependabot.yml`, `.github/branch-protection.md`, `renovate.json` ; `codeql.yml` avec `--ci-extras codeql` |
+| `--ci github` | `.github/workflows/ci.yml`, `pr-title.yml`, `copilot-setup-steps.yml` (Node et les dépendances, installés avant le démarrage de l'agent cloud de Copilot), `.github/dependabot.yml`, `.github/branch-protection.md`, `renovate.json` ; `codeql.yml` avec `--ci-extras codeql` |
 | `--ci gitlab` | `.gitlab-ci.yml` (les constats d'architecture comme rapport Code Quality au moyen de `check --format gitlab`), `.gitlab/merge-request-settings.md`, `renovate.json` |
-| `README.md`, `CLAUDE.md`, `.claude/rules/*.md` | comment le lancer ; un guide léger (commandes, comment lire moins, la carte des règles, fichiers générés, note sur le compilateur, les *skills* du *plugin* : `/ddd-ts-kit:start`, `glossary`, `use-case`, `document`, `quality-gate`) et les invariants dans sept fichiers de règles, `domain.md`, `application.md`, `published-language.md`, `infrastructure.md`, `presentation.md`, `platform.md` et `tests.md`, chacun délimité par un frontmatter `paths` |
-| `.claude/settings.json` | des permissions seulement : les vérifications et les générateurs s'exécutent sans demander, les fichiers `.env` sont illisibles (`.env.example` reste lisible), les trois documents générés ne sont pas modifiés à la main, `git push`, `npm publish` et toute modification des fichiers qui portent les règles et le *pipeline* (`ddd-ts-kit.config.json`, `eslint.config.mjs`, `biome.json`, `.dependency-cruiser.cjs`, `knip.json`, `lefthook.yml`, `.gitlab-ci.yml`, `.github/workflows/**`, `.claude/settings.json`) demandent d'abord |
+| `README.md`, `AGENTS.md`, `CLAUDE.md`, `.claude/rules/*.md`, `.github/instructions/*.instructions.md` | comment le lancer ; un guide léger dans `AGENTS.md`, que lisent Codex, Copilot et la plupart des agents de code et qu'importe `CLAUDE.md` (commandes, comment lire moins, la carte des règles, fichiers générés, note sur le compilateur, les *skills* du *plugin* : `/ddd-ts-kit:start`, `glossary`, `use-case`, `document`, `quality-gate`) et les invariants dans sept fichiers de règles, `domain.md`, `application.md`, `published-language.md`, `infrastructure.md`, `presentation.md`, `platform.md` et `tests.md`, chacun délimité par un frontmatter `paths`, et les mêmes sept pour GitHub Copilot, chacun délimité par `applyTo` |
+| `.github/copilot/settings.json` | le *plugin* du kit, déclaré pour GitHub Copilot (`extraKnownMarketplaces`, `enabledPlugins`) : son agent cloud l'installe, la CLI Copilot et VS Code le recommandent ; un fichier existant garde ce qu'il contient et reçoit les deux entrées |
+| `.claude/settings.json` | des permissions seulement : les vérifications et les générateurs s'exécutent sans demander, les fichiers `.env` sont illisibles (`.env.example` reste lisible), les trois documents générés ne sont pas modifiés à la main, `git push`, `npm publish` et toute modification des fichiers qui portent les règles et le *pipeline* (`ddd-ts-kit.config.json`, `eslint.config.mjs`, `biome.json`, `.dependency-cruiser.cjs`, `knip.json`, `lefthook.yml`, `.gitlab-ci.yml`, `.github/workflows/**`, `.claude/settings.json`, `.github/copilot/settings.json`) demandent d'abord |
 | `.gitignore` | `node_modules`, `dist`, `coverage`, `.env`, `*.tsbuildinfo` et `.ddd-ts-kit/`, où écrit `worker-scope` |
 
 `--ci both` écrit les deux *pipelines*, `--ci none` aucun (et pas de `renovate.json`). Les
@@ -678,7 +679,7 @@ Next, in this order: the language of the context first, then the business decisi
   avec `@Repository(<UseCase>Reader)` ; `integration-handler` écrit
   `@IntegrationEventHandler(definition, { consumer })` et est refusé quand l'amont ne déclare pas
   l'événement ; `event-handler` et le *publisher* de `integration-event` écrivent
-  `@DomainEventHandler(Event, { name })` (le *publisher* avec
+  `@DomainEventHandler(Event)`, rattaché au `eventName` que déclare la classe d'événement (le *publisher* avec
   `[IntegrationEventPublisher, IdGenerator]`), et tous deux sont trouvés comme n'importe quel
   fichier de rôle : la racine de composition ne liste aucun *publisher* ; `job` écrit
   `@Scheduled('<context>.<name>', schedule)` ; `policy` écrit une classe avec
@@ -1107,7 +1108,8 @@ est utilisée quand le clone l'a). Chaque chemin modifié atteint quelque chose
   puisque leur code peut lire son langage publié ; un chemin sous son seul `test/` atteint ce
   contexte seul, puisqu'aucun autre contexte ne peut importer ses tests ;
 - un document n'atteint rien qui s'exécute : un fichier Markdown à la racine, tout ce qui est
-  sous `docs/`, `openapi/` ou `.claude/` (la porte des documents tourne toujours) ;
+  sous `docs/`, `openapi/`, `.claude/`, `.github/instructions/` ou `.github/copilot/` (la porte des
+  documents tourne toujours) ;
 - tout le reste atteint tout : la plateforme, le noyau partagé, `main.ts`, la configuration, le
   lockfile, le *pipeline*, un répertoire de `src/contexts/` que la configuration ne déclare pas.
 
@@ -1258,6 +1260,7 @@ règle.
 | `naming/suffix` | un fichier sans le suffixe de son rôle, ou pas en kebab-case. `application/scheduling/` contient des `*.job.ts` ; un dossier de cas d'usage accepte un `*.result.ts` à côté de son message et de son gestionnaire ; `presentation/http/<context>.routes.ts`, nommé d'après son contexte au lieu d'un rôle, est accepté dans les deux styles |
 | `naming/one-concept-per-file` | plusieurs classes exportées dans un fichier d'agrégat, d'entité, d'objet-valeur, d'événement, de commande, de requête, de gestionnaire, de gestionnaire d'événement, de gestionnaire d'événement d'intégration ou de *job* ; dans le style déclaré, plusieurs classes portant un décorateur de déclaration dans un même fichier de rôle |
 | `naming/search-not-list` | dans un contexte, une méthode nommée `list` ou `list<Something>` dans un port (`domain/repositories/*.repository.ts`, `application/ports/*.port.ts`), dans une classe de `infrastructure/` ou dans un *fake* de `test/fakes/` ; sous `application/queries/`, un dossier ou un fichier nommé `list`, `list-...` ou `list....`, ou une classe nommée `List` ou `List<Something>`. Les propriétés et `listAccessible` (exigée par le port `Authorizer`) ne sont pas jugées. Nommez-les `search...` : `generate query <context> Search<Things> --search` |
+| `naming/business-name` | dans `domain/` et `application/` d'un contexte et dans le noyau partagé hors de `presentation/`, une variable, une variable de boucle, un nom déstructuré, un paramètre ou une propriété nommés d'un mot générique (`target`, `data`, `item` et les autres mots de la liste, que `businessNames` de la configuration change) ; le correctif nomme le concept qu'un initialiseur construit ou lit quand le texte le dit, et `npx eslint --fix` le renomme |
 | `test/spec-required` | un agrégat, un objet-valeur, un service du domaine, un gestionnaire, un gestionnaire d'événement du domaine, un gestionnaire d'événement d'intégration ou un *job* sans *spec* (un `*.result.ts` n'en a pas besoin) |
 | `test/no-mocks` | `vi.mock`, `vi.fn`, `vi.spyOn`, leurs jumeaux `jest`, ou une bibliothèque de *mocks* dans les tests d'un contexte |
 | `test/builder-required` | un agrégat sans `test/builders/<name>.builder.ts` |
@@ -1305,7 +1308,7 @@ règle.
 | `event-sourcing/upcaster-required` | un `defineStoredEvent` dont `encode` ne nomme aucun type, ou un type non déclaré dans le fichier, ou un type qu'il atteint et que le fichier ne déclare pas ; une version au-dessus de 1 sans *upcaster* depuis chaque version inférieure ; une version en dessous de la dernière enregistrée dans `stored-events.lock.json`, ou une version enregistrée dont la forme a changé. `ddd-ts-kit docs --stored-events` enregistre les nouvelles versions et n'en réécrit jamais une ; `docs --check` échoue tant qu'une version déclarée n'est pas enregistrée |
 | `context/extractable` | un fichier de module qui importe un autre contexte hors de son langage publié ; une persistance qui importe l'infrastructure d'un autre contexte ou nomme son schéma ; un gestionnaire qui importe le *repository* d'un autre contexte ; `export let` ou un `new Map`, `Set`, `WeakMap` exporté au niveau du module ; `deployable: true` sans `apps/<context>/main.ts` ; dans le style déclaré, un fichier de rôle qui importe quoi que ce soit d'un fichier de port d'un autre contexte |
 | `governance/recorded-deviation` | un commentaire `ddd-ts-kit-disable` ou `eslint-disable` dont la raison ne nomme aucun `ADR-<number>` avec un fichier `docs/adr/<number>-*.md` ; une règle mise à `off` (ou à `warn` en dessous de sa valeur par défaut), un répertoire supplémentaire, un *package* autorisé supplémentaire, un `guard` autre que `enforce` ou `stack.events` hors de l'outbox, sans entrée `deviations` `{ what, adr, reason }` qui pointe vers un enregistrement existant |
-| `declarations/role-declared` | style déclaré seulement : un fichier de rôle (autre que `*.command.ts` et `*.query.ts`, tenus par `authz/declared` ; `*.job.ts` sous `application/scheduling/` avec `@Scheduled` et `*.publisher.ts` avec `@DomainEventHandler` sont des rôles) qui n'exporte aucune classe portant le décorateur de son suffixe et de son dossier, ou une classe qui en porte une autre ; une classe déclarée dans un fichier qui n'est pas un fichier de rôle ; une option `consumer` ou `name` manquante, vide, une variable, une concaténation ou un template literal avec une substitution ; un nom de `@DomainEventHandler` qui diffère du littéral `name` de la classe d'événement importée ; tout décorateur de déclaration sur une classe sous `domain/` |
+| `declarations/role-declared` | style déclaré seulement : un fichier de rôle (autre que `*.command.ts` et `*.query.ts`, tenus par `authz/declared` ; `*.job.ts` sous `application/scheduling/` avec `@Scheduled` et `*.publisher.ts` avec `@DomainEventHandler` sont des rôles) qui n'exporte aucune classe portant le décorateur de son suffixe et de son dossier, ou une classe qui en porte une autre ; une classe déclarée dans un fichier qui n'est pas un fichier de rôle ; une option `consumer` ou `name` manquante, vide, une variable, une concaténation ou un template literal avec une substitution ; tout décorateur de déclaration sur une classe sous `domain/` |
 | `declarations/barrel-current` | style déclaré seulement : avec `stack.assembly: barrel`, un `<context>.declarations.ts` manquant ou qui diffère d'un `export *` par fichier de rôle trié par chemin, suivi d'un `injected(Class, [Tokens])` par classe dont le constructeur reçoit quelque chose (lu depuis les signatures, avec leurs imports) ; avec `discovery`, un barrel qui existe encore, et un `<context>.dependencies.ts` qui diffère de ces instructions `injected` (son absence est acceptée tant qu'il n'en contiendrait aucune). Le message nomme le fichier de rôle manquant ou la classe dont la liste est périmée. Elle a besoin de l'arbre, c'est pourquoi `check-file` ne l'exécute pas |
 | `declarations/constructor-injection` | style déclaré seulement, dans un fichier de rôle : sur une classe dont le décorateur ne liste rien, un paramètre de constructeur optionnel, qui a une valeur par défaut, est un paramètre du reste ou est déstructuré, n'a pas de type, ou est typé par autre chose qu'un nom de classe (arguments de type mis à part) : une union, une intersection, un tableau, un nom qualifié, un type du langage, une interface, un alias de type, une enum ou une classe non exportée du fichier ou du fichier du projet d'où elle est importée ; une classe qui hérite son constructeur d'une classe que le projet ne sait pas lire. Sous `stack.dependencies: signature`, un décorateur qui porte une liste alors que le constructeur peut être lu : une liste qui le répète, une qui en diffère |
 | `ports/abstract-class` | dans un fichier de port (`domain/repositories/*.repository.ts`, `application/ports/*.port.ts`) : une classe qui n'est pas `abstract` ; un membre qui n'est pas une méthode ou une propriété abstraite (`static readonly tokenKey = '<text>'` mis à part) : un constructeur, un corps, un initialiseur, un membre `private`, `protected` ou `#` ; une `interface` exportée (un alias `type`, une forme de données, n'est pas signalé) |
@@ -1411,11 +1414,7 @@ exactement comme le chemin relatif vers le même fichier.
   et les espaces de noms). Les options `consumer` et `name` ne sont lues que dans un littéral
   d'objet écrit dans l'appel du décorateur : gardées dans une variable, étalées ou construites par
   une fonction, elles sont signalées comme n'étant pas une chaîne littérale.
-- `declarations/role-declared` compare un nom de `@DomainEventHandler` avec `name = '...'` dans
-  le corps de la classe d'événement, trouvée par un import direct relatif ou par alias : un nom
-  posé dans un constructeur, un accesseur ou une classe de base, ou un événement atteint par un
-  barrel, n'est pas comparé. `authz/declared` suit un import direct du message depuis un fichier
-  de module.
+- `authz/declared` suit un import direct du message depuis un fichier de module.
 - `context/extractable` reconnaît un port à son fichier (`domain/repositories/*.repository.ts`,
   `application/ports/*.port.ts`) : un port d'un autre contexte atteint par un réexport n'est pas
   vu.

package/README.md

@@ -188,11 +188,11 @@ export class IssueInvoiceHandler implements CommandHandler<IssueInvoiceCommand>
   ) {}
 
   async execute(command: IssueInvoiceCommand): Promise<string> {
-    const target = Invoice.create(this.ids.next(), this.clock.now());
+    const invoice = Invoice.create(this.ids.next(), this.clock.now());
 
-    await this.invoiceRepository.save(target);
+    await this.invoiceRepository.save(invoice);
 
-    return target.id;
+    return invoice.id;
   }
 }
 ```
@@ -504,10 +504,11 @@ config, `docsUi`, `ci` and `logger` included.
 | `knip.json` | dead code: entry points are `main.ts` and `apps/*/main.ts`, the scripts, the specs and the fakes, the module files in the explicit style, the role files under discovery (jobs and publishers included) |
 | `vitest.config.ts` | unit and integration projects, the coverage thresholds read from `ddd-ts-kit.config.json` (`governedCoverage`), per context and layer, in the standard decorator mode `decorators()` of `@ddd-ts-kit/testing/vitest`, which compiles the files holding a decorator with the compiler of the project (Vitest does not lower standard decorators; it lowers legacy ones itself, so a project with `experimentalDecorators` gets no plugin), and under `--assembly discovery` `server.deps.inline: ['@ddd-ts-kit/di']` |
 | `lefthook.yml`, `commitlint.config.mjs` | pre-commit (ESLint, the format check and `check` on the staged files, `check --commit-size --staged`, which never blocks), pre-push (types, unit tests) and commit-msg hooks (`npm run hooks:install`), conventional commits |
-| `--ci github` | `.github/workflows/ci.yml`, `pr-title.yml`, `.github/dependabot.yml`, `.github/branch-protection.md`, `renovate.json`; `codeql.yml` with `--ci-extras codeql` |
+| `--ci github` | `.github/workflows/ci.yml`, `pr-title.yml`, `copilot-setup-steps.yml` (Node and the dependencies, installed before the Copilot cloud agent starts), `.github/dependabot.yml`, `.github/branch-protection.md`, `renovate.json`; `codeql.yml` with `--ci-extras codeql` |
 | `--ci gitlab` | `.gitlab-ci.yml` (architecture findings as a Code Quality report through `check --format gitlab`), `.gitlab/merge-request-settings.md`, `renovate.json` |
-| `README.md`, `CLAUDE.md`, `.claude/rules/*.md` | how to run it; a slim guide (commands, how to read less, the map of the rules, generated files, compiler note, the skills of the plugin: `/ddd-ts-kit:start`, `glossary`, `use-case`, `document`, `quality-gate`) and the invariants in seven rule files, `domain.md`, `application.md`, `published-language.md`, `infrastructure.md`, `presentation.md`, `platform.md` and `tests.md`, each scoped by a `paths` frontmatter |
-| `.claude/settings.json` | permissions only: the checks and generators run without asking, `.env` files are unreadable (`.env.example` stays readable), the three generated documents are not edited by hand, `git push`, `npm publish` and any edit of the files that hold the rules and the pipeline (`ddd-ts-kit.config.json`, `eslint.config.mjs`, `biome.json`, `.dependency-cruiser.cjs`, `knip.json`, `lefthook.yml`, `.gitlab-ci.yml`, `.github/workflows/**`, `.claude/settings.json`) ask first |
+| `README.md`, `AGENTS.md`, `CLAUDE.md`, `.claude/rules/*.md`, `.github/instructions/*.instructions.md` | how to run it; a slim guide in `AGENTS.md`, which Codex, Copilot and most coding agents read and `CLAUDE.md` imports (commands, how to read less, the map of the rules, generated files, compiler note, the skills of the plugin: `/ddd-ts-kit:start`, `glossary`, `use-case`, `document`, `quality-gate`) and the invariants in seven rule files, `domain.md`, `application.md`, `published-language.md`, `infrastructure.md`, `presentation.md`, `platform.md` and `tests.md`, each scoped by a `paths` frontmatter, and the same seven for GitHub Copilot, each scoped by `applyTo` |
+| `.github/copilot/settings.json` | the plugin of the kit, declared for GitHub Copilot (`extraKnownMarketplaces`, `enabledPlugins`): its cloud agent installs it, the Copilot CLI and VS Code recommend it; an existing file keeps what it holds and gains the two entries |
+| `.claude/settings.json` | permissions only: the checks and generators run without asking, `.env` files are unreadable (`.env.example` stays readable), the three generated documents are not edited by hand, `git push`, `npm publish` and any edit of the files that hold the rules and the pipeline (`ddd-ts-kit.config.json`, `eslint.config.mjs`, `biome.json`, `.dependency-cruiser.cjs`, `knip.json`, `lefthook.yml`, `.gitlab-ci.yml`, `.github/workflows/**`, `.claude/settings.json`, `.github/copilot/settings.json`) ask first |
 | `.gitignore` | `node_modules`, `dist`, `coverage`, `.env`, `*.tsbuildinfo` and `.ddd-ts-kit/`, where `worker-scope` writes |
 
 `--ci both` writes the two pipelines, `--ci none` neither (and no `renovate.json`). The pipeline
@@ -658,7 +659,7 @@ Next, in this order: the language of the context first, then the business decisi
   `@Repository(<UseCase>Reader)`; `integration-handler` writes
   `@IntegrationEventHandler(definition, { consumer })` and is refused when the
   upstream does not declare the event; `event-handler` and the publisher of `integration-event`
-  write `@DomainEventHandler(Event, { name })` (the publisher with
+  write `@DomainEventHandler(Event)`, attached under the `eventName` the event class declares (the publisher with
   `[IntegrationEventPublisher, IdGenerator]`), and both are found like any role file: the
   composition root lists no publisher; `job` writes `@Scheduled('<context>.<name>', schedule)`;
   `policy` writes a class with `@Policy(permission, { name })` and registers nothing; `gateway`
@@ -1056,7 +1057,8 @@ Each changed path reaches something:
   their code may read its published language; a path under its `test/` alone reaches that
   context alone, since no other context may import its tests;
 - a document reaches nothing that runs: a Markdown file at the root, anything under `docs/`,
-  `openapi/` or `.claude/` (the documents gate always runs);
+  `openapi/`, `.claude/`, `.github/instructions/` or `.github/copilot/` (the documents gate
+  always runs);
 - anything else reaches everything: the platform, the shared kernel, `main.ts`, the config, the
   lockfile, the pipeline, a directory of `src/contexts/` the config does not declare.
 
@@ -1201,6 +1203,7 @@ const due = handler.isDueNow(new Reminder(new Date('2026-03-01T09:00:00Z'))); //
 | `naming/suffix` | a file without the suffix of its role, or not in kebab-case. `application/scheduling/` holds `*.job.ts`; a use case folder accepts `*.result.ts` next to its message and its handler; `presentation/http/<context>.routes.ts`, named after its context instead of a role, is accepted in both styles |
 | `naming/one-concept-per-file` | several exported classes in an aggregate, entity, value object, event, command, query, handler, event handler, integration event handler or job file; in the declared style, several classes carrying a declaration decorator in one role file |
 | `naming/search-not-list` | in a context, a method named `list` or `list<Something>` in a port (`domain/repositories/*.repository.ts`, `application/ports/*.port.ts`), in a class of `infrastructure/` or in a fake of `test/fakes/`; under `application/queries/`, a folder or a file named `list`, `list-...` or `list....`, or a class named `List` or `List<Something>`. Properties and `listAccessible` (required by the `Authorizer` port) are not judged. Name them `search...`: `generate query <context> Search<Things> --search` |
+| `naming/business-name` | in `domain/` and `application/` of a context and in the shared kernel outside `presentation/`, a variable, loop variable, destructured binding, parameter or property named with a generic word (`target`, `data`, `item` and the other words of the list, which `businessNames` of the config changes); the fix names the concept an initializer builds or reads when the text says it, and `npx eslint --fix` renames it |
 | `test/spec-required` | an aggregate, value object, domain service, handler, domain event handler, integration event handler or job without a spec (a `*.result.ts` needs none) |
 | `test/no-mocks` | `vi.mock`, `vi.fn`, `vi.spyOn`, their `jest` twins, or a mocking library in a context's tests |
 | `test/builder-required` | an aggregate without `test/builders/<name>.builder.ts` |
@@ -1248,7 +1251,7 @@ const due = handler.isDueNow(new Reminder(new Date('2026-03-01T09:00:00Z'))); //
 | `event-sourcing/upcaster-required` | a `defineStoredEvent` whose `encode` names no type, or a type not declared in the file, or a type it reaches that the file does not declare; a version above 1 without an upcaster from each version below; a version below the last one recorded in `stored-events.lock.json`, or a recorded version whose shape changed. `ddd-ts-kit docs --stored-events` records new versions and never rewrites one; `docs --check` fails while a declared version is unrecorded |
 | `context/extractable` | a module file importing another context outside its published language; persistence importing another context's infrastructure or naming its schema; a handler importing another context's repository; `export let` or an exported `new Map`, `Set`, `WeakMap` at module level; `deployable: true` without `apps/<context>/main.ts`; in the declared style, a role file importing anything of a port file of another context |
 | `governance/recorded-deviation` | a `ddd-ts-kit-disable` or `eslint-disable` comment whose reason names no `ADR-<number>` with a file `docs/adr/<number>-*.md`; a rule set to `off` (or to `warn` below its default), an extra directory, an extra allowed package, a `guard` other than `enforce` or `stack.events` off the outbox, without a `deviations` entry `{ what, adr, reason }` pointing to an existing record |
-| `declarations/role-declared` | declared style only: a role file (other than `*.command.ts` and `*.query.ts`, held by `authz/declared`; `*.job.ts` under `application/scheduling/` with `@Scheduled` and `*.publisher.ts` with `@DomainEventHandler` are roles) exporting no class with the decorator of its suffix and folder, or one carrying another declaration; a declared class in a file that is not a role file; a `consumer` or `name` option that is missing, empty, a variable, a concatenation or a template with a substitution; a `@DomainEventHandler` name that differs from the `name` literal of the imported event class; any declaration decorator on a class under `domain/` |
+| `declarations/role-declared` | declared style only: a role file (other than `*.command.ts` and `*.query.ts`, held by `authz/declared`; `*.job.ts` under `application/scheduling/` with `@Scheduled` and `*.publisher.ts` with `@DomainEventHandler` are roles) exporting no class with the decorator of its suffix and folder, or one carrying another declaration; a declared class in a file that is not a role file; a `consumer` or `name` option that is missing, empty, a variable, a concatenation or a template with a substitution; any declaration decorator on a class under `domain/` |
 | `declarations/barrel-current` | declared style only: with `stack.assembly: barrel`, a missing `<context>.declarations.ts` or one that differs from one `export *` per role file sorted by path followed by one `injected(Class, [Tokens])` per class whose constructor takes something (read from the signatures, with their imports); with `discovery`, a barrel that still exists, and a `<context>.dependencies.ts` that differs from those `injected` statements (absent is accepted while it would hold none). The message names the missing role file or the class whose list is stale. It needs the tree, so `check-file` does not run it |
 | `declarations/constructor-injection` | declared style only, in a role file: on a class whose decorator lists nothing, a constructor parameter that is optional, has a default value, is a rest parameter or is destructured, has no type, or is typed by anything but one class name (type arguments aside): a union, an intersection, an array, a qualified name, a type of the language, an interface, a type alias, an enum or an unexported class of the file or of the file of the project it is imported from; a class that inherits its constructor from a class the project cannot read. Under `stack.dependencies: signature`, a decorator that carries a list although the constructor can be read: one that repeats it, one that differs |
 | `ports/abstract-class` | in a port file (`domain/repositories/*.repository.ts`, `application/ports/*.port.ts`): a class that is not `abstract`; a member that is not an abstract method or property (`static readonly tokenKey = '<text>'` apart): a constructor, a body, an initializer, a `private`, `protected` or `#` member; an exported `interface` (a `type` alias, a data shape, is not reported) |
@@ -1342,10 +1345,7 @@ import is judged by every boundary rule exactly as the relative path to the same
   and namespaces). The `consumer` and `name` options are read only in an object literal written in
   the decorator call: held in a variable, spread or built by a function, they are reported as not
   being a string literal.
-- `declarations/role-declared` compares a `@DomainEventHandler` name with `name = '...'` in the
-  body of the event class, found through a direct relative or alias import: a name set in a
-  constructor, a getter or a base class, or an event reached through a barrel, is not compared.
-  `authz/declared` follows one direct import of the message from a module file.
+- `authz/declared` follows one direct import of the message from a module file.
 - `context/extractable` tells a port by its file (`domain/repositories/*.repository.ts`,
   `application/ports/*.port.ts`): a port of another context reached through a re-export is not seen.
 - `composition/only-in-module` reports every `.include(` of a file importing `@ddd-ts-kit/di`

package/dist/affected/reach-of.js

@@ -1,5 +1,5 @@
 /** Written for people and agents, never loaded by a spec, a build or a tool of the pipeline other than the documents gate, which always runs. */
-const DOCUMENT_DIRECTORIES = ['docs/', 'openapi/', '.claude/'];
+const DOCUMENT_DIRECTORIES = ['docs/', 'openapi/', '.claude/', '.github/instructions/', '.github/copilot/'];
 /**
  * What a changed path, relative to the project root, reaches. A path under a declared context
  * reaches that context; a document reaches nothing; anything else (the shared kernel, the

package/dist/affected/reach-of.js.map

@@ -1 +1 @@
-{"version":3,"file":"reach-of.js","sourceRoot":"","sources":["../../src/affected/reach-of.ts"],"names":[],"mappings":"AAGA,iJAAiJ;AACjJ,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,IAAY;IAClD,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC;IAE1C,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,6BAA6B,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,MAAc,EAAE,MAAc;IAClD,MAAM,CAAC,OAAO,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAElD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;QAChE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,iCAAiC,EAAE,CAAC;IAC1G,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAEnC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;AAClH,CAAC"}
+{"version":3,"file":"reach-of.js","sourceRoot":"","sources":["../../src/affected/reach-of.ts"],"names":[],"mappings":"AAGA,iJAAiJ;AACjJ,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,uBAAuB,EAAE,kBAAkB,CAAC,CAAC;AAE5G;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,IAAY;IAClD,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC;IAE1C,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,6BAA6B,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,MAAc,EAAE,MAAc;IAClD,MAAM,CAAC,OAAO,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAElD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;QAChE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,iCAAiC,EAAE,CAAC;IAC1G,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAEnC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;AAClH,CAAC"}

package/dist/check/business-names/closing-parenthesis.d.ts

@@ -0,0 +1,3 @@
+/** Offset of the `)` that closes a parenthesis opened before `from`, or the end of the text. */
+export declare function closingParenthesis(text: string, from: number): number;
+//# sourceMappingURL=closing-parenthesis.d.ts.map

package/dist/check/business-names/closing-parenthesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closing-parenthesis.d.ts","sourceRoot":"","sources":["../../../src/check/business-names/closing-parenthesis.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAcrE"}

package/dist/check/business-names/closing-parenthesis.js

@@ -0,0 +1,16 @@
+import { BRACKETS } from '../text/brackets.js';
+/** Offset of the `)` that closes a parenthesis opened before `from`, or the end of the text. */
+export function closingParenthesis(text, from) {
+    let depth = 0;
+    for (let i = from; i < text.length; i += 1) {
+        const char = text.charAt(i);
+        if (BRACKETS.openers.includes(char)) {
+            depth += 1;
+        }
+        else if (BRACKETS.closers.includes(char) && (depth -= 1) < 0) {
+            return i;
+        }
+    }
+    return text.length;
+}
+//# sourceMappingURL=closing-parenthesis.js.map

package/dist/check/business-names/closing-parenthesis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closing-parenthesis.js","sourceRoot":"","sources":["../../../src/check/business-names/closing-parenthesis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,gGAAgG;AAChG,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,IAAY;IAC3D,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAE5B,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/D,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC"}

package/dist/check/business-names/declared-bindings.d.ts

@@ -0,0 +1,4 @@
+import type { NamedBinding } from './named-binding.js';
+/** The variables a source declares with `const`, `let` or `var`, loop variables and destructured names included. */
+export declare function declaredBindings(code: string): NamedBinding[];
+//# sourceMappingURL=declared-bindings.d.ts.map

package/dist/check/business-names/declared-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declared-bindings.d.ts","sourceRoot":"","sources":["../../../src/check/business-names/declared-bindings.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQvD,oHAAoH;AACpH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAkB7D"}

package/dist/check/business-names/declared-bindings.js

@@ -0,0 +1,41 @@
+import { statementEnd } from '../text/statement-end.js';
+import { closingParenthesis } from './closing-parenthesis.js';
+import { identifierAt } from './identifier-at.js';
+import { patternBindings } from './pattern-bindings.js';
+import { topLevelSeparator } from './top-level-separator.js';
+const DECLARATION = /(?<![\w$.])(?:const|let|var)\s+(?=[A-Za-z_$[{])/g;
+const OPENS_A_LOOP = /(?<![\w$.])for\s*(?:await\s*)?\(\s*$/;
+const WALKS = /^\s+(?:of|in)\s+/;
+/** The variables a source declares with `const`, `let` or `var`, loop variables and destructured names included. */
+export function declaredBindings(code) {
+    return [...code.matchAll(DECLARATION)].flatMap((match) => {
+        const at = match.index + match[0].length;
+        const opener = code.charAt(at);
+        if (opener === '{' || opener === '[') {
+            return patternBindings(code, at);
+        }
+        const name = identifierAt(code, at);
+        const after = at + name.length;
+        if (OPENS_A_LOOP.test(code.slice(Math.max(0, match.index - 20), match.index))) {
+            return [{ name, offset: at, kind: 'loop variable', source: walkedCollection(code, after) }];
+        }
+        return [{ name, offset: at, kind: 'variable', source: initializer(code, after) }];
+    });
+}
+/** `due` in `for (const target of due)`. */
+function walkedCollection(code, from) {
+    const rest = code.slice(from, from + 400);
+    const walks = WALKS.exec(rest);
+    if (walks === null) {
+        return '';
+    }
+    const start = walks[0].length;
+    return rest.slice(start, closingParenthesis(rest, start)).trim();
+}
+/** What follows the `=` of a declaration, its type annotation skipped. */
+function initializer(code, from) {
+    const declared = code.slice(from, statementEnd(code, from));
+    const equals = topLevelSeparator(declared, '=');
+    return equals === -1 ? '' : declared.slice(equals + 1).trim();
+}
+//# sourceMappingURL=declared-bindings.js.map

package/dist/check/business-names/declared-bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declared-bindings.js","sourceRoot":"","sources":["../../../src/check/business-names/declared-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,WAAW,GAAG,kDAAkD,CAAC;AACvE,MAAM,YAAY,GAAG,sCAAsC,CAAC;AAC5D,MAAM,KAAK,GAAG,kBAAkB,CAAC;AAEjC,oHAAoH;AACpH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvD,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAE/B,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACrC,OAAO,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAE/B,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC9E,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,4CAA4C;AAC5C,SAAS,gBAAgB,CAAC,IAAY,EAAE,IAAY;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAE9B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACnE,CAAC;AAED,0EAA0E;AAC1E,SAAS,WAAW,CAAC,IAAY,EAAE,IAAY;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAEhD,OAAO,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAChE,CAAC"}

package/dist/check/business-names/generic-words-of.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from '../../config/index.js';
+/** The words of the rule for a project: `businessNames.words` in place of the defaults, less `businessNames.allow`. */
+export declare function genericWordsOf(config: Config): ReadonlySet<string>;
+//# sourceMappingURL=generic-words-of.d.ts.map

package/dist/check/business-names/generic-words-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-words-of.d.ts","sourceRoot":"","sources":["../../../src/check/business-names/generic-words-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,uHAAuH;AACvH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAIlE"}

package/dist/check/business-names/generic-words-of.js

@@ -0,0 +1,7 @@
+import { GENERIC_WORDS } from './generic-words.js';
+/** The words of the rule for a project: `businessNames.words` in place of the defaults, less `businessNames.allow`. */
+export function genericWordsOf(config) {
+    const { words, allow } = config.businessNames;
+    return new Set((words ?? GENERIC_WORDS).filter((word) => !allow.includes(word)));
+}
+//# sourceMappingURL=generic-words-of.js.map

package/dist/check/business-names/generic-words-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-words-of.js","sourceRoot":"","sources":["../../../src/check/business-names/generic-words-of.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,uHAAuH;AACvH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,aAAa,CAAC;IAE9C,OAAO,IAAI,GAAG,CAAC,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACnF,CAAC"}

package/dist/check/business-names/generic-words.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Words that say a value is there without saying which concept it is. `naming/business-name`
+ * reports a binding named by one of them where the model speaks; the same list as the ESLint
+ * plugin.
+ */
+export declare const GENERIC_WORDS: readonly string[];
+//# sourceMappingURL=generic-words.d.ts.map

package/dist/check/business-names/generic-words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-words.d.ts","sourceRoot":"","sources":["../../../src/check/business-names/generic-words.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAmB1C,CAAC"}

package/dist/check/business-names/generic-words.js

@@ -0,0 +1,26 @@
+/**
+ * Words that say a value is there without saying which concept it is. `naming/business-name`
+ * reports a binding named by one of them where the model speaks; the same list as the ESLint
+ * plugin.
+ */
+export const GENERIC_WORDS = [
+    'target',
+    'targets',
+    'data',
+    'item',
+    'items',
+    'obj',
+    'object',
+    'thing',
+    'things',
+    'stuff',
+    'info',
+    'element',
+    'el',
+    'tmp',
+    'temp',
+    'foo',
+    'bar',
+    'baz',
+];
+//# sourceMappingURL=generic-words.js.map

package/dist/check/business-names/generic-words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-words.js","sourceRoot":"","sources":["../../../src/check/business-names/generic-words.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,QAAQ;IACR,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,OAAO;IACP,MAAM;IACN,SAAS;IACT,IAAI;IACJ,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;CACN,CAAC"}

package/dist/check/business-names/identifier-at.d.ts

@@ -0,0 +1,3 @@
+/** The identifier that starts at `offset`, or an empty text. */
+export declare function identifierAt(code: string, offset: number): string;
+//# sourceMappingURL=identifier-at.d.ts.map

package/dist/check/business-names/identifier-at.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier-at.d.ts","sourceRoot":"","sources":["../../../src/check/business-names/identifier-at.ts"],"names":[],"mappings":"AAEA,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/check/business-names/identifier-at.js

@@ -0,0 +1,6 @@
+const NAME = /^[A-Za-z_$][\w$]*/;
+/** The identifier that starts at `offset`, or an empty text. */
+export function identifierAt(code, offset) {
+    return NAME.exec(code.slice(offset, offset + 200))?.[0] ?? '';
+}
+//# sourceMappingURL=identifier-at.js.map

package/dist/check/business-names/identifier-at.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier-at.js","sourceRoot":"","sources":["../../../src/check/business-names/identifier-at.ts"],"names":[],"mappings":"AAAA,MAAM,IAAI,GAAG,mBAAmB,CAAC;AAEjC,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,MAAc;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAChE,CAAC"}

package/dist/check/business-names/judges-names.d.ts

@@ -0,0 +1,7 @@
+import type { SourceFile } from '../model/source-file.js';
+/**
+ * Where the language of the model lives: `domain/` and `application/` of a context, and the
+ * shared kernel outside its `presentation/`. Specs are not judged. Same table as the ESLint plugin.
+ */
+export declare function judgesNames(file: SourceFile, sharedKernelDir: string): boolean;
+//# sourceMappingURL=judges-names.d.ts.map

package/dist/check/business-names/judges-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"judges-names.d.ts","sourceRoot":"","sources":["../../../src/check/business-names/judges-names.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAU9E"}

package/dist/check/business-names/judges-names.js

@@ -0,0 +1,14 @@
+/**
+ * Where the language of the model lives: `domain/` and `application/` of a context, and the
+ * shared kernel outside its `presentation/`. Specs are not judged. Same table as the ESLint plugin.
+ */
+export function judgesNames(file, sharedKernelDir) {
+    if (file.isTest) {
+        return false;
+    }
+    if (file.location.area === 'context') {
+        return file.location.layer === 'domain' || file.location.layer === 'application';
+    }
+    return file.location.area === 'shared-kernel' && !file.path.startsWith(`${sharedKernelDir}/presentation/`);
+}
+//# sourceMappingURL=judges-names.js.map

package/dist/check/business-names/judges-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"judges-names.js","sourceRoot":"","sources":["../../../src/check/business-names/judges-names.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,eAAuB;IACnE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,aAAa,CAAC;IACnF,CAAC;IAED,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,eAAe,gBAAgB,CAAC,CAAC;AAC7G,CAAC"}

package/dist/check/business-names/named-binding.d.ts

@@ -0,0 +1,12 @@
+/** What a binding names: the reader of a message needs to know which one it is. */
+type BindingKind = 'variable' | 'loop variable' | 'destructured binding' | 'parameter' | 'property';
+/** A name a source gives to something, where it is written and, when it says what it holds, what it is given. */
+export interface NamedBinding {
+    readonly name: string;
+    readonly offset: number;
+    readonly kind: BindingKind;
+    /** The initializer of a variable, or the collection a loop variable walks through. */
+    readonly source?: string;
+}
+export {};
+//# sourceMappingURL=named-binding.d.ts.map

package/dist/check/business-names/named-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-binding.d.ts","sourceRoot":"","sources":["../../../src/check/business-names/named-binding.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,KAAK,WAAW,GAAG,UAAU,GAAG,eAAe,GAAG,sBAAsB,GAAG,WAAW,GAAG,UAAU,CAAC;AAEpG,iHAAiH;AACjH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/check/business-names/named-binding.js

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

package/dist/check/business-names/named-binding.js.map

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

package/dist/check/business-names/named-bindings.d.ts

@@ -0,0 +1,4 @@
+import type { NamedBinding } from './named-binding.js';
+/** Every name a blanked source binds: variables, loop variables, destructured names, parameters and properties. */
+export declare function namedBindings(code: string): NamedBinding[];
+//# sourceMappingURL=named-bindings.d.ts.map

package/dist/check/business-names/named-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-bindings.d.ts","sourceRoot":"","sources":["../../../src/check/business-names/named-bindings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,mHAAmH;AACnH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAI1D"}

package/dist/check/business-names/named-bindings.js

@@ -0,0 +1,8 @@
+import { declaredBindings } from './declared-bindings.js';
+import { parameterBindings } from './parameter-bindings.js';
+import { propertyBindings } from './property-bindings.js';
+/** Every name a blanked source binds: variables, loop variables, destructured names, parameters and properties. */
+export function namedBindings(code) {
+    return [...declaredBindings(code), ...parameterBindings(code), ...propertyBindings(code)].sort((left, right) => left.offset - right.offset);
+}
+//# sourceMappingURL=named-bindings.js.map

package/dist/check/business-names/named-bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-bindings.js","sourceRoot":"","sources":["../../../src/check/business-names/named-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,mHAAmH;AACnH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAC5F,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAC5C,CAAC;AACJ,CAAC"}

package/dist/check/business-names/opening-bracket.d.ts

@@ -0,0 +1,3 @@
+/** Offset of the bracket opening the one that closes at `close`, read backwards, or -1. */
+export declare function openingBracket(code: string, close: number): number;
+//# sourceMappingURL=opening-bracket.d.ts.map

package/dist/check/business-names/opening-bracket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opening-bracket.d.ts","sourceRoot":"","sources":["../../../src/check/business-names/opening-bracket.ts"],"names":[],"mappings":"AAEA,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAclE"}

package/dist/check/business-names/opening-bracket.js

@@ -0,0 +1,16 @@
+import { BRACKETS } from '../text/brackets.js';
+/** Offset of the bracket opening the one that closes at `close`, read backwards, or -1. */
+export function openingBracket(code, close) {
+    let depth = 0;
+    for (let i = close; i >= 0; i -= 1) {
+        const char = code.charAt(i);
+        if (BRACKETS.closers.includes(char)) {
+            depth += 1;
+        }
+        else if (BRACKETS.openers.includes(char) && (depth -= 1) === 0) {
+            return i;
+        }
+    }
+    return -1;
+}
+//# sourceMappingURL=opening-bracket.js.map

package/dist/check/business-names/opening-bracket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opening-bracket.js","sourceRoot":"","sources":["../../../src/check/business-names/opening-bracket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,2FAA2F;AAC3F,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAa;IACxD,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAE5B,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACjE,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC"}

package/dist/check/business-names/parameter-bindings.d.ts

@@ -0,0 +1,4 @@
+import type { NamedBinding } from './named-binding.js';
+/** The parameters of every function, method, signature and arrow of a source; a parameter property is a property. */
+export declare function parameterBindings(code: string): NamedBinding[];
+//# sourceMappingURL=parameter-bindings.d.ts.map

package/dist/check/business-names/parameter-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-bindings.d.ts","sourceRoot":"","sources":["../../../src/check/business-names/parameter-bindings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD,qHAAqH;AACrH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAU9D"}

package/dist/check/business-names/parameter-bindings.js

@@ -0,0 +1,28 @@
+import { splitTopLevel } from '../text/split-top-level.js';
+import { identifierAt } from './identifier-at.js';
+import { parameterLists } from './parameter-lists.js';
+import { patternBindings } from './pattern-bindings.js';
+const MODIFIERS = /^(?:(?:public|private|protected|readonly|override)\s+)+/;
+/** The parameters of every function, method, signature and arrow of a source; a parameter property is a property. */
+export function parameterBindings(code) {
+    return parameterLists(code).flatMap((list) => {
+        if ('single' in list) {
+            return [{ name: identifierAt(code, list.single), offset: list.single, kind: 'parameter' }];
+        }
+        return splitTopLevel(code.slice(list.open + 1, list.close)).flatMap((part) => parameter(code, list.open + 1 + part.start, part.code));
+    });
+}
+function parameter(code, start, text) {
+    const modifiers = MODIFIERS.exec(text)?.[0].length ?? 0;
+    const at = start + modifiers + (text.startsWith('...', modifiers) ? 3 : 0);
+    const opener = code.charAt(at);
+    if (opener === '{' || opener === '[') {
+        return patternBindings(code, at);
+    }
+    const name = identifierAt(code, at);
+    if (name === '' || name === 'this') {
+        return [];
+    }
+    return [{ name, offset: at, kind: modifiers > 0 ? 'property' : 'parameter' }];
+}
+//# sourceMappingURL=parameter-bindings.js.map

package/dist/check/business-names/parameter-bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-bindings.js","sourceRoot":"","sources":["../../../src/check/business-names/parameter-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,SAAS,GAAG,yDAAyD,CAAC;AAE5E,qHAAqH;AACrH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3C,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,WAAoB,EAAE,CAAC,CAAC;QACtG,CAAC;QAED,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3E,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CACvD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,IAAY;IAC1D,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,KAAK,GAAG,SAAS,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAE/B,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACrC,OAAO,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAEpC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACnC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAChF,CAAC"}

package/dist/check/business-names/parameter-lists.d.ts

@@ -0,0 +1,14 @@
+/** A parameter list, by the offsets of its parentheses, or the one parameter of `name =>`. */
+export type ParameterList = {
+    readonly open: number;
+    readonly close: number;
+} | {
+    readonly single: number;
+};
+/**
+ * The parameter lists of a blanked source: functions, methods and signatures of classes,
+ * interfaces and object literals (a body or a return type follows their parentheses, which tells
+ * them from a call), arrows, and the function types of annotations.
+ */
+export declare function parameterLists(code: string): ParameterList[];
+//# sourceMappingURL=parameter-lists.d.ts.map

package/dist/check/business-names/parameter-lists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-lists.d.ts","sourceRoot":"","sources":["../../../src/check/business-names/parameter-lists.ts"],"names":[],"mappings":"AAGA,8FAA8F;AAC9F,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAkC5G;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAmB5D"}