@platformos/platformos-common 0.0.11 → 0.0.15

package/src/route-table/RouteTable.spec.ts

@@ -0,0 +1,708 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { URI } from 'vscode-uri';
+import { RouteTable } from './RouteTable';
+import { AbstractFileSystem, FileType, FileStat, FileTuple } from '../AbstractFileSystem';
+
+function createMockFileSystem(files: Record<string, string>): AbstractFileSystem {
+  const fileSet = new Map(Object.entries(files));
+
+  return {
+    stat: vi.fn(async (uri: string): Promise<FileStat> => {
+      if (fileSet.has(uri)) {
+        return { type: FileType.File, size: fileSet.get(uri)!.length };
+      }
+      throw new Error(`File not found: ${uri}`);
+    }),
+    readFile: vi.fn(async (uri: string): Promise<string> => {
+      if (fileSet.has(uri)) {
+        return fileSet.get(uri)!;
+      }
+      throw new Error(`File not found: ${uri}`);
+    }),
+    readDirectory: vi.fn(async (uri: string): Promise<FileTuple[]> => {
+      const results: FileTuple[] = [];
+      const dirs = new Set<string>();
+
+      for (const filePath of fileSet.keys()) {
+        if (filePath.startsWith(uri + '/') || filePath === uri) {
+          // Check if this is a direct child or nested
+          const remaining = filePath.slice(uri.length + 1);
+          const slashIdx = remaining.indexOf('/');
+          if (slashIdx === -1) {
+            results.push([filePath, FileType.File]);
+          } else {
+            const dirName = uri + '/' + remaining.slice(0, slashIdx);
+            if (!dirs.has(dirName)) {
+              dirs.add(dirName);
+              results.push([dirName, FileType.Directory]);
+            }
+          }
+        }
+      }
+
+      if (results.length === 0 && !fileSet.has(uri)) {
+        throw new Error(`Directory not found: ${uri}`);
+      }
+
+      return results;
+    }),
+  };
+}
+
+const ROOT = URI.parse('file:///project');
+
+function page(path: string, content: string = ''): [string, string] {
+  return [`file:///project/${path}`, content];
+}
+
+describe('RouteTable', () => {
+  describe('build and static matching', () => {
+    it('matches a simple static page', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/about.html.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/about')).toBe(true);
+      expect(rt.hasMatch('/nonexistent')).toBe(false);
+    });
+
+    it('matches root index page', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/index.html.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/')).toBe(true);
+    });
+
+    it('matches root from home.html.liquid (deprecated alias)', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/home.html.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/')).toBe(true);
+      expect(rt.hasMatch('/home')).toBe(false);
+    });
+
+    it('normalizes trailing slashes', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/about.html.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/about/')).toBe(true);
+    });
+
+    it('matches nested pages', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/users/show.html.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/users/show')).toBe(true);
+      expect(rt.hasMatch('/users')).toBe(false);
+    });
+
+    it('handles index aliasing', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/products/index.html.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/products')).toBe(true);
+      expect(rt.hasMatch('/products/index')).toBe(true);
+    });
+
+    it('does not report false match', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/about.html.liquid'),
+          page('app/views/pages/contact.html.liquid'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/nonexistent')).toBe(false);
+    });
+  });
+
+  describe('frontmatter slug override', () => {
+    it('uses frontmatter slug instead of file path', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/legacy-about.html.liquid', '---\nslug: about\n---\n<h1>About</h1>'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/about')).toBe(true);
+      expect(rt.hasMatch('/legacy-about')).toBe(false);
+    });
+  });
+
+  describe('dynamic route matching', () => {
+    it('matches :param segments', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/users.html.liquid', '---\nslug: users/:id\n---\n'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/users/42')).toBe(true);
+      expect(rt.hasMatch('/users/john')).toBe(true);
+      expect(rt.hasMatch('/users')).toBe(false);
+      expect(rt.hasMatch('/users/42/extra')).toBe(false);
+    });
+
+    it('matches :param with static suffix', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/user-edit.html.liquid', '---\nslug: users/:id/edit\n---\n'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/users/42/edit')).toBe(true);
+      expect(rt.hasMatch('/users/42')).toBe(false);
+    });
+
+    it('matches wildcard segments', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/api.html.liquid', '---\nslug: api/*path\n---\n'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/api/v1')).toBe(true);
+      expect(rt.hasMatch('/api/v1/users/42')).toBe(true);
+      expect(rt.hasMatch('/api')).toBe(false);
+    });
+  });
+
+  describe('optional segment matching', () => {
+    it('matches with optional part omitted', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/users.html.liquid', '---\nslug: users(/:id)\n---\n'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/users')).toBe(true);
+      expect(rt.hasMatch('/users/42')).toBe(true);
+      expect(rt.hasMatch('/users/42/extra')).toBe(false);
+    });
+
+    it('matches with multiple optional groups', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/search.html.liquid', '---\nslug: search(/:country)(/:city)\n---\n'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/search')).toBe(true);
+      expect(rt.hasMatch('/search/us')).toBe(true);
+      expect(rt.hasMatch('/search/us/nyc')).toBe(true);
+    });
+
+    it('matches optional group with static + wildcard', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/users.html.liquid', '---\nslug: users(/section/*)\n---\n'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/users')).toBe(true);
+      expect(rt.hasMatch('/users/section/anything/here')).toBe(true);
+      expect(rt.hasMatch('/users/other')).toBe(false);
+    });
+  });
+
+  describe('method matching', () => {
+    it('filters by HTTP method', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/login.html.liquid'),
+          page('app/views/pages/login-post.html.liquid', '---\nslug: login\nmethod: post\n---\n'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/login', 'get')).toBe(true);
+      expect(rt.hasMatch('/login', 'post')).toBe(true);
+      expect(rt.hasMatch('/login', 'delete')).toBe(false);
+    });
+
+    it('defaults method to get', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/about.html.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/about', 'get')).toBe(true);
+      expect(rt.hasMatch('/about', 'post')).toBe(false);
+    });
+  });
+
+  describe('format matching', () => {
+    it('does not match json format page without explicit .json extension', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/api/data.json.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      // /api/data without extension defaults to html — no html page exists
+      expect(rt.hasMatch('/api/data')).toBe(false);
+      // Explicit .json extension matches the json page
+      expect(rt.hasMatch('/api/data.json')).toBe(true);
+    });
+
+    it('matches format extension in URL against the correct format page', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/api/my-page.html.liquid'),
+          page('app/views/pages/api/my-page.json.liquid'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      // Without format suffix — defaults to html, only html page matches
+      const htmlDefaultMatches = rt.match('/api/my-page');
+      expect(htmlDefaultMatches.length).toBe(1);
+      expect(htmlDefaultMatches[0].format).toBe('html');
+
+      // With .json suffix — only the json page matches
+      const jsonMatches = rt.match('/api/my-page.json');
+      expect(jsonMatches.length).toBe(1);
+      expect(jsonMatches[0].format).toBe('json');
+      expect(jsonMatches[0].uri).toContain('my-page.json.liquid');
+
+      // With .html suffix — only the html page matches
+      const htmlMatches = rt.match('/api/my-page.html');
+      expect(htmlMatches.length).toBe(1);
+      expect(htmlMatches[0].format).toBe('html');
+
+      // hasMatch respects format too
+      expect(rt.hasMatch('/api/my-page.json')).toBe(true);
+      expect(rt.hasMatch('/api/my-page.xml')).toBe(false);
+    });
+
+    it('does not treat unknown extensions as format suffixes', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page(
+            'app/views/pages/files/report.html.liquid',
+            '---\nslug: files/report.unknown\n---\n',
+          ),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      // .unknown is not a known format, so the whole segment is the slug component
+      expect(rt.hasMatch('/files/report.unknown')).toBe(true);
+    });
+  });
+
+  describe('Liquid interpolation matching', () => {
+    it('matches :_liquid_ against :param route', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/users.html.liquid', '---\nslug: users/:id\n---\n'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/users/:_liquid_')).toBe(true);
+    });
+
+    it('matches :_liquid_ against static route segment', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/users/show.html.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      // /users/:_liquid_ should match users/show because :_liquid_ matches any segment
+      expect(rt.hasMatch('/users/:_liquid_')).toBe(true);
+    });
+
+    it('matches mixed static + :_liquid_ pattern', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page(
+            'app/views/pages/product-reviews.html.liquid',
+            '---\nslug: products/:id/reviews\n---\n',
+          ),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/products/:_liquid_/reviews')).toBe(true);
+      expect(rt.hasMatch('/products/:_liquid_/settings')).toBe(false);
+    });
+
+    it('does not match :_liquid_ when no route exists', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/about.html.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/orders/:_liquid_/invoice')).toBe(false);
+    });
+  });
+
+  describe('precedence ordering', () => {
+    it('returns most specific route first', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/users-section-1.html.liquid', '---\nslug: users/section/1\n---\n'),
+          page(
+            'app/views/pages/users-section-id.html.liquid',
+            '---\nslug: users/section/:id\n---\n',
+          ),
+          page('app/views/pages/users-wild.html.liquid', '---\nslug: users/*\n---\n'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      const matches = rt.match('/users/section/1');
+      expect(matches.length).toBeGreaterThanOrEqual(2);
+      // Most specific (all static) should be first
+      expect(matches[0].slug).toBe('users/section/1');
+    });
+
+    it('prefers required param over optional param', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/users-required.html.liquid', '---\nslug: users/:id\n---\n'),
+          page('app/views/pages/users-optional.html.liquid', '---\nslug: users(/:id)\n---\n'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      const matches = rt.match('/users/42');
+      expect(matches.length).toBe(2);
+      expect(matches[0].slug).toBe('users/:id');
+    });
+  });
+
+  describe('updateFile and removeFile', () => {
+    it('adds a route via updateFile', async () => {
+      const fs = createMockFileSystem({});
+      const rt = new RouteTable(fs);
+
+      rt.updateFile(
+        'file:///project/app/views/pages/new-page.html.liquid',
+        '---\nslug: new-page\n---\n',
+      );
+
+      expect(rt.hasMatch('/new-page')).toBe(true);
+    });
+
+    it('removes a route via removeFile', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/about.html.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/about')).toBe(true);
+
+      rt.removeFile('file:///project/app/views/pages/about.html.liquid');
+
+      expect(rt.hasMatch('/about')).toBe(false);
+    });
+
+    it('updates existing route', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/page.html.liquid', '---\nslug: old\n---\n')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/old')).toBe(true);
+      expect(rt.hasMatch('/new')).toBe(false);
+
+      rt.updateFile('file:///project/app/views/pages/page.html.liquid', '---\nslug: new\n---\n');
+
+      expect(rt.hasMatch('/old')).toBe(false);
+      expect(rt.hasMatch('/new')).toBe(true);
+    });
+  });
+
+  describe('module pages', () => {
+    it('discovers and matches module pages', async () => {
+      const files = Object.fromEntries([
+        page('modules/admin/public/views/pages/dashboard.html.liquid'),
+      ]);
+      // Also need the modules directory to be discoverable
+      const fs = createMockFileSystem(files);
+      const rt = new RouteTable(fs);
+
+      // Manually add since build requires directory listing
+      rt.updateFile('file:///project/modules/admin/public/views/pages/dashboard.html.liquid', '');
+
+      expect(rt.hasMatch('/dashboard')).toBe(true);
+    });
+  });
+
+  describe('build clears previous state', () => {
+    it('rebuild after branch switch picks up new pages', async () => {
+      // Simulate initial branch with one page
+      const initialFiles = Object.fromEntries([page('app/views/pages/about.html.liquid')]);
+      const fs = createMockFileSystem(initialFiles);
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/about')).toBe(true);
+      expect(rt.hasMatch('/contact')).toBe(false);
+
+      // Simulate branch switch: replace backing files and rebuild
+      const newFiles = Object.fromEntries([page('app/views/pages/contact.html.liquid')]);
+      const fs2 = createMockFileSystem(newFiles);
+      const rt2 = new RouteTable(fs2);
+      await rt2.build(ROOT);
+
+      expect(rt2.hasMatch('/about')).toBe(false);
+      expect(rt2.hasMatch('/contact')).toBe(true);
+    });
+
+    it('build clears stale routes from a previous build', async () => {
+      const files = Object.fromEntries([page('app/views/pages/old-page.html.liquid')]);
+      const fs = createMockFileSystem(files);
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/old-page')).toBe(true);
+
+      // Simulate changed filesystem (branch switch) and rebuild
+      const newFiles = Object.fromEntries([page('app/views/pages/new-page.html.liquid')]);
+      const fs2 = createMockFileSystem(newFiles);
+      const rt2 = new RouteTable(fs2);
+      await rt2.build(ROOT);
+
+      expect(rt2.hasMatch('/old-page')).toBe(false);
+      expect(rt2.hasMatch('/new-page')).toBe(true);
+    });
+  });
+
+  describe('Windows-style URIs', () => {
+    it('handles Windows file URIs with drive letters', () => {
+      const rt = new RouteTable(createMockFileSystem({}));
+
+      // vscode-uri produces forward-slash URIs even on Windows
+      rt.updateFile('file:///C:/Users/dev/project/app/views/pages/about.html.liquid', '');
+
+      expect(rt.hasMatch('/about')).toBe(true);
+    });
+
+    it('handles Windows module page URIs', () => {
+      const rt = new RouteTable(createMockFileSystem({}));
+
+      rt.updateFile(
+        'file:///C:/Users/dev/project/modules/admin/public/views/pages/dashboard.html.liquid',
+        '',
+      );
+
+      expect(rt.hasMatch('/dashboard')).toBe(true);
+    });
+  });
+
+  describe('format defaults to html', () => {
+    it('plain URL without extension matches only html pages', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/about.html.liquid'),
+          page('app/views/pages/about.json.liquid'),
+          page('app/views/pages/about.xml.liquid'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      const matches = rt.match('/about');
+      expect(matches.length).toBe(1);
+      expect(matches[0].format).toBe('html');
+    });
+
+    it('page with only .liquid extension defaults to html format', async () => {
+      const fs = createMockFileSystem(Object.fromEntries([page('app/views/pages/simple.liquid')]));
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/simple')).toBe(true);
+
+      const matches = rt.match('/simple');
+      expect(matches[0].format).toBe('html');
+    });
+
+    it('json-only page requires .json extension to match', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/api/endpoint.json.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.hasMatch('/api/endpoint')).toBe(false);
+      expect(rt.hasMatch('/api/endpoint.json')).toBe(true);
+    });
+  });
+
+  describe('routeCount', () => {
+    it('returns 0 for empty table', () => {
+      const rt = new RouteTable(createMockFileSystem({}));
+      expect(rt.routeCount()).toBe(0);
+    });
+
+    it('counts single route entry', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/about.html.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.routeCount()).toBe(1);
+    });
+
+    it('counts index alias as two entries', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([page('app/views/pages/products/index.html.liquid')]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      // products + products/index
+      expect(rt.routeCount()).toBe(2);
+    });
+
+    it('decrements after removeFile', async () => {
+      const fs = createMockFileSystem(
+        Object.fromEntries([
+          page('app/views/pages/a.html.liquid'),
+          page('app/views/pages/b.html.liquid'),
+        ]),
+      );
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.routeCount()).toBe(2);
+      rt.removeFile('file:///project/app/views/pages/a.html.liquid');
+      expect(rt.routeCount()).toBe(1);
+    });
+  });
+
+  describe('large route table', () => {
+    it('handles hundreds of routes and matches correctly', async () => {
+      const files: [string, string][] = [];
+      for (let i = 0; i < 200; i++) {
+        files.push(page(`app/views/pages/section-${i}/page.html.liquid`));
+      }
+      // Add some dynamic routes
+      for (let i = 0; i < 50; i++) {
+        files.push(
+          page(`app/views/pages/api-${i}.html.liquid`, `---\nslug: api/${i}/items/:id\n---\n`),
+        );
+      }
+      const fs = createMockFileSystem(Object.fromEntries(files));
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.routeCount()).toBe(250);
+
+      // Static matches
+      expect(rt.hasMatch('/section-0/page')).toBe(true);
+      expect(rt.hasMatch('/section-199/page')).toBe(true);
+      expect(rt.hasMatch('/section-200/page')).toBe(false);
+
+      // Dynamic matches
+      expect(rt.hasMatch('/api/0/items/42')).toBe(true);
+      expect(rt.hasMatch('/api/49/items/abc')).toBe(true);
+      expect(rt.hasMatch('/api/50/items/1')).toBe(false);
+
+      // Precedence: static more specific than dynamic
+      const matches = rt.match('/api/0/items/42');
+      expect(matches.length).toBe(1);
+      expect(matches[0].slug).toBe('api/0/items/:id');
+    });
+
+    it('updateFile on large table does not corrupt other routes', async () => {
+      const files: [string, string][] = [];
+      for (let i = 0; i < 100; i++) {
+        files.push(page(`app/views/pages/page-${i}.html.liquid`));
+      }
+      const fs = createMockFileSystem(Object.fromEntries(files));
+      const rt = new RouteTable(fs);
+      await rt.build(ROOT);
+
+      expect(rt.routeCount()).toBe(100);
+
+      // Update one page to change its slug
+      rt.updateFile(
+        'file:///project/app/views/pages/page-50.html.liquid',
+        '---\nslug: new-slug\n---\n',
+      );
+
+      expect(rt.routeCount()).toBe(100);
+      expect(rt.hasMatch('/page-50')).toBe(false);
+      expect(rt.hasMatch('/new-slug')).toBe(true);
+      // Other routes unaffected
+      expect(rt.hasMatch('/page-0')).toBe(true);
+      expect(rt.hasMatch('/page-99')).toBe(true);
+    });
+
+    it('build clears all routes before repopulating', async () => {
+      const files1: [string, string][] = [];
+      for (let i = 0; i < 50; i++) {
+        files1.push(page(`app/views/pages/old-${i}.html.liquid`));
+      }
+      const fs1 = createMockFileSystem(Object.fromEntries(files1));
+      const rt = new RouteTable(fs1);
+      await rt.build(ROOT);
+
+      expect(rt.routeCount()).toBe(50);
+
+      // Rebuild with different files
+      const files2: [string, string][] = [];
+      for (let i = 0; i < 30; i++) {
+        files2.push(page(`app/views/pages/new-${i}.html.liquid`));
+      }
+      const fs2 = createMockFileSystem(Object.fromEntries(files2));
+      const rt2 = new RouteTable(fs2);
+      await rt2.build(ROOT);
+
+      expect(rt2.routeCount()).toBe(30);
+      expect(rt2.hasMatch('/old-0')).toBe(false);
+      expect(rt2.hasMatch('/new-0')).toBe(true);
+    });
+  });
+});