@nikovirtala/projen-constructs 0.1.8 → 0.2.0

package/.jsii

@@ -4190,7 +4190,7 @@
   },
   "name": "@nikovirtala/projen-constructs",
   "readme": {
-    "markdown": "# @nikovirtala/projen-constructs\n\nProjen project types with standard configuration for consistent project setup across all repositories.\n\n## Installation\n\n```bash\npnpm add -D @nikovirtala/projen-constructs projen constructs\n```\n\n## Standard Configuration\n\nAll project types include:\n\n- **Author**: Niko Virtala (niko.virtala@hey.com)\n- **Default Release Branch**: main\n- **Package Manager**: pnpm 10\n- **Node Version**: 22.21.1\n- **TypeScript**: 5.9.3\n- **Module Type**: ES modules (TypeScript and CDK App projects only; JSII projects use CommonJS)\n- **Code Quality**: Biome for formatting and linting\n- **Testing**: Vitest\n- **Auto-merge**: Enabled with auto-approve\n- **VSCode**: Recommended extensions and settings\n- **mise**: Node version management (via Homebrew)\n- **CDK Version**: 2.223.0 (for CDK projects)\n- **JSII Version**: ~5.9.3 (for JSII projects)\n\n## Customization\n\nOverride any option by passing it to the constructor:\n\n```typescript\nconst project = new JsiiProject({\n  name: \"my-project\",\n  repositoryUrl: \"https://github.com/nikovirtala/my-project.git\",\n  minNodeVersion: \"20.0.0\",\n  author: \"Custom Author\",\n  authorAddress: \"custom@example.com\",\n  mise: false,\n  vitest: false,\n  tsconfig: {\n    compilerOptions: {\n      noUnusedLocals: false,\n    },\n  },\n  biomeOptions: {\n    biomeConfig: {\n      formatter: {\n        lineWidth: 100,\n      },\n    },\n  },\n});\n```\n\n## Usage\n\n### Projects\n\n#### AWS CDK Construct Library Project\n\n```typescript\nimport { AwsCdkConstructLibraryProject } from \"@nikovirtala/projen-constructs\";\n\nconst project = new AwsCdkConstructLibraryProject({\n  name: \"my-cdk-construct\",\n  repositoryUrl: \"https://github.com/nikovirtala/my-cdk-construct.git\",\n});\n\nproject.synth();\n```\n\n#### AWS CDK TypeScript App Project\n\n```typescript\nimport { AwsCdkTypeScriptAppProject } from \"@nikovirtala/projen-constructs\";\n\nconst project = new AwsCdkTypeScriptAppProject({\n  name: \"my-cdk-app\",\n  repositoryUrl: \"https://github.com/nikovirtala/my-cdk-app.git\",\n});\n\nproject.synth();\n```\n\n#### JSII Project\n\n```typescript\nimport { JsiiProject } from \"@nikovirtala/projen-constructs\";\n\nconst project = new JsiiProject({\n  name: \"my-jsii-project\",\n  repositoryUrl: \"https://github.com/nikovirtala/my-jsii-project.git\",\n});\n\nproject.synth();\n```\n\n#### TypeScript Project\n\n```typescript\nimport { TypeScriptProject } from \"@nikovirtala/projen-constructs\";\n\nconst project = new TypeScriptProject({\n  name: \"my-typescript-project\",\n  repositoryUrl: \"https://github.com/nikovirtala/my-typescript-project.git\",\n});\n\nproject.synth();\n```\n\n### Components\n\nThe package includes reusable components for common development tasks:\n\n#### Vitest\n\n[Vitest](https://vitest.dev) testing framework component.\n\n```typescript\nimport { Vitest } from \"@nikovirtala/projen-constructs\";\n\nnew Vitest(project, {\n  vitestVersion: \"^4\",\n  config: {\n    coverageProvider: CoverageProvider.V8,\n    coverageReporters: [CoverageReporter.TEXT, CoverageReporter.LCOV],\n  },\n});\n```\n\n#### TypeDoc\n\n[TypeDoc](https://typedoc.org) documentation generation component.\n\n```typescript\nimport { TypeDoc, EntryPointStrategy } from \"@nikovirtala/projen-constructs\";\n\nnew TypeDoc(project, {\n  version: \"^0.28\",\n  typeDocConfig: {\n    entryPointStrategy: EntryPointStrategy.EXPAND,\n    out: \"docs/api\",\n    exclude: [\"**/*.test.ts\"],\n  },\n});\n```\n\n#### Mise\n\n[Mise](https://mise.jdx.dev) dev tools/runtimes management component.\n\n```typescript\nimport { Mise } from \"@nikovirtala/projen-constructs\";\n\nnew Mise(project, {\n  nodeVersion: \"22.21.1\",\n});\n```\n\n#### Homebrew\n\n[Homebrew](https://brew.sh) package management component.\n\n```typescript\nimport { Homebrew } from \"@nikovirtala/projen-constructs\";\n\nconst homebrew = new Homebrew(project, {\n  packages: [\"jq\", \"yq\"],\n});\n\nhomebrew.addPackage(\"gh\");\n```\n\n#### Colima\n\n[Colima](https://github.com/abiosoft/colima) container runtime component. Alternative for Docker.\n\n```typescript\nimport { Colima } from \"@nikovirtala/projen-constructs\";\n\nnew Colima(project);\n```\n\n#### LocalStack\n\n[LocalStack](https://www.localstack.cloud) AWS emulation component.\n\n```typescript\nimport { LocalStack } from \"@nikovirtala/projen-constructs\";\n\nnew LocalStack(project, {\n  services: [\"s3\", \"lambda\", \"dynamodb\"],\n  port: 4566,\n  debug: true,\n});\n```\n\n#### LambdaFunctionConstructGenerator\n\nGenerates AWS CDK Lambda Function constructs and bundles their code.\n\n```typescript\nimport { LambdaFunctionConstructGenerator } from \"@nikovirtala/projen-constructs\";\n\nnew LambdaFunctionConstructGenerator(project, {\n  sourceDir: \"src/handlers\",\n  outputDir: \"src/constructs/lambda\",\n  filePattern: \"*.lambda.ts\",\n  esbuildOptions: {\n    minify: true,\n    sourcemap: true,\n  },\n});\n```\n\n#### Bundler\n\nLow-level bundling utilities for Lambda functions.\n\n```typescript\nimport {\n  Bundler,\n  LambdaFunctionCodeBundle,\n} from \"@nikovirtala/projen-constructs\";\n\nconst bundler = new Bundler(project, {\n  assetsDir: \"assets\",\n  esbuildVersion: \"^0.25\",\n});\n\nnew LambdaFunctionCodeBundle(project, {\n  entrypoint: \"src/my-function.lambda.ts\",\n  extension: \".lambda.ts\",\n});\n```\n"
+    "markdown": "# @nikovirtala/projen-constructs\n\nProjen project types with standard configuration for consistent project setup across all repositories.\n\n## Installation\n\n```bash\npnpm add -D @nikovirtala/projen-constructs projen constructs\n```\n\n## Features\n\n- **Standard Configuration**: Opinionated defaults for author, release branch, package manager, Node.js, TypeScript, and tooling\n- **Automatic Project Type Discovery**: Generates `ProjectType` enum from Projen's JSII manifest (18 project types)\n- **Component System**: Reusable components (Vitest, Mise, TypeDoc, LocalStack, etc.)\n- **Code Generation**: `ProjectGenerator` creates project classes with standard configuration\n- **ES Modules**: TypeScript and CDK App projects use ES modules (JSII uses CommonJS)\n- **Code Quality**: Biome for formatting and linting\n- **Testing**: Vitest with coverage\n- **Auto-merge**: Enabled with auto-approve\n- **VSCode**: Recommended extensions and settings\n- **mise**: Node version management\n\n## Standard Configuration\n\n- **Author**: Niko Virtala (niko.virtala@hey.com)\n- **Default Release Branch**: main\n- **Package Manager**: pnpm 10\n- **Node Version**: 22.21.1\n- **TypeScript**: 5.9.3\n- **CDK Version**: 2.223.0 (for CDK projects)\n- **JSII Version**: ~5.9.3 (for JSII projects)\n\n## Customization\n\nOverride any option by passing it to the constructor:\n\n```typescript\nconst project = new JsiiProject({\n  name: \"my-project\",\n  repositoryUrl: \"https://github.com/nikovirtala/my-project.git\",\n  minNodeVersion: \"20.0.0\",\n  author: \"Custom Author\",\n  authorAddress: \"custom@example.com\",\n  mise: false,\n  vitest: false,\n  tsconfig: {\n    compilerOptions: {\n      noUnusedLocals: false,\n    },\n  },\n  biomeOptions: {\n    biomeConfig: {\n      formatter: {\n        lineWidth: 100,\n      },\n    },\n  },\n});\n```\n\n## Usage\n\n### Projects\n\n#### AWS CDK Construct Library Project\n\n```typescript\nimport { AwsCdkConstructLibraryProject } from \"@nikovirtala/projen-constructs\";\n\nconst project = new AwsCdkConstructLibraryProject({\n  name: \"my-cdk-construct\",\n  repositoryUrl: \"https://github.com/nikovirtala/my-cdk-construct.git\",\n});\n\nproject.synth();\n```\n\n#### AWS CDK TypeScript App Project\n\n```typescript\nimport { AwsCdkTypeScriptAppProject } from \"@nikovirtala/projen-constructs\";\n\nconst project = new AwsCdkTypeScriptAppProject({\n  name: \"my-cdk-app\",\n  repositoryUrl: \"https://github.com/nikovirtala/my-cdk-app.git\",\n});\n\nproject.synth();\n```\n\n#### JSII Project\n\n```typescript\nimport { JsiiProject } from \"@nikovirtala/projen-constructs\";\n\nconst project = new JsiiProject({\n  name: \"my-jsii-project\",\n  repositoryUrl: \"https://github.com/nikovirtala/my-jsii-project.git\",\n});\n\nproject.synth();\n```\n\n#### TypeScript Project\n\n```typescript\nimport { TypeScriptProject } from \"@nikovirtala/projen-constructs\";\n\nconst project = new TypeScriptProject({\n  name: \"my-typescript-project\",\n  repositoryUrl: \"https://github.com/nikovirtala/my-typescript-project.git\",\n});\n\nproject.synth();\n```\n\n### Components\n\nThe package includes reusable components for common development tasks:\n\n#### Vitest\n\n[Vitest](https://vitest.dev) testing framework component.\n\n```typescript\nimport { Vitest } from \"@nikovirtala/projen-constructs\";\n\nnew Vitest(project, {\n  vitestVersion: \"^4\",\n  config: {\n    coverageProvider: CoverageProvider.V8,\n    coverageReporters: [CoverageReporter.TEXT, CoverageReporter.LCOV],\n  },\n});\n```\n\n#### TypeDoc\n\n[TypeDoc](https://typedoc.org) documentation generation component.\n\n```typescript\nimport { TypeDoc, EntryPointStrategy } from \"@nikovirtala/projen-constructs\";\n\nnew TypeDoc(project, {\n  version: \"^0.28\",\n  typeDocConfig: {\n    entryPointStrategy: EntryPointStrategy.EXPAND,\n    out: \"docs/api\",\n    exclude: [\"**/*.test.ts\"],\n  },\n});\n```\n\n#### Mise\n\n[Mise](https://mise.jdx.dev) dev tools/runtimes management component.\n\n```typescript\nimport { Mise } from \"@nikovirtala/projen-constructs\";\n\nnew Mise(project, {\n  nodeVersion: \"22.21.1\",\n});\n```\n\n#### Homebrew\n\n[Homebrew](https://brew.sh) package management component.\n\n```typescript\nimport { Homebrew } from \"@nikovirtala/projen-constructs\";\n\nconst homebrew = new Homebrew(project, {\n  packages: [\"jq\", \"yq\"],\n});\n\nhomebrew.addPackage(\"gh\");\n```\n\n#### Colima\n\n[Colima](https://github.com/abiosoft/colima) container runtime component. Alternative for Docker.\n\n```typescript\nimport { Colima } from \"@nikovirtala/projen-constructs\";\n\nnew Colima(project);\n```\n\n#### LocalStack\n\n[LocalStack](https://www.localstack.cloud) AWS emulation component.\n\n```typescript\nimport { LocalStack } from \"@nikovirtala/projen-constructs\";\n\nnew LocalStack(project, {\n  services: [\"s3\", \"lambda\", \"dynamodb\"],\n  port: 4566,\n  debug: true,\n});\n```\n\n#### LambdaFunctionConstructGenerator\n\nGenerates AWS CDK Lambda Function constructs and bundles their code.\n\n```typescript\nimport { LambdaFunctionConstructGenerator } from \"@nikovirtala/projen-constructs\";\n\nnew LambdaFunctionConstructGenerator(project, {\n  sourceDir: \"src/handlers\",\n  outputDir: \"src/constructs/lambda\",\n  filePattern: \"*.lambda.ts\",\n  esbuildOptions: {\n    minify: true,\n    sourcemap: true,\n  },\n});\n```\n\n#### Bundler\n\nLow-level bundling utilities for Lambda functions.\n\n```typescript\nimport {\n  Bundler,\n  LambdaFunctionCodeBundle,\n} from \"@nikovirtala/projen-constructs\";\n\nconst bundler = new Bundler(project, {\n  assetsDir: \"assets\",\n  esbuildVersion: \"^0.25\",\n});\n\nnew LambdaFunctionCodeBundle(project, {\n  entrypoint: \"src/my-function.lambda.ts\",\n  extension: \".lambda.ts\",\n});\n```\n\n#### ProjectGenerator\n\nGenerates TypeScript project classes with standard configuration.\n\n```typescript\nimport { ProjectGenerator, ProjectType } from \"@nikovirtala/projen-constructs\";\n\nnew ProjectGenerator(project, {\n  name: \"TypeScriptProject\",\n  projectType: ProjectType.TYPESCRIPT,\n  filePath: \"./src/projects/typescript.generated.ts\",\n  components: [\n    { componentClass: Mise },\n    { componentClass: Vitest }, // Auto-detects VitestOptions from JSII manifest\n  ],\n});\n```\n\nFeatures:\n- Automatically generates the `ProjectType` enum from Projen's JSII manifest\n- Auto-detects component options types from JSII manifests\n- Validates paths to prevent directory traversal attacks\n- Structured error handling with custom error classes\n"
   },
   "repository": {
     "type": "git",
@@ -4218,7 +4218,7 @@
         },
         "locationInModule": {
           "filename": "src/projects/awscdk-construct-library.generated.ts",
-          "line": 22
+          "line": 20
         },
         "parameters": [
           {
@@ -4235,7 +4235,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/projects/awscdk-construct-library.generated.ts",
-        "line": 18
+        "line": 16
       },
       "name": "AwsCdkConstructLibraryProject",
       "symbolId": "src/projects/awscdk-construct-library.generated:AwsCdkConstructLibraryProject"
@@ -7353,7 +7353,7 @@
         },
         "locationInModule": {
           "filename": "src/projects/awscdk-typescript-app.generated.ts",
-          "line": 22
+          "line": 20
         },
         "parameters": [
           {
@@ -7370,7 +7370,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/projects/awscdk-typescript-app.generated.ts",
-        "line": 18
+        "line": 16
       },
       "name": "AwsCdkTypeScriptAppProject",
       "symbolId": "src/projects/awscdk-typescript-app.generated:AwsCdkTypeScriptAppProject"
@@ -10373,6 +10373,140 @@
       ],
       "symbolId": "src/projects/awscdk-typescript-app-options.generated:AwsCdkTypeScriptAppProjectOptions"
     },
