projen 0.101.2 → 0.101.4

package/.jsii

@@ -92,49 +92,49 @@
     "projen.awscdk": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 55
+        "line": 56
       },
       "symbolId": "src/awscdk/index:"
     },
     "projen.build": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 59
+        "line": 60
       },
       "symbolId": "src/build/index:"
     },
     "projen.cdk": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 58
+        "line": 59
       },
       "symbolId": "src/cdk/index:"
     },
     "projen.cdk8s": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 56
+        "line": 57
       },
       "symbolId": "src/cdk8s/index:"
     },
     "projen.cdktf": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 57
+        "line": 58
       },
       "symbolId": "src/cdktf/index:"
     },
     "projen.circleci": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 48
+        "line": 49
       },
       "symbolId": "src/circleci/index:"
     },
     "projen.github": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 46
+        "line": 47
       },
       "symbolId": "src/github/index:"
     },
@@ -148,21 +148,21 @@
     "projen.gitlab": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 47
+        "line": 48
       },
       "symbolId": "src/gitlab/index:"
     },
     "projen.java": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 50
+        "line": 51
       },
       "symbolId": "src/java/index:"
     },
     "projen.javascript": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 53
+        "line": 54
       },
       "symbolId": "src/javascript/index:"
     },
@@ -176,7 +176,7 @@
     "projen.python": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 51
+        "line": 52
       },
       "symbolId": "src/python/index:"
     },
@@ -190,28 +190,28 @@
     "projen.release": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 54
+        "line": 55
       },
       "symbolId": "src/release/index:"
     },
     "projen.typescript": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 52
+        "line": 53
       },
       "symbolId": "src/typescript/index:"
     },
     "projen.vscode": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 49
+        "line": 50
       },
       "symbolId": "src/vscode/index:"
     },
     "projen.web": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 45
+        "line": 46
       },
       "symbolId": "src/web/index:"
     }
@@ -671,7 +671,7 @@
         },
         "locationInModule": {
           "filename": "src/component.ts",
-          "line": 32
+          "line": 33
         },
         "parameters": [
           {
@@ -692,7 +692,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/component.ts",
-        "line": 22
+        "line": 23
       },
       "methods": [
         {
@@ -702,7 +702,7 @@
           },
           "locationInModule": {
             "filename": "src/component.ts",
-            "line": 26
+            "line": 27
           },
           "name": "isComponent",
           "parameters": [
@@ -728,7 +728,7 @@
           },
           "locationInModule": {
             "filename": "src/component.ts",
-            "line": 54
+            "line": 55
           },
           "name": "postSynthesize"
         },
@@ -739,7 +739,7 @@
           },
           "locationInModule": {
             "filename": "src/component.ts",
-            "line": 44
+            "line": 45
           },
           "name": "preSynthesize"
         },
@@ -750,7 +750,7 @@
           },
           "locationInModule": {
             "filename": "src/component.ts",
-            "line": 49
+            "line": 50
           },
           "name": "synthesize"
         }
@@ -764,7 +764,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/component.ts",
-            "line": 30
+            "line": 31
           },
           "name": "project",
           "type": {
@@ -3954,6 +3954,130 @@
       ],
       "symbolId": "src/file:FileBaseOptions"
     },
