cdklabs-projen-project-types 0.4.0 → 0.5.0

package/.jsii

@@ -12,7 +12,7 @@
   },
   "dependencies": {
     "constructs": "^10.0.0",
-    "projen": ">=0.99.48 <1.0.0"
+    "projen": ">=0.99.68 <1.0.0"
   },
   "dependencyClosure": {
     "constructs": {
@@ -99,7 +99,7 @@
   },
   "name": "cdklabs-projen-project-types",
   "readme": {
-    "markdown": "# Cdklabs Projen Project Types\n\nThis repository stores custom project types extended from `projen` with cdklabs defaults\nbaked in. This is meant to serve as a hook for continuous management of all repos we own.\nWith cdklabs projen types, we can add new configuration as they come up and have it\npropagate to all repositories using the type.\n\n## CdklabsConstructLibrary\n\nThis type extends projen's `awscdk.AwsConstructLibrary` project type and should be used in place\nof that type.\n\n### Usage\n\nFrom the command line:\n\n```bash\nnpx projen new --from cdklabs-projen-project-types cdklabs-construct-lib\n```\n\nFrom inside `cdk-ops`:\n\n```ts\nthis.cdklabs.addPreApprovedRepo({\n  repo: 'cdk-new-lib',\n  owner: 'conroyka@amazon.com',\n  createWith: {\n    projectType: ProjectType.CDKLABS_MANAGED_CONSTRUCT_LIB,\n  },\n});\n```\n\n### Features\n\n- `cdklabsPublishingDefaults`\n\nBy default, this is turned on. `cdklabsPublishingDefaults` provides publishing defaults based off\nof the project's name. Specifically, the defaults look like this:\n\n```ts\nreturn {\n  publishToPypi: {\n    distName: npmPackageName,\n    module: changeDelimiter(npmPackageName, '_'),\n  },\n  publishToMaven: {\n    javaPackage: `io.github.cdklabs.${changeDelimiter(npmPackageName, '.')}`,\n    mavenGroupId: 'io.github.cdklabs',\n    mavenArtifactId: npmPackageName,\n    mavenEndpoint: 'https://s01.oss.sonatype.org',\n  },\n  publishToNuget: {\n    dotNetNamespace: `Cdklabs${upperCaseName(npmPackageName)}`,\n    packageId: `Cdklabs${upperCaseName(npmPackageName)}`,\n  },\n  publishToGo: {\n    moduleName: `${npmPackageName}-go`,\n  },\n};\n```\n\nAdditionally, we also require that we publish to all jsii language targets (including go) when\nwe specify a library as `stable`.\n\n- `private`\n\nBy default, a project is created as `private`. Turning this off simply means setting `private: false`.\nA project being `private` means it gets certain properties set as default that are true for private\nprojects. Today, that means setting `private: true` in `package.json`, removing `.mergify.yml` from\nthe project, and removing `.npmignore`.\n\n- `releasableCommits`\n\nBy default this project type releases `ReleasableCommits.featuresAndFixes`, to not release a new\nversion every day on a package that only sees devDependency updates. You may want to override this\nif you need something more specific.\n\n## CdklabsTypeScriptProject\n\nThis type extends projen's `typescript.TypeScriptProject` project type and should be used in place\nof that type.\n\n### Usage\n\n```bash\nnpx projen new --from cdklabs-projen-project-types cdklabs-ts-proj\n```\n\nFrom inside `cdk-ops`:\n\n```ts\nthis.cdklabs.addPreApprovedRepo({\n  repo: 'cdk-new-lib',\n  owner: 'conroyka@amazon.com',\n  createWith: {\n    projectType: ProjectType.CDKLABS_MANAGED_TS_PROJECT,\n  },\n});\n```\n\n### Features\n\n- `private`\n\nBy default, a project is created as `private`. Turning this off simply means setting `private: false`.\nA project being `private` means it gets certain properties set as default that are true for private\nprojects. Today, that means setting `private: true` in `package.json`, removing `.mergify.yml` from\nthe project, and removing `.npmignore`.\n\n## CdklabsMonorepo\n\nA TypeScript monorepo using Yarn Workspaces.\nIndividual workspaces can be added with `yarn.TypeScriptWorkspace` which extends projen's `typescript.TypeScriptProject`.\n\n### Usage\n\n```bash\nnpx projen new --from cdklabs-projen-project-types cdklabs-yarn-monorepo\n```\n\n### Features\n\n```ts\nconst project = new yarn.CdkLabsMonorepo({\n  defaultReleaseBranch: \"main\",\n  devDeps: [\"cdklabs-projen-project-types\"],\n  name: \"monorepo\",\n});\n```\n\n- Workspace commands: `projen build|compile|package|test|upgrade`\\\nWill run the specific command in all workspaces and the root if applicable.\n\n- Workspace run: `projen run <command>`\\\nExecutes the given command in all workspaces\n\n- Automatic dependency installation\\\nThe monorepo will know if a dependency has been added for a workspace and run `yarn install` as part of `projen`\n\n- `projen` at any level\\\nThe default `projen` command can be run in any workspace and will execute the monorepo synth command.\n\n- Release\\\nThis feature is not supported at this time.\nAny release functionality must be implemented.\n\n- `vscodeWorkspace: boolean`\\\nYou can specify if a VSCode Workspace file should be created for the monorepo.\n\n#### Workspaces\n\n```ts\nnew yarn.TypeScriptWorkspace({\n  parent: project,\n  name: 'workspace'\n})\n```\n\n- `parent: yarn.Monorepo`\\\nWorkspaces (aka subprojects) must be added using the `parent` option.\n\n- `workspaceScope: string`\\\nThe location the workspace is placed at. Defaults to `./packages`\n\n- `excludeDepsFromUpgrade: Array<string>`\\\nList any dependencies that should not be updated in the workspace.\n\n\n"
+    "markdown": "# Cdklabs Projen Project Types\n\nThis repository stores custom project types extended from `projen` with cdklabs defaults\nbaked in. This is meant to serve as a hook for continuous management of all repos we own.\nWith cdklabs projen types, we can add new configuration as they come up and have it\npropagate to all repositories using the type.\n\n## CdklabsConstructLibrary\n\nThis type extends projen's `awscdk.AwsConstructLibrary` project type and should be used in place\nof that type.\n\n### Usage\n\nFrom the command line:\n\n```bash\nnpx projen new --from cdklabs-projen-project-types cdklabs-construct-lib\n```\n\nFrom inside `cdk-ops`:\n\n```ts\nthis.cdklabs.addPreApprovedRepo({\n  repo: 'cdk-new-lib',\n  owner: 'conroyka@amazon.com',\n  createWith: {\n    projectType: ProjectType.CDKLABS_MANAGED_CONSTRUCT_LIB,\n  },\n});\n```\n\n### Features\n\n- `cdklabsPublishingDefaults`\n\nBy default, this is turned on. `cdklabsPublishingDefaults` provides publishing defaults based off\nof the project's name. Specifically, the defaults look like this:\n\n```ts\nreturn {\n  publishToPypi: {\n    distName: npmPackageName,\n    module: changeDelimiter(npmPackageName, '_'),\n  },\n  publishToMaven: {\n    javaPackage: `io.github.cdklabs.${changeDelimiter(npmPackageName, '.')}`,\n    mavenGroupId: 'io.github.cdklabs',\n    mavenArtifactId: npmPackageName,\n    mavenEndpoint: 'https://s01.oss.sonatype.org',\n  },\n  publishToNuget: {\n    dotNetNamespace: `Cdklabs${upperCaseName(npmPackageName)}`,\n    packageId: `Cdklabs${upperCaseName(npmPackageName)}`,\n  },\n  publishToGo: {\n    moduleName: `${npmPackageName}-go`,\n  },\n};\n```\n\nAdditionally, we also require that we publish to all jsii language targets (including go) when\nwe specify a library as `stable`.\n\n- `private`\n\nBy default, a project is created as `private`. Turning this off simply means setting `private: false`.\nA project being `private` means it gets certain properties set as default that are true for private\nprojects. Today, that means setting `private: true` in `package.json`, removing `.mergify.yml` from\nthe project, and removing `.npmignore`.\n\n- `releasableCommits`\n\nBy default this project type releases `ReleasableCommits.featuresAndFixes`, to not release a new\nversion every day on a package that only sees devDependency updates. You may want to override this\nif you need something more specific.\n\n## CdklabsTypeScriptProject\n\nThis type extends projen's `typescript.TypeScriptProject` project type and should be used in place\nof that type.\n\n### Usage\n\n```bash\nnpx projen new --from cdklabs-projen-project-types cdklabs-ts-proj\n```\n\nFrom inside `cdk-ops`:\n\n```ts\nthis.cdklabs.addPreApprovedRepo({\n  repo: 'cdk-new-lib',\n  owner: 'conroyka@amazon.com',\n  createWith: {\n    projectType: ProjectType.CDKLABS_MANAGED_TS_PROJECT,\n  },\n});\n```\n\n### Features\n\n- `private`\n\nBy default, a project is created as `private`. Turning this off simply means setting `private: false`.\nA project being `private` means it gets certain properties set as default that are true for private\nprojects. Today, that means setting `private: true` in `package.json`, removing `.mergify.yml` from\nthe project, and removing `.npmignore`.\n\n## CdklabsMonorepo\n\nA TypeScript monorepo using Yarn Workspaces.\nIndividual workspaces can be added with `yarn.TypeScriptWorkspace` which extends projen's `typescript.TypeScriptProject`.\n\n### Usage\n\n```bash\nnpx projen new --from cdklabs-projen-project-types cdklabs-yarn-monorepo\n```\n\n### Features\n\n```ts\nconst project = new yarn.CdkLabsMonorepo({\n  defaultReleaseBranch: \"main\",\n  devDeps: [\"cdklabs-projen-project-types\"],\n  name: \"monorepo\",\n});\n```\n\n- Workspace commands: `projen build|compile|package|test|upgrade`\\\nWill run the specific command in all workspaces and the root if applicable.\n\n- Workspace run: `projen run <command>`\\\nExecutes the given command in all workspaces\n\n- Automatic dependency installation\\\nThe monorepo will know if a dependency has been added for a workspace and run `yarn install` as part of `projen`\n\n- `projen` at any level\\\nThe default `projen` command can be run in any workspace and will execute the monorepo synth command.\n\n- Release\\\nThis feature is not supported at this time.\nAny release functionality must be implemented.\n\n- `vscodeWorkspace: boolean`\\\nYou can specify if a VSCode Workspace file should be created for the monorepo.\n\n#### Workspaces\n\n```ts\nnew yarn.TypeScriptWorkspace({\n  parent: project,\n  name: 'workspace'\n})\n```\n\n- `parent: yarn.Monorepo`\\\nWorkspaces (aka subprojects) must be added using the `parent` option.\n\n- `workspaceScope: string`\\\nThe location the workspace is placed at. Defaults to `./packages`\n\n- `excludeDepsFromUpgrade: Array<string>`\\\nList any dependencies that should not be updated in the workspace.\n\n#### JsiiBuild\n\nUse `WorkspaceJsiiBuild` to add jsii compilation and multi-language publishing to a workspace:\n\n```ts\nconst lib = new yarn.TypeScriptWorkspace({\n  parent: project,\n  name: '@cdklabs/my-lib',\n  disableTsconfig: true, // required for jsii\n});\n\nlib.with(new yarn.WorkspaceJsiiBuild({\n  publishToMaven: { ... },\n  publishToPypi: { ... },\n  publishToNuget: { ... },\n  publishToGo: { ... },\n}));\n```\n\nThis is a mixin that wraps the upstream projen `JsiiBuild` and adds:\n\n- Rosetta (strict mode by default)\n- Composite project references (`composite: true`)\n- PyPI classifiers (`pypiClassifiers`)\n- Monorepo-appropriate packaging (only `package:js`, other targets in release workflow)\n"
   },
   "repository": {
     "type": "git",
@@ -7924,7 +7924,7 @@
           {
             "name": "project",
             "type": {
-              "fqn": "projen.cdk.JsiiProject"
+              "fqn": "projen.typescript.TypeScriptProject"
             }
           },
           {
@@ -8285,6 +8285,365 @@
       ],
       "symbolId": "src/yarn/typescript-workspace:IWorkspaceReference"
     },
+    "cdklabs-projen-project-types.yarn.JsiiBuildOptions": {
+      "assembly": "cdklabs-projen-project-types",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Options for `JsiiBuild`."
+      },
+      "fqn": "cdklabs-projen-project-types.yarn.JsiiBuildOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+        "line": 9
+      },
+      "name": "JsiiBuildOptions",
+      "namespace": "yarn",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- undefined",
+            "stability": "stable",
+            "summary": "Options for publishing npm package to AWS CodeArtifact."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 106
+          },
+          "name": "codeArtifactOptions",
+          "optional": true,
+          "type": {
+            "fqn": "projen.release.CodeArtifactOptions"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "remarks": "- You can manually run compatibility tests using `yarn compat` if this feature is disabled.\n- You can ignore compatibility failures by adding lines to a \".compatignore\" file.",
+            "stability": "stable",
+            "summary": "Automatically run API compatibility test against the latest version published to npm after compilation."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 38
+          },
+          "name": "compat",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\".compatignore\"",
+            "stability": "stable",
+            "summary": "Name of the ignore file for API compatibility tests."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 44
+          },
+          "name": "compatIgnore",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "stability": "stable",
+            "summary": "Emit a compressed version of the assembly."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 62
+          },
+          "name": "compressAssembly",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "true",
+            "stability": "stable",
+            "summary": "Generate a MarkDown file describing the jsii API."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 88
+          },
+          "name": "docgen",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"API.md\"",
+            "stability": "stable",
+            "summary": "File path for generated docs."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 57
+          },
+          "name": "docgenFilePath",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Files matching any of those patterns will be excluded from the TypeScript compiler input.\n\nBy default, jsii will include all *.ts files (except .d.ts files) in the TypeScript compiler input.\nThis can be problematic for example when the package's build or test procedure generates .ts files\nthat cannot be compiled with jsii's compiler settings.",
+            "stability": "stable",
+            "summary": "Accepts a list of glob patterns."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 52
+          },
+          "name": "excludeTypescript",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "pjnew": "\"~5.9.0\""
+            },
+            "default": "\"~5.9.0\"",
+            "remarks": "Set to \"*\" if you want to manually manage the version of jsii in your\nproject by managing updates to `package.json` on your own.\n\nNOTE: The jsii compiler releases since 5.0.0 are not semantically versioned\nand should remain on the same minor, so we recommend using a `~` dependency\n(e.g. `~5.0.0`).",
+            "stability": "stable",
+            "summary": "Version of the jsii compiler to use."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 76
+          },
+          "name": "jsiiVersion",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "stability": "stable",
+            "summary": "Whether to use trusted publishing for npm."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 100
+          },
+          "name": "npmTrustedPublishing",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no publishing",
+            "stability": "stable",
+            "summary": "Publish Go bindings to a git repository."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 24
+          },
+          "name": "publishToGo",
+          "optional": true,
+          "type": {
+            "fqn": "projen.cdk.JsiiGoTarget"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no publishing",
+            "stability": "stable",
+            "summary": "Publish to maven."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 14
+          },
+          "name": "publishToMaven",
+          "optional": true,
+          "type": {
+            "fqn": "projen.cdk.JsiiJavaTarget"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no publishing",
+            "stability": "stable",
+            "summary": "Publish to NuGet."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 29
+          },
+          "name": "publishToNuget",
+          "optional": true,
+          "type": {
+            "fqn": "projen.cdk.JsiiDotNetTarget"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no publishing",
+            "stability": "stable",
+            "summary": "Publish to pypi."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 19
+          },
+          "name": "publishToPypi",
+          "optional": true,
+          "type": {
+            "fqn": "projen.cdk.JsiiPythonTarget"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "true",
+            "stability": "stable",
+            "summary": "Whether to publish to npm."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 94
+          },
+          "name": "releaseToNpm",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"stable\"",
+            "stability": "stable",
+            "summary": "The stability of the package."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 82
+          },
+          "name": "stability",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "[]",
+            "stability": "stable",
+            "summary": "Additional steps to run before packaging in workflows."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 127
+          },
+          "name": "workflowBootstrapSteps",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "projen.github.workflows.Step"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"lts/*\"",
+            "stability": "stable",
+            "summary": "The node version to use in packaging workflows."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 121
+          },
+          "name": "workflowNodeVersion",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\".\" - root of the repository",
+            "remarks": "This is used in monorepo setups where the package is not at the root.\nPackaging steps will extract build artifacts into this subdirectory.",
+            "stability": "stable",
+            "summary": "Relative path of the package within the repository."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "node_modules/projen/lib/cdk/jsii-build.d.ts",
+            "line": 115
+          },
+          "name": "workspaceDirectory",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "lib/cdk/jsii-build:JsiiBuildOptions"
+    },
     "cdklabs-projen-project-types.yarn.Monorepo": {
       "assembly": "cdklabs-projen-project-types",
       "base": "projen.typescript.TypeScriptProject",
@@ -12117,7 +12476,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/yarn/typescript-workspace.ts",
-        "line": 356
+        "line": 362
       },
       "name": "ReferenceOptions",
       "namespace": "yarn",
