@buzola/vite-plugin 0.0.1

package/dist/__tests__/tree-builder.test.js

@@ -0,0 +1,335 @@
+import { describe, expect, it } from 'bun:test';
+import { buildFileRouteTree } from '../generator/tree-builder';
+/** Module loader that returns empty modules (no page exports). */
+const emptyLoader = async () => ({});
+describe('buildFileRouteTree', () => {
+    it('builds a tree from flat files', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/index.tsx', relativePath: 'index.tsx' },
+            { absolutePath: '/app/src/routes/about.tsx', relativePath: 'about.tsx' },
+        ];
+        const tree = await buildFileRouteTree(files, emptyLoader);
+        expect(tree).toHaveLength(2);
+        const index = tree.find(n => n.isIndex);
+        expect(index).toBeDefined();
+        expect(index.fullPath).toBe('/');
+        const about = tree.find(n => n.segment === 'about');
+        expect(about).toBeDefined();
+        expect(about.fullPath).toBe('/about');
+    });
+    it('builds nested routes with layouts', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/_layout.tsx', relativePath: '_layout.tsx' },
+            { absolutePath: '/app/src/routes/index.tsx', relativePath: 'index.tsx' },
+            { absolutePath: '/app/src/routes/users/_layout.tsx', relativePath: 'users/_layout.tsx' },
+            { absolutePath: '/app/src/routes/users/index.tsx', relativePath: 'users/index.tsx' },
+            { absolutePath: '/app/src/routes/users/detail.tsx', relativePath: 'users/detail.tsx' },
+        ];
+        const tree = await buildFileRouteTree(files, emptyLoader);
+        expect(tree).toHaveLength(1);
+        const rootLayout = tree[0];
+        expect(rootLayout.isLayout).toBe(true);
+        expect(rootLayout.filePath).toBe('/app/src/routes/_layout.tsx');
+        const rootIndex = rootLayout.children.find(n => n.isIndex);
+        expect(rootIndex).toBeDefined();
+        const usersLayout = rootLayout.children.find(n => n.isLayout && n.segment === 'users');
+        expect(usersLayout).toBeDefined();
+        expect(usersLayout.children).toHaveLength(2);
+        const usersIndex = usersLayout.children.find(n => n.isIndex);
+        expect(usersIndex).toBeDefined();
+        const detail = usersLayout.children.find(n => n.segment === 'detail');
+        expect(detail).toBeDefined();
+    });
+    it('handles pathless groups', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/(auth)/login.tsx', relativePath: '(auth)/login.tsx' },
+        ];
+        const tree = await buildFileRouteTree(files, emptyLoader);
+        const authGroup = tree.find(n => n.isPathlessGroup);
+        expect(authGroup).toBeDefined();
+    });
+    it('uses plain file names as segments', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/users/detail.tsx', relativePath: 'users/detail.tsx' },
+        ];
+        const tree = await buildFileRouteTree(files, emptyLoader);
+        const users = tree.find(n => n.segment === 'users');
+        expect(users).toBeDefined();
+        expect(users.children).toHaveLength(1);
+        expect(users.children[0].segment).toBe('detail');
+        expect(users.children[0].fullPath).toBe('/users/detail');
+    });
+    it('derives segment from page .route() via module loader', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/users/detail.tsx', relativePath: 'users/detail.tsx' },
+        ];
+        const loader = async (p) => {
+            if (p === '/app/src/routes/users/detail.tsx') {
+                return {
+                    default: {
+                        __buzolaPage: true,
+                        component: () => null,
+                        route: '/users/:userId',
+                        paramsMeta: [{ name: 'userId', optional: false, array: false }],
+                    },
+                };
+            }
+            return {};
+        };
+        const tree = await buildFileRouteTree(files, loader);
+        const users = tree.find(n => n.segment === 'users');
+        expect(users).toBeDefined();
+        expect(users.children).toHaveLength(1);
+        expect(users.children[0].segment).toBe(':userId');
+        expect(users.children[0].fullPath).toBe('/users/:userId');
+        expect(users.children[0].pageExports).toEqual([
+            { pageId: 'users/detail', exportName: 'default', routePattern: '/users/:userId', params: [{ name: 'userId', optional: false, array: false }] },
+        ]);
+    });
+    it('derives route from file path when no .route()', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/users/detail.tsx', relativePath: 'users/detail.tsx' },
+        ];
+        const loader = async () => ({
+            default: {
+                __buzolaPage: true,
+                component: () => null,
+                paramsMeta: [{ name: 'userId', optional: false, array: false }],
+                // no .route() — should derive /users/detail from file path
+            },
+        });
+        const tree = await buildFileRouteTree(files, loader);
+        const users = tree.find(n => n.segment === 'users');
+        expect(users).toBeDefined();
+        expect(users.children[0].segment).toBe('detail');
+        expect(users.children[0].fullPath).toBe('/users/detail');
+        expect(users.children[0].pageExports).toEqual([
+            { pageId: 'users/detail', exportName: 'default', routePattern: '/users/detail', params: [{ name: 'userId', optional: false, array: false }] },
+        ]);
+    });
+    it('derives route for index file when no .route()', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/users/index.tsx', relativePath: 'users/index.tsx' },
+        ];
+        const loader = async () => ({
+            default: {
+                __buzolaPage: true,
+                component: () => null,
+                paramsMeta: [],
+            },
+        });
+        const tree = await buildFileRouteTree(files, loader);
+        const users = tree.find(n => n.segment === 'users');
+        const index = users.children.find(n => n.isIndex);
+        expect(index).toBeDefined();
+        expect(index.pageExports).toEqual([
+            { pageId: 'users', exportName: 'default', routePattern: '/users', params: [] },
+        ]);
+    });
+    it('sorts not-found routes last', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/about.tsx', relativePath: 'about.tsx' },
+            { absolutePath: '/app/src/routes/_404.tsx', relativePath: '_404.tsx' },
+            { absolutePath: '/app/src/routes/users/index.tsx', relativePath: 'users/index.tsx' },
+        ];
+        const tree = await buildFileRouteTree(files, emptyLoader);
+        const segments = tree.map(n => n.segment);
+        // _404 catch-all must be last
+        expect(segments[segments.length - 1]).toBe(':__notFound+');
+        const notFound = tree.find(n => n.isNotFound);
+        expect(notFound).toBeDefined();
+        expect(notFound.fullPath).toBe('/:__notFound+');
+    });
+    // ─── Named exports ──────────────────────────────────────────────────────
+    it('creates child nodes for named exports from regular files', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/users.tsx', relativePath: 'users.tsx' },
+        ];
+        const loader = async () => ({
+            default: {
+                __buzolaPage: true,
+                component: () => null,
+                paramsMeta: [],
+            },
+            detail: {
+                __buzolaPage: true,
+                component: () => null,
+                paramsMeta: [{ name: 'id', optional: false, array: false }],
+            },
+            settings: {
+                __buzolaPage: true,
+                component: () => null,
+                paramsMeta: [],
+            },
+        });
+        const tree = await buildFileRouteTree(files, loader);
+        const users = tree.find(n => n.segment === 'users');
+        expect(users).toBeDefined();
+        expect(users.filePath).toBe('/app/src/routes/users.tsx');
+        expect(users.exportName).toBe('default');
+        expect(users.pageExports).toEqual([
+            { pageId: 'users', exportName: 'default', routePattern: '/users', params: [] },
+        ]);
+        // Named exports become children
+        expect(users.children).toHaveLength(2);
+        const detail = users.children.find(n => n.segment === 'detail');
+        expect(detail).toBeDefined();
+        expect(detail.filePath).toBe('/app/src/routes/users.tsx');
+        expect(detail.exportName).toBe('detail');
+        expect(detail.fullPath).toBe('/users/detail');
+        expect(detail.pageExports).toEqual([
+            { pageId: 'users/detail', exportName: 'detail', routePattern: '/users/detail', params: [{ name: 'id', optional: false, array: false }] },
+        ]);
+        const settings = users.children.find(n => n.segment === 'settings');
+        expect(settings).toBeDefined();
+        expect(settings.fullPath).toBe('/users/settings');
+    });
+    it('creates sibling nodes for named exports from index files', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/users/index.tsx', relativePath: 'users/index.tsx' },
+        ];
+        const loader = async () => ({
+            default: {
+                __buzolaPage: true,
+                component: () => null,
+                paramsMeta: [],
+            },
+            detail: {
+                __buzolaPage: true,
+                component: () => null,
+                paramsMeta: [{ name: 'id', optional: false, array: false }],
+            },
+        });
+        const tree = await buildFileRouteTree(files, loader);
+        const users = tree.find(n => n.segment === 'users');
+        expect(users).toBeDefined();
+        // Default export → index node
+        const index = users.children.find(n => n.isIndex);
+        expect(index).toBeDefined();
+        expect(index.filePath).toBe('/app/src/routes/users/index.tsx');
+        // Named export → sibling of index (child of users)
+        const detail = users.children.find(n => n.segment === 'detail');
+        expect(detail).toBeDefined();
+        expect(detail.filePath).toBe('/app/src/routes/users/index.tsx');
+        expect(detail.exportName).toBe('detail');
+        expect(detail.fullPath).toBe('/users/detail');
+        expect(detail.pageExports).toEqual([
+            { pageId: 'users/detail', exportName: 'detail', routePattern: '/users/detail', params: [{ name: 'id', optional: false, array: false }] },
+        ]);
+    });
+    it('creates container node when file has only named exports', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/users.tsx', relativePath: 'users.tsx' },
+        ];
+        const loader = async () => ({
+            list: {
+                __buzolaPage: true,
+                component: () => null,
+                paramsMeta: [],
+            },
+            detail: {
+                __buzolaPage: true,
+                component: () => null,
+                paramsMeta: [],
+            },
+        });
+        const tree = await buildFileRouteTree(files, loader);
+        const users = tree.find(n => n.segment === 'users');
+        expect(users).toBeDefined();
+        expect(users.filePath).toBeUndefined(); // No default → no component
+        expect(users.pageExports).toBeUndefined();
+        expect(users.children).toHaveLength(2);
+        expect(users.children.find(n => n.segment === 'detail')).toBeDefined();
+        expect(users.children.find(n => n.segment === 'list')).toBeDefined();
+    });
+    it('named export with .route() uses explicit route pattern', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/users.tsx', relativePath: 'users.tsx' },
+        ];
+        const loader = async () => ({
+            detail: {
+                __buzolaPage: true,
+                component: () => null,
+                route: '/users/:userId',
+                paramsMeta: [{ name: 'userId', optional: false, array: false }],
+            },
+        });
+        const tree = await buildFileRouteTree(files, loader);
+        const users = tree.find(n => n.segment === 'users');
+        expect(users.children).toHaveLength(1);
+        expect(users.children[0].segment).toBe(':userId');
+        expect(users.children[0].fullPath).toBe('/users/:userId');
+    });
+    it('throws on collision: named export vs file in subdirectory', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/users.tsx', relativePath: 'users.tsx' },
+            { absolutePath: '/app/src/routes/users/detail.tsx', relativePath: 'users/detail.tsx' },
+        ];
+        const loader = async (p) => {
+            if (p === '/app/src/routes/users.tsx') {
+                return {
+                    detail: {
+                        __buzolaPage: true,
+                        component: () => null,
+                        paramsMeta: [],
+                    },
+                };
+            }
+            return {
+                default: {
+                    __buzolaPage: true,
+                    component: () => null,
+                    paramsMeta: [],
+                },
+            };
+        };
+        expect(buildFileRouteTree(files, loader)).rejects.toThrow(/Route collision/);
+    });
+    it('throws on collision: named export from index vs file in same directory', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/users/detail.tsx', relativePath: 'users/detail.tsx' },
+            { absolutePath: '/app/src/routes/users/index.tsx', relativePath: 'users/index.tsx' },
+        ];
+        const loader = async (p) => {
+            if (p === '/app/src/routes/users/index.tsx') {
+                return {
+                    detail: {
+                        __buzolaPage: true,
+                        component: () => null,
+                        paramsMeta: [],
+                    },
+                };
+            }
+            return {
+                default: {
+                    __buzolaPage: true,
+                    component: () => null,
+                    paramsMeta: [],
+                },
+            };
+        };
+        expect(buildFileRouteTree(files, loader)).rejects.toThrow(/Route collision/);
+    });
+    it('handles nested _404 within a directory', async () => {
+        const files = [
+            { absolutePath: '/app/src/routes/users/index.tsx', relativePath: 'users/index.tsx' },
+            { absolutePath: '/app/src/routes/users/_404.tsx', relativePath: 'users/_404.tsx' },
+        ];
+        const tree = await buildFileRouteTree(files, emptyLoader);
+        const users = tree.find(n => n.segment === 'users');
+        expect(users).toBeDefined();
+        const notFound = users.children.find(n => n.isNotFound);
+        expect(notFound).toBeDefined();
+        expect(notFound.segment).toBe(':__notFound+');
+        expect(notFound.fullPath).toBe('/users/:__notFound+');
+        expect(notFound.pageExports).toEqual([
+            {
+                pageId: 'users/404',
+                exportName: 'default',
+                routePattern: '/users/:__notFound+',
+                params: [{ name: '__notFound', optional: false, array: false }],
+            },
+        ]);
+    });
+});
+//# sourceMappingURL=tree-builder.test.js.map

