breakage 0.8.3 → 0.8.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -82,8 +82,8 @@ Add these scripts to the tested package, preserving your existing runner and cer
82
82
  ```json
83
83
  {
84
84
  "scripts": {
85
- "test:breaks:prelude": "breakage prelude --out .breakage/baseline.json",
86
- "test:breaks": "breakage --baseline-file .breakage/baseline.json"
85
+ "test:breakage:prelude": "breakage prelude --out .breakage/baseline.json",
86
+ "test:breakage": "breakage --baseline-file .breakage/baseline.json"
87
87
  }
88
88
  }
89
89
  ```
@@ -93,11 +93,11 @@ Use [Turbo's deferred hashing](https://turborepo.dev/docs/reference/configuratio
93
93
  ```json
94
94
  {
95
95
  "tasks": {
96
- "test:breaks:prelude": {
96
+ "test:breakage:prelude": {
97
97
  "cache": false
98
98
  },
99
- "test:breaks": {
100
- "dependsOn": ["test:breaks:prelude", "^build"],
99
+ "test:breakage": {
100
+ "dependsOn": ["test:breakage:prelude", "^build"],
101
101
  "inputs": [
102
102
  "$TURBO_DEFAULT$",
103
103
  { "mode": "jit", "globs": [".breakage/baseline.json"] }
@@ -108,7 +108,7 @@ Use [Turbo's deferred hashing](https://turborepo.dev/docs/reference/configuratio
108
108
  }
109
109
  ```
110
110
 
111
- Run `turbo run test:breaks` as usual. The prelude runs even when the compatibility check hits its cache; a failed prelude prevents the downstream task from replaying a cached success. Keep all additional runner, helper, configuration, environment, and certification inputs in the compatibility task's hash, including release-plan files outside the package directory. Keep upstream `^build` prerequisites; the tested package does not need a self-build preflight. For runners without deferred hashing, finish the prelude before starting the task runner and include its snapshot in the check's cache key.
111
+ Run `turbo run test:breakage` as usual. The prelude runs even when the compatibility check hits its cache; a failed prelude prevents the downstream task from replaying a cached success. Keep all additional runner, helper, configuration, environment, and certification inputs in the compatibility task's hash, including release-plan files outside the package directory. Keep upstream `^build` prerequisites; the tested package does not need a self-build preflight. For runners without deferred hashing, finish the prelude before starting the task runner and include its snapshot in the check's cache key.
112
112
 
113
113
  The JavaScript API exports `breakagePrelude({ out, tagPattern, baseDirname })` and accepts `baselineFile` in `breakage` options. Without `baselineFile`, the existing single-command discovery behavior is preserved.
114
114
 
@@ -212,6 +212,8 @@ If a process is forcibly interrupted or restoration fails, breakage retains reco
212
212
 
213
213
  ## options
214
214
 
215
+ The optional [`breakage npm` command family](./npm.md) checks peer compatibility and end-of-support changes for npm packages. Its representatives, packed candidates, and release-intent hooks apply only to that namespace. The ordinary public check retains the adoption conditions and behavior described above. Both commands can use `breakage.config.ts`; default discovery prefers it over `breakage.config.json`, and an explicit configuration path wins. TypeScript configuration uses the runtime's native support for erasable TypeScript.
216
+
215
217
  | Check option | Shorthand | Required | Purpose |
216
218
  | ------------------ | --------- | -------- | ------------------------------------------------- |
217
219
  | `--tagPattern` | `-g` | | RegExp selecting release tags. |