@esmx/router 3.0.0-rc.29 → 3.0.0-rc.31

package/dist/router-forward.test.mjs

@@ -1,376 +0,0 @@
-import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
-import { Router } from "./router.mjs";
-import { RouteType, RouterMode } from "./types.mjs";
-describe("Router.forward Tests", () => {
-  let router;
-  let executionLog;
-  beforeEach(async () => {
-    executionLog = [];
-    router = new Router({
-      mode: RouterMode.memory,
-      base: new URL("http://localhost:3000/"),
-      fallback: (to, from) => {
-        executionLog.push("location-handler-".concat(to.path));
-      },
-      routes: [
-        {
-          path: "/",
-          component: () => "Home"
-        },
-        {
-          path: "/about",
-          component: () => "About"
-        },
-        {
-          path: "/user/:id",
-          component: () => "User",
-          beforeEnter: (to) => {
-            if (to.params.id === "blocked") {
-              return false;
-            }
-            if (to.params.id === "redirect") {
-              return "/about";
-            }
-          }
-        },
-        {
-          path: "/async",
-          asyncComponent: () => new Promise((resolve) => {
-            setTimeout(() => resolve("AsyncComponent"), 10);
-          })
-        },
-        {
-          path: "/async-error",
-          asyncComponent: () => new Promise((_, reject) => {
-            setTimeout(
-              () => reject(new Error("Load failed")),
-              10
-            );
-          })
-        }
-      ]
-    });
-    await router.push("/");
-  });
-  afterEach(() => {
-    router.destroy();
-  });
-  describe("\u{1F3AF} Core Behavior", () => {
-    test("forward should return Promise<Route | null>", async () => {
-      await router.push("/about");
-      await router.back();
-      const route = await router.forward();
-      expect(route).toBeInstanceOf(Object);
-      expect(route == null ? void 0 : route.path).toBe("/about");
-      expect(route == null ? void 0 : route.handle).not.toBeNull();
-    });
-    test("forward should navigate to next route", async () => {
-      await router.push("/about");
-      await router.push("/user/123");
-      await router.back();
-      const forwardRoute = await router.forward();
-      expect(forwardRoute == null ? void 0 : forwardRoute.path).toBe("/user/123");
-      expect(router.route.path).toBe("/user/123");
-    });
-    test("forward should update router state", async () => {
-      await router.push("/about");
-      await router.back();
-      await router.forward();
-      expect(router.route.path).toBe("/about");
-      expect(router.route.handle).not.toBeNull();
-    });
-  });
-  describe("\u{1F504} History Navigation Logic", () => {
-    test("forward should navigate based on history stack", async () => {
-      await router.push("/about");
-      await router.push("/user/123");
-      await router.back();
-      await router.back();
-      const route1 = await router.forward();
-      expect(route1 == null ? void 0 : route1.path).toBe("/about");
-      expect(router.route.path).toBe("/about");
-      const route2 = await router.forward();
-      expect(route2 == null ? void 0 : route2.path).toBe("/user/123");
-      expect(router.route.path).toBe("/user/123");
-    });
-    test("forward beyond history boundaries should return null", async () => {
-      await router.push("/about");
-      await router.push("/user/123");
-      const route = await router.forward();
-      expect(route).toBe(null);
-      expect(router.route.path).toBe("/user/123");
-    });
-    test("forward should return correct RouteType", async () => {
-      await router.push("/about");
-      await router.back();
-      const route = await router.forward();
-      expect(route == null ? void 0 : route.type).toBe(RouteType.forward);
-    });
-    test("forward should keep isPush as false", async () => {
-      await router.push("/about");
-      await router.back();
-      const route = await router.forward();
-      expect(route == null ? void 0 : route.isPush).toBe(false);
-    });
-  });
-  describe("\u{1F3C3} Concurrency Control", () => {
-    test("later initiated forward should cancel earlier forward", async () => {
-      await router.push("/about");
-      await router.push("/user/123");
-      await router.back();
-      await router.back();
-      const [firstResult, secondResult] = await Promise.all([
-        router.forward(),
-        // First operation, should succeed
-        router.forward()
-        // Second operation, returns null due to first one in progress
-      ]);
-      expect(firstResult == null ? void 0 : firstResult.handle).not.toBeNull();
-      expect(secondResult).toBe(null);
-      expect(router.route.path).toBe("/about");
-    });
-    test("cancelled tasks should not affect micro-app state", async () => {
-      const updateSpy = vi.spyOn(router.microApp, "_update");
-      await router.push("/about");
-      await router.push("/user/123");
-      await router.back();
-      await router.back();
-      updateSpy.mockClear();
-      const [firstResult, secondResult] = await Promise.all([
-        router.forward(),
-        // First operation succeeds
-        router.forward()
-        // Second operation returns null
-      ]);
-      expect(firstResult == null ? void 0 : firstResult.handle).not.toBeNull();
-      expect(secondResult).toBe(null);
-      expect(updateSpy).toHaveBeenCalledTimes(1);
-    });
-  });
-  describe("\u{1F3AD} Micro-app Integration", () => {
-    test("forward should trigger micro-app update", async () => {
-      const updateSpy = vi.spyOn(router.microApp, "_update");
-      await router.push("/about");
-      await router.back();
-      await router.forward();
-      expect(updateSpy).toHaveBeenCalled();
-    });
-    test("micro-app update should happen after route state update", async () => {
-      let routePathWhenUpdated = null;
-      vi.spyOn(router.microApp, "_update").mockImplementation(() => {
-        routePathWhenUpdated = router.route.path;
-      });
-      await router.push("/about");
-      await router.back();
-      await router.forward();
-      expect(routePathWhenUpdated).toBe("/about");
-    });
-  });
-  describe("\u26A1 Async Components & Forward", () => {
-    test("forward to async component route should wait for component loading", async () => {
-      await router.push("/async");
-      await router.back();
-      const route = await router.forward();
-      expect(route == null ? void 0 : route.path).toBe("/async");
-      expect(route == null ? void 0 : route.handle).not.toBeNull();
-    });
-    test("forward to failed async component route should return error status", async () => {
-      await router.push("/about");
-      await expect(router.push("/async-error")).rejects.toThrow();
-      expect(router.route.path).toBe("/about");
-      const route = await router.forward();
-      expect(route).toBe(null);
-    });
-  });
-  describe("\u{1F6E1}\uFE0F Forward Guard Behavior", () => {
-    test("forward to guard-blocked route should throw navigation aborted error", async () => {
-      await expect(router.push("/user/blocked")).rejects.toThrow();
-      expect(router.route.path).toBe("/");
-      const result = await router.forward();
-      expect(result).toBe(null);
-    });
-    test("forward to route with redirect guard should navigate to redirect route", async () => {
-      await router.push("/user/redirect");
-      await router.back();
-      const route = await router.forward();
-      expect(route == null ? void 0 : route.path).toBe("/about");
-    });
-    test("afterEach only executes when forward succeeds", async () => {
-      let afterEachCalled = false;
-      const testRouter = new Router({
-        mode: RouterMode.memory,
-        base: new URL("http://localhost:3000/"),
-        routes: [
-          { path: "/", component: "Home" },
-          { path: "/about", component: "About" },
-          {
-            path: "/blocked",
-            component: "Blocked",
-            beforeEnter: () => false
-          }
-        ]
-      });
-      testRouter.afterEach(() => {
-        afterEachCalled = true;
-      });
-      await testRouter.push("/about");
-      afterEachCalled = false;
-      await testRouter.back();
-      afterEachCalled = false;
-      await testRouter.forward();
-      expect(afterEachCalled).toBe(true);
-      testRouter.destroy();
-    });
-    test("beforeEach guard should be called during forward operation", async () => {
-      let beforeEachCalled = false;
-      router.beforeEach(() => {
-        beforeEachCalled = true;
-      });
-      await router.push("/about");
-      await router.back();
-      await router.forward();
-      expect(beforeEachCalled).toBe(true);
-    });
-  });
-  describe("\u{1F4BE} History Management", () => {
-    test("forward should navigate correctly in history stack", async () => {
-      await router.push("/about");
-      await router.push("/user/123");
-      await router.back();
-      const route = await router.forward();
-      expect(route == null ? void 0 : route.path).toBe("/user/123");
-      expect(router.route.path).toBe("/user/123");
-    });
-    test("forward operation should not create new history entries", async () => {
-      await router.push("/about");
-      await router.push("/user/123");
-      await router.back();
-      await router.forward();
-      const backRoute = await router.back();
-      expect(backRoute == null ? void 0 : backRoute.path).toBe("/about");
-    });
-  });
-  describe("\u274C Error Handling", () => {
-    test("forward to non-existent route should trigger location handling", async () => {
-      const fallbackSpy = vi.fn();
-      const testRouter = new Router({
-        mode: RouterMode.memory,
-        base: new URL("http://localhost:3000/"),
-        fallback: fallbackSpy,
-        routes: [{ path: "/", component: "Home" }]
-      });
-      await testRouter.push("/");
-      const result = await testRouter.forward();
-      expect(result).toBe(null);
-      testRouter.destroy();
-    });
-    test("exceptions during forward process should propagate correctly", async () => {
-      const testRouter = new Router({
-        mode: RouterMode.memory,
-        base: new URL("http://localhost:3000/"),
-        routes: [
-          { path: "/", component: "Home" },
-          { path: "/about", component: "About" }
-        ]
-      });
-      await testRouter.push("/about");
-      await testRouter.back();
-      testRouter.beforeEach(() => {
-        throw new Error("Guard error");
-      });
-      await expect(testRouter.forward()).rejects.toThrow("Guard error");
-      testRouter.destroy();
-    });
-  });
-  describe("\u{1F50D} Edge Cases", () => {
-    test("forward should handle special character paths correctly", async () => {
-      const testRouter = new Router({
-        mode: RouterMode.memory,
-        base: new URL("http://localhost:3000/"),
-        routes: [
-          { path: "/", component: "Home" },
-          { path: "/special", component: "Special" }
-        ],
-        fallback: () => ({ component: "Fallback" })
-      });
-      await testRouter.push("/");
-      await testRouter.push("/special");
-      expect(testRouter.route.path).toBe("/special");
-      await testRouter.back();
-      expect(testRouter.route.path).toBe("/");
-      const route = await testRouter.forward();
-      expect(route == null ? void 0 : route.path).toBe("/special");
-      expect(testRouter.route.path).toBe("/special");
-      testRouter.destroy();
-    });
-  });
-  describe("\u{1F517} Integration with Other Navigation Methods", () => {
-    test("forward should behave consistently with go(1)", async () => {
-      await router.push("/about");
-      await router.push("/user/123");
-      await router.back();
-      await router.back();
-      const forwardRoute = await router.forward();
-      const goRoute = await router.go(1);
-      expect(forwardRoute == null ? void 0 : forwardRoute.path).toBe("/about");
-      expect(goRoute == null ? void 0 : goRoute.path).toBe("/user/123");
-    });
-    test("push after forward should handle history correctly", async () => {
-      await router.push("/about");
-      await router.push("/user/123");
-      await router.back();
-      await router.forward();
-      await router.push("/user/456");
-      expect(router.route.path).toBe("/user/456");
-    });
-  });
-  describe("\u{1F527} handleBackBoundary Callback Tests", () => {
-    test("forward beyond boundaries should not trigger handleBackBoundary", async () => {
-      let handleBackBoundaryCalled = false;
-      const testRouter = new Router({
-        mode: RouterMode.memory,
-        base: new URL("http://localhost:3000/"),
-        routes: [{ path: "/", component: "Home" }],
-        handleBackBoundary: () => {
-          handleBackBoundaryCalled = true;
-        }
-      });
-      await testRouter.push("/");
-      const result = await testRouter.forward();
-      expect(result).toBe(null);
-      expect(handleBackBoundaryCalled).toBe(false);
-      testRouter.destroy();
-    });
-    test("should not error when no handleBackBoundary callback", async () => {
-      const testRouter = new Router({
-        mode: RouterMode.memory,
-        base: new URL("http://localhost:3000/"),
-        routes: [{ path: "/", component: "Home" }]
-      });
-      await testRouter.push("/");
-      const result = await testRouter.forward();
-      expect(result).toBe(null);
-      testRouter.destroy();
-    });
-  });
-  describe("\u{1F504} Navigation Result Handling", () => {
-    test("should correctly handle successful navigation result", async () => {
-      await router.push("/about");
-      await router.back();
-      const route = await router.forward();
-      expect(route == null ? void 0 : route.path).toBe("/about");
-      expect(router.route.path).toBe("/about");
-    });
-    test("should return null directly when Navigation returns null", async () => {
-      const testRouter = new Router({
-        mode: RouterMode.memory,
-        base: new URL("http://localhost:3000/"),
-        routes: [{ path: "/", component: "Home" }]
-      });
-      await testRouter.push("/");
-      const result = await testRouter.forward();
-      expect(result).toBe(null);
-      testRouter.destroy();
-    });
-  });
-});

