@alma-cdk/project 1.0.0-beta.8 → 1.0.0

package/.jsii

@@ -3651,10 +3651,10 @@
   },
   "description": "Opinionated CDK Project “Framework”",
   "docs": {
-    "stability": "experimental"
+    "stability": "stable"
   },
   "homepage": "https://github.com/alma-cdk/project.git",
-  "jsiiVersion": "5.3.55 (build 4f29397)",
+  "jsiiVersion": "5.5.10 (build 224bf90)",
   "keywords": [
     "aws",
     "aws-cdk",
@@ -3672,7 +3672,7 @@
   },
   "name": "@alma-cdk/project",
   "readme": {
-    "markdown": "<div align=\"center\">\n\t<br/>\n\t<br/>\n  <h1>\n\t<img width=\"300\" src=\"assets/alma-cdk-project.svg\" alt=\"Alma CDK Project\" />\n  <br/>\n  <br/>\n  </h1>\n\n  ```sh\n  npm i -D @alma-cdk/project\n  ```\n\n  <div align=\"left\">\n\n  Opinionated CDK “framework” with constructs & utilities for:\n  - deploying multiple environments to multiple accounts (with many-to-many relationship)\n  - managing account configuration through standardized props (no more random config files)\n  - querying account and/or environment specific information within your CDK code\n  - enabling dynamic & short-lived “feature-environments”\n  - enabling well-defined tagging\n  - providing structure & common conventions to CDK projects\n  - choosing the target account & environment by passing in runtime context:\n\n    ```sh\n    npx cdk deploy -c account=dev -c environment=feature/abc-123\n    ```\n    ... which means you don't need to define all the possibile environments ahead of time!\n\n  </div>\n  <br/>\n</div>\n\n\n## Account Strategies\n\nDepending on the use case, you may choose a configuration between 1-3 AWS accounts with the following environments:\n\n\n1. **Shared account (`shared`)**:\n\n    ![default-multi](assets/accounts-1x.svg)\n    <br/>\n\n2. **Multi-account (`dev`+`prod`)**_– RECOMMENDED_:\n\n    ![default-multi](assets/accounts-2x.svg)\n    <br/>\n\n<br/>\n</details>\n\n3. **Multi-account (`dev`+`preprod`+`prod`)**:\n\n    ![default-multi](assets/accounts-3x.svg)\n    <br/>\n\n<br/>\n\n## Getting Started\n\nSteps required to define a _environmental_ project resources; At first, it might seem complex but once you get into the habbit of defining your projects this way it starts to make sense:\n\n1. Choose your [Account Strategy](#account-strategies)\n\n2. Initialize a new `Project` instead of `cdk.App`:\n\n    ```ts\n    // bin/app.ts\n    import { Project, AccountStrategy } from '@alma-cdk/project';\n\n    const project = new Project({\n      // Basic info, you could also read these from package.json if you want\n      name: 'my-cool-project',\n      author: {\n        organization: 'Acme Corp',\n        name: 'Mad Scientists',\n        email: 'mad.scientists@acme.example.com',\n      },\n\n      // If not set, defaults to one of: $CDK_DEFAULT_REGION, $AWS_REGION or us-east-1\n      defaultRegion: 'eu-west-1',\n\n      // Configures the project to use 2 AWS accounts (recommended)\n      accounts: AccountStrategy.two({\n        dev: {\n          id: '111111111111',\n          config: {\n            // whatever you want here as [string]: any\n            baseDomain: 'example.net',\n          },\n        },\n        prod: {\n          id: '222222222222',\n          config: {\n            // whatever you want here as [string]: any\n            baseDomain: 'example.com',\n          },\n        },\n      }),\n    })\n    ```\n\n3. Define a stack which `extends SmartStack` with resources:\n    ```ts\n    // lib/my-stack.ts\n    import { Construct } from 'constructs';\n    import { StackProps, RemovalPolicy } from 'aws-cdk-lib';\n    import { SmartStack, Name, UrlName, PathName, EC } from '@alma-cdk/project';\n\n    export class MyStack extends SmartStack {\n      constructor(scope: Construct, id: string, props: StackProps) {\n        super(scope, id, props);\n\n        new dynamodb.Table(this, 'Table', {\n          removalPolicy: EC.isStable(this) ? RemovalPolicy.RETAIN : RemovalPolicy.DESTROY,\n\n          tableName: Name.it(this, 'MyTable'),\n          partitionKey: {\n            type: dynamodb.AttributeType.STRING,\n            name: 'pk',\n          },\n          // StagingMyTable\n        });\n\n        new events.EventBus(this, 'EventBus', {\n          eventBusName: Name.withProject(this, 'MyEventBus'),\n          // MyCoolProjectStagingMyEventBus\n        });\n\n        new s3.Bucket(this, 'Bucket', {\n\n          removalPolicy: EC.isStable(this) ? RemovalPolicy.RETAIN : RemovalPolicy.DESTROY,\n          autoDeleteObjects: EC.isStable(this) ? false : true,\n\n          bucketName: UrlName.globally(this, 'MyBucket'),\n          // acme-corp-my-cool-project-feature-foo-bar-my-bucket\n        });\n\n        new ssm.StringParameter(this, 'Parameter', {\n          stringValue: 'Foo',\n          tier: ssm.ParameterTier.ADVANCED,\n          parameterName: PathName.withProject(this, 'MyNamespace/MyParameter'),\n          // /MyCoolProject/Staging/MyNamespace/MyParameter\n        });\n      }\n    }\n    ```\n\n4. Define a new _environmental_ which `extends EnvironmentWrapper` and initialize all your environmental `SmartStack` stacks within:\n\n    ```ts\n    // lib/environment.ts\n    import { Construct } from 'constructs';\n    import { EnvironmentWrapper } from '@alma-cdk/project';\n    import { MyStack } from './my-stack';\n\n    export class Environment extends EnvironmentWrapper {\n      constructor(scope: Construct) {\n        super(scope);\n        new MyStack(this, 'MyStack', { description: 'This is required' });\n      }\n    }\n    ```\n\n    Resulting Stack properties (given `environment=staging`):\n\n    |        Property         |                    Example value                     |\n    | :---------------------- | :--------------------------------------------------- |\n    | `stackName`             | `\"MyCoolProject-Environment-Staging-MyExampleStack\"` |\n    | `terminationProtection` | `true`                                               |\n    | `env.account`           | `\"111111111111\"`                                     |\n    | `env.region`            | `\"eu-west-1\"`                                        |\n\n    Resulting Tags for the Stack and its resources (given `environment=staging`):\n\n    |        Property         |           Example value           |\n    | :---------------------- | :-------------------------------- |\n    | `Account`               | `dev`                             |\n    | `Environment`           | `staging`                         |\n    | `Project`               | `my-cool-project`                 |\n    | `Author`                | `Mad Scientists`                  |\n    | `Organization`          | `Acme Corp`                       |\n    | `Contact`               | `mad.scientists@acme.example.com` |\n\n5. Finally initialize the environment with the `Project` scope:\n\n    ```ts\n    // bin/app.ts\n    import { Project, Accounts } from '@alma-cdk/project';\n    import { Environment } from '../lib/environment';\n\n    const project = new Project({/* removed for brevity, see step 1 */})\n\n    new Environment(project);\n    ```\n\n<br/>\n\n\n## Documentation\n\nSee detailed documentation for specific classes & methods at [constructs.dev](http://constructs.dev/packages/@alma-cdk/project).\n\nGenerally speaking you would be most interested in the following:\n- Project\n- AccountStrategy\n- SmartStack\n- AccountWrapper & EnvironmentWrapper\n- AccountContext (AC)\n- EnvironmentContext (EC)\n- Name / UrlName / PathName\n"
+    "markdown": "<div align=\"center\">\n\t<br/>\n\t<br/>\n  <h1>\n\t<img width=\"300\" src=\"assets/alma-cdk-project.svg\" alt=\"Alma CDK Project\" />\n  <br/>\n  <br/>\n  </h1>\n\n  ![NPM License](https://img.shields.io/npm/l/%40alma-cdk%2Fproject)\n  [![release](https://github.com/alma-cdk/project/actions/workflows/release.yml/badge.svg)](https://github.com/alma-cdk/project/actions/workflows/release.yml)\n\n  ```sh\n  npm i -D @alma-cdk/project\n  ```\n\n  <div align=\"left\">\n\n  Opinionated CDK “framework” with constructs & utilities for:\n  - deploying multiple environments to multiple accounts (with many-to-many relationship)\n  - managing account configuration through standardized props (no more random config files)\n  - querying account and/or environment specific information within your CDK code\n  - enabling dynamic & short-lived “feature-environments”\n  - enabling well-defined tagging\n  - providing structure & common conventions to CDK projects\n  - choosing the target account & environment by passing in runtime context:\n\n    ```sh\n    npx cdk deploy -c account=dev -c environment=feature/abc-123\n    ```\n    ... which means you don't need to define all the possibile environments ahead of time!\n\n  </div>\n  <br/>\n</div>\n\n\n## Account Strategies\n\nDepending on the use case, you may choose a configuration between 1-3 AWS accounts with the following environments:\n\n\n1. **Shared account (`shared`)**:\n\n    ![default-multi](assets/accounts-1x.svg)\n    <br/>\n\n2. **Multi-account (`dev`+`prod`)**_– RECOMMENDED_:\n\n    ![default-multi](assets/accounts-2x.svg)\n    <br/>\n\n<br/>\n</details>\n\n3. **Multi-account (`dev`+`preprod`+`prod`)**:\n\n    ![default-multi](assets/accounts-3x.svg)\n    <br/>\n\n<br/>\n\n## Getting Started\n\nSteps required to define a _environmental_ project resources; At first, it might seem complex but once you get into the habbit of defining your projects this way it starts to make sense:\n\n1. Choose your [Account Strategy](#account-strategies)\n\n2. Initialize a new `Project` instead of `cdk.App`:\n\n    ```ts\n    // bin/app.ts\n    import { Project, AccountStrategy } from '@alma-cdk/project';\n\n    const project = new Project({\n      // Basic info, you could also read these from package.json if you want\n      name: 'my-cool-project',\n      author: {\n        organization: 'Acme Corp',\n        name: 'Mad Scientists',\n        email: 'mad.scientists@acme.example.com',\n      },\n\n      // If not set, defaults to one of: $CDK_DEFAULT_REGION, $AWS_REGION or us-east-1\n      defaultRegion: 'eu-west-1',\n\n      // Configures the project to use 2 AWS accounts (recommended)\n      accounts: AccountStrategy.two({\n        dev: {\n          id: '111111111111',\n          config: {\n            // whatever you want here as [string]: any\n            baseDomain: 'example.net',\n          },\n        },\n        prod: {\n          id: '222222222222',\n          config: {\n            // whatever you want here as [string]: any\n            baseDomain: 'example.com',\n          },\n        },\n      }),\n    })\n    ```\n\n3. Define a stack which `extends SmartStack` with resources:\n    ```ts\n    // lib/my-stack.ts\n    import { Construct } from 'constructs';\n    import { StackProps, RemovalPolicy } from 'aws-cdk-lib';\n    import { SmartStack, Name, UrlName, PathName, EC } from '@alma-cdk/project';\n\n    export class MyStack extends SmartStack {\n      constructor(scope: Construct, id: string, props: StackProps) {\n        super(scope, id, props);\n\n        new dynamodb.Table(this, 'Table', {\n          removalPolicy: EC.isStable(this) ? RemovalPolicy.RETAIN : RemovalPolicy.DESTROY,\n\n          tableName: Name.it(this, 'MyTable'),\n          partitionKey: {\n            type: dynamodb.AttributeType.STRING,\n            name: 'pk',\n          },\n          // StagingMyTable\n        });\n\n        new events.EventBus(this, 'EventBus', {\n          eventBusName: Name.withProject(this, 'MyEventBus'),\n          // MyCoolProjectStagingMyEventBus\n        });\n\n        new s3.Bucket(this, 'Bucket', {\n\n          removalPolicy: EC.isStable(this) ? RemovalPolicy.RETAIN : RemovalPolicy.DESTROY,\n          autoDeleteObjects: EC.isStable(this) ? false : true,\n\n          bucketName: UrlName.globally(this, 'MyBucket'),\n          // acme-corp-my-cool-project-feature-foo-bar-my-bucket\n        });\n\n        new ssm.StringParameter(this, 'Parameter', {\n          stringValue: 'Foo',\n          tier: ssm.ParameterTier.ADVANCED,\n          parameterName: PathName.withProject(this, 'MyNamespace/MyParameter'),\n          // /MyCoolProject/Staging/MyNamespace/MyParameter\n        });\n      }\n    }\n    ```\n\n4. Define a new _environmental_ which `extends EnvironmentWrapper` and initialize all your environmental `SmartStack` stacks within:\n\n    ```ts\n    // lib/environment.ts\n    import { Construct } from 'constructs';\n    import { EnvironmentWrapper } from '@alma-cdk/project';\n    import { MyStack } from './my-stack';\n\n    export class Environment extends EnvironmentWrapper {\n      constructor(scope: Construct) {\n        super(scope);\n        new MyStack(this, 'MyStack', { description: 'This is required' });\n      }\n    }\n    ```\n\n    Resulting Stack properties (given `environment=staging`):\n\n    |        Property         |                    Example value                     |\n    | :---------------------- | :--------------------------------------------------- |\n    | `stackName`             | `\"MyCoolProject-Environment-Staging-MyExampleStack\"` |\n    | `terminationProtection` | `true`                                               |\n    | `env.account`           | `\"111111111111\"`                                     |\n    | `env.region`            | `\"eu-west-1\"`                                        |\n\n    Resulting Tags for the Stack and its resources (given `environment=staging`):\n\n    |        Property         |           Example value           |\n    | :---------------------- | :-------------------------------- |\n    | `Account`               | `dev`                             |\n    | `Environment`           | `staging`                         |\n    | `Project`               | `my-cool-project`                 |\n    | `Author`                | `Mad Scientists`                  |\n    | `Organization`          | `Acme Corp`                       |\n    | `Contact`               | `mad.scientists@acme.example.com` |\n\n5. Finally initialize the environment with the `Project` scope:\n\n    ```ts\n    // bin/app.ts\n    import { Project, Accounts } from '@alma-cdk/project';\n    import { Environment } from '../lib/environment';\n\n    const project = new Project({/* removed for brevity, see step 1 */})\n\n    new Environment(project);\n    ```\n\n<br/>\n\n\n## Documentation\n\nSee detailed documentation for specific classes & methods at [constructs.dev](http://constructs.dev/packages/@alma-cdk/project).\n\nGenerally speaking you would be most interested in the following:\n- Project\n- AccountStrategy\n- SmartStack\n- AccountWrapper & EnvironmentWrapper\n- AccountContext (AC)\n- EnvironmentContext (EC)\n- Name / UrlName / PathName\n\n## Migration\n\n### v0 to v1\n\n#### Tagging behavior\n\nDue to a bug in `v0`, the `Contact` and `Organization` tags were NOT applied as they should have. This means that by default, upgrading from v0→v1 introduces CloudFormation diff. Basically adding the `Contact` and `Organization` tags to all resources. This should be safe operation, but we allow disabling it via a feature flag (note that `Contact` and `Organization` tags will most likely be enforced in future `v2`).\n\n```diff\n// cdk.json\n{\n  \"context\": {\n    // existing context keys\n+   \"@alma-cdk/project:compatibility:v0:tags\": true\n  },\n}\n```\n"
   },
   "repository": {
     "type": "git",
@@ -3696,14 +3696,14 @@
       "assembly": "@alma-cdk/project",
       "datatype": true,
       "docs": {
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "AWS account configuration."
       },
       "fqn": "@alma-cdk/project.Account",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/project/interfaces.ts",
-        "line": 3
+        "line": 2
       },
       "name": "Account",
       "properties": [
@@ -3711,13 +3711,13 @@
           "abstract": true,
           "docs": {
             "example": "'123456789012'",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "AWS Account ID."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/project/interfaces.ts",
-            "line": 10
+            "line": 8
           },
           "name": "id",
           "type": {
@@ -3729,13 +3729,13 @@
           "docs": {
             "example": "{\n  dev: {\n    id: '111111111111',\n    config: {\n      baseDomain: 'example.net',\n    },\n  },\n  prod: {\n    id: '222222222222',\n    config: {\n      baseDomain: 'example.com',\n    },\n  },\n},",
             "remarks": "For example VPC IDs (for existing VPCs), Direct Connect Gateway IDs, apex domain names (for Route53 Zone lookups), etc. Basically configuration for resources that are defined outside of this CDK application.",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "AWS account specific configuration."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/project/interfaces.ts",
-            "line": 42
+            "line": 40
           },
           "name": "config",
           "optional": true,
@@ -3753,13 +3753,13 @@
           "docs": {
             "example": "[\"development\", \"feature/.*\"]",
             "remarks": "List of strings or strings representing regexp initialization (passed onto `new Regexp(\"^\"+environment+\"$\", \"i\")`).",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "List of accepted environments for the given account."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/project/interfaces.ts",
-            "line": 20
+            "line": 18
           },
           "name": "environments",
           "optional": true,
@@ -3779,7 +3779,7 @@
       "assembly": "@alma-cdk/project",
       "datatype": true,
       "docs": {
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "Interface for a single account type configuration."
       },
       "fqn": "@alma-cdk/project.AccountConfiguration",
@@ -3793,7 +3793,7 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
@@ -3808,7 +3808,7 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
@@ -3832,27 +3832,27 @@
     "@alma-cdk/project.AccountContext": {
       "assembly": "@alma-cdk/project",
       "docs": {
-        "stability": "experimental"
+        "stability": "stable"
       },
       "fqn": "@alma-cdk/project.AccountContext",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         }
       },
       "kind": "class",
       "locationInModule": {
         "filename": "src/context/account.ts",
-        "line": 6
+        "line": 5
       },
       "methods": [
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/context/account.ts",
-            "line": 13
+            "line": 11
           },
           "name": "getAccountConfig",
           "parameters": [
@@ -3878,11 +3878,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/context/account.ts",
-            "line": 8
+            "line": 6
           },
           "name": "getAccountId",
           "parameters": [
@@ -3902,11 +3902,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/context/account.ts",
-            "line": 17
+            "line": 15
           },
           "name": "getAccountType",
           "parameters": [
@@ -3926,11 +3926,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/context/account.ts",
-            "line": 29
+            "line": 27
           },
           "name": "isDev",
           "parameters": [
@@ -3950,11 +3950,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/context/account.ts",
-            "line": 21
+            "line": 19
           },
           "name": "isMock",
           "parameters": [
@@ -3974,11 +3974,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/context/account.ts",
-            "line": 33
+            "line": 31
           },
           "name": "isPreProd",
           "parameters": [
@@ -3998,11 +3998,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/context/account.ts",
-            "line": 37
+            "line": 35
           },
           "name": "isProd",
           "parameters": [
@@ -4022,11 +4022,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/context/account.ts",
-            "line": 25
+            "line": 23
           },
           "name": "isShared",
           "parameters": [
@@ -4053,13 +4053,13 @@
       "assembly": "@alma-cdk/project",
       "docs": {
         "remarks": "Available strategies are:\n- One Account: `shared`\n- Two Accounts: `dev`+`prod` – _recommended_\n- Three Accounts: `dev`+`preprod`+`prod`",
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "Use static methods of `AccountStrategy` abstract class to define your account strategy."
       },
       "fqn": "@alma-cdk/project.AccountStrategy",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         }
       },
       "kind": "class",
