@djblackeagle/dev-config-js 0.0.0-stage → 1.0.0

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.
Files changed (88) hide show
  1. package/LICENSE.md +21 -0
  2. package/README.md +541 -2
  3. package/dist/cli/bin.d.ts +3 -0
  4. package/dist/cli/bin.d.ts.map +1 -0
  5. package/dist/cli/bin.js +4 -0
  6. package/dist/cli/bin.js.map +1 -0
  7. package/dist/cli/init.d.ts +30 -0
  8. package/dist/cli/init.d.ts.map +1 -0
  9. package/dist/cli/init.js +168 -0
  10. package/dist/cli/init.js.map +1 -0
  11. package/dist/commitlint/index.d.ts +20 -0
  12. package/dist/commitlint/index.d.ts.map +1 -0
  13. package/dist/commitlint/index.js +25 -0
  14. package/dist/commitlint/index.js.map +1 -0
  15. package/dist/eslint/angular.d.ts +9 -0
  16. package/dist/eslint/angular.d.ts.map +1 -0
  17. package/dist/eslint/angular.js +50 -0
  18. package/dist/eslint/angular.js.map +1 -0
  19. package/dist/eslint/base.d.ts +14 -0
  20. package/dist/eslint/base.d.ts.map +1 -0
  21. package/dist/eslint/base.js +183 -0
  22. package/dist/eslint/base.js.map +1 -0
  23. package/dist/eslint/css.d.ts +16 -0
  24. package/dist/eslint/css.d.ts.map +1 -0
  25. package/dist/eslint/css.js +28 -0
  26. package/dist/eslint/css.js.map +1 -0
  27. package/dist/eslint/index.d.ts +21 -0
  28. package/dist/eslint/index.d.ts.map +1 -0
  29. package/dist/eslint/index.js +46 -0
  30. package/dist/eslint/index.js.map +1 -0
  31. package/dist/eslint/json.d.ts +19 -0
  32. package/dist/eslint/json.d.ts.map +1 -0
  33. package/dist/eslint/json.js +56 -0
  34. package/dist/eslint/json.js.map +1 -0
  35. package/dist/eslint/markdown.d.ts +19 -0
  36. package/dist/eslint/markdown.d.ts.map +1 -0
  37. package/dist/eslint/markdown.js +45 -0
  38. package/dist/eslint/markdown.js.map +1 -0
  39. package/dist/eslint/nestjs.d.ts +5 -0
  40. package/dist/eslint/nestjs.d.ts.map +1 -0
  41. package/dist/eslint/nestjs.js +19 -0
  42. package/dist/eslint/nestjs.js.map +1 -0
  43. package/dist/eslint/package-json.d.ts +16 -0
  44. package/dist/eslint/package-json.d.ts.map +1 -0
  45. package/dist/eslint/package-json.js +22 -0
  46. package/dist/eslint/package-json.js.map +1 -0
  47. package/dist/eslint/prettier.d.ts +5 -0
  48. package/dist/eslint/prettier.d.ts.map +1 -0
  49. package/dist/eslint/prettier.js +5 -0
  50. package/dist/eslint/prettier.js.map +1 -0
  51. package/dist/eslint/vitest.d.ts +6 -0
  52. package/dist/eslint/vitest.d.ts.map +1 -0
  53. package/dist/eslint/vitest.js +19 -0
  54. package/dist/eslint/vitest.js.map +1 -0
  55. package/dist/eslint/yaml.d.ts +17 -0
  56. package/dist/eslint/yaml.d.ts.map +1 -0
  57. package/dist/eslint/yaml.js +36 -0
  58. package/dist/eslint/yaml.js.map +1 -0
  59. package/dist/index.d.ts +8 -0
  60. package/dist/index.d.ts.map +1 -0
  61. package/dist/index.js +8 -0
  62. package/dist/index.js.map +1 -0
  63. package/dist/lint-staged/index.d.ts +13 -0
  64. package/dist/lint-staged/index.d.ts.map +1 -0
  65. package/dist/lint-staged/index.js +20 -0
  66. package/dist/lint-staged/index.js.map +1 -0
  67. package/dist/markdownlint/index.jsonc +14 -0
  68. package/dist/prettier/index.d.ts +5 -0
  69. package/dist/prettier/index.d.ts.map +1 -0
  70. package/dist/prettier/index.js +22 -0
  71. package/dist/prettier/index.js.map +1 -0
  72. package/dist/tsconfig/angular.json +20 -0
  73. package/dist/tsconfig/base.json +29 -0
  74. package/dist/tsconfig/library.json +11 -0
  75. package/dist/tsconfig/nestjs.json +17 -0
  76. package/dist/vitest/base.d.ts +8 -0
  77. package/dist/vitest/base.d.ts.map +1 -0
  78. package/dist/vitest/base.js +39 -0
  79. package/dist/vitest/base.js.map +1 -0
  80. package/dist/vitest/index.d.ts +10 -0
  81. package/dist/vitest/index.d.ts.map +1 -0
  82. package/dist/vitest/index.js +9 -0
  83. package/dist/vitest/index.js.map +1 -0
  84. package/dist/vitest/nestjs.d.ts +7 -0
  85. package/dist/vitest/nestjs.d.ts.map +1 -0
  86. package/dist/vitest/nestjs.js +26 -0
  87. package/dist/vitest/nestjs.js.map +1 -0
  88. package/package.json +144 -3
