address docs routing review feedback

This commit is contained in:
2026-04-28 15:02:50 +02:00
parent 14a55e8dd1
commit a8c6fafbcd
4 changed files with 16 additions and 15 deletions
+3 -3
View File
@@ -11,7 +11,7 @@ The editor is a React route used to inspect and adjust the `public/map.json` sce
- `/` renders the playable La-Fabrik scene. - `/` renders the playable La-Fabrik scene.
- `/editor` renders the map editor. - `/editor` renders the map editor.
- `src/App.tsx` mounts TanStack Router through `RouterProvider`. - `src/App.tsx` mounts TanStack Router through `RouterProvider`.
- `src/router.tsx` defines the `/editor` route and imports `EditorPage` from `src/pages/editor/EditorPage.tsx`. - `src/router.tsx` defines the `/editor` route and imports `EditorPage` from `src/pages/editor/page.tsx`.
## File Structure ## File Structure
@@ -19,7 +19,7 @@ The editor is a React route used to inspect and adjust the `public/map.json` sce
src/ src/
├── pages/ ├── pages/
│ └── editor/ │ └── editor/
│ └── EditorPage.tsx │ └── page.tsx
├── components/ ├── components/
│ └── editor/ │ └── editor/
│ ├── EditorControls.tsx │ ├── EditorControls.tsx
@@ -43,7 +43,7 @@ src/
## Responsibilities ## Responsibilities
`src/pages/editor/EditorPage.tsx` is the route-level composition component. It owns route-specific state such as selected object, hovered object, transform mode, and player-mode toggle. `src/pages/editor/page.tsx` is the route-level composition component. It owns route-specific state such as selected object, hovered object, transform mode, and player-mode toggle.
`src/hooks/editor/useEditorSceneData.ts` loads the default map data and handles folder uploads. `src/hooks/editor/useEditorSceneData.ts` loads the default map data and handles folder uploads.
+6 -5
View File
@@ -91,13 +91,14 @@ Ce document décrit le code réellement présent aujourd'hui dans le dépôt.
## Structure runtime ## Structure runtime
- \`src/App.tsx\` monte le \`Canvas\`, le \`World\` 3D, l'overlay de performance debug et les overlays HTML. - \`src/App.tsx\` monte le \`RouterProvider\`, qui pilote l'affichage des vues de l'application.
- \`src/pages/page.tsx\` monte le \`Canvas\`, le \`World\` 3D, l'overlay de performance debug et les overlays HTML.
- \`src/world/World.tsx\` compose la scène active avec : - \`src/world/World.tsx\` compose la scène active avec :
- l'environnement et l'éclairage - l'environnement et l'éclairage
- les helpers debug et le mode caméra debug - les helpers debug et le mode caméra debug
- soit la carte principale, soit la scène de test physique debug - soit la carte principale, soit la scène de test physique debug
- le rig joueur quand le mode caméra actif est \`player\` - le rig joueur quand le mode caméra actif est \`player\`
- \`src/world/Map.tsx\` charge le modèle principal de la carte et construit l'octree de collision. - \`src/world/GameMap.tsx\` charge les modèles de carte disponibles et construit l'octree de collision.
- \`src/world/debug/TestScene.tsx\` fournit une scène orientée debug pour les interactions et la physique. - \`src/world/debug/TestScene.tsx\` fournit une scène orientée debug pour les interactions et la physique.
- \`src/world/player/Player.tsx\` monte la caméra et le contrôleur. - \`src/world/player/Player.tsx\` monte la caméra et le contrôleur.
- \`src/world/player/PlayerController.tsx\` gère le mouvement pointer lock, le saut et les inputs d'interaction. - \`src/world/player/PlayerController.tsx\` gère le mouvement pointer lock, le saut et les inputs d'interaction.
@@ -121,9 +122,9 @@ Ce document décrit le code réellement présent aujourd'hui dans le dépôt.
- Le mode debug est activé avec \`?debug\`. - Le mode debug est activé avec \`?debug\`.
- \`src/utils/debug/Debug.ts\` possède l'instance \`lil-gui\` et les contrôles debug. - \`src/utils/debug/Debug.ts\` possède l'instance \`lil-gui\` et les contrôles debug.
- \`src/hooks/debug/useCameraMode.ts\` et \`src/hooks/debug/useSceneMode.ts\` s'abonnent à l'état debug. - \`src/hooks/debug/useCameraMode.ts\` et \`src/hooks/debug/useSceneMode.ts\` s'abonnent à l'état debug.
- \`src/utils/debug/DebugPerf.tsx\` monte \`r3f-perf\` en lazy uniquement en mode debug. - \`src/components/debug/DebugPerf.tsx\` monte \`r3f-perf\` en lazy uniquement en mode debug.
- \`src/utils/debug/scene/DebugHelpers.tsx\` monte les helpers debug. - \`src/components/debug/scene/DebugHelpers.tsx\` monte les helpers debug.
- \`src/utils/debug/scene/DebugCameraControls.tsx\` monte la caméra libre debug. - \`src/components/debug/scene/DebugCameraControls.tsx\` monte la caméra libre debug.
## Limites actuelles ## Limites actuelles
+2 -2
View File
@@ -18,8 +18,8 @@ export function DocsLanguageProvider({
} }
return ( return (
<DocsLanguageContext value={{ language, toggleLanguage }}> <DocsLanguageContext.Provider value={{ language, toggleLanguage }}>
{children} {children}
</DocsLanguageContext> </DocsLanguageContext.Provider>
); );
} }
+5 -5
View File
@@ -40,11 +40,11 @@ const docsRoute = createRoute({
const docsChildRoutes = [ const docsChildRoutes = [
{ path: "/", component: DocsReadmeRoute }, { path: "/", component: DocsReadmeRoute },
{ path: "/architecture", component: DocsArchitectureRoute }, { path: "architecture", component: DocsArchitectureRoute },
{ path: "/target-architecture", component: DocsTargetArchitectureRoute }, { path: "target-architecture", component: DocsTargetArchitectureRoute },
{ path: "/technical-editor", component: DocsTechnicalEditorRoute }, { path: "technical-editor", component: DocsTechnicalEditorRoute },
{ path: "/features", component: DocsFeaturesRoute }, { path: "features", component: DocsFeaturesRoute },
{ path: "/editor", component: DocsEditorRoute }, { path: "editor", component: DocsEditorRoute },
].map(({ path, component }) => ].map(({ path, component }) =>
createRoute({ createRoute({
getParentRoute: () => docsRoute, getParentRoute: () => docsRoute,