From 720fc5fc7c751e31ebab7624f7b9f4116e68c1ed Mon Sep 17 00:00:00 2001 From: daishi Date: Fri, 6 Mar 2026 20:28:46 +0900 Subject: [PATCH 01/10] refactor: path for public api, pathname for original path, routePath for normalized path --- e2e/fixtures/use-router/src/TestRouter.tsx | 13 +++ e2e/use-router.spec.ts | 42 +++++++- examples/22_define-router/src/waku.server.tsx | 2 +- packages/waku/src/router/client.tsx | 43 ++++---- packages/waku/src/router/common.ts | 37 ++++--- packages/waku/src/router/create-pages.tsx | 101 ++++++++++-------- packages/waku/src/router/define-router.tsx | 59 +++++----- packages/waku/tests/create-pages.test.ts | 17 +++ packages/waku/tests/inferred-paths.test.ts | 17 ++- packages/waku/tests/path.test.ts | 2 + packages/waku/tests/router-client.test.tsx | 9 +- packages/waku/tests/rscPath.test.ts | 23 +++- 12 files changed, 252 insertions(+), 113 deletions(-) diff --git a/e2e/fixtures/use-router/src/TestRouter.tsx b/e2e/fixtures/use-router/src/TestRouter.tsx index f5516e5d3b..11886144b7 100644 --- a/e2e/fixtures/use-router/src/TestRouter.tsx +++ b/e2e/fixtures/use-router/src/TestRouter.tsx @@ -75,6 +75,19 @@ export default function TestRouter() { router.push prefetched static target

+

+ +

+

+ + Go to static trailing + +

); } diff --git a/e2e/use-router.spec.ts b/e2e/use-router.spec.ts index 6426207bd7..f2b3a37645 100644 --- a/e2e/use-router.spec.ts +++ b/e2e/use-router.spec.ts @@ -29,6 +29,20 @@ test.describe('useRouter', () => { await expect(page.getByRole('heading', { name: 'Static' })).toBeVisible(); await expect(page.getByTestId('path')).toHaveText('Path: /static'); }); + + test(`on dynamic pages with trailing slash`, async ({ page }) => { + await page.goto(`http://localhost:${port}/dynamic/`); + await expect( + page.getByRole('heading', { name: 'Dynamic' }), + ).toBeVisible(); + await expect(page.getByTestId('path')).toHaveText('Path: /dynamic'); + }); + + test(`on static pages with trailing slash`, async ({ page }) => { + await page.goto(`http://localhost:${port}/static/`); + await expect(page.getByRole('heading', { name: 'Static' })).toBeVisible(); + await expect(page.getByTestId('path')).toHaveText('Path: /static'); + }); }); test.describe('updates path on link navigation', () => { @@ -63,7 +77,9 @@ test.describe('useRouter', () => { }) => { await page.goto(`http://localhost:${port}/dynamic`); await waitForHydration(page); - await page.getByRole('link', { name: 'Go to static' }).click(); + await page + .getByRole('link', { name: 'Go to static', exact: true }) + .click(); await expect(page.getByRole('heading', { name: 'Static' })).toBeVisible(); const beforeReplaceHistoryLength = await page.evaluate( () => window.history.length, @@ -97,7 +113,9 @@ test.describe('useRouter', () => { await page.click('text=Increment query'); await expect(page.getByTestId('query')).toHaveText('Query: 1'); - await page.getByRole('link', { name: 'Go to static' }).click(); + await page + .getByRole('link', { name: 'Go to static', exact: true }) + .click(); await expect(page.getByRole('heading', { name: 'Static' })).toBeVisible(); await expect(page.getByTestId('query')).toHaveText('Query: 0'); @@ -174,6 +192,26 @@ test.describe('useRouter', () => { await expect(page.getByRole('heading', { name: 'Bar' })).toBeVisible(); expect(messages.some((msg) => msg.includes('Uncaught'))).toBe(false); }); + + test('router.push preserves trailing-slash URL while keeping canonical path', async ({ + page, + }) => { + await page.goto(`http://localhost:${port}/dynamic`); + await waitForHydration(page); + await page.getByTestId('router-push-static-trailing').click(); + await expect(page.getByRole('heading', { name: 'Static' })).toBeVisible(); + await expect(page).toHaveURL(`http://localhost:${port}/static/`); + await expect(page.getByTestId('path')).toHaveText('Path: /static'); + }); + + test('Link supports trailing-slash targets', async ({ page }) => { + await page.goto(`http://localhost:${port}/dynamic`); + await waitForHydration(page); + await page.getByTestId('link-static-trailing').click(); + await expect(page.getByRole('heading', { name: 'Static' })).toBeVisible(); + await expect(page).toHaveURL(`http://localhost:${port}/static/`); + await expect(page.getByTestId('path')).toHaveText('Path: /static'); + }); }); test.describe('retrieves query variables', () => { diff --git a/examples/22_define-router/src/waku.server.tsx b/examples/22_define-router/src/waku.server.tsx index 59743dbe0f..5402c67ac7 100644 --- a/examples/22_define-router/src/waku.server.tsx +++ b/examples/22_define-router/src/waku.server.tsx @@ -133,7 +133,7 @@ export default adapter( // using `[slug]` syntax is just an example and it technically conflicts with others. So, it's better to use a different prefix like `dynamic-page:`. 'page:/dynamic/[slug]': { isStatic: false, - renderer: ({ pathname }) =>

{pathname}

, + renderer: ({ routePath }) =>

{routePath}

, }, }, }, diff --git a/packages/waku/src/router/client.tsx b/packages/waku/src/router/client.tsx index cb2e5f5749..987a7a3e3a 100644 --- a/packages/waku/src/router/client.tsx +++ b/packages/waku/src/router/client.tsx @@ -41,14 +41,19 @@ import { SKIP_HEADER, encodeRoutePath, encodeSliceId, + pathnameToRoutePath, } from './common.js'; import type { RouteProps } from './common.js'; +type AllowTrailingSlash = Path extends '/' + ? Path + : Path | `${Path}/`; + type AllowPathDecorators = Path extends unknown ? - | Path - | `${Path}?${string}` - | `${Path}#${string}` + | AllowTrailingSlash + | `${AllowTrailingSlash}?${string}` + | `${AllowTrailingSlash}#${string}` | `?${string}` | `#${string}` : never; @@ -59,20 +64,15 @@ type InferredPaths = RouteConfig extends { ? AllowPathDecorators : string; -const normalizeRoutePath = (path: string) => { - path = removeBase(path, import.meta.env.WAKU_CONFIG_BASE_PATH); - for (const suffix of ['/', '/index.html']) { - if (path.endsWith(suffix)) { - return path.slice(0, -suffix.length) || '/'; - } - } - return path; -}; +const pathnameToCurrentRoutePath = (pathname: string) => + pathnameToRoutePath( + removeBase(pathname, import.meta.env.WAKU_CONFIG_BASE_PATH), + ); const parseRoute = (url: URL): RouteProps => { const { pathname, searchParams, hash } = url; return { - path: normalizeRoutePath(pathname), + path: pathnameToCurrentRoutePath(pathname), query: searchParams.toString(), hash, }; @@ -107,7 +107,8 @@ const parseRouteFromLocation = (): RouteProps => { }; const shouldScrollByDefault = (url: URL) => - url.pathname !== window.location.pathname || + pathnameToCurrentRoutePath(url.pathname) !== + pathnameToCurrentRoutePath(window.location.pathname) || url.hash !== window.location.hash; const isPathChange = (next: RouteProps, prev: RouteProps) => @@ -227,13 +228,15 @@ export function useRouter() { ) => { to = addBase(to, import.meta.env.WAKU_CONFIG_BASE_PATH); const url = new URL(to, window.location.href); - await changeRoute(parseRoute(url), { + const nextRoute = parseRoute(url); + await changeRoute(nextRoute, { + skipRefetch: isSameRoute(nextRoute, route), shouldScroll: options?.scroll ?? shouldScrollByDefault(url), mode: 'push', url, }); }, - [changeRoute], + [changeRoute, route], ); const replace = useCallback( async ( @@ -250,13 +253,15 @@ export function useRouter() { ) => { to = addBase(to, import.meta.env.WAKU_CONFIG_BASE_PATH); const url = new URL(to, window.location.href); - await changeRoute(parseRoute(url), { + const nextRoute = parseRoute(url); + await changeRoute(nextRoute, { + skipRefetch: isSameRoute(nextRoute, route), shouldScroll: options?.scroll ?? shouldScrollByDefault(url), mode: 'replace', url, }); }, - [changeRoute], + [changeRoute, route], ); const reload = useCallback(async () => { const url = new URL(window.location.href); @@ -403,8 +408,10 @@ export function Link({ if (url.href !== window.location.href) { const route = parseRoute(url); prefetchRoute(route); + const skipRefetch = router ? isSameRoute(route, router.route) : false; startTransitionFn(async () => { await changeRoute(route, { + skipRefetch, shouldScroll: scroll ?? shouldScrollByDefault(url), mode: 'push', url, diff --git a/packages/waku/src/router/common.ts b/packages/waku/src/router/common.ts index 25b1c5d260..e856f91428 100644 --- a/packages/waku/src/router/common.ts +++ b/packages/waku/src/router/common.ts @@ -7,8 +7,24 @@ export type RouteProps = { hash: string; }; -export function getComponentIds(path: string): readonly string[] { - const pathItems = path.split('/').filter(Boolean); +export function pathnameToRoutePath(pathname: string): string { + if (!pathname.startsWith('/')) { + throw new Error('Pathname must start with `/`: ' + pathname); + } + if (pathname.length > 1 && pathname.endsWith('/')) { + pathname = pathname.slice(0, -1); + } + if (pathname.endsWith('/index.html')) { + pathname = pathname.slice(0, -'/index.html'.length) || '/'; + } + if (pathname.length > 1 && pathname.endsWith('/')) { + pathname = pathname.slice(0, -1); + } + return pathname || '/'; +} + +export function getComponentIds(routePath: string): readonly string[] { + const pathItems = routePath.split('/').filter(Boolean); const idSet = new Set(); for (let index = 0; index <= pathItems.length; ++index) { const id = [...pathItems.slice(0, index), 'layout'].join('/'); @@ -21,20 +37,15 @@ export function getComponentIds(path: string): readonly string[] { const ROUTE_PREFIX = 'R'; const SLICE_PREFIX = 'S/'; -export function encodeRoutePath(path: string): string { - if (!path.startsWith('/')) { - throw new Error('Path must start with `/`: ' + path); - } - if (path.length > 1 && path.endsWith('/')) { - throw new Error('Path must not end with `/`: ' + path); - } - if (path === '/') { +export function encodeRoutePath(routePath: string): string { + routePath = pathnameToRoutePath(routePath); + if (routePath === '/') { return ROUTE_PREFIX + '/_root'; } - if (path.startsWith('/_')) { - return ROUTE_PREFIX + '/__' + path.slice(2); + if (routePath.startsWith('/_')) { + return ROUTE_PREFIX + '/__' + routePath.slice(2); } - return ROUTE_PREFIX + path; + return ROUTE_PREFIX + routePath; } export function decodeRoutePath(rscPath: string): string { diff --git a/packages/waku/src/router/create-pages.tsx b/packages/waku/src/router/create-pages.tsx index b26607f3ed..be797807d8 100644 --- a/packages/waku/src/router/create-pages.tsx +++ b/packages/waku/src/router/create-pages.tsx @@ -11,6 +11,7 @@ import { import type { PathSpec } from '../lib/utils/path.js'; import { Children, Slot } from '../minimal/client.js'; import { ErrorBoundary } from '../router/client.js'; +import { pathnameToRoutePath } from './common.js'; import type { AnyPage, GetSlugs, @@ -429,39 +430,41 @@ export const createPages = < if (configured) { throw new Error('createPage no longer available'); } - if (pagePathExists(page.path)) { + const pageRoutePath = pathnameToRoutePath(page.path); + if (pagePathExists(pageRoutePath)) { throw new Error(`Duplicated path: ${page.path}`); } - const pathSpec = parsePathWithSlug(page.path); + const pathSpec = parsePathWithSlug(pageRoutePath); const { numSlugs, numWildcards } = getSlugsAndWildcards(pathSpec); if (page.unstable_disableSSR) { noSsrSet.add(pathSpec); } if (page.exactPath) { - const spec = parseExactPath(page.path); + const routePath = pageRoutePath; + const spec = parseExactPath(routePath); if (page.render === 'static') { - staticPathMap.set(page.path, { + staticPathMap.set(routePath, { literalSpec: spec, }); - const id = joinPath(page.path, 'page').replace(/^\//, ''); + const id = joinPath(routePath, 'page').replace(/^\//, ''); if (page.component) { registerStaticComponent(id, page.component); } } else if (page.component) { - dynamicPagePathMap.set(page.path, [spec, page.component]); + dynamicPagePathMap.set(routePath, [spec, page.component]); } else { - dynamicPagePathMap.set(page.path, [spec, []]); + dynamicPagePathMap.set(routePath, [spec, []]); } } else if (page.render === 'static' && numSlugs === 0) { - const pagePath = getGrouplessPath(page.path); - staticPathMap.set(pagePath, { + const routePath = pathnameToRoutePath(getGrouplessPath(page.path)); + staticPathMap.set(routePath, { literalSpec: pathSpec, }); - const id = joinPath(pagePath, 'page').replace(/^\//, ''); - if (pagePath !== page.path) { - groupPathLookup.set(pagePath, page.path); + const id = joinPath(routePath, 'page').replace(/^\//, ''); + if (routePath !== pageRoutePath) { + groupPathLookup.set(routePath, pageRoutePath); } if (page.component) { registerStaticComponent(id, page.component); @@ -482,36 +485,37 @@ export const createPages = < pathSpec, staticPath, ); - const pagePath = getGrouplessPath(definedPath); - staticPathMap.set(pagePath, { + const routePath = pathnameToRoutePath(getGrouplessPath(definedPath)); + staticPathMap.set(routePath, { literalSpec: pathItems.map((name) => ({ type: 'literal', name })), originalSpec: pathSpec, }); - if (pagePath !== definedPath) { - groupPathLookup.set(pagePath, definedPath); + const definedRoutePath = pathnameToRoutePath(definedPath); + if (routePath !== definedRoutePath) { + groupPathLookup.set(routePath, definedRoutePath); } - const id = joinPath(pagePath, 'page').replace(/^\//, ''); + const id = joinPath(routePath, 'page').replace(/^\//, ''); const WrappedComponent = (props: Record) => createElement(page.component as any, { ...props, ...mapping }); registerStaticComponent(id, WrappedComponent); } } else if (page.render === 'dynamic' && numWildcards === 0) { - const pagePath = getGrouplessPath(page.path); - if (pagePath !== page.path) { - groupPathLookup.set(pagePath, page.path); + const routePath = pathnameToRoutePath(getGrouplessPath(page.path)); + if (routePath !== pageRoutePath) { + groupPathLookup.set(routePath, pageRoutePath); } - dynamicPagePathMap.set(pagePath, [pathSpec, page.component]); + dynamicPagePathMap.set(routePath, [pathSpec, page.component]); } else if (page.render === 'dynamic' && numWildcards === 1) { - const pagePath = getGrouplessPath(page.path); - if (pagePath !== page.path) { - groupPathLookup.set(pagePath, page.path); + const routePath = pathnameToRoutePath(getGrouplessPath(page.path)); + if (routePath !== pageRoutePath) { + groupPathLookup.set(routePath, pageRoutePath); } - wildcardPagePathMap.set(pagePath, [pathSpec, page.component]); + wildcardPagePathMap.set(routePath, [pathSpec, page.component]); } else { throw new Error('Invalid page configuration ' + JSON.stringify(page)); } if (page.slices?.length) { - slicePathMap.set(page.path, page.slices); + slicePathMap.set(pageRoutePath, page.slices); } return page as Exclude; }; @@ -520,15 +524,16 @@ export const createPages = < if (configured) { throw new Error('createLayout no longer available'); } + const routePath = pathnameToRoutePath(layout.path); if (layout.render === 'static') { - const id = joinPath(layout.path, 'layout').replace(/^\//, ''); + const id = joinPath(routePath, 'layout').replace(/^\//, ''); registerStaticComponent(id, layout.component); } else if (layout.render === 'dynamic') { - if (dynamicLayoutPathMap.has(layout.path)) { + if (dynamicLayoutPathMap.has(routePath)) { throw new Error(`Duplicated dynamic path: ${layout.path}`); } - const pathSpec = parsePathWithSlug(layout.path); - dynamicLayoutPathMap.set(layout.path, [pathSpec, layout.component]); + const pathSpec = parsePathWithSlug(routePath); + dynamicLayoutPathMap.set(routePath, [pathSpec, layout.component]); } else { throw new Error('Invalid layout configuration'); } @@ -538,10 +543,11 @@ export const createPages = < if (configured) { throw new Error('createApi no longer available'); } - if (apiPathMap.has(options.path)) { + const routePath = pathnameToRoutePath(options.path); + if (apiPathMap.has(routePath)) { throw new Error(`Duplicated api path: ${options.path}`); } - const pathSpec = parsePathWithSlug(options.path); + const pathSpec = parsePathWithSlug(routePath); if (options.render === 'static') { const { numSlugs, numWildcards } = getSlugsAndWildcards(pathSpec); if (numSlugs > 0 && options.staticPaths) { @@ -556,24 +562,25 @@ export const createPages = < pathSpec, staticPath, ); - if (apiPathMap.has(definedPath)) { + const definedRoutePath = pathnameToRoutePath(definedPath); + if (apiPathMap.has(definedRoutePath)) { throw new Error(`Duplicated api path: ${definedPath}`); } - apiPathMap.set(definedPath, { + apiPathMap.set(definedRoutePath, { render: 'static', pathSpec: pathItems.map((name) => ({ type: 'literal', name })), handlers: { GET: options.handler }, }); } } else { - apiPathMap.set(options.path, { + apiPathMap.set(routePath, { render: 'static', pathSpec, handlers: { GET: options.handler }, }); } } else { - apiPathMap.set(options.path, { + apiPathMap.set(routePath, { render: 'dynamic', pathSpec, handlers: options.handlers, @@ -646,7 +653,7 @@ export const createPages = < type ElementSpec = { isStatic: boolean; renderer: (options: { - pathname: string; + routePath: string; query: string | undefined; }) => ReactNode; }; @@ -691,9 +698,9 @@ export const createPages = < createElement( pageComponent, { - ...getPropsMapping(option.pathname), + ...getPropsMapping(option.routePath), ...(option.query ? { query: option.query } : {}), - path: option.pathname, + path: option.routePath, }, , ), @@ -745,9 +752,9 @@ export const createPages = < isStatic: comp.render === 'static', renderer: (option) => createElement(comp.component, { - ...getPropsMapping(option.pathname), + ...getPropsMapping(option.routePath), ...(option.query ? { query: option.query } : {}), - path: option.pathname, + path: option.routePath, }), }; } @@ -759,9 +766,9 @@ export const createPages = < createElement( components, { - ...getPropsMapping(option.pathname), + ...getPropsMapping(option.routePath), ...(option.query ? { query: option.query } : {}), - path: option.pathname, + path: option.routePath, }, , ), @@ -813,9 +820,9 @@ export const createPages = < isStatic: comp.render === 'static', renderer: (option) => createElement(comp.component, { - ...getPropsMapping(option.pathname), + ...getPropsMapping(option.routePath), ...(option.query ? { query: option.query } : {}), - path: option.pathname, + path: option.routePath, }), }; } @@ -827,9 +834,9 @@ export const createPages = < createElement( components, { - ...getPropsMapping(option.pathname), + ...getPropsMapping(option.routePath), ...(option.query ? { query: option.query } : {}), - path: option.pathname, + path: option.routePath, }, , ), diff --git a/packages/waku/src/router/define-router.tsx b/packages/waku/src/router/define-router.tsx index 080d6cd19a..8ebd0f63e5 100644 --- a/packages/waku/src/router/define-router.tsx +++ b/packages/waku/src/router/define-router.tsx @@ -16,6 +16,7 @@ import { decodeSliceId, encodeRoutePath, encodeSliceId, + pathnameToRoutePath, } from './common.js'; export type ApiHandler = ( @@ -124,18 +125,19 @@ const is404 = (pathSpec: PathSpec) => pathSpec[0]!.type === 'literal' && pathSpec[0]!.name === '404'; -const pathSpec2pathname = (pathSpec: PathSpec) => { +const pathSpecToRoutePath = (pathSpec: PathSpec) => { if (pathSpec.some(({ type }) => type !== 'literal')) { return undefined; } return '/' + pathSpec.map(({ name }) => name!).join('/'); }; -const htmlPath2pathname = (htmlPath: string): string => - htmlPath === '/404' ? '404.html' : htmlPath + '/index.html'; +const routePathToHtmlFilePath = (routePath: string): string => + routePath === '/404' ? '404.html' : routePath + '/index.html'; export function unstable_rerenderRoute(pathname: string, query?: string) { - const rscPath = encodeRoutePath(pathname); + const routePath = pathnameToRoutePath(pathname); + const rscPath = encodeRoutePath(routePath); getRerender()(rscPath, query && new URLSearchParams({ query })); } @@ -166,7 +168,7 @@ const assertNonReservedSlotId = (slotId: SlotId) => { } }; -type RendererOption = { pathname: string; query: string | undefined }; +type RendererOption = { routePath: string; query: string | undefined }; type RouteConfig = { type: 'route'; @@ -256,11 +258,12 @@ export function unstable_defineRouter(fns: { }; const getPathConfigItem = async (pathname: string) => { + const routePath = pathnameToRoutePath(pathname); const myConfig = await getMyConfig(); const found = myConfig.configs.find( (item): item is typeof item & { type: 'route' | 'api' } => (item.type === 'route' || item.type === 'api') && - !!getPathMapping(item.path, pathname), + !!getPathMapping(item.path, routePath), ); return found; }; @@ -295,8 +298,8 @@ export function unstable_defineRouter(fns: { ) => { setRscPath(rscPath); setRscParams(rscParams); - const pathname = decodeRoutePath(rscPath); - const pathConfigItem = await getPathConfigItem(pathname); + const routePath = decodeRoutePath(rscPath); + const pathConfigItem = await getPathConfigItem(routePath); if (pathConfigItem?.type !== 'route') { return null; } @@ -308,9 +311,9 @@ export function unstable_defineRouter(fns: { } const skipIdSet = new Set(isStringArray(skipParam) ? skipParam : []); const { query } = parseRscParams(rscParams); - const routeId = ROUTE_SLOT_ID_PREFIX + pathname; + const routeId = ROUTE_SLOT_ID_PREFIX + routePath; const option: RendererOption = { - pathname, + routePath, query: pathConfigItem.isStatic ? undefined : query, }; const myConfig = await getMyConfig(); @@ -386,7 +389,7 @@ export function unstable_defineRouter(fns: { entries[id] = sliceElement; }), ]); - entries[ROUTE_ID] = [pathname, query]; + entries[ROUTE_ID] = [routePath, query]; entries[IS_STATIC_ID] = pathConfigItem.isStatic; sliceConfigMap.forEach((sliceConfig, sliceId) => { if (sliceConfig.isStatic) { @@ -563,7 +566,8 @@ export function unstable_defineRouter(fns: { query: string, httpstatus = 200, ) => { - const rscPath = encodeRoutePath(pathname); + const routePath = pathnameToRoutePath(pathname); + const rscPath = encodeRoutePath(routePath); const rscParams = new URLSearchParams({ query }); const entries = await getEntriesForRoute( rscPath, @@ -578,7 +582,7 @@ export function unstable_defineRouter(fns: { const path2moduleIds = await getPath2moduleIds(); const html = ( ); @@ -661,15 +665,15 @@ export function unstable_defineRouter(fns: { if (!item.isStatic) { continue; } - const pathname = pathSpec2pathname(item.path); - if (!pathname) { + const routePath = pathSpecToRoutePath(item.path); + if (!routePath) { continue; } - const req = new Request(new URL(pathname, 'http://localhost:3000')); + const req = new Request(new URL(routePath, 'http://localhost:3000')); runTask(async () => { await withRequest(req, async () => { const res = await item.handler(req, { params: {} }); - await generateFile(pathname, res.body || ''); + await generateFile(routePath, res.body || ''); }); }); } @@ -685,12 +689,12 @@ export function unstable_defineRouter(fns: { if (!item.isStatic) { continue; } - const pathname = pathSpec2pathname(item.path); - if (!pathname) { + const routePath = pathSpecToRoutePath(item.path); + if (!routePath) { continue; } - const rscPath = encodeRoutePath(pathname); - const req = new Request(new URL(pathname, 'http://localhost:3000')); + const rscPath = encodeRoutePath(routePath); + const req = new Request(new URL(routePath, 'http://localhost:3000')); runTask(async () => { await withRequest(req, async () => { const entries = await getEntriesForRoute( @@ -719,7 +723,7 @@ export function unstable_defineRouter(fns: { htmlRenderTasks.add(async () => { const html = ( ); @@ -728,7 +732,10 @@ export function unstable_defineRouter(fns: { unstable_extraScriptContent: getRouterPrefetchCode(path2moduleIds), }); - await generateFile(htmlPath2pathname(pathname), res.body || ''); + await generateFile( + routePathToHtmlFilePath(routePath), + res.body || '', + ); }); }); }); @@ -743,12 +750,12 @@ export function unstable_defineRouter(fns: { continue; } if (item.noSsr) { - const pathname = pathSpec2pathname(item.path); - if (!pathname) { + const routePath = pathSpecToRoutePath(item.path); + if (!routePath) { throw new Error('Pathname is required for noSsr routes on build'); } runTask(async () => { - await generateDefaultHtml(htmlPath2pathname(pathname)); + await generateDefaultHtml(routePathToHtmlFilePath(routePath)); }); } } diff --git a/packages/waku/tests/create-pages.test.ts b/packages/waku/tests/create-pages.test.ts index 392306e491..32b4668c51 100644 --- a/packages/waku/tests/create-pages.test.ts +++ b/packages/waku/tests/create-pages.test.ts @@ -1473,6 +1473,23 @@ describe('createPages pages and layouts', () => { await expect(getConfigs).rejects.toThrowError('Duplicated path: /test'); }); + it('fails if canonical and trailing-slash paths override each other', async () => { + createPages(async ({ createPage }) => [ + createPage({ + render: 'dynamic', + path: '/test', + component: () => null, + }), + createPage({ + render: 'dynamic', + path: '/test/' as never, + component: () => null, + }), + ]); + const { getConfigs } = injectedFunctions(); + await expect(getConfigs).rejects.toThrowError('Duplicated path: /test/'); + }); + it('creates a complex router', async () => { const TestPage = vi.fn(); complexTestRouter(createPages, TestPage); diff --git a/packages/waku/tests/inferred-paths.test.ts b/packages/waku/tests/inferred-paths.test.ts index 642152d628..fe0e898ecc 100644 --- a/packages/waku/tests/inferred-paths.test.ts +++ b/packages/waku/tests/inferred-paths.test.ts @@ -3,11 +3,15 @@ import type { TypeEqual } from 'ts-expect'; import { describe, it } from 'vitest'; // Reproduce the AllowPathDecorators type from router/client.tsx to test it directly +type AllowTrailingSlash = Path extends '/' + ? Path + : Path | `${Path}/`; + type AllowPathDecorators = Path extends unknown ? - | Path - | `${Path}?${string}` - | `${Path}#${string}` + | AllowTrailingSlash + | `${AllowTrailingSlash}?${string}` + | `${AllowTrailingSlash}#${string}` | `?${string}` | `#${string}` : never; @@ -17,6 +21,7 @@ describe('AllowPathDecorators', () => { type Result = AllowPathDecorators<'/' | '/foo'>; expectType>(true); expectType>(true); + expectType>(true); }); it('allows paths with query strings', () => { @@ -27,6 +32,9 @@ describe('AllowPathDecorators', () => { expectType>( true, ); + expectType>( + true, + ); }); it('allows paths with hash fragments', () => { @@ -37,6 +45,9 @@ describe('AllowPathDecorators', () => { expectType>( true, ); + expectType>( + true, + ); }); it('allows bare query strings without a path prefix', () => { diff --git a/packages/waku/tests/path.test.ts b/packages/waku/tests/path.test.ts index 1779739dd8..29e244ae4c 100644 --- a/packages/waku/tests/path.test.ts +++ b/packages/waku/tests/path.test.ts @@ -52,12 +52,14 @@ describe('getPathMapping', () => { test('handles literal paths', () => { const pathSpec = parsePathWithSlug('/foo/bar'); expect(getPathMapping(pathSpec, '/foo/bar')).toEqual({}); + expect(getPathMapping(pathSpec, '/foo/bar/')).toEqual({}); expect(getPathMapping(pathSpec, '/foo/baz')).toBe(null); }); test('handles paths with groups', () => { const pathSpec = parsePathWithSlug('/foo/[id]'); expect(getPathMapping(pathSpec, '/foo/123')).toEqual({ id: '123' }); + expect(getPathMapping(pathSpec, '/foo/123/')).toEqual({ id: '123' }); expect(getPathMapping(pathSpec, '/foo/bar')).toEqual({ id: 'bar' }); expect(getPathMapping(pathSpec, '/foo')).toBe(null); }); diff --git a/packages/waku/tests/router-client.test.tsx b/packages/waku/tests/router-client.test.tsx index 06e110d7d5..f859f9a4db 100644 --- a/packages/waku/tests/router-client.test.tsx +++ b/packages/waku/tests/router-client.test.tsx @@ -260,7 +260,7 @@ afterEach(() => { }); describe('router/client utilities', () => { - test('parses route path/query/hash and normalizes trailing suffixes', () => { + test('parses route path/query/hash and canonicalizes path from pathname', () => { const route = unstable_parseRoute( new URL('http://localhost/foo/index.html?count=2#hash'), ); @@ -276,6 +276,13 @@ describe('router/client utilities', () => { query: 'q=1', hash: '', }); + + const route3 = unstable_parseRoute(new URL('http://localhost/baz/?q=1')); + expect(route3).toEqual({ + path: '/baz', + query: 'q=1', + hash: '', + }); }); test('reads httpstatus meta content', () => { diff --git a/packages/waku/tests/rscPath.test.ts b/packages/waku/tests/rscPath.test.ts index 555d17cea3..c76499eb45 100644 --- a/packages/waku/tests/rscPath.test.ts +++ b/packages/waku/tests/rscPath.test.ts @@ -5,7 +5,11 @@ import { encodeFuncId, encodeRscPath, } from '../src/lib/utils/rsc-path.js'; -import { decodeRoutePath, encodeRoutePath } from '../src/router/common.js'; +import { + decodeRoutePath, + encodeRoutePath, + pathnameToRoutePath, +} from '../src/router/common.js'; describe('encodeRscPath', () => { test('encodes rscPath', () => { @@ -79,16 +83,31 @@ describe('decodeFuncId', () => { }); }); +describe('pathnameToRoutePath', () => { + test('canonicalizes trailing slash and index.html', () => { + expect(pathnameToRoutePath('/')).toBe('/'); + expect(pathnameToRoutePath('/foo')).toBe('/foo'); + expect(pathnameToRoutePath('/foo/')).toBe('/foo'); + expect(pathnameToRoutePath('/index.html')).toBe('/'); + expect(pathnameToRoutePath('/foo/index.html')).toBe('/foo'); + }); + + test('throws on invalid pathname', () => { + expect(() => pathnameToRoutePath('foo')).toThrow(); + }); +}); + describe('encodeRoutePath', () => { test('encodes routePath', () => { expect(encodeRoutePath('/')).toBe('R/_root'); expect(encodeRoutePath('/foo')).toBe('R/foo'); expect(encodeRoutePath('/foo/bar')).toBe('R/foo/bar'); + expect(encodeRoutePath('/foo/')).toBe('R/foo'); + expect(encodeRoutePath('/foo/index.html')).toBe('R/foo'); }); test('throws on invalid routePath', () => { expect(() => encodeRoutePath('foo')).toThrow(); - expect(() => encodeRoutePath('/foo/')).toThrow(); }); }); From 88041232c140011d907cfbb57659a32078c89c0e Mon Sep 17 00:00:00 2001 From: daishi Date: Fri, 6 Mar 2026 20:52:23 +0900 Subject: [PATCH 02/10] add tests and a fix --- e2e/base-path.spec.ts | 20 +++++++++++++++++-- e2e/fixtures/base-path/src/pages/_layout.tsx | 3 +++ .../src/components/route-state.tsx | 9 +++++++++ e2e/router-client.spec.ts | 20 +++++++++++++++++++ packages/waku/src/router/fs-router.ts | 2 +- 5 files changed, 51 insertions(+), 3 deletions(-) diff --git a/e2e/base-path.spec.ts b/e2e/base-path.spec.ts index 19feef8772..eb9ca844f9 100644 --- a/e2e/base-path.spec.ts +++ b/e2e/base-path.spec.ts @@ -52,16 +52,27 @@ test.describe(`base-path`, () => { await waitForHydration(page); // push - await page.getByText('dynamic-push').click(); + await page + .getByRole('button', { name: 'dynamic-push', exact: true }) + .click(); await page.waitForURL(`${baseUrl}dynamic`); await expect( page.getByRole('heading', { name: 'Dynamic page' }), ).toBeVisible(); + // push trailing slash + await page.goto(baseUrl); + await waitForHydration(page); + await page.getByRole('button', { name: 'dynamic-push-trailing' }).click(); + await page.waitForURL(`${baseUrl}dynamic/`); + await expect( + page.getByRole('heading', { name: 'Dynamic page' }), + ).toBeVisible(); + // replace await page.goto(baseUrl); await waitForHydration(page); - await page.getByText('dynamic-replace').click(); + await page.getByRole('button', { name: 'dynamic-replace' }).click(); await page.waitForURL(`${baseUrl}dynamic`); await expect( page.getByRole('heading', { name: 'Dynamic page' }), @@ -115,4 +126,9 @@ async function basicTest(page: Page, baseUrl: string) { await expect( page.getByRole('heading', { name: 'Static page' }), ).toBeVisible(); + + await page.goto(`${baseUrl}static/`); + await expect( + page.getByRole('heading', { name: 'Static page' }), + ).toBeVisible(); } diff --git a/e2e/fixtures/base-path/src/pages/_layout.tsx b/e2e/fixtures/base-path/src/pages/_layout.tsx index 8f646cc1b0..e98e631ce0 100644 --- a/e2e/fixtures/base-path/src/pages/_layout.tsx +++ b/e2e/fixtures/base-path/src/pages/_layout.tsx @@ -24,6 +24,9 @@ export default async function RootLayout({
  • dynamic-push
    • +
  • + dynamic-push-trailing +
  • dynamic-replace diff --git a/e2e/fixtures/router-client/src/components/route-state.tsx b/e2e/fixtures/router-client/src/components/route-state.tsx index e213d42253..bbcfae9d06 100644 --- a/e2e/fixtures/router-client/src/components/route-state.tsx +++ b/e2e/fixtures/router-client/src/components/route-state.tsx @@ -36,6 +36,15 @@ export function RouteState() { router.push hash missing

    +

    + +

    + <> + + + ); } diff --git a/e2e/fs-router.spec.ts b/e2e/fs-router.spec.ts index 015bf0dfba..5fb4b1d1d1 100644 --- a/e2e/fs-router.spec.ts +++ b/e2e/fs-router.spec.ts @@ -41,6 +41,11 @@ test.describe('fs-router', () => { await expect(page.getByRole('heading', { name: 'Foo' })).toBeVisible(); }); + test('foo with trailing slash', async ({ page }) => { + await page.goto(`http://localhost:${port}/foo/`); + await expect(page.getByRole('heading', { name: 'Foo' })).toBeVisible(); + }); + test('nested/foo', async ({ page }) => { // /nested/foo is defined as a staticPath of /nested/[id] which matches this layout await page.goto(`http://localhost:${port}/nested/foo`); @@ -56,6 +61,20 @@ test.describe('fs-router', () => { ).toBeVisible(); }); + test('nested/baz with trailing slash', async ({ page }) => { + await page.goto(`http://localhost:${port}/nested/baz/`); + await expect( + page.getByRole('heading', { name: 'Nested Layout' }), + ).toBeVisible(); + }); + + test('static-nested encoded path with trailing slash', async ({ page }) => { + await page.goto(`http://localhost:${port}/static-nested/encoded%20path/`); + await expect( + page.getByRole('heading', { name: 'Nested / encoded%20path' }), + ).toBeVisible(); + }); + test('check hydration error', async ({ page }) => { const messages: string[] = []; page.on('console', (msg) => messages.push(msg.text())); diff --git a/e2e/router-client-no-404.spec.ts b/e2e/router-client-no-404.spec.ts index 7e4faaf603..a8d5e99ac8 100644 --- a/e2e/router-client-no-404.spec.ts +++ b/e2e/router-client-no-404.spec.ts @@ -33,4 +33,21 @@ test.describe('router-client-no-404', () => { ); await expect(page).toHaveURL(/\/missing$/); }); + + test('client navigation to missing trailing-slash route renders Not Found fallback without /404 page', async ({ + page, + }) => { + await page.goto(`http://localhost:${port}/start`); + await waitForHydration(page); + + await page.getByTestId('go-missing-trailing').click(); + + await expect( + page.getByRole('heading', { name: 'Not Found' }), + ).toBeVisible(); + await expect(page.getByRole('heading', { name: 'Custom 404' })).toHaveCount( + 0, + ); + await expect(page).toHaveURL(/\/missing\/$/); + }); }); From 9dd7ba97adba63a8f2b664460f9a4fcb797f1262 Mon Sep 17 00:00:00 2001 From: daishi Date: Fri, 6 Mar 2026 21:07:15 +0900 Subject: [PATCH 04/10] add api tests --- e2e/base-path.spec.ts | 27 +++++++++++++++++++++++++++ e2e/fs-router.spec.ts | 15 +++++++++++++++ 2 files changed, 42 insertions(+) diff --git a/e2e/base-path.spec.ts b/e2e/base-path.spec.ts index eb9ca844f9..6a1e6fc0e9 100644 --- a/e2e/base-path.spec.ts +++ b/e2e/base-path.spec.ts @@ -44,6 +44,33 @@ test.describe(`base-path`, () => { text: 'hello', }, }); + + // get trailing slash + const resGetTrailing = await request.get(`${baseUrl}hello/`); + expect(resGetTrailing.ok()).toBe(true); + expect(await resGetTrailing.json()).toEqual({ + ok: true, + request: { + handler: 'GET', + method: 'GET', + pathname: '/hello/', + }, + }); + + // post trailing slash + const resPostTrailing = await request.post(`${baseUrl}hello/`, { + data: 'hello', + }); + expect(resPostTrailing.ok()).toBe(true); + expect(await resPostTrailing.json()).toEqual({ + ok: true, + request: { + handler: 'POST', + method: 'POST', + pathname: '/hello/', + text: 'hello', + }, + }); }); test('router', async ({ page }) => { diff --git a/e2e/fs-router.spec.ts b/e2e/fs-router.spec.ts index 5fb4b1d1d1..eee1e0d1a7 100644 --- a/e2e/fs-router.spec.ts +++ b/e2e/fs-router.spec.ts @@ -104,6 +104,12 @@ test.describe('fs-router', () => { expect(await res.text()).toBe('Hello from API!'); }); + test('api hi with trailing slash', async () => { + const res = await fetch(`http://localhost:${port}/hi/`); + expect(res.status).toBe(200); + expect(await res.text()).toBe('Hello from API!'); + }); + test('api hi.txt', async () => { const res = await fetch(`http://localhost:${port}/hi.txt`); expect(res.status).toBe(200); @@ -125,6 +131,15 @@ test.describe('fs-router', () => { expect(await res.text()).toBe('POST Hello from API! from the test!'); }); + test('api hi with POST and trailing slash', async () => { + const res = await fetch(`http://localhost:${port}/hi/`, { + method: 'POST', + body: 'from the test!', + }); + expect(res.status).toBe(200); + expect(await res.text()).toBe('POST Hello from API! from the test!'); + }); + test('api has-default GET', async () => { const res = await fetch(`http://localhost:${port}/has-default`); expect(res.status).toBe(200); From 0c6512642ab5ce5107304d928c9c7ff966566144 Mon Sep 17 00:00:00 2001 From: daishi Date: Fri, 6 Mar 2026 21:21:06 +0900 Subject: [PATCH 05/10] refactor without [route] --- packages/waku/src/router/client.tsx | 31 ++++++++++++---------- packages/waku/tests/router-client.test.tsx | 2 +- 2 files changed, 18 insertions(+), 15 deletions(-) diff --git a/packages/waku/src/router/client.tsx b/packages/waku/src/router/client.tsx index 987a7a3e3a..ac7e8e641a 100644 --- a/packages/waku/src/router/client.tsx +++ b/packages/waku/src/router/client.tsx @@ -230,13 +230,12 @@ export function useRouter() { const url = new URL(to, window.location.href); const nextRoute = parseRoute(url); await changeRoute(nextRoute, { - skipRefetch: isSameRoute(nextRoute, route), shouldScroll: options?.scroll ?? shouldScrollByDefault(url), mode: 'push', url, }); }, - [changeRoute, route], + [changeRoute], ); const replace = useCallback( async ( @@ -255,17 +254,19 @@ export function useRouter() { const url = new URL(to, window.location.href); const nextRoute = parseRoute(url); await changeRoute(nextRoute, { - skipRefetch: isSameRoute(nextRoute, route), shouldScroll: options?.scroll ?? shouldScrollByDefault(url), mode: 'replace', url, }); }, - [changeRoute, route], + [changeRoute], ); const reload = useCallback(async () => { const url = new URL(window.location.href); - await changeRoute(parseRoute(url), { shouldScroll: true }); + await changeRoute(parseRoute(url), { + shouldScroll: true, + skipRefetch: false, + }); }, [changeRoute]); const back = useCallback(() => { // FIXME is this correct? @@ -408,10 +409,8 @@ export function Link({ if (url.href !== window.location.href) { const route = parseRoute(url); prefetchRoute(route); - const skipRefetch = router ? isSameRoute(route, router.route) : false; startTransitionFn(async () => { await changeRoute(route, { - skipRefetch, shouldScroll: scroll ?? shouldScrollByDefault(url), mode: 'push', url, @@ -819,14 +818,17 @@ const InnerRouter = ({ routeChangeListenersRef.current = createRouteChangeListeners(); } // Update the route post-load to include the current hash. + const routeRef = useRef(route); useEffect(() => { - setRoute((prev) => (isSameRoute(prev, initialRoute) ? prev : initialRoute)); + setRoute((prev) => { + if (isSameRoute(prev, initialRoute)) { + return prev; + } + routeRef.current = initialRoute; + return initialRoute; + }); }, [initialRoute]); const [err, setErr] = useState(null); - const routeRef = useRef(route); - useEffect(() => { - routeRef.current = route; - }, [route]); const [routeChangeEvents, emitRouteChangeEvent] = routeChangeListenersRef.current; @@ -840,7 +842,6 @@ const InnerRouter = ({ emitRouteChangeEvent('start', nextRoute); const startTransitionFn = options.unstable_startTransition || ((fn: TransitionFunction) => fn()); - const { skipRefetch } = options; const historyPathnameBeforeChange = window.location.pathname; const writeHistoryIfNeeded = ( mode: undefined | 'push' | 'replace', @@ -861,6 +862,8 @@ const InnerRouter = ({ let { mode, url } = options; const requestedUrlToWrite = mode && (url || getRouteUrl(nextRoute)); const routeBeforeChange = routeRef.current; + const skipRefetch = + options.skipRefetch ?? isSameRoute(nextRoute, routeBeforeChange); const pathChanged = isPathChange(nextRoute, routeBeforeChange); setErr(null); if (!staticPathSetRef.current.has(nextRoute.path) && !skipRefetch) { @@ -927,6 +930,7 @@ const InnerRouter = ({ return; } writeHistoryIfNeeded(mode, urlToWrite); + routeRef.current = nextRoute; setRoute(nextRoute); routeChangeAbortRef.current = null; if (options.shouldScroll) { @@ -1010,7 +1014,6 @@ const InnerRouter = ({ } changeRoute(nextRoute, { shouldScroll: shouldScrollForRouteChange(nextRoute, routeRef.current), - skipRefetch: isSameRoute(nextRoute, routeRef.current), }).catch((err) => { console.log('Error while navigating back:', err); }); diff --git a/packages/waku/tests/router-client.test.tsx b/packages/waku/tests/router-client.test.tsx index f859f9a4db..bf563d0e56 100644 --- a/packages/waku/tests/router-client.test.tsx +++ b/packages/waku/tests/router-client.test.tsx @@ -412,7 +412,7 @@ describe('useRouter + Link with context', () => { expect(changeRoute).toHaveBeenNthCalledWith( 3, { path: '/start', query: '', hash: '' }, - { shouldScroll: true }, + { shouldScroll: true, skipRefetch: false }, ); const firstUrl = ( (changeRoute.mock.calls[0] as unknown[] | undefined)?.[1] as From 7be845afdf24b0fbdeea226df97a5192a293f10b Mon Sep 17 00:00:00 2001 From: daishi Date: Fri, 6 Mar 2026 21:36:51 +0900 Subject: [PATCH 06/10] refactor: invert skipRefetch option --- packages/waku/src/router/client.tsx | 15 ++++++--------- packages/waku/tests/router-client.test.tsx | 2 +- 2 files changed, 7 insertions(+), 10 deletions(-) diff --git a/packages/waku/src/router/client.tsx b/packages/waku/src/router/client.tsx index ac7e8e641a..071687808c 100644 --- a/packages/waku/src/router/client.tsx +++ b/packages/waku/src/router/client.tsx @@ -142,7 +142,7 @@ const createRscParams = (query: string): URLSearchParams => { type ChangeRouteOptions = { shouldScroll: boolean; - skipRefetch?: boolean; + refetch?: boolean; // true: force refetch, false: don't refetch, undefined: auto-decide based on route change mode?: undefined | 'push' | 'replace'; url?: URL | undefined; unstable_startTransition?: ((fn: TransitionFunction) => void) | undefined; @@ -263,10 +263,7 @@ export function useRouter() { ); const reload = useCallback(async () => { const url = new URL(window.location.href); - await changeRoute(parseRoute(url), { - shouldScroll: true, - skipRefetch: false, - }); + await changeRoute(parseRoute(url), { shouldScroll: true, refetch: true }); }, [changeRoute]); const back = useCallback(() => { // FIXME is this correct? @@ -862,11 +859,11 @@ const InnerRouter = ({ let { mode, url } = options; const requestedUrlToWrite = mode && (url || getRouteUrl(nextRoute)); const routeBeforeChange = routeRef.current; - const skipRefetch = - options.skipRefetch ?? isSameRoute(nextRoute, routeBeforeChange); + const shouldRefetch = + options.refetch ?? !isSameRoute(nextRoute, routeBeforeChange); const pathChanged = isPathChange(nextRoute, routeBeforeChange); setErr(null); - if (!staticPathSetRef.current.has(nextRoute.path) && !skipRefetch) { + if (!staticPathSetRef.current.has(nextRoute.path) && shouldRefetch) { const rscPath = encodeRoutePath(nextRoute.path); const rscParams = createRscParams(nextRoute.query); const skipHeaderEnhancer = @@ -959,7 +956,7 @@ const InnerRouter = ({ url.search = query; url.hash = ''; await changeRoute(parseRoute(url), { - skipRefetch: true, + refetch: false, shouldScroll: false, mode: path === '/404' ? undefined : 'push', url, diff --git a/packages/waku/tests/router-client.test.tsx b/packages/waku/tests/router-client.test.tsx index bf563d0e56..748be839db 100644 --- a/packages/waku/tests/router-client.test.tsx +++ b/packages/waku/tests/router-client.test.tsx @@ -412,7 +412,7 @@ describe('useRouter + Link with context', () => { expect(changeRoute).toHaveBeenNthCalledWith( 3, { path: '/start', query: '', hash: '' }, - { shouldScroll: true, skipRefetch: false }, + { shouldScroll: true, refetch: true }, ); const firstUrl = ( (changeRoute.mock.calls[0] as unknown[] | undefined)?.[1] as From 1e9dfa87e1c3d0ee6fdb7387184fd089f3f1e1fa Mon Sep 17 00:00:00 2001 From: daishi Date: Fri, 6 Mar 2026 22:18:28 +0900 Subject: [PATCH 07/10] refactor --- packages/waku/src/router/client.tsx | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/packages/waku/src/router/client.tsx b/packages/waku/src/router/client.tsx index 071687808c..f5574ffa2f 100644 --- a/packages/waku/src/router/client.tsx +++ b/packages/waku/src/router/client.tsx @@ -228,8 +228,7 @@ export function useRouter() { ) => { to = addBase(to, import.meta.env.WAKU_CONFIG_BASE_PATH); const url = new URL(to, window.location.href); - const nextRoute = parseRoute(url); - await changeRoute(nextRoute, { + await changeRoute(parseRoute(url), { shouldScroll: options?.scroll ?? shouldScrollByDefault(url), mode: 'push', url, @@ -252,8 +251,7 @@ export function useRouter() { ) => { to = addBase(to, import.meta.env.WAKU_CONFIG_BASE_PATH); const url = new URL(to, window.location.href); - const nextRoute = parseRoute(url); - await changeRoute(nextRoute, { + await changeRoute(parseRoute(url), { shouldScroll: options?.scroll ?? shouldScrollByDefault(url), mode: 'replace', url, @@ -817,11 +815,11 @@ const InnerRouter = ({ // Update the route post-load to include the current hash. const routeRef = useRef(route); useEffect(() => { + routeRef.current = initialRoute; setRoute((prev) => { if (isSameRoute(prev, initialRoute)) { return prev; } - routeRef.current = initialRoute; return initialRoute; }); }, [initialRoute]); From 296a78ea3694d63ba3eae35d5871fb80d693d868 Mon Sep 17 00:00:00 2001 From: daishi Date: Fri, 6 Mar 2026 22:34:10 +0900 Subject: [PATCH 08/10] refactor with new contract --- packages/waku/src/router/common.ts | 10 +++++++++- packages/waku/src/router/define-router.tsx | 3 ++- packages/waku/tests/rscPath.test.ts | 5 +++-- 3 files changed, 14 insertions(+), 4 deletions(-) diff --git a/packages/waku/src/router/common.ts b/packages/waku/src/router/common.ts index e856f91428..1c4fb9b594 100644 --- a/packages/waku/src/router/common.ts +++ b/packages/waku/src/router/common.ts @@ -38,7 +38,15 @@ const ROUTE_PREFIX = 'R'; const SLICE_PREFIX = 'S/'; export function encodeRoutePath(routePath: string): string { - routePath = pathnameToRoutePath(routePath); + if (!routePath.startsWith('/')) { + throw new Error('Route path must start with `/`: ' + routePath); + } + if (routePath.length > 1 && routePath.endsWith('/')) { + throw new Error('Route path must not end with `/`: ' + routePath); + } + if (routePath.endsWith('/index.html')) { + throw new Error('Route path must not end with `/index.html`: ' + routePath); + } if (routePath === '/') { return ROUTE_PREFIX + '/_root'; } diff --git a/packages/waku/src/router/define-router.tsx b/packages/waku/src/router/define-router.tsx index 8ebd0f63e5..57bd39d21f 100644 --- a/packages/waku/src/router/define-router.tsx +++ b/packages/waku/src/router/define-router.tsx @@ -541,7 +541,8 @@ export function unstable_defineRouter(fns: { } catch (e) { const info = getErrorInfo(e); if (info?.location) { - const rscPath = encodeRoutePath(info.location); + const routePath = pathnameToRoutePath(info.location); + const rscPath = encodeRoutePath(routePath); const entries = await getEntriesForRoute( rscPath, undefined, diff --git a/packages/waku/tests/rscPath.test.ts b/packages/waku/tests/rscPath.test.ts index c76499eb45..01b251979f 100644 --- a/packages/waku/tests/rscPath.test.ts +++ b/packages/waku/tests/rscPath.test.ts @@ -102,12 +102,13 @@ describe('encodeRoutePath', () => { expect(encodeRoutePath('/')).toBe('R/_root'); expect(encodeRoutePath('/foo')).toBe('R/foo'); expect(encodeRoutePath('/foo/bar')).toBe('R/foo/bar'); - expect(encodeRoutePath('/foo/')).toBe('R/foo'); - expect(encodeRoutePath('/foo/index.html')).toBe('R/foo'); }); test('throws on invalid routePath', () => { expect(() => encodeRoutePath('foo')).toThrow(); + expect(() => encodeRoutePath('/foo/')).toThrow(); + expect(() => encodeRoutePath('/index.html')).toThrow(); + expect(() => encodeRoutePath('/foo/index.html')).toThrow(); }); }); From 3efb3bf8d867b786d76460c0aa8095816b4eb1ce Mon Sep 17 00:00:00 2001 From: daishi Date: Fri, 6 Mar 2026 22:42:49 +0900 Subject: [PATCH 09/10] small refactor --- packages/waku/src/router/client.tsx | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/packages/waku/src/router/client.tsx b/packages/waku/src/router/client.tsx index f5574ffa2f..4f6360fecc 100644 --- a/packages/waku/src/router/client.tsx +++ b/packages/waku/src/router/client.tsx @@ -816,12 +816,7 @@ const InnerRouter = ({ const routeRef = useRef(route); useEffect(() => { routeRef.current = initialRoute; - setRoute((prev) => { - if (isSameRoute(prev, initialRoute)) { - return prev; - } - return initialRoute; - }); + setRoute((prev) => (isSameRoute(prev, initialRoute) ? prev : initialRoute)); }, [initialRoute]); const [err, setErr] = useState(null); From ce2c0d9e4293b001710afca3be733883d61379cd Mon Sep 17 00:00:00 2001 From: daishi Date: Fri, 6 Mar 2026 22:45:19 +0900 Subject: [PATCH 10/10] add comment --- packages/waku/src/router/define-router.tsx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/waku/src/router/define-router.tsx b/packages/waku/src/router/define-router.tsx index 57bd39d21f..b9c685baa8 100644 --- a/packages/waku/src/router/define-router.tsx +++ b/packages/waku/src/router/define-router.tsx @@ -146,7 +146,7 @@ export function unstable_notFound(): never { } export function unstable_redirect( - location: string, + location: string, // only URL `pathname` is supported. status: 303 | 307 | 308 = 307, ): never { throw createCustomError('Redirect', { status, location });