@@ -4072,12 +4072,12 @@
           "docs": {
             "example": "AccountStrategy.one({\n  shared: {\n    id: '111111111111',\n  },\n}),",
             "remarks": "1. `shared` account with environments:\n   - development\n   - feature/*\n   - test\n   - qaN\n   - staging\n   - preproduction\n   - production",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Enables single account strategy."
           },
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 74
+            "line": 73
           },
           "name": "one",
           "parameters": [
@@ -4104,12 +4104,12 @@
           "docs": {
             "example": "AccountStrategy.three({\n  dev: {\n    id: '111111111111',\n  },\n  preprod: {\n    id: '222222222222',\n  },\n  prod: {\n    id: '333333333333',\n  },\n}),",
             "remarks": "1. `dev` account with environments:\n   - development\n   - feature/*\n   - test\n   - staging\n2. `preprod` account with environments:\n   - qaN\n   - preproduction\n3. `prod` account with environments:\n   - production",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Enables triple account strategy."
           },
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 177
+            "line": 172
           },
           "name": "three",
           "parameters": [
@@ -4136,12 +4136,12 @@
           "docs": {
             "example": "AccountStrategy.two({\n  dev: {\n    id: '111111111111',\n  },\n  prod: {\n    id: '222222222222',\n  },\n}),",
             "remarks": "1. `dev` account with environments:\n   - development\n   - feature/*\n   - test\n   - qaN\n   - staging\n2. `prod` account with environments:\n   - preproduction\n   - production",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Enables dual account strategy."
           },
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 121
+            "line": 118
           },
           "name": "two",
           "parameters": [
@@ -4172,7 +4172,7 @@
       "assembly": "@alma-cdk/project",
       "datatype": true,
       "docs": {
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "Props `AccountStrategy.one`."
       },
       "fqn": "@alma-cdk/project.AccountStrategyOneProps",
@@ -4186,7 +4186,7 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
@@ -4201,7 +4201,7 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
@@ -4221,7 +4221,7 @@
       "assembly": "@alma-cdk/project",
       "datatype": true,
       "docs": {
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "Props `AccountStrategy.three`."
       },
       "fqn": "@alma-cdk/project.AccountStrategyThreeProps",
@@ -4235,7 +4235,7 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
@@ -4250,7 +4250,7 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
@@ -4265,7 +4265,7 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
@@ -4280,7 +4280,7 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
@@ -4300,7 +4300,7 @@
       "assembly": "@alma-cdk/project",
       "datatype": true,
       "docs": {
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "Props `AccountStrategy.two`."
       },
       "fqn": "@alma-cdk/project.AccountStrategyTwoProps",
@@ -4314,7 +4314,7 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
@@ -4329,7 +4329,7 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
@@ -4344,7 +4344,7 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
@@ -4363,13 +4363,13 @@
     "@alma-cdk/project.AccountType": {
       "assembly": "@alma-cdk/project",
       "docs": {
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "Internal class to handle set/get operations for Account Type."
       },
       "fqn": "@alma-cdk/project.AccountType",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         }
       },
       "kind": "class",
