@askrjs/askr 0.0.47 → 0.0.49

package/dist/router/policy.js

@@ -1,6 +1,7 @@
 import { isPromiseLike } from "../common/promise.js";
 //#region src/router/policy.ts
 const ROUTE_AUTH_OPTIONS = Symbol.for("__ASKR_ROUTE_AUTH_OPTIONS__");
+const BUILT_IN_ROUTE_POLICY = Symbol.for("__ASKR_BUILT_IN_ROUTE_POLICY__");
 function allow() {
 	return { kind: "allow" };
 }
@@ -44,6 +45,17 @@ function assertRouteAuthOptions(context) {
 	if (!auth?.resolve) throw new Error("Built-in auth policies require router auth configuration. Provide `auth` to registerRoutes(...), createSPA(...), hydrateSPA(...), or SSR route resolution.");
 	return auth;
 }
+function markBuiltInRoutePolicy(policy, metadata) {
+	Object.defineProperty(policy, BUILT_IN_ROUTE_POLICY, {
+		value: Object.freeze({ ...metadata }),
+		enumerable: false,
+		configurable: false
+	});
+	return policy;
+}
+function _getBuiltInRoutePolicy(policy) {
+	return policy[BUILT_IN_ROUTE_POLICY] ?? null;
+}
 function resolvePathSetting(value, fallback, context) {
 	if (!value) return fallback;
 	if (typeof value === "function") return value(context);
@@ -79,36 +91,42 @@ function resolveAuthenticatedRedirect(context) {
 	return redirect(target, { replace: true });
 }
 function requireAuth() {
-	return (context) => {
+	return markBuiltInRoutePolicy((context) => {
 		if (context.session) return allow();
 		return resolveUnauthenticatedRedirect(context);
-	};
+	}, { kind: "auth" });
 }
 function requireGuest() {
-	return (context) => {
+	return markBuiltInRoutePolicy((context) => {
 		if (!context.session) return allow();
 		return resolveAuthenticatedRedirect(context);
-	};
+	}, { kind: "guest" });
 }
 function requireRole(role) {
-	return (context) => {
+	return markBuiltInRoutePolicy((context) => {
 		if (!context.user) return resolveUnauthenticatedRedirect(context);
 		const auth = assertRouteAuthOptions(context);
 		const hasRole = auth.hasRole ? auth.hasRole(context.user, role, context) : defaultHasRole(context.user, role);
 		if (isPromiseLike(hasRole)) return Promise.resolve(hasRole).then((next) => next ? allow() : forbidden());
 		return hasRole ? allow() : forbidden();
-	};
+	}, {
+		kind: "role",
+		value: role
+	});
 }
 function requirePermission(permission) {
-	return (context) => {
+	return markBuiltInRoutePolicy((context) => {
 		if (!context.user) return resolveUnauthenticatedRedirect(context);
 		const auth = assertRouteAuthOptions(context);
 		const hasPermission = auth.hasPermission ? auth.hasPermission(context.user, permission, context) : defaultHasPermission(context.user, permission);
 		if (isPromiseLike(hasPermission)) return Promise.resolve(hasPermission).then((next) => next ? allow() : forbidden());
 		return hasPermission ? allow() : forbidden();
-	};
+	}, {
+		kind: "permission",
+		value: permission
+	});
 }
 //#endregion
-export { allow, deny, forbidden, notFound, redirect, requireAuth, requireGuest, requirePermission, requireRole, unauthorized, withRouteAuthOptions };
+export { _getBuiltInRoutePolicy, allow, deny, forbidden, notFound, redirect, requireAuth, requireGuest, requirePermission, requireRole, unauthorized, withRouteAuthOptions };
 
 //# sourceMappingURL=policy.js.map

package/dist/router/policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"policy.js","names":[],"sources":["../../src/router/policy.ts"],"sourcesContent":["import type {\n  AccessDecision,\n  AccessAllowDecision,\n  AccessDenyDecision,\n  AccessDenyStatus,\n  AccessRedirectDecision,\n  AccessRedirectStatus,\n  RouteAuthOptions,\n  RouteContext,\n  RoutePolicy,\n} from '../common/router';\nimport { isPromiseLike } from '../common/promise';\n\nconst ROUTE_AUTH_OPTIONS = Symbol.for('__ASKR_ROUTE_AUTH_OPTIONS__');\n\ntype InternalRouteContext = RouteContext & {\n  [ROUTE_AUTH_OPTIONS]?: RouteAuthOptions;\n};\n\ntype RoutePathResolver =\n  | string\n  | ((context: RouteContext) => string | PromiseLike<string>);\n\nexport function allow(): AccessAllowDecision {\n  return { kind: 'allow' };\n}\n\nexport function redirect(\n  to: string,\n  init: {\n    status?: AccessRedirectStatus;\n    replace?: boolean;\n  } = {}\n): AccessRedirectDecision {\n  return {\n    kind: 'redirect',\n    to,\n    ...(init.status ? { status: init.status } : {}),\n    ...(init.replace !== undefined ? { replace: init.replace } : {}),\n  };\n}\n\nexport function deny(status: AccessDenyStatus): AccessDenyDecision {\n  return { kind: 'deny', status };\n}\n\nexport function unauthorized(): AccessDenyDecision {\n  return deny(401);\n}\n\nexport function forbidden(): AccessDenyDecision {\n  return deny(403);\n}\n\nexport function notFound(): AccessDenyDecision {\n  return deny(404);\n}\n\nexport function normalizeAccessDecision(\n  result: AccessDecision\n): AccessDecision {\n  return result;\n}\n\nexport function withRouteAuthOptions(\n  context: RouteContext,\n  auth: RouteAuthOptions | undefined\n): RouteContext {\n  const internal = context as InternalRouteContext;\n\n  if (!auth) {\n    delete internal[ROUTE_AUTH_OPTIONS];\n    return context;\n  }\n\n  internal[ROUTE_AUTH_OPTIONS] = auth;\n  return context;\n}\n\nfunction getRouteAuthOptions(\n  context: RouteContext\n): RouteAuthOptions | undefined {\n  return (context as InternalRouteContext)[ROUTE_AUTH_OPTIONS];\n}\n\nfunction assertRouteAuthOptions(context: RouteContext): RouteAuthOptions {\n  const auth = getRouteAuthOptions(context);\n  if (!auth?.resolve) {\n    throw new Error(\n      'Built-in auth policies require router auth configuration. ' +\n        'Provide `auth` to registerRoutes(...), createSPA(...), hydrateSPA(...), or SSR route resolution.'\n    );\n  }\n\n  return auth;\n}\n\nfunction resolvePathSetting(\n  value: RoutePathResolver | undefined,\n  fallback: string,\n  context: RouteContext\n): string | PromiseLike<string> {\n  if (!value) {\n    return fallback;\n  }\n\n  if (typeof value === 'function') {\n    return value(context);\n  }\n\n  return value;\n}\n\nfunction appendNextTarget(path: string, href: string): string {\n  const resolved = new URL(path, 'http://localhost');\n  resolved.searchParams.set('next', href);\n  return `${resolved.pathname}${resolved.search}${resolved.hash}`;\n}\n\nfunction collectStringValues(value: unknown): string[] {\n  if (typeof value === 'string') {\n    return [value];\n  }\n\n  if (Array.isArray(value)) {\n    return value.filter((entry): entry is string => typeof entry === 'string');\n  }\n\n  if (value instanceof Set) {\n    return Array.from(value).filter(\n      (entry): entry is string => typeof entry === 'string'\n    );\n  }\n\n  return [];\n}\n\nfunction defaultHasRole(user: unknown, role: string): boolean {\n  if (!user || typeof user !== 'object') {\n    return false;\n  }\n\n  return collectStringValues((user as { roles?: unknown }).roles).includes(\n    role\n  );\n}\n\nfunction defaultHasPermission(user: unknown, permission: string): boolean {\n  if (!user || typeof user !== 'object') {\n    return false;\n  }\n\n  return collectStringValues(\n    (user as { permissions?: unknown }).permissions\n  ).includes(permission);\n}\n\nfunction resolveUnauthenticatedRedirect(\n  context: RouteContext\n): AccessDecision | Promise<AccessDecision> {\n  const auth = assertRouteAuthOptions(context);\n  const loginPath = resolvePathSetting(auth.loginPath, '/login', context);\n  if (isPromiseLike<string>(loginPath)) {\n    return Promise.resolve(loginPath).then((nextPath) =>\n      redirect(appendNextTarget(nextPath, context.href), {\n        replace: context.mode === 'spa',\n      })\n    );\n  }\n\n  return redirect(appendNextTarget(loginPath, context.href), {\n    replace: context.mode === 'spa',\n  });\n}\n\nfunction resolveAuthenticatedRedirect(\n  context: RouteContext\n): AccessDecision | Promise<AccessDecision> {\n  const auth = assertRouteAuthOptions(context);\n  const target = resolvePathSetting(auth.guestRedirectTo, '/', context);\n  if (isPromiseLike<string>(target)) {\n    return Promise.resolve(target).then((nextTarget) =>\n      redirect(nextTarget, {\n        replace: true,\n      })\n    );\n  }\n\n  return redirect(target, {\n    replace: true,\n  });\n}\n\nexport function requireAuth(): RoutePolicy {\n  return (context) => {\n    if (context.session) {\n      return allow();\n    }\n\n    return resolveUnauthenticatedRedirect(context);\n  };\n}\n\nexport function requireGuest(): RoutePolicy {\n  return (context) => {\n    if (!context.session) {\n      return allow();\n    }\n\n    return resolveAuthenticatedRedirect(context);\n  };\n}\n\nexport function requireRole(role: string): RoutePolicy {\n  return (context) => {\n    if (!context.user) {\n      return resolveUnauthenticatedRedirect(context);\n    }\n\n    const auth = assertRouteAuthOptions(context);\n    const hasRole = auth.hasRole\n      ? auth.hasRole(context.user, role, context)\n      : defaultHasRole(context.user, role);\n\n    if (isPromiseLike<boolean>(hasRole)) {\n      return Promise.resolve(hasRole).then((next) =>\n        next ? allow() : forbidden()\n      );\n    }\n\n    return hasRole ? allow() : forbidden();\n  };\n}\n\nexport function requirePermission(permission: string): RoutePolicy {\n  return (context) => {\n    if (!context.user) {\n      return resolveUnauthenticatedRedirect(context);\n    }\n\n    const auth = assertRouteAuthOptions(context);\n    const hasPermission = auth.hasPermission\n      ? auth.hasPermission(context.user, permission, context)\n      : defaultHasPermission(context.user, permission);\n\n    if (isPromiseLike<boolean>(hasPermission)) {\n      return Promise.resolve(hasPermission).then((next) =>\n        next ? allow() : forbidden()\n      );\n    }\n\n    return hasPermission ? allow() : forbidden();\n  };\n}\n\nexport async function evaluateRoutePolicy(\n  policy: RoutePolicy,\n  context: RouteContext\n): Promise<AccessDecision> {\n  const result = await policy(context);\n  return result;\n}\n"],"mappings":"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"}
+{"version":3,"file":"policy.js","names":[],"sources":["../../src/router/policy.ts"],"sourcesContent":["import type {\n  AccessDecision,\n  AccessAllowDecision,\n  AccessDenyDecision,\n  AccessDenyStatus,\n  AccessRedirectDecision,\n  AccessRedirectStatus,\n  RouteAuthOptions,\n  RouteContext,\n  RoutePolicy,\n} from '../common/router';\nimport { isPromiseLike } from '../common/promise';\n\nconst ROUTE_AUTH_OPTIONS = Symbol.for('__ASKR_ROUTE_AUTH_OPTIONS__');\nconst BUILT_IN_ROUTE_POLICY = Symbol.for('__ASKR_BUILT_IN_ROUTE_POLICY__');\n\ntype InternalRouteContext = RouteContext & {\n  [ROUTE_AUTH_OPTIONS]?: RouteAuthOptions;\n};\n\nexport type BuiltInRoutePolicyKind = 'auth' | 'guest' | 'role' | 'permission';\n\nexport interface BuiltInRoutePolicyMetadata {\n  kind: BuiltInRoutePolicyKind;\n  value?: string;\n}\n\ntype InternalRoutePolicy = RoutePolicy & {\n  [BUILT_IN_ROUTE_POLICY]?: BuiltInRoutePolicyMetadata;\n};\n\ntype RoutePathResolver =\n  | string\n  | ((context: RouteContext) => string | PromiseLike<string>);\n\nexport function allow(): AccessAllowDecision {\n  return { kind: 'allow' };\n}\n\nexport function redirect(\n  to: string,\n  init: {\n    status?: AccessRedirectStatus;\n    replace?: boolean;\n  } = {}\n): AccessRedirectDecision {\n  return {\n    kind: 'redirect',\n    to,\n    ...(init.status ? { status: init.status } : {}),\n    ...(init.replace !== undefined ? { replace: init.replace } : {}),\n  };\n}\n\nexport function deny(status: AccessDenyStatus): AccessDenyDecision {\n  return { kind: 'deny', status };\n}\n\nexport function unauthorized(): AccessDenyDecision {\n  return deny(401);\n}\n\nexport function forbidden(): AccessDenyDecision {\n  return deny(403);\n}\n\nexport function notFound(): AccessDenyDecision {\n  return deny(404);\n}\n\nexport function normalizeAccessDecision(\n  result: AccessDecision\n): AccessDecision {\n  return result;\n}\n\nexport function withRouteAuthOptions(\n  context: RouteContext,\n  auth: RouteAuthOptions | undefined\n): RouteContext {\n  const internal = context as InternalRouteContext;\n\n  if (!auth) {\n    delete internal[ROUTE_AUTH_OPTIONS];\n    return context;\n  }\n\n  internal[ROUTE_AUTH_OPTIONS] = auth;\n  return context;\n}\n\nfunction getRouteAuthOptions(\n  context: RouteContext\n): RouteAuthOptions | undefined {\n  return (context as InternalRouteContext)[ROUTE_AUTH_OPTIONS];\n}\n\nfunction assertRouteAuthOptions(context: RouteContext): RouteAuthOptions {\n  const auth = getRouteAuthOptions(context);\n  if (!auth?.resolve) {\n    throw new Error(\n      'Built-in auth policies require router auth configuration. ' +\n        'Provide `auth` to registerRoutes(...), createSPA(...), hydrateSPA(...), or SSR route resolution.'\n    );\n  }\n\n  return auth;\n}\n\nfunction markBuiltInRoutePolicy(\n  policy: RoutePolicy,\n  metadata: BuiltInRoutePolicyMetadata\n): RoutePolicy {\n  Object.defineProperty(policy, BUILT_IN_ROUTE_POLICY, {\n    value: Object.freeze({ ...metadata }),\n    enumerable: false,\n    configurable: false,\n  });\n  return policy;\n}\n\nexport function _getBuiltInRoutePolicy(\n  policy: RoutePolicy\n): BuiltInRoutePolicyMetadata | null {\n  return (policy as InternalRoutePolicy)[BUILT_IN_ROUTE_POLICY] ?? null;\n}\n\nfunction resolvePathSetting(\n  value: RoutePathResolver | undefined,\n  fallback: string,\n  context: RouteContext\n): string | PromiseLike<string> {\n  if (!value) {\n    return fallback;\n  }\n\n  if (typeof value === 'function') {\n    return value(context);\n  }\n\n  return value;\n}\n\nfunction appendNextTarget(path: string, href: string): string {\n  const resolved = new URL(path, 'http://localhost');\n  resolved.searchParams.set('next', href);\n  return `${resolved.pathname}${resolved.search}${resolved.hash}`;\n}\n\nfunction collectStringValues(value: unknown): string[] {\n  if (typeof value === 'string') {\n    return [value];\n  }\n\n  if (Array.isArray(value)) {\n    return value.filter((entry): entry is string => typeof entry === 'string');\n  }\n\n  if (value instanceof Set) {\n    return Array.from(value).filter(\n      (entry): entry is string => typeof entry === 'string'\n    );\n  }\n\n  return [];\n}\n\nfunction defaultHasRole(user: unknown, role: string): boolean {\n  if (!user || typeof user !== 'object') {\n    return false;\n  }\n\n  return collectStringValues((user as { roles?: unknown }).roles).includes(\n    role\n  );\n}\n\nfunction defaultHasPermission(user: unknown, permission: string): boolean {\n  if (!user || typeof user !== 'object') {\n    return false;\n  }\n\n  return collectStringValues(\n    (user as { permissions?: unknown }).permissions\n  ).includes(permission);\n}\n\nfunction resolveUnauthenticatedRedirect(\n  context: RouteContext\n): AccessDecision | Promise<AccessDecision> {\n  const auth = assertRouteAuthOptions(context);\n  const loginPath = resolvePathSetting(auth.loginPath, '/login', context);\n  if (isPromiseLike<string>(loginPath)) {\n    return Promise.resolve(loginPath).then((nextPath) =>\n      redirect(appendNextTarget(nextPath, context.href), {\n        replace: context.mode === 'spa',\n      })\n    );\n  }\n\n  return redirect(appendNextTarget(loginPath, context.href), {\n    replace: context.mode === 'spa',\n  });\n}\n\nfunction resolveAuthenticatedRedirect(\n  context: RouteContext\n): AccessDecision | Promise<AccessDecision> {\n  const auth = assertRouteAuthOptions(context);\n  const target = resolvePathSetting(auth.guestRedirectTo, '/', context);\n  if (isPromiseLike<string>(target)) {\n    return Promise.resolve(target).then((nextTarget) =>\n      redirect(nextTarget, {\n        replace: true,\n      })\n    );\n  }\n\n  return redirect(target, {\n    replace: true,\n  });\n}\n\nexport function requireAuth(): RoutePolicy {\n  return markBuiltInRoutePolicy(\n    (context) => {\n      if (context.session) {\n        return allow();\n      }\n\n      return resolveUnauthenticatedRedirect(context);\n    },\n    { kind: 'auth' }\n  );\n}\n\nexport function requireGuest(): RoutePolicy {\n  return markBuiltInRoutePolicy(\n    (context) => {\n      if (!context.session) {\n        return allow();\n      }\n\n      return resolveAuthenticatedRedirect(context);\n    },\n    { kind: 'guest' }\n  );\n}\n\nexport function requireRole(role: string): RoutePolicy {\n  return markBuiltInRoutePolicy(\n    (context) => {\n      if (!context.user) {\n        return resolveUnauthenticatedRedirect(context);\n      }\n\n      const auth = assertRouteAuthOptions(context);\n      const hasRole = auth.hasRole\n        ? auth.hasRole(context.user, role, context)\n        : defaultHasRole(context.user, role);\n\n      if (isPromiseLike<boolean>(hasRole)) {\n        return Promise.resolve(hasRole).then((next) =>\n          next ? allow() : forbidden()\n        );\n      }\n\n      return hasRole ? allow() : forbidden();\n    },\n    { kind: 'role', value: role }\n  );\n}\n\nexport function requirePermission(permission: string): RoutePolicy {\n  return markBuiltInRoutePolicy(\n    (context) => {\n      if (!context.user) {\n        return resolveUnauthenticatedRedirect(context);\n      }\n\n      const auth = assertRouteAuthOptions(context);\n      const hasPermission = auth.hasPermission\n        ? auth.hasPermission(context.user, permission, context)\n        : defaultHasPermission(context.user, permission);\n\n      if (isPromiseLike<boolean>(hasPermission)) {\n        return Promise.resolve(hasPermission).then((next) =>\n          next ? allow() : forbidden()\n        );\n      }\n\n      return hasPermission ? allow() : forbidden();\n    },\n    { kind: 'permission', value: permission }\n  );\n}\n\nexport async function evaluateRoutePolicy(\n  policy: RoutePolicy,\n  context: RouteContext\n): Promise<AccessDecision> {\n  const result = await policy(context);\n  return result;\n}\n"],"mappings":"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"}

