@nikovirtala/projen-constructs 0.3.77 → 0.3.79

package/.jsii

@@ -4196,7 +4196,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\nRequires pnpm 11 and `projen` >= 0.101.27. `@mrgrain/cdk-esbuild` and `constructs` are peer\ndependencies as well.\n\nTo create a project from scratch:\n\n```bash\npnpm dlx projen new --from @nikovirtala/projen-constructs aws_cdk_construct_library\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 the `ProjectType` enum from Projen's JSII manifest (19 project types)\n- **Component System**: Reusable components (Vitest, TypeDoc, Mise, Homebrew, Colima, LocalStack, Lambda bundling)\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 11.20.0\n- **Node Version**: 24.19.0\n- **TypeScript**: 6.0.3\n- **CDK Version**: 2.263.0 (for CDK projects)\n- **JSII Version**: ~6.0.3 (for JSII projects)\n\nThe AWS CDK, Node.js and TypeScript versions live in `src/versions.json` and are refreshed by the\n`update-versions` task, which the dependency upgrade workflow runs.\n\n### pnpm\n\npnpm reads its settings from `pnpm-workspace.yaml`, not `.npmrc`, since pnpm 11. Generated projects\nget:\n\n| Setting                | Value             | Reason                                                                                                       |\n| ---------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------ |\n| `nodeLinker`           | `hoisted`         | jsii tooling resolves dependencies from a flat `node_modules`                                                |\n| `allowBuilds`          | `esbuild: true`   | esbuild links its platform binary in a postinstall script, and pnpm 11 fails an install with ignored builds   |\n| `verifyDepsBeforeRun`  | `false`           | projen resolves the task `PATH` with `$(pnpm -c exec ...)`, which otherwise re-enters `pnpm install` and deadlocks |\n| `minimumReleaseAge`    | `0`              | the pnpm 11 default of 1440 minutes makes pnpm write `minimumReleaseAgeExclude` entries into this generated file |\n\n### TypeScript configuration\n\nProjen renders three configs, and none of them should be edited directly:\n\n- `tsconfig.json` compiles `src` to `lib`. For JSII projects, jsii validates it against its `strict`\n  rule set, so it only carries compiler options jsii accepts.\n- `test/tsconfig.json` extends it and is type-check only. This is the config Vitest type checking and\n  the editor use, and the one `tsconfigDev` points at.\n- `projenrc/tsconfig.json` covers `.projenrc.ts`.\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: \"24.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\nEvery component is exposed as an enable flag (`mise`, `vitest`, ...) plus an options property\n(`miseOptions`, `vitestOptions`, ...).\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\nType checking runs against the project's development tsconfig (`test/tsconfig.json`) unless\n`config.typecheckTsconfig` says otherwise.\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: \"24.19.0\",\n});\n```\n\n#### Homebrew\n\n[Homebrew](https://brew.sh) package management component. Writes a `Brewfile` and adds an\n`install:homebrew` task that bootstraps Homebrew and runs `brew bundle`.\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.TYPE_SCRIPT_PROJECT,\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\n- Automatically generates the `ProjectType` enum from Projen's JSII manifest\n- Auto-detects component options types from JSII manifests\n- Strips Projen's `@pjnew` annotation from `packageManager`, which `projen new` would otherwise\n  render into a generated `.projenrc.ts` as the package manager that ran the command\n- Validates paths to prevent directory traversal attacks\n- Structured error handling with custom error classes\n\n## Development\n\nThis project is managed by Projen and generates itself: `.projenrc.ts` defines the project using the\n`JsiiProject` type from `src/`. Configuration changes belong in `.projenrc.ts`, never in the\ngenerated files.\n\n```bash\npnpm projen           # synthesize project files\npnpm build            # synthesize, compile, test and package\npnpm test             # biome, vitest, typedoc\npnpm test:watch       # vitest in watch mode\npnpm test:update      # update snapshots\npnpm biome            # format and lint\npnpm docgen           # regenerate API.md from the .jsii manifest\npnpm update-versions  # refresh src/versions.json\npnpm upgrade          # upgrade dependencies\n```\n\n### Build process\n\n```mermaid\nflowchart TD\n    projenrc[\".projenrc.ts\"]\n\n    subgraph synthesize[\"default (synthesize)\"]\n        direction TB\n        synth[\"tsx .projenrc.ts\"]\n        generator[\"ProjectGenerator\"]\n        generated[\"src/project-type.ts<br/>src/projects/*.generated.ts<br/>src/projects/*-options.generated.ts\"]\n        projenfiles[\"package.json, tsconfig.json,<br/>pnpm-workspace.yaml, workflows, ...\"]\n        brew[\"install:homebrew<br/>brew bundle\"]\n        definecfg[\"bundle-vitest-define-config<br/>esbuild → lib/vitest-define-config.js\"]\n\n        synth --> generator --> generated\n        synth --> projenfiles\n        synth --> brew\n        synth --> definecfg\n    end\n\n    subgraph compile[\"compile\"]\n        direction TB\n        jsii[\"jsii<br/>validates tsconfig.json against the strict rule set\"]\n        lib[\"lib/**\"]\n        manifest[\".jsii manifest\"]\n\n        jsii --> lib\n        jsii --> manifest\n    end\n\n    subgraph test[\"test\"]\n        direction TB\n        biome[\"biome check --write\"]\n        vitest[\"vitest run<br/>+ type checking\"]\n        typedoc[\"typedoc → docs/api\"]\n\n        biome --> vitest --> typedoc\n    end\n\n    subgraph package[\"package\"]\n        direction TB\n        pacmak[\"jsii-pacmak<br/>--pack-command 'pnpm pack'\"]\n        dist[\"dist/js/*.tgz\"]\n\n        pacmak --> dist\n    end\n\n    projenrc --> synthesize\n    synthesize --> compile\n    compile --> test\n    test --> package\n\n    manifest -. \"component options FQNs<br/>read on the next synthesis\" .-> generator\n    docgen[\"docgen<br/>jsii-docgen → API.md\"]\n    manifest --> docgen\n\n    classDef artifact fill:#eef,stroke:#88a\n    class generated,projenfiles,lib,manifest,dist artifact\n```\n\nThe dashed edge is the part worth knowing about: `ProjectGenerator` reads the committed `.jsii`\nmanifest to resolve component options types, so the manifest produced by `compile` feeds the *next*\nsynthesis. This is why `.jsii` is committed rather than ignored. A component options type that is\nmissing from the manifest is reported as a warning and its options property is left out of the\ngenerated interface, which is expected only while a new component is being introduced: compile once,\nthen synthesize again.\n\n`package` runs `package:js` on CI and `package-all` locally; both end up in `jsii-pacmak`.\n`docgen` is not part of `build` and has to be run explicitly after the manifest changes.\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\nRequires pnpm 11 and `projen` >= 0.101.27. `@mrgrain/cdk-esbuild` and `constructs` are peer\ndependencies as well.\n\nTo create a project from scratch:\n\n```bash\npnpm dlx projen new --from @nikovirtala/projen-constructs aws_cdk_construct_library\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 the `ProjectType` enum from Projen's JSII manifest (19 project types)\n- **Component System**: Reusable components (Vitest, TypeDoc, Mise, Homebrew, Colima, LocalStack, Lambda bundling)\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 11.20.0\n- **Node Version**: 24.19.0\n- **TypeScript**: 6.0.3\n- **CDK Version**: 2.263.0 (for CDK projects)\n- **JSII Version**: ~6.0.3 (for JSII projects)\n\nThe AWS CDK, Node.js and TypeScript versions live in `src/versions.json` and are refreshed by the\n`update-versions` task, which the dependency upgrade workflow runs.\n\n### pnpm\n\npnpm reads its settings from `pnpm-workspace.yaml`, not `.npmrc`, since pnpm 11. Generated projects\nget:\n\n| Setting                | Value             | Reason                                                                                                       |\n| ---------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------ |\n| `nodeLinker`           | `hoisted`         | jsii tooling resolves dependencies from a flat `node_modules`                                                |\n| `allowBuilds`          | `esbuild: true`   | esbuild links its platform binary in a postinstall script, and pnpm 11 fails an install with ignored builds   |\n| `verifyDepsBeforeRun`  | `false`           | projen resolves the task `PATH` with `$(pnpm -c exec ...)`, which otherwise re-enters `pnpm install` and deadlocks |\n| `minimumReleaseAge`    | `0`              | the pnpm 11 default of 1440 minutes makes pnpm write `minimumReleaseAgeExclude` entries into this generated file |\n\n### TypeScript configuration\n\nProjen renders three configs, and none of them should be edited directly:\n\n- `tsconfig.json` compiles `src` to `lib`. For JSII projects, jsii validates it against its `strict`\n  rule set, so it only carries compiler options jsii accepts.\n- `test/tsconfig.json` extends it and is type-check only. This is the config Vitest type checking and\n  the editor use, and the one `tsconfigDev` points at.\n- `projenrc/tsconfig.json` covers `.projenrc.ts`.\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: \"24.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\nEvery component is exposed as an enable flag (`mise`, `vitest`, ...) plus an options property\n(`miseOptions`, `vitestOptions`, ...).\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\nType checking runs against the project's development tsconfig (`test/tsconfig.json`) unless\n`config.typecheckTsconfig` says otherwise.\n\nFor Vitest settings that `config` doesn't cover, use `extraTestConfig` (merged into `test`) and\n`extraConfig` (top-level options next to `test`):\n\n```typescript\nnew Vitest(project, {\n  extraTestConfig: {\n    setupFiles: [\"test/setup.ts\"],\n  },\n  extraConfig: {\n    resolve: { alias: { \"@\": \"/src\" } },\n  },\n});\n```\n\n`extraTestConfig` is deep-merged over the generated `test` options: objects merge, and other values\n(including arrays) replace the generated value. Both options are rendered as JSON, so their values\ncan't contain functions or regular expressions, which rules out plugins.\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: \"24.19.0\",\n});\n```\n\n#### Homebrew\n\n[Homebrew](https://brew.sh) package management component. Writes a `Brewfile` and adds an\n`install:homebrew` task that bootstraps Homebrew and runs `brew bundle`.\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.TYPE_SCRIPT_PROJECT,\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\n- Automatically generates the `ProjectType` enum from Projen's JSII manifest\n- Auto-detects component options types from JSII manifests\n- Strips Projen's `@pjnew` annotation from `packageManager`, which `projen new` would otherwise\n  render into a generated `.projenrc.ts` as the package manager that ran the command\n- Validates paths to prevent directory traversal attacks\n- Structured error handling with custom error classes\n\n## Development\n\nThis project is managed by Projen and generates itself: `.projenrc.ts` defines the project using the\n`JsiiProject` type from `src/`. Configuration changes belong in `.projenrc.ts`, never in the\ngenerated files.\n\n```bash\npnpm projen           # synthesize project files\npnpm build            # synthesize, compile, test and package\npnpm test             # biome, vitest, typedoc\npnpm test:watch       # vitest in watch mode\npnpm test:update      # update snapshots\npnpm biome            # format and lint\npnpm docgen           # regenerate API.md from the .jsii manifest\npnpm update-versions  # refresh src/versions.json\npnpm upgrade          # upgrade dependencies\n```\n\n### Build process\n\n```mermaid\nflowchart TD\n    projenrc[\".projenrc.ts\"]\n\n    subgraph synthesize[\"default (synthesize)\"]\n        direction TB\n        synth[\"tsx .projenrc.ts\"]\n        generator[\"ProjectGenerator\"]\n        generated[\"src/project-type.ts<br/>src/projects/*.generated.ts<br/>src/projects/*-options.generated.ts\"]\n        projenfiles[\"package.json, tsconfig.json,<br/>pnpm-workspace.yaml, workflows, ...\"]\n        brew[\"install:homebrew<br/>brew bundle\"]\n        definecfg[\"bundle-vitest-define-config<br/>esbuild → lib/vitest-define-config.js\"]\n\n        synth --> generator --> generated\n        synth --> projenfiles\n        synth --> brew\n        synth --> definecfg\n    end\n\n    subgraph compile[\"compile\"]\n        direction TB\n        jsii[\"jsii<br/>validates tsconfig.json against the strict rule set\"]\n        lib[\"lib/**\"]\n        manifest[\".jsii manifest\"]\n\n        jsii --> lib\n        jsii --> manifest\n    end\n\n    subgraph test[\"test\"]\n        direction TB\n        biome[\"biome check --write\"]\n        vitest[\"vitest run<br/>+ type checking\"]\n        typedoc[\"typedoc → docs/api\"]\n\n        biome --> vitest --> typedoc\n    end\n\n    subgraph package[\"package\"]\n        direction TB\n        pacmak[\"jsii-pacmak<br/>--pack-command 'pnpm pack'\"]\n        dist[\"dist/js/*.tgz\"]\n\n        pacmak --> dist\n    end\n\n    projenrc --> synthesize\n    synthesize --> compile\n    compile --> test\n    test --> package\n\n    manifest -. \"component options FQNs<br/>read on the next synthesis\" .-> generator\n    docgen[\"docgen<br/>jsii-docgen → API.md\"]\n    manifest --> docgen\n\n    classDef artifact fill:#eef,stroke:#88a\n    class generated,projenfiles,lib,manifest,dist artifact\n```\n\nThe dashed edge is the part worth knowing about: `ProjectGenerator` reads the committed `.jsii`\nmanifest to resolve component options types, so the manifest produced by `compile` feeds the *next*\nsynthesis. This is why `.jsii` is committed rather than ignored. A component options type that is\nmissing from the manifest is reported as a warning and its options property is left out of the\ngenerated interface, which is expected only while a new component is being introduced: compile once,\nthen synthesize again.\n\n`package` runs `package:js` on CI and `package-all` locally; both end up in `jsii-pacmak`.\n`docgen` is not part of `build` and has to be run explicitly after the manifest changes.\n"
   },
   "repository": {
     "type": "git",
@@ -10995,7 +10995,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 149
+        "line": 158
       },
       "name": "Bundle",
       "properties": [
@@ -11007,7 +11007,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 150
+            "line": 159
           },
           "name": "bundleTask",
           "type": {
@@ -11022,7 +11022,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 152
+            "line": 161
           },
           "name": "outdir",
           "type": {
@@ -11037,7 +11037,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 151
+            "line": 160
           },
           "name": "outfile",
           "type": {
@@ -11060,7 +11060,7 @@
         },
         "locationInModule": {
           "filename": "src/components/bundle-lambda-function-code.ts",
-          "line": 41
+          "line": 50
         },
         "parameters": [
           {
@@ -11081,7 +11081,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 28
+        "line": 37
       },
       "methods": [
         {
@@ -11090,7 +11090,7 @@
           },
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 29
+            "line": 38
           },
           "name": "of",
           "parameters": [
@@ -11115,7 +11115,7 @@
           },
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 62
+            "line": 71
           },
           "name": "addBundle",
           "parameters": [
@@ -11148,7 +11148,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 35
+            "line": 44
           },
           "name": "bundledir",
           "type": {
@@ -11162,7 +11162,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 49
+            "line": 58
           },
           "name": "bundleTask",
           "type": {
@@ -11176,7 +11176,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 34
+            "line": 43
           },
           "name": "esbuildVersion",
           "optional": true,
