projen 0.100.6 → 0.101.0

package/.jsii

@@ -61,7 +61,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/projen/projen.git",
-  "jsiiVersion": "6.0.3 (build 3c89083)",
+  "jsiiVersion": "6.0.4 (build 308d98d)",
   "keywords": [
     "cdk",
     "cicd",
@@ -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": 57
+          "line": 78
         },
         "parameters": [
           {
@@ -10547,7 +10547,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/task.ts",
-        "line": 42
+        "line": 62
       },
       "methods": [
         {
@@ -10559,7 +10559,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 130
+            "line": 180
           },
           "name": "addCondition",
           "parameters": [
@@ -10584,7 +10584,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 161
+            "line": 211
           },
           "name": "addSteps",
           "parameters": [
@@ -10609,7 +10609,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 185
+            "line": 255
           },
           "name": "builtin",
           "parameters": [
@@ -10631,7 +10631,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 268
+            "line": 357
           },
           "name": "env",
           "parameters": [
@@ -10663,7 +10663,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 170
+            "line": 220
           },
           "name": "exec",
           "parameters": [
@@ -10688,6 +10688,45 @@
             }
           ]
         },
+        {
+          "docs": {
+            "example": "task.execArgs([\"echo\", \"hello world\"]);",
+            "remarks": "A convenient alternative to `Task.exec`: arguments with spaces or\nspecial characters are passed through as-is, with no quoting needed. The\nelements are not run through a shell, so environment variables (`$FOO`) are\nnot expanded and other shell features are unavailable.",
+            "stability": "experimental",
+            "summary": "Executes a command provided as a list of the program followed by its arguments (an \"argv\")."
+          },
+          "locationInModule": {
+            "filename": "src/task.ts",
+            "line": 238
+          },
+          "name": "execArgs",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "The program followed by its arguments."
+              },
+              "name": "command",
+              "type": {
+                "collection": {
+                  "elementtype": {
+                    "primitive": "string"
+                  },
+                  "kind": "array"
+                }
+              }
+            },
+            {
+              "docs": {
+                "summary": "Options."
+              },
+              "name": "options",
+              "optional": true,
+              "type": {
+                "fqn": "projen.TaskStepOptions"
+              }
+            }
+          ]
+        },
         {
           "docs": {
             "stability": "experimental",
@@ -10695,7 +10734,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 299
+            "line": 388
           },
           "name": "insertStep",
           "parameters": [
@@ -10729,7 +10768,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 80
+            "line": 114
           },
           "name": "lock"
         },
@@ -10740,7 +10779,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 219
+            "line": 291
           },
           "name": "prependExec",
           "parameters": [
@@ -10748,7 +10787,7 @@
               "docs": {
                 "summary": "The command to add."
               },
-              "name": "shell",
+              "name": "command",
               "type": {
                 "primitive": "string"
               }
@@ -10769,7 +10808,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 235
+            "line": 311
           },
           "name": "prependSay",
           "parameters": [
@@ -10798,7 +10837,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 227
+            "line": 301
           },
           "name": "prependSpawn",
           "parameters": [
@@ -10827,7 +10866,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 211
+            "line": 283
           },
           "name": "prependSteps",
           "parameters": [
@@ -10850,7 +10889,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 343
+            "line": 432
           },
           "name": "removeStep",
           "parameters": [
@@ -10872,7 +10911,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 138
+            "line": 188
           },
           "name": "reset",
           "parameters": [
@@ -10902,7 +10941,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 194
+            "line": 264
           },
           "name": "say",
           "parameters": [
@@ -10934,7 +10973,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 202
+            "line": 272
           },
           "name": "spawn",
           "parameters": [
@@ -10962,7 +11001,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 321
+            "line": 410
           },
           "name": "updateStep",
           "parameters": [
@@ -10997,7 +11036,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 276
+            "line": 365
           },
           "name": "envVars",
           "type": {
@@ -11017,7 +11056,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 46
+            "line": 66
           },
           "name": "name",
           "type": {
@@ -11032,7 +11071,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 283
+            "line": 372
           },
           "name": "steps",
           "type": {
@@ -11053,7 +11092,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 116
+            "line": 166
           },
           "name": "condition",
           "optional": true,
