@nikovirtala/projen-constructs 0.3.78 → 0.3.80

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",
@@ -10989,25 +10989,27 @@
       "assembly": "@nikovirtala/projen-constructs",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "A bundle created by `Bundler.addBundle`."
       },
       "fqn": "@nikovirtala/projen-constructs.Bundle",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 158
+        "line": 235
       },
       "name": "Bundle",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "The task that produces this bundle."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 159
+            "line": 239
           },
           "name": "bundleTask",
           "type": {
@@ -11017,12 +11019,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Base directory containing the output file (relative to project root)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 161
+            "line": 249
           },
           "name": "outdir",
           "type": {
@@ -11032,12 +11035,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Location of the output file (relative to project root)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 160
+            "line": 244
           },
           "name": "outfile",
           "type": {
@@ -11051,16 +11055,18 @@
       "assembly": "@nikovirtala/projen-constructs",
       "base": "projen.Component",
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Adds support for bundling JavaScript applications and dependencies into a single file."
       },
       "fqn": "@nikovirtala/projen-constructs.Bundler",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "stability": "stable",
+          "summary": "Creates a `Bundler`."
         },
         "locationInModule": {
           "filename": "src/components/bundle-lambda-function-code.ts",
-          "line": 50
+          "line": 106
         },
         "parameters": [
           {
@@ -11081,20 +11087,25 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 37
+        "line": 76
       },
       "methods": [
         {
           "docs": {
-            "stability": "stable"
+            "returns": "A bundler",
+            "stability": "stable",
+            "summary": "Returns the `Bundler` instance associated with a project or `undefined` if there is no Bundler."
           },
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 38
+            "line": 84
           },
           "name": "of",
           "parameters": [
             {
+              "docs": {
+                "summary": "The project."
+              },
               "name": "project",
               "type": {
                 "fqn": "projen.Project"
@@ -11111,21 +11122,28 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Adds a task to the project which bundles a specific entrypoint and all of its dependencies into a single javascript output file."
           },
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 71
+            "line": 140
           },
           "name": "addBundle",
           "parameters": [
             {
+              "docs": {
+                "summary": "The relative path of the artifact within the project."
+              },
               "name": "entrypoint",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "summary": "Bundling options."
+              },
               "name": "options",
               "type": {
                 "fqn": "@nikovirtala/projen-constructs.BundlingOptions"
@@ -11143,12 +11161,13 @@
       "properties": [
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Root bundle directory."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 44
+            "line": 97
           },
           "name": "bundledir",
           "type": {
@@ -11157,12 +11176,14 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "If the project doesn't have a \"bundle\" task, it will be created and spawned\nduring the pre-compile phase (unless `addToPreCompile` is `false`).",
+            "stability": "stable",
+            "summary": "Gets or creates the singleton \"bundle\" task of the project."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 58
+            "line": 120
           },
           "name": "bundleTask",
           "type": {
@@ -11171,12 +11192,13 @@
         },
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "The semantic version requirement for `esbuild` (if defined)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 43
+            "line": 92
           },
           "name": "esbuildVersion",
           "optional": true,
@@ -11191,25 +11213,28 @@
       "assembly": "@nikovirtala/projen-constructs",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Options for `Bundler`."
       },
       "fqn": "@nikovirtala/projen-constructs.BundlerOptions",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 30
+        "line": 41
       },
       "name": "BundlerOptions",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "true",
+            "stability": "stable",
+            "summary": "Install the `bundle` command as a pre-compile phase."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 33
+            "line": 61
           },
           "name": "addToPreCompile",
           "optional": true,
@@ -11220,12 +11245,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"assets\"",
+            "stability": "stable",
+            "summary": "Output directory for all bundles."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 32
+            "line": 54
           },
           "name": "assetsDir",
           "optional": true,
@@ -11236,12 +11263,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "- no specific version (implies latest)",
+            "stability": "stable",
+            "summary": "The semantic version requirement for `esbuild`."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 31
+            "line": 47
           },
           "name": "esbuildVersion",
           "optional": true,