@@ -11197,7 +11197,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 21
+        "line": 30
       },
       "name": "BundlerOptions",
       "properties": [
@@ -11209,7 +11209,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 24
+            "line": 33
           },
           "name": "addToPreCompile",
           "optional": true,
@@ -11225,7 +11225,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 23
+            "line": 32
           },
           "name": "assetsDir",
           "optional": true,
@@ -11241,7 +11241,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 22
+            "line": 31
           },
           "name": "esbuildVersion",
           "optional": true,
@@ -11257,7 +11257,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 25
+            "line": 34
           },
           "name": "loaders",
           "optional": true,
@@ -11283,7 +11283,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 155
+        "line": 164
       },
       "name": "BundlingOptions",
       "properties": [
@@ -11295,7 +11295,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 167
+            "line": 176
           },
           "name": "banner",
           "optional": true,
@@ -11311,7 +11311,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 156
+            "line": 165
           },
           "name": "externals",
           "optional": true,
@@ -11332,7 +11332,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 163
+            "line": 172
           },
           "name": "format",
           "optional": true,
@@ -11348,7 +11348,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 162
+            "line": 171
           },
           "name": "loaders",
           "optional": true,
@@ -11369,7 +11369,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 166
+            "line": 175
           },
           "name": "mainFields",
           "optional": true,
