projen 0.99.47 → 0.99.48

package/.jsii

@@ -462,7 +462,7 @@
         },
         "locationInModule": {
           "filename": "src/file.ts",
-          "line": 95
+          "line": 98
         },
         "parameters": [
           {
@@ -918,7 +918,7 @@
         },
         "locationInModule": {
           "filename": "src/dependencies.ts",
-          "line": 53
+          "line": 54
         },
         "parameters": [
           {
@@ -935,7 +935,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/dependencies.ts",
-        "line": 17
+        "line": 18
       },
       "methods": [
         {
@@ -946,7 +946,7 @@
           },
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 32
+            "line": 33
           },
           "name": "parseDependency",
           "parameters": [
@@ -971,7 +971,7 @@
           },
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 135
+            "line": 136
           },
           "name": "addDependency",
           "parameters": [
@@ -1021,7 +1021,7 @@
           },
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 88
+            "line": 89
           },
           "name": "getDependency",
           "parameters": [
@@ -1060,7 +1060,7 @@
           },
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 186
+            "line": 189
           },
           "name": "isDependencySatisfied",
           "parameters": [
@@ -1105,7 +1105,7 @@
           },
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 168
+            "line": 171
           },
           "name": "removeDependency",
           "parameters": [
@@ -1140,7 +1140,7 @@
           },
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 209
+            "line": 212
           },
           "name": "requestDependency",
           "parameters": [
@@ -1169,7 +1169,7 @@
           },
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 114
+            "line": 115
           },
           "name": "tryGetDependency",
           "parameters": [
@@ -1213,7 +1213,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 21
+            "line": 22
           },
           "name": "MANIFEST_FILE",
           "static": true,
@@ -1230,7 +1230,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 72
+            "line": 73
           },
           "name": "all",
           "type": {
@@ -1259,7 +1259,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/dependencies.ts",
-        "line": 363
+        "line": 366
       },
       "name": "Dependency",
       "properties": [
@@ -1272,7 +1272,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 367
+            "line": 370
           },
           "name": "type",
           "type": {
@@ -1289,7 +1289,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 374
+            "line": 377
           },
           "name": "metadata",
           "optional": true,
@@ -1316,7 +1316,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/dependencies.ts",
-        "line": 343
+        "line": 346
       },
       "name": "DependencyCoordinates",
       "properties": [
@@ -1330,7 +1330,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 350
+            "line": 353
           },
           "name": "name",
           "type": {
@@ -1347,7 +1347,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 357
+            "line": 360
           },
           "name": "version",
           "optional": true,
@@ -1370,7 +1370,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/dependencies.ts",
-        "line": 432
+        "line": 435
       },
       "name": "DependencyRequest",
       "properties": [
@@ -1383,7 +1383,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 436
+            "line": 439
           },
           "name": "name",
           "type": {
@@ -1400,7 +1400,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 455
+            "line": 458
           },
           "name": "metadata",
           "optional": true,
@@ -1424,7 +1424,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 449
+            "line": 452
           },
           "name": "type",
           "optional": true,
@@ -1442,7 +1442,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 442
+            "line": 445
           },
           "name": "version",
           "optional": true,
@@ -1463,7 +1463,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/dependencies.ts",
-        "line": 380
+        "line": 383
       },
       "members": [
         {
@@ -1538,7 +1538,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/dependencies.ts",
-        "line": 333
+        "line": 336
       },
       "name": "DepsManifest",
       "properties": [
@@ -1551,7 +1551,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/dependencies.ts",
-            "line": 337
+            "line": 340
           },
           "name": "dependencies",
           "type": {
@@ -3613,7 +3613,7 @@
         },
         "locationInModule": {
           "filename": "src/file.ts",
-          "line": 95
+          "line": 98
         },
         "parameters": [
           {
@@ -3640,9 +3640,56 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/file.ts",
-        "line": 55
+        "line": 56
       },
       "methods": [
+        {
+          "docs": {
+            "default": "3",
+            "remarks": "Only available after synthesis.\n\nThis is an expensive operation and should only be used on non time-critical\ncode paths, like debug output.",
+            "returns": "the diff as an array of lines, or `undefined` if the file was\nnot changed or has not been synthesized yet.",
+            "stability": "experimental",
+            "summary": "Returns a unified diff of the old and new file contents with context lines and hunk headers."
+          },
+          "locationInModule": {
+            "filename": "src/file.ts",
+            "line": 242
+          },
+          "name": "diff",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "Whether to colorize the diff output."
+              },
+              "name": "colorize",
+              "optional": true,
+              "type": {
+                "primitive": "boolean"
+              }
+            },
+            {
+              "docs": {
+                "summary": "Number of context lines around changes."
+              },
+              "name": "contextLines",
+              "optional": true,
+              "type": {
+                "primitive": "number"
+              }
+            }
+          ],
+          "returns": {
+            "optional": true,
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "primitive": "string"
+                },
+                "kind": "array"
+              }
+            }
+          }
+        },
         {
           "docs": {
             "stability": "experimental",
@@ -3650,7 +3697,7 @@
           },
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 154
+            "line": 157
           },
           "name": "synthesize",
           "overrides": "projen.Component"