package/dist/router/rendering.d.ts

@@ -0,0 +1,10 @@
+import { JSXElement } from "../common/jsx.js";
+import { LayoutScopeRecord, PageScopeRecord, RouteComponent, RouteHandler, RouteRecord } from "../common/router.js";
+
+//#region src/router/rendering.d.ts
+declare function Outlet(): JSXElement;
+declare function createRouteHandler(component: RouteComponent, pageChain: readonly PageScopeRecord[], layoutChain: readonly LayoutScopeRecord[], deferComponents?: boolean): RouteHandler;
+declare function getRenderHandler(record: RouteRecord): RouteHandler;
+//#endregion
+export { Outlet };
+//# sourceMappingURL=rendering.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rendering.d.ts","names":[],"sources":["../../src/router/rendering.ts"],"mappings":";;;;iBAegB,MAAA,IAAU,UAAU;AAAA,iBA2CpB,kBAAA,CACd,SAAA,EAAW,cAAA,EACX,SAAA,WAAoB,eAAA,IACpB,WAAA,WAAsB,iBAAA,IACtB,eAAA,aACC,YAAA;AAAA,iBAgBa,gBAAA,CAAiB,MAAA,EAAQ,WAAA,GAAc,YAAY"}

package/dist/router/rendering.js

@@ -0,0 +1,45 @@
+import { ELEMENT_TYPE, Fragment } from "../common/jsx.js";
+import { defineContext, readContext } from "../runtime/context.js";
+import { ROUTE_ROOT_COMPONENT } from "../common/router-internal.js";
+//#region src/router/rendering.ts
+const outletContext = defineContext(null);
+function Outlet() {
+	return {
+		$$typeof: ELEMENT_TYPE,
+		type: Fragment,
+		props: { children: readContext(outletContext) },
+		key: null
+	};
+}
+function applyPageChain(pageChain, params, content, deferComponents = false) {
+	let nextContent = content;
+	for (let i = pageChain.length - 1; i >= 0; i--) nextContent = outletContext.Scope({
+		value: nextContent,
+		children: deferComponents ? createRouteComponentVNode(pageChain[i].component, params) : pageChain[i].component(params)
+	});
+	return nextContent;
+}
+function createRouteComponentVNode(component, params, routeRoot = false) {
+	return {
+		$$typeof: ELEMENT_TYPE,
+		type: component,
+		props: params,
+		key: null,
+		...routeRoot ? { [ROUTE_ROOT_COMPONENT]: true } : {}
+	};
+}
+function createRouteHandler(component, pageChain, layoutChain, deferComponents = false) {
+	return (params) => {
+		let content = deferComponents ? createRouteComponentVNode(component, params, true) : component(params);
+		content = applyPageChain(pageChain, params, content, deferComponents);
+		for (let i = layoutChain.length - 1; i >= 0; i--) content = layoutChain[i].component({ children: content });
+		return content;
+	};
+}
+function getRenderHandler(record) {
+	return record.renderHandler ?? createRouteHandler(record.component, record.pageChain, record.layoutChain, true);
+}
+//#endregion
+export { Outlet, createRouteHandler, getRenderHandler };
+
+//# sourceMappingURL=rendering.js.map

