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.
- `/editor` renders the map editor.
- `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
@@ -19,7 +19,7 @@ The editor is a React route used to inspect and adjust the `public/map.json` sce
src/
├── pages/
│ └── editor/
│ └── EditorPage.tsx
│ └── page.tsx
├── components/
│ └── editor/
│ ├── EditorControls.tsx
@@ -43,7 +43,7 @@ src/
## 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.
+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
- \`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 :
- l'environnement et l'éclairage
- les helpers debug et le mode caméra debug
- soit la carte principale, soit la scène de test physique debug
- 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/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.
@@ -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\`.
- \`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/utils/debug/DebugPerf.tsx\` monte \`r3f-perf\` en lazy uniquement en mode debug.
- \`src/utils/debug/scene/DebugHelpers.tsx\` monte les helpers debug.
- \`src/utils/debug/scene/DebugCameraControls.tsx\` monte la caméra libre debug.
- \`src/components/debug/DebugPerf.tsx\` monte \`r3f-perf\` en lazy uniquement en mode debug.
- \`src/components/debug/scene/DebugHelpers.tsx\` monte les helpers debug.
- \`src/components/debug/scene/DebugCameraControls.tsx\` monte la caméra libre debug.
## Limites actuelles
+2 -2
View File
@@ -18,8 +18,8 @@ export function DocsLanguageProvider({
}
return (
<DocsLanguageContext value={{ language, toggleLanguage }}>
<DocsLanguageContext.Provider value={{ language, toggleLanguage }}>
{children}
</DocsLanguageContext>
</DocsLanguageContext.Provider>
);
}
+5 -5
View File
@@ -40,11 +40,11 @@ const docsRoute = createRoute({
const docsChildRoutes = [
{ path: "/", component: DocsReadmeRoute },
{ path: "/architecture", component: DocsArchitectureRoute },
{ path: "/target-architecture", component: DocsTargetArchitectureRoute },
{ path: "/technical-editor", component: DocsTechnicalEditorRoute },
{ path: "/features", component: DocsFeaturesRoute },
{ path: "/editor", component: DocsEditorRoute },
{ path: "architecture", component: DocsArchitectureRoute },
{ path: "target-architecture", component: DocsTargetArchitectureRoute },
{ path: "technical-editor", component: DocsTechnicalEditorRoute },
{ path: "features", component: DocsFeaturesRoute },
{ path: "editor", component: DocsEditorRoute },
].map(({ path, component }) =>
createRoute({
getParentRoute: () => docsRoute,