+    "@nikovirtala/projen-constructs.Component": {
+      "assembly": "@nikovirtala/projen-constructs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Configuration for a component to be integrated into a generated project."
+      },
+      "fqn": "@nikovirtala/projen-constructs.Component",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/project-generator.ts",
+        "line": 36
+      },
+      "name": "Component",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Optional - auto-detected by searching JSII manifests.",
+            "stability": "stable",
+            "summary": "Fully qualified name of the component class."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/project-generator.ts",
+            "line": 49
+          },
+          "name": "fqn",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Optional - auto-detected from component constructor.\nSet to false to disable options property generation.\nSet to string or object to customize the property name.",
+            "stability": "stable",
+            "summary": "Options property configuration for the generated options interface."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/project-generator.ts",
+            "line": 58
+          },
+          "name": "optionsProperty",
+          "optional": true,
+          "type": {
+            "union": {
+              "types": [
+                {
+                  "primitive": "string"
+                },
+                {
+                  "primitive": "boolean"
+                },
+                {
+                  "fqn": "@nikovirtala/projen-constructs.ComponentOptions"
+                }
+              ]
+            }
+          }
+        }
+      ],
+      "symbolId": "src/project-generator:Component"
+    },
+    "@nikovirtala/projen-constructs.ComponentOptions": {
+      "assembly": "@nikovirtala/projen-constructs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Options property configuration."
+      },
+      "fqn": "@nikovirtala/projen-constructs.ComponentOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/project-generator.ts",
+        "line": 64
+      },
+      "name": "ComponentOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Name of the options property."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/project-generator.ts",
+            "line": 68
+          },
+          "name": "name",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Documentation summary (optional, auto-detected from component constructor)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/project-generator.ts",
+            "line": 76
+          },
+          "name": "docs",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Fully qualified type name (optional, auto-detected from component constructor)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/project-generator.ts",
+            "line": 72
+          },
+          "name": "type",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/project-generator:ComponentOptions"
+    },
     "@nikovirtala/projen-constructs.CoverageProvider": {
       "assembly": "@nikovirtala/projen-constructs",
       "docs": {
@@ -10382,18 +10516,22 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/components/vitest.ts",
-        "line": 21
+        "line": 72
       },
       "members": [
         {
           "docs": {
-            "stability": "stable"
+            "see": "https://istanbul.js.org",
+            "stability": "stable",
+            "summary": "Provide coverage report using istanbul."
           },
           "name": "ISTANBUL"
         },
         {
           "docs": {
-            "stability": "stable"
+            "see": "https://v8.dev/blog/javascript-code-coverage",
+            "stability": "stable",
+            "summary": "Provide coverage reports using v8."
           },
           "name": "V8"
         }
@@ -10410,36 +10548,41 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/components/vitest.ts",
-        "line": 26
+        "line": 88
       },
       "members": [
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Provides `clover` report."
           },
           "name": "CLOVER"
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Provides `HTML` report."
           },
           "name": "HTML"
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Provides `JSON` report."
           },
           "name": "JSON"
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Provides `LCOV` report."
           },
           "name": "LCOV"
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Provides `text` report."
           },
           "name": "TEXT"
         }
