npm - @macedon-technologies/batman - Versions diffs - 1.13.0 → 1.14.0 - Mend

@macedon-technologies/batman 1.13.0 → 1.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (37) hide show

package/.jsii +7 -5
package/API.md +961 -1062
package/lib/Api/ApiFiles.d.ts +5 -0
package/lib/Api/ApiFiles.js +15 -0
package/lib/Api/ApiFunctionFile.d.ts +4 -0
package/lib/Api/ApiFunctionFile.js +18 -0
package/lib/Api/ApiHelperFiles.d.ts +5 -0
package/lib/Api/ApiHelperFiles.js +15 -0
package/lib/Api/AppHelperFile.d.ts +4 -0
package/lib/Api/AppHelperFile.js +63 -0
package/lib/Api/AppMiddlewareFiles.d.ts +5 -0
package/lib/Api/AppMiddlewareFiles.js +19 -0
package/lib/Api/AuthMiddlewareFile.d.ts +4 -0
package/lib/Api/AuthMiddlewareFile.js +109 -0
package/lib/Api/CorsMiddlewareFile.d.ts +4 -0
package/lib/Api/CorsMiddlewareFile.js +54 -0
package/lib/Api/ErrorHandlerMiddlewareFile.d.ts +4 -0
package/lib/Api/ErrorHandlerMiddlewareFile.js +49 -0
package/lib/Api/ExpressApiRouterFile.d.ts +4 -0
package/lib/Api/ExpressApiRouterFile.js +61 -0
package/lib/Application.js +6 -6
package/lib/BatmanProject.js +2 -4
package/lib/BootcampApplication.js +4 -4
package/lib/BootcampProject.js +2 -4
package/lib/CodeOwnersFile.js +2 -4
package/lib/LocalDevAppFile.js +2 -1
package/lib/LocalDevFiles.d.ts +7 -0
package/lib/LocalDevFiles.js +13 -0
package/lib/{ApiFunctionFile.d.ts → LocalDevServerFile.d.ts} +1 -1
package/lib/LocalDevServerFile.js +59 -0
package/lib/ProductionDeployWorkflow.js +2 -4
package/lib/StagingDeployWorkflow.js +2 -4
package/lib/ViteReactProject.js +8 -1
package/lib/WorkflowAutoDiscover.js +37 -6
package/package.json +45 -39
package/pnpm-workspace.yaml +6 -0
package/lib/ApiFunctionFile.js +0 -30

package/API.md CHANGED Viewed

@@ -29,11 +29,11 @@ new BatmanProject(options: BatmanProjectOptions)
 | **Name** | **Description** |
 | --- | --- |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.toString">toString</a></code> | Returns a string representation of this construct. |
+| <code><a href="#@macedon-technologies/batman.BatmanProject.with">with</a></code> | Applies one or more mixins to this construct. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.addExcludeFromCleanup">addExcludeFromCleanup</a></code> | Exclude the matching files from pre-synth cleanup. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.addGitIgnore">addGitIgnore</a></code> | Adds a .gitignore pattern. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.addPackageIgnore">addPackageIgnore</a></code> | Adds patterns to be ignored by npm. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.addTask">addTask</a></code> | Adds a new task to this project. |
-| <code><a href="#@macedon-technologies/batman.BatmanProject.addTip">addTip</a></code> | Prints a "tip" message during synthesis. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.annotateGenerated">annotateGenerated</a></code> | Marks the provided file(s) as being generated. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.postSynthesize">postSynthesize</a></code> | Called after all components are synthesized. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.preSynthesize">preSynthesize</a></code> | Called before all components are synthesized. |
@@ -41,24 +41,19 @@ new BatmanProject(options: BatmanProjectOptions)
 | <code><a href="#@macedon-technologies/batman.BatmanProject.runTaskCommand">runTaskCommand</a></code> | Returns the shell command to execute in order to run a task. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.synth">synth</a></code> | Synthesize all project files into `outdir`. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.tryFindFile">tryFindFile</a></code> | Finds a file at the specified relative path within this project and all its subprojects. |
-| <code><a href="#@macedon-technologies/batman.BatmanProject.tryFindJsonFile">tryFindJsonFile</a></code> | Finds a json file by name. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.tryFindObjectFile">tryFindObjectFile</a></code> | Finds an object file (like JsonFile, YamlFile, etc.) by name. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.tryRemoveFile">tryRemoveFile</a></code> | Finds a file at the specified relative path within this project and removes it. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.addBins">addBins</a></code> | *No description.* |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.addBundledDeps">addBundledDeps</a></code> | Defines bundled dependencies. |
-| <code><a href="#@macedon-technologies/batman.BatmanProject.addCompileCommand">addCompileCommand</a></code> | DEPRECATED. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.addDeps">addDeps</a></code> | Defines normal dependencies. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.addDevDeps">addDevDeps</a></code> | Defines development/test dependencies. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.addFields">addFields</a></code> | Directly set fields in `package.json`. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.addKeywords">addKeywords</a></code> | Adds keywords to package.json (deduplicated). |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.addPeerDeps">addPeerDeps</a></code> | Defines peer dependencies. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.addScripts">addScripts</a></code> | Replaces the contents of multiple npm package.json scripts. |
-| <code><a href="#@macedon-technologies/batman.BatmanProject.addTestCommand">addTestCommand</a></code> | DEPRECATED. |
-| <code><a href="#@macedon-technologies/batman.BatmanProject.hasScript">hasScript</a></code> | Indicates if a script by the name name is defined. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.removeScript">removeScript</a></code> | Removes the npm script (always successful). |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.renderWorkflowSetup">renderWorkflowSetup</a></code> | Returns the set of workflow steps which should be executed to bootstrap a workflow. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.setScript">setScript</a></code> | Replaces the contents of an npm package.json script. |
-| <code><a href="#@macedon-technologies/batman.BatmanProject.addCdkDependency">addCdkDependency</a></code> | Adds an AWS CDK module dependencies. |
 ---
@@ -70,6 +65,27 @@ public toString(): string
 Returns a string representation of this construct.
+##### `with` <a name="with" id="@macedon-technologies/batman.BatmanProject.with"></a>
+```typescript
+public with(mixins: ...IMixin[]): IConstruct
+```
+Applies one or more mixins to this construct.
+Mixins are applied in order. The list of constructs is captured at the
+start of the call, so constructs added by a mixin will not be visited.
+Use multiple `with()` calls if subsequent mixins should apply to added
+constructs.
+###### `mixins`<sup>Required</sup> <a name="mixins" id="@macedon-technologies/batman.BatmanProject.with.parameter.mixins"></a>
+- *Type:* ...constructs.IMixin[]
+The mixins to apply.
+---
 ##### `addExcludeFromCleanup` <a name="addExcludeFromCleanup" id="@macedon-technologies/batman.BatmanProject.addExcludeFromCleanup"></a>
 ```typescript
@@ -148,22 +164,6 @@ Task properties.
 ---
-##### ~~`addTip`~~ <a name="addTip" id="@macedon-technologies/batman.BatmanProject.addTip"></a>
-```typescript
-public addTip(message: string): void
-```
-Prints a "tip" message during synthesis.
-###### `message`<sup>Required</sup> <a name="message" id="@macedon-technologies/batman.BatmanProject.addTip.parameter.message"></a>
-- *Type:* string
-The message.
----
 ##### `annotateGenerated` <a name="annotateGenerated" id="@macedon-technologies/batman.BatmanProject.annotateGenerated"></a>
 ```typescript
@@ -229,7 +229,7 @@ public runTaskCommand(task: Task): string
 Returns the shell command to execute in order to run a task.
 This will
-typically be `npx projen TASK`.
+typically be `pnpm projen TASK`.
 ###### `task`<sup>Required</sup> <a name="task" id="@macedon-technologies/batman.BatmanProject.runTaskCommand.parameter.task"></a>
@@ -251,8 +251,10 @@ Synthesize all project files into `outdir`.
 2. Delete all generated files
 3. Synthesize all subprojects
 4. Synthesize all components of this project
-5. Call "postSynthesize()" for all components of this project
-6. Call "this.postSynthesize()"
+5. Call "projectCreation()" for all components, only if the project is being created for the first time
+6. Call "postSynthesize()" for all components of this project
+7. Call "this.postSynthesize()"
+8. Call "postProjectCreation()" for all components, only if the project is being created for the first time
 ##### `tryFindFile` <a name="tryFindFile" id="@macedon-technologies/batman.BatmanProject.tryFindFile"></a>
@@ -273,22 +275,6 @@ from the root of _this_ project.
 ---
-##### ~~`tryFindJsonFile`~~ <a name="tryFindJsonFile" id="@macedon-technologies/batman.BatmanProject.tryFindJsonFile"></a>
-```typescript
-public tryFindJsonFile(filePath: string): JsonFile
-```
-Finds a json file by name.
-###### `filePath`<sup>Required</sup> <a name="filePath" id="@macedon-technologies/batman.BatmanProject.tryFindJsonFile.parameter.filePath"></a>
-- *Type:* string
-The file path.
----
 ##### `tryFindObjectFile` <a name="tryFindObjectFile" id="@macedon-technologies/batman.BatmanProject.tryFindObjectFile"></a>
 ```typescript
@@ -354,27 +340,13 @@ Bundled dependencies will be added as normal dependencies as well as to the
 Names modules to install.
 By default, the the dependency will
-be installed in the next `npx projen` run and the version will be recorded
-in your `package.json` file. You can upgrade manually or using `yarn
-add/upgrade`. If you wish to specify a version range use this syntax:
+be installed in the next `pnpm projen` run and the version will be recorded
+in your `package.json` file. You can upgrade manually or using `pnpm
+add/update`. If you wish to specify a version range use this syntax:
 `module@^7`.
 ---
-##### ~~`addCompileCommand`~~ <a name="addCompileCommand" id="@macedon-technologies/batman.BatmanProject.addCompileCommand"></a>
-```typescript
-public addCompileCommand(commands: ...string[]): void
-```
-DEPRECATED.
-###### `commands`<sup>Required</sup> <a name="commands" id="@macedon-technologies/batman.BatmanProject.addCompileCommand.parameter.commands"></a>
-- *Type:* ...string[]
----
 ##### `addDeps` <a name="addDeps" id="@macedon-technologies/batman.BatmanProject.addDeps"></a>
 ```typescript
@@ -390,9 +362,9 @@ Defines normal dependencies.
 Names modules to install.
 By default, the the dependency will
-be installed in the next `npx projen` run and the version will be recorded
-in your `package.json` file. You can upgrade manually or using `yarn
-add/upgrade`. If you wish to specify a version range use this syntax:
+be installed in the next `pnpm projen` run and the version will be recorded
+in your `package.json` file. You can upgrade manually or using `pnpm
+add/update`. If you wish to specify a version range use this syntax:
 `module@^7`.
 ---
@@ -412,9 +384,9 @@ Defines development/test dependencies.
 Names modules to install.
 By default, the the dependency will
-be installed in the next `npx projen` run and the version will be recorded
-in your `package.json` file. You can upgrade manually or using `yarn
-add/upgrade`. If you wish to specify a version range use this syntax:
+be installed in the next `pnpm projen` run and the version will be recorded
+in your `package.json` file. You can upgrade manually or using `pnpm
+add/update`. If you wish to specify a version range use this syntax:
 `module@^7`.
 ---
@@ -470,9 +442,9 @@ your code against the minimum version required from your consumers.
 Names modules to install.
 By default, the the dependency will
-be installed in the next `npx projen` run and the version will be recorded
-in your `package.json` file. You can upgrade manually or using `yarn
-add/upgrade`. If you wish to specify a version range use this syntax:
+be installed in the next `pnpm projen` run and the version will be recorded
+in your `package.json` file. You can upgrade manually or using `pnpm
+add/update`. If you wish to specify a version range use this syntax:
 `module@^7`.
 ---
@@ -493,36 +465,6 @@ The scripts to set.
 ---
-##### ~~`addTestCommand`~~ <a name="addTestCommand" id="@macedon-technologies/batman.BatmanProject.addTestCommand"></a>
-```typescript
-public addTestCommand(commands: ...string[]): void
-```
-DEPRECATED.
-###### `commands`<sup>Required</sup> <a name="commands" id="@macedon-technologies/batman.BatmanProject.addTestCommand.parameter.commands"></a>
-- *Type:* ...string[]
----
-##### ~~`hasScript`~~ <a name="hasScript" id="@macedon-technologies/batman.BatmanProject.hasScript"></a>
-```typescript
-public hasScript(name: string): boolean
-```
-Indicates if a script by the name name is defined.
-###### `name`<sup>Required</sup> <a name="name" id="@macedon-technologies/batman.BatmanProject.hasScript.parameter.name"></a>
-- *Type:* string
-The name of the script.
----
 ##### `removeScript` <a name="removeScript" id="@macedon-technologies/batman.BatmanProject.removeScript"></a>
 ```typescript
@@ -579,22 +521,6 @@ The command to execute.
 ---
-##### `addCdkDependency` <a name="addCdkDependency" id="@macedon-technologies/batman.BatmanProject.addCdkDependency"></a>
-```typescript
-public addCdkDependency(modules: ...string[]): void
-```
-Adds an AWS CDK module dependencies.
-###### `modules`<sup>Required</sup> <a name="modules" id="@macedon-technologies/batman.BatmanProject.addCdkDependency.parameter.modules"></a>
-- *Type:* ...string[]
-The list of modules to depend on.
----
 #### Static Functions <a name="Static Functions" id="Static Functions"></a>
 | **Name** | **Description** |
@@ -700,21 +626,16 @@ When given a project, this it the project itself.
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.defaultTask">defaultTask</a></code> | <code>projen.Task</code> | This is the "default" task, the one that executes "projen". |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.initProject">initProject</a></code> | <code>projen.InitProject</code> | The options used when this project is bootstrapped via `projen new`. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.parent">parent</a></code> | <code>projen.Project</code> | A parent project. |
-| <code><a href="#@macedon-technologies/batman.BatmanProject.property.projectType">projectType</a></code> | <code>projen.ProjectType</code> | *No description.* |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.autoApprove">autoApprove</a></code> | <code>projen.github.AutoApprove</code> | Auto approve set up for this project. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.devContainer">devContainer</a></code> | <code>projen.vscode.DevContainer</code> | Access for .devcontainer.json (used for GitHub Codespaces). |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.github">github</a></code> | <code>projen.github.GitHub</code> | Access all github components. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.gitpod">gitpod</a></code> | <code>projen.Gitpod</code> | Access for Gitpod. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.vscode">vscode</a></code> | <code>projen.vscode.VsCode</code> | Access all VSCode components. |
-| <code><a href="#@macedon-technologies/batman.BatmanProject.property.allowLibraryDependencies">allowLibraryDependencies</a></code> | <code>boolean</code> | *No description.* |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.artifactsDirectory">artifactsDirectory</a></code> | <code>string</code> | The build output directory. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.artifactsJavascriptDirectory">artifactsJavascriptDirectory</a></code> | <code>string</code> | The location of the npm tarball after build (`${artifactsDirectory}/js`). |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.bundler">bundler</a></code> | <code>projen.javascript.Bundler</code> | *No description.* |
-| <code><a href="#@macedon-technologies/batman.BatmanProject.property.entrypoint">entrypoint</a></code> | <code>string</code> | *No description.* |
-| <code><a href="#@macedon-technologies/batman.BatmanProject.property.manifest">manifest</a></code> | <code>any</code> | *No description.* |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.npmrc">npmrc</a></code> | <code>projen.javascript.NpmConfig</code> | The .npmrc file. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.package">package</a></code> | <code>projen.javascript.NodePackage</code> | API for managing the node package. |
-| <code><a href="#@macedon-technologies/batman.BatmanProject.property.packageManager">packageManager</a></code> | <code>projen.javascript.NodePackageManager</code> | The package manager to use. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.runScriptCommand">runScriptCommand</a></code> | <code>string</code> | The command to use to run scripts (e.g. `yarn run` or `npm run` depends on the package manager). |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.autoMerge">autoMerge</a></code> | <code>projen.github.AutoMerge</code> | Component that sets up mergify for merging approved pull requests. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.biome">biome</a></code> | <code>projen.javascript.Biome</code> | *No description.* |
@@ -725,11 +646,11 @@ When given a project, this it the project itself.
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.minNodeVersion">minNodeVersion</a></code> | <code>string</code> | The minimum node version required by this package to function. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.npmignore">npmignore</a></code> | <code>projen.IgnoreFile</code> | The .npmignore file. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.prettier">prettier</a></code> | <code>projen.javascript.Prettier</code> | *No description.* |
-| <code><a href="#@macedon-technologies/batman.BatmanProject.property.publisher">publisher</a></code> | <code>projen.release.Publisher</code> | Package publisher. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.release">release</a></code> | <code>projen.release.Release</code> | Release management. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.upgradeWorkflow">upgradeWorkflow</a></code> | <code>projen.javascript.UpgradeDependencies</code> | The upgrade workflow. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.docsDirectory">docsDirectory</a></code> | <code>string</code> | *No description.* |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.libdir">libdir</a></code> | <code>string</code> | The directory in which compiled .js files reside. |
+| <code><a href="#@macedon-technologies/batman.BatmanProject.property.runner">runner</a></code> | <code>projen.typescript.TypeScriptRunner</code> | The TypeScript runner used for executing TypeScript files. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.srcdir">srcdir</a></code> | <code>string</code> | The directory in which the .ts sources reside. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.testdir">testdir</a></code> | <code>string</code> | The directory in which tests reside. |
 | <code><a href="#@macedon-technologies/batman.BatmanProject.property.tsconfigDev">tsconfigDev</a></code> | <code>projen.javascript.TypescriptConfig</code> | A typescript configuration file which covers all files (sources, tests, projen). |
@@ -1013,7 +934,9 @@ the project is being ejected.
 ---
-##### `initProject`<sup>Optional</sup> <a name="initProject" id="@macedon-technologies/batman.BatmanProject.property.initProject"></a>
+##### ~~`initProject`~~<sup>Optional</sup> <a name="initProject" id="@macedon-technologies/batman.BatmanProject.property.initProject"></a>
+- *Deprecated:* use the `initProject` argument passed to `Component.projectCreation()` instead.
 ```typescript
 public readonly initProject: InitProject;
@@ -1043,16 +966,6 @@ If undefined, this is the root project.
 ---
-##### `projectType`<sup>Required</sup> <a name="projectType" id="@macedon-technologies/batman.BatmanProject.property.projectType"></a>
-```typescript
-public readonly projectType: ProjectType;
-```
-- *Type:* projen.ProjectType
----
 ##### `autoApprove`<sup>Optional</sup> <a name="autoApprove" id="@macedon-technologies/batman.BatmanProject.property.autoApprove"></a>
 ```typescript
@@ -1121,18 +1034,6 @@ This will be `undefined` for subprojects.
 ---
-##### ~~`allowLibraryDependencies`~~<sup>Required</sup> <a name="allowLibraryDependencies" id="@macedon-technologies/batman.BatmanProject.property.allowLibraryDependencies"></a>
-- *Deprecated:* use `package.allowLibraryDependencies`
-```typescript
-public readonly allowLibraryDependencies: boolean;
-```
-- *Type:* boolean
----
 ##### `artifactsDirectory`<sup>Required</sup> <a name="artifactsDirectory" id="@macedon-technologies/batman.BatmanProject.property.artifactsDirectory"></a>
 ```typescript
@@ -1171,30 +1072,6 @@ public readonly bundler: Bundler;
 ---
