@xmachines/play-router 1.0.0-beta.1

package/examples/demo/test/library-pattern.test.ts

@@ -0,0 +1,51 @@
+import { describe, expect, it } from "vitest";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+describe("Vanilla demo library pattern", () => {
+	const mainSource = readFileSync(join(__dirname, "../src/main.ts"), "utf-8");
+	const routerSource = readFileSync(join(__dirname, "../src/router.ts"), "utf-8");
+	const shellSource = readFileSync(join(__dirname, "../src/shell.ts"), "utf-8");
+	const demoReadme = readFileSync(join(__dirname, "../README.md"), "utf-8");
+	const packageReadme = readFileSync(join(__dirname, "../../../README.md"), "utf-8");
+	const apiReadme = readFileSync(
+		join(__dirname, "../../../../../docs/api/@xmachines/play-router-demo/README.md"),
+		"utf-8",
+	);
+
+	it("uses shared machine and catalog from play-router-shared", () => {
+		expect(mainSource).toMatch(
+			/import.*authMachine,\s*catalog.*@xmachines\/play-router-shared/,
+		);
+		expect(mainSource).toMatch(/definePlayer\s*\(/);
+		expect(mainSource).toMatch(/machine:\s*authMachine/);
+		expect(mainSource).toMatch(/catalog/);
+	});
+
+	it("uses play-router helpers for infrastructure wiring", () => {
+		expect(routerSource).toMatch(/extractMachineRoutes/);
+		expect(routerSource).toMatch(/createRouteMap/);
+		expect(routerSource).toMatch(/createBrowserHistory/);
+		expect(routerSource).toMatch(/createRouter/);
+		expect(routerSource).toMatch(/connectRouter/);
+	});
+
+	it("keeps shell reactive and actor-driven", () => {
+		expect(shellSource).toMatch(/Signal\.subtle\.Watcher/);
+		expect(shellSource).toMatch(/actor\.send\(\{\s*type:\s*"play\.route"/);
+		expect(shellSource).toMatch(/actor\.send\(\{\s*type:\s*"auth\.login"/);
+		expect(shellSource).toMatch(/actor\.send\(\{\s*type:\s*"auth\.logout"/);
+	});
+
+	it("documents shell terminology consistently", () => {
+		expect(demoReadme).toMatch(/src\/shell\.ts/);
+		expect(apiReadme).toMatch(/src\/shell\.ts/);
+		expect(demoReadme).not.toMatch(/src\/ui\.ts/);
+		expect(apiReadme).not.toMatch(/src\/ui\.ts/);
+		expect(packageReadme).toMatch(/play-router/i);
+	});
+});

package/examples/demo/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "extends": "@xmachines/shared/tsconfig",
+  "compilerOptions": {
+    "composite": true,
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "lib": ["ES2022", "DOM"]
+  },
+  "references": [
+    { "path": "../.." },
+    { "path": "../../../play" },
+    { "path": "../../../play-catalog" },
+    { "path": "../../../play-signals" },
+    { "path": "../../../play-xstate" }
+  ],
+  "include": ["src/**/*"]
+}

package/examples/demo/vite.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vite";
+import { xmAliases } from "@xmachines/shared/vite-aliases";
+
+export default defineConfig({
+	resolve: { alias: xmAliases(import.meta.url) },
+	server: { port: 5174 },
+});

package/examples/demo/vitest.browser.config.ts

@@ -0,0 +1,20 @@
+import { defineConfig } from "vitest/config";
+import { playwright } from "@vitest/browser-playwright";
+import { xmAliases } from "@xmachines/shared/vite-aliases";
+
+export default defineConfig({
+	resolve: { alias: xmAliases(import.meta.url) },
+	test: {
+		name: "vanilla-router-demo-browser",
+		setupFiles: ["../../../shared/config/vitest.setup.ts"],
+		include: ["test/browser/**/*.browser.test.ts"],
+		exclude: ["node_modules/**"],
+		fileParallelism: false,
+		browser: {
+			enabled: true,
+			provider: playwright(),
+			headless: true,
+			instances: [{ browser: "chromium" }],
+		},
+	},
+});

package/examples/demo/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+	test: {
+		include: ["test/**/*.test.ts"],
+		exclude: ["test/browser/**"],
+		passWithNoTests: true,
+	},
+});

package/examples/shared/dist/auth-machine.d.ts

@@ -0,0 +1,20 @@
+import type { PlayRouteEvent } from "@xmachines/play-router";
+export interface AuthContext {
+    isAuthenticated: boolean;
+    username: string | null;
+    routeParams: Record<string, string>;
+    queryParams: Record<string, string>;
+}
+export type AuthEvents = PlayRouteEvent | {
+    type: "auth.login";
+    username: string;
+} | {
+    type: "auth.register";
+    username: string;
+    email: string;
+    password: string;
+} | {
+    type: "auth.logout";
+};
+export declare const authMachine: import("xstate").StateMachine<import("xstate").MachineContext, import("xstate").AnyEventObject, Record<string, import("xstate").AnyActorRef>, import("xstate").ProvidedActor, import("xstate").ParameterizedObject, import("xstate").ParameterizedObject, string, import("xstate").StateValue, string, unknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, any>;
+//# sourceMappingURL=auth-machine.d.ts.map

package/examples/shared/dist/auth-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-machine.d.ts","sourceRoot":"","sources":["../src/auth-machine.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,WAAW,WAAW;IAC3B,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAID,MAAM,MAAM,UAAU,GACnB,cAAc,GACd;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAsM3B,eAAO,MAAM,WAAW,uZAA2D,CAAC"}

package/examples/shared/dist/auth-machine.js

@@ -0,0 +1,212 @@
+/**
+ * Unified Authentication State Machine
+ *
+ * Shared across ALL demo applications (Vanilla, React, Vue, SolidJS, TanStack Solid, React Router)
+ *
+ * States:
+ * - home: Public landing page (/)
+ * - about: Public information page (/about)
+ * - contact: Public contact page (/contact)
+ * - login: Login form (/login)
+ * - dashboard: Protected authenticated home (/dashboard)
+ * - profile: Protected user profile (/profile/:username)
+ *
+ * Events:
+ * - auth.login: Login with username only (no password)
+ * - auth.logout: Logout and return to home
+ * - play.route: Navigation events from router
+ */
+import { createMachine, assign } from "xstate";
+import { formatPlayRouteTransitions } from "@xmachines/play-xstate";
+const machineConfig = {
+    id: "auth",
+    initial: "home",
+    types: {
+        context: {},
+        events: {},
+        input: {},
+    },
+    context: ({ input }) => ({
+        isAuthenticated: input?.isAuthenticated ?? false,
+        username: input?.username ?? null,
+        routeParams: input?.routeParams ?? {},
+        queryParams: input?.queryParams ?? {},
+    }),
+    // ROOT-LEVEL EVENT HANDLERS
+    // These can be triggered from any state
+    on: {
+        "auth.login": {
+            target: ".dashboard",
+            actions: assign({
+                isAuthenticated: true,
+                username: ({ event }) => event.username,
+            }),
+        },
+        "auth.register": {
+            target: ".dashboard",
+            actions: assign({
+                isAuthenticated: true,
+                username: ({ event }) => event.username,
+            }),
+        },
+    },
+    states: {
+        // PUBLIC ROUTES
+        home: {
+            id: "home",
+            meta: {
+                route: "/",
+                view: {
+                    component: "Home",
+                    props: { title: "Welcome Home" },
+                },
+            },
+            on: {
+                "auth.logout": {
+                    actions: assign({
+                        isAuthenticated: false,
+                        username: null,
+                    }),
+                },
+            },
+        },
+        about: {
+            id: "about",
+            meta: {
+                route: "/about",
+                view: {
+                    component: "About",
+                    props: { title: "About Us" },
+                },
+            },
+            on: {
+                "auth.logout": {
+                    target: "home",
+                    actions: assign({
+                        isAuthenticated: false,
+                        username: null,
+                    }),
+                },
+            },
+        },
+        contact: {
+            id: "contact",
+            meta: {
+                route: "/contact",
+                view: {
+                    component: "Contact",
+                    props: { title: "Contact Us" },
+                },
+            },
+            on: {
+                "auth.logout": {
+                    target: "home",
+                    actions: assign({
+                        isAuthenticated: false,
+                        username: null,
+                    }),
+                },
+            },
+        },
+        login: {
+            id: "login",
+            meta: {
+                route: "/login",
+                view: {
+                    component: "Login",
+                    props: { title: "Please Log In" },
+                },
+            },
+        },
+        register: {
+            id: "register",
+            meta: {
+                route: "/register",
+                view: {
+                    component: "Register",
+                    props: { title: "Create Account" },
+                },
+            },
+        },
+        // PROTECTED ROUTES
+        dashboard: {
+            id: "dashboard",
+            meta: {
+                route: "/dashboard",
+                view: {
+                    component: "Dashboard",
+                    props: ({ context }) => ({
+                        welcome: true,
+                        username: context.username || "Guest",
+                    }),
+                },
+            },
+            on: {
+                "auth.logout": {
+                    target: "home",
+                    actions: assign({
+                        isAuthenticated: false,
+                        username: null,
+                    }),
+                },
+            },
+            always: {
+                guard: ({ context }) => !context.isAuthenticated,
+                target: "login",
+            },
+        },
+        profile: {
+            id: "profile",
+            meta: {
+                route: "/profile/:username",
+                view: {
+                    component: "Profile",
+                    props: ({ context }) => ({
+                        username: context.routeParams.username || context.username || "Guest",
+                    }),
+                },
+            },
+            on: {
+                "auth.logout": {
+                    target: "home",
+                    actions: assign({
+                        isAuthenticated: false,
+                        username: null,
+                    }),
+                },
+            },
+            always: {
+                guard: ({ context }) => !context.isAuthenticated,
+                target: "login",
+            },
+        },
+        settings: {
+            id: "settings",
+            meta: {
+                route: "/settings/:section?",
+                view: {
+                    component: "Settings",
+                    props: ({ context }) => ({
+                        section: context.routeParams.section,
+                        username: context.username || "Guest",
+                    }),
+                },
+            },
+            on: {
+                "auth.logout": {
+                    target: "home",
+                    actions: assign({
+                        isAuthenticated: false,
+                        username: null,
+                    }),
+                },
+            },
+            always: {
+                guard: ({ context }) => !context.isAuthenticated,
+                target: "login",
+            },
+        },
+    },
+};
+export const authMachine = createMachine(formatPlayRouteTransitions(machineConfig));
+//# sourceMappingURL=auth-machine.js.map

package/examples/shared/dist/auth-machine.js.map

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

package/examples/shared/dist/catalog.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Component Catalog - Type-Safe UI Schema
+ *
+ * Defines component prop schemas using Zod for runtime validation.
+ * Used by definePlayer() for build-time type checking.
+ *
+ * Framework-agnostic: No framework imports — catalog is pure business logic.
+ * Shared across all demo applications.
+ */
+import { z } from "zod";
+/**
+ * Type-safe component catalog with Zod schemas
+ *
+ * defineCatalog() accepts record of component names to Zod schemas.
+ * Props are inferred by PlayRenderer for type-safe component rendering.
+ */
+export declare const catalog: {
+    /**
+     * Home component
+     * Public landing page
+     */
+    Home: z.ZodObject<{
+        title: z.ZodString;
+    }, z.core.$strip>;
+    /**
+     * About component
+     * Public information page
+     */
+    About: z.ZodObject<{
+        title: z.ZodString;
+    }, z.core.$strip>;
+    /**
+     * Contact component
+     * Public contact page
+     */
+    Contact: z.ZodObject<{
+        title: z.ZodString;
+    }, z.core.$strip>;
+    /**
+     * Login component
+     * Login form page
+     */
+    Login: z.ZodObject<{
+        title: z.ZodString;
+    }, z.core.$strip>;
+    /**
+     * Dashboard component
+     * Protected dashboard page
+     */
+    Dashboard: z.ZodObject<{
+        welcome: z.ZodBoolean;
+        username: z.ZodString;
+    }, z.core.$strip>;
+    /**
+     * Profile component
+     * Protected user profile with username parameter
+     */
+    Profile: z.ZodObject<{
+        username: z.ZodString;
+    }, z.core.$strip>;
+    /**
+     * Settings component
+     * Protected settings page with optional section parameter
+     */
+    Settings: z.ZodObject<{
+        section: z.ZodOptional<z.ZodString>;
+        username: z.ZodString;
+    }, z.core.$strip>;
+    /**
+     * Register component
+     * Auth-only registration form
+     */
+    Register: z.ZodObject<{
+        title: z.ZodString;
+    }, z.core.$strip>;
+    /**
+     * Navigation component
+     * Displays all available routes categorized by access level
+     */
+    Navigation: z.ZodObject<{
+        isAuthenticated: z.ZodBoolean;
+        currentPath: z.ZodString;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=catalog.d.ts.map

package/examples/shared/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;GAKG;AACH,eAAO,MAAM,OAAO;IACnB;;;OAGG;;;;IAKH;;;OAGG;;;;IAKH;;;OAGG;;;;IAKH;;;OAGG;;;;IAKH;;;OAGG;;;;;IAMH;;;OAGG;;;;IAKH;;;OAGG;;;;;IAMH;;;OAGG;;;;IAKH;;;OAGG;;;;;CAKF,CAAC"}

package/examples/shared/dist/catalog.js

@@ -0,0 +1,86 @@
+/**
+ * Component Catalog - Type-Safe UI Schema
+ *
+ * Defines component prop schemas using Zod for runtime validation.
+ * Used by definePlayer() for build-time type checking.
+ *
+ * Framework-agnostic: No framework imports — catalog is pure business logic.
+ * Shared across all demo applications.
+ */
+import { z } from "zod";
+import { defineCatalog } from "@xmachines/play-catalog";
+/**
+ * Type-safe component catalog with Zod schemas
+ *
+ * defineCatalog() accepts record of component names to Zod schemas.
+ * Props are inferred by PlayRenderer for type-safe component rendering.
+ */
+export const catalog = defineCatalog({
+    /**
+     * Home component
+     * Public landing page
+     */
+    Home: z.object({
+        title: z.string(),
+    }),
+    /**
+     * About component
+     * Public information page
+     */
+    About: z.object({
+        title: z.string(),
+    }),
+    /**
+     * Contact component
+     * Public contact page
+     */
+    Contact: z.object({
+        title: z.string(),
+    }),
+    /**
+     * Login component
+     * Login form page
+     */
+    Login: z.object({
+        title: z.string(),
+    }),
+    /**
+     * Dashboard component
+     * Protected dashboard page
+     */
+    Dashboard: z.object({
+        welcome: z.boolean(),
+        username: z.string(),
+    }),
+    /**
+     * Profile component
+     * Protected user profile with username parameter
+     */
+    Profile: z.object({
+        username: z.string(),
+    }),
+    /**
+     * Settings component
+     * Protected settings page with optional section parameter
+     */
+    Settings: z.object({
+        section: z.string().optional(),
+        username: z.string(),
+    }),
+    /**
+     * Register component
+     * Auth-only registration form
+     */
+    Register: z.object({
+        title: z.string(),
+    }),
+    /**
+     * Navigation component
+     * Displays all available routes categorized by access level
+     */
+    Navigation: z.object({
+        isAuthenticated: z.boolean(),
+        currentPath: z.string(),
+    }),
+});
+//# sourceMappingURL=catalog.js.map

package/examples/shared/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC;IACpC;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;IAEF;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;IAEF;;;OAGG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;IAEF;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;IAEF;;;OAGG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB,CAAC;IAEF;;;OAGG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB,CAAC;IAEF;;;OAGG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB,CAAC;IAEF;;;OAGG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;IAEF;;;OAGG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE;QAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;KACvB,CAAC;CACF,CAAC,CAAC"}

package/examples/shared/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { authMachine } from "./auth-machine.js";
+export type { AuthEvents, AuthContext } from "./auth-machine.js";
+export { catalog } from "./catalog.js";
+//# sourceMappingURL=index.d.ts.map

package/examples/shared/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/examples/shared/dist/index.js

@@ -0,0 +1,3 @@
+export { authMachine } from "./auth-machine.js";
+export { catalog } from "./catalog.js";
+//# sourceMappingURL=index.js.map

package/examples/shared/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/examples/shared/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@xmachines/play-router-shared",
+  "version": "1.0.0-beta.1",
+  "private": true,
+  "description": "Shared auth machine and catalog for @xmachines router adapter demos.",
+  "keywords": [
+    "auth",
+    "examples",
+    "xmachines"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./index.css": "./src/index.css"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "dependencies": {
+    "@xmachines/play-catalog": "1.0.0-beta.1",
+    "@xmachines/play-router": "1.0.0-beta.1",
+    "@xmachines/play-xstate": "1.0.0-beta.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "typescript": "^5.7.0",
+    "xstate": "^5.28.0"
+  },
+  "peerDependencies": {
+    "xstate": "^5.28.0"
+  }
+}