@@ -10461,25 +10604,32 @@
       "members": [
         {
           "docs": {
-            "stability": "stable"
+            "see": "https://edge-runtime.vercel.app/packages/vm",
+            "stability": "stable",
+            "summary": "Run tests in Vercel's Edge Runtime VM."
           },
           "name": "EDGE_RUNTIME"
         },
         {
           "docs": {
-            "stability": "stable"
+            "see": "https://github.com/capricorn86/happy-dom",
+            "stability": "stable",
+            "summary": "Run tests in `happy-dom` environment."
           },
           "name": "HAPPY_DOM"
         },
         {
           "docs": {
-            "stability": "stable"
+            "see": "https://github.com/jsdom/jsdom",
+            "stability": "stable",
+            "summary": "Run tests in `jsdom` environment."
           },
           "name": "JSDOM"
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Run tests in a Node.js environment."
           },
           "name": "NODE"
         }
@@ -10502,7 +10652,7 @@
         },
         "locationInModule": {
           "filename": "src/projects/jsii.generated.ts",
-          "line": 22
+          "line": 20
         },
         "parameters": [
           {
@@ -10519,7 +10669,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/projects/jsii.generated.ts",
-        "line": 18
+        "line": 16
       },
       "name": "JsiiProject",
       "symbolId": "src/projects/jsii.generated:JsiiProject"
@@ -13413,30 +13563,40 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/components/vitest.ts",
-        "line": 14
+        "line": 35
       },
       "members": [
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "Test isolation (when enabled) is done by spawning a new child process for each test file.",
+            "see": "https://nodejs.org/api/child_process.html#child_processforkmodulepath-args-options",
+            "stability": "stable",
+            "summary": "Run tests in `node:child_process` using fork()."
           },
           "name": "FORKS"
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "Test isolation (when enabled) is done by spawning a new thread for each test file.",
+            "stability": "stable",
+            "summary": "Run tests in `node:worker_threads`."
           },
           "name": "THREADS"
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "Test files are run parallel using `node:child_process` fork()\n\nThis makes tests run faster, but VM module is unstable. Your tests might leak memory.",
+            "see": "https://nodejs.org/api/child_process.html#child_processforkmodulepath-args-options",
+            "stability": "stable",
+            "summary": "Run tests in isolated `node:vm`."
           },
           "name": "VMFORKS"
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "This makes tests run faster, but VM module is unstable. Your tests might leak memory.",
+            "stability": "stable",
+            "summary": "Run tests in isolated `node:vm`. Test files are run parallel using `node:worker_threads`."
           },
           "name": "VMTHREADS"
         }
