@real-router/core 0.52.0 → 0.54.1

package/dist/esm/cloneRouter-C_ULpzHM.mjs

@@ -0,0 +1,2 @@
+import{m as e,n as t,t as n,u as r}from"./Router-BeMyxy_V.mjs";import{r as i}from"./internals-C59msvHY.mjs";function a(n){if(n())throw new t(e.ROUTER_DISPOSED)}const o=new WeakMap;function s(n){let r=o.get(n);if(r)return r;let s=i(n),c={makeState:(e,t,n,r)=>(s.validator?.state.validateMakeStateArgs(e,t,n),s.makeState(e,t,n,r?.params)),buildState:(e,t)=>{s.validator?.routes.validateStateBuilderArgs(e,t,`buildState`);let{name:n,params:r}=s.forwardState(e,t);return s.buildStateResolved(n,r)},forwardState:(e,t)=>(s.validator?.routes.validateStateBuilderArgs(e,t,`forwardState`),s.forwardState(e,t)),matchPath:e=>(s.validator?.routes.validateMatchPathArgs(e),s.matchPath(e,s.getOptions())),navigateToState:(e,t)=>(a(s.isDisposed),s.validator?.navigation.validateNavigateToStateArgs(e),t!==void 0&&s.validator?.navigation.validateNavigationOptions(t,`navigateToState`),s.navigateToState(e,t)),setRootPath:e=>{a(s.isDisposed),s.validator?.routes.validateSetRootPathArgs(e),s.setRootPath(e)},getRootPath:s.getRootPath,addEventListener:(e,t)=>(a(s.isDisposed),s.validator?.eventBus.validateListenerArgs(e,t),s.addEventListener(e,t)),buildNavigationState:(e,t={})=>{s.validator?.routes.validateStateBuilderArgs(e,t,`buildNavigationState`);let{name:n,params:r}=s.forwardState(e,t),i=s.buildStateResolved(n,r);if(i)return s.makeState(i.name,i.params,s.buildPath(i.name,i.params),i.meta)},getOptions:s.getOptions,getTree:s.getTree,addInterceptor:(e,t)=>{a(s.isDisposed),s.validator?.plugins.validateAddInterceptorArgs(e,t);let n=s.interceptors.get(e);return n||(n=[],s.interceptors.set(e,n)),n.push(t),()=>{let e=n.indexOf(t);e!==-1&&n.splice(e,1)}},getRouteConfig:e=>{let t=s.routeGetStore();if(t.matcher.hasRoute(e))return t.routeCustomFields[e]},extendRouter:r=>{a(s.isDisposed);let i=Object.keys(r);for(let r of i)if(r in n)throw new t(e.PLUGIN_CONFLICT,{message:`Cannot extend router: property "${r}" already exists`});for(let e of i)n[e]=r[e];let o={keys:i};s.routerExtensions.push(o);let c=!1;return()=>{if(c)return;c=!0;for(let e of o.keys)delete n[e];let e=s.routerExtensions.indexOf(o);e!==-1&&s.routerExtensions.splice(e,1)}},emitTransitionError:e=>{a(s.isDisposed),s.emitTransitionError(e)},claimContextNamespace:n=>{if(a(s.isDisposed),s.contextClaimRecords.has(n))throw new t(e.CONTEXT_NAMESPACE_ALREADY_CLAIMED,{message:`Cannot claim context namespace: "${n}" is already claimed by another plugin`});return s.contextClaimRecords.add(n),{write(e,t){e.context[n]=t},release(){s.contextClaimRecords.delete(n)}}}};return o.set(n,c),c}function c(e){let t=i(e),n=t.routeGetStore().lifecycleNamespace;return{addActivateGuard(e,r){a(t.isDisposed),t.validator?.routes.validateRouteName(e,`addActivateGuard`),t.validator?.lifecycle.validateHandler(r,`addActivateGuard`);let i=n.getHandlerCount(`activate`);t.validator?.lifecycle.validateHandlerLimit(i,t.dependenciesGetStore().limits,`canActivate`),n.addCanActivate(e,r)},addDeactivateGuard(e,r){a(t.isDisposed),t.validator?.routes.validateRouteName(e,`addDeactivateGuard`),t.validator?.lifecycle.validateHandler(r,`addDeactivateGuard`);let i=n.getHandlerCount(`deactivate`);t.validator?.lifecycle.validateHandlerLimit(i,t.dependenciesGetStore().limits,`canDeactivate`),n.addCanDeactivate(e,r)},removeActivateGuard(e){a(t.isDisposed),t.validator?.routes.validateRouteName(e,`removeActivateGuard`),n.clearCanActivate(e)},removeDeactivateGuard(e){a(t.isDisposed),t.validator?.routes.validateRouteName(e,`removeDeactivateGuard`),n.clearCanDeactivate(e)}}}function l(a,o){let s=i(a);if(s.isDisposed())throw new t(e.ROUTER_DISPOSED);s.validator?.dependencies.validateCloneArgs(o);let l=s.routeGetStore(),u=r(l.tree),d=l.config,f=l.resolvedForwardMap,p=l.routeCustomFields,m=s.cloneOptions(),h=s.cloneDependencies(),[g,_]=s.getLifecycleFactories(),v=s.getPluginFactories(),y=new n(u,m,{...h,...o}),b=c(y);for(let[e,t]of Object.entries(g))b.addDeactivateGuard(e,t);for(let[e,t]of Object.entries(_))b.addActivateGuard(e,t);v.length>0&&y.usePlugin(...v);let x=i(y).routeGetStore();return Object.assign(x.config.decoders,d.decoders),Object.assign(x.config.encoders,d.encoders),Object.assign(x.config.defaultParams,d.defaultParams),Object.assign(x.config.forwardMap,d.forwardMap),Object.assign(x.config.forwardFnMap,d.forwardFnMap),Object.assign(x.resolvedForwardMap,f),Object.assign(x.routeCustomFields,p),y}export{a as i,c as n,s as r,l as t};
+//# sourceMappingURL=cloneRouter-C_ULpzHM.mjs.map