@@ -11252,12 +11281,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "- no loaders",
+            "remarks": "Loaders are appended to the esbuild command by `--loader:.extension=loader`",
+            "stability": "stable",
+            "summary": "Map of file extensions (without dot) and loaders to use for this file type."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 34
+            "line": 69
           },
           "name": "loaders",
           "optional": true,
@@ -11277,25 +11309,30 @@
       "assembly": "@nikovirtala/projen-constructs",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Options for bundling."
       },
       "fqn": "@nikovirtala/projen-constructs.BundlingOptions",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 164
+        "line": 255
       },
       "name": "BundlingOptions",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\":js=import { createRequire as topLevelCreateRequire } from 'module';const require = topLevelCreateRequire(import.meta.url)\"",
+            "remarks": "The default defines `require` so that CommonJS dependencies work in an ES module bundle.",
+            "see": "https://esbuild.github.io/api/#banner",
+            "stability": "stable",
+            "summary": "esbuild `--banner` argument, appended as is (so it starts with the file type, e.g. `:js=`)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 176
+            "line": 359
           },
           "name": "banner",
           "optional": true,
@@ -11306,12 +11343,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "[]",
+            "remarks": "Instead of being bundled, the import will be preserved (using require for\nthe iife and cjs formats and using import for the esm format) and will be\nevaluated at run time instead.\n\nThis has several uses. First of all, it can be used to trim unnecessary\ncode from your bundle for a code path that you know will never be executed.\nFor example, a package may contain code that only runs in node but you will\nonly be using that package in the browser. It can also be used to import\ncode in node at run time from a package that cannot be bundled. For\nexample, the fsevents package contains a native extension, which esbuild\ndoesn't support.",
+            "stability": "stable",
+            "summary": "You can mark a file or a package as external to exclude it from your build."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 165
+            "line": 272
           },
           "name": "externals",
           "optional": true,
@@ -11327,12 +11367,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"esm\"",
+            "see": "https://esbuild.github.io/api/#format",
+            "stability": "stable",
+            "summary": "Output format for the generated JavaScript files: `\"iife\"`, `\"cjs\"` or `\"esm\"`."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 172
+            "line": 325
           },
           "name": "format",
           "optional": true,
@@ -11343,12 +11386,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "- the loaders of the `Bundler`",
+            "remarks": "Loaders are appended to the esbuild command by `--loader:.extension=loader`",
+            "stability": "stable",
+            "summary": "Map of file extensions (without dot) and loaders to use for this file type."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 171
+            "line": 317
           },
           "name": "loaders",
           "optional": true,
@@ -11364,12 +11410,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"module,main\"",
+            "see": "https://esbuild.github.io/api/#main-fields",
+            "stability": "stable",
+            "summary": "Comma-separated list of `package.json` fields esbuild tries when resolving a package."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 175
+            "line": 349
           },
           "name": "mainFields",
           "optional": true,
@@ -11380,12 +11429,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "true",
+            "see": "https://esbuild.github.io/api/#minify",
+            "stability": "stable",
+            "summary": "Minify the bundle."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 173
+            "line": 333
           },
           "name": "minify",
           "optional": true,
@@ -11396,12 +11448,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"index.mjs\"",
+            "stability": "stable",
+            "summary": "Bundler output path relative to the asset's output directory."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 169
+            "line": 300
           },
           "name": "outfile",
           "optional": true,
@@ -11412,12 +11466,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"node\"",
+            "stability": "stable",
+            "summary": "esbuild platform."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 168
+            "line": 293
           },
           "name": "platform",
           "optional": true,
@@ -11428,12 +11484,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "true",
+            "stability": "stable",
+            "summary": "Include a source map in the bundle."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 166
+            "line": 279
           },
           "name": "sourcemap",
           "optional": true,
@@ -11444,12 +11502,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "false",
+            "see": "https://esbuild.github.io/api/#sources-content",
+            "stability": "stable",
+            "summary": "Include the original source code in the source map."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 174
+            "line": 341
           },
           "name": "sourcesContent",
           "optional": true,