@@ -11069,7 +11108,7 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 87
+            "line": 121
           },
           "name": "cwd",
           "optional": true,
@@ -11085,13 +11124,30 @@
           },
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 101
+            "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"
@@ -11106,7 +11162,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/task-model.ts",
-        "line": 27
+        "line": 36
       },
       "name": "TaskCommonOptions",
       "properties": [
@@ -11120,7 +11176,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 52
+            "line": 61
           },
           "name": "condition",
           "optional": true,
@@ -11138,7 +11194,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 60
+            "line": 69
           },
           "name": "cwd",
           "optional": true,
@@ -11156,7 +11212,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 32
+            "line": 41
           },
           "name": "description",
           "optional": true,
@@ -11175,7 +11231,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 39
+            "line": 48
           },
           "name": "env",
           "optional": true,
@@ -11198,7 +11254,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 45
+            "line": 54
           },
           "name": "requiredEnv",
           "optional": true,
@@ -11210,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"
@@ -11227,7 +11301,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/task.ts",
-        "line": 9
+        "line": 10
       },
       "name": "TaskOptions",
       "properties": [
@@ -11242,7 +11316,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 35
+            "line": 55
           },
           "name": "args",
           "optional": true,
@@ -11259,13 +11333,14 @@
           "abstract": true,
           "docs": {
             "default": "- add steps using `task.exec(command)` or `task.spawn(subtask)`",
+            "remarks": "Mutually exclusive with `execArgs`.",
             "stability": "experimental",
             "summary": "Shell command to execute as the first command of the task."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 14
+            "line": 18
           },
           "name": "exec",
           "optional": true,
@@ -11273,6 +11348,31 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- add steps using `task.execArgs(args)`, `task.exec(command)` or `task.spawn(subtask)`",
+            "remarks": "A convenient alternative to `exec`: arguments with spaces or special\ncharacters are passed through as-is, with no quoting needed. The elements\nare not run through a shell, so environment variables (`$FOO`) are not\nexpanded and other shell features are unavailable.",
+            "see": "TaskStep.execArgs *\nMutually exclusive with `exec`.",
+            "stability": "experimental",
+            "summary": "Shell command to execute as the first command of the task, provided as a list of the program followed by its arguments (an \"argv\")."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task.ts",
+            "line": 34
+          },
+          "name": "execArgs",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -11284,7 +11384,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 27
+            "line": 47
           },
           "name": "receiveArgs",
           "optional": true,
@@ -11301,7 +11401,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task.ts",
-            "line": 19
+            "line": 39
           },
           "name": "steps",
           "optional": true,
@@ -11317,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": [
@@ -11344,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": {
@@ -11360,7 +11715,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 75
+            "line": 139
           },
           "name": "steps",
           "optional": true,
@@ -11380,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": {
@@ -11406,7 +11782,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 191
+            "line": 345
           },
           "name": "builtin",
           "optional": true,
@@ -11414,17 +11790,78 @@
             "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": {
             "default": "- don't execute a shell command",
+            "remarks": "The whole command is a single shell string. To pass arguments as a list\ninstead - without having to quote spaces or other characters yourself -\nuse `execArgs`.",
             "stability": "experimental",
             "summary": "Shell command to execute."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 164
+            "line": 297
           },
           "name": "exec",
           "optional": true,