+    "projen.FutureComponent": {
+      "abstract": true,
+      "assembly": "projen",
+      "base": "projen.Component",
+      "docs": {
+        "remarks": "Like a regular component, but constructed without a project. It improves on a\nnaive deferred component in three ways:\n\n- Use-before-attach is an error, not a silent footgun. The constructor hands\n  the caller a guard proxy; touching `project`, `node`, `synthesize()` or any\n  subclass feature before `attach()` throws.\n- No global shadow-tree leak. Each instance gets its own throwaway shadow\n  root, so detached components never share an id counter and the root becomes\n  garbage once the component is reparented on attach.\n- `attach()` returns the unwrapped component, so callers can opt out of the\n  proxy entirely.\n\nThe constructor takes no arguments (`super()`). A subclass that needs options\ncaptures them itself, reading the local parameter inside its constructor - NOT\n`this.options`, which the guard blocks until attach.\n\n```ts\nclass Worker extends FutureComponent {\n  private readonly options: WorkerOptions;\n  constructor(options: WorkerOptions = {}) {\n    super();\n    this.options = options; // set: allowed\n  }\n  protected init() {\n    // this.project is available here\n  }\n}\n\nconst w = new Worker({ retries: 3 });\n// w.project;                  // throws: not attached yet\nconst real = w.attach(project); // reparents, runs init(), returns the bare instance\n```",
+        "stability": "experimental",
+        "summary": "A {@link Component} that is created *detached* from any project and attached to one later via {@link FutureComponent.attach}."
+      },
+      "fqn": "projen.FutureComponent",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/component.ts",
+          "line": 183
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/component.ts",
+        "line": 179
+      },
+      "methods": [
+        {
+          "docs": {
+            "remarks": "Returns the real, unwrapped component (not the proxy). A component may be\nattached exactly once; attaching an already-attached component throws (copy\nit first to attach a variant elsewhere). Use `tryAttach()` if you don't care\nwhether it has already been attached.",
+            "stability": "experimental",
+            "summary": "Attach the component to a scope. Only now does it become usable."
+          },
+          "locationInModule": {
+            "filename": "src/component.ts",
+            "line": 222
+          },
+          "name": "attach",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.IConstruct"
+              }
+            },
+            {
+              "name": "id",
+              "optional": true,
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "projen.FutureComponent"
+            }
+          }
+        },
+        {
+          "docs": {
+            "remarks": "Runs once, from `attach()`, when `this.project` is\nfinally available.",
+            "stability": "experimental",
+            "summary": "Project-dependent setup."
+          },
+          "locationInModule": {
+            "filename": "src/component.ts",
+            "line": 212
+          },
+          "name": "init",
+          "protected": true
+        },
+        {
+          "docs": {
+            "remarks": "Unlike `attach()`, never throws on an already-attached component: if attached\nanywhere at all, the existing instance is returned and `scope` is ignored.\nUse `attach()` when attaching to a specific scope is part of your contract\nand a pre-existing attachment elsewhere would be a bug.",
+            "stability": "experimental",
+            "summary": "Attach the component if it isn't already, without caring *where*."
+          },
+          "locationInModule": {
+            "filename": "src/component.ts",
+            "line": 268
+          },
+          "name": "tryAttach",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.IConstruct"
+              }
+            },
+            {
+              "name": "id",
+              "optional": true,
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "projen.FutureComponent"
+            }
+          }
+        }
+      ],
+      "name": "FutureComponent",
+      "properties": [
+        {
+          "docs": {
+            "remarks": "A convenience for tests/introspection;\nprefer `tryAttach()` over reading this and branching.",
+            "stability": "experimental",
+            "summary": "Whether `attach()` has been called."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/component.ts",
+            "line": 204
+          },
+          "name": "attached",
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/component:FutureComponent"
+    },
     "projen.GitAttributesFile": {
       "assembly": "projen",
       "base": "projen.FileBase",
@@ -5583,6 +5707,48 @@
       "name": "IResolver",
       "symbolId": "src/file:IResolver"
     },
+    "projen.IScriptRunner": {
+      "assembly": "projen",
+      "docs": {
+        "stability": "experimental",
+        "summary": "A script runner that can produce the configuration to execute a file of a particular type."
+      },
+      "fqn": "projen.IScriptRunner",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/script-runner.ts",
+        "line": 24
+      },
+      "methods": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Produce the configuration to run the given entrypoint."
+          },
+          "locationInModule": {
+            "filename": "src/script-runner.ts",
+            "line": 28
+          },
+          "name": "configFor",
+          "parameters": [
+            {
+              "name": "entrypoint",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "projen.RunScriptConfig"
+            }
+          }
+        }
+      ],
+      "name": "IScriptRunner",
+      "symbolId": "src/script-runner:IScriptRunner"
+    },
     "projen.IgnoreFile": {
       "assembly": "projen",
       "base": "projen.FileBase",
@@ -9061,7 +9227,7 @@
         },
         "locationInModule": {
           "filename": "src/component.ts",
-          "line": 32
+          "line": 33
         },
         "parameters": [
           {
@@ -9908,6 +10074,66 @@
       ],
       "symbolId": "src/makefile:Rule"
     },
