@taimos/projen 0.1.62 → 0.1.64

package/.jsii

@@ -8,8 +8,9 @@
     ]
   },
   "dependencies": {
-    "constructs": "^10.4.4",
-    "projen": ">=0.98.32 <1.0.0"
+    "constructs": "^10.5.1",
+    "projen": ">=0.100.7 <1.0.0",
+    "projen-pipelines": ">=0.3.19"
   },
   "dependencyClosure": {
     "constructs": {
@@ -77,6 +78,13 @@
           "module": "projen"
         }
       }
+    },
+    "projen-pipelines": {
+      "targets": {
+        "js": {
+          "npm": "projen-pipelines"
+        }
+      }
     }
   },
   "description": "@taimos/projen",
@@ -92,7 +100,7 @@
         "hasDefaultInterfaces": true
       }
     },
-    "tscRootDir": "src"
+    "tscRootDir": "/home/runner/work/taimos-projen/taimos-projen/src"
   },
   "name": "@taimos/projen",
   "readme": {
@@ -109,6 +117,673 @@
     }
   },
   "types": {
+    "@taimos/projen.MonorepoAmplifyApp": {
+      "assembly": "@taimos/projen",
+      "datatype": true,
+      "docs": {
+        "remarks": "Renders a single entry under `applications:` in the generated `amplify.yml`.\nAmplify does not auto-detect PNPM workspaces, so the generated build spec\nruns `corepack enable` + a root `pnpm install` and pre-builds any shared\npackages before building the app from its `appRoot` (see ADR-0002).",
+        "stability": "stable",
+        "summary": "One AWS Amplify Hosting application served from a workspace package."
+      },
+      "fqn": "@taimos/projen.MonorepoAmplifyApp",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/projects/monorepo.ts",
+        "line": 25
+      },
+      "name": "MonorepoAmplifyApp",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The package path that is the Amplify app root, e.g. `packages/frontend`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 29
+          },
+          "name": "appRoot",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The pnpm package name to build, used as the `--filter` target, e.g. `deploymon-frontend` or `radball-digital-portal`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 40
+          },
+          "name": "buildFilter",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The frontend framework, used to pick build/artifact/cache defaults."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 34
+          },
+          "name": "framework",
+          "type": {
+            "fqn": "@taimos/projen.MonorepoAmplifyFramework"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- `<appRoot>/.next` for Next.js, or\n`<appRoot>/dist/<buildFilter>/browser` for Angular.",
+            "stability": "stable",
+            "summary": "Override the artifact base directory."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 66
+          },
+          "name": "artifactBaseDirectory",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- `pnpm --filter <buildFilter> run build` for Next.js, or\n`pnpm --filter <buildFilter> run build:${BUILD_ENV}` for Angular.",
+            "stability": "stable",
+            "summary": "Override the build command run in the Amplify `build` phase."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 58
+          },
+          "name": "buildCommand",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- `node_modules/**` plus the framework build cache\n(`<appRoot>/.next/cache/**` or `<appRoot>/.angular/cache/**`).",
+            "stability": "stable",
+            "summary": "Override the Amplify build cache paths."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 74
+          },
+          "name": "cachePaths",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "[]",
+            "remarks": "Typically the shared API package the app consumes via `workspace:*`,\ne.g. `['@taimos/deploymon-api']`.",
+            "stability": "stable",
+            "summary": "Workspace packages to build before the app, as `--filter` targets."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 50
+          },
+          "name": "preBuildFilters",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "src/projects/monorepo:MonorepoAmplifyApp"
+    },
+    "@taimos/projen.MonorepoAmplifyFramework": {
+      "assembly": "@taimos/projen",
+      "docs": {
+        "remarks": "Selects sensible defaults for the build command, artifact directory and\ncache paths in the generated `amplify.yml`.",
+        "stability": "stable",
+        "summary": "The frontend framework an Amplify Hosting application is built with."
+      },
+      "fqn": "@taimos/projen.MonorepoAmplifyFramework",
+      "kind": "enum",
+      "locationInModule": {
+        "filename": "src/projects/monorepo.ts",
+        "line": 10
+      },
+      "members": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "A Next.js app — artifacts in `<appRoot>/.next`, built via `run build`."
+          },
+          "name": "NEXTJS"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "An Angular app — artifacts in `<appRoot>/dist/<filter>/browser`, built via `run build:${BUILD_ENV}`."
+          },
+          "name": "ANGULAR"
+        }
+      ],
+      "name": "MonorepoAmplifyFramework",
+      "symbolId": "src/projects/monorepo:MonorepoAmplifyFramework"
+    },
+    "@taimos/projen.MonorepoApproverMapping": {
+      "assembly": "@taimos/projen",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "One author-to-approvers routing rule for the PR approver assignment."
+      },
+      "fqn": "@taimos/projen.MonorepoApproverMapping",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/projects/monorepo.ts",
+        "line": 125
+      },
+      "name": "MonorepoApproverMapping",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The GitHub usernames assigned to review when `author` opens a PR."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 134
+          },
+          "name": "approvers",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The GitHub username opening the PR."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 129
+          },
+          "name": "author",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/projects/monorepo:MonorepoApproverMapping"
+    },
+    "@taimos/projen.MonorepoProject": {
+      "assembly": "@taimos/projen",
+      "base": "projen.typescript.TypeScriptProject",
+      "docs": {
+        "custom": {
+          "pjid": "taimos-monorepo"
+        },
+        "remarks": "The root only orchestrates the workspace — building, testing and linting are\ndelegated to the workspace packages via `pnpm -r`. This project generates the\n`pnpm-workspace.yaml`, the root convenience scripts, a unified PR build\nworkflow and (optionally) an Amplify Hosting build spec. The projen-managed\nsub-projects (api, backend, infra) are added with the `parent`/`outdir`\npattern in the consuming `.projenrc.ts`; plain workspace packages (e.g.\nNext.js apps) are picked up by the `packages/*` glob.",
+        "stability": "stable",
+        "summary": "Private PNPM-workspace monorepo root, following Taimos ADR-0002."
+      },
+      "fqn": "@taimos/projen.MonorepoProject",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/projects/monorepo.ts",
+          "line": 230
+        },
+        "parameters": [
+          {
+            "name": "options",
+            "type": {
+              "fqn": "@taimos/projen.MonorepoProjectOptions"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/projects/monorepo.ts",
+        "line": 216
+      },
+      "name": "MonorepoProject",
+      "properties": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "The unified PR build workflow."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 222
+          },
+          "name": "prBuildWorkflow",
+          "type": {
+            "fqn": "projen.github.GithubWorkflow"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "The generated `pnpm-workspace.yaml`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 219
+          },
+          "name": "workspaceFile",
+          "type": {
+            "fqn": "projen.YamlFile"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "The generated `amplify.yml`, if any Amplify apps were configured."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 225
+          },
+          "name": "amplifyFile",
+          "optional": true,
+          "type": {
+            "fqn": "projen.YamlFile"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "The PR approver assignment, if enabled."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 228
+          },
+          "name": "assignApprover",
+          "optional": true,
+          "type": {
+            "fqn": "projen-pipelines.GitHubAssignApprover"
+          }
+        }
+      ],
+      "symbolId": "src/projects/monorepo:MonorepoProject"
+    },
+    "@taimos/projen.MonorepoProjectOptions": {
+      "assembly": "@taimos/projen",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@taimos/projen.MonorepoProjectOptions",
+      "interfaces": [
+        "projen.typescript.TypeScriptProjectOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/projects/monorepo.ts",
+        "line": 137
+      },
+      "name": "MonorepoProjectOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "[]",
+            "remarks": "When set, an `amplify.yml` is generated\nwith one entry per app. When omitted, no `amplify.yml` is created.",
+            "stability": "stable",
+            "summary": "AWS Amplify Hosting applications."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 200
+          },
+          "name": "amplifyApps",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@taimos/projen.MonorepoAmplifyApp"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- hoegertn and hoegerma review each other",
+            "remarks": "Only used when `assignApprover` is enabled.",
+            "stability": "stable",
+            "summary": "Author-to-approvers routing for the PR approver assignment."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 177
+          },
+          "name": "approverMapping",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@taimos/projen.MonorepoApproverMapping"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "true",
+            "stability": "stable",
+            "summary": "Whether to assign PR approvers via `GitHubAssignApprover`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 169
+          },
+          "name": "assignApprover",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "stability": "stable",
+            "summary": "Whether to add `cdk-serverless` as a workspace dev dependency."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 162
+          },
+          "name": "cdkServerless",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "['hoegertn', 'hoegerma']",
+            "remarks": "Only used when `assignApprover` is enabled.",
+            "stability": "stable",
+            "summary": "Approvers assigned when no author-specific mapping matches."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 185
+          },
+          "name": "defaultApprovers",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'22'",
+            "stability": "stable",
+            "summary": "The Node.js version used in the generated build workflow."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 150
+          },
+          "name": "nodeVersion",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'10.33.0'",
+            "stability": "stable",
+            "summary": "The pnpm version pinned for the workspace and CI."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 143
+          },
+          "name": "pnpmWorkspaceVersion",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "true",
+            "stability": "stable",
+            "summary": "Whether the unified build workflow also runs `pnpm -r run test`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 192
+          },
+          "name": "runTestsInBuild",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "PNPM workspace tuning for the generated `pnpm-workspace.yaml`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 155
+          },
+          "name": "workspaceOptions",
+          "optional": true,
+          "type": {
+            "fqn": "@taimos/projen.MonorepoWorkspaceOptions"
+          }
+        }
+      ],
+      "symbolId": "src/projects/monorepo:MonorepoProjectOptions"
+    },
+    "@taimos/projen.MonorepoWorkspaceOptions": {
+      "assembly": "@taimos/projen",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "PNPM workspace tuning for the generated `pnpm-workspace.yaml`."
+      },
+      "fqn": "@taimos/projen.MonorepoWorkspaceOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/projects/monorepo.ts",
+        "line": 80
+      },
+      "name": "MonorepoWorkspaceOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "['@aws-amplify/cli', 'esbuild', 'sharp', 'unrs-resolver']",
+            "remarks": "pnpm >= 10 blocks these\nby default. The list populates both `allowBuilds` and\n`onlyBuiltDependencies` so pnpm does not treat `node_modules` as stale.",
+            "stability": "stable",
+            "summary": "Dependencies allowed to run install/build scripts."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 103
+          },
+          "name": "allowedBuilds",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "2880 // 2 days",
+            "stability": "stable",
+            "summary": "Minimum age in minutes a published version must have before it may be installed (`minimumReleaseAge`)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 111
+          },
+          "name": "minimumReleaseAge",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "['projen-pipelines', 'cdk-serverless', '@taimos/projen']",
+            "stability": "stable",
+            "summary": "Packages exempt from `minimumReleaseAge` so our own tooling can update without the cooldown."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 119
+          },
+          "name": "minimumReleaseAgeExclude",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "{}",
+            "remarks": "Omitted from the file when empty.",
+            "stability": "stable",
+            "summary": "Version overrides forced across the whole workspace (the `overrides:` field)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 94
+          },
+          "name": "overrides",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "map"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "['packages/*']",
+            "stability": "stable",
+            "summary": "The workspace package globs."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/projects/monorepo.ts",
+            "line": 86
+          },
+          "name": "packages",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "src/projects/monorepo:MonorepoWorkspaceOptions"
+    },
     "@taimos/projen.PrivateTaimosCdkApp": {
       "assembly": "@taimos/projen",
       "base": "@taimos/projen.TaimosCdkApp",
@@ -700,6 +1375,6 @@
       "symbolId": "src/projects/ts-lib:TaimosTypescriptLibraryOptions"
     }
   },
-  "version": "0.1.62",
-  "fingerprint": "viB/nlmTGjM4mXiwMKBPaqnnTlSCuLoLMTmuvt1myVg="
+  "version": "0.1.64",
+  "fingerprint": "h0cGDvdcBBDcr7Y/+JpFRUdZva3EmqdngZ4Dj3vZX5I="
 }