package/dist/__tests__/tree-builder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-builder.test.js","sourceRoot":"","sources":["../../src/__tests__/tree-builder.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UAAU,CAAA;AAG/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAE9D,kEAAkE;AAClE,MAAM,WAAW,GAAiB,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;AAElD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,2BAA2B,EAAE,YAAY,EAAE,WAAW,EAAE;YACxE,EAAE,YAAY,EAAE,2BAA2B,EAAE,YAAY,EAAE,WAAW,EAAE;SACxE,CAAA;QAED,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QACzD,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAE5B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACvC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;QAC3B,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAEjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;QAC3B,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,6BAA6B,EAAE,YAAY,EAAE,aAAa,EAAE;YAC5E,EAAE,YAAY,EAAE,2BAA2B,EAAE,YAAY,EAAE,WAAW,EAAE;YACxE,EAAE,YAAY,EAAE,mCAAmC,EAAE,YAAY,EAAE,mBAAmB,EAAE;YACxF,EAAE,YAAY,EAAE,iCAAiC,EAAE,YAAY,EAAE,iBAAiB,EAAE;YACpF,EAAE,YAAY,EAAE,kCAAkC,EAAE,YAAY,EAAE,kBAAkB,EAAE;SACtF,CAAA;QAED,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QAEzD,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QAC1B,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACtC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;QAE/D,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QAC1D,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAA;QAE/B,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;QACtF,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAA;QAEjC,MAAM,CAAC,WAAY,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7C,MAAM,UAAU,GAAG,WAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QAC7D,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAA;QAChC,MAAM,MAAM,GAAG,WAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAA;QACtE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,kCAAkC,EAAE,YAAY,EAAE,kBAAkB,EAAE;SACtF,CAAA;QAED,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAA;QACnD,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,kCAAkC,EAAE,YAAY,EAAE,kBAAkB,EAAE;SACtF,CAAA;QAED,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;QAC3B,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACjD,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,kCAAkC,EAAE,YAAY,EAAE,kBAAkB,EAAE;SACtF,CAAA;QAED,MAAM,MAAM,GAAiB,KAAK,EAAE,CAAC,EAAE,EAAE;YACxC,IAAI,CAAC,KAAK,kCAAkC,EAAE,CAAC;gBAC9C,OAAO;oBACN,OAAO,EAAE;wBACR,YAAY,EAAE,IAAI;wBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;wBACrB,KAAK,EAAE,gBAAgB;wBACvB,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;qBAC/D;iBACD,CAAA;YACF,CAAC;YACD,OAAO,EAAE,CAAA;QACV,CAAC,CAAA;QAED,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;QAC3B,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAClD,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;YAC9C,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE;SAC9I,CAAC,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,kCAAkC,EAAE,YAAY,EAAE,kBAAkB,EAAE;SACtF,CAAA;QAED,MAAM,MAAM,GAAiB,KAAK,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,EAAE;gBACR,YAAY,EAAE,IAAI;gBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;gBACrB,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;gBAC/D,2DAA2D;aAC3D;SACD,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;QAC3B,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACjD,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QACzD,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;YAC9C,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE;SAC7I,CAAC,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,iCAAiC,EAAE,YAAY,EAAE,iBAAiB,EAAE;SACpF,CAAA;QAED,MAAM,MAAM,GAAiB,KAAK,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,EAAE;gBACR,YAAY,EAAE,IAAI;gBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;gBACrB,UAAU,EAAE,EAAE;aACd;SACD,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;QACnD,MAAM,KAAK,GAAG,KAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QAClD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;QAC3B,MAAM,CAAC,KAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;YAClC,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;SAC9E,CAAC,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,2BAA2B,EAAE,YAAY,EAAE,WAAW,EAAE;YACxE,EAAE,YAAY,EAAE,0BAA0B,EAAE,YAAY,EAAE,UAAU,EAAE;YACtE,EAAE,YAAY,EAAE,iCAAiC,EAAE,YAAY,EAAE,iBAAiB,EAAE;SACpF,CAAA;QAED,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QAEzC,8BAA8B;QAC9B,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QAC7C,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;QAC9B,MAAM,CAAC,QAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,2EAA2E;IAE3E,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,2BAA2B,EAAE,YAAY,EAAE,WAAW,EAAE;SACxE,CAAA;QAED,MAAM,MAAM,GAAiB,KAAK,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,EAAE;gBACR,YAAY,EAAE,IAAI;gBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;gBACrB,UAAU,EAAE,EAAE;aACd;YACD,MAAM,EAAE;gBACP,YAAY,EAAE,IAAI;gBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;gBACrB,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;aAC3D;YACD,QAAQ,EAAE;gBACT,YAAY,EAAE,IAAI;gBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;gBACrB,UAAU,EAAE,EAAE;aACd;SACD,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;QAC3B,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;QACzD,MAAM,CAAC,KAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACzC,MAAM,CAAC,KAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;YAClC,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;SAC9E,CAAC,CAAA;QAEF,gCAAgC;QAChC,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,MAAM,GAAG,KAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAA;QAChE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;QAC5B,MAAM,CAAC,MAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;QAC1D,MAAM,CAAC,MAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACzC,MAAM,CAAC,MAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QAC9C,MAAM,CAAC,MAAO,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;YACnC,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE;SACxI,CAAC,CAAA;QAEF,MAAM,QAAQ,GAAG,KAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAA;QACpE,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;QAC9B,MAAM,CAAC,QAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,iCAAiC,EAAE,YAAY,EAAE,iBAAiB,EAAE;SACpF,CAAA;QAED,MAAM,MAAM,GAAiB,KAAK,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,EAAE;gBACR,YAAY,EAAE,IAAI;gBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;gBACrB,UAAU,EAAE,EAAE;aACd;YACD,MAAM,EAAE;gBACP,YAAY,EAAE,IAAI;gBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;gBACrB,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;aAC3D;SACD,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;QAE3B,8BAA8B;QAC9B,MAAM,KAAK,GAAG,KAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QAClD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;QAC3B,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAA;QAE/D,mDAAmD;QACnD,MAAM,MAAM,GAAG,KAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAA;QAChE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;QAC5B,MAAM,CAAC,MAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAA;QAChE,MAAM,CAAC,MAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACzC,MAAM,CAAC,MAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QAC9C,MAAM,CAAC,MAAO,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;YACnC,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE;SACxI,CAAC,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,2BAA2B,EAAE,YAAY,EAAE,WAAW,EAAE;SACxE,CAAA;QAED,MAAM,MAAM,GAAiB,KAAK,IAAI,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE;gBACL,YAAY,EAAE,IAAI;gBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;gBACrB,UAAU,EAAE,EAAE;aACd;YACD,MAAM,EAAE;gBACP,YAAY,EAAE,IAAI;gBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;gBACrB,UAAU,EAAE,EAAE;aACd;SACD,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;QAC3B,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAA,CAAC,4BAA4B;QACpE,MAAM,CAAC,KAAM,CAAC,WAAW,CAAC,CAAC,aAAa,EAAE,CAAA;QAE1C,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;QACvE,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;IACtE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,2BAA2B,EAAE,YAAY,EAAE,WAAW,EAAE;SACxE,CAAA;QAED,MAAM,MAAM,GAAiB,KAAK,IAAI,EAAE,CAAC,CAAC;YACzC,MAAM,EAAE;gBACP,YAAY,EAAE,IAAI;gBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;gBACrB,KAAK,EAAE,gBAAgB;gBACvB,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;aAC/D;SACD,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;QACnD,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAClD,MAAM,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,2BAA2B,EAAE,YAAY,EAAE,WAAW,EAAE;YACxE,EAAE,YAAY,EAAE,kCAAkC,EAAE,YAAY,EAAE,kBAAkB,EAAE;SACtF,CAAA;QAED,MAAM,MAAM,GAAiB,KAAK,EAAE,CAAC,EAAE,EAAE;YACxC,IAAI,CAAC,KAAK,2BAA2B,EAAE,CAAC;gBACvC,OAAO;oBACN,MAAM,EAAE;wBACP,YAAY,EAAE,IAAI;wBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;wBACrB,UAAU,EAAE,EAAE;qBACd;iBACD,CAAA;YACF,CAAC;YACD,OAAO;gBACN,OAAO,EAAE;oBACR,YAAY,EAAE,IAAI;oBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;oBACrB,UAAU,EAAE,EAAE;iBACd;aACD,CAAA;QACF,CAAC,CAAA;QAED,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC7E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,kCAAkC,EAAE,YAAY,EAAE,kBAAkB,EAAE;YACtF,EAAE,YAAY,EAAE,iCAAiC,EAAE,YAAY,EAAE,iBAAiB,EAAE;SACpF,CAAA;QAED,MAAM,MAAM,GAAiB,KAAK,EAAE,CAAC,EAAE,EAAE;YACxC,IAAI,CAAC,KAAK,iCAAiC,EAAE,CAAC;gBAC7C,OAAO;oBACN,MAAM,EAAE;wBACP,YAAY,EAAE,IAAI;wBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;wBACrB,UAAU,EAAE,EAAE;qBACd;iBACD,CAAA;YACF,CAAC;YACD,OAAO;gBACN,OAAO,EAAE;oBACR,YAAY,EAAE,IAAI;oBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;oBACrB,UAAU,EAAE,EAAE;iBACd;aACD,CAAA;QACF,CAAC,CAAA;QAED,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC7E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,KAAK,GAAkB;YAC5B,EAAE,YAAY,EAAE,iCAAiC,EAAE,YAAY,EAAE,iBAAiB,EAAE;YACpF,EAAE,YAAY,EAAE,gCAAgC,EAAE,YAAY,EAAE,gBAAgB,EAAE;SAClF,CAAA;QAED,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;QAE3B,MAAM,QAAQ,GAAG,KAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QACxD,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;QAC9B,MAAM,CAAC,QAAS,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAC9C,MAAM,CAAC,QAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;QACtD,MAAM,CAAC,QAAS,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;YACrC;gBACC,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,SAAS;gBACrB,YAAY,EAAE,qBAAqB;gBACnC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;aAC/D;SACD,CAAC,CAAA;IACH,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/conventions.d.ts

