projen 0.100.7 → 0.101.0

package/.jsii

@@ -92,49 +92,49 @@
     "projen.awscdk": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 54
+        "line": 55
       },
       "symbolId": "src/awscdk/index:"
     },
     "projen.build": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 58
+        "line": 59
       },
       "symbolId": "src/build/index:"
     },
     "projen.cdk": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 57
+        "line": 58
       },
       "symbolId": "src/cdk/index:"
     },
     "projen.cdk8s": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 55
+        "line": 56
       },
       "symbolId": "src/cdk8s/index:"
     },
     "projen.cdktf": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 56
+        "line": 57
       },
       "symbolId": "src/cdktf/index:"
     },
     "projen.circleci": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 47
+        "line": 48
       },
       "symbolId": "src/circleci/index:"
     },
     "projen.github": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 45
+        "line": 46
       },
       "symbolId": "src/github/index:"
     },
@@ -148,21 +148,21 @@
     "projen.gitlab": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 46
+        "line": 47
       },
       "symbolId": "src/gitlab/index:"
     },
     "projen.java": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 49
+        "line": 50
       },
       "symbolId": "src/java/index:"
     },
     "projen.javascript": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 52
+        "line": 53
       },
       "symbolId": "src/javascript/index:"
     },
@@ -176,7 +176,7 @@
     "projen.python": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 50
+        "line": 51
       },
       "symbolId": "src/python/index:"
     },
@@ -190,28 +190,28 @@
     "projen.release": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 53
+        "line": 54
       },
       "symbolId": "src/release/index:"
     },
     "projen.typescript": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 51
+        "line": 52
       },
       "symbolId": "src/typescript/index:"
     },
     "projen.vscode": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 48
+        "line": 49
       },
       "symbolId": "src/vscode/index:"
     },
     "projen.web": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 44
+        "line": 45
       },
       "symbolId": "src/web/index:"
     }
@@ -9290,7 +9290,7 @@
         {
           "docs": {
             "example": "\"git log --oneline $LATEST_TAG..HEAD -- .\"",
-            "remarks": "A new release will be initiated, if the number of returned commits is greater than zero.\nMust return a newline separate list of commits that should considered releasable.\n`$LATEST_TAG` will be replaced with the actual latest tag for the given prefix.*",
+            "remarks": "A new release will be initiated, if the number of returned commits is greater than zero.\nMust return a newline separate list of commits that should considered releasable.\n`$LATEST_TAG` is available as an environment variable (set to the actual latest tag for the given prefix).",
             "stability": "experimental",
             "summary": "Use an arbitrary shell command to find releasable commits since the latest tag."
           },
@@ -10526,7 +10526,7 @@
         },
         "locationInModule": {
           "filename": "src/task.ts",
-          "line": 76
+          "line": 78
         },
         "parameters": [
           {
@@ -10547,7 +10547,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/task.ts",
-        "line": 61
+        "line": 62
       },
       "methods": [
         {
@@ -10559,7 +10559,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 161
+            "line": 180
           },
           "name": "addCondition",
           "parameters": [
@@ -10584,7 +10584,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 192
+            "line": 211
           },
           "name": "addSteps",
           "parameters": [
@@ -10609,7 +10609,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 234
+            "line": 255
           },
           "name": "builtin",
           "parameters": [
@@ -10631,7 +10631,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 317
+            "line": 357
           },
           "name": "env",
           "parameters": [
@@ -10663,7 +10663,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 201
+            "line": 220
           },
           "name": "exec",
           "parameters": [
@@ -10697,7 +10697,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 219
+            "line": 238
           },
           "name": "execArgs",
           "parameters": [
@@ -10734,7 +10734,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 348
+            "line": 388
           },
           "name": "insertStep",
           "parameters": [
@@ -10768,7 +10768,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 111
+            "line": 114
           },
           "name": "lock"
         },
@@ -10779,7 +10779,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 268
+            "line": 291
           },
           "name": "prependExec",
           "parameters": [
@@ -10787,7 +10787,7 @@
               "docs": {
                 "summary": "The command to add."
               },
-              "name": "shell",
+              "name": "command",
               "type": {
                 "primitive": "string"
               }
@@ -10808,7 +10808,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 284
+            "line": 311
           },
           "name": "prependSay",
           "parameters": [
@@ -10837,7 +10837,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 276
+            "line": 301
           },
           "name": "prependSpawn",
           "parameters": [
@@ -10866,7 +10866,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 260
+            "line": 283
           },
           "name": "prependSteps",
           "parameters": [
@@ -10889,7 +10889,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 392
+            "line": 432
           },
           "name": "removeStep",
           "parameters": [
@@ -10911,7 +10911,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 169
+            "line": 188
           },
           "name": "reset",
           "parameters": [
@@ -10941,7 +10941,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 243
+            "line": 264
           },
           "name": "say",
           "parameters": [
@@ -10973,7 +10973,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 251
+            "line": 272
           },
           "name": "spawn",
           "parameters": [
@@ -11001,7 +11001,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 370
+            "line": 410
           },
           "name": "updateStep",
           "parameters": [
@@ -11036,7 +11036,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 325
+            "line": 365
           },
           "name": "envVars",
           "type": {
@@ -11056,7 +11056,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 65
+            "line": 66
           },
           "name": "name",
           "type": {
@@ -11071,7 +11071,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 332
+            "line": 372
           },
           "name": "steps",
           "type": {
@@ -11092,7 +11092,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 147
+            "line": 166
           },
           "name": "condition",
           "optional": true,
