proby 0.13.1 → 0.13.3

package/README.md

@@ -6,9 +6,9 @@ Test runner for JavaScript runtimes.
 
 A cross-runtime test runner that automatically discovers and runs test files.
 Works with both single repositories and monorepos. Supports TypeScript source
-execution in monorepos without a build step when your packages expose `source`
-entries in `package.json`. Uses `@rcompat/test` for writing tests. Works
-consistently across Node, Deno, and Bun.
+execution in monorepos without a build step when your packages expose a custom
+source condition in `package.json`. Uses `@rcompat/test` for writing tests.
+Works consistently across Node, Deno, and Bun.
 
 ## Installation
 
@@ -58,41 +58,50 @@ npx proby math.spec.ts addition
 
 ## How proby resolves source files
 
-Proby relaunches itself with runtime conditions before running tests. By
-default it uses the `source` condition, which lets runtimes resolve package
-`imports` and `exports` to your TypeScript source files instead of built
-JavaScript.
+Proby reads `compilerOptions.customConditions` from your `tsconfig.json` and
+relaunches itself with those conditions active before running tests. This lets
+Node resolve package `imports` and `exports` to your TypeScript source files
+instead of built JavaScript — no build step required.
 
-This is especially useful in monorepos where packages depend on each other and
-you want to run tests against source directly.
+Use a condition scoped to your project to avoid conflicts when multiple
+monorepos share `node_modules`:
 
-To use this pattern, expose `source` entries in your packages.
+```json
+{
+  "compilerOptions": {
+    "customConditions": ["@myproject/source"]
+  }
+}
+```
 
-Example:
+Then expose matching entries in your packages:
 
 ```json
 {
   "imports": {
     "#*": {
-      "source": "./src/*.ts",
-      "default": "./lib/*.js"
+      "@myproject/source": "./src/private/*.ts",
+      "default": "./lib/private/*.js"
     }
   },
   "exports": {
     ".": {
-      "source": "./src/index.ts",
-      "default": "./lib/index.js"
+      "@myproject/source": "./src/public/index.ts",
+      "default": "./lib/public/index.js"
     }
   }
 }
 ```
 
-With this setup, proby can run against your TypeScript source without requiring
-an upfront build step.
+Because TypeScript reads the same `customConditions`, your editor's
+jump-to-source also lands on the `.ts` source file — not compiled output.
+
+The opt-in is per package and entirely additive. Packages without the condition
+fall back to built output as normal.
 
 ## Configuration
 
-Create `proby.config.ts` or `proby.config.js` in your project root.
+Create `proby.config.ts` or `proby.config.js` in your project root:
 
 ```ts
 import config from "proby/config";
@@ -101,7 +110,6 @@ export default config({
   monorepo: true,
   packages: "packages",
   include: ["src"],
-  conditions: ["source"],
 });
 ```
 
@@ -115,11 +123,7 @@ boolean
 
 Whether proby should scan package directories inside a monorepo.
 
-Default:
-
-```ts
-false
-```
+Default: `false`
 
 #### `packages`
 
@@ -129,11 +133,7 @@ string
 
 Directory containing package folders when `monorepo` is enabled.
 
-Default:
-
-```ts
-"packages"
-```
+Default: `"packages"`
 
 #### `include`
 
@@ -143,30 +143,10 @@ string[]
 
 Directories to scan for spec files.
 
-Default:
-
-```ts
-["src"]
-```
-
-#### `conditions`
-
-```ts
-string[]
-```
-
-Runtime conditions used when proby relaunches itself.
-
-Default:
-
-```ts
-["source"]
-```
+Default: `["src"]`
 
 ## Project structure
 
-Proby automatically detects your project structure.
-
 ### Single repository
 
 ```text
@@ -206,7 +186,7 @@ my-monorepo/
 
 Proby supports preloading sibling mock files before a spec file is evaluated.
 This allows module mocks to be registered before the spec's static imports are
-read.
+resolved.
 
 Pair files by matching the spec extension exactly:
 
@@ -215,15 +195,6 @@ Pair files by matching the spec extension exactly:
 
 If a sibling mock file exists, proby loads it before the spec file.
 
-Example:
-
-```ts
-// math.ts
-export function add(a: number, b: number) {
-  return a + b;
-}
-```
-
 ```ts
 // math.mock.ts
 import test from "@rcompat/test";
@@ -243,13 +214,12 @@ test.case("uses the preloaded mock", assert => {
 });
 ```
 
-Static mocks are file-scoped. A mock loaded for one spec file does not leak
-into later spec files.
+Static mocks are file-scoped — they do not leak into later spec files.
 
 ## Grouping tests
 
-Use `test.group` in your spec files to cluster related cases. Groups can then
-be targeted individually when running proby.
+Use `test.group` to cluster related cases. Groups can be targeted individually
+when running proby:
 
 ```js
 import test from "@rcompat/test";
@@ -383,4 +353,3 @@ MIT
 ## Contributing
 
 See [CONTRIBUTING.md](../../CONTRIBUTING.md) in the repository root.
-

package/lib/Schema.d.ts