package/dist/router/rendering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendering.js","names":[],"sources":["../../src/router/rendering.ts"],"sourcesContent":["import { ELEMENT_TYPE, Fragment, type JSXElement } from '../common/jsx';\nimport type {\n  LayoutScopeRecord,\n  PageScopeRecord,\n  RouteComponent,\n  RouteHandler,\n  RouteRecord,\n} from '../common/router';\nimport { ROUTE_ROOT_COMPONENT } from '../common/router-internal';\nimport type { RenderableChild } from '../common/vnode';\nimport { defineContext, readContext } from '../runtime/context';\nimport type { InternalRouteRecord } from './internal-types';\n\nconst outletContext = defineContext<RenderableChild>(null);\n\nexport function Outlet(): JSXElement {\n  return {\n    $$typeof: ELEMENT_TYPE,\n    type: Fragment,\n    props: { children: readContext(outletContext) },\n    key: null,\n  };\n}\n\nfunction applyPageChain(\n  pageChain: readonly PageScopeRecord[],\n  params: Record<string, string>,\n  content: RenderableChild,\n  deferComponents = false\n): RenderableChild {\n  let nextContent = content;\n\n  for (let i = pageChain.length - 1; i >= 0; i--) {\n    nextContent = outletContext.Scope({\n      value: nextContent,\n      children: deferComponents\n        ? createRouteComponentVNode(pageChain[i].component, params)\n        : pageChain[i].component(params),\n    });\n  }\n\n  return nextContent;\n}\n\nfunction createRouteComponentVNode(\n  component: RouteComponent,\n  params: Record<string, string>,\n  routeRoot = false\n): RenderableChild {\n  return {\n    $$typeof: ELEMENT_TYPE,\n    type: component,\n    props: params,\n    key: null,\n    ...(routeRoot ? { [ROUTE_ROOT_COMPONENT]: true } : {}),\n  };\n}\n\nexport function createRouteHandler(\n  component: RouteComponent,\n  pageChain: readonly PageScopeRecord[],\n  layoutChain: readonly LayoutScopeRecord[],\n  deferComponents = false\n): RouteHandler {\n  return (params) => {\n    let content = deferComponents\n      ? createRouteComponentVNode(component, params, true)\n      : component(params);\n\n    content = applyPageChain(pageChain, params, content, deferComponents);\n\n    for (let i = layoutChain.length - 1; i >= 0; i--) {\n      content = layoutChain[i].component({ children: content });\n    }\n\n    return content;\n  };\n}\n\nexport function getRenderHandler(record: RouteRecord): RouteHandler {\n  const internalRecord = record as InternalRouteRecord;\n  return (\n    internalRecord.renderHandler ??\n    createRouteHandler(\n      record.component,\n      record.pageChain,\n      record.layoutChain,\n      true\n    )\n  );\n}\n"],"mappings":";;;;AAaA,MAAM,gBAAgB,cAA+B,IAAI;AAEzD,SAAgB,SAAqB;CACnC,OAAO;EACL,UAAU;EACV,MAAM;EACN,OAAO,EAAE,UAAU,YAAY,aAAa,EAAE;EAC9C,KAAK;CACP;AACF;AAEA,SAAS,eACP,WACA,QACA,SACA,kBAAkB,OACD;CACjB,IAAI,cAAc;CAElB,KAAK,IAAI,IAAI,UAAU,SAAS,GAAG,KAAK,GAAG,KACzC,cAAc,cAAc,MAAM;EAChC,OAAO;EACP,UAAU,kBACN,0BAA0B,UAAU,EAAE,CAAC,WAAW,MAAM,IACxD,UAAU,EAAE,CAAC,UAAU,MAAM;CACnC,CAAC;CAGH,OAAO;AACT;AAEA,SAAS,0BACP,WACA,QACA,YAAY,OACK;CACjB,OAAO;EACL,UAAU;EACV,MAAM;EACN,OAAO;EACP,KAAK;EACL,GAAI,YAAY,GAAG,uBAAuB,KAAK,IAAI,CAAC;CACtD;AACF;AAEA,SAAgB,mBACd,WACA,WACA,aACA,kBAAkB,OACJ;CACd,QAAQ,WAAW;EACjB,IAAI,UAAU,kBACV,0BAA0B,WAAW,QAAQ,IAAI,IACjD,UAAU,MAAM;EAEpB,UAAU,eAAe,WAAW,QAAQ,SAAS,eAAe;EAEpE,KAAK,IAAI,IAAI,YAAY,SAAS,GAAG,KAAK,GAAG,KAC3C,UAAU,YAAY,EAAE,CAAC,UAAU,EAAE,UAAU,QAAQ,CAAC;EAG1D,OAAO;CACT;AACF;AAEA,SAAgB,iBAAiB,QAAmC;CAElE,OACE,OAAe,iBACf,mBACE,OAAO,WACP,OAAO,WACP,OAAO,aACP,IACF;AAEJ"}