@@ -11432,6 +11869,68 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- don't execute a shell command",
+            "example": "{ execArgs: [\"echo\", \"hello world\"] }",
+            "remarks": "Often more convenient than `exec`: each element is passed to the\nprogram as-is, so arguments with spaces or special characters don't need\nquoting. Fixed (`args`) or received (`receiveArgs`) arguments are inserted\nwherever a `$@` element appears, or appended at the end if there is none.\n\nThe elements are not run through a shell, so environment variables (`$FOO`)\nare not expanded and other shell features are unavailable. Use `exec`\nif you need them.\n\nMutually exclusive with `exec`.",
+            "stability": "experimental",
+            "summary": "Shell command to execute, provided as a list of the program followed by its arguments (an \"argv\")."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/task-model.ts",
+            "line": 318
+          },
+          "name": "execArgs",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "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": {
@@ -11442,7 +11941,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 177
+            "line": 331
           },
           "name": "say",
           "optional": true,
@@ -11450,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": {
@@ -11460,7 +11991,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 171
+            "line": 325
           },
           "name": "spawn",
           "optional": true,
@@ -11482,7 +12013,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/task-model.ts",
-        "line": 81
+        "line": 145
       },
       "name": "TaskStepOptions",
       "properties": [
@@ -11498,7 +12029,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 141
+            "line": 205
           },
           "name": "args",
           "optional": true,
@@ -11521,7 +12052,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 101
+            "line": 165
           },
           "name": "condition",
           "optional": true,
@@ -11539,7 +12070,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 94
+            "line": 158
           },
           "name": "cwd",
           "optional": true,
@@ -11559,7 +12090,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 151
+            "line": 215
           },
           "name": "env",
           "optional": true,
@@ -11582,7 +12113,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 87
+            "line": 151
           },
           "name": "name",
           "optional": true,
@@ -11595,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"
@@ -11628,7 +12178,7 @@
         },
         "locationInModule": {
           "filename": "src/tasks.ts",
-          "line": 23
+          "line": 25
         },
         "parameters": [
           {
@@ -11642,7 +12192,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/tasks.ts",
-        "line": 18
+        "line": 19
       },
       "methods": [
         {
@@ -11652,7 +12202,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 90
+            "line": 92
           },
           "name": "addEnvironment",
           "parameters": [
@@ -11683,7 +12233,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 47
+            "line": 49
           },
           "name": "addTask",
           "parameters": [
@@ -11721,7 +12271,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 65
+            "line": 67
           },
           "name": "removeTask",
           "parameters": [
@@ -11748,7 +12298,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 145
+            "line": 164
           },
           "name": "resolveTasksManifest",
           "parameters": [
@@ -11772,7 +12322,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 117
+            "line": 136
           },
           "name": "runTask",
           "parameters": [
@@ -11818,7 +12368,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 125
+            "line": 144
           },
           "name": "synthesize",
           "overrides": "projen.Component"
@@ -11831,7 +12381,7 @@
           },
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 107
+            "line": 126
           },
           "name": "tryFind",
           "parameters": [
@@ -11863,7 +12413,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 38
+            "line": 40
           },
           "name": "all",
           "type": {
@@ -11883,7 +12433,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/tasks.ts",
-            "line": 97
+            "line": 99
           },
           "name": "env",
           "type": {
@@ -11894,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"
@@ -11909,7 +12476,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/task-model.ts",
-        "line": 4
+        "line": 6
       },
       "name": "TasksManifest",
       "properties": [
@@ -11922,7 +12489,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 24
+            "line": 26
           },
           "name": "env",
           "optional": true,
@@ -11946,7 +12513,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 14
+            "line": 16
           },
           "name": "manifestVersion",
           "optional": true,
@@ -11954,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": {
@@ -11963,7 +12561,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/task-model.ts",
-            "line": 19
+            "line": 21
           },
           "name": "tasks",
           "optional": true,