@@ -11460,12 +11521,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"esnext\"",
+            "stability": "stable",
+            "summary": "esbuild target."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 167
+            "line": 286
           },
           "name": "target",
           "optional": true,
@@ -11476,12 +11539,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "- no tsconfig is passed to esbuild",
+            "remarks": "`LambdaFunctionCodeBundle` always sets this to the project's development tsconfig.",
+            "stability": "stable",
+            "summary": "The path of the tsconfig.json file to use for bundling."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 170
+            "line": 309
           },
           "name": "tsconfigPath",
           "optional": true,
@@ -11496,7 +11562,9 @@
       "assembly": "@nikovirtala/projen-constructs",
       "base": "projen.Component",
       "docs": {
-        "stability": "stable"
+        "remarks": "Adds Colima support to your project with automatic installation and startup.",
+        "stability": "stable",
+        "summary": "Colima component for projen projects."
       },
       "fqn": "@nikovirtala/projen-constructs.Colima",
       "initializer": {
@@ -11505,7 +11573,7 @@
         },
         "locationInModule": {
           "filename": "src/components/colima.ts",
-          "line": 8
+          "line": 13
         },
         "parameters": [
           {
@@ -11519,7 +11587,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/components/colima.ts",
-        "line": 7
+        "line": 12
       },
       "name": "Colima",
       "symbolId": "src/components/colima:Colima"
@@ -15264,25 +15332,35 @@
       "assembly": "@nikovirtala/projen-constructs",
       "base": "projen.Component",
       "docs": {
-        "stability": "stable"
+        "example": "new Bundler(myProject);\nnew LambdaFunctionCodeBundle(myProject, {\n  entrypoint: \"src/foo.lambda.ts\",\n  extension: \".lambda.ts\",\n});",
+        "remarks": "Adds a task to the project's `Bundler` that uses `esbuild` to bundle the\nhandler into the assets directory, and generates a file (e.g. `src/foo-code.ts`)\nexporting an `aws_lambda.Code` constant (e.g. `FooFunctionCode`) that points to\nthe bundle. Pass it as the `code` of an `aws_lambda.Function`.\n\nRequires a `Bundler` component in the project.",
+        "stability": "stable",
+        "summary": "Generates a pre-bundled AWS Lambda Function code asset from handler code."
       },
       "fqn": "@nikovirtala/projen-constructs.LambdaFunctionCodeBundle",
       "initializer": {
         "docs": {
-          "stability": "stable"
+          "stability": "stable",
+          "summary": "Defines a pre-bundled AWS Lambda Function code asset from handler code."
         },
         "locationInModule": {
           "filename": "src/components/bundle-lambda-function-code.ts",
-          "line": 188
+          "line": 433
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "The project to use."
+            },
             "name": "project",
             "type": {
               "fqn": "projen.Project"
             }
           },
           {
+            "docs": {
+              "summary": "Options."
+            },
             "name": "options",
             "type": {
               "fqn": "@nikovirtala/projen-constructs.LambdaFunctionCodeBundleOptions"
@@ -15293,7 +15371,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 187
+        "line": 426
       },
       "name": "LambdaFunctionCodeBundle",
       "symbolId": "src/components/bundle-lambda-function-code:LambdaFunctionCodeBundle"
@@ -15302,25 +15380,29 @@
       "assembly": "@nikovirtala/projen-constructs",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Options for `LambdaFunctionCodeBundle`."
       },
       "fqn": "@nikovirtala/projen-constructs.LambdaFunctionCodeBundleOptions",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 179
+        "line": 365
       },
       "name": "LambdaFunctionCodeBundleOptions",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "example": "\"src/subdir/foo.lambda.ts\"",