package/dist/router/resolution.d.ts

@@ -0,0 +1,17 @@
+import { ResolvedRoute, Route, RouteManifest, RouteMatch, RouteRecord, RouteRequestOptions, RouteRequestResult } from "../common/router.js";
+
+//#region src/router/resolution.d.ts
+declare function computeMatchesFromRoutes(pathname: string, routesList: readonly Route[]): RouteMatch[];
+declare function computeMatchesFromRouteRecords(pathname: string, routeRecords: readonly RouteRecord[]): RouteMatch[];
+declare function computeRouteActivityMatches(pathname: string, options?: {
+  manifest?: RouteManifest;
+  routes?: readonly Route[];
+}): RouteMatch[];
+declare function resolveRoute(pathname: string): ResolvedRoute | null;
+declare function resolveRouteRequest(target: string, options?: RouteRequestOptions): RouteRequestResult | Promise<RouteRequestResult>;
+declare function resolveRouteFromRoutes(pathname: string, routeList: readonly Route[]): ResolvedRoute | null;
+declare function _resolveRouteMatchFromRoutes(pathname: string, routeList: readonly Route[]): {
+  route: Route;
+  params: Record<string, string>;
+} | null;
+//# sourceMappingURL=resolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolution.d.ts","names":[],"sources":["../../src/router/resolution.ts"],"mappings":";;;iBAsPgB,wBAAA,CACd,QAAA,UACA,UAAA,WAAqB,KAAA,KACpB,UAAU;AAAA,iBAyBG,8BAAA,CACd,QAAA,UACA,YAAA,WAAuB,WAAA,KACtB,UAAU;AAAA,iBAgBG,2BAAA,CACd,QAAA,UACA,OAAA;EACE,QAAA,GAAW,aAAA;EACX,MAAA,YAAkB,KAAA;AAAA,IAEnB,UAAA;AAAA,iBAYa,YAAA,CAAa,QAAA,WAAmB,aAAa;AAAA,iBA+H7C,mBAAA,CACd,MAAA,UACA,OAAA,GAAS,mBAAA,GACR,kBAAA,GAAqB,OAAA,CAAQ,kBAAA;AAAA,iBAsDhB,sBAAA,CACd,QAAA,UACA,SAAA,WAAoB,KAAA,KACnB,aAAa;AAAA,iBAOA,4BAAA,CACd,QAAA,UACA,SAAA,WAAoB,KAAA;EACjB,KAAA,EAAO,KAAA;EAAO,MAAA,EAAQ,MAAA;AAAA"}

package/dist/router/resolution.js