@@ -12133,7 +12492,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/yarn/typescript-workspace.ts",
-            "line": 367
+            "line": 373
           },
           "name": "versionType",
           "optional": true,
@@ -12158,7 +12517,7 @@
         },
         "locationInModule": {
           "filename": "src/yarn/typescript-workspace.ts",
-          "line": 65
+          "line": 66
         },
         "parameters": [
           {
@@ -12186,7 +12545,7 @@
           },
           "locationInModule": {
             "filename": "src/yarn/typescript-workspace.ts",
-            "line": 316
+            "line": 322
           },
           "name": "addEslintRcFix",
           "protected": true
@@ -12198,7 +12557,7 @@
           },
           "locationInModule": {
             "filename": "src/yarn/typescript-workspace.ts",
-            "line": 302
+            "line": 308
           },
           "name": "addTsconfigDevFix",
           "protected": true
@@ -12210,7 +12569,7 @@
           },
           "locationInModule": {
             "filename": "src/yarn/typescript-workspace.ts",
-            "line": 343
+            "line": 349
           },
           "name": "customizeReference",
           "parameters": [
@@ -12236,7 +12595,7 @@
           },
           "locationInModule": {
             "filename": "src/yarn/typescript-workspace.ts",
-            "line": 334
+            "line": 340
           },
           "name": "workspaceDependencies",
           "parameters": [
@@ -12275,7 +12634,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/yarn/typescript-workspace.ts",
-            "line": 59
+            "line": 60
           },
           "name": "bundledDeps",
           "type": {
@@ -12295,7 +12654,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/yarn/typescript-workspace.ts",
-            "line": 60
+            "line": 61
           },
           "name": "isPrivatePackage",
           "overrides": "cdklabs-projen-project-types.yarn.IWorkspaceReference",
