kiru 0.53.0 → 0.54.0-preview.1

package/dist/router/globals.d.ts

@@ -9,4 +9,7 @@ export declare const fileRouterRoute: {
 export declare const routerCache: {
     current: RouterCache | null;
 };
+export declare const requestContext: {
+    current: Kiru.RequestContext;
+};
 //# sourceMappingURL=globals.d.ts.map

package/dist/router/globals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../../src/router/globals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAElE,eAAO,MAAM,kBAAkB;aACZ,oBAAoB,GAAG,IAAI;CAC7C,CAAA;AAED,eAAO,MAAM,eAAe;aACT,MAAM,GAAG,IAAI;CAC/B,CAAA;AAED,eAAO,MAAM,WAAW;aACL,WAAW,GAAG,IAAI;CACpC,CAAA"}
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../../src/router/globals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAElE,eAAO,MAAM,kBAAkB;aACZ,oBAAoB,GAAG,IAAI;CAC7C,CAAA;AAED,eAAO,MAAM,eAAe;aACT,MAAM,GAAG,IAAI;CAC/B,CAAA;AAED,eAAO,MAAM,WAAW;aACL,WAAW,GAAG,IAAI;CACpC,CAAA;AAED,eAAO,MAAM,cAAc;aACV,IAAI,CAAC,cAAc;CACnC,CAAA"}

package/dist/router/globals.js

@@ -7,4 +7,7 @@ export const fileRouterRoute = {
 export const routerCache = {
     current: null,
 };
+export const requestContext = {
+    current: {},
+};
 //# sourceMappingURL=globals.js.map

package/dist/router/globals.js.map

@@ -1 +1 @@
-{"version":3,"file":"globals.js","sourceRoot":"","sources":["../../src/router/globals.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,IAAmC;CAC7C,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,IAAqB;CAC/B,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,IAA0B;CACpC,CAAA"}
+{"version":3,"file":"globals.js","sourceRoot":"","sources":["../../src/router/globals.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,IAAmC;CAC7C,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,IAAqB;CAC/B,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,IAA0B;CACpC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,EAAyB;CACnC,CAAA"}

package/dist/router/guard.d.ts

@@ -0,0 +1,17 @@
+import type { NavigationHook } from "./types";
+import type { GuardModule } from "./types.internal";
+export type GuardBeforeEach = NavigationHook<void | string | Promise<void | string>>;
+export type GuardAfterEach = NavigationHook<void | Promise<void>>;
+export interface NavGuard {
+    beforeEach: GuardBeforeEach;
+    afterEach: GuardAfterEach;
+}
+export declare const $NAVGUARD_INTERNAL: unique symbol;
+export declare function resolveNavguard(module: GuardModule): NavGuard | null;
+export interface NavGuardBuilder {
+    beforeEach(...fns: GuardBeforeEach[]): NavGuardBuilder;
+    afterEach(...fns: GuardAfterEach[]): NavGuardBuilder;
+    get [$NAVGUARD_INTERNAL](): NavGuard;
+}
+export declare function createNavGuard(): NavGuardBuilder;
+//# sourceMappingURL=guard.d.ts.map

package/dist/router/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/router/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,MAAM,eAAe,GAAG,cAAc,CAC1C,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CACvC,CAAA;AACD,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;AAEjE,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,eAAe,CAAA;IAC3B,SAAS,EAAE,cAAc,CAAA;CAC1B;AAED,eAAO,MAAM,kBAAkB,eAA8B,CAAA;AAE7D,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,IAAI,CAQpE;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,GAAG,GAAG,EAAE,eAAe,EAAE,GAAG,eAAe,CAAA;IACtD,SAAS,CAAC,GAAG,GAAG,EAAE,cAAc,EAAE,GAAG,eAAe,CAAA;IACpD,IAAI,CAAC,kBAAkB,CAAC,IAAI,QAAQ,CAAA;CACrC;AAwBD,wBAAgB,cAAc,IAAI,eAAe,CAkBhD"}

package/dist/router/guard.js

@@ -0,0 +1,45 @@
+export const $NAVGUARD_INTERNAL = Symbol.for("kiru:navguard");
+export function resolveNavguard(module) {
+    if ("guard" in module &&
+        $NAVGUARD_INTERNAL in (module.guard ?? {})) {
+        return module.guard[$NAVGUARD_INTERNAL];
+    }
+    return null;
+}
+function createNavGuard_impl(beforeEach, afterEach) {
+    return {
+        beforeEach: async (ctx, to, from) => {
+            for (const fn of beforeEach) {
+                const res = await fn(ctx, to, from);
+                if (typeof res === "string") {
+                    return res;
+                }
+            }
+            return;
+        },
+        afterEach: async (ctx, to, from) => {
+            for (const fn of afterEach) {
+                await fn(ctx, to, from);
+            }
+        },
+    };
+}
+export function createNavGuard() {
+    const beforeEach = [];
+    const afterEach = [];
+    const guard = createNavGuard_impl(beforeEach, afterEach);
+    return {
+        beforeEach(...fns) {
+            beforeEach.push(...fns);
+            return this;
+        },
+        afterEach(...fns) {
+            afterEach.push(...fns);
+            return this;
+        },
+        get [$NAVGUARD_INTERNAL]() {
+            return guard;
+        },
+    };
+}
+//# sourceMappingURL=guard.js.map

package/dist/router/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/router/guard.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;AAE7D,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,IACE,OAAO,IAAI,MAAM;QACjB,kBAAkB,IAAK,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAqB,EAC/D,CAAC;QACD,OAAQ,MAAM,CAAC,KAAyB,CAAC,kBAAkB,CAAC,CAAA;IAC9D,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAQD,SAAS,mBAAmB,CAC1B,UAA6B,EAC7B,SAA2B;IAE3B,OAAO;QACL,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YAClC,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;gBAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,CAAA;gBACnC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;oBAC5B,OAAO,GAAG,CAAA;gBACZ,CAAC;YACH,CAAC;YACD,OAAM;QACR,CAAC;QACD,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YACjC,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;gBAC3B,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,CAAA;YACzB,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,UAAU,GAAsB,EAAE,CAAA;IACxC,MAAM,SAAS,GAAqB,EAAE,CAAA;IACtC,MAAM,KAAK,GAAG,mBAAmB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;IAExD,OAAO;QACL,UAAU,CAAC,GAAG,GAAsB;YAClC,UAAU,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAA;YACvB,OAAO,IAAI,CAAA;QACb,CAAC;QACD,SAAS,CAAC,GAAG,GAAqB;YAChC,SAAS,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAA;YACtB,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC;YACtB,OAAO,KAAK,CAAA;QACd,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/router/head.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../src/router/head.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAA;AAIlC,iBAAS,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CAwC1E;AAED,iBAAS,UAAU,IAAI,GAAG,CAAC,OAAO,CAEjC"}
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../src/router/head.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAA;AAIlC,iBAAS,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CAsC1E;AAED,iBAAS,UAAU,IAAI,GAAG,CAAC,OAAO,CAEjC"}

package/dist/router/head.js

@@ -1,5 +1,5 @@
 import { Signal } from "../signals/base.js";
-import { isValidTextChild, isVNode } from "../utils/index.js";
+import { isValidTextChild, isVNode, toArray } from "../utils/index.js";
 import { createElement } from "../element.js";
 import { __DEV__ } from "../env.js";
 import { KiruError } from "../error.js";
@@ -9,7 +9,7 @@ const validHeadChildren = ["title", "base", "link", "meta", "style", "script"];
 function HeadContent({ children }) {
     if (__DEV__) {
         const n = node.current;
-        const asArray = Array.isArray(children) ? children : [children];
+        const asArray = toArray(children);
         const invalidNodes = asArray.filter((c) => !isVNode(c) ||
             typeof c.type !== "string" ||
             !validHeadChildren.includes(c.type));
@@ -21,13 +21,11 @@ function HeadContent({ children }) {
         }
     }
     if ("window" in globalThis) {
-        const asArray = Array.isArray(children) ? children : [children];
-        const titleNode = asArray.find((c) => isVNode(c) && c.type === "title");
+        const c = toArray(children);
+        const titleNode = c.find((c) => isVNode(c) && c.type === "title");
         if (titleNode) {
             const props = titleNode.props;
-            const titleChildren = Array.isArray(props.children)
-                ? props.children
-                : [props.children];
+            const titleChildren = toArray(props.children);
             document.title = titleChildren
                 .map((c) => (Signal.isSignal(c) ? c.value : c))
                 .filter(isValidTextChild)

package/dist/router/head.js.map

@@ -1 +1 @@
-{"version":3,"file":"head.js","sourceRoot":"","sources":["../../src/router/head.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAEpC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAA;AAElC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;AAE9E,SAAS,WAAW,CAAC,EAAE,QAAQ,EAA8B;IAC3D,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,OAAQ,CAAA;QACvB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;QAC/D,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CACjC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,OAAO,CAAC,CAAC,CAAC;YACX,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;YAC1B,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CACtC,CAAA;QACD,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,SAAS,CAAC;gBAClB,OAAO,EAAE,wHAAwH,YAAY,CAAC,GAAG,CAC/I,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAC1D,EAAE;gBACH,KAAK,EAAE,CAAC;aACT,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;QAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAC1B,CAAA;QAEf,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;YAC7B,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;gBACjD,CAAC,CAAC,KAAK,CAAC,QAAQ;gBAChB,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YAEpB,QAAQ,CAAC,KAAK,GAAG,aAAa;iBAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBAC9C,MAAM,CAAC,gBAAgB,CAAC;iBACxB,IAAI,CAAC,EAAE,CAAC,CAAA;QACb,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,aAAa,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;AACzD,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,aAAa,CAAC,kBAAkB,CAAC,CAAA;AAC1C,CAAC"}
+{"version":3,"file":"head.js","sourceRoot":"","sources":["../../src/router/head.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAEpC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAA;AAElC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;AAE9E,SAAS,WAAW,CAAC,EAAE,QAAQ,EAA8B;IAC3D,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,OAAQ,CAAA;QACvB,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;QACjC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CACjC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,OAAO,CAAC,CAAC,CAAC;YACX,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;YAC1B,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CACtC,CAAA;QACD,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,SAAS,CAAC;gBAClB,OAAO,EAAE,wHAAwH,YAAY,CAAC,GAAG,CAC/I,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAC1D,EAAE;gBACH,KAAK,EAAE,CAAC;aACT,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC3B,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CACtB,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAC1B,CAAA;QAEf,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;YAC7B,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YAE7C,QAAQ,CAAC,KAAK,GAAG,aAAa;iBAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBAC9C,MAAM,CAAC,gBAAgB,CAAC;iBACxB,IAAI,CAAC,EAAE,CAAC,CAAA;QACb,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,aAAa,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;AACzD,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,aAAa,CAAC,kBAAkB,CAAC,CAAA;AAC1C,CAAC"}

package/dist/router/index.d.ts

@@ -1,6 +1,7 @@
-export { useFileRouter, type FileRouterContextType } from "./context.js";
+export { useRequestContext, useFileRouter, type FileRouterContextType, } from "./context.js";
 export * from "./errors.js";
 export { FileRouter, type FileRouterProps } from "./fileRouter.js";
+export { createNavGuard, type GuardBeforeEach, type GuardAfterEach, type NavGuard, type NavGuardBuilder, } from "./guard.js";
 export * from "./link.js";
 export * from "./pageConfig.js";
 export type * from "./types.js";

package/dist/router/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACxE,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAClE,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,mBAAmB,YAAY,CAAA;AAE/B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEnD,eAAO,MAAM,IAAI;IACf;;;;;;;;;;;;;;;KAeC;;IAED;;;;;;;;;;;;;;;;KAgBC;;CAEF,CAAA;AAED,eAAO,MAAM,IAAI;IACf;;;;;;;;;;;;;;;;OAgBG;;CAEJ,CAAA;AAED,iBAAS,UAAU,iBAElB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAA;AACrB,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EACL,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,YAAY,CAAA;AACnB,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,mBAAmB,YAAY,CAAA;AAE/B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEnD,eAAO,MAAM,IAAI;IACf;;;;;;;;;;;;;;;KAeC;;IAED;;;;;;;;;;;;;;;;KAgBC;;CAEF,CAAA;AAED,eAAO,MAAM,IAAI;IACf;;;;;;;;;;;;;;;;OAgBG;;CAEJ,CAAA;AAED,iBAAS,UAAU,iBAElB"}

package/dist/router/index.js

@@ -1,8 +1,9 @@
 import { createElement } from "../element.js";
 import { __DEV__ } from "../env.js";
-export { useFileRouter } from "./context.js";
+export { useRequestContext, useFileRouter, } from "./context.js";
 export * from "./errors.js";
 export { FileRouter } from "./fileRouter.js";
+export { createNavGuard, } from "./guard.js";
 export * from "./link.js";
 export * from "./pageConfig.js";
 import { HeadContent, HeadOutlet } from "./head.js";

package/dist/router/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,aAAa,EAA8B,MAAM,cAAc,CAAA;AACxE,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAA;AAClE,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAG/B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEnD,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB;;;;;;;;;;;;;;;KAeC;IACD,OAAO,EAAE,WAAW;IACpB;;;;;;;;;;;;;;;;KAgBC;IACD,MAAM,EAAE,UAAU;CACnB,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,EAAE,UAAU;CACnB,CAAA;AAED,SAAS,UAAU;IACjB,OAAO,aAAa,CAAC,kBAAkB,CAAC,CAAA;AAC1C,CAAC;AAED,IAAI,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,IAAI,CAAC,OAAmB,CAAC,WAAW,GAAG,mBAAmB,CAC3D;IAAC,IAAI,CAAC,MAAkB,CAAC,WAAW,GAAG,kBAAkB,CACzD;IAAC,IAAI,CAAC,MAAkB,CAAC,WAAW,GAAG,kBAAkB,CAAA;AAC5D,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EACL,iBAAiB,EACjB,aAAa,GAEd,MAAM,cAAc,CAAA;AACrB,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAA;AAClE,OAAO,EACL,cAAc,GAKf,MAAM,YAAY,CAAA;AACnB,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAG/B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEnD,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB;;;;;;;;;;;;;;;KAeC;IACD,OAAO,EAAE,WAAW;IACpB;;;;;;;;;;;;;;;;KAgBC;IACD,MAAM,EAAE,UAAU;CACnB,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,EAAE,UAAU;CACnB,CAAA;AAED,SAAS,UAAU;IACjB,OAAO,aAAa,CAAC,kBAAkB,CAAC,CAAA;AAC1C,CAAC;AAED,IAAI,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,IAAI,CAAC,OAAmB,CAAC,WAAW,GAAG,mBAAmB,CAC3D;IAAC,IAAI,CAAC,MAAkB,CAAC,WAAW,GAAG,kBAAkB,CACzD;IAAC,IAAI,CAAC,MAAkB,CAAC,WAAW,GAAG,kBAAkB,CAAA;AAC5D,CAAC"}

package/dist/router/{server → ssg}/index.d.ts

@@ -1,10 +1,11 @@
-import { FormattedViteImportMap } from "../types.internal.js";
+import type { FormattedViteImportMap, GuardModule, PageModule } from "../types.internal.js";
 export interface RenderContext {
-    pages: FormattedViteImportMap;
+    pages: FormattedViteImportMap<PageModule>;
     layouts: FormattedViteImportMap;
+    guards: FormattedViteImportMap<GuardModule>;
     Document: Kiru.FC;
     registerModule: (moduleId: string) => void;
-    registerPreloadedPageProps: (props: Record<string, unknown>) => void;
+    registerStaticProps: (props: Record<string, unknown>) => void;
 }
 export interface RenderResult {
     status: number;

package/dist/router/ssg/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/router/ssg/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,sBAAsB,EACtB,WAAW,EACX,UAAU,EACX,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAA;IACzC,OAAO,EAAE,sBAAsB,CAAA;IAC/B,MAAM,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAA;IAC3C,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAA;IACjB,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;CAC9D;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAsB,MAAM,CAC1B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,aAAa,EAClB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,YAAY,CAAC,CA0JvB;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,sBAAsB,mCAmCtE"}

package/dist/router/{server → ssg}/index.js

@@ -1,5 +1,5 @@
 import { createElement, Fragment } from "../../element.js";
-import { matchLayouts, matchRoute, match404Route, parseQuery, wrapWithLayouts, } from "../utils/index.js";
+import { matchModules, matchRoute, match404Route, parseQuery, wrapWithLayouts, } from "../utils/index.js";
 import { RouterContext } from "../context.js";
 import { __DEV__ } from "../../env.js";
 import { FileRouterDataLoadError } from "../errors.js";
@@ -34,7 +34,7 @@ export async function render(url, ctx, result) {
     }
     const { pageEntry, routeSegments, params } = routeMatch;
     const is404Route = routeMatch.routeSegments.includes("404");
-    const layoutEntries = matchLayouts(ctx.layouts, routeSegments);
+    const layoutEntries = matchModules(ctx.layouts, routeSegments);
     [pageEntry, ...layoutEntries].forEach((e) => {
         ctx.registerModule(e.filePath);
     });
@@ -47,7 +47,7 @@ export async function render(url, ctx, result) {
     const config = page.config ?? {};
     const abortController = new AbortController();
     if (config.loader) {
-        if (config.loader.mode !== "static" || __DEV__) {
+        if (!config.loader.static || __DEV__) {
             props = { loading: true, data: null, error: null };
         }
         else {
@@ -62,7 +62,10 @@ export async function render(url, ctx, result) {
                 abortController.abort("[kiru/router]: Page data loading timed out after 10 seconds");
             }, 10000);
             try {
-                const data = await config.loader.load(routerState);
+                const data = await config.loader.load({
+                    ...routerState,
+                    context: {},
+                });
                 props = {
                     data,
                     error: null,
@@ -78,7 +81,7 @@ export async function render(url, ctx, result) {
             }
             finally {
                 clearTimeout(timeout);
-                ctx.registerPreloadedPageProps({ data: props.data, error: props.error });
+                ctx.registerStaticProps({ data: props.data, error: props.error });
             }
         }
     }

package/dist/router/ssg/index.js.map

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

package/dist/router/ssr/index.d.ts

@@ -0,0 +1,20 @@
+import type { FormattedViteImportMap, GuardModule, PageModule } from "../types.internal.js";
+export interface SSRRenderContext {
+    pages: FormattedViteImportMap<PageModule>;
+    layouts: FormattedViteImportMap;
+    guards: FormattedViteImportMap<GuardModule>;
+    Document: Kiru.FC;
+    userContext: Kiru.RequestContext;
+    registerModule: (moduleId: string) => void;
+}
+export interface SSRHttpResponse {
+    html: string;
+    statusCode: number;
+    headers: Array<[string, string]>;
+    stream: ReadableStream | null;
+}
+export interface SSRRenderResult {
+    httpResponse: SSRHttpResponse | null;
+}
+export declare function render(url: string, ctx: SSRRenderContext): Promise<SSRRenderResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/router/ssr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/router/ssr/index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,sBAAsB,EACtB,WAAW,EACX,UAAU,EACX,MAAM,sBAAsB,CAAA;AAI7B,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAA;IACzC,OAAO,EAAE,sBAAsB,CAAA;IAC/B,MAAM,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAA;IAC3C,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAA;IACjB,WAAW,EAAE,IAAI,CAAC,cAAc,CAAA;IAChC,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAChC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,eAAe,GAAG,IAAI,CAAA;CACrC;AAED,wBAAsB,MAAM,CAC1B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,CAAC,CA+L1B"}

package/dist/router/ssr/index.js

@@ -0,0 +1,163 @@
+import path from "path";
+import { createElement, Fragment } from "../../element.js";
+import { __DEV__ } from "../../env.js";
+import { renderToString } from "../../renderToString.js";
+import { renderToReadableStream } from "../../ssr/server.js";
+import { toArray } from "../../utils/format.js";
+import { matchModules, matchRoute, match404Route, parseQuery, wrapWithLayouts, runBeforeEachGuards, runAfterEachGuards, runBeforeEnterHooks, } from "../utils/index.js";
+import { RouterContext, RequestContext } from "../context.js";
+import { createStatefulPromise } from "../../utils/promise.js";
+import { PAGE_DATA_PROMISE_ID } from "../constants.js";
+export async function render(url, ctx) {
+    const extName = path.extname(url);
+    if (extName && extName.length > 0) {
+        return { httpResponse: null };
+    }
+    else if (url.startsWith("/@")) {
+        return { httpResponse: null };
+    }
+    const u = new URL(url, "http://localhost");
+    const pathSegments = u.pathname.split("/").filter(Boolean);
+    let routeMatch = matchRoute(ctx.pages, pathSegments);
+    if (!routeMatch) {
+        // Try to find a 404 page in parent directories
+        const fourOhFourMatch = match404Route(ctx.pages, pathSegments);
+        if (fourOhFourMatch) {
+            routeMatch = fourOhFourMatch;
+        }
+        else {
+            // Fallback to root 404 or default fallback
+            if (url === "/404") {
+                if (__DEV__) {
+                    console.warn("[kiru/router]: No 404 route defined. Using fallback 404 page.");
+                }
+                return {
+                    httpResponse: {
+                        statusCode: 404,
+                        headers: [["Content-Type", "text/html"]],
+                        html: "<!doctype html><html><head><title>Not Found</title></head><body><h1>404</h1></body></html>",
+                        stream: null,
+                    },
+                };
+            }
+            // Recursively render the 404 page
+            const notFoundResponse = await render("/404", ctx);
+            return {
+                httpResponse: {
+                    html: notFoundResponse.httpResponse?.html ?? "",
+                    headers: notFoundResponse.httpResponse?.headers ?? [
+                        ["Content-Type", "text/html"],
+                    ],
+                    ...notFoundResponse,
+                    statusCode: 404,
+                    stream: null,
+                },
+            };
+        }
+    }
+    const { pageEntry, routeSegments, params } = routeMatch;
+    const is404Route = routeMatch.routeSegments.includes("404");
+    const guardEntries = matchModules(ctx.guards, routeSegments);
+    const guardModules = await Promise.all(guardEntries.map((entry) => entry.load()));
+    const redirectPath = await runBeforeEachGuards(guardModules, { ...ctx.userContext }, u.pathname);
+    if (redirectPath !== null) {
+        return createRedirectResult(redirectPath);
+    }
+    const layoutEntries = matchModules(ctx.layouts, routeSegments);
+    [pageEntry, ...layoutEntries].forEach((e) => {
+        ctx.registerModule(e.filePath);
+    });
+    const [page, ...layouts] = await Promise.all([
+        pageEntry.load(),
+        ...layoutEntries.map((layoutEntry) => layoutEntry.load()),
+    ]);
+    const onBeforeEnter = page.config?.hooks?.onBeforeEnter;
+    if (onBeforeEnter) {
+        const redirectPath = await runBeforeEnterHooks(toArray(onBeforeEnter), { ...ctx.userContext }, u.pathname);
+        if (redirectPath !== null) {
+            return createRedirectResult(redirectPath);
+        }
+    }
+    let documentShell = renderToString(createElement(ctx.Document));
+    if (documentShell.includes("</body>") ||
+        !documentShell.includes("<kiru-body-outlet>")) {
+        throw new Error("[kiru/router]: Document is expected to contain a <Body.Outlet> element. See https://kirujs.dev/docs/api/file-router#general-usage");
+    }
+    const query = parseQuery(u.search);
+    let props = {};
+    const config = page.config ?? {};
+    const abortSignal = new AbortController().signal;
+    const routerState = {
+        params,
+        query,
+        pathname: u.pathname,
+        hash: "",
+        signal: abortSignal,
+    };
+    let pageDataPromise = null;
+    if (config.loader && !config.loader.static) {
+        props = {
+            data: null,
+            error: null,
+            loading: true,
+        };
+        const promise = config.loader.load({
+            ...routerState,
+            context: { ...ctx.userContext },
+        });
+        pageDataPromise = createStatefulPromise(PAGE_DATA_PROMISE_ID, promise);
+    }
+    const children = wrapWithLayouts(layouts
+        .map((layout) => layout.default)
+        .filter((l) => typeof l === "function"), page.default, props);
+    const app = createElement(RouterContext.Provider, {
+        children: createElement(RequestContext.Provider, {
+            children: Fragment({ children }),
+            value: ctx.userContext,
+        }),
+        value: { state: routerState },
+    });
+    let { immediate: pageOutletContent, stream } = renderToReadableStream(app, {
+        data: pageDataPromise ? [pageDataPromise] : [],
+    });
+    const hasHeadContent = pageOutletContent.includes("<kiru-head-content>");
+    const hasHeadOutlet = documentShell.includes("<kiru-head-outlet>");
+    if (hasHeadOutlet && hasHeadContent) {
+        let [preHeadContent = "", headContentInner = "", postHeadContent = ""] = pageOutletContent.split(/<kiru-head-content>|<\/kiru-head-content>/);
+        documentShell = documentShell.replace("<kiru-head-outlet>", headContentInner);
+        pageOutletContent = `${preHeadContent}${postHeadContent}`;
+    }
+    else if (hasHeadContent) {
+        // remove head content element and everything within it
+        pageOutletContent = pageOutletContent.replace(/<kiru-head-content>(.*?)<\/kiru-head-content>/, "");
+    }
+    else if (hasHeadOutlet) {
+        // remove head outlet element and everything within it
+        documentShell = documentShell.replaceAll("<kiru-head-outlet>", "");
+    }
+    const [prePageOutlet, postPageOutlet] = documentShell.split("<kiru-body-outlet>");
+    const html = `<!DOCTYPE html>${prePageOutlet}<body>${pageOutletContent}</body>${postPageOutlet}`;
+    const statusCode = is404Route ? 404 : 200;
+    queueMicrotask(() => {
+        runAfterEachGuards(guardModules, { ...ctx.userContext }, u.pathname);
+    });
+    return {
+        httpResponse: {
+            html,
+            statusCode,
+            headers: [["Content-Type", "text/html;charset=utf-8"]],
+            stream,
+        },
+    };
+}
+function createRedirectResult(to) {
+    return {
+        httpResponse: {
+            statusCode: 302,
+            headers: [["Location", to]],
+            html: "",
+            stream: null,
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/router/ssr/index.js.map

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

package/dist/router/types.d.ts

@@ -1,11 +1,13 @@
 import type { AsyncTaskState } from "../types.utils";
 import type { FileRouterDataLoadError } from "./errors";
-import type { DefaultComponentModule, FormattedViteImportMap, PageModule } from "./types.internal";
+import type { DefaultComponentModule, FormattedViteImportMap, GuardModule, PageModule } from "./types.internal";
 export interface FileRouterPreloadConfig {
-    pages: FormattedViteImportMap;
+    pages: FormattedViteImportMap<PageModule>;
     layouts: FormattedViteImportMap;
+    guards?: FormattedViteImportMap<GuardModule>;
     page: PageModule;
     pageProps: Record<string, unknown>;
+    pagePropsPromise?: Promise<AsyncTaskState<unknown, FileRouterDataLoadError>>;
     pageLayouts: DefaultComponentModule[];
     params: RouteParams;
     query: RouteQuery;
@@ -36,6 +38,14 @@ export interface FileRouterConfig {
      * ```
      */
     layouts: Record<string, unknown>;
+    /**
+     * The import map to use for loading nav guards
+     * @example
+     * ```tsx
+     * <FileRouter config={{ guards: import.meta.glob("/∗∗/guard.{ts,js}"), ... }} />
+     * ```
+     */
+    guards?: Record<string, unknown>;
     /**
      * The base url to use as a prefix for route matching
      * @default "/"
@@ -87,25 +97,37 @@ export interface RouterState {
      */
     signal: AbortSignal;
 }
-type PageDataLoaderContext = RouterState & {};
 export interface PageDataLoaderCacheConfig {
     type: "memory" | "localStorage" | "sessionStorage";
     ttl: number;
 }
+interface LoaderContext extends RouterState {
+    /**
+     * The request context - in SSR, this is the data from the server
+     * that's passed to the `renderPage` function
+     * @example
+     * ```ts
+     * // server.ts
+     * renderPage({ url, context: { test: 123 } })
+     *
+     * // page.tsx
+     * loader: {
+     *   load: ({ context }) => context.test
+     * }
+     * ```
+     */
+    context: Kiru.RequestContext;
+}
 export type PageDataLoaderConfig<T = unknown> = {
     /**
      * The function to load the page data
      */
-    load: (context: PageDataLoaderContext) => Promise<T>;
+    load: (context: LoaderContext) => Promise<T>;
 } & ({
     /**
-     * The mode to use for the page data loader
-     * @default "client"
-     * @description
-     * - **static**: The page data is loaded at build time and never updated
-     * - **client**: The page data is loaded upon navigation and updated on subsequent navigations
+     * Indicates that the page data should only be loaded at build time
      */
-    mode?: "client";
+    static?: false;
     /**
      * Enable transitions when swapping between "load", "error" and "data" states
      */
@@ -123,14 +145,17 @@ export type PageDataLoaderConfig<T = unknown> = {
     cache?: PageDataLoaderCacheConfig;
 } | {
     /**
-     * The mode to use for the page data loader
-     * @default "client"
-     * @description
-     * - **static**: The page data is loaded at build time and never updated
-     * - **client**: The page data is loaded upon navigation and updated on subsequent navigations
+     * Indicates that the page data should only be loaded at build time
      */
-    mode: "static";
+    static: true;
 });
+export type NavigationHook<T> = (context: Kiru.RequestContext, to: string, from: string) => T;
+export type OnBeforeEnterHook = NavigationHook<string | void | Promise<string | void>>;
+export type OnBeforeLeaveHook = NavigationHook<false | void>;
+interface PageContextHooks {
+    onBeforeEnter?: OnBeforeEnterHook | OnBeforeEnterHook[];
+    onBeforeLeave?: OnBeforeLeaveHook | OnBeforeLeaveHook[];
+}
 export interface PageConfig<T = unknown> {
     /**
      * The loader configuration for this page
@@ -141,6 +166,7 @@ export interface PageConfig<T = unknown> {
      * returned, a page will be generated
      */
     generateStaticParams?: () => RouteParams[] | Promise<RouteParams[]>;
+    hooks?: PageContextHooks;
 }
 export type PageProps<T extends PageConfig<any>> = T extends PageConfig<infer U> ? AsyncTaskState<U, FileRouterDataLoadError> : {};
 export {};

package/dist/router/types.d.ts.map

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

package/dist/router/types.internal.d.ts

@@ -1,5 +1,6 @@
 import type { FileRouterContextType } from "./context";
 import type { PageConfig } from "./types";
+import type { NavGuardBuilder } from "./guard";
 export interface CurrentPage {
     component: Kiru.FC<any>;
     config?: PageConfig;
@@ -16,6 +17,9 @@ export interface PageModule {
         error: string | null;
     }>;
 }
+export interface GuardModule {
+    guard: NavGuardBuilder;
+}
 export interface ViteImportMap {
     [fp: string]: () => Promise<DefaultComponentModule>;
 }

package/dist/router/types.internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.internal.d.ts","sourceRoot":"","sources":["../../src/router/types.internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACvB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,IAAI,CAAC,EAAE,CAAA;IAChB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,qBAAqB,CAAC,EAAE,MAAM,CAC5B,MAAM,EACN;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CACxC,CAAA;CACF;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,2BAA2B,CAAC,CAAC,GAAG,sBAAsB;IACrE,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAA;IACtB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,sBAAsB;IAChE,CAAC,GAAG,EAAE,MAAM,GAAG,2BAA2B,CAAC,CAAC,CAAC,CAAA;CAC9C;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAA;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,sBAAsB,CAAC,UAAU,CAAC,CAAA;IAClD,UAAU,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAA;IAC/C,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAA;IAC3C,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IACvC,SAAS,EAAE,CACT,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,KACnE,MAAM,IAAI,CAAA;CAChB"}
+{"version":3,"file":"types.internal.d.ts","sourceRoot":"","sources":["../../src/router/types.internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACvB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,IAAI,CAAC,EAAE,CAAA;IAChB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,qBAAqB,CAAC,EAAE,MAAM,CAC5B,MAAM,EACN;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CACxC,CAAA;CACF;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,eAAe,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,2BAA2B,CAAC,CAAC,GAAG,sBAAsB;IACrE,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAA;IACtB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,sBAAsB;IAChE,CAAC,GAAG,EAAE,MAAM,GAAG,2BAA2B,CAAC,CAAC,CAAC,CAAA;CAC9C;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAA;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,sBAAsB,CAAC,UAAU,CAAC,CAAA;IAClD,UAAU,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAA;IAC/C,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAA;IAC3C,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IACvC,SAAS,EAAE,CACT,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,KACnE,MAAM,IAAI,CAAA;CAChB"}