@@ -0,0 +1,253 @@
+import { isPromiseLike } from "../common/promise.js";
+import { computeRank, matchSegments, parseSegments, splitPathSegments } from "./match.js";
+import { compileNodePolicies } from "./access.js";
+import { getRenderHandler } from "./rendering.js";
+import { getActiveRenderContext } from "../common/render-context.js";
+import { getActiveRouteAuthOptions, getActiveRoutes, getRouteRecords, isRouteStoreRoutes } from "./store.js";
+import { buildRouteContext, buildRouteContextBase, deepFreeze, parseLocation } from "./route-context.js";
+//#region src/router/resolution.ts
+const routeSegsCache = /* @__PURE__ */ new WeakMap();
+const routeRankCache = /* @__PURE__ */ new WeakMap();
+const sortedListCache = /* @__PURE__ */ new WeakMap();
+function cachedSegs(route) {
+	let segments = routeSegsCache.get(route);
+	if (!segments) {
+		segments = parseSegments(route.path);
+		routeSegsCache.set(route, segments);
+	}
+	return segments;
+}
+function cachedRank(route) {
+	let rank = routeRankCache.get(route);
+	if (rank === void 0) {
+		rank = computeRank(cachedSegs(route));
+		routeRankCache.set(route, rank);
+	}
+	return rank;
+}
+function cachedSortedList(routeList) {
+	let sorted = sortedListCache.get(routeList);
+	if (!sorted) {
+		sorted = [...routeList].sort((a, b) => cachedRank(b) - cachedRank(a));
+		sortedListCache.set(routeList, sorted);
+	}
+	return sorted;
+}
+function matchFallbackPrefix(pathname, fallbackPrefix) {
+	const normalizedPath = pathname.endsWith("/") && pathname !== "/" ? pathname.slice(0, -1) : pathname;
+	const normalizedPrefix = fallbackPrefix.endsWith("/") && fallbackPrefix !== "/" ? fallbackPrefix.slice(0, -1) : fallbackPrefix;
+	if (normalizedPrefix === "/") {
+		const urlParts = splitPathSegments(normalizedPath);
+		return { "*": urlParts.length === 0 ? "/" : urlParts.length === 1 ? urlParts[0] : "/" + urlParts.join("/") };
+	}
+	if (normalizedPath !== normalizedPrefix && !normalizedPath.startsWith(`${normalizedPrefix}/`)) return null;
+	const remainderParts = splitPathSegments(normalizedPath === normalizedPrefix ? "/" : normalizedPath.slice(normalizedPrefix.length));
+	return { "*": remainderParts.length === 0 ? "/" : remainderParts.length === 1 ? remainderParts[0] : "/" + remainderParts.join("/") };
+}
+function findBestResolvedRouteFromRoutes(pathname, routeList) {
+	const normalized = pathname.endsWith("/") && pathname !== "/" ? pathname.slice(0, -1) : pathname;
+	const urlParts = splitPathSegments(normalized);
+	const sorted = cachedSortedList(routeList);
+	let bestRoute = null;
+	let bestParams = {};
+	let bestRank = -Infinity;
+	for (const route of sorted) {
+		if (route.fallbackPrefix) continue;
+		const rank = cachedRank(route);
+		if (rank < bestRank) break;
+		if (bestRoute !== null && rank === bestRank) continue;
+		const params = matchSegments(urlParts, cachedSegs(route));
+		if (params !== null) {
+			bestRoute = route;
+			bestParams = params;
+			bestRank = rank;
+		}
+	}
+	if (bestRoute !== null) return {
+		route: bestRoute,
+		params: bestParams
+	};
+	let bestFallback = null;
+	let bestFallbackParams = null;
+	let bestPrefixLength = -1;
+	for (const route of routeList) {
+		const internalRoute = route;
+		if (!internalRoute.fallbackPrefix) continue;
+		const params = matchFallbackPrefix(normalized, internalRoute.fallbackPrefix);
+		if (params === null) continue;
+		if (internalRoute.fallbackPrefix.length > bestPrefixLength) {
+			bestFallback = internalRoute;
+			bestFallbackParams = params;
+			bestPrefixLength = internalRoute.fallbackPrefix.length;
+		}
+	}
+	return bestFallback && bestFallbackParams ? {
+		route: bestFallback,
+		params: bestFallbackParams
+	} : null;
+}
+function findBestScopedFallbackRecord(pathname, routeRecords) {
+	let bestRecord = null;
+	let bestParams = null;
+	let bestPrefixLength = -1;
+	for (const routeRecord of routeRecords) {
+		const record = routeRecord;
+		if (!record.fallbackPrefix) continue;
+		const params = matchFallbackPrefix(pathname, record.fallbackPrefix);
+		if (params === null) continue;
+		if (record.fallbackPrefix.length > bestPrefixLength) {
+			bestRecord = record;
+			bestParams = params;
+			bestPrefixLength = record.fallbackPrefix.length;
+		}
+	}
+	return bestRecord && bestParams ? {
+		record: bestRecord,
+		params: bestParams
+	} : null;
+}
+function getMatchingRecord(target, routeRecords) {
+	const location = parseLocation(target);
+	const normalized = location.pathname.endsWith("/") && location.pathname !== "/" ? location.pathname.slice(0, -1) : location.pathname;
+	const urlParts = splitPathSegments(normalized);
+	for (const record of routeRecords) {
+		if (record.fallbackPrefix) continue;
+		const params = matchSegments(urlParts, record.segments);
+		if (params !== null) return {
+			record,
+			params
+		};
+	}
+	return findBestScopedFallbackRecord(normalized, routeRecords);
+}
+function computeMatchesFromRoutes(pathname, routesList) {
+	const bestMatch = isRouteStoreRoutes(routesList) ? getMatchingRecord(pathname, getRouteRecords()) : findBestResolvedRouteFromRoutes(pathname, routesList);
+	if (!bestMatch) return [];
+	return [{
+		path: "route" in bestMatch ? bestMatch.route.path : bestMatch.record.path,
+		params: deepFreeze({ ...bestMatch.params }),
+		name: "route" in bestMatch ? bestMatch.route.name : void 0,
+		namespace: "route" in bestMatch ? bestMatch.route.namespace : bestMatch.record.options.namespace
+	}];
+}
+function computeMatchesFromRouteRecords(pathname, routeRecords) {
+	const bestMatch = getMatchingRecord(pathname, routeRecords);
+	if (!bestMatch) return [];
+	return [{
+		path: bestMatch.record.path,
+		params: deepFreeze({ ...bestMatch.params }),
+		namespace: bestMatch.record.options.namespace
+	}];
+}
+function computeRouteActivityMatches(pathname, options = {}) {
+	if (options.manifest) return computeMatchesFromRouteRecords(pathname, options.manifest.records);
+	if (options.routes) return computeMatchesFromRoutes(pathname, options.routes);
+	return computeMatchesFromRoutes(pathname, getActiveRoutes());
+}
+function resolveRoute(pathname) {
+	const normalized = pathname.endsWith("/") && pathname !== "/" ? pathname.slice(0, -1) : pathname;
+	const urlParts = splitPathSegments(normalized);
+	const records = getRouteRecords();
+	for (const record of records) {
+		if (record.fallbackPrefix) continue;
+		const params = matchSegments(urlParts, record.segments);
+		if (params !== null) return {
+			handler: record.handler,
+			params
+		};
+	}
+	const fallbackMatch = findBestScopedFallbackRecord(normalized, records);
+	return fallbackMatch ? {
+		handler: fallbackMatch.record.handler,
+		params: fallbackMatch.params
+	} : null;
+}
+function getRoutePolicies(options) {
+	if (!options) return [];
+	if (options.policies?.length) return options.policies;
+	return compileNodePolicies(options);
+}
+function getDefaultRouteMode() {
+	if (typeof window !== "undefined") return "spa";
+	return "ssr";
+}
+function createRenderDataAwareHandler(handler, data) {
+	return (params, context) => {
+		const renderContext = getActiveRenderContext();
+		if (renderContext) renderContext.renderData = data ?? null;
+		return handler(params, context);
+	};
+}
+function buildRenderResult(record, params, mode) {
+	const renderHandler = getRenderHandler(record);
+	const loader = mode === "ssr" ? record.options?.loader : void 0;
+	if (loader) {
+		const loaded = loader({ params });
+		const finalize = (data) => ({
+			kind: "render",
+			handler: createRenderDataAwareHandler(renderHandler, data),
+			params
+		});
+		if (isPromiseLike(loaded)) return Promise.resolve(loaded).then((data) => finalize(data));
+		return finalize(loaded);
+	}
+	return {
+		kind: "render",
+		handler: renderHandler,
+		params
+	};
+}
+function continueRoutePolicies(policies, context, record, params, startIndex = 0) {
+	for (let index = startIndex; index < policies.length; index += 1) {
+		const policyResult = policies[index](context);
+		if (isPromiseLike(policyResult)) return Promise.resolve(policyResult).then((next) => {
+			if (next.kind !== "allow") return next;
+			return continueRoutePolicies(policies, context, record, params, index + 1);
+		});
+		if (policyResult.kind !== "allow") return policyResult;
+	}
+	return buildRenderResult(record, params, context.mode);
+}
+function resolveRouteRequest(target, options = {}) {
+	const match = getMatchingRecord(target, options.manifest?.records ?? getRouteRecords());
+	if (!match) return null;
+	const { record, params } = match;
+	const policies = getRoutePolicies(record.options);
+	const mode = options.mode ?? getDefaultRouteMode();
+	if (policies.length === 0) return buildRenderResult(record, params, mode);
+	const signal = options.signal ?? getActiveRenderContext()?.signal ?? new AbortController().signal;
+	const auth = getActiveRouteAuthOptions(options.auth ?? options.manifest?.auth);
+	const baseContext = buildRouteContextBase(target, params, {
+		mode,
+		signal
+	});
+	const finalize = (authState) => continueRoutePolicies(policies, buildRouteContext(target, params, {
+		mode,
+		signal,
+		auth,
+		session: authState.session,
+		user: authState.user
+	}), record, params);
+	if (!auth?.resolve) return finalize({
+		session: null,
+		user: null
+	});
+	const authState = auth.resolve(baseContext);
+	if (isPromiseLike(authState)) return Promise.resolve(authState).then((next) => finalize(next));
+	return finalize(authState);
+}
+function resolveRouteFromRoutes(pathname, routeList) {
+	if (isRouteStoreRoutes(routeList)) return resolveRoute(pathname);
+	const match = findBestResolvedRouteFromRoutes(pathname, routeList);
+	return match ? {
+		handler: match.route.handler,
+		params: match.params
+	} : null;
+}
+function _resolveRouteMatchFromRoutes(pathname, routeList) {
+	return findBestResolvedRouteFromRoutes(pathname, routeList);
+}
+//#endregion
+export { _resolveRouteMatchFromRoutes, computeMatchesFromRouteRecords, computeMatchesFromRoutes, computeRouteActivityMatches, resolveRoute, resolveRouteFromRoutes, resolveRouteRequest };
+
+//# sourceMappingURL=resolution.js.map