@@ -11108,7 +11108,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 118
+            "line": 121
           },
           "name": "cwd",
           "optional": true,
@@ -11124,13 +11124,30 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 132
+            "line": 151
           },
           "name": "description",
           "optional": true,
           "type": {
             "primitive": "string"
           }
+        },
+        {
+          "docs": {
+            "remarks": "Sets the shell used to run this task's commands.",
+            "see": "{@link TaskCommonOptions.shell }",
+            "stability": "experimental",
+            "summary": "The shell used to run this task's commands, or `undefined` when inheriting the built-in default shell."
+          },
+          "locationInModule": {
+            "filename": "src/task.ts",
+            "line": 137
+          },
+          "name": "shell",
+          "optional": true,
+          "type": {
+            "fqn": "projen.TaskShell"
+          }
         }
       ],
       "symbolId": "src/task:Task"
@@ -11145,7 +11162,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/task-model.ts",
-        "line": 27
+        "line": 36
       },
       "name": "TaskCommonOptions",
       "properties": [
@@ -11159,7 +11176,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 52
+            "line": 61
           },
           "name": "condition",
           "optional": true,
@@ -11177,7 +11194,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 60
+            "line": 69
           },
           "name": "cwd",
           "optional": true,
@@ -11195,7 +11212,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 32
+            "line": 41
           },
           "name": "description",
           "optional": true,
@@ -11214,7 +11231,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 39
+            "line": 48
           },
           "name": "env",
           "optional": true,
@@ -11237,7 +11254,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 45
+            "line": 54
           },
           "name": "requiredEnv",
           "optional": true,
@@ -11249,6 +11266,24 @@
               "kind": "array"
             }
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- inherited from the task/project, otherwise the built-in projen shell",
+            "stability": "experimental",
+            "summary": "The shell used to run this task's commands, including its `condition` and `$(...)` environment evaluation. Use {@link TaskShell} to pick a built-in or an explicit invocation. Set at project, task or step level; the nearest declared level wins."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 79
+          },
+          "name": "shell",
+          "optional": true,
+          "type": {
+            "fqn": "projen.TaskShell"
+          }
         }
       ],
       "symbolId": "src/task-model:TaskCommonOptions"
@@ -11266,7 +11301,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/task.ts",
-        "line": 9
+        "line": 10
       },
       "name": "TaskOptions",
       "properties": [
@@ -11281,7 +11316,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 54
+            "line": 55
           },
           "name": "args",
           "optional": true,