-##### ~~`entrypoint`~~<sup>Required</sup> <a name="entrypoint" id="@macedon-technologies/batman.BatmanProject.property.entrypoint"></a>
-- *Deprecated:* use `package.entrypoint`
-```typescript
-public readonly entrypoint: string;
-```
-- *Type:* string
----
-##### ~~`manifest`~~<sup>Required</sup> <a name="manifest" id="@macedon-technologies/batman.BatmanProject.property.manifest"></a>
-- *Deprecated:* use `package.addField(x, y)`
-```typescript
-public readonly manifest: any;
-```
-- *Type:* any
----
 ##### `npmrc`<sup>Required</sup> <a name="npmrc" id="@macedon-technologies/batman.BatmanProject.property.npmrc"></a>
 ```typescript
@@ -1219,20 +1096,6 @@ API for managing the node package.
 ---
-##### ~~`packageManager`~~<sup>Required</sup> <a name="packageManager" id="@macedon-technologies/batman.BatmanProject.property.packageManager"></a>
-- *Deprecated:* use `package.packageManager`
-```typescript
-public readonly packageManager: NodePackageManager;
-```
-- *Type:* projen.javascript.NodePackageManager
-The package manager to use.
----
 ##### `runScriptCommand`<sup>Required</sup> <a name="runScriptCommand" id="@macedon-technologies/batman.BatmanProject.property.runScriptCommand"></a>
 ```typescript
@@ -1355,23 +1218,6 @@ public readonly prettier: Prettier;
 ---
-##### ~~`publisher`~~<sup>Optional</sup> <a name="publisher" id="@macedon-technologies/batman.BatmanProject.property.publisher"></a>
-- *Deprecated:* use `release.publisher`.
-```typescript
-public readonly publisher: Publisher;
-```
-- *Type:* projen.release.Publisher
-Package publisher.
-This will be `undefined` if the project does not have a
-release workflow.
----
 ##### `release`<sup>Optional</sup> <a name="release" id="@macedon-technologies/batman.BatmanProject.property.release"></a>
 ```typescript
@@ -1418,6 +1264,18 @@ The directory in which compiled .js files reside.
 ---
+##### `runner`<sup>Required</sup> <a name="runner" id="@macedon-technologies/batman.BatmanProject.property.runner"></a>
+```typescript
+public readonly runner: TypeScriptRunner;
+```
+- *Type:* projen.typescript.TypeScriptRunner
+The TypeScript runner used for executing TypeScript files.
+---
 ##### `srcdir`<sup>Required</sup> <a name="srcdir" id="@macedon-technologies/batman.BatmanProject.property.srcdir"></a>
 ```typescript
@@ -1625,11 +1483,11 @@ new BootcampProject(options: BootcampProjectOptions)
 | **Name** | **Description** |
 | --- | --- |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.toString">toString</a></code> | Returns a string representation of this construct. |
+| <code><a href="#@macedon-technologies/batman.BootcampProject.with">with</a></code> | Applies one or more mixins to this construct. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.addExcludeFromCleanup">addExcludeFromCleanup</a></code> | Exclude the matching files from pre-synth cleanup. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.addGitIgnore">addGitIgnore</a></code> | Adds a .gitignore pattern. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.addPackageIgnore">addPackageIgnore</a></code> | Adds patterns to be ignored by npm. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.addTask">addTask</a></code> | Adds a new task to this project. |
-| <code><a href="#@macedon-technologies/batman.BootcampProject.addTip">addTip</a></code> | Prints a "tip" message during synthesis. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.annotateGenerated">annotateGenerated</a></code> | Marks the provided file(s) as being generated. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.postSynthesize">postSynthesize</a></code> | Called after all components are synthesized. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.preSynthesize">preSynthesize</a></code> | Called before all components are synthesized. |
@@ -1637,24 +1495,19 @@ new BootcampProject(options: BootcampProjectOptions)
 | <code><a href="#@macedon-technologies/batman.BootcampProject.runTaskCommand">runTaskCommand</a></code> | Returns the shell command to execute in order to run a task. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.synth">synth</a></code> | Synthesize all project files into `outdir`. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.tryFindFile">tryFindFile</a></code> | Finds a file at the specified relative path within this project and all its subprojects. |
-| <code><a href="#@macedon-technologies/batman.BootcampProject.tryFindJsonFile">tryFindJsonFile</a></code> | Finds a json file by name. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.tryFindObjectFile">tryFindObjectFile</a></code> | Finds an object file (like JsonFile, YamlFile, etc.) by name. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.tryRemoveFile">tryRemoveFile</a></code> | Finds a file at the specified relative path within this project and removes it. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.addBins">addBins</a></code> | *No description.* |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.addBundledDeps">addBundledDeps</a></code> | Defines bundled dependencies. |
-| <code><a href="#@macedon-technologies/batman.BootcampProject.addCompileCommand">addCompileCommand</a></code> | DEPRECATED. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.addDeps">addDeps</a></code> | Defines normal dependencies. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.addDevDeps">addDevDeps</a></code> | Defines development/test dependencies. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.addFields">addFields</a></code> | Directly set fields in `package.json`. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.addKeywords">addKeywords</a></code> | Adds keywords to package.json (deduplicated). |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.addPeerDeps">addPeerDeps</a></code> | Defines peer dependencies. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.addScripts">addScripts</a></code> | Replaces the contents of multiple npm package.json scripts. |
-| <code><a href="#@macedon-technologies/batman.BootcampProject.addTestCommand">addTestCommand</a></code> | DEPRECATED. |
-| <code><a href="#@macedon-technologies/batman.BootcampProject.hasScript">hasScript</a></code> | Indicates if a script by the name name is defined. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.removeScript">removeScript</a></code> | Removes the npm script (always successful). |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.renderWorkflowSetup">renderWorkflowSetup</a></code> | Returns the set of workflow steps which should be executed to bootstrap a workflow. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.setScript">setScript</a></code> | Replaces the contents of an npm package.json script. |
-| <code><a href="#@macedon-technologies/batman.BootcampProject.addCdkDependency">addCdkDependency</a></code> | Adds an AWS CDK module dependencies. |
 ---
@@ -1666,6 +1519,27 @@ public toString(): string
 Returns a string representation of this construct.
+##### `with` <a name="with" id="@macedon-technologies/batman.BootcampProject.with"></a>
+```typescript
+public with(mixins: ...IMixin[]): IConstruct
+```
+Applies one or more mixins to this construct.
+Mixins are applied in order. The list of constructs is captured at the
+start of the call, so constructs added by a mixin will not be visited.
+Use multiple `with()` calls if subsequent mixins should apply to added
+constructs.
+###### `mixins`<sup>Required</sup> <a name="mixins" id="@macedon-technologies/batman.BootcampProject.with.parameter.mixins"></a>
+- *Type:* ...constructs.IMixin[]
+The mixins to apply.
+---
 ##### `addExcludeFromCleanup` <a name="addExcludeFromCleanup" id="@macedon-technologies/batman.BootcampProject.addExcludeFromCleanup"></a>
 ```typescript
@@ -1744,22 +1618,6 @@ Task properties.
 ---
-##### ~~`addTip`~~ <a name="addTip" id="@macedon-technologies/batman.BootcampProject.addTip"></a>
-```typescript
-public addTip(message: string): void
-```
-Prints a "tip" message during synthesis.
-###### `message`<sup>Required</sup> <a name="message" id="@macedon-technologies/batman.BootcampProject.addTip.parameter.message"></a>
-- *Type:* string
-The message.
----
 ##### `annotateGenerated` <a name="annotateGenerated" id="@macedon-technologies/batman.BootcampProject.annotateGenerated"></a>
 ```typescript
@@ -1825,7 +1683,7 @@ public runTaskCommand(task: Task): string
 Returns the shell command to execute in order to run a task.
 This will
-typically be `npx projen TASK`.
+typically be `pnpm projen TASK`.
 ###### `task`<sup>Required</sup> <a name="task" id="@macedon-technologies/batman.BootcampProject.runTaskCommand.parameter.task"></a>
@@ -1847,8 +1705,10 @@ Synthesize all project files into `outdir`.
 2. Delete all generated files
 3. Synthesize all subprojects
 4. Synthesize all components of this project
-5. Call "postSynthesize()" for all components of this project
-6. Call "this.postSynthesize()"
+5. Call "projectCreation()" for all components, only if the project is being created for the first time
+6. Call "postSynthesize()" for all components of this project
+7. Call "this.postSynthesize()"
+8. Call "postProjectCreation()" for all components, only if the project is being created for the first time
 ##### `tryFindFile` <a name="tryFindFile" id="@macedon-technologies/batman.BootcampProject.tryFindFile"></a>
@@ -1869,22 +1729,6 @@ from the root of _this_ project.
 ---
-##### ~~`tryFindJsonFile`~~ <a name="tryFindJsonFile" id="@macedon-technologies/batman.BootcampProject.tryFindJsonFile"></a>
-```typescript
-public tryFindJsonFile(filePath: string): JsonFile
-```
-Finds a json file by name.
-###### `filePath`<sup>Required</sup> <a name="filePath" id="@macedon-technologies/batman.BootcampProject.tryFindJsonFile.parameter.filePath"></a>
-- *Type:* string
-The file path.
----
 ##### `tryFindObjectFile` <a name="tryFindObjectFile" id="@macedon-technologies/batman.BootcampProject.tryFindObjectFile"></a>
 ```typescript
@@ -1950,27 +1794,13 @@ Bundled dependencies will be added as normal dependencies as well as to the
 Names modules to install.
 By default, the the dependency will
-be installed in the next `npx projen` run and the version will be recorded
-in your `package.json` file. You can upgrade manually or using `yarn
-add/upgrade`. If you wish to specify a version range use this syntax:
+be installed in the next `pnpm projen` run and the version will be recorded
+in your `package.json` file. You can upgrade manually or using `pnpm
+add/update`. If you wish to specify a version range use this syntax:
 `module@^7`.
 ---
-##### ~~`addCompileCommand`~~ <a name="addCompileCommand" id="@macedon-technologies/batman.BootcampProject.addCompileCommand"></a>
-```typescript
-public addCompileCommand(commands: ...string[]): void
-```
-DEPRECATED.
-###### `commands`<sup>Required</sup> <a name="commands" id="@macedon-technologies/batman.BootcampProject.addCompileCommand.parameter.commands"></a>
-- *Type:* ...string[]
----
 ##### `addDeps` <a name="addDeps" id="@macedon-technologies/batman.BootcampProject.addDeps"></a>
 ```typescript
@@ -1986,9 +1816,9 @@ Defines normal dependencies.
 Names modules to install.
 By default, the the dependency will
-be installed in the next `npx projen` run and the version will be recorded
-in your `package.json` file. You can upgrade manually or using `yarn
-add/upgrade`. If you wish to specify a version range use this syntax:
+be installed in the next `pnpm projen` run and the version will be recorded
+in your `package.json` file. You can upgrade manually or using `pnpm
+add/update`. If you wish to specify a version range use this syntax:
 `module@^7`.
 ---
@@ -2008,9 +1838,9 @@ Defines development/test dependencies.
 Names modules to install.
 By default, the the dependency will
-be installed in the next `npx projen` run and the version will be recorded
-in your `package.json` file. You can upgrade manually or using `yarn
-add/upgrade`. If you wish to specify a version range use this syntax:
+be installed in the next `pnpm projen` run and the version will be recorded
+in your `package.json` file. You can upgrade manually or using `pnpm
+add/update`. If you wish to specify a version range use this syntax:
 `module@^7`.
 ---
@@ -2066,9 +1896,9 @@ your code against the minimum version required from your consumers.
 Names modules to install.
 By default, the the dependency will
-be installed in the next `npx projen` run and the version will be recorded
-in your `package.json` file. You can upgrade manually or using `yarn
-add/upgrade`. If you wish to specify a version range use this syntax:
+be installed in the next `pnpm projen` run and the version will be recorded
+in your `package.json` file. You can upgrade manually or using `pnpm
+add/update`. If you wish to specify a version range use this syntax:
 `module@^7`.
 ---
@@ -2089,36 +1919,6 @@ The scripts to set.
 ---
-##### ~~`addTestCommand`~~ <a name="addTestCommand" id="@macedon-technologies/batman.BootcampProject.addTestCommand"></a>
-```typescript
-public addTestCommand(commands: ...string[]): void
-```
-DEPRECATED.
-###### `commands`<sup>Required</sup> <a name="commands" id="@macedon-technologies/batman.BootcampProject.addTestCommand.parameter.commands"></a>
-- *Type:* ...string[]
----
-##### ~~`hasScript`~~ <a name="hasScript" id="@macedon-technologies/batman.BootcampProject.hasScript"></a>
-```typescript
-public hasScript(name: string): boolean
-```
-Indicates if a script by the name name is defined.
-###### `name`<sup>Required</sup> <a name="name" id="@macedon-technologies/batman.BootcampProject.hasScript.parameter.name"></a>
-- *Type:* string
-The name of the script.
----
 ##### `removeScript` <a name="removeScript" id="@macedon-technologies/batman.BootcampProject.removeScript"></a>
 ```typescript
@@ -2175,22 +1975,6 @@ The command to execute.
 ---
-##### `addCdkDependency` <a name="addCdkDependency" id="@macedon-technologies/batman.BootcampProject.addCdkDependency"></a>
-```typescript
-public addCdkDependency(modules: ...string[]): void
-```
-Adds an AWS CDK module dependencies.
-###### `modules`<sup>Required</sup> <a name="modules" id="@macedon-technologies/batman.BootcampProject.addCdkDependency.parameter.modules"></a>
-- *Type:* ...string[]
-The list of modules to depend on.
----
 #### Static Functions <a name="Static Functions" id="Static Functions"></a>
 | **Name** | **Description** |
@@ -2296,21 +2080,16 @@ When given a project, this it the project itself.
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.defaultTask">defaultTask</a></code> | <code>projen.Task</code> | This is the "default" task, the one that executes "projen". |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.initProject">initProject</a></code> | <code>projen.InitProject</code> | The options used when this project is bootstrapped via `projen new`. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.parent">parent</a></code> | <code>projen.Project</code> | A parent project. |
-| <code><a href="#@macedon-technologies/batman.BootcampProject.property.projectType">projectType</a></code> | <code>projen.ProjectType</code> | *No description.* |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.autoApprove">autoApprove</a></code> | <code>projen.github.AutoApprove</code> | Auto approve set up for this project. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.devContainer">devContainer</a></code> | <code>projen.vscode.DevContainer</code> | Access for .devcontainer.json (used for GitHub Codespaces). |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.github">github</a></code> | <code>projen.github.GitHub</code> | Access all github components. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.gitpod">gitpod</a></code> | <code>projen.Gitpod</code> | Access for Gitpod. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.vscode">vscode</a></code> | <code>projen.vscode.VsCode</code> | Access all VSCode components. |
-| <code><a href="#@macedon-technologies/batman.BootcampProject.property.allowLibraryDependencies">allowLibraryDependencies</a></code> | <code>boolean</code> | *No description.* |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.artifactsDirectory">artifactsDirectory</a></code> | <code>string</code> | The build output directory. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.artifactsJavascriptDirectory">artifactsJavascriptDirectory</a></code> | <code>string</code> | The location of the npm tarball after build (`${artifactsDirectory}/js`). |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.bundler">bundler</a></code> | <code>projen.javascript.Bundler</code> | *No description.* |
-| <code><a href="#@macedon-technologies/batman.BootcampProject.property.entrypoint">entrypoint</a></code> | <code>string</code> | *No description.* |
-| <code><a href="#@macedon-technologies/batman.BootcampProject.property.manifest">manifest</a></code> | <code>any</code> | *No description.* |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.npmrc">npmrc</a></code> | <code>projen.javascript.NpmConfig</code> | The .npmrc file. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.package">package</a></code> | <code>projen.javascript.NodePackage</code> | API for managing the node package. |
-| <code><a href="#@macedon-technologies/batman.BootcampProject.property.packageManager">packageManager</a></code> | <code>projen.javascript.NodePackageManager</code> | The package manager to use. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.runScriptCommand">runScriptCommand</a></code> | <code>string</code> | The command to use to run scripts (e.g. `yarn run` or `npm run` depends on the package manager). |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.autoMerge">autoMerge</a></code> | <code>projen.github.AutoMerge</code> | Component that sets up mergify for merging approved pull requests. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.biome">biome</a></code> | <code>projen.javascript.Biome</code> | *No description.* |
@@ -2321,11 +2100,11 @@ When given a project, this it the project itself.
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.minNodeVersion">minNodeVersion</a></code> | <code>string</code> | The minimum node version required by this package to function. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.npmignore">npmignore</a></code> | <code>projen.IgnoreFile</code> | The .npmignore file. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.prettier">prettier</a></code> | <code>projen.javascript.Prettier</code> | *No description.* |
-| <code><a href="#@macedon-technologies/batman.BootcampProject.property.publisher">publisher</a></code> | <code>projen.release.Publisher</code> | Package publisher. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.release">release</a></code> | <code>projen.release.Release</code> | Release management. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.upgradeWorkflow">upgradeWorkflow</a></code> | <code>projen.javascript.UpgradeDependencies</code> | The upgrade workflow. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.docsDirectory">docsDirectory</a></code> | <code>string</code> | *No description.* |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.libdir">libdir</a></code> | <code>string</code> | The directory in which compiled .js files reside. |
+| <code><a href="#@macedon-technologies/batman.BootcampProject.property.runner">runner</a></code> | <code>projen.typescript.TypeScriptRunner</code> | The TypeScript runner used for executing TypeScript files. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.srcdir">srcdir</a></code> | <code>string</code> | The directory in which the .ts sources reside. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.testdir">testdir</a></code> | <code>string</code> | The directory in which tests reside. |
 | <code><a href="#@macedon-technologies/batman.BootcampProject.property.tsconfigDev">tsconfigDev</a></code> | <code>projen.javascript.TypescriptConfig</code> | A typescript configuration file which covers all files (sources, tests, projen). |
@@ -2609,7 +2388,9 @@ the project is being ejected.
 ---
-##### `initProject`<sup>Optional</sup> <a name="initProject" id="@macedon-technologies/batman.BootcampProject.property.initProject"></a>
+##### ~~`initProject`~~<sup>Optional</sup> <a name="initProject" id="@macedon-technologies/batman.BootcampProject.property.initProject"></a>
+- *Deprecated:* use the `initProject` argument passed to `Component.projectCreation()` instead.
 ```typescript
 public readonly initProject: InitProject;
@@ -2639,16 +2420,6 @@ If undefined, this is the root project.
 ---
-##### `projectType`<sup>Required</sup> <a name="projectType" id="@macedon-technologies/batman.BootcampProject.property.projectType"></a>
-```typescript
-public readonly projectType: ProjectType;
-```
-- *Type:* projen.ProjectType
----
 ##### `autoApprove`<sup>Optional</sup> <a name="autoApprove" id="@macedon-technologies/batman.BootcampProject.property.autoApprove"></a>
 ```typescript
@@ -2717,18 +2488,6 @@ This will be `undefined` for subprojects.
 ---
-##### ~~`allowLibraryDependencies`~~<sup>Required</sup> <a name="allowLibraryDependencies" id="@macedon-technologies/batman.BootcampProject.property.allowLibraryDependencies"></a>
-- *Deprecated:* use `package.allowLibraryDependencies`
-```typescript
-public readonly allowLibraryDependencies: boolean;
-```
-- *Type:* boolean
----
 ##### `artifactsDirectory`<sup>Required</sup> <a name="artifactsDirectory" id="@macedon-technologies/batman.BootcampProject.property.artifactsDirectory"></a>
 ```typescript
@@ -2767,69 +2526,31 @@ public readonly bundler: Bundler;
 ---
-##### ~~`entrypoint`~~<sup>Required</sup> <a name="entrypoint" id="@macedon-technologies/batman.BootcampProject.property.entrypoint"></a>
-- *Deprecated:* use `package.entrypoint`
+##### `npmrc`<sup>Required</sup> <a name="npmrc" id="@macedon-technologies/batman.BootcampProject.property.npmrc"></a>
 ```typescript
-public readonly entrypoint: string;
+public readonly npmrc: NpmConfig;
 ```