package/dist/router/resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution.js","names":[],"sources":["../../src/router/resolution.ts"],"sourcesContent":["import type {\n  Route,\n  RouteContext,\n  RouteHandler,\n  RouteManifest,\n  RouteMatch,\n  RouteOptions,\n  RoutePolicy,\n  RouteRecord,\n  RouteRenderResult,\n  RouteRequestOptions,\n  RouteRequestResult,\n  ResolvedRoute,\n} from '../common/router';\nimport { isPromiseLike } from '../common/promise';\nimport { getActiveRenderContext } from '../common/render-context';\nimport {\n  buildRouteContext,\n  buildRouteContextBase,\n  deepFreeze,\n  parseLocation,\n} from './route-context';\nimport { compileNodePolicies } from './access';\nimport {\n  computeRank,\n  matchSegments,\n  parseSegments,\n  splitPathSegments,\n} from './match';\nimport type { InternalRoute, InternalRouteRecord } from './internal-types';\nimport { getRenderHandler } from './rendering';\nimport {\n  getActiveRouteAuthOptions,\n  getActiveRoutes,\n  getRouteRecords,\n  isRouteStoreRoutes,\n} from './store';\n\nconst routeSegsCache = new WeakMap<Route, ReturnType<typeof parseSegments>>();\nconst routeRankCache = new WeakMap<Route, number>();\nconst sortedListCache = new WeakMap<\n  ReadonlyArray<Route>,\n  ReadonlyArray<Route>\n>();\n\nfunction cachedSegs(route: Route): ReturnType<typeof parseSegments> {\n  let segments = routeSegsCache.get(route);\n  if (!segments) {\n    segments = parseSegments(route.path);\n    routeSegsCache.set(route, segments);\n  }\n  return segments;\n}\n\nfunction cachedRank(route: Route): number {\n  let rank = routeRankCache.get(route);\n  if (rank === undefined) {\n    rank = computeRank(cachedSegs(route));\n    routeRankCache.set(route, rank);\n  }\n  return rank;\n}\n\nfunction cachedSortedList(\n  routeList: ReadonlyArray<Route>\n): ReadonlyArray<Route> {\n  let sorted = sortedListCache.get(routeList);\n  if (!sorted) {\n    sorted = [...routeList].sort((a, b) => cachedRank(b) - cachedRank(a));\n    sortedListCache.set(routeList, sorted);\n  }\n  return sorted;\n}\n\nfunction matchFallbackPrefix(\n  pathname: string,\n  fallbackPrefix: string\n): Record<string, string> | null {\n  const normalizedPath =\n    pathname.endsWith('/') && pathname !== '/'\n      ? pathname.slice(0, -1)\n      : pathname;\n  const normalizedPrefix =\n    fallbackPrefix.endsWith('/') && fallbackPrefix !== '/'\n      ? fallbackPrefix.slice(0, -1)\n      : fallbackPrefix;\n\n  if (normalizedPrefix === '/') {\n    const urlParts = splitPathSegments(normalizedPath);\n    return {\n      '*':\n        urlParts.length === 0\n          ? '/'\n          : urlParts.length === 1\n            ? urlParts[0]\n            : '/' + urlParts.join('/'),\n    };\n  }\n\n  if (\n    normalizedPath !== normalizedPrefix &&\n    !normalizedPath.startsWith(`${normalizedPrefix}/`)\n  ) {\n    return null;\n  }\n\n  const remainder =\n    normalizedPath === normalizedPrefix\n      ? '/'\n      : normalizedPath.slice(normalizedPrefix.length);\n  const remainderParts = splitPathSegments(remainder);\n\n  return {\n    '*':\n      remainderParts.length === 0\n        ? '/'\n        : remainderParts.length === 1\n          ? remainderParts[0]\n          : '/' + remainderParts.join('/'),\n  };\n}\n\nfunction findBestResolvedRouteFromRoutes(\n  pathname: string,\n  routeList: readonly Route[]\n): { route: Route; params: Record<string, string> } | null {\n  const normalized =\n    pathname.endsWith('/') && pathname !== '/'\n      ? pathname.slice(0, -1)\n      : pathname;\n  const urlParts = splitPathSegments(normalized);\n\n  const sorted = cachedSortedList(routeList);\n  let bestRoute: Route | null = null;\n  let bestParams: Record<string, string> = {};\n  let bestRank = -Infinity;\n\n  for (const route of sorted) {\n    const internalRoute = route as InternalRoute;\n    if (internalRoute.fallbackPrefix) {\n      continue;\n    }\n\n    const rank = cachedRank(route);\n    if (rank < bestRank) break;\n    if (bestRoute !== null && rank === bestRank) continue;\n\n    const params = matchSegments(urlParts, cachedSegs(route));\n    if (params !== null) {\n      bestRoute = route;\n      bestParams = params;\n      bestRank = rank;\n    }\n  }\n\n  if (bestRoute !== null) {\n    return { route: bestRoute, params: bestParams };\n  }\n\n  let bestFallback: InternalRoute | null = null;\n  let bestFallbackParams: Record<string, string> | null = null;\n  let bestPrefixLength = -1;\n\n  for (const route of routeList) {\n    const internalRoute = route as InternalRoute;\n    if (!internalRoute.fallbackPrefix) {\n      continue;\n    }\n\n    const params = matchFallbackPrefix(\n      normalized,\n      internalRoute.fallbackPrefix\n    );\n    if (params === null) {\n      continue;\n    }\n\n    if (internalRoute.fallbackPrefix.length > bestPrefixLength) {\n      bestFallback = internalRoute;\n      bestFallbackParams = params;\n      bestPrefixLength = internalRoute.fallbackPrefix.length;\n    }\n  }\n\n  return bestFallback && bestFallbackParams\n    ? { route: bestFallback, params: bestFallbackParams }\n    : null;\n}\n\nfunction findBestScopedFallbackRecord(\n  pathname: string,\n  routeRecords: readonly RouteRecord[]\n): { record: InternalRouteRecord; params: Record<string, string> } | null {\n  let bestRecord: InternalRouteRecord | null = null;\n  let bestParams: Record<string, string> | null = null;\n  let bestPrefixLength = -1;\n\n  for (const routeRecord of routeRecords) {\n    const record = routeRecord as InternalRouteRecord;\n    if (!record.fallbackPrefix) {\n      continue;\n    }\n\n    const params = matchFallbackPrefix(pathname, record.fallbackPrefix);\n    if (params === null) {\n      continue;\n    }\n\n    if (record.fallbackPrefix.length > bestPrefixLength) {\n      bestRecord = record;\n      bestParams = params;\n      bestPrefixLength = record.fallbackPrefix.length;\n    }\n  }\n\n  return bestRecord && bestParams\n    ? { record: bestRecord, params: bestParams }\n    : null;\n}\n\nfunction getMatchingRecord(\n  target: string,\n  routeRecords: readonly RouteRecord[]\n): { record: RouteRecord; params: Record<string, string> } | null {\n  const location = parseLocation(target);\n  const normalized =\n    location.pathname.endsWith('/') && location.pathname !== '/'\n      ? location.pathname.slice(0, -1)\n      : location.pathname;\n  const urlParts = splitPathSegments(normalized);\n\n  for (const record of routeRecords) {\n    const internalRecord = record as InternalRouteRecord;\n    if (internalRecord.fallbackPrefix) {\n      continue;\n    }\n\n    const params = matchSegments(urlParts, record.segments);\n    if (params !== null) {\n      return { record, params };\n    }\n  }\n\n  return findBestScopedFallbackRecord(normalized, routeRecords);\n}\n\nexport function computeMatchesFromRoutes(\n  pathname: string,\n  routesList: readonly Route[]\n): RouteMatch[] {\n  const bestMatch = isRouteStoreRoutes(routesList)\n    ? getMatchingRecord(pathname, getRouteRecords())\n    : findBestResolvedRouteFromRoutes(pathname, routesList);\n\n  if (!bestMatch) {\n    return [];\n  }\n\n  return [\n    {\n      path: 'route' in bestMatch ? bestMatch.route.path : bestMatch.record.path,\n      params: deepFreeze({ ...bestMatch.params }),\n      name:\n        'route' in bestMatch\n          ? (bestMatch.route as { name?: string }).name\n          : undefined,\n      namespace:\n        'route' in bestMatch\n          ? bestMatch.route.namespace\n          : bestMatch.record.options.namespace,\n    },\n  ];\n}\n\nexport function computeMatchesFromRouteRecords(\n  pathname: string,\n  routeRecords: readonly RouteRecord[]\n): RouteMatch[] {\n  const bestMatch = getMatchingRecord(pathname, routeRecords);\n\n  if (!bestMatch) {\n    return [];\n  }\n\n  return [\n    {\n      path: bestMatch.record.path,\n      params: deepFreeze({ ...bestMatch.params }),\n      namespace: bestMatch.record.options.namespace,\n    },\n  ];\n}\n\nexport function computeRouteActivityMatches(\n  pathname: string,\n  options: {\n    manifest?: RouteManifest;\n    routes?: readonly Route[];\n  } = {}\n): RouteMatch[] {\n  if (options.manifest) {\n    return computeMatchesFromRouteRecords(pathname, options.manifest.records);\n  }\n\n  if (options.routes) {\n    return computeMatchesFromRoutes(pathname, options.routes);\n  }\n\n  return computeMatchesFromRoutes(pathname, getActiveRoutes());\n}\n\nexport function resolveRoute(pathname: string): ResolvedRoute | null {\n  const normalized =\n    pathname.endsWith('/') && pathname !== '/'\n      ? pathname.slice(0, -1)\n      : pathname;\n  const urlParts = splitPathSegments(normalized);\n  const records = getRouteRecords();\n\n  for (const record of records) {\n    if (record.fallbackPrefix) {\n      continue;\n    }\n\n    const params = matchSegments(urlParts, record.segments);\n    if (params !== null) {\n      return { handler: record.handler, params };\n    }\n  }\n\n  const fallbackMatch = findBestScopedFallbackRecord(normalized, records);\n  return fallbackMatch\n    ? { handler: fallbackMatch.record.handler, params: fallbackMatch.params }\n    : null;\n}\n\nfunction getRoutePolicies(\n  options: RouteOptions | undefined\n): readonly RoutePolicy[] {\n  if (!options) {\n    return [];\n  }\n\n  if (options.policies?.length) {\n    return options.policies;\n  }\n\n  return compileNodePolicies(options);\n}\n\nfunction getDefaultRouteMode(): RouteContext['mode'] {\n  if (typeof window !== 'undefined') {\n    return 'spa';\n  }\n\n  return 'ssr';\n}\n\nfunction createRenderDataAwareHandler(\n  handler: RouteHandler,\n  data: unknown\n): RouteHandler {\n  return (params, context) => {\n    const renderContext = getActiveRenderContext();\n    if (renderContext) {\n      renderContext.renderData = (data ?? null) as Record<\n        string,\n        unknown\n      > | null;\n    }\n\n    return handler(params, context);\n  };\n}\n\nfunction buildRenderResult(\n  record: RouteRecord,\n  params: Record<string, string>,\n  mode: RouteContext['mode']\n): RouteRequestResult | Promise<RouteRequestResult> {\n  const renderHandler = getRenderHandler(record);\n  const loader = mode === 'ssr' ? record.options?.loader : undefined;\n  if (loader) {\n    const loaded = loader({ params });\n    const finalize = (data: unknown): RouteRenderResult => ({\n      kind: 'render',\n      handler: createRenderDataAwareHandler(renderHandler, data),\n      params,\n    });\n\n    if (isPromiseLike(loaded)) {\n      return Promise.resolve(loaded).then((data) => finalize(data));\n    }\n\n    return finalize(loaded);\n  }\n\n  return {\n    kind: 'render',\n    handler: renderHandler,\n    params,\n  };\n}\n\nfunction continueRoutePolicies(\n  policies: readonly RoutePolicy[],\n  context: RouteContext,\n  record: RouteRecord,\n  params: Record<string, string>,\n  startIndex = 0\n): RouteRequestResult | Promise<RouteRequestResult> {\n  for (let index = startIndex; index < policies.length; index += 1) {\n    const policyResult = policies[index](context);\n\n    if (isPromiseLike(policyResult)) {\n      return Promise.resolve(policyResult).then((next) => {\n        if (next.kind !== 'allow') {\n          return next;\n        }\n\n        return continueRoutePolicies(\n          policies,\n          context,\n          record,\n          params,\n          index + 1\n        );\n      });\n    }\n\n    if (policyResult.kind !== 'allow') {\n      return policyResult;\n    }\n  }\n\n  return buildRenderResult(record, params, context.mode);\n}\n\nexport function resolveRouteRequest(\n  target: string,\n  options: RouteRequestOptions = {}\n): RouteRequestResult | Promise<RouteRequestResult> {\n  const routeRecords = options.manifest?.records ?? getRouteRecords();\n  const match = getMatchingRecord(target, routeRecords);\n\n  if (!match) {\n    return null;\n  }\n\n  const { record, params } = match;\n  const policies = getRoutePolicies(record.options);\n  const mode = options.mode ?? getDefaultRouteMode();\n\n  if (policies.length === 0) {\n    return buildRenderResult(record, params, mode);\n  }\n\n  const signal =\n    options.signal ??\n    getActiveRenderContext()?.signal ??\n    new AbortController().signal;\n  const auth = getActiveRouteAuthOptions(\n    options.auth ?? options.manifest?.auth\n  );\n  const baseContext = buildRouteContextBase(target, params, {\n    mode,\n    signal,\n  });\n\n  const finalize = (authState: { session: unknown; user: unknown }) =>\n    continueRoutePolicies(\n      policies,\n      buildRouteContext(target, params, {\n        mode,\n        signal,\n        auth,\n        session: authState.session,\n        user: authState.user,\n      }),\n      record,\n      params\n    );\n\n  if (!auth?.resolve) {\n    return finalize({ session: null, user: null });\n  }\n\n  const authState = auth.resolve(baseContext);\n  if (isPromiseLike(authState)) {\n    return Promise.resolve(authState).then((next) => finalize(next));\n  }\n\n  return finalize(authState);\n}\n\nexport function resolveRouteFromRoutes(\n  pathname: string,\n  routeList: readonly Route[]\n): ResolvedRoute | null {\n  if (isRouteStoreRoutes(routeList)) return resolveRoute(pathname);\n\n  const match = findBestResolvedRouteFromRoutes(pathname, routeList);\n  return match ? { handler: match.route.handler, params: match.params } : null;\n}\n\nexport function _resolveRouteMatchFromRoutes(\n  pathname: string,\n  routeList: readonly Route[]\n): { route: Route; params: Record<string, string> } | null {\n  return findBestResolvedRouteFromRoutes(pathname, routeList);\n}\n"],"mappings":"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"}

