@conformetry/configuration 0.0.4 → 0.0.6

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+## 0.0.6 (2026-10-08)
+
+### 🚀 Features
+
+- **conformetry,lexico:** ✨ add frontend conformetry templates and infer validation inputs ([#1301](https://github.com/organizzolini/codebase/pull/1301))
+
+### 🧱 Updated Dependencies
+
+- Updated conformetry-core to 0.0.6
+
+## 0.0.5 (2026-10-06)
+
+### 💅 Refactors
+
+- **ic-suite:** ♻️ rename @codebase/logger to @codebase/logging ([#1208](https://github.com/organizzolini/codebase/pull/1208))
+
+### 🧱 Updated Dependencies
+
+- Updated conformetry-core to 0.0.5

package/README.md

@@ -1,5 +1,7 @@
 # 👔 Conformetry Configuration
 
+[![npm](https://img.shields.io/npm/v/@conformetry/configuration?logo=npm&label=npm)](https://www.npmjs.com/package/@conformetry/configuration)
+
 **The configuration reference for [Conformetry](../conformetry-cli/README.md).**
 
 `@conformetry/configuration` reads a repository's `conformetry.config.*`, checks
@@ -96,6 +98,7 @@ instances: [
 
 | Field | Purpose |
 | ----- | ------- |
+| `exclude` | Workspace-relative globs naming paths that are never instances, applied with or without `tags` |
 | `patterns` | Globs locating this group's instances, workspace-relative |
 | `substitutions` | Values the template's placeholders are rendered with for this group |
 | `tags` | Labels selecting which hosts the group applies to, carried uninterpreted |
@@ -105,12 +108,23 @@ Groups exist so substitutions can differ per glob. `type` is `packages` for one
 set of paths and `applications` for another, and no generic rule can tell them
 apart.
 
-> **Every placeholder a template uses must be supplied here.** A missing entry
-> fails the run with `MissingSubstitutionError` rather than rendering as an
-> empty string — see
-> [`@conformetry/generation`](../conformetry-generation/README.md) for why that
-> is an error and not a finding, and for the section syntax a template uses to
-> make a placeholder genuinely optional.
+> **A placeholder these substitutions leave out is read from the instance.**
+> Validation renders a random stand-in for it, captures the text the instance
+> holds where the template's first use of it aligns, renders the template again
+> with that text, and compares as usual — so a later use holding different text
+> is an ordinary difference. When nothing aligns, the instance fails with
+> `Could not infer {{…}}`. `name` and its variants always come from the
+> instance path, and a value supplied here always wins. Generation has no
+> instance to read, so there a placeholder nobody supplied still raises
+> `MissingSubstitutionError` — see
+> [`@conformetry/generation`](../conformetry-generation/README.md) for why, and
+> for the section syntax a template uses to make a placeholder optional.
+
+`exclude` drops any instance whose own path — the directory a pattern found, or
+the files of a file instance — matches one of its globs, whether or not the
+group has `tags`. It is how vendored or generated code living beside real
+instances, such as shadcn's component output, is left out of validation:
+`exclude: ["applications/lexico/src/components/ui/**"]`.
 
 `tags` is carried through untouched by this package, which has no notion of a
 host to match labels against. [`@conformetry/nx`](../conformetry-nx/README.md)
@@ -269,9 +283,9 @@ Call stacks traced through `packages/ic-suite/conformetry/conformetry-configurat
 
 | Measure | Value |
 | --- | --- |
-| Callables | 167 |
-| Files | 37 |
-| Calls traced | 151 |
+| Callables | 181 |
+| Files | 38 |
+| Calls traced | 165 |
 | Call stacks | 5 |
 | Deepest stack | 10 |
 | Stacks through recursion | 0 |
@@ -291,23 +305,23 @@ What this project is judged against, as declared in its own `callidescope.config
 **1. `InstanceDiscoveryService.matchTemplates`** — depth ≥ 10 · orphan-root
 
 ```text
-🚀 InstanceDiscoveryService.matchTemplates(…): TemplateMatch[] [packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:103]
+🚀 InstanceDiscoveryService.matchTemplates(…): TemplateMatch[] [packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:131]
    ↳ Ranks every template that shares a file with one instance, best first.
-  └─> InstanceDiscoveryMatchingService.matchTemplates(…): TemplateMatch[] [packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:154]
+  └─> InstanceDiscoveryMatchingService.matchTemplates(…): TemplateMatch[] [packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:180]
      ↳ Weighs every template that shares at least one file with the instance, best-first.
-    └─> InstanceDiscoveryMatchingService.map(…)(…): { matchedFileCount: number; matchRatio: number; template: TemplateDefinition; } [packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:160]
-      └─> TemplateDiscoveryService.countMatchingFiles(…): number [packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:121]
+    └─> InstanceDiscoveryMatchingService.map(…)(…): { matchedFileCount: number; matchRatio: number; template: TemplateDefinition; placeholderValues: Substitutions; substitutions: Substitutions; } [packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:186]
+      └─> TemplateDiscoveryService.countMatchingFiles(…): number [packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:146]
          ↳ Counts how many of a template's files the instance path already has.
-        └─> TemplateDiscoveryService.filter(…)(templateFilePath: string): boolean [packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:130]
-          └─> TemplateDiscoveryService.resolveInstanceFilePath(…): string [packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:179]
+        └─> TemplateDiscoveryService.filter(…)(templateFilePath: string): boolean [packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:155]
+          └─> TemplateDiscoveryService.resolveInstanceFilePath(…): string [packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:204]
              ↳ Maps a template file path to the instance file path it governs.
             └─> RenderingService.renderPath(…): string [packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.service.ts:142]
                ↳ Renders a template path with mustache, the same way contents are rendered.
               └─> RenderingService.assertEverySubstitutionSupplied(…): void [packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.service.ts:35]
                  ↳ Refuses to render a template asking for a value nobody supplied.
-                └─> RenderingService.collectInterpolatedNames(template: string): string[] [packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.service.ts:61]
+                └─> RenderingService.collectInterpolatedNames(template: string): string[] [packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.service.ts:80]
                    ↳ Every placeholder a template interpolates, deduplicated.
-                  └─> RenderingService.walk(spans: TemplateSpans): void [packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.service.ts:63]
+                  └─> RenderingService.walk(spans: TemplateSpans): void [packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.service.ts:82]
 ```
 
 **2. `InputService.resolveInputsFromValues`** — depth ≥ 8 · orphan-root
@@ -361,11 +375,11 @@ What this project is judged against, as declared in its own `callidescope.config
 **5. `InstanceDiscoveryService.buildSubstitutions`** — depth 3 · orphan-root
 
 ```text
-🚀 InstanceDiscoveryService.buildSubstitutions(…): Substitutions [packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:83]
+🚀 InstanceDiscoveryService.buildSubstitutions(…): Substitutions [packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:111]
    ↳ Builds the substitutions an instance's template is rendered with.
-  └─> InstanceDiscoveryMatchingService.buildSubstitutions(instance: Instance): Substitutions [packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:72]
+  └─> InstanceDiscoveryMatchingService.buildSubstitutions(instance: Instance): Substitutions [packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:97]
      ↳ Builds the substitutions an instance's template is rendered with.
-    └─> RenderingService.buildNameSubstitutions(name: string): Substitutions [packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.service.ts:94]
+    └─> RenderingService.buildNameSubstitutions(name: string): Substitutions [packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.service.ts:60]
        ↳ Derives the case variants every template can reference from one name.
 ```
 
@@ -375,20 +389,20 @@ What this project is judged against, as declared in its own `callidescope.config
 
 | Callable | Breadth | Calls directly | Location |
 | --- | --- | --- | --- |
-| `InstanceDiscoveryMatchingService.matchInstances` | 5 | `InstanceDiscoveryMatchingService.buildSubstitutions`, `InstanceDiscoveryMatchingService.matchTemplates`, `InstanceDiscoveryMatchingService.filter(…)`, `InstanceDiscoveryMatchingService.map(…)`, `InstanceDiscoveryMatchingService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:93` |
+| `InstanceDiscoveryLocatingService.findInstances` | 5 | `InstanceDiscoveryLocatingService.resolveGlobSuffix`, `InstanceDiscoveryLocatingService.globEntries`, `InstanceDiscoveryLocatingService.resolveNameStem`, `InstanceDiscoveryLocatingService.map(…)`, `InstanceDiscoveryLocatingService.toSorted(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-locating.service.ts:156` |
+| `InstanceDiscoveryMatchingService.matchInstances` | 5 | `InstanceDiscoveryMatchingService.buildSubstitutions`, `InstanceDiscoveryMatchingService.matchTemplates`, `InstanceDiscoveryMatchingService.filter(…)`, `InstanceDiscoveryMatchingService.map(…)`, `InstanceDiscoveryMatchingService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:118` |
 | `InputPromptingService.promptForInput` | 4 | `InputPromptingService.assertCanPrompt`, `InputSchemaService.readEnumValues`, `InputPromptingService.map(…)`, `InputSchemaService.readPromptMessage` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input-prompting.service.ts:90` |
-| `InputService.resolveInputs` | 4 | `InputSchemaService.readPropertyNames`, `InputSchemaService.describeInput`, `InputService.acceptProvidedValue`, `InputService.resolveMissingValue` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input.service.ts:53` |
 
 <details>
-<summary>91 more callables</summary>
+<summary>100 more callables</summary>
 
 | Callable | Breadth | Calls directly | Location |
 | --- | --- | --- | --- |
+| `InputService.resolveInputs` | 4 | `InputSchemaService.readPropertyNames`, `InputSchemaService.describeInput`, `InputService.acceptProvidedValue`, `InputService.resolveMissingValue` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input.service.ts:53` |
 | `InputService.resolveMissingValue` | 4 | `InputPromptingService.isAtTerminal`, `missingInputError`, `InputPromptingService.promptForInput`, `InputSchemaService.validateValue` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input.service.ts:94` |
-| `InstanceDiscoveryLocatingService.findInstances` | 4 | `InstanceDiscoveryLocatingService.resolveGlobSuffix`, `InstanceDiscoveryLocatingService.resolveNameStem`, `InstanceDiscoveryLocatingService.map(…)`, `InstanceDiscoveryLocatingService.toSorted(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-locating.service.ts:121` |
-| `InstanceDiscoveryService.resolveInventoriedInstances` | 4 | `InstanceDiscoveryService.takeInventory`, `InstanceDiscoveryService.map(…)`, `InstanceDiscoveryService.filter(…)`, `InstanceDiscoveryService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:191` |
-| `InstanceDiscoveryService.resolveInventoriedTemplates` | 4 | `InstanceDiscoveryService.takeInventory`, `InstanceDiscoveryService.filter(…)`, `InstanceDiscoveryService.map(…)`, `InstanceDiscoveryService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:216` |
-| `InstanceDiscoveryService.takeInventory` | 4 | `TemplateDiscoveryService.collectTemplates`, `InstanceDiscoveryService.flatMap(…)`, `InstanceDiscoveryService.findInstances`, `InstanceDiscoveryService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:255` |
+| `InstanceDiscoveryService.resolveInventoriedInstances` | 4 | `InstanceDiscoveryService.takeInventory`, `InstanceDiscoveryService.map(…)`, `InstanceDiscoveryService.filter(…)`, `InstanceDiscoveryService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:219` |
+| `InstanceDiscoveryService.resolveInventoriedTemplates` | 4 | `InstanceDiscoveryService.takeInventory`, `InstanceDiscoveryService.filter(…)`, `InstanceDiscoveryService.map(…)`, `InstanceDiscoveryService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:244` |
+| `InstanceDiscoveryService.takeInventory` | 4 | `TemplateDiscoveryService.collectTemplates`, `InstanceDiscoveryService.findInstances`, `InstanceDiscoveryService.readInventoryGlobs`, `InstanceDiscoveryService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:283` |
 | `ConfigurationService.loadConformetryConfiguration` | 4 | `ConfigurationService.resolveConfigurationPath`, `UnknownConfigurationFileTypeError.constructor`, `ConfigurationService.loadConfigurationModule`, `ConfigurationService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:243` |
 | `assertNoCollisions` | 3 | `findDuplicates`, `findUnusableNames`, `findReservedNames` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.utilities.ts:28` |
 | `findReservedNames` | 3 | `map(…)`, `filter(…)`, `map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.utilities.ts:97` |
@@ -396,17 +410,20 @@ What this project is judged against, as declared in its own `callidescope.config
 | `InputOptionsService.collectOneInput` | 3 | `InputOptionsService.readOptionName`, `InputOptionsService.resolvePropertyName`, `InputOptionsService.readOptionValue` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input-options.service.ts:38` |
 | `InputSchemaService.validateValue` | 3 | `InputSchemaService.validateEnum`, `InputSchemaService.validateLength`, `InputSchemaService.validatePattern` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input-schema.service.ts:158` |
 | `RenderingService.assertEverySubstitutionSupplied` | 3 | `RenderingService.filter(…)`, `RenderingService.collectInterpolatedNames`, `MissingSubstitutionError.constructor` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.service.ts:35` |
-| `InstanceDiscoveryMatchingService.matchTemplates` | 3 | `InstanceDiscoveryMatchingService.toSorted(…)`, `InstanceDiscoveryMatchingService.filter(…)`, `InstanceDiscoveryMatchingService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:154` |
-| `InstanceDiscoveryService.weighInstance` | 3 | `InstanceDiscoveryService.map(…)`, `InstanceDiscoveryMatchingService.matchTemplates`, `InstanceDiscoveryMatchingService.buildSubstitutions` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:56` |
-| `InstanceDiscoveryService.map(…)` | 3 | `InstanceDiscoveryService.filter(…)`, `InstanceDiscoveryService.map(…)`, `InstanceDiscoveryService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:118` |
+| `InstanceDiscoveryMatchingService.matchTemplates` | 3 | `InstanceDiscoveryMatchingService.toSorted(…)`, `InstanceDiscoveryMatchingService.filter(…)`, `InstanceDiscoveryMatchingService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:180` |
+| `InstanceDiscoveryService.readInventoryGlobs` | 3 | `InstanceDiscoveryService.flatMap(…)`, `InstanceDiscoveryService.flatMap(…)`, `InstanceDiscoveryService.flatMap(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:62` |
+| `InstanceDiscoveryService.weighInstance` | 3 | `InstanceDiscoveryService.map(…)`, `InstanceDiscoveryMatchingService.matchTemplates`, `InstanceDiscoveryMatchingService.buildSubstitutions` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:84` |
+| `InstanceDiscoveryService.map(…)` | 3 | `InstanceDiscoveryService.filter(…)`, `InstanceDiscoveryService.map(…)`, `InstanceDiscoveryService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:146` |
 | `findDuplicates` | 2 | `map(…)`, `filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.utilities.ts:62` |
 | `InputSchemaService.readEnumValues` | 2 | `InputSchemaService.readSchemaProperty`, `InputSchemaService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input-schema.service.ts:123` |
 | `InputPromptingService.assertCanPrompt` | 2 | `InputPromptingService.isAtTerminal`, `missingInputError` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input-prompting.service.ts:50` |
 | `InputPromptingService.promptForTemplates` | 2 | `InputPromptingService.map(…)`, `InputPromptingService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input-prompting.service.ts:144` |
 | `InputService.parseCommaDelimitedOption` | 2 | `InputService.filter(…)`, `InputService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input.service.ts:118` |
 | `InputService.resolveGeneratorInputs` | 2 | `InputOptionsService.collectGeneratorInputs`, `InputService.resolveInputs` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input.service.ts:180` |
-| `TemplateDiscoveryService.prepareDocument` | 2 | `TemplateDiscoveryService.resolveInstanceFilePath`, `RenderingService.renderContent` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:153` |
-| `InstanceDiscoveryService.flatMap(…)` | 2 | `InstanceDiscoveryService.flatMap(…)`, `InstanceDiscoveryService.readWorkspaceGroups` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:265` |
+| `TemplateDiscoveryService.collectTemplate` | 2 | `TemplateDiscoveryService.collectFilePaths`, `TemplateDiscoveryService.collectPlaceholderNames` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:97` |
+| `TemplateDiscoveryService.prepareDocument` | 2 | `TemplateDiscoveryService.resolveInstanceFilePath`, `RenderingService.renderContent` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:178` |
+| `InstanceDiscoveryMatchingService.fillPlaceholders` | 2 | `InstanceDiscoveryMatchingService.map(…)`, `InstanceDiscoveryMatchingService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:73` |
+| `InstanceDiscoveryMatchingService.map(…)` | 2 | `InstanceDiscoveryMatchingService.fillPlaceholders`, `TemplateDiscoveryService.countMatchingFiles` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:186` |
 | `missingInputError` | 1 | `InputError.constructor` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input.constants.ts:65` |
 | `InputOptionsService.resolvePropertyName` | 1 | `InputOptionsService.find(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input-options.service.ts:104` |
 | `InputOptionsService.collectGeneratorInputs` | 1 | `InputOptionsService.collectOneInput` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input-options.service.ts:124` |
@@ -423,35 +440,41 @@ What this project is judged against, as declared in its own `callidescope.config
 | `InputService.parseThresholdOption` | 1 | `InputService.parseOptionalOption` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input.service.ts:161` |
 | `InputService.resolveInputsFromValues` | 1 | `InputService.resolveInputs` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input.service.ts:195` |
 | `MissingSubstitutionError.constructor` | 1 | `MissingSubstitutionError.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.constants.ts:31` |
-| `RenderingService.collectInterpolatedNames` | 1 | `RenderingService.walk` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.service.ts:61` |
+| `RenderingService.collectInterpolatedNames` | 1 | `RenderingService.walk` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.service.ts:80` |
 | `RenderingService.renderContent` | 1 | `RenderingService.assertEverySubstitutionSupplied` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.service.ts:115` |
 | `RenderingService.renderPath` | 1 | `RenderingService.assertEverySubstitutionSupplied` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.service.ts:142` |
-| `TemplateDiscoveryService.collectTemplate` | 1 | `TemplateDiscoveryService.collectFilePaths` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:78` |
-| `TemplateDiscoveryService.collectTemplates` | 1 | `TemplateDiscoveryService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:98` |
-| `TemplateDiscoveryService.map(…)` | 1 | `TemplateDiscoveryService.collectTemplate` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:102` |
-| `TemplateDiscoveryService.countMatchingFiles` | 1 | `TemplateDiscoveryService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:121` |
-| `TemplateDiscoveryService.filter(…)` | 1 | `TemplateDiscoveryService.resolveInstanceFilePath` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:130` |
-| `TemplateDiscoveryService.resolveInstanceFilePath` | 1 | `RenderingService.renderPath` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:179` |
-| `InstanceDiscoveryLocatingService.resolveGlobSuffix` | 1 | `InstanceDiscoveryLocatingService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-locating.service.ts:73` |
-| `InstanceDiscoveryLocatingService.map(…)` | 1 | `InstanceDiscoveryLocatingService.deriveLocationSubstitutions` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-locating.service.ts:162` |
-| `InstanceDiscoveryMatchingService.buildSubstitutions` | 1 | `RenderingService.buildNameSubstitutions` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:72` |
-| `InstanceDiscoveryMatchingService.map(…)` | 1 | `TemplateDiscoveryService.countMatchingFiles` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:160` |
-| `InstanceDiscoveryMatchingService.toSorted(…)` | 1 | `InstanceDiscoveryMatchingService.compareMatches` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:180` |
-| `InstanceDiscoveryService.buildSubstitutions` | 1 | `InstanceDiscoveryMatchingService.buildSubstitutions` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:83` |
-| `InstanceDiscoveryService.findInstances` | 1 | `InstanceDiscoveryLocatingService.findInstances` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:90` |
-| `InstanceDiscoveryService.matchInstances` | 1 | `InstanceDiscoveryMatchingService.matchInstances` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:95` |
-| `InstanceDiscoveryService.matchTemplates` | 1 | `InstanceDiscoveryMatchingService.matchTemplates` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:103` |
-| `InstanceDiscoveryService.prepareDocuments` | 1 | `InstanceDiscoveryService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:113` |
-| `InstanceDiscoveryService.map(…)` | 1 | `TemplateDiscoveryService.prepareDocument` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:124` |
-| `InstanceDiscoveryService.readWorkspaceGroups` | 1 | `InstanceDiscoveryService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:158` |
-| `InstanceDiscoveryService.filter(…)` | 1 | `InstanceGroupService.isProjectScoped` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:161` |
-| `InstanceDiscoveryService.resolveInstanceFiles` | 1 | `InstanceDiscoveryService.flatMap(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:167` |
-| `InstanceDiscoveryService.flatMap(…)` | 1 | `InstanceDiscoveryService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:168` |
-| `InstanceDiscoveryService.map(…)` | 1 | `TemplateDiscoveryService.resolveInstanceFilePath` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:169` |
-| `InstanceDiscoveryService.map(…)` | 1 | `InstanceDiscoveryService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:200` |
-| `InstanceDiscoveryService.map(…)` | 1 | `InstanceDiscoveryService.flatMap(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:228` |
-| `InstanceDiscoveryService.flatMap(…)` | 1 | `InstanceDiscoveryService.find(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:229` |
-| `InstanceDiscoveryService.map(…)` | 1 | `InstanceDiscoveryService.weighInstance` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:277` |
+| `TemplateDiscoveryService.collectPlaceholderNames` | 1 | `TemplateDiscoveryService.flatMap(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:71` |
+| `TemplateDiscoveryService.flatMap(…)` | 1 | `TemplateDiscoveryService.flatMap(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:77` |
+| `TemplateDiscoveryService.flatMap(…)` | 1 | `RenderingService.collectInterpolatedNames` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:81` |
+| `TemplateDiscoveryService.collectTemplates` | 1 | `TemplateDiscoveryService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:123` |
+| `TemplateDiscoveryService.map(…)` | 1 | `TemplateDiscoveryService.collectTemplate` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:127` |
+| `TemplateDiscoveryService.countMatchingFiles` | 1 | `TemplateDiscoveryService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:146` |
+| `TemplateDiscoveryService.filter(…)` | 1 | `TemplateDiscoveryService.resolveInstanceFilePath` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:155` |
+| `TemplateDiscoveryService.resolveInstanceFilePath` | 1 | `RenderingService.renderPath` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts:204` |
+| `InstanceDiscoveryLocatingService.globEntries` | 1 | `InstanceDiscoveryLocatingService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-locating.service.ts:66` |
+| `InstanceDiscoveryLocatingService.filter(…)` | 1 | `InstanceDiscoveryLocatingService.isExcluded` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-locating.service.ts:76` |
+| `InstanceDiscoveryLocatingService.isExcluded` | 1 | `InstanceDiscoveryLocatingService.some(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-locating.service.ts:85` |
+| `InstanceDiscoveryLocatingService.resolveGlobSuffix` | 1 | `InstanceDiscoveryLocatingService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-locating.service.ts:108` |
+| `InstanceDiscoveryLocatingService.map(…)` | 1 | `InstanceDiscoveryLocatingService.deriveLocationSubstitutions` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-locating.service.ts:195` |
+| `InstanceDiscoveryMatchingService.map(…)` | 1 | `createPlaceholderValue` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:80` |
+| `InstanceDiscoveryMatchingService.buildSubstitutions` | 1 | `RenderingService.buildNameSubstitutions` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:97` |
+| `InstanceDiscoveryMatchingService.toSorted(…)` | 1 | `InstanceDiscoveryMatchingService.compareMatches` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts:211` |
+| `InstanceDiscoveryService.flatMap(…)` | 1 | `InstanceDiscoveryService.readWorkspaceGroups` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:72` |
+| `InstanceDiscoveryService.buildSubstitutions` | 1 | `InstanceDiscoveryMatchingService.buildSubstitutions` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:111` |
+| `InstanceDiscoveryService.findInstances` | 1 | `InstanceDiscoveryLocatingService.findInstances` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:118` |
+| `InstanceDiscoveryService.matchInstances` | 1 | `InstanceDiscoveryMatchingService.matchInstances` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:123` |
+| `InstanceDiscoveryService.matchTemplates` | 1 | `InstanceDiscoveryMatchingService.matchTemplates` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:131` |
+| `InstanceDiscoveryService.prepareDocuments` | 1 | `InstanceDiscoveryService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:141` |
+| `InstanceDiscoveryService.map(…)` | 1 | `TemplateDiscoveryService.prepareDocument` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:152` |
+| `InstanceDiscoveryService.readWorkspaceGroups` | 1 | `InstanceDiscoveryService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:186` |
+| `InstanceDiscoveryService.filter(…)` | 1 | `InstanceGroupService.isProjectScoped` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:189` |
+| `InstanceDiscoveryService.resolveInstanceFiles` | 1 | `InstanceDiscoveryService.flatMap(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:195` |
+| `InstanceDiscoveryService.flatMap(…)` | 1 | `InstanceDiscoveryService.map(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:196` |
+| `InstanceDiscoveryService.map(…)` | 1 | `TemplateDiscoveryService.resolveInstanceFilePath` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:197` |
+| `InstanceDiscoveryService.map(…)` | 1 | `InstanceDiscoveryService.filter(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:228` |
+| `InstanceDiscoveryService.map(…)` | 1 | `InstanceDiscoveryService.flatMap(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:256` |
+| `InstanceDiscoveryService.flatMap(…)` | 1 | `InstanceDiscoveryService.find(…)` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:257` |
+| `InstanceDiscoveryService.map(…)` | 1 | `InstanceDiscoveryService.weighInstance` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:295` |
 | `ConfigurationService.loadConfigurationModule` | 1 | `ConfigurationService.loadJsonConfiguration` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:135` |
 | `ConfigurationService.resolveConfigurationPath` | 1 | `ConfigurationService.findWorkspaceRoot` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:174` |
 | `ConfigurationService.buildNameSubstitutions` | 1 | `RenderingService.buildNameSubstitutions` | `packages/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:202` |
@@ -581,6 +604,8 @@ graph LR
   file_src_modules_rendering_rendering_service_ts["src/modules/rendering/rendering.service.ts"]
   file_src_modules_rendering_rendering_service_unit_test_ts["src/modules/rendering/rendering.service.unit.test.ts"]
   file_src_modules_rendering_rendering_types_ts["src/modules/rendering/rendering.types.ts"]
+  file_src_modules_rendering_rendering_utilities_ts["src/modules/rendering/rendering.utilities.ts"]
+  file_src_modules_rendering_rendering_utilities_unit_test_ts["src/modules/rendering/rendering.utilities.unit.test.ts"]
   file_src_modules_template_discovery_template_discovery_constants_ts["src/modules/template-discovery/template-discovery.constants.ts"]
   file_src_modules_template_discovery_template_discovery_module_ts["src/modules/template-discovery/template-discovery.module.ts"]
   file_src_modules_template_discovery_template_discovery_service_ts["src/modules/template-discovery/template-discovery.service.ts"]
@@ -656,6 +681,7 @@ graph LR
   file_src_modules_instance_discovery_instance_discovery_matching_service_ts --> file_src_modules_instance_discovery_instance_discovery_types_ts
   file_src_modules_instance_discovery_instance_discovery_matching_service_ts --> file_src_modules_rendering_rendering_service_ts
   file_src_modules_instance_discovery_instance_discovery_matching_service_ts --> file_src_modules_rendering_rendering_types_ts
+  file_src_modules_instance_discovery_instance_discovery_matching_service_ts --> file_src_modules_rendering_rendering_utilities_ts
   file_src_modules_instance_discovery_instance_discovery_matching_service_ts --> file_src_modules_template_discovery_template_discovery_service_ts
   file_src_modules_instance_discovery_instance_discovery_matching_service_ts --> file_src_modules_template_discovery_template_discovery_types_ts
   file_src_modules_instance_discovery_instance_discovery_matching_service_unit_test_ts --> file_src_modules_instance_discovery_instance_discovery_matching_service_ts
@@ -690,6 +716,8 @@ graph LR
   file_src_modules_rendering_rendering_service_ts --> file_src_modules_rendering_rendering_types_ts
   file_src_modules_rendering_rendering_service_unit_test_ts --> file_src_modules_rendering_rendering_constants_ts
   file_src_modules_rendering_rendering_service_unit_test_ts --> file_src_modules_rendering_rendering_service_ts
+  file_src_modules_rendering_rendering_utilities_ts --> file_src_modules_rendering_rendering_constants_ts
+  file_src_modules_rendering_rendering_utilities_unit_test_ts --> file_src_modules_rendering_rendering_utilities_ts
   file_src_modules_template_discovery_template_discovery_module_ts --> file_src_modules_rendering_rendering_module_ts
   file_src_modules_template_discovery_template_discovery_module_ts --> file_src_modules_template_discovery_template_discovery_service_ts
   file_src_modules_template_discovery_template_discovery_service_ts --> file_src_modules_configuration_configuration_types_ts
@@ -708,40 +736,40 @@ graph LR
 
 ### Project
 
-![Lines of Code](https://img.shields.io/badge/Lines_of_Code-6347-22c55e?style=flat-square)
-![Repository Size](https://img.shields.io/badge/Repository_Size-216.33_kB-6b7280?style=flat-square)
+![Lines of Code](https://img.shields.io/badge/Lines_of_Code-6684-22c55e?style=flat-square)
+![Repository Size](https://img.shields.io/badge/Repository_Size-227.87_kB-6b7280?style=flat-square)
 ![Folders](https://img.shields.io/badge/Folders-9-4a4a4a?style=flat-square)
-![Source Files](https://img.shields.io/badge/Source_Files-52-3178c6?style=flat-square)
+![Source Files](https://img.shields.io/badge/Source_Files-54-3178c6?style=flat-square)
 
 ### Measured Targets
 
-![Compiled JavaScript Size](https://img.shields.io/badge/Compiled_JavaScript_Size-7.47_kB_gzip-6b7280?style=flat-square)
+![Compiled JavaScript Size](https://img.shields.io/badge/Compiled_JavaScript_Size-8.01_kB_gzip-6b7280?style=flat-square)
 
 ### TypeScript
 
-![TypeScript Files](https://img.shields.io/badge/TypeScript_Files-52-3178c6?style=flat-square)
+![TypeScript Files](https://img.shields.io/badge/TypeScript_Files-54-3178c6?style=flat-square)
 ![Interfaces](https://img.shields.io/badge/Interfaces-18-0ea5e9?style=flat-square)
 ![Generic Declarations](https://img.shields.io/badge/Generic_Declarations-2-0369a1?style=flat-square)
 ![Enums](https://img.shields.io/badge/Enums-0-f97316?style=flat-square)
 ![Decorators](https://img.shields.io/badge/Decorators-17-db2777?style=flat-square)
-![Doc Comments](https://img.shields.io/badge/Doc_Comments-173-6366f1?style=flat-square)
+![Doc Comments](https://img.shields.io/badge/Doc_Comments-188-6366f1?style=flat-square)
 ![Static Methods](https://img.shields.io/badge/Static_Methods-0-166534?style=flat-square)
 
 ### JavaScript
 
 ![JavaScript Files](https://img.shields.io/badge/JavaScript_Files-0-f7df1e?style=flat-square)
-![Test Files](https://img.shields.io/badge/Test_Files-13-10b981?style=flat-square)
-![External Packages](https://img.shields.io/badge/External_Packages-16-8b5cf6?style=flat-square)
+![Test Files](https://img.shields.io/badge/Test_Files-14-10b981?style=flat-square)
+![External Packages](https://img.shields.io/badge/External_Packages-17-8b5cf6?style=flat-square)
 ![Classes](https://img.shields.io/badge/Classes-20-7c3aed?style=flat-square)
-![Functions](https://img.shields.io/badge/Functions-339-16a34a?style=flat-square)
-![Methods](https://img.shields.io/badge/Methods-135-15803d?style=flat-square)
-![Sync Functions](https://img.shields.io/badge/Sync_Functions-377-4ade80?style=flat-square)
-![Async Functions](https://img.shields.io/badge/Async_Functions-97-059669?style=flat-square)
-![Constants](https://img.shields.io/badge/Constants-310-dc2626?style=flat-square)
-![Imports](https://img.shields.io/badge/Imports-210-0284c7?style=flat-square)
-![Exported Symbols](https://img.shields.io/badge/Exported_Symbols-62-ea580c?style=flat-square)
-![Comments](https://img.shields.io/badge/Comments-322-64748b?style=flat-square)
-![Comment Lines](https://img.shields.io/badge/Comment_Lines-872-475569?style=flat-square)
+![Functions](https://img.shields.io/badge/Functions-354-16a34a?style=flat-square)
+![Methods](https://img.shields.io/badge/Methods-147-15803d?style=flat-square)
+![Sync Functions](https://img.shields.io/badge/Sync_Functions-403-4ade80?style=flat-square)
+![Async Functions](https://img.shields.io/badge/Async_Functions-98-059669?style=flat-square)
+![Constants](https://img.shields.io/badge/Constants-328-dc2626?style=flat-square)
+![Imports](https://img.shields.io/badge/Imports-216-0284c7?style=flat-square)
+![Exported Symbols](https://img.shields.io/badge/Exported_Symbols-66-ea580c?style=flat-square)
+![Comments](https://img.shields.io/badge/Comments-340-64748b?style=flat-square)
+![Comment Lines](https://img.shields.io/badge/Comment_Lines-924-475569?style=flat-square)
 ![TODO Comments](https://img.shields.io/badge/TODO_Comments-0-ca8a04?style=flat-square)
 
 ### Python
@@ -762,16 +790,16 @@ graph LR
 ### JSON
 
 ![JSON Files](https://img.shields.io/badge/JSON_Files-4-a16207?style=flat-square)
-![JSON Lines](https://img.shields.io/badge/JSON_Lines-171-ca8a04?style=flat-square)
+![JSON Lines](https://img.shields.io/badge/JSON_Lines-172-ca8a04?style=flat-square)
 ![JSON Objects](https://img.shields.io/badge/JSON_Objects-38-7c3aed?style=flat-square)
 ![JSON Arrays](https://img.shields.io/badge/JSON_Arrays-13-8b5cf6?style=flat-square)
 ![JSON Properties](https://img.shields.io/badge/JSON_Properties-108-0284c7?style=flat-square)
-![JSON Strings](https://img.shields.io/badge/JSON_Strings-96-16a34a?style=flat-square)
+![JSON Strings](https://img.shields.io/badge/JSON_Strings-97-16a34a?style=flat-square)
 ![JSON Numbers](https://img.shields.io/badge/JSON_Numbers-1-059669?style=flat-square)
 ![JSON Booleans](https://img.shields.io/badge/JSON_Booleans-7-0ea5e9?style=flat-square)
 ![JSON Nulls](https://img.shields.io/badge/JSON_Nulls-0-64748b?style=flat-square)
-![JSON Items](https://img.shields.io/badge/JSON_Items-43-475569?style=flat-square)
-![JSON Nodes](https://img.shields.io/badge/JSON_Nodes-155-dc2626?style=flat-square)
+![JSON Items](https://img.shields.io/badge/JSON_Items-44-475569?style=flat-square)
+![JSON Nodes](https://img.shields.io/badge/JSON_Nodes-156-dc2626?style=flat-square)
 ![JSON Max Depth](https://img.shields.io/badge/JSON_Max_Depth-5-ea580c?style=flat-square)
 
 ### YAML
@@ -857,9 +885,9 @@ graph LR
 ![Command Files](https://img.shields.io/badge/Command_Files-0-16a34a?style=flat-square)
 ![Constants Files](https://img.shields.io/badge/Constants_Files-6-ea580c?style=flat-square)
 ![Types Files](https://img.shields.io/badge/Types_Files-6-db2777?style=flat-square)
-![Utilities Files](https://img.shields.io/badge/Utilities_Files-1-0ea5e9?style=flat-square)
+![Utilities Files](https://img.shields.io/badge/Utilities_Files-2-0ea5e9?style=flat-square)
 ![TypeORM Entities](https://img.shields.io/badge/TypeORM_Entities-0-059669?style=flat-square)
-![Unit Tests](https://img.shields.io/badge/Unit_Tests-13-ca8a04?style=flat-square)
+![Unit Tests](https://img.shields.io/badge/Unit_Tests-14-ca8a04?style=flat-square)
 ![Integration Tests](https://img.shields.io/badge/Integration_Tests-0-7c3aed?style=flat-square)
 ![End To End Tests](https://img.shields.io/badge/End_To_End_Tests-0-0284c7?style=flat-square)
 ![CSS Comment Budget](https://img.shields.io/badge/CSS_Comment_Budget-0-16a34a?style=flat-square)
@@ -896,21 +924,21 @@ graph LR
 
 ### Markdown
 
-![Markdown Files](https://img.shields.io/badge/Markdown_Files-1-083fa1?style=flat-square)
-![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-222-1f6feb?style=flat-square)
+![Markdown Files](https://img.shields.io/badge/Markdown_Files-2-083fa1?style=flat-square)
+![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-241-1f6feb?style=flat-square)
 ![H1](https://img.shields.io/badge/H1-1-7c3aed?style=flat-square)
-![H2](https://img.shields.io/badge/H2-7-8b5cf6?style=flat-square)
-![H3](https://img.shields.io/badge/H3-12-a78bfa?style=flat-square)
+![H2](https://img.shields.io/badge/H2-9-8b5cf6?style=flat-square)
+![H3](https://img.shields.io/badge/H3-16-a78bfa?style=flat-square)
 ![H4](https://img.shields.io/badge/H4-0-c4b5fd?style=flat-square)
 ![H5](https://img.shields.io/badge/H5-0-ddd6fe?style=flat-square)
 ![H6](https://img.shields.io/badge/H6-0-ede9fe?style=flat-square)
-![Paragraphs](https://img.shields.io/badge/Paragraphs-45-64748b?style=flat-square)
-![Lists](https://img.shields.io/badge/Lists-6-16a34a?style=flat-square)
-![List Items](https://img.shields.io/badge/List_Items-25-22c55e?style=flat-square)
+![Paragraphs](https://img.shields.io/badge/Paragraphs-49-64748b?style=flat-square)
+![Lists](https://img.shields.io/badge/Lists-10-16a34a?style=flat-square)
+![List Items](https://img.shields.io/badge/List_Items-29-22c55e?style=flat-square)
 ![Task List Items](https://img.shields.io/badge/Task_List_Items-0-4ade80?style=flat-square)
 ![Tables](https://img.shields.io/badge/Tables-2-0284c7?style=flat-square)
 ![Table Rows](https://img.shields.io/badge/Table_Rows-10-0ea5e9?style=flat-square)
-![Links](https://img.shields.io/badge/Links-9-059669?style=flat-square)
+![Links](https://img.shields.io/badge/Links-11-059669?style=flat-square)
 ![Images](https://img.shields.io/badge/Images-0-10b981?style=flat-square)
 ![Code Blocks](https://img.shields.io/badge/Code_Blocks-11-dc2626?style=flat-square)
 ![Inline Code](https://img.shields.io/badge/Inline_Code-73-ef4444?style=flat-square)

package/dist/src/index.d.ts

@@ -15,6 +15,20 @@ import { PreparedValidationDocument } from '@conformetry/core';
  */
 export declare const ALL_TEMPLATES_SELECTION = "all";
 
+/**
+ * Reads what each placeholder value in `templateText` stands for in
+ * `instanceText`.
+ *
+ * The template text is a pattern: its literal parts must match exactly and
+ * each placeholder value captures a non-empty run of text. Returns `undefined`
+ * when the template text holds no placeholder value or the instance text does
+ * not fit the pattern, so a caller keeps its own equality check as it was.
+ */
+export declare function capturePlaceholderValues(args: {
+    instanceText: string;
+    templateText: string;
+}): Record<string, string> | undefined;
+
 /**
  * Provides the configuration layer's one public service.
  *
@@ -182,6 +196,13 @@ export declare type ConformetryGeneratorInputDefinition = Record<string, unknown
  * `Instance.path`.
  */
 export declare interface ConformetryInstanceGroup {
+    /**
+     * Workspace-relative globs naming paths that are never instances, applied
+     * whether or not the group has tags. A directory or file the patterns found
+     * is dropped when one of these matches it — how vendored or generated code,
+     * such as shadcn components, is left out of validation.
+     */
+    exclude?: string[] | undefined;
     /**
      * Globs locating this group's instances.
      *
@@ -217,8 +238,22 @@ export declare interface ConformetryInstanceGroup {
     threshold?: number | undefined;
 }
 
+/**
+ * Creates a random stand-in for a placeholder nothing supplied.
+ *
+ * Validation renders it in place of the missing value, so the comparison can
+ * find where the instance holds the real one and capture it.
+ */
+export declare function createPlaceholderValue(): string;
+
 /** Arguments for expanding instance globs into instances. */
 export declare interface FindInstancesArguments {
+    /**
+     * Globs, relative to the working directory, naming paths that are never
+     * instances: a directory or file a pattern found is dropped when one of
+     * these matches it.
+     */
+    readonly exclude?: string[] | undefined;
     /** Glob patterns, resolved against the working directory. */
     readonly patterns: string[];
     /**
@@ -514,6 +549,10 @@ declare class InstanceDiscoveryLocatingService {
      * projects deeper needs.
      */
     private deriveLocationSubstitutions;
+    /** Expands one pattern, leaving out every path an exclude glob matches. */
+    private globEntries;
+    /** Whether an exclude glob matches a found path, workspace-relative. */
+    private isExcluded;
     /**
      * Returns the literal filename suffix a pattern ends with, such as
      * `.service.ts` for `**\/*.service.ts`, or `""` when the pattern's last
@@ -568,6 +607,15 @@ declare class InstanceDiscoveryMatchingService {
      * deterministic.
      */
     private compareMatches;
+    /**
+     * Gives every placeholder the substitutions leave out a random stand-in.
+     *
+     * Only validation matches instances, and there a missing value is something
+     * to infer from the instance rather than an error: generation renders
+     * without this and still refuses a placeholder nobody supplied. `name` and its
+     * variants are always supplied, so they are never stood in for.
+     */
+    private fillPlaceholders;
     /**
      * Builds the substitutions an instance's template is rendered with.
      *
@@ -623,6 +671,14 @@ declare class InstanceDiscoveryService {
     private readonly instanceGroupService;
     private readonly templateDiscoveryService;
     constructor(instanceDiscoveryLocatingService: InstanceDiscoveryLocatingService, instanceDiscoveryMatchingService: InstanceDiscoveryMatchingService, instanceGroupService: InstanceGroupService, templateDiscoveryService: TemplateDiscoveryService);
+    /**
+     * The globs an inventory expands: the configured groups' patterns and
+     * exclusions, or an explicit pattern list replacing both.
+     *
+     * One expansion rather than one per group, so an instance two groups locate
+     * is listed once; every group's exclusions therefore apply to all of them.
+     */
+    private readInventoryGlobs;
     /** Weighs one instance against every template, best fit first. */
     private weighInstance;
     /** Builds the substitutions an instance's template is rendered with. */
@@ -740,6 +796,13 @@ export declare interface MatchedInstance {
     readonly instance: Instance;
     /** How many of the template's files the instance already has. */
     readonly matchedFileCount: number;
+    /**
+     * The random stand-in rendered for each placeholder nothing supplied, keyed
+     * by placeholder. Validation replaces each with the text the instance holds
+     * there. Absent or empty when every placeholder was supplied.
+     */
+    readonly placeholderValues?: Substitutions;
+    /** Every value the template renders with, stand-ins included. */
     readonly substitutions: Substitutions;
     readonly template: TemplateDefinition;
 }
@@ -796,6 +859,13 @@ declare class RenderingService {
     constructor();
     /** Refuses to render a template asking for a value nobody supplied. */
     private assertEverySubstitutionSupplied;
+    /**
+     * Derives the case variants every template can reference from one name.
+     *
+     * Callers merge their own inputs over this result, so an explicit input of
+     * the same key always wins over the derived variant.
+     */
+    buildNameSubstitutions(name: string): Substitutions;
     /**
      * Every placeholder a template interpolates, deduplicated.
      *
@@ -805,14 +875,7 @@ declare class RenderingService {
      * `{{^field}}` are conditionals, so absence is an answer there — as is the
      * implicit iterator `{{.}}`, which names no field.
      */
-    private collectInterpolatedNames;
-    /**
-     * Derives the case variants every template can reference from one name.
-     *
-     * Callers merge their own inputs over this result, so an explicit input of
-     * the same key always wins over the derived variant.
-     */
-    buildNameSubstitutions(name: string): Substitutions;
+    collectInterpolatedNames(template: string): string[];
     /**
      * Renders template contents with mustache.
      *
@@ -912,6 +975,12 @@ export declare interface TemplateDefinition {
     readonly filePaths: string[];
     /** The template's directory name, used to identify it. */
     readonly name: string;
+    /**
+     * Every placeholder the template's files and file paths interpolate. Read
+     * once here so validation knows which ones nothing supplied without
+     * reading the template again per instance. Absent means none.
+     */
+    readonly placeholderNames?: string[];
     /**
      * Lowest conformance score an instance of this template may have, from the
      * generator that owns it. Undefined when the generator sets none.
@@ -937,6 +1006,8 @@ declare class TemplateDiscoveryService {
     constructor(renderingService: RenderingService);
     /** Lists every file under a directory, recursively and sorted. */
     private collectFilePaths;
+    /** Every placeholder a template's file contents and paths interpolate. */
+    private collectPlaceholderNames;
     /**
      * Reads one template folder.
      *
@@ -1006,6 +1077,10 @@ export declare interface TemplateMatch {
     readonly matchedFileCount: number;
     /** Share of the template's files the instance already has, 0 to 1. */
     readonly matchRatio: number;
+    /** The stand-ins this template needed — see `MatchedInstance`. */
+    readonly placeholderValues: Substitutions;
+    /** The instance's substitutions with those stand-ins added. */
+    readonly substitutions: Substitutions;
     readonly template: TemplateDefinition;
 }
 

package/dist/src/index.js

@@ -5,7 +5,8 @@ import i from "lodash";
 import a from "prompts";
 import o from "mustache";
 import s, { existsSync as c } from "node:fs";
-import { access as l, readFile as u } from "node:fs/promises";
+import { randomUUID as l } from "node:crypto";
+import { access as u, readFile as ee } from "node:fs/promises";
 import { fileURLToPath as d } from "node:url";
 import { createJiti as f } from "jiti";
 import { parse as p } from "jsonc-parser";
@@ -38,8 +39,8 @@ function y(e, t) {
 			describe: (e, t) => `${e} is the template of more than one generator: ${t.join(", ")}. Validation cannot tell which one a matching instance belongs to.`,
 			keysOf: (e) => [e.templatePath]
 		}),
-		...S(e),
-		...x(e)
+		...x(e),
+		...te(e)
 	];
 	for (let e of n) t.addIssue({
 		code: "custom",
@@ -61,7 +62,7 @@ function b(e) {
 		path: [n.lastIndex]
 	}));
 }
-function x(e) {
+function te(e) {
 	return e.map((e, t) => ({
 		index: t,
 		name: e.name
@@ -70,7 +71,7 @@ function x(e) {
 		path: [e]
 	}));
 }
-function S(e) {
+function x(e) {
 	return e.map((e, t) => ({
 		index: t,
 		name: e.name
@@ -81,11 +82,11 @@ function S(e) {
 }
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.constants.ts
-var C = class extends Error {
+var S = class extends Error {
 	constructor(e) {
 		super(`Unsupported configuration file type: ${e}`), this.name = "UnknownConfigurationFileTypeError";
 	}
-}, w = "pnpm-workspace.yaml", T = /* @__PURE__ */ new Set([
+}, C = "pnpm-workspace.yaml", w = /* @__PURE__ */ new Set([
 	".cjs",
 	".cts",
 	".js",
@@ -94,17 +95,18 @@ var C = class extends Error {
 	".mjs",
 	".mts",
 	".ts"
-]), E = e.lazy(() => e.union([
+]), T = e.lazy(() => e.union([
 	e.string(),
 	e.number(),
 	e.boolean(),
 	e.null(),
-	e.array(E),
-	e.record(e.string(), E)
-])), D = e.array(e.strictObject({
+	e.array(T),
+	e.record(e.string(), T)
+])), E = e.array(e.strictObject({
 	description: e.string().optional(),
-	inputs: e.record(e.string(), e.record(e.string(), E)).optional(),
+	inputs: e.record(e.string(), e.record(e.string(), T)).optional(),
 	instances: e.array(e.object({
+		exclude: e.array(e.string()).optional(),
 		patterns: e.array(e.string()).optional(),
 		substitutions: e.record(e.string(), e.string()).optional(),
 		tags: e.array(e.string()).optional(),
@@ -116,12 +118,12 @@ var C = class extends Error {
 })).superRefine(y);
 //#endregion
 //#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorateMetadata.js
-function O(e, t) {
+function D(e, t) {
 	if (typeof Reflect == "object" && typeof Reflect.metadata == "function") return Reflect.metadata(e, t);
 }
 //#endregion
 //#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorate.js
-function k(e, t, n, r) {
+function O(e, t, n, r) {
 	var i = arguments.length, a = i < 3 ? t : r === null ? r = Object.getOwnPropertyDescriptor(t, n) : r, o;
 	if (typeof Reflect == "object" && typeof Reflect.decorate == "function") a = Reflect.decorate(e, t, n, r);
 	else for (var s = e.length - 1; s >= 0; s--) (o = e[s]) && (a = (i < 3 ? o(a) : i > 3 ? o(t, n, a) : o(t, n)) || a);
@@ -129,7 +131,7 @@ function k(e, t, n, r) {
 }
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input-options.service.ts
-var A = class {
+var k = class {
 	constructor() {}
 	collectOneInput(e) {
 		let t = e.commandArguments[e.argumentIndex];
@@ -183,10 +185,10 @@ var A = class {
 		return t.join(e.defaultGeneratedOutputDirectory ?? "generated", e.generatorName);
 	}
 };
-A = k([n(), O("design:paramtypes", [])], A);
+k = O([n(), D("design:paramtypes", [])], k);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input-schema.service.ts
-var j = class {
+var A = class {
 	constructor() {}
 	readSchemaProperty(e, t) {
 		if (typeof e == "object" && e) return Object.entries(e).find(([e]) => e === t)?.[1];
@@ -241,10 +243,10 @@ var j = class {
 		}) : r;
 	}
 };
-j = k([n(), O("design:paramtypes", [])], j);
+A = O([n(), D("design:paramtypes", [])], A);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input-prompting.service.ts
-var M = class {
+var j = class {
 	inputSchemaService;
 	constructor(e) {
 		this.inputSchemaService = e;
@@ -307,10 +309,10 @@ var M = class {
 		return n.length === 0 ? void 0 : n;
 	}
 };
-M = k([n(), O("design:paramtypes", [j === void 0 ? Object : j])], M);
+j = O([n(), D("design:paramtypes", [A === void 0 ? Object : A])], j);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input.service.ts
-var N = class {
+var M = class {
 	inputOptionsService;
 	inputPromptingService;
 	inputSchemaService;
@@ -391,72 +393,63 @@ var N = class {
 		});
 	}
 };
-N = k([n(), O("design:paramtypes", [
-	A === void 0 ? Object : A,
-	M === void 0 ? Object : M,
-	j === void 0 ? Object : j
-])], N);
+M = O([n(), D("design:paramtypes", [
+	k === void 0 ? Object : k,
+	j === void 0 ? Object : j,
+	A === void 0 ? Object : A
+])], M);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/input/input.module.ts
-var P = class {};
-P = k([r({
+var N = class {};
+N = O([r({
 	controllers: [],
 	exports: [
-		A,
-		M,
-		N
+		k,
+		j,
+		M
 	],
 	imports: [],
 	providers: [
-		A,
-		M,
+		k,
 		j,
-		N
+		A,
+		M
 	]
-})], P);
+})], N);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-group/instance-group.service.ts
-var F = class {
+var P = class {
 	constructor() {}
 	isProjectScoped(e) {
 		return e.tags !== void 0 && e.tags.length > 0;
 	}
 };
-F = k([n(), O("design:paramtypes", [])], F);
+P = O([n(), D("design:paramtypes", [])], P);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-group/instance-group.module.ts
-var I = class {};
-I = k([r({
+var F = class {};
+F = O([r({
 	controllers: [],
-	exports: [F],
+	exports: [P],
 	imports: [],
-	providers: [F]
-})], I);
+	providers: [P]
+})], F);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.constants.ts
-var L = { escape: String }, R = class extends Error {
+var I = { escape: String }, L = class extends Error {
 	constructor(e) {
 		let t = e.placeholders.map((e) => `{{${e}}}`).join(", ");
 		super(`No value was supplied for ${t} while rendering ${e.subject}. Declare each one as an input of the generator, and in the matching instance group's substitutions.`), this.name = "MissingSubstitutionError";
 	}
-}, z = class {
+}, R = /conformetry[0-9a-f]{32}/g, z = "conformetry", B = class {
 	constructor() {}
 	assertEverySubstitutionSupplied(e) {
 		let t = this.collectInterpolatedNames(e.template).filter((t) => !Object.hasOwn(e.substitutions, t));
-		if (t.length > 0) throw new R({
+		if (t.length > 0) throw new L({
 			placeholders: t,
 			subject: e.subject
 		});
 	}
-	collectInterpolatedNames(e) {
-		let t = /* @__PURE__ */ new Set(), n = (e) => {
-			for (let r of e) {
-				let e = r[0], i = r[1], a = r[4];
-				(e === "name" || e === "&") && i !== "." && t.add(i), Array.isArray(a) && n(a);
-			}
-		};
-		return n(o.parse(e)), [...t];
-	}
 	buildNameSubstitutions(e) {
 		let t = i.camelCase(e);
 		return {
@@ -466,34 +459,43 @@ var L = { escape: String }, R = class extends Error {
 			nameSnakeCase: i.snakeCase(e)
 		};
 	}
+	collectInterpolatedNames(e) {
+		let t = /* @__PURE__ */ new Set(), n = (e) => {
+			for (let r of e) {
+				let e = r[0], i = r[1], a = r[4];
+				(e === "name" || e === "&") && i !== "." && t.add(i), Array.isArray(a) && n(a);
+			}
+		};
+		return n(o.parse(e)), [...t];
+	}
 	renderContent(e) {
 		return this.assertEverySubstitutionSupplied({
 			subject: e.subject ?? "a template file",
 			substitutions: e.substitutions,
 			template: e.templateContent
-		}), o.render(e.templateContent, e.substitutions, {}, L);
+		}), o.render(e.templateContent, e.substitutions, {}, I);
 	}
 	renderPath(e) {
 		return this.assertEverySubstitutionSupplied({
 			subject: e.subject ?? e.templatePath,
 			substitutions: e.substitutions,
 			template: e.templatePath
-		}), o.render(e.templatePath, e.substitutions, {}, L);
+		}), o.render(e.templatePath, e.substitutions, {}, I);
 	}
 };
-z = k([n(), O("design:paramtypes", [])], z);
+B = O([n(), D("design:paramtypes", [])], B);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.module.ts
-var B = class {};
-B = k([r({
+var V = class {};
+V = O([r({
 	controllers: [],
-	exports: [z],
+	exports: [B],
 	imports: [],
-	providers: [z]
-})], B);
+	providers: [B]
+})], V);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.service.ts
-var V = class {
+var H = class {
 	renderingService;
 	constructor(e) {
 		this.renderingService = e;
@@ -510,11 +512,19 @@ var V = class {
 		}
 		return n.toSorted();
 	}
+	collectPlaceholderNames(e) {
+		return [...new Set(e.filePaths.flatMap((n) => [t.relative(e.directoryPath, n), s.readFileSync(n, "utf8")].flatMap((e) => this.renderingService.collectInterpolatedNames(e))))];
+	}
 	collectTemplate(e) {
+		let t = this.collectFilePaths(e.templatePath);
 		return {
 			directoryPath: e.templatePath,
-			filePaths: this.collectFilePaths(e.templatePath),
+			filePaths: t,
 			name: e.name,
+			placeholderNames: this.collectPlaceholderNames({
+				directoryPath: e.templatePath,
+				filePaths: t
+			}),
 			...e.threshold === void 0 ? {} : { threshold: e.threshold }
 		};
 	}
@@ -559,42 +569,55 @@ var V = class {
 		}));
 	}
 };
-V = k([n(), O("design:paramtypes", [z === void 0 ? Object : z])], V);
+H = O([n(), D("design:paramtypes", [B === void 0 ? Object : B])], H);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/template-discovery/template-discovery.module.ts
-var H = class {};
-H = k([r({
+var U = class {};
+U = O([r({
 	controllers: [],
-	exports: [V],
-	imports: [B],
-	providers: [V]
-})], H);
+	exports: [H],
+	imports: [V],
+	providers: [H]
+})], U);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.constants.ts
-var U = /\.[^.]+$/u, W = [
+var W = /\.[^.]+$/u, G = [
 	"*",
 	"?",
 	"]"
-], G = class {
+], K = class {
 	constructor() {}
 	deriveLocationSubstitutions(e) {
 		let [n = ""] = t.relative(e.workingDirectory, t.join(e.instancePath, e.nameStem)).split(t.sep);
 		return n === "" || n === ".." ? {} : { type: n };
 	}
+	globEntries(e) {
+		return s.globSync(e.pattern, {
+			cwd: e.workingDirectory,
+			withFileTypes: !0
+		}).filter((n) => !this.isExcluded({
+			...e,
+			entryPath: t.join(n.parentPath, n.name)
+		}));
+	}
+	isExcluded(e) {
+		let n = t.relative(e.workingDirectory, t.resolve(e.workingDirectory, e.entryPath));
+		return (e.exclude ?? []).some((e) => t.matchesGlob(n, e));
+	}
 	resolveGlobSuffix(e) {
-		let n = t.basename(e), r = Math.max(...W.map((e) => n.lastIndexOf(e)));
+		let n = t.basename(e), r = Math.max(...G.map((e) => n.lastIndexOf(e)));
 		return r === -1 ? "" : n.slice(r + 1);
 	}
 	resolveNameStem(e) {
-		return e.isDirectory ? e.entryName : e.suffix !== "" && e.entryName.endsWith(e.suffix) ? e.entryName.slice(0, -e.suffix.length) : e.entryName.replace(U, "");
+		return e.isDirectory ? e.entryName : e.suffix !== "" && e.entryName.endsWith(e.suffix) ? e.entryName.slice(0, -e.suffix.length) : e.entryName.replace(W, "");
 	}
 	findInstances(e) {
 		let n = /* @__PURE__ */ new Map();
 		for (let r of e.patterns) {
 			let i = this.resolveGlobSuffix(r);
-			for (let a of s.globSync(r, {
-				cwd: e.workingDirectory,
-				withFileTypes: !0
+			for (let a of this.globEntries({
+				...e,
+				pattern: r
 			})) {
 				let e = a.isDirectory(), r = t.join(a.parentPath, a.name), o = [
 					a.parentPath,
@@ -632,10 +655,24 @@ var U = /\.[^.]+$/u, W = [
 		});
 	}
 };
-G = k([n(), O("design:paramtypes", [])], G);
+K = O([n(), D("design:paramtypes", [])], K);
+//#endregion
+//#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/rendering/rendering.utilities.ts
+function q(e) {
+	let t = e.templateText.match(R) ?? [];
+	if (t.length === 0) return;
+	let n = i.escapeRegExp(e.templateText).replaceAll(R, String.raw`([\s\S]+?)`), r = RegExp(`^${n}$`, "u").exec(e.instanceText);
+	if (r === null) return;
+	let a = {};
+	for (let [e, n] of t.entries()) a[n] ??= r[e + 1] ?? "";
+	return a;
+}
+function J() {
+	return `${z}${l().replaceAll("-", "")}`;
+}
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery-matching.service.ts
-var K = class {
+var Y = class {
 	templateDiscoveryService;
 	renderingService;
 	constructor(e, t) {
@@ -644,6 +681,16 @@ var K = class {
 	compareMatches(e, t) {
 		return e.matchRatio === t.matchRatio ? e.matchedFileCount === t.matchedFileCount ? e.template.name.localeCompare(t.template.name) : t.matchedFileCount - e.matchedFileCount : t.matchRatio - e.matchRatio;
 	}
+	fillPlaceholders(e) {
+		let t = Object.fromEntries((e.template.placeholderNames ?? []).filter((t) => !Object.hasOwn(e.substitutions, t)).map((e) => [e, J()]));
+		return {
+			placeholderValues: t,
+			substitutions: {
+				...t,
+				...e.substitutions
+			}
+		};
+	}
 	buildSubstitutions(e) {
 		return {
 			...this.renderingService.buildNameSubstitutions(e.nameStem),
@@ -679,7 +726,8 @@ var K = class {
 			t.push(...s.map((e) => ({
 				instance: r,
 				matchedFileCount: e.matchedFileCount,
-				substitutions: i,
+				placeholderValues: e.placeholderValues,
+				substitutions: e.substitutions,
 				template: e.template
 			})));
 		}
@@ -690,24 +738,28 @@ var K = class {
 	}
 	matchTemplates(e) {
 		return e.templates.map((t) => {
-			let n = this.templateDiscoveryService.countMatchingFiles({
+			let n = this.fillPlaceholders({
+				substitutions: e.substitutions,
+				template: t
+			}), r = this.templateDiscoveryService.countMatchingFiles({
 				fileScope: e.instance.fileScope,
 				instancePath: e.instance.path,
-				substitutions: e.substitutions,
+				substitutions: n.substitutions,
 				template: t
 			});
 			return {
-				matchedFileCount: n,
-				matchRatio: n / t.filePaths.length,
+				...n,
+				matchedFileCount: r,
+				matchRatio: r / t.filePaths.length,
 				template: t
 			};
 		}).filter((e) => e.matchedFileCount > 0 && e.matchRatio > 0).toSorted((e, t) => this.compareMatches(e, t));
 	}
 };
-K = k([n(), O("design:paramtypes", [V === void 0 ? Object : V, z === void 0 ? Object : z])], K);
+Y = O([n(), D("design:paramtypes", [H === void 0 ? Object : H, B === void 0 ? Object : B])], Y);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts
-var q = class {
+var X = class {
 	instanceDiscoveryLocatingService;
 	instanceDiscoveryMatchingService;
 	instanceGroupService;
@@ -715,6 +767,18 @@ var q = class {
 	constructor(e, t, n, r) {
 		this.instanceDiscoveryLocatingService = e, this.instanceDiscoveryMatchingService = t, this.instanceGroupService = n, this.templateDiscoveryService = r;
 	}
+	readInventoryGlobs(e) {
+		if (e.instancePatterns !== void 0) return {
+			patterns: e.instancePatterns,
+			workingDirectory: e.workingDirectory
+		};
+		let t = e.configuration.flatMap((e) => this.readWorkspaceGroups(e.instances));
+		return {
+			exclude: t.flatMap((e) => e.exclude ?? []),
+			patterns: t.flatMap((e) => e.patterns ?? []),
+			workingDirectory: e.workingDirectory
+		};
+	}
 	weighInstance(e) {
 		let t = this.instanceDiscoveryMatchingService.matchTemplates({
 			instance: e.instance,
@@ -799,50 +863,47 @@ var q = class {
 		let t = this.templateDiscoveryService.collectTemplates({
 			configuration: e.configuration,
 			workingDirectory: e.workingDirectory
-		}), n = e.instancePatterns ?? e.configuration.flatMap((e) => this.readWorkspaceGroups(e.instances).flatMap((e) => e.patterns ?? []));
+		});
 		return {
 			templates: t,
-			weighed: this.findInstances({
-				patterns: n,
-				workingDirectory: e.workingDirectory
-			}).map((e) => this.weighInstance({
+			weighed: this.findInstances(this.readInventoryGlobs(e)).map((e) => this.weighInstance({
 				instance: e,
 				templates: t
 			}))
 		};
 	}
 };
-q = k([n(), O("design:paramtypes", [
-	G === void 0 ? Object : G,
+X = O([n(), D("design:paramtypes", [
 	K === void 0 ? Object : K,
-	F === void 0 ? Object : F,
-	V === void 0 ? Object : V
-])], q);
+	Y === void 0 ? Object : Y,
+	P === void 0 ? Object : P,
+	H === void 0 ? Object : H
+])], X);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.module.ts
-var J = class {};
-J = k([r({
+var Z = class {};
+Z = O([r({
 	controllers: [],
 	exports: [
-		G,
 		K,
-		q,
-		H
+		Y,
+		X,
+		U
 	],
 	imports: [
-		I,
-		B,
-		H
+		F,
+		V,
+		U
 	],
 	providers: [
-		G,
 		K,
-		q
+		Y,
+		X
 	]
-})], J);
+})], Z);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts
-var Y = class {
+var Q = class {
 	inputPromptingService;
 	inputService;
 	instanceDiscoveryService;
@@ -865,7 +926,7 @@ var Y = class {
 	async findWorkspaceRoot() {
 		let e = t.resolve(process.cwd());
 		for (;;) try {
-			return await l(t.join(e, w)), e;
+			return await u(t.join(e, C)), e;
 		} catch {
 			let n = t.dirname(e);
 			if (n === e) return;
@@ -880,7 +941,7 @@ var Y = class {
 		return typeof n == "object" && n ? n : t;
 	}
 	async loadJsonConfiguration(e) {
-		let t = await u(e.configurationPath, "utf8");
+		let t = await ee(e.configurationPath, "utf8");
 		return e.extension === ".jsonc" ? p(t) : JSON.parse(t);
 	}
 	async resolveConfigurationPath(e) {
@@ -911,12 +972,12 @@ var Y = class {
 	}
 	async loadConformetryConfiguration(e) {
 		let n = await this.resolveConfigurationPath(e), r = t.extname(n).toLowerCase();
-		if (!T.has(r)) throw new C(n);
+		if (!w.has(r)) throw new S(n);
 		let i = await this.loadConfigurationModule({
 			configurationPath: n,
 			extension: r
 		});
-		return D.parse(i).map((e) => this.applyGeneratorDefaults(e));
+		return E.parse(i).map((e) => this.applyGeneratorDefaults(e));
 	}
 	matchInstances(e) {
 		return this.instanceDiscoveryService.matchInstances(e);
@@ -961,28 +1022,28 @@ var Y = class {
 		return this.instanceDiscoveryService.resolveInventoriedTemplates(e);
 	}
 };
-Y = k([n(), O("design:paramtypes", [
+Q = O([n(), D("design:paramtypes", [
+	j === void 0 ? Object : j,
 	M === void 0 ? Object : M,
-	N === void 0 ? Object : N,
-	q === void 0 ? Object : q,
-	F === void 0 ? Object : F,
-	z === void 0 ? Object : z,
-	V === void 0 ? Object : V
-])], Y);
+	X === void 0 ? Object : X,
+	P === void 0 ? Object : P,
+	B === void 0 ? Object : B,
+	H === void 0 ? Object : H
+])], Q);
 //#endregion
 //#region packages/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.module.ts
-var X = class {};
-X = k([r({
+var $ = class {};
+$ = O([r({
 	controllers: [],
-	exports: [Y],
+	exports: [Q],
 	imports: [
-		P,
-		J,
-		I,
-		B,
-		H
+		N,
+		Z,
+		F,
+		V,
+		U
 	],
-	providers: [Y]
-})], X);
+	providers: [Q]
+})], $);
 //#endregion
-export { h as ALL_TEMPLATES_SELECTION, X as ConfigurationModule, Y as ConfigurationService, _ as InputError, R as MissingSubstitutionError, C as UnknownConfigurationFileTypeError, v as missingInputError };
+export { h as ALL_TEMPLATES_SELECTION, $ as ConfigurationModule, Q as ConfigurationService, _ as InputError, L as MissingSubstitutionError, S as UnknownConfigurationFileTypeError, q as capturePlaceholderValues, J as createPlaceholderValue, v as missingInputError };

package/package.json

@@ -4,7 +4,7 @@
     "url": "https://github.com/organizzolini/codebase/issues"
   },
   "dependencies": {
-    "@conformetry/core": "0.0.4",
+    "@conformetry/core": "0.0.6",
     "@nestjs/common": "^11.1.21 || ^12.0.1",
     "jiti": "^2.7.0",
     "jsonc-parser": "^3.3.1",
@@ -35,6 +35,7 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "CHANGELOG.md",
     "dist",
     "LICENSE",
     "README.md"
@@ -66,5 +67,5 @@
     "strict": true
   },
   "types": "./dist/src/index.d.ts",
-  "version": "0.0.4"
+  "version": "0.0.6"
 }