@@ -11305,7 +11340,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 17
+            "line": 18
           },
           "name": "exec",
           "optional": true,
@@ -11325,7 +11360,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 33
+            "line": 34
           },
           "name": "execArgs",
           "optional": true,
@@ -11349,7 +11384,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 46
+            "line": 47
           },
           "name": "receiveArgs",
           "optional": true,
@@ -11366,7 +11401,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 38
+            "line": 39
           },
           "name": "steps",
           "optional": true,
@@ -11382,21 +11417,143 @@
       ],
       "symbolId": "src/task:TaskOptions"
     },
+    "projen.TaskShell": {
+      "assembly": "projen",
+      "docs": {
+        "remarks": "Choose one of the built-in shells, or provide an explicit shell invocation:\n\n- {@link TaskShell.projen} (the default) - the built-in cross-platform shell.\n- {@link TaskShell.system} - the operating system's native shell.\n- {@link TaskShell.bash} / {@link TaskShell.sh} - common POSIX shells.\n- {@link TaskShell.command} - an arbitrary shell invocation given as an\n  explicit argument list, e.g. `TaskShell.command([\"npx\", \"-c\"])`.\n\nA `shell` can be set at the project (tasks), task and step level, and the\nnearest declared level wins (it is a scalar override, not merged).",
+        "stability": "experimental",
+        "summary": "The shell used to run a task's commands - including its `condition` and any `$(...)` environment-variable evaluation."
+      },
+      "fqn": "projen.TaskShell",
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/task-shell.ts",
+        "line": 16
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Runs commands through `bash -c`."
+          },
+          "locationInModule": {
+            "filename": "src/task-shell.ts",
+            "line": 40
+          },
+          "name": "bash",
+          "returns": {
+            "type": {
+              "fqn": "projen.TaskShell"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "example": "TaskShell.command([\"npx\", \"-c\"]);",
+            "remarks": "The task\ncommand is appended as the final argument, so the invocation must accept\nthe command as its last argument (e.g. `bash -c`, `sh -c`, `npx -c`,\n`yarn exec`).",
+            "stability": "experimental",
+            "summary": "An arbitrary shell invocation, given as an explicit argument list."
+          },
+          "locationInModule": {
+            "filename": "src/task-shell.ts",
+            "line": 64
+          },
+          "name": "command",
+          "parameters": [
+            {
+              "docs": {
+                "remarks": "Must not be\nempty.",
+                "summary": "The shell program followed by its arguments."
+              },
+              "name": "command",
+              "type": {
+                "collection": {
+                  "elementtype": {
+                    "primitive": "string"
+                  },
+                  "kind": "array"
+                }
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "projen.TaskShell"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "remarks": "It interprets POSIX-style\ntask syntax (`mkdir -p`, `&&`, `$VAR`, ...) identically on every platform,\nincluding Windows.",
+            "stability": "experimental",
+            "summary": "The built-in cross-platform shell (the default)."
+          },
+          "locationInModule": {
+            "filename": "src/task-shell.ts",
+            "line": 22
+          },
+          "name": "projen",
+          "returns": {
+            "type": {
+              "fqn": "projen.TaskShell"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Runs commands through `sh -c`."
+          },
+          "locationInModule": {
+            "filename": "src/task-shell.ts",
+            "line": 47
+          },
+          "name": "sh",
+          "returns": {
+            "type": {
+              "fqn": "projen.TaskShell"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "remarks": "Use this to opt out of the cross-platform shell and run commands through\nwhatever shell the host provides.",
+            "stability": "experimental",
+            "summary": "The operating system's native shell (`/bin/sh` on POSIX, `cmd.exe` on Windows)."
+          },
+          "locationInModule": {
+            "filename": "src/task-shell.ts",
+            "line": 33
+          },
+          "name": "system",
+          "returns": {
+            "type": {
+              "fqn": "projen.TaskShell"
+            }
+          },
+          "static": true
+        }
+      ],
+      "name": "TaskShell",
+      "symbolId": "src/task-shell:TaskShell"
+    },
     "projen.TaskSpec": {
       "assembly": "projen",
       "datatype": true,
       "docs": {
+        "remarks": "The `tasks.json` (manifest) form of a task. {@link TaskCommonOptions} is the\nform used to define one; they differ only in the rendered `shell` field.",
         "stability": "experimental",
         "summary": "Specification of a single task."
       },
       "fqn": "projen.TaskSpec",
-      "interfaces": [
-        "projen.TaskCommonOptions"
-      ],
       "kind": "interface",
       "locationInModule": {
         "filename": "src/task-model.ts",
-        "line": 66
+        "line": 88
       },
       "name": "TaskSpec",
       "properties": [
@@ -11409,13 +11566,146 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 70
+            "line": 92
           },
           "name": "name",
           "type": {
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "If\nthe program exits with a zero exit code, steps will be executed. A non-zero\ncode means that task will be skipped.",
+            "stability": "experimental",
+            "summary": "A shell command which determines if the this task should be executed."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 118
+          },
+          "name": "condition",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- process.cwd()",
+            "stability": "experimental",
+            "summary": "The working directory for all steps in this task (unless overridden by the step)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 126
+          },
+          "name": "cwd",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- the task name",
+            "stability": "experimental",
+            "summary": "The description of this build command."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 98
+          },
+          "name": "description",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "{}",
+            "remarks": "Values in this map will be evaluated in a shell, so you can do stuff like `$(echo \"foo\")`.",
+            "stability": "experimental",
+            "summary": "Defines environment variables for the execution of this task."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 105
+          },
+          "name": "env",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "map"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Task execution will fail if one of these is not defined.",
+            "stability": "experimental",
+            "summary": "A set of environment variables that must be defined in order to execute this task."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 111
+          },
+          "name": "requiredEnv",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- the built-in projen shell",
+            "stability": "experimental",
+            "summary": "The task shell in `tasks.json` form: a keyword (`\"projen\"` or `\"system\"`) or an invocation argument list."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 134
+          },
+          "name": "shell",
+          "optional": true,
+          "type": {
+            "union": {
+              "types": [
+                {
+                  "primitive": "string"
+                },
+                {
+                  "collection": {
+                    "elementtype": {
+                      "primitive": "string"
+                    },
+                    "kind": "array"
+                  }
+                }
+              ]
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -11425,7 +11715,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 75
+            "line": 139
           },
           "name": "steps",
           "optional": true,
@@ -11445,21 +11735,42 @@
       "assembly": "projen",
       "datatype": true,
       "docs": {
-        "remarks": "The step could either be  the execution of a\nshell command or execution of a sub-task, by name.",
+        "remarks": "The step could either be  the execution of a\nshell command or execution of a sub-task, by name.\n\nThe `tasks.json` (manifest) form of a step. {@link TaskStepOptions} is the\nform used to define steps (via `task.exec()` etc.); they differ only in the\nrendered `shell` field.",
         "stability": "experimental",
         "summary": "A single step within a task."
       },
       "fqn": "projen.TaskStep",
-      "interfaces": [
-        "projen.TaskStepOptions"
-      ],
       "kind": "interface",
       "locationInModule": {
         "filename": "src/task-model.ts",
-        "line": 158
+        "line": 234
       },
       "name": "TaskStep",
       "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no arguments are passed to the step",
+            "see": "{@link TaskStepOptions.args }",
+            "stability": "experimental",
+            "summary": "A list of fixed arguments always passed to the step."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 270
+          },
+          "name": "args",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -11471,7 +11782,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 216
+            "line": 345
           },
           "name": "builtin",
           "optional": true,
