@real-router/preact 0.2.6 → 0.2.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cjs/index.js CHANGED
@@ -1,2 +1,2 @@
1
- Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`@real-router/core`),t=require(`@real-router/route-utils`),n=require(`preact`),r=require(`preact/compat`),i=require(`preact/jsx-runtime`),a=require(`@real-router/sources`),o=require(`preact/hooks`),s=require(`dom-utils`),c=require(`@real-router/core/api`);function l(e){return null}l.displayName=`RouteView.Match`;function u(e){return null}u.displayName=`RouteView.NotFound`;function d(e,n,r){return r?e===n:(0,t.startsWithSegment)(e,n)}function f(e,t){for(let r of(0,n.toChildArray)(e))(0,n.isValidElement)(r)&&(r.type===l||r.type===u?t.push(r):f(r.props.children,t))}function p(t,a,o){let s=null,c=!1,l=[];for(let e of t){if(e.type===u){s=e.props.children;continue}let{segment:t,exact:f=!1,fallback:p}=e.props,m=o?`${o}.${t}`:t;if(!c&&d(a,m,f)){c=!0;let t=e.props.children,a=p===void 0?t:(0,i.jsx)(r.Suspense,{fallback:p,children:t});l.push((0,i.jsx)(n.Fragment,{children:a},m))}}return!c&&a===e.UNKNOWN_ROUTE&&s!==null&&l.push((0,i.jsx)(n.Fragment,{children:s},`__route-view-not-found__`)),{rendered:l,activeMatchFound:c}}function m(e,t,n){let[r,i]=(0,o.useState)(t);return(0,o.useEffect)(()=>(i(t()),e(()=>{i(t())})),[e,t]),r}const h=(0,n.createContext)(null),g=(0,n.createContext)(null),_=(0,n.createContext)(null),v=()=>{let e=(0,o.useContext)(g);if(!e)throw Error(`useRouter must be used within a RouterProvider`);return e};function y(t){let n=v(),r=(0,o.useMemo)(()=>(0,a.createRouteNodeSource)(n,t),[n,t]),{route:i,previousRoute:s}=m(r.subscribe,r.getSnapshot,r.getSnapshot),c=(0,o.useMemo)(()=>(0,e.getNavigator)(n),[n]);return(0,o.useMemo)(()=>({navigator:c,route:i,previousRoute:s}),[c,i,s])}function b({nodeName:e,children:t}){let{route:n}=y(e);if(!n)return null;let r=[];f(t,r);let{rendered:a}=p(r,n.name,e);return a.length>0?(0,i.jsx)(i.Fragment,{children:a}):null}b.displayName=`RouteView`;const x=Object.assign(b,{Match:l,NotFound:u}),S=Object.freeze({}),C=Object.freeze({});function w(e){return(0,o.useMemo)(()=>e,[JSON.stringify(e)])}function T(e,t,n=!1,r=!0){let i=v(),s=w(t),c=(0,o.useMemo)(()=>(0,a.createActiveRouteSource)(i,e,s,{strict:n,ignoreQueryParams:r}),[i,e,s,n,r]);return m(c.subscribe,c.getSnapshot,c.getSnapshot)}function E(e,t){return e.routeName===t.routeName&&e.className===t.className&&e.activeClassName===t.activeClassName&&e.activeStrict===t.activeStrict&&e.ignoreQueryParams===t.ignoreQueryParams&&e.onClick===t.onClick&&e.target===t.target&&e.style===t.style&&e.children===t.children&&JSON.stringify(e.routeParams)===JSON.stringify(t.routeParams)&&JSON.stringify(e.routeOptions)===JSON.stringify(t.routeOptions)}const D=(0,r.memo)(({routeName:e,routeParams:t=S,routeOptions:n=C,className:r,activeClassName:a=`active`,activeStrict:c=!1,ignoreQueryParams:l=!0,onClick:u,target:d,children:f,...p})=>{let m=v(),h=w(t),g=w(n),_=T(e,h,c,l),y=(0,o.useMemo)(()=>(0,s.buildHref)(m,e,h),[m,e,h]),b=(0,o.useCallback)(t=>{u&&(u(t),t.defaultPrevented)||!(0,s.shouldNavigate)(t)||d===`_blank`||(t.preventDefault(),m.navigate(e,h,g).catch(()=>{}))},[u,d,m,e,h,g]),x=(0,o.useMemo)(()=>(0,s.buildActiveClassName)(_,a,r),[_,a,r]);return(0,i.jsx)(`a`,{...p,href:y,className:x,onClick:b,children:f})},E);D.displayName=`Link`;const O=new WeakMap;function k(){let e=v(),t=(0,o.useMemo)(()=>{let t=O.get(e);return t||(t=(0,a.createErrorSource)(e),O.set(e,t)),t},[e]);return m(t.subscribe,t.getSnapshot,t.getSnapshot)}function A({children:e,fallback:t,onError:r}){let a=k(),[s,c]=(0,o.useState)(-1),l=(0,o.useRef)(r);l.current=r,(0,o.useEffect)(()=>{a.error&&l.current?.(a.error,a.toRoute,a.fromRoute)},[a.version]);let u=a.version>s?a.error:null,d=(0,o.useCallback)(()=>{c(a.version)},[a.version]);return(0,i.jsxs)(n.Fragment,{children:[e,u?t(u,d):null]})}const j=()=>{let e=(0,o.useContext)(_);if(!e)throw Error(`useNavigator must be used within a RouterProvider`);return e},M=()=>(0,t.getRouteUtils)((0,c.getPluginApi)(v()).getTree()),N=()=>{let e=(0,o.useContext)(h);if(!e)throw Error(`useRoute must be used within a RouteProvider`);return e};function P(){let e=v(),t=(0,o.useMemo)(()=>(0,a.createTransitionSource)(e),[e]);return m(t.subscribe,t.getSnapshot,t.getSnapshot)}const F=({router:t,children:n,announceNavigation:r})=>{(0,o.useEffect)(()=>{if(!r)return;let e=(0,s.createRouteAnnouncer)(t);return()=>{e.destroy()}},[r,t]);let c=(0,o.useMemo)(()=>(0,e.getNavigator)(t),[t]),l=(0,o.useMemo)(()=>(0,a.createRouteSource)(t),[t]),{route:u,previousRoute:d}=m(l.subscribe,l.getSnapshot,l.getSnapshot),f=(0,o.useMemo)(()=>({navigator:c,route:u,previousRoute:d}),[c,u,d]);return(0,i.jsx)(g.Provider,{value:t,children:(0,i.jsx)(_.Provider,{value:c,children:(0,i.jsx)(h.Provider,{value:f,children:n})})})};exports.Link=D,exports.NavigatorContext=_,exports.RouteContext=h,exports.RouteView=x,exports.RouterContext=g,exports.RouterErrorBoundary=A,exports.RouterProvider=F,exports.useNavigator=j,exports.useRoute=N,exports.useRouteNode=y,exports.useRouteUtils=M,exports.useRouter=v,exports.useRouterTransition=P;
1
+ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`@real-router/core`),t=require(`@real-router/route-utils`),n=require(`preact`),r=require(`preact/compat`),i=require(`preact/jsx-runtime`),a=require(`@real-router/sources`),o=require(`preact/hooks`),s=require(`@real-router/core/api`);function c(e){return null}c.displayName=`RouteView.Match`;function l(e){return null}l.displayName=`RouteView.NotFound`;function u(e,n,r){return r?e===n:(0,t.startsWithSegment)(e,n)}function d(e,t){for(let r of(0,n.toChildArray)(e))(0,n.isValidElement)(r)&&(r.type===c||r.type===l?t.push(r):d(r.props.children,t))}function f(t,a,o){let s=null,c=!1,d=[];for(let e of t){if(e.type===l){s=e.props.children;continue}let{segment:t,exact:f=!1,fallback:p}=e.props,m=o?`${o}.${t}`:t;if(!c&&u(a,m,f)){c=!0;let t=e.props.children,a=p===void 0?t:(0,i.jsx)(r.Suspense,{fallback:p,children:t});d.push((0,i.jsx)(n.Fragment,{children:a},m))}}return!c&&a===e.UNKNOWN_ROUTE&&s!==null&&d.push((0,i.jsx)(n.Fragment,{children:s},`__route-view-not-found__`)),{rendered:d,activeMatchFound:c}}function p(e,t,n){let[r,i]=(0,o.useState)(t);return(0,o.useEffect)(()=>(i(t()),e(()=>{i(t())})),[e,t]),r}const m=(0,n.createContext)(null),h=(0,n.createContext)(null),g=(0,n.createContext)(null),_=()=>{let e=(0,o.useContext)(h);if(!e)throw Error(`useRouter must be used within a RouterProvider`);return e};function v(t){let n=_(),r=(0,o.useMemo)(()=>(0,a.createRouteNodeSource)(n,t),[n,t]),{route:i,previousRoute:s}=p(r.subscribe,r.getSnapshot,r.getSnapshot),c=(0,o.useMemo)(()=>(0,e.getNavigator)(n),[n]);return(0,o.useMemo)(()=>({navigator:c,route:i,previousRoute:s}),[c,i,s])}function y({nodeName:e,children:t}){let{route:n}=v(e);if(!n)return null;let r=[];d(t,r);let{rendered:a}=f(r,n.name,e);return a.length>0?(0,i.jsx)(i.Fragment,{children:a}):null}y.displayName=`RouteView`;const b=Object.assign(y,{Match:c,NotFound:l}),x=`data-real-router-announcer`;function S(e,t){let n=t?.prefix??`Navigated to `,r=t?.getAnnouncementText,i=!0,a=!1,o=!1,s=``,c,l=C(),u=setTimeout(()=>{a=!0},100),d=e.subscribe(({route:e})=>{if(i){i=!1;return}requestAnimationFrame(()=>{requestAnimationFrame(()=>{if(o)return;let t=T(e,n,r);t&&t!==s&&a&&(s=t,clearTimeout(c),l.textContent=t,c=setTimeout(()=>{l.textContent=``,s=``},7e3),E())})})});return{destroy(){o=!0,d(),clearTimeout(c),clearTimeout(u),w()}}}function C(){let e=document.querySelector(`[${x}]`);if(e)return e;let t=document.createElement(`div`);return t.setAttribute(`style`,`position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0`),t.setAttribute(`aria-live`,`assertive`),t.setAttribute(`aria-atomic`,`true`),t.setAttribute(x,``),document.body.prepend(t),t}function w(){document.querySelector(`[${x}]`)?.remove()}function T(e,t,n){if(n)return n(e);let r=document.querySelector(`h1`)?.textContent.trim()??``,i=e.name.startsWith(`@@`)?``:e.name;return`${t}${r||document.title||i||globalThis.location.pathname}`}function E(){let e=document.querySelector(`h1`);e&&(e.hasAttribute(`tabindex`)||e.setAttribute(`tabindex`,`-1`),e.focus({preventScroll:!0}))}function D(e){return e.button===0&&!e.metaKey&&!e.altKey&&!e.ctrlKey&&!e.shiftKey}function O(e,t,n){try{let r=e.buildUrl;return r?r(t,n):e.buildPath(t,n)}catch{console.error(`[real-router] Route "${t}" is not defined. The element will render without an href attribute.`);return}}function k(e,t,n){return e&&t?n?`${n} ${t}`.trim():t:n??void 0}const A=Object.freeze({}),j=Object.freeze({});function M(e){return(0,o.useMemo)(()=>e,[JSON.stringify(e)])}function N(e,t,n=!1,r=!0){let i=_(),s=M(t),c=(0,o.useMemo)(()=>(0,a.createActiveRouteSource)(i,e,s,{strict:n,ignoreQueryParams:r}),[i,e,s,n,r]);return p(c.subscribe,c.getSnapshot,c.getSnapshot)}function P(e,t){return e.routeName===t.routeName&&e.className===t.className&&e.activeClassName===t.activeClassName&&e.activeStrict===t.activeStrict&&e.ignoreQueryParams===t.ignoreQueryParams&&e.onClick===t.onClick&&e.target===t.target&&e.style===t.style&&e.children===t.children&&JSON.stringify(e.routeParams)===JSON.stringify(t.routeParams)&&JSON.stringify(e.routeOptions)===JSON.stringify(t.routeOptions)}const F=(0,r.memo)(({routeName:e,routeParams:t=A,routeOptions:n=j,className:r,activeClassName:a=`active`,activeStrict:s=!1,ignoreQueryParams:c=!0,onClick:l,target:u,children:d,...f})=>{let p=_(),m=M(t),h=M(n),g=N(e,m,s,c),v=(0,o.useMemo)(()=>O(p,e,m),[p,e,m]),y=(0,o.useCallback)(t=>{l&&(l(t),t.defaultPrevented)||!D(t)||u===`_blank`||(t.preventDefault(),p.navigate(e,m,h).catch(()=>{}))},[l,u,p,e,m,h]),b=(0,o.useMemo)(()=>k(g,a,r),[g,a,r]);return(0,i.jsx)(`a`,{...f,href:v,className:b,onClick:y,children:d})},P);F.displayName=`Link`;const I=new WeakMap;function L(){let e=_(),t=(0,o.useMemo)(()=>{let t=I.get(e);return t||(t=(0,a.createErrorSource)(e),I.set(e,t)),t},[e]);return p(t.subscribe,t.getSnapshot,t.getSnapshot)}function R({children:e,fallback:t,onError:r}){let a=L(),[s,c]=(0,o.useState)(-1),l=(0,o.useRef)(r);l.current=r,(0,o.useEffect)(()=>{a.error&&l.current?.(a.error,a.toRoute,a.fromRoute)},[a.version]);let u=a.version>s?a.error:null,d=(0,o.useCallback)(()=>{c(a.version)},[a.version]);return(0,i.jsxs)(n.Fragment,{children:[e,u?t(u,d):null]})}const z=()=>{let e=(0,o.useContext)(g);if(!e)throw Error(`useNavigator must be used within a RouterProvider`);return e},B=()=>(0,t.getRouteUtils)((0,s.getPluginApi)(_()).getTree()),V=()=>{let e=(0,o.useContext)(m);if(!e)throw Error(`useRoute must be used within a RouteProvider`);return e};function H(){let e=_(),t=(0,o.useMemo)(()=>(0,a.createTransitionSource)(e),[e]);return p(t.subscribe,t.getSnapshot,t.getSnapshot)}const U=({router:t,children:n,announceNavigation:r})=>{(0,o.useEffect)(()=>{if(!r)return;let e=S(t);return()=>{e.destroy()}},[r,t]);let s=(0,o.useMemo)(()=>(0,e.getNavigator)(t),[t]),c=(0,o.useMemo)(()=>(0,a.createRouteSource)(t),[t]),{route:l,previousRoute:u}=p(c.subscribe,c.getSnapshot,c.getSnapshot),d=(0,o.useMemo)(()=>({navigator:s,route:l,previousRoute:u}),[s,l,u]);return(0,i.jsx)(h.Provider,{value:t,children:(0,i.jsx)(g.Provider,{value:s,children:(0,i.jsx)(m.Provider,{value:d,children:n})})})};exports.Link=F,exports.NavigatorContext=g,exports.RouteContext=m,exports.RouteView=b,exports.RouterContext=h,exports.RouterErrorBoundary=R,exports.RouterProvider=U,exports.useNavigator=z,exports.useRoute=V,exports.useRouteNode=v,exports.useRouteUtils=B,exports.useRouter=_,exports.useRouterTransition=H;
2
2
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["Suspense","Fragment","UNKNOWN_ROUTE","Fragment"],"sources":["../../src/components/RouteView/components.tsx","../../src/components/RouteView/helpers.tsx","../../src/useSyncExternalStore.ts","../../src/context.ts","../../src/hooks/useRouter.tsx","../../src/hooks/useRouteNode.tsx","../../src/components/RouteView/RouteView.tsx","../../src/constants.ts","../../src/hooks/useStableValue.tsx","../../src/hooks/useIsActiveRoute.tsx","../../src/components/Link.tsx","../../src/hooks/useRouterError.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"sourcesContent":["import type { MatchProps, NotFoundProps } from \"./types\";\n\nexport function Match(_props: MatchProps): null {\n return null;\n}\n\nMatch.displayName = \"RouteView.Match\";\n\nexport function NotFound(_props: NotFoundProps): null {\n return null;\n}\n\nNotFound.displayName = \"RouteView.NotFound\";\n","import { UNKNOWN_ROUTE } from \"@real-router/core\";\nimport { startsWithSegment } from \"@real-router/route-utils\";\nimport { Fragment, isValidElement, toChildArray } from \"preact\";\nimport { Suspense } from \"preact/compat\";\n\nimport { Match, NotFound } from \"./components\";\n\nimport type { MatchProps, NotFoundProps } from \"./types\";\nimport type { VNode, ComponentChildren } from \"preact\";\n\nfunction isSegmentMatch(\n routeName: string,\n fullSegmentName: string,\n exact: boolean,\n): boolean {\n if (exact) {\n return routeName === fullSegmentName;\n }\n\n return startsWithSegment(routeName, fullSegmentName);\n}\n\nexport function collectElements(\n children: ComponentChildren,\n result: VNode[],\n): void {\n for (const child of toChildArray(children)) {\n if (!isValidElement(child)) {\n continue;\n }\n\n if (child.type === Match || child.type === NotFound) {\n result.push(child);\n } else {\n collectElements(\n (child.props as { readonly children: ComponentChildren }).children,\n result,\n );\n }\n }\n}\n\nexport function buildRenderList(\n elements: VNode[],\n routeName: string,\n nodeName: string,\n): { rendered: VNode[]; activeMatchFound: boolean } {\n let notFoundChildren: ComponentChildren = null;\n let activeMatchFound = false;\n const rendered: VNode[] = [];\n\n for (const child of elements) {\n if (child.type === NotFound) {\n notFoundChildren = (child.props as NotFoundProps).children;\n continue;\n }\n\n const { segment, exact = false, fallback } = child.props as MatchProps;\n const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n const isActive =\n !activeMatchFound && isSegmentMatch(routeName, fullSegmentName, exact);\n\n if (isActive) {\n activeMatchFound = true;\n const matchChildren = (child.props as MatchProps).children;\n const content =\n fallback === undefined ? (\n matchChildren\n ) : (\n <Suspense fallback={fallback}>{matchChildren}</Suspense>\n );\n\n rendered.push(<Fragment key={fullSegmentName}>{content}</Fragment>);\n }\n }\n\n if (\n !activeMatchFound &&\n routeName === UNKNOWN_ROUTE &&\n notFoundChildren !== null\n ) {\n rendered.push(\n <Fragment key=\"__route-view-not-found__\">{notFoundChildren}</Fragment>,\n );\n }\n\n return { rendered, activeMatchFound };\n}\n","import { useEffect, useState } from \"preact/hooks\";\n\n/**\n * Polyfill for React's useSyncExternalStore.\n *\n * Preact does not provide a native useSyncExternalStore.\n * This implementation uses useState + useEffect to subscribe\n * to external stores.\n *\n * Race condition handling: the value may change between\n * `useState(getSnapshot)` (render) and `useEffect` (commit).\n * We synchronize by calling `setValue(getSnapshot())` before\n * subscribing in the effect.\n */\nexport function useSyncExternalStore<T>(\n subscribe: (onStoreChange: () => void) => () => void,\n getSnapshot: () => T,\n _getServerSnapshot?: () => T,\n): T {\n const [value, setValue] = useState(getSnapshot);\n\n useEffect(() => {\n // Synchronize before subscribing to handle race condition\n setValue(getSnapshot());\n\n return subscribe(() => {\n setValue(getSnapshot());\n });\n }, [subscribe, getSnapshot]);\n\n return value;\n}\n","import { createContext } from \"preact\";\n\nimport type { RouteContext as RouteContextType } from \"./types\";\nimport type { Router, Navigator } from \"@real-router/core\";\n\nexport const RouteContext = createContext<RouteContextType | null>(null);\n\nexport const RouterContext = createContext<Router | null>(null);\n\nexport const NavigatorContext = createContext<Navigator | null>(null);\n","import { useContext } from \"preact/hooks\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n const router = useContext(RouterContext);\n\n if (!router) {\n throw new Error(\"useRouter must be used within a RouterProvider\");\n }\n\n return router;\n};\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteNodeSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n const router = useRouter();\n\n const store = useMemo(\n () => createRouteNodeSource(router, nodeName),\n [router, nodeName],\n );\n\n const { route, previousRoute } = useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n\n const navigator = useMemo(() => getNavigator(router), [router]);\n\n return useMemo(\n (): RouteContext => ({ navigator, route, previousRoute }),\n [navigator, route, previousRoute],\n );\n}\n","import { Match, NotFound } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../hooks/useRouteNode\";\n\nimport type { RouteViewProps } from \"./types\";\nimport type { VNode } from \"preact\";\n\nfunction RouteViewRoot({\n nodeName,\n children,\n}: Readonly<RouteViewProps>): VNode | null {\n const { route } = useRouteNode(nodeName);\n\n if (!route) {\n return null;\n }\n\n const elements: VNode[] = [];\n\n collectElements(children, elements);\n\n const { rendered } = buildRenderList(elements, route.name, nodeName);\n\n if (rendered.length > 0) {\n return <>{rendered}</>;\n }\n\n return null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, { Match, NotFound });\n\nexport type {\n RouteViewProps,\n MatchProps as RouteViewMatchProps,\n NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\n","/**\n * Stable empty object for default params\n */\nexport const EMPTY_PARAMS = Object.freeze({});\n\n/**\n * Stable empty options object\n */\nexport const EMPTY_OPTIONS = Object.freeze({});\n","import { useMemo } from \"preact/hooks\";\n\nexport function useStableValue<T>(value: T): T {\n const serialized = JSON.stringify(value);\n\n // eslint-disable-next-line @eslint-react/exhaustive-deps\n return useMemo(() => value, [serialized]);\n}\n","import { createActiveRouteSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\nimport { useStableValue } from \"./useStableValue\";\n\nimport type { Params } from \"@real-router/core\";\n\nexport function useIsActiveRoute(\n routeName: string,\n params?: Params,\n strict = false,\n ignoreQueryParams = true,\n): boolean {\n const router = useRouter();\n\n const stableParams = useStableValue(params);\n\n const store = useMemo(\n () =>\n createActiveRouteSource(router, routeName, stableParams, {\n strict,\n ignoreQueryParams,\n }),\n [router, routeName, stableParams, strict, ignoreQueryParams],\n );\n\n return useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n}\n","import { shouldNavigate, buildHref, buildActiveClassName } from \"dom-utils\";\nimport { memo } from \"preact/compat\";\nimport { useCallback, useMemo } from \"preact/hooks\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\nimport { useStableValue } from \"../hooks/useStableValue\";\n\nimport type { LinkProps } from \"../types\";\nimport type { FunctionComponent, JSX } from \"preact\";\n\nfunction areLinkPropsEqual(\n prev: Readonly<LinkProps>,\n next: Readonly<LinkProps>,\n): boolean {\n return (\n prev.routeName === next.routeName &&\n prev.className === next.className &&\n prev.activeClassName === next.activeClassName &&\n prev.activeStrict === next.activeStrict &&\n prev.ignoreQueryParams === next.ignoreQueryParams &&\n prev.onClick === next.onClick &&\n prev.target === next.target &&\n prev.style === next.style &&\n prev.children === next.children &&\n JSON.stringify(prev.routeParams) === JSON.stringify(next.routeParams) &&\n JSON.stringify(prev.routeOptions) === JSON.stringify(next.routeOptions)\n );\n}\n\nexport const Link: FunctionComponent<LinkProps> = memo(\n ({\n routeName,\n routeParams = EMPTY_PARAMS,\n routeOptions = EMPTY_OPTIONS,\n className,\n activeClassName = \"active\",\n activeStrict = false,\n ignoreQueryParams = true,\n onClick,\n target,\n children,\n ...props\n }) => {\n const router = useRouter();\n\n const stableParams = useStableValue(routeParams);\n const stableOptions = useStableValue(routeOptions);\n\n const isActive = useIsActiveRoute(\n routeName,\n stableParams,\n activeStrict,\n ignoreQueryParams,\n );\n\n const href = useMemo(\n () => buildHref(router, routeName, stableParams),\n [router, routeName, stableParams],\n );\n\n const handleClick = useCallback(\n (evt: JSX.TargetedMouseEvent<HTMLAnchorElement>) => {\n if (onClick) {\n onClick(evt);\n\n if (evt.defaultPrevented) {\n return;\n }\n }\n\n if (!shouldNavigate(evt) || target === \"_blank\") {\n return;\n }\n\n evt.preventDefault();\n router.navigate(routeName, stableParams, stableOptions).catch(() => {});\n },\n [onClick, target, router, routeName, stableParams, stableOptions],\n );\n\n const finalClassName = useMemo(\n () => buildActiveClassName(isActive, activeClassName, className),\n [isActive, activeClassName, className],\n );\n\n return (\n <a\n {...props}\n href={href}\n className={finalClassName}\n onClick={handleClick}\n >\n {children}\n </a>\n );\n },\n areLinkPropsEqual,\n);\n\nLink.displayName = \"Link\";\n","import { createErrorSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { RouterErrorSnapshot, RouterSource } from \"@real-router/sources\";\n\nconst cache = new WeakMap<Router, RouterSource<RouterErrorSnapshot>>();\n\nexport function useRouterError(): RouterErrorSnapshot {\n const router = useRouter();\n\n const store = useMemo(() => {\n let source = cache.get(router);\n\n if (!source) {\n source = createErrorSource(router);\n cache.set(router, source);\n }\n\n return source;\n }, [router]);\n\n return useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n}\n","import { Fragment } from \"preact\";\nimport { useCallback, useEffect, useRef, useState } from \"preact/hooks\";\n\nimport { useRouterError } from \"../hooks/useRouterError\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { ComponentChildren, VNode } from \"preact\";\n\nexport interface RouterErrorBoundaryProps {\n readonly children: ComponentChildren;\n readonly fallback: (\n error: RouterError,\n resetError: () => void,\n ) => ComponentChildren;\n readonly onError?: (\n error: RouterError,\n toRoute: State | null,\n fromRoute: State | null,\n ) => void;\n}\n\nexport function RouterErrorBoundary({\n children,\n fallback,\n onError,\n}: RouterErrorBoundaryProps): VNode {\n const snapshot = useRouterError();\n const [dismissedVersion, setDismissedVersion] = useState(-1);\n\n const onErrorRef = useRef(onError);\n\n // eslint-disable-next-line @eslint-react/refs -- \"latest ref\" pattern: sync callback to ref to avoid effect re-runs\n onErrorRef.current = onError;\n\n useEffect(() => {\n if (snapshot.error) {\n onErrorRef.current?.(\n snapshot.error,\n snapshot.toRoute,\n snapshot.fromRoute,\n );\n }\n // eslint-disable-next-line @eslint-react/exhaustive-deps -- onError tracked via ref, snapshot fields accessed inside callback\n }, [snapshot.version]);\n\n const visibleError =\n snapshot.version > dismissedVersion ? snapshot.error : null;\n\n const resetError = useCallback(() => {\n setDismissedVersion(snapshot.version);\n }, [snapshot.version]);\n\n return (\n <Fragment>\n {children}\n {visibleError ? fallback(visibleError, resetError) : null}\n </Fragment>\n );\n}\n","import { useContext } from \"preact/hooks\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n const navigator = useContext(NavigatorContext);\n\n if (!navigator) {\n throw new Error(\"useNavigator must be used within a RouterProvider\");\n }\n\n return navigator;\n};\n","import { getPluginApi } from \"@real-router/core/api\";\nimport { getRouteUtils } from \"@real-router/route-utils\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteUtils } from \"@real-router/route-utils\";\n\nexport const useRouteUtils = (): RouteUtils => {\n const router = useRouter();\n\n return getRouteUtils(getPluginApi(router).getTree());\n};\n","import { useContext } from \"preact/hooks\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\n\nexport const useRoute = (): RouteContextType => {\n const routeContext = useContext(RouteContext);\n\n if (!routeContext) {\n throw new Error(\"useRoute must be used within a RouteProvider\");\n }\n\n return routeContext;\n};\n","import { createTransitionSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouterTransitionSnapshot } from \"@real-router/sources\";\n\nexport function useRouterTransition(): RouterTransitionSnapshot {\n const router = useRouter();\n\n const store = useMemo(() => createTransitionSource(router), [router]);\n\n return useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n}\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { createRouteAnnouncer } from \"dom-utils\";\nimport { useEffect, useMemo } from \"preact/hooks\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\nimport { useSyncExternalStore } from \"./useSyncExternalStore\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { FunctionComponent, ComponentChildren } from \"preact\";\n\nexport interface RouteProviderProps {\n router: Router;\n children: ComponentChildren;\n announceNavigation?: boolean;\n}\n\nexport const RouterProvider: FunctionComponent<RouteProviderProps> = ({\n router,\n children,\n announceNavigation,\n}) => {\n useEffect(() => {\n if (!announceNavigation) {\n return;\n }\n\n const announcer = createRouteAnnouncer(router);\n\n return () => {\n announcer.destroy();\n };\n }, [announceNavigation, router]);\n const navigator = useMemo(() => getNavigator(router), [router]);\n\n // useSyncExternalStore manages the router subscription lifecycle:\n // subscribe connects to router on first listener, unsubscribes on last.\n const store = useMemo(() => createRouteSource(router), [router]);\n const { route, previousRoute } = useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot, // SSR: router returns same state on server and client\n );\n\n const routeContextValue = useMemo(\n () => ({ navigator, route, previousRoute }),\n [navigator, route, previousRoute],\n );\n\n return (\n <RouterContext.Provider value={router}>\n <NavigatorContext.Provider value={navigator}>\n <RouteContext.Provider value={routeContextValue}>\n {children}\n </RouteContext.Provider>\n </NavigatorContext.Provider>\n </RouterContext.Provider>\n );\n};\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":["Suspense","Fragment","UNKNOWN_ROUTE","buildHref","shouldNavigate","buildActiveClassName","Fragment","createRouteAnnouncer"],"sources":["../../src/components/RouteView/components.tsx","../../src/components/RouteView/helpers.tsx","../../src/useSyncExternalStore.ts","../../src/context.ts","../../src/hooks/useRouter.tsx","../../src/hooks/useRouteNode.tsx","../../src/components/RouteView/RouteView.tsx","../../../dom-utils/dist/esm/index.mjs","../../src/constants.ts","../../src/hooks/useStableValue.tsx","../../src/hooks/useIsActiveRoute.tsx","../../src/components/Link.tsx","../../src/hooks/useRouterError.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"sourcesContent":["import type { MatchProps, NotFoundProps } from \"./types\";\n\nexport function Match(_props: MatchProps): null {\n return null;\n}\n\nMatch.displayName = \"RouteView.Match\";\n\nexport function NotFound(_props: NotFoundProps): null {\n return null;\n}\n\nNotFound.displayName = \"RouteView.NotFound\";\n","import { UNKNOWN_ROUTE } from \"@real-router/core\";\nimport { startsWithSegment } from \"@real-router/route-utils\";\nimport { Fragment, isValidElement, toChildArray } from \"preact\";\nimport { Suspense } from \"preact/compat\";\n\nimport { Match, NotFound } from \"./components\";\n\nimport type { MatchProps, NotFoundProps } from \"./types\";\nimport type { VNode, ComponentChildren } from \"preact\";\n\nfunction isSegmentMatch(\n routeName: string,\n fullSegmentName: string,\n exact: boolean,\n): boolean {\n if (exact) {\n return routeName === fullSegmentName;\n }\n\n return startsWithSegment(routeName, fullSegmentName);\n}\n\nexport function collectElements(\n children: ComponentChildren,\n result: VNode[],\n): void {\n for (const child of toChildArray(children)) {\n if (!isValidElement(child)) {\n continue;\n }\n\n if (child.type === Match || child.type === NotFound) {\n result.push(child);\n } else {\n collectElements(\n (child.props as { readonly children: ComponentChildren }).children,\n result,\n );\n }\n }\n}\n\nexport function buildRenderList(\n elements: VNode[],\n routeName: string,\n nodeName: string,\n): { rendered: VNode[]; activeMatchFound: boolean } {\n let notFoundChildren: ComponentChildren = null;\n let activeMatchFound = false;\n const rendered: VNode[] = [];\n\n for (const child of elements) {\n if (child.type === NotFound) {\n notFoundChildren = (child.props as NotFoundProps).children;\n continue;\n }\n\n const { segment, exact = false, fallback } = child.props as MatchProps;\n const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n const isActive =\n !activeMatchFound && isSegmentMatch(routeName, fullSegmentName, exact);\n\n if (isActive) {\n activeMatchFound = true;\n const matchChildren = (child.props as MatchProps).children;\n const content =\n fallback === undefined ? (\n matchChildren\n ) : (\n <Suspense fallback={fallback}>{matchChildren}</Suspense>\n );\n\n rendered.push(<Fragment key={fullSegmentName}>{content}</Fragment>);\n }\n }\n\n if (\n !activeMatchFound &&\n routeName === UNKNOWN_ROUTE &&\n notFoundChildren !== null\n ) {\n rendered.push(\n <Fragment key=\"__route-view-not-found__\">{notFoundChildren}</Fragment>,\n );\n }\n\n return { rendered, activeMatchFound };\n}\n","import { useEffect, useState } from \"preact/hooks\";\n\n/**\n * Polyfill for React's useSyncExternalStore.\n *\n * Preact does not provide a native useSyncExternalStore.\n * This implementation uses useState + useEffect to subscribe\n * to external stores.\n *\n * Race condition handling: the value may change between\n * `useState(getSnapshot)` (render) and `useEffect` (commit).\n * We synchronize by calling `setValue(getSnapshot())` before\n * subscribing in the effect.\n */\nexport function useSyncExternalStore<T>(\n subscribe: (onStoreChange: () => void) => () => void,\n getSnapshot: () => T,\n _getServerSnapshot?: () => T,\n): T {\n const [value, setValue] = useState(getSnapshot);\n\n useEffect(() => {\n // Synchronize before subscribing to handle race condition\n setValue(getSnapshot());\n\n return subscribe(() => {\n setValue(getSnapshot());\n });\n }, [subscribe, getSnapshot]);\n\n return value;\n}\n","import { createContext } from \"preact\";\n\nimport type { RouteContext as RouteContextType } from \"./types\";\nimport type { Router, Navigator } from \"@real-router/core\";\n\nexport const RouteContext = createContext<RouteContextType | null>(null);\n\nexport const RouterContext = createContext<Router | null>(null);\n\nexport const NavigatorContext = createContext<Navigator | null>(null);\n","import { useContext } from \"preact/hooks\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n const router = useContext(RouterContext);\n\n if (!router) {\n throw new Error(\"useRouter must be used within a RouterProvider\");\n }\n\n return router;\n};\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteNodeSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n const router = useRouter();\n\n const store = useMemo(\n () => createRouteNodeSource(router, nodeName),\n [router, nodeName],\n );\n\n const { route, previousRoute } = useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n\n const navigator = useMemo(() => getNavigator(router), [router]);\n\n return useMemo(\n (): RouteContext => ({ navigator, route, previousRoute }),\n [navigator, route, previousRoute],\n );\n}\n","import { Match, NotFound } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../hooks/useRouteNode\";\n\nimport type { RouteViewProps } from \"./types\";\nimport type { VNode } from \"preact\";\n\nfunction RouteViewRoot({\n nodeName,\n children,\n}: Readonly<RouteViewProps>): VNode | null {\n const { route } = useRouteNode(nodeName);\n\n if (!route) {\n return null;\n }\n\n const elements: VNode[] = [];\n\n collectElements(children, elements);\n\n const { rendered } = buildRenderList(elements, route.name, nodeName);\n\n if (rendered.length > 0) {\n return <>{rendered}</>;\n }\n\n return null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, { Match, NotFound });\n\nexport type {\n RouteViewProps,\n MatchProps as RouteViewMatchProps,\n NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\n","const e=`data-real-router-announcer`;function t(e,t){let o=t?.prefix??`Navigated to `,s=t?.getAnnouncementText,c=!0,l=!1,u=!1,d=``,f,p=n(),m=setTimeout(()=>{l=!0},100),h=e.subscribe(({route:e})=>{if(c){c=!1;return}requestAnimationFrame(()=>{requestAnimationFrame(()=>{if(u)return;let t=i(e,o,s);t&&t!==d&&l&&(d=t,clearTimeout(f),p.textContent=t,f=setTimeout(()=>{p.textContent=``,d=``},7e3),a())})})});return{destroy(){u=!0,h(),clearTimeout(f),clearTimeout(m),r()}}}function n(){let t=document.querySelector(`[${e}]`);if(t)return t;let n=document.createElement(`div`);return n.setAttribute(`style`,`position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0`),n.setAttribute(`aria-live`,`assertive`),n.setAttribute(`aria-atomic`,`true`),n.setAttribute(e,``),document.body.prepend(n),n}function r(){document.querySelector(`[${e}]`)?.remove()}function i(e,t,n){if(n)return n(e);let r=document.querySelector(`h1`)?.textContent.trim()??``,i=e.name.startsWith(`@@`)?``:e.name;return`${t}${r||document.title||i||globalThis.location.pathname}`}function a(){let e=document.querySelector(`h1`);e&&(e.hasAttribute(`tabindex`)||e.setAttribute(`tabindex`,`-1`),e.focus({preventScroll:!0}))}function o(e){return e.button===0&&!e.metaKey&&!e.altKey&&!e.ctrlKey&&!e.shiftKey}function s(e,t,n){try{let r=e.buildUrl;return r?r(t,n):e.buildPath(t,n)}catch{console.error(`[real-router] Route \"${t}\" is not defined. The element will render without an href attribute.`);return}}function c(e,t,n){return e&&t?n?`${n} ${t}`.trim():t:n??void 0}function l(e){e instanceof HTMLAnchorElement||e instanceof HTMLButtonElement||(e.getAttribute(`role`)||e.setAttribute(`role`,`link`),e.getAttribute(`tabindex`)||e.setAttribute(`tabindex`,`0`))}export{l as applyLinkA11y,c as buildActiveClassName,s as buildHref,t as createRouteAnnouncer,o as shouldNavigate};\n//# sourceMappingURL=index.mjs.map","/**\n * Stable empty object for default params\n */\nexport const EMPTY_PARAMS = Object.freeze({});\n\n/**\n * Stable empty options object\n */\nexport const EMPTY_OPTIONS = Object.freeze({});\n","import { useMemo } from \"preact/hooks\";\n\nexport function useStableValue<T>(value: T): T {\n const serialized = JSON.stringify(value);\n\n // eslint-disable-next-line @eslint-react/exhaustive-deps\n return useMemo(() => value, [serialized]);\n}\n","import { createActiveRouteSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\nimport { useStableValue } from \"./useStableValue\";\n\nimport type { Params } from \"@real-router/core\";\n\nexport function useIsActiveRoute(\n routeName: string,\n params?: Params,\n strict = false,\n ignoreQueryParams = true,\n): boolean {\n const router = useRouter();\n\n const stableParams = useStableValue(params);\n\n const store = useMemo(\n () =>\n createActiveRouteSource(router, routeName, stableParams, {\n strict,\n ignoreQueryParams,\n }),\n [router, routeName, stableParams, strict, ignoreQueryParams],\n );\n\n return useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n}\n","import { shouldNavigate, buildHref, buildActiveClassName } from \"dom-utils\";\nimport { memo } from \"preact/compat\";\nimport { useCallback, useMemo } from \"preact/hooks\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\nimport { useStableValue } from \"../hooks/useStableValue\";\n\nimport type { LinkProps } from \"../types\";\nimport type { FunctionComponent, JSX } from \"preact\";\n\nfunction areLinkPropsEqual(\n prev: Readonly<LinkProps>,\n next: Readonly<LinkProps>,\n): boolean {\n return (\n prev.routeName === next.routeName &&\n prev.className === next.className &&\n prev.activeClassName === next.activeClassName &&\n prev.activeStrict === next.activeStrict &&\n prev.ignoreQueryParams === next.ignoreQueryParams &&\n prev.onClick === next.onClick &&\n prev.target === next.target &&\n prev.style === next.style &&\n prev.children === next.children &&\n JSON.stringify(prev.routeParams) === JSON.stringify(next.routeParams) &&\n JSON.stringify(prev.routeOptions) === JSON.stringify(next.routeOptions)\n );\n}\n\nexport const Link: FunctionComponent<LinkProps> = memo(\n ({\n routeName,\n routeParams = EMPTY_PARAMS,\n routeOptions = EMPTY_OPTIONS,\n className,\n activeClassName = \"active\",\n activeStrict = false,\n ignoreQueryParams = true,\n onClick,\n target,\n children,\n ...props\n }) => {\n const router = useRouter();\n\n const stableParams = useStableValue(routeParams);\n const stableOptions = useStableValue(routeOptions);\n\n const isActive = useIsActiveRoute(\n routeName,\n stableParams,\n activeStrict,\n ignoreQueryParams,\n );\n\n const href = useMemo(\n () => buildHref(router, routeName, stableParams),\n [router, routeName, stableParams],\n );\n\n const handleClick = useCallback(\n (evt: JSX.TargetedMouseEvent<HTMLAnchorElement>) => {\n if (onClick) {\n onClick(evt);\n\n if (evt.defaultPrevented) {\n return;\n }\n }\n\n if (!shouldNavigate(evt) || target === \"_blank\") {\n return;\n }\n\n evt.preventDefault();\n router.navigate(routeName, stableParams, stableOptions).catch(() => {});\n },\n [onClick, target, router, routeName, stableParams, stableOptions],\n );\n\n const finalClassName = useMemo(\n () => buildActiveClassName(isActive, activeClassName, className),\n [isActive, activeClassName, className],\n );\n\n return (\n <a\n {...props}\n href={href}\n className={finalClassName}\n onClick={handleClick}\n >\n {children}\n </a>\n );\n },\n areLinkPropsEqual,\n);\n\nLink.displayName = \"Link\";\n","import { createErrorSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { RouterErrorSnapshot, RouterSource } from \"@real-router/sources\";\n\nconst cache = new WeakMap<Router, RouterSource<RouterErrorSnapshot>>();\n\nexport function useRouterError(): RouterErrorSnapshot {\n const router = useRouter();\n\n const store = useMemo(() => {\n let source = cache.get(router);\n\n if (!source) {\n source = createErrorSource(router);\n cache.set(router, source);\n }\n\n return source;\n }, [router]);\n\n return useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n}\n","import { Fragment } from \"preact\";\nimport { useCallback, useEffect, useRef, useState } from \"preact/hooks\";\n\nimport { useRouterError } from \"../hooks/useRouterError\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { ComponentChildren, VNode } from \"preact\";\n\nexport interface RouterErrorBoundaryProps {\n readonly children: ComponentChildren;\n readonly fallback: (\n error: RouterError,\n resetError: () => void,\n ) => ComponentChildren;\n readonly onError?: (\n error: RouterError,\n toRoute: State | null,\n fromRoute: State | null,\n ) => void;\n}\n\nexport function RouterErrorBoundary({\n children,\n fallback,\n onError,\n}: RouterErrorBoundaryProps): VNode {\n const snapshot = useRouterError();\n const [dismissedVersion, setDismissedVersion] = useState(-1);\n\n const onErrorRef = useRef(onError);\n\n // eslint-disable-next-line @eslint-react/refs -- \"latest ref\" pattern: sync callback to ref to avoid effect re-runs\n onErrorRef.current = onError;\n\n useEffect(() => {\n if (snapshot.error) {\n onErrorRef.current?.(\n snapshot.error,\n snapshot.toRoute,\n snapshot.fromRoute,\n );\n }\n // eslint-disable-next-line @eslint-react/exhaustive-deps -- onError tracked via ref, snapshot fields accessed inside callback\n }, [snapshot.version]);\n\n const visibleError =\n snapshot.version > dismissedVersion ? snapshot.error : null;\n\n const resetError = useCallback(() => {\n setDismissedVersion(snapshot.version);\n }, [snapshot.version]);\n\n return (\n <Fragment>\n {children}\n {visibleError ? fallback(visibleError, resetError) : null}\n </Fragment>\n );\n}\n","import { useContext } from \"preact/hooks\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n const navigator = useContext(NavigatorContext);\n\n if (!navigator) {\n throw new Error(\"useNavigator must be used within a RouterProvider\");\n }\n\n return navigator;\n};\n","import { getPluginApi } from \"@real-router/core/api\";\nimport { getRouteUtils } from \"@real-router/route-utils\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteUtils } from \"@real-router/route-utils\";\n\nexport const useRouteUtils = (): RouteUtils => {\n const router = useRouter();\n\n return getRouteUtils(getPluginApi(router).getTree());\n};\n","import { useContext } from \"preact/hooks\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\n\nexport const useRoute = (): RouteContextType => {\n const routeContext = useContext(RouteContext);\n\n if (!routeContext) {\n throw new Error(\"useRoute must be used within a RouteProvider\");\n }\n\n return routeContext;\n};\n","import { createTransitionSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouterTransitionSnapshot } from \"@real-router/sources\";\n\nexport function useRouterTransition(): RouterTransitionSnapshot {\n const router = useRouter();\n\n const store = useMemo(() => createTransitionSource(router), [router]);\n\n return useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n}\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { createRouteAnnouncer } from \"dom-utils\";\nimport { useEffect, useMemo } from \"preact/hooks\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\nimport { useSyncExternalStore } from \"./useSyncExternalStore\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { FunctionComponent, ComponentChildren } from \"preact\";\n\nexport interface RouteProviderProps {\n router: Router;\n children: ComponentChildren;\n announceNavigation?: boolean;\n}\n\nexport const RouterProvider: FunctionComponent<RouteProviderProps> = ({\n router,\n children,\n announceNavigation,\n}) => {\n useEffect(() => {\n if (!announceNavigation) {\n return;\n }\n\n const announcer = createRouteAnnouncer(router);\n\n return () => {\n announcer.destroy();\n };\n }, [announceNavigation, router]);\n const navigator = useMemo(() => getNavigator(router), [router]);\n\n // useSyncExternalStore manages the router subscription lifecycle:\n // subscribe connects to router on first listener, unsubscribes on last.\n const store = useMemo(() => createRouteSource(router), [router]);\n const { route, previousRoute } = useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot, // SSR: router returns same state on server and client\n );\n\n const routeContextValue = useMemo(\n () => ({ navigator, route, previousRoute }),\n [navigator, route, previousRoute],\n );\n\n return (\n <RouterContext.Provider value={router}>\n <NavigatorContext.Provider value={navigator}>\n <RouteContext.Provider value={routeContextValue}>\n {children}\n </RouteContext.Provider>\n </NavigatorContext.Provider>\n </RouterContext.Provider>\n );\n};\n"],"mappings":"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"}
@@ -1,2 +1,2 @@
1
- import{UNKNOWN_ROUTE as e,getNavigator as t}from"@real-router/core";import{getRouteUtils as n,startsWithSegment as r}from"@real-router/route-utils";import{Fragment as i,createContext as a,isValidElement as o,toChildArray as s}from"preact";import{Suspense as c,memo as l}from"preact/compat";import{Fragment as u,jsx as d,jsxs as f}from"preact/jsx-runtime";import{createActiveRouteSource as p,createErrorSource as m,createRouteNodeSource as h,createRouteSource as g,createTransitionSource as _}from"@real-router/sources";import{useCallback as v,useContext as y,useEffect as b,useMemo as x,useRef as S,useState as C}from"preact/hooks";import{buildActiveClassName as w,buildHref as T,createRouteAnnouncer as E,shouldNavigate as D}from"dom-utils";import{getPluginApi as O}from"@real-router/core/api";function k(e){return null}k.displayName=`RouteView.Match`;function A(e){return null}A.displayName=`RouteView.NotFound`;function j(e,t,n){return n?e===t:r(e,t)}function M(e,t){for(let n of s(e))o(n)&&(n.type===k||n.type===A?t.push(n):M(n.props.children,t))}function N(t,n,r){let a=null,o=!1,s=[];for(let e of t){if(e.type===A){a=e.props.children;continue}let{segment:t,exact:l=!1,fallback:u}=e.props,f=r?`${r}.${t}`:t;if(!o&&j(n,f,l)){o=!0;let t=e.props.children,n=u===void 0?t:d(c,{fallback:u,children:t});s.push(d(i,{children:n},f))}}return!o&&n===e&&a!==null&&s.push(d(i,{children:a},`__route-view-not-found__`)),{rendered:s,activeMatchFound:o}}function P(e,t,n){let[r,i]=C(t);return b(()=>(i(t()),e(()=>{i(t())})),[e,t]),r}const F=a(null),I=a(null),L=a(null),R=()=>{let e=y(I);if(!e)throw Error(`useRouter must be used within a RouterProvider`);return e};function z(e){let n=R(),r=x(()=>h(n,e),[n,e]),{route:i,previousRoute:a}=P(r.subscribe,r.getSnapshot,r.getSnapshot),o=x(()=>t(n),[n]);return x(()=>({navigator:o,route:i,previousRoute:a}),[o,i,a])}function B({nodeName:e,children:t}){let{route:n}=z(e);if(!n)return null;let r=[];M(t,r);let{rendered:i}=N(r,n.name,e);return i.length>0?d(u,{children:i}):null}B.displayName=`RouteView`;const V=Object.assign(B,{Match:k,NotFound:A}),H=Object.freeze({}),U=Object.freeze({});function W(e){return x(()=>e,[JSON.stringify(e)])}function G(e,t,n=!1,r=!0){let i=R(),a=W(t),o=x(()=>p(i,e,a,{strict:n,ignoreQueryParams:r}),[i,e,a,n,r]);return P(o.subscribe,o.getSnapshot,o.getSnapshot)}function K(e,t){return e.routeName===t.routeName&&e.className===t.className&&e.activeClassName===t.activeClassName&&e.activeStrict===t.activeStrict&&e.ignoreQueryParams===t.ignoreQueryParams&&e.onClick===t.onClick&&e.target===t.target&&e.style===t.style&&e.children===t.children&&JSON.stringify(e.routeParams)===JSON.stringify(t.routeParams)&&JSON.stringify(e.routeOptions)===JSON.stringify(t.routeOptions)}const q=l(({routeName:e,routeParams:t=H,routeOptions:n=U,className:r,activeClassName:i=`active`,activeStrict:a=!1,ignoreQueryParams:o=!0,onClick:s,target:c,children:l,...u})=>{let f=R(),p=W(t),m=W(n),h=G(e,p,a,o),g=x(()=>T(f,e,p),[f,e,p]),_=v(t=>{s&&(s(t),t.defaultPrevented)||!D(t)||c===`_blank`||(t.preventDefault(),f.navigate(e,p,m).catch(()=>{}))},[s,c,f,e,p,m]),y=x(()=>w(h,i,r),[h,i,r]);return d(`a`,{...u,href:g,className:y,onClick:_,children:l})},K);q.displayName=`Link`;const J=new WeakMap;function Y(){let e=R(),t=x(()=>{let t=J.get(e);return t||(t=m(e),J.set(e,t)),t},[e]);return P(t.subscribe,t.getSnapshot,t.getSnapshot)}function X({children:e,fallback:t,onError:n}){let r=Y(),[a,o]=C(-1),s=S(n);s.current=n,b(()=>{r.error&&s.current?.(r.error,r.toRoute,r.fromRoute)},[r.version]);let c=r.version>a?r.error:null,l=v(()=>{o(r.version)},[r.version]);return f(i,{children:[e,c?t(c,l):null]})}const Z=()=>{let e=y(L);if(!e)throw Error(`useNavigator must be used within a RouterProvider`);return e},Q=()=>n(O(R()).getTree()),$=()=>{let e=y(F);if(!e)throw Error(`useRoute must be used within a RouteProvider`);return e};function ee(){let e=R(),t=x(()=>_(e),[e]);return P(t.subscribe,t.getSnapshot,t.getSnapshot)}const te=({router:e,children:n,announceNavigation:r})=>{b(()=>{if(!r)return;let t=E(e);return()=>{t.destroy()}},[r,e]);let i=x(()=>t(e),[e]),a=x(()=>g(e),[e]),{route:o,previousRoute:s}=P(a.subscribe,a.getSnapshot,a.getSnapshot),c=x(()=>({navigator:i,route:o,previousRoute:s}),[i,o,s]);return d(I.Provider,{value:e,children:d(L.Provider,{value:i,children:d(F.Provider,{value:c,children:n})})})};export{q as Link,L as NavigatorContext,F as RouteContext,V as RouteView,I as RouterContext,X as RouterErrorBoundary,te as RouterProvider,Z as useNavigator,$ as useRoute,z as useRouteNode,Q as useRouteUtils,R as useRouter,ee as useRouterTransition};
1
+ import{UNKNOWN_ROUTE as e,getNavigator as t}from"@real-router/core";import{getRouteUtils as n,startsWithSegment as r}from"@real-router/route-utils";import{Fragment as i,createContext as a,isValidElement as o,toChildArray as s}from"preact";import{Suspense as c,memo as l}from"preact/compat";import{Fragment as u,jsx as d,jsxs as f}from"preact/jsx-runtime";import{createActiveRouteSource as p,createErrorSource as m,createRouteNodeSource as h,createRouteSource as g,createTransitionSource as _}from"@real-router/sources";import{useCallback as v,useContext as y,useEffect as b,useMemo as x,useRef as S,useState as C}from"preact/hooks";import{getPluginApi as w}from"@real-router/core/api";function T(e){return null}T.displayName=`RouteView.Match`;function E(e){return null}E.displayName=`RouteView.NotFound`;function D(e,t,n){return n?e===t:r(e,t)}function O(e,t){for(let n of s(e))o(n)&&(n.type===T||n.type===E?t.push(n):O(n.props.children,t))}function k(t,n,r){let a=null,o=!1,s=[];for(let e of t){if(e.type===E){a=e.props.children;continue}let{segment:t,exact:l=!1,fallback:u}=e.props,f=r?`${r}.${t}`:t;if(!o&&D(n,f,l)){o=!0;let t=e.props.children,n=u===void 0?t:d(c,{fallback:u,children:t});s.push(d(i,{children:n},f))}}return!o&&n===e&&a!==null&&s.push(d(i,{children:a},`__route-view-not-found__`)),{rendered:s,activeMatchFound:o}}function A(e,t,n){let[r,i]=C(t);return b(()=>(i(t()),e(()=>{i(t())})),[e,t]),r}const j=a(null),M=a(null),N=a(null),P=()=>{let e=y(M);if(!e)throw Error(`useRouter must be used within a RouterProvider`);return e};function F(e){let n=P(),r=x(()=>h(n,e),[n,e]),{route:i,previousRoute:a}=A(r.subscribe,r.getSnapshot,r.getSnapshot),o=x(()=>t(n),[n]);return x(()=>({navigator:o,route:i,previousRoute:a}),[o,i,a])}function I({nodeName:e,children:t}){let{route:n}=F(e);if(!n)return null;let r=[];O(t,r);let{rendered:i}=k(r,n.name,e);return i.length>0?d(u,{children:i}):null}I.displayName=`RouteView`;const ee=Object.assign(I,{Match:T,NotFound:E}),L=`data-real-router-announcer`;function R(e,t){let n=t?.prefix??`Navigated to `,r=t?.getAnnouncementText,i=!0,a=!1,o=!1,s=``,c,l=z(),u=setTimeout(()=>{a=!0},100),d=e.subscribe(({route:e})=>{if(i){i=!1;return}requestAnimationFrame(()=>{requestAnimationFrame(()=>{if(o)return;let t=V(e,n,r);t&&t!==s&&a&&(s=t,clearTimeout(c),l.textContent=t,c=setTimeout(()=>{l.textContent=``,s=``},7e3),H())})})});return{destroy(){o=!0,d(),clearTimeout(c),clearTimeout(u),B()}}}function z(){let e=document.querySelector(`[${L}]`);if(e)return e;let t=document.createElement(`div`);return t.setAttribute(`style`,`position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0`),t.setAttribute(`aria-live`,`assertive`),t.setAttribute(`aria-atomic`,`true`),t.setAttribute(L,``),document.body.prepend(t),t}function B(){document.querySelector(`[${L}]`)?.remove()}function V(e,t,n){if(n)return n(e);let r=document.querySelector(`h1`)?.textContent.trim()??``,i=e.name.startsWith(`@@`)?``:e.name;return`${t}${r||document.title||i||globalThis.location.pathname}`}function H(){let e=document.querySelector(`h1`);e&&(e.hasAttribute(`tabindex`)||e.setAttribute(`tabindex`,`-1`),e.focus({preventScroll:!0}))}function U(e){return e.button===0&&!e.metaKey&&!e.altKey&&!e.ctrlKey&&!e.shiftKey}function W(e,t,n){try{let r=e.buildUrl;return r?r(t,n):e.buildPath(t,n)}catch{console.error(`[real-router] Route "${t}" is not defined. The element will render without an href attribute.`);return}}function G(e,t,n){return e&&t?n?`${n} ${t}`.trim():t:n??void 0}const K=Object.freeze({}),q=Object.freeze({});function J(e){return x(()=>e,[JSON.stringify(e)])}function Y(e,t,n=!1,r=!0){let i=P(),a=J(t),o=x(()=>p(i,e,a,{strict:n,ignoreQueryParams:r}),[i,e,a,n,r]);return A(o.subscribe,o.getSnapshot,o.getSnapshot)}function X(e,t){return e.routeName===t.routeName&&e.className===t.className&&e.activeClassName===t.activeClassName&&e.activeStrict===t.activeStrict&&e.ignoreQueryParams===t.ignoreQueryParams&&e.onClick===t.onClick&&e.target===t.target&&e.style===t.style&&e.children===t.children&&JSON.stringify(e.routeParams)===JSON.stringify(t.routeParams)&&JSON.stringify(e.routeOptions)===JSON.stringify(t.routeOptions)}const Z=l(({routeName:e,routeParams:t=K,routeOptions:n=q,className:r,activeClassName:i=`active`,activeStrict:a=!1,ignoreQueryParams:o=!0,onClick:s,target:c,children:l,...u})=>{let f=P(),p=J(t),m=J(n),h=Y(e,p,a,o),g=x(()=>W(f,e,p),[f,e,p]),_=v(t=>{s&&(s(t),t.defaultPrevented)||!U(t)||c===`_blank`||(t.preventDefault(),f.navigate(e,p,m).catch(()=>{}))},[s,c,f,e,p,m]),y=x(()=>G(h,i,r),[h,i,r]);return d(`a`,{...u,href:g,className:y,onClick:_,children:l})},X);Z.displayName=`Link`;const Q=new WeakMap;function te(){let e=P(),t=x(()=>{let t=Q.get(e);return t||(t=m(e),Q.set(e,t)),t},[e]);return A(t.subscribe,t.getSnapshot,t.getSnapshot)}function $({children:e,fallback:t,onError:n}){let r=te(),[a,o]=C(-1),s=S(n);s.current=n,b(()=>{r.error&&s.current?.(r.error,r.toRoute,r.fromRoute)},[r.version]);let c=r.version>a?r.error:null,l=v(()=>{o(r.version)},[r.version]);return f(i,{children:[e,c?t(c,l):null]})}const ne=()=>{let e=y(N);if(!e)throw Error(`useNavigator must be used within a RouterProvider`);return e},re=()=>n(w(P()).getTree()),ie=()=>{let e=y(j);if(!e)throw Error(`useRoute must be used within a RouteProvider`);return e};function ae(){let e=P(),t=x(()=>_(e),[e]);return A(t.subscribe,t.getSnapshot,t.getSnapshot)}const oe=({router:e,children:n,announceNavigation:r})=>{b(()=>{if(!r)return;let t=R(e);return()=>{t.destroy()}},[r,e]);let i=x(()=>t(e),[e]),a=x(()=>g(e),[e]),{route:o,previousRoute:s}=A(a.subscribe,a.getSnapshot,a.getSnapshot),c=x(()=>({navigator:i,route:o,previousRoute:s}),[i,o,s]);return d(M.Provider,{value:e,children:d(N.Provider,{value:i,children:d(j.Provider,{value:c,children:n})})})};export{Z as Link,N as NavigatorContext,j as RouteContext,ee as RouteView,M as RouterContext,$ as RouterErrorBoundary,oe as RouterProvider,ne as useNavigator,ie as useRoute,F as useRouteNode,re as useRouteUtils,P as useRouter,ae as useRouterTransition};
2
2
  //# sourceMappingURL=index.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":[],"sources":["../../src/components/RouteView/components.tsx","../../src/components/RouteView/helpers.tsx","../../src/useSyncExternalStore.ts","../../src/context.ts","../../src/hooks/useRouter.tsx","../../src/hooks/useRouteNode.tsx","../../src/components/RouteView/RouteView.tsx","../../src/constants.ts","../../src/hooks/useStableValue.tsx","../../src/hooks/useIsActiveRoute.tsx","../../src/components/Link.tsx","../../src/hooks/useRouterError.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"sourcesContent":["import type { MatchProps, NotFoundProps } from \"./types\";\n\nexport function Match(_props: MatchProps): null {\n return null;\n}\n\nMatch.displayName = \"RouteView.Match\";\n\nexport function NotFound(_props: NotFoundProps): null {\n return null;\n}\n\nNotFound.displayName = \"RouteView.NotFound\";\n","import { UNKNOWN_ROUTE } from \"@real-router/core\";\nimport { startsWithSegment } from \"@real-router/route-utils\";\nimport { Fragment, isValidElement, toChildArray } from \"preact\";\nimport { Suspense } from \"preact/compat\";\n\nimport { Match, NotFound } from \"./components\";\n\nimport type { MatchProps, NotFoundProps } from \"./types\";\nimport type { VNode, ComponentChildren } from \"preact\";\n\nfunction isSegmentMatch(\n routeName: string,\n fullSegmentName: string,\n exact: boolean,\n): boolean {\n if (exact) {\n return routeName === fullSegmentName;\n }\n\n return startsWithSegment(routeName, fullSegmentName);\n}\n\nexport function collectElements(\n children: ComponentChildren,\n result: VNode[],\n): void {\n for (const child of toChildArray(children)) {\n if (!isValidElement(child)) {\n continue;\n }\n\n if (child.type === Match || child.type === NotFound) {\n result.push(child);\n } else {\n collectElements(\n (child.props as { readonly children: ComponentChildren }).children,\n result,\n );\n }\n }\n}\n\nexport function buildRenderList(\n elements: VNode[],\n routeName: string,\n nodeName: string,\n): { rendered: VNode[]; activeMatchFound: boolean } {\n let notFoundChildren: ComponentChildren = null;\n let activeMatchFound = false;\n const rendered: VNode[] = [];\n\n for (const child of elements) {\n if (child.type === NotFound) {\n notFoundChildren = (child.props as NotFoundProps).children;\n continue;\n }\n\n const { segment, exact = false, fallback } = child.props as MatchProps;\n const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n const isActive =\n !activeMatchFound && isSegmentMatch(routeName, fullSegmentName, exact);\n\n if (isActive) {\n activeMatchFound = true;\n const matchChildren = (child.props as MatchProps).children;\n const content =\n fallback === undefined ? (\n matchChildren\n ) : (\n <Suspense fallback={fallback}>{matchChildren}</Suspense>\n );\n\n rendered.push(<Fragment key={fullSegmentName}>{content}</Fragment>);\n }\n }\n\n if (\n !activeMatchFound &&\n routeName === UNKNOWN_ROUTE &&\n notFoundChildren !== null\n ) {\n rendered.push(\n <Fragment key=\"__route-view-not-found__\">{notFoundChildren}</Fragment>,\n );\n }\n\n return { rendered, activeMatchFound };\n}\n","import { useEffect, useState } from \"preact/hooks\";\n\n/**\n * Polyfill for React's useSyncExternalStore.\n *\n * Preact does not provide a native useSyncExternalStore.\n * This implementation uses useState + useEffect to subscribe\n * to external stores.\n *\n * Race condition handling: the value may change between\n * `useState(getSnapshot)` (render) and `useEffect` (commit).\n * We synchronize by calling `setValue(getSnapshot())` before\n * subscribing in the effect.\n */\nexport function useSyncExternalStore<T>(\n subscribe: (onStoreChange: () => void) => () => void,\n getSnapshot: () => T,\n _getServerSnapshot?: () => T,\n): T {\n const [value, setValue] = useState(getSnapshot);\n\n useEffect(() => {\n // Synchronize before subscribing to handle race condition\n setValue(getSnapshot());\n\n return subscribe(() => {\n setValue(getSnapshot());\n });\n }, [subscribe, getSnapshot]);\n\n return value;\n}\n","import { createContext } from \"preact\";\n\nimport type { RouteContext as RouteContextType } from \"./types\";\nimport type { Router, Navigator } from \"@real-router/core\";\n\nexport const RouteContext = createContext<RouteContextType | null>(null);\n\nexport const RouterContext = createContext<Router | null>(null);\n\nexport const NavigatorContext = createContext<Navigator | null>(null);\n","import { useContext } from \"preact/hooks\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n const router = useContext(RouterContext);\n\n if (!router) {\n throw new Error(\"useRouter must be used within a RouterProvider\");\n }\n\n return router;\n};\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteNodeSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n const router = useRouter();\n\n const store = useMemo(\n () => createRouteNodeSource(router, nodeName),\n [router, nodeName],\n );\n\n const { route, previousRoute } = useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n\n const navigator = useMemo(() => getNavigator(router), [router]);\n\n return useMemo(\n (): RouteContext => ({ navigator, route, previousRoute }),\n [navigator, route, previousRoute],\n );\n}\n","import { Match, NotFound } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../hooks/useRouteNode\";\n\nimport type { RouteViewProps } from \"./types\";\nimport type { VNode } from \"preact\";\n\nfunction RouteViewRoot({\n nodeName,\n children,\n}: Readonly<RouteViewProps>): VNode | null {\n const { route } = useRouteNode(nodeName);\n\n if (!route) {\n return null;\n }\n\n const elements: VNode[] = [];\n\n collectElements(children, elements);\n\n const { rendered } = buildRenderList(elements, route.name, nodeName);\n\n if (rendered.length > 0) {\n return <>{rendered}</>;\n }\n\n return null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, { Match, NotFound });\n\nexport type {\n RouteViewProps,\n MatchProps as RouteViewMatchProps,\n NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\n","/**\n * Stable empty object for default params\n */\nexport const EMPTY_PARAMS = Object.freeze({});\n\n/**\n * Stable empty options object\n */\nexport const EMPTY_OPTIONS = Object.freeze({});\n","import { useMemo } from \"preact/hooks\";\n\nexport function useStableValue<T>(value: T): T {\n const serialized = JSON.stringify(value);\n\n // eslint-disable-next-line @eslint-react/exhaustive-deps\n return useMemo(() => value, [serialized]);\n}\n","import { createActiveRouteSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\nimport { useStableValue } from \"./useStableValue\";\n\nimport type { Params } from \"@real-router/core\";\n\nexport function useIsActiveRoute(\n routeName: string,\n params?: Params,\n strict = false,\n ignoreQueryParams = true,\n): boolean {\n const router = useRouter();\n\n const stableParams = useStableValue(params);\n\n const store = useMemo(\n () =>\n createActiveRouteSource(router, routeName, stableParams, {\n strict,\n ignoreQueryParams,\n }),\n [router, routeName, stableParams, strict, ignoreQueryParams],\n );\n\n return useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n}\n","import { shouldNavigate, buildHref, buildActiveClassName } from \"dom-utils\";\nimport { memo } from \"preact/compat\";\nimport { useCallback, useMemo } from \"preact/hooks\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\nimport { useStableValue } from \"../hooks/useStableValue\";\n\nimport type { LinkProps } from \"../types\";\nimport type { FunctionComponent, JSX } from \"preact\";\n\nfunction areLinkPropsEqual(\n prev: Readonly<LinkProps>,\n next: Readonly<LinkProps>,\n): boolean {\n return (\n prev.routeName === next.routeName &&\n prev.className === next.className &&\n prev.activeClassName === next.activeClassName &&\n prev.activeStrict === next.activeStrict &&\n prev.ignoreQueryParams === next.ignoreQueryParams &&\n prev.onClick === next.onClick &&\n prev.target === next.target &&\n prev.style === next.style &&\n prev.children === next.children &&\n JSON.stringify(prev.routeParams) === JSON.stringify(next.routeParams) &&\n JSON.stringify(prev.routeOptions) === JSON.stringify(next.routeOptions)\n );\n}\n\nexport const Link: FunctionComponent<LinkProps> = memo(\n ({\n routeName,\n routeParams = EMPTY_PARAMS,\n routeOptions = EMPTY_OPTIONS,\n className,\n activeClassName = \"active\",\n activeStrict = false,\n ignoreQueryParams = true,\n onClick,\n target,\n children,\n ...props\n }) => {\n const router = useRouter();\n\n const stableParams = useStableValue(routeParams);\n const stableOptions = useStableValue(routeOptions);\n\n const isActive = useIsActiveRoute(\n routeName,\n stableParams,\n activeStrict,\n ignoreQueryParams,\n );\n\n const href = useMemo(\n () => buildHref(router, routeName, stableParams),\n [router, routeName, stableParams],\n );\n\n const handleClick = useCallback(\n (evt: JSX.TargetedMouseEvent<HTMLAnchorElement>) => {\n if (onClick) {\n onClick(evt);\n\n if (evt.defaultPrevented) {\n return;\n }\n }\n\n if (!shouldNavigate(evt) || target === \"_blank\") {\n return;\n }\n\n evt.preventDefault();\n router.navigate(routeName, stableParams, stableOptions).catch(() => {});\n },\n [onClick, target, router, routeName, stableParams, stableOptions],\n );\n\n const finalClassName = useMemo(\n () => buildActiveClassName(isActive, activeClassName, className),\n [isActive, activeClassName, className],\n );\n\n return (\n <a\n {...props}\n href={href}\n className={finalClassName}\n onClick={handleClick}\n >\n {children}\n </a>\n );\n },\n areLinkPropsEqual,\n);\n\nLink.displayName = \"Link\";\n","import { createErrorSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { RouterErrorSnapshot, RouterSource } from \"@real-router/sources\";\n\nconst cache = new WeakMap<Router, RouterSource<RouterErrorSnapshot>>();\n\nexport function useRouterError(): RouterErrorSnapshot {\n const router = useRouter();\n\n const store = useMemo(() => {\n let source = cache.get(router);\n\n if (!source) {\n source = createErrorSource(router);\n cache.set(router, source);\n }\n\n return source;\n }, [router]);\n\n return useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n}\n","import { Fragment } from \"preact\";\nimport { useCallback, useEffect, useRef, useState } from \"preact/hooks\";\n\nimport { useRouterError } from \"../hooks/useRouterError\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { ComponentChildren, VNode } from \"preact\";\n\nexport interface RouterErrorBoundaryProps {\n readonly children: ComponentChildren;\n readonly fallback: (\n error: RouterError,\n resetError: () => void,\n ) => ComponentChildren;\n readonly onError?: (\n error: RouterError,\n toRoute: State | null,\n fromRoute: State | null,\n ) => void;\n}\n\nexport function RouterErrorBoundary({\n children,\n fallback,\n onError,\n}: RouterErrorBoundaryProps): VNode {\n const snapshot = useRouterError();\n const [dismissedVersion, setDismissedVersion] = useState(-1);\n\n const onErrorRef = useRef(onError);\n\n // eslint-disable-next-line @eslint-react/refs -- \"latest ref\" pattern: sync callback to ref to avoid effect re-runs\n onErrorRef.current = onError;\n\n useEffect(() => {\n if (snapshot.error) {\n onErrorRef.current?.(\n snapshot.error,\n snapshot.toRoute,\n snapshot.fromRoute,\n );\n }\n // eslint-disable-next-line @eslint-react/exhaustive-deps -- onError tracked via ref, snapshot fields accessed inside callback\n }, [snapshot.version]);\n\n const visibleError =\n snapshot.version > dismissedVersion ? snapshot.error : null;\n\n const resetError = useCallback(() => {\n setDismissedVersion(snapshot.version);\n }, [snapshot.version]);\n\n return (\n <Fragment>\n {children}\n {visibleError ? fallback(visibleError, resetError) : null}\n </Fragment>\n );\n}\n","import { useContext } from \"preact/hooks\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n const navigator = useContext(NavigatorContext);\n\n if (!navigator) {\n throw new Error(\"useNavigator must be used within a RouterProvider\");\n }\n\n return navigator;\n};\n","import { getPluginApi } from \"@real-router/core/api\";\nimport { getRouteUtils } from \"@real-router/route-utils\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteUtils } from \"@real-router/route-utils\";\n\nexport const useRouteUtils = (): RouteUtils => {\n const router = useRouter();\n\n return getRouteUtils(getPluginApi(router).getTree());\n};\n","import { useContext } from \"preact/hooks\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\n\nexport const useRoute = (): RouteContextType => {\n const routeContext = useContext(RouteContext);\n\n if (!routeContext) {\n throw new Error(\"useRoute must be used within a RouteProvider\");\n }\n\n return routeContext;\n};\n","import { createTransitionSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouterTransitionSnapshot } from \"@real-router/sources\";\n\nexport function useRouterTransition(): RouterTransitionSnapshot {\n const router = useRouter();\n\n const store = useMemo(() => createTransitionSource(router), [router]);\n\n return useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n}\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { createRouteAnnouncer } from \"dom-utils\";\nimport { useEffect, useMemo } from \"preact/hooks\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\nimport { useSyncExternalStore } from \"./useSyncExternalStore\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { FunctionComponent, ComponentChildren } from \"preact\";\n\nexport interface RouteProviderProps {\n router: Router;\n children: ComponentChildren;\n announceNavigation?: boolean;\n}\n\nexport const RouterProvider: FunctionComponent<RouteProviderProps> = ({\n router,\n children,\n announceNavigation,\n}) => {\n useEffect(() => {\n if (!announceNavigation) {\n return;\n }\n\n const announcer = createRouteAnnouncer(router);\n\n return () => {\n announcer.destroy();\n };\n }, [announceNavigation, router]);\n const navigator = useMemo(() => getNavigator(router), [router]);\n\n // useSyncExternalStore manages the router subscription lifecycle:\n // subscribe connects to router on first listener, unsubscribes on last.\n const store = useMemo(() => createRouteSource(router), [router]);\n const { route, previousRoute } = useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot, // SSR: router returns same state on server and client\n );\n\n const routeContextValue = useMemo(\n () => ({ navigator, route, previousRoute }),\n [navigator, route, previousRoute],\n );\n\n return (\n <RouterContext.Provider value={router}>\n <NavigatorContext.Provider value={navigator}>\n <RouteContext.Provider value={routeContextValue}>\n {children}\n </RouteContext.Provider>\n </NavigatorContext.Provider>\n </RouterContext.Provider>\n );\n};\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","names":["buildHref","shouldNavigate","buildActiveClassName","createRouteAnnouncer"],"sources":["../../src/components/RouteView/components.tsx","../../src/components/RouteView/helpers.tsx","../../src/useSyncExternalStore.ts","../../src/context.ts","../../src/hooks/useRouter.tsx","../../src/hooks/useRouteNode.tsx","../../src/components/RouteView/RouteView.tsx","../../../dom-utils/dist/esm/index.mjs","../../src/constants.ts","../../src/hooks/useStableValue.tsx","../../src/hooks/useIsActiveRoute.tsx","../../src/components/Link.tsx","../../src/hooks/useRouterError.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"sourcesContent":["import type { MatchProps, NotFoundProps } from \"./types\";\n\nexport function Match(_props: MatchProps): null {\n return null;\n}\n\nMatch.displayName = \"RouteView.Match\";\n\nexport function NotFound(_props: NotFoundProps): null {\n return null;\n}\n\nNotFound.displayName = \"RouteView.NotFound\";\n","import { UNKNOWN_ROUTE } from \"@real-router/core\";\nimport { startsWithSegment } from \"@real-router/route-utils\";\nimport { Fragment, isValidElement, toChildArray } from \"preact\";\nimport { Suspense } from \"preact/compat\";\n\nimport { Match, NotFound } from \"./components\";\n\nimport type { MatchProps, NotFoundProps } from \"./types\";\nimport type { VNode, ComponentChildren } from \"preact\";\n\nfunction isSegmentMatch(\n routeName: string,\n fullSegmentName: string,\n exact: boolean,\n): boolean {\n if (exact) {\n return routeName === fullSegmentName;\n }\n\n return startsWithSegment(routeName, fullSegmentName);\n}\n\nexport function collectElements(\n children: ComponentChildren,\n result: VNode[],\n): void {\n for (const child of toChildArray(children)) {\n if (!isValidElement(child)) {\n continue;\n }\n\n if (child.type === Match || child.type === NotFound) {\n result.push(child);\n } else {\n collectElements(\n (child.props as { readonly children: ComponentChildren }).children,\n result,\n );\n }\n }\n}\n\nexport function buildRenderList(\n elements: VNode[],\n routeName: string,\n nodeName: string,\n): { rendered: VNode[]; activeMatchFound: boolean } {\n let notFoundChildren: ComponentChildren = null;\n let activeMatchFound = false;\n const rendered: VNode[] = [];\n\n for (const child of elements) {\n if (child.type === NotFound) {\n notFoundChildren = (child.props as NotFoundProps).children;\n continue;\n }\n\n const { segment, exact = false, fallback } = child.props as MatchProps;\n const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n const isActive =\n !activeMatchFound && isSegmentMatch(routeName, fullSegmentName, exact);\n\n if (isActive) {\n activeMatchFound = true;\n const matchChildren = (child.props as MatchProps).children;\n const content =\n fallback === undefined ? (\n matchChildren\n ) : (\n <Suspense fallback={fallback}>{matchChildren}</Suspense>\n );\n\n rendered.push(<Fragment key={fullSegmentName}>{content}</Fragment>);\n }\n }\n\n if (\n !activeMatchFound &&\n routeName === UNKNOWN_ROUTE &&\n notFoundChildren !== null\n ) {\n rendered.push(\n <Fragment key=\"__route-view-not-found__\">{notFoundChildren}</Fragment>,\n );\n }\n\n return { rendered, activeMatchFound };\n}\n","import { useEffect, useState } from \"preact/hooks\";\n\n/**\n * Polyfill for React's useSyncExternalStore.\n *\n * Preact does not provide a native useSyncExternalStore.\n * This implementation uses useState + useEffect to subscribe\n * to external stores.\n *\n * Race condition handling: the value may change between\n * `useState(getSnapshot)` (render) and `useEffect` (commit).\n * We synchronize by calling `setValue(getSnapshot())` before\n * subscribing in the effect.\n */\nexport function useSyncExternalStore<T>(\n subscribe: (onStoreChange: () => void) => () => void,\n getSnapshot: () => T,\n _getServerSnapshot?: () => T,\n): T {\n const [value, setValue] = useState(getSnapshot);\n\n useEffect(() => {\n // Synchronize before subscribing to handle race condition\n setValue(getSnapshot());\n\n return subscribe(() => {\n setValue(getSnapshot());\n });\n }, [subscribe, getSnapshot]);\n\n return value;\n}\n","import { createContext } from \"preact\";\n\nimport type { RouteContext as RouteContextType } from \"./types\";\nimport type { Router, Navigator } from \"@real-router/core\";\n\nexport const RouteContext = createContext<RouteContextType | null>(null);\n\nexport const RouterContext = createContext<Router | null>(null);\n\nexport const NavigatorContext = createContext<Navigator | null>(null);\n","import { useContext } from \"preact/hooks\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n const router = useContext(RouterContext);\n\n if (!router) {\n throw new Error(\"useRouter must be used within a RouterProvider\");\n }\n\n return router;\n};\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteNodeSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n const router = useRouter();\n\n const store = useMemo(\n () => createRouteNodeSource(router, nodeName),\n [router, nodeName],\n );\n\n const { route, previousRoute } = useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n\n const navigator = useMemo(() => getNavigator(router), [router]);\n\n return useMemo(\n (): RouteContext => ({ navigator, route, previousRoute }),\n [navigator, route, previousRoute],\n );\n}\n","import { Match, NotFound } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../hooks/useRouteNode\";\n\nimport type { RouteViewProps } from \"./types\";\nimport type { VNode } from \"preact\";\n\nfunction RouteViewRoot({\n nodeName,\n children,\n}: Readonly<RouteViewProps>): VNode | null {\n const { route } = useRouteNode(nodeName);\n\n if (!route) {\n return null;\n }\n\n const elements: VNode[] = [];\n\n collectElements(children, elements);\n\n const { rendered } = buildRenderList(elements, route.name, nodeName);\n\n if (rendered.length > 0) {\n return <>{rendered}</>;\n }\n\n return null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, { Match, NotFound });\n\nexport type {\n RouteViewProps,\n MatchProps as RouteViewMatchProps,\n NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\n","const e=`data-real-router-announcer`;function t(e,t){let o=t?.prefix??`Navigated to `,s=t?.getAnnouncementText,c=!0,l=!1,u=!1,d=``,f,p=n(),m=setTimeout(()=>{l=!0},100),h=e.subscribe(({route:e})=>{if(c){c=!1;return}requestAnimationFrame(()=>{requestAnimationFrame(()=>{if(u)return;let t=i(e,o,s);t&&t!==d&&l&&(d=t,clearTimeout(f),p.textContent=t,f=setTimeout(()=>{p.textContent=``,d=``},7e3),a())})})});return{destroy(){u=!0,h(),clearTimeout(f),clearTimeout(m),r()}}}function n(){let t=document.querySelector(`[${e}]`);if(t)return t;let n=document.createElement(`div`);return n.setAttribute(`style`,`position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0`),n.setAttribute(`aria-live`,`assertive`),n.setAttribute(`aria-atomic`,`true`),n.setAttribute(e,``),document.body.prepend(n),n}function r(){document.querySelector(`[${e}]`)?.remove()}function i(e,t,n){if(n)return n(e);let r=document.querySelector(`h1`)?.textContent.trim()??``,i=e.name.startsWith(`@@`)?``:e.name;return`${t}${r||document.title||i||globalThis.location.pathname}`}function a(){let e=document.querySelector(`h1`);e&&(e.hasAttribute(`tabindex`)||e.setAttribute(`tabindex`,`-1`),e.focus({preventScroll:!0}))}function o(e){return e.button===0&&!e.metaKey&&!e.altKey&&!e.ctrlKey&&!e.shiftKey}function s(e,t,n){try{let r=e.buildUrl;return r?r(t,n):e.buildPath(t,n)}catch{console.error(`[real-router] Route \"${t}\" is not defined. The element will render without an href attribute.`);return}}function c(e,t,n){return e&&t?n?`${n} ${t}`.trim():t:n??void 0}function l(e){e instanceof HTMLAnchorElement||e instanceof HTMLButtonElement||(e.getAttribute(`role`)||e.setAttribute(`role`,`link`),e.getAttribute(`tabindex`)||e.setAttribute(`tabindex`,`0`))}export{l as applyLinkA11y,c as buildActiveClassName,s as buildHref,t as createRouteAnnouncer,o as shouldNavigate};\n//# sourceMappingURL=index.mjs.map","/**\n * Stable empty object for default params\n */\nexport const EMPTY_PARAMS = Object.freeze({});\n\n/**\n * Stable empty options object\n */\nexport const EMPTY_OPTIONS = Object.freeze({});\n","import { useMemo } from \"preact/hooks\";\n\nexport function useStableValue<T>(value: T): T {\n const serialized = JSON.stringify(value);\n\n // eslint-disable-next-line @eslint-react/exhaustive-deps\n return useMemo(() => value, [serialized]);\n}\n","import { createActiveRouteSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\nimport { useStableValue } from \"./useStableValue\";\n\nimport type { Params } from \"@real-router/core\";\n\nexport function useIsActiveRoute(\n routeName: string,\n params?: Params,\n strict = false,\n ignoreQueryParams = true,\n): boolean {\n const router = useRouter();\n\n const stableParams = useStableValue(params);\n\n const store = useMemo(\n () =>\n createActiveRouteSource(router, routeName, stableParams, {\n strict,\n ignoreQueryParams,\n }),\n [router, routeName, stableParams, strict, ignoreQueryParams],\n );\n\n return useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n}\n","import { shouldNavigate, buildHref, buildActiveClassName } from \"dom-utils\";\nimport { memo } from \"preact/compat\";\nimport { useCallback, useMemo } from \"preact/hooks\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\nimport { useStableValue } from \"../hooks/useStableValue\";\n\nimport type { LinkProps } from \"../types\";\nimport type { FunctionComponent, JSX } from \"preact\";\n\nfunction areLinkPropsEqual(\n prev: Readonly<LinkProps>,\n next: Readonly<LinkProps>,\n): boolean {\n return (\n prev.routeName === next.routeName &&\n prev.className === next.className &&\n prev.activeClassName === next.activeClassName &&\n prev.activeStrict === next.activeStrict &&\n prev.ignoreQueryParams === next.ignoreQueryParams &&\n prev.onClick === next.onClick &&\n prev.target === next.target &&\n prev.style === next.style &&\n prev.children === next.children &&\n JSON.stringify(prev.routeParams) === JSON.stringify(next.routeParams) &&\n JSON.stringify(prev.routeOptions) === JSON.stringify(next.routeOptions)\n );\n}\n\nexport const Link: FunctionComponent<LinkProps> = memo(\n ({\n routeName,\n routeParams = EMPTY_PARAMS,\n routeOptions = EMPTY_OPTIONS,\n className,\n activeClassName = \"active\",\n activeStrict = false,\n ignoreQueryParams = true,\n onClick,\n target,\n children,\n ...props\n }) => {\n const router = useRouter();\n\n const stableParams = useStableValue(routeParams);\n const stableOptions = useStableValue(routeOptions);\n\n const isActive = useIsActiveRoute(\n routeName,\n stableParams,\n activeStrict,\n ignoreQueryParams,\n );\n\n const href = useMemo(\n () => buildHref(router, routeName, stableParams),\n [router, routeName, stableParams],\n );\n\n const handleClick = useCallback(\n (evt: JSX.TargetedMouseEvent<HTMLAnchorElement>) => {\n if (onClick) {\n onClick(evt);\n\n if (evt.defaultPrevented) {\n return;\n }\n }\n\n if (!shouldNavigate(evt) || target === \"_blank\") {\n return;\n }\n\n evt.preventDefault();\n router.navigate(routeName, stableParams, stableOptions).catch(() => {});\n },\n [onClick, target, router, routeName, stableParams, stableOptions],\n );\n\n const finalClassName = useMemo(\n () => buildActiveClassName(isActive, activeClassName, className),\n [isActive, activeClassName, className],\n );\n\n return (\n <a\n {...props}\n href={href}\n className={finalClassName}\n onClick={handleClick}\n >\n {children}\n </a>\n );\n },\n areLinkPropsEqual,\n);\n\nLink.displayName = \"Link\";\n","import { createErrorSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { RouterErrorSnapshot, RouterSource } from \"@real-router/sources\";\n\nconst cache = new WeakMap<Router, RouterSource<RouterErrorSnapshot>>();\n\nexport function useRouterError(): RouterErrorSnapshot {\n const router = useRouter();\n\n const store = useMemo(() => {\n let source = cache.get(router);\n\n if (!source) {\n source = createErrorSource(router);\n cache.set(router, source);\n }\n\n return source;\n }, [router]);\n\n return useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n}\n","import { Fragment } from \"preact\";\nimport { useCallback, useEffect, useRef, useState } from \"preact/hooks\";\n\nimport { useRouterError } from \"../hooks/useRouterError\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { ComponentChildren, VNode } from \"preact\";\n\nexport interface RouterErrorBoundaryProps {\n readonly children: ComponentChildren;\n readonly fallback: (\n error: RouterError,\n resetError: () => void,\n ) => ComponentChildren;\n readonly onError?: (\n error: RouterError,\n toRoute: State | null,\n fromRoute: State | null,\n ) => void;\n}\n\nexport function RouterErrorBoundary({\n children,\n fallback,\n onError,\n}: RouterErrorBoundaryProps): VNode {\n const snapshot = useRouterError();\n const [dismissedVersion, setDismissedVersion] = useState(-1);\n\n const onErrorRef = useRef(onError);\n\n // eslint-disable-next-line @eslint-react/refs -- \"latest ref\" pattern: sync callback to ref to avoid effect re-runs\n onErrorRef.current = onError;\n\n useEffect(() => {\n if (snapshot.error) {\n onErrorRef.current?.(\n snapshot.error,\n snapshot.toRoute,\n snapshot.fromRoute,\n );\n }\n // eslint-disable-next-line @eslint-react/exhaustive-deps -- onError tracked via ref, snapshot fields accessed inside callback\n }, [snapshot.version]);\n\n const visibleError =\n snapshot.version > dismissedVersion ? snapshot.error : null;\n\n const resetError = useCallback(() => {\n setDismissedVersion(snapshot.version);\n }, [snapshot.version]);\n\n return (\n <Fragment>\n {children}\n {visibleError ? fallback(visibleError, resetError) : null}\n </Fragment>\n );\n}\n","import { useContext } from \"preact/hooks\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n const navigator = useContext(NavigatorContext);\n\n if (!navigator) {\n throw new Error(\"useNavigator must be used within a RouterProvider\");\n }\n\n return navigator;\n};\n","import { getPluginApi } from \"@real-router/core/api\";\nimport { getRouteUtils } from \"@real-router/route-utils\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteUtils } from \"@real-router/route-utils\";\n\nexport const useRouteUtils = (): RouteUtils => {\n const router = useRouter();\n\n return getRouteUtils(getPluginApi(router).getTree());\n};\n","import { useContext } from \"preact/hooks\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\n\nexport const useRoute = (): RouteContextType => {\n const routeContext = useContext(RouteContext);\n\n if (!routeContext) {\n throw new Error(\"useRoute must be used within a RouteProvider\");\n }\n\n return routeContext;\n};\n","import { createTransitionSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouterTransitionSnapshot } from \"@real-router/sources\";\n\nexport function useRouterTransition(): RouterTransitionSnapshot {\n const router = useRouter();\n\n const store = useMemo(() => createTransitionSource(router), [router]);\n\n return useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot,\n );\n}\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { createRouteAnnouncer } from \"dom-utils\";\nimport { useEffect, useMemo } from \"preact/hooks\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\nimport { useSyncExternalStore } from \"./useSyncExternalStore\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { FunctionComponent, ComponentChildren } from \"preact\";\n\nexport interface RouteProviderProps {\n router: Router;\n children: ComponentChildren;\n announceNavigation?: boolean;\n}\n\nexport const RouterProvider: FunctionComponent<RouteProviderProps> = ({\n router,\n children,\n announceNavigation,\n}) => {\n useEffect(() => {\n if (!announceNavigation) {\n return;\n }\n\n const announcer = createRouteAnnouncer(router);\n\n return () => {\n announcer.destroy();\n };\n }, [announceNavigation, router]);\n const navigator = useMemo(() => getNavigator(router), [router]);\n\n // useSyncExternalStore manages the router subscription lifecycle:\n // subscribe connects to router on first listener, unsubscribes on last.\n const store = useMemo(() => createRouteSource(router), [router]);\n const { route, previousRoute } = useSyncExternalStore(\n store.subscribe,\n store.getSnapshot,\n store.getSnapshot, // SSR: router returns same state on server and client\n );\n\n const routeContextValue = useMemo(\n () => ({ navigator, route, previousRoute }),\n [navigator, route, previousRoute],\n );\n\n return (\n <RouterContext.Provider value={router}>\n <NavigatorContext.Provider value={navigator}>\n <RouteContext.Provider value={routeContextValue}>\n {children}\n </RouteContext.Provider>\n </NavigatorContext.Provider>\n </RouterContext.Provider>\n );\n};\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@real-router/preact",
