From a8c6fafbcdaac25eb9d84eb073bb7ebfce4e53bd Mon Sep 17 00:00:00 2001 From: Tom Boullay Date: Tue, 28 Apr 2026 15:02:50 +0200 Subject: [PATCH] address docs routing review feedback --- docs/technical/editor.md | 6 +++--- src/data/docs/docsTranslations.ts | 11 ++++++----- src/providers/docs/DocsLanguageProvider.tsx | 4 ++-- src/router.tsx | 10 +++++----- 4 files changed, 16 insertions(+), 15 deletions(-) diff --git a/docs/technical/editor.md b/docs/technical/editor.md index 42e2f60..fd0e8cb 100644 --- a/docs/technical/editor.md +++ b/docs/technical/editor.md @@ -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. diff --git a/src/data/docs/docsTranslations.ts b/src/data/docs/docsTranslations.ts index 1b26a88..82d45ec 100644 --- a/src/data/docs/docsTranslations.ts +++ b/src/data/docs/docsTranslations.ts @@ -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 diff --git a/src/providers/docs/DocsLanguageProvider.tsx b/src/providers/docs/DocsLanguageProvider.tsx index a1278bc..0f081a2 100644 --- a/src/providers/docs/DocsLanguageProvider.tsx +++ b/src/providers/docs/DocsLanguageProvider.tsx @@ -18,8 +18,8 @@ export function DocsLanguageProvider({ } return ( - + {children} - + ); } diff --git a/src/router.tsx b/src/router.tsx index a999bb8..4bb68a2 100644 --- a/src/router.tsx +++ b/src/router.tsx @@ -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,