@@ -13444,9 +13604,195 @@
       "name": "Pool",
       "symbolId": "src/components/vitest:Pool"
     },
+    "@nikovirtala/projen-constructs.ProjectGenerator": {
+      "assembly": "@nikovirtala/projen-constructs",
+      "base": "projen.Component",
+      "docs": {
+        "remarks": "This component automates the creation of project classes that extend Projen base classes\nwith opinionated defaults and component integration.",
+        "stability": "stable",
+        "summary": "Projen component that generates TypeScript project classes with standard configuration."
+      },
+      "fqn": "@nikovirtala/projen-constructs.ProjectGenerator",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/project-generator.ts",
+          "line": 559
+        },
+        "parameters": [
+          {
+            "docs": {
+              "summary": "- Projen project instance."
+            },
+            "name": "project",
+            "type": {
+              "fqn": "projen.Project"
+            }
+          },
+          {
+            "docs": {
+              "summary": "- Generator configuration."
+            },
+            "name": "options",
+            "type": {
+              "fqn": "@nikovirtala/projen-constructs.ProjectGeneratorOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/project-generator.ts",
+        "line": 551
+      },
+      "methods": [
+        {
+          "docs": {
+            "remarks": "Called by Projen during the synthesis phase to generate the project class file.\nThe file is marked as readonly to prevent manual editing.",
+            "stability": "stable",
+            "summary": "Generates the TypeScript class file during Projen synthesis."
+          },
+          "locationInModule": {
+            "filename": "src/project-generator.ts",
+            "line": 688
+          },
+          "name": "preSynthesize",
+          "overrides": "projen.Component"
+        }
+      ],
+      "name": "ProjectGenerator",
+      "symbolId": "src/project-generator:ProjectGenerator"
+    },
+    "@nikovirtala/projen-constructs.ProjectGeneratorOptions": {
+      "assembly": "@nikovirtala/projen-constructs",
+      "datatype": true,
+      "docs": {
+        "remarks": "Configures the generation of a TypeScript project class that extends a Projen base class\nwith standard configuration and component integration.",
+        "stability": "stable",
+        "summary": "Options for ProjectGenerator component."
+      },
+      "fqn": "@nikovirtala/projen-constructs.ProjectGeneratorOptions",
+      "interfaces": [
+        "projen.SourceCodeOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/project-generator.ts",
+        "line": 85
+      },
+      "name": "ProjectGeneratorOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "example": "\"src/projects/typescript.generated.ts\"",
+            "remarks": "Must contain a directory separator. The options interface will be generated\nin the same directory with a \".generated.ts\" suffix.",
+            "stability": "stable",
+            "summary": "Output file path for the generated class."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/project-generator.ts",
+            "line": 111
+          },
+          "name": "filePath",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "The options interface will be named `${name}Options`.",
+            "stability": "stable",
+            "summary": "Name of the generated class (e.g., \"TypeScriptProject\")."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/project-generator.ts",
+            "line": 91
+          },
+          "name": "name",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "example": "ProjectType.JSII",
+            "remarks": "Specifies which Projen base class to extend and which default configuration to apply.",
+            "stability": "stable",
+            "summary": "Project type identifier."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/project-generator.ts",
+            "line": 101
+          },
+          "name": "projectType",
+          "type": {
+            "fqn": "@nikovirtala/projen-constructs.ProjectType"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "[{ component: Mise }, { component: Vitest, optionsProperty: { name: \"vitestOptions\", type: \"...\", docs: \"...\" } }]",
+            "remarks": "Each component will be instantiated during project construction and can be\nconfigured via an optional options property in the generated interface.",
+            "stability": "stable",
+            "summary": "Components to integrate into the project."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/project-generator.ts",
+            "line": 121
+          },
+          "name": "components",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@nikovirtala/projen-constructs.Component"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Use this to hide base class options that should not be configurable\nin the generated project type.",
+            "stability": "stable",
+            "summary": "Property names to omit from the base options interface."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/project-generator.ts",
+            "line": 139
+          },
+          "name": "omitOptions",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "src/project-generator:ProjectGeneratorOptions"
+    },
     "@nikovirtala/projen-constructs.ProjectType": {
       "assembly": "@nikovirtala/projen-constructs",
       "docs": {
+        "custom": {
+          "generated": "Automatically generated from Projen's JSII manifest"
+        },
         "remarks": "Each project type corresponds to a generated project class and its configuration\nin the defaultOptions structure.",
         "stability": "stable",
         "summary": "Enum defining all supported project types."
@@ -13455,40 +13801,155 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/project-type.ts",
-        "line": 7
+        "line": 9
       },
       "members": [
         {
           "docs": {
-            "see": "https://projen.io/docs/api/typescript#typescriptproject-",
             "stability": "stable",
-            "summary": "TypeScript project with ES modules support."
+            "summary": "AWS CDK construct library project."
           },
-          "name": "TYPESCRIPT"
+          "name": "AWS_CDK_CONSTRUCT_LIBRARY"
         },
         {
           "docs": {
-            "see": "https://projen.io/docs/api/cdk#jsiiproject-",
             "stability": "stable",
-            "summary": "JSII project for publishing multi-language libraries."
+            "summary": "AWS CDK app in Java."
           },
-          "name": "JSII"
+          "name": "AWS_CDK_JAVA_APP"
         },
         {
           "docs": {
-            "see": "https://projen.io/docs/api/awscdk#awscdktypescriptapp-",
             "stability": "stable",
-            "summary": "AWS CDK TypeScript application project with ES modules support."
+            "summary": "AWS CDK app in Python."
           },
-          "name": "AWS_CDK_TYPESCRIPT_APP"
+          "name": "AWS_CDK_PYTHON_APP"
         },
         {
           "docs": {
-            "see": "https://projen.io/docs/api/awscdk/#awscdkconstructlibrary-",
             "stability": "stable",
-            "summary": "AWS CDK construct library project for publishing reusable constructs."
+            "summary": "AWS CDK app in TypeScript."
           },
-          "name": "AWS_CDK_CONSTRUCT_LIBRARY"
+          "name": "AWS_CDK_TYPE_SCRIPT_APP"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "CDK8s app in Python."
+          },
+          "name": "CDK8S_PYTHON_APP"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "CDK8s app in TypeScript."
+          },
+          "name": "CDK8S_TYPE_SCRIPT_APP"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "ConstructLibraryAws."
+          },
+          "name": "CONSTRUCT_LIBRARY_AWS"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "CDK8s construct library project."
+          },
+          "name": "CONSTRUCT_LIBRARY_CDK8S"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "CDKTF construct library project."
+          },
+          "name": "CONSTRUCT_LIBRARY_CDKTF"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "GitHub-based project."
+          },
+          "name": "GIT_HUB_PROJECT"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Java project."
+          },
+          "name": "JAVA_PROJECT"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Multi-language jsii library project."
+          },
+          "name": "JSII_PROJECT"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Next.js project using JavaScript."
+          },
+          "name": "NEXT_JS_PROJECT"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Next.js project using TypeScript."
+          },
+          "name": "NEXT_JS_TYPE_SCRIPT_PROJECT"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Node.js project."
+          },
+          "name": "NODE_PROJECT"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Python project."
+          },
+          "name": "PYTHON_PROJECT"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "React project using JavaScript."
+          },
+          "name": "REACT_PROJECT"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "React project using TypeScript."
+          },
+          "name": "REACT_TYPE_SCRIPT_PROJECT"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "TypeScript app."
+          },
+          "name": "TYPE_SCRIPT_APP_PROJECT"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "TypeScriptLibraryProject."
+          },
+          "name": "TYPE_SCRIPT_LIBRARY_PROJECT"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "TypeScript project."
+          },
+          "name": "TYPE_SCRIPT_PROJECT"
         }
       ],
       "name": "ProjectType",