@@ -11479,6 +11790,66 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "If\nthe program exits with a zero exit code, the step will be executed. A non-zero\ncode means the step will be skipped (subsequent task steps will still be evaluated/executed).",
+            "stability": "experimental",
+            "summary": "A shell command which determines if the this step should be executed."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 254
+          },
+          "name": "condition",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- determined by the task",
+            "stability": "experimental",
+            "summary": "The working directory for this step."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 247
+          },
+          "name": "cwd",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no environment variables defined in step",
+            "see": "{@link TaskStepOptions.env }",
+            "stability": "experimental",
+            "summary": "Defines environment variables for the execution of this step (`exec` and `builtin` only)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 278
+          },
+          "name": "env",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "map"
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -11490,7 +11861,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 168
+            "line": 297
           },
           "name": "exec",
           "optional": true,
@@ -11510,7 +11881,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 189
+            "line": 318
           },
           "name": "execArgs",
           "optional": true,
@@ -11523,6 +11894,43 @@
             }
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no name",
+            "stability": "experimental",
+            "summary": "Step name."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 240
+          },
+          "name": "name",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "see": "{@link TaskStepOptions.receiveArgs }",
+            "stability": "experimental",
+            "summary": "Should this step receive args passed to the task."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 262
+          },
+          "name": "receiveArgs",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -11533,7 +11941,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 202
+            "line": 331
           },
           "name": "say",
           "optional": true,
