Remove engine domain index barrel exports phase 1 - PR_26140_067-remove-engine-domain-index-barrels-phase1

Author: DavidQ

docs/dev/reports/engine_domain_index_barrel_removal_phase1_report.md

@@ -0,0 +1,55 @@
+# PR_26140_067 Engine Domain Index Barrel Removal Phase 1
+
+## Summary
+- Removed the targeted engine domain barrel files:
+  - `src/engine/camera/index.js`
+  - `src/engine/collision/index.js`
+  - `src/engine/input/index.js`
+  - `src/engine/theme/index.js`
+- Replaced active imports and re-exports from those barrels with direct canonical file imports.
+- Kept scope to import/export wiring only; no runtime logic, sample JSON, or entry file removal was changed.
+- Applied the user's scope clarification for import-only edits in `games/Asteroids/index.js`, `samples/**/index.js`, `src/engine/core/Engine.js`, and `src/engine/core/index.js`.
+
+## Direct Import Mapping
+- Camera:
+  - `Camera2D` -> `src/engine/camera/Camera2D.js`
+  - `Camera3D` -> `src/engine/camera/Camera3D.js`
+  - `followCameraTarget`, `worldRectToScreen` -> `src/engine/camera/CameraSystem.js`
+  - `updateZoneCamera` -> `src/engine/camera/ZoneCameraSystem.js`
+- Collision:
+  - AABB helpers -> `src/engine/collision/aabb.js`
+  - polygon helpers -> `src/engine/collision/polygon.js`
+  - raster helpers -> `src/engine/collision/raster.js`
+  - hybrid helpers -> `src/engine/collision/hybrid.js`
+  - Object Vector collision helpers -> `src/engine/collision/objectVector.js`
+- Input:
+  - input services/maps/adapters -> their one-class files under `src/engine/input/`
+  - `drawActionInputDebugOverlay` -> `src/engine/input/ActionInputDebugOverlay.js`
+- Theme:
+  - header helpers -> `src/engine/theme/toolboxaid-header.js`
+  - `Theme` -> `src/engine/theme/Theme.js`
+  - `ThemeTokens` -> `src/engine/theme/ThemeTokens.js`
+
+## Validation
+- PASS: target barrel scan reports `remaining targeted barrel imports/exports: 0`.
+- PASS: target deletion scan reports `deleted targeted index files: 4/4`.
+- PASS: no JSON files changed.
+- PASS: `node --check` passed for 567 changed existing JS/MJS files.
+- PASS: local import target validation passed for 567 changed existing JS/MJS files.
+- PASS: `npm run test:workspace-v2` passed 59/59 tests.
+- PASS: targeted affected engine/final tests passed:
+  - `tests/core/Engine2DCapabilityCombinedFoundation.test.mjs`
+  - `tests/core/Engine3DPhysicsHookIsolation.test.mjs`
+  - `tests/core/EngineCoreBoundaryBaseline.test.mjs`
+  - `tests/core/EngineSceneLifecycle.test.mjs`
+  - `tests/core/Section1FinalResidueStructure.test.mjs`
+  - `tests/final/PlatformUxSystems.test.mjs`
+  - `tests/final/PrecisionCollisionSystems.test.mjs`
+- PASS: `npm run test:launch-smoke:games` passed 12/12 game entries.
+- PASS: `git diff --check` exited 0. Git emitted advisory line-ending warnings for touched test `.mjs` files only.
+- INFO: extra `npm test` was attempted as a broader engine check; it stopped on an existing unrelated missing import, `games/Asteroids/game/FullscreenBezelOverlay.js`, from `tests/games/FullscreenBezelOverlay.test.mjs`.
+- SKIPPED: full samples smoke test, per PR instruction.
+
+## Side Effects Cleaned
+- `npm run test:launch-smoke:games` created `tmp/node_modules`; it was removed after validation so `tmp/` is reserved for the final delta ZIP.
+- `docs/dev/reports/launch_smoke_report.md` was restored to its pre-validation content and is not part of this PR.

games/AITargetDummy/game/AITargetDummyInputController.js

@@ -4,7 +4,7 @@ David Quesenberry
 03/25/2026
 AITargetDummyInputController.js
 */