@@ -13509,7 +13970,7 @@
         },
         "locationInModule": {
           "filename": "src/projects/typescript.generated.ts",
-          "line": 22
+          "line": 20
         },
         "parameters": [
           {
@@ -13526,7 +13987,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/projects/typescript.generated.ts",
-        "line": 18
+        "line": 16
       },
       "name": "TypeScriptProject",
       "symbolId": "src/projects/typescript.generated:TypeScriptProject"
@@ -16166,7 +16627,7 @@
         },
         "locationInModule": {
           "filename": "src/components/vitest.ts",
-          "line": 88
+          "line": 315
         },
         "parameters": [
           {
@@ -16187,7 +16648,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/components/vitest.ts",
-        "line": 61
+        "line": 288
       },
       "methods": [
         {
@@ -16196,7 +16657,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 62
+            "line": 289
           },
           "name": "of",
           "parameters": [
@@ -16221,7 +16682,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 150
+            "line": 377
           },
           "name": "addExclude",
           "parameters": [
@@ -16239,7 +16700,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 145
+            "line": 372
           },
           "name": "addInclude",
           "parameters": [
@@ -16257,7 +16718,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 160
+            "line": 387
           },
           "name": "configureCoverageProvider",
           "parameters": [
@@ -16275,7 +16736,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 179
+            "line": 406
           },
           "name": "configureCoverageReporters",
           "parameters": [
@@ -16298,7 +16759,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 155
+            "line": 382
           },
           "name": "configureEnvironment",
           "parameters": [
@@ -16316,7 +16777,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 184
+            "line": 411
           },
           "name": "configureGlobals"
         },
@@ -16327,7 +16788,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 135
+            "line": 362
           },
           "name": "preSynthesize",
           "overrides": "projen.Component"
