docs(highways): JSDoc the delegating _freeCamFor wrappers (keys, drum)

Finish the docstring pass for the CamDir bridge functions changed in this PR:
convert the two per-panel _freeCamFor delegating wrappers to JSDoc, matching the
pure _resolveFreeCam / _ssApi helpers. Comment-only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Kris Anderson <topkoa@gmail.com>
This commit is contained in:
Kris Anderson
2026-07-09 16:28:58 -04:00
co-authored by Claude Opus 4.8
parent bcee2e8610
commit 54b5d2e426
2 changed files with 16 additions and 8 deletions
+8 -4
View File
@@ -2683,10 +2683,14 @@
cam.lookAt(0, 0, -AHEAD * TS * 0.45);
}
// Camera Director bridge for THIS panel — delegates to the pure, unit-
// tested _resolveFreeCam / _ssApi (see the resolver block above the
// factory). Reads the live globals: per-panel map __h3dCamCtlPanels →
// this panel's camera, else the global __h3dCamCtl, else null (stock).
/**
* Camera Director bridge for THIS panel — delegates to the pure, unit-
* tested _resolveFreeCam / _ssApi (resolver block above the factory).
* Reads the live globals: per-panel map __h3dCamCtlPanels → this panel's
* camera, else the global __h3dCamCtl, else null (stock framing).
* @param {HTMLCanvasElement} canvas this panel's highway canvas
* @returns {object|null} the resolved free-camera bridge, or null
*/
function _freeCamFor(canvas) {
return _resolveFreeCam(canvas, _ssApi(), window.__h3dCamCtlPanels, window.__h3dCamCtl);
}