package/dist/router/route-query.d.ts

@@ -0,0 +1,17 @@
+//#region src/router/route-query.d.ts
+type RouteQueryParamValue = string | number | boolean | null | undefined;
+type RouteQueryParamInput = RouteQueryParamValue | readonly RouteQueryParamValue[];
+type RouteQueryUpdates = Record<string, RouteQueryParamInput>;
+type RouteQueryUpdater = (searchParams: URLSearchParams) => void;
+type UpdateRouteQueryOptions = {
+  /**
+   * Defaults to replace so high-frequency controls such as search inputs do not
+   * create one browser-history entry per character.
+   */
+  history?: 'push' | 'replace';
+  replace?: boolean;
+};
+declare function updateRouteQuery(updates: RouteQueryUpdates | RouteQueryUpdater, options?: UpdateRouteQueryOptions): void;
+//#endregion
+export { RouteQueryParamInput, RouteQueryParamValue, RouteQueryUpdater, RouteQueryUpdates, UpdateRouteQueryOptions, updateRouteQuery };
+//# sourceMappingURL=route-query.d.ts.map

package/dist/router/route-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-query.d.ts","names":[],"sources":["../../src/router/route-query.ts"],"mappings":";KAWY,oBAAA;AAAA,KACA,oBAAA,GACR,oBAAA,YACS,oBAAoB;AAAA,KACrB,iBAAA,GAAoB,MAAM,SAAS,oBAAA;AAAA,KACnC,iBAAA,IAAqB,YAA6B,EAAf,eAAe;AAAA,KAElD,uBAAA;EAPoB;AAChC;;;EAWE,OAAA;EACA,OAAO;AAAA;AAAA,iBAmDO,gBAAA,CACd,OAAA,EAAS,iBAAA,GAAoB,iBAAA,EAC7B,OAAA,GAAS,uBAAA"}