@@ -16340,25 +16801,30 @@
       "assembly": "@nikovirtala/projen-constructs",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "see": "https://vitest.dev/config/",
+        "stability": "stable",
+        "summary": "Vitest Config."
       },
       "fqn": "@nikovirtala/projen-constructs.VitestConfigOptions",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/vitest.ts",
-        "line": 34
+        "line": 120
       },
       "name": "VitestConfigOptions",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "0",
+            "see": "https://vitest.dev/config/#bail",
+            "stability": "stable",
+            "summary": "Stop running tests after certain number of failures."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 49
+            "line": 240
           },
           "name": "bail",
           "optional": true,
@@ -16369,12 +16835,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"coverage\"",
+            "stability": "stable",
+            "summary": "Coverage output directory."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 44
+            "line": 200
           },
           "name": "coverageDirectory",
           "optional": true,
@@ -16385,12 +16853,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "true",
+            "see": "https://vitest.dev/config/#coverage-enabled",
+            "stability": "stable",
+            "summary": "Coverage enabled."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 41
+            "line": 177
           },
           "name": "coverageEnabled",
           "optional": true,
@@ -16401,12 +16872,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"v8\"",
+            "see": "https://vitest.dev/config/#coverage-provider",
+            "stability": "stable",
+            "summary": "Coverage provider type."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 42
+            "line": 185
           },
           "name": "coverageProvider",
           "optional": true,