package/LICENSE.md ADDED
@@ -0,0 +1,21 @@
1
+ # MIT License
2
+
3
+ Copyright (c) 2026 DJ BlackEagle
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,542 @@
1
- # Temporary Holding Version
1
+ # Welcome to @djblackeagle/dev-config-js <!-- omit in toc -->
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 version](https://img.shields.io/npm/v/@djblackeagle/dev-config-js.svg)][REF_INTERN_URL_NPMJS_PACKAGE]
4
+ [![Downloads](https://img.shields.io/npm/dm/@djblackeagle/dev-config-js.svg)][REF_INTERN_URL_NPMJS_PACKAGE]
5
+ [![License](https://img.shields.io/badge/License-MIT-blue.svg)][REF_INTERN_FILE_MD_LICENSE]
6
+ [![CodeQL](https://github.com/DJBlackEagle/dev-code-js/actions/workflows/codeql.yml/badge.svg)][REF_INTERN_URL_WORKFLOW_CODEQL]
7
+ [![Build Status](https://github.com/DJBlackEagle/dev-code-js/actions/workflows/pullrequest-status-checks.yml/badge.svg)][REF_INTERN_URL_WORKFLOW_CQAT]
8
+ [![Release & Publish](https://github.com/DJBlackEagle/dev-code-js/actions/workflows/release.yml/badge.svg)][REF_INTERN_URL_WORKFLOW_RELEASE]
9
+ [![Dependabot Updates](https://github.com/DJBlackEagle/dev-code-js/actions/workflows/dependabot/dependabot-updates/badge.svg)][REF_INTERN_URL_WORKFLOW_DEPENDABOT]
10
+ [![Code Style](https://img.shields.io/badge/code_style-@djblackeagle--dev--config--js-blue.svg)][REF_INTERN_FILE_MD_README]
11
+
12
+ Centralized, modular TypeScript, ESLint (Flat Config), Prettier, Markdownlint, Vitest, and Git tooling configuration
13
+ for Node.js, NestJS, and Angular projects.
14
+
15
+ ## Table of Contents <!-- omit in toc -->
16
+
17
+ - [Benefits](#benefits)
18
+ - [Package Exports Overview](#package-exports-overview)
19
+ - [Getting Started](#getting-started)
20
+ - [TypeScript (`tsconfig`) Presets](#typescript-tsconfig-presets)
21
+ - [Prettier Preset](#prettier-preset)
22
+ - [ESLint Flat Config Presets](#eslint-flat-config-presets)
23
+ - [Markdownlint Preset](#markdownlint-preset)
24
+ - [Vitest Presets](#vitest-presets)
25
+ - [Commitlint Preset](#commitlint-preset)
26
+ - [Lint-Staged Preset](#lint-staged-preset)
27
+ - [End-to-End Stack Integration Guides](#end-to-end-stack-integration-guides)
28
+ - [1. Shared TypeScript Library (Node.js / Universal)](#1-shared-typescript-library-nodejs--universal)
29
+ - [2. NestJS Backend Service](#2-nestjs-backend-service)
30
+ - [3. Angular Frontend Application](#3-angular-frontend-application)
31
+ - [Contributing](#contributing)
32
+ - [Code of Conduct](#code-of-conduct)
33
+ - [Security](#security)
34
+ - [License](#license)
35
+ - [Additional Resources](#additional-resources)
36
+
37
+ ## Benefits
38
+
39
+ Using `@djblackeagle/dev-config-js` offers several advantages for your projects:
40
+
41
+ - **Single Source of Truth:** Unified configuration presets for TypeScript, ESLint, Prettier, Vitest, Markdownlint,
42
+ Commitlint, and Lint-Staged across all repositories.
43
+ - **Modern ESM & Flat Config Architecture:** Built natively as an ECMAScript Module (`"type": "module"`) using the
44
+ modern ESLint Flat Config system.
45
+ - **Modular & Composable:** Dedicated presets tailored for Shared TypeScript Libraries, NestJS Backends, and Angular
46
+ Frontends.
47
+
48
+ ## Package Exports Overview
49
+
50
+ | Export Path | Target Tool | Description |
51
+ | :-------------------------------------------------- | :---------------- | :------------------------------------------------------------------------------- |
52
+ | `@djblackeagle/dev-config-js` | Central API | Re-exports all JavaScript/TypeScript presets, factories, and types |
53
+ | `@djblackeagle/dev-config-js/tsconfig/base.json` | TypeScript | Strict ES2023 / NodeNext base compiler configuration |
54
+ | `@djblackeagle/dev-config-js/tsconfig/library.json` | TypeScript | Shared TypeScript library preset (`declaration`, `sourceMap`) |
55
+ | `@djblackeagle/dev-config-js/tsconfig/nestjs.json` | TypeScript | NestJS backend preset (`experimentalDecorators`, `emitDecoratorMetadata`) |
56
+ | `@djblackeagle/dev-config-js/tsconfig/angular.json` | TypeScript | Angular frontend preset (`bundler` resolution, `angularCompilerOptions`) |
57
+ | `@djblackeagle/dev-config-js/prettier` | Prettier | Shared Prettier configuration (`singleQuote`, `printWidth: 100`, JSONC override) |
58
+ | `@djblackeagle/dev-config-js/eslint` | ESLint 9+ | Stack presets (`presets.library`, `presets.nestjs`, `presets.angular`) & blocks |
59
+ | `@djblackeagle/dev-config-js/markdownlint` | markdownlint-cli2 | Shared Markdownlint ruleset (`MD013` 120 chars, standard ignores) |
60
+ | `@djblackeagle/dev-config-js/vitest` | Vitest | Base Node.js / library test & V8 coverage preset (`vitestBaseConfig`) |
61
+ | `@djblackeagle/dev-config-js/vitest/nestjs` | Vitest | NestJS test & V8 coverage preset (`vitestNestjsConfig`) |
62
+ | `@djblackeagle/dev-config-js/commitlint` | Commitlint | Conventional Commits preset (`commitlintConfig`, `createCommitlintConfig`) |
63
+ | `@djblackeagle/dev-config-js/lint-staged` | lint-staged | Pre-commit staged files preset (`lintStagedConfig`, `createLintStagedConfig`) |
64
+
65
+ ## Getting Started
66
+
67
+ This section will guide you through setting up and configuring `@djblackeagle/dev-config-js`
68
+ in your project.
69
+
70
+ ```bash
71
+ pnpm add -D @djblackeagle/dev-config-js
72
+ ```
73
+
74
+ To scaffold the matching configuration files automatically for your stack (`library`, `nestjs`, or `angular`), run:
75
+
76
+ ```bash
77
+ pnpm dlx @djblackeagle/dev-config-js init --stack library
78
+ # or: npx @djblackeagle/dev-config-js init --stack nestjs
79
+ # add --force to overwrite existing configuration files
80
+ ```
81
+
82
+ ### TypeScript (`tsconfig`) Presets
83
+
84
+ Extend one of the modular TypeScript presets in your project's `tsconfig.json`:
85
+
86
+ - **Shared Library (`@djblackeagle/dev-config-js/tsconfig/library.json`):**
87
+
88
+ ```json
89
+ {
90
+ "$schema": "https://json.schemastore.org/tsconfig",
91
+ "extends": "@djblackeagle/dev-config-js/tsconfig/library.json",
92
+ "compilerOptions": {
93
+ "outDir": "./dist",
94
+ "rootDir": "./src"
95
+ },
96
+ "include": ["src/**/*"]
97
+ }
98
+ ```
99
+
100
+ - **NestJS Backend (`@djblackeagle/dev-config-js/tsconfig/nestjs.json`):**
101
+
102
+ ```json
103
+ {
104
+ "$schema": "https://json.schemastore.org/tsconfig",
105
+ "extends": "@djblackeagle/dev-config-js/tsconfig/nestjs.json",
106
+ "compilerOptions": {
107
+ "outDir": "./dist",
108
+ "baseUrl": "./"
109
+ },
110
+ "include": ["src/**/*"]
111
+ }
112
+ ```
113
+
114
+ - **Angular Frontend (`@djblackeagle/dev-config-js/tsconfig/angular.json`):**
115
+
116
+ ```json
117
+ {
118
+ "$schema": "https://json.schemastore.org/tsconfig",
119
+ "extends": "@djblackeagle/dev-config-js/tsconfig/angular.json"
120
+ }
121
+ ```
122
+
123
+ - **Base Configuration (`@djblackeagle/dev-config-js/tsconfig/base.json`):**
124
+
125
+ ```json
126
+ {
127
+ "$schema": "https://json.schemastore.org/tsconfig",
128
+ "extends": "@djblackeagle/dev-config-js/tsconfig/base.json"
129
+ }
130
+ ```
131
+
132
+ ### Prettier Preset
133
+
134
+ Reference the shared Prettier preset directly in your `package.json`:
135
+
136
+ ```json
137
+ {
138
+ "prettier": "@djblackeagle/dev-config-js/prettier"
139
+ }
140
+ ```
141
+
142
+ Or import and extend it in `prettier.config.js` to customize options:
143
+
144
+ ```js
145
+ import prettierConfig from '@djblackeagle/dev-config-js/prettier';
146
+
147
+ export default {
148
+ ...prettierConfig,
149
+ };
150
+ ```
151
+
152
+ ### ESLint Flat Config Presets
153
+
154
+ Use one of the pre-assembled stack presets (`presets.library`, `presets.nestjs`, `presets.angular`) in your project's
155
+ `eslint.config.js`. All presets build on `baseConfig` (which ignores `dist/**`, `node_modules/**`, `coverage/**`,
156
+ `*.d.ts`, `.tmp/**`, and `**/generated/**` by default, and enforces Prettier-compatible JS/TS best-practice rules and
157
+ strict `@typescript-eslint/naming-convention` rules):
158
+
159
+ - **Shared TypeScript Library:**
160
+
161
+ ```js
162
+ import { presets } from '@djblackeagle/dev-config-js/eslint';
163
+
164
+ export default [...presets.library];
165
+ ```
166
+
167
+ - **NestJS Backend:**
168
+
169
+ ```js
170
+ import { presets } from '@djblackeagle/dev-config-js/eslint';
171
+
172
+ export default [...presets.nestjs];
173
+ ```
174
+
175
+ - **Angular Frontend:**
176
+
177
+ ```js
178
+ import { presets } from '@djblackeagle/dev-config-js/eslint';
179
+
180
+ export default [...presets.angular];
181
+ ```
182
+
183
+ - **Custom Composition (Individual Building Blocks):**
184
+
185
+ ```js
186
+ import {
187
+ createBaseConfig,
188
+ jsonConfig,
189
+ markdownEslintConfig,
190
+ nestjsConfig,
191
+ packageJsonConfig,
192
+ prettierEslintConfig,
193
+ vitestConfig,
194
+ yamlConfig,
195
+ } from '@djblackeagle/dev-config-js/eslint';
196
+
197
+ export default [
198
+ ...createBaseConfig({
199
+ project: ['./tsconfig.eslint.json'],
200
+ tsconfigRootDir: import.meta.dirname,
201
+ }),
202
+ ...jsonConfig,
203
+ ...packageJsonConfig,
204
+ ...yamlConfig,
205
+ ...markdownEslintConfig,
206
+ ...nestjsConfig,
207
+ ...vitestConfig,
208
+ ...prettierEslintConfig,
209
+ ];
210
+ ```
211
+
212
+ _(Note: `eslintPresets.library`, `eslintPresets.nestjs`, and `eslintPresets.angular` already include `jsonConfig` for
213
+ `*.json`/`*.jsonc` linting via `@eslint/json`, `packageJsonConfig` for `package.json` validation via
214
+ `eslint-plugin-package-json`, `yamlConfig` for `*.yml`/`*.yaml` linting via `eslint-plugin-yml`, and
215
+ `markdownEslintConfig` for fenced code-block linting in `*.md` via `@eslint/markdown`. `eslintPresets.angular`
216
+ additionally includes `cssConfig` for `*.css` linting via `@eslint/css`.)_
217
+
218
+ ### Markdownlint Preset
219
+
220
+ Run `markdownlint-cli2` with the shared configuration preset (`@djblackeagle/dev-config-js/markdownlint`):
221
+
222
+ ```bash
223
+ pnpm exec markdownlint-cli2 --config node_modules/@djblackeagle/dev-config-js/dist/markdownlint/index.jsonc
224
+ ```
225
+
226
+ Or extend/copy the preset in your project's `.markdownlint-cli2.jsonc`:
227
+
228
+ ```jsonc
229
+ {
230
+ "config": {
231
+ "default": true,
232
+ "MD013": {
233
+ "line_length": 120,
234
+ "tables": false,
235
+ "code_blocks": false,
236
+ },
237
+ },
238
+ "globs": ["**/*.md"],
239
+ "ignores": ["**/node_modules/**", "**/dist/**", "**/coverage/**", "**/.tmp/**"],
240
+ }
241
+ ```
242
+
243
+ ### Vitest Presets
244
+
245
+ Use the modular Vitest presets in your project's `vitest.config.ts`:
246
+
247
+ - **Shared TypeScript Library / Node.js (`@djblackeagle/dev-config-js/vitest`):**
248
+
249
+ ```ts
250
+ import { vitestBaseConfig } from '@djblackeagle/dev-config-js/vitest';
251
+
252
+ export default vitestBaseConfig;
253
+ ```
254
+
255
+ - **NestJS Backend (`@djblackeagle/dev-config-js/vitest/nestjs`):**
256
+
257
+ ```ts
258
+ import { vitestNestjsConfig } from '@djblackeagle/dev-config-js/vitest/nestjs';
259
+
260
+ export default vitestNestjsConfig;
261
+ ```
262
+
263
+ - **Custom Overrides (`createVitestConfig` / `createNestjsVitestConfig`):**
264
+
265
+ ```ts
266
+ import { createVitestConfig } from '@djblackeagle/dev-config-js/vitest';
267
+
268
+ export default createVitestConfig({
269
+ test: {
270
+ setupFiles: ['./test/setup.ts'],
271
+ },
272
+ });
273
+ ```
274
+
275
+ ### Commitlint Preset
276
+
277
+ Use the shared Commitlint Conventional Commits preset in your project's `commitlint.config.js`:
278
+
279
+ ```js
280
+ import commitlintConfig from '@djblackeagle/dev-config-js/commitlint';
281
+
282
+ export default commitlintConfig;
283
+ ```
284
+
285
+ Or customize rules using `createCommitlintConfig`:
286
+
287
+ ```js
288
+ import { createCommitlintConfig } from '@djblackeagle/dev-config-js/commitlint';
289
+
290
+ export default createCommitlintConfig({
291
+ rules: {
292
+ 'header-max-length': [2, 'always', 120],
293
+ },
294
+ });
295
+ ```
296
+
297
+ ### Lint-Staged Preset
298
+
299
+ Use the shared `lint-staged` pre-commit preset in your project's `.lintstagedrc.js` (runs `eslint --fix` and
300
+ `prettier --write` on JS/TS, JSON/JSONC, YAML, and Markdown files, plus `markdownlint-cli2 --fix` on Markdown):
301
+
302
+ ```js
303
+ import lintStagedConfig from '@djblackeagle/dev-config-js/lint-staged';
304
+
305
+ export default lintStagedConfig;
306
+ ```
307
+
308
+ Or extend the preset with custom file globs using `createLintStagedConfig`:
309
+
310
+ ```js
311
+ import { createLintStagedConfig } from '@djblackeagle/dev-config-js/lint-staged';
312
+
313
+ export default createLintStagedConfig({
314
+ '*.{html,scss}': ['prettier --write'],
315
+ });
316
+ ```
317
+
318
+ ## End-to-End Stack Integration Guides
319
+
320
+ Below are complete, copy-paste-ready setup recipes for integrating `@djblackeagle/dev-config-js` into new or existing
321
+ projects across all three supported stacks.
322
+
323
+ ### 1. Shared TypeScript Library (Node.js / Universal)
324
+
325
+ 1. **Install dependencies:**
326
+
327
+ ```bash
328
+ pnpm add -D @djblackeagle/dev-config-js typescript eslint husky
329
+ ```
330
+
331
+ 2. **Configure `package.json`:**
332
+
333
+ ```json
334
+ {
335
+ "type": "module",
336
+ "prettier": "@djblackeagle/dev-config-js/prettier",
337
+ "scripts": {
338
+ "prepare": "husky",
339
+ "build": "tsc -p tsconfig.build.json",
340
+ "typecheck": "tsc --noEmit",
341
+ "lint": "eslint . && markdownlint-cli2 --config node_modules/@djblackeagle/dev-config-js/dist/markdownlint/index.jsonc",
342
+ "lint:fix": "eslint . --fix && markdownlint-cli2 --fix --config node_modules/@djblackeagle/dev-config-js/dist/markdownlint/index.jsonc",
343
+ "format": "prettier --check .",
344
+ "format:fix": "prettier --write .",
345
+ "test": "vitest run --coverage.enabled --coverage.reporter=text",
346
+ "test:watch": "vitest"
347
+ }
348
+ }
349
+ ```
350
+
351
+ 3. **Create `tsconfig.json`, `tsconfig.build.json`, and `tsconfig.eslint.json`:**
352
+
353
+ ```jsonc
354
+ // tsconfig.json
355
+ {
356
+ "$schema": "https://json.schemastore.org/tsconfig",
357
+ "extends": "@djblackeagle/dev-config-js/tsconfig/library.json",
358
+ "compilerOptions": {
359
+ "outDir": "./dist",
360
+ "rootDir": ".",
361
+ },
362
+ "include": ["src/**/*", "tests/**/*", "eslint.config.js", "vitest.config.ts"],
363
+ }
364
+ ```
365
+
366
+ ```jsonc
367
+ // tsconfig.build.json
368
+ {
369
+ "$schema": "https://json.schemastore.org/tsconfig",
370
+ "extends": "./tsconfig.json",
371
+ "compilerOptions": {
372
+ "rootDir": "./src",
373
+ },
374
+ "include": ["src/**/*"],
375
+ "exclude": ["node_modules", "dist", "coverage", "**/*.spec.ts", "**/*.test.ts"],
376
+ }
377
+ ```
378
+
379
+ ```jsonc
380
+ // tsconfig.eslint.json
381
+ {
382
+ "$schema": "https://json.schemastore.org/tsconfig",
383
+ "extends": "./tsconfig.json",
384
+ "compilerOptions": {
385
+ "noEmit": true,
386
+ "allowJs": true,
387
+ },
388
+ "include": [
389
+ "src/**/*",
390
+ "tests/**/*",
391
+ ".lintstagedrc.js",
392
+ "commitlint.config.js",
393
+ "eslint.config.js",
394
+ "vitest.config.ts",
395
+ ],
396
+ }
397
+ ```
398
+
399
+ 4. **Create `eslint.config.js`, `vitest.config.ts`, `commitlint.config.js`, and `.lintstagedrc.js`:**
400
+
401
+ ```js
402
+ // eslint.config.js
403
+ import { presets } from '@djblackeagle/dev-config-js/eslint';
404
+
405
+ export default [...presets.library];
406
+ ```
407
+
408
+ ```ts
409
+ // vitest.config.ts
410
+ import { vitestBaseConfig } from '@djblackeagle/dev-config-js/vitest';
411
+
412
+ export default vitestBaseConfig;
413
+ ```
414
+
415
+ ```js
416
+ // commitlint.config.js
417
+ import commitlintConfig from '@djblackeagle/dev-config-js/commitlint';
418
+
419
+ export default commitlintConfig;
420
+ ```
421
+
422
+ ```js
423
+ // .lintstagedrc.js
424
+ import lintStagedConfig from '@djblackeagle/dev-config-js/lint-staged';
425
+
426
+ export default lintStagedConfig;
427
+ ```
428
+
429
+ ---
430
+
431
+ ### 2. NestJS Backend Service
432
+
433
+ 1. **Install dependencies:**
434
+
435
+ ```bash
436
+ pnpm add -D @djblackeagle/dev-config-js typescript eslint husky
437
+ ```
438
+
439
+ 2. **Create `tsconfig.json`:**
440
+
441
+ ```json
442
+ {
443
+ "$schema": "https://json.schemastore.org/tsconfig",
444
+ "extends": "@djblackeagle/dev-config-js/tsconfig/nestjs.json",
445
+ "compilerOptions": {
446
+ "outDir": "./dist",
447
+ "baseUrl": "./"
448
+ },
449
+ "include": ["src/**/*", "test/**/*"]
450
+ }
451
+ ```
452
+
453
+ 3. **Create `eslint.config.js` and `vitest.config.ts`:**
454
+
455
+ ```js
456
+ // eslint.config.js
457
+ import { presets } from '@djblackeagle/dev-config-js/eslint';
458
+
459
+ export default [...presets.nestjs];
460
+ ```
461
+
462
+ ```ts
463
+ // vitest.config.ts
464
+ import { vitestNestjsConfig } from '@djblackeagle/dev-config-js/vitest/nestjs';
465
+
466
+ export default vitestNestjsConfig;
467
+ ```
468
+
469
+ ---
470
+
471
+ ### 3. Angular Frontend Application
472
+
473
+ 1. **Install dependencies:**
474
+
475
+ ```bash
476
+ pnpm add -D @djblackeagle/dev-config-js typescript eslint husky
477
+ ```
478
+
479
+ 2. **Create `tsconfig.json`:**
480
+
481
+ ```json
482
+ {
483
+ "$schema": "https://json.schemastore.org/tsconfig",
484
+ "extends": "@djblackeagle/dev-config-js/tsconfig/angular.json"
485
+ }
486
+ ```
487
+
488
+ 3. **Create `eslint.config.js` and `.lintstagedrc.js`:**
489
+
490
+ ```js
491
+ // eslint.config.js
492
+ import { presets } from '@djblackeagle/dev-config-js/eslint';
493
+
494
+ export default [...presets.angular];
495
+ ```
496
+
497
+ ```js
498
+ // .lintstagedrc.js
499
+ import { createLintStagedConfig } from '@djblackeagle/dev-config-js/lint-staged';
500
+
501
+ export default createLintStagedConfig({
502
+ '*.{html,scss}': ['prettier --write'],
503
+ });
504
+ ```
505
+
506
+ ## Contributing
507
+
508
+ We welcome contributions from the community! If you're interested in helping to
509
+ improve `@djblackeagle/dev-config-js`, please take a look at our
510
+ [Contributing Guidelines][REF_INTERN_FILE_MD_CONTRIBUTING] for more information on how to get started.
511
+
512
+ ## Code of Conduct
513
+
514
+ We are committed to fostering a welcoming and inclusive community. Please review
515
+ our [Code of Conduct][REF_INTERN_FILE_MD_CODE_OF_CONDUCT] to understand our
516
+ expectations for behavior within the project.
517
+
518
+ ## Security
519
+
520
+ If you discover a security vulnerability in `@djblackeagle/dev-config-js`, please
521
+ follow our [Security Guidelines][REF_INTERN_FILE_MD_SECURITY] to report it responsibly.
522
+
523
+ ## License
524
+
525
+ This project is licensed under the [MIT License][REF_INTERN_FILE_MD_LICENSE].
526
+
527
+ ## Additional Resources
528
+
529
+ - [Agent & Engineering Guidelines][REF_INTERN_FILE_MD_AGENTS] – For detailed information
530
+ on development standards, project structure, and `package.json` scripts.
531
+
532
+ [REF_INTERN_FILE_MD_AGENTS]: ./AGENTS.md
533
+ [REF_INTERN_FILE_MD_CODE_OF_CONDUCT]: ./CODE_OF_CONDUCT.md
534
+ [REF_INTERN_FILE_MD_CONTRIBUTING]: ./CONTRIBUTING.md
535
+ [REF_INTERN_FILE_MD_LICENSE]: ./LICENSE.md
536
+ [REF_INTERN_FILE_MD_README]: ./README.md
537
+ [REF_INTERN_FILE_MD_SECURITY]: ./SECURITY.md
538
+ [REF_INTERN_URL_NPMJS_PACKAGE]: https://www.npmjs.com/package/@djblackeagle/dev-config-js
539
+ [REF_INTERN_URL_WORKFLOW_CODEQL]: https://github.com/DJBlackEagle/dev-code-js/actions/workflows/codeql.yml
540
+ [REF_INTERN_URL_WORKFLOW_CQAT]: https://github.com/DJBlackEagle/dev-code-js/actions/workflows/pullrequest-status-checks.yml
541
+ [REF_INTERN_URL_WORKFLOW_DEPENDABOT]: https://github.com/DJBlackEagle/dev-code-js/actions/workflows/dependabot/dependabot-updates
542
+ [REF_INTERN_URL_WORKFLOW_RELEASE]: https://github.com/DJBlackEagle/dev-code-js/actions/workflows/release.yml
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export {};
3
+ //# sourceMappingURL=bin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env node
2
+ import { runCli } from './init.js';
3
+ process.exitCode = runCli(process.argv.slice(2));
4
+ //# sourceMappingURL=bin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}
@@ -0,0 +1,30 @@
1
+ declare const SUPPORTED_STACKS: readonly ["library", "nestjs", "angular"];
2
+ type StackType = (typeof SUPPORTED_STACKS)[number];
3
+ interface InitOptions {
4
+ stack: StackType;
5
+ cwd?: string;
6
+ force?: boolean;
7
+ }
8
+ interface InitResult {
9
+ created: string[];
10
+ skipped: string[];
11
+ }
12
+ interface ParsedCliArgs {
13
+ command?: string;
14
+ stack?: string;
15
+ force: boolean;
16
+ help: boolean;
17
+ unknownArg?: string;
18
+ }
19
+ interface CliIo {
20
+ stdout: (message: string) => void;
21
+ stderr: (message: string) => void;
22
+ }
23
+ declare const HELP_TEXT: string;
24
+ declare function isStackType(value: string): value is StackType;
25
+ declare function getTemplatesForStack(stack: StackType): Record<string, string>;
26
+ declare function initProject(options: InitOptions): InitResult;
27
+ declare function parseCliArgs(argv: readonly string[]): ParsedCliArgs;
28
+ declare function runCli(argv?: readonly string[], io?: CliIo, cwd?: string): number;
29
+ export { HELP_TEXT, SUPPORTED_STACKS, getTemplatesForStack, initProject, isStackType, parseCliArgs, runCli, type CliIo, type InitOptions, type InitResult, type ParsedCliArgs, type StackType, };
30
+ //# sourceMappingURL=init.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,gBAAgB,2CAA4C,CAAC;AAEnE,KAAK,SAAS,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,UAAU,WAAW;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,KAAK;IACb,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAWD,QAAA,MAAM,SAAS,QAOH,CAAC;AAqBb,iBAAS,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAEtD;AAeD,iBAAS,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgCtE;AAED,iBAAS,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAmBrD;AAED,iBAAS,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CAgC5D;AAED,iBAAS,MAAM,CACb,IAAI,GAAE,SAAS,MAAM,EAA0B,EAC/C,EAAE,GAAE,KAAkB,EACtB,GAAG,GAAE,MAAsB,GAC1B,MAAM,CA4CR;AAED,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,MAAM,EACN,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,SAAS,GACf,CAAC"}