@@ -11541,6 +11949,38 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- the task's (or project's) shell",
+            "stability": "experimental",
+            "summary": "The step shell in `tasks.json` form: a keyword (`\"projen\"` or `\"system\"`) or an invocation argument list."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 286
+          },
+          "name": "shell",
+          "optional": true,
+          "type": {
+            "union": {
+              "types": [
+                {
+                  "primitive": "string"
+                },
+                {
+                  "collection": {
+                    "elementtype": {
+                      "primitive": "string"
+                    },
+                    "kind": "array"
+                  }
+                }
+              ]
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -11551,7 +11991,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 196
+            "line": 325
           },
           "name": "spawn",
           "optional": true,
@@ -11573,7 +12013,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/task-model.ts",
-        "line": 81
+        "line": 145
       },
       "name": "TaskStepOptions",
       "properties": [
@@ -11589,7 +12029,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 141
+            "line": 205
           },
           "name": "args",
           "optional": true,
@@ -11612,7 +12052,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 101
+            "line": 165
           },
           "name": "condition",
           "optional": true,
@@ -11630,7 +12070,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 94
+            "line": 158
           },
           "name": "cwd",
           "optional": true,
@@ -11650,7 +12090,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 151
+            "line": 215
           },
           "name": "env",
           "optional": true,
@@ -11673,7 +12113,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 87
+            "line": 151
           },
           "name": "name",
           "optional": true,
@@ -11686,20 +12126,39 @@
           "docs": {
             "default": "false",
             "example": "task.exec(\"echo Hello $@ World!\", { receiveArgs: true });",
-            "remarks": "If `true`, args are passed through at the end of the `exec` shell command.\\\nThe position of the args can be changed by including the marker `$@` inside the command string.\n\nIf the marker is explicitly double-quoted (\"$@\") arguments will be wrapped in single quotes, approximating\nthe whitespace preserving behavior of bash variable expansion.\n\nIf the step spawns a subtask, args are passed to the subtask.\nThe subtask must define steps receiving args for this to have any effect.",
+            "remarks": "If `true`, args are passed through at the end of the `exec` shell command.\\\nThe position of the args can be changed by including the marker `$@` inside the command string.\n\nIf the marker is explicitly double-quoted (\"$@\") arguments will be wrapped in double quotes, approximating\nthe whitespace preserving behavior of bash variable expansion.\n\nIf the step spawns a subtask, args are passed to the subtask.\nThe subtask must define steps receiving args for this to have any effect.",
             "stability": "experimental",
             "summary": "Should this step receive args passed to the task."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 119
+            "line": 183
           },
           "name": "receiveArgs",
           "optional": true,
           "type": {
             "primitive": "boolean"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- the task's (or project's) shell",
