@askrjs/askr 0.0.28 → 0.0.30

package/dist/renderer/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/renderer/utils.ts"],"sourcesContent":["/**\n * Shared utilities for the renderer module.\n * Consolidates common patterns to reduce code duplication.\n */\n\nimport { globalScheduler } from '../runtime/scheduler';\nimport { logger } from '../dev/logger';\nimport { getRuntimeEnv } from './env';\nimport { setDevValue, incDevCounter } from '../runtime/dev-namespace';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface ListenerEntry {\n  handler: EventListener;\n  original: EventListener;\n  options?: boolean | AddEventListenerOptions;\n  updateHandler?: (nextHandler: EventListener) => void;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Event Handler Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n// Handler pooling cache to avoid recreating wrapped handlers\n// Key: handler reference, Value: { wrapped: EventListener, flushAfter: boolean }\nconst handlerCache = new WeakMap<EventListener, Map<boolean, EventListener>>();\nlet cacheSize = 0;\nconst MAX_CACHE_SIZE = 1000;\n\n/**\n * Parse an event prop name (e.g., 'onClick') to its DOM event name (e.g., 'click')\n */\nexport function parseEventName(propName: string): string | null {\n  if (!propName.startsWith('on') || propName.length <= 2) return null;\n  return (\n    propName.slice(2).charAt(0).toLowerCase() + propName.slice(3).toLowerCase()\n  );\n}\n\n/**\n * Get default event listener options for passive events\n */\nexport function getPassiveOptions(\n  eventName: string\n): AddEventListenerOptions | undefined {\n  if (\n    eventName === 'wheel' ||\n    eventName === 'scroll' ||\n    eventName.startsWith('touch')\n  ) {\n    return { passive: true };\n  }\n  return undefined;\n}\n\n/**\n * Create a wrapped event handler that integrates with the scheduler\n * Uses caching to avoid recreating wrappers for the same handler\n */\nexport function createWrappedHandler(\n  handler: EventListener,\n  flushAfter = false\n): EventListener {\n  // Check cache first\n  const cachedByFlush = handlerCache.get(handler);\n  if (cachedByFlush) {\n    const cached = cachedByFlush.get(flushAfter);\n    if (cached) return cached;\n  }\n\n  const wrapped: EventListener = (event: Event) => {\n    try {\n      globalScheduler.runInHandlerScope(\n        () => {\n          try {\n            handler(event);\n          } catch (error) {\n            logger.error('[Askr] Event handler error:', error);\n          }\n        },\n        flushAfter ? 'sync' : 'defer'\n      );\n    } catch (err) {\n      if (flushAfter) {\n        queueMicrotask(() => {\n          throw err;\n        });\n      } else {\n        logger.error('[Askr] Event handler error:', err);\n      }\n    }\n  };\n\n  // Cache the wrapped handler\n  try {\n    if (!handlerCache.has(handler)) {\n      // Limit cache size to prevent memory leaks\n      if (cacheSize >= MAX_CACHE_SIZE) {\n        // Simple eviction - just don't cache new entries when full\n      } else {\n        cacheSize++;\n        handlerCache.set(handler, new Map());\n      }\n    }\n    handlerCache.get(handler)?.set(flushAfter, wrapped);\n  } catch {\n    // WeakMap can throw if handler is not a valid key\n  }\n\n  return wrapped;\n}\n\nexport function createMutableWrappedHandler(\n  handler: EventListener,\n  flushAfter = false\n): {\n  handler: EventListener;\n  updateHandler: (nextHandler: EventListener) => void;\n} {\n  let currentHandler = handler;\n\n  const wrapped: EventListener = (event: Event) => {\n    try {\n      globalScheduler.runInHandlerScope(\n        () => {\n          try {\n            currentHandler(event);\n          } catch (error) {\n            logger.error('[Askr] Event handler error:', error);\n          }\n        },\n        flushAfter ? 'sync' : 'defer'\n      );\n    } catch (err) {\n      if (flushAfter) {\n        queueMicrotask(() => {\n          throw err;\n        });\n      } else {\n        logger.error('[Askr] Event handler error:', err);\n      }\n    }\n  };\n\n  return {\n    handler: wrapped,\n    updateHandler(nextHandler: EventListener) {\n      currentHandler = nextHandler;\n    },\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Prop/Attribute Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/** Props that should be skipped during attribute processing */\nexport function isSkippedProp(key: string): boolean {\n  return key === 'children' || key === 'key' || key === 'ref';\n}\n\n/** Check if prop should be ignored for prop-change detection */\nexport function isIgnoredForPropChanges(key: string): boolean {\n  if (key === 'children' || key === 'key') return true;\n  if (key.startsWith('on') && key.length > 2) return true;\n  if (key.startsWith('data-')) return true;\n  return false;\n}\n\n/**\n * Check if an element's current attribute value differs from vnode value\n */\nexport function hasPropChanged(\n  el: Element,\n  key: string,\n  value: unknown\n): boolean {\n  try {\n    if (key === 'class' || key === 'className') {\n      return readElementClassName(el) !== String(value);\n    }\n    if (key === 'value' || key === 'checked') {\n      return (el as HTMLElement & Record<string, unknown>)[key] !== value;\n    }\n    const attr = el.getAttribute(key);\n    if (value === undefined || value === null || value === false) {\n      return attr !== null;\n    }\n    return String(value) !== attr;\n  } catch {\n    return true;\n  }\n}\n\nexport function isSVGDomElement(el: Element): el is SVGElement {\n  return typeof SVGElement !== 'undefined' && el instanceof SVGElement;\n}\n\nexport function readElementClassName(el: Element): string {\n  if (isSVGDomElement(el)) {\n    return el.getAttribute('class') ?? '';\n  }\n\n  return (el as HTMLElement).className;\n}\n\nexport function writeElementClassName(el: Element, value: string): void {\n  if (isSVGDomElement(el)) {\n    if (value.length > 0) {\n      el.setAttribute('class', value);\n    } else {\n      el.removeAttribute('class');\n    }\n    return;\n  }\n\n  (el as HTMLElement).className = value;\n}\n\nexport function tagNamesEqualIgnoreCase(a: string, b: string): boolean {\n  if (a === b) return true;\n  if (a.length !== b.length) return false;\n\n  for (let index = 0; index < a.length; index += 1) {\n    const aCode = a.charCodeAt(index);\n    const bCode = b.charCodeAt(index);\n    if (aCode === bCode) continue;\n\n    const normalizedA = aCode >= 65 && aCode <= 90 ? aCode + 32 : aCode;\n    const normalizedB = bCode >= 65 && bCode <= 90 ? bCode + 32 : bCode;\n    if (normalizedA !== normalizedB) return false;\n  }\n\n  return true;\n}\n\n/**\n * Check if a vnode has non-trivial props (excluding events and data-*)\n */\nexport function hasNonTrivialProps(props: Record<string, unknown>): boolean {\n  for (const k of Object.keys(props)) {\n    if (isIgnoredForPropChanges(k)) continue;\n    return true;\n  }\n  return false;\n}\n\n/**\n * Check for prop changes between vnode and existing element\n */\nexport function checkPropChanges(\n  el: Element,\n  props: Record<string, unknown>\n): boolean {\n  for (const k of Object.keys(props)) {\n    if (isIgnoredForPropChanges(k)) continue;\n    if (hasPropChanged(el, k, props[k])) {\n      return true;\n    }\n  }\n  return false;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Key Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Extract key from a vnode object\n */\nexport function extractKey(vnode: unknown): string | number | undefined {\n  if (typeof vnode !== 'object' || vnode === null) return undefined;\n  const obj = vnode as Record<string, unknown>;\n  const rawKey =\n    obj.key ?? (obj.props as Record<string, unknown> | undefined)?.key;\n  if (rawKey === undefined || rawKey === null) return undefined;\n  return typeof rawKey === 'symbol'\n    ? String(rawKey)\n    : (rawKey as string | number);\n}\n\n/**\n * Build a key map from element's children\n */\nexport function buildKeyMapFromChildren(\n  parent: Element\n): Map<string | number, Element> {\n  const map = new Map<string | number, Element>();\n  for (let ch = parent.firstElementChild; ch; ch = ch.nextElementSibling) {\n    const k = ch.getAttribute('data-key');\n    if (k !== null) {\n      map.set(k, ch);\n      const n = Number(k);\n      if (!Number.isNaN(n)) map.set(n, ch);\n    }\n  }\n  return map;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Diagnostic Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Record DOM replace operation for diagnostics\n */\nexport function recordDOMReplace(source: string): void {\n  try {\n    incDevCounter('__DOM_REPLACE_COUNT');\n    setDevValue(`__LAST_DOM_REPLACE_STACK_${source}`, new Error().stack);\n  } catch {\n    // ignore\n  }\n}\n\n/**\n * Record fast-path stats for diagnostics\n */\nexport function recordFastPathStats(\n  stats: Record<string, unknown>,\n  counterName?: string\n): void {\n  try {\n    setDevValue('__LAST_FASTPATH_STATS', stats);\n    setDevValue('__LAST_FASTPATH_COMMIT_COUNT', 1);\n    if (counterName) {\n      incDevCounter(counterName);\n    }\n  } catch {\n    // ignore\n  }\n}\n\n/**\n * Conditionally log debug info for fast-path operations\n */\nexport function logFastPathDebug(\n  message: string,\n  indexOrData?: number | unknown,\n  data?: unknown\n): void {\n  const env = getRuntimeEnv();\n  if (env.ASKR_FASTPATH_DEBUG === '1' || env.ASKR_FASTPATH_DEBUG === 'true') {\n    if (data !== undefined) {\n      logger.warn(`[Askr][FASTPATH] ${message}`, indexOrData, data);\n    } else if (indexOrData !== undefined) {\n      logger.warn(`[Askr][FASTPATH] ${message}`, indexOrData);\n    } else {\n      logger.warn(`[Askr][FASTPATH] ${message}`);\n    }\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Performance Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get current high-resolution timestamp\n */\nexport function now(): number {\n  return typeof performance !== 'undefined' && performance.now\n    ? performance.now()\n    : Date.now();\n}\n"],"mappings":"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"}

package/dist/resources/index.d.ts

@@ -1,9 +1,3 @@
-/**
- * askr/resources — async data policy (resources)
- *
- * This tier exists to make async data intent explicit in import paths.
- */
-export { resource } from '../runtime/operations';
-export type { ResourceResult as DataResult } from '../runtime/operations';
-export { getSignal } from '../runtime/component';
-//# sourceMappingURL=index.d.ts.map
+import { getSignal } from "../runtime/component.js";
+import { ResourceResult, capture, on, resource, stream, task, timer } from "../runtime/operations.js";
+export { type ResourceResult, capture, getSignal, on, resource, stream, task, timer };

package/dist/resources/index.js

@@ -1 +1,3 @@
-import{resource as o}from"../runtime/operations.js";import{getSignal as f}from"../runtime/component.js";export{f as getSignal,o as resource};
+import { getSignal } from "../runtime/component.js";
+import { capture, on, resource, stream, task, timer } from "../runtime/operations.js";
+export { capture, getSignal, on, resource, stream, task, timer };

package/dist/router/index.d.ts

@@ -1,10 +1,6 @@
-/**
- * askr/router — routing surface (explicit tier)
- */
-export { route, getRoutes, clearRoutes } from './route';
-export type { Route, RouteHandler, RouteSnapshot, RouteMatch, RouteQuery, } from '../common/router';
-export { navigate } from './navigate';
-export { Link } from '../components/link';
-export type { LinkProps } from '../components/link';
-export { layout } from '../foundations/structures/layout';
-//# sourceMappingURL=index.d.ts.map
+import { AccessDecision, AccessDenyDecision, AccessRedirectDecision, GroupHelperOptions, LayoutScopeRecord, ParsedSegment, RegisterRoutesOptions, Route, RouteAuthMode, RouteAuthOptions, RouteAuthResolver, RouteAuthState, RouteComponent, RouteContext, RouteDefinition, RouteHandler, RouteManifest, RouteMatch, RouteMode, RouteOptions, RoutePolicy, RouteQuery, RouteRecord, RouteRenderResult, RouteRequestOptions, RouteRequestResult, RouteSnapshot } from "../common/router.js";
+import { HistoryScrollBehavior, NavigateOptions, NavigationScrollBehavior, ScrollRestorationOptions, navigate } from "./navigate.js";
+import { _applyManifest, _drainLazy, clearRoutes, currentRoute, fallback, getLoadedNamespaces, getManifest, getNamespaceRoutes, getRoutes, group, lazy, registerRoutes, resolveRouteRequest, route, setServerLocation, unloadNamespace } from "./route.js";
+import { allow, deny, forbidden, notFound, redirect, requireAuth, requirePermission, requireRole, unauthorized } from "./policy.js";
+import { Link, LinkProps } from "../components/link.js";
+export { type AccessDecision, type AccessDenyDecision, type AccessRedirectDecision, type GroupHelperOptions, type HistoryScrollBehavior, type LayoutScopeRecord, Link, type LinkProps, type NavigateOptions, type NavigationScrollBehavior, type ParsedSegment, type RegisterRoutesOptions, type Route, type RouteAuthMode, type RouteAuthOptions, type RouteAuthResolver, type RouteAuthState, type RouteComponent, type RouteContext, type RouteDefinition, type RouteHandler, type RouteManifest, type RouteMatch, type RouteMode, type RouteOptions, type RoutePolicy, type RouteQuery, type RouteRecord, type RouteRenderResult, type RouteRequestOptions, type RouteRequestResult, type RouteSnapshot, type ScrollRestorationOptions, _applyManifest, _drainLazy, allow, clearRoutes, currentRoute, deny, fallback, forbidden, getLoadedNamespaces, getManifest, getNamespaceRoutes, getRoutes, group, lazy, navigate, notFound, redirect, registerRoutes, requireAuth, requirePermission, requireRole, resolveRouteRequest, route, setServerLocation, unauthorized, unloadNamespace };

package/dist/router/index.js

@@ -1 +1,5 @@
-import{clearRoutes as r,getRoutes as t,route as a}from"./route.js";import{navigate as m}from"./navigate.js";import{Link as u}from"../components/link.js";import{layout as g}from"../foundations/structures/layout.js";export{u as Link,r as clearRoutes,t as getRoutes,g as layout,m as navigate,a as route};
+import { allow, deny, forbidden, notFound, redirect, requireAuth, requirePermission, requireRole, unauthorized } from "./policy.js";
+import { _applyManifest, _drainLazy, clearRoutes, currentRoute, fallback, getLoadedNamespaces, getManifest, getNamespaceRoutes, getRoutes, group, lazy, registerRoutes, resolveRouteRequest, route, setServerLocation, unloadNamespace } from "./route.js";
+import { navigate } from "./navigate.js";
+import { Link } from "../components/link.js";
+export { Link, _applyManifest, _drainLazy, allow, clearRoutes, currentRoute, deny, fallback, forbidden, getLoadedNamespaces, getManifest, getNamespaceRoutes, getRoutes, group, lazy, navigate, notFound, redirect, registerRoutes, requireAuth, requirePermission, requireRole, resolveRouteRequest, route, setServerLocation, unauthorized, unloadNamespace };

package/dist/router/match.js

@@ -1 +1,83 @@
-function h(n,s){const o=n.endsWith("/")&&n!=="/"?n.slice(0,-1):n,c=s.endsWith("/")&&s!=="/"?s.slice(0,-1):s,a=o.split("/").filter(Boolean),e=c.split("/").filter(Boolean);if(e.length===1&&e[0]==="*")return{matched:!0,params:{"*":a.length>1?o:a[0]}};if(a.length!==e.length)return{matched:!1,params:{}};const l={};for(let r=0;r<e.length;r++){const t=e[r],i=a[r];if(t.startsWith("{")&&t.endsWith("}")){const m=t.slice(1,-1);l[m]=decodeURIComponent(i)}else if(t==="*")l["*"]=i;else if(t!==i)return{matched:!1,params:{}}}return{matched:!0,params:l}}export{h as match};
+//#region src/router/match.ts
+/**
+* Parse a route template path into typed segments.
+*
+* @example
+* parseSegments('/users/{id}')  // [{kind:'static',value:'users'},{kind:'param',value:'id'}]
+* parseSegments('/*')           // [{kind:'catchall',value:'*'}]
+* parseSegments('/posts/*')     // [{kind:'static',value:'posts'},{kind:'wildcard',value:'*'}]
+*/
+function parseSegments(path) {
+	const parts = (path.endsWith("/") && path !== "/" ? path.slice(0, -1) : path).split("/").filter(Boolean);
+	if (parts.length === 1 && parts[0] === "*") return [{
+		kind: "catchall",
+		value: "*"
+	}];
+	return parts.map((segment) => {
+		if (segment.startsWith("{") && segment.endsWith("}")) return {
+			kind: "param",
+			value: segment.slice(1, -1)
+		};
+		if (segment === "*") return {
+			kind: "wildcard",
+			value: "*"
+		};
+		return {
+			kind: "static",
+			value: segment
+		};
+	});
+}
+/**
+* Compute a numeric specificity rank from a parsed segment list.
+*
+* Scoring: static = 3, param = 2, wildcard = 1, catchall = 0.
+* Higher rank wins when multiple routes match the same path.
+*/
+function computeRank(segments) {
+	if (segments.length === 1 && segments[0].kind === "catchall") return -1;
+	let score = 0;
+	for (const seg of segments) if (seg.kind === "static") score += 3;
+	else if (seg.kind === "param") score += 2;
+	else if (seg.kind === "wildcard") score += 1;
+	return score;
+}
+/** Reused frozen empty params object — returned for purely-static (no-capture) routes. */
+const emptyParams = Object.freeze(Object.create(null));
+Object.freeze({
+	matched: false,
+	params: emptyParams
+});
+/**
+* Match pre-split URL parts against pre-parsed route segments.
+*
+* This is the hot-path matcher used by `resolveRoute` and
+* `resolveRouteFromRoutes`. Callers split the URL path **once** and reuse
+* `urlParts` across all route comparisons in a single resolution call.
+*
+* - Returns a params object (possibly the shared `{}`) on match.
+* - Returns `null` on no match.
+* - Params are allocated lazily — purely-static routes return the frozen
+*   empty sentinel without any heap allocation.
+*/
+function matchSegments(urlParts, segments) {
+	if (segments.length === 1 && segments[0].kind === "catchall") return { "*": urlParts.length === 0 ? "/" : urlParts.length === 1 ? urlParts[0] : "/" + urlParts.join("/") };
+	if (urlParts.length !== segments.length) return null;
+	let params = null;
+	for (let i = 0; i < segments.length; i++) {
+		const seg = segments[i];
+		const part = urlParts[i];
+		if (seg.kind === "static") {
+			if (seg.value !== part) return null;
+		} else {
+			if (params === null) params = {};
+			if (seg.kind === "param") params[seg.value] = part.includes("%") ? decodeURIComponent(part) : part;
+			else params["*"] = part;
+		}
+	}
+	return params ?? emptyParams;
+}
+//#endregion
+export { computeRank, matchSegments, parseSegments };
+
+//# sourceMappingURL=match.js.map

package/dist/router/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","names":[],"sources":["../../src/router/match.ts"],"sourcesContent":["/**\n * Path matching, segment parsing, and specificity scoring.\n */\n\nimport type { ParsedSegment } from '../common/router';\n\n/**\n * Parse a route template path into typed segments.\n *\n * @example\n * parseSegments('/users/{id}')  // [{kind:'static',value:'users'},{kind:'param',value:'id'}]\n * parseSegments('/*')           // [{kind:'catchall',value:'*'}]\n * parseSegments('/posts/*')     // [{kind:'static',value:'posts'},{kind:'wildcard',value:'*'}]\n */\nexport function parseSegments(path: string): ParsedSegment[] {\n  const normalized =\n    path.endsWith('/') && path !== '/' ? path.slice(0, -1) : path;\n\n  const parts = normalized.split('/').filter(Boolean);\n\n  // Bare catch-all: /*\n  if (parts.length === 1 && parts[0] === '*') {\n    return [{ kind: 'catchall', value: '*' }];\n  }\n\n  return parts.map((segment): ParsedSegment => {\n    if (segment.startsWith('{') && segment.endsWith('}')) {\n      return { kind: 'param', value: segment.slice(1, -1) };\n    }\n    if (segment === '*') {\n      return { kind: 'wildcard', value: '*' };\n    }\n    return { kind: 'static', value: segment };\n  });\n}\n\n/**\n * Compute a numeric specificity rank from a parsed segment list.\n *\n * Scoring: static = 3, param = 2, wildcard = 1, catchall = 0.\n * Higher rank wins when multiple routes match the same path.\n */\nexport function computeRank(segments: ParsedSegment[]): number {\n  if (segments.length === 1 && segments[0].kind === 'catchall') return -1;\n  let score = 0;\n  for (const seg of segments) {\n    if (seg.kind === 'static') score += 3;\n    else if (seg.kind === 'param') score += 2;\n    else if (seg.kind === 'wildcard') score += 1;\n    // catchall contributes 0 per segment but is handled above\n  }\n  return score;\n}\n\n/** Reused frozen empty params object — returned for purely-static (no-capture) routes. */\nconst emptyParams: Record<string, string> = Object.freeze(\n  Object.create(null) as Record<string, string>\n);\n\n/** Returned for every failed match — avoids per-call allocation. */\nconst noMatch: MatchResult = Object.freeze({\n  matched: false,\n  params: emptyParams,\n});\n\n/**\n * Match pre-split URL parts against pre-parsed route segments.\n *\n * This is the hot-path matcher used by `resolveRoute` and\n * `resolveRouteFromRoutes`. Callers split the URL path **once** and reuse\n * `urlParts` across all route comparisons in a single resolution call.\n *\n * - Returns a params object (possibly the shared `{}`) on match.\n * - Returns `null` on no match.\n * - Params are allocated lazily — purely-static routes return the frozen\n *   empty sentinel without any heap allocation.\n */\nexport function matchSegments(\n  urlParts: string[],\n  segments: ParsedSegment[]\n): Record<string, string> | null {\n  // catch-all /* — matches every URL at any depth\n  if (segments.length === 1 && segments[0].kind === 'catchall') {\n    return {\n      '*':\n        urlParts.length === 0\n          ? '/'\n          : urlParts.length === 1\n            ? urlParts[0]\n            : '/' + urlParts.join('/'),\n    };\n  }\n\n  // non-catchall: part count must equal segment count\n  if (urlParts.length !== segments.length) return null;\n\n  // Walk segments; allocate the params object lazily on first capture\n  let params: Record<string, string> | null = null;\n  for (let i = 0; i < segments.length; i++) {\n    const seg = segments[i];\n    const part = urlParts[i];\n    if (seg.kind === 'static') {\n      if (seg.value !== part) return null;\n    } else {\n      if (params === null) params = {};\n      if (seg.kind === 'param') {\n        // Avoid decodeURIComponent when no percent-encoding is present\n        params[seg.value] = part.includes('%')\n          ? decodeURIComponent(part)\n          : part;\n      } else {\n        // wildcard\n        params['*'] = part;\n      }\n    }\n  }\n  return params ?? emptyParams;\n}\n\nexport interface MatchResult {\n  matched: boolean;\n  params: Record<string, string>;\n}\n\n/**\n * Match a path against a route pattern and extract params\n *\n * @example\n * match('/users/123', '/users/{id}')\n * // → { matched: true, params: { id: '123' } }\n *\n * match('/posts/hello-world/edit', '/posts/{slug}/{action}')\n * // → { matched: true, params: { slug: 'hello-world', action: 'edit' } }\n *\n * match('/users', '/posts/{id}')\n * // → { matched: false, params: {} }\n */\nexport function match(path: string, pattern: string): MatchResult {\n  // Normalize trailing slashes\n  const normalizedPath =\n    path.endsWith('/') && path !== '/' ? path.slice(0, -1) : path;\n  const normalizedPattern =\n    pattern.endsWith('/') && pattern !== '/' ? pattern.slice(0, -1) : pattern;\n\n  // Split into segments\n  const pathSegments = normalizedPath.split('/').filter(Boolean);\n  const patternSegments = normalizedPattern.split('/').filter(Boolean);\n\n  // Support catch-all route: /* matches any path at any depth\n  if (patternSegments.length === 1 && patternSegments[0] === '*') {\n    // For multi-segment paths, preserve the leading slash\n    // For single-segment paths, return just the segment\n    return {\n      matched: true,\n      params: {\n        '*': pathSegments.length > 1 ? normalizedPath : pathSegments[0],\n      },\n    };\n  }\n\n  // Check if lengths match (wildcard segments still need to match one segment)\n  if (pathSegments.length !== patternSegments.length) {\n    return { matched: false, params: {} };\n  }\n\n  const params: Record<string, string> = {};\n\n  // Match each segment\n  for (let i = 0; i < patternSegments.length; i++) {\n    const patternSegment = patternSegments[i];\n    const pathSegment = pathSegments[i];\n\n    // Parameter: {paramName}\n    if (patternSegment.startsWith('{') && patternSegment.endsWith('}')) {\n      const paramName = patternSegment.slice(1, -1);\n      params[paramName] = pathSegment.includes('%')\n        ? decodeURIComponent(pathSegment)\n        : pathSegment;\n    } else if (patternSegment === '*') {\n      // Wildcard: match single segment\n      params['*'] = pathSegment;\n    } else if (patternSegment !== pathSegment) {\n      // Literal segment mismatch\n      return noMatch;\n    }\n  }\n\n  return { matched: true, params };\n}\n"],"mappings":";;;;;;;;;AAcA,SAAgB,cAAc,MAA+B;CAI3D,MAAM,SAFJ,KAAK,SAAS,IAAI,IAAI,SAAS,MAAM,KAAK,MAAM,GAAG,GAAG,GAAG,MAElC,MAAM,IAAI,CAAC,OAAO,QAAQ;AAGnD,KAAI,MAAM,WAAW,KAAK,MAAM,OAAO,IACrC,QAAO,CAAC;EAAE,MAAM;EAAY,OAAO;EAAK,CAAC;AAG3C,QAAO,MAAM,KAAK,YAA2B;AAC3C,MAAI,QAAQ,WAAW,IAAI,IAAI,QAAQ,SAAS,IAAI,CAClD,QAAO;GAAE,MAAM;GAAS,OAAO,QAAQ,MAAM,GAAG,GAAG;GAAE;AAEvD,MAAI,YAAY,IACd,QAAO;GAAE,MAAM;GAAY,OAAO;GAAK;AAEzC,SAAO;GAAE,MAAM;GAAU,OAAO;GAAS;GACzC;;;;;;;;AASJ,SAAgB,YAAY,UAAmC;AAC7D,KAAI,SAAS,WAAW,KAAK,SAAS,GAAG,SAAS,WAAY,QAAO;CACrE,IAAI,QAAQ;AACZ,MAAK,MAAM,OAAO,SAChB,KAAI,IAAI,SAAS,SAAU,UAAS;UAC3B,IAAI,SAAS,QAAS,UAAS;UAC/B,IAAI,SAAS,WAAY,UAAS;AAG7C,QAAO;;;AAIT,MAAM,cAAsC,OAAO,OACjD,OAAO,OAAO,KAAK,CACpB;AAG4B,OAAO,OAAO;CACzC,SAAS;CACT,QAAQ;CACT,CAAC;;;;;;;;;;;;;AAcF,SAAgB,cACd,UACA,UAC+B;AAE/B,KAAI,SAAS,WAAW,KAAK,SAAS,GAAG,SAAS,WAChD,QAAO,EACL,KACE,SAAS,WAAW,IAChB,MACA,SAAS,WAAW,IAClB,SAAS,KACT,MAAM,SAAS,KAAK,IAAI,EACjC;AAIH,KAAI,SAAS,WAAW,SAAS,OAAQ,QAAO;CAGhD,IAAI,SAAwC;AAC5C,MAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;EACxC,MAAM,MAAM,SAAS;EACrB,MAAM,OAAO,SAAS;AACtB,MAAI,IAAI,SAAS,UACf;OAAI,IAAI,UAAU,KAAM,QAAO;SAC1B;AACL,OAAI,WAAW,KAAM,UAAS,EAAE;AAChC,OAAI,IAAI,SAAS,QAEf,QAAO,IAAI,SAAS,KAAK,SAAS,IAAI,GAClC,mBAAmB,KAAK,GACxB;OAGJ,QAAO,OAAO;;;AAIpB,QAAO,UAAU"}

package/dist/router/navigate.d.ts

@@ -1,20 +1,32 @@
-/**
- * Client-side navigation with History API
- */
-import { type ComponentInstance } from '../runtime/component';
+import { ComponentInstance } from "../runtime/component.js";
+
+//#region src/router/navigate.d.ts
+type NavigationScrollBehavior = 'top' | 'preserve';
+type HistoryScrollBehavior = 'restore' | 'top' | 'preserve';
+type ScrollRestorationOptions = {
+  navigation?: NavigationScrollBehavior;
+  history?: HistoryScrollBehavior;
+};
+type NavigateOptions = {
+  history?: 'push' | 'replace';
+  scroll?: NavigationScrollBehavior;
+};
+declare function configureScrollRestoration(options?: boolean | ScrollRestorationOptions): void;
 /** Register the current app instance (called by createSPA/hydrateSPA). */
-export declare function registerAppInstance(instance: ComponentInstance, _path: string): void;
+declare function registerAppInstance(instance: ComponentInstance, path: string): void;
 /**
  * Navigate to a new path
  * Updates URL, resolves route, and re-mounts app with new handler
  */
-export declare function navigate(path: string): void;
+declare function navigate(path: string, options?: NavigateOptions): void;
 /**
  * Setup popstate listener for browser navigation
  */
-export declare function initializeNavigation(): void;
+declare function initializeNavigation(): void;
 /**
  * Cleanup navigation listeners
  */
-export declare function cleanupNavigation(): void;
+declare function cleanupNavigation(): void;
+//#endregion
+export { HistoryScrollBehavior, NavigateOptions, NavigationScrollBehavior, ScrollRestorationOptions, navigate };
 //# sourceMappingURL=navigate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../src/router/navigate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAM9B,0EAA0E;AAC1E,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,MAAM,GACZ,IAAI,CAON;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA8C3C;AAsCD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC"}
+{"version":3,"file":"navigate.d.ts","names":[],"sources":["../../src/router/navigate.ts"],"mappings":";;;KAyBY,wBAAA;AAAA,KACA,qBAAA;AAAA,KAEA,wBAAA;EACV,UAAA,GAAa,wBAAA;EACb,OAAA,GAAU,qBAAA;AAAA;AAAA,KAqBA,eAAA;EACV,OAAA;EACA,MAAA,GAAS,wBAAA;AAAA;AAAA,iBAsIK,0BAAA,CACd,OAAA,aAAoB,wBAAA;;iBA6ON,mBAAA,CACd,QAAA,EAAU,iBAAA,EACV,IAAA;;;;;iBAiBc,QAAA,CAAS,IAAA,UAAc,OAAA,GAAS,eAAA;;AAzYhD;;iBAqdgB,oBAAA,CAAA;;;;iBASA,iBAAA,CAAA"}

package/dist/router/navigate.js

@@ -1 +1,288 @@
-import{lockRouteRegistration as f,resolveRoute as r}from"./route.js";import{cleanupComponent as i,mountComponent as a}from"../runtime/component.js";import"../dev/logger.js";let e=null;function c(t,n){e=t,f()}function w(t){if(typeof window>"u")return;const n=r(t);n&&(window.history.pushState({path:t},"",t),e&&(i(e),e.fn=n.handler,e.props=n.params,e.stateValues=[],e.expectedStateIndices=[],e.firstRenderComplete=!1,e.stateIndexCheck=-1,e.evaluationGeneration++,e.notifyUpdate=null,e.abortController=new AbortController,a(e)))}function l(t){const n=window.location.pathname;if(!e)return;const o=r(n);o&&(i(e),e.fn=o.handler,e.props=o.params,e.stateValues=[],e.expectedStateIndices=[],e.firstRenderComplete=!1,e.stateIndexCheck=-1,e.evaluationGeneration++,e.notifyUpdate=null,e.abortController=new AbortController,a(e))}function m(){typeof window<"u"&&window.addEventListener("popstate",l)}function v(){typeof window<"u"&&window.removeEventListener("popstate",l)}export{v as cleanupNavigation,m as initializeNavigation,w as navigate,c as registerAppInstance};
+import { isDevelopmentEnvironment, isProductionEnvironment } from "../common/env.js";
+import { logger } from "../dev/logger.js";
+import { ELEMENT_TYPE, Fragment } from "../common/jsx.js";
+import { mountComponent } from "../runtime/component.js";
+import { lockRouteRegistration, resolveRoute, resolveRouteRequest } from "./route.js";
+import "../jsx/index.js";
+import { DefaultPortal } from "../foundations/structures/portal.js";
+//#region src/router/navigate.ts
+/**
+* Client-side navigation with History API
+*/
+let currentInstance = null;
+let currentPathname = "/";
+let currentHref = "/";
+const DEFAULT_SCROLL_RESTORATION = {
+	enabled: true,
+	navigation: "top",
+	history: "restore"
+};
+let scrollRestorationOptions = { ...DEFAULT_SCROLL_RESTORATION };
+const scrollPositions = /* @__PURE__ */ new Map();
+function getWindowHref() {
+	if (typeof window === "undefined") return currentHref;
+	return `${window.location.pathname}${window.location.search}${window.location.hash}`;
+}
+function normalizeScrollRestorationOptions(options) {
+	if (options === false) return {
+		enabled: false,
+		navigation: DEFAULT_SCROLL_RESTORATION.navigation,
+		history: DEFAULT_SCROLL_RESTORATION.history
+	};
+	if (options === true || options === void 0) return { ...DEFAULT_SCROLL_RESTORATION };
+	return {
+		enabled: true,
+		navigation: options.navigation ?? DEFAULT_SCROLL_RESTORATION.navigation,
+		history: options.history ?? DEFAULT_SCROLL_RESTORATION.history
+	};
+}
+function readScrollPosition() {
+	if (typeof window === "undefined") return {
+		x: 0,
+		y: 0
+	};
+	return {
+		x: typeof window.scrollX === "number" ? window.scrollX : typeof window.pageXOffset === "number" ? window.pageXOffset : 0,
+		y: typeof window.scrollY === "number" ? window.scrollY : typeof window.pageYOffset === "number" ? window.pageYOffset : 0
+	};
+}
+function writeHistoryScrollPosition(href, position) {
+	if (typeof window === "undefined" || getWindowHref() !== href) return;
+	if (typeof window.history?.replaceState !== "function") return;
+	const state = window.history.state && typeof window.history.state === "object" ? window.history.state : {};
+	window.history.replaceState({
+		...state,
+		path: href,
+		scroll: position
+	}, "", href);
+}
+function saveScrollPosition(href) {
+	if (!scrollRestorationOptions.enabled || typeof window === "undefined") return;
+	const position = readScrollPosition();
+	scrollPositions.set(href, position);
+	writeHistoryScrollPosition(href, position);
+}
+function scrollToPosition(position) {
+	if (typeof window === "undefined" || typeof window.scrollTo !== "function") return;
+	window.scrollTo(position.x, position.y);
+}
+function applyNavigationScroll(behavior) {
+	if (!scrollRestorationOptions.enabled || behavior === "preserve") return;
+	scrollToPosition({
+		x: 0,
+		y: 0
+	});
+}
+function applyHistoryScroll(href, state) {
+	if (!scrollRestorationOptions.enabled) return;
+	if (scrollRestorationOptions.history === "preserve") return;
+	if (scrollRestorationOptions.history === "top") {
+		scrollToPosition({
+			x: 0,
+			y: 0
+		});
+		return;
+	}
+	const fromState = state && typeof state === "object" && "scroll" in state ? state.scroll : void 0;
+	scrollToPosition((fromState && typeof fromState.x === "number" && typeof fromState.y === "number" ? {
+		x: fromState.x,
+		y: fromState.y
+	} : scrollPositions.get(href)) ?? {
+		x: 0,
+		y: 0
+	});
+}
+function configureScrollRestoration(options) {
+	scrollRestorationOptions = normalizeScrollRestorationOptions(options);
+	if (typeof window === "undefined") return;
+	if ("scrollRestoration" in window.history) try {
+		window.history.scrollRestoration = scrollRestorationOptions.enabled ? "manual" : "auto";
+	} catch {}
+}
+function parseTargetUrl(path) {
+	const pathname = window.location.pathname || "/";
+	const search = window.location.search || "";
+	const hash = window.location.hash || "";
+	const href = typeof window.location.href === "string" ? window.location.href : "";
+	const base = href && href !== "about:blank" && !href.startsWith("about:") && !href.startsWith("data:") ? href : `http://localhost${pathname}${search}${hash}`;
+	return new URL(path, base);
+}
+function isRenderResult(result) {
+	return result !== null && result.kind === "render";
+}
+function isPromise(value) {
+	return value instanceof Promise;
+}
+function createDeniedResolvedRoute(status) {
+	return {
+		handler: () => ({
+			type: "div",
+			props: { "data-route-denied": String(status) },
+			children: [String(status)]
+		}),
+		params: {}
+	};
+}
+function bindResolvedRouteHandler(resolved) {
+	return () => resolved.handler(resolved.params);
+}
+function wrapRootRouteHandler(componentFn) {
+	const wrappedFn = (props, ctx) => {
+		const out = componentFn(props, ctx);
+		const portalVNode = {
+			$$typeof: ELEMENT_TYPE,
+			type: DefaultPortal,
+			props: {},
+			key: "__default_portal"
+		};
+		return {
+			$$typeof: ELEMENT_TYPE,
+			type: Fragment,
+			props: { children: out === void 0 || out === null ? [portalVNode] : [out, portalVNode] }
+		};
+	};
+	Object.defineProperty(wrappedFn, "name", { value: componentFn.name || "Component" });
+	return wrappedFn;
+}
+function remountResolvedRoute(resolved, pathname, href) {
+	if (!currentInstance) return false;
+	currentInstance.fn = wrapRootRouteHandler(bindResolvedRouteHandler(resolved));
+	currentInstance.props = {};
+	currentInstance.stateValues = [];
+	currentInstance.expectedStateIndices = [];
+	currentInstance.firstRenderComplete = false;
+	currentInstance.stateIndexCheck = -1;
+	currentInstance.evaluationGeneration++;
+	currentInstance.notifyUpdate = null;
+	currentInstance.mountOperations = [];
+	currentInstance._placeholder = void 0;
+	currentInstance.hasPendingUpdate = false;
+	currentInstance.abortController = null;
+	mountComponent(currentInstance);
+	currentPathname = pathname;
+	currentHref = href;
+	return true;
+}
+function rerenderResolvedRoute(pathname, href) {
+	if (!currentInstance) return false;
+	if (!resolveRoute(pathname)) return false;
+	currentPathname = pathname;
+	currentHref = href;
+	currentInstance._enqueueRun?.();
+	return true;
+}
+function resolveNavigationTarget(path) {
+	const target = parseTargetUrl(path);
+	const pathname = target.pathname;
+	const href = `${target.pathname}${target.search}${target.hash}`;
+	const resolved = resolveRouteRequest(href);
+	if (isPromise(resolved)) return resolved.then((next) => ({
+		href,
+		pathname,
+		resolved: next
+	}));
+	return {
+		href,
+		pathname,
+		resolved
+	};
+}
+function applyNavigationTarget(path, options, target) {
+	const { href, pathname, resolved } = target;
+	const previousPathname = currentPathname;
+	saveScrollPosition(currentHref);
+	if (!resolved) {
+		if (isDevelopmentEnvironment()) logger.warn(`No route found for path: ${path}`);
+		return;
+	}
+	if (resolved.kind === "redirect") {
+		const redirectTarget = parseTargetUrl(resolved.to);
+		const redirectHref = `${redirectTarget.pathname}${redirectTarget.search}${redirectTarget.hash}`;
+		if (redirectHref === href) {
+			if (isDevelopmentEnvironment()) logger.warn(`Navigation guard redirected to the same path: ${redirectHref}`);
+			return;
+		}
+		navigate(redirectHref, { history: "replace" });
+		return;
+	}
+	const nextResolved = resolved.kind === "deny" ? createDeniedResolvedRoute(resolved.status) : {
+		handler: resolved.handler,
+		params: resolved.params
+	};
+	const historyMethod = options.history === "replace" ? "replaceState" : "pushState";
+	window.history[historyMethod]({ path: href }, "", href);
+	if (currentInstance) {
+		if (pathname === currentPathname && isRenderResult(resolved)) {
+			rerenderResolvedRoute(pathname, href);
+			return;
+		}
+		remountResolvedRoute(nextResolved, pathname, href);
+		if (pathname !== previousPathname) applyNavigationScroll(options.scroll ?? scrollRestorationOptions.navigation);
+	}
+}
+/** Register the current app instance (called by createSPA/hydrateSPA). */
+function registerAppInstance(instance, path) {
+	currentInstance = instance;
+	currentPathname = path;
+	currentHref = getWindowHref();
+	saveScrollPosition(currentHref);
+	if (isProductionEnvironment()) lockRouteRegistration();
+}
+/**
+* Navigate to a new path
+* Updates URL, resolves route, and re-mounts app with new handler
+*/
+function navigate(path, options = {}) {
+	if (typeof window === "undefined") return;
+	const target = resolveNavigationTarget(path);
+	if (isPromise(target)) {
+		target.then((resolvedTarget) => applyNavigationTarget(path, options, resolvedTarget));
+		return;
+	}
+	applyNavigationTarget(path, options, target);
+}
+/**
+* Handle browser back/forward buttons
+*/
+function handlePopState(_event) {
+	const previousHref = currentHref;
+	const pathname = window.location.pathname;
+	const href = `${window.location.pathname}${window.location.search}${window.location.hash}`;
+	saveScrollPosition(previousHref);
+	if (!currentInstance) return;
+	const resolved = resolveRouteRequest(href);
+	const applyResolved = (resolved) => {
+		if (!resolved) {
+			if (isDevelopmentEnvironment()) logger.warn(`No route found for path: ${pathname}`);
+			return;
+		}
+		if (resolved.kind === "redirect") {
+			navigate(resolved.to, { history: "replace" });
+			return;
+		}
+		if (pathname === currentPathname && isRenderResult(resolved)) {
+			rerenderResolvedRoute(pathname, href);
+			return;
+		}
+		remountResolvedRoute(resolved.kind === "deny" ? createDeniedResolvedRoute(resolved.status) : {
+			handler: resolved.handler,
+			params: resolved.params
+		}, pathname, href);
+		applyHistoryScroll(href, _event.state);
+	};
+	if (isPromise(resolved)) {
+		resolved.then((next) => applyResolved(next));
+		return;
+	}
+	applyResolved(resolved);
+}
+/**
+* Setup popstate listener for browser navigation
+*/
+function initializeNavigation() {
+	if (typeof window !== "undefined") window.addEventListener("popstate", handlePopState);
+}
+//#endregion
+export { configureScrollRestoration, initializeNavigation, navigate, registerAppInstance };
+
+//# sourceMappingURL=navigate.js.map

package/dist/router/navigate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.js","names":[],"sources":["../../src/router/navigate.ts"],"sourcesContent":["/**\n * Client-side navigation with History API\n */\n\nimport {\n  resolveRoute,\n  resolveRouteRequest,\n  lockRouteRegistration,\n  type ResolvedRoute,\n} from './route';\nimport { mountComponent, type ComponentInstance } from '../runtime/component';\nimport {\n  isDevelopmentEnvironment,\n  isProductionEnvironment,\n} from '../common/env';\nimport { logger } from '../dev/logger';\nimport type { RouteRenderResult, RouteRequestResult } from '../common/router';\nimport { Fragment, ELEMENT_TYPE } from '../jsx';\nimport { DefaultPortal } from '../foundations/structures/portal';\n\n// Global app state for navigation\nlet currentInstance: ComponentInstance | null = null;\nlet currentPathname = '/';\nlet currentHref = '/';\n\nexport type NavigationScrollBehavior = 'top' | 'preserve';\nexport type HistoryScrollBehavior = 'restore' | 'top' | 'preserve';\n\nexport type ScrollRestorationOptions = {\n  navigation?: NavigationScrollBehavior;\n  history?: HistoryScrollBehavior;\n};\n\ntype NormalizedScrollRestorationOptions = {\n  enabled: boolean;\n  navigation: NavigationScrollBehavior;\n  history: HistoryScrollBehavior;\n};\n\nconst DEFAULT_SCROLL_RESTORATION: NormalizedScrollRestorationOptions = {\n  enabled: true,\n  navigation: 'top',\n  history: 'restore',\n};\n\nlet scrollRestorationOptions: NormalizedScrollRestorationOptions = {\n  ...DEFAULT_SCROLL_RESTORATION,\n};\n\nconst scrollPositions = new Map<string, { x: number; y: number }>();\n\nexport type NavigateOptions = {\n  history?: 'push' | 'replace';\n  scroll?: NavigationScrollBehavior;\n};\n\nfunction getWindowHref(): string {\n  if (typeof window === 'undefined') {\n    return currentHref;\n  }\n\n  return `${window.location.pathname}${window.location.search}${window.location.hash}`;\n}\n\nfunction normalizeScrollRestorationOptions(\n  options?: boolean | ScrollRestorationOptions\n): NormalizedScrollRestorationOptions {\n  if (options === false) {\n    return {\n      enabled: false,\n      navigation: DEFAULT_SCROLL_RESTORATION.navigation,\n      history: DEFAULT_SCROLL_RESTORATION.history,\n    };\n  }\n\n  if (options === true || options === undefined) {\n    return { ...DEFAULT_SCROLL_RESTORATION };\n  }\n\n  return {\n    enabled: true,\n    navigation: options.navigation ?? DEFAULT_SCROLL_RESTORATION.navigation,\n    history: options.history ?? DEFAULT_SCROLL_RESTORATION.history,\n  };\n}\n\nfunction readScrollPosition(): { x: number; y: number } {\n  if (typeof window === 'undefined') {\n    return { x: 0, y: 0 };\n  }\n\n  const x =\n    typeof window.scrollX === 'number'\n      ? window.scrollX\n      : typeof window.pageXOffset === 'number'\n        ? window.pageXOffset\n        : 0;\n  const y =\n    typeof window.scrollY === 'number'\n      ? window.scrollY\n      : typeof window.pageYOffset === 'number'\n        ? window.pageYOffset\n        : 0;\n\n  return { x, y };\n}\n\nfunction writeHistoryScrollPosition(\n  href: string,\n  position: { x: number; y: number }\n): void {\n  if (typeof window === 'undefined' || getWindowHref() !== href) {\n    return;\n  }\n  if (typeof window.history?.replaceState !== 'function') {\n    return;\n  }\n  const state =\n    window.history.state && typeof window.history.state === 'object'\n      ? window.history.state\n      : {};\n\n  window.history.replaceState(\n    {\n      ...state,\n      path: href,\n      scroll: position,\n    },\n    '',\n    href\n  );\n}\n\nfunction saveScrollPosition(href: string): void {\n  if (!scrollRestorationOptions.enabled || typeof window === 'undefined') {\n    return;\n  }\n\n  const position = readScrollPosition();\n  scrollPositions.set(href, position);\n  writeHistoryScrollPosition(href, position);\n}\n\nfunction scrollToPosition(position: { x: number; y: number }): void {\n  if (typeof window === 'undefined' || typeof window.scrollTo !== 'function') {\n    return;\n  }\n\n  window.scrollTo(position.x, position.y);\n}\n\nfunction applyNavigationScroll(behavior: NavigationScrollBehavior): void {\n  if (!scrollRestorationOptions.enabled || behavior === 'preserve') {\n    return;\n  }\n\n  scrollToPosition({ x: 0, y: 0 });\n}\n\nfunction applyHistoryScroll(href: string, state: PopStateEvent['state']): void {\n  if (!scrollRestorationOptions.enabled) {\n    return;\n  }\n\n  if (scrollRestorationOptions.history === 'preserve') {\n    return;\n  }\n\n  if (scrollRestorationOptions.history === 'top') {\n    scrollToPosition({ x: 0, y: 0 });\n    return;\n  }\n\n  const fromState =\n    state && typeof state === 'object' && 'scroll' in state\n      ? (state.scroll as { x?: unknown; y?: unknown })\n      : undefined;\n  const saved =\n    fromState &&\n    typeof fromState.x === 'number' &&\n    typeof fromState.y === 'number'\n      ? { x: fromState.x, y: fromState.y }\n      : scrollPositions.get(href);\n\n  scrollToPosition(saved ?? { x: 0, y: 0 });\n}\n\nexport function configureScrollRestoration(\n  options?: boolean | ScrollRestorationOptions\n): void {\n  scrollRestorationOptions = normalizeScrollRestorationOptions(options);\n\n  if (typeof window === 'undefined') {\n    return;\n  }\n\n  if ('scrollRestoration' in window.history) {\n    try {\n      window.history.scrollRestoration = scrollRestorationOptions.enabled\n        ? 'manual'\n        : 'auto';\n    } catch {\n      // Ignore environments that expose but do not allow setting scrollRestoration.\n    }\n  }\n}\n\nfunction parseTargetUrl(path: string): URL {\n  const pathname = window.location.pathname || '/';\n  const search = window.location.search || '';\n  const hash = window.location.hash || '';\n  const href =\n    typeof window.location.href === 'string' ? window.location.href : '';\n  const base =\n    href &&\n    href !== 'about:blank' &&\n    !href.startsWith('about:') &&\n    !href.startsWith('data:')\n      ? href\n      : `http://localhost${pathname}${search}${hash}`;\n\n  return new URL(path, base);\n}\n\nfunction isRenderResult(\n  result: RouteRequestResult\n): result is RouteRenderResult {\n  return result !== null && result.kind === 'render';\n}\n\nfunction isPromise<T>(value: T | Promise<T>): value is Promise<T> {\n  return value instanceof Promise;\n}\n\nfunction createDeniedResolvedRoute(status: number): ResolvedRoute {\n  return {\n    handler: () => ({\n      type: 'div',\n      props: {\n        'data-route-denied': String(status),\n      },\n      children: [String(status)],\n    }),\n    params: {},\n  };\n}\n\nfunction bindResolvedRouteHandler(\n  resolved: ResolvedRoute\n): ComponentInstance['fn'] {\n  return () =>\n    resolved.handler(resolved.params) as ReturnType<ComponentInstance['fn']>;\n}\n\nfunction wrapRootRouteHandler(\n  componentFn: ComponentInstance['fn']\n): ComponentInstance['fn'] {\n  const wrappedFn: ComponentInstance['fn'] = (props, ctx) => {\n    const out = componentFn(props, ctx);\n    const portalVNode = {\n      $$typeof: ELEMENT_TYPE,\n      type: DefaultPortal,\n      props: {},\n      key: '__default_portal',\n    } as unknown;\n\n    return {\n      $$typeof: ELEMENT_TYPE,\n      type: Fragment,\n      props: {\n        children:\n          out === undefined || out === null\n            ? [portalVNode]\n            : [out, portalVNode],\n      },\n    } as ReturnType<ComponentInstance['fn']>;\n  };\n\n  Object.defineProperty(wrappedFn, 'name', {\n    value: componentFn.name || 'Component',\n  });\n\n  return wrappedFn;\n}\n\nfunction remountResolvedRoute(\n  resolved: ResolvedRoute,\n  pathname: string,\n  href: string\n): boolean {\n  if (!currentInstance) {\n    return false;\n  }\n\n  // The route handler IS the component function\n  // It takes params as props and renders the route\n  currentInstance.fn = wrapRootRouteHandler(bindResolvedRouteHandler(resolved));\n  currentInstance.props = {};\n\n  // Reset state to prevent leakage from previous route\n  // Each route navigation starts completely fresh\n  currentInstance.stateValues = [];\n  currentInstance.expectedStateIndices = [];\n  currentInstance.firstRenderComplete = false;\n  currentInstance.stateIndexCheck = -1;\n  // Increment generation to invalidate pending async evaluations from previous route\n  currentInstance.evaluationGeneration++;\n  currentInstance.notifyUpdate = null;\n  currentInstance.mountOperations = [];\n  currentInstance._placeholder = undefined;\n  currentInstance.hasPendingUpdate = false;\n\n  // Route-local async work should create a fresh abort controller lazily.\n  currentInstance.abortController = null;\n\n  // Re-execute component against the existing host so reconciliation can\n  // preserve any shared layout DOM between sibling routes.\n  mountComponent(currentInstance);\n  currentPathname = pathname;\n  currentHref = href;\n  return true;\n}\n\nfunction rerenderResolvedRoute(pathname: string, href: string): boolean {\n  if (!currentInstance) {\n    return false;\n  }\n\n  const resolved = resolveRoute(pathname);\n  if (!resolved) {\n    return false;\n  }\n\n  currentPathname = pathname;\n  currentHref = href;\n  currentInstance._enqueueRun?.();\n  return true;\n}\n\nfunction resolveNavigationTarget(path: string) {\n  const target = parseTargetUrl(path);\n  const pathname = target.pathname;\n  const href = `${target.pathname}${target.search}${target.hash}`;\n  const resolved = resolveRouteRequest(href);\n\n  if (isPromise(resolved)) {\n    return resolved.then((next) => ({\n      href,\n      pathname,\n      resolved: next,\n    }));\n  }\n\n  return {\n    href,\n    pathname,\n    resolved,\n  };\n}\n\nfunction applyNavigationTarget(\n  path: string,\n  options: NavigateOptions,\n  target: {\n    href: string;\n    pathname: string;\n    resolved: RouteRequestResult;\n  }\n): void {\n  const { href, pathname, resolved } = target;\n  const previousPathname = currentPathname;\n\n  saveScrollPosition(currentHref);\n\n  if (!resolved) {\n    if (isDevelopmentEnvironment()) {\n      logger.warn(`No route found for path: ${path}`);\n    }\n    return;\n  }\n\n  if (resolved.kind === 'redirect') {\n    const redirectTarget = parseTargetUrl(resolved.to);\n    const redirectHref = `${redirectTarget.pathname}${redirectTarget.search}${redirectTarget.hash}`;\n    if (redirectHref === href) {\n      if (isDevelopmentEnvironment()) {\n        logger.warn(\n          `Navigation guard redirected to the same path: ${redirectHref}`\n        );\n      }\n      return;\n    }\n\n    navigate(redirectHref, { history: 'replace' });\n    return;\n  }\n\n  const nextResolved =\n    resolved.kind === 'deny'\n      ? createDeniedResolvedRoute(resolved.status)\n      : {\n          handler: resolved.handler,\n          params: resolved.params,\n        };\n\n  const historyMethod =\n    options.history === 'replace' ? 'replaceState' : 'pushState';\n  window.history[historyMethod]({ path: href }, '', href);\n\n  if (currentInstance) {\n    if (pathname === currentPathname && isRenderResult(resolved)) {\n      rerenderResolvedRoute(pathname, href);\n      return;\n    }\n\n    remountResolvedRoute(nextResolved, pathname, href);\n    if (pathname !== previousPathname) {\n      applyNavigationScroll(\n        options.scroll ?? scrollRestorationOptions.navigation\n      );\n    }\n  }\n}\n\n/** Register the current app instance (called by createSPA/hydrateSPA). */\nexport function registerAppInstance(\n  instance: ComponentInstance,\n  path: string\n): void {\n  currentInstance = instance;\n  currentPathname = path;\n  currentHref = getWindowHref();\n  saveScrollPosition(currentHref);\n  // Lock further route registrations after the app has started — but allow tests to register routes.\n  // Enforce only in production to avoid breaking test infra which registers routes dynamically.\n  if (isProductionEnvironment()) {\n    lockRouteRegistration();\n  }\n}\n\n/**\n * Navigate to a new path\n * Updates URL, resolves route, and re-mounts app with new handler\n */\nexport function navigate(path: string, options: NavigateOptions = {}): void {\n  if (typeof window === 'undefined') {\n    // SSR context\n    return;\n  }\n\n  const target = resolveNavigationTarget(path);\n  if (isPromise(target)) {\n    void target.then((resolvedTarget) =>\n      applyNavigationTarget(path, options, resolvedTarget)\n    );\n    return;\n  }\n\n  applyNavigationTarget(path, options, target);\n}\n\n/**\n * Handle browser back/forward buttons\n */\nfunction handlePopState(_event: PopStateEvent): void {\n  const previousHref = currentHref;\n  const pathname = window.location.pathname;\n  const href = `${window.location.pathname}${window.location.search}${window.location.hash}`;\n\n  saveScrollPosition(previousHref);\n\n  if (!currentInstance) {\n    return;\n  }\n\n  const resolved = resolveRouteRequest(href);\n\n  const applyResolved = (resolved: RouteRequestResult) => {\n    if (!resolved) {\n      if (isDevelopmentEnvironment()) {\n        logger.warn(`No route found for path: ${pathname}`);\n      }\n      return;\n    }\n\n    if (resolved.kind === 'redirect') {\n      navigate(resolved.to, { history: 'replace' });\n      return;\n    }\n\n    if (pathname === currentPathname && isRenderResult(resolved)) {\n      rerenderResolvedRoute(pathname, href);\n      return;\n    }\n\n    remountResolvedRoute(\n      resolved.kind === 'deny'\n        ? createDeniedResolvedRoute(resolved.status)\n        : {\n            handler: resolved.handler,\n            params: resolved.params,\n          },\n      pathname,\n      href\n    );\n\n    applyHistoryScroll(href, _event.state);\n  };\n\n  if (isPromise(resolved)) {\n    void resolved.then((next) => applyResolved(next));\n    return;\n  }\n\n  applyResolved(resolved);\n}\n\n/**\n * Setup popstate listener for browser navigation\n */\nexport function initializeNavigation(): void {\n  if (typeof window !== 'undefined') {\n    window.addEventListener('popstate', handlePopState);\n  }\n}\n\n/**\n * Cleanup navigation listeners\n */\nexport function cleanupNavigation(): void {\n  if (typeof window !== 'undefined') {\n    window.removeEventListener('popstate', handlePopState);\n  }\n}\n"],"mappings":";;;;;;;;;;;AAqBA,IAAI,kBAA4C;AAChD,IAAI,kBAAkB;AACtB,IAAI,cAAc;AAgBlB,MAAM,6BAAiE;CACrE,SAAS;CACT,YAAY;CACZ,SAAS;CACV;AAED,IAAI,2BAA+D,EACjE,GAAG,4BACJ;AAED,MAAM,kCAAkB,IAAI,KAAuC;AAOnE,SAAS,gBAAwB;AAC/B,KAAI,OAAO,WAAW,YACpB,QAAO;AAGT,QAAO,GAAG,OAAO,SAAS,WAAW,OAAO,SAAS,SAAS,OAAO,SAAS;;AAGhF,SAAS,kCACP,SACoC;AACpC,KAAI,YAAY,MACd,QAAO;EACL,SAAS;EACT,YAAY,2BAA2B;EACvC,SAAS,2BAA2B;EACrC;AAGH,KAAI,YAAY,QAAQ,YAAY,OAClC,QAAO,EAAE,GAAG,4BAA4B;AAG1C,QAAO;EACL,SAAS;EACT,YAAY,QAAQ,cAAc,2BAA2B;EAC7D,SAAS,QAAQ,WAAW,2BAA2B;EACxD;;AAGH,SAAS,qBAA+C;AACtD,KAAI,OAAO,WAAW,YACpB,QAAO;EAAE,GAAG;EAAG,GAAG;EAAG;AAgBvB,QAAO;EAAE,GAZP,OAAO,OAAO,YAAY,WACtB,OAAO,UACP,OAAO,OAAO,gBAAgB,WAC5B,OAAO,cACP;EAQI,GANV,OAAO,OAAO,YAAY,WACtB,OAAO,UACP,OAAO,OAAO,gBAAgB,WAC5B,OAAO,cACP;EAEO;;AAGjB,SAAS,2BACP,MACA,UACM;AACN,KAAI,OAAO,WAAW,eAAe,eAAe,KAAK,KACvD;AAEF,KAAI,OAAO,OAAO,SAAS,iBAAiB,WAC1C;CAEF,MAAM,QACJ,OAAO,QAAQ,SAAS,OAAO,OAAO,QAAQ,UAAU,WACpD,OAAO,QAAQ,QACf,EAAE;AAER,QAAO,QAAQ,aACb;EACE,GAAG;EACH,MAAM;EACN,QAAQ;EACT,EACD,IACA,KACD;;AAGH,SAAS,mBAAmB,MAAoB;AAC9C,KAAI,CAAC,yBAAyB,WAAW,OAAO,WAAW,YACzD;CAGF,MAAM,WAAW,oBAAoB;AACrC,iBAAgB,IAAI,MAAM,SAAS;AACnC,4BAA2B,MAAM,SAAS;;AAG5C,SAAS,iBAAiB,UAA0C;AAClE,KAAI,OAAO,WAAW,eAAe,OAAO,OAAO,aAAa,WAC9D;AAGF,QAAO,SAAS,SAAS,GAAG,SAAS,EAAE;;AAGzC,SAAS,sBAAsB,UAA0C;AACvE,KAAI,CAAC,yBAAyB,WAAW,aAAa,WACpD;AAGF,kBAAiB;EAAE,GAAG;EAAG,GAAG;EAAG,CAAC;;AAGlC,SAAS,mBAAmB,MAAc,OAAqC;AAC7E,KAAI,CAAC,yBAAyB,QAC5B;AAGF,KAAI,yBAAyB,YAAY,WACvC;AAGF,KAAI,yBAAyB,YAAY,OAAO;AAC9C,mBAAiB;GAAE,GAAG;GAAG,GAAG;GAAG,CAAC;AAChC;;CAGF,MAAM,YACJ,SAAS,OAAO,UAAU,YAAY,YAAY,QAC7C,MAAM,SACP;AAQN,mBANE,aACA,OAAO,UAAU,MAAM,YACvB,OAAO,UAAU,MAAM,WACnB;EAAE,GAAG,UAAU;EAAG,GAAG,UAAU;EAAG,GAClC,gBAAgB,IAAI,KAAK,KAEL;EAAE,GAAG;EAAG,GAAG;EAAG,CAAC;;AAG3C,SAAgB,2BACd,SACM;AACN,4BAA2B,kCAAkC,QAAQ;AAErE,KAAI,OAAO,WAAW,YACpB;AAGF,KAAI,uBAAuB,OAAO,QAChC,KAAI;AACF,SAAO,QAAQ,oBAAoB,yBAAyB,UACxD,WACA;SACE;;AAMZ,SAAS,eAAe,MAAmB;CACzC,MAAM,WAAW,OAAO,SAAS,YAAY;CAC7C,MAAM,SAAS,OAAO,SAAS,UAAU;CACzC,MAAM,OAAO,OAAO,SAAS,QAAQ;CACrC,MAAM,OACJ,OAAO,OAAO,SAAS,SAAS,WAAW,OAAO,SAAS,OAAO;CACpE,MAAM,OACJ,QACA,SAAS,iBACT,CAAC,KAAK,WAAW,SAAS,IAC1B,CAAC,KAAK,WAAW,QAAQ,GACrB,OACA,mBAAmB,WAAW,SAAS;AAE7C,QAAO,IAAI,IAAI,MAAM,KAAK;;AAG5B,SAAS,eACP,QAC6B;AAC7B,QAAO,WAAW,QAAQ,OAAO,SAAS;;AAG5C,SAAS,UAAa,OAA4C;AAChE,QAAO,iBAAiB;;AAG1B,SAAS,0BAA0B,QAA+B;AAChE,QAAO;EACL,gBAAgB;GACd,MAAM;GACN,OAAO,EACL,qBAAqB,OAAO,OAAO,EACpC;GACD,UAAU,CAAC,OAAO,OAAO,CAAC;GAC3B;EACD,QAAQ,EAAE;EACX;;AAGH,SAAS,yBACP,UACyB;AACzB,cACE,SAAS,QAAQ,SAAS,OAAO;;AAGrC,SAAS,qBACP,aACyB;CACzB,MAAM,aAAsC,OAAO,QAAQ;EACzD,MAAM,MAAM,YAAY,OAAO,IAAI;EACnC,MAAM,cAAc;GAClB,UAAU;GACV,MAAM;GACN,OAAO,EAAE;GACT,KAAK;GACN;AAED,SAAO;GACL,UAAU;GACV,MAAM;GACN,OAAO,EACL,UACE,QAAQ,UAAa,QAAQ,OACzB,CAAC,YAAY,GACb,CAAC,KAAK,YAAY,EACzB;GACF;;AAGH,QAAO,eAAe,WAAW,QAAQ,EACvC,OAAO,YAAY,QAAQ,aAC5B,CAAC;AAEF,QAAO;;AAGT,SAAS,qBACP,UACA,UACA,MACS;AACT,KAAI,CAAC,gBACH,QAAO;AAKT,iBAAgB,KAAK,qBAAqB,yBAAyB,SAAS,CAAC;AAC7E,iBAAgB,QAAQ,EAAE;AAI1B,iBAAgB,cAAc,EAAE;AAChC,iBAAgB,uBAAuB,EAAE;AACzC,iBAAgB,sBAAsB;AACtC,iBAAgB,kBAAkB;AAElC,iBAAgB;AAChB,iBAAgB,eAAe;AAC/B,iBAAgB,kBAAkB,EAAE;AACpC,iBAAgB,eAAe;AAC/B,iBAAgB,mBAAmB;AAGnC,iBAAgB,kBAAkB;AAIlC,gBAAe,gBAAgB;AAC/B,mBAAkB;AAClB,eAAc;AACd,QAAO;;AAGT,SAAS,sBAAsB,UAAkB,MAAuB;AACtE,KAAI,CAAC,gBACH,QAAO;AAIT,KAAI,CADa,aAAa,SACzB,CACH,QAAO;AAGT,mBAAkB;AAClB,eAAc;AACd,iBAAgB,eAAe;AAC/B,QAAO;;AAGT,SAAS,wBAAwB,MAAc;CAC7C,MAAM,SAAS,eAAe,KAAK;CACnC,MAAM,WAAW,OAAO;CACxB,MAAM,OAAO,GAAG,OAAO,WAAW,OAAO,SAAS,OAAO;CACzD,MAAM,WAAW,oBAAoB,KAAK;AAE1C,KAAI,UAAU,SAAS,CACrB,QAAO,SAAS,MAAM,UAAU;EAC9B;EACA;EACA,UAAU;EACX,EAAE;AAGL,QAAO;EACL;EACA;EACA;EACD;;AAGH,SAAS,sBACP,MACA,SACA,QAKM;CACN,MAAM,EAAE,MAAM,UAAU,aAAa;CACrC,MAAM,mBAAmB;AAEzB,oBAAmB,YAAY;AAE/B,KAAI,CAAC,UAAU;AACb,MAAI,0BAA0B,CAC5B,QAAO,KAAK,4BAA4B,OAAO;AAEjD;;AAGF,KAAI,SAAS,SAAS,YAAY;EAChC,MAAM,iBAAiB,eAAe,SAAS,GAAG;EAClD,MAAM,eAAe,GAAG,eAAe,WAAW,eAAe,SAAS,eAAe;AACzF,MAAI,iBAAiB,MAAM;AACzB,OAAI,0BAA0B,CAC5B,QAAO,KACL,iDAAiD,eAClD;AAEH;;AAGF,WAAS,cAAc,EAAE,SAAS,WAAW,CAAC;AAC9C;;CAGF,MAAM,eACJ,SAAS,SAAS,SACd,0BAA0B,SAAS,OAAO,GAC1C;EACE,SAAS,SAAS;EAClB,QAAQ,SAAS;EAClB;CAEP,MAAM,gBACJ,QAAQ,YAAY,YAAY,iBAAiB;AACnD,QAAO,QAAQ,eAAe,EAAE,MAAM,MAAM,EAAE,IAAI,KAAK;AAEvD,KAAI,iBAAiB;AACnB,MAAI,aAAa,mBAAmB,eAAe,SAAS,EAAE;AAC5D,yBAAsB,UAAU,KAAK;AACrC;;AAGF,uBAAqB,cAAc,UAAU,KAAK;AAClD,MAAI,aAAa,iBACf,uBACE,QAAQ,UAAU,yBAAyB,WAC5C;;;;AAMP,SAAgB,oBACd,UACA,MACM;AACN,mBAAkB;AAClB,mBAAkB;AAClB,eAAc,eAAe;AAC7B,oBAAmB,YAAY;AAG/B,KAAI,yBAAyB,CAC3B,wBAAuB;;;;;;AAQ3B,SAAgB,SAAS,MAAc,UAA2B,EAAE,EAAQ;AAC1E,KAAI,OAAO,WAAW,YAEpB;CAGF,MAAM,SAAS,wBAAwB,KAAK;AAC5C,KAAI,UAAU,OAAO,EAAE;AACrB,EAAK,OAAO,MAAM,mBAChB,sBAAsB,MAAM,SAAS,eAAe,CACrD;AACD;;AAGF,uBAAsB,MAAM,SAAS,OAAO;;;;;AAM9C,SAAS,eAAe,QAA6B;CACnD,MAAM,eAAe;CACrB,MAAM,WAAW,OAAO,SAAS;CACjC,MAAM,OAAO,GAAG,OAAO,SAAS,WAAW,OAAO,SAAS,SAAS,OAAO,SAAS;AAEpF,oBAAmB,aAAa;AAEhC,KAAI,CAAC,gBACH;CAGF,MAAM,WAAW,oBAAoB,KAAK;CAE1C,MAAM,iBAAiB,aAAiC;AACtD,MAAI,CAAC,UAAU;AACb,OAAI,0BAA0B,CAC5B,QAAO,KAAK,4BAA4B,WAAW;AAErD;;AAGF,MAAI,SAAS,SAAS,YAAY;AAChC,YAAS,SAAS,IAAI,EAAE,SAAS,WAAW,CAAC;AAC7C;;AAGF,MAAI,aAAa,mBAAmB,eAAe,SAAS,EAAE;AAC5D,yBAAsB,UAAU,KAAK;AACrC;;AAGF,uBACE,SAAS,SAAS,SACd,0BAA0B,SAAS,OAAO,GAC1C;GACE,SAAS,SAAS;GAClB,QAAQ,SAAS;GAClB,EACL,UACA,KACD;AAED,qBAAmB,MAAM,OAAO,MAAM;;AAGxC,KAAI,UAAU,SAAS,EAAE;AACvB,EAAK,SAAS,MAAM,SAAS,cAAc,KAAK,CAAC;AACjD;;AAGF,eAAc,SAAS;;;;;AAMzB,SAAgB,uBAA6B;AAC3C,KAAI,OAAO,WAAW,YACpB,QAAO,iBAAiB,YAAY,eAAe"}

package/dist/router/policy.d.ts

@@ -0,0 +1,22 @@
+import { AccessDecision, AccessDenyStatus, AccessRedirectStatus, RouteAuthOptions, RouteContext, RoutePolicy } from "../common/router.js";
+
+//#region src/router/policy.d.ts
+declare function allow(): AccessDecision;
+declare function redirect(to: string, init?: {
+  status?: AccessRedirectStatus;
+  replace?: boolean;
+}): AccessDecision;
+declare function deny(status: AccessDenyStatus): AccessDecision;
+declare function unauthorized(): AccessDecision;
+declare function forbidden(): AccessDecision;
+declare function notFound(): AccessDecision;
+declare function normalizeAccessDecision(result: AccessDecision): AccessDecision;
+declare function withRouteAuthOptions(context: RouteContext, auth: RouteAuthOptions | undefined): RouteContext;
+declare function requireAuth(): RoutePolicy;
+declare function requireGuest(): RoutePolicy;
+declare function requireRole(role: string): RoutePolicy;
+declare function requirePermission(permission: string): RoutePolicy;
+declare function evaluateRoutePolicy(policy: RoutePolicy, context: RouteContext): Promise<AccessDecision>;
+//#endregion
+export { allow, deny, forbidden, notFound, redirect, requireAuth, requirePermission, requireRole, unauthorized };
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","names":[],"sources":["../../src/router/policy.ts"],"mappings":";;;iBAuBgB,KAAA,CAAA,GAAS,cAAA;AAAA,iBAIT,QAAA,CACd,EAAA,UACA,IAAA;EACE,MAAA,GAAS,oBAAA;EACT,OAAA;AAAA,IAED,cAAA;AAAA,iBASa,IAAA,CAAK,MAAA,EAAQ,gBAAA,GAAmB,cAAA;AAAA,iBAIhC,YAAA,CAAA,GAAgB,cAAA;AAAA,iBAIhB,SAAA,CAAA,GAAa,cAAA;AAAA,iBAIb,QAAA,CAAA,GAAY,cAAA;AAAA,iBAIZ,uBAAA,CACd,MAAA,EAAQ,cAAA,GACP,cAAA;AAAA,iBAIa,oBAAA,CACd,OAAA,EAAS,YAAA,EACT,IAAA,EAAM,gBAAA,eACL,YAAA;AAAA,iBA8Ha,WAAA,CAAA,GAAe,WAAA;AAAA,iBAUf,YAAA,CAAA,GAAgB,WAAA;AAAA,iBAUhB,WAAA,CAAY,IAAA,WAAe,WAAA;AAAA,iBAmB3B,iBAAA,CAAkB,UAAA,WAAqB,WAAA;AAAA,iBAmBjC,mBAAA,CACpB,MAAA,EAAQ,WAAA,EACR,OAAA,EAAS,YAAA,GACR,OAAA,CAAQ,cAAA"}