package/dist/esm/cloneRouter-C_ULpzHM.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneRouter-C_ULpzHM.mjs","names":["routeTreeToDefinitions","RouterClass"],"sources":["../../src/api/helpers.ts","../../src/api/getPluginApi.ts","../../src/api/getLifecycleApi.ts","../../src/api/cloneRouter.ts"],"sourcesContent":["// packages/core/src/api/helpers.ts\n\nimport { errorCodes } from \"../constants\";\nimport { RouterError } from \"../RouterError\";\n\nexport function throwIfDisposed(isDisposed: () => boolean): void {\n  if (isDisposed()) {\n    throw new RouterError(errorCodes.ROUTER_DISPOSED);\n  }\n}\n","import { throwIfDisposed } from \"./helpers\";\nimport { errorCodes } from \"../constants\";\nimport { getInternals } from \"../internals\";\nimport { RouterError } from \"../RouterError\";\n\nimport type { PluginApi } from \"./types\";\nimport type {\n  ContextNamespaceClaim,\n  DefaultDependencies,\n  Params,\n  Router,\n  State,\n} from \"@real-router/types\";\n\n// Cache the assembled PluginApi per router — mirrors getNavigator() (#525):\n// avoids re-allocating the closure-bag on each call (plugins call this once\n// at init, but tests + nested plugins poll it), and gives spy/stub helpers\n// a stable object identity to attach to (e.g. spying on\n// `getPluginApi(router).navigateToState` to inject errors in popstate\n// recovery tests).\nconst cache = new WeakMap<object, PluginApi>();\n\nexport function getPluginApi<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(router: Router<Dependencies>): PluginApi {\n  const cached = cache.get(router);\n\n  if (cached) {\n    return cached;\n  }\n\n  const ctx = getInternals(router);\n  const api: PluginApi = {\n    makeState: (name, params, path, meta) => {\n      ctx.validator?.state.validateMakeStateArgs(name, params, path);\n\n      return ctx.makeState(\n        name,\n        params,\n        path,\n        meta?.params as\n          | Record<string, Record<string, \"url\" | \"query\">>\n          | undefined,\n      );\n    },\n    buildState: (routeName, routeParams) => {\n      ctx.validator?.routes.validateStateBuilderArgs(\n        routeName,\n        routeParams,\n        \"buildState\",\n      );\n\n      const { name, params } = ctx.forwardState(routeName, routeParams);\n\n      return ctx.buildStateResolved(name, params);\n    },\n    forwardState: <P extends Params = Params>(\n      routeName: string,\n      routeParams: P,\n    ) => {\n      ctx.validator?.routes.validateStateBuilderArgs(\n        routeName,\n        routeParams,\n        \"forwardState\",\n      );\n\n      return ctx.forwardState(routeName, routeParams);\n    },\n    matchPath: (path) => {\n      ctx.validator?.routes.validateMatchPathArgs(path);\n\n      return ctx.matchPath(path, ctx.getOptions());\n    },\n    navigateToState: (state, options) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.navigation.validateNavigateToStateArgs(state);\n\n      if (options !== undefined) {\n        ctx.validator?.navigation.validateNavigationOptions(\n          options,\n          \"navigateToState\",\n        );\n      }\n\n      return ctx.navigateToState(state, options);\n    },\n    setRootPath: (rootPath) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateSetRootPathArgs(rootPath);\n\n      ctx.setRootPath(rootPath);\n    },\n    getRootPath: ctx.getRootPath,\n    addEventListener: (eventName, cb) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.eventBus.validateListenerArgs(eventName, cb);\n\n      return ctx.addEventListener(eventName, cb);\n    },\n    buildNavigationState: (name, params = {}) => {\n      ctx.validator?.routes.validateStateBuilderArgs(\n        name,\n        params,\n        \"buildNavigationState\",\n      );\n\n      const { name: resolvedName, params: resolvedParams } = ctx.forwardState(\n        name,\n        params,\n      );\n      const routeInfo = ctx.buildStateResolved(resolvedName, resolvedParams);\n\n      if (!routeInfo) {\n        return;\n      }\n\n      return ctx.makeState(\n        routeInfo.name,\n        routeInfo.params,\n        ctx.buildPath(routeInfo.name, routeInfo.params),\n        routeInfo.meta,\n      );\n    },\n    getOptions: ctx.getOptions,\n    getTree: ctx.getTree,\n    addInterceptor: (method, fn) => {\n      throwIfDisposed(ctx.isDisposed);\n      ctx.validator?.plugins.validateAddInterceptorArgs(method, fn);\n      let list = ctx.interceptors.get(method);\n\n      if (!list) {\n        list = [];\n        ctx.interceptors.set(method, list);\n      }\n\n      list.push(fn);\n\n      return () => {\n        const index = list.indexOf(fn);\n\n        if (index !== -1) {\n          list.splice(index, 1);\n        }\n      };\n    },\n    getRouteConfig: (name) => {\n      const store = ctx.routeGetStore();\n\n      if (!store.matcher.hasRoute(name)) {\n        return;\n      }\n\n      return store.routeCustomFields[name];\n    },\n    extendRouter: (extensions: Record<string, unknown>) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      const keys = Object.keys(extensions);\n\n      for (const key of keys) {\n        if (key in router) {\n          throw new RouterError(errorCodes.PLUGIN_CONFLICT, {\n            message: `Cannot extend router: property \"${key}\" already exists`,\n          });\n        }\n      }\n\n      for (const key of keys) {\n        (router as Record<string, unknown>)[key] = extensions[key];\n      }\n\n      const extensionRecord = { keys };\n\n      ctx.routerExtensions.push(extensionRecord);\n\n      let removed = false;\n\n      return () => {\n        if (removed) {\n          return;\n        }\n\n        removed = true;\n\n        for (const key of extensionRecord.keys) {\n          delete (router as Record<string, unknown>)[key];\n        }\n\n        const idx = ctx.routerExtensions.indexOf(extensionRecord);\n\n        if (idx !== -1) {\n          ctx.routerExtensions.splice(idx, 1);\n        }\n      };\n    },\n    emitTransitionError: (error) => {\n      throwIfDisposed(ctx.isDisposed);\n      ctx.emitTransitionError(error);\n    },\n    claimContextNamespace: (namespace: string) => {\n      throwIfDisposed(ctx.isDisposed);\n\n      if (ctx.contextClaimRecords.has(namespace)) {\n        throw new RouterError(errorCodes.CONTEXT_NAMESPACE_ALREADY_CLAIMED, {\n          message: `Cannot claim context namespace: \"${namespace}\" is already claimed by another plugin`,\n        });\n      }\n\n      ctx.contextClaimRecords.add(namespace);\n\n      return {\n        write(state: State, value: unknown) {\n          state.context[namespace] = value;\n        },\n        release() {\n          ctx.contextClaimRecords.delete(namespace);\n        },\n      } satisfies ContextNamespaceClaim;\n    },\n  };\n\n  cache.set(router, api);\n\n  return api;\n}\n","import { throwIfDisposed } from \"./helpers\";\nimport { getInternals } from \"../internals\";\n\nimport type { LifecycleApi } from \"./types\";\nimport type { DefaultDependencies, Router } from \"@real-router/types\";\n\nexport function getLifecycleApi<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(router: Router<Dependencies>): LifecycleApi<Dependencies> {\n  const ctx = getInternals(router);\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- guaranteed set after wiring\n  const lifecycleNamespace = ctx.routeGetStore().lifecycleNamespace!;\n\n  return {\n    addActivateGuard(name, handler) {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateRouteName(name, \"addActivateGuard\");\n      ctx.validator?.lifecycle.validateHandler(handler, \"addActivateGuard\");\n\n      const activateCount = lifecycleNamespace.getHandlerCount(\"activate\");\n\n      ctx.validator?.lifecycle.validateHandlerLimit(\n        activateCount,\n        ctx.dependenciesGetStore().limits,\n        \"canActivate\",\n      );\n\n      lifecycleNamespace.addCanActivate(name, handler);\n    },\n\n    addDeactivateGuard(name, handler) {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateRouteName(name, \"addDeactivateGuard\");\n      ctx.validator?.lifecycle.validateHandler(handler, \"addDeactivateGuard\");\n\n      const deactivateCount = lifecycleNamespace.getHandlerCount(\"deactivate\");\n\n      ctx.validator?.lifecycle.validateHandlerLimit(\n        deactivateCount,\n        ctx.dependenciesGetStore().limits,\n        \"canDeactivate\",\n      );\n\n      lifecycleNamespace.addCanDeactivate(name, handler);\n    },\n\n    removeActivateGuard(name) {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateRouteName(name, \"removeActivateGuard\");\n\n      lifecycleNamespace.clearCanActivate(name);\n    },\n\n    removeDeactivateGuard(name) {\n      throwIfDisposed(ctx.isDisposed);\n\n      ctx.validator?.routes.validateRouteName(name, \"removeDeactivateGuard\");\n\n      lifecycleNamespace.clearCanDeactivate(name);\n    },\n  };\n}\n","import { routeTreeToDefinitions } from \"route-tree\";\n\nimport { errorCodes } from \"../constants\";\nimport { getInternals } from \"../internals\";\nimport { Router as RouterClass } from \"../Router\";\nimport { RouterError } from \"../RouterError\";\nimport { getLifecycleApi } from \"./getLifecycleApi\";\n\nimport type { Route } from \"../types\";\nimport type { DefaultDependencies, Router } from \"@real-router/types\";\n\nexport function cloneRouter<\n  Dependencies extends DefaultDependencies = DefaultDependencies,\n>(\n  router: Router<Dependencies>,\n  dependencies?: Dependencies,\n): RouterClass<Dependencies> {\n  const ctx = getInternals(router);\n\n  if (ctx.isDisposed()) {\n    throw new RouterError(errorCodes.ROUTER_DISPOSED);\n  }\n\n  ctx.validator?.dependencies.validateCloneArgs(dependencies);\n\n  // Get source store directly\n  const sourceStore = ctx.routeGetStore();\n  const routes = routeTreeToDefinitions(sourceStore.tree);\n  const routeConfig = sourceStore.config;\n  const resolvedForwardMap = sourceStore.resolvedForwardMap;\n  const routeCustomFields = sourceStore.routeCustomFields;\n\n  const options = ctx.cloneOptions();\n  const sourceDeps = ctx.cloneDependencies();\n  const [canDeactivateFactories, canActivateFactories] =\n    ctx.getLifecycleFactories();\n  const pluginFactories = ctx.getPluginFactories();\n\n  const mergedDeps = {\n    ...sourceDeps,\n    ...dependencies,\n  } as Dependencies;\n\n  const newRouter = new RouterClass<Dependencies>(\n    routes as Route<Dependencies>[],\n    options,\n    mergedDeps,\n  );\n\n  const lifecycle = getLifecycleApi(newRouter);\n\n  for (const [name, handler] of Object.entries(canDeactivateFactories)) {\n    lifecycle.addDeactivateGuard(name, handler);\n  }\n\n  for (const [name, handler] of Object.entries(canActivateFactories)) {\n    lifecycle.addActivateGuard(name, handler);\n  }\n\n  if (pluginFactories.length > 0) {\n    newRouter.usePlugin(...pluginFactories);\n  }\n\n  const newCtx = getInternals(newRouter);\n  const newStore = newCtx.routeGetStore();\n\n  // Apply cloned config directly to new store\n  Object.assign(newStore.config.decoders, routeConfig.decoders);\n  Object.assign(newStore.config.encoders, routeConfig.encoders);\n  Object.assign(newStore.config.defaultParams, routeConfig.defaultParams);\n  Object.assign(newStore.config.forwardMap, routeConfig.forwardMap);\n  Object.assign(newStore.config.forwardFnMap, routeConfig.forwardFnMap);\n  Object.assign(newStore.resolvedForwardMap, resolvedForwardMap);\n  Object.assign(newStore.routeCustomFields, routeCustomFields);\n\n  return newRouter;\n}\n"],"mappings":"4GAKA,SAAgB,EAAgB,EAAiC,CAC/D,GAAI,EAAW,EACb,MAAM,IAAI,EAAY,EAAW,eAAe,CAEpD,CCWA,MAAM,EAAQ,IAAI,QAElB,SAAgB,EAEd,EAAyC,CACzC,IAAM,EAAS,EAAM,IAAI,CAAM,EAE/B,GAAI,EACF,OAAO,EAGT,IAAM,EAAM,EAAa,CAAM,EACzB,EAAiB,CACrB,WAAY,EAAM,EAAQ,EAAM,KAC9B,EAAI,WAAW,MAAM,sBAAsB,EAAM,EAAQ,CAAI,EAEtD,EAAI,UACT,EACA,EACA,EACA,GAAM,MAGR,GAEF,YAAa,EAAW,IAAgB,CACtC,EAAI,WAAW,OAAO,yBACpB,EACA,EACA,YACF,EAEA,GAAM,CAAE,OAAM,UAAW,EAAI,aAAa,EAAW,CAAW,EAEhE,OAAO,EAAI,mBAAmB,EAAM,CAAM,CAC5C,EACA,cACE,EACA,KAEA,EAAI,WAAW,OAAO,yBACpB,EACA,EACA,cACF,EAEO,EAAI,aAAa,EAAW,CAAW,GAEhD,UAAY,IACV,EAAI,WAAW,OAAO,sBAAsB,CAAI,EAEzC,EAAI,UAAU,EAAM,EAAI,WAAW,CAAC,GAE7C,iBAAkB,EAAO,KACvB,EAAgB,EAAI,UAAU,EAE9B,EAAI,WAAW,WAAW,4BAA4B,CAAK,EAEvD,IAAY,IAAA,IACd,EAAI,WAAW,WAAW,0BACxB,EACA,iBACF,EAGK,EAAI,gBAAgB,EAAO,CAAO,GAE3C,YAAc,GAAa,CACzB,EAAgB,EAAI,UAAU,EAE9B,EAAI,WAAW,OAAO,wBAAwB,CAAQ,EAEtD,EAAI,YAAY,CAAQ,CAC1B,EACA,YAAa,EAAI,YACjB,kBAAmB,EAAW,KAC5B,EAAgB,EAAI,UAAU,EAE9B,EAAI,WAAW,SAAS,qBAAqB,EAAW,CAAE,EAEnD,EAAI,iBAAiB,EAAW,CAAE,GAE3C,sBAAuB,EAAM,EAAS,CAAC,IAAM,CAC3C,EAAI,WAAW,OAAO,yBACpB,EACA,EACA,sBACF,EAEA,GAAM,CAAE,KAAM,EAAc,OAAQ,GAAmB,EAAI,aACzD,EACA,CACF,EACM,EAAY,EAAI,mBAAmB,EAAc,CAAc,EAEhE,KAIL,OAAO,EAAI,UACT,EAAU,KACV,EAAU,OACV,EAAI,UAAU,EAAU,KAAM,EAAU,MAAM,EAC9C,EAAU,IACZ,CACF,EACA,WAAY,EAAI,WAChB,QAAS,EAAI,QACb,gBAAiB,EAAQ,IAAO,CAC9B,EAAgB,EAAI,UAAU,EAC9B,EAAI,WAAW,QAAQ,2BAA2B,EAAQ,CAAE,EAC5D,IAAI,EAAO,EAAI,aAAa,IAAI,CAAM,EAStC,OAPK,IACH,EAAO,CAAC,EACR,EAAI,aAAa,IAAI,EAAQ,CAAI,GAGnC,EAAK,KAAK,CAAE,MAEC,CACX,IAAM,EAAQ,EAAK,QAAQ,CAAE,EAEzB,IAAU,IACZ,EAAK,OAAO,EAAO,CAAC,CAExB,CACF,EACA,eAAiB,GAAS,CACxB,IAAM,EAAQ,EAAI,cAAc,EAE3B,KAAM,QAAQ,SAAS,CAAI,EAIhC,OAAO,EAAM,kBAAkB,EACjC,EACA,aAAe,GAAwC,CACrD,EAAgB,EAAI,UAAU,EAE9B,IAAM,EAAO,OAAO,KAAK,CAAU,EAEnC,IAAK,IAAM,KAAO,EAChB,GAAI,KAAO,EACT,MAAM,IAAI,EAAY,EAAW,gBAAiB,CAChD,QAAS,mCAAmC,EAAI,iBAClD,CAAC,EAIL,IAAK,IAAM,KAAO,EAChB,EAAoC,GAAO,EAAW,GAGxD,IAAM,EAAkB,CAAE,MAAK,EAE/B,EAAI,iBAAiB,KAAK,CAAe,EAEzC,IAAI,EAAU,GAEd,UAAa,CACX,GAAI,EACF,OAGF,EAAU,GAEV,IAAK,IAAM,KAAO,EAAgB,KAChC,OAAQ,EAAmC,GAG7C,IAAM,EAAM,EAAI,iBAAiB,QAAQ,CAAe,EAEpD,IAAQ,IACV,EAAI,iBAAiB,OAAO,EAAK,CAAC,CAEtC,CACF,EACA,oBAAsB,GAAU,CAC9B,EAAgB,EAAI,UAAU,EAC9B,EAAI,oBAAoB,CAAK,CAC/B,EACA,sBAAwB,GAAsB,CAG5C,GAFA,EAAgB,EAAI,UAAU,EAE1B,EAAI,oBAAoB,IAAI,CAAS,EACvC,MAAM,IAAI,EAAY,EAAW,kCAAmC,CAClE,QAAS,oCAAoC,EAAU,uCACzD,CAAC,EAKH,OAFA,EAAI,oBAAoB,IAAI,CAAS,EAE9B,CACL,MAAM,EAAc,EAAgB,CAClC,EAAM,QAAQ,GAAa,CAC7B,EACA,SAAU,CACR,EAAI,oBAAoB,OAAO,CAAS,CAC1C,CACF,CACF,CACF,EAIA,OAFA,EAAM,IAAI,EAAQ,CAAG,EAEd,CACT,CC7NA,SAAgB,EAEd,EAA0D,CAC1D,IAAM,EAAM,EAAa,CAAM,EAEzB,EAAqB,EAAI,cAAc,EAAE,mBAE/C,MAAO,CACL,iBAAiB,EAAM,EAAS,CAC9B,EAAgB,EAAI,UAAU,EAE9B,EAAI,WAAW,OAAO,kBAAkB,EAAM,kBAAkB,EAChE,EAAI,WAAW,UAAU,gBAAgB,EAAS,kBAAkB,EAEpE,IAAM,EAAgB,EAAmB,gBAAgB,UAAU,EAEnE,EAAI,WAAW,UAAU,qBACvB,EACA,EAAI,qBAAqB,EAAE,OAC3B,aACF,EAEA,EAAmB,eAAe,EAAM,CAAO,CACjD,EAEA,mBAAmB,EAAM,EAAS,CAChC,EAAgB,EAAI,UAAU,EAE9B,EAAI,WAAW,OAAO,kBAAkB,EAAM,oBAAoB,EAClE,EAAI,WAAW,UAAU,gBAAgB,EAAS,oBAAoB,EAEtE,IAAM,EAAkB,EAAmB,gBAAgB,YAAY,EAEvE,EAAI,WAAW,UAAU,qBACvB,EACA,EAAI,qBAAqB,EAAE,OAC3B,eACF,EAEA,EAAmB,iBAAiB,EAAM,CAAO,CACnD,EAEA,oBAAoB,EAAM,CACxB,EAAgB,EAAI,UAAU,EAE9B,EAAI,WAAW,OAAO,kBAAkB,EAAM,qBAAqB,EAEnE,EAAmB,iBAAiB,CAAI,CAC1C,EAEA,sBAAsB,EAAM,CAC1B,EAAgB,EAAI,UAAU,EAE9B,EAAI,WAAW,OAAO,kBAAkB,EAAM,uBAAuB,EAErE,EAAmB,mBAAmB,CAAI,CAC5C,CACF,CACF,CCrDA,SAAgB,EAGd,EACA,EAC2B,CAC3B,IAAM,EAAM,EAAa,CAAM,EAE/B,GAAI,EAAI,WAAW,EACjB,MAAM,IAAI,EAAY,EAAW,eAAe,EAGlD,EAAI,WAAW,aAAa,kBAAkB,CAAY,EAG1D,IAAM,EAAc,EAAI,cAAc,EAChC,EAASA,EAAuB,EAAY,IAAI,EAChD,EAAc,EAAY,OAC1B,EAAqB,EAAY,mBACjC,EAAoB,EAAY,kBAEhC,EAAU,EAAI,aAAa,EAC3B,EAAa,EAAI,kBAAkB,EACnC,CAAC,EAAwB,GAC7B,EAAI,sBAAsB,EACtB,EAAkB,EAAI,mBAAmB,EAOzC,EAAY,IAAIC,EACpB,EACA,EACA,CAPA,GAAG,EACH,GAAG,CAMM,CACX,EAEM,EAAY,EAAgB,CAAS,EAE3C,IAAK,GAAM,CAAC,EAAM,KAAY,OAAO,QAAQ,CAAsB,EACjE,EAAU,mBAAmB,EAAM,CAAO,EAG5C,IAAK,GAAM,CAAC,EAAM,KAAY,OAAO,QAAQ,CAAoB,EAC/D,EAAU,iBAAiB,EAAM,CAAO,EAGtC,EAAgB,OAAS,GAC3B,EAAU,UAAU,GAAG,CAAe,EAIxC,IAAM,EADS,EAAa,CACN,EAAE,cAAc,EAWtC,OARA,OAAO,OAAO,EAAS,OAAO,SAAU,EAAY,QAAQ,EAC5D,OAAO,OAAO,EAAS,OAAO,SAAU,EAAY,QAAQ,EAC5D,OAAO,OAAO,EAAS,OAAO,cAAe,EAAY,aAAa,EACtE,OAAO,OAAO,EAAS,OAAO,WAAY,EAAY,UAAU,EAChE,OAAO,OAAO,EAAS,OAAO,aAAc,EAAY,YAAY,EACpE,OAAO,OAAO,EAAS,mBAAoB,CAAkB,EAC7D,OAAO,OAAO,EAAS,kBAAmB,CAAiB,EAEpD,CACT"}

