@glubean/scanner 0.1.2

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @module @glubean/scanner
+ *
+ * Scanner for Glubean test files.
+ *
+ * Supports two extraction modes:
+ * - **Static analysis**: Uses regex patterns to extract metadata
+ *   without importing files. Works everywhere.
+ * - **Runtime extraction**: Imports test files via tsx subprocess and reads
+ *   metadata from the SDK's global registry (100% accurate).
+ *
+ * @example Static analysis (default)
+ * ```ts
+ * import { createScanner } from "@glubean/scanner";
+ *
+ * const scanner = createScanner();
+ * const result = await scanner.scan("./tests");
+ * console.log(`Found ${result.testCount} tests`);
+ * ```
+ *
+ * @example Pure static analysis (no file system)
+ * ```ts
+ * import { extractFromSource } from "@glubean/scanner";
+ *
+ * const content = fs.readFileSync("test.ts", "utf-8");
+ * const exports = extractFromSource(content);
+ * ```
+ */
+export { isSpecVersionSupported, SPEC_VERSION, SUPPORTED_SPEC_VERSIONS } from "./spec.js";
+export type { BundleMetadata, ExportMeta, FileMeta, ScanOptions, ScanResult, ValidationResult } from "./types.js";
+export { Scanner } from "./scanner.js";
+export type { FileSystem, Hasher, MetadataExtractor } from "./scanner.js";
+export { createStaticExtractor, extractAliasesFromSource, extractFromSource, isGlubeanFile } from "./extractor-static.js";
+export { nodeFs, nodeHasher } from "./fs.js";
+import { Scanner } from "./scanner.js";
+import type { ScanOptions, ScanResult, ValidationResult } from "./types.js";
+/**
+ * Validate that a directory is a valid Glubean project.
+ *
+ * @param dir Directory to validate
+ * @returns Validation result with errors and warnings
+ *
+ * @example
+ * ```ts
+ * const result = await validate("./tests");
+ * if (!result.valid) {
+ *   console.error("Errors:", result.errors);
+ * }
+ * ```
+ */
+export declare function validate(dir: string): Promise<ValidationResult>;
+/**
+ * Scan a directory for Glubean test files.
+ *
+ * Uses static analysis by default. For runtime extraction,
+ * create a Scanner with a custom MetadataExtractor.
+ *
+ * @param dir Directory to scan
+ * @param options Scan options
+ * @returns Scan result with file metadata and test counts
+ *
+ * @example
+ * ```ts
+ * const result = await scan("./tests");
+ * console.log(`Found ${result.testCount} tests`);
+ * ```
+ */
+export declare function scan(dir: string, options?: ScanOptions): Promise<ScanResult>;
+/**
+ * Create a scanner with static analysis extraction.
+ *
+ * Uses regex-based static analysis to extract metadata without importing files.
+ *
+ * @param specVersion Spec version to use for scanning
+ * @returns New Scanner instance
+ *
+ * @example
+ * ```ts
+ * const scanner = createScanner("2.0");
+ * const result = await scanner.scan("./tests");
+ * ```
+ */
+export declare function createScanner(specVersion?: string): Scanner;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAG1F,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGlH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG1E,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG1H,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAU5E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAE/D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAE5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,WAAW,GAAE,MAAqB,GAAG,OAAO,CAGzE"}

package/dist/index.js