@@ -16417,12 +16891,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "'[\"text\", \"lcov\"]'",
+            "see": "https://vitest.dev/config/#coverage-reporter",
+            "stability": "stable",
+            "summary": "Coverage reporters."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 43
+            "line": 193
           },
           "name": "coverageReporters",
           "optional": true,
@@ -16438,12 +16915,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"node\"",
+            "see": "https://vitest.dev/config/#environment",
+            "stability": "stable",
+            "summary": "The environment that will be used for testing."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 37
+            "line": 143
           },
           "name": "environment",
           "optional": true,
@@ -16454,12 +16934,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "- Vitest's `configDefaults.exclude`",
+            "see": "https://vitest.dev/config/#exclude",
+            "stability": "stable",
+            "summary": "A list of glob patterns that should be excluded from your test files."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 36
+            "line": 135
           },
           "name": "exclude",
           "optional": true,
@@ -16475,12 +16958,16 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "false",
+            "remarks": "If you prefer to use the APIs globally like Jest, set to `true`.",
+            "see": "https://vitest.dev/config/#globals",
+            "stability": "stable",
+            "summary": "Register apis globally."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 40
+            "line": 169
           },
           "name": "globals",
           "optional": true,
@@ -16491,12 +16978,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "- Vitest's `configDefaults.include`",
+            "see": "https://vitest.dev/config/#include",
+            "stability": "stable",
+            "summary": "A list of glob patterns that match your test files."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 35
+            "line": 127
           },
           "name": "include",
           "optional": true,
