@testspectra/skills 1.2.32 → 1.2.33

package/dist/skills/matchers-and-assertions/SKILL.md

@@ -179,12 +179,18 @@ collection carry the scope forward too. No behavior difference on web vs. Androi
 | `await Spectra.browser.shouldHaveClipboardText(text)`     | Assert the clipboard text, polling                                 |
 | `await Spectra.browser.getPageLoadCount(tab?)`            | Loads of a tab since the test case began / the tab attached        |
 | `await Spectra.browser.shouldHavePageLoadCount(n, { tab? })` | Assert a tab's load count: only the refreshed tab grew          |
+| `await Spectra.browser.waitForDownload({ timeout? })`     | Next file the page downloads: `{ fileName, path, size, text(), rows() }` |
+| `await file.shouldHaveRows(rows, { header? })`            | Assert the CSV / first XLSX sheet; `header: false`: `rows` omit the header row |
+| `await file.shouldContainRow(row)`                        | Assert one row of the file equals `row`                            |
+| `await Spectra.browser.shouldHaveDownloaded(name \| /re/)` | Assert a download with that name completed, polling                |
+| `await Spectra.browser.shouldNotHaveDownloaded({ within? })` | Assert no download this test case, nor in `within` ms (1000)    |
+| `await Spectra.browser.shouldHaveDownloadCount(n)`        | Assert `n` downloads completed                                     |
 | `await Spectra.browser.installClock()`                    | Fake page clock, before the page loads                             |
 | `await Spectra.browser.advanceClock(ms)`                  | Jump the clock; timers that fall due run                           |
 | `await Spectra.browser.shouldHaveOpenedDialog(msg?)`      | Assert a JS dialog opened (each is answered as it opens)           |
 | `await Spectra.browser.shouldNotHaveOpenedDialog()`       | Assert none opened, nor opens for 500ms                            |
 
-Tabs, the clock and dialogs are web only, and reset when the next test case starts: one tab, no fake clock, no dialogs recorded. Install the clock before `Spectra.navigate`: timers the current document started earlier do not move.
+Tabs, the clock, dialogs and downloads are web only, and reset when the next test case starts: one tab, no fake clock, no dialogs or downloads recorded. Install the clock before `Spectra.navigate`: timers the current document started earlier do not move.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testspectra/skills",
-  "version": "1.2.32",
+  "version": "1.2.33",
   "description": "Installer & manager for modular AI agent skills that standardize TestSpectra script authoring (specs, page objects, steps, actions, hooks, fixtures, matchers)",
   "keywords": [
     "agents",

package/skills/matchers-and-assertions/SKILL.md

@@ -179,12 +179,18 @@ collection carry the scope forward too. No behavior difference on web vs. Androi
 | `await Spectra.browser.shouldHaveClipboardText(text)`     | Assert the clipboard text, polling                                 |
 | `await Spectra.browser.getPageLoadCount(tab?)`            | Loads of a tab since the test case began / the tab attached        |
 | `await Spectra.browser.shouldHavePageLoadCount(n, { tab? })` | Assert a tab's load count: only the refreshed tab grew          |
+| `await Spectra.browser.waitForDownload({ timeout? })`     | Next file the page downloads: `{ fileName, path, size, text(), rows() }` |
+| `await file.shouldHaveRows(rows, { header? })`            | Assert the CSV / first XLSX sheet; `header: false`: `rows` omit the header row |
+| `await file.shouldContainRow(row)`                        | Assert one row of the file equals `row`                            |
+| `await Spectra.browser.shouldHaveDownloaded(name \| /re/)` | Assert a download with that name completed, polling                |
+| `await Spectra.browser.shouldNotHaveDownloaded({ within? })` | Assert no download this test case, nor in `within` ms (1000)    |
+| `await Spectra.browser.shouldHaveDownloadCount(n)`        | Assert `n` downloads completed                                     |
 | `await Spectra.browser.installClock()`                    | Fake page clock, before the page loads                             |
 | `await Spectra.browser.advanceClock(ms)`                  | Jump the clock; timers that fall due run                           |
 | `await Spectra.browser.shouldHaveOpenedDialog(msg?)`      | Assert a JS dialog opened (each is answered as it opens)           |
 | `await Spectra.browser.shouldNotHaveOpenedDialog()`       | Assert none opened, nor opens for 500ms                            |
 
-Tabs, the clock and dialogs are web only, and reset when the next test case starts: one tab, no fake clock, no dialogs recorded. Install the clock before `Spectra.navigate`: timers the current document started earlier do not move.
+Tabs, the clock, dialogs and downloads are web only, and reset when the next test case starts: one tab, no fake clock, no dialogs or downloads recorded. Install the clock before `Spectra.navigate`: timers the current document started earlier do not move.
 
 ---