+    "projen.RunScriptConfig": {
+      "assembly": "projen",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "The resolved configuration for running a script."
+      },
+      "fqn": "projen.RunScriptConfig",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/script-runner.ts",
+        "line": 8
+      },
+      "name": "RunScriptConfig",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Dependencies required to run the script."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/script-runner.ts",
+            "line": 12
+          },
+          "name": "dependencies",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "projen.DependencyRequest"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The task steps to execute the script."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/script-runner.ts",
+            "line": 17
+          },
+          "name": "steps",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "projen.TaskStep"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "src/script-runner:RunScriptConfig"
+    },
     "projen.SampleDir": {
       "assembly": "projen",
       "base": "projen.Component",
@@ -10256,6 +10482,62 @@
       ],
       "symbolId": "src/readme:SampleReadmeProps"
     },
+    "projen.ScriptRunner": {
+      "assembly": "projen",
+      "base": "projen.FutureComponent",
+      "docs": {
+        "remarks": "A runner is a {@link FutureComponent}: it can be created standalone (e.g. in\n`.projenrc.ts`) and is attached to a project by whoever consumes it.",
+        "stability": "experimental",
+        "summary": "A script runner that executes the entrypoint file directly."
+      },
+      "fqn": "projen.ScriptRunner",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/component.ts",
+          "line": 183
+        }
+      },
+      "interfaces": [
+        "projen.IScriptRunner"
+      ],
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/script-runner.ts",
+        "line": 37
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Produce the configuration to run the given entrypoint."
+          },
+          "locationInModule": {
+            "filename": "src/script-runner.ts",
+            "line": 38
+          },
+          "name": "configFor",
+          "overrides": "projen.IScriptRunner",
+          "parameters": [
+            {
+              "name": "entrypoint",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "projen.RunScriptConfig"
+            }
+          }
+        }
+      ],
+      "name": "ScriptRunner",
+      "symbolId": "src/script-runner:ScriptRunner"
+    },
     "projen.SnapshotOptions": {
       "assembly": "projen",
       "datatype": true,
@@ -69809,7 +70091,7 @@
           "abstract": true,
           "docs": {
             "default": "false",
-            "remarks": "This will create a tsconfig file (default: `tsconfig.projen.json`)\nand use `ts-node` in the default task to parse the project source files.",
+            "remarks": "This will create a tsconfig file (default: `tsconfig.projen.json`)\nand use a typescript runner in the default task to parse the project source files.",
             "stability": "experimental",
             "summary": "Use projenrc in TypeScript."
           },
@@ -79312,12 +79594,88 @@
       ],
       "symbolId": "src/release/release-trigger:TagReleaseOptions"
     },
+    "projen.typescript.NodeRunnerOptions": {
+      "assembly": "projen",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Options for the native Node.js TypeScript runner."
+      },
+      "fqn": "projen.typescript.NodeRunnerOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/typescript/typescript-runner.ts",
+        "line": 64
+      },
+      "name": "NodeRunnerOptions",
+      "namespace": "typescript",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "stability": "experimental",
+            "summary": "Whether to also enable `--experimental-transform-types`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 88
+          },
+          "name": "experimentalTransformTypes",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- typescript default discovery",
+            "remarks": "When specified, will use this tsconfig for type-checking (if enabled).",
+            "stability": "experimental",
+            "summary": "Path to the tsconfig file for type-checking."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 82
+          },
+          "name": "tsconfig",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "remarks": "Because the native Node.js TypeScript does not type check code,\nyou may want to enable this for additional type safety.\nWhen enabled, runs `tsc --noEmit`, using the provided tsconfig.",
+            "stability": "experimental",
+            "summary": "Whether to type-check the entrypoint before executing."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 74
+          },
+          "name": "typeCheck",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/typescript/typescript-runner:NodeRunnerOptions"
+    },
     "projen.typescript.Projenrc": {
       "assembly": "projen",
       "base": "projen.ProjenrcFile",
       "docs": {
+        "remarks": "This component is used within TypeScriptProject.",
         "stability": "experimental",
-        "summary": "Sets up a typescript project to use TypeScript for projenrc."
+        "summary": "A projenrc file written in TypeScript."
       },
       "fqn": "projen.typescript.Projenrc",
       "initializer": {
@@ -79326,7 +79684,7 @@
         },
         "locationInModule": {
           "filename": "src/typescript/projenrc.ts",
-          "line": 45
+          "line": 56
         },
         "parameters": [
           {
@@ -79347,7 +79705,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/typescript/projenrc.ts",
-        "line": 37
+        "line": 48
       },
       "methods": [
         {
@@ -79357,7 +79715,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/projenrc.ts",
-            "line": 95
+            "line": 122
           },
           "name": "preSynthesize",
           "overrides": "projen.ProjenrcFile"
@@ -79374,7 +79732,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/projenrc.ts",
-            "line": 38
+            "line": 49
           },
           "name": "filePath",
           "overrides": "projen.ProjenrcFile",
@@ -79389,7 +79747,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/projenrc.ts",
-            "line": 39
+            "line": 50
           },
           "name": "tsconfig",
           "type": {
@@ -79409,7 +79767,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/typescript/projenrc.ts",
-        "line": 9
+        "line": 10
       },
       "name": "ProjenrcOptions",
       "namespace": "typescript",
@@ -79424,7 +79782,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/projenrc.ts",
-            "line": 14
+            "line": 15
           },
           "name": "filename",
           "optional": true,