3
- "version": "0.2.6",
3
+ "version": "0.2.8",
4
4
  "type": "commonjs",
5
5
  "description": "Preact integration for Real-Router",
6
6
  "main": "./dist/cjs/index.js",
@@ -18,8 +18,7 @@
18
18
  }
19
19
  },
20
20
  "files": [
21
- "dist",
22
- "src"
21
+ "dist"
23
22
  ],
24
23
  "homepage": "https://github.com/greydragon888/real-router",
25
24
  "repository": {
@@ -48,10 +47,9 @@
48
47
  "license": "MIT",
49
48
  "sideEffects": false,
50
49
  "dependencies": {
51
- "@real-router/core": "^0.45.0",
52
- "@real-router/route-utils": "^0.1.11",
53
- "@real-router/sources": "^0.4.1",
54
- "dom-utils": "^0.2.7"
50
+ "@real-router/core": "^0.45.1",
51
+ "@real-router/route-utils": "^0.1.12",
52
+ "@real-router/sources": "^0.4.2"
55
53
  },
56
54
  "devDependencies": {
57
55
  "@testing-library/dom": "10.4.1",
@@ -59,7 +57,8 @@
59
57
  "@testing-library/preact": "3.2.4",
60
58
  "@testing-library/user-event": "14.6.1",
61
59
  "preact": "10.25.4",
62
- "@real-router/browser-plugin": "^0.11.4"
60
+ "@real-router/browser-plugin": "^0.11.5",
61
+ "dom-utils": "^0.2.7"
63
62
  },
64
63
  "peerDependencies": {
65
64
  "preact": ">=10.0.0"
@@ -70,7 +69,7 @@
70
69
  "test:stress": "vitest run --config vitest.config.stress.mts",
71
70
  "type-check": "tsc --noEmit",
72
71
  "lint": "eslint --cache --ext .ts,.tsx src/ tests/ --fix --max-warnings 0",
73
- "lint:package": "publint",
72
+ "lint:package": "bash ../../scripts/publint-filter.sh",
74
73
  "lint:types": "attw --pack .",
75
74
  "build:dist-only": "tsdown --config-loader unrun"
76
75
  }
@@ -1,59 +0,0 @@
1
- import { getNavigator } from "@real-router/core";
2
- import { createRouteSource } from "@real-router/sources";
3
- import { createRouteAnnouncer } from "dom-utils";
4
- import { useEffect, useMemo } from "preact/hooks";
5
-
6
- import { NavigatorContext, RouteContext, RouterContext } from "./context";
7
- import { useSyncExternalStore } from "./useSyncExternalStore";
8
-
9
- import type { Router } from "@real-router/core";
10
- import type { FunctionComponent, ComponentChildren } from "preact";
11
-
12
- export interface RouteProviderProps {
13
- router: Router;
14
- children: ComponentChildren;
15
- announceNavigation?: boolean;
16
- }
17
-
18
- export const RouterProvider: FunctionComponent<RouteProviderProps> = ({
19
- router,
20
- children,
21
- announceNavigation,
22
- }) => {
23
- useEffect(() => {
24
- if (!announceNavigation) {
25
- return;
26
- }
27
-
28
- const announcer = createRouteAnnouncer(router);
29
-
30
- return () => {
31
- announcer.destroy();
32
- };
33
- }, [announceNavigation, router]);
34
- const navigator = useMemo(() => getNavigator(router), [router]);
35
-
36
- // useSyncExternalStore manages the router subscription lifecycle:
37
- // subscribe connects to router on first listener, unsubscribes on last.
38
- const store = useMemo(() => createRouteSource(router), [router]);
39
- const { route, previousRoute } = useSyncExternalStore(
40
- store.subscribe,
41
- store.getSnapshot,
42
- store.getSnapshot, // SSR: router returns same state on server and client
43
- );
44
-
45
- const routeContextValue = useMemo(
46
- () => ({ navigator, route, previousRoute }),
47
- [navigator, route, previousRoute],
48
- );
49
-
50
- return (
51
- <RouterContext.Provider value={router}>
52
- <NavigatorContext.Provider value={navigator}>
53
- <RouteContext.Provider value={routeContextValue}>
54
- {children}
55
- </RouteContext.Provider>
56
- </NavigatorContext.Provider>
57
- </RouterContext.Provider>
58
- );
59
- };
@@ -1,102 +0,0 @@
1
- import { shouldNavigate, buildHref, buildActiveClassName } from "dom-utils";
2
- import { memo } from "preact/compat";
3
- import { useCallback, useMemo } from "preact/hooks";
4
-
5
- import { EMPTY_PARAMS, EMPTY_OPTIONS } from "../constants";
6
- import { useIsActiveRoute } from "../hooks/useIsActiveRoute";
7
- import { useRouter } from "../hooks/useRouter";
8
- import { useStableValue } from "../hooks/useStableValue";
9
-
10
- import type { LinkProps } from "../types";
11
- import type { FunctionComponent, JSX } from "preact";
12
-
13
- function areLinkPropsEqual(
14
- prev: Readonly<LinkProps>,
15
- next: Readonly<LinkProps>,
16
- ): boolean {
17
- return (
18
- prev.routeName === next.routeName &&
19
- prev.className === next.className &&
20
- prev.activeClassName === next.activeClassName &&
21
- prev.activeStrict === next.activeStrict &&
22
- prev.ignoreQueryParams === next.ignoreQueryParams &&
23
- prev.onClick === next.onClick &&
24
- prev.target === next.target &&
25
- prev.style === next.style &&
26
- prev.children === next.children &&
27
- JSON.stringify(prev.routeParams) === JSON.stringify(next.routeParams) &&
28
- JSON.stringify(prev.routeOptions) === JSON.stringify(next.routeOptions)
29
- );
30
- }
31
-
32
- export const Link: FunctionComponent<LinkProps> = memo(
33
- ({
34
- routeName,
35
- routeParams = EMPTY_PARAMS,
36
- routeOptions = EMPTY_OPTIONS,
37
- className,
38
- activeClassName = "active",
39
- activeStrict = false,
40
- ignoreQueryParams = true,
41
- onClick,
42
- target,
43
- children,
44
- ...props
45
- }) => {
46
- const router = useRouter();
47
-
48
- const stableParams = useStableValue(routeParams);
49
- const stableOptions = useStableValue(routeOptions);
50
-
51
- const isActive = useIsActiveRoute(
52
- routeName,
53
- stableParams,
54
- activeStrict,
55
- ignoreQueryParams,
56
- );
57
-
58
- const href = useMemo(
59
- () => buildHref(router, routeName, stableParams),
60
- [router, routeName, stableParams],
61
- );
62
-
63
- const handleClick = useCallback(
64
- (evt: JSX.TargetedMouseEvent<HTMLAnchorElement>) => {
65
- if (onClick) {
66
- onClick(evt);
67
-
68
- if (evt.defaultPrevented) {
69
- return;
70
- }
71
- }
72
-
73
- if (!shouldNavigate(evt) || target === "_blank") {
74
- return;
75
- }
76
-
77
- evt.preventDefault();
78
- router.navigate(routeName, stableParams, stableOptions).catch(() => {});
79
- },
80
- [onClick, target, router, routeName, stableParams, stableOptions],
81
- );
82
-
83
- const finalClassName = useMemo(
84
- () => buildActiveClassName(isActive, activeClassName, className),
85
- [isActive, activeClassName, className],
86
- );
87
-
88
- return (
89
- <a
90
- {...props}
91
- href={href}
92
- className={finalClassName}
93
- onClick={handleClick}
94
- >
95
- {children}
96
- </a>
97
- );
98
- },
99
- areLinkPropsEqual,
100
- );
101
-
102
- Link.displayName = "Link";
@@ -1,39 +0,0 @@
1
- import { Match, NotFound } from "./components";
2
- import { buildRenderList, collectElements } from "./helpers";
3
- import { useRouteNode } from "../../hooks/useRouteNode";
4
-
5
- import type { RouteViewProps } from "./types";
6
- import type { VNode } from "preact";
7
-
8
- function RouteViewRoot({
9
- nodeName,
10
- children,
11
- }: Readonly<RouteViewProps>): VNode | null {
12
- const { route } = useRouteNode(nodeName);
13
-
14
- if (!route) {
15
- return null;
16
- }
17
-
18
- const elements: VNode[] = [];
19
-
20
- collectElements(children, elements);
21
-
22
- const { rendered } = buildRenderList(elements, route.name, nodeName);
23
-
24
- if (rendered.length > 0) {
25
- return <>{rendered}</>;
26
- }
27
-
28
- return null;
29
- }
30
-
31
- RouteViewRoot.displayName = "RouteView";
32
-
33
- export const RouteView = Object.assign(RouteViewRoot, { Match, NotFound });
34
-
35
- export type {
36
- RouteViewProps,
37
- MatchProps as RouteViewMatchProps,
38
- NotFoundProps as RouteViewNotFoundProps,
39
- } from "./types";
@@ -1,13 +0,0 @@
1
- import type { MatchProps, NotFoundProps } from "./types";
2
-
3
- export function Match(_props: MatchProps): null {
4
- return null;
5
- }
6
-
7
- Match.displayName = "RouteView.Match";
8
-
9
- export function NotFound(_props: NotFoundProps): null {
10
- return null;
11
- }
12
-
13
- NotFound.displayName = "RouteView.NotFound";
@@ -1,88 +0,0 @@
1
- import { UNKNOWN_ROUTE } from "@real-router/core";
2
- import { startsWithSegment } from "@real-router/route-utils";
3
- import { Fragment, isValidElement, toChildArray } from "preact";
4
- import { Suspense } from "preact/compat";
5
-
6
- import { Match, NotFound } from "./components";
7
-
8
- import type { MatchProps, NotFoundProps } from "./types";
9
- import type { VNode, ComponentChildren } from "preact";
10
-
11
- function isSegmentMatch(
12
- routeName: string,
13
- fullSegmentName: string,
14
- exact: boolean,
15
- ): boolean {
16
- if (exact) {
17
- return routeName === fullSegmentName;
18
- }
19
-
20
- return startsWithSegment(routeName, fullSegmentName);
21
- }
22
-
23
- export function collectElements(
24
- children: ComponentChildren,
25
- result: VNode[],
26
- ): void {
27
- for (const child of toChildArray(children)) {
28
- if (!isValidElement(child)) {
29
- continue;
30
- }
31
-
32
- if (child.type === Match || child.type === NotFound) {
33
- result.push(child);
34
- } else {
35
- collectElements(
36
- (child.props as { readonly children: ComponentChildren }).children,
37
- result,
38
- );
39
- }
40
- }
41
- }
42
-
43
- export function buildRenderList(
44
- elements: VNode[],
45
- routeName: string,
46
- nodeName: string,
47
- ): { rendered: VNode[]; activeMatchFound: boolean } {
48
- let notFoundChildren: ComponentChildren = null;
49
- let activeMatchFound = false;
50
- const rendered: VNode[] = [];
51
-
52
- for (const child of elements) {
53
- if (child.type === NotFound) {
54
- notFoundChildren = (child.props as NotFoundProps).children;
55
- continue;
56
- }
57
-
58
- const { segment, exact = false, fallback } = child.props as MatchProps;
59
- const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;
60
- const isActive =
61
- !activeMatchFound && isSegmentMatch(routeName, fullSegmentName, exact);
62
-
63
- if (isActive) {
64
- activeMatchFound = true;
65
- const matchChildren = (child.props as MatchProps).children;
66
- const content =
67
- fallback === undefined ? (
68
- matchChildren
69
- ) : (
70
- <Suspense fallback={fallback}>{matchChildren}</Suspense>
71
- );
72
-
73
- rendered.push(<Fragment key={fullSegmentName}>{content}</Fragment>);
74
- }
75
- }
76
-
77
- if (
78
- !activeMatchFound &&
79
- routeName === UNKNOWN_ROUTE &&
80
- notFoundChildren !== null
81
- ) {
82
- rendered.push(
83
- <Fragment key="__route-view-not-found__">{notFoundChildren}</Fragment>,
84
- );
85
- }
86
-
87
- return { rendered, activeMatchFound };
88
- }
@@ -1,7 +0,0 @@
1
- export { RouteView } from "./RouteView";
2
-
3
- export type {
4
- RouteViewProps,
5
- RouteViewMatchProps,
6
- RouteViewNotFoundProps,
7
- } from "./RouteView";
@@ -1,17 +0,0 @@
1
- import type { ComponentChildren } from "preact";
2
-
3
- export interface RouteViewProps {
4
- readonly nodeName: string;
5
- readonly children: ComponentChildren;
6
- }
7
-
8
- export interface MatchProps {
9
- readonly segment: string;
10
- readonly exact?: boolean;
11
- readonly fallback?: ComponentChildren;
12
- readonly children: ComponentChildren;
13
- }
14
-
15
- export interface NotFoundProps {
16
- readonly children: ComponentChildren;
17
- }
@@ -1,59 +0,0 @@
1
- import { Fragment } from "preact";
2
- import { useCallback, useEffect, useRef, useState } from "preact/hooks";
3
-
4
- import { useRouterError } from "../hooks/useRouterError";
5
-
6
- import type { RouterError, State } from "@real-router/core";
7
- import type { ComponentChildren, VNode } from "preact";
8
-
9
- export interface RouterErrorBoundaryProps {
10
- readonly children: ComponentChildren;
11
- readonly fallback: (
12
- error: RouterError,
13
- resetError: () => void,
14
- ) => ComponentChildren;
15
- readonly onError?: (
16
- error: RouterError,
17
- toRoute: State | null,
18
- fromRoute: State | null,
19
- ) => void;
20
- }
21
-
22
- export function RouterErrorBoundary({
23
- children,
24
- fallback,
25
- onError,
26
- }: RouterErrorBoundaryProps): VNode {
27
- const snapshot = useRouterError();
28
- const [dismissedVersion, setDismissedVersion] = useState(-1);
29
-
30
- const onErrorRef = useRef(onError);
31
-
32
- // eslint-disable-next-line @eslint-react/refs -- "latest ref" pattern: sync callback to ref to avoid effect re-runs
33
- onErrorRef.current = onError;
34
-
35
- useEffect(() => {
36
- if (snapshot.error) {
37
- onErrorRef.current?.(
38
- snapshot.error,
39
- snapshot.toRoute,
40
- snapshot.fromRoute,
41
- );
42
- }
43
- // eslint-disable-next-line @eslint-react/exhaustive-deps -- onError tracked via ref, snapshot fields accessed inside callback
44
- }, [snapshot.version]);
45
-
46
- const visibleError =
47
- snapshot.version > dismissedVersion ? snapshot.error : null;
48
-
49
- const resetError = useCallback(() => {
50
- setDismissedVersion(snapshot.version);
51
- }, [snapshot.version]);
52
-
53
- return (
54
- <Fragment>
55
- {children}
56
- {visibleError ? fallback(visibleError, resetError) : null}
57
- </Fragment>
58
- );
59
- }
package/src/constants.ts DELETED
@@ -1,9 +0,0 @@
1
- /**
2
- * Stable empty object for default params
3
- */
4
- export const EMPTY_PARAMS = Object.freeze({});
5
-
6
- /**
7
- * Stable empty options object
8
- */
9
- export const EMPTY_OPTIONS = Object.freeze({});
package/src/context.ts DELETED
@@ -1,10 +0,0 @@
1
- import { createContext } from "preact";
2
-
3
- import type { RouteContext as RouteContextType } from "./types";
4
- import type { Router, Navigator } from "@real-router/core";
5
-
6
- export const RouteContext = createContext<RouteContextType | null>(null);
7
-
8
- export const RouterContext = createContext<Router | null>(null);
9
-
10
- export const NavigatorContext = createContext<Navigator | null>(null);
@@ -1,34 +0,0 @@
1
- import { createActiveRouteSource } from "@real-router/sources";
2
- import { useMemo } from "preact/hooks";
3
-
4
- import { useSyncExternalStore } from "../useSyncExternalStore";
5
- import { useRouter } from "./useRouter";
6
- import { useStableValue } from "./useStableValue";
7
-
8
- import type { Params } from "@real-router/core";
9
-
10
- export function useIsActiveRoute(
11
- routeName: string,
12
- params?: Params,
13
- strict = false,
14
- ignoreQueryParams = true,
15
- ): boolean {
16
- const router = useRouter();
17
-
18
- const stableParams = useStableValue(params);
19
-
20
- const store = useMemo(
21
- () =>
22
- createActiveRouteSource(router, routeName, stableParams, {
23
- strict,
24
- ignoreQueryParams,
25
- }),
26
- [router, routeName, stableParams, strict, ignoreQueryParams],
27
- );
28
-
29
- return useSyncExternalStore(
30
- store.subscribe,
31
- store.getSnapshot,
32
- store.getSnapshot,
33
- );
34
- }
@@ -1,15 +0,0 @@
1
- import { useContext } from "preact/hooks";
2
-
3
- import { NavigatorContext } from "../context";
4
-
5
- import type { Navigator } from "@real-router/core";
6
-
7
- export const useNavigator = (): Navigator => {
8
- const navigator = useContext(NavigatorContext);
9
-
10
- if (!navigator) {
11
- throw new Error("useNavigator must be used within a RouterProvider");
12
- }
13
-
14
- return navigator;
15
- };
@@ -1,15 +0,0 @@
1
- import { useContext } from "preact/hooks";
2
-
3
- import { RouteContext } from "../context";
4
-
5
- import type { RouteContext as RouteContextType } from "../types";
6
-
7
- export const useRoute = (): RouteContextType => {
8
- const routeContext = useContext(RouteContext);
9
-
10
- if (!routeContext) {
11
- throw new Error("useRoute must be used within a RouteProvider");
12
- }
13
-
14
- return routeContext;
15
- };
@@ -1,30 +0,0 @@
1
- import { getNavigator } from "@real-router/core";
2
- import { createRouteNodeSource } from "@real-router/sources";
3
- import { useMemo } from "preact/hooks";
4
-
5
- import { useSyncExternalStore } from "../useSyncExternalStore";
6
- import { useRouter } from "./useRouter";
7
-
8
- import type { RouteContext } from "../types";
9
-
10
- export function useRouteNode(nodeName: string): RouteContext {
11
- const router = useRouter();
12
-
13
- const store = useMemo(
14
- () => createRouteNodeSource(router, nodeName),
15
- [router, nodeName],
16
- );
17
-
18
- const { route, previousRoute } = useSyncExternalStore(
19
- store.subscribe,
20
- store.getSnapshot,
21
- store.getSnapshot,
22
- );
23
-
24
- const navigator = useMemo(() => getNavigator(router), [router]);
25
-
26
- return useMemo(
27
- (): RouteContext => ({ navigator, route, previousRoute }),
28
- [navigator, route, previousRoute],
29
- );
30
- }
@@ -1,12 +0,0 @@
1
- import { getPluginApi } from "@real-router/core/api";
2
- import { getRouteUtils } from "@real-router/route-utils";
3
-
4
- import { useRouter } from "./useRouter";
5
-
6
- import type { RouteUtils } from "@real-router/route-utils";
7
-
8
- export const useRouteUtils = (): RouteUtils => {
9
- const router = useRouter();
10
-
11
- return getRouteUtils(getPluginApi(router).getTree());
12
- };
@@ -1,15 +0,0 @@
1
- import { useContext } from "preact/hooks";
2
-
3
- import { RouterContext } from "../context";
4
-
5
- import type { Router } from "@real-router/core";
6
-
7
- export const useRouter = (): Router => {
8
- const router = useContext(RouterContext);
9
-
10
- if (!router) {
11
- throw new Error("useRouter must be used within a RouterProvider");
12
- }
13
-
14
- return router;
15
- };
@@ -1,31 +0,0 @@
1
- import { createErrorSource } from "@real-router/sources";
2
- import { useMemo } from "preact/hooks";
3
-
4
- import { useSyncExternalStore } from "../useSyncExternalStore";
5
- import { useRouter } from "./useRouter";
6
-
7
- import type { Router } from "@real-router/core";
8
- import type { RouterErrorSnapshot, RouterSource } from "@real-router/sources";
9
-
10
- const cache = new WeakMap<Router, RouterSource<RouterErrorSnapshot>>();
11
-
12
- export function useRouterError(): RouterErrorSnapshot {
13
- const router = useRouter();
14
-
15
- const store = useMemo(() => {
16
- let source = cache.get(router);
17
-
18
- if (!source) {
19
- source = createErrorSource(router);
20
- cache.set(router, source);
21
- }
22
-
23
- return source;
24
- }, [router]);
25
-
26
- return useSyncExternalStore(
27
- store.subscribe,
28
- store.getSnapshot,
29
- store.getSnapshot,
30
- );
31
- }
@@ -1,19 +0,0 @@
1
- import { createTransitionSource } from "@real-router/sources";
2
- import { useMemo } from "preact/hooks";
3
-
4
- import { useSyncExternalStore } from "../useSyncExternalStore";
5
- import { useRouter } from "./useRouter";
6
-
7
- import type { RouterTransitionSnapshot } from "@real-router/sources";
8
-
9
- export function useRouterTransition(): RouterTransitionSnapshot {
10
- const router = useRouter();
11
-
12
- const store = useMemo(() => createTransitionSource(router), [router]);
13
-
14
- return useSyncExternalStore(
15
- store.subscribe,
16
- store.getSnapshot,
17
- store.getSnapshot,
18
- );
19
- }
@@ -1,8 +0,0 @@
1
- import { useMemo } from "preact/hooks";
2
-
3
- export function useStableValue<T>(value: T): T {
4
- const serialized = JSON.stringify(value);
5
-
6
- // eslint-disable-next-line @eslint-react/exhaustive-deps
7
- return useMemo(() => value, [serialized]);
8
- }
package/src/index.ts DELETED
@@ -1,39 +0,0 @@
1
- // Components
2
- export { RouteView } from "./components/RouteView";
3
-
4
- export { Link } from "./components/Link";
5
-
6
- export { RouterErrorBoundary } from "./components/RouterErrorBoundary";
7
-
8
- // Hooks
9
- export { useRouter } from "./hooks/useRouter";
10
-
11
- export { useNavigator } from "./hooks/useNavigator";
12
-
13
- export { useRouteUtils } from "./hooks/useRouteUtils";
14
-
15
- export { useRoute } from "./hooks/useRoute";
16
-
17
- export { useRouteNode } from "./hooks/useRouteNode";
18
-
19
- export { useRouterTransition } from "./hooks/useRouterTransition";
20
-
21
- // Context
22
- export { RouterProvider } from "./RouterProvider";
23
-
24
- export { RouterContext, NavigatorContext, RouteContext } from "./context";
25
-
26
- // Types
27
- export type { LinkProps } from "./types";
28
-
29
- export type { RouterErrorBoundaryProps } from "./components/RouterErrorBoundary";
30
-
31
- export type {
32
- RouteViewProps,
33
- RouteViewMatchProps,
34
- RouteViewNotFoundProps,
35
- } from "./components/RouteView";
36
-
37
- export type { Navigator } from "@real-router/core";
38
-
39
- export type { RouterTransitionSnapshot } from "@real-router/sources";
package/src/types.ts DELETED
@@ -1,30 +0,0 @@
1
- import type {
2
- NavigationOptions,
3
- Params,
4
- Navigator,
5
- State,
6
- } from "@real-router/core";
7
- import type { JSX } from "preact";
8
-
9
- export interface RouteState<P extends Params = Params> {
10
- route: State<P> | undefined;
11
- previousRoute?: State | undefined;
12
- }
13
-
14
- export type RouteContext = {
15
- navigator: Navigator;
16
- } & RouteState;
17
-
18
- export interface LinkProps<P extends Params = Params> extends Omit<
19
- JSX.HTMLAttributes<HTMLAnchorElement>,
20
- "className"
21
- > {
22
- routeName: string;
23
- routeParams?: P;
24
- routeOptions?: NavigationOptions;
25
- className?: string;
26
- activeClassName?: string;
27
- activeStrict?: boolean;
28
- ignoreQueryParams?: boolean;
29
- target?: string;
30
- }
@@ -1,32 +0,0 @@
1
- import { useEffect, useState } from "preact/hooks";
2
-
3
- /**
4
- * Polyfill for React's useSyncExternalStore.
5
- *
6
- * Preact does not provide a native useSyncExternalStore.
7
- * This implementation uses useState + useEffect to subscribe
8
- * to external stores.
9
- *
10
- * Race condition handling: the value may change between
11
- * `useState(getSnapshot)` (render) and `useEffect` (commit).
12
- * We synchronize by calling `setValue(getSnapshot())` before
13
- * subscribing in the effect.
14
- */
15
- export function useSyncExternalStore<T>(
16
- subscribe: (onStoreChange: () => void) => () => void,
17
- getSnapshot: () => T,
18
- _getServerSnapshot?: () => T,
19
- ): T {
20
- const [value, setValue] = useState(getSnapshot);
21
-
22
- useEffect(() => {
23
- // Synchronize before subscribing to handle race condition
24
- setValue(getSnapshot());
25
-
26
- return subscribe(() => {
27
- setValue(getSnapshot());
28
- });
29
- }, [subscribe, getSnapshot]);
30
-
31
- return value;
32
- }