@@ -11385,7 +11385,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 164
+            "line": 173
           },
           "name": "minify",
           "optional": true,
@@ -11401,7 +11401,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 160
+            "line": 169
           },
           "name": "outfile",
           "optional": true,
@@ -11417,7 +11417,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 159
+            "line": 168
           },
           "name": "platform",
           "optional": true,
@@ -11433,7 +11433,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 157
+            "line": 166
           },
           "name": "sourcemap",
           "optional": true,
@@ -11449,7 +11449,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 165
+            "line": 174
           },
           "name": "sourcesContent",
           "optional": true,
@@ -11465,7 +11465,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 158
+            "line": 167
           },
           "name": "target",
           "optional": true,
@@ -11481,7 +11481,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 161
+            "line": 170
           },
           "name": "tsconfigPath",
           "optional": true,
@@ -15273,7 +15273,7 @@
         },
         "locationInModule": {
           "filename": "src/components/bundle-lambda-function-code.ts",
-          "line": 179
+          "line": 188
         },
         "parameters": [
           {
@@ -15293,7 +15293,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 178
+        "line": 187
       },
       "name": "LambdaFunctionCodeBundle",
       "symbolId": "src/components/bundle-lambda-function-code:LambdaFunctionCodeBundle"
@@ -15308,7 +15308,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 170
+        "line": 179
       },
       "name": "LambdaFunctionCodeBundleOptions",
       "properties": [
@@ -15320,7 +15320,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 171
+            "line": 180
           },
           "name": "entrypoint",
           "type": {
@@ -15335,7 +15335,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 172
+            "line": 181
           },
           "name": "extension",
           "type": {
@@ -15350,7 +15350,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 175
+            "line": 184
           },
           "name": "bundlingOptions",
           "optional": true,