@@ -79442,7 +79800,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/projenrc.ts",
-            "line": 22
+            "line": 23
           },
           "name": "projenCodeDir",
           "optional": true,
@@ -79453,14 +79811,33 @@
         {
           "abstract": true,
           "docs": {
-            "default": "false",
+            "default": "- the project's runner",
             "stability": "experimental",
+            "summary": "The runner to use for executing TypeScript files."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/projenrc.ts",
+            "line": 38
+          },
+          "name": "runner",
+          "optional": true,
+          "type": {
+            "fqn": "projen.typescript.TypeScriptRunner"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "deprecated": "Use `runner: TypeScriptRunner.tsNode({ swc: true })` instead.",
+            "stability": "deprecated",
             "summary": "Whether to use `SWC` for ts-node."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/projenrc.ts",
-            "line": 29
+            "line": 31
           },
           "name": "swc",
           "optional": true,
@@ -79475,7 +79852,7 @@
       "assembly": "projen",
       "base": "projen.ProjenrcFile",
       "docs": {
-        "remarks": "This component can be instantiated in any type of project\nand has no expectations around the project's main language.\n\nRequires that `npx` is available.",
+        "remarks": "This component can be instantiated in any type of project\nand has no expectations around the project's main language.",
         "stability": "experimental",
         "summary": "A projenrc file written in TypeScript."
       },
@@ -79486,7 +79863,7 @@
         },
         "locationInModule": {
           "filename": "src/typescript/projenrc-ts.ts",
-          "line": 51
+          "line": 60
         },
         "parameters": [
           {
@@ -79507,7 +79884,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/typescript/projenrc-ts.ts",
-        "line": 43
+        "line": 50
       },
       "methods": [
         {
@@ -79517,7 +79894,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/projenrc-ts.ts",
-            "line": 73
+            "line": 115
           },
           "name": "preSynthesize",
           "overrides": "projen.ProjenrcFile"
@@ -79534,7 +79911,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/projenrc-ts.ts",
-            "line": 48
+            "line": 55
           },
           "name": "filePath",
           "overrides": "projen.ProjenrcFile",
@@ -79550,7 +79927,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/projenrc-ts.ts",
-            "line": 47
+            "line": 54
           },
           "name": "tsconfig",
           "type": {
@@ -79570,7 +79947,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/typescript/projenrc-ts.ts",
-        "line": 9
+        "line": 10
       },
       "name": "ProjenrcTsOptions",
       "namespace": "typescript",
@@ -79585,7 +79962,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/projenrc-ts.ts",
-            "line": 14
+            "line": 15
           },
           "name": "filename",
           "optional": true,
@@ -79603,7 +79980,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/projenrc-ts.ts",
-            "line": 22
+            "line": 23
           },
           "name": "projenCodeDir",
           "optional": true,
