@xpertss/projen-types 0.0.0

package/.jsii

@@ -0,0 +1,1742 @@
+{
+  "author": {
+    "email": "cfloersch@xpertss.org",
+    "name": "Chris Floersch",
+    "roles": [
+      "author"
+    ]
+  },
+  "dependencies": {
+    "constructs": "^10.8.1",
+    "projen": "^0.103.22"
+  },
+  "dependencyClosure": {
+    "constructs": {
+      "targets": {
+        "dotnet": {
+          "namespace": "Constructs",
+          "packageId": "Constructs"
+        },
+        "go": {
+          "moduleName": "github.com/aws/constructs-go"
+        },
+        "java": {
+          "maven": {
+            "artifactId": "constructs",
+            "groupId": "software.constructs"
+          },
+          "package": "software.constructs"
+        },
+        "js": {
+          "npm": "constructs"
+        },
+        "python": {
+          "distName": "constructs",
+          "module": "constructs"
+        }
+      }
+    },
+    "projen": {
+      "submodules": {
+        "projen.awscdk": {},
+        "projen.build": {},
+        "projen.cdk": {},
+        "projen.cdk8s": {},
+        "projen.cdktf": {},
+        "projen.cdktn": {},
+        "projen.circleci": {},
+        "projen.github": {},
+        "projen.github.workflows": {},
+        "projen.gitlab": {},
+        "projen.java": {},
+        "projen.javascript": {},
+        "projen.javascript.biome_config": {},
+        "projen.polaris": {},
+        "projen.python": {},
+        "projen.python.uvConfig": {},
+        "projen.release": {},
+        "projen.sonarqube": {},
+        "projen.typescript": {},
+        "projen.vscode": {},
+        "projen.web": {}
+      },
+      "targets": {
+        "go": {
+          "moduleName": "github.com/projen/projen-go"
+        },
+        "java": {
+          "maven": {
+            "artifactId": "projen",
+            "groupId": "io.github.cdklabs"
+          },
+          "package": "io.github.cdklabs.projen"
+        },
+        "js": {
+          "npm": "projen"
+        },
+        "python": {
+          "distName": "projen",
+          "module": "projen"
+        }
+      }
+    }
+  },
+  "description": "Projen project types for CDK/TypeScript and Java/Maven projects",
+  "docs": {
+    "stability": "experimental"
+  },
+  "homepage": "git@github.com:xpertss/projen",
+  "jsiiVersion": "6.0.14 (build 44649f3)",
+  "keywords": [
+    "aws",
+    "cdk",
+    "java",
+    "maven",
+    "projen"
+  ],
+  "license": "Apache-2.0",
+  "metadata": {
+    "jsii": {
+      "pacmak": {
+        "hasDefaultInterfaces": true
+      }
+    },
+    "tscOutDir": "lib",
+    "tscRootDir": "src"
+  },
+  "name": "@xpertss/projen-types",
+  "readme": {
+    "markdown": "# @xpertss/projen-types\n\nProjen project types for CDK/TypeScript and Java/Maven projects.\n\nInstead of hand-maintaining `pom.xml`, `cdk.json`, and GitHub workflows, you declare a project type in a `.projenrc.ts` file and let [projen](https://github.com/projen/projen) generate (and keep up to date) the whole scaffold: build files, source skeletons, CI workflows, and deploy pipelines.\n\n## Project types at a glance\n\n| Type | What it is | Publishes to | Generated workflows |\n| --- | --- | --- | --- |\n| `CdkInfraProject` | Pure-infrastructure CDK stacks (CloudFront, Route53, SQS, API Gateway, Cognito, ECR/ECS for externally-built images) | - | `build` (PR checks), `deploy` (manual dispatch) |\n| `CdkAppProject` | Full TypeScript service behind API Gateway: infra + app source + database | - | `build`, `deploy`, `app-build` (PR checks) |\n| `JavaLibraryProject` | Reusable Java library | Maven Central | `build`, `upgrade` (nightly), `publish-maven-central`, `codeindex` |\n| `JavaServiceProject` | Spring Boot service | Docker Hub | `build`, `upgrade` (nightly), `publish-docker`, `deploy-cdk` |\n| `JavaAppProject` | GUI/TUI/CLI Java application | GitHub Packages | `build`, `upgrade` (nightly), `publish-ghpackages` |\n\nTwo foundation classes are also exported for advanced use: `CdkTypescriptProject` (shared CDK + TypeScript base for the CDK types) and `JavaMavenProject` (shared Maven base for the Java types).\n\nAll project types:\n\n- run a **drift check** in PR builds - a job that re-runs projen and fails if generated files were hand-edited. Edit `.projenrc.ts`, then run `npx projen`; never edit generated files directly.\n- use the GitHub secret `PROJEN_GITHUB_TOKEN` (a fine-grained PAT) for projen's automation. Override with `gheTokenSecret`.\n- make all publishing/deploying **manual** (workflow_dispatch) rather than on every merge.\n\n## Getting started\n\nCreate a new git repository and install the dependencies:\n\n```bash\nmkdir my-project && cd my-project\ngit init\nnpm install -D projen constructs @xpertss/projen-types\n```\n\nWrite a `.projenrc.ts` (see examples below), then generate the project:\n\n```bash\nnpx projen\n```\n\nCommit the result. From then on, every change to the scaffold goes through `.projenrc.ts` followed by `npx projen`.\n\nThe `name` option must match the `name` field in the project's `package.json` (for the CDK types) or the project name used by projen's `java.JavaProject` (for the Java types).\n\n## Examples\n\n### CdkInfraProject\n\nPure infrastructure stacks with optional ECR/ECS and edge-networking constructs.\n\n```typescript\n// .projenrc.ts\nimport { CdkInfraProject } from '@xpertss/projen-types';\n\nconst project = new CdkInfraProject({\n  name: 'media-edge-infra',\n  environments: [\n    'dev',\n    { name: 'stage', accountId: '111111111111', region: 'eu-central-1' },\n    { name: 'prod', accountId: '222222222222', region: 'eu-central-1', requiresApproval: true },\n  ],\n  edgeResources: ['cloudfront', 'route53', 'sqs'],\n  ecrEcs: { enabled: true, externalImageSource: true },\n  slackWebhookSecret: 'SLACK_DEPLOY_WEBHOOK',\n});\n\nproject.synth();\n```\n\nYou get:\n\n- `cdk.json`, `cdk synth` / `cdk diff` / `cdk deploy` tasks, and the standard `AwsCdkTypeScriptApp` layout (CDK 2.189.1 by default).\n- `.github/workflows/build.yml` - PR build that hard-fails on projen drift.\n- `.github/workflows/deploy.yml` - manual dispatch with one `deploy-<env>` job per environment (runs `cdk deploy --all` with `--context environment=<env>`); `requiresApproval` environments get a GitHub Environment approval gate; a Slack notification step is added when `slackWebhookSecret` is set.\n- `src/constructs/edge-networking.ts` - helper constructs only for the requested `edgeResources` (`cloudfront`, `route53`, `apigateway`, `cognito`, `sqs`).\n- `src/constructs/ecr-ecs.ts` when `ecrEcs.enabled` - ECR repo + Fargate service; `externalImageSource: true` (default) means the service pulls an image built outside this repo.\n\n### CdkAppProject\n\n`CdkInfraProject` plus application source, a database construct, and an app-level build workflow.\n\n```typescript\n// .projenrc.ts\nimport { CdkAppProject } from '@xpertss/projen-types';\n\nconst project = new CdkAppProject({\n  name: 'video-api',\n  environments: ['dev', 'prod'],\n  edgeResources: ['apigateway'],\n  database: { engine: 'postgres', migrationTool: 'flyway' },\n  appEntryPoint: 'src/app.ts',\n});\n\nproject.synth();\n```\n\nEverything from `CdkInfraProject`, plus:\n\n- `src/app.ts` - application entrypoint stub (`export function handler()`).\n- `src/handlers/example.ts` - API Gateway proxy handler stub, with `@types/aws-lambda` added as a dev dependency.\n- `src/constructs/database.ts` - a `Database` construct stub for the chosen engine (`postgres`/`mysql` -> RDS, `dynamodb` -> DynamoDB). `migrationTool` (no default, intentionally) is added as a dev dependency and referenced in the stub - wiring it up is left to you.\n- `.github/workflows/app-build.yml` - runs the project's test task on every PR, then checks for projen drift.\n\n### JavaLibraryProject\n\nA reusable Java library published to Maven Central.\n\n```typescript\n// .projenrc.ts\nimport { JavaLibraryProject } from '@xpertss/projen-types';\n\nconst project = new JavaLibraryProject({\n  name: 'common-utils',\n  groupId: 'org.xpertss',\n  artifactId: 'common-utils',\n  version: '1.0.0',\n  sonarProjectKey: 'org.xpertss:common-utils',\n  mavenCentralOidc: true,\n});\n\nproject.synth();\n```\n\nYou get:\n\n- `pom.xml` (via projen's `java.JavaProject`) with the given GAV coordinates.\n- `.github/workflows/build.yml` - PR build + projen drift check, plus a SonarQube scan step when `sonarProjectKey` is set (needs a `SONAR_TOKEN` secret).\n- `.github/workflows/upgrade.yml` - nightly (03:00 UTC) PR running `mvn versions:use-latest-releases versions:update-properties`.\n- `.github/workflows/publish-maven-central.yml` - manual dispatch running `mvn -B deploy -P release`. With `mavenCentralOidc: true` it uses Maven Central's OIDC trusted publishing (no GPG secrets needed); otherwise it expects the secrets `MAVEN_GPG_PRIVATE_KEY`, `MAVEN_GPG_PASSPHRASE`, `MAVEN_CENTRAL_USERNAME`, `MAVEN_CENTRAL_PASSWORD`.\n- `.github/workflows/codeindex.yml` - on push to `main`, generates a Java source index under `.cai/` (disable with `publishCodeIndex: false`).\n\n### JavaServiceProject\n\nA Spring Boot service that publishes a Docker image and can trigger deploys in a companion CDK repo.\n\n```typescript\n// .projenrc.ts\nimport { JavaServiceProject } from '@xpertss/projen-types';\n\nconst project = new JavaServiceProject({\n  name: 'stream-processor',\n  groupId: 'org.xpertss',\n  artifactId: 'stream-processor',\n  dockerRegistry: 'docker.io/xpertss',\n  cdkDeployHook: { targetRepo: 'xpertss/stream-infra' },\n  environments: ['dev', { name: 'prod', requiresApproval: true }],\n});\n\nproject.synth();\n```\n\nYou get (everything from `JavaMavenProject` - `pom.xml`, `build` + drift check, nightly `upgrade` - plus):\n\n- `spring-boot-starter-web` added to the pom.\n- `.github/workflows/publish-docker.yml` - manual dispatch: `mvn -B package && docker build -t <registry>/<name>:<sha>`, logged in with the `DOCKER_USERNAME` / `DOCKER_PASSWORD` secrets. `dockerRegistry` defaults to `docker.io`.\n- Flyway wiring when `useFlyway` (default `true`): `flyway-maven-plugin` ^10 + `flyway-core` ^10 in the pom, and `src/main/resources/db/migration/V1__init.sql`.\n- `.github/workflows/deploy-cdk.yml` (the `CdkDeployHook`, enabled by default) - manual dispatch with an environment selector; each job sends a `workflow_dispatch` to `deploy.yml` in the companion `targetRepo` (a `CdkInfraProject`/`CdkAppProject` repo). `targetRepo` is required when the hook is enabled; disable it with `cdkDeployHook: { enabled: false }`. `environments` defaults to `['prod']`.\n\n### JavaAppProject\n\nA GUI/TUI/CLI Java application published to GitHub Packages only - no Maven Central, no Docker, no CDK deploy hook.\n\n```typescript\n// .projenrc.ts\nimport { JavaAppProject } from '@xpertss/projen-types';\n\nconst project = new JavaAppProject({\n  name: 'studio-cli',\n  groupId: 'org.xpertss',\n  artifactId: 'studio-cli',\n  ghPackagesRegistry: 'https://maven.pkg.github.com/xpertss/studio-cli',\n});\n\nproject.synth();\n```\n\nYou get everything from `JavaMavenProject`, plus `.github/workflows/publish-ghpackages.yml` - manual dispatch running `mvn -B deploy -DaltDeploymentRepository=github::<registry>`, authenticated with `GITHUB_TOKEN`. `ghPackagesRegistry` defaults to `https://maven.pkg.github.com/<repo>` derived from the repository URL.\n\n## Common options\n\nCDK project types (`CdkInfraProjectOptions` / `CdkAppProjectOptions`):\n\n| Option | Default | Description |\n| --- | --- | --- |\n| `name` | - (required) | Project name; must match `package.json` |\n| `cdkVersion` | `2.189.1` | AWS CDK version |\n| `gheTokenSecret` | `PROJEN_GITHUB_TOKEN` | GitHub secret holding projen's PAT |\n| `slackWebhookSecret` | - | GitHub secret with a Slack webhook URL for deploy notifications |\n| `environments` | - (required) | Deploy targets for the `deploy` workflow; strings or `EnvironmentOptions` |\n| `ecrEcs` | - | `EcrEcsOptions` - `enabled`, `externalImageSource` (default `true`) |\n| `edgeResources` | - | Subset of `cloudfront`, `route53`, `apigateway`, `cognito`, `sqs` |\n| `database` | - (app only) | `DatabaseOptions` - `engine` (`postgres`/`mysql`/`dynamodb`, default `postgres`), `migrationTool` |\n| `appEntryPoint` | `src/app.ts` (app only) | Path of the generated application entrypoint |\n\nJava project types (`JavaLibraryProjectOptions` / `JavaServiceProjectOptions` / `JavaAppProjectOptions`):\n\n| Option | Default | Description |\n| --- | --- | --- |\n| `name` | - (required) | Project name |\n| `groupId` | - (required) | Maven group id |\n| `artifactId` | - (required) | Maven artifact id |\n| `version` | `0.1.0` | Maven version |\n| `sonarProjectKey` | - | SonarQube project key; the sonar step is skipped when unset |\n| `gheTokenSecret` | `PROJEN_GITHUB_TOKEN` | GitHub secret holding projen's PAT |\n\n`EnvironmentOptions` for deploy targets:\n\n```typescript\ninterface EnvironmentOptions {\n  readonly name: string;              // e.g. \"dev\", \"stage\", \"prod\"\n  readonly accountId?: string;        // AWS account id (CDK deploys)\n  readonly region?: string;           // AWS region (CDK deploys)\n  readonly requiresApproval?: boolean; // GitHub Environment approval gate (default false)\n}\n```\n\nPlain strings (`'dev'`) are shorthand for `{ name: 'dev' }`.\n\n## Required GitHub secrets\n\n| Secret | Used by | Notes |\n| --- | --- | --- |\n| `PROJEN_GITHUB_TOKEN` | all types | PAT for projen's self-mutation/automation; override via `gheTokenSecret` |\n| `SONAR_TOKEN` | Java types with `sonarProjectKey` | SonarQube scan step in `build.yml` |\n| `DOCKER_USERNAME` / `DOCKER_PASSWORD` | `JavaServiceProject` | Docker image push |\n| `MAVEN_GPG_PRIVATE_KEY`, `MAVEN_GPG_PASSPHRASE`, `MAVEN_CENTRAL_USERNAME`, `MAVEN_CENTRAL_PASSWORD` | `JavaLibraryProject` without `mavenCentralOidc` | Not needed with OIDC trusted publishing |\n| (your Slack webhook secret) | CDK types with `slackWebhookSecret` | Deploy notifications |\n\n## Going further\n\nThe project types are composed from smaller components you can also attach to your own projects:\n\n| Component | Applies to | Purpose |\n| --- | --- | --- |\n| `AppRuntimeScaffold` | `NodeProject` | App source skeleton (`app.ts` + handlers) |\n| `DatabaseComponent` | `NodeProject` | Database construct stub + migration tool wiring |\n| `EcrEcsConstructs` | `Project` | ECR + Fargate ECS construct helper |\n| `EdgeNetworkingConstructs` | `Project` | Per-resource edge networking construct helpers |\n| `MavenCentralPublish` | `JavaProject` | Manual-dispatch Maven Central publish workflow |\n| `DockerPublish` | `JavaProject` | Manual-dispatch Docker build+push workflow |\n| `GitHubPackagesPublish` | `JavaProject` | Manual-dispatch GitHub Packages publish workflow |\n| `FlywayMigration` | `JavaProject` | Flyway plugin/dependency + migrations directory |\n| `CdkDeployHook` | `JavaProject` | Manual-dispatch workflow that triggers `deploy.yml` in a companion CDK repo |\n| `CodeIndexWorkflow` | `JavaProject` | Code index generation on push to `main` |\n\nExample - adding a Docker publish to a plain projen `JavaProject`:\n\n```typescript\nimport { java } from 'projen';\nimport { DockerPublish } from '@xpertss/projen-types';\n\nconst project = new java.JavaProject({\n  name: 'my-service',\n  groupId: 'org.xpertss',\n  artifactId: 'my-service',\n});\n\nnew DockerPublish(project, { dockerRegistry: 'ghcr.io' });\n\nproject.synth();\n```\n\nThe full API reference, including every option and property, is in [API.md](./API.md).\n"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:xpertss/projen"
+  },
+  "schema": "jsii/0.10.0",
+  "targets": {
+    "js": {
+      "npm": "@xpertss/projen-types"
+    }
+  },
+  "types": {
+    "@xpertss/projen-types.AppRuntimeScaffold": {
+      "assembly": "@xpertss/projen-types",
+      "base": "projen.Component",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Full TypeScript application source structure (handlers/business logic), layered on top of `CdkTypescriptProject`'s pure-infra scaffold."
+      },
+      "fqn": "@xpertss/projen-types.AppRuntimeScaffold",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/cdk/app-runtime-scaffold.ts",
+          "line": 8
+        },
+        "parameters": [
+          {
+            "name": "project",
+            "type": {
+              "fqn": "projen.javascript.NodeProject"
+            }
+          },
+          {
+            "name": "appEntryPoint",
+            "optional": true,
+            "type": {
+              "primitive": "string"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/cdk/app-runtime-scaffold.ts",
+        "line": 7
+      },
+      "name": "AppRuntimeScaffold",
+      "symbolId": "src/cdk/app-runtime-scaffold:AppRuntimeScaffold"
+    },
+    "@xpertss/projen-types.CdkAppProject": {
+      "assembly": "@xpertss/projen-types",
+      "base": "@xpertss/projen-types.CdkInfraProject",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Full TypeScript service application running behind API Gateway (or similar), with the infra to support it - `CdkInfraProject` plus application source, a database, and an app-level build/test workflow."
+      },
+      "fqn": "@xpertss/projen-types.CdkAppProject",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/cdk/cdk-app-project.ts",
+          "line": 14
+        },
+        "parameters": [
+          {
+            "name": "options",
+            "type": {
+              "fqn": "@xpertss/projen-types.CdkAppProjectOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/cdk/cdk-app-project.ts",
+        "line": 13
+      },
+      "name": "CdkAppProject",
+      "symbolId": "src/cdk/cdk-app-project:CdkAppProject"
+    },
+    "@xpertss/projen-types.CdkAppProjectOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.CdkAppProjectOptions",
+      "interfaces": [
+        "@xpertss/projen-types.CdkInfraProjectOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/cdk/options.ts",
+        "line": 53
+      },
+      "name": "CdkAppProjectOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"src/app.ts\"",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/options.ts",
+            "line": 57
+          },
+          "name": "appEntryPoint",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/options.ts",
+            "line": 54
+          },
+          "name": "database",
+          "optional": true,
+          "type": {
+            "fqn": "@xpertss/projen-types.DatabaseOptions"
+          }
+        }
+      ],
+      "symbolId": "src/cdk/options:CdkAppProjectOptions"
+    },
+    "@xpertss/projen-types.CdkDeployHook": {
+      "assembly": "@xpertss/projen-types",
+      "base": "projen.Component",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Manual-dispatch workflow that invokes a downstream CDK deploy in a companion `CdkInfraProject`/`CdkAppProject` repo, using the same `ManualDeployWorkflow` contract those project types use for their own deploys - see the CDK spec's open question about sharing this contract."
+      },
+      "fqn": "@xpertss/projen-types.CdkDeployHook",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/java/components/cdk-deploy-hook.ts",
+          "line": 14
+        },
+        "parameters": [
+          {
+            "name": "project",
+            "type": {
+              "fqn": "projen.java.JavaProject"
+            }
+          },
+          {
+            "name": "environments",
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "union": {
+                    "types": [
+                      {
+                        "primitive": "string"
+                      },
+                      {
+                        "fqn": "@xpertss/projen-types.EnvironmentOptions"
+                      }
+                    ]
+                  }
+                },
+                "kind": "array"
+              }
+            }
+          },
+          {
+            "name": "options",
+            "optional": true,
+            "type": {
+              "fqn": "@xpertss/projen-types.CdkDeployHookOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/java/components/cdk-deploy-hook.ts",
+        "line": 13
+      },
+      "name": "CdkDeployHook",
+      "symbolId": "src/java/components/cdk-deploy-hook:CdkDeployHook"
+    },
+    "@xpertss/projen-types.CdkDeployHookOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.CdkDeployHookOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/java/options.ts",
+        "line": 26
+      },
+      "name": "CdkDeployHookOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "true",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 28
+          },
+          "name": "enabled",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The companion CDK infra/app repo (owner/repo) that owns the actual infrastructure."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 31
+          },
+          "name": "targetRepo",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/java/options:CdkDeployHookOptions"
+    },
+    "@xpertss/projen-types.CdkInfraProject": {
+      "assembly": "@xpertss/projen-types",
+      "base": "@xpertss/projen-types.CdkTypescriptProject",
+      "docs": {
+        "remarks": "Reference example: SimulcastAVDelivery.",
+        "stability": "experimental",
+        "summary": "Pure infrastructure CDK stacks - little or no application code (CloudFront, Route53, SQS, API Gateway, Cognito, ECR/ECS standing up externally-built images)."
+      },
+      "fqn": "@xpertss/projen-types.CdkInfraProject",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/cdk/cdk-infra-project.ts",
+          "line": 12
+        },
+        "parameters": [
+          {
+            "name": "options",
+            "type": {
+              "fqn": "@xpertss/projen-types.CdkInfraProjectOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/cdk/cdk-infra-project.ts",
+        "line": 11
+      },
+      "name": "CdkInfraProject",
+      "symbolId": "src/cdk/cdk-infra-project:CdkInfraProject"
+    },
+    "@xpertss/projen-types.CdkInfraProjectOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.CdkInfraProjectOptions",
+      "interfaces": [
+        "@xpertss/projen-types.CommonCdkOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/cdk/options.ts",
+        "line": 36
+      },
+      "name": "CdkInfraProjectOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Deploy targets for the manual-dispatch deploy workflow, e.g. [\"dev\", \"stage\", \"prod\"]."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/options.ts",
+            "line": 38
+          },
+          "name": "environments",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "union": {
+                  "types": [
+                    {
+                      "primitive": "string"
+                    },
+                    {
+                      "fqn": "@xpertss/projen-types.EnvironmentOptions"
+                    }
+                  ]
+                }
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/options.ts",
+            "line": 40
+          },
+          "name": "ecrEcs",
+          "optional": true,
+          "type": {
+            "fqn": "@xpertss/projen-types.EcrEcsOptions"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/options.ts",
+            "line": 42
+          },
+          "name": "edgeResources",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "src/cdk/options:CdkInfraProjectOptions"
+    },
+    "@xpertss/projen-types.CdkTypescriptProject": {
+      "assembly": "@xpertss/projen-types",
+      "base": "projen.awscdk.AwsCdkTypeScriptApp",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Shared CDK + TypeScript foundation for `CdkInfraProject` and `CdkAppProject`: standard app structure (via `AwsCdkTypeScriptApp`, `cdk.json`, `cdk synth`/`cdk diff` tasks), a PR-check build that hard-fails on projen drift (rather than self-mutating), and an optional `ManualDeployWorkflow` when `environments` is provided."
+      },
+      "fqn": "@xpertss/projen-types.CdkTypescriptProject",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/cdk/cdk-typescript-base.ts",
+          "line": 19
+        },
+        "parameters": [
+          {
+            "name": "options",
+            "type": {
+              "fqn": "@xpertss/projen-types.CdkTypescriptProjectOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/cdk/cdk-typescript-base.ts",
+        "line": 18
+      },
+      "name": "CdkTypescriptProject",
+      "symbolId": "src/cdk/cdk-typescript-base:CdkTypescriptProject"
+    },
+    "@xpertss/projen-types.CdkTypescriptProjectOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.CdkTypescriptProjectOptions",
+      "interfaces": [
+        "@xpertss/projen-types.CommonCdkOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/cdk/cdk-typescript-base.ts",
+        "line": 7
+      },
+      "name": "CdkTypescriptProjectOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/cdk-typescript-base.ts",
+            "line": 8
+          },
+          "name": "environments",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "union": {
+                  "types": [
+                    {
+                      "primitive": "string"
+                    },
+                    {
+                      "fqn": "@xpertss/projen-types.EnvironmentOptions"
+                    }
+                  ]
+                }
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "src/cdk/cdk-typescript-base:CdkTypescriptProjectOptions"
+    },
+    "@xpertss/projen-types.CodeIndexWorkflow": {
+      "assembly": "@xpertss/projen-types",
+      "base": "projen.Component",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Generates a code index and publishes it to `.cai/` on checkin."
+      },
+      "fqn": "@xpertss/projen-types.CodeIndexWorkflow",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/java/components/code-index-workflow.ts",
+          "line": 6
+        },
+        "parameters": [
+          {
+            "name": "project",
+            "type": {
+              "fqn": "projen.java.JavaProject"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/java/components/code-index-workflow.ts",
+        "line": 5
+      },
+      "name": "CodeIndexWorkflow",
+      "symbolId": "src/java/components/code-index-workflow:CodeIndexWorkflow"
+    },
+    "@xpertss/projen-types.CommonCdkOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.CommonCdkOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/cdk/options.ts",
+        "line": 23
+      },
+      "name": "CommonCdkOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/options.ts",
+            "line": 24
+          },
+          "name": "name",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"2.189.1\"",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/options.ts",
+            "line": 27
+          },
+          "name": "cdkVersion",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"PROJEN_GITHUB_TOKEN\"",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/options.ts",
+            "line": 30
+          },
+          "name": "gheTokenSecret",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "GitHub secret holding a Slack webhook URL for deploy notifications."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/options.ts",
+            "line": 33
+          },
+          "name": "slackWebhookSecret",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/cdk/options:CommonCdkOptions"
+    },
+    "@xpertss/projen-types.CommonJavaOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.CommonJavaOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/java/options.ts",
+        "line": 3
+      },
+      "name": "CommonJavaOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 6
+          },
+          "name": "artifactId",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 5
+          },
+          "name": "groupId",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 4
+          },
+          "name": "name",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"PROJEN_GITHUB_TOKEN\"",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 15
+          },
+          "name": "gheTokenSecret",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "If unset, the sonar scan step is skipped.",
+            "stability": "experimental",
+            "summary": "SonarQube project key."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 12
+          },
+          "name": "sonarProjectKey",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"0.1.0\"",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 9
+          },
+          "name": "version",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/java/options:CommonJavaOptions"
+    },
+    "@xpertss/projen-types.DatabaseComponent": {
+      "assembly": "@xpertss/projen-types",
+      "base": "projen.Component",
+      "docs": {
+        "remarks": "The migration tool\nitself is left fully pluggable per the spec's open question - if\n`migrationTool` is provided it's added as a dev dependency and left for\nthe consuming team to wire up; no opinionated default is imposed.",
+        "stability": "experimental",
+        "summary": "DB provisioning construct + migration tooling wiring."
+      },
+      "fqn": "@xpertss/projen-types.DatabaseComponent",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/cdk/database-component.ts",
+          "line": 11
+        },
+        "parameters": [
+          {
+            "name": "project",
+            "type": {
+              "fqn": "projen.javascript.NodeProject"
+            }
+          },
+          {
+            "name": "options",
+            "optional": true,
+            "type": {
+              "fqn": "@xpertss/projen-types.DatabaseOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/cdk/database-component.ts",
+        "line": 10
+      },
+      "name": "DatabaseComponent",
+      "symbolId": "src/cdk/database-component:DatabaseComponent"
+    },
+    "@xpertss/projen-types.DatabaseOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.DatabaseOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/cdk/options.ts",
+        "line": 45
+      },
+      "name": "DatabaseOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"postgres\"",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/options.ts",
+            "line": 47
+          },
+          "name": "engine",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Migration tool to wire up, e.g. \"flyway\", \"liquibase\", \"prisma\". Left pluggable - no default."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/options.ts",
+            "line": 50
+          },
+          "name": "migrationTool",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/cdk/options:DatabaseOptions"
+    },
+    "@xpertss/projen-types.DockerPublish": {
+      "assembly": "@xpertss/projen-types",
+      "base": "projen.Component",
+      "docs": {
+        "stability": "experimental",
+        "summary": "On-demand build+push of a Docker image, defaulting to Docker Hub."
+      },
+      "fqn": "@xpertss/projen-types.DockerPublish",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/java/components/docker-publish.ts",
+          "line": 11
+        },
+        "parameters": [
+          {
+            "name": "project",
+            "type": {
+              "fqn": "projen.java.JavaProject"
+            }
+          },
+          {
+            "name": "options",
+            "optional": true,
+            "type": {
+              "fqn": "@xpertss/projen-types.DockerPublishOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/java/components/docker-publish.ts",
+        "line": 10
+      },
+      "name": "DockerPublish",
+      "symbolId": "src/java/components/docker-publish:DockerPublish"
+    },
+    "@xpertss/projen-types.DockerPublishOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.DockerPublishOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/java/components/docker-publish.ts",
+        "line": 4
+      },
+      "name": "DockerPublishOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"docker.io\"",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/components/docker-publish.ts",
+            "line": 6
+          },
+          "name": "dockerRegistry",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/java/components/docker-publish:DockerPublishOptions"
+    },
+    "@xpertss/projen-types.EcrEcsConstructs": {
+      "assembly": "@xpertss/projen-types",
+      "base": "projen.Component",
+      "docs": {
+        "remarks": "`externalImageSource` controls whether the\nservice pulls an externally-published image (infra-only projects) or one\nbuilt from this project's own source (app projects).",
+        "stability": "experimental",
+        "summary": "Reusable construct helper for an ECR repo + Fargate ECS cluster/service standing up a container image."
+      },
+      "fqn": "@xpertss/projen-types.EcrEcsConstructs",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/cdk/components/ecr-ecs-constructs.ts",
+          "line": 12
+        },
+        "parameters": [
+          {
+            "name": "project",
+            "type": {
+              "fqn": "projen.Project"
+            }
+          },
+          {
+            "name": "options",
+            "optional": true,
+            "type": {
+              "fqn": "@xpertss/projen-types.EcrEcsOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/cdk/components/ecr-ecs-constructs.ts",
+        "line": 11
+      },
+      "name": "EcrEcsConstructs",
+      "symbolId": "src/cdk/components/ecr-ecs-constructs:EcrEcsConstructs"
+    },
+    "@xpertss/projen-types.EcrEcsOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.EcrEcsOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/cdk/options.ts",
+        "line": 10
+      },
+      "name": "EcrEcsOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/options.ts",
+            "line": 12
+          },
+          "name": "enabled",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "true",
+            "stability": "experimental",
+            "summary": "Whether the ECS service stands up an externally-built image (infra-only) rather than one built from this project's own source."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/cdk/options.ts",
+            "line": 20
+          },
+          "name": "externalImageSource",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/cdk/options:EcrEcsOptions"
+    },
+    "@xpertss/projen-types.EdgeNetworkingConstructs": {
+      "assembly": "@xpertss/projen-types",
+      "base": "projen.Component",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Construct helpers for CloudFront/Route53/API Gateway/Cognito/SQS, scoped to whichever `edgeResources` the consuming project type opts into."
+      },
+      "fqn": "@xpertss/projen-types.EdgeNetworkingConstructs",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/cdk/components/edge-networking-constructs.ts",
+          "line": 46
+        },
+        "parameters": [
+          {
+            "name": "project",
+            "type": {
+              "fqn": "projen.Project"
+            }
+          },
+          {
+            "name": "resources",
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "primitive": "string"
+                },
+                "kind": "array"
+              }
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/cdk/components/edge-networking-constructs.ts",
+        "line": 45
+      },
+      "name": "EdgeNetworkingConstructs",
+      "symbolId": "src/cdk/components/edge-networking-constructs:EdgeNetworkingConstructs"
+    },
+    "@xpertss/projen-types.EnvironmentOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "A single named deployment target used by manual-dispatch deploy workflows."
+      },
+      "fqn": "@xpertss/projen-types.EnvironmentOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/common/environment-options.ts",
+        "line": 4
+      },
+      "name": "EnvironmentOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Environment name, e.g. \"dev\", \"stage\", \"prod\"."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/common/environment-options.ts",
+            "line": 6
+          },
+          "name": "name",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "AWS account id to deploy into, if relevant to the deploy steps used."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/common/environment-options.ts",
+            "line": 9
+          },
+          "name": "accountId",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "AWS region to deploy into, if relevant to the deploy steps used."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/common/environment-options.ts",
+            "line": 12
+          },
+          "name": "region",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "stability": "experimental",
+            "summary": "Whether this environment requires a GitHub Environment approval gate before the deploy job is allowed to run."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/common/environment-options.ts",
+            "line": 20
+          },
+          "name": "requiresApproval",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/common/environment-options:EnvironmentOptions"
+    },
+    "@xpertss/projen-types.FlywayMigration": {
+      "assembly": "@xpertss/projen-types",
+      "base": "projen.Component",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Adds Flyway config/dependencies + a migrations directory for DB migrations."
+      },
+      "fqn": "@xpertss/projen-types.FlywayMigration",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/java/components/flyway-migration.ts",
+          "line": 6
+        },
+        "parameters": [
+          {
+            "name": "project",
+            "type": {
+              "fqn": "projen.java.JavaProject"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/java/components/flyway-migration.ts",
+        "line": 5
+      },
+      "name": "FlywayMigration",
+      "symbolId": "src/java/components/flyway-migration:FlywayMigration"
+    },
+    "@xpertss/projen-types.GitHubPackagesPublish": {
+      "assembly": "@xpertss/projen-types",
+      "base": "projen.Component",
+      "docs": {
+        "stability": "experimental",
+        "summary": "On-demand publish to GitHub Packages."
+      },
+      "fqn": "@xpertss/projen-types.GitHubPackagesPublish",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/java/components/github-packages-publish.ts",
+          "line": 11
+        },
+        "parameters": [
+          {
+            "name": "project",
+            "type": {
+              "fqn": "projen.java.JavaProject"
+            }
+          },
+          {
+            "name": "options",
+            "optional": true,
+            "type": {
+              "fqn": "@xpertss/projen-types.GitHubPackagesPublishOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/java/components/github-packages-publish.ts",
+        "line": 10
+      },
+      "name": "GitHubPackagesPublish",
+      "symbolId": "src/java/components/github-packages-publish:GitHubPackagesPublish"
+    },
+    "@xpertss/projen-types.GitHubPackagesPublishOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.GitHubPackagesPublishOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/java/components/github-packages-publish.ts",
+        "line": 4
+      },
+      "name": "GitHubPackagesPublishOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "derived from the repository URL",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/components/github-packages-publish.ts",
+            "line": 6
+          },
+          "name": "ghPackagesRegistry",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/java/components/github-packages-publish:GitHubPackagesPublishOptions"
+    },
+    "@xpertss/projen-types.JavaAppProject": {
+      "assembly": "@xpertss/projen-types",
+      "base": "@xpertss/projen-types.JavaMavenProject",
+      "docs": {
+        "remarks": "Publishes to GitHub Packages only -\nexplicitly excludes Maven Central, Docker, and CDK deploy hooks.",
+        "stability": "experimental",
+        "summary": "GUI/TUI/CLI Java application."
+      },
+      "fqn": "@xpertss/projen-types.JavaAppProject",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/java/java-app-project.ts",
+          "line": 10
+        },
+        "parameters": [
+          {
+            "name": "options",
+            "type": {
+              "fqn": "@xpertss/projen-types.JavaAppProjectOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/java/java-app-project.ts",
+        "line": 9
+      },
+      "name": "JavaAppProject",
+      "symbolId": "src/java/java-app-project:JavaAppProject"
+    },
+    "@xpertss/projen-types.JavaAppProjectOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.JavaAppProjectOptions",
+      "interfaces": [
+        "@xpertss/projen-types.CommonJavaOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/java/options.ts",
+        "line": 53
+      },
+      "name": "JavaAppProjectOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"https://maven.pkg.github.com/OWNER/REPO\" (derived from the repository URL)",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 55
+          },
+          "name": "ghPackagesRegistry",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/java/options:JavaAppProjectOptions"
+    },
+    "@xpertss/projen-types.JavaLibraryProject": {
+      "assembly": "@xpertss/projen-types",
+      "base": "@xpertss/projen-types.JavaMavenProject",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Reusable Java library, published to Maven Central."
+      },
+      "fqn": "@xpertss/projen-types.JavaLibraryProject",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/java/java-library-project.ts",
+          "line": 8
+        },
+        "parameters": [
+          {
+            "name": "options",
+            "type": {
+              "fqn": "@xpertss/projen-types.JavaLibraryProjectOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/java/java-library-project.ts",
+        "line": 7
+      },
+      "name": "JavaLibraryProject",
+      "symbolId": "src/java/java-library-project:JavaLibraryProject"
+    },
+    "@xpertss/projen-types.JavaLibraryProjectOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.JavaLibraryProjectOptions",
+      "interfaces": [
+        "@xpertss/projen-types.CommonJavaOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/java/options.ts",
+        "line": 18
+      },
+      "name": "JavaLibraryProjectOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Use Maven Central's OIDC trusted-publishing flow instead of secret-based GPG signing."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 20
+          },
+          "name": "mavenCentralOidc",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "true",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 23
+          },
+          "name": "publishCodeIndex",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/java/options:JavaLibraryProjectOptions"
+    },
+    "@xpertss/projen-types.JavaMavenProject": {
+      "assembly": "@xpertss/projen-types",
+      "base": "projen.java.JavaProject",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Shared Maven build skeleton for all three Java project types: standard `pom.xml`/directory layout (via `java.JavaProject`), a PR-triggered build+test(+SonarQube) workflow that hard-fails on projen drift, and a nightly dependency-upgrade workflow."
+      },
+      "fqn": "@xpertss/projen-types.JavaMavenProject",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/java/java-maven-base.ts",
+          "line": 19
+        },
+        "parameters": [
+          {
+            "name": "options",
+            "type": {
+              "fqn": "@xpertss/projen-types.JavaMavenProjectOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/java/java-maven-base.ts",
+        "line": 15
+      },
+      "name": "JavaMavenProject",
+      "properties": [
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/java-maven-base.ts",
+            "line": 17
+          },
+          "name": "buildVerifyWorkflow",
+          "type": {
+            "fqn": "projen.github.TaskWorkflow"
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/java-maven-base.ts",
+            "line": 16
+          },
+          "name": "upgradeTask",
+          "type": {
+            "fqn": "projen.Task"
+          }
+        }
+      ],
+      "symbolId": "src/java/java-maven-base:JavaMavenProject"
+    },
+    "@xpertss/projen-types.JavaMavenProjectOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.JavaMavenProjectOptions",
+      "interfaces": [
+        "@xpertss/projen-types.CommonJavaOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/java/java-maven-base.ts",
+        "line": 7
+      },
+      "name": "JavaMavenProjectOptions",
+      "symbolId": "src/java/java-maven-base:JavaMavenProjectOptions"
+    },
+    "@xpertss/projen-types.JavaServiceProject": {
+      "assembly": "@xpertss/projen-types",
+      "base": "@xpertss/projen-types.JavaMavenProject",
+      "docs": {
+        "remarks": "Publishes to Docker Hub (never Maven\nCentral); publish and deploy are both manual-dispatch, not on every merge.",
+        "stability": "experimental",
+        "summary": "Springboot service application."
+      },
+      "fqn": "@xpertss/projen-types.JavaServiceProject",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/java/java-service-project.ts",
+          "line": 12
+        },
+        "parameters": [
+          {
+            "name": "options",
+            "type": {
+              "fqn": "@xpertss/projen-types.JavaServiceProjectOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/java/java-service-project.ts",
+        "line": 11
+      },
+      "name": "JavaServiceProject",
+      "symbolId": "src/java/java-service-project:JavaServiceProject"
+    },
+    "@xpertss/projen-types.JavaServiceProjectOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.JavaServiceProjectOptions",
+      "interfaces": [
+        "@xpertss/projen-types.CommonJavaOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/java/options.ts",
+        "line": 34
+      },
+      "name": "JavaServiceProjectOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "{ enabled: true }",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 42
+          },
+          "name": "cdkDeployHook",
+          "optional": true,
+          "type": {
+            "fqn": "@xpertss/projen-types.CdkDeployHookOptions"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"docker.io\"",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 36
+          },
+          "name": "dockerRegistry",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "[\"prod\"]",
+            "stability": "experimental",
+            "summary": "Deploy targets to offer on the `CdkDeployHook`'s manual-dispatch workflow, when the hook is enabled."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 50
+          },
+          "name": "environments",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "union": {
+                  "types": [
+                    {
+                      "primitive": "string"
+                    },
+                    {
+                      "fqn": "@xpertss/projen-types.EnvironmentOptions"
+                    }
+                  ]
+                }
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "true",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/options.ts",
+            "line": 39
+          },
+          "name": "useFlyway",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/java/options:JavaServiceProjectOptions"
+    },
+    "@xpertss/projen-types.MavenCentralPublish": {
+      "assembly": "@xpertss/projen-types",
+      "base": "projen.Component",
+      "docs": {
+        "stability": "experimental",
+        "summary": "On-demand publish workflow to Maven Central, with GPG signing (secrets) or OIDC trusted publishing."
+      },
+      "fqn": "@xpertss/projen-types.MavenCentralPublish",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/java/components/maven-central-publish.ts",
+          "line": 14
+        },
+        "parameters": [
+          {
+            "name": "project",
+            "type": {
+              "fqn": "projen.java.JavaProject"
+            }
+          },
+          {
+            "name": "options",
+            "optional": true,
+            "type": {
+              "fqn": "@xpertss/projen-types.MavenCentralPublishOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/java/components/maven-central-publish.ts",
+        "line": 13
+      },
+      "name": "MavenCentralPublish",
+      "symbolId": "src/java/components/maven-central-publish:MavenCentralPublish"
+    },
+    "@xpertss/projen-types.MavenCentralPublishOptions": {
+      "assembly": "@xpertss/projen-types",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@xpertss/projen-types.MavenCentralPublishOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/java/components/maven-central-publish.ts",
+        "line": 4
+      },
+      "name": "MavenCentralPublishOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/java/components/maven-central-publish.ts",
+            "line": 6
+          },
+          "name": "mavenCentralOidc",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/java/components/maven-central-publish:MavenCentralPublishOptions"
+    }
+  },
+  "version": "0.0.0",
+  "fingerprint": "ykgAzboMXVLVjt0FSFAS6+rsuZvrzsgcv4OWJA7Sp/o="
+}