@@ -15366,7 +15366,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 173
+            "line": 182
           },
           "name": "constructFile",
           "optional": true,
@@ -15382,7 +15382,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 174
+            "line": 183
           },
           "name": "constructName",
           "optional": true,
@@ -15395,9 +15395,10 @@
     },
     "@nikovirtala/projen-constructs.LambdaFunctionCodeBundler": {
       "assembly": "@nikovirtala/projen-constructs",
-      "base": "projen.Component",
+      "base": "projen.cdk.AutoDiscoverBase",
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Creates Lambda Function code bundles from entrypoints discovered in the project's source tree."
       },
       "fqn": "@nikovirtala/projen-constructs.LambdaFunctionCodeBundler",
       "initializer": {
@@ -15406,7 +15407,7 @@
         },
         "locationInModule": {
           "filename": "src/components/bundle-lambda-function-code.ts",
-          "line": 238
+          "line": 250
         },
         "parameters": [
           {
@@ -15426,7 +15427,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 237
+        "line": 249
       },
       "name": "LambdaFunctionCodeBundler",
       "symbolId": "src/components/bundle-lambda-function-code:LambdaFunctionCodeBundler"
@@ -15441,7 +15442,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 231
+        "line": 240
       },
       "name": "LambdaFunctionCodeBundlerOptions",
       "properties": [
@@ -15453,7 +15454,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 232
+            "line": 241
           },
           "name": "extension",
           "type": {
@@ -15468,7 +15469,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 233
+            "line": 242
           },
           "name": "srcdir",
           "type": {
@@ -15483,7 +15484,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 234
+            "line": 243
           },
           "name": "bundleOptions",
           "optional": true,