@@ -79614,14 +79991,33 @@
         {
           "abstract": true,
           "docs": {
-            "default": "\"tsconfig.projen.json\"",
+            "default": "TypeScriptRunner.tsNode()",
             "stability": "experimental",
-            "summary": "The name of the tsconfig file that will be used by ts-node when compiling projen source files."
+            "summary": "The runner to use for executing TypeScript files."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/projenrc-ts.ts",
-            "line": 30
+            "line": 39
+          },
+          "name": "runner",
+          "optional": true,
+          "type": {
+            "fqn": "projen.typescript.TypeScriptRunner"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"tsconfig.projen.json\"",
+            "deprecated": "Use `runner` to configure the tsconfigFileName directly.",
+            "stability": "deprecated",
+            "summary": "The name of the tsconfig file that will be used by the runner when compiling projen source files."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/projenrc-ts.ts",
+            "line": 32
           },
           "name": "tsconfigFileName",
           "optional": true,
@@ -79642,7 +80038,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/typescript/typescript.ts",
-        "line": 31
+        "line": 35
       },
       "methods": [
         {
@@ -79653,7 +80049,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 44
+            "line": 48
           },
           "name": "autoDetectConfig",
           "returns": {
@@ -79671,7 +80067,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 61
+            "line": 65
           },
           "name": "custom",
           "parameters": [
@@ -79701,7 +80097,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 35
+            "line": 39
           },
           "name": "disabled",
           "returns": {
@@ -79719,7 +80115,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 53
+            "line": 57
           },
           "name": "fromFile",
           "parameters": [
@@ -79752,7 +80148,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/typescript/typescript.ts",
-        "line": 81
+        "line": 85
       },
       "methods": [
         {
@@ -79762,7 +80158,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 85
+            "line": 89
           },
           "name": "all",
           "returns": {
@@ -79780,7 +80176,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 101
+            "line": 105
           },
           "name": "custom",
           "parameters": [
@@ -79810,7 +80206,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 92
+            "line": 96
           },
           "name": "none",
           "returns": {
@@ -79835,7 +80231,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/typescript/typescript.ts",
-        "line": 222
+        "line": 226
       },
       "name": "TsJestOptions",
       "namespace": "typescript",
@@ -79849,7 +80245,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 234
+            "line": 238
           },
           "name": "transformOptions",
           "optional": true,
@@ -79868,7 +80264,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 230
+            "line": 234
           },
           "name": "transformPattern",
           "optional": true,
@@ -79890,7 +80286,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/typescript/typescript.ts",
-        "line": 168
+        "line": 172
       },
       "name": "TsJestTransformOptions",
       "namespace": "typescript",
@@ -79905,7 +80301,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 174
+            "line": 178
           },
           "name": "astTransformers",
           "optional": true,
@@ -79928,7 +80324,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 180
+            "line": 184
           },
           "name": "babelConfig",
           "optional": true,
@@ -79946,7 +80342,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 186
+            "line": 190
           },
           "name": "compiler",
           "optional": true,
@@ -79964,7 +80360,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 192
+            "line": 196
           },
           "name": "diagnostics",
           "optional": true,
@@ -79984,7 +80380,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 201
+            "line": 205
           },
           "name": "isolatedModules",
           "optional": true,
@@ -80002,7 +80398,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 207
+            "line": 211
           },
           "name": "stringifyContentPathRegex",
           "optional": true,
@@ -80020,7 +80416,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 213
+            "line": 217
           },
           "name": "tsconfig",
           "optional": true,
@@ -80038,7 +80434,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 219
+            "line": 223
           },
           "name": "useESM",
           "optional": true,
