@coinagerie/configuration 0.0.0-stage → 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md ADDED
@@ -0,0 +1,13 @@
1
+ ## 0.0.1 (2026-11-04)
2
+
3
+ ### 🚀 Features
4
+
5
+ - **coinagerie:** 📦️ publish coinagerie to npm ([#2088](https://github.com/organizzolini/codebase/pull/2088), [#1793](https://github.com/organizzolini/codebase/issues/1793))
6
+ - **configuration,coinagerie:** ✨ adopt coinagerie with a root glossary ([#1888](https://github.com/organizzolini/codebase/pull/1888), [#1785](https://github.com/organizzolini/codebase/issues/1785))
7
+ - **coinagerie:** ✨ write json glossaries and override configuration with flags ([#1880](https://github.com/organizzolini/codebase/pull/1880), [#1766](https://github.com/organizzolini/codebase/issues/1766))
8
+ - **coinagerie:** ✨ fold word forms and exclude configured words ([#1882](https://github.com/organizzolini/codebase/pull/1882), [#1762](https://github.com/organizzolini/codebase/issues/1762))
9
+ - **coinagerie:** ✨ build a markdown glossary from typescript ([#1875](https://github.com/organizzolini/codebase/pull/1875), [#1755](https://github.com/organizzolini/codebase/issues/1755))
10
+
11
+ ### 🧱 Updated Dependencies
12
+
13
+ - Updated coinagerie-core to 0.0.1
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Jimmy Paolini
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,420 @@
1
- # Temporary Holding Version
1
+ # @coinagerie/configuration
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ [![npm](https://img.shields.io/npm/v/@coinagerie/configuration?logo=npm&label=npm)](https://www.npmjs.com/package/@coinagerie/configuration)
4
+
5
+ The configuration schema, loader, and command-line flag resolution for coinagerie. It reads a `coinagerie.config.ts` and resolves the folder a run scans, what it includes and excludes, and where its glossaries are written.
6
+
7
+ ```bash
8
+ npm install @coinagerie/configuration
9
+ ```
10
+
11
+ ## Test
12
+
13
+ ```bash
14
+ nx run coinagerie-configuration:vitest
15
+ ```
16
+
17
+ ## 👔 Conformetry
18
+
19
+ This project was generated from the [nestjs-service-project](../../configuration/conformetry-templates/nestjs-service-project) conformetry template.
20
+
21
+ <!-- coinagerie:start -->
22
+
23
+ ## 🪙 Coinagerie
24
+
25
+ The words this package uses that the root glossary does not define, regenerated with `nx run coinagerie-configuration:coinagerie-check:write`.
26
+
27
+ - **absolute**:
28
+ - **after**:
29
+ - **array**:
30
+ - **breadth**:
31
+ - **bug**:
32
+ - **clear**:
33
+ - **compile**:
34
+ - **compiler**:
35
+ - **console**:
36
+ - **constant**:
37
+ - **controller**:
38
+ - **custom**:
39
+ - **decorator**:
40
+ - **define**:
41
+ - **describe**:
42
+ - **discriminate**:
43
+ - **each**:
44
+ - **equal**:
45
+ - **experimental**:
46
+ - **fake**:
47
+ - **field**:
48
+ - **flag**:
49
+ - **forbid**:
50
+ - **force**:
51
+ - **gitkeep**:
52
+ - **homepage**:
53
+ - **implementation**:
54
+ - **injectable**:
55
+ - **invalid**:
56
+ - **least**:
57
+ - **length**:
58
+ - **literal**:
59
+ - **load**:
60
+ - **locate**:
61
+ - **location**:
62
+ - **maximum**:
63
+ - **meta**:
64
+ - **min**:
65
+ - **mkdtemp**:
66
+ - **mock**:
67
+ - **optional**:
68
+ - **prettify**:
69
+ - **promise**:
70
+ - **publish**:
71
+ - **real**:
72
+ - **reason**:
73
+ - **recursive**:
74
+ - **refine**:
75
+ - **regex**:
76
+ - **reject**:
77
+ - **relative**:
78
+ - **resolution**:
79
+ - **safe**:
80
+ - **sort**:
81
+ - **spy**:
82
+ - **strict**:
83
+ - **stringify**:
84
+ - **success**:
85
+ - **synthetic**:
86
+ - **temporary**:
87
+ - **timer**:
88
+ - **vi**:
89
+
90
+ <!-- coinagerie:end -->
91
+
92
+ <!-- callidescope:start -->
93
+
94
+ ## 🔭 Callidescope
95
+
96
+ Call stacks traced through `projects/ic-suite/coinagerie/coinagerie-configuration`, deepest first. Each frame shows what it takes, what it returns, and what its documentation says.
97
+
98
+ | Measure | Value |
99
+ | --- | --- |
100
+ | Callables | 14 |
101
+ | Files | 12 |
102
+ | Calls traced | 20 |
103
+ | Call stacks | 1 |
104
+ | Deepest stack | 2 |
105
+ | Stacks through recursion | 0 |
106
+ | Unfollowable calls | 2 |
107
+
108
+ ### Limits
109
+
110
+ What this project is judged against, as declared in its own `callidescope.config.ts`.
111
+
112
+ | Limit | Value |
113
+ | --- | --- |
114
+ | `maximumDepth` | 3 |
115
+ | `maximumBreadth` | 3 |
116
+
117
+ ### Call stacks (depth)
118
+
119
+ **1. `ConfigurationService.anonymous`** — depth ≥ 2 · orphan-root
120
+
121
+ ```text
122
+ 🚀 ConfigurationService.anonymous(word: string): string [projects/ic-suite/coinagerie/coinagerie-configuration/src/modules/configuration/configuration.service.ts:66]
123
+ └─> InvalidConfigurationError.constructor(filePath: string, reason: string): InvalidConfigurationError [projects/ic-suite/coinagerie/coinagerie-core/src/modules/coinagerie-core/coinagerie-core.constants.ts:32]
124
+ ```
125
+
126
+ ### Breadth
127
+
128
+ | Callable | Breadth | Calls directly | Location |
129
+ | --- | --- | --- | --- |
130
+ | `ConfigurationService.locate` | 3 | `ConfigurationFileNotFoundError.constructor`, `ConfigurationService.find(…)`, `ConfigurationService.map(…)` | `projects/ic-suite/coinagerie/coinagerie-configuration/src/modules/configuration/configuration.service.ts:98` |
131
+ | `ConfigurationService.read` | 3 | `InvalidConfigurationError.constructor`, `ConfigurationService.describe`, `ConfigurationService.resolveWords` | `projects/ic-suite/coinagerie/coinagerie-configuration/src/modules/configuration/configuration.service.ts:168` |
132
+ | `ConfigurationService.resolve` | 3 | `InvalidConfigurationError.constructor`, `ConfigurationService.override`, `ConfigurationService.guardFold` | `projects/ic-suite/coinagerie/coinagerie-configuration/src/modules/configuration/configuration.service.ts:204` |
133
+
134
+ <details>
135
+ <summary>2 more callables</summary>
136
+
137
+ | Callable | Breadth | Calls directly | Location |
138
+ | --- | --- | --- | --- |
139
+ | `ConfigurationService.loadConfiguration` | 3 | `ConfigurationService.locate`, `ConfigurationService.resolve`, `ConfigurationService.read` | `projects/ic-suite/coinagerie/coinagerie-configuration/src/modules/configuration/configuration.service.ts:299` |
140
+ | `ConfigurationService.anonymous` | 2 | `InvalidConfigurationError.constructor`, `ConfigurationService.describe` | `projects/ic-suite/coinagerie/coinagerie-configuration/src/modules/configuration/configuration.service.ts:66` |
141
+
142
+ </details>
143
+ <!-- callidescope:end -->
144
+
145
+ ## 🕸️ Codependix
146
+
147
+ Dependency graphs exported by [codependix](https://github.com/Organizzolini/codebase/tree/main/projects/ic-suite/codependix/codependix-cli), regenerated by `nx run configuration:codependix:write`.
148
+
149
+ ### Nx Neighborhood
150
+
151
+ <!-- codependix:start name="codependix-nx-projects" -->
152
+ ```mermaid
153
+ graph LR
154
+ coinagerie_cli["coinagerie-cli"]
155
+ coinagerie_configuration["coinagerie-configuration"]
156
+ coinagerie_core["coinagerie-core"]
157
+ coinagerie_nx["coinagerie-nx"]
158
+ coinagerie_output["coinagerie-output"]
159
+ coinagerie_vocabulary["coinagerie-vocabulary"]
160
+ coinagerie_cli --> coinagerie_configuration
161
+ coinagerie_configuration --> coinagerie_core
162
+ coinagerie_nx --> coinagerie_configuration
163
+ coinagerie_output --> coinagerie_configuration
164
+ coinagerie_vocabulary --> coinagerie_configuration
165
+ classDef subject fill:#7c3aed,color:#fff,stroke:#4c1d95,stroke-width:2px
166
+ class coinagerie_configuration subject
167
+ ```
168
+ <!-- codependix:end name="codependix-nx-projects" -->
169
+
170
+ ### NestJS Module Graph
171
+
172
+ <!-- codependix:start name="codependix-nestjs-modules" -->
173
+ ```mermaid
174
+ flowchart LR
175
+ ConfigurationModule
176
+ ```
177
+ <!-- codependix:end name="codependix-nestjs-modules" -->
178
+
179
+ ### File Imports
180
+
181
+ <!-- codependix:start name="codependix-file-imports" -->
182
+ ```mermaid
183
+ graph LR
184
+ file_callidescope_config_ts["callidescope.config.ts"]
185
+ file_codependix_config_ts["codependix.config.ts"]
186
+ file_codometer_config_ts["codometer.config.ts"]
187
+ file_coinagerie_config_ts["coinagerie.config.ts"]
188
+ file_eslint_config_ts["eslint.config.ts"]
189
+ file_src_index_ts["src/index.ts"]
190
+ file_src_index_unit_test_ts["src/index.unit.test.ts"]
191
+ file_src_modules_configuration_configuration_constants_ts["src/modules/configuration/configuration.constants.ts"]
192
+ file_src_modules_configuration_configuration_module_ts["src/modules/configuration/configuration.module.ts"]
193
+ file_src_modules_configuration_configuration_service_ts["src/modules/configuration/configuration.service.ts"]
194
+ file_src_modules_configuration_configuration_service_unit_test_ts["src/modules/configuration/configuration.service.unit.test.ts"]
195
+ file_src_modules_configuration_configuration_types_ts["src/modules/configuration/configuration.types.ts"]
196
+ file_testing_mocks_ts["testing/mocks.ts"]
197
+ file_testing_setup_ts["testing/setup.ts"]
198
+ file_vite_config_ts["vite.config.ts"]
199
+ file_vitest_config_ts["vitest.config.ts"]
200
+ file_src_index_unit_test_ts --> file_src_index_ts
201
+ file_src_modules_configuration_configuration_constants_ts --> file_src_modules_configuration_configuration_types_ts
202
+ file_src_modules_configuration_configuration_module_ts --> file_src_modules_configuration_configuration_service_ts
203
+ file_src_modules_configuration_configuration_service_ts --> file_src_modules_configuration_configuration_constants_ts
204
+ file_src_modules_configuration_configuration_service_ts --> file_src_modules_configuration_configuration_types_ts
205
+ file_src_modules_configuration_configuration_service_unit_test_ts --> file_src_modules_configuration_configuration_constants_ts
206
+ file_src_modules_configuration_configuration_service_unit_test_ts --> file_src_modules_configuration_configuration_service_ts
207
+ ```
208
+ <!-- codependix:end name="codependix-file-imports" -->
209
+
210
+ <!-- codometer:start -->
211
+
212
+ ## ⏲️ Codometer
213
+
214
+ ### Project
215
+
216
+ ![Lines of Code](https://img.shields.io/badge/Lines_of_Code-1292-22c55e?style=flat-square)
217
+ ![Repository Size](https://img.shields.io/badge/Repository_Size-53.32_kB-6b7280?style=flat-square)
218
+ ![Folders](https://img.shields.io/badge/Folders-4-4a4a4a?style=flat-square)
219
+ ![Source Files](https://img.shields.io/badge/Source_Files-16-3178c6?style=flat-square)
220
+
221
+ ### TypeScript
222
+
223
+ ![TypeScript Files](https://img.shields.io/badge/TypeScript_Files-16-3178c6?style=flat-square)
224
+ ![Interfaces](https://img.shields.io/badge/Interfaces-10-0ea5e9?style=flat-square)
225
+ ![Generic Declarations](https://img.shields.io/badge/Generic_Declarations-0-0369a1?style=flat-square)
226
+ ![Enums](https://img.shields.io/badge/Enums-0-f97316?style=flat-square)
227
+ ![Decorators](https://img.shields.io/badge/Decorators-2-db2777?style=flat-square)
228
+ ![Doc Comments](https://img.shields.io/badge/Doc_Comments-52-6366f1?style=flat-square)
229
+ ![Static Methods](https://img.shields.io/badge/Static_Methods-0-166534?style=flat-square)
230
+
231
+ ### JavaScript
232
+
233
+ ![JavaScript Files](https://img.shields.io/badge/JavaScript_Files-0-f7df1e?style=flat-square)
234
+ ![Test Files](https://img.shields.io/badge/Test_Files-2-10b981?style=flat-square)
235
+ ![External Packages](https://img.shields.io/badge/External_Packages-10-8b5cf6?style=flat-square)
236
+ ![Classes](https://img.shields.io/badge/Classes-2-7c3aed?style=flat-square)
237
+ ![Functions](https://img.shields.io/badge/Functions-41-16a34a?style=flat-square)
238
+ ![Methods](https://img.shields.io/badge/Methods-11-15803d?style=flat-square)
239
+ ![Sync Functions](https://img.shields.io/badge/Sync_Functions-29-4ade80?style=flat-square)
240
+ ![Async Functions](https://img.shields.io/badge/Async_Functions-23-059669?style=flat-square)
241
+ ![Constants](https://img.shields.io/badge/Constants-56-dc2626?style=flat-square)
242
+ ![Imports](https://img.shields.io/badge/Imports-36-0284c7?style=flat-square)
243
+ ![Exported Symbols](https://img.shields.io/badge/Exported_Symbols-24-ea580c?style=flat-square)
244
+ ![Comments](https://img.shields.io/badge/Comments-65-64748b?style=flat-square)
245
+ ![Comment Lines](https://img.shields.io/badge/Comment_Lines-171-475569?style=flat-square)
246
+ ![TODO Comments](https://img.shields.io/badge/TODO_Comments-0-ca8a04?style=flat-square)
247
+
248
+ ### Python
249
+
250
+ ![Python Files](https://img.shields.io/badge/Python_Files-0-3776ab?style=flat-square)
251
+ ![Python Lines](https://img.shields.io/badge/Python_Lines-0-4b8bbe?style=flat-square)
252
+ ![Python Classes](https://img.shields.io/badge/Python_Classes-0-7c3aed?style=flat-square)
253
+ ![Python Functions](https://img.shields.io/badge/Python_Functions-0-16a34a?style=flat-square)
254
+ ![Python Protocols](https://img.shields.io/badge/Python_Protocols-0-0ea5e9?style=flat-square)
255
+ ![Python Constants](https://img.shields.io/badge/Python_Constants-0-dc2626?style=flat-square)
256
+ ![Python Imports](https://img.shields.io/badge/Python_Imports-0-0284c7?style=flat-square)
257
+ ![Python Decorators](https://img.shields.io/badge/Python_Decorators-0-db2777?style=flat-square)
258
+ ![Docstrings](https://img.shields.io/badge/Docstrings-0-6366f1?style=flat-square)
259
+ ![Docstring Lines](https://img.shields.io/badge/Docstring_Lines-0-818cf8?style=flat-square)
260
+ ![Python Comments](https://img.shields.io/badge/Python_Comments-0-64748b?style=flat-square)
261
+ ![Python Comment Lines](https://img.shields.io/badge/Python_Comment_Lines-0-475569?style=flat-square)
262
+
263
+ ### JSON
264
+
265
+ ![JSON Files](https://img.shields.io/badge/JSON_Files-4-a16207?style=flat-square)
266
+ ![JSON Lines](https://img.shields.io/badge/JSON_Lines-157-ca8a04?style=flat-square)
267
+ ![JSON Objects](https://img.shields.io/badge/JSON_Objects-37-7c3aed?style=flat-square)
268
+ ![JSON Arrays](https://img.shields.io/badge/JSON_Arrays-12-8b5cf6?style=flat-square)
269
+ ![JSON Properties](https://img.shields.io/badge/JSON_Properties-96-0284c7?style=flat-square)
270
+ ![JSON Strings](https://img.shields.io/badge/JSON_Strings-86-16a34a?style=flat-square)
271
+ ![JSON Numbers](https://img.shields.io/badge/JSON_Numbers-1-059669?style=flat-square)
272
+ ![JSON Booleans](https://img.shields.io/badge/JSON_Booleans-6-0ea5e9?style=flat-square)
273
+ ![JSON Nulls](https://img.shields.io/badge/JSON_Nulls-0-64748b?style=flat-square)
274
+ ![JSON Items](https://img.shields.io/badge/JSON_Items-42-475569?style=flat-square)
275
+ ![JSON Nodes](https://img.shields.io/badge/JSON_Nodes-142-dc2626?style=flat-square)
276
+ ![JSON Max Depth](https://img.shields.io/badge/JSON_Max_Depth-5-ea580c?style=flat-square)
277
+
278
+ ### YAML
279
+
280
+ ![YAML Files](https://img.shields.io/badge/YAML_Files-0-cb171e?style=flat-square)
281
+ ![YAML Lines](https://img.shields.io/badge/YAML_Lines-0-e34c26?style=flat-square)
282
+ ![YAML Documents](https://img.shields.io/badge/YAML_Documents-0-f97316?style=flat-square)
283
+ ![YAML Mappings](https://img.shields.io/badge/YAML_Mappings-0-7c3aed?style=flat-square)
284
+ ![YAML Sequences](https://img.shields.io/badge/YAML_Sequences-0-8b5cf6?style=flat-square)
285
+ ![YAML Keys](https://img.shields.io/badge/YAML_Keys-0-0284c7?style=flat-square)
286
+ ![YAML Scalars](https://img.shields.io/badge/YAML_Scalars-0-16a34a?style=flat-square)
287
+ ![YAML Anchors](https://img.shields.io/badge/YAML_Anchors-0-059669?style=flat-square)
288
+ ![YAML Aliases](https://img.shields.io/badge/YAML_Aliases-0-10b981?style=flat-square)
289
+ ![YAML Comments](https://img.shields.io/badge/YAML_Comments-0-64748b?style=flat-square)
290
+ ![YAML Max Depth](https://img.shields.io/badge/YAML_Max_Depth-0-ea580c?style=flat-square)
291
+
292
+ ### TOML
293
+
294
+ ![TOML Files](https://img.shields.io/badge/TOML_Files-0-9c4221?style=flat-square)
295
+ ![TOML Lines](https://img.shields.io/badge/TOML_Lines-0-b45309?style=flat-square)
296
+ ![TOML Tables](https://img.shields.io/badge/TOML_Tables-0-7c3aed?style=flat-square)
297
+ ![TOML Array Tables](https://img.shields.io/badge/TOML_Array_Tables-0-8b5cf6?style=flat-square)
298
+ ![TOML Keys](https://img.shields.io/badge/TOML_Keys-0-0284c7?style=flat-square)
299
+ ![TOML Arrays](https://img.shields.io/badge/TOML_Arrays-0-16a34a?style=flat-square)
300
+ ![TOML Comments](https://img.shields.io/badge/TOML_Comments-0-64748b?style=flat-square)
301
+
302
+ ### Shell
303
+
304
+ ![Shell Files](https://img.shields.io/badge/Shell_Files-0-89e051?style=flat-square)
305
+ ![Shell Lines](https://img.shields.io/badge/Shell_Lines-0-4eaa25?style=flat-square)
306
+ ![Shell Functions](https://img.shields.io/badge/Shell_Functions-0-16a34a?style=flat-square)
307
+ ![Shell Variables](https://img.shields.io/badge/Shell_Variables-0-0284c7?style=flat-square)
308
+ ![Shell Exports](https://img.shields.io/badge/Shell_Exports-0-ea580c?style=flat-square)
309
+ ![Shell Conditionals](https://img.shields.io/badge/Shell_Conditionals-0-7c3aed?style=flat-square)
310
+ ![Shell Loops](https://img.shields.io/badge/Shell_Loops-0-8b5cf6?style=flat-square)
311
+ ![Shell Pipelines](https://img.shields.io/badge/Shell_Pipelines-0-059669?style=flat-square)
312
+ ![Shebangs](https://img.shields.io/badge/Shebangs-0-6b7280?style=flat-square)
313
+ ![Shell Comments](https://img.shields.io/badge/Shell_Comments-0-64748b?style=flat-square)
314
+ ![Shell Comment Lines](https://img.shields.io/badge/Shell_Comment_Lines-0-475569?style=flat-square)
315
+
316
+ ### SQL
317
+
318
+ ![SQL Files](https://img.shields.io/badge/SQL_Files-0-e38c00?style=flat-square)
319
+ ![SQL Lines](https://img.shields.io/badge/SQL_Lines-0-f29111?style=flat-square)
320
+ ![SQL Statements](https://img.shields.io/badge/SQL_Statements-0-7c3aed?style=flat-square)
321
+ ![SQL Selects](https://img.shields.io/badge/SQL_Selects-0-16a34a?style=flat-square)
322
+ ![SQL Inserts](https://img.shields.io/badge/SQL_Inserts-0-22c55e?style=flat-square)
323
+ ![SQL Updates](https://img.shields.io/badge/SQL_Updates-0-0ea5e9?style=flat-square)
324
+ ![SQL Deletes](https://img.shields.io/badge/SQL_Deletes-0-dc2626?style=flat-square)
325
+ ![SQL Creates](https://img.shields.io/badge/SQL_Creates-0-0284c7?style=flat-square)
326
+ ![SQL Joins](https://img.shields.io/badge/SQL_Joins-0-8b5cf6?style=flat-square)
327
+ ![SQL CTEs](https://img.shields.io/badge/SQL_CTEs-0-059669?style=flat-square)
328
+ ![SQL Comments](https://img.shields.io/badge/SQL_Comments-0-64748b?style=flat-square)
329
+
330
+ ### HCL
331
+
332
+ ![HCL Files](https://img.shields.io/badge/HCL_Files-0-844fba?style=flat-square)
333
+ ![HCL Lines](https://img.shields.io/badge/HCL_Lines-0-a78bfa?style=flat-square)
334
+ ![HCL Blocks](https://img.shields.io/badge/HCL_Blocks-0-7c3aed?style=flat-square)
335
+ ![HCL Resources](https://img.shields.io/badge/HCL_Resources-0-0284c7?style=flat-square)
336
+ ![HCL Variables](https://img.shields.io/badge/HCL_Variables-0-16a34a?style=flat-square)
337
+ ![HCL Outputs](https://img.shields.io/badge/HCL_Outputs-0-059669?style=flat-square)
338
+ ![HCL Attributes](https://img.shields.io/badge/HCL_Attributes-0-0ea5e9?style=flat-square)
339
+ ![HCL Interpolations](https://img.shields.io/badge/HCL_Interpolations-0-db2777?style=flat-square)
340
+ ![HCL Comments](https://img.shields.io/badge/HCL_Comments-0-64748b?style=flat-square)
341
+
342
+ ### CSS
343
+
344
+ ![CSS Files](https://img.shields.io/badge/CSS_Files-0-264de4?style=flat-square)
345
+ ![CSS Lines](https://img.shields.io/badge/CSS_Lines-0-2965f1?style=flat-square)
346
+ ![CSS Rules](https://img.shields.io/badge/CSS_Rules-0-7c3aed?style=flat-square)
347
+ ![CSS Selectors](https://img.shields.io/badge/CSS_Selectors-0-8b5cf6?style=flat-square)
348
+ ![CSS Declarations](https://img.shields.io/badge/CSS_Declarations-0-0284c7?style=flat-square)
349
+ ![CSS At Rules](https://img.shields.io/badge/CSS_At_Rules-0-f97316?style=flat-square)
350
+ ![CSS Media Queries](https://img.shields.io/badge/CSS_Media_Queries-0-ea580c?style=flat-square)
351
+ ![CSS Custom Properties](https://img.shields.io/badge/CSS_Custom_Properties-0-16a34a?style=flat-square)
352
+ ![CSS Comments](https://img.shields.io/badge/CSS_Comments-0-64748b?style=flat-square)
353
+
354
+ ### Conventions
355
+
356
+ ![Module Files](https://img.shields.io/badge/Module_Files-1-7c3aed?style=flat-square)
357
+ ![Service Files](https://img.shields.io/badge/Service_Files-1-0284c7?style=flat-square)
358
+ ![Command Files](https://img.shields.io/badge/Command_Files-0-16a34a?style=flat-square)
359
+ ![Constants Files](https://img.shields.io/badge/Constants_Files-1-ea580c?style=flat-square)
360
+ ![Types Files](https://img.shields.io/badge/Types_Files-1-db2777?style=flat-square)
361
+ ![Utilities Files](https://img.shields.io/badge/Utilities_Files-0-0ea5e9?style=flat-square)
362
+ ![TypeORM Entities](https://img.shields.io/badge/TypeORM_Entities-0-059669?style=flat-square)
363
+ ![Unit Tests](https://img.shields.io/badge/Unit_Tests-2-ca8a04?style=flat-square)
364
+ ![Integration Tests](https://img.shields.io/badge/Integration_Tests-0-7c3aed?style=flat-square)
365
+ ![End To End Tests](https://img.shields.io/badge/End_To_End_Tests-0-0284c7?style=flat-square)
366
+ ![CSS Comment Budget](https://img.shields.io/badge/CSS_Comment_Budget-0-16a34a?style=flat-square)
367
+ ![HCL Comment Budget](https://img.shields.io/badge/HCL_Comment_Budget-0-ea580c?style=flat-square)
368
+ ![Python Comment Budget](https://img.shields.io/badge/Python_Comment_Budget-0-db2777?style=flat-square)
369
+ ![SQL Comment Budget](https://img.shields.io/badge/SQL_Comment_Budget-0-0ea5e9?style=flat-square)
370
+ ![TOML Comment Budget](https://img.shields.io/badge/TOML_Comment_Budget-0-059669?style=flat-square)
371
+ ![TypeScript Comment Budget](https://img.shields.io/badge/TypeScript_Comment_Budget-0-ca8a04?style=flat-square)
372
+ ![YAML Comment Budget](https://img.shields.io/badge/YAML_Comment_Budget-0-7c3aed?style=flat-square)
373
+ ![Shell Comment Budget](https://img.shields.io/badge/Shell_Comment_Budget-0-0284c7?style=flat-square)
374
+
375
+ ### Jupyter
376
+
377
+ ![Notebooks](https://img.shields.io/badge/Notebooks-0-f37626?style=flat-square)
378
+ ![Notebook Cells](https://img.shields.io/badge/Notebook_Cells-0-e8a33d?style=flat-square)
379
+ ![Code Cells](https://img.shields.io/badge/Code_Cells-0-3776ab?style=flat-square)
380
+ ![Markdown Cells](https://img.shields.io/badge/Markdown_Cells-0-083fa1?style=flat-square)
381
+ ![Raw Cells](https://img.shields.io/badge/Raw_Cells-0-9ca3af?style=flat-square)
382
+ ![Executed Cells](https://img.shields.io/badge/Executed_Cells-0-16a34a?style=flat-square)
383
+ ![Cell Outputs](https://img.shields.io/badge/Cell_Outputs-0-059669?style=flat-square)
384
+ ![Notebook Code Lines](https://img.shields.io/badge/Notebook_Code_Lines-0-4b8bbe?style=flat-square)
385
+ ![Notebook Classes](https://img.shields.io/badge/Notebook_Classes-0-7c3aed?style=flat-square)
386
+ ![Notebook Functions](https://img.shields.io/badge/Notebook_Functions-0-22c55e?style=flat-square)
387
+ ![Notebook Imports](https://img.shields.io/badge/Notebook_Imports-0-0284c7?style=flat-square)
388
+ ![Notebook Decorators](https://img.shields.io/badge/Notebook_Decorators-0-db2777?style=flat-square)
389
+ ![Notebook Prose Lines](https://img.shields.io/badge/Notebook_Prose_Lines-0-1f6feb?style=flat-square)
390
+ ![Notebook Headings](https://img.shields.io/badge/Notebook_Headings-0-a78bfa?style=flat-square)
391
+ ![Notebook Links](https://img.shields.io/badge/Notebook_Links-0-10b981?style=flat-square)
392
+ ![Notebook Images](https://img.shields.io/badge/Notebook_Images-0-34d399?style=flat-square)
393
+ ![Notebook Code Blocks](https://img.shields.io/badge/Notebook_Code_Blocks-0-dc2626?style=flat-square)
394
+ ![Notebook Properties](https://img.shields.io/badge/Notebook_Properties-0-ca8a04?style=flat-square)
395
+ ![Notebook Nodes](https://img.shields.io/badge/Notebook_Nodes-0-a16207?style=flat-square)
396
+ ![Notebook Max Depth](https://img.shields.io/badge/Notebook_Max_Depth-0-ea580c?style=flat-square)
397
+
398
+ ### Markdown
399
+
400
+ ![Markdown Files](https://img.shields.io/badge/Markdown_Files-2-083fa1?style=flat-square)
401
+ ![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-235-1f6feb?style=flat-square)
402
+ ![H1](https://img.shields.io/badge/H1-1-7c3aed?style=flat-square)
403
+ ![H2](https://img.shields.io/badge/H2-8-8b5cf6?style=flat-square)
404
+ ![H3](https://img.shields.io/badge/H3-14-a78bfa?style=flat-square)
405
+ ![H4](https://img.shields.io/badge/H4-0-c4b5fd?style=flat-square)
406
+ ![H5](https://img.shields.io/badge/H5-0-ddd6fe?style=flat-square)
407
+ ![H6](https://img.shields.io/badge/H6-0-ede9fe?style=flat-square)
408
+ ![Paragraphs](https://img.shields.io/badge/Paragraphs-51-64748b?style=flat-square)
409
+ ![Lists](https://img.shields.io/badge/Lists-8-16a34a?style=flat-square)
410
+ ![List Items](https://img.shields.io/badge/List_Items-31-22c55e?style=flat-square)
411
+ ![Task List Items](https://img.shields.io/badge/Task_List_Items-0-4ade80?style=flat-square)
412
+ ![Tables](https://img.shields.io/badge/Tables-2-0284c7?style=flat-square)
413
+ ![Table Rows](https://img.shields.io/badge/Table_Rows-10-0ea5e9?style=flat-square)
414
+ ![Links](https://img.shields.io/badge/Links-19-059669?style=flat-square)
415
+ ![Images](https://img.shields.io/badge/Images-0-10b981?style=flat-square)
416
+ ![Code Blocks](https://img.shields.io/badge/Code_Blocks-11-dc2626?style=flat-square)
417
+ ![Inline Code](https://img.shields.io/badge/Inline_Code-72-ef4444?style=flat-square)
418
+ ![Block Quotes](https://img.shields.io/badge/Block_Quotes-0-ca8a04?style=flat-square)
419
+ ![Thematic Breaks](https://img.shields.io/badge/Thematic_Breaks-0-a16207?style=flat-square)
420
+ <!-- codometer:end -->
@@ -0,0 +1,232 @@
1
+ /**
2
+ * What a `coinagerie.config.ts` exports by default.
3
+ *
4
+ * Every field is optional, and every path in it is relative to the folder the
5
+ * file sits in — that folder is also the root the run scans.
6
+ */
7
+ export declare interface CoinagerieConfiguration {
8
+ exclude?: CoinagerieExclusions | undefined;
9
+ /**
10
+ * Merges a derivational family into one headword, such as `configuration`
11
+ * into `configure`. Runs after plurals and inflections have been folded, so
12
+ * it sees lemmas rather than every surface form, and must return a
13
+ * non-empty string.
14
+ */
15
+ fold?: FoldWord | undefined;
16
+ /**
17
+ * Globs naming the files the run scans, matched with `path.matchesGlob`.
18
+ * Defaults to every file, dot-files included.
19
+ */
20
+ include?: string[] | undefined;
21
+ /** Where the glossary is kept. With none, a run only prints it. */
22
+ outputs?: CoinagerieOutput[] | undefined;
23
+ }
24
+
25
+ /** What a run leaves out, on top of whatever `.gitignore` already ignores. */
26
+ export declare interface CoinagerieExclusions {
27
+ /** Globs naming files left out of the scan. */
28
+ paths?: string[] | undefined;
29
+ /**
30
+ * Words left out of the glossary, as a list or as a function returning one,
31
+ * synchronously or not — the function is where a configuration reads
32
+ * whatever else it wants to exclude. Exclusion applies after folding, so
33
+ * excluding `service` also covers `services`. Defaults to none.
34
+ */
35
+ words?: ExcludedWords | undefined;
36
+ }
37
+
38
+ /**
39
+ * A JSON destination: the whole file is the glossary, a flat object sorted by
40
+ * word with `""` for a word nobody has defined yet.
41
+ */
42
+ export declare interface CoinagerieJsonOutput {
43
+ path: string;
44
+ type: "json";
45
+ }
46
+
47
+ /**
48
+ * A markdown destination: the glossary block is kept between the
49
+ * `coinagerie:start` and `coinagerie:end` anchors of this file, and appended
50
+ * to its end when the file has no anchors yet.
51
+ */
52
+ export declare interface CoinagerieMarkdownOutput {
53
+ /** Rendered under the heading, telling a reader what the block is. */
54
+ description?: string | undefined;
55
+ path: string;
56
+ type: "markdown";
57
+ }
58
+
59
+ /** One place a glossary is kept. */
60
+ export declare type CoinagerieOutput = CoinagerieJsonOutput | CoinagerieMarkdownOutput;
61
+
62
+ /**
63
+ * File names a run looks for in its working directory when no `--config` is
64
+ * given, in order of preference.
65
+ */
66
+ export declare const CONFIGURATION_FILE_NAMES: readonly ["coinagerie.config.ts", "coinagerie.config.mts", "coinagerie.config.cts", "coinagerie.config.js", "coinagerie.config.mjs", "coinagerie.config.cjs"];
67
+
68
+ /**
69
+ * Provides the configuration layer: reading a `coinagerie.config.ts` into a
70
+ * configuration every other coinagerie package can trust.
71
+ */
72
+ export declare class ConfigurationModule {
73
+ }
74
+
75
+ /**
76
+ * What the command line says, layered over the configuration file: a flag
77
+ * that is given replaces the field it names, and a field with no flag keeps
78
+ * what the file says.
79
+ *
80
+ * The two destination flags together replace the file's `outputs` with just
81
+ * the destinations they name. Their paths are relative to the working
82
+ * directory, as a path typed in a shell is; globs stay relative to the scan
83
+ * root.
84
+ */
85
+ export declare interface ConfigurationOverrides {
86
+ /** Replaces the description of every markdown destination. */
87
+ description?: string | undefined;
88
+ /** Replaces `exclude.paths`. */
89
+ excludePaths?: string[] | undefined;
90
+ /** Replaces `include`. */
91
+ include?: string[] | undefined;
92
+ /** A JSON destination that replaces the file's `outputs`. */
93
+ outputJson?: string | undefined;
94
+ /** A markdown destination that replaces the file's `outputs`. */
95
+ outputMarkdown?: string | undefined;
96
+ }
97
+
98
+ /**
99
+ * Finds, reads, validates, and resolves a `coinagerie.config.ts`.
100
+ *
101
+ * The one place a configuration is interpreted: what leaves here has every
102
+ * default filled in and every path made absolute, so nothing downstream has
103
+ * to know how the run was configured.
104
+ */
105
+ export declare class ConfigurationService {
106
+ constructor();
107
+ /** A caught value as text, whether or not it is an `Error`. */
108
+ private describe;
109
+ /**
110
+ * Wraps the configured fold so that its faults name the file.
111
+ *
112
+ * The function is the configuration's own code, and it runs once per word
113
+ * long after the file was read; wrapping it here keeps every check of what
114
+ * it did in the one place that knows the file's path.
115
+ */
116
+ private guardFold;
117
+ /**
118
+ * The configuration file a run reads, or `undefined` when it uses defaults.
119
+ *
120
+ * A named file must exist. An unnamed one is searched for only in the
121
+ * working directory, never above it, so a run never picks up a
122
+ * configuration written for some enclosing folder.
123
+ */
124
+ private locate;
125
+ /**
126
+ * The configuration with the command line's flags laid over it.
127
+ *
128
+ * A flag that is given replaces the field it names, so the file never has
129
+ * to be edited to try a variation.
130
+ */
131
+ private override;
132
+ /**
133
+ * Imports a configuration file, validates its default export, and calls
134
+ * its `exclude.words` function when it has one.
135
+ *
136
+ * Any failure — the file throwing, a syntax error, an export of the wrong
137
+ * shape, a function that throws or returns something else — is reported
138
+ * with the file's path, which is the one thing a reader needs to find the
139
+ * fault.
140
+ */
141
+ private read;
142
+ /** Fills in every default and makes every path absolute. */
143
+ private resolve;
144
+ /**
145
+ * The words a configuration excludes, calling its function when it has one.
146
+ *
147
+ * Throws a plain error for the caller to name the file in, so that no frame
148
+ * is spent on building the report here.
149
+ */
150
+ private resolveWords;
151
+ /**
152
+ * Loads the run's configuration, or the defaults when there is none.
153
+ *
154
+ * The scan root is the configuration file's folder, so a run behaves the
155
+ * same wherever it is invoked from.
156
+ */
157
+ loadConfiguration(args: LoadConfigurationArguments): Promise<ResolvedCoinagerieConfiguration>;
158
+ }
159
+
160
+ /**
161
+ * Globs that together name every file, dot-files included.
162
+ *
163
+ * Three rather than one because `path.matchesGlob` never lets `*` or `**`
164
+ * match a name that starts with a dot: `**` alone would skip `.gitignore` and
165
+ * everything under `.github/`.
166
+ */
167
+ export declare const DEFAULT_INCLUDE: readonly ["**", "**/.*", "**/.*/**"];
168
+
169
+ /** A list of words, or a function that returns one. */
170
+ export declare type ExcludedWords = (() => Promise<string[]> | string[]) | string[];
171
+
172
+ /** A function from a word to the headword it is folded into. */
173
+ export declare type FoldWord = (word: string) => string;
174
+
175
+ /** What `loadConfiguration` is asked for. */
176
+ export declare interface LoadConfigurationArguments {
177
+ /**
178
+ * A configuration file named on the command line, relative to the working
179
+ * directory. Without one, the working directory is searched for a file
180
+ * named in `CONFIGURATION_FILE_NAMES`, and defaults apply when none exists.
181
+ */
182
+ configurationPath?: string | undefined;
183
+ /** What the command line overrides; nothing when absent. */
184
+ overrides?: ConfigurationOverrides | undefined;
185
+ /** Absolute path the command was run from. */
186
+ workingDirectory: string;
187
+ }
188
+
189
+ /**
190
+ * A configuration with every default filled in and every path absolute.
191
+ *
192
+ * What the rest of the toolchain reads: nothing past this point has to know
193
+ * whether a value was written or defaulted.
194
+ */
195
+ export declare interface ResolvedCoinagerieConfiguration {
196
+ /** The file read, or `undefined` when the run uses only defaults. */
197
+ configurationPath: string | undefined;
198
+ /** The root the run scans: the configuration file's folder, or the
199
+ * working directory when there is no file. */
200
+ directory: string;
201
+ /** `words` is the resolved list: a function in the file has been called. */
202
+ exclude: {
203
+ paths: string[];
204
+ words: string[];
205
+ };
206
+ /**
207
+ * The configured fold, wrapped so that a throw or an empty or non-string
208
+ * result raises an `InvalidConfigurationError` naming the file; `undefined`
209
+ * when none is configured.
210
+ */
211
+ fold: FoldWord | undefined;
212
+ include: string[];
213
+ outputs: ResolvedCoinagerieOutput[];
214
+ }
215
+
216
+ /** A JSON destination whose path has been made absolute. */
217
+ export declare interface ResolvedCoinagerieJsonOutput {
218
+ path: string;
219
+ type: "json";
220
+ }
221
+
222
+ /** A markdown destination whose path has been made absolute. */
223
+ export declare interface ResolvedCoinagerieMarkdownOutput {
224
+ description: string | undefined;
225
+ path: string;
226
+ type: "markdown";
227
+ }
228
+
229
+ /** One destination, resolved. */
230
+ export declare type ResolvedCoinagerieOutput = ResolvedCoinagerieJsonOutput | ResolvedCoinagerieMarkdownOutput;
231
+
232
+ export { }
@@ -0,0 +1,184 @@
1
+ import { z as e } from "zod";
2
+ import { Injectable as t, Module as n } from "@nestjs/common";
3
+ import { existsSync as r } from "node:fs";
4
+ import i from "node:path";
5
+ import { fileURLToPath as a } from "node:url";
6
+ import { ConfigurationFileNotFoundError as o, InvalidConfigurationError as s } from "@coinagerie/core";
7
+ import { createJiti as c } from "jiti";
8
+ // \0rolldown/runtime.js
9
+ var l = [
10
+ "coinagerie.config.ts",
11
+ "coinagerie.config.mts",
12
+ "coinagerie.config.cts",
13
+ "coinagerie.config.js",
14
+ "coinagerie.config.mjs",
15
+ "coinagerie.config.cjs"
16
+ ], u = [
17
+ "**",
18
+ "**/.*",
19
+ "**/.*/**"
20
+ ], d = /^\s*(?:[-*+]\s|<!--)/mu, f = e.strictObject({
21
+ path: e.string().min(1),
22
+ type: e.literal("json")
23
+ }), p = e.string().refine((e) => !d.test(e), { message: "A description may not hold a list item or an HTML comment, which would read back as part of the glossary" }), isFunction = (e) => typeof e == "function", m = e.array(e.string()), h = e.string().regex(/^[^\s*]+$/u), g = e.strictObject({
24
+ description: p.optional(),
25
+ path: e.string().min(1),
26
+ type: e.literal("markdown")
27
+ }), _ = e.strictObject({
28
+ description: p.optional(),
29
+ excludePaths: e.array(e.string()).optional(),
30
+ include: e.array(e.string()).optional(),
31
+ outputJson: e.string().min(1).optional(),
32
+ outputMarkdown: e.string().min(1).optional()
33
+ }), v = e.strictObject({
34
+ exclude: e.strictObject({
35
+ paths: e.array(e.string()).optional(),
36
+ words: e.union([e.array(e.string()), e.custom(isFunction, { message: "Expected a list of words or a function returning one" })]).optional()
37
+ }).optional(),
38
+ fold: e.custom(isFunction, { message: "Expected a function" }).optional(),
39
+ include: e.array(e.string()).optional(),
40
+ outputs: e.array(e.discriminatedUnion("type", [f, g])).optional()
41
+ });
42
+ // \0@oxc-project+runtime@0.155.0/helpers/esm/decorateMetadata.js
43
+ function __decorateMetadata(e, t) {
44
+ if (typeof Reflect == "object" && typeof Reflect.metadata == "function") return Reflect.metadata(e, t);
45
+ }
46
+ // \0@oxc-project+runtime@0.155.0/helpers/esm/decorate.js
47
+ function __decorate(e, t, n, r) {
48
+ var i = arguments.length, a = i < 3 ? t : r === null ? r = Object.getOwnPropertyDescriptor(t, n) : r, o;
49
+ if (typeof Reflect == "object" && typeof Reflect.decorate == "function") a = Reflect.decorate(e, t, n, r);
50
+ 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);
51
+ return i > 3 && a && Object.defineProperty(t, n, a), a;
52
+ }
53
+ // src/modules/configuration/configuration.service.ts
54
+ var y = class ConfigurationService {
55
+ constructor() {}
56
+ describe(e) {
57
+ return e instanceof Error ? e.message : String(e);
58
+ }
59
+ guardFold(e, t) {
60
+ return (n) => {
61
+ let r;
62
+ try {
63
+ r = e(n);
64
+ } catch (e) {
65
+ throw new s(t, `fold threw on "${n}": ${this.describe(e)}`);
66
+ }
67
+ let i = h.safeParse(r);
68
+ if (!i.success) throw new s(t, `fold must return a non-empty string without whitespace or "*", but returned ${typeof r == "string" ? JSON.stringify(r) : `a value of type ${typeof r}`} for "${n}"; it must be synchronous`);
69
+ return i.data;
70
+ };
71
+ }
72
+ locate(e) {
73
+ if (e.configurationPath !== void 0) {
74
+ let t = i.resolve(e.workingDirectory, e.configurationPath);
75
+ if (!r(t)) throw new o(t);
76
+ return t;
77
+ }
78
+ return l.map((t) => i.join(e.workingDirectory, t)).find((e) => r(e));
79
+ }
80
+ override(e) {
81
+ let { configuration: t, flags: n, workingDirectory: r } = e, a = [...n.outputJson === void 0 ? [] : [{
82
+ path: i.resolve(r, n.outputJson),
83
+ type: "json"
84
+ }], ...n.outputMarkdown === void 0 ? [] : [{
85
+ path: i.resolve(r, n.outputMarkdown),
86
+ type: "markdown"
87
+ }]], o = a.length > 0 ? a : t.outputs ?? [];
88
+ return {
89
+ exclude: n.excludePaths ? {
90
+ ...t.exclude,
91
+ paths: n.excludePaths
92
+ } : t.exclude,
93
+ fold: t.fold,
94
+ include: n.include ?? t.include,
95
+ outputs: o
96
+ };
97
+ }
98
+ async read(t) {
99
+ let n;
100
+ try {
101
+ n = await c(a(import.meta.url)).import(t, { default: !0 });
102
+ } catch (e) {
103
+ throw new s(t, this.describe(e));
104
+ }
105
+ let r = v.safeParse(n);
106
+ if (!r.success) throw new s(t, e.prettifyError(r.error));
107
+ try {
108
+ return {
109
+ configuration: r.data,
110
+ words: await this.resolveWords(r.data.exclude?.words)
111
+ };
112
+ } catch (e) {
113
+ throw new s(t, `exclude.words ${this.describe(e)}`);
114
+ }
115
+ }
116
+ resolve(t) {
117
+ let { directory: n, location: r } = t, a = _.safeParse(t.overrides ?? {});
118
+ if (!a.success) throw new s("the command line", e.prettifyError(a.error));
119
+ let o = this.override({
120
+ configuration: t.loaded.configuration,
121
+ flags: a.data,
122
+ workingDirectory: t.workingDirectory
123
+ }), c = [], l = /* @__PURE__ */ new Set();
124
+ for (let e of o.outputs ?? []) {
125
+ let r = i.resolve(n, e.path);
126
+ if (l.has(r)) throw new s(t.configurationPath ?? "the command line", `Two outputs name ${r}, and each write would overwrite the other`);
127
+ l.add(r), c.push(e.type === "json" ? {
128
+ path: r,
129
+ type: "json"
130
+ } : {
131
+ description: a.data.description ?? e.description,
132
+ path: r,
133
+ type: "markdown"
134
+ });
135
+ }
136
+ return {
137
+ configurationPath: t.configurationPath,
138
+ directory: n,
139
+ exclude: {
140
+ paths: o.exclude?.paths ?? [],
141
+ words: t.loaded.words
142
+ },
143
+ fold: o.fold === void 0 ? void 0 : this.guardFold(o.fold, r),
144
+ include: o.include ?? [...u],
145
+ outputs: c
146
+ };
147
+ }
148
+ async resolveWords(e) {
149
+ let t = typeof e == "function" ? await e() : e ?? [], n = m.safeParse(t);
150
+ if (!n.success) throw Error("must be a list of strings, or a function returning one");
151
+ return n.data;
152
+ }
153
+ async loadConfiguration(e) {
154
+ let t = this.locate(e);
155
+ return t === void 0 ? this.resolve({
156
+ configurationPath: void 0,
157
+ directory: e.workingDirectory,
158
+ loaded: {
159
+ configuration: {},
160
+ words: []
161
+ },
162
+ location: e.workingDirectory,
163
+ overrides: e.overrides,
164
+ workingDirectory: e.workingDirectory
165
+ }) : this.resolve({
166
+ configurationPath: t,
167
+ directory: i.dirname(t),
168
+ loaded: await this.read(t),
169
+ location: t,
170
+ overrides: e.overrides,
171
+ workingDirectory: e.workingDirectory
172
+ });
173
+ }
174
+ };
175
+ y = __decorate([t(), __decorateMetadata("design:paramtypes", [])], y);
176
+ // src/modules/configuration/configuration.module.ts
177
+ var b = class ConfigurationModule {};
178
+ b = __decorate([n({
179
+ controllers: [],
180
+ exports: [y],
181
+ imports: [],
182
+ providers: [y]
183
+ })], b);
184
+ export { l as CONFIGURATION_FILE_NAMES, b as ConfigurationModule, y as ConfigurationService, u as DEFAULT_INCLUDE };
package/package.json CHANGED
@@ -1,6 +1,63 @@
1
1
  {
2
+ "author": "Jimmy Paolini",
3
+ "bugs": {
4
+ "url": "https://github.com/organizzolini/codebase/issues"
5
+ },
6
+ "dependencies": {
7
+ "@coinagerie/core": "0.0.1",
8
+ "@nestjs/common": "^11.1.21 || ^12.0.1",
9
+ "jiti": "^2.7.0",
10
+ "reflect-metadata": "^0.2.2",
11
+ "zod": "^4.4.3"
12
+ },
13
+ "description": "Configuration schema, loader, and command-line flag resolution for the coinagerie vocabulary toolchain",
14
+ "devDependencies": {
15
+ "@golevelup/ts-vitest": "^4.0.0",
16
+ "@nestjs/testing": "^12.0.1",
17
+ "@nx/eslint-plugin": "^24.0.0",
18
+ "@swc/helpers": "^0.5.21",
19
+ "@types/node": "^26.5.1",
20
+ "@vitest/coverage-v8": "^5.0.0",
21
+ "typescript": "^6.0.3",
22
+ "vitest": "^5.0.0"
23
+ },
24
+ "exports": {
25
+ ".": {
26
+ "types": "./dist/src/index.d.ts",
27
+ "default": "./dist/src/index.js"
28
+ },
29
+ "./package.json": "./package.json"
30
+ },
31
+ "files": [
32
+ "CHANGELOG.md",
33
+ "dist",
34
+ "LICENSE",
35
+ "README.md"
36
+ ],
37
+ "homepage": "https://github.com/organizzolini/codebase/tree/main/projects/ic-suite/coinagerie/coinagerie-configuration#readme",
38
+ "keywords": [
39
+ "coinagerie",
40
+ "configuration",
41
+ "glossary",
42
+ "vocabulary"
43
+ ],
44
+ "license": "MIT",
45
+ "main": "./dist/src/index.js",
2
46
  "name": "@coinagerie/configuration",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
47
+ "publishConfig": {
48
+ "access": "public",
49
+ "registry": "https://registry.npmjs.org"
50
+ },
51
+ "repository": {
52
+ "directory": "projects/ic-suite/coinagerie/coinagerie-configuration",
53
+ "type": "git",
54
+ "url": "git+https://github.com/organizzolini/codebase.git"
55
+ },
56
+ "type": "module",
57
+ "typeCoverage": {
58
+ "atLeast": 100,
59
+ "strict": true
60
+ },
61
+ "types": "./dist/src/index.d.ts",
62
+ "version": "0.0.1"
6
63
  }