@xmachines/shared 1.0.0-beta.7 → 1.0.0-beta.9

package/README.md

@@ -139,8 +139,6 @@ What the shared Vitest layer provides automatically:
 - Node setup injection (`config/vitest.node.setup.ts`) for non-browser projects
 - Runtime preflight:
     - Node.js runtime/version check (`>=22`) in node setup
-    - `urlpattern-polyfill` load in shared setup
-    - `URLPattern` availability assertion in shared setup
 - DOM matcher extension via `@testing-library/jest-dom/vitest`
 
 ### Vitest Setup Injection Rules
@@ -162,9 +160,12 @@ This gives a safe default for Node package tests while keeping browser projects
 - `@xmachines/shared/vitest` → `config/vitest.ts`
 - `@xmachines/shared/vitest-setup` → `config/vitest.setup.ts`
 - `@xmachines/shared/vitest-node-setup` → `config/vitest.node.setup.ts`
+- `@xmachines/shared/vitest-urlpattern-setup` → `config/vitest.urlpattern.setup.ts`
 
 Use `@xmachines/shared/vitest` for package config files; direct setup exports are for advanced customization only.
 
+`vitest-urlpattern-setup` must be added explicitly to `setupFiles` in packages that exercise URLPattern-based route matching (e.g. `play-router` and its adapter packages). It mirrors what consumers must do in production on Node < 24 or older browsers.
+
 ## Configuration Details
 
 ### TypeScript (`config/tsconfig.json`)
@@ -198,14 +199,16 @@ import { foo } from "./bar"; // ❌ Wrong
 - **Style:** Double quotes, semicolons, trailing commas
 - **Final Newline:** Always insert
 
-### Vitest (`config/vitest.ts`, `config/vitest.setup.ts`, `config/vitest.node.setup.ts`)
+### Vitest (`config/vitest.ts`, `config/vitest.setup.ts`, `config/vitest.node.setup.ts`, `config/vitest.urlpattern.setup.ts`)
 
 - **Helper API:** `defineXmVitestConfig(importMetaUrl, overrides)` merges shared defaults with package-specific Vitest config
 - **Auto-aliasing:** `resolve.alias` is wired to `xmAliases(importMetaUrl)` so workspace packages resolve to source
 - **Cross-runtime setup (`config/vitest.setup.ts`):**
-    - loads `urlpattern-polyfill`
     - extends `expect` with `@testing-library/jest-dom/vitest`
-    - asserts `URLPattern` availability
+- **URLPattern setup (`config/vitest.urlpattern.setup.ts`):**
+    - loads `urlpattern-polyfill` — opt-in per package via `setupFiles: ["@xmachines/shared/vitest-urlpattern-setup"]`
+    - required for packages exercising URLPattern-based route matching (play-router and adapters)
+    - mirrors what consumers must do in production on Node < 24 or older browsers
 - **Node-only setup (`config/vitest.node.setup.ts`):**
     - asserts Node runtime (`process.release.name === "node"`)
     - enforces Node version `>=22`

package/config/oxlint.json

@@ -11,7 +11,7 @@
   "rules": {
     "unicorn/filename-case": "off",
     "import/no-cycle": "error",
-    "typescript/no-explicit-any": "warn",
+    "typescript/no-explicit-any": "error",
     "typescript/no-unused-vars": [
       "error",
       {

package/config/vitest.setup.ts

@@ -4,10 +4,4 @@
  * @internal
  */
 // eslint-disable-next-line import/no-unassigned-import
-import "urlpattern-polyfill";
-// eslint-disable-next-line import/no-unassigned-import
 import "@testing-library/jest-dom/vitest";
-
-if (typeof (globalThis as { URLPattern?: unknown }).URLPattern !== "function") {
-	throw new Error("URLPattern is unavailable after setup");
-}

package/config/vitest.ts

@@ -1,7 +1,7 @@
 import { fileURLToPath } from "node:url";
 import { dirname, resolve } from "node:path";
 import { defineConfig, mergeConfig } from "vitest/config";
-import { xmAliases } from "./vite-aliases.js";
+import { xmAliases } from "@xmachines/shared/vite-aliases";
 
 const configDir = dirname(fileURLToPath(import.meta.url));
 const nodeSetupFile = resolve(configDir, "vitest.node.setup.ts");

package/config/vitest.urlpattern.setup.ts

@@ -0,0 +1,22 @@
+/**
+ * Optional Vitest setup file for packages that use URLPattern (via @xmachines/play-router).
+ *
+ * Include this in `setupFiles` for packages that exercise route matching in tests:
+ *
+ * ```ts
+ * // vitest.config.ts
+ * import { defineXmVitestConfig } from "@xmachines/shared/vitest";
+ * export default defineXmVitestConfig(import.meta.url, {
+ *   test: {
+ *     setupFiles: ["@xmachines/shared/vitest-urlpattern-setup"],
+ *   },
+ * });
+ * ```
+ *
+ * This mirrors what consumers must do in production on Node < 24 or older browsers:
+ * load a URLPattern polyfill before importing @xmachines/play-router.
+ *
+ * @internal — test infrastructure only, not part of the public API
+ */
+// eslint-disable-next-line import/no-unassigned-import
+import "urlpattern-polyfill";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmachines/shared",
-  "version": "1.0.0-beta.7",
+  "version": "1.0.0-beta.9",
   "description": "Shared configurations for XMachines packages",
   "keywords": [
     "config",
@@ -28,24 +28,31 @@
     "./vitest": "./config/vitest.ts",
     "./vitest-node-setup": "./config/vitest.node.setup.ts",
     "./vitest-setup": "./config/vitest.setup.ts",
+    "./vitest-urlpattern-setup": "./config/vitest.urlpattern.setup.ts",
     "./config/tsconfig.json": "./config/tsconfig.json",
     "./config/oxlint.json": "./config/oxlint.json",
     "./config/oxfmt.json": "./config/oxfmt.json",
     "./config/vitest.ts": "./config/vitest.ts",
     "./config/vitest.node.setup.ts": "./config/vitest.node.setup.ts",
-    "./config/vitest.setup.ts": "./config/vitest.setup.ts"
+    "./config/vitest.setup.ts": "./config/vitest.setup.ts",
+    "./config/vitest.urlpattern.setup.ts": "./config/vitest.urlpattern.setup.ts"
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
+    "clean": "rm -rf dist coverage *.tsbuildinfo node_modules/.vite node_modules/.vite-temp",
     "lint": "oxlint .",
     "lint:fix": "oxlint --fix .",
     "format": "oxfmt .",
     "format:check": "oxfmt --check .",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "vitest"
   },
   "dependencies": {
-    "@testing-library/jest-dom": "^6.9.1"
+    "@testing-library/jest-dom": "^6.9.1",
+    "urlpattern-polyfill": "^10.1.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.0"
   }
 }