@@ -80059,7 +80455,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/typescript/typescript.ts",
-        "line": 119
+        "line": 123
       },
       "methods": [
         {
@@ -80069,7 +80465,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 123
+            "line": 127
           },
           "name": "auto",
           "returns": {
@@ -80086,7 +80482,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 130
+            "line": 134
           },
           "name": "builtInDefaults",
           "returns": {
@@ -80104,7 +80500,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 148
+            "line": 152
           },
           "name": "custom",
           "parameters": [
@@ -80130,7 +80526,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 139
+            "line": 143
           },
           "name": "fromFile",
           "parameters": [
@@ -80153,6 +80549,139 @@
       "namespace": "typescript",
       "symbolId": "src/typescript/typescript:TsJestTsconfig"
     },
+    "projen.typescript.TsNodeRunnerOptions": {
+      "assembly": "projen",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Options for the ts-node runner."
+      },
+      "fqn": "projen.typescript.TsNodeRunnerOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/typescript/typescript-runner.ts",
+        "line": 9
+      },
+      "name": "TsNodeRunnerOptions",
+      "namespace": "typescript",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "remarks": "This will disable type-checking.",
+            "see": "https://github.com/TypeStrong/ts-node#swc",
+            "stability": "experimental",
+            "summary": "Whether to use SWC for transpilation."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 35
+          },
+          "name": "swc",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- ts-node default discovery",
+            "stability": "experimental",
+            "summary": "Path to the tsconfig file to use."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 24
+          },
+          "name": "tsconfig",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "true",
+            "see": "https://github.com/TypeStrong/ts-node#typecheck",
+            "stability": "experimental",
+            "summary": "Whether to type-check the script during executing."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 17
+          },
+          "name": "typeCheck",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/typescript/typescript-runner:TsNodeRunnerOptions"
+    },
+    "projen.typescript.TsxRunnerOptions": {
+      "assembly": "projen",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Options for the tsx runner."
+      },
+      "fqn": "projen.typescript.TsxRunnerOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/typescript/typescript-runner.ts",
+        "line": 41
+      },
+      "name": "TsxRunnerOptions",
+      "namespace": "typescript",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- tsx/typescript default discovery",
+            "remarks": "When specified, will use this tsconfig for running tsx and type-checking (if enabled).",
+            "stability": "experimental",
+            "summary": "Path to the tsconfig file to use."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 58
+          },
+          "name": "tsconfig",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "remarks": "Because tsx does not type check code, you may want to enable this for additional type safety.\nWhen enabled, runs `tsc --noEmit`, using the provided tsconfig.",
+            "stability": "experimental",
+            "summary": "Whether to type-check the entrypoint before executing."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 50
+          },
+          "name": "typeCheck",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/typescript/typescript-runner:TsxRunnerOptions"
+    },
     "projen.typescript.TypeScriptAppProject": {
       "assembly": "projen",
       "base": "projen.typescript.TypeScriptProject",
@@ -80170,7 +80699,7 @@
         },
         "locationInModule": {
           "filename": "src/typescript/typescript.ts",
-          "line": 933
+          "line": 954
         },
         "parameters": [
           {
@@ -80184,7 +80713,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/typescript/typescript.ts",
-        "line": 932
+        "line": 953
       },
       "name": "TypeScriptAppProject",
       "namespace": "typescript",
@@ -80207,7 +80736,7 @@
         },
         "locationInModule": {
           "filename": "src/typescript/typescript.ts",
-          "line": 407
+          "line": 426
         },
         "parameters": [
           {
@@ -80221,7 +80750,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/typescript/typescript.ts",
-        "line": 373
+        "line": 387
       },
       "methods": [
         {
@@ -80231,7 +80760,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 676
+            "line": 697
           },
           "name": "defaultTypeScriptCompilerOptions",
           "protected": true,
@@ -80253,7 +80782,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 374
+            "line": 388
           },
           "name": "DEFAULT_TS_JEST_TRANFORM_PATTERN",
           "static": true,
@@ -80268,7 +80797,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 377
+            "line": 391
           },
           "name": "docsDirectory",
           "type": {
@@ -80283,13 +80812,28 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 395
+            "line": 409
           },
           "name": "libdir",
           "type": {
             "primitive": "string"
           }
         },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The TypeScript runner used for executing TypeScript files."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/typescript.ts",
+            "line": 419
+          },
+          "name": "runner",
+          "type": {
+            "fqn": "projen.typescript.TypeScriptRunner"
+          }
+        },
         {
           "docs": {
             "stability": "experimental",
@@ -80298,7 +80842,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 390
+            "line": 404
           },
           "name": "srcdir",
           "type": {
@@ -80313,7 +80857,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 400
+            "line": 414
           },
           "name": "testdir",
           "type": {
@@ -80328,7 +80872,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 385
+            "line": 399
           },
           "name": "tsconfigDev",
           "type": {
@@ -80343,7 +80887,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 405
+            "line": 424
           },
           "name": "watchTask",
           "type": {
@@ -80357,7 +80901,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 376
+            "line": 390
           },
           "name": "docgen",
           "optional": true,
@@ -80372,7 +80916,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 378
+            "line": 392
           },
           "name": "eslint",
           "optional": true,