+            "remarks": "This is relative to the root directory of the project.",
+            "stability": "stable",
+            "summary": "A path from the project root directory to a TypeScript file which contains the AWS Lambda handler entrypoint (exports a `handler` function)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 180
+            "line": 374
           },
           "name": "entrypoint",
           "type": {
@@ -15330,12 +15412,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "example": "\".lambda.ts\"",
+            "stability": "stable",
+            "summary": "Suffix for AWS Lambda handlers."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 181
+            "line": 381
           },
           "name": "extension",
           "type": {
@@ -15345,12 +15429,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "- the defaults of `BundlingOptions`",
+            "stability": "stable",
+            "summary": "Bundling options for this AWS Lambda Function."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 184
+            "line": 405
           },
           "name": "bundlingOptions",
           "optional": true,
@@ -15361,12 +15447,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "- The path of the entrypoint file, with the `-code.ts` suffix\ninstead of the extension (e.g. `src/foo-code.ts`).",
+            "remarks": "This file should also be\nunder the source tree.",
+            "stability": "stable",
+            "summary": "The name of the generated TypeScript source file."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 182
+            "line": 390
           },
           "name": "constructFile",
           "optional": true,
@@ -15377,12 +15466,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "- A pascal cased version of the name of the entrypoint file, with\nthe suffix `FunctionCode` (e.g. `ResizeImageFunctionCode`).",
+            "stability": "stable",
+            "summary": "The name of the generated `aws_lambda.Code` constant."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 183
+            "line": 398
           },
           "name": "constructName",
           "optional": true,
@@ -15407,7 +15498,7 @@
         },
         "locationInModule": {
           "filename": "src/components/bundle-lambda-function-code.ts",
-          "line": 250
+          "line": 516
         },
         "parameters": [
           {
@@ -15427,7 +15518,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 249
+        "line": 515
       },
       "name": "LambdaFunctionCodeBundler",
       "symbolId": "src/components/bundle-lambda-function-code:LambdaFunctionCodeBundler"
@@ -15436,25 +15527,28 @@
       "assembly": "@nikovirtala/projen-constructs",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Options for `LambdaFunctionCodeBundler`."
       },
       "fqn": "@nikovirtala/projen-constructs.LambdaFunctionCodeBundlerOptions",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/bundle-lambda-function-code.ts",
-        "line": 240
+        "line": 488
       },
       "name": "LambdaFunctionCodeBundlerOptions",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "example": "\".lambda.ts\"",
+            "stability": "stable",
+            "summary": "Locate files with the given extension."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 241
+            "line": 494
           },
           "name": "extension",
           "type": {
@@ -15464,12 +15558,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Project source tree (relative to project output directory)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 242
+            "line": 499
           },
           "name": "srcdir",
           "type": {
@@ -15479,12 +15574,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "- the defaults of `LambdaFunctionCodeBundleOptions`",
+            "remarks": "The `entrypoint` and `extension` given here are ignored: each bundle uses its\ndiscovered entrypoint and the `extension` of the bundler.",
+            "stability": "stable",
+            "summary": "Options for AWS Lambda Function bundling, applied to every discovered entrypoint."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/bundle-lambda-function-code.ts",
-            "line": 243
+            "line": 509
           },
           "name": "bundleOptions",
           "optional": true,
@@ -15499,7 +15597,9 @@
       "assembly": "@nikovirtala/projen-constructs",
       "base": "projen.Component",
       "docs": {
-        "stability": "stable"
+        "remarks": "The bundling happens during projen execution, not during CDK synth, enabling a \"build once, deploy many\" pattern.",
+        "stability": "stable",
+        "summary": "A projen component that generates AWS CDK Lambda Function constructs and bundles their code assets using esbuild."
       },
       "fqn": "@nikovirtala/projen-constructs.LambdaFunctionConstructGenerator",
       "initializer": {
@@ -15508,7 +15608,7 @@
         },
         "locationInModule": {
           "filename": "src/components/lambda-function-construct-generator.ts",
-          "line": 29
+          "line": 90
         },
         "parameters": [
           {
@@ -15529,7 +15629,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/components/lambda-function-construct-generator.ts",
-        "line": 18
+        "line": 79
       },
       "name": "LambdaFunctionConstructGenerator",
       "properties": [
@@ -15540,7 +15640,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 22
+            "line": 83
           },
           "name": "esbuildOptions",
           "type": {
@@ -15554,7 +15654,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 21
+            "line": 82
           },
           "name": "filePattern",
           "type": {
@@ -15568,7 +15668,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 20
+            "line": 81
           },
           "name": "outputDir",
           "type": {
@@ -15582,7 +15682,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 19
+            "line": 80
           },
           "name": "sourceDir",
           "type": {
@@ -15596,7 +15696,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 24
+            "line": 85
           },
           "name": "baseConstructClass",
           "optional": true,
@@ -15611,7 +15711,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 23
+            "line": 84
           },
           "name": "baseConstructImport",
           "optional": true,