@@ -20574,7 +20575,7 @@
         },
         "locationInModule": {
           "filename": "src/components/vitest.ts",
-          "line": 317
+          "line": 344
         },
         "parameters": [
           {
@@ -20595,7 +20596,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/components/vitest.ts",
-        "line": 290
+        "line": 315
       },
       "methods": [
         {
@@ -20604,7 +20605,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 291
+            "line": 316
           },
           "name": "of",
           "parameters": [
@@ -20629,7 +20630,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 383
+            "line": 417
           },
           "name": "addExclude",
           "parameters": [
@@ -20647,7 +20648,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 378
+            "line": 412
           },
           "name": "addInclude",
           "parameters": [
@@ -20665,7 +20666,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 393
+            "line": 427
           },
           "name": "configureCoverageProvider",
           "parameters": [
@@ -20683,7 +20684,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 412
+            "line": 446
           },
           "name": "configureCoverageReporters",
           "parameters": [
@@ -20706,7 +20707,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 388
+            "line": 422
           },
           "name": "configureEnvironment",
           "parameters": [
@@ -20724,7 +20725,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 417
+            "line": 451
           },
           "name": "configureGlobals"
         },
@@ -20735,7 +20736,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 368
+            "line": 402
           },
           "name": "preSynthesize",
           "overrides": "projen.Component"