-- *Type:* string
+- *Type:* projen.javascript.NpmConfig
----
+The .npmrc file.
-##### ~~`manifest`~~<sup>Required</sup> <a name="manifest" id="@macedon-technologies/batman.BootcampProject.property.manifest"></a>
+---
-- *Deprecated:* use `package.addField(x, y)`
+##### `package`<sup>Required</sup> <a name="package" id="@macedon-technologies/batman.BootcampProject.property.package"></a>
 ```typescript
-public readonly manifest: any;
+public readonly package: NodePackage;
 ```
-- *Type:* any
+- *Type:* projen.javascript.NodePackage
+API for managing the node package.
 ---
-##### `npmrc`<sup>Required</sup> <a name="npmrc" id="@macedon-technologies/batman.BootcampProject.property.npmrc"></a>
-```typescript
-public readonly npmrc: NpmConfig;
-```
-- *Type:* projen.javascript.NpmConfig
-The .npmrc file.
----
-##### `package`<sup>Required</sup> <a name="package" id="@macedon-technologies/batman.BootcampProject.property.package"></a>
-```typescript
-public readonly package: NodePackage;
-```
-- *Type:* projen.javascript.NodePackage
-API for managing the node package.
----
-##### ~~`packageManager`~~<sup>Required</sup> <a name="packageManager" id="@macedon-technologies/batman.BootcampProject.property.packageManager"></a>
-- *Deprecated:* use `package.packageManager`
-```typescript
-public readonly packageManager: NodePackageManager;
-```
-- *Type:* projen.javascript.NodePackageManager
-The package manager to use.
----
-##### `runScriptCommand`<sup>Required</sup> <a name="runScriptCommand" id="@macedon-technologies/batman.BootcampProject.property.runScriptCommand"></a>
+##### `runScriptCommand`<sup>Required</sup> <a name="runScriptCommand" id="@macedon-technologies/batman.BootcampProject.property.runScriptCommand"></a>
 ```typescript
 public readonly runScriptCommand: string;
@@ -2951,23 +2672,6 @@ public readonly prettier: Prettier;
 ---
-##### ~~`publisher`~~<sup>Optional</sup> <a name="publisher" id="@macedon-technologies/batman.BootcampProject.property.publisher"></a>
-- *Deprecated:* use `release.publisher`.
-```typescript
-public readonly publisher: Publisher;
-```
-- *Type:* projen.release.Publisher
-Package publisher.
-This will be `undefined` if the project does not have a
-release workflow.
----
 ##### `release`<sup>Optional</sup> <a name="release" id="@macedon-technologies/batman.BootcampProject.property.release"></a>
 ```typescript
@@ -3014,6 +2718,18 @@ The directory in which compiled .js files reside.
 ---
+##### `runner`<sup>Required</sup> <a name="runner" id="@macedon-technologies/batman.BootcampProject.property.runner"></a>
+```typescript
+public readonly runner: TypeScriptRunner;
+```
+- *Type:* projen.typescript.TypeScriptRunner
+The TypeScript runner used for executing TypeScript files.
+---
 ##### `srcdir`<sup>Required</sup> <a name="srcdir" id="@macedon-technologies/batman.BootcampProject.property.srcdir"></a>
 ```typescript
@@ -3228,9 +2944,13 @@ new CodeOwnersFile(project: AwsCdkTypeScriptApp, options?: CodeOwnersFileOptions
 | **Name** | **Description** |
 | --- | --- |
 | <code><a href="#@macedon-technologies/batman.CodeOwnersFile.toString">toString</a></code> | Returns a string representation of this construct. |
+| <code><a href="#@macedon-technologies/batman.CodeOwnersFile.with">with</a></code> | Applies one or more mixins to this construct. |
+| <code><a href="#@macedon-technologies/batman.CodeOwnersFile.postProjectCreation">postProjectCreation</a></code> | Called once, right after `postSynthesize()`, only when the project is created for the first time. |
 | <code><a href="#@macedon-technologies/batman.CodeOwnersFile.postSynthesize">postSynthesize</a></code> | Called after synthesis. |
 | <code><a href="#@macedon-technologies/batman.CodeOwnersFile.preSynthesize">preSynthesize</a></code> | Called before synthesis. |
+| <code><a href="#@macedon-technologies/batman.CodeOwnersFile.projectCreation">projectCreation</a></code> | Called once, right after `synthesize()`, only when the project is created for the first time. |
 | <code><a href="#@macedon-technologies/batman.CodeOwnersFile.synthesize">synthesize</a></code> | Writes the file to the project's output directory. |
+| <code><a href="#@macedon-technologies/batman.CodeOwnersFile.diff">diff</a></code> | Returns a unified diff of the old and new file contents with context lines and hunk headers. |
 | <code><a href="#@macedon-technologies/batman.CodeOwnersFile.addLine">addLine</a></code> | Adds a line to the text file. |
 ---
@@ -3243,6 +2963,48 @@ public toString(): string
 Returns a string representation of this construct.
+##### `with` <a name="with" id="@macedon-technologies/batman.CodeOwnersFile.with"></a>
+```typescript
+public with(mixins: ...IMixin[]): IConstruct
+```
+Applies one or more mixins to this construct.
+Mixins are applied in order. The list of constructs is captured at the
+start of the call, so constructs added by a mixin will not be visited.
+Use multiple `with()` calls if subsequent mixins should apply to added
+constructs.
+###### `mixins`<sup>Required</sup> <a name="mixins" id="@macedon-technologies/batman.CodeOwnersFile.with.parameter.mixins"></a>
+- *Type:* ...constructs.IMixin[]
+The mixins to apply.
+---
+##### `postProjectCreation` <a name="postProjectCreation" id="@macedon-technologies/batman.CodeOwnersFile.postProjectCreation"></a>
+```typescript
+public postProjectCreation(initProject: InitProject): void
+```
+Called once, right after `postSynthesize()`, only when the project is created for the first time.
+It does not run on later `projen` invocations. It only fires for `projen new` (or `Projects.createProject`).
+It is also skipped when post-synthesis steps are disabled, e.g. `--no-post` or `PROJEN_DISABLE_POST`.
+Use it for one-off setup that can be turned off by the user, like running a task to give the user immediate
+feedback on their new project. Order across components is not guaranteed.
+###### `initProject`<sup>Required</sup> <a name="initProject" id="@macedon-technologies/batman.CodeOwnersFile.postProjectCreation.parameter.initProject"></a>
+- *Type:* projen.InitProject
+Details about how the project was created, e.g. its type and the original CLI args.
+---
 ##### `postSynthesize` <a name="postSynthesize" id="@macedon-technologies/batman.CodeOwnersFile.postSynthesize"></a>
 ```typescript
@@ -3261,6 +3023,25 @@ public preSynthesize(): void
 Called before synthesis.
+##### `projectCreation` <a name="projectCreation" id="@macedon-technologies/batman.CodeOwnersFile.projectCreation"></a>
+```typescript
+public projectCreation(initProject: InitProject): void
+```
+Called once, right after `synthesize()`, only when the project is created for the first time.
+It does not run on later `projen` invocations. It only fires for `projen new` (or `Projects.createProject`).
+Use it for deterministic, one-off file generation. Order across components is not guaranteed.
+###### `initProject`<sup>Required</sup> <a name="initProject" id="@macedon-technologies/batman.CodeOwnersFile.projectCreation.parameter.initProject"></a>
+- *Type:* projen.InitProject
+Details about how the project was created, e.g. its type and the original CLI args.
+---
 ##### `synthesize` <a name="synthesize" id="@macedon-technologies/batman.CodeOwnersFile.synthesize"></a>
 ```typescript
@@ -3269,6 +3050,35 @@ public synthesize(): void
 Writes the file to the project's output directory.
+##### `diff` <a name="diff" id="@macedon-technologies/batman.CodeOwnersFile.diff"></a>
+```typescript
+public diff(colorize?: boolean, contextLines?: number): string[]
+```
+Returns a unified diff of the old and new file contents with context lines and hunk headers.
+Only available after synthesis.
+This is an expensive operation and should only be used on non time-critical
+code paths, like debug output.
+###### `colorize`<sup>Optional</sup> <a name="colorize" id="@macedon-technologies/batman.CodeOwnersFile.diff.parameter.colorize"></a>
+- *Type:* boolean
+Whether to colorize the diff output.
+---
+###### `contextLines`<sup>Optional</sup> <a name="contextLines" id="@macedon-technologies/batman.CodeOwnersFile.diff.parameter.contextLines"></a>
+- *Type:* number
+Number of context lines around changes.
+---
 ##### `addLine` <a name="addLine" id="@macedon-technologies/batman.CodeOwnersFile.addLine"></a>
 ```typescript
@@ -3349,6 +3159,7 @@ Test whether the given construct is a component.
 | <code><a href="#@macedon-technologies/batman.CodeOwnersFile.property.node">node</a></code> | <code>constructs.Node</code> | The tree node. |
 | <code><a href="#@macedon-technologies/batman.CodeOwnersFile.property.project">project</a></code> | <code>projen.Project</code> | *No description.* |
 | <code><a href="#@macedon-technologies/batman.CodeOwnersFile.property.absolutePath">absolutePath</a></code> | <code>string</code> | The absolute path of this file. |
+| <code><a href="#@macedon-technologies/batman.CodeOwnersFile.property.committed">committed</a></code> | <code>boolean</code> | Indicates if the file will be committed. |
 | <code><a href="#@macedon-technologies/batman.CodeOwnersFile.property.path">path</a></code> | <code>string</code> | The file path, relative to the project's outdir. |
 | <code><a href="#@macedon-technologies/batman.CodeOwnersFile.property.changed">changed</a></code> | <code>boolean</code> | Indicates if the file has been changed during synthesis. |
 | <code><a href="#@macedon-technologies/batman.CodeOwnersFile.property.marker">marker</a></code> | <code>string</code> | The projen marker, used to identify files as projen-generated. |
@@ -3391,6 +3202,18 @@ The absolute path of this file.
 ---
+##### `committed`<sup>Required</sup> <a name="committed" id="@macedon-technologies/batman.CodeOwnersFile.property.committed"></a>
+```typescript
+public readonly committed: boolean;
+```
+- *Type:* boolean
+Indicates if the file will be committed.
+---
 ##### `path`<sup>Required</sup> <a name="path" id="@macedon-technologies/batman.CodeOwnersFile.property.path"></a>
 ```typescript
@@ -3492,9 +3315,13 @@ new ProductionDeployWorkflow(project: AwsCdkTypeScriptApp, options: ProductionDe
 | **Name** | **Description** |
 | --- | --- |
 | <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.toString">toString</a></code> | Returns a string representation of this construct. |
+| <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.with">with</a></code> | Applies one or more mixins to this construct. |
+| <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.postProjectCreation">postProjectCreation</a></code> | Called once, right after `postSynthesize()`, only when the project is created for the first time. |
 | <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.postSynthesize">postSynthesize</a></code> | Called after synthesis. |
 | <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.preSynthesize">preSynthesize</a></code> | Called before synthesis. |
+| <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.projectCreation">projectCreation</a></code> | Called once, right after `synthesize()`, only when the project is created for the first time. |
 | <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.synthesize">synthesize</a></code> | Writes the file to the project's output directory. |
+| <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.diff">diff</a></code> | Returns a unified diff of the old and new file contents with context lines and hunk headers. |
 | <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.addDeletionOverride">addDeletionOverride</a></code> | Syntactic sugar for `addOverride(path, undefined)`. |
 | <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.addOverride">addOverride</a></code> | Adds an override to the synthesized object file. |
 | <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.addToArray">addToArray</a></code> | Adds to an array in the synthesized object file. |
@@ -3510,6 +3337,48 @@ public toString(): string
 Returns a string representation of this construct.
+##### `with` <a name="with" id="@macedon-technologies/batman.ProductionDeployWorkflow.with"></a>
+```typescript
+public with(mixins: ...IMixin[]): IConstruct
+```
+Applies one or more mixins to this construct.
+Mixins are applied in order. The list of constructs is captured at the
+start of the call, so constructs added by a mixin will not be visited.
+Use multiple `with()` calls if subsequent mixins should apply to added
+constructs.
+###### `mixins`<sup>Required</sup> <a name="mixins" id="@macedon-technologies/batman.ProductionDeployWorkflow.with.parameter.mixins"></a>
+- *Type:* ...constructs.IMixin[]
+The mixins to apply.
+---
+##### `postProjectCreation` <a name="postProjectCreation" id="@macedon-technologies/batman.ProductionDeployWorkflow.postProjectCreation"></a>
+```typescript
+public postProjectCreation(initProject: InitProject): void
+```
+Called once, right after `postSynthesize()`, only when the project is created for the first time.
+It does not run on later `projen` invocations. It only fires for `projen new` (or `Projects.createProject`).
+It is also skipped when post-synthesis steps are disabled, e.g. `--no-post` or `PROJEN_DISABLE_POST`.
+Use it for one-off setup that can be turned off by the user, like running a task to give the user immediate
+feedback on their new project. Order across components is not guaranteed.
+###### `initProject`<sup>Required</sup> <a name="initProject" id="@macedon-technologies/batman.ProductionDeployWorkflow.postProjectCreation.parameter.initProject"></a>
+- *Type:* projen.InitProject
+Details about how the project was created, e.g. its type and the original CLI args.
+---
 ##### `postSynthesize` <a name="postSynthesize" id="@macedon-technologies/batman.ProductionDeployWorkflow.postSynthesize"></a>
 ```typescript
@@ -3528,6 +3397,25 @@ public preSynthesize(): void
 Called before synthesis.
+##### `projectCreation` <a name="projectCreation" id="@macedon-technologies/batman.ProductionDeployWorkflow.projectCreation"></a>
+```typescript
+public projectCreation(initProject: InitProject): void
+```
+Called once, right after `synthesize()`, only when the project is created for the first time.
+It does not run on later `projen` invocations. It only fires for `projen new` (or `Projects.createProject`).
+Use it for deterministic, one-off file generation. Order across components is not guaranteed.
+###### `initProject`<sup>Required</sup> <a name="initProject" id="@macedon-technologies/batman.ProductionDeployWorkflow.projectCreation.parameter.initProject"></a>
+- *Type:* projen.InitProject
+Details about how the project was created, e.g. its type and the original CLI args.
+---
 ##### `synthesize` <a name="synthesize" id="@macedon-technologies/batman.ProductionDeployWorkflow.synthesize"></a>
 ```typescript
@@ -3536,6 +3424,35 @@ public synthesize(): void
 Writes the file to the project's output directory.
+##### `diff` <a name="diff" id="@macedon-technologies/batman.ProductionDeployWorkflow.diff"></a>
+```typescript
+public diff(colorize?: boolean, contextLines?: number): string[]
+```
+Returns a unified diff of the old and new file contents with context lines and hunk headers.
+Only available after synthesis.
+This is an expensive operation and should only be used on non time-critical
+code paths, like debug output.
+###### `colorize`<sup>Optional</sup> <a name="colorize" id="@macedon-technologies/batman.ProductionDeployWorkflow.diff.parameter.colorize"></a>
+- *Type:* boolean
+Whether to colorize the diff output.
+---
+###### `contextLines`<sup>Optional</sup> <a name="contextLines" id="@macedon-technologies/batman.ProductionDeployWorkflow.diff.parameter.contextLines"></a>
+- *Type:* number
+Number of context lines around changes.
+---
 ##### `addDeletionOverride` <a name="addDeletionOverride" id="@macedon-technologies/batman.ProductionDeployWorkflow.addDeletionOverride"></a>
 ```typescript
@@ -3771,6 +3688,7 @@ Test whether the given construct is a component.
 | <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.property.node">node</a></code> | <code>constructs.Node</code> | The tree node. |
 | <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.property.project">project</a></code> | <code>projen.Project</code> | *No description.* |
 | <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.property.absolutePath">absolutePath</a></code> | <code>string</code> | The absolute path of this file. |
+| <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.property.committed">committed</a></code> | <code>boolean</code> | Indicates if the file will be committed. |
 | <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.property.path">path</a></code> | <code>string</code> | The file path, relative to the project's outdir. |
 | <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.property.changed">changed</a></code> | <code>boolean</code> | Indicates if the file has been changed during synthesis. |
 | <code><a href="#@macedon-technologies/batman.ProductionDeployWorkflow.property.marker">marker</a></code> | <code>string</code> | The projen marker, used to identify files as projen-generated. |
@@ -3815,6 +3733,18 @@ The absolute path of this file.
 ---
+##### `committed`<sup>Required</sup> <a name="committed" id="@macedon-technologies/batman.ProductionDeployWorkflow.property.committed"></a>
+```typescript
+public readonly committed: boolean;
+```
+- *Type:* boolean
+Indicates if the file will be committed.
+---
 ##### `path`<sup>Required</sup> <a name="path" id="@macedon-technologies/batman.ProductionDeployWorkflow.property.path"></a>
 ```typescript
@@ -3940,9 +3870,13 @@ new StagingDeployWorkflow(project: AwsCdkTypeScriptApp, options: StagingDeployWo
 | **Name** | **Description** |
 | --- | --- |
 | <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.toString">toString</a></code> | Returns a string representation of this construct. |
+| <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.with">with</a></code> | Applies one or more mixins to this construct. |
+| <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.postProjectCreation">postProjectCreation</a></code> | Called once, right after `postSynthesize()`, only when the project is created for the first time. |
 | <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.postSynthesize">postSynthesize</a></code> | Called after synthesis. |
 | <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.preSynthesize">preSynthesize</a></code> | Called before synthesis. |
+| <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.projectCreation">projectCreation</a></code> | Called once, right after `synthesize()`, only when the project is created for the first time. |
 | <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.synthesize">synthesize</a></code> | Writes the file to the project's output directory. |
+| <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.diff">diff</a></code> | Returns a unified diff of the old and new file contents with context lines and hunk headers. |
 | <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.addDeletionOverride">addDeletionOverride</a></code> | Syntactic sugar for `addOverride(path, undefined)`. |
 | <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.addOverride">addOverride</a></code> | Adds an override to the synthesized object file. |
 | <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.addToArray">addToArray</a></code> | Adds to an array in the synthesized object file. |
@@ -3958,6 +3892,48 @@ public toString(): string
 Returns a string representation of this construct.
+##### `with` <a name="with" id="@macedon-technologies/batman.StagingDeployWorkflow.with"></a>
+```typescript
+public with(mixins: ...IMixin[]): IConstruct
+```
+Applies one or more mixins to this construct.
+Mixins are applied in order. The list of constructs is captured at the
+start of the call, so constructs added by a mixin will not be visited.
+Use multiple `with()` calls if subsequent mixins should apply to added
+constructs.
+###### `mixins`<sup>Required</sup> <a name="mixins" id="@macedon-technologies/batman.StagingDeployWorkflow.with.parameter.mixins"></a>
+- *Type:* ...constructs.IMixin[]
+The mixins to apply.
+---
+##### `postProjectCreation` <a name="postProjectCreation" id="@macedon-technologies/batman.StagingDeployWorkflow.postProjectCreation"></a>
+```typescript
+public postProjectCreation(initProject: InitProject): void
+```
+Called once, right after `postSynthesize()`, only when the project is created for the first time.
+It does not run on later `projen` invocations. It only fires for `projen new` (or `Projects.createProject`).
+It is also skipped when post-synthesis steps are disabled, e.g. `--no-post` or `PROJEN_DISABLE_POST`.
+Use it for one-off setup that can be turned off by the user, like running a task to give the user immediate
+feedback on their new project. Order across components is not guaranteed.
+###### `initProject`<sup>Required</sup> <a name="initProject" id="@macedon-technologies/batman.StagingDeployWorkflow.postProjectCreation.parameter.initProject"></a>
+- *Type:* projen.InitProject
+Details about how the project was created, e.g. its type and the original CLI args.
+---
 ##### `postSynthesize` <a name="postSynthesize" id="@macedon-technologies/batman.StagingDeployWorkflow.postSynthesize"></a>
 ```typescript