@@ -12311,7 +12670,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/yarn/typescript-workspace.ts",
-            "line": 61
+            "line": 62
           },
           "name": "versionType",
           "overrides": "cdklabs-projen-project-types.yarn.IWorkspaceReference",
@@ -12326,12 +12685,30 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/yarn/typescript-workspace.ts",
-            "line": 58
+            "line": 59
           },
           "name": "workspaceDirectory",
           "type": {
             "primitive": "string"
           }
+        },
+        {
+          "docs": {
+            "remarks": "If undefined, this is the root project.",
+            "stability": "stable",
+            "summary": "A parent project."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/yarn/typescript-workspace.ts",
+            "line": 58
+          },
+          "name": "parent",
+          "optional": true,
+          "overrides": "projen.Project",
+          "type": {
+            "fqn": "cdklabs-projen-project-types.yarn.Monorepo"
+          }
         }
       ],
       "symbolId": "src/yarn/typescript-workspace:TypeScriptWorkspace"
@@ -15403,6 +15780,194 @@
       ],
       "symbolId": "src/yarn/vscode-workspace-options:VsCodeWorkspaceOptions"
     },
+    "cdklabs-projen-project-types.yarn.WorkspaceJsiiBuild": {
+      "assembly": "cdklabs-projen-project-types",
+      "docs": {
+        "stability": "stable",
+        "summary": "A mixin that applies the upstream projen JsiiBuild to a TypeScriptWorkspace, adding monorepo-appropriate defaults (Rosetta, composite, pypiClassifiers)."
+      },
+      "fqn": "cdklabs-projen-project-types.yarn.WorkspaceJsiiBuild",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/yarn/jsii-build.ts",
+          "line": 44
+        },
+        "parameters": [
+          {
+            "name": "options",
+            "optional": true,
+            "type": {
+              "fqn": "cdklabs-projen-project-types.yarn.WorkspaceJsiiBuildOptions"
+            }
+          }
+        ]
+      },
+      "interfaces": [
+        "constructs.IMixin"
+      ],
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/yarn/jsii-build.ts",
+        "line": 41
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Applies the mixin functionality to the target construct."
+          },
+          "locationInModule": {
+            "filename": "src/yarn/jsii-build.ts",
+            "line": 52
+          },
+          "name": "applyTo",
+          "overrides": "constructs.IMixin",
+          "parameters": [
+            {
+              "name": "construct",
+              "type": {
+                "fqn": "constructs.IConstruct"
+              }
+            }
+          ]
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Determines whether this mixin can be applied to the given construct."
+          },
+          "locationInModule": {
+            "filename": "src/yarn/jsii-build.ts",
+            "line": 48
+          },
+          "name": "supports",
+          "overrides": "constructs.IMixin",
+          "parameters": [
+            {
+              "name": "construct",
+              "type": {
+                "fqn": "constructs.IConstruct"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "boolean"
+            }
+          }
+        }
+      ],
+      "name": "WorkspaceJsiiBuild",
+      "namespace": "yarn",
+      "symbolId": "src/yarn/jsii-build:WorkspaceJsiiBuild"
+    },
+    "cdklabs-projen-project-types.yarn.WorkspaceJsiiBuildOptions": {
+      "assembly": "cdklabs-projen-project-types",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "cdklabs-projen-project-types.yarn.WorkspaceJsiiBuildOptions",
+      "interfaces": [
+        "projen.cdk.JsiiBuildOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/yarn/jsii-build.ts",
+        "line": 9
+      },
+      "name": "WorkspaceJsiiBuildOptions",
+      "namespace": "yarn",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "stability": "stable",
+            "summary": "Whether to turn on composite mode for the TypeScript project."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/yarn/jsii-build.ts",
+            "line": 28
+          },
+          "name": "composite",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "none",
+            "stability": "stable",
+            "summary": "PyPI classifiers to add to `package.json`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/yarn/jsii-build.ts",
+            "line": 34
+          },
+          "name": "pypiClassifiers",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "[]",
+            "see": "https://github.com/aws/jsii-rosetta?tab=readme-ov-file#dependencies",
+            "stability": "stable",
+            "summary": "Additional example dependencies for Rosetta."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/yarn/jsii-build.ts",
+            "line": 22
+          },
+          "name": "rosettaDependencies",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "true",
+            "stability": "stable",
+            "summary": "Whether to turn on 'strict' mode for Rosetta."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/yarn/jsii-build.ts",
+            "line": 14
+          },
+          "name": "rosettaStrict",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/yarn/jsii-build:WorkspaceJsiiBuildOptions"
+    },
     "cdklabs-projen-project-types.yarn.WorkspaceRelease": {
       "assembly": "cdklabs-projen-project-types",
       "base": "projen.Component",
@@ -15416,7 +15981,7 @@
         },
         "locationInModule": {
           "filename": "src/yarn/typescript-workspace-release.ts",
-          "line": 30
+          "line": 31
         },
         "parameters": [
           {
@@ -15441,6 +16006,20 @@
       "name": "WorkspaceRelease",
       "namespace": "yarn",
       "properties": [
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/yarn/typescript-workspace-release.ts",
+            "line": 29
+          },
+          "name": "artifactsDirectory",
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "docs": {
             "stability": "stable"
@@ -15675,6 +16254,6 @@
   "usedFeatures": [
     "class-covariant-overrides"
   ],
-  "version": "0.4.0",
-  "fingerprint": "Ygn/wS2X2hjHUKvc2ukP3RXsiUurr4uioM4nMa8GRSk="
+  "version": "0.5.0",
+  "fingerprint": "6p3DDGQxLcQN4o12bCMPWrOHhXkeEb/h8DTPWKYhVI8="
 }