@nikovirtala/projen-constructs 0.5.1 → 0.5.3

package/docs/api/index.html

@@ -9,419 +9,156 @@
 <div class="tsd-page-title">
 <h1>@nikovirtala/projen-constructs</h1></div>
 <div class="tsd-panel tsd-typography"><h1 id="nikovirtalaprojen-constructs" class="tsd-anchor-link">@nikovirtala/projen-constructs<a href="#nikovirtalaprojen-constructs" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h1>
-<p>Projen project types with standard configuration for consistent project setup across all repositories.</p>
-<h2 id="installation" class="tsd-anchor-link">Installation<a href="#installation" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
-<pre><code class="bash"><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">add</span><span class="hl-1"> </span><span class="hl-3">-D</span><span class="hl-1"> </span><span class="hl-2">@nikovirtala/projen-constructs</span><span class="hl-1"> </span><span class="hl-2">projen</span><span class="hl-1"> </span><span class="hl-2">constructs</span>
-</code><button type="button">Copy</button></pre>
-
-<p>Requires pnpm 12 and <code>projen</code> ^0.104.23. <code>@mrgrain/cdk-esbuild</code> and <code>constructs</code> are peer
-dependencies as well.</p>
-<p>To create a project from scratch:</p>
-<pre><code class="bash"><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">dlx</span><span class="hl-1"> </span><span class="hl-2">projen</span><span class="hl-1"> </span><span class="hl-2">new</span><span class="hl-1"> </span><span class="hl-3">--from</span><span class="hl-1"> </span><span class="hl-2">@nikovirtala/projen-constructs</span><span class="hl-1"> </span><span class="hl-2">aws_cdk_construct_library</span>
-</code><button type="button">Copy</button></pre>
-
-<h2 id="features" class="tsd-anchor-link">Features<a href="#features" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
-<ul>
-<li><strong>Standard Configuration</strong>: Opinionated defaults for author, release branch, package manager, Node.js, TypeScript, and tooling</li>
-<li><strong>Automatic Project Type Discovery</strong>: Generates the <code>ProjectType</code> enum from Projen's JSII manifest (19 project types)</li>
-<li><strong>Component System</strong>: Reusable components (Vitest, TypeDoc, Mise, Homebrew, Colima, LocalStack, Lambda bundling)</li>
-<li><strong>Code Generation</strong>: <code>ProjectGenerator</code> creates project classes with standard configuration</li>
-<li><strong>ES Modules</strong>: TypeScript and CDK App projects use ES modules (JSII uses CommonJS)</li>
-<li><strong>Code Quality</strong>: Biome for formatting and linting</li>
-<li><strong>Testing</strong>: Vitest with coverage</li>
-<li><strong>Auto-merge</strong>: Enabled with auto-approve</li>
-<li><strong>VSCode</strong>: Recommended extensions and settings</li>
-<li><strong>mise</strong>: Node version management</li>
+<p>Opinionated projen project types that scaffold TypeScript, JSII and AWS CDK repositories with one shared config.</p>
+<p><a href="https://www.npmjs.com/package/@nikovirtala/projen-constructs"><img src="https://img.shields.io/npm/v/@nikovirtala/projen-constructs?label=npm" alt="npm version badge, latest release on npm"></a>
+<a href="https://github.com/nikovirtala/projen-constructs/actions/workflows/build.yml"><img src="https://img.shields.io/github/actions/workflow/status/nikovirtala/projen-constructs/build.yml?branch=main&amp;label=build" alt="build status badge from the GitHub Actions build workflow"></a>
+<a href="./LICENSE"><img src="https://img.shields.io/npm/l/@nikovirtala/projen-constructs?label=license" alt="license badge, Apache-2.0"></a>
+<a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D26.13.0-informational?label=node" alt="supported Node.js version badge, requires Node.js 26.13.0 or newer"></a>
+<a href="https://projen.io"><img src="https://img.shields.io/badge/projen-%5E0.104.23-informational?label=projen" alt="projen peer dependency version badge, requires projen 0.104.23 or newer"></a></p>
+<h2 id="why-this-exists" class="tsd-anchor-link">Why this exists<a href="#why-this-exists" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
+<p>Projen gives you code-first project configuration, but wiring up a consistent setup across many
+TypeScript, JSII and AWS CDK repositories still means repeating the same choices. This library
+packages those choices into ready-made project types and reusable components, so every repository
+you generate shares the same package manager, Node.js and TypeScript versions, testing, linting and
+release tooling.</p>
+<p>It is for anyone in the projen and AWS CDK community who maintains more than one repository and wants
+them to behave the same way without hand-copying configuration between them.</p>
+<h2 id="when-not-to-use-this" class="tsd-anchor-link">When not to use this<a href="#when-not-to-use-this" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
+<p>Reach for plain projen instead when:</p>
+<ul>
+<li>you want unopinionated projen defaults and prefer to make each tooling choice yourself</li>
+<li>your setup is not pnpm-based or cannot run Node.js 26</li>
+<li>you build in languages beyond TypeScript, JSII and AWS CDK</li>
 </ul>
-<h2 id="standard-configuration" class="tsd-anchor-link">Standard Configuration<a href="#standard-configuration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
-<ul>
-<li><strong>Author</strong>: Niko Virtala (<a href="mailto:niko.virtala@hey.com">niko.virtala@hey.com</a>)</li>
-<li><strong>Default Release Branch</strong>: main</li>
-<li><strong>Package Manager</strong>: pnpm 12.16.1</li>
-<li><strong>Node Version</strong>: 26.13.0</li>
-<li><strong>TypeScript</strong>: 6.0.3</li>
-<li><strong>CDK Version</strong>: 2.263.0 (for CDK projects)</li>
-<li><strong>JSII Version</strong>: ~6.0.3 (for JSII projects)</li>
-</ul>
-<p>The AWS CDK, Node.js and TypeScript versions live in <code>src/versions.json</code> and are refreshed by the
-<code>update-versions</code> task, which the dependency upgrade workflow runs.</p>
-<h3 id="pnpm" class="tsd-anchor-link">pnpm<a href="#pnpm" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<p>pnpm reads its settings from <code>pnpm-workspace.yaml</code>, not <code>.npmrc</code>, since pnpm 11. Generated projects
-get:</p>
+<h2 id="status-and-supported-versions" class="tsd-anchor-link">Status and supported versions<a href="#status-and-supported-versions" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
+<p>Stability: <strong>stable</strong>. This library requires <code>projen</code> ^0.104.23, pnpm 12, and Node.js &gt;= 26.13.0.
+These values are maintained in <code>src/versions.json</code> and the project configuration; the numbers quoted
+across this documentation track those sources.</p>
+<h2 id="documentation" class="tsd-anchor-link">Documentation<a href="#documentation" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <table>
 <thead>
 <tr>