@@ -3976,6 +3952,25 @@ public preSynthesize(): void
 Called before synthesis.
+##### `projectCreation` <a name="projectCreation" id="@macedon-technologies/batman.StagingDeployWorkflow.projectCreation"></a>
+```typescript
+public projectCreation(initProject: InitProject): void
+```
+Called once, right after `synthesize()`, only when the project is created for the first time.
+It does not run on later `projen` invocations. It only fires for `projen new` (or `Projects.createProject`).
+Use it for deterministic, one-off file generation. Order across components is not guaranteed.
+###### `initProject`<sup>Required</sup> <a name="initProject" id="@macedon-technologies/batman.StagingDeployWorkflow.projectCreation.parameter.initProject"></a>
+- *Type:* projen.InitProject
+Details about how the project was created, e.g. its type and the original CLI args.
+---
 ##### `synthesize` <a name="synthesize" id="@macedon-technologies/batman.StagingDeployWorkflow.synthesize"></a>
 ```typescript
@@ -3984,6 +3979,35 @@ public synthesize(): void
 Writes the file to the project's output directory.
+##### `diff` <a name="diff" id="@macedon-technologies/batman.StagingDeployWorkflow.diff"></a>
+```typescript
+public diff(colorize?: boolean, contextLines?: number): string[]
+```
+Returns a unified diff of the old and new file contents with context lines and hunk headers.
+Only available after synthesis.
+This is an expensive operation and should only be used on non time-critical
+code paths, like debug output.
+###### `colorize`<sup>Optional</sup> <a name="colorize" id="@macedon-technologies/batman.StagingDeployWorkflow.diff.parameter.colorize"></a>
+- *Type:* boolean
+Whether to colorize the diff output.
+---
+###### `contextLines`<sup>Optional</sup> <a name="contextLines" id="@macedon-technologies/batman.StagingDeployWorkflow.diff.parameter.contextLines"></a>
+- *Type:* number
+Number of context lines around changes.
+---
 ##### `addDeletionOverride` <a name="addDeletionOverride" id="@macedon-technologies/batman.StagingDeployWorkflow.addDeletionOverride"></a>
 ```typescript
@@ -4219,6 +4243,7 @@ Test whether the given construct is a component.
 | <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.property.node">node</a></code> | <code>constructs.Node</code> | The tree node. |
 | <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.property.project">project</a></code> | <code>projen.Project</code> | *No description.* |
 | <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.property.absolutePath">absolutePath</a></code> | <code>string</code> | The absolute path of this file. |
+| <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.property.committed">committed</a></code> | <code>boolean</code> | Indicates if the file will be committed. |
 | <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.property.path">path</a></code> | <code>string</code> | The file path, relative to the project's outdir. |
 | <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.property.changed">changed</a></code> | <code>boolean</code> | Indicates if the file has been changed during synthesis. |
 | <code><a href="#@macedon-technologies/batman.StagingDeployWorkflow.property.marker">marker</a></code> | <code>string</code> | The projen marker, used to identify files as projen-generated. |
@@ -4263,6 +4288,18 @@ The absolute path of this file.
 ---
+##### `committed`<sup>Required</sup> <a name="committed" id="@macedon-technologies/batman.StagingDeployWorkflow.property.committed"></a>
+```typescript
+public readonly committed: boolean;
+```
+- *Type:* boolean
+Indicates if the file will be committed.
+---
 ##### `path`<sup>Required</sup> <a name="path" id="@macedon-technologies/batman.StagingDeployWorkflow.property.path"></a>
 ```typescript
@@ -4381,8 +4418,11 @@ new WorkflowAutoDiscover(project: AwsCdkTypeScriptApp)
 | **Name** | **Description** |
 | --- | --- |
 | <code><a href="#@macedon-technologies/batman.WorkflowAutoDiscover.toString">toString</a></code> | Returns a string representation of this construct. |
+| <code><a href="#@macedon-technologies/batman.WorkflowAutoDiscover.with">with</a></code> | Applies one or more mixins to this construct. |
+| <code><a href="#@macedon-technologies/batman.WorkflowAutoDiscover.postProjectCreation">postProjectCreation</a></code> | Called once, right after `postSynthesize()`, only when the project is created for the first time. |
 | <code><a href="#@macedon-technologies/batman.WorkflowAutoDiscover.postSynthesize">postSynthesize</a></code> | Called after synthesis. |
 | <code><a href="#@macedon-technologies/batman.WorkflowAutoDiscover.preSynthesize">preSynthesize</a></code> | Called before synthesis. |
+| <code><a href="#@macedon-technologies/batman.WorkflowAutoDiscover.projectCreation">projectCreation</a></code> | Called once, right after `synthesize()`, only when the project is created for the first time. |
 | <code><a href="#@macedon-technologies/batman.WorkflowAutoDiscover.synthesize">synthesize</a></code> | Synthesizes files to the project output directory. |
 ---
@@ -4395,6 +4435,48 @@ public toString(): string
 Returns a string representation of this construct.
+##### `with` <a name="with" id="@macedon-technologies/batman.WorkflowAutoDiscover.with"></a>
+```typescript
+public with(mixins: ...IMixin[]): IConstruct
+```
+Applies one or more mixins to this construct.
+Mixins are applied in order. The list of constructs is captured at the
+start of the call, so constructs added by a mixin will not be visited.
+Use multiple `with()` calls if subsequent mixins should apply to added
+constructs.
+###### `mixins`<sup>Required</sup> <a name="mixins" id="@macedon-technologies/batman.WorkflowAutoDiscover.with.parameter.mixins"></a>
+- *Type:* ...constructs.IMixin[]
+The mixins to apply.
+---
+##### `postProjectCreation` <a name="postProjectCreation" id="@macedon-technologies/batman.WorkflowAutoDiscover.postProjectCreation"></a>
+```typescript
+public postProjectCreation(initProject: InitProject): void
+```
+Called once, right after `postSynthesize()`, only when the project is created for the first time.
+It does not run on later `projen` invocations. It only fires for `projen new` (or `Projects.createProject`).
+It is also skipped when post-synthesis steps are disabled, e.g. `--no-post` or `PROJEN_DISABLE_POST`.
+Use it for one-off setup that can be turned off by the user, like running a task to give the user immediate
+feedback on their new project. Order across components is not guaranteed.
+###### `initProject`<sup>Required</sup> <a name="initProject" id="@macedon-technologies/batman.WorkflowAutoDiscover.postProjectCreation.parameter.initProject"></a>
+- *Type:* projen.InitProject
+Details about how the project was created, e.g. its type and the original CLI args.
+---
 ##### `postSynthesize` <a name="postSynthesize" id="@macedon-technologies/batman.WorkflowAutoDiscover.postSynthesize"></a>
 ```typescript
@@ -4413,6 +4495,25 @@ public preSynthesize(): void
 Called before synthesis.
+##### `projectCreation` <a name="projectCreation" id="@macedon-technologies/batman.WorkflowAutoDiscover.projectCreation"></a>
+```typescript
+public projectCreation(initProject: InitProject): void
+```
+Called once, right after `synthesize()`, only when the project is created for the first time.
+It does not run on later `projen` invocations. It only fires for `projen new` (or `Projects.createProject`).
+Use it for deterministic, one-off file generation. Order across components is not guaranteed.
+###### `initProject`<sup>Required</sup> <a name="initProject" id="@macedon-technologies/batman.WorkflowAutoDiscover.projectCreation.parameter.initProject"></a>
+- *Type:* projen.InitProject
+Details about how the project was created, e.g. its type and the original CLI args.
+---
 ##### `synthesize` <a name="synthesize" id="@macedon-technologies/batman.WorkflowAutoDiscover.synthesize"></a>
 ```typescript
@@ -4674,16 +4775,14 @@ const batmanProjectOptions: BatmanProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.github">github</a></code> | <code>boolean</code> | Enable GitHub integration. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.githubOptions">githubOptions</a></code> | <code>projen.github.GitHubOptions</code> | Options for GitHub integration. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.gitpod">gitpod</a></code> | <code>boolean</code> | Add a Gitpod development environment. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.mergify">mergify</a></code> | <code>boolean</code> | Whether mergify should be enabled on this repository or not. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.mergifyOptions">mergifyOptions</a></code> | <code>projen.github.MergifyOptions</code> | Options for mergify. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.projectType">projectType</a></code> | <code>projen.ProjectType</code> | Which type of project this is (library/app). |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.projenCredentials">projenCredentials</a></code> | <code>projen.github.GithubCredentials</code> | Choose a method of providing GitHub API access for projen workflows. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.projenTokenSecret">projenTokenSecret</a></code> | <code>string</code> | The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.readme">readme</a></code> | <code>projen.SampleReadmeProps</code> | The README setup. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.stale">stale</a></code> | <code>boolean</code> | Auto-close of stale issues and pull request. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.staleOptions">staleOptions</a></code> | <code>projen.github.StaleOptions</code> | Auto-close stale issues and pull requests. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.vscode">vscode</a></code> | <code>boolean</code> | Enable VSCode integration. |
+| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.addPackageManagerToDevEngines">addPackageManagerToDevEngines</a></code> | <code>boolean</code> | Automatically add the resolved `packageManager` to `devEngines.packageManager` in `package.json`, setting `onFail` to `ignore`. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.allowLibraryDependencies">allowLibraryDependencies</a></code> | <code>boolean</code> | Allow the project to include `peerDependencies` and `bundledDependencies`. |
+| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.allowScripts">allowScripts</a></code> | <code>string[]</code> | List of dependency (package) names that are allowed to run lifecycle install scripts (`preinstall`, `install`, `postinstall`, `prepare`) during dependency installation. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.authorEmail">authorEmail</a></code> | <code>string</code> | Author's e-mail. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.authorName">authorName</a></code> | <code>string</code> | Author's name. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.authorOrganization">authorOrganization</a></code> | <code>boolean</code> | Is the author an organization. |
@@ -4695,9 +4794,12 @@ const batmanProjectOptions: BatmanProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.bundledDeps">bundledDeps</a></code> | <code>string[]</code> | List of dependencies to bundle into this module. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.bunVersion">bunVersion</a></code> | <code>string</code> | The version of Bun to use if using Bun as a package manager. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.codeArtifactOptions">codeArtifactOptions</a></code> | <code>projen.javascript.CodeArtifactOptions</code> | Options for npm packages using AWS CodeArtifact. |
+| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.dedupeDeps">dedupeDeps</a></code> | <code>boolean</code> | Add a `dedupe` task that deduplicates project dependencies. |
+| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.deleteOrphanedLockFiles">deleteOrphanedLockFiles</a></code> | <code>boolean</code> | Automatically delete lockfiles from package managers that are not the active one. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.deps">deps</a></code> | <code>string[]</code> | Runtime dependencies of this module. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.description">description</a></code> | <code>string</code> | The description is just a string that helps people understand the purpose of the package. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.devDeps">devDeps</a></code> | <code>string[]</code> | Build dependencies for this module. |
+| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.devEngines">devEngines</a></code> | <code>projen.javascript.DevEngines</code> | Configure the `devEngines` field in `package.json`. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.entrypoint">entrypoint</a></code> | <code>string</code> | Module entrypoint (`main` in `package.json`). |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.homepage">homepage</a></code> | <code>string</code> | Package's Homepage / Website. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.keywords">keywords</a></code> | <code>string[]</code> | Keywords to include in `package.json`. |
@@ -4707,7 +4809,6 @@ const batmanProjectOptions: BatmanProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.minNodeVersion">minNodeVersion</a></code> | <code>string</code> | The minimum node version required by this package to function. Most projects should not use this option. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.npmAccess">npmAccess</a></code> | <code>projen.javascript.NpmAccess</code> | Access level of the npm package. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.npmProvenance">npmProvenance</a></code> | <code>boolean</code> | Should provenance statements be generated when the package is published. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.npmRegistry">npmRegistry</a></code> | <code>string</code> | The host name of the npm registry to publish to. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.npmRegistryUrl">npmRegistryUrl</a></code> | <code>string</code> | The base URL of the npm package registry. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.npmTokenSecret">npmTokenSecret</a></code> | <code>string</code> | GitHub secret which contains the NPM token to use when publishing packages. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.npmTrustedPublishing">npmTrustedPublishing</a></code> | <code>boolean</code> | Use trusted publishing for publishing to npmjs.com Needs to be pre-configured on npm.js to work. |
@@ -4715,11 +4816,11 @@ const batmanProjectOptions: BatmanProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.packageName">packageName</a></code> | <code>string</code> | The "name" in package.json. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.peerDependencyOptions">peerDependencyOptions</a></code> | <code>projen.javascript.PeerDependencyOptions</code> | Options for `peerDeps`. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.peerDeps">peerDeps</a></code> | <code>string[]</code> | Peer dependencies for this module. |
+| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.pnpmOptions">pnpmOptions</a></code> | <code>projen.javascript.PnpmOptions</code> | Options for pnpm. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.pnpmVersion">pnpmVersion</a></code> | <code>string</code> | The version of PNPM to use if using PNPM as a package manager. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.repository">repository</a></code> | <code>string</code> | The repository is the location where the actual code for your package lives. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.repositoryDirectory">repositoryDirectory</a></code> | <code>string</code> | If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.scopedPackagesOptions">scopedPackagesOptions</a></code> | <code>projen.javascript.ScopedPackagesOptions[]</code> | Options for privately hosted scoped packages. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.scripts">scripts</a></code> | <code>{[ key: string ]: string}</code> | npm scripts to include. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.stability">stability</a></code> | <code>string</code> | Package's Stability. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.yarnBerryOptions">yarnBerryOptions</a></code> | <code>projen.javascript.YarnBerryOptions</code> | Options for Yarn Berry. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.bumpPackage">bumpPackage</a></code> | <code>string</code> | The `commit-and-tag-version` compatible package used to bump the package version, as a dependency string. |
@@ -4735,10 +4836,8 @@ const batmanProjectOptions: BatmanProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.releasableCommits">releasableCommits</a></code> | <code>projen.ReleasableCommits</code> | Find commits that should be considered releasable Used to decide if a release is required. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.releaseBranches">releaseBranches</a></code> | <code>{[ key: string ]: projen.release.BranchOptions}</code> | Defines additional release branches. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.releaseEnvironment">releaseEnvironment</a></code> | <code>string</code> | The GitHub Actions environment used for the release. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.releaseEveryCommit">releaseEveryCommit</a></code> | <code>boolean</code> | Automatically release new versions every commit to one of branches in `releaseBranches`. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.releaseFailureIssue">releaseFailureIssue</a></code> | <code>boolean</code> | Create a github issue on every failed publishing task. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.releaseFailureIssueLabel">releaseFailureIssueLabel</a></code> | <code>string</code> | The label to apply to issues indicating publish failures. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.releaseSchedule">releaseSchedule</a></code> | <code>string</code> | CRON schedule to trigger new releases. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.releaseTagPrefix">releaseTagPrefix</a></code> | <code>string</code> | Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.releaseTrigger">releaseTrigger</a></code> | <code>projen.release.ReleaseTrigger</code> | The release trigger to use. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.releaseWorkflowEnv">releaseWorkflowEnv</a></code> | <code>{[ key: string ]: string}</code> | Build environment variables for release workflows. |
@@ -4748,7 +4847,6 @@ const batmanProjectOptions: BatmanProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.workflowContainerImage">workflowContainerImage</a></code> | <code>string</code> | Container image to use for GitHub workflows. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.workflowRunsOn">workflowRunsOn</a></code> | <code>string[]</code> | Github Runner selection labels. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.workflowRunsOnGroup">workflowRunsOnGroup</a></code> | <code>projen.GroupRunnerOptions</code> | Github Runner Group selection options. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.defaultReleaseBranch">defaultReleaseBranch</a></code> | <code>string</code> | The name of the main release branch. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.artifactsDirectory">artifactsDirectory</a></code> | <code>string</code> | A directory which will contain build artifacts. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.auditDeps">auditDeps</a></code> | <code>boolean</code> | Run security audit on dependencies. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.auditDepsOptions">auditDepsOptions</a></code> | <code>projen.javascript.AuditOptions</code> | Security audit options. |
@@ -4757,13 +4855,13 @@ const batmanProjectOptions: BatmanProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.biomeOptions">biomeOptions</a></code> | <code>projen.javascript.BiomeOptions</code> | Biome options. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.buildWorkflow">buildWorkflow</a></code> | <code>boolean</code> | Define a GitHub workflow for building PRs. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.buildWorkflowOptions">buildWorkflowOptions</a></code> | <code>projen.javascript.BuildWorkflowOptions</code> | Options for PR build workflow. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.buildWorkflowTriggers">buildWorkflowTriggers</a></code> | <code>projen.github.workflows.Triggers</code> | Build workflow triggers. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.bundlerOptions">bundlerOptions</a></code> | <code>projen.javascript.BundlerOptions</code> | Options for `Bundler`. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.checkLicenses">checkLicenses</a></code> | <code>projen.javascript.LicenseCheckerOptions</code> | Configure which licenses should be deemed acceptable for use by dependencies. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.codeCov">codeCov</a></code> | <code>boolean</code> | Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v5 By default, OIDC auth is used. Alternatively a token can be provided via `codeCovTokenSecret`. |
+| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.codeCov">codeCov</a></code> | <code>boolean</code> | Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.codeCovTokenSecret">codeCovTokenSecret</a></code> | <code>string</code> | Define the secret name for a specified https://codecov.io/ token. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.copyrightOwner">copyrightOwner</a></code> | <code>string</code> | License copyright owner. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.copyrightPeriod">copyrightPeriod</a></code> | <code>string</code> | The copyright years to put in the LICENSE file. |
+| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.defaultReleaseBranch">defaultReleaseBranch</a></code> | <code>string</code> | The name of the main release branch. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.dependabot">dependabot</a></code> | <code>boolean</code> | Use dependabot to handle dependency upgrades. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.dependabotOptions">dependabotOptions</a></code> | <code>projen.github.DependabotOptions</code> | Options for dependabot. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.depsUpgrade">depsUpgrade</a></code> | <code>boolean</code> | Use tasks and github workflows to handle dependency upgrades. |
@@ -4771,8 +4869,6 @@ const batmanProjectOptions: BatmanProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.gitignore">gitignore</a></code> | <code>string[]</code> | Additional entries to .gitignore. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.jest">jest</a></code> | <code>boolean</code> | Setup jest unit tests. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.jestOptions">jestOptions</a></code> | <code>projen.javascript.JestOptions</code> | Jest options. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.mutableBuild">mutableBuild</a></code> | <code>boolean</code> | Automatically update files modified during builds to pull-request branches. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.npmignore">npmignore</a></code> | <code>string[]</code> | Additional entries to .npmignore. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.npmignoreEnabled">npmignoreEnabled</a></code> | <code>boolean</code> | Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.npmIgnoreOptions">npmIgnoreOptions</a></code> | <code>projen.IgnoreFileOptions</code> | Configuration options for .npmignore file. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.package">package</a></code> | <code>boolean</code> | Defines a `package` task that will produce an npm tarball under the artifacts directory (e.g. `dist`). |
@@ -4786,13 +4882,12 @@ const batmanProjectOptions: BatmanProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.pullRequestTemplateContents">pullRequestTemplateContents</a></code> | <code>string[]</code> | The contents of the pull request template. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.release">release</a></code> | <code>boolean</code> | Add release management to this project. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.releaseToNpm">releaseToNpm</a></code> | <code>boolean</code> | Automatically release to npm when new versions are introduced. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.releaseWorkflow">releaseWorkflow</a></code> | <code>boolean</code> | DEPRECATED: renamed to `release`. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.workflowBootstrapSteps">workflowBootstrapSteps</a></code> | <code>projen.github.workflows.JobStep[]</code> | Workflow steps to use in order to bootstrap this repo. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.workflowGitIdentity">workflowGitIdentity</a></code> | <code>projen.github.GitIdentity</code> | The git identity to use in workflows. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.workflowNodeVersion">workflowNodeVersion</a></code> | <code>string</code> | The node version used in GitHub Actions workflows. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.workflowPackageCache">workflowPackageCache</a></code> | <code>boolean</code> | Enable Node.js package cache in GitHub workflows. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.disableTsconfig">disableTsconfig</a></code> | <code>boolean</code> | Do not generate a `tsconfig.json` file (used by jsii projects since tsconfig.json is generated by the jsii compiler). |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.disableTsconfigDev">disableTsconfigDev</a></code> | <code>boolean</code> | Do not generate a `tsconfig.dev.json` file. |
+| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.disableTsconfigDev">disableTsconfigDev</a></code> | <code>boolean</code> | Do not generate a development tsconfig file. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.docgen">docgen</a></code> | <code>boolean</code> | Docgen by Typedoc. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.docsDirectory">docsDirectory</a></code> | <code>string</code> | Docs directory. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.entrypointTypes">entrypointTypes</a></code> | <code>string</code> | The .d.ts file that includes the type declarations for this module. |
@@ -4801,12 +4896,13 @@ const batmanProjectOptions: BatmanProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.libdir">libdir</a></code> | <code>string</code> | Typescript  artifacts output directory. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.projenrcTs">projenrcTs</a></code> | <code>boolean</code> | Use TypeScript for your projenrc file (`.projenrc.ts`). |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.projenrcTsOptions">projenrcTsOptions</a></code> | <code>projen.typescript.ProjenrcOptions</code> | Options for .projenrc.ts. |
+| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.runner">runner</a></code> | <code>projen.typescript.TypeScriptRunner</code> | The TypeScript runner to use for executing TypeScript files. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.sampleCode">sampleCode</a></code> | <code>boolean</code> | Generate one-time sample in `src/` and `test/` if there are no files there. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.srcdir">srcdir</a></code> | <code>string</code> | Typescript sources directory. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.testdir">testdir</a></code> | <code>string</code> | Jest tests directory. Tests files should be named `xxx.test.ts`. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.tsconfig">tsconfig</a></code> | <code>projen.javascript.TypescriptConfigOptions</code> | Custom TSConfig. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.tsconfigDev">tsconfigDev</a></code> | <code>projen.javascript.TypescriptConfigOptions</code> | Custom tsconfig options for the development tsconfig.json file (used for testing). |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.tsconfigDevFile">tsconfigDevFile</a></code> | <code>string</code> | The name of the development tsconfig.json file. |
+| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.tsconfigDevFile">tsconfigDevFile</a></code> | <code>string</code> | The name (and path) of the development tsconfig file. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.tsJestOptions">tsJestOptions</a></code> | <code>projen.typescript.TsJestOptions</code> | Options for ts-jest. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.typescriptVersion">typescriptVersion</a></code> | <code>string</code> | TypeScript version to use. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.buildCommand">buildCommand</a></code> | <code>string</code> | A command to execute before synthesis. |
@@ -4817,12 +4913,7 @@ const batmanProjectOptions: BatmanProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.watchExcludes">watchExcludes</a></code> | <code>string[]</code> | Glob patterns to exclude from `cdk watch`. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.watchIncludes">watchIncludes</a></code> | <code>string[]</code> | Glob patterns to include in `cdk watch`. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.cdkVersion">cdkVersion</a></code> | <code>string</code> | Minimum version of the AWS CDK to depend on. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.cdkAssert">cdkAssert</a></code> | <code>boolean</code> | Warning: NodeJS only. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.cdkAssertions">cdkAssertions</a></code> | <code>boolean</code> | Install the assertions library? |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.cdkCliVersion">cdkCliVersion</a></code> | <code>string</code> | Version range of the AWS CDK CLI to depend on. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.cdkDependencies">cdkDependencies</a></code> | <code>string[]</code> | Which AWS CDKv1 modules this project requires. |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.cdkDependenciesAsDeps">cdkDependenciesAsDeps</a></code> | <code>boolean</code> | If this is enabled (default), all modules declared in `cdkDependencies` will be also added as normal `dependencies` (as well as `peerDependencies`). |
-| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.cdkTestDependencies">cdkTestDependencies</a></code> | <code>string[]</code> | AWS CDK modules required for testing. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.cdkVersionPinning">cdkVersionPinning</a></code> | <code>boolean</code> | Use pinned version instead of caret version for CDK. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.constructsVersion">constructsVersion</a></code> | <code>string</code> | Minimum version of the `constructs` library to depend on. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.app">app</a></code> | <code>string</code> | The command line to execute in order to synthesize the CDK application (language specific). |
@@ -4833,6 +4924,7 @@ const batmanProjectOptions: BatmanProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.lambdaAutoDiscover">lambdaAutoDiscover</a></code> | <code>boolean</code> | Automatically adds an `awscdk.LambdaFunction` for each `.lambda.ts` handler in your source tree. If this is disabled, you can manually add an `awscdk.AutoDiscover` component to your project. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.lambdaExtensionAutoDiscover">lambdaExtensionAutoDiscover</a></code> | <code>boolean</code> | Automatically adds an `awscdk.LambdaExtension` for each `.lambda-extension.ts` entrypoint in your source tree. If this is disabled, you can manually add an `awscdk.AutoDiscover` component to your project. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.lambdaOptions">lambdaOptions</a></code> | <code>projen.awscdk.LambdaFunctionCommonOptions</code> | Common options for all AWS Lambda functions. |
+| <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.singletonLambdaAutoDiscover">singletonLambdaAutoDiscover</a></code> | <code>boolean</code> | Automatically adds an `awscdk.SingletonFunction` for each `.singleton-lambda.ts` handler in your source tree. If this is disabled, you can manually add an `awscdk.AutoDiscover` component to your project. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.dev">dev</a></code> | <code><a href="#@macedon-technologies/batman.ApplicationEnvironmentConfig">ApplicationEnvironmentConfig</a></code> | Development environment configuration. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.prod">prod</a></code> | <code><a href="#@macedon-technologies/batman.ApplicationEnvironmentConfig">ApplicationEnvironmentConfig</a></code> | Production environment configuration. |
 | <code><a href="#@macedon-technologies/batman.BatmanProjectOptions.property.staging">staging</a></code> | <code><a href="#@macedon-technologies/batman.ApplicationEnvironmentConfig">ApplicationEnvironmentConfig</a></code> | Development environment configuration. |
@@ -4961,6 +5053,10 @@ public readonly projenCommand: string;
 The shell command to use in order to run the projen CLI.
+Inserted verbatim into task steps, workflows and IDE configuration, and run
+by each of their shells - locally, in CI and in dev containers. Keep it a
+plain unquoted command, since shell syntax in it executes in all of them.
 Can be used to customize in special environments.
 ---
@@ -5129,51 +5225,6 @@ Add a Gitpod development environment.
 ---
-##### ~~`mergify`~~<sup>Optional</sup> <a name="mergify" id="@macedon-technologies/batman.BatmanProjectOptions.property.mergify"></a>
-- *Deprecated:* use `githubOptions.mergify` instead
-```typescript
-public readonly mergify: boolean;
-```
-- *Type:* boolean
-- *Default:* true
-Whether mergify should be enabled on this repository or not.
----
-##### ~~`mergifyOptions`~~<sup>Optional</sup> <a name="mergifyOptions" id="@macedon-technologies/batman.BatmanProjectOptions.property.mergifyOptions"></a>
-- *Deprecated:* use `githubOptions.mergifyOptions` instead
-```typescript
-public readonly mergifyOptions: MergifyOptions;
-```
-- *Type:* projen.github.MergifyOptions
-- *Default:* default options
-Options for mergify.
----
-##### ~~`projectType`~~<sup>Optional</sup> <a name="projectType" id="@macedon-technologies/batman.BatmanProjectOptions.property.projectType"></a>
-- *Deprecated:* no longer supported at the base project level
-```typescript
-public readonly projectType: ProjectType;
-```
-- *Type:* projen.ProjectType
-- *Default:* ProjectType.UNKNOWN
-Which type of project this is (library/app).
----
 ##### `projenCredentials`<sup>Optional</sup> <a name="projenCredentials" id="@macedon-technologies/batman.BatmanProjectOptions.property.projenCredentials"></a>
 ```typescript