package/dist/esm/{Router-BeXr2zW4.d.mts → index-DNjaY7KH.d.mts}

@@ -1,5 +1,3 @@
-import { DefaultDependencies, EventMethodMap, GuardFnFactory, LeaveFn, LimitsConfig, NavigationOptions, Options, Params, PluginFactory, Route, RouteConfigUpdate, RouteTreeState, Router, State, SubscribeFn, Unsubscribe } from "@real-router/types";
-
 //#region ../path-matcher/dist/esm/index.d.mts
 //#region src/types.d.ts
 /**
@@ -232,7 +230,7 @@ type NumberFormat = "none" | "auto";
 /**
  * Options for search-params parsing and building.
  */
-interface Options$1 {
+interface Options {
   /** Array parameter encoding format. @default "none" */
   arrayFormat?: ArrayFormat;
   /** Boolean parameter encoding format. @default "auto" */
@@ -309,7 +307,7 @@ interface RouteTree {
  *
  * Controls how arrays, booleans, nulls, and numbers are serialized in query strings.
  */
-type QueryParamsConfig = Readonly<Options$1>;
+type QueryParamsConfig = Readonly<Options>;
 /**
  * Options for creating a path matcher.
  */
@@ -344,68 +342,5 @@ type Matcher = SegmentMatcher;
  * ```
  */
 //#endregion
-//#region src/types.d.ts
-/**
- * Immutable limits configuration type.
- */
-type Limits = Readonly<LimitsConfig>;
-/**
- * Extended build result that includes segments for path building.
- * Used internally to avoid duplicate getSegmentsByName calls.
- *
- * @param segments - Route segments from getSegmentsByName (typed as unknown[] for cross-package compatibility)
- * @internal
- */
-interface BuildStateResultWithSegments<P extends Params = Params> {
-  readonly state: RouteTreeState<P>;
-  readonly segments: readonly unknown[];
-}
-//#endregion
-//#region src/Router.d.ts
-/**
- * Router class with integrated namespace architecture.
- *
- * All functionality is provided by namespace classes:
- * - OptionsNamespace: getOptions (immutable)
- * - DependenciesStore: get/set/remove dependencies
- * - EventEmitter: subscribe
- * - StateNamespace: state storage (getState, setState, getPreviousState)
- * - RoutesNamespace: route tree operations
- * - RouteLifecycleNamespace: canActivate/canDeactivate guards
- * - PluginsNamespace: plugin lifecycle
- * - NavigationNamespace: navigate
- * - RouterLifecycleNamespace: start, stop, isStarted
- *
- * @internal This class implementation is internal. Use createRouter() instead.
- */
-declare class Router$1<Dependencies extends DefaultDependencies = DefaultDependencies> implements Router<Dependencies> {
-  #private;
-  [key: string]: unknown;
-  /**
-   * @param routes - Route definitions
-   * @param options - Router options
-   * @param dependencies - DI dependencies
-   */
-  constructor(routes?: Route<Dependencies>[], options?: Partial<Options>, dependencies?: Dependencies);
-  isActiveRoute(name: string, params?: Params, strictEquality?: boolean, ignoreQueryParams?: boolean): boolean;
-  buildPath(route: string, params?: Params): string;
-  getState<P extends Params = Params>(): State<P> | undefined;
-  getPreviousState(): State | undefined;
-  areStatesEqual(state1: State | undefined, state2: State | undefined, ignoreQueryParams?: boolean): boolean;
-  shouldUpdateNode(nodeName: string): (toState: State, fromState?: State) => boolean;
-  isActive(): boolean;
-  start(startPath: string): Promise<State>;
-  stop(): this;
-  dispose(): void;
-  canNavigateTo(name: string, params?: Params): boolean;
-  usePlugin(...plugins: (PluginFactory<Dependencies> | false | null | undefined)[]): Unsubscribe;
-  subscribe(listener: SubscribeFn): Unsubscribe;
-  subscribeLeave(listener: LeaveFn): Unsubscribe;
-  isLeaveApproved(): boolean;
-  navigate(routeName: string, routeParams?: Params, options?: NavigationOptions): Promise<State>;
-  navigateToDefault(options?: NavigationOptions): Promise<State>;
-  navigateToNotFound(path?: string): State;
-}
-//#endregion
-export { Limits as a, RouteConfigUpdate as c, RouteDefinition as d, RouteTree as f, GuardFnFactory as i, CreateMatcherOptions as l, BuildStateResultWithSegments as n, PluginFactory as o, EventMethodMap as r, Route as s, Router$1 as t, Matcher as u };
-//# sourceMappingURL=Router-BeXr2zW4.d.mts.map
+export { RouteTree as i, Matcher as n, RouteDefinition as r, CreateMatcherOptions as t };
+//# sourceMappingURL=index-DNjaY7KH.d.mts.map

package/dist/esm/index-DNjaY7KH.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DNjaY7KH.d.mts","names":["ConstraintPattern","RegExp","pattern","constraint","ParamMeta","Record","Readonly","ReadonlyMap","urlParams","queryParams","spatParams","paramTypeMap","constraintPatterns","pathPattern","URLParamsEncodingType","MatcherInputNode","name","path","fullName","absolute","children","nonAbsoluteChildren","paramMeta","staticPath","CompiledRoute","ReadonlySet","BuildParamSlot","MatchResult","parent","depth","matchSegments","meta","declaredQueryParams","declaredQueryParamsSet","hasTrailingSlash","hasConstraints","buildStaticParts","buildParamSlots","buildParamNamesSet","cachedResult","forwardTo","defaultParams","paramName","encoder","value","isOptional","BuildPathOptions","queryParamsMode","trailingSlash","SegmentNode","staticChildren","hasChildren","paramChild","node","splatChild","route","slashChildRoute","segments","params","SegmentMatcherOptions","caseSensitive","strictTrailingSlash","strictQueryParams","urlParamsEncoding","parseQueryString","queryString","buildQueryString","ResolvedMatcherOptions","buildParamMeta","validateConstraints","encodeURIComponentExcludingSubDelims","segment","ENCODING_METHODS","param","DECODING_METHODS","encodeParam","encoding","isSpatParam","createSegmentNode","SegmentMatcher","private","options","constructor","registerTree","match","buildPath","getSegmentsByName","getMetaByName","hasRoute","setRootPath","rootPath","ArrayFormat","BooleanFormat","NullFormat","NumberFormat","Options","arrayFormat","booleanFormat","nullFormat","numberFormat","FinalOptions","QueryParamPrimitive","QueryParamValue","SearchParams","Record","OmitResponse","querystring","removedParams","KeepResponse","keptParams","DecodeResult","parse","path","opts","parseInto","queryString","target","build","params","omit","paramsToOmit","keep","paramsToKeep","DEFAULT_QUERY_PARAMS","ParamMeta","SegmentMatcher","URLParamsEncodingType","DEFAULT_QUERY_PARAMS","Options","RouteDefinition","key","name","path","children","RouteTree","ReadonlyMap","Record","Readonly","absolute","paramMeta","parent","nonAbsoluteChildren","fullName","staticPath","paramTypeMap","TreeBuildOptions","skipFreeze","QueryParamsMode","TrailingSlashMode","BasePathOptions","trailingSlashMode","queryParamsMode","queryParams","urlParamsEncoding","BuildOptions","ignoreConstraints","MatchOptions","strictTrailingSlash","strongMatching","ParamSource","ParamTypeMap","RouteTreeStateMeta","MatchResult","P","RouteParams","segments","params","meta","RouteTreeState","createRouteTree","routes","options","getSegmentsByName","tree","routeName","nodeToDefinition","node","routeTreeToDefinitions","QueryParamsConfig","CreateMatcherOptions","caseSensitive","strictQueryParams","Matcher","createMatcher","validateRoute","Set","Map","route","methodName","rootNode","parentName","seenNames","seenPathsByParent"],"sources":["../../../path-matcher/dist/esm/index.d.mts","../../../search-params/dist/esm/index.d.mts","../../../route-tree/dist/esm/index.d.mts"],"mappings":"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"}

package/dist/esm/index-r_JTvSBH.d.mts

@@ -0,0 +1,306 @@
+import { t as Router$1 } from "./Router-BmhiDQUJ.mjs";
+import { DefaultDependencies, Params, Router, State } from "@real-router/types";
+
+//#region src/utils/createRequestScope.d.ts
+/**
+ * Subset of Node's `http.IncomingMessage` that `createRequestScope` relies on:
+ * a `"close"` event indicating that the client disconnected (or the response
+ * was fully sent) and the standard `removeListener` cleanup hook.
+ */
+interface IncomingMessageLike {
+  on: (event: "close", listener: () => void) => unknown;
+  removeListener?: (event: "close", listener: () => void) => unknown;
+}
+/**
+ * Web `Request`-shaped object — anything carrying an `AbortSignal`. Web
+ * runtimes (Bun, Cloudflare Workers, Vite RSC) surface client-disconnect via
+ * `request.signal` directly, so no listener attachment is needed.
+ */
+interface RequestLike {
+  signal: AbortSignal;
+}
+type RequestScopeSource = IncomingMessageLike | RequestLike;
+interface RequestScope<Dependencies extends DefaultDependencies = DefaultDependencies> extends AsyncDisposable {
+  /**
+   * Per-request router clone. Carries `abortSignal` injected into its
+   * dependencies — loaders can `getDep("abortSignal")` and pass it to fetch /
+   * `withTimeout` for cooperative cancellation when the client disconnects.
+   */
+  readonly router: Router$1<Dependencies>;
+  /**
+   * Aborts when the request closes (Node `IncomingMessage`'s `"close"` event)
+   * or when the upstream Web `Request.signal` aborts.
+   */
+  readonly signal: AbortSignal;
+  /**
+   * Detach the close listener (if attached to a Node `IncomingMessage`) and
+   * dispose the cloned router. Idempotent — safe to call multiple times or in
+   * combination with `Symbol.asyncDispose`.
+   */
+  dispose: () => Promise<void>;
+}
+/**
+ * Build a per-request router scope: clones `base`, attaches an `AbortSignal`
+ * tied to the request's lifetime, and exposes `dispose()` (plus
+ * `Symbol.asyncDispose` for `await using` declarations).
+ *
+ * Replaces the four-step boilerplate that every server entry repeats:
+ *
+ * 1. `new AbortController()` per request
+ * 2. `req.on("close", () => controller.abort())`
+ * 3. `cloneRouter(base, { ...deps, abortSignal: signal })`
+ * 4. `try { ... } finally { router.dispose() }`
+ *
+ * The signal is injected into the router clone under `abortSignal` so existing
+ * loaders that read `getDep("abortSignal")` keep working without changes.
+ *
+ * ## `await using` compatibility
+ *
+ * The scope implements `Symbol.asyncDispose`, so `await using scope = …` is
+ * supported on runtimes that ship the well-known `Symbol.asyncDispose`:
+ *
+ * - **Node.js 24+** (full support; partial in 20.4–20.17 only for `fs`/`stream`)
+ * - **Bun 1.0.23+**, **Deno 1.37+**
+ * - **Chrome / Edge 127+**, **Firefox 141+**
+ * - **Safari**: not yet supported (irrelevant in practice — this helper is
+ *   server-side only and never reaches the browser)
+ *
+ * On Node.js 22 LTS the well-known symbol is unavailable, so `await using`
+ * fails. **The bundled SSR examples therefore use the explicit
+ * `try/finally` + `await scope.dispose()` form**, which works on every
+ * runtime. Use `await using` only when you control the deployment target and
+ * know it ships the symbol.
+ *
+ * @example
+ * ```typescript
+ * // Explicit dispose — works on Node 18+, all browsers, every CI image
+ * export async function render(url: string, req: IncomingMessage) {
+ *   const scope = createRequestScope(req, baseRouter, { currentUser });
+ *   try {
+ *     scope.router.usePlugin(ssrDataPluginFactory(loaders));
+ *     return await renderShell(scope.router, url);
+ *   } finally {
+ *     await scope.dispose();
+ *   }
+ * }
+ *
+ * // `await using` — Node 24+, Bun, Deno, modern browsers
+ * export async function render(url: string, req: IncomingMessage) {
+ *   await using scope = createRequestScope(req, baseRouter, { currentUser });
+ *   scope.router.usePlugin(ssrDataPluginFactory(loaders));
+ *   return await renderShell(scope.router, url);
+ * }
+ *
+ * // Web runtime (signal already on the request)
+ * async function handler(request: Request) {
+ *   const scope = createRequestScope(request, baseRouter, { db });
+ *   try {
+ *     scope.router.usePlugin(rscServerPluginFactory(loaders));
+ *     return await render(scope.router, request.url);
+ *   } finally {
+ *     await scope.dispose();
+ *   }
+ * }
+ * ```
+ */
+declare function createRequestScope<Dependencies extends DefaultDependencies = DefaultDependencies>(request: RequestScopeSource, base: Router<Dependencies>, deps?: Partial<Dependencies>): RequestScope<Dependencies>;
+//#endregion
+//#region src/utils/getStaticPaths.d.ts
+type StaticPathEntries = Record<string, () => Promise<Record<string, string>[]>>;
+declare function getStaticPaths<Dependencies extends DefaultDependencies = DefaultDependencies>(router: Router<Dependencies>, entries?: StaticPathEntries): Promise<string[]>;
+//#endregion
+//#region src/utils/hydrateRouter.d.ts
+/**
+ * Custom deserializer signature for {@link hydrateRouter} (#606). Compatible
+ * with `JSON.parse` (default), `devalue.parse`, `superjson.parse`, or any
+ * user-supplied function.
+ */
+type Deserialize = (json: string) => unknown;
+interface HydrateRouterOptions {
+  /**
+   * Custom deserializer (e.g., `devalue.parse` / `superjson.parse`) for
+   * matching the `serialize` passed to {@link serializeRouterState}. Defaults
+   * to `JSON.parse`. Ignored when `source` is already an object.
+   *
+   * @default JSON.parse
+   *
+   * @example
+   * ```typescript
+   * import * as devalue from "devalue";
+   * await hydrateRouter(router, ssrJson, { deserialize: devalue.parse });
+   * ```
+   */
+  deserialize?: Deserialize;
+}
+/**
+ * Hydrate a fresh router from server-serialized State (#563, #596).
+ *
+ * Accepts either a JSON string (parsed via `JSON.parse` by default, or
+ * `options.deserialize` when provided) or a State-shaped object. Extracts
+ * `state.path` and delegates to `router.start(state.path)` — the canonical
+ * URL is the source of truth for the router on hydration.
+ *
+ * The full parsed state (incl. `state.context.<namespace>` payloads) is
+ * deposited into a one-shot scratchpad on `RouterInternals.hydrationState`
+ * before `start()` is invoked and cleared in the matching `finally`. SSR
+ * loader plugins (`@real-router/ssr-data-plugin`,
+ * `@real-router/rsc-server-plugin`) read this scratchpad to skip their loader
+ * call when the server-resolved namespace value is already present — avoiding
+ * the post-hydration loader re-run on first paint.
+ *
+ * Single-shot semantics: the scratchpad is consumed during the first `start()`
+ * triggered by `hydrateRouter` regardless of route mismatch; subsequent
+ * `start()` calls run loaders normally.
+ *
+ * @example
+ * ```typescript
+ * // Client
+ * const router = createAppRouter();
+ * router.usePlugin(browserPluginFactory());
+ * await hydrateRouter(router, window.__SSR_STATE__);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With non-JSON types (Date / Map / Set / RegExp / BigInt) via devalue (#606)
+ * import * as devalue from "devalue";
+ *
+ * await hydrateRouter(router, window.__SSR_STATE__, {
+ *   deserialize: devalue.parse,
+ * });
+ * ```
+ */
+declare function hydrateRouter(router: Router, source: string | {
+  path: string;
+}, options?: HydrateRouterOptions): Promise<State>;
+//#endregion
+//#region src/utils/serializeState.d.ts
+/**
+ * Custom serializer signature for {@link serializeState} (#606).
+ *
+ * Compatible with `JSON.stringify` (default) as well as `devalue.stringify`,
+ * `superjson.stringify`, or any user-supplied function that returns a JSON
+ * string. The output is run through XSS-safe character escapes regardless
+ * of which serializer produced it.
+ */
+type Serialize = (data: unknown) => string;
+interface SerializeStateOptions {
+  /**
+   * Custom serializer (e.g., `devalue.stringify` / `superjson.stringify`) to
+   * support non-JSON types (Date / Map / Set / RegExp / BigInt). Defaults to
+   * `JSON.stringify`. Output is still XSS-escaped.
+   *
+   * @default JSON.stringify
+   */
+  serialize?: Serialize;
+}
+/**
+ * XSS-safe JSON serialization for embedding data in HTML `<script>` tags.
+ *
+ * Escapes `<`, `>`, and `&` to their Unicode equivalents to prevent
+ * injection via `</script>` or HTML entities inside inline scripts.
+ *
+ * Pass `options.serialize` to use a custom serializer such as `devalue` or
+ * `superjson` for non-JSON types (Date/Map/Set/RegExp/BigInt). The serializer
+ * must return a string; XSS-escape is applied to its output.
+ *
+ * @example
+ * ```typescript
+ * const json = serializeState({ name: "home", path: "/" });
+ * const html = `<script>window.__STATE__=${json}</script>`;
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import * as devalue from "devalue";
+ *
+ * const json = serializeState(
+ *   { date: new Date(), tags: new Set(["a", "b"]) },
+ *   { serialize: devalue.stringify },
+ * );
+ * ```
+ */
+declare function serializeState(data: unknown, options?: SerializeStateOptions): string;
+//#endregion
+//#region src/utils/serializeRouterState.d.ts
+/**
+ * Parsed shape produced by {@link serializeRouterState} (after `JSON.parse`).
+ *
+ * Identical to {@link State} minus `transition` (per-navigation `TransitionMeta`
+ * is meaningless after hydration; the client builds its own on commit). Used as
+ * the input shape for {@link hydrateRouter} and as the type of the one-shot
+ * hydration scratchpad consumed by SSR loader plugins.
+ */
+type SerializedRouterState<P extends Params = Params> = Omit<State<P>, "transition">;
+interface SerializeRouterStateOptions {
+  /**
+   * Plugin context namespaces to strip from the serialized output.
+   * Use when a plugin populates `state.context.<ns>` with non-JSON-serializable
+   * values (e.g., RSC payload: ReactNode trees containing functions/symbols).
+   *
+   * @default []
+   */
+  excludeContext?: readonly string[];
+  /**
+   * Custom serializer (e.g., `devalue.stringify` / `superjson.stringify`) to
+   * support non-JSON types in `state.params` and `state.context.<ns>` payloads
+   * (Date / Map / Set / RegExp / BigInt). Defaults to `JSON.stringify`.
+   *
+   * Pair with the matching `deserialize` on `hydrateRouter` to round-trip the
+   * extended types on the client.
+   *
+   * @default JSON.stringify
+   *
+   * @example
+   * ```typescript
+   * import * as devalue from "devalue";
+   *
+   * const json = serializeRouterState(state, { serialize: devalue.stringify });
+   * ```
+   */
+  serialize?: Serialize;
+}
+/**
+ * XSS-safe JSON serialization of router State for SSR → client transport (#563).
+ *
+ * Strips `state.transition` (per-navigation `TransitionMeta` — meaningless after
+ * hydration; the client's hydration commit produces its own `transition`).
+ * Keeps `name`, `params`, `path`, and `context` (plugin context namespaces are
+ * preserved as-is — server's `state.context.data` from `ssr-data-plugin` and
+ * any other plugin claims travel to the client untouched).
+ *
+ * Pass `options.excludeContext` to strip specific namespaces from the output —
+ * required for plugins that publish non-JSON-serializable values (e.g., RSC
+ * `ReactNode` trees from `@real-router/rsc-server-plugin`).
+ *
+ * @example
+ * ```typescript
+ * // Server
+ * const state = await router.start(req.url);
+ * const html = `<script>window.__SSR_STATE__=${serializeRouterState(state)}</script>`;
+ *
+ * // Client
+ * await hydrateRouter(router, window.__SSR_STATE__);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With RSC plugin: strip the "rsc" namespace before transport
+ * const state = await router.start(url);
+ * const json = serializeRouterState(state, { excludeContext: ["rsc"] });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Non-JSON types (Date / Map / Set / RegExp / BigInt) via devalue (#606)
+ * import * as devalue from "devalue";
+ *
+ * const json = serializeRouterState(state, { serialize: devalue.stringify });
+ * // On the client:
+ * await hydrateRouter(router, json, { deserialize: devalue.parse });
+ * ```
+ */
+declare function serializeRouterState(state: State, options?: SerializeRouterStateOptions): string;
+//#endregion
+export { SerializeStateOptions as a, HydrateRouterOptions as c, getStaticPaths as d, IncomingMessageLike as f, createRequestScope as g, RequestScopeSource as h, Serialize as i, hydrateRouter as l, RequestScope as m, SerializedRouterState as n, serializeState as o, RequestLike as p, serializeRouterState as r, Deserialize as s, SerializeRouterStateOptions as t, StaticPathEntries as u };
+//# sourceMappingURL=index-r_JTvSBH.d.mts.map

package/dist/esm/index-r_JTvSBH.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-r_JTvSBH.d.mts","names":[],"sources":["../../src/utils/createRequestScope.ts","../../src/utils/getStaticPaths.ts","../../src/utils/hydrateRouter.ts","../../src/utils/serializeState.ts","../../src/utils/serializeRouterState.ts"],"mappings":";;;;;;AAUA;;;UAAiB,mBAAA;EACf,EAAA,GAAK,KAAA,WAAgB,QAAA;EACrB,cAAA,IAAkB,KAAA,WAAgB,QAAA;AAAA;;;;;AAAoB;UAQvC,WAAA;EACf,MAAA,EAAQ,WAAW;AAAA;AAAA,KAGT,kBAAA,GAAqB,mBAAA,GAAsB,WAAW;AAAA,UAEjD,YAAA,sBACM,mBAAA,GAAsB,mBAAA,UACnC,eAAA;EAJE;;;;AAAsD;EAAtD,SAUD,MAAA,EAAQ,QAAA,CAAY,YAAA;EARF;;;;EAAA,SAclB,MAAA,EAAQ,WAAA;EANA;;;;;EAajB,OAAA,QAAe,OAAA;AAAA;;;;;;;;;;;;AAAO;AA4ExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAM4B;;;;AC5H5B;;;;;;;;;;;;AAEsB;AAiBtB;;;;;;;iBDmGgB,kBAAA,sBACO,mBAAA,GAAsB,mBAAA,CAAA,CAE3C,OAAA,EAAS,kBAAA,EACT,IAAA,EAAM,MAAA,CAAO,YAAA,GACb,IAAA,GAAO,OAAA,CAAQ,YAAA,IACd,YAAA,CAAa,YAAA;;;KC5HJ,iBAAA,GAAoB,MAAA,eAExB,OAAA,CAAQ,MAAA;AAAA,iBAiBM,cAAA,sBACC,mBAAA,GAAsB,mBAAA,CAAA,CAE3C,MAAA,EAAQ,MAAA,CAAO,YAAA,GACf,OAAA,GAAU,iBAAA,GACT,OAAA;;;;;;ADnBH;;KEAY,WAAA,IAAe,IAAY;AAAA,UAEtB,oBAAA;EFDf;;;;;;;AACsD;AAQxD;;;;AACqB;EEKnB,WAAA,GAAc,WAAW;AAAA;;;AFFuC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;AAqBwB;AA4ExB;;;;;;;;;;iBExDsB,aAAA,CACpB,MAAA,EAAQ,MAAA,EACR,MAAA;EAAmB,IAAA;AAAA,GACnB,OAAA,GAAU,oBAAA,GACT,OAAA,CAAQ,KAAA;;;;;;;AF7DX;;;;KGFY,SAAA,IAAa,IAAa;AAAA,UAErB,qBAAA;EHCM;;;;;AACiC;AAQxD;EGFE,SAAA,GAAY,SAAS;AAAA;;AHGF;AAGrB;;;;AAAkE;AAElE;;;;;;;;;;;;;;;;;;;iBGqBgB,cAAA,CACd,IAAA,WACA,OAAA,GAAU,qBAAqB;;;;;AHvCjC;;;;;;KIGY,qBAAA,WAAgC,MAAA,GAAS,MAAA,IAAU,IAAA,CAC7D,KAAA,CAAM,CAAA;AAAA,UAIS,2BAAA;EJNG;;;AAAoC;AAQxD;;;EIME,cAAA;EJLmB;AAGrB;;;;AAAkE;AAElE;;;;;;;;;;;EImBE,SAAA,GAAY,SAAS;AAAA;;;;;;;;;;;;AJEC;AA4ExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBInCgB,oBAAA,CACd,KAAA,EAAO,KAAA,EACP,OAAA,GAAU,2BAA2B"}