package/dist/router/route-query.js

@@ -0,0 +1,47 @@
+import { saveScrollPosition } from "./navigation-scroll.js";
+import { getCurrentHref, getRegisteredAppsSnapshot, getWindowHref, parseTargetUrl, setCurrentRouteLocation, syncAppRegistrationLocation, syncRegisteredRouteSnapshot } from "./navigation-registry.js";
+//#region src/router/route-query.ts
+function getRouteQueryHistoryMode(options) {
+	if (options.history) return options.history;
+	return options.replace === false ? "push" : "replace";
+}
+function setRouteQueryValue(searchParams, key, value) {
+	searchParams.delete(key);
+	if (Array.isArray(value)) {
+		for (const entry of value) {
+			if (entry === null || entry === void 0) continue;
+			searchParams.append(key, String(entry));
+		}
+		return;
+	}
+	if (value === null || value === void 0) return;
+	searchParams.set(key, String(value));
+}
+function applyRouteQueryUpdates(searchParams, updates) {
+	if (typeof updates === "function") {
+		updates(searchParams);
+		return;
+	}
+	for (const [key, value] of Object.entries(updates)) setRouteQueryValue(searchParams, key, value);
+}
+function updateRouteQuery(updates, options = {}) {
+	if (typeof window === "undefined") return;
+	const url = parseTargetUrl(getWindowHref());
+	applyRouteQueryUpdates(url.searchParams, updates);
+	const href = `${url.pathname}${url.search}${url.hash}`;
+	if (href === getWindowHref()) return;
+	const historyMode = getRouteQueryHistoryMode(options);
+	if (historyMode === "push") saveScrollPosition(getCurrentHref());
+	const state = window.history.state && typeof window.history.state === "object" ? window.history.state : {};
+	window.history[historyMode === "replace" ? "replaceState" : "pushState"]({
+		...state,
+		path: href
+	}, "", href);
+	setCurrentRouteLocation(url.pathname, href);
+	for (const app of getRegisteredAppsSnapshot()) syncAppRegistrationLocation(app, url.pathname, href);
+	syncRegisteredRouteSnapshot();
+}
+//#endregion
+export { updateRouteQuery };
+
+//# sourceMappingURL=route-query.js.map

package/dist/router/route-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-query.js","names":[],"sources":["../../src/router/route-query.ts"],"sourcesContent":["import { saveScrollPosition } from './navigation-scroll';\nimport {\n  getCurrentHref,\n  getRegisteredAppsSnapshot,\n  getWindowHref,\n  parseTargetUrl,\n  setCurrentRouteLocation,\n  syncAppRegistrationLocation,\n  syncRegisteredRouteSnapshot,\n} from './navigation-registry';\n\nexport type RouteQueryParamValue = string | number | boolean | null | undefined;\nexport type RouteQueryParamInput =\n  | RouteQueryParamValue\n  | readonly RouteQueryParamValue[];\nexport type RouteQueryUpdates = Record<string, RouteQueryParamInput>;\nexport type RouteQueryUpdater = (searchParams: URLSearchParams) => void;\n\nexport type UpdateRouteQueryOptions = {\n  /**\n   * Defaults to replace so high-frequency controls such as search inputs do not\n   * create one browser-history entry per character.\n   */\n  history?: 'push' | 'replace';\n  replace?: boolean;\n};\n\nfunction getRouteQueryHistoryMode(\n  options: UpdateRouteQueryOptions\n): 'push' | 'replace' {\n  if (options.history) {\n    return options.history;\n  }\n\n  return options.replace === false ? 'push' : 'replace';\n}\n\nfunction setRouteQueryValue(\n  searchParams: URLSearchParams,\n  key: string,\n  value: RouteQueryParamInput\n): void {\n  searchParams.delete(key);\n\n  if (Array.isArray(value)) {\n    for (const entry of value) {\n      if (entry === null || entry === undefined) {\n        continue;\n      }\n      searchParams.append(key, String(entry));\n    }\n    return;\n  }\n\n  if (value === null || value === undefined) {\n    return;\n  }\n\n  searchParams.set(key, String(value));\n}\n\nfunction applyRouteQueryUpdates(\n  searchParams: URLSearchParams,\n  updates: RouteQueryUpdates | RouteQueryUpdater\n): void {\n  if (typeof updates === 'function') {\n    updates(searchParams);\n    return;\n  }\n\n  for (const [key, value] of Object.entries(updates)) {\n    setRouteQueryValue(searchParams, key, value);\n  }\n}\n\nexport function updateRouteQuery(\n  updates: RouteQueryUpdates | RouteQueryUpdater,\n  options: UpdateRouteQueryOptions = {}\n): void {\n  if (typeof window === 'undefined') {\n    return;\n  }\n\n  const url = parseTargetUrl(getWindowHref());\n  applyRouteQueryUpdates(url.searchParams, updates);\n\n  const href = `${url.pathname}${url.search}${url.hash}`;\n  if (href === getWindowHref()) {\n    return;\n  }\n\n  const historyMode = getRouteQueryHistoryMode(options);\n  if (historyMode === 'push') {\n    saveScrollPosition(getCurrentHref());\n  }\n\n  const state =\n    window.history.state && typeof window.history.state === 'object'\n      ? window.history.state\n      : {};\n\n  window.history[historyMode === 'replace' ? 'replaceState' : 'pushState'](\n    {\n      ...state,\n      path: href,\n    },\n    '',\n    href\n  );\n\n  setCurrentRouteLocation(url.pathname, href);\n  for (const app of getRegisteredAppsSnapshot()) {\n    syncAppRegistrationLocation(app, url.pathname, href);\n  }\n  syncRegisteredRouteSnapshot();\n}\n"],"mappings":";;;AA2BA,SAAS,yBACP,SACoB;CACpB,IAAI,QAAQ,SACV,OAAO,QAAQ;CAGjB,OAAO,QAAQ,YAAY,QAAQ,SAAS;AAC9C;AAEA,SAAS,mBACP,cACA,KACA,OACM;CACN,aAAa,OAAO,GAAG;CAEvB,IAAI,MAAM,QAAQ,KAAK,GAAG;EACxB,KAAK,MAAM,SAAS,OAAO;GACzB,IAAI,UAAU,QAAQ,UAAU,QAC9B;GAEF,aAAa,OAAO,KAAK,OAAO,KAAK,CAAC;EACxC;EACA;CACF;CAEA,IAAI,UAAU,QAAQ,UAAU,QAC9B;CAGF,aAAa,IAAI,KAAK,OAAO,KAAK,CAAC;AACrC;AAEA,SAAS,uBACP,cACA,SACM;CACN,IAAI,OAAO,YAAY,YAAY;EACjC,QAAQ,YAAY;EACpB;CACF;CAEA,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,GAC/C,mBAAmB,cAAc,KAAK,KAAK;AAE/C;AAEA,SAAgB,iBACd,SACA,UAAmC,CAAC,GAC9B;CACN,IAAI,OAAO,WAAW,aACpB;CAGF,MAAM,MAAM,eAAe,cAAc,CAAC;CAC1C,uBAAuB,IAAI,cAAc,OAAO;CAEhD,MAAM,OAAO,GAAG,IAAI,WAAW,IAAI,SAAS,IAAI;CAChD,IAAI,SAAS,cAAc,GACzB;CAGF,MAAM,cAAc,yBAAyB,OAAO;CACpD,IAAI,gBAAgB,QAClB,mBAAmB,eAAe,CAAC;CAGrC,MAAM,QACJ,OAAO,QAAQ,SAAS,OAAO,OAAO,QAAQ,UAAU,WACpD,OAAO,QAAQ,QACf,CAAC;CAEP,OAAO,QAAQ,gBAAgB,YAAY,iBAAiB,YAAY,CACtE;EACE,GAAG;EACH,MAAM;CACR,GACA,IACA,IACF;CAEA,wBAAwB,IAAI,UAAU,IAAI;CAC1C,KAAK,MAAM,OAAO,0BAA0B,GAC1C,4BAA4B,KAAK,IAAI,UAAU,IAAI;CAErD,4BAA4B;AAC9B"}