refactor(frontend): each module defines itself in its folder; rails load lazily and keep their own state
A page used to be listed three times (lib/modules for its label, icon and gate; shell/moduleRegistry for its page and rail; lib/pageMeta for its title), and App held every rail's layout and collapse flag. Now each module's `module.ts` says it all — label, icon, gate, its lazy page and rail, its width — handed out through its index.ts, and features/navigation/moduleRegistry lists them in nav order for the rail, the palette, the tab title, the reachable set and the shell's render. A contract test holds the registry to the page ids and each definition to its own folder, with no static import of a page. Every rail is lazy now, loaded together with its page so a pinned rail never arrives after it and shoves the content aside; the feed's and the playlists' rails took @dnd-kit off the boot path (boot 428.5 → 393.9 KiB gzip, the App chunk 122 → 32 KiB). A rail reads its own layout and collapse flag (lib/useRail) and writes a layout change to the `me` cache too, since it now mounts anew on each visit. App's session effects, its one-shot entry-URL handlers and the admin nudge move into shell hooks; App is layout. The registry's three layer suppressions are gone: none is left.
This commit is contained in:
@@ -41,3 +41,14 @@ export function lazyWithPreload<P extends object>(
|
||||
}
|
||||
return Object.assign(Preloadable, { preload });
|
||||
}
|
||||
|
||||
/** A lazy page that resolves only once `alongside` (its side rail) has loaded too. The rail renders in
|
||||
* its own Suspense beside the page, and a pinned rail sits in the page's flow: arriving after the page,
|
||||
* it would shove the page's content sideways on its first visit. Loaded together, the rail is already
|
||||
* there (it renders synchronously once loaded) when the page commits. */
|
||||
export function lazyWithPreloadAlongside<P extends object>(
|
||||
factory: () => Promise<{ default: ComponentType<P> }>,
|
||||
alongside: PreloadableComponent<object>,
|
||||
): PreloadableComponent<P> {
|
||||
return lazyWithPreload(() => Promise.all([factory(), alongside.preload()]).then(([m]) => m));
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user