@@ -0,0 +1,53 @@
+/**
+ * File naming conventions for page-centric routing.
+ *
+ * _layout.tsx   → Layout wrapper (renders children via <Outlet />)
+ * _404.tsx      → Not-found catch-all (auto-assigned catch-all pattern within parent scope)
+ * index.tsx     → Index route (renders at parent's exact path)
+ * about.tsx     → Named page file (page ID derived from file name)
+ * (group)/      → Pathless group (no URL segment)
+ *
+ * Files prefixed with `_` are special convention files, not regular pages.
+ * Route patterns (URL paths) come exclusively from `.route()` on `createPage()`.
+ * File names only determine page IDs and layout nesting.
+ */
+export declare const ROUTE_FILE_EXTENSIONS: string[];
+export interface ParsedRouteFile {
+    /** The route segment this file contributes. */
+    segment: string;
+    /** Whether this is a layout file. */
+    isLayout: boolean;
+    /** Whether this is an index file. */
+    isIndex: boolean;
+    /** Whether this is a not-found catch-all file. */
+    isNotFound: boolean;
+    /** Whether this directory is a pathless group. */
+    isPathlessGroup: boolean;
+    /** Original file path relative to routes dir. */
+    relativePath: string;
+}
+/**
+ * Check if a file is a route file based on extension.
+ */
+export declare function isRouteFile(filePath: string): boolean;
+/**
+ * Parse a directory name for routing conventions.
+ */
+export declare function parseDirName(name: string): {
+    segment: string;
+    isPathlessGroup: boolean;
+};
+/**
+ * Parse a route file name (without extension) into routing info.
+ */
+export declare function parseFileName(nameWithoutExt: string): {
+    segment: string;
+    isLayout: boolean;
+    isIndex: boolean;
+    isNotFound: boolean;
+};
+/**
+ * Parse a route file path relative to the routes directory.
+ */
+export declare function parseRouteFile(relativePath: string): ParsedRouteFile;
+//# sourceMappingURL=conventions.d.ts.map