-import { GamepadInputAdapter } from '/src/engine/input/index.js';
+import GamepadInputAdapter from '/src/engine/input/GamepadInputAdapter.js';
 import { clamp } from '/src/shared/math/scalars.js';
 
 export default class AITargetDummyInputController {

games/AITargetDummy/main.js

@@ -5,8 +5,9 @@ David Quesenberry
 main.js
 */
 import Engine from '/src/engine/core/Engine.js';
-import { InputService } from '/src/engine/input/index.js';
-import { Theme, ThemeTokens } from '/src/engine/theme/index.js';
+import InputService from '/src/engine/input/InputService.js';
+import { Theme } from '/src/engine/theme/Theme.js';
+import { ThemeTokens } from '/src/engine/theme/ThemeTokens.js';
 import AITargetDummyScene from './game/AITargetDummyScene.js';
 
 const theme = new Theme(ThemeTokens);

games/Asteroids/entities/Asteroid.js

@@ -5,7 +5,7 @@ David Quesenberry
 Asteroid.js
 */
 import { TAU, randomRange, wrap } from '/src/shared/math/scalars.js';
-import { transformCollisionPoints } from '/src/engine/collision/index.js';
+import { transformCollisionPoints } from '/src/engine/collision/objectVector.js';
 
 const SIZE_PROFILES = {
   SML: { id: 1 },

games/Asteroids/entities/Bullet.js

@@ -5,7 +5,7 @@ David Quesenberry
 Bullet.js
 */
 import { wrap } from '/src/shared/math/scalars.js';
-import { transformCollisionPoints } from '/src/engine/collision/index.js';
+import { transformCollisionPoints } from '/src/engine/collision/objectVector.js';
 import { normalizePoints } from '/src/shared/math/geometry.js';
 
 export default class Bullet {

games/Asteroids/entities/Ship.js

@@ -5,7 +5,7 @@ David Quesenberry
 Ship.js
 */
 import { wrap } from '/src/shared/math/scalars.js';
-import { transformCollisionPoints } from '/src/engine/collision/index.js';
+import { transformCollisionPoints } from '/src/engine/collision/objectVector.js';
 import { normalizePoints } from '/src/shared/math/geometry.js';
 
 export default class Ship {

games/Asteroids/entities/Ufo.js

@@ -7,7 +7,7 @@ Ufo.js
 import Bullet from './Bullet.js';
 import { distance, randomRange } from '/src/shared/math/scalars.js';
 import { normalizePoints } from '/src/shared/math/geometry.js';
-import { transformCollisionPoints } from '/src/engine/collision/index.js';
+import { transformCollisionPoints } from '/src/engine/collision/objectVector.js';
 
 const UFO_PROFILES = {
   large: {

games/Asteroids/game/AsteroidsWorld.js

@@ -8,7 +8,7 @@ import Asteroid from '../entities/Asteroid.js';
 import Bullet from '../entities/Bullet.js';
 import Ship from '../entities/Ship.js';
 import Ufo from '../entities/Ufo.js';
-import { arePolygonsColliding } from '/src/engine/collision/index.js';
+import { arePolygonsColliding } from '/src/engine/collision/polygon.js';
 import { distance, randomRange } from '/src/shared/math/scalars.js';
 import { sanitizeFiniteNumber, sanitizePositiveNumber } from '/src/shared/math/numberNormalization.js';
 import {

games/Asteroids/game/asteroidObjectGeometry.js

@@ -1,7 +1,7 @@
 import {
   ASTEROIDS_ASTEROID_SIZE_OBJECT_IDS,
 } from './asteroidsObjectGeometryManifest.js';
-import { getObjectVectorCollisionOutlinePoints } from '/src/engine/collision/index.js';
+import { getObjectVectorCollisionOutlinePoints } from '/src/engine/collision/objectVector.js';
 import { asArray } from '/src/shared/array/arrays.js';
 import { centerPoints, maxRadius } from '/src/shared/math/geometry.js';
 

games/Asteroids/game/asteroidsObjectGeometryManifest.js

@@ -1,4 +1,4 @@
-import { getObjectVectorCollisionOutlinePoints } from '/src/engine/collision/index.js';
+import { getObjectVectorCollisionOutlinePoints } from '/src/engine/collision/objectVector.js';
 import { isRecord } from '/src/shared/object/objects.js';
 import { deepClone } from '/src/shared/json/clone.js';