@@ -50407,7 +51005,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 972
+            "line": 979
           },
           "name": "addBins",
           "parameters": [
@@ -50432,7 +51030,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1236
+            "line": 1243
           },
           "name": "addBundledDeps",
           "parameters": [
@@ -50457,7 +51055,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1190
+            "line": 1197
           },
           "name": "addDeps",
           "parameters": [
@@ -50482,7 +51080,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1203
+            "line": 1210
           },
           "name": "addDevDeps",
           "parameters": [
@@ -50507,7 +51105,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1008
+            "line": 1015
           },
           "name": "addFields",
           "parameters": [
@@ -50534,7 +51132,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1018
+            "line": 1025
           },
           "name": "addKeywords",
           "parameters": [
@@ -50561,7 +51159,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1248
+            "line": 1255
           },
           "name": "addPackageIgnore",
           "overrides": "projen.Project",
@@ -50585,7 +51183,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1220
+            "line": 1227
           },
           "name": "addPeerDeps",
           "parameters": [
@@ -50610,7 +51208,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 990
+            "line": 997
           },
           "name": "addScripts",
           "parameters": [
@@ -50637,7 +51235,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1000
+            "line": 1007
           },
           "name": "removeScript",
           "parameters": [
@@ -50660,7 +51258,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1110
+            "line": 1117
           },
           "name": "renderWorkflowSetup",
           "parameters": [
@@ -50694,7 +51292,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1321
+            "line": 1328
           },
           "name": "runTaskCommand",
           "overrides": "projen.Project",
@@ -50722,7 +51320,7 @@
           },
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 982
+            "line": 989
           },
           "name": "setScript",
           "parameters": [
@@ -50931,7 +51529,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1328
+            "line": 1335
           },
           "name": "buildWorkflowJobId",
           "optional": true,
@@ -53116,7 +53714,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/javascript/node-project.ts",
-        "line": 1446
+        "line": 1453
       },
       "name": "RenderWorkflowSetupOptions",
       "namespace": "javascript",
@@ -53132,7 +53730,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1455
+            "line": 1462
           },
           "name": "installStepConfiguration",
           "optional": true,
@@ -53150,7 +53748,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/javascript/node-project.ts",
-            "line": 1460
+            "line": 1467
           },
           "name": "mutable",
           "optional": true,
@@ -65360,7 +65958,7 @@
           },
           "locationInModule": {
             "filename": "src/python/pip.ts",
-            "line": 43
+            "line": 55
           },
           "name": "addDependency",
           "overrides": "projen.python.IPythonDeps",
@@ -65383,7 +65981,7 @@
           },
           "locationInModule": {
             "filename": "src/python/pip.ts",
-            "line": 52
+            "line": 64
           },
           "name": "addDevDependency",
           "overrides": "projen.python.IPythonDeps",
@@ -65406,7 +66004,7 @@
           },
           "locationInModule": {
             "filename": "src/python/pip.ts",
-            "line": 59
+            "line": 71
           },
           "name": "installDependencies",
           "overrides": "projen.python.IPythonDeps"
@@ -78983,7 +79581,7 @@
         },
         "locationInModule": {
           "filename": "src/typescript/typescript.ts",
-          "line": 931
+          "line": 933
         },
         "parameters": [
           {
@@ -78997,7 +79595,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/typescript/typescript.ts",
-        "line": 930
+        "line": 932
       },
       "name": "TypeScriptAppProject",
       "namespace": "typescript",
@@ -79044,7 +79642,7 @@
           },
           "locationInModule": {
             "filename": "src/typescript/typescript.ts",
-            "line": 674
+            "line": 676
           },
           "name": "defaultTypeScriptCompilerOptions",
           "protected": true,
@@ -82226,6 +82824,6 @@
   "usedFeatures": [
     "class-covariant-overrides"
   ],
-  "version": "0.100.6",
-  "fingerprint": "mYHQbEq/u5KOoIlg8IUQHyiKHVr7zs4X/yl2hVzCpEs="
+  "version": "0.101.0",
+  "fingerprint": "BGjjsI3QkQI4hi7MIJUczqwF4kXN1seEj8Q+SMJC7eg="
 }