@@ -80387,7 +80931,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 380
+            "line": 394
           },
           "name": "tsconfig",
           "optional": true,
@@ -80402,7 +80946,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 379
+            "line": 393
           },
           "name": "tsconfigEslint",
           "optional": true,
@@ -80426,7 +80970,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/typescript/typescript.ts",
-        "line": 237
+        "line": 241
       },
       "name": "TypeScriptProjectOptions",
       "namespace": "typescript",
@@ -80441,7 +80985,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 330
+            "line": 334
           },
           "name": "disableTsconfig",
           "optional": true,
@@ -80459,7 +81003,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 336
+            "line": 340
           },
           "name": "disableTsconfigDev",
           "optional": true,
@@ -80477,7 +81021,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 292
+            "line": 296
           },
           "name": "docgen",
           "optional": true,
@@ -80495,7 +81039,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 299
+            "line": 303
           },
           "name": "docsDirectory",
           "optional": true,
@@ -80513,7 +81057,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 348
+            "line": 352
           },
           "name": "entrypointTypes",
           "optional": true,
@@ -80531,7 +81075,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 269
+            "line": 273
           },
           "name": "eslint",
           "optional": true,
@@ -80549,7 +81093,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 275
+            "line": 279
           },
           "name": "eslintOptions",
           "optional": true,
@@ -80567,7 +81111,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 243
+            "line": 247
           },
           "name": "libdir",
           "optional": true,
@@ -80588,7 +81132,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 356
+            "line": 360
           },
           "name": "projenrcTs",
           "optional": true,
@@ -80605,7 +81149,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 361
+            "line": 365
           },
           "name": "projenrcTsOptions",
           "optional": true,
@@ -80613,6 +81157,25 @@
             "fqn": "projen.typescript.ProjenrcOptions"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "TypeScriptRunner.tsNode()",
+            "remarks": "This is a project-level setting that components (e.g. projenrc) will\nuse as their default runner.",
+            "stability": "experimental",
+            "summary": "The TypeScript runner to use for executing TypeScript files."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/typescript.ts",
+            "line": 375
+          },
+          "name": "runner",
+          "optional": true,
+          "type": {
+            "fqn": "projen.typescript.TypeScriptRunner"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -80623,7 +81186,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 342
+            "line": 346
           },
           "name": "sampleCode",
           "optional": true,
@@ -80641,7 +81204,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 250
+            "line": 254
           },
           "name": "srcdir",
           "optional": true,
@@ -80660,7 +81223,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 262
+            "line": 266
           },
           "name": "testdir",
           "optional": true,
@@ -80678,7 +81241,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 305
+            "line": 309
           },
           "name": "tsconfig",
           "optional": true,
@@ -80696,7 +81259,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 311
+            "line": 315
           },
           "name": "tsconfigDev",
           "optional": true,
@@ -80715,7 +81278,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 322
+            "line": 326
           },
           "name": "tsconfigDevFile",
           "optional": true,
@@ -80732,7 +81295,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 366
+            "line": 380
           },
           "name": "tsJestOptions",
           "optional": true,
@@ -80751,7 +81314,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 285
+            "line": 289
           },
           "name": "typescriptVersion",
           "optional": true,
@@ -80762,6 +81325,211 @@
       ],
       "symbolId": "src/typescript/typescript:TypeScriptProjectOptions"
     },