package/dist/router-go.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/router-go.test.mjs

@@ -1,73 +0,0 @@
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
-import { Router } from "./router.mjs";
-import { RouterMode } from "./types.mjs";
-describe("Router Go Tests", () => {
-  let router;
-  beforeEach(async () => {
-    router = new Router({
-      mode: RouterMode.memory,
-      base: new URL("http://localhost:3000/"),
-      routes: [
-        { path: "/", component: () => "Home" },
-        { path: "/user/:id", component: () => "User" },
-        { path: "/about", component: () => "About" }
-      ]
-    });
-    await router.replace("/");
-  });
-  afterEach(() => {
-    router.destroy();
-  });
-  describe("Basic go navigation", () => {
-    test("should go back successfully", async () => {
-      await router.push("/about");
-      await router.push("/user/123");
-      const route = await router.go(-1);
-      expect(route == null ? void 0 : route.path).toBe("/about");
-      expect(router.route.path).toBe("/about");
-    });
-    test("should go forward successfully", async () => {
-      await router.push("/about");
-      await router.push("/user/123");
-      await router.back();
-      const route = await router.go(1);
-      expect(route == null ? void 0 : route.path).toBe("/user/123");
-      expect(router.route.path).toBe("/user/123");
-    });
-    test("should handle go to specific position", async () => {
-      await router.push("/about");
-      await router.push("/user/123");
-      await router.push("/user/456");
-      const route = await router.go(-2);
-      expect(route == null ? void 0 : route.path).toBe("/about");
-    });
-  });
-  describe("Error handling", () => {
-    test("should handle go when history is empty", async () => {
-      const route = await router.go(-1);
-      expect(route).toBe(null);
-      const route2 = await router.go(1);
-      expect(route2).toBe(null);
-    });
-    test("should handle invalid delta values", async () => {
-      const route = await router.go(0);
-      expect(route).toBe(null);
-      const route2 = await router.go(-10);
-      expect(route2).toBe(null);
-    });
-  });
-  describe("History boundaries", () => {
-    test("should return null when going beyond history", async () => {
-      const route = await router.go(-10);
-      expect(route).toBe(null);
-      const route2 = await router.go(10);
-      expect(route2).toBe(null);
-    });
-    test("should handle boundary conditions gracefully", async () => {
-      await router.push("/about");
-      const route = await router.go(-2);
-      expect(route).toBe(null);
-      expect(router.route.path).toBe("/about");
-    });
-  });
-});

package/dist/router-guards-cleanup.test.d.ts

@@ -1 +0,0 @@
-export {};