@@ -5187,24 +5238,6 @@ Choose a method of providing GitHub API access for projen workflows.
 ---
-##### ~~`projenTokenSecret`~~<sup>Optional</sup> <a name="projenTokenSecret" id="@macedon-technologies/batman.BatmanProjectOptions.property.projenTokenSecret"></a>
-- *Deprecated:* use `projenCredentials`
-```typescript
-public readonly projenTokenSecret: string;
-```
-- *Type:* string
-- *Default:* "PROJEN_GITHUB_TOKEN"
-The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows.
-This token needs to have the `repo`, `workflows`
-and `packages` scope.
----
 ##### `readme`<sup>Optional</sup> <a name="readme" id="@macedon-technologies/batman.BatmanProjectOptions.property.readme"></a>
 ```typescript
@@ -5270,6 +5303,19 @@ Enabled by default for root projects. Disabled for non-root projects.
 ---
+##### `addPackageManagerToDevEngines`<sup>Optional</sup> <a name="addPackageManagerToDevEngines" id="@macedon-technologies/batman.BatmanProjectOptions.property.addPackageManagerToDevEngines"></a>
+```typescript
+public readonly addPackageManagerToDevEngines: boolean;
+```
+- *Type:* boolean
+- *Default:* true
+Automatically add the resolved `packageManager` to `devEngines.packageManager` in `package.json`, setting `onFail` to `ignore`.
+---
 ##### `allowLibraryDependencies`<sup>Optional</sup> <a name="allowLibraryDependencies" id="@macedon-technologies/batman.BatmanProjectOptions.property.allowLibraryDependencies"></a>
 ```typescript
@@ -5286,6 +5332,44 @@ for specifying these.
 ---
