test-inventory 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,131 @@
 # test-inventory
 
+## 0.7.0
+
+### Minor Changes
+
+- [#72](https://github.com/Huldoser/test-inventory/pull/72) [`cf784f0`](https://github.com/Huldoser/test-inventory/commit/cf784f070e66523df1d68c546f033e1f495f0f49) - `--expand-cases` (library: `expandCases: true`) lists each case of a `.each` or `.for` table and each pass of a loop
+  whose values the scan can work out as its own record, with the title the runner gives it. Vitest's titles follow the
+  rules of the project's Vitest version, 3.0 to 5: `%s`, `%d`, `%i`, `%f`, `%j`, `%o`, `%O`, `%c`, `%#`, `%$` and `$name`,
+  with values quoted and cut as that version does; they match the names Vitest 3.0, 3.1, 3.2, 4.0, 4.1 and 5.0 list.
+  Each case's values are bound in its callback, so titles, tags and conditions built from them are worked out per case,
+  and an `if`, `?:`, `&&`, `||` or `??` that reads nothing but them registers only the branch it takes. Loops in test
+  and hook bodies and loops over a `var` are not expanded, and a file starts expansions up to 1,000 loop passes and
+  describe cases.
+  Suites and tests have a new key, `caseIndex`: the case's index from 0, as `%#` counts, or `null` without the option. A
+  table that can't be expanded stays one record with a new `cases-not-expanded` warning. Without the option the output
+  is as before, apart from `caseIndex: null` on every suite and test.
+
+- [#72](https://github.com/Huldoser/test-inventory/pull/72) [`cf784f0`](https://github.com/Huldoser/test-inventory/commit/cf784f070e66523df1d68c546f033e1f495f0f49) - Values imported from other files of the project are now worked out: a title, tag, annotation, reason, run setting or
+  `.each` table built from a constant, enum or default export of another module, through re-exports, `export *`,
+  `import * as` and JSON files, found the same way as helper functions (relative paths, tsconfig `paths`, `#imports`,
+  workspace packages). Values from installed packages are still not read, and keep their diagnostic.
+
+  A test in a `for...of`, `for...in`, `forEach` or `map` loop over values the scan can work out now has `caseCount`, the
+  number of tests the runner registers, and no `test-in-loop` warning; the warning now marks a loop the scan can't
+  count. Values also work out arithmetic on numbers, as in `30 * 1000`, `?:`, `&&`, `||`, `??`, comparisons,
+  `Object.keys()`, `Object.values()`, `Object.entries()`, `JSON.stringify()`, `String()`, and a string's `toUpperCase()`,
+  `toLowerCase()` and `trim()` and an array's `join()`. A skip condition that works out to a constant, such as
+  `side === 'short'` in a helper called with `'buy'`, now sets the state it gives instead of being kept as a condition.
+
+  Code after an `if` whose branch always returns or throws, as in `if (!strategy.enabled) return;` in a helper, is now
+  under the opposite condition, so its tests have `isInCondition` and a loop around them no count. A tagged-template
+  table is counted as Vitest splits it: outer pipes are columns, an incomplete last row is left out, and a template
+  without values is one case.
+
+  A test whose title was its source text and is now worked out gets a new `id`, once.
+
+### Patch Changes
+
+- [#71](https://github.com/Huldoser/test-inventory/pull/71) [`bf8383f`](https://github.com/Huldoser/test-inventory/commit/bf8383f009a73a026d128cd8e050505cdd63cfb5) - A name destructured from a test object, as in `const { describe, beforeEach } = test`, is now read as that member:
+  `beforeEach(...)` is a hook, `describe(...)` a describe and `skip(...)` a skipped test, for Playwright and Vitest,
+  also nested, as in `const { describe: { serial } } = test`. Every such name was read as `test` itself, so a hook got
+  `test-without-body` and every test of the file `notLoaded`, and the tests inside a describe were left out with
+  `nested-test` warnings.
+
+- [#71](https://github.com/Huldoser/test-inventory/pull/71) [`bf8383f`](https://github.com/Huldoser/test-inventory/commit/bf8383f009a73a026d128cd8e050505cdd63cfb5) - When the root and the folders above it don't have the framework, its version is now read from the shallowest
+  `package.json` below the root that declares it and holds scanned files, as `code/package.json` in a monorepo, with
+  that package's lockfile or installed copy first. The version was `null` there, so the newest rules applied: Vitest
+  5's, which refuse a file that calls `vi.mock` inside a block, made every test of such a file `notLoaded` in a project
+  on Vitest 3.
+
+## 0.6.1
+
+### Patch Changes
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - An import that matches a tsconfig `paths` pattern but none of its files, as an installed package does with
+  `"paths": { "*": ["./src/types/*"] }`, now goes on to the usual lookup, as TypeScript does. Such imports were reported
+  as unreadable, so every test that used a package or a built-in module such as `node:fs` got
+  `hasUnfollowedDependencies`. An `@/` or `~/` alias whose files are missing is still reported.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - A file that only passes names on, as a barrel `index.ts` with `export * from './fees'` or
+  `export { OrderTicket } from './order-ticket'` does, is now in the `dependencies` of the tests that import through it,
+  so `--related` keeps them when the file changes. Which module a re-export points at is now part of `dependencyHash`, as
+  an import's already was, so the hash of a test that imports through a re-export changes once.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - An imported file that isn't text, such as `import logo from './logo.png'`, is now taken by its bytes in
+  `dependencyHash`. It was read as text, where every byte that isn't UTF-8 reads the same, so two different images could
+  give the same hash.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - A `<script>` block in a Vue or Svelte component whose `type` isn't JavaScript, such as
+  `<script type="application/ld+json">` in `<svelte:head>`, is no longer read as the component's code. It made the
+  component unreadable, so the modules its real script imports were missing from `dependencies`.
+
+- [#68](https://github.com/Huldoser/test-inventory/pull/68) [`fa9b97a`](https://github.com/Huldoser/test-inventory/commit/fa9b97affd5d8598dcb91f11c7fc2c5343ec5b87) - `dependencyHash` now follows what a Vue or Svelte single-file component imports, also the components and helpers only
+  its template uses, so a change to a child component changes the hash of the tests that mount its parent. A component
+  whose script doesn't parse is still taken by its text, and its tests get `hasUnfollowedDependencies`.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - A file with brackets nested more than 500 deep, such as a generated fixture, now gets a `parse-error` instead of
+  crashing the scan. oxc-parser overflows the native stack on such a file, about 5,000 deep, and the process dies with a
+  segmentation fault that no error handling can catch, so no inventory was written.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - `expectCount` now counts `expect.element()`, the assertion of Vitest browser mode, so a browser test that checks the
+  page only with `await expect.element(locator).toBeVisible()` no longer looks like a test without assertions.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - An import written with a `.jsx` extension now finds the `.tsx` file it refers to, as `.js` already found `.ts`, so
+  `import { OrderHeader } from './OrderHeader.jsx'` is followed instead of marking the test with
+  `hasUnfollowedDependencies`.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - From Playwright 1.57, the config's `tag` is now read: every test gets it first in its `tags`, and a project's `grep` or
+  `grepInvert` matches it, so a project with `grepInvert: /@nightly/` in a config with `tag: '@nightly'` no longer runs
+  the tests. When the scan can't work out the `tag`, as for `process.env.CI_ENVIRONMENT_NAME`, it gets a
+  `config-value-unknown` warning, and the tests of a project with a `grep` get `projects: null`.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - From Playwright 1.64, a project with `default: false` is no longer listed in a test's `projects`, as Playwright runs it
+  only with `--project`, unless a project that runs lists it in `dependencies` or `teardown`. A `default` the scan can't
+  work out gets a `config-value-unknown` warning, and the tests it may run get `projects: null`.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - Playwright's `defineConfig(base, config)` is now merged as Playwright merges it: a project of `config` merges into the
+  project of `base` with the same name instead of replacing all of `base`'s projects, and `expect`, `use` and `build`
+  merge key by key. A setup project from a base config is no longer lost, and an `expect.toHaveScreenshot.pathTemplate`
+  from the base still marks the tests that compare screenshots with `hasUnfollowedDependencies`.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - A Vitest `retry` object in a test's or describe's options before Vitest 4.1 now gets an `unresolved-option` warning
+  and `retries: null`. Vitest 4.0 and 3.2 never run such a test; the scan used to ignore the object and give the
+  config's retry count instead.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - A Vitest test's own `skip`, `only`, `todo` or `fails` option now replaces the one its tags set, as Vitest does, so
+  `test('title', { tags: ['flaky'], skip: false }, fn)` is active instead of skipped, and a conditional `skip` replaces
+  the tag's unconditional one.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - An import that starts with `@/` or `~/`, as a Vite `resolve.alias` allows, now gives the test
+  `hasUnfollowedDependencies` and a `dependency-not-followed` warning when no tsconfig `paths` define it. It was taken for
+  an installed package, so the aliased file was missing from `dependencies` without a sign, and `--related` left the test
+  out when that file changed.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - Vitest 5 tests follow the option rules of Vitest 5.0.5: the last of `.skip`, `skipIf()` and `runIf()` on a test
+  decides its skip, so `test.skip.skipIf(false)` is active, and a `skipIf()` or `runIf()` replaces the skip of a tag or of
+  the options a describe passes down. An option set to `undefined`, as in `test.skip('title', { skip: undefined }, fn)`,
+  no longer undoes the chain or a tag.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - In Vitest 5, the projects of a config that another config lists in `projects` are named inside that config's name, as
+  Vitest names them: the `unit` project of `apps/web/vitest.config.ts`, named `web`, is `web (unit)`.
+
+- [#69](https://github.com/Huldoser/test-inventory/pull/69) [`41ce74d`](https://github.com/Huldoser/test-inventory/commit/41ce74d6dc5fb413ffcfa789442754a445f5572c) - A Vitest project without a `test.name` now has the name Vitest gives it, in `projects` and in `configs`: the `name` in
+  the package.json of its folder, else the folder's name, so `projects: ['packages/*']` names its projects
+  `@trading/pricing` or `ledger` instead of `""`. An inline project without a name is named after its place among the
+  inline projects, as `0`, and in Vitest 5 no longer takes the name of the config it extends.
+
 ## 0.6.0
 
 ### Minor Changes

package/dist/case-titles.d.ts

@@ -0,0 +1,14 @@
+import type { Value } from './values.ts';
+/**
+ * The title Vitest gives one case of a `.each` or `.for` table, read from Vitest's `formatTitle` in 3.0, 3.1, 4.1
+ * and 5.0: `%#` and `%$` for the case's index, printf placeholders for its items, and `$name` for a key of its object.
+ * Vitest 3 formats the whole title and then replaces `$name`, also inside the values it put in; Vitest 4 and 5 format
+ * each placeholder on its own and replace `$name` only in the text between them. Vitest 3.0 has no `%$`, and reads
+ * `$name` only when the case is an object. Null when the title shows a value the scan doesn't format the way Vitest
+ * does, which is any array or object printed as a whole.
+ *
+ * `version` is Vitest's `[major, minor]`, null for the newest rules. `truncate` is the length Vitest shortens a value to,
+ * 40 unless the config sets `chaiConfig.truncateThreshold` (3 and 4) or `taskTitleValueFormatTruncate` (5); 0 keeps
+ * values whole.
+ */
+export declare function vitestCaseTitle(template: string, items: readonly Value[], index: number, version: readonly [number, number] | null, truncate?: number): string | null;

package/dist/case-titles.js

@@ -0,0 +1,227 @@
+/**
+ * The title Vitest gives one case of a `.each` or `.for` table, read from Vitest's `formatTitle` in 3.0, 3.1, 4.1
+ * and 5.0: `%#` and `%$` for the case's index, printf placeholders for its items, and `$name` for a key of its object.
+ * Vitest 3 formats the whole title and then replaces `$name`, also inside the values it put in; Vitest 4 and 5 format
+ * each placeholder on its own and replace `$name` only in the text between them. Vitest 3.0 has no `%$`, and reads
+ * `$name` only when the case is an object. Null when the title shows a value the scan doesn't format the way Vitest
+ * does, which is any array or object printed as a whole.
+ *
+ * `version` is Vitest's `[major, minor]`, null for the newest rules. `truncate` is the length Vitest shortens a value to,
+ * 40 unless the config sets `chaiConfig.truncateThreshold` (3 and 4) or `taskTitleValueFormatTruncate` (5); 0 keeps
+ * values whole.
+ */
+export function vitestCaseTitle(template, items, index, version, truncate = 40) {
+    const rules = version === null || version[0] >= 5 ? 5 : version[0];
+    const isFirst3 = version !== null && version[0] === 3 && version[1] === 0;
+    let text = template;
+    if (text.includes('%#') || (!isFirst3 && text.includes('%$'))) {
+        text = text.replace(/%%/g, ESCAPED).replace(/%#/g, String(index));
+        if (!isFirst3)
+            text = text.replace(/%\$/g, String(index + 1));
+        text = text.replaceAll(ESCAPED, '%%');
+    }
+    const count = text.split('%').length - 1;
+    if (text.includes('%f'))
+        text = negativeFloats(text, items);
+    const isObjectItem = isObject(items[0]);
+    const attribute = (key) => {
+        const isArrayKey = !isFirst3 && /^\d+$/.test(key);
+        if (!isObjectItem && !isArrayKey)
+            return `$${key}`;
+        const element = isArrayKey ? objectAttr(items, key) : undefined;
+        const value = isObjectItem ? objectAttr(items[0], key, element) : element;
+        if (value === NOT_PLAIN)
+            return null;
+        if (rules === 5)
+            return typeof value === 'string' ? shorten(value, truncate) : prettyFormat(value, truncate);
+        return loupe(value, truncate === 0 ? Infinity : truncate);
+    };
+    if (rules === 3) {
+        const formatted = printf(text, items.slice(0, count), rules, truncate);
+        return formatted === null ? null : replaceAttributes(formatted, ATTRIBUTE_3, attribute);
+    }
+    let output = '';
+    let used = 0;
+    let last = 0;
+    for (const match of text.matchAll(PLACEHOLDER)) {
+        const between = replaceAttributes(text.slice(last, match.index), rules === 5 ? ATTRIBUTE_5 : ATTRIBUTE_3, attribute);
+        if (between === null)
+            return null;
+        output += between;
+        // Each placeholder, `%%` included, takes the next item, also one past the end of the case.
+        const placeholder = printf(match[0], [items[used++]], rules, truncate);
+        if (placeholder === null)
+            return null;
+        output += placeholder;
+        last = match.index + match[0].length;
+    }
+    const rest = replaceAttributes(text.slice(last), rules === 5 ? ATTRIBUTE_5 : ATTRIBUTE_3, attribute);
+    return rest === null ? null : output + rest;
+}
+const ESCAPED = '__vitest_escaped_%__';
+const PLACEHOLDER = /%[sdjifoOc%]/g;
+const ATTRIBUTE_3 = /\$([$\w.]+)/g;
+const ATTRIBUTE_5 = /\$([$\p{ID_Continue}.]+)/gu;
+/** A key that leads to something other than a plain value, such as `toString`, which Vitest would show as a function. */
+const NOT_PLAIN = Symbol('not plain');
+function isPrimitive(value) {
+    return typeof value !== 'object' || value === null;
+}
+function isObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/** Vitest's `objectAttr`: a path such as `order.qty`, `legs[0].side` or `0`, read as `new Object(value)[key]` reads it. */
+function objectAttr(source, path, fallback) {
+    let result = source;
+    for (const key of path.replace(/\[(\d+)\]/g, '.$1').split('.')) {
+        if (result === null || result === undefined)
+            return fallback;
+        const object = Object(result);
+        if (Object.hasOwn(object, key)) {
+            result = object[key];
+        }
+        else if (key in object) {
+            return NOT_PLAIN;
+        }
+        else {
+            return fallback;
+        }
+        if (result === undefined)
+            return fallback;
+    }
+    return result;
+}
+/** `%f` of `-0` shows a minus, which Vitest adds for the item at the same place among the items. */
+function negativeFloats(template, items) {
+    let text = template;
+    template.match(/%f/g).forEach((_, index) => {
+        if (!Object.is(items[index], -0))
+            return;
+        let occurrence = 0;
+        text = text.replace(/%f/g, (match) => (++occurrence === index + 1 ? '-%f' : match));
+    });
+    return text;
+}
+function replaceAttributes(text, pattern, attribute) {
+    let output = '';
+    let last = 0;
+    for (const match of text.matchAll(pattern)) {
+        const value = attribute(match[1]);
+        if (value === null)
+            return null;
+        output += text.slice(last, match.index) + value;
+        last = match.index + match[0].length;
+    }
+    return output + text.slice(last);
+}
+/** Vitest's `format()` for a template and its arguments, for the values it shows the way the scan does. */
+function printf(template, args, rules, truncate) {
+    let used = 0;
+    let output = '';
+    let last = 0;
+    for (const match of template.matchAll(PLACEHOLDER)) {
+        const placeholder = match[0];
+        const formatted = placeholder === '%%'
+            ? '%'
+            : used >= args.length
+                ? placeholder
+                : formatValue(placeholder, args[used++], rules, truncate);
+        if (formatted === null)
+            return null;
+        output += template.slice(last, match.index) + formatted;
+        last = match.index + placeholder.length;
+    }
+    output += template.slice(last);
+    // Arguments beyond the placeholders are appended, as `console.log` does.
+    for (const value of args.slice(used)) {
+        if (!isPrimitive(value))
+            return null;
+        output += ` ${String(value)}`;
+    }
+    return output;
+}
+function formatValue(placeholder, value, rules, truncate) {
+    switch (placeholder) {
+        case '%s':
+            if (!isPrimitive(value))
+                return null;
+            return Object.is(value, -0) ? '-0' : String(value);
+        case '%d':
+            return Number(value).toString();
+        case '%i':
+            return isPrimitive(value) ? Number.parseInt(String(value)).toString() : null;
+        case '%f':
+            return isPrimitive(value) ? Number.parseFloat(String(value)).toString() : null;
+        case '%j':
+            // JSON.stringify(undefined) gives undefined, which the title shows as text.
+            return value === undefined ? 'undefined' : JSON.stringify(value);
+        case '%c':
+            return '';
+        default:
+            // `%o` and `%O` inspect the value: with loupe in Vitest 3 and 4, with pretty-format and the truncate option in 5.
+            if (!isPrimitive(value))
+                return null;
+            return rules === 5 ? prettyFormat(value, truncate) : loupe(value, Infinity);
+    }
+}
+/** A string cut to `length` with an ellipsis, without splitting a surrogate pair; 0 keeps it whole. */
+function shorten(text, length) {
+    if (length === 0 || text.length <= length)
+        return text;
+    let end = length - 1;
+    if (isHighSurrogate(text[end - 1]))
+        end -= 1;
+    return `${text.slice(0, end)}…`;
+}
+function isHighSurrogate(char) {
+    return char !== undefined && char >= '\ud800' && char <= '\udbff';
+}
+/** Vitest 5's `inspect()` of a value, through pretty-format with single quotes. */
+function prettyFormat(value, truncate) {
+    if (!isPrimitive(value))
+        return null;
+    if (typeof value !== 'string')
+        return Object.is(value, -0) ? '-0' : String(value);
+    const quoted = `'${value}'`;
+    if (truncate === 0 || quoted.length <= truncate)
+        return quoted;
+    let end = truncate - 1;
+    if (end > 0 && isHighSurrogate(quoted[end - 1]))
+        end -= 1;
+    return `'${quoted.slice(1, end)}…'`;
+}
+const LOUPE_ESCAPED = new RegExp("['\\u0000-\\u001f\\u007f-\\u009f\\u00ad\\u0600-\\u0604\\u070f\\u17b4\\u17b5\\u200c-\\u200f\\u2028-\\u202f\\u2060-\\u206f\\ufeff\\ufff0-\\uffff]", 'g');
+const LOUPE_ESCAPES = {
+    '\b': '\\b',
+    '\t': '\\t',
+    '\n': '\\n',
+    '\f': '\\f',
+    '\r': '\\r',
+    "'": "\\'",
+};
+/** loupe's `inspect()` of a value, as Vitest 3 and 4 show it, cut to `truncate`. */
+function loupe(value, truncate) {
+    if (!isPrimitive(value))
+        return null;
+    if (typeof value === 'string') {
+        const escaped = value.replace(LOUPE_ESCAPED, (char) => LOUPE_ESCAPES[char] ?? `\\u${`0000${char.charCodeAt(0).toString(16)}`.slice(-4)}`);
+        return `'${loupeTruncate(escaped, truncate - 2)}'`;
+    }
+    if (typeof value !== 'number')
+        return String(value);
+    if (Number.isNaN(value) || !Number.isFinite(value))
+        return String(value);
+    if (value === 0)
+        return Object.is(value, -0) ? '-0' : '+0';
+    return loupeTruncate(String(value), truncate);
+}
+function loupeTruncate(text, length) {
+    if (length < 1 && text.length > 1)
+        return '…';
+    if (text.length <= length || text.length <= 1)
+        return text;
+    let end = length - 1;
+    if (end > 0 && isHighSurrogate(text[end - 1]))
+        end -= 1;
+    return `${text.slice(0, end)}…`;
+}

package/dist/cli.d.ts

@@ -6,6 +6,6 @@ export interface Io {
     /** Read for `--related -`. */
     stdin?: Readable;
 }
-export declare const HELP = "Usage: test-inventory [glob...] --framework <playwright|vitest> [options]\n\nLists the tests in the matching files as JSON, read from the source code without running them. Without globs, the\ntest files are those the Playwright or Vitest configs in the root and the folders below it run.\n\nOptions:\n  --framework <name>           playwright or vitest (required)\n  --root <dir>                 project root; paths in the output are relative to it (default: current directory)\n  --ignore <glob>              leave out matching files; can be repeated (node_modules is always left out)\n  --framework-version <x.y.z>  apply the rules of this framework version instead of the one in the project\n  --comments <mode>            comments above tests: all, non-active or none (default: non-active)\n  --state <state>              keep tests in this state, such as skip or fixme; can be repeated\n  --tag <tag>                  keep tests with this tag, such as @smoke; can be repeated\n  --grep <regex>               keep tests whose full name matches, ignoring case\n  --only                       keep tests that use .only, or are inside a describe that does\n  --without-reason             keep tests that don't run and give no reason\n  --related <file>             keep tests a change to this file can affect; can be repeated; - reads files, one per\n                               line, from standard input, as git diff --name-only writes them\n  --fields <keys>              write only these keys of each test, separated by commas; id is always kept\n  --format <format>            json or jsonl, one record per line (default: json)\n  -o, --output <file>          write to a file instead of standard output\n  --pretty                     indent the JSON\n  -h, --help                   show this help\n  -v, --version                show the version\n\nExit codes: 0 when the scan finishes, even with diagnostics; 2 for invalid arguments, an output that cannot be\nwritten, or a crash. 1 is reserved for a future release.\n\nExamples:\n  test-inventory \"tests/**/*.spec.ts\" --framework playwright --output inventory.json\n  test-inventory \"tests/**/*.spec.ts\" --framework playwright --state skip --fields fullName,reason\n";
+export declare const HELP = "Usage: test-inventory [glob...] --framework <playwright|vitest> [options]\n\nLists the tests in the matching files as JSON, read from the source code without running them. Without globs, the\ntest files are those the Playwright or Vitest configs in the root and the folders below it run.\n\nOptions:\n  --framework <name>           playwright or vitest (required)\n  --root <dir>                 project root; paths in the output are relative to it (default: current directory)\n  --ignore <glob>              leave out matching files; can be repeated (node_modules is always left out)\n  --framework-version <x.y.z>  apply the rules of this framework version instead of the one in the project\n  --comments <mode>            comments above tests: all, non-active or none (default: non-active)\n  --expand-cases               one record per case of a .each or .for table and per pass of a loop, with its title\n  --state <state>              keep tests in this state, such as skip or fixme; can be repeated\n  --tag <tag>                  keep tests with this tag, such as @smoke; can be repeated\n  --grep <regex>               keep tests whose full name matches, ignoring case\n  --only                       keep tests that use .only, or are inside a describe that does\n  --without-reason             keep tests that don't run and give no reason\n  --related <file>             keep tests a change to this file can affect; can be repeated; - reads files, one per\n                               line, from standard input, as git diff --name-only writes them\n  --fields <keys>              write only these keys of each test, separated by commas; id is always kept\n  --format <format>            json or jsonl, one record per line (default: json)\n  -o, --output <file>          write to a file instead of standard output\n  --pretty                     indent the JSON\n  -h, --help                   show this help\n  -v, --version                show the version\n\nExit codes: 0 when the scan finishes, even with diagnostics; 2 for invalid arguments, an output that cannot be\nwritten, or a crash. 1 is reserved for a future release.\n\nExamples:\n  test-inventory \"tests/**/*.spec.ts\" --framework playwright --output inventory.json\n  test-inventory \"tests/**/*.spec.ts\" --framework playwright --state skip --fields fullName,reason\n";
 /** Runs the command line with the given arguments and streams. Resolves to the exit code. */
 export declare function run(argv: string[], io: Io): Promise<number>;

package/dist/cli.js

@@ -19,6 +19,7 @@ Options:
   --ignore <glob>              leave out matching files; can be repeated (node_modules is always left out)
   --framework-version <x.y.z>  apply the rules of this framework version instead of the one in the project
   --comments <mode>            comments above tests: all, non-active or none (default: non-active)
+  --expand-cases               one record per case of a .each or .for table and per pass of a loop, with its title
   --state <state>              keep tests in this state, such as skip or fixme; can be repeated
   --tag <tag>                  keep tests with this tag, such as @smoke; can be repeated
   --grep <regex>               keep tests whose full name matches, ignoring case
@@ -114,6 +115,7 @@ export async function run(argv, io) {
                 ignore: { type: 'string', multiple: true },
                 'framework-version': { type: 'string' },
                 comments: { type: 'string' },
+                'expand-cases': { type: 'boolean' },
                 state: { type: 'string', multiple: true },
                 tag: { type: 'string', multiple: true },
                 grep: { type: 'string' },
@@ -180,6 +182,7 @@ export async function run(argv, io) {
             ignore: values.ignore ?? [],
             frameworkVersion: values['framework-version'],
             comments: values.comments,
+            expandCases: values['expand-cases'],
         });
         const filtered = filterInventory(inventory, filter);
         result = fields === undefined ? filtered : pickTestFields(filtered, fields);

package/dist/config-runs.d.ts

@@ -21,6 +21,8 @@ export interface ProjectAbout {
     config: ConfigFile;
     grep: ((title: string) => boolean) | null;
     grepRoot: string;
+    /** Whether the runner runs the project without `--project`, as Playwright's `default` decides; null when unknown. */
+    runsByDefault: boolean | null;
     defaults: ProjectDefaults;
 }
 /**
@@ -43,6 +45,8 @@ export interface Placement {
     runs: Run | false | null;
     /** The projects of the config that run the file, which a Playwright `grep` may narrow per test; null when unknown. */
     projects: ProjectAbout[] | null;
+    /** The tags Playwright's config `tag` gives every test; null when the scan can't work them out. */
+    tags: string[] | null;
 }
 /** Finds the configs a file is under and decides which one runs it, as the runner started at the root would. */
 export declare class ConfigRuns {
@@ -54,7 +58,7 @@ export declare class ConfigRuns {
     private readonly projects;
     private readonly ignoreRules;
     private readonly folderStates;
-    /** The Vitest configs whose projects are being found, to stop at one whose projects name itself. */
+    /** The Vitest configs whose projects are being found, with their names, to stop at one whose projects name itself. */
     private readonly expanding;
     constructor(configs: Configs, framework: Framework, version: [number, number] | null, findsFiles: boolean);
     /**
@@ -63,6 +67,13 @@ export declare class ConfigRuns {
      * nearest config.
      */
     placementOf(file: string): Placement;
+    private place;
+    /**
+     * Playwright's config `tag`, from 1.57, which it gives every test before its own tags; null when the scan can't work
+     * it out. That is reported where the config writes `tag`; a config whose settings come from code the scan can't
+     * follow is reported there already, as its projects can't be worked out either.
+     */
+    private configTags;
     /** The projects of a config the output lists; null when the scan can't work them out. */
     projectsIn(config: ConfigFile): ProjectRecord[] | null;
     /**
@@ -79,6 +90,13 @@ export declare class ConfigRuns {
     /** A project whose files can't be worked out, because of `setting` under `key`: it may run any file. */
     private unknownProject;
     private playwrightProjects;
+    /**
+     * Whether Playwright runs each project without `--project`: from 1.64, not with `default: false`, unless a project it
+     * runs lists it in `dependencies` or `teardown`, directly or through others. Null when the scan can't tell.
+     */
+    private runsByDefault;
+    /** The name of a project a Vitest config lists, with a warning when its `test.name` can't be worked out. */
+    private listedName;
     /** A Playwright project: its own settings, else the config's, else Playwright's defaults. */
     private playwrightProject;
     /**
@@ -89,17 +107,25 @@ export declare class ConfigRuns {
     /** A folder's status and the rules inside it, worked out once per project folder however many files it holds. */
     private folderState;
     private rulesIn;
+    /**
+     * The projects of a Vitest config, the one the runner starts with or, in Vitest 5, a config another lists, whose name
+     * then goes around the names of its projects.
+     */
     private vitestProjects;
-    /** A project written in `test.projects`, which inherits the root config as each version of Vitest decides. */
+    /**
+     * A project written in `test.projects`, which inherits the root config as each version of Vitest decides, named
+     * after `index` when it has no name of its own.
+     */
     private vitestEntry;
     /**
      * The projects of a config file or folder `test.projects` names: the config's own, also the projects it lists in
-     * Vitest 5, or a project with Vitest's defaults for a folder without a config.
+     * Vitest 5, or a project with Vitest's defaults for a folder without a config. Without a name, a project is named
+     * after the package.json in its folder, else the folder.
      */
     private vitestPath;
     /**
-     * A Vitest project: its files are found from `test.dir`, else `test.root` or `root`, else its folder. With browser
-     * mode on, each of `browser.instances` is a project of its own, named as Vitest names it.
+     * A Vitest project, with the name Vitest gives it: its files are found from `test.dir`, else `test.root` or `root`,
+     * else its folder. With browser mode on, each of `browser.instances` is a project of its own, named as Vitest names it.
      */
     private vitestProject;
     /** The files a Vitest project runs and its settings; `ownTags`, when set, in place of the tags in `settings`. */