@@ -2,7 +2,6 @@ declare const Schema: import("pema").ObjectType<{
     monorepo: import("pema").DefaultType<import("pema").BooleanType, false>;
     packages: import("pema").DefaultType<import("pema").StringType, "packages">;
     include: import("pema").DefaultType<import("pema").ArrayType<import("pema").StringType>, string[]>;
-    conditions: import("pema").DefaultType<import("pema").ArrayType<import("pema").StringType>, string[]>;
 }>;
 export default Schema;
 //# sourceMappingURL=Schema.d.ts.map

package/lib/Schema.js

@@ -3,7 +3,6 @@ const Schema = p({
     monorepo: p.boolean.default(false),
     packages: p.string.default("packages"),
     include: p.array(p.string).default(["src"]),
-    conditions: p.array(p.string).default(["source"]),
 });
 export default Schema;
 //# sourceMappingURL=Schema.js.map

package/lib/bin.js

@@ -1,16 +1,21 @@
 #!/usr/bin/env node
-import p from "pema";
+import Schema from "#Schema";
 import env from "@rcompat/env";
 import fs from "@rcompat/fs";
 import io from "@rcompat/io";
 import is from "@rcompat/is";
 import runtime from "@rcompat/runtime";
-const Schema = p({
-    monorepo: p.boolean.default(false),
-    packages: p.string.default("packages"),
-    include: p.array(p.string).default(["src"]),
-    conditions: p.array(p.string).default(["source"]),
-});
+async function read_conditions(file) {
+    const json = await file.json();
+    if (json.compilerOptions?.customConditions?.length) {
+        return json.compilerOptions.customConditions;
+    }
+    if (json.extends === undefined) {
+        return [];
+    }
+    const next = await runtime.resolve(json.extends, file.directory.path);
+    return read_conditions(fs.ref(next));
+}
 const root = await fs.project.root();
 const ts_config_file = root.join("proby.config.ts");
 const js_config_file = root.join("proby.config.js");
@@ -19,14 +24,18 @@ const user_config = await ts_config_file.exists()
     : await js_config_file.exists()
         ? (await js_config_file.import("default"))
         : {};
-const { include, packages, conditions, monorepo } = Schema.parse(user_config);
-const conditions_flag = conditions.length > 0
-    ? ` --conditions=${conditions.join(",")}`
-    : "";
+const { include, packages, monorepo } = Schema.parse(user_config);
+const ts_config = root.join("tsconfig.json");
+const conditions = await ts_config.exists()
+    ? await read_conditions(ts_config)
+    : [];
+const conditions_flags = conditions
+    .map(c => ` --conditions="${c}"`)
+    .join("");
 const script = runtime.script;
 const args = runtime.args.join(" ");
 if (!is.defined(env.try("PROBY_RELAUNCHED"))) {
-    await io.spawn(`${runtime.bin} ${conditions_flag} ${script} ${args}`, {
+    await io.spawn(`${runtime.bin}${conditions_flags} ${script} ${args}`, {
         inherit: true,
         env: { ...process.env, PROBY_RELAUNCHED: "1" },
     });

package/lib/config.d.ts

@@ -3,7 +3,6 @@ declare const _default: (input: typeof Schema.input) => {
     monorepo?: boolean | undefined;
     packages?: string | undefined;
     include?: string[] | undefined;
-    conditions?: string[] | undefined;
 } | undefined;
 export default _default;
 //# sourceMappingURL=config.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "proby",
-  "version": "0.13.1",
+  "version": "0.13.3",
   "description": "Standard library test runner",
   "bugs": "https://github.com/rcompat/rcompat/issues",
   "license": "MIT",
@@ -17,16 +17,16 @@
   },
   "dependencies": {
     "pema": "^0.5.0",
-    "@rcompat/assert": "^0.8.0",
-    "@rcompat/cli": "^0.18.0",
-    "@rcompat/env": "^0.17.0",
-    "@rcompat/fs": "^0.28.0",
-    "@rcompat/io": "^0.5.0",
-    "@rcompat/is": "^0.6.0",
-    "@rcompat/runtime": "^0.11.0"
+    "@rcompat/assert": "^0.8.1",
+    "@rcompat/cli": "^0.18.1",
+    "@rcompat/fs": "^0.28.1",
+    "@rcompat/env": "^0.17.1",
+    "@rcompat/io": "^0.5.1",
+    "@rcompat/is": "^0.6.1",
+    "@rcompat/runtime": "^0.11.1"
   },
   "peerDependencies": {
-    "@rcompat/test": "^0.12.0"
+    "@rcompat/test": "^0.12.1"
   },
   "peerDependenciesMeta": {
     "@rcompat/test": {
@@ -36,13 +36,13 @@
   "type": "module",
   "imports": {
     "#*": {
-      "source": "./src/*.ts",
+      "@rcompat/source": "./src/*.ts",
       "default": "./lib/*.js"
     }
   },
   "exports": {
     "./config": {
-      "source": "./src/config.ts",
+      "@rcompat/source": "./src/config.ts",
       "default": "./lib/config.js"
     }
   },