@xmachines/shared 1.0.0-beta.10

package/README.md

@@ -0,0 +1,372 @@
+# @xmachines/shared
+
+**Shared TypeScript, linting, and formatting configurations for XMachines monorepo**
+
+Centralized config enabling composite build system with project references.
+
+## Overview
+
+`@xmachines/shared` provides shared configuration files for all XMachines packages, establishing consistent TypeScript compilation, linting rules, formatting, and Vitest setup across the monorepo.
+
+**Enhancement:** Added TypeScript composite build system with project references enabling correct build order, incremental compilation, and IDE source navigation via declaration maps.
+
+## Installation
+
+This package is automatically available to all workspace packages via npm workspaces.
+
+## Contents
+
+Configuration files in `config/` directory:
+
+- **`config/tsconfig.json`** - TypeScript compiler settings with composite project support
+- **`config/oxlint.json`** - Linting rules and plugins
+- **`config/oxfmt.json`** - Code formatting preferences
+- **`config/vitest.ts`** - Shared Vitest config helper (`defineXmVitestConfig`)
+- **`config/vitest.setup.ts`** - Shared cross-runtime Vitest setup (polyfills, jest-dom matchers)
+- **`config/vitest.node.setup.ts`** - Node-only Vitest setup (Node runtime/version preflight)
+- **`config/vite-aliases.ts`** - Workspace alias mapping for `@xmachines/*`
+
+## Usage
+
+### TypeScript Configuration
+
+**Recommended (short alias):**
+
+```json
+{
+	"extends": "@xmachines/shared/tsconfig",
+	"compilerOptions": {
+		"composite": true,
+		"rootDir": "./src",
+		"outDir": "./dist"
+	}
+}
+```
+
+**Alternative (full path):**
+
+```json
+{
+	"extends": "@xmachines/shared/config/tsconfig.json",
+	"compilerOptions": {
+		"composite": true,
+		"rootDir": "./src",
+		"outDir": "./dist"
+	}
+}
+```
+
+> **Note:** Both import styles work. The short alias is recommended for cleaner config files.
+
+### Oxlint Configuration
+
+**Recommended:**
+
+```json
+{
+	"extends": ["@xmachines/shared/oxlint"]
+}
+```
+
+### Oxfmt Configuration
+
+**Recommended:**
+
+```json
+{
+	"extends": ["@xmachines/shared/oxfmt"]
+}
+```
+
+### Vite Alias Configuration
+
+Use the shared alias helper in Vite and Vitest configs so workspace packages resolve to source files without requiring `dist/` builds:
+
+```ts
+import { defineConfig } from "vite";
+import { xmAliases } from "@xmachines/shared/vite-aliases";
+
+export default defineConfig({
+	resolve: {
+		alias: xmAliases(import.meta.url),
+	},
+});
+```
+
+This is especially important after `npm run clean`, where package `exports` targeting `dist/` are temporarily unavailable until rebuild.
+
+### Vitest Configuration
+
+Use the shared helper so package configs inherit common aliasing and runtime setup:
+
+```ts
+import { defineXmVitestConfig } from "@xmachines/shared/vitest";
+
+export default defineXmVitestConfig(import.meta.url, {
+	test: {
+		environment: "node",
+		include: ["test/**/*.test.ts"],
+		exclude: ["node_modules/**"],
+	},
+});
+```
+
+**Browser project example:**
+
+```ts
+import { defineXmVitestConfig } from "@xmachines/shared/vitest";
+import { playwright } from "@vitest/browser-playwright";
+
+export default defineXmVitestConfig(import.meta.url, {
+	test: {
+		name: "my-demo-browser",
+		browser: {
+			enabled: true,
+			provider: playwright(),
+			headless: true,
+			instances: [{ browser: "chromium" }],
+		},
+		include: ["test/browser/**/*.browser.test.ts"],
+		exclude: ["node_modules/**"],
+	},
+});
+```
+
+What the shared Vitest layer provides automatically:
+
+- `resolve.alias` for all `@xmachines/*` packages via `xmAliases(...)`
+- Shared setup injection (`config/vitest.setup.ts`) unless already present
+- Node setup injection (`config/vitest.node.setup.ts`) for non-browser projects
+- Runtime preflight:
+    - Node.js runtime/version check (`>=22`) in node setup
+- DOM matcher extension via `@testing-library/jest-dom/vitest`
+
+### Vitest Setup Injection Rules
+
+`defineXmVitestConfig(...)` applies setup files predictably:
+
+1. It normalizes `test.setupFiles` into an array.
+2. It injects `config/vitest.setup.ts` if missing.
+3. It injects `config/vitest.node.setup.ts` only when `test.browser.enabled !== true`.
+4. It avoids duplicates by checking filenames (suffix match).
+5. Injected setup files run before user-provided setup files.
+
+This gives a safe default for Node package tests while keeping browser projects compatible.
+
+### Vitest Exports
+
+`@xmachines/shared` exports these Vitest entry points:
+
+- `@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`)
+
+- **Target:** ESNext (Node.js 22+)
+- **Module:** NodeNext (ESM with `.js` extensions required)
+- **Strict:** Full strict mode enabled
+- **Output:** Colocated `.d.ts` files with source maps
+- **Composite:** Enabled for project references ()
+
+**Important:** You must use `.js` extensions in imports:
+
+```typescript
+import { foo } from "./bar.js"; // ✅ Correct
+import { foo } from "./bar"; // ❌ Wrong
+```
+
+### Oxlint (`config/oxlint.json`)
+
+- **Plugins:** TypeScript, Unicorn, Import
+- **Categories:** Correctness (error), Suspicious (warn), Performance (warn)
+- **Key Rules:**
+    - Circular dependency detection (`import/no-cycle`)
+    - Unused variables (allow `_` prefix)
+    - TypeScript-specific checks
+
+### Oxfmt (`config/oxfmt.json`)
+
+- **Line Width:** 100 characters
+- **Indentation:** Tabs (4 spaces)
+- **Style:** Double quotes, semicolons, trailing commas
+- **Final Newline:** Always insert
+
+### 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`):**
+    - extends `expect` with `@testing-library/jest-dom/vitest`
+- **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`
+- **Browser behavior:** Browser projects do not receive node-only setup injection
+- **Override model:** Package-level config still controls test environment, includes/excludes, plugins, coverage, and browser provider
+
+### Vite Aliases (`config/vite-aliases.ts`)
+
+- **Helper API:** `xmAliases(importMetaUrl)` returns a complete `resolve.alias` map for all `@xmachines/*` workspace packages
+- **Root discovery:** Walks upward from `import.meta.url` until it finds the workspace root (`package.json` with `workspaces`)
+- **Source-first resolution:** Maps package imports to `packages/*/src/index.ts` for fast local dev without prebuild
+- **Extra aliases:** Includes `@xmachines/play-router-shared` and `@xmachines/play-router-shared/index.css` for demo shared assets
+- **Primary use cases:** `vite.config.ts`, `vitest` browser configs, and any local tooling relying on Vite resolver semantics
+
+### Vite Alias Troubleshooting
+
+- **`[xmAliases] Could not find workspace root`**
+    - Ensure `xmAliases` receives `import.meta.url` from the calling config file.
+    - Ensure the config file lives somewhere under the monorepo root.
+- **Workspace package import resolves to missing `dist/` files**
+    - Ensure config includes `resolve.alias: xmAliases(import.meta.url)`.
+    - Re-run after cleaning caches when lockfile/deps changed.
+
+### Vitest Troubleshooting
+
+- **`URLPattern is unavailable after setup`**
+    - Ensure `test.setupFiles` is not replacing shared setup unexpectedly.
+    - Ensure config is created via `defineXmVitestConfig(...)`.
+- **`Node runtime is required for this Vitest configuration`**
+    - This indicates node-only setup loaded in a browser project.
+    - Set `test.browser.enabled: true` in that project config.
+- **Workspace import resolution failures (e.g. `@xmachines/play-signals`)**
+    - Confirm config uses `defineXmVitestConfig(import.meta.url, ...)` so aliases are injected.
+
+## TypeScript Composite Build System
+
+This package introduced TypeScript project references for proper build-order management in the monorepo.
+
+### What This Means
+
+- **Root `tsconfig.json`** coordinates all packages via `references` array
+- **Each package** has `composite: true` enabling incremental builds
+- **Packages with dependencies** declare `references` to their deps
+- **TypeScript builds in correct order automatically** (no manual sequencing needed)
+
+### Building
+
+```bash
+npm run build          # Root-level tsc --build handles everything
+npm run build -w <pkg> # Automatically builds dependencies first
+```
+
+The root build command uses `tsc --build` which:
+
+- Understands the dependency graph
+- Builds packages in correct order
+- Only rebuilds changed packages (incremental)
+- Produces `.d.ts.map` files for IDE navigation
+
+### Declaration Maps
+
+The base config enables **declaration maps** (`declarationMap: true`) for better IDE experience in composite projects.
+
+When TypeScript compiles with `declarationMap: true`, it produces `.d.ts.map` files that map type definitions back to source. This enables:
+
+- **Go to Definition** jumps to `.ts` source files (not compiled `.d.ts`)
+- **Rename refactoring** works across package boundaries
+- **Error messages** reference source locations
+
+**Cost:** Slightly larger `dist/` output (~10% more)  
+**Benefit:** Dramatically better IDE experience
+
+### Project References
+
+Packages with internal dependencies should declare `references` in their `tsconfig.json`:
+
+```json
+{
+	"extends": "@xmachines/shared/tsconfig",
+	"compilerOptions": {
+		"composite": true,
+		"rootDir": "./src",
+		"outDir": "./dist"
+	},
+	"references": [{ "path": "../dependency-package" }]
+}
+```
+
+The root `tsconfig.json` maintains the full package reference graph, enabling TypeScript to:
+
+- Build packages in correct dependency order
+- Support incremental builds (only rebuild what changed)
+- Enable cross-package type checking and navigation
+
+### Adding New Packages
+
+When creating a new package:
+
+1. **Add to root tsconfig.json references:**
+
+    ```json
+    {
+    	"references": [{ "path": "./packages/your-new-package" }]
+    }
+    ```
+
+2. **Enable composite in package tsconfig.json:**
+
+    ```json
+    {
+    	"extends": "@xmachines/shared/tsconfig",
+    	"compilerOptions": {
+    		"composite": true,
+    		"rootDir": "./src",
+    		"outDir": "./dist"
+    	}
+    }
+    ```
+
+3. **Declare dependencies (if any):**
+    ```json
+    {
+    	"references": [{ "path": "../dependency-package" }]
+    }
+    ```
+
+### IDE Benefits
+
+With `declarationMap: true` in the base config:
+
+- **Go to Definition** jumps to source files (not compiled `.d.ts`)
+- **Real-time errors** across package boundaries
+- **Refactoring works** across the entire monorepo
+
+No build required for IDE features - TypeScript understands the source graph directly.
+
+See `AGENTS.md` (section: TypeScript Composite Build System) for complete composite build documentation.
+
+## Adding New Configurations
+
+To add a new shared configuration (e.g., for Jest, Vitest, etc.):
+
+1. Create `config/<tool>.json` (or `.js`, `.ts` as appropriate)
+2. Add exports to `package.json` exports field:
+    ```json
+    {
+    	"exports": {
+    		"./<tool>": "./config/<tool>.json",
+    		"./config/<tool>.json": "./config/<tool>.json"
+    	}
+    }
+    ```
+3. Document in this README with usage examples
+4. Note whether the tool supports package exports or requires relative paths
+
+## License
+
+Copyright (c) 2016 [Mikael Karon](mailto:mikael@karon.se). All rights reserved.
+
+This work is licensed under the terms of the MIT license.  
+For a copy, see <https://opensource.org/licenses/MIT>.

package/config/oxfmt.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "../../../node_modules/oxfmt/configuration_schema.json",
+  "printWidth": 100,
+  "tabWidth": 4,
+  "useTabs": true,
+  "semi": true,
+  "singleQuote": false,
+  "trailingComma": "all",
+  "insertFinalNewline": true
+}

package/config/oxlint.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "../../../node_modules/oxlint/configuration_schema.json",
+  "plugins": ["typescript", "unicorn", "import"],
+  "categories": {
+    "correctness": "error",
+    "suspicious": "warn",
+    "pedantic": "off",
+    "perf": "warn",
+    "style": "off"
+  },
+  "rules": {
+    "unicorn/filename-case": "off",
+    "import/no-cycle": "error",
+    "typescript/no-explicit-any": "error",
+    "typescript/no-unused-vars": [
+      "error",
+      {
+        "argsIgnorePattern": "^_",
+        "varsIgnorePattern": "^_"
+      }
+    ]
+  },
+  "env": {
+    "es2025": true,
+    "node": true
+  }
+}

package/config/tsconfig.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    /* Language and Environment */
+    "target": "ESNext",
+    "lib": ["ESNext"],
+
+    /* Modules */
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+
+    /* Type Checking */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitReturns": true,
+    "noImplicitOverride": true,
+    "exactOptionalPropertyTypes": true,
+
+    /* Emit */
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "removeComments": false,
+    "importHelpers": false,
+
+    /* Interop Constraints */
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+
+    /* Completeness */
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["dist", "node_modules", "**/*.spec.ts", "**/*.test.ts"]
+}

package/config/vite-aliases.ts

@@ -0,0 +1,84 @@
+import { resolve } from "path";
+import { fileURLToPath } from "url";
+
+/**
+ * Vite resolve.alias entries for all @xmachines/* workspace packages.
+ *
+ * Maps every package to its TypeScript source entry so that `npm run dev`
+ * works without a prior `npm run build`. Required because `npm run clean`
+ * removes all dist/ directories — including transitive dependencies —
+ * leaving Vite unable to resolve package.json `exports` that point to dist/.
+ *
+ * Usage in a demo vite.config.ts:
+ *
+ *   import { xmAliases } from "@xmachines/shared/vite-aliases";
+ *
+ *   export default defineConfig({
+ *     resolve: { alias: xmAliases(import.meta.url) },
+ *   });
+ *
+ * @param importMetaUrl - Pass `import.meta.url` from the calling config file.
+ *   Used to locate the workspace root (the directory containing `packages/`).
+ */
+export function xmAliases(importMetaUrl: string): Record<string, string> {
+	const configDir = fileURLToPath(new URL(".", importMetaUrl));
+
+	// Walk up from the config file's directory until we find the folder that
+	// contains a `packages/` subdirectory — that's the workspace root.
+	let root = configDir;
+	while (!isWorkspaceRoot(root)) {
+		const parent = resolve(root, "..");
+		if (parent === root)
+			throw new Error(`[xmAliases] Could not find workspace root from ${configDir}`);
+		root = parent;
+	}
+
+	const p = (pkg: string) => resolve(root, "packages", pkg, "src/index.ts");
+
+	return {
+		"@xmachines/play": p("play"),
+		"@xmachines/play-actor": p("play-actor"),
+		"@xmachines/play-catalog": p("play-catalog"),
+		"@xmachines/play-signals": p("play-signals"),
+		"@xmachines/play-router": p("play-router"),
+		"@xmachines/play-xstate": p("play-xstate"),
+		"@xmachines/play-react": p("play-react"),
+		"@xmachines/play-react-router": p("play-react-router"),
+		"@xmachines/play-solid": p("play-solid"),
+		"@xmachines/play-solid-router": p("play-solid-router"),
+		"@xmachines/play-vue": p("play-vue"),
+		"@xmachines/play-vue-router": p("play-vue-router"),
+		"@xmachines/play-tanstack-react-router": p("play-tanstack-react-router"),
+		"@xmachines/play-tanstack-solid-router": p("play-tanstack-solid-router"),
+		"@xmachines/play-router-shared/index.css": resolve(
+			root,
+			"packages",
+			"play-router",
+			"examples",
+			"shared",
+			"src/index.css",
+		),
+		"@xmachines/play-router-shared": resolve(
+			root,
+			"packages",
+			"play-router",
+			"examples",
+			"shared",
+			"src",
+		),
+	};
+}
+
+import { existsSync, readFileSync } from "fs";
+
+function isWorkspaceRoot(dir: string): boolean {
+	const pkgPath = resolve(dir, "package.json");
+	if (!existsSync(pkgPath)) return false;
+	try {
+		const raw = readFileSync(pkgPath, "utf8");
+		const pkg = JSON.parse(raw) as { workspaces?: unknown };
+		return Array.isArray(pkg.workspaces);
+	} catch {
+		return false;
+	}
+}

package/config/vitest.node.setup.ts

@@ -0,0 +1,15 @@
+const isNodeRuntime =
+	typeof process !== "undefined" &&
+	process.release?.name === "node" &&
+	typeof process.versions?.node === "string";
+
+if (!isNodeRuntime) {
+	throw new Error("Node runtime is required for this Vitest configuration");
+}
+
+const [nodeMajorRaw] = process.versions.node.split(".");
+const nodeMajor = Number.parseInt(nodeMajorRaw ?? "0", 10);
+
+if (!Number.isFinite(nodeMajor) || nodeMajor < 22) {
+	throw new Error(`Vitest runtime requires Node.js >=22.0.0, received ${process.versions.node}`);
+}

package/config/vitest.setup.ts

@@ -0,0 +1,7 @@
+/**
+ * Vitest setup shared across packages.
+ * Extends matchers with @testing-library/jest-dom.
+ * @internal
+ */
+// eslint-disable-next-line import/no-unassigned-import
+import "@testing-library/jest-dom/vitest";

package/config/vitest.ts

@@ -0,0 +1,87 @@
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { defineConfig, mergeConfig } from "vitest/config";
+import { xmAliases } from "@xmachines/shared/vite-aliases";
+
+const configDir = dirname(fileURLToPath(import.meta.url));
+const nodeSetupFile = resolve(configDir, "vitest.node.setup.ts");
+const setupFile = resolve(configDir, "vitest.setup.ts");
+
+/**
+ * Normalize Vitest `test.setupFiles` into a string array.
+ */
+function normalizeSetupFiles(setupFiles: unknown): string[] {
+	if (!setupFiles) return [];
+	if (Array.isArray(setupFiles)) {
+		return setupFiles.filter((entry): entry is string => typeof entry === "string");
+	}
+	return typeof setupFiles === "string" ? [setupFiles] : [];
+}
+
+/**
+ * True when Vitest browser mode is explicitly enabled.
+ */
+function isBrowserEnabled(browserConfig: unknown): boolean {
+	if (!browserConfig || typeof browserConfig !== "object") return false;
+	return (browserConfig as { enabled?: unknown }).enabled === true;
+}
+
+/**
+ * Checks whether setup files already include a file by suffix.
+ *
+ * This supports both absolute and relative setup file entries and normalizes
+ * Windows separators for cross-platform matching.
+ */
+function hasSetupFile(setupFiles: string[], fileName: string): boolean {
+	const normalizedSuffix = `/${fileName}`;
+	return setupFiles.some((entry) => entry.replaceAll("\\", "/").endsWith(normalizedSuffix));
+}
+
+/**
+ * Create a Vitest config with XMachines workspace defaults.
+ *
+ * What this applies automatically:
+ * - `resolve.alias` from `xmAliases(importMetaUrl)` so `@xmachines/*` imports
+ *   resolve to source in local/dev test runs.
+ * - `config/vitest.setup.ts` when missing.
+ * - `config/vitest.node.setup.ts` for non-browser projects when missing.
+ *
+ * Setup injection is additive and preserves caller-provided ordering after
+ * required shared setup files.
+ *
+ * @param importMetaUrl Pass `import.meta.url` from the calling config file.
+ * @param overrides Package/project-specific Vitest config overrides.
+ * @returns Merged Vitest configuration object.
+ */
+export function defineXmVitestConfig(importMetaUrl: string, overrides: Record<string, unknown>) {
+	const merged = mergeConfig(
+		defineConfig({
+			resolve: {
+				alias: xmAliases(importMetaUrl),
+			},
+		}),
+		defineConfig(overrides),
+	);
+
+	const testConfig = merged.test ?? {};
+	const setupFiles = normalizeSetupFiles(testConfig.setupFiles);
+	const browserEnabled = isBrowserEnabled(testConfig.browser);
+	const hasNodeSetup = hasSetupFile(setupFiles, "vitest.node.setup.ts");
+	const hasSharedSetup = hasSetupFile(setupFiles, "vitest.setup.ts");
+	const injectedSetupFiles: string[] = [];
+
+	if (!browserEnabled && !hasNodeSetup) {
+		injectedSetupFiles.push(nodeSetupFile);
+	}
+	if (!hasSharedSetup) {
+		injectedSetupFiles.push(setupFile);
+	}
+
+	return {
+		...merged,
+		test: {
+			...testConfig,
+			setupFiles: [...injectedSetupFiles, ...setupFiles],
+		},
+	};
+}

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

@@ -0,0 +1,58 @@
+{
+  "name": "@xmachines/shared",
+  "version": "1.0.0-beta.10",
+  "description": "Shared configurations for XMachines packages",
+  "keywords": [
+    "config",
+    "shared",
+    "xmachines"
+  ],
+  "homepage": "https://gitlab.com/xmachin-es/xmachines-js/tree/main/packages/shared",
+  "license": "MIT",
+  "author": "Mikael Karon <mikael@karon.se>",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@gitlab.com/xmachin-es/xmachines-js.git",
+    "directory": "packages/shared"
+  },
+  "files": [
+    "config",
+    "README.md"
+  ],
+  "type": "module",
+  "exports": {
+    "./tsconfig": "./config/tsconfig.json",
+    "./oxlint": "./config/oxlint.json",
+    "./oxfmt": "./config/oxfmt.json",
+    "./vite-aliases": "./config/vite-aliases.ts",
+    "./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.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": "vitest"
+  },
+  "dependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "urlpattern-polyfill": "^10.1.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.0"
+  }
+}