-<th>Setting</th>
-<th>Value</th>
-<th>Reason</th>
+<th>Guide</th>
+<th>What it covers</th>
 </tr>
 </thead>
 <tbody>
 <tr>
-<td><code>nodeLinker</code></td>
-<td><code>hoisted</code></td>
-<td>jsii tooling resolves dependencies from a flat <code>node_modules</code></td>
+<td><a href="media/configuration.md">Configuration</a></td>
+<td>Standard defaults, pnpm settings, the TypeScript configs, native TypeScript, and how to customize any option</td>
+</tr>
+<tr>
+<td><a href="media/components.md">Components</a></td>
+<td>Reference for every component: Vitest, TypeDoc, Mise, Homebrew, Colima, LocalStack, LambdaFunctionConstructGenerator, Bundler, and ProjectGenerator</td>
 </tr>
 <tr>
-<td><code>allowBuilds</code></td>
-<td><code>esbuild: true</code></td>
-<td>esbuild links its platform binary in a postinstall script, and pnpm 11 fails an install with ignored builds</td>
+<td><a href="media/migration.md">Migration</a></td>
+<td>Moving from the deprecated standalone packages, including the name mapping and behaviour changes</td>
 </tr>
 <tr>
-<td><code>verifyDepsBeforeRun</code></td>
-<td><code>false</code></td>
-<td>projen resolves the task <code>PATH</code> with <code>$(pnpm -c exec ...)</code>, which otherwise re-enters <code>pnpm install</code> and deadlocks</td>
+<td><a href="media/development.md">Development</a></td>
+<td>Development commands and the build process diagram</td>
 </tr>
 <tr>
-<td><code>minimumReleaseAge</code></td>
-<td><code>0</code></td>
-<td>the pnpm 11 default of 1440 minutes makes pnpm write <code>minimumReleaseAgeExclude</code> entries into this generated file</td>
+<td><a href="media/index.html">API reference</a></td>
+<td>Generated TypeDoc API documentation</td>
 </tr>
 </tbody>
 </table>