@@ -21172,6 +21173,58 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no additional top-level options",
+            "example": "{ resolve: { alias: { \"@\": \"/src\" } } }",
+            "remarks": "Values are rendered as JSON, so they must be JSON-serializable (no functions or regular expressions,\nwhich rules out plugins). Use `extraTestConfig` for `test` options.",
+            "see": "https://vitest.dev/config/",
+            "stability": "stable",
+            "summary": "Additional top-level config options, next to `test`, such as `resolve`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/components/vitest.ts",
+            "line": 312
+          },
+          "name": "extraConfig",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "any"
+              },
+              "kind": "map"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no additional test options",
+            "example": "{ setupFiles: [\"test/setup.ts\"], expect: { requireAssertions: true } }",
+            "remarks": "Deep-merged over the options generated from `config`: objects are merged, other values (including\narrays) replace the generated value. Values are rendered as JSON, so they must be JSON-serializable\n(no functions or regular expressions).",
+            "see": "https://vitest.dev/config/",
+            "stability": "stable",
+            "summary": "Additional `test` options for settings that `config` doesn't cover, such as `setupFiles` or `expect`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/components/vitest.ts",
+            "line": 300
+          },
+          "name": "extraTestConfig",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "any"
+              },
+              "kind": "map"
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -21194,6 +21247,6 @@
       "symbolId": "src/components/vitest:VitestOptions"
     }
   },
-  "version": "0.3.77",
-  "fingerprint": "q+PzlPyAVBri9CYWJDVRrx+IBvfzcv1iPhLEM/+cimE="
+  "version": "0.3.79",
+  "fingerprint": "VRPwvbb0ZYcBikmET25BdRi+oXVjSIHOXFDkc0B/2DE="
 }

package/README.md

@@ -175,6 +175,24 @@ new Vitest(project, {
 Type checking runs against the project's development tsconfig (`test/tsconfig.json`) unless
 `config.typecheckTsconfig` says otherwise.
 
+For Vitest settings that `config` doesn't cover, use `extraTestConfig` (merged into `test`) and
+`extraConfig` (top-level options next to `test`):
+
+```typescript
+new Vitest(project, {
+  extraTestConfig: {
+    setupFiles: ["test/setup.ts"],
+  },
+  extraConfig: {
+    resolve: { alias: { "@": "/src" } },
+  },
+});
+```
+
+`extraTestConfig` is deep-merged over the generated `test` options: objects merge, and other values
+(including arrays) replace the generated value. Both options are rendered as JSON, so their values
+can't contain functions or regular expressions, which rules out plugins.
+
 #### TypeDoc
 
 [TypeDoc](https://typedoc.org) documentation generation component.