@@ -0,0 +1,98 @@
+/**
+ * @module @glubean/scanner
+ *
+ * Scanner for Glubean test files.
+ *
+ * Supports two extraction modes:
+ * - **Static analysis**: Uses regex patterns to extract metadata
+ *   without importing files. Works everywhere.
+ * - **Runtime extraction**: Imports test files via tsx subprocess and reads
+ *   metadata from the SDK's global registry (100% accurate).
+ *
+ * @example Static analysis (default)
+ * ```ts
+ * import { createScanner } from "@glubean/scanner";
+ *
+ * const scanner = createScanner();
+ * const result = await scanner.scan("./tests");
+ * console.log(`Found ${result.testCount} tests`);
+ * ```
+ *
+ * @example Pure static analysis (no file system)
+ * ```ts
+ * import { extractFromSource } from "@glubean/scanner";
+ *
+ * const content = fs.readFileSync("test.ts", "utf-8");
+ * const exports = extractFromSource(content);
+ * ```
+ */
+// Re-export spec constants
+export { isSpecVersionSupported, SPEC_VERSION, SUPPORTED_SPEC_VERSIONS } from "./spec.js";
+// Re-export Scanner class and interfaces
+export { Scanner } from "./scanner.js";
+// Re-export static analysis extractor
+export { createStaticExtractor, extractAliasesFromSource, extractFromSource, isGlubeanFile } from "./extractor-static.js";
+// Re-export file system implementations
+export { nodeFs, nodeHasher } from "./fs.js";
+// Imports for convenience functions
+import { nodeFs, nodeHasher } from "./fs.js";
+import { createStaticExtractor } from "./extractor-static.js";
+import { Scanner } from "./scanner.js";
+import { SPEC_VERSION } from "./spec.js";
+// Default scanner instance (static analysis)
+const defaultScanner = new Scanner(nodeFs, nodeHasher, SPEC_VERSION, createStaticExtractor((path) => nodeFs.readText(path)));
+/**
+ * Validate that a directory is a valid Glubean project.
+ *
+ * @param dir Directory to validate
+ * @returns Validation result with errors and warnings
+ *
+ * @example
+ * ```ts
+ * const result = await validate("./tests");
+ * if (!result.valid) {
+ *   console.error("Errors:", result.errors);
+ * }
+ * ```
+ */
+export function validate(dir) {
+    return defaultScanner.validate(dir);
+}
+/**
+ * Scan a directory for Glubean test files.
+ *
+ * Uses static analysis by default. For runtime extraction,
+ * create a Scanner with a custom MetadataExtractor.
+ *
+ * @param dir Directory to scan
+ * @param options Scan options
+ * @returns Scan result with file metadata and test counts
+ *
+ * @example
+ * ```ts
+ * const result = await scan("./tests");
+ * console.log(`Found ${result.testCount} tests`);
+ * ```
+ */
+export function scan(dir, options) {
+    return defaultScanner.scan(dir, options);
+}
+/**
+ * Create a scanner with static analysis extraction.
+ *
+ * Uses regex-based static analysis to extract metadata without importing files.
+ *
+ * @param specVersion Spec version to use for scanning
+ * @returns New Scanner instance
+ *
+ * @example
+ * ```ts
+ * const scanner = createScanner("2.0");
+ * const result = await scanner.scan("./tests");
+ * ```
+ */
+export function createScanner(specVersion = SPEC_VERSION) {
+    const extractor = createStaticExtractor((path) => nodeFs.readText(path));
+    return new Scanner(nodeFs, nodeHasher, specVersion, extractor);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,2BAA2B;AAC3B,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAK1F,yCAAyC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,sCAAsC;AACtC,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE1H,wCAAwC;AACxC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE7C,oCAAoC;AACpC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,6CAA6C;AAC7C,MAAM,cAAc,GAAG,IAAI,OAAO,CAChC,MAAM,EACN,UAAU,EACV,YAAY,EACZ,qBAAqB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CACvD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,IAAI,CAAC,GAAW,EAAE,OAAqB;IACrD,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,cAAsB,YAAY;IAC9D,MAAM,SAAS,GAAG,qBAAqB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AACjE,CAAC"}

package/dist/scanner.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Core scanner logic for extracting test metadata from source files.
+ *
+ * This module uses runtime extraction - it imports test files and reads
+ * metadata from the SDK's global registry instead of static analysis.
+ */
+import type { ExportMeta, ScanOptions, ScanResult, ValidationResult } from "./types.js";
+/** File system interface for runtime abstraction */
+export interface FileSystem {
+    /** Check if a path exists */
+    exists(path: string): Promise<boolean>;
+    /** Read file as text */
+    readText(path: string): Promise<string>;
+    /** Read file as bytes (for hashing) */
+    readBytes(path: string): Promise<Uint8Array>;
+    /** Walk directory recursively, yielding file paths */
+    walk(dir: string, options: {
+        extensions: string[];
+        skipDirs: string[];
+    }): AsyncIterable<string>;
+    /** Join path segments */
+    join(...segments: string[]): string;
+    /** Get relative path from base to target */
+    relative(base: string, target: string): string;
+    /** Resolve path to absolute */
+    resolve?(path: string): string;
+}
+/** Hash function interface */
+export interface Hasher {
+    /** Calculate SHA-256 hash of content, returns "sha256-..." */
+    sha256(content: Uint8Array): Promise<string>;
+}
+/** Metadata extractor interface (runtime-specific) */
+export type MetadataExtractor = (filePath: string, customFns?: string[]) => Promise<ExportMeta[]>;
+/**
+ * Scanner class for extracting test metadata from a directory.
+ *
+ * Uses runtime extraction: imports test files and reads from SDK registry.
+ */
+export declare class Scanner {
+    private readonly specVersion;
+    private readonly fs;
+    private readonly hasher;
+    private readonly extractor?;
+    constructor(fs: FileSystem, hasher: Hasher, specVersion?: string, extractor?: MetadataExtractor);
+    /**
+     * Collect custom function names from `.extend()` calls across all .ts files.
+     * Returns an array of alias names (e.g. ["browserTest", "screenshotTest"]).
+     */
+    private collectAliases;
+    /**
+     * Validate that a directory is a valid Glubean project.
+     */
+    validate(dir: string): Promise<ValidationResult>;
+    /**
+     * Scan a directory for Glubean test files using runtime extraction.
+     *
+     * This imports each test file in a subprocess and reads metadata from
+     * the SDK's global registry, ensuring accurate extraction without
+     * regex-based parsing.
+     */
+    scan(dir: string, options?: ScanOptions): Promise<ScanResult>;
+}
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAY,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAElG,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,uCAAuC;IACvC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7C,sDAAsD;IACtD,IAAI,CACF,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,GACpD,aAAa,CAAC,MAAM,CAAC,CAAC;IACzB,yBAAyB;IACzB,IAAI,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACpC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/C,+BAA+B;IAC/B,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED,8BAA8B;AAC9B,MAAM,WAAW,MAAM;IACrB,8DAA8D;IAC9D,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,sDAAsD;AACtD,MAAM,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;AAQlG;;;;GAIG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAoB;gBAG7C,EAAE,EAAE,UAAU,EACd,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,MAAqB,EAClC,SAAS,CAAC,EAAE,iBAAiB;IAiB/B;;;OAGG;YACW,cAAc;IAmB5B;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsEtD;;;;;;OAMG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;CAuFxE"}

package/dist/scanner.js

@@ -0,0 +1,192 @@
+/**
+ * Core scanner logic for extracting test metadata from source files.
+ *
+ * This module uses runtime extraction - it imports test files and reads
+ * metadata from the SDK's global registry instead of static analysis.
+ */
+import { isSpecVersionSupported, SPEC_VERSION, SUPPORTED_SPEC_VERSIONS } from "./spec.js";
+import { extractAliasesFromSource } from "./extractor-static.js";
+const DEFAULT_SKIP_DIRS = ["node_modules", ".git", "dist", "build"];
+const DEFAULT_EXTENSIONS = [".ts"];
+// File detection uses the `.test.ts` extension as the convention.
+// All *.test.ts files in scanned directories are considered Glubean test files.
+/**
+ * Scanner class for extracting test metadata from a directory.
+ *
+ * Uses runtime extraction: imports test files and reads from SDK registry.
+ */
+export class Scanner {
+    specVersion;
+    fs;
+    hasher;
+    extractor;
+    constructor(fs, hasher, specVersion = SPEC_VERSION, extractor) {
+        if (!isSpecVersionSupported(specVersion)) {
+            throw new Error(`Unsupported spec version: ${specVersion}. Supported: ${SUPPORTED_SPEC_VERSIONS.join(", ")}`);
+        }
+        this.fs = fs;
+        this.hasher = hasher;
+        this.specVersion = specVersion;
+        this.extractor = extractor;
+    }
+    /**
+     * Collect custom function names from `.extend()` calls across all .ts files.
+     * Returns an array of alias names (e.g. ["browserTest", "screenshotTest"]).
+     */
+    async collectAliases(dir, skipDirs = DEFAULT_SKIP_DIRS, extensions = DEFAULT_EXTENSIONS) {
+        const aliases = new Set();
+        try {
+            for await (const filePath of this.fs.walk(dir, { extensions, skipDirs })) {
+                const content = await this.fs.readText(filePath);
+                for (const alias of extractAliasesFromSource(content)) {
+                    aliases.add(alias);
+                }
+            }
+        }
+        catch {
+            // Non-fatal — continue without aliases
+        }
+        return aliases.size > 0 ? [...aliases] : undefined;
+    }
+    /**
+     * Validate that a directory is a valid Glubean project.
+     */
+    async validate(dir) {
+        const errors = [];
+        const warnings = [];
+        let detectedSpecVersion;
+        // Check for package.json
+        const packageJsonPath = this.fs.join(dir, "package.json");
+        const hasPackageJson = await this.fs.exists(packageJsonPath);
+        if (!hasPackageJson) {
+            warnings.push("No package.json found - are you sure this is a Glubean project?");
+        }
+        else {
+            // Try to detect SDK version from package.json
+            try {
+                const content = await this.fs.readText(packageJsonPath);
+                const json = JSON.parse(content);
+                // Check dependencies for @glubean/sdk
+                const deps = { ...json.dependencies, ...json.devDependencies };
+                const sdkDep = deps["@glubean/sdk"];
+                if (sdkDep) {
+                    // Extract version from dep like "^0.12.0" or "workspace:*"
+                    const versionMatch = sdkDep.match(/(\d+)\.\d+\.\d+/);
+                    if (versionMatch) {
+                        const majorVersion = parseInt(versionMatch[1]);
+                        detectedSpecVersion = majorVersion >= 2 ? "2.0" : "1.0";
+                    }
+                }
+            }
+            catch {
+                warnings.push("Failed to parse package.json");
+            }
+        }
+        // Check for at least one *.test.ts file
+        let foundTestFile = false;
+        try {
+            for await (const filePath of this.fs.walk(dir, {
+                extensions: DEFAULT_EXTENSIONS,
+                skipDirs: DEFAULT_SKIP_DIRS,
+            })) {
+                if (filePath.endsWith(".test.ts")) {
+                    foundTestFile = true;
+                    break;
+                }
+            }
+        }
+        catch (err) {
+            errors.push(`Failed to scan directory: ${err}`);
+        }
+        if (!foundTestFile) {
+            errors.push("No *.test.ts files found. " +
+                "Ensure your test files are named *.test.ts.");
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+            detectedSpecVersion: detectedSpecVersion || this.specVersion,
+        };
+    }
+    /**
+     * Scan a directory for Glubean test files using runtime extraction.
+     *
+     * This imports each test file in a subprocess and reads metadata from
+     * the SDK's global registry, ensuring accurate extraction without
+     * regex-based parsing.
+     */
+    async scan(dir, options = {}) {
+        const specVersion = options.specVersion || this.specVersion;
+        const skipDirs = options.skipDirs || DEFAULT_SKIP_DIRS;
+        const extensions = options.extensions || DEFAULT_EXTENSIONS;
+        const files = {};
+        let testCount = 0;
+        const allTags = new Set();
+        const warnings = [];
+        // Optionally validate first
+        if (options.requirePackageJson) {
+            const validation = await this.validate(dir);
+            if (!validation.valid) {
+                throw new Error(`Invalid Glubean project: ${validation.errors.join("; ")}`);
+            }
+            warnings.push(...validation.warnings);
+        }
+        else {
+            // Just check package.json for warning
+            const packageJsonPath = this.fs.join(dir, "package.json");
+            const hasPackageJson = await this.fs.exists(packageJsonPath);
+            if (!hasPackageJson) {
+                warnings.push("No package.json found in root directory");
+            }
+        }
+        if (!this.extractor) {
+            throw new Error("No metadata extractor configured. Use createScanner() for the default extractor.");
+        }
+        // Phase 1: collect .extend() aliases from all .ts files
+        const aliases = await this.collectAliases(dir, skipDirs, extensions);
+        // Phase 2: collect all *.test.ts files
+        const testFiles = [];
+        for await (const filePath of this.fs.walk(dir, { extensions, skipDirs })) {
+            if (!filePath.endsWith(".test.ts"))
+                continue;
+            testFiles.push(filePath);
+        }
+        // Extract metadata from each file using runtime extraction
+        for (const filePath of testFiles) {
+            try {
+                const exports = await this.extractor(filePath, aliases);
+                if (exports.length > 0) {
+                    const relativePath = this.fs.relative(dir, filePath);
+                    const contentBytes = await this.fs.readBytes(filePath);
+                    const hash = await this.hasher.sha256(contentBytes);
+                    files[relativePath] = { hash, exports };
+                    // Count tests and collect tags
+                    for (const exp of exports) {
+                        testCount += 1;
+                        // Collect tags
+                        if (exp.tags) {
+                            exp.tags.forEach((tag) => allTags.add(tag));
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                warnings.push(`Failed to extract metadata from ${filePath}: ${err}`);
+            }
+        }
+        if (Object.keys(files).length === 0) {
+            warnings.push("No Glubean test files found. " +
+                "Ensure your test files are named *.test.ts and export test().");
+        }
+        return {
+            specVersion,
+            files,
+            testCount,
+            fileCount: Object.keys(files).length,
+            tags: Array.from(allTags),
+            warnings,
+        };
+    }
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

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

package/dist/spec.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Glubean Spec Version
+ *
+ * This defines the contract between SDK, Scanner, and Runner.
+ * - Major version: Breaking changes (Scanner/Runner may not be compatible)
+ * - Minor version: New features (backward compatible)
+ *
+ * History:
+ * - 1.0: Initial release
+ *   - testCase(meta, fn) and testSuite(meta, config)
+ *   - TestContext: vars, secrets, log, assert, trace
+ *   - TestCaseMeta: id, name, description, tags, timeout, only, skip
+ *   - TestSuiteMeta: id, name, description, tags, only, skip
+ *
+ * - 2.0: Unified Builder API
+ *   - test(meta, fn) for simple tests (replaces testCase)
+ *   - test(id).step().build() for multi-step tests (replaces testSuite)
+ *   - Global registry for runtime metadata extraction
+ *   - Legacy testCase/testSuite API removed
+ */
+export declare const SPEC_VERSION = "2.0";
+/**
+ * Supported spec versions for scanning.
+ * Scanner can read test files from these versions.
+ */
+export declare const SUPPORTED_SPEC_VERSIONS: readonly ["1.0", "2.0"];
+/**
+ * Check if a spec version is supported by this scanner.
+ */
+export declare function isSpecVersionSupported(version: string): boolean;
+//# sourceMappingURL=spec.d.ts.map

package/dist/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,yBAA0B,CAAC;AAE/D;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI/D"}

package/dist/spec.js

@@ -0,0 +1,33 @@
+/**
+ * Glubean Spec Version
+ *
+ * This defines the contract between SDK, Scanner, and Runner.
+ * - Major version: Breaking changes (Scanner/Runner may not be compatible)
+ * - Minor version: New features (backward compatible)
+ *
+ * History:
+ * - 1.0: Initial release
+ *   - testCase(meta, fn) and testSuite(meta, config)
+ *   - TestContext: vars, secrets, log, assert, trace
+ *   - TestCaseMeta: id, name, description, tags, timeout, only, skip
+ *   - TestSuiteMeta: id, name, description, tags, only, skip
+ *
+ * - 2.0: Unified Builder API
+ *   - test(meta, fn) for simple tests (replaces testCase)
+ *   - test(id).step().build() for multi-step tests (replaces testSuite)
+ *   - Global registry for runtime metadata extraction
+ *   - Legacy testCase/testSuite API removed
+ */
+export const SPEC_VERSION = "2.0";
+/**
+ * Supported spec versions for scanning.
+ * Scanner can read test files from these versions.
+ */
+export const SUPPORTED_SPEC_VERSIONS = ["1.0", "2.0"];
+/**
+ * Check if a spec version is supported by this scanner.
+ */
+export function isSpecVersionSupported(version) {
+    return SUPPORTED_SPEC_VERSIONS.includes(version);
+}
+//# sourceMappingURL=spec.js.map

package/dist/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,KAAK,CAAU,CAAC;AAE/D;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,OAAO,uBAAuB,CAAC,QAAQ,CACrC,OAAmD,CACpD,CAAC;AACJ,CAAC"}

package/dist/static.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pure static analysis entry point for Glubean test files.
+ *
+ * This module re-exports the pure regex-based extractor and SDK import
+ * detection utilities. It has **no runtime dependencies** — no file system
+ * access — making it safe to consume from constrained environments
+ * such as the VSCode extension.
+ *
+ * @example
+ * ```ts
+ * import { extractFromSource, isGlubeanFile } from "@glubean/scanner/static";
+ *
+ * const code = await fs.readFile("tests/api.test.ts", "utf-8");
+ * if (isGlubeanFile(code)) {
+ *   const tests = extractFromSource(code);
+ *   console.log(`Found ${tests.length} tests`);
+ * }
+ * ```
+ *
+ * @module static
+ */
+export { createStaticExtractor, extractAliasesFromSource, extractFromSource, isGlubeanFile, } from "./extractor-static.js";
+export type { ExportMeta } from "./types.js";
+//# sourceMappingURL=static.d.ts.map

package/dist/static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../src/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/static.js

@@ -0,0 +1,23 @@
+/**
+ * Pure static analysis entry point for Glubean test files.
+ *
+ * This module re-exports the pure regex-based extractor and SDK import
+ * detection utilities. It has **no runtime dependencies** — no file system
+ * access — making it safe to consume from constrained environments
+ * such as the VSCode extension.
+ *
+ * @example
+ * ```ts
+ * import { extractFromSource, isGlubeanFile } from "@glubean/scanner/static";
+ *
+ * const code = await fs.readFile("tests/api.test.ts", "utf-8");
+ * if (isGlubeanFile(code)) {
+ *   const tests = extractFromSource(code);
+ *   console.log(`Found ${tests.length} tests`);
+ * }
+ * ```
+ *
+ * @module static
+ */
+export { createStaticExtractor, extractAliasesFromSource, extractFromSource, isGlubeanFile, } from "./extractor-static.js";
+//# sourceMappingURL=static.js.map

package/dist/static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.js","sourceRoot":"","sources":["../src/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,GACd,MAAM,uBAAuB,CAAC"}