@@ -15626,7 +15726,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 25
+            "line": 86
           },
           "name": "baseConstructPackage",
           "optional": true,
@@ -15641,25 +15741,28 @@
       "assembly": "@nikovirtala/projen-constructs",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Options for the LambdaFunctionConstructGenerator."
       },
       "fqn": "@nikovirtala/projen-constructs.LambdaFunctionConstructGeneratorOptions",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/lambda-function-construct-generator.ts",
-        "line": 7
+        "line": 10
       },
       "name": "LambdaFunctionConstructGeneratorOptions",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "true",
+            "stability": "stable",
+            "summary": "Whether to automatically add the required dependencies."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 12
+            "line": 44
           },
           "name": "addDependencies",
           "optional": true,
@@ -15670,12 +15773,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"aws_lambda.Function\"",
+            "example": "\"NodejsFunction\"",
+            "stability": "stable",
+            "summary": "Name of the construct class to extend."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 14
+            "line": 62
           },
           "name": "baseConstructClass",
           "optional": true,
@@ -15686,12 +15792,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"import { aws_lambda } from 'aws-cdk-lib';\"",
+            "example": "\"import { NodejsFunction } from 'aws-cdk-lib/aws-lambda-nodejs';\"",
+            "stability": "stable",
+            "summary": "Import statement for the base construct."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 13
+            "line": 53
           },
           "name": "baseConstructImport",
           "optional": true,
@@ -15702,12 +15811,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"aws-cdk-lib\"",
+            "example": "\"aws-cdk-lib\"",
+            "stability": "stable",
+            "summary": "Package name to add as dependency for the base construct."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 15
+            "line": 71
           },
           "name": "baseConstructPackage",
           "optional": true,
@@ -15718,12 +15830,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "{}",
+            "stability": "stable",
+            "summary": "esbuild options to customize the bundling process."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 11
+            "line": 37
           },
           "name": "esbuildOptions",
           "optional": true,
@@ -15734,12 +15848,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"*.lambda.ts\"",
+            "stability": "stable",
+            "summary": "File pattern to identify Lambda Function handlers."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 10
+            "line": 30
           },
           "name": "filePattern",
           "optional": true,
@@ -15750,12 +15866,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"src/constructs/lambda\"",
+            "stability": "stable",
+            "summary": "Output directory where Lambda Function constructs will be generated."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 9
+            "line": 23
           },
           "name": "outputDir",
           "optional": true,
@@ -15766,12 +15884,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "\"src/handlers\"",
+            "stability": "stable",
+            "summary": "Source directory where Lambda Function handlers are located."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/lambda-function-construct-generator.ts",
-            "line": 8
+            "line": 16
           },
           "name": "sourceDir",
           "optional": true,
