test-inventory 0.1.1 → 0.2.0

package/dist/values.js

@@ -56,6 +56,35 @@ export class Values {
     bindingsByScope = new Map();
     cache = new Map();
     pending = new Set();
+    /** The functions being read at one of their calls, innermost last. */
+    calls = [];
+    /**
+     * Runs `read` with a function's parameters bound to the arguments of one call, worked out where the call is, so that
+     * titles and values built from them resolve, as in `test(\`${side} rejects a zero quantity\`)` inside
+     * `validatesQuantity('buy')`. `args` stop at a spread argument, after which no position is known. A missing argument
+     * takes the parameter's default value, worked out in `scopes`, the scopes around the function.
+     */
+    withArguments(fn, args, scopes, read) {
+        const parameters = new Map();
+        for (const [index, parameter] of fn.params.entries()) {
+            const target = parameter.type === 'AssignmentPattern' ? parameter.left : parameter;
+            if (target.type !== 'Identifier')
+                continue;
+            const argument = args.at(index);
+            if (argument)
+                parameters.set(target.name, () => argument);
+            else if (parameter.type === 'AssignmentPattern') {
+                parameters.set(target.name, () => this.resolve(parameter.right, [...scopes, fn]));
+            }
+        }
+        this.calls.push({ fn, parameters, cache: new Map() });
+        try {
+            return read();
+        }
+        finally {
+            this.calls.pop();
+        }
+    }
     /** `scopes` lists the scope nodes around the expression, outermost first. */
     resolve(node, scopes) {
         const expression = unwrap(node);
@@ -179,6 +208,11 @@ export class Values {
     declarationOf(name, scopes) {
         return this.lookup(name, scopes)?.binding.declaration ?? null;
     }
+    /** The module a name is imported from where it is used; null when it isn't an import. */
+    importSource(name, scopes) {
+        const binding = this.lookup(name, scopes)?.binding;
+        return binding?.kind === 'import' ? binding.source : null;
+    }
     /** Whether a name refers to a function or class declared in the file. */
     isFunction(name, scopes) {
         return this.lookup(name, scopes)?.binding.kind === 'function';
@@ -203,12 +237,19 @@ export class Values {
             case 'import':
                 return { ok: false, importedFrom: binding.source };
             case 'function':
-            case 'other':
                 return UNRESOLVED;
+            case 'other':
+                return this.resolveParameter(name, binding.declaration);
         }
     }
+    /** A parameter of a function read at one of its calls: the argument given there. */
+    resolveParameter(name, fn) {
+        const call = this.calls.findLast((item) => item.fn === fn);
+        return call?.parameters.get(name)?.() ?? UNRESOLVED;
+    }
     resolveConstant(init, scopes) {
-        const cached = this.cache.get(init);
+        const cache = this.calls.at(-1)?.cache ?? this.cache;
+        const cached = cache.get(init);
         if (cached)
             return cached;
         if (this.pending.has(init))
@@ -216,7 +257,7 @@ export class Values {
         this.pending.add(init);
         const resolved = this.resolve(init, scopes);
         this.pending.delete(init);
-        this.cache.set(init, resolved);
+        cache.set(init, resolved);
         return resolved;
     }
     enumMembers(node, scopes) {

package/package.json

@@ -1,9 +1,11 @@
 {
   "name": "test-inventory",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Test metadata from source code, not from test results.",
   "keywords": [
     "testing",
+    "playwright",
+    "vitest",
     "test-suite",
     "test-inventory",
     "static-analysis",
@@ -77,26 +79,27 @@
     "changeset": "changeset"
   },
   "dependencies": {
-    "oxc-parser": "0.153.0",
+    "oxc-parser": "0.154.0",
     "tinyglobby": "^0.2.17"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
     "@changesets/changelog-github": "^1.0.1",
     "@changesets/cli": "^3.0.3",
-    "@types/node": "^22.12.0",
-    "@vitest/coverage-v8": "5.0.3",
+    "@types/node": "~22.12.0",
+    "@vitest/coverage-v8": "5.0.4",
     "ajv": "^8.20.0",
-    "eslint": "^10.12.0",
-    "prettier": "^3.9.9",
+    "eslint": "~10.12.0",
+    "prettier": "3.9.10",
     "publint": "^0.3.25",
     "ts-json-schema-generator": "2.9.0",
-    "typedoc": "0.28.20",
+    "typedoc": "^0.28.20",
     "typedoc-plugin-markdown": "^4.13.1",
     "typedoc-vitepress-theme": "^1.1.4",
     "typescript": "~6.0.3",
-    "typescript-eslint": "^8.71.1",
+    "typescript-eslint": "~8.71.2",
     "vitepress": "2.0.0-alpha.20",
-    "vitest": "5.0.3"
+    "vitepress-plugin-llms": "^1.14.0",
+    "vitest": "5.0.4"
   }
 }

package/schema/v1.json

@@ -268,6 +268,17 @@
           "minimum": 1,
           "description": "In UTF-16 code units."
         },
+        "declaredAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/DeclaredAt"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Where a helper imported from another file writes the describe; the record's location is then the call that registers it. Null for code written in the scanned file."
+        },
         "title": {
           "type": "string",
           "description": "As the runner shows it, tags included."
@@ -385,6 +396,7 @@
         "lineEnd",
         "columnStart",
         "columnEnd",
+        "declaredAt",
         "title",
         "titleWithoutTags",
         "hasDynamicTitle",
@@ -409,6 +421,29 @@
       ],
       "description": "A describe block, with what is written on the describe itself. Inherited values are on the tests."
     },
+    "DeclaredAt": {
+      "type": "object",
+      "properties": {
+        "relativeFilePath": {
+          "type": "string",
+          "description": "The helper's file, from the project root."
+        },
+        "lineStart": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "columnStart": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "In UTF-16 code units."
+        }
+      },
+      "required": [
+        "relativeFilePath",
+        "lineStart",
+        "columnStart"
+      ]
+    },
     "Annotation": {
       "type": "object",
       "properties": {
@@ -524,6 +559,17 @@
           "minimum": 1,
           "description": "In UTF-16 code units."
         },
+        "declaredAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/DeclaredAt"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Where a helper imported from another file writes the test; the record's location is then the call that registers it. Null for code written in the scanned file."
+        },
         "title": {
           "type": "string",
           "description": "As the runner shows it, tags included."
@@ -646,7 +692,7 @@
           "items": {
             "type": "string"
           },
-          "description": "From the test and its describes. Playwright only."
+          "description": "From the test, its describes and the `test.describe.configure()` calls around it. Playwright only."
         },
         "meta": {
           "anyOf": [
@@ -702,6 +748,7 @@
         "lineEnd",
         "columnStart",
         "columnEnd",
+        "declaredAt",
         "title",
         "titleWithoutTags",
         "hasDynamicTitle",