@buzola/router 0.0.18 → 0.0.19

package/dist/engine/utils.js

@@ -22,12 +22,12 @@ export function extractParamNames(pattern) {
     return names;
 }
 /**
- * Whether two URLs address the same page — i.e. only search/hash differ.
+ * Whether two URLs address the same page, i.e. only search/hash differ.
  * Same-path navigations (filters, sorting, pagination, search) keep the page
  * on screen and keep its loader data as stale; path changes do not.
  *
- * Note this ignores the hash. Callers that care about fragment changes — focus
- * handling, for one — have to compare `hash` themselves.
+ * Note this ignores the hash. Callers that care about fragment changes (focus
+ * handling, for one) have to compare `hash` themselves.
  */
 export function isSamePath(a, b) {
     const urlA = typeof a === 'string' ? new URL(a) : a;

package/dist/react/hooks.d.ts

@@ -7,7 +7,7 @@ export declare function useRouter(): Router;
 /**
  * Type-safe navigation function.
  * Uses page IDs instead of URL patterns.
- * Persistent params are optional — resolved from current URL or fallback.
+ * Persistent params are optional: resolved from current URL or fallback.
  */
 type NavigateFn = <P extends RegisteredPage>(to: P, ...args: [keyof EffectivePageParams<P>] extends [never] ? [options?: NavigateOptions] : {} extends EffectivePageParams<P> ? [options?: NavigateOptions & {
     params?: EffectivePageParams<P>;
@@ -16,7 +16,7 @@ type NavigateFn = <P extends RegisteredPage>(to: P, ...args: [keyof EffectivePag
 }]) => void;
 /**
  * Hook to get a type-safe navigate function.
- * Navigates using page IDs — the router looks up the route pattern from the page registry.
+ * Navigates using page IDs: the router looks up the route pattern from the page registry.
  */
 export declare function useNavigate(): NavigateFn;
 /**

package/dist/react/hooks.js

@@ -23,7 +23,7 @@ function useRouteContext() {
 }
 /**
  * Hook to get a type-safe navigate function.
- * Navigates using page IDs — the router looks up the route pattern from the page registry.
+ * Navigates using page IDs: the router looks up the route pattern from the page registry.
  */
 export function useNavigate() {
     const router = useRouter();

package/dist/react/link.d.ts

@@ -25,9 +25,9 @@ type LinkPropsBase = Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'>
     asChild?: boolean;
     /**
      * Prefetch strategy for lazy-loaded route code.
-     * - `'intent'` — preload on mouseEnter/focus (default)
-     * - `'render'` — preload as soon as the Link renders
-     * - `'none'` — disable prefetching
+     * - `'intent'`: preload on mouseEnter/focus (default)
+     * - `'render'`: preload as soon as the Link renders
+     * - `'none'`: disable prefetching
      */
     prefetch?: 'intent' | 'render' | 'none';
 };
@@ -43,7 +43,7 @@ export type LinkProps<P extends RegisteredPage = RegisteredPage> = [keyof Effect
 };
 /**
  * Type-safe link component.
- * Uses page IDs for navigation — the router looks up the route pattern from the page registry.
+ * Uses page IDs for navigation: the router looks up the route pattern from the page registry.
  * For simple navigations, renders a native <a> and lets the Navigation API handle it.
  * Uses programmatic navigation when state, replace, resetScroll, or viewTransition is needed.
  *

package/dist/react/link.js

@@ -3,7 +3,7 @@ import React, { useCallback, useEffect, useRef } from 'react';
 import { useRouter, useRouterState } from './hooks.js';
 /**
  * Type-safe link component.
- * Uses page IDs for navigation — the router looks up the route pattern from the page registry.
+ * Uses page IDs for navigation: the router looks up the route pattern from the page registry.
  * For simple navigations, renders a native <a> and lets the Navigation API handle it.
  * Uses programmatic navigation when state, replace, resetScroll, or viewTransition is needed.
  *

package/dist/react/outlet.js

@@ -8,7 +8,7 @@ function DefaultNotFound() {
         style: { fontFamily: 'system-ui, sans-serif', padding: '2rem', maxWidth: '600px', margin: '0 auto' },
     }, isDev
         ? [
-            React.createElement('h1', { key: 'h' }, '404 — Page Not Found'),
+            React.createElement('h1', { key: 'h' }, '404: Page Not Found'),
             React.createElement('p', { key: 'p1' }, `No route matches "${typeof window !== 'undefined' ? window.location.pathname : ''}".`),
             React.createElement('p', {
                 key: 'p2',
@@ -56,7 +56,7 @@ export function Outlet({ fallback, errorFallback, notFound }) {
         };
     }, [state, depth, effectiveDepth, matches, match, routeContext.params]);
     if (!match) {
-        // At root depth with no matches — show 404
+        // At root depth with no matches: show 404
         if (depth === 0 && matches.length === 0) {
             if (notFound === null)
                 return null;

package/dist/react/outlet.js.map

@@ -1 +1 @@
-{"version":3,"file":"outlet.js","sourceRoot":"","sources":["../../src/react/outlet.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"outlet.js","sourceRoot":"","sources":["../../src/react/outlet.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@buzola/router",
-	"version": "0.0.18",
+	"version": "0.0.19",
 	"type": "module",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",

package/src/__tests__/create-page.test.ts

@@ -610,7 +610,7 @@ describe('redirect()', () => {
 			})
 			.render(() => null)
 
-		expect(typeof receivedRedirect).toBe('undefined') // not called yet — component not rendered
+		expect(typeof receivedRedirect).toBe('undefined') // not called yet: component not rendered
 		// Verify the type is correct by checking the function signature
 		expect(page.__buzolaPage).toBe(true)
 	})

package/src/__tests__/loader-cache.test.ts

@@ -91,7 +91,7 @@ describe('LoaderCache', () => {
 		cache.set('a', 1)
 		cache.set('b', 2)
 
-		// Update 'a' — should move to most recent
+		// Update 'a': should move to most recent
 		cache.set('a', 10)
 
 		// Now 'b' is the oldest

package/src/__tests__/loader-state.test.ts

@@ -74,7 +74,7 @@ describe('PageLoaderState', () => {
 	})
 
 	describe('invalidation (cache key change)', () => {
-		it('with stale data — returns stale data with isLoading and starts background fetch', () => {
+		it('with stale data: returns stale data with isLoading and starts background fetch', () => {
 			const state = createState()
 			resolveCtx(state, { cacheKey: 'k:0' })
 			state.commitResult('stale-data')
@@ -93,12 +93,12 @@ describe('PageLoaderState', () => {
 			expect(bgLoad).toBeDefined()
 		})
 
-		it('without stale data — returns suspend instruction', () => {
+		it('without stale data: returns suspend instruction', () => {
 			const state = createState()
 			const promise = Promise.resolve('data')
 			const instruction = resolveCtx(state, { cacheKey: 'k:0', load: () => promise })
 
-			// No commitResult called — no stale data
+			// No commitResult called: no stale data
 			const second = resolveCtx(state, { cacheKey: 'k:1', load: () => Promise.resolve('new') })
 			expect(second.action).toBe('suspend')
 		})
@@ -149,7 +149,7 @@ describe('PageLoaderState', () => {
 				onBackgroundSettled: settled1,
 			})
 
-			// Immediately invalidate again — supersedes the first background fetch
+			// Immediately invalidate again: supersedes the first background fetch
 			state.commitBackgroundResult('stale') // commit so hasResolved stays true
 			const settled2 = mock(() => {})
 			resolveCtx(state, {
@@ -200,7 +200,7 @@ describe('PageLoaderState', () => {
 			resolveCtx(state, { url: 'http://localhost/a', cacheKey: 'a:0', loaderCache: cache })
 			state.commitResult('data-a')
 
-			// Navigate to B — should save A's data to cache
+			// Navigate to B: should save A's data to cache
 			resolveCtx(state, { url: 'http://localhost/b', cacheKey: 'b:0', loaderCache: cache })
 
 			expect(cache.size).toBe(1)
@@ -218,7 +218,7 @@ describe('PageLoaderState', () => {
 			resolveCtx(state, { url: 'http://localhost/b', cacheKey: 'b:0', loaderCache: cache })
 			state.commitResult('data-b')
 
-			// Navigate back to A — should restore from cache
+			// Navigate back to A: should restore from cache
 			const instruction = resolveCtx(state, {
 				url: 'http://localhost/a',
 				cacheKey: 'a:0',
@@ -229,11 +229,11 @@ describe('PageLoaderState', () => {
 			expect(instruction.action).toBe('render')
 			if (instruction.action === 'render') {
 				expect(instruction.data).toBe('data-a')
-				expect(instruction.isLoading).toBe(true) // SWR — stale data + background reload
+				expect(instruction.isLoading).toBe(true) // SWR: stale data + background reload
 			}
 		})
 
-		it('keeps data as stale when only the query changes — no suspend', () => {
+		it('keeps data as stale when only the query changes: no suspend', () => {
 			const cache = new LoaderCache(10)
 			const state = createState()
 
@@ -301,7 +301,7 @@ describe('PageLoaderState', () => {
 			// Load A without committing (no stale data to cache)
 			resolveCtx(state, { url: 'http://localhost/a', cacheKey: 'a:0', loaderCache: cache })
 
-			// Navigate to B — no cache for B
+			// Navigate to B: no cache for B
 			const instruction = resolveCtx(state, {
 				url: 'http://localhost/b',
 				cacheKey: 'b:0',
@@ -317,7 +317,7 @@ describe('PageLoaderState', () => {
 			const cache = new LoaderCache(10)
 			const state1 = createState()
 
-			// First mount — load and dispose
+			// First mount: load and dispose
 			resolveCtx(state1, { url: 'http://localhost/a', cacheKey: 'a:0', loaderCache: cache })
 			state1.commitResult('cached-data')
 			state1.dispose(cache) // saves to cache
@@ -386,13 +386,13 @@ describe('PageLoaderState', () => {
 	})
 
 	describe('no loader cache', () => {
-		it('works without loaderCache — no stale caching', () => {
+		it('works without loaderCache: no stale caching', () => {
 			const state = createState()
 
 			resolveCtx(state, { url: 'http://localhost/a', cacheKey: 'a:0' })
 			state.commitResult('data-a')
 
-			// URL change without cache — no restore
+			// URL change without cache: no restore
 			const instruction = resolveCtx(state, { url: 'http://localhost/b', cacheKey: 'b:0' })
 			expect(instruction.action).toBe('suspend')
 		})

package/src/__tests__/navigation-adapter.test.ts

@@ -39,7 +39,7 @@ describe('createBrowserNavigationAdapter', () => {
 	/* The case actually seen in the wild: the getter returns the empty string on a
 	   document that is not fully active, which is what Safari handed us. `new
 	   URL('')` throws just as `new URL(null)` does, and it throws out of the
-	   `Router` constructor during render — a blank page, not a degraded route. An
+	   `Router` constructor during render: a blank page, not a degraded route. An
 	   empty string is falsy but not nullish, so this is the case `??` would miss. */
 	it('falls back to the document URL when the entry reports an empty URL', () => {
 		const adapter = withNavigation({ url: '' })
@@ -50,7 +50,7 @@ describe('createBrowserNavigationAdapter', () => {
 	/* `url` is also typed nullable: the getter returns null for entries whose
 	   document is not the current one and was fetched under a `no-referrer` or
 	   `origin` referrer policy. That branch needs `sameDocument` to be false, which
-	   `currentEntry` never is, so it should not be reachable through this call —
+	   `currentEntry` never is, so it should not be reachable through this call,
 	   but the type permits it and the fallback costs nothing. */
 	it('falls back to the document URL when the entry reports no URL', () => {
 		const adapter = withNavigation({ url: null })

package/src/__tests__/react.test.tsx

@@ -563,7 +563,7 @@ describe('Page loaders', () => {
 		})
 		await flushNav()
 
-		// No Suspense fallback — the stale render stays up until the reload lands
+		// No Suspense fallback: the stale render stays up until the reload lands
 		expect(container.textContent).toBe('loads:1')
 
 		await act(async () => {
@@ -672,7 +672,7 @@ describe('Outlet', () => {
 			{
 				path: '/admin',
 				isLayout: true,
-				// No component — should be skipped
+				// No component: should be skipped
 				children: [
 					{ path: '/dashboard', component: () => <div>Dashboard</div> },
 				],
@@ -952,7 +952,7 @@ describe('useBlocker', () => {
 
 		expect(getByTestId('state').textContent).toBe('idle')
 
-		// Try to navigate — should be blocked
+		// Try to navigate: should be blocked
 		router.navigate('/about')
 		await flushNav()
 
@@ -1123,7 +1123,7 @@ describe('ErrorBoundary', () => {
 
 		expect(container.textContent).toContain('Route error: boom')
 
-		// Change resetKey and stop throwing — should reset
+		// Change resetKey and stop throwing: should reset
 		rerender(
 			<ErrorBoundary resetKey="b">
 				<MaybeThrow shouldThrow={false} />

package/src/__tests__/router.test.ts

@@ -307,7 +307,7 @@ describe('Router same-URL navigation', () => {
 		expect(count()).toBe(1)
 	})
 
-	it('does not invalidate when the URL changes — the href-keyed loader reloads on its own', () => {
+	it('does not invalidate when the URL changes: the href-keyed loader reloads on its own', () => {
 		const { router, count } = createCountingRouter('http://localhost/')
 
 		router.navigate('/list')
@@ -408,7 +408,7 @@ describe('Router focus reset', () => {
 		try {
 			const { router, captured } = createCapturingRouter('http://localhost/list')
 
-			// No route matches — the router bails out before intercepting
+			// No route matches: the router bails out before intercepting
 			router.navigate('/unmatched', { focusReset: 'manual' })
 			expect(captured).toHaveLength(0)
 

package/src/__tests__/setup-dom.ts

@@ -11,7 +11,7 @@ for (const key of Object.getOwnPropertyNames(window)) {
 			configurable: true,
 		})
 	} catch {
-		// Some properties can't be set — skip them
+		// Some properties can't be set: skip them
 	}
 }
 

package/src/__tests__/type-safety.test.tsx

@@ -29,7 +29,7 @@ describe('createPage route type safety', () => {
 	})
 
 	it('rejects dynamic route without params', () => {
-		// @ts-expect-error — :id in route but no .params() defined
+		// @ts-expect-error: :id in route but no .params() defined
 		const _page = createPage().route('/users/:id').render(() => null)
 		expect(true).toBe(true)
 	})
@@ -45,7 +45,7 @@ describe('createPage route type safety', () => {
 	it('rejects dynamic route when param is not in schema', () => {
 		const _page = createPage()
 			.params(mockSchema<{ userId: string }>())
-			// @ts-expect-error — :id is not a key of { userId: string }
+			// @ts-expect-error: :id is not a key of { userId: string }
 			.route('/users/:id')
 			.render(({ params }) => null)
 		expect(true).toBe(true)
@@ -62,7 +62,7 @@ describe('createPage route type safety', () => {
 	it('rejects when one route param is missing from schema', () => {
 		const _page = createPage()
 			.params(mockSchema<{ userId: string }>())
-			// @ts-expect-error — :postId is not in { userId: string }
+			// @ts-expect-error: :postId is not in { userId: string }
 			.route('/users/:userId/posts/:postId')
 			.render(({ params }) => null)
 		expect(true).toBe(true)
@@ -97,14 +97,14 @@ describe('createPage catch type safety', () => {
 
 	it('no .catch() after .catch()', () => {
 		const withCatch = createPage().catch(({ error }) => <div>{error.message}</div>)
-		// @ts-expect-error — .catch() should not be available after .catch()
+		// @ts-expect-error: .catch() should not be available after .catch()
 		withCatch.catch
 		expect(true).toBe(true)
 	})
 
 	it('no .loader() after .catch()', () => {
 		const withCatch = createPage().catch(({ error }) => <div>{error.message}</div>)
-		// @ts-expect-error — .loader() should not be available after .catch()
+		// @ts-expect-error: .loader() should not be available after .catch()
 		withCatch.loader
 		expect(true).toBe(true)
 	})
@@ -125,7 +125,7 @@ describe('createPage catch type safety', () => {
 	it('.catch() handler has empty params when no schema defined', () => {
 		const _page = createPage()
 			.catch(({ params }) => {
-				// @ts-expect-error — no params defined, accessing unknown key
+				// @ts-expect-error: no params defined, accessing unknown key
 				params.anything
 				return null
 			})
@@ -144,7 +144,7 @@ describe('LinkProps type safety', () => {
 	})
 
 	it('static page rejects params', () => {
-		// @ts-expect-error — static page should not accept params
+		// @ts-expect-error: static page should not accept params
 		const _a: LinkProps<'about'> = { to: 'about', params: { foo: 'bar' } }
 		expect(true).toBe(true)
 	})
@@ -152,13 +152,13 @@ describe('LinkProps type safety', () => {
 	it('dynamic page requires params', () => {
 		const _a: LinkProps<'users/detail'> = { to: 'users/detail', params: { userId: '1' } }
 
-		// @ts-expect-error — missing required params
+		// @ts-expect-error: missing required params
 		const _b: LinkProps<'users/detail'> = { to: 'users/detail' }
 		expect(true).toBe(true)
 	})
 
 	it('dynamic page requires correct param names', () => {
-		// @ts-expect-error — wrong param name
+		// @ts-expect-error: wrong param name
 		const _a: LinkProps<'users/detail'> = { to: 'users/detail', params: { id: '1' } }
 		expect(true).toBe(true)
 	})
@@ -171,14 +171,14 @@ describe('LinkProps type safety', () => {
 
 		const _b: LinkProps<'users/posts'> = {
 			to: 'users/posts',
-			// @ts-expect-error — missing postId
+			// @ts-expect-error: missing postId
 			params: { userId: '1' },
 		}
 		expect(true).toBe(true)
 	})
 
 	it('rejects unregistered pages', () => {
-		// @ts-expect-error — page not in BuzolaPageMap
+		// @ts-expect-error: page not in BuzolaPageMap
 		const _a: LinkProps<'unknown'> = { to: 'unknown' }
 		expect(true).toBe(true)
 	})
@@ -196,7 +196,7 @@ describe('Link JSX generic inference', () => {
 	})
 
 	it('rejects params on static page', () => {
-		// @ts-expect-error — static page should not accept params
+		// @ts-expect-error: static page should not accept params
 		const _el = <Link to="about" params={{ foo: 'bar' }}>About</Link>
 		expect(true).toBe(true)
 	})
@@ -204,13 +204,13 @@ describe('Link JSX generic inference', () => {
 	it('requires params on dynamic page', () => {
 		const _el = <Link to="users/detail" params={{ userId: '1' }}>User</Link>
 
-		// @ts-expect-error — missing required params
+		// @ts-expect-error: missing required params
 		const _el2 = <Link to="users/detail">User</Link>
 		expect(true).toBe(true)
 	})
 
 	it('rejects wrong param names', () => {
-		// @ts-expect-error — wrong param name
+		// @ts-expect-error: wrong param name
 		const _el = <Link to="users/detail" params={{ id: '1' }}>User</Link>
 		expect(true).toBe(true)
 	})
@@ -218,13 +218,13 @@ describe('Link JSX generic inference', () => {
 	it('requires all params for multi-param page', () => {
 		const _ok = <Link to="users/posts" params={{ userId: '1', postId: '2' }}>Post</Link>
 
-		// @ts-expect-error — missing postId
+		// @ts-expect-error: missing postId
 		const _bad = <Link to="users/posts" params={{ userId: '1' }}>Post</Link>
 		expect(true).toBe(true)
 	})
 
 	it('rejects unregistered pages', () => {
-		// @ts-expect-error — page not in BuzolaPageMap
+		// @ts-expect-error: page not in BuzolaPageMap
 		const _el = <Link to="nope">Nope</Link>
 		expect(true).toBe(true)
 	})
@@ -258,7 +258,7 @@ describe('NavigateFn type safety', () => {
 	})
 
 	it('static page rejects params', () => {
-		// @ts-expect-error — static page should not accept params
+		// @ts-expect-error: static page should not accept params
 		noop('home', { params: { foo: 'bar' } })
 		expect(true).toBe(true)
 	})
@@ -266,19 +266,19 @@ describe('NavigateFn type safety', () => {
 	it('dynamic page requires options with params', () => {
 		noop('users/detail', { params: { userId: '1' } })
 
-		// @ts-expect-error — missing required options with params
+		// @ts-expect-error: missing required options with params
 		noop('users/detail')
 		expect(true).toBe(true)
 	})
 
 	it('dynamic page requires correct param names', () => {
-		// @ts-expect-error — wrong param name (id instead of userId)
+		// @ts-expect-error: wrong param name (id instead of userId)
 		noop('users/detail', { params: { id: '1' } })
 		expect(true).toBe(true)
 	})
 
 	it('dynamic page rejects params passed directly as options (without params wrapper)', () => {
-		// @ts-expect-error — { userId: '1' } is not valid, must be { params: { userId: '1' } }
+		// @ts-expect-error: { userId: '1' } is not valid, must be { params: { userId: '1' } }
 		noop('users/detail', { userId: '1' })
 		expect(true).toBe(true)
 	})
@@ -286,13 +286,13 @@ describe('NavigateFn type safety', () => {
 	it('multi-param page requires all params', () => {
 		noop('users/posts', { params: { userId: '1', postId: '2' } })
 
-		// @ts-expect-error — missing postId
+		// @ts-expect-error: missing postId
 		noop('users/posts', { params: { userId: '1' } })
 		expect(true).toBe(true)
 	})
 
 	it('rejects unregistered pages', () => {
-		// @ts-expect-error — page not in BuzolaPageMap
+		// @ts-expect-error: page not in BuzolaPageMap
 		noop('unknown')
 		expect(true).toBe(true)
 	})

package/src/define/create-page.tsx

@@ -156,7 +156,7 @@ function combineLoaders(loaders: LoaderFn[]): LoaderFn | undefined {
 }
 
 /**
- * Follow a loader redirect, unless it points at the URL the page is already on —
+ * Follow a loader redirect, unless it points at the URL the page is already on:
  * that navigation re-runs the loader, which returns the same redirect, forever.
  */
 function followRedirect(router: Router | null, target: BuzolaRedirect): void {

package/src/engine/loader-cache.ts

@@ -1,7 +1,7 @@
 /**
  * Global LRU cache for page loader data.
  * Shared across all page components to limit total memory usage.
- * Uses Map insertion order for LRU eviction — oldest entries are evicted first.
+ * Uses Map insertion order for LRU eviction: oldest entries are evicted first.
  */
 export class LoaderCache {
 	private cache = new Map<string, unknown>()

package/src/engine/loader-state.ts

@@ -8,7 +8,7 @@ export type LoaderInstruction =
 	| { action: 'suspend'; promise: Promise<unknown> }
 
 export interface LoaderResolveContext {
-	/** Current URL href — used for stale cache keying */
+	/** Current URL href: used for stale cache keying */
 	currentUrlHref: string
 	/** Cache key that changes on URL change or invalidation */
 	cacheKey: string
@@ -31,7 +31,7 @@ let nextId = 0
 /**
  * Manages loader data lifecycle outside of React's render cycle.
  *
- * This state survives React Suspense retries — when use() suspends, React
+ * This state survives React Suspense retries. When use() suspends, React
  * discards uncommitted hook state (useRef, useState, useMemo). Closure/instance
  * state is preserved, preventing infinite suspend loops from promise recreation.
  *
@@ -43,7 +43,7 @@ export class PageLoaderState {
 	private activeCacheKey: string | null = null
 	private activePromise: Promise<unknown> | null = null
 	private activeResolvedData: unknown
-	/** URL the currently held data was loaded for — data is cached under this href, not the active one. */
+	/** URL the currently held data was loaded for: data is cached under this href, not the active one. */
 	private resolvedUrlHref: string | null = null
 	private hasResolved = false
 	private pendingBackgroundKey: string | null = null
@@ -62,7 +62,7 @@ export class PageLoaderState {
 
 		this.handleUrlChange(currentUrlHref, loaderCache)
 
-		// ─── Same cache key — return current state ─────
+		// ─── Same cache key: return current state ─────
 		if (this.activeCacheKey === cacheKey) {
 			if (this.pendingBackgroundKey === cacheKey) {
 				return { action: 'render', data: this.activeResolvedData, isLoading: true }
@@ -110,14 +110,14 @@ export class PageLoaderState {
 		this.hasResolved = true
 	}
 
-	/** Commit background SWR success — update data and clear pending flag */
+	/** Commit background SWR success: update data and clear pending flag */
 	commitBackgroundResult(data: unknown): void {
 		this.activeResolvedData = data
 		this.resolvedUrlHref = this.activeUrlHref
 		this.pendingBackgroundKey = null
 	}
 
-	/** Mark background load as failed — next render will suspend with rejected promise */
+	/** Mark background load as failed: next render will suspend with rejected promise */
 	commitBackgroundError(): void {
 		this.hasResolved = false
 		this.pendingBackgroundKey = null
@@ -141,7 +141,7 @@ export class PageLoaderState {
 
 	private handleUrlChange(currentUrlHref: string, loaderCache: LoaderCache | undefined): void {
 		if (this.activeUrlHref !== null && this.activeUrlHref !== currentUrlHref) {
-			// URL changed — save the held data to stale cache under the href it was loaded for
+			// URL changed: save the held data to stale cache under the href it was loaded for
 			if (loaderCache && this.hasResolved && this.activeResolvedData !== undefined && this.resolvedUrlHref) {
 				this.saveToStaleCache(loaderCache, this.resolvedUrlHref, this.activeResolvedData)
 			}
@@ -152,7 +152,7 @@ export class PageLoaderState {
 				this.resolvedUrlHref = currentUrlHref
 				this.hasResolved = true
 			} else if (!isSamePath(this.activeUrlHref, currentUrlHref)) {
-				// Different path — the held data describes another page, drop it and suspend
+				// Different path: the held data describes another page, so drop it and suspend
 				this.hasResolved = false
 				this.activeResolvedData = undefined
 				this.resolvedUrlHref = null
@@ -161,7 +161,7 @@ export class PageLoaderState {
 			// keep the data as stale so resolve() serves it while the new query loads.
 			this.pendingBackgroundKey = null
 		} else if (this.activeUrlHref === null && loaderCache) {
-			// Remount — try to restore from stale cache
+			// Remount: try to restore from stale cache
 			const cached = this.restoreFromStaleCache(loaderCache, currentUrlHref)
 			if (cached.hit) {
 				this.activeResolvedData = cached.value

package/src/engine/matcher.ts

@@ -20,7 +20,7 @@ function matchTrie(
 	values: string[],
 	pathname: string,
 ): RouteMatch[] | null {
-	// All segments consumed — check if this trie node has a terminal route
+	// All segments consumed: check if this trie node has a terminal route
 	if (index === segments.length) {
 		if (node.route) {
 			return buildMatchChain(node.route, values, pathname)
@@ -30,20 +30,20 @@ function matchTrie(
 
 	const segment = segments[index]
 
-	// 1. Try static child first — O(1) Map lookup, always most specific
+	// 1. Try static child first: O(1) Map lookup, always most specific
 	const staticChild = node.staticChildren.get(segment)
 	if (staticChild) {
 		const result = matchTrie(staticChild, segments, index + 1, values, pathname)
 		if (result) return result
 	}
 
-	// 2. Try dynamic child — matches any single segment
+	// 2. Try dynamic child: matches any single segment
 	if (node.dynamicChild) {
 		const result = matchTrie(node.dynamicChild, segments, index + 1, [...values, decodeURIComponent(segment)], pathname)
 		if (result) return result
 	}
 
-	// 3. Try catch-all child — consumes all remaining segments
+	// 3. Try catch-all child: consumes all remaining segments
 	if (node.catchAllChild) {
 		const remaining = segments.slice(index).map(s => decodeURIComponent(s)).join('/')
 		return buildMatchChain(node.catchAllChild, [...values, remaining], pathname)