@gate-forge/pack-playwright 0.7.1 → 0.9.0

package/dist/discovery/static-discovery.d.ts

@@ -10,6 +10,15 @@ export interface ScanBudget {
     /** Max import-chain depth when resolving an alias (default 16). */
     maxImportDepth?: number;
 }
+/**
+ * A caller-supplied veto over one repo-relative posix file. Returning
+ * true means the file is NOT a static-discovery candidate. It is
+ * consulted at the candidate-seed boundary only, so it never removes
+ * a file the runner legitimately enumerates, and never shortens
+ * import traversal (a traversed import target is read for bindings
+ * whatever the seed says about it).
+ */
+export type RepoRelativeFileFilter = (repoRelativePath: string) => boolean;
 /** Options for one static test scan. */
 export interface StaticScanOptions {
     /** Absolute repo root. */
@@ -18,6 +27,29 @@ export interface StaticScanOptions {
     include: readonly string[];
     /** Repo-root-relative exclude globs (any match wins). */
     exclude: readonly string[];
+    /**
+     * Optional veto over seeded candidates (repo-relative posix paths).
+     *
+     * The seed is the ONLY place this applies: a file the caller hides
+     * here contributes no static rows, while import traversal from a
+     * kept file and the native runner's own enumeration are untouched.
+     * Gateforge's CLI passes the engine's own generated run-state
+     * artifacts (see `cli/src/state-artifacts.ts`) so the controller
+     * spec a first run persists into the state directory cannot be
+     * harvested back as a test the repository never declared.
+     */
+    excludeFile?: RepoRelativeFileFilter;
+    /**
+     * Per-file runner-globals predicate (repo-relative posix paths).
+     *
+     * TRUE when the file's own runner injects `test`/`it`/`describe` as
+     * GLOBALS (vitest `globals: true`): in such a file a bare
+     * `it('…')`/`test('…')` IS a test registration the runner owns, not
+     * an alias the scan could not resolve. Without this predicate every
+     * unbound call stays `unresolved-test-alias`, which is what a file
+     * without runner globals must keep.
+     */
+    testGlobals?: RepoRelativeFileFilter;
     /** Traversal budgets (defaults documented on {@link ScanBudget}). */
     budget?: ScanBudget;
 }
@@ -27,6 +59,8 @@ export interface StaticTestFacts {
     signatureParams: string[];
     /** `page.route(...)` (or any `<x>.route(`) inside the test body. */
     pageRoute: Location | null;
+    /** Literal URL patterns passed to `page.route(...)`, when statically known. */
+    pageRouteTargets?: string[];
     /** fetch/axios call inside the test body. */
     httpClientCall: Location | null;
     /** fetch/axios call anywhere in the file (app-boundary import hint). */
@@ -61,6 +95,10 @@ export interface StaticTestEntry {
     }>;
     /** Inference facts from the call + callback body. */
     facts: StaticTestFacts;
+    /** Literal claims from this test's Gateforge annotations, when present. */
+    annotationClaims?: string[];
+    /** Why a Gateforge annotation could not be resolved without execution. */
+    annotationIssue?: string;
 }
 /** One statically detected gap (unresolvable call, budget, dynamic title). */
 export interface StaticUnresolved {
@@ -81,11 +119,19 @@ export interface StaticParseError {
     message: string;
     location: Location;
 }
+/** A test registration is controlled by a Gateforge environment variable. */
+export interface StaticRegistrationWarning {
+    file: string;
+    titlePath: string[];
+    environmentVariable: string;
+    location: Location;
+}
 /** Result of one static scan. */
 export interface StaticScanResult {
     entries: StaticTestEntry[];
     unresolved: StaticUnresolved[];
     parseErrors: StaticParseError[];
+    registrationWarnings: StaticRegistrationWarning[];
     /** Repo-relative files that were parsed (seeded + traversed). */
     scannedFiles: string[];
     /** True when the import-traversal budget cut resolution short. */
@@ -120,9 +166,9 @@ export declare const BROWSER_FIXTURE_PARAMS: Set<string>;
  *   options: cwd, include/exclude globs, and optional budgets.
  *
  * Returns:
- *   StaticScanResult: entries, unresolved rows, parse errors, scanned
- *   files, and the budget flag. Never throws for scanner-detectable
- *   problems — those are rows (fail closed as data, not silence).
+ *   StaticScanResult: entries, unresolved rows, parse errors, registration
+ *   warnings, scanned files, and the budget flag. Never throws for
+ *   scanner-detectable problems — those are rows (fail closed as data, not silence).
  */
 export declare function scanTestFiles(options: StaticScanOptions): StaticScanResult;
 //# sourceMappingURL=static-discovery.d.ts.map

package/dist/discovery/static-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static-discovery.d.ts","sourceRoot":"","sources":["../../src/discovery/static-discovery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"static-discovery.d.ts","sourceRoot":"","sources":["../../src/discovery/static-discovery.ts"],"names":[],"mappings":"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"}