@@ -16512,12 +17002,16 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "true",
+            "remarks": "Disabling this option might improve performance if your code doesn't rely on side effects.",
+            "see": "https://vitest.dev/config/#isolate",
+            "stability": "stable",
+            "summary": "Run tests in an isolated environment. This option has no effect on vmThreads pool."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 38
+            "line": 153
           },
           "name": "isolate",
           "optional": true,
@@ -16528,12 +17022,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "true",
+            "see": "https://vitest.dev/config/#passwithnotests",
+            "stability": "stable",
+            "summary": "Vitest will not fail, if no tests will be found."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 48
+            "line": 232
           },
           "name": "passWithNoTests",
           "optional": true,
@@ -16544,12 +17041,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"forks\"",
+            "see": "https://vitest.dev/config/#pool",
+            "stability": "stable",
+            "summary": "Pool used to run tests in."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 39
+            "line": 161
           },
           "name": "pool",
           "optional": true,
@@ -16560,12 +17060,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "true",
+            "see": "https://vitest.dev/config/#consoletrace",
+            "stability": "stable",
+            "summary": "Always print console traces when calling any console method."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 51
+            "line": 256
           },
           "name": "printConsoleTrace",
           "optional": true,
@@ -16576,12 +17079,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "300",
+            "see": "https://vitest.dev/config/#slowtestthreshold",
+            "stability": "stable",
+            "summary": "The number of milliseconds after which a test or suite is considered slow."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 52
+            "line": 264
           },
           "name": "slowTestThreshold",
           "optional": true,
@@ -16592,12 +17098,16 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"tsc --noEmit\"",
+            "remarks": "Checker should implement the same output format as `tsc`.",
+            "see": "https://vitest.dev/config/#typecheck-checker",
+            "stability": "stable",
+            "summary": "Tool to use for type checking."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 46
+            "line": 216
           },
           "name": "typecheckChecker",
           "optional": true,
@@ -16608,12 +17118,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "true (for TypeScript projects)",
+            "see": "https://vitest.dev/config/#typecheck-enabled",
+            "stability": "stable",
+            "summary": "Enable typechecking alongside your regular tests."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 45
+            "line": 208
           },
           "name": "typecheckEnabled",
           "optional": true,
@@ -16624,12 +17137,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"tsconfig.dev.json\"",
+            "see": "https://vitest.dev/config/#typecheck-tsconfig",
+            "stability": "stable",
+            "summary": "Path to custom tsconfig, relative to the project root."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 47
+            "line": 224
           },
           "name": "typecheckTsconfig",
           "optional": true,
@@ -16640,12 +17156,16 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "true",
+            "remarks": "This will update all changed snapshots and delete obsolete ones.",
+            "see": "https://vitest.dev/guide/snapshot.html#updating-snapshots",
+            "stability": "stable",
+            "summary": "Update snapshot files."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 50
+            "line": 248
           },
           "name": "updateSnapshots",
           "optional": true,
@@ -16666,19 +17186,20 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/vitest.ts",
-        "line": 55
+        "line": 267
       },
       "name": "VitestOptions",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Initial config options."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 57
+            "line": 278
           },
           "name": "config",
           "optional": true,
@@ -16689,12 +17210,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"vitest.config.ts\"",
+            "stability": "stable",
+            "summary": "Config file path."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 56
+            "line": 273
           },
           "name": "configFilePath",
           "optional": true,
@@ -16705,12 +17228,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"^4\"",
+            "stability": "stable",
+            "summary": "Vitest version."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 58
+            "line": 285
           },
           "name": "vitestVersion",
           "optional": true,
@@ -16722,6 +17247,6 @@
       "symbolId": "src/components/vitest:VitestOptions"
     }
   },
-  "version": "0.1.8",
-  "fingerprint": "AuVCeOtv0O0ZLGVa6UBbewG7QH3rHriJ2CXjqE/uIpk="
+  "version": "0.2.0",
+  "fingerprint": "xuX563zrmTKL1EVuZhYRywKnsCFqGf4m29DJkKiXN64="
 }