+            "see": "{@link TaskCommonOptions.shell }",
+            "stability": "experimental",
+            "summary": "The shell used to run this step, overriding the task/project shell."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 223
+          },
+          "name": "shell",
+          "optional": true,
+          "type": {
+            "fqn": "projen.TaskShell"
+          }
         }
       ],
       "symbolId": "src/task-model:TaskStepOptions"
@@ -11719,7 +12178,7 @@
         },
         "locationInModule": {
           "filename": "src/tasks.ts",
-          "line": 23
+          "line": 25
         },
         "parameters": [
           {
@@ -11733,7 +12192,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/tasks.ts",
-        "line": 18
+        "line": 19
       },
       "methods": [
         {
@@ -11743,7 +12202,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 90
+            "line": 92
           },
           "name": "addEnvironment",
           "parameters": [
@@ -11774,7 +12233,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 47
+            "line": 49
           },
           "name": "addTask",
           "parameters": [
@@ -11812,7 +12271,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 65
+            "line": 67
           },
           "name": "removeTask",
           "parameters": [
@@ -11839,7 +12298,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 145
+            "line": 164
           },
           "name": "resolveTasksManifest",
           "parameters": [
@@ -11863,7 +12322,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 117
+            "line": 136
           },
           "name": "runTask",
           "parameters": [
@@ -11909,7 +12368,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 125
+            "line": 144
           },
           "name": "synthesize",
           "overrides": "projen.Component"
@@ -11922,7 +12381,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 107
+            "line": 126
           },
           "name": "tryFind",
           "parameters": [
@@ -11954,7 +12413,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 38
+            "line": 40
           },
           "name": "all",
           "type": {
@@ -11974,7 +12433,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 97
+            "line": 99
           },
           "name": "env",
           "type": {
@@ -11985,6 +12444,23 @@
               "kind": "map"
             }
           }
+        },
+        {
+          "docs": {
+            "remarks": "Individual tasks and steps can\noverride this.\nSets the default shell used to run all task commands.",
+            "see": "{@link TaskCommonOptions.shell }",
+            "stability": "experimental",
+            "summary": "The default shell used to run all task commands, or `undefined` for the built-in cross-platform projen shell."
+          },
+          "locationInModule": {
+            "filename": "src/tasks.ts",
+            "line": 111
+          },
+          "name": "shell",
+          "optional": true,
+          "type": {
+            "fqn": "projen.TaskShell"
+          }
         }
       ],
       "symbolId": "src/tasks:Tasks"
@@ -12000,7 +12476,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/task-model.ts",
-        "line": 4
+        "line": 6
       },
       "name": "TasksManifest",
       "properties": [
@@ -12013,7 +12489,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 24
+            "line": 26
           },
           "name": "env",
           "optional": true,
@@ -12037,7 +12513,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 14
+            "line": 16
           },
           "name": "manifestVersion",
           "optional": true,
@@ -12045,6 +12521,37 @@
             "primitive": "number"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The default task shell, in `tasks.json` form: a keyword (`\"projen\"` or `\"system\"`) or an invocation argument list. See {@link TaskCommonOptions.shell}."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 33
+          },
+          "name": "shell",
+          "optional": true,
+          "type": {
+            "union": {
+              "types": [
+                {
+                  "primitive": "string"
+                },
+                {
+                  "collection": {
+                    "elementtype": {
+                      "primitive": "string"
+                    },
+                    "kind": "array"
+                  }
+                }
+              ]
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -12054,7 +12561,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 19
+            "line": 21
           },
           "name": "tasks",
           "optional": true,
@@ -82317,6 +82824,6 @@
   "usedFeatures": [
     "class-covariant-overrides"
   ],
-  "version": "0.100.7",
-  "fingerprint": "dOi6JcK8AnWZhGPP66lf133THWYYINUK+iww8kM+ptA="
+  "version": "0.101.0",
+  "fingerprint": "BGjjsI3QkQI4hi7MIJUczqwF4kXN1seEj8Q+SMJC7eg="
 }