@wp-tester/config 0.1.1 → 0.1.3

package/dist/path-utils.js

@@ -0,0 +1,141 @@
+import { existsSync, statSync } from "fs";
+import { join, dirname, resolve, isAbsolute } from "path";
+import { fileURLToPath } from "url";
+import { hostToVfs } from './path-mappers.js';
+/**
+ * Get the actual working directory, accounting for tools like tsx that may change process.cwd()
+ * When running via npx or tsx, INIT_CWD contains the original directory where the command was invoked
+ */
+export function getWorkingDirectory() {
+    return process.env.INIT_CWD || process.cwd();
+}
+/**
+ * Resolve a path to an absolute path.
+ * If the path is already absolute, return it as-is.
+ * Otherwise, resolve it relative to the base directory.
+ *
+ * @param path - Path to resolve (relative or absolute)
+ * @param baseDir - Base directory to resolve relative paths from
+ * @returns Absolute path
+ */
+export function resolveAbsolute(path, baseDir) {
+    return isAbsolute(path) ? path : resolve(baseDir, path);
+}
+export function configPath() {
+    return join(getWorkingDirectory(), "wp-tester.json");
+}
+export function getSchemaPath(importMetaUrl) {
+    // For ESM in production (built files) - use import.meta.url from this module
+    // This works when the package is installed via npm or run via npx
+    const metaUrl = importMetaUrl || import.meta.url;
+    if (metaUrl) {
+        const currentDir = dirname(fileURLToPath(metaUrl));
+        const schemaPath = join(currentDir, "schema.json");
+        if (existsSync(schemaPath)) {
+            return schemaPath;
+        }
+    }
+    // For CommonJS (built files)
+    if (typeof __dirname !== "undefined") {
+        return join(__dirname, "schema.json");
+    }
+    // For dev mode: try to find the config package
+    // Could be in monorepo (packages/config) or installed (node_modules)
+    const candidates = [
+        // Monorepo from root
+        join(process.cwd(), "packages/config/src/schema.json"),
+        // Monorepo from a package directory
+        join(process.cwd(), "../config/src/schema.json"),
+        // Installed package
+        join(process.cwd(), "node_modules/@wp-tester/config/dist/schema.json"),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    // Last resort
+    return candidates[candidates.length - 1];
+}
+/**
+ * Get the absolute config file path.
+ *
+ * @param config - Path to config file (relative or absolute)
+ * @returns Absolute path to the config file
+ */
+export function getConfigPath(config) {
+    // Expand tilde (~) to home directory
+    if (config.startsWith('~/') || config === '~') {
+        const homeDir = process.env.HOME || process.env.USERPROFILE;
+        if (!homeDir) {
+            throw new Error('Unable to resolve home directory');
+        }
+        config = config === '~' ? homeDir : join(homeDir, config.slice(2));
+    }
+    return isAbsolute(config) ? config : resolve(getWorkingDirectory(), config);
+}
+/**
+ * Normalize a config path to ensure it points to a file, not a directory.
+ * If the path is a directory, appends 'wp-tester.json' to it.
+ * Used by readConfigFile, resolveConfig, and the test watcher to handle
+ * directory paths passed via --config flag.
+ *
+ * @param configPath - Path to config file or directory (relative or absolute)
+ * @returns Absolute path to the config file
+ */
+export function normalizeConfigPath(configPath) {
+    const absolutePath = getConfigPath(configPath);
+    // Check if path is a directory (synchronous)
+    try {
+        const stats = statSync(absolutePath);
+        if (stats.isDirectory()) {
+            return join(absolutePath, 'wp-tester.json');
+        }
+    }
+    catch {
+        // If stat fails, assume it's a file path
+    }
+    return absolutePath;
+}
+/**
+ * Get the config file directory path.
+ *
+ * @param configPath - Path to config file
+ * @returns Directory path where the config file is located
+ */
+export function getConfigDir(configPath) {
+    return dirname(getConfigPath(configPath));
+}
+/**
+ * Get the project root directory path.
+ *
+ * Returns config.projectHostPath if specified (resolved relative to config file or as absolute),
+ * otherwise returns the config file's directory.
+ *
+ * @param config - Config object
+ * @param configPath - Optional path to config file (needed to resolve relative projectHostPath)
+ * @returns Absolute path to the project root directory
+ */
+export function getProjectDir(config, configPath) {
+    // Get base directory: config file location or cwd
+    const baseDir = configPath ? getConfigDir(configPath) : getWorkingDirectory();
+    // If projectHostPath is specified, resolve it relative to base directory
+    if (config.projectHostPath) {
+        return resolveAbsolute(config.projectHostPath, baseDir);
+    }
+    // No projectHostPath specified, return base directory
+    return baseDir;
+}
+/**
+ * Convert a host path to a ResolvedPath using the project path mapping
+ * @param hostPath - Absolute path on host
+ * @param projectPath - Project path mapping
+ * @returns ResolvedPath with both host and VFS paths
+ */
+export function toResolvedPath(hostPath, projectPath) {
+    return {
+        hostPath,
+        vfsPath: hostToVfs(hostPath, projectPath),
+    };
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/path-utils.js.map

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

package/dist/resolved-types.d.ts

@@ -1,5 +1,12 @@
 import type { BlueprintV1Declaration } from "@wp-playground/blueprints";
-import type { Mount, PHPUnitConfig, Tests, Environment, WPTesterConfig, TestMode, ProjectType, BaseReporterOptions, JsonReporterOptions } from "./wp-tester-config.js";
+import type { Mount, Tests, Environment, WPTesterConfig, TestMode, ProjectType, BaseReporterOptions } from "./wp-tester-config.js";
+/**
+ * Resolved JSON reporter options with required outputFile.
+ */
+export interface ResolvedJsonReporterOptions extends BaseReporterOptions {
+    /** Absolute path where the JSON report file will be written */
+    outputFile: string;
+}
 /**
  * Resolved reporters configuration.
  * Supports boolean shorthand for default reporter (true = enable with defaults).
@@ -7,15 +14,23 @@ import type { Mount, PHPUnitConfig, Tests, Environment, WPTesterConfig, TestMode
 export interface ResolvedReporters {
     /** Default reporter options (supports boolean shorthand: true = enable with defaults) */
     default?: boolean | BaseReporterOptions;
-    /** JSON reporter options */
-    json?: JsonReporterOptions;
+    /** JSON reporter options with resolved outputFile path */
+    json?: ResolvedJsonReporterOptions;
 }
 /**
- * Resolved PHPUnit configuration with absolute paths and required testMode.
+ * Resolved PHPUnit configuration with resolved paths and required testMode.
  */
-export interface ResolvedPHPUnitConfig extends Omit<PHPUnitConfig, 'testMode'> {
+export interface ResolvedPHPUnitConfig {
+    /** Path to PHPUnit executable with host and VFS paths */
+    phpunitPath: ResolvedPath;
+    /** Path to PHPUnit configuration file with host and VFS paths */
+    configPath: ResolvedPath;
+    /** Path to PHPUnit bootstrap file with host and VFS paths */
+    bootstrapPath?: ResolvedPath;
     /** Test mode (always defined after resolution, defaults to "unit") */
     testMode: TestMode;
+    /** Additional arguments to pass to PHPUnit */
+    phpunitArgs?: string[];
 }
 /**
  * Resolved test configuration with resolved PHPUnit config.
@@ -25,6 +40,15 @@ export interface ResolvedTests extends Omit<Tests, 'phpunit'> {
     /** Allow the test suite to pass when no tests are executed */
     passWithNoTests?: boolean;
 }
+/**
+ * Resolved path type with a host and VFS path.
+ */
+export interface ResolvedPath {
+    /** Absolute path on host system */
+    hostPath: string;
+    /** Absolute path in VFS */
+    vfsPath: string;
+}
 /**
  * Resolved blueprint with guaranteed preferredVersions.
  */
@@ -49,10 +73,8 @@ export interface ResolvedEnvironment extends Omit<Environment, 'blueprint' | 'mo
  * Resolved config with all paths absolute and optional fields set.
  */
 export interface ResolvedWPTesterConfig extends Omit<WPTesterConfig, 'projectHostPath' | 'projectVFSPath' | 'projectType' | 'reporters' | 'environments' | 'tests'> {
-    /** Absolute path to project on host (always defined after resolution) */
-    projectHostPath: string;
-    /** VFS path determined by project type or explicit config (always defined after resolution) */
-    projectVFSPath: string;
+    /** Resolved project path with both host and VFS paths */
+    projectPath: ResolvedPath;
     /** Project type (always defined after resolution) */
     projectType: ProjectType;
     /** Resolved environments with loaded blueprints */

package/dist/resolved-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolved-types.d.ts","sourceRoot":"","sources":["../src/resolved-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEpK;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,OAAO,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAAC;IACxC,4BAA4B;IAC5B,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC;IAC5E,sEAAsE;IACtE,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC;IAC3D,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,sBAAsB,EAAE,mBAAmB,CAAC;IAC1F,iFAAiF;IACjF,iBAAiB,EAAE,QAAQ,CAAC,WAAW,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;CACvF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IACrG,6FAA6F;IAC7F,SAAS,EAAE,iBAAiB,CAAC;IAC7B,kDAAkD;IAClD,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,sGAAsG;IACtG,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,cAAc,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,aAAa,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC;IACjK,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC;IACxB,+FAA+F;IAC/F,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,WAAW,EAAE,WAAW,CAAC;IACzB,mDAAmD;IACnD,YAAY,EAAE,mBAAmB,EAAE,CAAC;IACpC,sDAAsD;IACtD,KAAK,EAAE,aAAa,CAAC;IACrB,sFAAsF;IACtF,SAAS,EAAE,iBAAiB,CAAC;CAC9B"}
+{"version":3,"file":"resolved-types.d.ts","sourceRoot":"","sources":["../src/resolved-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEhI;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,OAAO,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAAC;IACxC,0DAA0D;IAC1D,IAAI,CAAC,EAAE,2BAA2B,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,WAAW,EAAE,YAAY,CAAC;IAC1B,iEAAiE;IACjE,UAAU,EAAE,YAAY,CAAC;IACzB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,EAAE,QAAQ,CAAC;IACnB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC;IAC3D,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,sBAAsB,EAAE,mBAAmB,CAAC;IAC1F,iFAAiF;IACjF,iBAAiB,EAAE,QAAQ,CAAC,WAAW,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;CACvF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IACrG,6FAA6F;IAC7F,SAAS,EAAE,iBAAiB,CAAC;IAC7B,kDAAkD;IAClD,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,sGAAsG;IACtG,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,cAAc,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,aAAa,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC;IACjK,yDAAyD;IACzD,WAAW,EAAE,YAAY,CAAC;IAC1B,qDAAqD;IACrD,WAAW,EAAE,WAAW,CAAC;IACzB,mDAAmD;IACnD,YAAY,EAAE,mBAAmB,EAAE,CAAC;IACpC,sDAAsD;IACtD,KAAK,EAAE,aAAa,CAAC;IACrB,sFAAsF;IACtF,SAAS,EAAE,iBAAiB,CAAC;CAC9B"}

package/dist/schema.json

@@ -2432,8 +2432,9 @@
           "type": "boolean"
         },
         "outputFile": {
-          "description": "Path where the JSON report file should be written",
-          "type": "string"
+          "description": "Path where the JSON report file should be written. Defaults to wp-tester-results.json in the config directory.",
+          "type": "string",
+          "default": "wp-tester-results.json"
         },
         "passed": {
           "default": false,
@@ -2451,9 +2452,6 @@
           "type": "boolean"
         }
       },
-      "required": [
-        "outputFile"
-      ],
       "type": "object"
     },
     "MkdirStep": {

package/dist/test-resolver.d.ts

@@ -0,0 +1,18 @@
+import type { Tests } from "./wp-tester-config.js";
+import type { ResolvedTests, ResolvedPath } from "./resolved-types.js";
+/**
+ * Resolve PHPUnit arguments to map host paths to VFS paths
+ *
+ * @param args - Original arguments from config
+ * @param projectPath - Project path with host and VFS paths
+ * @returns Resolved arguments with paths converted to VFS paths
+ */
+export declare function resolvePhpunitArgs(args: string[], projectPath: ResolvedPath): string[];
+/**
+ * Resolve PHPUnit config paths and set default testMode
+ * @param tests - Tests configuration
+ * @param projectPath - Project path with host and VFS paths
+ * @returns Resolved tests configuration
+ */
+export declare function resolveTests(tests: Tests, projectPath: ResolvedPath): Promise<ResolvedTests>;
+//# sourceMappingURL=test-resolver.d.ts.map

package/dist/test-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-resolver.d.ts","sourceRoot":"","sources":["../src/test-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAyB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA8B3F;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,YAAY,GAAG,MAAM,EAAE,CAuCtF;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAyClG"}

package/dist/test-resolver.js

@@ -0,0 +1,107 @@
+import { resolveAbsolute, toResolvedPath } from "./path-utils.js";
+import { resolveBootstrapPath } from './options/phpunit-detect.js';
+import { hostToVfs } from './path-mappers.js';
+/**
+ * PHPUnit flags that are boolean (do not take a value).
+ * If a flag is NOT in this list, we assume it takes a value,
+ * and therefore the next argument should NOT be resolved as a path.
+ */
+const PHPUNIT_BOOLEAN_FLAGS = new Set([
+    '--teamcity', '--debug', '--verbose', '--testdox',
+    '--stderr', '--stop-on-error', '--stop-on-failure', '--stop-on-warning',
+    '--stop-on-defect', '--stop-on-risky', '--stop-on-skipped', '--stop-on-incomplete',
+    '--stop-on-deprecation', '--stop-on-notice',
+    '--fail-on-warning', '--fail-on-risky', '--fail-on-incomplete', '--fail-on-skipped',
+    '--fail-on-deprecation', '--fail-on-notice',
+    '--strict-coverage', '--strict-global-state', '--disallow-test-output',
+    '--disallow-resource-usage', '--enforce-time-limit',
+    '--process-isolation', '--no-globals-backup', '--static-backup',
+    '--no-configuration', '--no-coverage', '--no-logging', '--no-interaction',
+    '--no-extensions', '--no-output', '--dont-report-useless-tests',
+    '--no-progress',
+    '--display-deprecations', '--display-errors', '--display-incomplete',
+    '--display-notices', '--display-skipped', '--display-warnings',
+    '--strict',
+    '--help', '--version',
+    '--list-groups', '--list-suites', '--list-tests', '--list-tests-xml',
+]);
+/**
+ * Resolve PHPUnit arguments to map host paths to VFS paths
+ *
+ * @param args - Original arguments from config
+ * @param projectPath - Project path with host and VFS paths
+ * @returns Resolved arguments with paths converted to VFS paths
+ */
+export function resolvePhpunitArgs(args, projectPath) {
+    const resolvedArgs = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        // Don't resolve flags
+        if (arg.startsWith('-')) {
+            resolvedArgs.push(arg);
+            continue;
+        }
+        // Check if the previous argument was a flag that takes a value
+        const prevArg = args[i - 1];
+        if (prevArg?.startsWith('-') && !prevArg.includes('=')) {
+            // If the previous flag is NOT a known boolean flag, assume it takes a value
+            const flagName = prevArg.split('=')[0];
+            if (!PHPUNIT_BOOLEAN_FLAGS.has(flagName)) {
+                resolvedArgs.push(arg); // This is the flag's value, not a path
+                continue;
+            }
+        }
+        // Resolve arguments that look like file/directory paths
+        const looksLikePath = arg.includes('/') ||
+            arg.endsWith('.php') ||
+            arg === 'tests' || arg === 'test';
+        if (looksLikePath) {
+            const absoluteHostPath = resolveAbsolute(arg, projectPath.hostPath);
+            const vfsPath = hostToVfs(absoluteHostPath, projectPath);
+            resolvedArgs.push(vfsPath);
+            continue;
+        }
+        resolvedArgs.push(arg);
+    }
+    return resolvedArgs;
+}
+/**
+ * Resolve PHPUnit config paths and set default testMode
+ * @param tests - Tests configuration
+ * @param projectPath - Project path with host and VFS paths
+ * @returns Resolved tests configuration
+ */
+export async function resolveTests(tests, projectPath) {
+    // If no PHPUnit config, return tests as-is (but explicitly typed)
+    if (!tests.phpunit) {
+        return {
+            plugin: tests.plugin,
+            theme: tests.theme,
+            wp: tests.wp,
+            passWithNoTests: tests.passWithNoTests,
+        };
+    }
+    // Resolve PHPUnit config with absolute paths and default testMode
+    const phpunit = tests.phpunit;
+    const resolvedConfigHostPath = resolveAbsolute(phpunit.configPath, projectPath.hostPath);
+    // Resolve bootstrap path using centralized logic
+    const bootstrapHostPath = await resolveBootstrapPath(resolvedConfigHostPath, projectPath.hostPath, phpunit.bootstrapPath);
+    const resolvedPhpunit = {
+        phpunitPath: toResolvedPath(resolveAbsolute(phpunit.phpunitPath, projectPath.hostPath), projectPath),
+        configPath: toResolvedPath(resolvedConfigHostPath, projectPath),
+        testMode: phpunit.testMode ?? "unit",
+        bootstrapPath: bootstrapHostPath ? toResolvedPath(bootstrapHostPath, projectPath) : undefined,
+    };
+    // Resolve phpunitArgs paths if present
+    if (phpunit.phpunitArgs) {
+        resolvedPhpunit.phpunitArgs = resolvePhpunitArgs(phpunit.phpunitArgs, projectPath);
+    }
+    return {
+        plugin: tests.plugin,
+        theme: tests.theme,
+        wp: tests.wp,
+        phpunit: resolvedPhpunit,
+        passWithNoTests: tests.passWithNoTests,
+    };
+}
+//# sourceMappingURL=test-resolver.js.map

package/dist/test-resolver.js.map

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