+    "projen.typescript.TypeScriptRunner": {
+      "assembly": "projen",
+      "base": "projen.ScriptRunner",
+      "docs": {
+        "remarks": "A runner is a {@link FutureComponent }: create it standalone (e.g. via one of\nthe static factories) and it is attached to a project by the component that\nconsumes it. Use {@link TypeScriptRunner.copy} to derive a new runner with\nadjusted options.",
+        "stability": "experimental",
+        "summary": "The runner used to execute TypeScript files."
+      },
+      "fqn": "projen.typescript.TypeScriptRunner",
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/typescript/typescript-runner.ts",
+        "line": 131
+      },
+      "methods": [
+        {
+          "docs": {
+            "remarks": "Requires Node.js 22.18.0 or later.\nThe script must use ESM style imports (no directories, include file endings, etc.).\n\nNamed `nodejs` (not `node`) because a runner is a construct, and `node` is\nreserved by `constructs.Construct` for the construct's tree node.",
+            "stability": "experimental",
+            "summary": "Use the native Node.js TypeScript support."
+          },
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 158
+          },
+          "name": "nodejs",
+          "parameters": [
+            {
+              "name": "options",
+              "optional": true,
+              "type": {
+                "fqn": "projen.typescript.NodeRunnerOptions"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "projen.typescript.TypeScriptRunner"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Use ts-node to execute TypeScript files."
+          },
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 135
+          },
+          "name": "tsNode",
+          "parameters": [
+            {
+              "name": "options",
+              "optional": true,
+              "type": {
+                "fqn": "projen.typescript.TsNodeRunnerOptions"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "projen.typescript.TypeScriptRunner"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "remarks": "tsx is a fast TypeScript runtime that does not perform type-checking.\nYou may opt-in to an explicit type-checking step before the script is run.",
+            "stability": "experimental",
+            "summary": "Use tsx to execute TypeScript files."
+          },
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 145
+          },
+          "name": "tsx",
+          "parameters": [
+            {
+              "name": "options",
+              "optional": true,
+              "type": {
+                "fqn": "projen.typescript.TsxRunnerOptions"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "projen.typescript.TypeScriptRunner"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Produce the {@link RunScriptConfig} to run the given entrypoint with this runner."
+          },
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 185
+          },
+          "name": "configFor",
+          "overrides": "projen.ScriptRunner",
+          "parameters": [
+            {
+              "name": "entrypoint",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "projen.RunScriptConfig"
+            }
+          }
+        },
+        {
+          "docs": {
+            "remarks": "Safe to call while detached.",
+            "stability": "experimental",
+            "summary": "Returns a new (detached) runner of the same kind, with `overrides` merged over the current options."
+          },
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 177
+          },
+          "name": "copy",
+          "parameters": [
+            {
+              "name": "overrides",
+              "optional": true,
+              "type": {
+                "fqn": "projen.typescript.TypeScriptRunnerOptions"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "projen.typescript.TypeScriptRunner"
+            }
+          }
+        }
+      ],
+      "name": "TypeScriptRunner",
+      "namespace": "typescript",
+      "symbolId": "src/typescript/typescript-runner:TypeScriptRunner"
+    },
+    "projen.typescript.TypeScriptRunnerOptions": {
+      "assembly": "projen",
+      "datatype": true,
+      "docs": {
+        "remarks": "This is the override type for {@link TypeScriptRunner.copy}. Runtime-specific\ncreation options (such as `swc` for ts-node) are set via the static factories\nand are preserved - but cannot be changed - by `copy`, so a copy can never\nchange the runtime of a runner.",
+        "stability": "experimental",
+        "summary": "The options that can be adjusted on any {@link TypeScriptRunner}, regardless of its runtime."
+      },
+      "fqn": "projen.typescript.TypeScriptRunnerOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/typescript/typescript-runner.ts",
+        "line": 100
+      },
+      "name": "TypeScriptRunnerOptions",
+      "namespace": "typescript",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Path to the tsconfig file to use."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 109
+          },
+          "name": "tsconfig",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Whether to type-check the entrypoint."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/typescript/typescript-runner.ts",
+            "line": 104
+          },
+          "name": "typeCheck",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/typescript/typescript-runner:TypeScriptRunnerOptions"
+    },
     "projen.typescript.TypedocDocgen": {
       "assembly": "projen",
       "docs": {
@@ -83413,6 +84181,6 @@
   "usedFeatures": [
     "class-covariant-overrides"
   ],
-  "version": "0.101.2",
-  "fingerprint": "n371GxHjPz1sBPpZdcoSsR5eD4NSyB6wWvrPUWA4nw8="
+  "version": "0.101.4",
+  "fingerprint": "ItzpLIrWbA85nUTzR3gJsvxdN1Y9BZRqTO8mHFUcnh4="
 }