-<h3 id="typescript-configuration" class="tsd-anchor-link">TypeScript configuration<a href="#typescript-configuration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<p>Projen renders three configs, and none of them should be edited directly:</p>
-<ul>
-<li><code>tsconfig.json</code> compiles <code>src</code> to <code>lib</code>. For JSII projects, jsii validates it against its <code>strict</code>
-rule set, so it only carries compiler options jsii accepts.</li>
-<li><code>test/tsconfig.json</code> extends it and is type-check only. This is the config Vitest type checking and
-the editor use, and the one <code>tsconfigDev</code> points at.</li>
-<li><code>projenrc/tsconfig.json</code> covers <code>.projenrc.ts</code>.</li>
-</ul>
-<h3 id="native-typescript" class="tsd-anchor-link">Native TypeScript<a href="#native-typescript" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<p>TypeScript and AWS CDK app projects run TypeScript with Node.js's built-in
-<a href="https://nodejs.org/api/typescript.html#type-stripping">type stripping</a> instead of <code>tsx</code> or
-<code>ts-node</code>: the default task is <code>node .projenrc.ts</code>, and the cdk.json <code>app</code> is <code>node src/main.ts</code>.
-Their <code>tsconfig.json</code> sets <code>erasableSyntaxOnly</code> and <code>verbatimModuleSyntax</code>, so <code>tsc</code> reports code
-that Node.js can't run before Node.js does.</p>
-<p>Code in these projects must therefore:</p>
-<ul>
-<li>only use syntax that can be stripped: no <code>enum</code>s (use an <code>as const</code> object), no namespaces with
-values, and no constructor parameter properties</li>
-<li>mark type-only imports with <code>type</code> (Biome's <code>useImportType</code> fixes these)</li>
-<li>import relative files with their <code>.ts</code> extension, and never import a directory</li>
-<li>use Node.js <a href="https://nodejs.org/api/packages.html#subpath-imports">subpath imports</a>
-(<code>#stacks</code> in <code>package.json</code> <code>imports</code>) instead of tsconfig <code>paths</code>, which Node.js doesn't read</li>
-<li>import packages without an <code>exports</code> map either from the package root or with an explicit file,
-e.g. <code>projen/lib/component.js</code> rather than <code>projen/lib/component</code></li>
-</ul>
-<p>Lambda handlers bundled by esbuild and tests run by Vitest aren't run by Node.js directly, but the
-same compiler options apply to them.</p>
-<p>JSII and AWS CDK construct library projects keep using <code>tsx</code>, because jsii compiles to CommonJS, and
-their <code>.projenrc.ts</code> often imports their own <code>src</code>.</p>
-<p>When you start a new project by hand, make sure <code>package.json</code> has <code>&quot;type&quot;: &quot;module&quot;</code> before the
-first <code>node .projenrc.ts</code>: <code>npm init</code> writes <code>&quot;type&quot;: &quot;commonjs&quot;</code>, which makes Node.js reject the
-<code>import</code> statements in <code>.projenrc.ts</code>.</p>
-<h2 id="customization" class="tsd-anchor-link">Customization<a href="#customization" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
-<p>Override any option by passing it to the constructor:</p>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">JsiiProject</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">project</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">JsiiProject</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">name:</span><span class="hl-1"> </span><span class="hl-2">&quot;my-project&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">repositoryUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://github.com/nikovirtala/my-project.git&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">minNodeVersion:</span><span class="hl-1"> </span><span class="hl-2">&quot;26.0.0&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">author:</span><span class="hl-1"> </span><span class="hl-2">&quot;Custom Author&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">authorAddress:</span><span class="hl-1"> </span><span class="hl-2">&quot;custom@example.com&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">mise:</span><span class="hl-1"> </span><span class="hl-3">false</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">vitest:</span><span class="hl-1"> </span><span class="hl-3">false</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">tsconfig:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">compilerOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-5">noUnusedLocals:</span><span class="hl-1"> </span><span class="hl-3">false</span><span class="hl-1">,</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-5">biomeOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">biomeConfig:</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-5">formatter:</span><span class="hl-1"> {</span><br/><span class="hl-1">        </span><span class="hl-5">lineWidth:</span><span class="hl-1"> </span><span class="hl-7">100</span><span class="hl-1">,</span><br/><span class="hl-1">      },</span><br/><span class="hl-1">    },</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">});</span>
-</code><button type="button">Copy</button></pre>
-
-<p>Every component is exposed as an enable flag (<code>mise</code>, <code>vitest</code>, ...) plus an options property
-(<code>miseOptions</code>, <code>vitestOptions</code>, ...).</p>
-<h2 id="usage" class="tsd-anchor-link">Usage<a href="#usage" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
-<h3 id="projects" class="tsd-anchor-link">Projects<a href="#projects" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<h4 id="aws-cdk-construct-library-project" class="tsd-anchor-link">AWS CDK Construct Library Project<a href="#aws-cdk-construct-library-project" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">AwsCdkConstructLibraryProject</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">project</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">AwsCdkConstructLibraryProject</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">name:</span><span class="hl-1"> </span><span class="hl-2">&quot;my-cdk-construct&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">repositoryUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://github.com/nikovirtala/my-cdk-construct.git&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">project</span><span class="hl-1">.</span><span class="hl-0">synth</span><span class="hl-1">();</span>
-</code><button type="button">Copy</button></pre>
-
-<h4 id="aws-cdk-typescript-app-project" class="tsd-anchor-link">AWS CDK TypeScript App Project<a href="#aws-cdk-typescript-app-project" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">AwsCdkTypeScriptAppProject</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">project</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">AwsCdkTypeScriptAppProject</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">name:</span><span class="hl-1"> </span><span class="hl-2">&quot;my-cdk-app&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">repository:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://github.com/nikovirtala/my-cdk-app.git&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">project</span><span class="hl-1">.</span><span class="hl-0">synth</span><span class="hl-1">();</span>
-</code><button type="button">Copy</button></pre>
-
-<h4 id="jsii-project" class="tsd-anchor-link">JSII Project<a href="#jsii-project" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">JsiiProject</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">project</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">JsiiProject</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">name:</span><span class="hl-1"> </span><span class="hl-2">&quot;my-jsii-project&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">repositoryUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://github.com/nikovirtala/my-jsii-project.git&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">project</span><span class="hl-1">.</span><span class="hl-0">synth</span><span class="hl-1">();</span>
-</code><button type="button">Copy</button></pre>
-
-<h4 id="typescript-project" class="tsd-anchor-link">TypeScript Project<a href="#typescript-project" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">TypeScriptProject</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">project</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">TypeScriptProject</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">name:</span><span class="hl-1"> </span><span class="hl-2">&quot;my-typescript-project&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">repository:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://github.com/nikovirtala/my-typescript-project.git&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">project</span><span class="hl-1">.</span><span class="hl-0">synth</span><span class="hl-1">();</span>
-</code><button type="button">Copy</button></pre>
-
-<h3 id="components" class="tsd-anchor-link">Components<a href="#components" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<p>The package includes reusable components for common development tasks:</p>
-<h4 id="vitest" class="tsd-anchor-link">Vitest<a href="#vitest" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<p><a href="https://vitest.dev">Vitest</a> testing framework component.</p>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">Vitest</span><span class="hl-1">, </span><span class="hl-5">CoverageProvider</span><span class="hl-1">, </span><span class="hl-5">CoverageReporter</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">Vitest</span><span class="hl-1">(</span><span class="hl-5">project</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">vitestVersion:</span><span class="hl-1"> </span><span class="hl-2">&quot;^5&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">config:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">coverageProvider:</span><span class="hl-1"> </span><span class="hl-5">CoverageProvider</span><span class="hl-1">.</span><span class="hl-6">V8</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">coverageReporters:</span><span class="hl-1"> [</span><span class="hl-5">CoverageReporter</span><span class="hl-1">.</span><span class="hl-6">TEXT</span><span class="hl-1">, </span><span class="hl-5">CoverageReporter</span><span class="hl-1">.</span><span class="hl-6">LCOV</span><span class="hl-1">],</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">});</span>
-</code><button type="button">Copy</button></pre>
-
-<p>Type checking runs against the project's development tsconfig (<code>test/tsconfig.json</code>) unless
-<code>config.typecheckTsconfig</code> says otherwise.</p>
-<p>For Vitest settings that <code>config</code> doesn't cover, use <code>extraTestConfig</code> (merged into <code>test</code>) and
-<code>extraConfig</code> (top-level options next to <code>test</code>):</p>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">Vitest</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">Vitest</span><span class="hl-1">(</span><span class="hl-5">project</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">extraTestConfig:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">setupFiles:</span><span class="hl-1"> [</span><span class="hl-2">&quot;test/setup.ts&quot;</span><span class="hl-1">],</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-5">extraConfig:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">resolve:</span><span class="hl-1"> { </span><span class="hl-5">alias:</span><span class="hl-1"> { </span><span class="hl-2">&quot;@&quot;</span><span class="hl-5">:</span><span class="hl-1"> </span><span class="hl-2">&quot;/src&quot;</span><span class="hl-1"> } },</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">});</span>
-</code><button type="button">Copy</button></pre>
-
-<p><code>extraTestConfig</code> is deep-merged over the generated <code>test</code> 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.</p>
-<h4 id="typedoc" class="tsd-anchor-link">TypeDoc<a href="#typedoc" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<p><a href="https://typedoc.org">TypeDoc</a> documentation generation component.</p>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">TypeDoc</span><span class="hl-1">, </span><span class="hl-5">EntryPointStrategy</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">TypeDoc</span><span class="hl-1">(</span><span class="hl-5">project</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">version:</span><span class="hl-1"> </span><span class="hl-2">&quot;^0.28&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">typeDocConfig:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">entryPointStrategy:</span><span class="hl-1"> </span><span class="hl-5">EntryPointStrategy</span><span class="hl-1">.</span><span class="hl-6">EXPAND</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">out:</span><span class="hl-1"> </span><span class="hl-2">&quot;docs/api&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">exclude:</span><span class="hl-1"> [</span><span class="hl-2">&quot;**/*.test.ts&quot;</span><span class="hl-1">],</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">});</span>
-</code><button type="button">Copy</button></pre>
-
-<h4 id="mise" class="tsd-anchor-link">Mise<a href="#mise" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<p><a href="https://mise.jdx.dev">Mise</a> dev tools/runtimes management component.</p>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">Mise</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">Mise</span><span class="hl-1">(</span><span class="hl-5">project</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">nodeVersion:</span><span class="hl-1"> </span><span class="hl-2">&quot;26.13.0&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span>
-</code><button type="button">Copy</button></pre>
-
-<h4 id="homebrew" class="tsd-anchor-link">Homebrew<a href="#homebrew" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<p><a href="https://brew.sh">Homebrew</a> package management component. Writes a <code>Brewfile</code> and adds an
-<code>install:homebrew</code> task that bootstraps Homebrew and runs <code>brew bundle</code>.</p>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">Homebrew</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">homebrew</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">Homebrew</span><span class="hl-1">(</span><span class="hl-5">project</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">packages:</span><span class="hl-1"> [</span><span class="hl-2">&quot;jq&quot;</span><span class="hl-1">, </span><span class="hl-2">&quot;yq&quot;</span><span class="hl-1">],</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">homebrew</span><span class="hl-1">.</span><span class="hl-0">addPackage</span><span class="hl-1">(</span><span class="hl-2">&quot;gh&quot;</span><span class="hl-1">);</span>
-</code><button type="button">Copy</button></pre>
-
-<p>A fully qualified formula (<code>user/repository/formula</code>) also adds a <code>tap</code> entry. Since Homebrew 6,
-formulae from non-official taps only load when trusted, so they're written with <code>trusted: true</code>.
-That trusts only the formula, not the rest of its tap.</p>
-<h4 id="colima" class="tsd-anchor-link">Colima<a href="#colima" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<p><a href="https://github.com/abiosoft/colima">Colima</a> container runtime component. Alternative for Docker.</p>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">Colima</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">Colima</span><span class="hl-1">(</span><span class="hl-5">project</span><span class="hl-1">);</span>
-</code><button type="button">Copy</button></pre>
-
-<h4 id="localstack" class="tsd-anchor-link">LocalStack<a href="#localstack" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<p><a href="https://www.localstack.cloud">LocalStack</a> AWS emulation component.</p>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">LocalStack</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">LocalStack</span><span class="hl-1">(</span><span class="hl-5">project</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">services:</span><span class="hl-1"> [</span><span class="hl-2">&quot;s3&quot;</span><span class="hl-1">, </span><span class="hl-2">&quot;lambda&quot;</span><span class="hl-1">, </span><span class="hl-2">&quot;dynamodb&quot;</span><span class="hl-1">],</span><br/><span class="hl-1">  </span><span class="hl-5">port:</span><span class="hl-1"> </span><span class="hl-7">4566</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">debug:</span><span class="hl-1"> </span><span class="hl-3">true</span><span class="hl-1">,</span><br/><span class="hl-1">});</span>
-</code><button type="button">Copy</button></pre>
-
-<h4 id="lambdafunctionconstructgenerator" class="tsd-anchor-link">LambdaFunctionConstructGenerator<a href="#lambdafunctionconstructgenerator" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<p>Generates AWS CDK Lambda Function constructs and bundles their code.</p>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">LambdaFunctionConstructGenerator</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">LambdaFunctionConstructGenerator</span><span class="hl-1">(</span><span class="hl-5">project</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">sourceDir:</span><span class="hl-1"> </span><span class="hl-2">&quot;src/handlers&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">outputDir:</span><span class="hl-1"> </span><span class="hl-2">&quot;src/constructs/lambda&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">filePattern:</span><span class="hl-1"> </span><span class="hl-2">&quot;*.lambda.ts&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">esbuildOptions:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">minify:</span><span class="hl-1"> </span><span class="hl-3">true</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">sourcemap:</span><span class="hl-1"> </span><span class="hl-3">true</span><span class="hl-1">,</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">});</span>
-</code><button type="button">Copy</button></pre>
-
-<h4 id="bundler" class="tsd-anchor-link">Bundler<a href="#bundler" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<p>Low-level bundling utilities for Lambda functions.</p>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-5">Bundler</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">LambdaFunctionCodeBundle</span><span class="hl-1">,</span><br/><span class="hl-1">} </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">bundler</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">Bundler</span><span class="hl-1">(</span><span class="hl-5">project</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">assetsDir:</span><span class="hl-1"> </span><span class="hl-2">&quot;assets&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">esbuildVersion:</span><span class="hl-1"> </span><span class="hl-2">&quot;^0.25&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">LambdaFunctionCodeBundle</span><span class="hl-1">(</span><span class="hl-5">project</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">entrypoint:</span><span class="hl-1"> </span><span class="hl-2">&quot;src/my-function.lambda.ts&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">extension:</span><span class="hl-1"> </span><span class="hl-2">&quot;.lambda.ts&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span>
-</code><button type="button">Copy</button></pre>
-
-<h4 id="projectgenerator" class="tsd-anchor-link">ProjectGenerator<a href="#projectgenerator" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4>
-<p>Generates TypeScript project classes with standard configuration.</p>
-<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">ProjectGenerator</span><span class="hl-1">, </span><span class="hl-5">ProjectType</span><span class="hl-1">, </span><span class="hl-5">Mise</span><span class="hl-1">, </span><span class="hl-5">Vitest</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">ProjectGenerator</span><span class="hl-1">(</span><span class="hl-5">project</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">name:</span><span class="hl-1"> </span><span class="hl-2">&quot;TypeScriptProject&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">projectType:</span><span class="hl-1"> </span><span class="hl-5">ProjectType</span><span class="hl-1">.</span><span class="hl-6">TYPE_SCRIPT_PROJECT</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">filePath:</span><span class="hl-1"> </span><span class="hl-2">&quot;./src/projects/typescript.generated.ts&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">components:</span><span class="hl-1"> [</span><br/><span class="hl-1">    { </span><span class="hl-5">componentClass:</span><span class="hl-1"> </span><span class="hl-5">Mise</span><span class="hl-1"> },</span><br/><span class="hl-1">    { </span><span class="hl-5">componentClass:</span><span class="hl-1"> </span><span class="hl-5">Vitest</span><span class="hl-1"> }, </span><span class="hl-8">// Auto-detects VitestOptions from JSII manifest</span><br/><span class="hl-1">  ],</span><br/><span class="hl-1">});</span>
+<p>Quick links: <a href="#quick-start">Quick start</a> · <a href="#usage">Usage</a> · <a href="#features">Features</a>.</p>
+<h2 id="quick-start" class="tsd-anchor-link">Quick start<a href="#quick-start" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
+<p>To start a new project from scratch, run <code>projen new --from</code> in an empty directory. It installs the
+library and writes a ready-to-use <code>.projenrc.ts</code> and the full project for you, with no manual setup:</p>
+<pre><code class="bash"><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">dlx</span><span class="hl-1"> </span><span class="hl-2">projen</span><span class="hl-1"> </span><span class="hl-2">new</span><span class="hl-1"> </span><span class="hl-3">--from</span><span class="hl-1"> </span><span class="hl-2">@nikovirtala/projen-constructs</span><span class="hl-1"> </span><span class="hl-2">aws_cdk_construct_library</span>
 </code><button type="button">Copy</button></pre>
 
-<p>Features:</p>
-<ul>
-<li>Automatically generates the <code>ProjectType</code> enum from Projen's JSII manifest</li>
-<li>Auto-detects component options types from JSII manifests</li>
-<li>Strips Projen's <code>@pjnew</code> annotation from <code>packageManager</code>, which <code>projen new</code> would otherwise
-render into a generated <code>.projenrc.ts</code> as the package manager that ran the command</li>
-<li>Validates paths to prevent directory traversal attacks</li>
-<li>Structured error handling with custom error classes</li>
-</ul>
-<h2 id="migrating-from-the-standalone-packages" class="tsd-anchor-link">Migrating from the standalone packages<a href="#migrating-from-the-standalone-packages" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
-<p>The components used to be published as separate packages. Those packages are deprecated and won't
-get new features or fixes. Every class, interface, enum and function they exported is exported from
-<code>@nikovirtala/projen-constructs</code> under the same name, except <code>AwsCdkApp</code> (see below).</p>
+<p><strong>Expected output</strong>: projen installs <code>@nikovirtala/projen-constructs</code> and its peers, writes a
+<code>.projenrc.ts</code> that defines the project, and synthesizes the generated files into the directory:
+<code>package.json</code>, <code>tsconfig.json</code>, <code>pnpm-workspace.yaml</code>, the GitHub Actions workflows, the Vitest and
+Biome configuration, <code>mise.toml</code>, and the source and test scaffolding for your construct library.</p>
+<p>Pass a different project type to scaffold one of the others this library provides:</p>
 <table>
 <thead>
 <tr>
-<th>Deprecated package</th>
-<th>Replacement in <code>@nikovirtala/projen-constructs</code></th>
+<th>Project type</th>
+<th><code>projen new --from</code> argument</th>
 </tr>
 </thead>
 <tbody>
 <tr>
-<td><code>@nikovirtala/projen-vitest</code></td>
-<td><code>Vitest</code>, <code>VitestOptions</code>, <code>VitestConfigOptions</code>, <code>Environment</code>, <code>Pool</code>, <code>CoverageProvider</code>, <code>CoverageReporter</code></td>
-</tr>
-<tr>
-<td><code>@nikovirtala/projen-typedoc</code></td>
-<td><code>TypeDoc</code>, <code>TypeDocOptions</code>, <code>TypeDocConfiguration</code> and its enums</td>
-</tr>
-<tr>
-<td><code>@nikovirtala/projen-homebrew</code></td>
-<td><code>Homebrew</code>, <code>HomebrewOptions</code></td>
+<td>AWS CDK construct library</td>
+<td><code>aws_cdk_construct_library</code></td>
 </tr>
 <tr>
-<td><code>@nikovirtala/projen-colima</code></td>
-<td><code>Colima</code></td>
+<td>AWS CDK TypeScript app</td>
+<td><code>aws_cdk_type_script_app</code></td>
 </tr>
 <tr>
-<td><code>@nikovirtala/projen-localstack</code></td>
-<td><code>LocalStack</code>, <code>LocalStackOptions</code></td>
+<td>JSII</td>
+<td><code>jsii_project</code></td>
 </tr>
 <tr>
-<td><code>@nikovirtala/projen-bundle-lambda-function-code</code></td>
-<td><code>Bundler</code>, <code>LambdaFunctionCodeBundle</code>, <code>LambdaFunctionCodeBundler</code> and their options</td>
-</tr>
-<tr>
-<td><code>@nikovirtala/projen-lambda-function-construct-generator</code></td>
-<td><code>LambdaFunctionConstructGenerator</code>, <code>LambdaFunctionConstructGeneratorOptions</code></td>
-</tr>
-<tr>
-<td><code>@nikovirtala/projen-aws-cdk-app</code></td>
-<td><code>AwsCdkTypeScriptAppProject</code>, <code>AwsCdkTypeScriptAppProjectOptions</code></td>
+<td>TypeScript</td>
+<td><code>type_script_project</code></td>
 </tr>
 </tbody>
 </table>
-<h3 id="steps" class="tsd-anchor-link">Steps<a href="#steps" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<ol>
-<li>
-<p>In <code>.projenrc.ts</code>, replace the old package in <code>devDeps</code> with <code>@nikovirtala/projen-constructs</code>, and
-change the imports:</p>
-<pre><code class="typescript"><span class="hl-8">// before</span><br/><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">Vitest</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-vitest&quot;</span><span class="hl-1">;</span><br/><span class="hl-8">// after</span><br/><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">Vitest</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span>
+<h3 id="adding-it-to-an-existing-project" class="tsd-anchor-link">Adding it to an existing project<a href="#adding-it-to-an-existing-project" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<p>If you already have a <code>.projenrc.ts</code>, install the library alongside its <code>projen</code> and <code>constructs</code>
+peers instead:</p>
+<pre><code class="bash"><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">add</span><span class="hl-1"> </span><span class="hl-3">-D</span><span class="hl-1"> </span><span class="hl-2">@nikovirtala/projen-constructs</span><span class="hl-1"> </span><span class="hl-2">projen</span><span class="hl-1"> </span><span class="hl-2">constructs</span>
 </code><button type="button">Copy</button></pre>
 
-</li>
-<li>
-<p>Check the peer dependencies. <code>@nikovirtala/projen-constructs</code> needs <code>projen</code> ^0.104.23, <code>constructs</code>
-^10 and <code>@mrgrain/cdk-esbuild</code> ^5. The standalone packages accepted older projen versions, so you
-may have to upgrade projen in the same change.</p>
-</li>
-<li>
-<p>Install the new package, run <code>npx projen</code> and review the changes to the generated files.</p>
-</li>
-</ol>
-<h3 id="changes-to-expect" class="tsd-anchor-link">Changes to expect<a href="#changes-to-expect" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<p>These are the differences in behaviour or generated files between the standalone packages and this
-library.</p>
-<p><strong>Vitest</strong></p>
-<ul>
-<li><code>vitest.config.ts</code> imports <code>defineConfig</code> from
-<code>@nikovirtala/projen-constructs/lib/vitest-define-config</code> instead of
-<code>@nikovirtala/projen-vitest/lib/bundled-define-config</code>. Projen rewrites the file, so there's
-nothing to change by hand.</li>
-<li>The config is rendered as JSON, so its keys are quoted. The settings are the same.</li>
-<li><code>config.typecheckTsconfig</code> defaults to the project's development tsconfig (<code>test/tsconfig.json</code>
-in current projen) instead of <code>tsconfig.dev.json</code>.</li>
-<li>JSII and construct library projects exclude <code>vitest.config.ts</code> from the published package.</li>
-<li>New: <code>extraTestConfig</code> and <code>extraConfig</code> for Vitest settings that <code>config</code> doesn't cover.</li>
-</ul>
-<p><strong>Homebrew and Colima</strong></p>
-<ul>
-<li>Packages from a tap (<code>owner/tap/formula</code>) also add a <code>tap</code> line to the <code>Brewfile</code>, and the
-<code>Brewfile</code> is sorted.</li>
-<li>The <code>install:homebrew</code>, <code>homebrew:bundle</code> and <code>colima</code> tasks run in bash. <code>homebrew:bundle</code> also
-finds a freshly installed <code>brew</code> that isn't on the <code>PATH</code> yet.</li>
-</ul>
-<p><strong>LocalStack</strong></p>
-<ul>
-<li><code>imageTag</code> is applied: LocalStack starts with <code>localstack/localstack:&lt;imageTag&gt;</code>. It used to be
-ignored.</li>
-</ul>
-<p><strong>Bundler / LambdaFunctionCodeBundler</strong></p>
-<ul>
-<li><code>LambdaFunctionCodeBundler.bundleOptions</code> applies to every discovered entrypoint. Its <code>entrypoint</code>
-used to replace them all.</li>
-</ul>
-<p><strong>LambdaFunctionConstructGenerator</strong></p>
-<ul>
-<li>The bundle task runs <code>tsx</code> with the project's development tsconfig instead of <code>tsconfig.dev.json</code>.</li>
-</ul>
-<p><strong>TypeDoc</strong>: no changes.</p>
-<h3 id="from-to" class="tsd-anchor-link">From <code>AwsCdkApp</code> to <code>AwsCdkTypeScriptAppProject</code><a href="#from-to" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<pre><code class="typescript"><span class="hl-8">// before</span><br/><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">AwsCdkApp</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-aws-cdk-app&quot;</span><span class="hl-1">;</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">project</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">AwsCdkApp</span><span class="hl-1">({ </span><span class="hl-5">name:</span><span class="hl-1"> </span><span class="hl-2">&quot;my-app&quot;</span><span class="hl-1">, </span><span class="hl-5">cdkVersion:</span><span class="hl-1"> </span><span class="hl-2">&quot;2.221.0&quot;</span><span class="hl-1"> });</span><br/><br/><span class="hl-8">// after</span><br/><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">AwsCdkTypeScriptAppProject</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">project</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">AwsCdkTypeScriptAppProject</span><span class="hl-1">({ </span><span class="hl-5">name:</span><span class="hl-1"> </span><span class="hl-2">&quot;my-app&quot;</span><span class="hl-1">, </span><span class="hl-5">cdkVersion:</span><span class="hl-1"> </span><span class="hl-2">&quot;2.221.0&quot;</span><span class="hl-1"> });</span>
+<p>Then define a project in <code>.projenrc.ts</code>:</p>
+<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">AwsCdkConstructLibraryProject</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">project</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">AwsCdkConstructLibraryProject</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">name:</span><span class="hl-1"> </span><span class="hl-2">&quot;my-cdk-construct&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">author:</span><span class="hl-1"> </span><span class="hl-2">&quot;Your Name&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">authorAddress:</span><span class="hl-1"> </span><span class="hl-2">&quot;you@example.com&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">repositoryUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://github.com/your-org/my-cdk-construct.git&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">cdkVersion:</span><span class="hl-1"> </span><span class="hl-2">&quot;2.275.0&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">project</span><span class="hl-1">.</span><span class="hl-0">synth</span><span class="hl-1">();</span>
 </code><button type="button">Copy</button></pre>
 
-<p>Both are ES module apps using pnpm, Biome, Vitest and mise. The differences:</p>
+<p>Run synthesis to write or update the generated files:</p>
+<pre><code class="bash"><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">dlx</span><span class="hl-1"> </span><span class="hl-2">projen</span>
+</code><button type="button">Copy</button></pre>
+
+<p>Re-running <code>projen</code> after you edit <code>.projenrc.ts</code> updates those files in place.</p>
+<h2 id="features" class="tsd-anchor-link">Features<a href="#features" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <ul>
-<li>
-<p><strong>Native TypeScript</strong>: <code>.projenrc.ts</code> and the app run with <code>node</code> instead of <code>tsx</code>, and the
-tsconfig sets <code>erasableSyntaxOnly</code> and <code>verbatimModuleSyntax</code> (see <a href="#native-typescript">Native TypeScript</a>).</p>
-</li>
-<li>
-<p><strong><code>nvm</code> is removed.</strong> Use mise (on by default), which pins the Node.js version in <code>mise.toml</code>.</p>
-</li>
-<li>
-<p><strong>Homebrew is on by default.</strong> The project gets a <code>Brewfile</code>, and <code>npx projen</code> runs
-<code>install:homebrew</code> (installs Homebrew if <code>brew</code> is missing) and <code>homebrew:bundle</code>. Set
-<code>homebrew: false</code> to turn it off.</p>
-</li>
-<li>
-<p><strong>cdk.json <code>app</code></strong> is <code>node src/main.ts</code> instead of <code>tsx --tsconfig tsconfig.json src/main.ts</code>.</p>
-</li>
-<li>
-<p><strong>Defaults</strong> come from this library: Node.js, TypeScript, CDK and pnpm versions (pnpm 12 instead
-of 10), Dependabot off, auto-merge on, <code>auto-approve</code> and <code>auto-merge</code> labels on dependency
-upgrade PRs, and auto-approval of PRs by <code>nikovirtala</code>. Any option you set explicitly still wins,
-so set <code>autoApproveOptions</code> if you aren't <code>nikovirtala</code>.</p>
-</li>
-<li>
-<p><strong>tsconfig</strong>: <code>noImplicitOverride</code> and <code>allowSyntheticDefaultImports</code> move from <code>tsconfig.json</code>
-to the development tsconfig (<code>test/tsconfig.json</code>).</p>
-</li>
-<li>
-<p><strong>Options removed from the interface</strong>: <code>eslint</code>, <code>jest</code>, <code>prettier</code> (and their options),
-<code>sampleCode</code> and <code>tsJestOptions</code>.</p>
-</li>
-<li>
-<p><code>vitestOptions</code> takes the <code>VitestOptions</code> of this library, and now also <code>homebrewOptions</code> and
-<code>miseOptions</code>.</p>
-</li>
+<li><strong>Standard configuration</strong>: opinionated defaults for author, release branch, package manager,
+Node.js, TypeScript, and tooling</li>
+<li><strong>Automatic project type discovery</strong>: generates the <code>ProjectType</code> enum from projen's JSII manifest
+(<!-- generated:project-type-count-start -->21<!-- generated:project-type-count-end --> project types)</li>
+<li><strong>Component system</strong>: reusable components (Vitest, TypeDoc, Mise, Homebrew, Colima, LocalStack,
+Lambda bundling)</li>
+<li><strong>Code generation</strong>: <code>ProjectGenerator</code> creates project classes with standard configuration</li>
+<li><strong>ES modules</strong>: TypeScript and CDK app projects use ES modules (JSII uses CommonJS)</li>
+<li><strong>Code quality</strong>: Biome for formatting and linting</li>
+<li><strong>Testing</strong>: Vitest with coverage</li>
+<li><strong>Auto-merge</strong>: enabled with auto-approve</li>
+<li><strong>VSCode</strong>: recommended extensions and settings</li>
+<li><strong>mise</strong>: Node version management</li>
 </ul>
-<h2 id="development" class="tsd-anchor-link">Development<a href="#development" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
-<p>This project is managed by Projen and generates itself: <code>.projenrc.ts</code> defines the project using the
-<code>JsiiProject</code> type from <code>src/</code>. Configuration changes belong in <code>.projenrc.ts</code>, never in the
-generated files.</p>
-<pre><code class="bash"><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">projen</span><span class="hl-1">           </span><span class="hl-8"># synthesize project files</span><br/><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">build</span><span class="hl-1">            </span><span class="hl-8"># synthesize, compile, test and package</span><br/><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">test</span><span class="hl-1">             </span><span class="hl-8"># biome, vitest, typedoc</span><br/><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">test:watch</span><span class="hl-1">       </span><span class="hl-8"># vitest in watch mode</span><br/><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">test:update</span><span class="hl-1">      </span><span class="hl-8"># update snapshots</span><br/><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">biome</span><span class="hl-1">            </span><span class="hl-8"># format and lint</span><br/><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">docgen</span><span class="hl-1">           </span><span class="hl-8"># regenerate API.md from the .jsii manifest</span><br/><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">update-versions</span><span class="hl-1">  </span><span class="hl-8"># refresh src/versions.json</span><br/><span class="hl-0">pnpm</span><span class="hl-1"> </span><span class="hl-2">upgrade</span><span class="hl-1">          </span><span class="hl-8"># upgrade dependencies</span>
+<h2 id="usage" class="tsd-anchor-link">Usage<a href="#usage" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
+<p>Each project type applies the standard configuration and the shared components. See
+<a href="media/configuration.md">Configuration</a> for the defaults and how to override them, and
+<a href="media/components.md">Components</a> for the component reference.</p>
+<h3 id="aws-cdk-construct-library-project" class="tsd-anchor-link">AWS CDK construct library project<a href="#aws-cdk-construct-library-project" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">AwsCdkConstructLibraryProject</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">project</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">AwsCdkConstructLibraryProject</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">name:</span><span class="hl-1"> </span><span class="hl-2">&quot;my-cdk-construct&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">author:</span><span class="hl-1"> </span><span class="hl-2">&quot;Your Name&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">authorAddress:</span><span class="hl-1"> </span><span class="hl-2">&quot;you@example.com&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">repositoryUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://github.com/nikovirtala/my-cdk-construct.git&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">cdkVersion:</span><span class="hl-1"> </span><span class="hl-2">&quot;2.275.0&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">project</span><span class="hl-1">.</span><span class="hl-0">synth</span><span class="hl-1">();</span>
 </code><button type="button">Copy</button></pre>
 
-<h3 id="build-process" class="tsd-anchor-link">Build process<a href="#build-process" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<pre><code class="mermaid">flowchart TD
-    projenrc[".projenrc.ts"]
-
-    subgraph synthesize["default (synthesize)"]
-        direction TB
-        synth["tsx .projenrc.ts"]
-        generator["ProjectGenerator"]
-        generated["src/project-type.ts<br/>src/projects/*.generated.ts<br/>src/projects/*-options.generated.ts"]
-        projenfiles["package.json, tsconfig.json,<br/>pnpm-workspace.yaml, workflows, ..."]
-        brew["install:homebrew<br/>brew bundle"]
-        definecfg["bundle-vitest-define-config<br/>esbuild → lib/vitest-define-config.js"]
-
-        synth --> generator --> generated
-        synth --> projenfiles
-        synth --> brew
-        synth --> definecfg
-    end
-
-    subgraph compile["compile"]
-        direction TB
-        jsii["jsii<br/>validates tsconfig.json against the strict rule set"]
-        lib["lib/**"]
-        manifest[".jsii manifest"]
-
-        jsii --> lib
-        jsii --> manifest
-    end
-
-    subgraph test["test"]
-        direction TB
-        biome["biome check --write"]
-        vitest["vitest run<br/>+ type checking"]
-        typedoc["typedoc → docs/api"]
-
-        biome --> vitest --> typedoc
-    end
-
-    subgraph package["package"]
-        direction TB
-        pacmak["jsii-pacmak<br/>--pack-command 'pnpm pack'"]
-        dist["dist/js/*.tgz"]
-
-        pacmak --> dist
-    end
-
-    projenrc --> synthesize
-    synthesize --> compile
-    compile --> test
-    test --> package
+<h3 id="aws-cdk-typescript-app-project" class="tsd-anchor-link">AWS CDK TypeScript app project<a href="#aws-cdk-typescript-app-project" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">AwsCdkTypeScriptAppProject</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">project</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">AwsCdkTypeScriptAppProject</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">name:</span><span class="hl-1"> </span><span class="hl-2">&quot;my-cdk-app&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">repository:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://github.com/nikovirtala/my-cdk-app.git&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">cdkVersion:</span><span class="hl-1"> </span><span class="hl-2">&quot;2.275.0&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">project</span><span class="hl-1">.</span><span class="hl-0">synth</span><span class="hl-1">();</span>
+</code><button type="button">Copy</button></pre>
 
-    manifest -. "component options FQNs<br/>read on the next synthesis" .-> generator
-    docgen["docgen<br/>jsii-docgen → API.md"]
-    manifest --> docgen
+<h3 id="jsii-project" class="tsd-anchor-link">JSII project<a href="#jsii-project" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">JsiiProject</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">project</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">JsiiProject</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">name:</span><span class="hl-1"> </span><span class="hl-2">&quot;my-jsii-project&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">author:</span><span class="hl-1"> </span><span class="hl-2">&quot;Your Name&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">authorAddress:</span><span class="hl-1"> </span><span class="hl-2">&quot;you@example.com&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">repositoryUrl:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://github.com/nikovirtala/my-jsii-project.git&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">project</span><span class="hl-1">.</span><span class="hl-0">synth</span><span class="hl-1">();</span>
+</code><button type="button">Copy</button></pre>
 
-    classDef artifact fill:#eef,stroke:#88a
-    class generated,projenfiles,lib,manifest,dist artifact
+<h3 id="typescript-project" class="tsd-anchor-link">TypeScript project<a href="#typescript-project" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3>
+<pre><code class="typescript"><span class="hl-4">import</span><span class="hl-1"> { </span><span class="hl-5">TypeScriptProject</span><span class="hl-1"> } </span><span class="hl-4">from</span><span class="hl-1"> </span><span class="hl-2">&quot;@nikovirtala/projen-constructs&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-6">project</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-0">TypeScriptProject</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">name:</span><span class="hl-1"> </span><span class="hl-2">&quot;my-typescript-project&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">repository:</span><span class="hl-1"> </span><span class="hl-2">&quot;https://github.com/nikovirtala/my-typescript-project.git&quot;</span><span class="hl-1">,</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">project</span><span class="hl-1">.</span><span class="hl-0">synth</span><span class="hl-1">();</span>
 </code><button type="button">Copy</button></pre>
 
-<p>The dashed edge is the part worth knowing about: <code>ProjectGenerator</code> reads the committed <code>.jsii</code>
-manifest to resolve component options types, so the manifest produced by <code>compile</code> feeds the <em>next</em>
-synthesis. This is why <code>.jsii</code> is committed rather than ignored. A component options type that is
-missing from the manifest is reported as a warning and its options property is left out of the
-generated interface, which is expected only while a new component is being introduced: compile once,
-then synthesize again.</p>
-<p><code>package</code> runs <code>package:js</code> on CI and <code>package-all</code> locally; both end up in <code>jsii-pacmak</code>.
-<code>docgen</code> is not part of <code>build</code> and has to be run explicitly after the manifest changes.</p>
+<h2 id="contributing" class="tsd-anchor-link">Contributing<a href="#contributing" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
+<p>See <a href="media/development.md">Development</a> for the commands and the build process. Configuration
+changes belong in <code>.projenrc.ts</code>, never in the generated files.</p>
+<h2 id="license" class="tsd-anchor-link">License<a href="#license" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
+<p>Apache-2.0. See <a href="media/LICENSE">LICENSE</a>.</p>
 </div></div>
 <div class="col-sidebar">
 <div class="page-menu">
@@ -439,47 +176,24 @@ then synthesize again.</p>
 <h3>On This Page</h3></summary>
 <div class="tsd-accordion-details"><a href="#nikovirtalaprojen-constructs"><span>@nikovirtala/projen-<wbr/>constructs</span></a>
 <ul>
-<li><a href="#installation"><span>Installation</span></a></li>
-<li><a href="#features"><span>Features</span></a></li>
-<li><a href="#standard-configuration"><span>Standard <wbr/>Configuration</span></a></li>
+<li><a href="#why-this-exists"><span>Why this exists</span></a></li>
+<li><a href="#when-not-to-use-this"><span>When not to use this</span></a></li>
+<li><a href="#status-and-supported-versions"><span>Status and supported versions</span></a></li>
+<li><a href="#documentation"><span>Documentation</span></a></li>
+<li><a href="#quick-start"><span>Quick start</span></a></li>
 <li>
 <ul>
-<li><a href="#pnpm"><span>pnpm</span></a></li>
-<li><a href="#typescript-configuration"><span>Type<wbr/>Script configuration</span></a></li>
-<li><a href="#native-typescript"><span>Native <wbr/>Type<wbr/>Script</span></a></li></ul></li>
-<li><a href="#customization"><span>Customization</span></a></li>
+<li><a href="#adding-it-to-an-existing-project"><span>Adding it to an existing project</span></a></li></ul></li>
+<li><a href="#features"><span>Features</span></a></li>
 <li><a href="#usage"><span>Usage</span></a></li>
 <li>
 <ul>
-<li><a href="#projects"><span>Projects</span></a></li>
-<li>
-<ul>
-<li><a href="#aws-cdk-construct-library-project"><span>AWS <wbr/>CDK <wbr/>Construct <wbr/>Library <wbr/>Project</span></a></li>
-<li><a href="#aws-cdk-typescript-app-project"><span>AWS <wbr/>CDK <wbr/>Type<wbr/>Script <wbr/>App <wbr/>Project</span></a></li>
-<li><a href="#jsii-project"><span>JSII <wbr/>Project</span></a></li>
-<li><a href="#typescript-project"><span>Type<wbr/>Script <wbr/>Project</span></a></li></ul></li>
-<li><a href="#components"><span>Components</span></a></li>
-<li>
-<ul>
-<li><a href="#vitest"><span>Vitest</span></a></li>
-<li><a href="#typedoc"><span>Type<wbr/>Doc</span></a></li>
-<li><a href="#mise"><span>Mise</span></a></li>
-<li><a href="#homebrew"><span>Homebrew</span></a></li>
-<li><a href="#colima"><span>Colima</span></a></li>
-<li><a href="#localstack"><span>Local<wbr/>Stack</span></a></li>
-<li><a href="#lambdafunctionconstructgenerator"><span>Lambda<wbr/>Function<wbr/>Construct<wbr/>Generator</span></a></li>
-<li><a href="#bundler"><span>Bundler</span></a></li>
-<li><a href="#projectgenerator"><span>Project<wbr/>Generator</span></a></li></ul></li></ul></li>
-<li><a href="#migrating-from-the-standalone-packages"><span>Migrating from the standalone packages</span></a></li>
-<li>
-<ul>
-<li><a href="#steps"><span>Steps</span></a></li>
-<li><a href="#changes-to-expect"><span>Changes to expect</span></a></li>
-<li><a href="#from-to"><span>From  to </span></a></li></ul></li>
-<li><a href="#development"><span>Development</span></a></li>
-<li>
-<ul>
-<li><a href="#build-process"><span>Build process</span></a></li></ul></li></ul></div></details></div>
+<li><a href="#aws-cdk-construct-library-project"><span>AWS <wbr/>CDK construct library project</span></a></li>
+<li><a href="#aws-cdk-typescript-app-project"><span>AWS <wbr/>CDK <wbr/>Type<wbr/>Script app project</span></a></li>
+<li><a href="#jsii-project"><span>JSII project</span></a></li>
+<li><a href="#typescript-project"><span>Type<wbr/>Script project</span></a></li></ul></li>
+<li><a href="#contributing"><span>Contributing</span></a></li>
+<li><a href="#license"><span>License</span></a></li></ul></div></details></div>
 <div class="site-menu">
 <nav class="tsd-navigation"><a href="modules.html">@nikovirtala/projen-constructs</a>
 <ul class="tsd-small-nested-navigation" id="tsd-nav-container">