@@ -3664,7 +3711,7 @@
           },
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 149
+            "line": 152
           },
           "name": "synthesizeContent",
           "parameters": [
@@ -3697,7 +3744,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 74
+            "line": 75
           },
           "name": "absolutePath",
           "type": {
@@ -3712,7 +3759,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 59
+            "line": 60
           },
           "name": "path",
           "type": {
@@ -3728,7 +3775,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 221
+            "line": 226
           },
           "name": "changed",
           "optional": true,
@@ -3745,7 +3792,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 84
+            "line": 87
           },
           "name": "marker",
           "optional": true,
@@ -3760,7 +3807,7 @@
           },
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 69
+            "line": 70
           },
           "name": "executable",
           "type": {
@@ -3774,7 +3821,7 @@
           },
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 64
+            "line": 65
           },
           "name": "readonly",
           "type": {
@@ -3794,7 +3841,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/file.ts",
-        "line": 17
+        "line": 18
       },
       "name": "FileBaseOptions",
       "properties": [
@@ -3809,7 +3856,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 25
+            "line": 26
           },
           "name": "committed",
           "optional": true,
@@ -3827,7 +3874,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 31
+            "line": 32
           },
           "name": "editGitignore",
           "optional": true,
@@ -3845,7 +3892,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 45
+            "line": 46
           },
           "name": "executable",
           "optional": true,
@@ -3863,7 +3910,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 52
+            "line": 53
           },
           "name": "marker",
           "optional": true,
@@ -3881,7 +3928,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 38
+            "line": 39
           },
           "name": "readonly",
           "optional": true,
@@ -5442,7 +5489,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/file.ts",
-        "line": 256
+        "line": 286
       },
       "methods": [
         {
@@ -5453,7 +5500,7 @@
           },
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 260
+            "line": 290
           },
           "name": "toJSON",
           "returns": {
@@ -5476,7 +5523,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/file.ts",
-        "line": 229
+        "line": 259
       },
       "methods": [
         {
@@ -5490,7 +5537,7 @@
           },
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 236
+            "line": 266
           },
           "name": "resolve",
           "parameters": [
@@ -9557,7 +9604,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/file.ts",
-        "line": 242
+        "line": 272
       },
       "name": "ResolveOptions",
       "properties": [
@@ -9571,7 +9618,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 253
+            "line": 283
           },
           "name": "args",
           "optional": true,
@@ -9594,7 +9641,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/file.ts",
-            "line": 247
+            "line": 277
           },
           "name": "omitEmpty",
           "optional": true,
@@ -45505,6 +45552,125 @@
       ],
       "symbolId": "src/javascript/jest:HasteConfig"
     },