+##### `allowScripts`<sup>Optional</sup> <a name="allowScripts" id="@macedon-technologies/batman.BatmanProjectOptions.property.allowScripts"></a>
+```typescript
+public readonly allowScripts: string[];
+```
+- *Type:* string[]
+- *Default:* all install scripts are allowed to run (package manager default)
+List of dependency (package) names that are allowed to run lifecycle install scripts (`preinstall`, `install`, `postinstall`, `prepare`) during dependency installation.
+These scripts can execute arbitrary code, making them a common
+supply-chain attack vector. Package managers are moving toward
+blocking them by default and requiring an explicit allowlist.
+Configuring `allowScripts` sets up that allowlist so scripts only run
+for the packages you have explicitly reviewed and trust.
+Support for this setting depends on the configured `packageManager`:
+- `NPM`: written to the native `allowScripts` field in `package.json`
+  (requires npm >= 11.16; see https://docs.npmjs.com/cli/v11/commands/npm-approve-scripts).
+- `BUN`: written to the native `trustedDependencies` field in
+  `package.json` (see https://bun.com/docs/pm/lifecycle).
+- `PNPM`: written to the `onlyBuiltDependencies` setting in
+  `pnpm-workspace.yaml` (see https://pnpm.io/settings#onlybuiltdependencies).
+- `YARN2`, `YARN_BERRY`: written to the native
+  `dependenciesMeta.<pkg>.built` allowlist in `package.json`, combined
+  with `enableScripts: false` in `.yarnrc.yml` (see
+  https://yarnpkg.com/features/security#postinstalls). If you set
+  `yarnBerryOptions.yarnRcOptions.enableScripts` explicitly, that value
+  is respected instead of being overridden.
+- `YARN`, `YARN_CLASSIC`: not supported. Yarn Classic has no native
+  mechanism to allowlist install scripts for specific dependencies.
+  Setting this option with one of these package managers throws an
+  error at synthesis time.
+---
 ##### `authorEmail`<sup>Optional</sup> <a name="authorEmail" id="@macedon-technologies/batman.BatmanProjectOptions.property.authorEmail"></a>
 ```typescript
@@ -5402,11 +5486,11 @@ added both to the `dependencies` section and `bundledDependencies` section of
 your `package.json`.
 The recommendation is to only specify the module name here (e.g.
-`express`). This will behave similar to `yarn add` or `npm install` in the
+`express`). This will behave similar to `pnpm add` or `npm install` in the
 sense that it will add the module as a dependency to your `package.json`
 file with the latest version (`^`). You can specify semver requirements in
-the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and
-this will be what you `package.json` will eventually include.
+the same syntax passed to `pnpm add` or `npm i` (e.g. `express@^2`) and
+this will be what your `package.json` will eventually include.
 ---
@@ -5434,7 +5518,53 @@ public readonly codeArtifactOptions: CodeArtifactOptions;
 Options for npm packages using AWS CodeArtifact.
-This is required if publishing packages to, or installing scoped packages from AWS CodeArtifact
+This is required if publishing packages to, or installing scoped packages from AWS CodeArtifact
+---
+##### `dedupeDeps`<sup>Optional</sup> <a name="dedupeDeps" id="@macedon-technologies/batman.BatmanProjectOptions.property.dedupeDeps"></a>
+```typescript
+public readonly dedupeDeps: boolean;
+```
+- *Type:* boolean
+- *Default:* false, unless `yarnBerryOptions.dedupePackages` is set
+Add a `dedupe` task that deduplicates project dependencies.
+Deduplication prevents multiple versions of the same package from being
+installed, if a single version can satisfy all requested version ranges.
+This prevents version proliferation and reduces the size of the dependency
+tree.
+The behavior depends on the package manager:
+- npm: runs `npm dedupe` after every mutating install.
+- pnpm: runs `pnpm dedupe` after every mutating install.
+- Yarn Berry: runs `yarn dedupe` after every mutating install. If
+  `yarnBerryOptions.dedupePackages` is set, only the listed packages are
+  deduplicated.
+- Yarn Classic: `yarn install` already deduplicates, so the task only
+  prints an informational message.
+- Bun: not supported, enabling this option throws an error.
+---
+##### `deleteOrphanedLockFiles`<sup>Optional</sup> <a name="deleteOrphanedLockFiles" id="@macedon-technologies/batman.BatmanProjectOptions.property.deleteOrphanedLockFiles"></a>
+```typescript
+public readonly deleteOrphanedLockFiles: boolean;
+```
+- *Type:* boolean
+- *Default:* true
+Automatically delete lockfiles from package managers that are not the active one.
+Only triggered when the lockfile for the configured package
+manager already exists.
+This is useful when migrating between package managers to avoid conflicts.
 ---
@@ -5450,11 +5580,11 @@ public readonly deps: string[];
 Runtime dependencies of this module.
 The recommendation is to only specify the module name here (e.g.
-`express`). This will behave similar to `yarn add` or `npm install` in the
+`express`). This will behave similar to `pnpm add` or `npm install` in the
 sense that it will add the module as a dependency to your `package.json`
 file with the latest version (`^`). You can specify semver requirements in
-the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and
-this will be what you `package.json` will eventually include.
+the same syntax passed to `pnpm add` or `npm i` (e.g. `express@^2`) and
+this will be what your `package.json` will eventually include.
 ---
@@ -5496,11 +5626,11 @@ available in your build environment but will not be fetched when this
 module is consumed.
 The recommendation is to only specify the module name here (e.g.
-`express`). This will behave similar to `yarn add` or `npm install` in the
+`express`). This will behave similar to `pnpm add` or `npm install` in the
 sense that it will add the module as a dependency to your `package.json`
 file with the latest version (`^`). You can specify semver requirements in
-the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and
-this will be what you `package.json` will eventually include.
+the same syntax passed to `pnpm add` or `npm i` (e.g. `express@^2`) and
+this will be what your `package.json` will eventually include.
 ---
@@ -5511,6 +5641,24 @@ this will be what you `package.json` will eventually include.
 ```
+##### `devEngines`<sup>Optional</sup> <a name="devEngines" id="@macedon-technologies/batman.BatmanProjectOptions.property.devEngines"></a>
+```typescript
+public readonly devEngines: DevEngines;
+```
+- *Type:* projen.javascript.DevEngines
+Configure the `devEngines` field in `package.json`.
+The `devEngines.packageManager` field is automatically populated based on
+the resolved `packageManager` value. Any fields provided here are merged
+with the auto-populated `packageManager` entry.
+> [https://docs.npmjs.com/cli/v10/configuring-npm/package-json#devengines](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#devengines)
+---
 ##### `entrypoint`<sup>Optional</sup> <a name="entrypoint" id="@macedon-technologies/batman.BatmanProjectOptions.property.entrypoint"></a>
 ```typescript
@@ -5655,22 +5803,6 @@ which is using npm internally and supports provenance statements independently o
 ---
-##### ~~`npmRegistry`~~<sup>Optional</sup> <a name="npmRegistry" id="@macedon-technologies/batman.BatmanProjectOptions.property.npmRegistry"></a>
-- *Deprecated:* use `npmRegistryUrl` instead
-```typescript
-public readonly npmRegistry: string;
-```
-- *Type:* string
-The host name of the npm registry to publish to.
-Cannot be set together with `npmRegistryUrl`.
----
 ##### `npmRegistryUrl`<sup>Optional</sup> <a name="npmRegistryUrl" id="@macedon-technologies/batman.BatmanProjectOptions.property.npmRegistryUrl"></a>
 ```typescript
@@ -5719,7 +5851,7 @@ public readonly packageManager: NodePackageManager;
 ```
 - *Type:* projen.javascript.NodePackageManager
-- *Default:* NodePackageManager.YARN_CLASSIC
+- *Default:* Detected from the calling process or `YARN_CLASSIC` if detection fails.
 The Node Package Manager used to execute scripts.
@@ -5777,6 +5909,19 @@ test your module against the lowest peer version required.
 ---
+##### `pnpmOptions`<sup>Optional</sup> <a name="pnpmOptions" id="@macedon-technologies/batman.BatmanProjectOptions.property.pnpmOptions"></a>
+```typescript
+public readonly pnpmOptions: PnpmOptions;
+```
+- *Type:* projen.javascript.PnpmOptions
+- *Default:* all default options
+Options for pnpm.
+---
 ##### `pnpmVersion`<sup>Optional</sup> <a name="pnpmVersion" id="@macedon-technologies/batman.BatmanProjectOptions.property.pnpmVersion"></a>
 ```typescript
@@ -5784,7 +5929,7 @@ public readonly pnpmVersion: string;
 ```
 - *Type:* string
-- *Default:* "9"
+- *Default:* "10.33.0"
 The version of PNPM to use if using PNPM as a package manager.
@@ -5829,25 +5974,6 @@ Options for privately hosted scoped packages.
 ---
-##### ~~`scripts`~~<sup>Optional</sup> <a name="scripts" id="@macedon-technologies/batman.BatmanProjectOptions.property.scripts"></a>
-- *Deprecated:* use `project.addTask()` or `package.setScript()`
-```typescript
-public readonly scripts: {[ key: string ]: string};
-```
-- *Type:* {[ key: string ]: string}
-- *Default:* {}
-npm scripts to include.
-If a script has the same name as a standard script,
-the standard script will be overwritten.
-Also adds the script as a task.
----
 ##### `stability`<sup>Optional</sup> <a name="stability" id="@macedon-technologies/batman.BatmanProjectOptions.property.stability"></a>
 ```typescript
@@ -6090,21 +6216,6 @@ on a per artifact basis.
 ---
-##### ~~`releaseEveryCommit`~~<sup>Optional</sup> <a name="releaseEveryCommit" id="@macedon-technologies/batman.BatmanProjectOptions.property.releaseEveryCommit"></a>
-- *Deprecated:* Use `releaseTrigger: ReleaseTrigger.continuous()` instead
-```typescript
-public readonly releaseEveryCommit: boolean;
-```
-- *Type:* boolean
-- *Default:* true
-Automatically release new versions every commit to one of branches in `releaseBranches`.
----
 ##### `releaseFailureIssue`<sup>Optional</sup> <a name="releaseFailureIssue" id="@macedon-technologies/batman.BatmanProjectOptions.property.releaseFailureIssue"></a>
 ```typescript
@@ -6133,21 +6244,6 @@ Only applies if `releaseFailureIssue` is true.
 ---
-##### ~~`releaseSchedule`~~<sup>Optional</sup> <a name="releaseSchedule" id="@macedon-technologies/batman.BatmanProjectOptions.property.releaseSchedule"></a>
-- *Deprecated:* Use `releaseTrigger: ReleaseTrigger.scheduled()` instead
-```typescript
-public readonly releaseSchedule: string;
-```
-- *Type:* string
-- *Default:* no scheduled releases
-CRON schedule to trigger new releases.
----
 ##### `releaseTagPrefix`<sup>Optional</sup> <a name="releaseTagPrefix" id="@macedon-technologies/batman.BatmanProjectOptions.property.releaseTagPrefix"></a>
 ```typescript
@@ -6245,7 +6341,9 @@ Container image to use for GitHub workflows.
 ---
-##### `workflowRunsOn`<sup>Optional</sup> <a name="workflowRunsOn" id="@macedon-technologies/batman.BatmanProjectOptions.property.workflowRunsOn"></a>
+##### ~~`workflowRunsOn`~~<sup>Optional</sup> <a name="workflowRunsOn" id="@macedon-technologies/batman.BatmanProjectOptions.property.workflowRunsOn"></a>
+- *Deprecated:* use `githubOptions.workflowRunsOn` on the project, or `runsOn` on `ReleaseOptions`
 ```typescript
 public readonly workflowRunsOn: string[];
@@ -6258,7 +6356,9 @@ Github Runner selection labels.
 ---
-##### `workflowRunsOnGroup`<sup>Optional</sup> <a name="workflowRunsOnGroup" id="@macedon-technologies/batman.BatmanProjectOptions.property.workflowRunsOnGroup"></a>
+##### ~~`workflowRunsOnGroup`~~<sup>Optional</sup> <a name="workflowRunsOnGroup" id="@macedon-technologies/batman.BatmanProjectOptions.property.workflowRunsOnGroup"></a>
+- *Deprecated:* use `githubOptions.workflowRunsOnGroup` on the project, or `runsOnGroup` on `ReleaseOptions`
 ```typescript
 public readonly workflowRunsOnGroup: GroupRunnerOptions;
@@ -6270,19 +6370,6 @@ Github Runner Group selection options.
 ---
-##### `defaultReleaseBranch`<sup>Required</sup> <a name="defaultReleaseBranch" id="@macedon-technologies/batman.BatmanProjectOptions.property.defaultReleaseBranch"></a>
-```typescript
-public readonly defaultReleaseBranch: string;
-```
-- *Type:* string
-- *Default:* "main"
-The name of the main release branch.
----
 ##### `artifactsDirectory`<sup>Optional</sup> <a name="artifactsDirectory" id="@macedon-technologies/batman.BatmanProjectOptions.property.artifactsDirectory"></a>
 ```typescript
@@ -6392,21 +6479,6 @@ Options for PR build workflow.
 ---
-##### ~~`buildWorkflowTriggers`~~<sup>Optional</sup> <a name="buildWorkflowTriggers" id="@macedon-technologies/batman.BatmanProjectOptions.property.buildWorkflowTriggers"></a>
-- *Deprecated:* - Use `buildWorkflowOptions.workflowTriggers`
-```typescript
-public readonly buildWorkflowTriggers: Triggers;
-```
-- *Type:* projen.github.workflows.Triggers
-- *Default:* "{ pullRequest: {}, workflowDispatch: {} }"
-Build workflow triggers.
----
 ##### `bundlerOptions`<sup>Optional</sup> <a name="bundlerOptions" id="@macedon-technologies/batman.BatmanProjectOptions.property.bundlerOptions"></a>
 ```typescript
@@ -6443,7 +6515,10 @@ public readonly codeCov: boolean;
 - *Type:* boolean
 - *Default:* false
-Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v5 By default, OIDC auth is used. Alternatively a token can be provided via `codeCovTokenSecret`.
+Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/.
+Uses codecov/codecov-action. By default, OIDC auth is used.
+Alternatively a token can be provided via `codeCovTokenSecret`.
 ---
@@ -6471,6 +6546,10 @@ public readonly copyrightOwner: string;
 License copyright owner.
+This value is only used if the selected license text contains the
+`$copyright_owner` placeholder. For example, it has no effect on the
+MPL-2.0 license text.
 ---
 ##### `copyrightPeriod`<sup>Optional</sup> <a name="copyrightPeriod" id="@macedon-technologies/batman.BatmanProjectOptions.property.copyrightPeriod"></a>
@@ -6484,6 +6563,23 @@ public readonly copyrightPeriod: string;
 The copyright years to put in the LICENSE file.
+This value is only used if the selected license text contains the
+`$copyright_period` placeholder. For example, it has no effect on the
+MPL-2.0 license text.
+---
+##### `defaultReleaseBranch`<sup>Optional</sup> <a name="defaultReleaseBranch" id="@macedon-technologies/batman.BatmanProjectOptions.property.defaultReleaseBranch"></a>
+```typescript
+public readonly defaultReleaseBranch: string;
+```
+- *Type:* string
+- *Default:* "main"
+The name of the main release branch.
 ---
 ##### `dependabot`<sup>Optional</sup> <a name="dependabot" id="@macedon-technologies/batman.BatmanProjectOptions.property.dependabot"></a>
@@ -6580,41 +6676,6 @@ Jest options.
 ---
-##### ~~`mutableBuild`~~<sup>Optional</sup> <a name="mutableBuild" id="@macedon-technologies/batman.BatmanProjectOptions.property.mutableBuild"></a>
-- *Deprecated:* - Use `buildWorkflowOptions.mutableBuild`
-```typescript
-public readonly mutableBuild: boolean;
-```
-- *Type:* boolean
-- *Default:* true
-Automatically update files modified during builds to pull-request branches.
-This means
-that any files synthesized by projen or e.g. test snapshots will always be up-to-date
-before a PR is merged.
-Implies that PR builds do not have anti-tamper checks.
----
-##### ~~`npmignore`~~<sup>Optional</sup> <a name="npmignore" id="@macedon-technologies/batman.BatmanProjectOptions.property.npmignore"></a>
-- *Deprecated:* - use `project.addPackageIgnore`
-```typescript
-public readonly npmignore: string[];
-```
-- *Type:* string[]
-Additional entries to .npmignore.
----
 ##### `npmignoreEnabled`<sup>Optional</sup> <a name="npmignoreEnabled" id="@macedon-technologies/batman.BatmanProjectOptions.property.npmignoreEnabled"></a>
 ```typescript
@@ -6783,21 +6844,6 @@ Automatically release to npm when new versions are introduced.
 ---
-##### ~~`releaseWorkflow`~~<sup>Optional</sup> <a name="releaseWorkflow" id="@macedon-technologies/batman.BatmanProjectOptions.property.releaseWorkflow"></a>
-- *Deprecated:* see `release`.
-```typescript
-public readonly releaseWorkflow: boolean;
-```
-- *Type:* boolean
-- *Default:* true if not a subproject
-DEPRECATED: renamed to `release`.
----
 ##### `workflowBootstrapSteps`<sup>Optional</sup> <a name="workflowBootstrapSteps" id="@macedon-technologies/batman.BatmanProjectOptions.property.workflowBootstrapSteps"></a>
 ```typescript
@@ -6874,7 +6920,7 @@ public readonly disableTsconfigDev: boolean;
 - *Type:* boolean
 - *Default:* false
-Do not generate a `tsconfig.dev.json` file.
+Do not generate a development tsconfig file.
 ---
@@ -6981,6 +7027,22 @@ Options for .projenrc.ts.
 ---
+##### `runner`<sup>Optional</sup> <a name="runner" id="@macedon-technologies/batman.BatmanProjectOptions.property.runner"></a>
+```typescript
+public readonly runner: TypeScriptRunner;
+```
+- *Type:* projen.typescript.TypeScriptRunner
+- *Default:* TypeScriptRunner.tsNode()
+The TypeScript runner to use for executing TypeScript files.
+This is a project-level setting that components (e.g. projenrc) will
+use as their default runner.
+---
 ##### `sampleCode`<sup>Optional</sup> <a name="sampleCode" id="@macedon-technologies/batman.BatmanProjectOptions.property.sampleCode"></a>
 ```typescript
@@ -7058,9 +7120,13 @@ public readonly tsconfigDevFile: string;
 ```
 - *Type:* string
-- *Default:* "tsconfig.dev.json"
+- *Default:* "{testdir}/tsconfig.json"
-The name of the development tsconfig.json file.
+The name (and path) of the development tsconfig file.
+By default this lives inside the test directory (e.g. `test/tsconfig.json`)
+so that the TypeScript language service resolves it as the nearest config
+for test files.
 ---
@@ -7107,6 +7173,10 @@ This command will be called when
 running `cdk synth` or when `cdk watch` identifies a change in your source
 code before redeployment.
+The CDK CLI runs it through a shell on every synthesis, on the machine of
+anyone who checks out the project, so shell syntax in it is interpreted and
+the command should be one you would run yourself.
 ---
 ##### `cdkout`<sup>Optional</sup> <a name="cdkout" id="@macedon-technologies/batman.BatmanProjectOptions.property.cdkout"></a>
@@ -7204,39 +7274,6 @@ Minimum version of the AWS CDK to depend on.
 ---
-##### ~~`cdkAssert`~~<sup>Optional</sup> <a name="cdkAssert" id="@macedon-technologies/batman.BatmanProjectOptions.property.cdkAssert"></a>
-- *Deprecated:* The
-```typescript
-public readonly cdkAssert: boolean;
-```
-- *Type:* boolean
-- *Default:* will be included by default for AWS CDK >= 1.0.0 < 2.0.0
-Warning: NodeJS only.
-Install the
----
-##### `cdkAssertions`<sup>Optional</sup> <a name="cdkAssertions" id="@macedon-technologies/batman.BatmanProjectOptions.property.cdkAssertions"></a>
-```typescript
-public readonly cdkAssertions: boolean;
-```
-- *Type:* boolean
-- *Default:* will be included by default for AWS CDK >= 1.111.0 < 2.0.0
-Install the assertions library?
-Only needed for CDK 1.x. If using CDK 2.x then
-assertions is already included in 'aws-cdk-lib'
----
 ##### `cdkCliVersion`<sup>Optional</sup> <a name="cdkCliVersion" id="@macedon-technologies/batman.BatmanProjectOptions.property.cdkCliVersion"></a>
 ```typescript
@@ -7255,56 +7292,6 @@ option to restrict it to a specific version or version range.
 ---
-##### ~~`cdkDependencies`~~<sup>Optional</sup> <a name="cdkDependencies" id="@macedon-technologies/batman.BatmanProjectOptions.property.cdkDependencies"></a>
-- *Deprecated:* For CDK 2.x use "deps" instead. (or "peerDeps" if you're building a library)
-```typescript
-public readonly cdkDependencies: string[];
-```
-- *Type:* string[]
-Which AWS CDKv1 modules this project requires.
----
-##### ~~`cdkDependenciesAsDeps`~~<sup>Optional</sup> <a name="cdkDependenciesAsDeps" id="@macedon-technologies/batman.BatmanProjectOptions.property.cdkDependenciesAsDeps"></a>
-- *Deprecated:* Not supported in CDK v2.
-```typescript
-public readonly cdkDependenciesAsDeps: boolean;
-```
-- *Type:* boolean
-- *Default:* true
-If this is enabled (default), all modules declared in `cdkDependencies` will be also added as normal `dependencies` (as well as `peerDependencies`).
-This is to ensure that downstream consumers actually have your CDK dependencies installed
-when using npm < 7 or yarn, where peer dependencies are not automatically installed.
-If this is disabled, `cdkDependencies` will be added to `devDependencies` to ensure
-they are present during development.
-Note: this setting only applies to construct library projects
----
-##### ~~`cdkTestDependencies`~~<sup>Optional</sup> <a name="cdkTestDependencies" id="@macedon-technologies/batman.BatmanProjectOptions.property.cdkTestDependencies"></a>
-- *Deprecated:* For CDK 2.x use 'devDeps' (in node.js projects) or 'testDeps' (in java projects) instead
-```typescript
-public readonly cdkTestDependencies: string[];
-```
-- *Type:* string[]
-AWS CDK modules required for testing.
----
 ##### `cdkVersionPinning`<sup>Optional</sup> <a name="cdkVersionPinning" id="@macedon-technologies/batman.BatmanProjectOptions.property.cdkVersionPinning"></a>
 ```typescript
@@ -7436,6 +7423,19 @@ Common options for all AWS Lambda functions.
 ---
+##### `singletonLambdaAutoDiscover`<sup>Optional</sup> <a name="singletonLambdaAutoDiscover" id="@macedon-technologies/batman.BatmanProjectOptions.property.singletonLambdaAutoDiscover"></a>
+```typescript
+public readonly singletonLambdaAutoDiscover: boolean;
+```
+- *Type:* boolean
+- *Default:* true
+Automatically adds an `awscdk.SingletonFunction` for each `.singleton-lambda.ts` handler in your source tree. If this is disabled, you can manually add an `awscdk.AutoDiscover` component to your project.
+---
 ##### `dev`<sup>Required</sup> <a name="dev" id="@macedon-technologies/batman.BatmanProjectOptions.property.dev"></a>
 ```typescript
@@ -7555,16 +7555,14 @@ const bootcampProjectOptions: BootcampProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.github">github</a></code> | <code>boolean</code> | Enable GitHub integration. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.githubOptions">githubOptions</a></code> | <code>projen.github.GitHubOptions</code> | Options for GitHub integration. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.gitpod">gitpod</a></code> | <code>boolean</code> | Add a Gitpod development environment. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.mergify">mergify</a></code> | <code>boolean</code> | Whether mergify should be enabled on this repository or not. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.mergifyOptions">mergifyOptions</a></code> | <code>projen.github.MergifyOptions</code> | Options for mergify. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.projectType">projectType</a></code> | <code>projen.ProjectType</code> | Which type of project this is (library/app). |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.projenCredentials">projenCredentials</a></code> | <code>projen.github.GithubCredentials</code> | Choose a method of providing GitHub API access for projen workflows. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.projenTokenSecret">projenTokenSecret</a></code> | <code>string</code> | The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.readme">readme</a></code> | <code>projen.SampleReadmeProps</code> | The README setup. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.stale">stale</a></code> | <code>boolean</code> | Auto-close of stale issues and pull request. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.staleOptions">staleOptions</a></code> | <code>projen.github.StaleOptions</code> | Auto-close stale issues and pull requests. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.vscode">vscode</a></code> | <code>boolean</code> | Enable VSCode integration. |
+| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.addPackageManagerToDevEngines">addPackageManagerToDevEngines</a></code> | <code>boolean</code> | Automatically add the resolved `packageManager` to `devEngines.packageManager` in `package.json`, setting `onFail` to `ignore`. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.allowLibraryDependencies">allowLibraryDependencies</a></code> | <code>boolean</code> | Allow the project to include `peerDependencies` and `bundledDependencies`. |
+| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.allowScripts">allowScripts</a></code> | <code>string[]</code> | List of dependency (package) names that are allowed to run lifecycle install scripts (`preinstall`, `install`, `postinstall`, `prepare`) during dependency installation. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.authorEmail">authorEmail</a></code> | <code>string</code> | Author's e-mail. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.authorName">authorName</a></code> | <code>string</code> | Author's name. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.authorOrganization">authorOrganization</a></code> | <code>boolean</code> | Is the author an organization. |
@@ -7576,9 +7574,12 @@ const bootcampProjectOptions: BootcampProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.bundledDeps">bundledDeps</a></code> | <code>string[]</code> | List of dependencies to bundle into this module. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.bunVersion">bunVersion</a></code> | <code>string</code> | The version of Bun to use if using Bun as a package manager. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.codeArtifactOptions">codeArtifactOptions</a></code> | <code>projen.javascript.CodeArtifactOptions</code> | Options for npm packages using AWS CodeArtifact. |
+| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.dedupeDeps">dedupeDeps</a></code> | <code>boolean</code> | Add a `dedupe` task that deduplicates project dependencies. |
+| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.deleteOrphanedLockFiles">deleteOrphanedLockFiles</a></code> | <code>boolean</code> | Automatically delete lockfiles from package managers that are not the active one. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.deps">deps</a></code> | <code>string[]</code> | Runtime dependencies of this module. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.description">description</a></code> | <code>string</code> | The description is just a string that helps people understand the purpose of the package. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.devDeps">devDeps</a></code> | <code>string[]</code> | Build dependencies for this module. |
+| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.devEngines">devEngines</a></code> | <code>projen.javascript.DevEngines</code> | Configure the `devEngines` field in `package.json`. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.entrypoint">entrypoint</a></code> | <code>string</code> | Module entrypoint (`main` in `package.json`). |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.homepage">homepage</a></code> | <code>string</code> | Package's Homepage / Website. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.keywords">keywords</a></code> | <code>string[]</code> | Keywords to include in `package.json`. |
@@ -7588,7 +7589,6 @@ const bootcampProjectOptions: BootcampProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.minNodeVersion">minNodeVersion</a></code> | <code>string</code> | The minimum node version required by this package to function. Most projects should not use this option. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.npmAccess">npmAccess</a></code> | <code>projen.javascript.NpmAccess</code> | Access level of the npm package. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.npmProvenance">npmProvenance</a></code> | <code>boolean</code> | Should provenance statements be generated when the package is published. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.npmRegistry">npmRegistry</a></code> | <code>string</code> | The host name of the npm registry to publish to. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.npmRegistryUrl">npmRegistryUrl</a></code> | <code>string</code> | The base URL of the npm package registry. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.npmTokenSecret">npmTokenSecret</a></code> | <code>string</code> | GitHub secret which contains the NPM token to use when publishing packages. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.npmTrustedPublishing">npmTrustedPublishing</a></code> | <code>boolean</code> | Use trusted publishing for publishing to npmjs.com Needs to be pre-configured on npm.js to work. |
@@ -7596,11 +7596,11 @@ const bootcampProjectOptions: BootcampProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.packageName">packageName</a></code> | <code>string</code> | The "name" in package.json. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.peerDependencyOptions">peerDependencyOptions</a></code> | <code>projen.javascript.PeerDependencyOptions</code> | Options for `peerDeps`. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.peerDeps">peerDeps</a></code> | <code>string[]</code> | Peer dependencies for this module. |
+| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.pnpmOptions">pnpmOptions</a></code> | <code>projen.javascript.PnpmOptions</code> | Options for pnpm. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.pnpmVersion">pnpmVersion</a></code> | <code>string</code> | The version of PNPM to use if using PNPM as a package manager. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.repository">repository</a></code> | <code>string</code> | The repository is the location where the actual code for your package lives. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.repositoryDirectory">repositoryDirectory</a></code> | <code>string</code> | If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.scopedPackagesOptions">scopedPackagesOptions</a></code> | <code>projen.javascript.ScopedPackagesOptions[]</code> | Options for privately hosted scoped packages. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.scripts">scripts</a></code> | <code>{[ key: string ]: string}</code> | npm scripts to include. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.stability">stability</a></code> | <code>string</code> | Package's Stability. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.yarnBerryOptions">yarnBerryOptions</a></code> | <code>projen.javascript.YarnBerryOptions</code> | Options for Yarn Berry. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.bumpPackage">bumpPackage</a></code> | <code>string</code> | The `commit-and-tag-version` compatible package used to bump the package version, as a dependency string. |
@@ -7616,10 +7616,8 @@ const bootcampProjectOptions: BootcampProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.releasableCommits">releasableCommits</a></code> | <code>projen.ReleasableCommits</code> | Find commits that should be considered releasable Used to decide if a release is required. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.releaseBranches">releaseBranches</a></code> | <code>{[ key: string ]: projen.release.BranchOptions}</code> | Defines additional release branches. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.releaseEnvironment">releaseEnvironment</a></code> | <code>string</code> | The GitHub Actions environment used for the release. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.releaseEveryCommit">releaseEveryCommit</a></code> | <code>boolean</code> | Automatically release new versions every commit to one of branches in `releaseBranches`. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.releaseFailureIssue">releaseFailureIssue</a></code> | <code>boolean</code> | Create a github issue on every failed publishing task. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.releaseFailureIssueLabel">releaseFailureIssueLabel</a></code> | <code>string</code> | The label to apply to issues indicating publish failures. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.releaseSchedule">releaseSchedule</a></code> | <code>string</code> | CRON schedule to trigger new releases. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.releaseTagPrefix">releaseTagPrefix</a></code> | <code>string</code> | Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.releaseTrigger">releaseTrigger</a></code> | <code>projen.release.ReleaseTrigger</code> | The release trigger to use. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.releaseWorkflowEnv">releaseWorkflowEnv</a></code> | <code>{[ key: string ]: string}</code> | Build environment variables for release workflows. |
@@ -7629,7 +7627,6 @@ const bootcampProjectOptions: BootcampProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.workflowContainerImage">workflowContainerImage</a></code> | <code>string</code> | Container image to use for GitHub workflows. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.workflowRunsOn">workflowRunsOn</a></code> | <code>string[]</code> | Github Runner selection labels. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.workflowRunsOnGroup">workflowRunsOnGroup</a></code> | <code>projen.GroupRunnerOptions</code> | Github Runner Group selection options. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.defaultReleaseBranch">defaultReleaseBranch</a></code> | <code>string</code> | The name of the main release branch. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.artifactsDirectory">artifactsDirectory</a></code> | <code>string</code> | A directory which will contain build artifacts. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.auditDeps">auditDeps</a></code> | <code>boolean</code> | Run security audit on dependencies. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.auditDepsOptions">auditDepsOptions</a></code> | <code>projen.javascript.AuditOptions</code> | Security audit options. |
@@ -7638,13 +7635,13 @@ const bootcampProjectOptions: BootcampProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.biomeOptions">biomeOptions</a></code> | <code>projen.javascript.BiomeOptions</code> | Biome options. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.buildWorkflow">buildWorkflow</a></code> | <code>boolean</code> | Define a GitHub workflow for building PRs. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.buildWorkflowOptions">buildWorkflowOptions</a></code> | <code>projen.javascript.BuildWorkflowOptions</code> | Options for PR build workflow. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.buildWorkflowTriggers">buildWorkflowTriggers</a></code> | <code>projen.github.workflows.Triggers</code> | Build workflow triggers. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.bundlerOptions">bundlerOptions</a></code> | <code>projen.javascript.BundlerOptions</code> | Options for `Bundler`. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.checkLicenses">checkLicenses</a></code> | <code>projen.javascript.LicenseCheckerOptions</code> | Configure which licenses should be deemed acceptable for use by dependencies. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.codeCov">codeCov</a></code> | <code>boolean</code> | Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v5 By default, OIDC auth is used. Alternatively a token can be provided via `codeCovTokenSecret`. |
+| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.codeCov">codeCov</a></code> | <code>boolean</code> | Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.codeCovTokenSecret">codeCovTokenSecret</a></code> | <code>string</code> | Define the secret name for a specified https://codecov.io/ token. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.copyrightOwner">copyrightOwner</a></code> | <code>string</code> | License copyright owner. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.copyrightPeriod">copyrightPeriod</a></code> | <code>string</code> | The copyright years to put in the LICENSE file. |
+| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.defaultReleaseBranch">defaultReleaseBranch</a></code> | <code>string</code> | The name of the main release branch. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.dependabot">dependabot</a></code> | <code>boolean</code> | Use dependabot to handle dependency upgrades. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.dependabotOptions">dependabotOptions</a></code> | <code>projen.github.DependabotOptions</code> | Options for dependabot. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.depsUpgrade">depsUpgrade</a></code> | <code>boolean</code> | Use tasks and github workflows to handle dependency upgrades. |
@@ -7652,8 +7649,6 @@ const bootcampProjectOptions: BootcampProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.gitignore">gitignore</a></code> | <code>string[]</code> | Additional entries to .gitignore. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.jest">jest</a></code> | <code>boolean</code> | Setup jest unit tests. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.jestOptions">jestOptions</a></code> | <code>projen.javascript.JestOptions</code> | Jest options. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.mutableBuild">mutableBuild</a></code> | <code>boolean</code> | Automatically update files modified during builds to pull-request branches. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.npmignore">npmignore</a></code> | <code>string[]</code> | Additional entries to .npmignore. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.npmignoreEnabled">npmignoreEnabled</a></code> | <code>boolean</code> | Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.npmIgnoreOptions">npmIgnoreOptions</a></code> | <code>projen.IgnoreFileOptions</code> | Configuration options for .npmignore file. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.package">package</a></code> | <code>boolean</code> | Defines a `package` task that will produce an npm tarball under the artifacts directory (e.g. `dist`). |
@@ -7667,13 +7662,12 @@ const bootcampProjectOptions: BootcampProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.pullRequestTemplateContents">pullRequestTemplateContents</a></code> | <code>string[]</code> | The contents of the pull request template. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.release">release</a></code> | <code>boolean</code> | Add release management to this project. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.releaseToNpm">releaseToNpm</a></code> | <code>boolean</code> | Automatically release to npm when new versions are introduced. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.releaseWorkflow">releaseWorkflow</a></code> | <code>boolean</code> | DEPRECATED: renamed to `release`. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.workflowBootstrapSteps">workflowBootstrapSteps</a></code> | <code>projen.github.workflows.JobStep[]</code> | Workflow steps to use in order to bootstrap this repo. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.workflowGitIdentity">workflowGitIdentity</a></code> | <code>projen.github.GitIdentity</code> | The git identity to use in workflows. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.workflowNodeVersion">workflowNodeVersion</a></code> | <code>string</code> | The node version used in GitHub Actions workflows. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.workflowPackageCache">workflowPackageCache</a></code> | <code>boolean</code> | Enable Node.js package cache in GitHub workflows. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.disableTsconfig">disableTsconfig</a></code> | <code>boolean</code> | Do not generate a `tsconfig.json` file (used by jsii projects since tsconfig.json is generated by the jsii compiler). |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.disableTsconfigDev">disableTsconfigDev</a></code> | <code>boolean</code> | Do not generate a `tsconfig.dev.json` file. |
+| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.disableTsconfigDev">disableTsconfigDev</a></code> | <code>boolean</code> | Do not generate a development tsconfig file. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.docgen">docgen</a></code> | <code>boolean</code> | Docgen by Typedoc. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.docsDirectory">docsDirectory</a></code> | <code>string</code> | Docs directory. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.entrypointTypes">entrypointTypes</a></code> | <code>string</code> | The .d.ts file that includes the type declarations for this module. |
@@ -7682,12 +7676,13 @@ const bootcampProjectOptions: BootcampProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.libdir">libdir</a></code> | <code>string</code> | Typescript  artifacts output directory. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.projenrcTs">projenrcTs</a></code> | <code>boolean</code> | Use TypeScript for your projenrc file (`.projenrc.ts`). |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.projenrcTsOptions">projenrcTsOptions</a></code> | <code>projen.typescript.ProjenrcOptions</code> | Options for .projenrc.ts. |
+| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.runner">runner</a></code> | <code>projen.typescript.TypeScriptRunner</code> | The TypeScript runner to use for executing TypeScript files. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.sampleCode">sampleCode</a></code> | <code>boolean</code> | Generate one-time sample in `src/` and `test/` if there are no files there. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.srcdir">srcdir</a></code> | <code>string</code> | Typescript sources directory. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.testdir">testdir</a></code> | <code>string</code> | Jest tests directory. Tests files should be named `xxx.test.ts`. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.tsconfig">tsconfig</a></code> | <code>projen.javascript.TypescriptConfigOptions</code> | Custom TSConfig. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.tsconfigDev">tsconfigDev</a></code> | <code>projen.javascript.TypescriptConfigOptions</code> | Custom tsconfig options for the development tsconfig.json file (used for testing). |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.tsconfigDevFile">tsconfigDevFile</a></code> | <code>string</code> | The name of the development tsconfig.json file. |
+| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.tsconfigDevFile">tsconfigDevFile</a></code> | <code>string</code> | The name (and path) of the development tsconfig file. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.tsJestOptions">tsJestOptions</a></code> | <code>projen.typescript.TsJestOptions</code> | Options for ts-jest. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.typescriptVersion">typescriptVersion</a></code> | <code>string</code> | TypeScript version to use. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.buildCommand">buildCommand</a></code> | <code>string</code> | A command to execute before synthesis. |
@@ -7698,12 +7693,7 @@ const bootcampProjectOptions: BootcampProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.watchExcludes">watchExcludes</a></code> | <code>string[]</code> | Glob patterns to exclude from `cdk watch`. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.watchIncludes">watchIncludes</a></code> | <code>string[]</code> | Glob patterns to include in `cdk watch`. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.cdkVersion">cdkVersion</a></code> | <code>string</code> | Minimum version of the AWS CDK to depend on. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.cdkAssert">cdkAssert</a></code> | <code>boolean</code> | Warning: NodeJS only. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.cdkAssertions">cdkAssertions</a></code> | <code>boolean</code> | Install the assertions library? |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.cdkCliVersion">cdkCliVersion</a></code> | <code>string</code> | Version range of the AWS CDK CLI to depend on. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.cdkDependencies">cdkDependencies</a></code> | <code>string[]</code> | Which AWS CDKv1 modules this project requires. |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.cdkDependenciesAsDeps">cdkDependenciesAsDeps</a></code> | <code>boolean</code> | If this is enabled (default), all modules declared in `cdkDependencies` will be also added as normal `dependencies` (as well as `peerDependencies`). |
-| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.cdkTestDependencies">cdkTestDependencies</a></code> | <code>string[]</code> | AWS CDK modules required for testing. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.cdkVersionPinning">cdkVersionPinning</a></code> | <code>boolean</code> | Use pinned version instead of caret version for CDK. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.constructsVersion">constructsVersion</a></code> | <code>string</code> | Minimum version of the `constructs` library to depend on. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.app">app</a></code> | <code>string</code> | The command line to execute in order to synthesize the CDK application (language specific). |
@@ -7714,6 +7704,7 @@ const bootcampProjectOptions: BootcampProjectOptions = { ... }
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.lambdaAutoDiscover">lambdaAutoDiscover</a></code> | <code>boolean</code> | Automatically adds an `awscdk.LambdaFunction` for each `.lambda.ts` handler in your source tree. If this is disabled, you can manually add an `awscdk.AutoDiscover` component to your project. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.lambdaExtensionAutoDiscover">lambdaExtensionAutoDiscover</a></code> | <code>boolean</code> | Automatically adds an `awscdk.LambdaExtension` for each `.lambda-extension.ts` entrypoint in your source tree. If this is disabled, you can manually add an `awscdk.AutoDiscover` component to your project. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.lambdaOptions">lambdaOptions</a></code> | <code>projen.awscdk.LambdaFunctionCommonOptions</code> | Common options for all AWS Lambda functions. |
+| <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.singletonLambdaAutoDiscover">singletonLambdaAutoDiscover</a></code> | <code>boolean</code> | Automatically adds an `awscdk.SingletonFunction` for each `.singleton-lambda.ts` handler in your source tree. If this is disabled, you can manually add an `awscdk.AutoDiscover` component to your project. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.dev">dev</a></code> | <code><a href="#@macedon-technologies/batman.ApplicationEnvironmentConfig">ApplicationEnvironmentConfig</a></code> | Development environment configuration. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.prod">prod</a></code> | <code><a href="#@macedon-technologies/batman.ApplicationEnvironmentConfig">ApplicationEnvironmentConfig</a></code> | Production environment configuration. |
 | <code><a href="#@macedon-technologies/batman.BootcampProjectOptions.property.staging">staging</a></code> | <code><a href="#@macedon-technologies/batman.ApplicationEnvironmentConfig">ApplicationEnvironmentConfig</a></code> | Development environment configuration. |
@@ -7842,6 +7833,10 @@ public readonly projenCommand: string;
 The shell command to use in order to run the projen CLI.
+Inserted verbatim into task steps, workflows and IDE configuration, and run
+by each of their shells - locally, in CI and in dev containers. Keep it a
+plain unquoted command, since shell syntax in it executes in all of them.
 Can be used to customize in special environments.
 ---
@@ -8010,51 +8005,6 @@ Add a Gitpod development environment.
 ---
-##### ~~`mergify`~~<sup>Optional</sup> <a name="mergify" id="@macedon-technologies/batman.BootcampProjectOptions.property.mergify"></a>
-- *Deprecated:* use `githubOptions.mergify` instead
-```typescript
-public readonly mergify: boolean;
-```
-- *Type:* boolean
-- *Default:* true
-Whether mergify should be enabled on this repository or not.
----
-##### ~~`mergifyOptions`~~<sup>Optional</sup> <a name="mergifyOptions" id="@macedon-technologies/batman.BootcampProjectOptions.property.mergifyOptions"></a>
-- *Deprecated:* use `githubOptions.mergifyOptions` instead
-```typescript
-public readonly mergifyOptions: MergifyOptions;
-```
-- *Type:* projen.github.MergifyOptions
-- *Default:* default options
-Options for mergify.
----
-##### ~~`projectType`~~<sup>Optional</sup> <a name="projectType" id="@macedon-technologies/batman.BootcampProjectOptions.property.projectType"></a>
-- *Deprecated:* no longer supported at the base project level
-```typescript
-public readonly projectType: ProjectType;
-```
-- *Type:* projen.ProjectType
-- *Default:* ProjectType.UNKNOWN
-Which type of project this is (library/app).
----
 ##### `projenCredentials`<sup>Optional</sup> <a name="projenCredentials" id="@macedon-technologies/batman.BootcampProjectOptions.property.projenCredentials"></a>
 ```typescript
@@ -8062,27 +8012,9 @@ public readonly projenCredentials: GithubCredentials;
 ```
 - *Type:* projen.github.GithubCredentials
-- *Default:* use a personal access token named PROJEN_GITHUB_TOKEN
-Choose a method of providing GitHub API access for projen workflows.
----
-##### ~~`projenTokenSecret`~~<sup>Optional</sup> <a name="projenTokenSecret" id="@macedon-technologies/batman.BootcampProjectOptions.property.projenTokenSecret"></a>
-- *Deprecated:* use `projenCredentials`
-```typescript
-public readonly projenTokenSecret: string;
-```
-- *Type:* string
-- *Default:* "PROJEN_GITHUB_TOKEN"
-The name of a secret which includes a GitHub Personal Access Token to be used by projen workflows.
+- *Default:* use a personal access token named PROJEN_GITHUB_TOKEN
-This token needs to have the `repo`, `workflows`
-and `packages` scope.
+Choose a method of providing GitHub API access for projen workflows.
 ---
@@ -8151,6 +8083,19 @@ Enabled by default for root projects. Disabled for non-root projects.
 ---
+##### `addPackageManagerToDevEngines`<sup>Optional</sup> <a name="addPackageManagerToDevEngines" id="@macedon-technologies/batman.BootcampProjectOptions.property.addPackageManagerToDevEngines"></a>
+```typescript
+public readonly addPackageManagerToDevEngines: boolean;
+```
+- *Type:* boolean
+- *Default:* true
+Automatically add the resolved `packageManager` to `devEngines.packageManager` in `package.json`, setting `onFail` to `ignore`.
+---
 ##### `allowLibraryDependencies`<sup>Optional</sup> <a name="allowLibraryDependencies" id="@macedon-technologies/batman.BootcampProjectOptions.property.allowLibraryDependencies"></a>
 ```typescript
@@ -8167,6 +8112,44 @@ for specifying these.
 ---
+##### `allowScripts`<sup>Optional</sup> <a name="allowScripts" id="@macedon-technologies/batman.BootcampProjectOptions.property.allowScripts"></a>
+```typescript
+public readonly allowScripts: string[];
+```
+- *Type:* string[]
+- *Default:* all install scripts are allowed to run (package manager default)
+List of dependency (package) names that are allowed to run lifecycle install scripts (`preinstall`, `install`, `postinstall`, `prepare`) during dependency installation.
+These scripts can execute arbitrary code, making them a common
+supply-chain attack vector. Package managers are moving toward
+blocking them by default and requiring an explicit allowlist.
+Configuring `allowScripts` sets up that allowlist so scripts only run
+for the packages you have explicitly reviewed and trust.
+Support for this setting depends on the configured `packageManager`:
+- `NPM`: written to the native `allowScripts` field in `package.json`
+  (requires npm >= 11.16; see https://docs.npmjs.com/cli/v11/commands/npm-approve-scripts).
+- `BUN`: written to the native `trustedDependencies` field in
+  `package.json` (see https://bun.com/docs/pm/lifecycle).
+- `PNPM`: written to the `onlyBuiltDependencies` setting in
+  `pnpm-workspace.yaml` (see https://pnpm.io/settings#onlybuiltdependencies).
+- `YARN2`, `YARN_BERRY`: written to the native
+  `dependenciesMeta.<pkg>.built` allowlist in `package.json`, combined
+  with `enableScripts: false` in `.yarnrc.yml` (see
+  https://yarnpkg.com/features/security#postinstalls). If you set
+  `yarnBerryOptions.yarnRcOptions.enableScripts` explicitly, that value
+  is respected instead of being overridden.
+- `YARN`, `YARN_CLASSIC`: not supported. Yarn Classic has no native
+  mechanism to allowlist install scripts for specific dependencies.
+  Setting this option with one of these package managers throws an
+  error at synthesis time.
+---
 ##### `authorEmail`<sup>Optional</sup> <a name="authorEmail" id="@macedon-technologies/batman.BootcampProjectOptions.property.authorEmail"></a>
 ```typescript
@@ -8283,11 +8266,11 @@ added both to the `dependencies` section and `bundledDependencies` section of
 your `package.json`.
 The recommendation is to only specify the module name here (e.g.
-`express`). This will behave similar to `yarn add` or `npm install` in the
+`express`). This will behave similar to `pnpm add` or `npm install` in the
 sense that it will add the module as a dependency to your `package.json`
 file with the latest version (`^`). You can specify semver requirements in
-the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and
-this will be what you `package.json` will eventually include.
+the same syntax passed to `pnpm add` or `npm i` (e.g. `express@^2`) and
+this will be what your `package.json` will eventually include.
 ---
@@ -8319,6 +8302,52 @@ This is required if publishing packages to, or installing scoped packages from A
 ---
+##### `dedupeDeps`<sup>Optional</sup> <a name="dedupeDeps" id="@macedon-technologies/batman.BootcampProjectOptions.property.dedupeDeps"></a>
+```typescript
+public readonly dedupeDeps: boolean;
+```
+- *Type:* boolean
+- *Default:* false, unless `yarnBerryOptions.dedupePackages` is set
+Add a `dedupe` task that deduplicates project dependencies.
+Deduplication prevents multiple versions of the same package from being
+installed, if a single version can satisfy all requested version ranges.
+This prevents version proliferation and reduces the size of the dependency
+tree.
+The behavior depends on the package manager:
+- npm: runs `npm dedupe` after every mutating install.
+- pnpm: runs `pnpm dedupe` after every mutating install.
+- Yarn Berry: runs `yarn dedupe` after every mutating install. If
+  `yarnBerryOptions.dedupePackages` is set, only the listed packages are
+  deduplicated.
+- Yarn Classic: `yarn install` already deduplicates, so the task only
+  prints an informational message.
+- Bun: not supported, enabling this option throws an error.
+---
+##### `deleteOrphanedLockFiles`<sup>Optional</sup> <a name="deleteOrphanedLockFiles" id="@macedon-technologies/batman.BootcampProjectOptions.property.deleteOrphanedLockFiles"></a>
+```typescript
+public readonly deleteOrphanedLockFiles: boolean;
+```
+- *Type:* boolean
+- *Default:* true
+Automatically delete lockfiles from package managers that are not the active one.
+Only triggered when the lockfile for the configured package
+manager already exists.
+This is useful when migrating between package managers to avoid conflicts.
+---
 ##### `deps`<sup>Optional</sup> <a name="deps" id="@macedon-technologies/batman.BootcampProjectOptions.property.deps"></a>
 ```typescript
@@ -8331,11 +8360,11 @@ public readonly deps: string[];
 Runtime dependencies of this module.
 The recommendation is to only specify the module name here (e.g.
-`express`). This will behave similar to `yarn add` or `npm install` in the
+`express`). This will behave similar to `pnpm add` or `npm install` in the
 sense that it will add the module as a dependency to your `package.json`
 file with the latest version (`^`). You can specify semver requirements in
-the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and
-this will be what you `package.json` will eventually include.
+the same syntax passed to `pnpm add` or `npm i` (e.g. `express@^2`) and
+this will be what your `package.json` will eventually include.
 ---
@@ -8377,11 +8406,11 @@ available in your build environment but will not be fetched when this
 module is consumed.
 The recommendation is to only specify the module name here (e.g.
-`express`). This will behave similar to `yarn add` or `npm install` in the
+`express`). This will behave similar to `pnpm add` or `npm install` in the
 sense that it will add the module as a dependency to your `package.json`
 file with the latest version (`^`). You can specify semver requirements in
-the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and
-this will be what you `package.json` will eventually include.
+the same syntax passed to `pnpm add` or `npm i` (e.g. `express@^2`) and
+this will be what your `package.json` will eventually include.
 ---
@@ -8392,6 +8421,24 @@ this will be what you `package.json` will eventually include.
 ```
+##### `devEngines`<sup>Optional</sup> <a name="devEngines" id="@macedon-technologies/batman.BootcampProjectOptions.property.devEngines"></a>
+```typescript
+public readonly devEngines: DevEngines;
+```
+- *Type:* projen.javascript.DevEngines
+Configure the `devEngines` field in `package.json`.
+The `devEngines.packageManager` field is automatically populated based on
+the resolved `packageManager` value. Any fields provided here are merged
+with the auto-populated `packageManager` entry.
+> [https://docs.npmjs.com/cli/v10/configuring-npm/package-json#devengines](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#devengines)
+---
 ##### `entrypoint`<sup>Optional</sup> <a name="entrypoint" id="@macedon-technologies/batman.BootcampProjectOptions.property.entrypoint"></a>
 ```typescript
@@ -8536,22 +8583,6 @@ which is using npm internally and supports provenance statements independently o
 ---
-##### ~~`npmRegistry`~~<sup>Optional</sup> <a name="npmRegistry" id="@macedon-technologies/batman.BootcampProjectOptions.property.npmRegistry"></a>
-- *Deprecated:* use `npmRegistryUrl` instead
-```typescript
-public readonly npmRegistry: string;
-```
-- *Type:* string
-The host name of the npm registry to publish to.
-Cannot be set together with `npmRegistryUrl`.
----
 ##### `npmRegistryUrl`<sup>Optional</sup> <a name="npmRegistryUrl" id="@macedon-technologies/batman.BootcampProjectOptions.property.npmRegistryUrl"></a>
 ```typescript
@@ -8600,7 +8631,7 @@ public readonly packageManager: NodePackageManager;
 ```
 - *Type:* projen.javascript.NodePackageManager
-- *Default:* NodePackageManager.YARN_CLASSIC
+- *Default:* Detected from the calling process or `YARN_CLASSIC` if detection fails.
 The Node Package Manager used to execute scripts.
@@ -8658,6 +8689,19 @@ test your module against the lowest peer version required.
 ---
+##### `pnpmOptions`<sup>Optional</sup> <a name="pnpmOptions" id="@macedon-technologies/batman.BootcampProjectOptions.property.pnpmOptions"></a>
+```typescript
+public readonly pnpmOptions: PnpmOptions;
+```
+- *Type:* projen.javascript.PnpmOptions
+- *Default:* all default options
+Options for pnpm.
+---
 ##### `pnpmVersion`<sup>Optional</sup> <a name="pnpmVersion" id="@macedon-technologies/batman.BootcampProjectOptions.property.pnpmVersion"></a>
 ```typescript
@@ -8665,7 +8709,7 @@ public readonly pnpmVersion: string;
 ```
 - *Type:* string
-- *Default:* "9"
+- *Default:* "10.33.0"
 The version of PNPM to use if using PNPM as a package manager.
@@ -8710,25 +8754,6 @@ Options for privately hosted scoped packages.
 ---
-##### ~~`scripts`~~<sup>Optional</sup> <a name="scripts" id="@macedon-technologies/batman.BootcampProjectOptions.property.scripts"></a>
-- *Deprecated:* use `project.addTask()` or `package.setScript()`
-```typescript
-public readonly scripts: {[ key: string ]: string};
-```
-- *Type:* {[ key: string ]: string}
-- *Default:* {}
-npm scripts to include.
-If a script has the same name as a standard script,
-the standard script will be overwritten.
-Also adds the script as a task.
----
 ##### `stability`<sup>Optional</sup> <a name="stability" id="@macedon-technologies/batman.BootcampProjectOptions.property.stability"></a>
 ```typescript
@@ -8971,21 +8996,6 @@ on a per artifact basis.
 ---
-##### ~~`releaseEveryCommit`~~<sup>Optional</sup> <a name="releaseEveryCommit" id="@macedon-technologies/batman.BootcampProjectOptions.property.releaseEveryCommit"></a>
-- *Deprecated:* Use `releaseTrigger: ReleaseTrigger.continuous()` instead
-```typescript
-public readonly releaseEveryCommit: boolean;
-```
-- *Type:* boolean
-- *Default:* true
-Automatically release new versions every commit to one of branches in `releaseBranches`.
----
 ##### `releaseFailureIssue`<sup>Optional</sup> <a name="releaseFailureIssue" id="@macedon-technologies/batman.BootcampProjectOptions.property.releaseFailureIssue"></a>
 ```typescript
@@ -9014,21 +9024,6 @@ Only applies if `releaseFailureIssue` is true.
 ---
-##### ~~`releaseSchedule`~~<sup>Optional</sup> <a name="releaseSchedule" id="@macedon-technologies/batman.BootcampProjectOptions.property.releaseSchedule"></a>
-- *Deprecated:* Use `releaseTrigger: ReleaseTrigger.scheduled()` instead
-```typescript
-public readonly releaseSchedule: string;
-```
-- *Type:* string
-- *Default:* no scheduled releases
-CRON schedule to trigger new releases.
----
 ##### `releaseTagPrefix`<sup>Optional</sup> <a name="releaseTagPrefix" id="@macedon-technologies/batman.BootcampProjectOptions.property.releaseTagPrefix"></a>
 ```typescript
@@ -9126,7 +9121,9 @@ Container image to use for GitHub workflows.
 ---
-##### `workflowRunsOn`<sup>Optional</sup> <a name="workflowRunsOn" id="@macedon-technologies/batman.BootcampProjectOptions.property.workflowRunsOn"></a>
+##### ~~`workflowRunsOn`~~<sup>Optional</sup> <a name="workflowRunsOn" id="@macedon-technologies/batman.BootcampProjectOptions.property.workflowRunsOn"></a>
+- *Deprecated:* use `githubOptions.workflowRunsOn` on the project, or `runsOn` on `ReleaseOptions`
 ```typescript
 public readonly workflowRunsOn: string[];
@@ -9139,7 +9136,9 @@ Github Runner selection labels.
 ---
-##### `workflowRunsOnGroup`<sup>Optional</sup> <a name="workflowRunsOnGroup" id="@macedon-technologies/batman.BootcampProjectOptions.property.workflowRunsOnGroup"></a>
+##### ~~`workflowRunsOnGroup`~~<sup>Optional</sup> <a name="workflowRunsOnGroup" id="@macedon-technologies/batman.BootcampProjectOptions.property.workflowRunsOnGroup"></a>
+- *Deprecated:* use `githubOptions.workflowRunsOnGroup` on the project, or `runsOnGroup` on `ReleaseOptions`
 ```typescript
 public readonly workflowRunsOnGroup: GroupRunnerOptions;
@@ -9151,19 +9150,6 @@ Github Runner Group selection options.
 ---
-##### `defaultReleaseBranch`<sup>Required</sup> <a name="defaultReleaseBranch" id="@macedon-technologies/batman.BootcampProjectOptions.property.defaultReleaseBranch"></a>
-```typescript
-public readonly defaultReleaseBranch: string;
-```
-- *Type:* string
-- *Default:* "main"
-The name of the main release branch.
----
 ##### `artifactsDirectory`<sup>Optional</sup> <a name="artifactsDirectory" id="@macedon-technologies/batman.BootcampProjectOptions.property.artifactsDirectory"></a>
 ```typescript
@@ -9273,21 +9259,6 @@ Options for PR build workflow.
 ---
-##### ~~`buildWorkflowTriggers`~~<sup>Optional</sup> <a name="buildWorkflowTriggers" id="@macedon-technologies/batman.BootcampProjectOptions.property.buildWorkflowTriggers"></a>
-- *Deprecated:* - Use `buildWorkflowOptions.workflowTriggers`
-```typescript
-public readonly buildWorkflowTriggers: Triggers;
-```
-- *Type:* projen.github.workflows.Triggers
-- *Default:* "{ pullRequest: {}, workflowDispatch: {} }"
-Build workflow triggers.
----
 ##### `bundlerOptions`<sup>Optional</sup> <a name="bundlerOptions" id="@macedon-technologies/batman.BootcampProjectOptions.property.bundlerOptions"></a>
 ```typescript
@@ -9324,7 +9295,10 @@ public readonly codeCov: boolean;
 - *Type:* boolean
 - *Default:* false
-Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v5 By default, OIDC auth is used. Alternatively a token can be provided via `codeCovTokenSecret`.
+Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/.
+Uses codecov/codecov-action. By default, OIDC auth is used.
+Alternatively a token can be provided via `codeCovTokenSecret`.
 ---
@@ -9352,6 +9326,10 @@ public readonly copyrightOwner: string;
 License copyright owner.
+This value is only used if the selected license text contains the
+`$copyright_owner` placeholder. For example, it has no effect on the
+MPL-2.0 license text.
 ---
 ##### `copyrightPeriod`<sup>Optional</sup> <a name="copyrightPeriod" id="@macedon-technologies/batman.BootcampProjectOptions.property.copyrightPeriod"></a>
@@ -9365,6 +9343,23 @@ public readonly copyrightPeriod: string;
 The copyright years to put in the LICENSE file.
+This value is only used if the selected license text contains the
+`$copyright_period` placeholder. For example, it has no effect on the
+MPL-2.0 license text.
+---
+##### `defaultReleaseBranch`<sup>Optional</sup> <a name="defaultReleaseBranch" id="@macedon-technologies/batman.BootcampProjectOptions.property.defaultReleaseBranch"></a>
+```typescript
+public readonly defaultReleaseBranch: string;
+```
+- *Type:* string
+- *Default:* "main"
+The name of the main release branch.
 ---
 ##### `dependabot`<sup>Optional</sup> <a name="dependabot" id="@macedon-technologies/batman.BootcampProjectOptions.property.dependabot"></a>
@@ -9461,41 +9456,6 @@ Jest options.
 ---
-##### ~~`mutableBuild`~~<sup>Optional</sup> <a name="mutableBuild" id="@macedon-technologies/batman.BootcampProjectOptions.property.mutableBuild"></a>
-- *Deprecated:* - Use `buildWorkflowOptions.mutableBuild`
-```typescript
-public readonly mutableBuild: boolean;
-```
-- *Type:* boolean
-- *Default:* true
-Automatically update files modified during builds to pull-request branches.
-This means
-that any files synthesized by projen or e.g. test snapshots will always be up-to-date
-before a PR is merged.
-Implies that PR builds do not have anti-tamper checks.
----
-##### ~~`npmignore`~~<sup>Optional</sup> <a name="npmignore" id="@macedon-technologies/batman.BootcampProjectOptions.property.npmignore"></a>
-- *Deprecated:* - use `project.addPackageIgnore`
-```typescript
-public readonly npmignore: string[];
-```
-- *Type:* string[]
-Additional entries to .npmignore.
----
 ##### `npmignoreEnabled`<sup>Optional</sup> <a name="npmignoreEnabled" id="@macedon-technologies/batman.BootcampProjectOptions.property.npmignoreEnabled"></a>
 ```typescript
@@ -9664,21 +9624,6 @@ Automatically release to npm when new versions are introduced.
 ---
-##### ~~`releaseWorkflow`~~<sup>Optional</sup> <a name="releaseWorkflow" id="@macedon-technologies/batman.BootcampProjectOptions.property.releaseWorkflow"></a>
-- *Deprecated:* see `release`.
-```typescript
-public readonly releaseWorkflow: boolean;
-```
-- *Type:* boolean
-- *Default:* true if not a subproject
-DEPRECATED: renamed to `release`.
----
 ##### `workflowBootstrapSteps`<sup>Optional</sup> <a name="workflowBootstrapSteps" id="@macedon-technologies/batman.BootcampProjectOptions.property.workflowBootstrapSteps"></a>
 ```typescript
@@ -9755,7 +9700,7 @@ public readonly disableTsconfigDev: boolean;
 - *Type:* boolean
 - *Default:* false
-Do not generate a `tsconfig.dev.json` file.
+Do not generate a development tsconfig file.
 ---
@@ -9862,6 +9807,22 @@ Options for .projenrc.ts.
 ---
+##### `runner`<sup>Optional</sup> <a name="runner" id="@macedon-technologies/batman.BootcampProjectOptions.property.runner"></a>
+```typescript
+public readonly runner: TypeScriptRunner;
+```
+- *Type:* projen.typescript.TypeScriptRunner
+- *Default:* TypeScriptRunner.tsNode()
+The TypeScript runner to use for executing TypeScript files.
+This is a project-level setting that components (e.g. projenrc) will
+use as their default runner.
+---
 ##### `sampleCode`<sup>Optional</sup> <a name="sampleCode" id="@macedon-technologies/batman.BootcampProjectOptions.property.sampleCode"></a>
 ```typescript
@@ -9939,9 +9900,13 @@ public readonly tsconfigDevFile: string;
 ```
 - *Type:* string
-- *Default:* "tsconfig.dev.json"
+- *Default:* "{testdir}/tsconfig.json"
-The name of the development tsconfig.json file.
+The name (and path) of the development tsconfig file.
+By default this lives inside the test directory (e.g. `test/tsconfig.json`)
+so that the TypeScript language service resolves it as the nearest config
+for test files.
 ---
@@ -9988,6 +9953,10 @@ This command will be called when
 running `cdk synth` or when `cdk watch` identifies a change in your source
 code before redeployment.
+The CDK CLI runs it through a shell on every synthesis, on the machine of
+anyone who checks out the project, so shell syntax in it is interpreted and
+the command should be one you would run yourself.
 ---
 ##### `cdkout`<sup>Optional</sup> <a name="cdkout" id="@macedon-technologies/batman.BootcampProjectOptions.property.cdkout"></a>
@@ -10085,39 +10054,6 @@ Minimum version of the AWS CDK to depend on.
 ---
-##### ~~`cdkAssert`~~<sup>Optional</sup> <a name="cdkAssert" id="@macedon-technologies/batman.BootcampProjectOptions.property.cdkAssert"></a>
-- *Deprecated:* The
-```typescript
-public readonly cdkAssert: boolean;
-```
-- *Type:* boolean
-- *Default:* will be included by default for AWS CDK >= 1.0.0 < 2.0.0
-Warning: NodeJS only.
-Install the
----
-##### `cdkAssertions`<sup>Optional</sup> <a name="cdkAssertions" id="@macedon-technologies/batman.BootcampProjectOptions.property.cdkAssertions"></a>
-```typescript
-public readonly cdkAssertions: boolean;
-```
-- *Type:* boolean
-- *Default:* will be included by default for AWS CDK >= 1.111.0 < 2.0.0
-Install the assertions library?
-Only needed for CDK 1.x. If using CDK 2.x then
-assertions is already included in 'aws-cdk-lib'
----
 ##### `cdkCliVersion`<sup>Optional</sup> <a name="cdkCliVersion" id="@macedon-technologies/batman.BootcampProjectOptions.property.cdkCliVersion"></a>
 ```typescript
@@ -10136,56 +10072,6 @@ option to restrict it to a specific version or version range.
 ---
-##### ~~`cdkDependencies`~~<sup>Optional</sup> <a name="cdkDependencies" id="@macedon-technologies/batman.BootcampProjectOptions.property.cdkDependencies"></a>
-- *Deprecated:* For CDK 2.x use "deps" instead. (or "peerDeps" if you're building a library)
-```typescript
-public readonly cdkDependencies: string[];
-```
-- *Type:* string[]
-Which AWS CDKv1 modules this project requires.
----
-##### ~~`cdkDependenciesAsDeps`~~<sup>Optional</sup> <a name="cdkDependenciesAsDeps" id="@macedon-technologies/batman.BootcampProjectOptions.property.cdkDependenciesAsDeps"></a>
-- *Deprecated:* Not supported in CDK v2.
-```typescript
-public readonly cdkDependenciesAsDeps: boolean;
-```
-- *Type:* boolean
-- *Default:* true
-If this is enabled (default), all modules declared in `cdkDependencies` will be also added as normal `dependencies` (as well as `peerDependencies`).
-This is to ensure that downstream consumers actually have your CDK dependencies installed
-when using npm < 7 or yarn, where peer dependencies are not automatically installed.
-If this is disabled, `cdkDependencies` will be added to `devDependencies` to ensure
-they are present during development.
-Note: this setting only applies to construct library projects
----
-##### ~~`cdkTestDependencies`~~<sup>Optional</sup> <a name="cdkTestDependencies" id="@macedon-technologies/batman.BootcampProjectOptions.property.cdkTestDependencies"></a>
-- *Deprecated:* For CDK 2.x use 'devDeps' (in node.js projects) or 'testDeps' (in java projects) instead
-```typescript
-public readonly cdkTestDependencies: string[];
-```
-- *Type:* string[]
-AWS CDK modules required for testing.
----
 ##### `cdkVersionPinning`<sup>Optional</sup> <a name="cdkVersionPinning" id="@macedon-technologies/batman.BootcampProjectOptions.property.cdkVersionPinning"></a>
 ```typescript
@@ -10317,6 +10203,19 @@ Common options for all AWS Lambda functions.
 ---
+##### `singletonLambdaAutoDiscover`<sup>Optional</sup> <a name="singletonLambdaAutoDiscover" id="@macedon-technologies/batman.BootcampProjectOptions.property.singletonLambdaAutoDiscover"></a>
+```typescript
+public readonly singletonLambdaAutoDiscover: boolean;
+```
+- *Type:* boolean
+- *Default:* true
+Automatically adds an `awscdk.SingletonFunction` for each `.singleton-lambda.ts` handler in your source tree. If this is disabled, you can manually add an `awscdk.AutoDiscover` component to your project.
+---
 ##### `dev`<sup>Required</sup> <a name="dev" id="@macedon-technologies/batman.BootcampProjectOptions.property.dev"></a>
 ```typescript