@@ -4380,11 +4380,11 @@
       "methods": [
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/account-type.ts",
-            "line": 16
+            "line": 15
           },
           "name": "get",
           "parameters": [
@@ -4404,7 +4404,7 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/account-type.ts",
@@ -4445,11 +4445,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/account-type.ts",
-            "line": 11
+            "line": 10
           },
           "name": "set",
           "parameters": [
@@ -4476,17 +4476,17 @@
       "assembly": "@alma-cdk/project",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "Wrapper for account-level stacks."
       },
       "fqn": "@alma-cdk/project.AccountWrapper",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         },
         "locationInModule": {
           "filename": "src/wrapper/account.ts",
-          "line": 10
+          "line": 9
         },
         "parameters": [
           {
@@ -4505,19 +4505,68 @@
       "name": "AccountWrapper",
       "symbolId": "src/wrapper/account:AccountWrapper"
     },
+    "@alma-cdk/project.Acknowledgeable": {
+      "assembly": "@alma-cdk/project",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Interface for acknowledging warnings."
+      },
+      "fqn": "@alma-cdk/project.Acknowledgeable",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/project/project.ts",
+        "line": 10
+      },
+      "name": "Acknowledgeable",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/project/project.ts",
+            "line": 11
+          },
+          "name": "id",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/project/project.ts",
+            "line": 12
+          },
+          "name": "message",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/project/project:Acknowledgeable"
+    },
     "@alma-cdk/project.Author": {
       "assembly": "@alma-cdk/project",
       "datatype": true,
       "docs": {
         "remarks": "I.e. who owns/develops this project/service.",
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "Author information."
       },
       "fqn": "@alma-cdk/project.Author",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/project/interfaces.ts",
-        "line": 46
+        "line": 44
       },
       "name": "Author",
       "properties": [
@@ -4525,13 +4574,13 @@
           "abstract": true,
           "docs": {
             "example": "'Mad Scientists'",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Human-readable name for the team/contact responsible for this project/service."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/project/interfaces.ts",
-            "line": 60
+            "line": 57
           },
           "name": "name",
           "type": {
@@ -4542,13 +4591,13 @@
           "abstract": true,
           "docs": {
             "example": "'mad.scientists@acme.example.com'",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Email address for the team/contact responsible for this project/service."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/project/interfaces.ts",
-            "line": 67
+            "line": 64
           },
           "name": "email",
           "optional": true,
@@ -4560,13 +4609,13 @@
           "abstract": true,
           "docs": {
             "example": "'Acme Corp'",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Human-readable name for the organization responsible for this project/service."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/project/interfaces.ts",
-            "line": 53
+            "line": 50
           },
           "name": "organization",
           "optional": true,
@@ -4580,16 +4629,16 @@
     "@alma-cdk/project.EnvRegExp": {
       "assembly": "@alma-cdk/project",
       "docs": {
-        "stability": "experimental"
+        "stability": "stable"
       },
       "fqn": "@alma-cdk/project.EnvRegExp",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         },
         "locationInModule": {
           "filename": "src/project/envregexp.ts",
-          "line": 6
+          "line": 4
         },
         "parameters": [
           {
@@ -4603,16 +4652,16 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/project/envregexp.ts",
-        "line": 3
+        "line": 1
       },
       "methods": [
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/envregexp.ts",
-            "line": 10
+            "line": 8
           },
           "name": "test",
           "parameters": [
@@ -4637,43 +4686,43 @@
       "assembly": "@alma-cdk/project",
       "docs": {
         "remarks": "Categories are useful grouping to make distinction between `stable`\nenvironments (`staging` & `production`) from `feature` or `verification`\nenvironments (such as `test` or `preproduction`).",
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "Availalbe Enviroment Categories."
       },
       "fqn": "@alma-cdk/project.EnvironmentCategory",
       "kind": "enum",
       "locationInModule": {
         "filename": "src/configurations/environments.ts",
-        "line": 22
+        "line": 20
       },
       "members": [
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "name": "MOCK"
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "name": "DEVELOPMENT"
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "name": "FEATURE"
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "name": "VERIFICATION"
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "name": "STABLE"
         }
@@ -4684,18 +4733,18 @@
     "@alma-cdk/project.EnvironmentContext": {
       "assembly": "@alma-cdk/project",
       "docs": {
-        "stability": "experimental"
+        "stability": "stable"
       },
       "fqn": "@alma-cdk/project.EnvironmentContext",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         }
       },
       "kind": "class",
       "locationInModule": {
         "filename": "src/context/environment.ts",
-        "line": 6
+        "line": 11
       },
       "methods": [
         {
@@ -4703,12 +4752,12 @@
             "example": "'mock'\n'development'\n'feature'\n'verification'\n'stable'",
             "remarks": "Categories are useful grouping to make distinction between `stable`\nenvironments (`staging` & `production`) from `feature` or `verification`\nenvironments (such as `test` or `preproduction`).",
             "returns": "Environment Category",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Get Environment Category."
           },
           "locationInModule": {
             "filename": "src/context/environment.ts",
-            "line": 102
+            "line": 106
           },
           "name": "getCategory",
           "parameters": [
@@ -4733,12 +4782,12 @@
           "docs": {
             "remarks": "If environment belongs to `feature` category,\nthis will return a string describing the feature (sting after `feature/`-prefix).\n\nIf environment is not a feature environment, will return an empty string.",
             "returns": "string indicating the feature this environment relates to, if not feature environment returns an empty string",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Get Feature Info."
           },
           "locationInModule": {
             "filename": "src/context/environment.ts",
-            "line": 176
+            "line": 195
           },
           "name": "getFeatureInfo",
           "parameters": [
@@ -4764,12 +4813,12 @@
             "example": "'mock'\n'development'\n'feature'\n'test'\n'staging'\n'qa'\n'preproduction'\n'production'",
             "remarks": "Labels are useful since Environment Name can be complex,\nsuch as `feature/foo-bar` or `qa3`,\nbut we need to be able to “label” all `feature/*` and `qaN` environments\nas either `feature` or `qa`.",
             "returns": "Environment Label",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Get Environment Label."
           },
           "locationInModule": {
             "filename": "src/context/environment.ts",
-            "line": 80
+            "line": 84
           },
           "name": "getLabel",
           "parameters": [
@@ -4794,12 +4843,12 @@
           "docs": {
             "example": "'mock1'\n'mock2'\n'mock3'\n'development'\n'feature/foo-bar'\n'feature/ABC-123/new-stuff'\n'test'\n'staging'\n'qa1'\n'qa2'\n'qa3'\n'preproduction'\n'production'",
             "returns": "Environment Name (as given via `--context environment`)",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Get Environment Name."
           },
           "locationInModule": {
             "filename": "src/context/environment.ts",
-            "line": 29
+            "line": 33
           },
           "name": "getName",
           "parameters": [
@@ -4824,12 +4873,12 @@
           "docs": {
             "example": "'mock1'\n'mock2'\n'mock3'\n'development'\n'feature-foo-bar'\n'feature-abc-123-new-stuff'\n'test'\n'staging'\n'qa1'\n'qa2'\n'qa3'\n'preproduction'\n'production'",
             "returns": "Environment URL/DNS Compatible Name (as given via `--context environment` but `param-cased`)",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Get Environment URL/DNS Compatible Name."
           },
           "locationInModule": {
             "filename": "src/context/environment.ts",
-            "line": 54
+            "line": 58
           },
           "name": "getUrlName",
           "parameters": [
@@ -4854,12 +4903,12 @@
           "docs": {
             "remarks": "Returns true for `development`, otherwise `false`.",
             "returns": "boolean indicating does Environment belong to `development` category",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Check if Environment is part of `development` category."
           },
           "locationInModule": {
             "filename": "src/context/environment.ts",
-            "line": 125
+            "line": 132
           },
           "name": "isDevelopment",
           "parameters": [
@@ -4884,12 +4933,12 @@
           "docs": {
             "remarks": "Returns `true` for environments with name beginning with `feature/`-prefix, otherwise `false`.",
             "returns": "boolean indicating does Environment belong to `feature` category",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Check if Environment is part of `feature` category."
           },
           "locationInModule": {
             "filename": "src/context/environment.ts",
-            "line": 137
+            "line": 147
           },
           "name": "isFeature",
           "parameters": [
@@ -4913,12 +4962,12 @@
         {
           "docs": {
             "returns": "boolean indicating does Environment belong to `mock` category",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Check if Environment is part of `mock` category."
           },
           "locationInModule": {
             "filename": "src/context/environment.ts",
-            "line": 113
+            "line": 117
           },
           "name": "isMock",
           "parameters": [
@@ -4943,12 +4992,12 @@
           "docs": {
             "remarks": "Returns `true` for `staging` & `production`, otherwise `false`.",
             "returns": "boolean indicating does Environment belong to `stable` category",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Check if Environment is part of `stable` category."
           },
           "locationInModule": {
             "filename": "src/context/environment.ts",
-            "line": 161
+            "line": 177
           },
           "name": "isStable",
           "parameters": [
@@ -4973,12 +5022,12 @@
           "docs": {
             "remarks": "Returns `true` for `test` & `preproduction`, otherwise `false`.",
             "returns": "boolean indicating does Environment belong to `verification` category",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Check if Environment is part of `verification` category."
           },
           "locationInModule": {
             "filename": "src/context/environment.ts",
-            "line": 149
+            "line": 162
           },
           "name": "isVerification",
           "parameters": [
@@ -5007,61 +5056,61 @@
       "assembly": "@alma-cdk/project",
       "docs": {
         "remarks": "Labels are useful since Environment Name can be complex,\nsuch as `feature/foo-bar` or `qa3`,\nbut we need to be able to “label” all `feature/*` and `qaN` environments\nas either `feature` or `qa`.",
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "Available Environment Labels."
       },
       "fqn": "@alma-cdk/project.EnvironmentLabel",
       "kind": "enum",
       "locationInModule": {
         "filename": "src/configurations/environments.ts",
-        "line": 38
+        "line": 36
       },
       "members": [
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "name": "MOCK"
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "name": "DEVELOPMENT"
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "name": "FEATURE"
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "name": "TEST"
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "name": "STAGING"
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "name": "QA"
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "name": "PREPRODUCTION"
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "name": "PRODUCTION"
         }
@@ -5072,28 +5121,28 @@
     "@alma-cdk/project.EnvironmentType": {
       "assembly": "@alma-cdk/project",
       "docs": {
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "Internal class to handle set/get operations for Environment Type."
       },
       "fqn": "@alma-cdk/project.EnvironmentType",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         }
       },
       "kind": "class",
       "locationInModule": {
         "filename": "src/project/environment-type.ts",
-        "line": 9
+        "line": 8
       },
       "methods": [
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/environment-type.ts",
-            "line": 26
+            "line": 24
           },
           "name": "get",
           "parameters": [
@@ -5124,11 +5173,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/environment-type.ts",
-            "line": 11
+            "line": 9
           },
           "name": "set",
           "parameters": [
@@ -5149,11 +5198,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/environment-type.ts",
-            "line": 17
+            "line": 15
           },
           "name": "tryGet",
           "parameters": [
@@ -5180,13 +5229,13 @@
       "assembly": "@alma-cdk/project",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "Wrapper for environmental stacks."
       },
       "fqn": "@alma-cdk/project.EnvironmentWrapper",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         },
         "locationInModule": {
           "filename": "src/wrapper/environment.ts",
@@ -5213,12 +5262,12 @@
       "abstract": true,
       "assembly": "@alma-cdk/project",
       "docs": {
-        "stability": "experimental"
+        "stability": "stable"
       },
       "fqn": "@alma-cdk/project.Name",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         }
       },
       "kind": "class",
@@ -5229,12 +5278,12 @@
       "methods": [
         {
           "docs": {
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "PascalCase naming with global prefixes (org, project…)."
           },
           "locationInModule": {
             "filename": "src/name/name.ts",
-            "line": 40
+            "line": 47
           },
           "name": "globally",
           "parameters": [
@@ -5267,11 +5316,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/name/name.ts",
-            "line": 16
+            "line": 15
           },
           "name": "it",
           "parameters": [
@@ -5304,11 +5353,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/name/name.ts",
-            "line": 26
+            "line": 29
           },
           "name": "withProject",
           "parameters": [
@@ -5347,25 +5396,25 @@
       "assembly": "@alma-cdk/project",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "stable"
       },
       "fqn": "@alma-cdk/project.NameProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/name/interfaces.ts",
-        "line": 3
+        "line": 1
       },
       "name": "NameProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/name/interfaces.ts",
-            "line": 4
+            "line": 2
           },
           "name": "maxLength",
           "optional": true,
@@ -5376,12 +5425,12 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/name/interfaces.ts",
-            "line": 5
+            "line": 3
           },
           "name": "trim",
           "optional": true,
@@ -5397,12 +5446,12 @@
       "assembly": "@alma-cdk/project",
       "base": "@alma-cdk/project.UrlName",
       "docs": {
-        "stability": "experimental"
+        "stability": "stable"
       },
       "fqn": "@alma-cdk/project.PathName",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         }
       },
       "kind": "class",
@@ -5413,12 +5462,12 @@
       "methods": [
         {
           "docs": {
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "PascalCase naming with global prefixes (org, project…)."
           },
           "locationInModule": {
             "filename": "src/name/name-path.ts",
-            "line": 20
+            "line": 28
           },
           "name": "globally",
           "overrides": "@alma-cdk/project.UrlName",
@@ -5452,7 +5501,7 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/name/name-path.ts",
@@ -5490,11 +5539,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/name/name-path.ts",
-            "line": 14
+            "line": 18
           },
           "name": "withProject",
           "overrides": "@alma-cdk/project.UrlName",
@@ -5536,18 +5585,18 @@
       "docs": {
         "example": "// new Project instead of new App\nconst project = new Project({\n  name: 'my-cool-project',\n  author: {\n    organization: 'Acme Corp',\n    name: 'Mad Scientists',\n    email: 'mad.scientists@acme.example.com',\n  },\n  defaultRegion: 'eu-west-1', // defaults to one of: $CDK_DEFAULT_REGION, $AWS_REGION or us-east-1\n  accounts: {\n    dev: {\n      id: '111111111111',\n      environments: ['development', 'feature/.*', 'staging'],\n      config: {\n        baseDomain: 'example.net',\n      },\n    },\n    prod: {\n      id: '222222222222',\n      environments: ['production'],\n      config: {\n        baseDomain: 'example.com',\n      },\n    },\n  },\n})",
         "remarks": "Use it like you would `cdk.App` and assign stacks into it.",
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "High-level wrapper for `cdk.App` with specific requirements for props."
       },
       "fqn": "@alma-cdk/project.Project",
       "initializer": {
         "docs": {
-          "stability": "experimental",
+          "stability": "stable",
           "summary": "Initializes a new Project (which can be used in place of cdk.App)."
         },
         "locationInModule": {
           "filename": "src/project/project.ts",
-          "line": 77
+          "line": 86
         },
         "parameters": [
           {
@@ -5561,17 +5610,17 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/project/project.ts",
-        "line": 45
+        "line": 53
       },
       "methods": [
         {
           "docs": {
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Return account configuration."
           },
           "locationInModule": {
             "filename": "src/project/project.ts",
-            "line": 64
+            "line": 72
           },
           "name": "getAccount",
           "parameters": [
@@ -5597,12 +5646,12 @@
         },
         {
           "docs": {
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Return the project configuration as given in ProjectProps."
           },
           "locationInModule": {
             "filename": "src/project/project.ts",
-            "line": 51
+            "line": 58
           },
           "name": "getConfiguration",
           "parameters": [
@@ -5619,6 +5668,30 @@
             }
           },
           "static": true
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Acknowledge warnings for all stacks in the project."
+          },
+          "locationInModule": {
+            "filename": "src/project/project.ts",
+            "line": 111
+          },
+          "name": "acknowledgeWarnings",
+          "parameters": [
+            {
+              "name": "acknowledgements",
+              "type": {
+                "collection": {
+                  "elementtype": {
+                    "fqn": "@alma-cdk/project.Acknowledgeable"
+                  },
+                  "kind": "array"
+                }
+              }
+            }
+          ]
         }
       ],
       "name": "Project",
@@ -5626,13 +5699,13 @@
         {
           "const": true,
           "docs": {
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Namespace/key how this tool internally keeps track of the project configuration."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/project/project.ts",
-            "line": 48
+            "line": 55
           },
           "name": "CONTEXT_SCOPE",
           "static": true,
@@ -5647,13 +5720,13 @@
       "assembly": "@alma-cdk/project",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "stable"
       },
       "fqn": "@alma-cdk/project.ProjectConfiguration",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/project/interfaces.ts",
-        "line": 70
+        "line": 67
       },
       "name": "ProjectConfiguration",
       "properties": [
@@ -5662,13 +5735,13 @@
           "docs": {
             "example": "accounts: {\n  dev: {\n    id: '111111111111',\n    config: {\n      baseDomain: 'example.net',\n    },\n  },\n  prod: {\n    id: '222222222222',\n    config: {\n      baseDomain: 'example.com',\n    },\n  },\n},",
             "remarks": "The key value can be anything (such as AWS Account alias), but it's recommended to keep it short such as `dev` or `prod`.",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Dictionary of AWS account specific configuration."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/project/interfaces.ts",
-            "line": 114
+            "line": 110
           },
           "name": "accounts",
           "type": {
@@ -5684,13 +5757,13 @@
           "abstract": true,
           "docs": {
             "remarks": "I.e. who owns/develops this project/service.",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Author information."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/project/interfaces.ts",
-            "line": 82
+            "line": 78
           },
           "name": "author",
           "type": {
@@ -5702,13 +5775,13 @@
           "docs": {
             "example": "'my-cool-project'",
             "remarks": "Prefer `hyphen-case`.",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Name of your project/service."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/project/interfaces.ts",
-            "line": 79
+            "line": 75
           },
           "name": "name",
           "type": {
@@ -5719,13 +5792,13 @@
           "abstract": true,
           "docs": {
             "remarks": "If left empty will default to one of the following in order:\n1. `$CDK_DEFAULT_REGION`\n2. `$AWS_REGION`\n3. 'us-east-1'",
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Specify default region you wish to use."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/project/interfaces.ts",
-            "line": 92
+            "line": 88
           },
           "name": "defaultRegion",
           "optional": true,
@@ -5739,12 +5812,12 @@
     "@alma-cdk/project.ProjectContext": {
       "assembly": "@alma-cdk/project",
       "docs": {
-        "stability": "experimental"
+        "stability": "stable"
       },
       "fqn": "@alma-cdk/project.ProjectContext",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         }
       },
       "kind": "class",
@@ -5755,7 +5828,7 @@
       "methods": [
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/project-context.ts",
@@ -5792,7 +5865,7 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/project-context.ts",
@@ -5816,7 +5889,7 @@
         },
         {
           "docs": {
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "Returns the account type given in runtime/CLI context."
           },
           "locationInModule": {
@@ -5841,11 +5914,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/project-context.ts",
-            "line": 59
+            "line": 66
           },
           "name": "getAllowedEnvironments",
           "parameters": [
@@ -5870,11 +5943,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/project-context.ts",
-            "line": 54
+            "line": 61
           },
           "name": "getAuthorEmail",
           "parameters": [
@@ -5895,11 +5968,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/project-context.ts",
-            "line": 49
+            "line": 56
           },
           "name": "getAuthorName",
           "parameters": [
@@ -5919,11 +5992,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/project-context.ts",
-            "line": 44
+            "line": 51
           },
           "name": "getAuthorOrganization",
           "parameters": [
@@ -5944,11 +6017,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/project-context.ts",
-            "line": 34
+            "line": 41
           },
           "name": "getDefaultRegion",
           "parameters": [
@@ -5968,11 +6041,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/project-context.ts",
-            "line": 68
+            "line": 75
           },
           "name": "getEnvironment",
           "parameters": [
@@ -5992,11 +6065,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/project-context.ts",
-            "line": 39
+            "line": 46
           },
           "name": "getName",
           "parameters": [
@@ -6016,11 +6089,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/project/project-context.ts",
-            "line": 64
+            "line": 71
           },
           "name": "tryGetEnvironment",
           "parameters": [
@@ -6048,7 +6121,7 @@
       "datatype": true,
       "docs": {
         "remarks": "I.e. custom props for this construct and the usual props given to `cdk.App`.",
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "Props given to `Project`."
       },
       "fqn": "@alma-cdk/project.ProjectProps",
@@ -6059,7 +6132,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/project/project.ts",
-        "line": 11
+        "line": 19
       },
       "name": "ProjectProps",
       "symbolId": "src/project/project:ProjectProps"
@@ -6068,16 +6141,16 @@
       "assembly": "@alma-cdk/project",
       "base": "aws-cdk-lib.Stack",
       "docs": {
-        "stability": "experimental"
+        "stability": "stable"
       },
       "fqn": "@alma-cdk/project.SmartStack",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         },
         "locationInModule": {
           "filename": "src/smartstack/stack.ts",
-          "line": 17
+          "line": 21
         },
         "parameters": [
           {
@@ -6103,7 +6176,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/smartstack/stack.ts",
-        "line": 12
+        "line": 17
       },
       "name": "SmartStack",
       "symbolId": "src/smartstack/stack:SmartStack"
@@ -6113,12 +6186,12 @@
       "assembly": "@alma-cdk/project",
       "base": "@alma-cdk/project.Name",
       "docs": {
-        "stability": "experimental"
+        "stability": "stable"
       },
       "fqn": "@alma-cdk/project.UrlName",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         }
       },
       "kind": "class",
@@ -6129,12 +6202,12 @@
       "methods": [
         {
           "docs": {
-            "stability": "experimental",
+            "stability": "stable",
             "summary": "PascalCase naming with global prefixes (org, project…)."
           },
           "locationInModule": {
             "filename": "src/name/name-url.ts",
-            "line": 21
+            "line": 29
           },
           "name": "globally",
           "overrides": "@alma-cdk/project.Name",
@@ -6168,7 +6241,7 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/name/name-url.ts",
@@ -6206,11 +6279,11 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "stable"
           },
           "locationInModule": {
             "filename": "src/name/name-url.ts",
-            "line": 15
+            "line": 19
           },
           "name": "withProject",
           "overrides": "@alma-cdk/project.Name",
@@ -6247,6 +6320,6 @@
       "symbolId": "src/name/name-url:UrlName"
     }
   },
-  "version": "1.0.0-beta.8",
-  "fingerprint": "PazDajBjitt5rmJaM40aaMoAzWGufiO3yerLxJ5XTV8="
+  "version": "1.0.0",
+  "fingerprint": "5sNcA8I+dXCZtRB5J3+kQZVuSiAb8B5PgB2ZV0m5qlE="
 }