+    "projen.javascript.InstallReason": {
+      "assembly": "projen",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Why a dependency install was triggered during synthesis."
+      },
+      "fqn": "projen.javascript.InstallReason",
+      "kind": "enum",
+      "locationInModule": {
+        "filename": "src/javascript/node-package.ts",
+        "line": 2111
+      },
+      "members": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The node_modules directory does not exist."
+          },
+          "name": "NO_NODE_MODULES"
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The package.json file was modified during synthesis."
+          },
+          "name": "PACKAGE_JSON_CHANGED"
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Wildcard dependency versions were resolved to concrete ranges."
+          },
+          "name": "DEPS_RESOLVED"
+        }
+      ],
+      "name": "InstallReason",
+      "namespace": "javascript",
+      "symbolId": "src/javascript/node-package:InstallReason"
+    },
+    "projen.javascript.InstallTrigger": {
+      "assembly": "projen",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Describes why dependencies need to be installed."
+      },
+      "fqn": "projen.javascript.InstallTrigger",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/javascript/node-package.ts",
+        "line": 2123
+      },
+      "name": "InstallTrigger",
+      "namespace": "javascript",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The reason for the install."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/javascript/node-package.ts",
+            "line": 2125
+          },
+          "name": "reason",
+          "type": {
+            "fqn": "projen.javascript.InstallReason"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "A unified diff of the package.json changes. Only present when reason is `PACKAGE_JSON_CHANGED`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/javascript/node-package.ts",
+            "line": 2131
+          },
+          "name": "diff",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Only present when reason is `DEPS_RESOLVED`.",
+            "stability": "experimental",
+            "summary": "Human-readable descriptions of resolved dependency version changes."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/javascript/node-package.ts",
+            "line": 2137
+          },
+          "name": "resolutions",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "src/javascript/node-package:InstallTrigger"
+    },
     "projen.javascript.Jest": {
       "assembly": "projen",
       "base": "projen.Component",
@@ -48186,6 +48352,30 @@
             }
           }
         },
+        {
+          "docs": {
+            "remarks": "Does not log — the caller is\nresponsible for informing the user before calling this method.",
+            "stability": "experimental",
+            "summary": "Runs the install or install:ci task."
+          },
+          "locationInModule": {
+            "filename": "src/javascript/node-package.ts",
+            "line": 1898
+          },
+          "name": "installDependencies",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "the reason for the install, available for subclasses to act on."
+              },
+              "name": "_trigger",
+              "type": {
+                "fqn": "projen.javascript.InstallTrigger"
+              }
+            }
+          ],
+          "protected": true
+        },
         {
           "docs": {
             "remarks": "Order is *not* guaranteed.",
@@ -48337,7 +48527,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/javascript/node-package.ts",
-            "line": 1113
+            "line": 1165
           },
           "name": "execCommand",
           "type": {
@@ -48548,7 +48738,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/javascript/node-package.ts",
-            "line": 1121
+            "line": 1173
           },
           "name": "projenCommand",
           "type": {
@@ -48726,7 +48916,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/javascript/node-package.ts",
-        "line": 1961
+        "line": 2019
       },
       "members": [
         {
@@ -51310,7 +51500,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/javascript/node-package.ts",
-        "line": 2005
+        "line": 2063
       },
       "members": [
         {
@@ -51505,7 +51695,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/javascript/node-package.ts",
-        "line": 1950
+        "line": 2008
       },
       "name": "PeerDependencyOptions",
       "namespace": "javascript",
@@ -51520,7 +51710,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/javascript/node-package.ts",
-            "line": 1955
+            "line": 2013
           },
           "name": "pinnedDevDependency",
           "optional": true,
@@ -55687,7 +55877,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/javascript/node-package.ts",
-        "line": 2020
+        "line": 2078
       },
       "name": "YarnBerryOptions",
       "namespace": "javascript",
@@ -55702,7 +55892,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/javascript/node-package.ts",
-            "line": 2026
+            "line": 2084
           },
           "name": "version",
           "optional": true,
@@ -55720,7 +55910,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/javascript/node-package.ts",
-            "line": 2033
+            "line": 2091
           },
           "name": "yarnRcOptions",
           "optional": true,
@@ -55739,7 +55929,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/javascript/node-package.ts",
-            "line": 2041
+            "line": 2099
           },
           "name": "zeroInstalls",
           "optional": true,
@@ -81765,6 +81955,6 @@
   "usedFeatures": [
     "class-covariant-overrides"
   ],
-  "version": "0.99.47",
-  "fingerprint": "0n+yvB20F7rgVwGAoECqmlOpwZoELKXQ8Frbj28QkwU="
+  "version": "0.99.48",
+  "fingerprint": "DYLYwGiChz5heEtusKYkBDmIDiG6rhVPpBk2sHLQhmo="
 }