package/dist/conventions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventions.d.ts","sourceRoot":"","sources":["../src/conventions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,qBAAqB,UAAiC,CAAA;AAEnE,MAAM,WAAW,eAAe;IAC/B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAA;IACjB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAA;IACnB,kDAAkD;IAClD,eAAe,EAAE,OAAO,CAAA;IACxB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAOxF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG;IACtD,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;CACnB,CAcA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,CAoCpE"}

package/dist/conventions.js

@@ -0,0 +1,82 @@
+import * as path from 'node:path';
+/**
+ * File naming conventions for page-centric routing.
+ *
+ * _layout.tsx   → Layout wrapper (renders children via <Outlet />)
+ * _404.tsx      → Not-found catch-all (auto-assigned catch-all pattern within parent scope)
+ * index.tsx     → Index route (renders at parent's exact path)
+ * about.tsx     → Named page file (page ID derived from file name)
+ * (group)/      → Pathless group (no URL segment)
+ *
+ * Files prefixed with `_` are special convention files, not regular pages.
+ * Route patterns (URL paths) come exclusively from `.route()` on `createPage()`.
+ * File names only determine page IDs and layout nesting.
+ */
+export const ROUTE_FILE_EXTENSIONS = ['.tsx', '.jsx', '.ts', '.js'];
+/**
+ * Check if a file is a route file based on extension.
+ */
+export function isRouteFile(filePath) {
+    return ROUTE_FILE_EXTENSIONS.some(ext => filePath.endsWith(ext));
+}
+/**
+ * Parse a directory name for routing conventions.
+ */
+export function parseDirName(name) {
+    // Pathless group: (auth)
+    if (name.startsWith('(') && name.endsWith(')')) {
+        return { segment: '', isPathlessGroup: true };
+    }
+    return { segment: name, isPathlessGroup: false };
+}
+/**
+ * Parse a route file name (without extension) into routing info.
+ */
+export function parseFileName(nameWithoutExt) {
+    if (nameWithoutExt === '_layout') {
+        return { segment: '', isLayout: true, isIndex: false, isNotFound: false };
+    }
+    if (nameWithoutExt === '_404') {
+        return { segment: '', isLayout: false, isIndex: false, isNotFound: true };
+    }
+    if (nameWithoutExt === 'index') {
+        return { segment: '', isLayout: false, isIndex: true, isNotFound: false };
+    }
+    return { segment: nameWithoutExt, isLayout: false, isIndex: false, isNotFound: false };
+}
+/**
+ * Parse a route file path relative to the routes directory.
+ */
+export function parseRouteFile(relativePath) {
+    const ext = path.extname(relativePath);
+    const withoutExt = relativePath.slice(0, -ext.length);
+    const parts = withoutExt.split(path.sep);
+    const fileName = parts.pop();
+    const dirs = parts;
+    const fileInfo = parseFileName(fileName);
+    // Build segment from directory path + file
+    const segments = [];
+    let isPathlessGroup = false;
+    for (const dir of dirs) {
+        const dirInfo = parseDirName(dir);
+        if (dirInfo.isPathlessGroup) {
+            isPathlessGroup = true;
+        }
+        else {
+            segments.push(dirInfo.segment);
+        }
+    }
+    if (fileInfo.segment) {
+        segments.push(fileInfo.segment);
+    }
+    const segment = segments.length > 0 ? segments.join('/') : '';
+    return {
+        segment,
+        isLayout: fileInfo.isLayout,
+        isIndex: fileInfo.isIndex,
+        isNotFound: fileInfo.isNotFound,
+        isPathlessGroup,
+        relativePath,
+    };
+}
+//# sourceMappingURL=conventions.js.map

package/dist/conventions.js.map

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

package/dist/generator/codegen.d.ts

@@ -0,0 +1,23 @@
+import type { FileRouteNode } from './tree-builder';
+export interface CodegenOptions {
+    /** The route tree from file scanning. */
+    tree: FileRouteNode[];
+    /** Absolute path to the routes directory. */
+    routesDir: string;
+    /** Absolute path to the output file. */
+    outputPath: string;
+    /** Parameter names that should be persistent across navigations. */
+    persistentParams?: string[];
+}
+/**
+ * Generate the buzola.gen.ts file with:
+ * 1. Module augmentation for BuzolaPageMap (type safety)
+ * 2. Page registry (page ID → route pattern)
+ * 3. Route tree construction code
+ */
+export declare function generateRouteModule(options: CodegenOptions): string;
+/**
+ * Generate the virtual module content for `virtual:buzola/routes`.
+ */
+export declare function generateVirtualModule(outputPath: string): string;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/generator/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/generator/codegen.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,MAAM,WAAW,cAAc;IAC9B,yCAAyC;IACzC,IAAI,EAAE,aAAa,EAAE,CAAA;IACrB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAsFnE;AAsGD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEhE"}