@@ -15786,7 +15906,9 @@
       "assembly": "@nikovirtala/projen-constructs",
       "base": "projen.Component",
       "docs": {
-        "stability": "stable"
+        "remarks": "Adds LocalStack support to your project with automatic Docker/Colima setup.",
+        "stability": "stable",
+        "summary": "LocalStack component for projen projects."
       },
       "fqn": "@nikovirtala/projen-constructs.LocalStack",
       "initializer": {
@@ -15795,7 +15917,7 @@
         },
         "locationInModule": {
           "filename": "src/components/localstack.ts",
-          "line": 15
+          "line": 50
         },
         "parameters": [
           {
@@ -15816,7 +15938,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/components/localstack.ts",
-        "line": 14
+        "line": 49
       },
       "name": "LocalStack",
       "symbolId": "src/components/localstack:LocalStack"
@@ -15825,25 +15947,28 @@
       "assembly": "@nikovirtala/projen-constructs",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Options for LocalStack component."
       },
       "fqn": "@nikovirtala/projen-constructs.LocalStackOptions",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/components/localstack.ts",
-        "line": 7
+        "line": 10
       },
       "name": "LocalStackOptions",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "false",
+            "stability": "stable",
+            "summary": "Enable LocalStack debug mode."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/localstack.ts",
-            "line": 10
+            "line": 27
           },
           "name": "debug",
           "optional": true,
@@ -15854,12 +15979,16 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "- the LocalStack CLI's default image",
+            "remarks": "When set, LocalStack starts with the `localstack/localstack:<imageTag>` image, passed to\n`localstack start` through the `IMAGE_NAME` environment variable. That's the community\nimage, even if a `LOCALSTACK_AUTH_TOKEN` would otherwise select the Pro image.\n\nMust be a valid Docker tag.",
+            "see": "https://docs.localstack.cloud/aws/customization/configuration-options/",
+            "stability": "stable",
+            "summary": "LocalStack Docker image tag, e.g. `\"4.9\"` to pin a version."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/localstack.ts",
-            "line": 11
+            "line": 41
           },
           "name": "imageTag",
           "optional": true,
@@ -15870,12 +15999,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "4566",
+            "stability": "stable",
+            "summary": "LocalStack gateway port."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/localstack.ts",
-            "line": 9
+            "line": 21
           },
           "name": "port",
           "optional": true,
@@ -15886,12 +16017,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "- all services enabled",
+            "stability": "stable",
+            "summary": "LocalStack services to enable."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/components/localstack.ts",
-            "line": 8
+            "line": 15
           },
           "name": "services",
           "optional": true,
@@ -20575,7 +20708,7 @@
         },
         "locationInModule": {
           "filename": "src/components/vitest.ts",
-          "line": 317
+          "line": 344
         },
         "parameters": [
           {
@@ -20596,7 +20729,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/components/vitest.ts",
-        "line": 290
+        "line": 315
       },
       "methods": [
         {
@@ -20605,7 +20738,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 291
+            "line": 316
           },
           "name": "of",
           "parameters": [
@@ -20630,7 +20763,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 383
+            "line": 417
           },
           "name": "addExclude",
           "parameters": [
@@ -20648,7 +20781,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 378
+            "line": 412
           },
           "name": "addInclude",
           "parameters": [
@@ -20666,7 +20799,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 393
+            "line": 427
           },
           "name": "configureCoverageProvider",
           "parameters": [
@@ -20684,7 +20817,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 412
+            "line": 446
           },
           "name": "configureCoverageReporters",
           "parameters": [
@@ -20707,7 +20840,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 388
+            "line": 422
           },
           "name": "configureEnvironment",
           "parameters": [
@@ -20725,7 +20858,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 417
+            "line": 451
           },
           "name": "configureGlobals"
         },
@@ -20736,7 +20869,7 @@
           },
           "locationInModule": {
             "filename": "src/components/vitest.ts",
-            "line": 368
+            "line": 402
           },
           "name": "preSynthesize",
           "overrides": "projen.Component"
@@ -21173,6 +21306,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": {
@@ -21195,6 +21380,6 @@
       "symbolId": "src/components/vitest:VitestOptions"
     }
   },
-  "version": "0.3.78",
-  "fingerprint": "IlSKcQKlyQLH3MfXLnQLJrHFPApv8tEpciIKVND7bI0="
+  "version": "0.3.80",
+  "fingerprint": "859+Vz0Hr1V+Ho96Pw/4708GxTl+HpX3aG1KTlBTW5s="
 }