Files

admin 9bf56a806b Move docs/ package mirror into document-navigator plugin

Relocate the ~6k-file docs tree from the repo root into
plugins/document-navigator/docs/ so the plugin is self-contained and
portable. docs/superpowers/ (specs and plans) stays at the repo root.

Moved via cp+rm rather than git mv because directory rename() fails with
EPERM on this WSL /mnt DrvFs mount; git rename-detection pairs the
identical-content files at commit time.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-05-30 01:10:00 +01:00

src

Move docs/ package mirror into document-navigator plugin

2026-05-30 01:10:00 +01:00

README.md

Move docs/ package mirror into document-navigator plugin

2026-05-30 01:10:00 +01:00

README.md

@suaveplan/controller - Universal input controller foundation — unified 32-field ControllerInput shape, BaseController abstract base with Clock-injected pollRate gating and threshold/deadzone normalisation, typed InputEventEmitter, stable CONTROLLER.* error code registry, and OpenTelemetry instrumentation. Chunk A of the @suaveplan/controller migration; device adapters and merger ship in follow-up chunks.

Universal input controller foundation. Ships the unified ControllerInput shape (37 normalised fields in [0, 255]), BaseController abstract base with injectable Clock/IdGenerator, pollRate gating and per-input threshold/deadzone normalisation, the typed InputEventEmitter, the stable CONTROLLER.* error-code registry, and the package's OpenTelemetry instruments.

Device adapters (KeyboardController, GamepadController, TouchController, MouseController) and ControllerMerger ship in Chunks B and C.

Documentation tree

base — Abstract base for every device-specific controller adapter shipped by this package. Owns the 37-field ControllerInput…
- base — Abstract base for every device-specific controller adapter shipped by this package. Owns the 37-field ControllerInput…
error-codes — Defines the stable CONTROLLER.* error-code registry and the typed ControllerError class used by every public surfac…
- error-codes — Defines the stable CONTROLLER.* error-code registry and the typed ControllerError class used by every public surfac…
events — Typed event dispatcher used by BaseController to fan input, state and combo events out to listeners. Centralising the…
- events — Typed event dispatcher used by BaseController to fan input, state and combo events out to listeners. Centralising the…
gamepad — Browser-tier device adapter that polls the Web Gamepad API and normalises button + axis state into the canonical 37-fie…
- gamepad.internal — Module-private helpers used by GamepadController to keep the main class file under the repository's 300-line hard cap…
- gamepad — Browser-tier device adapter that polls the Web Gamepad API and normalises button + axis state into the canonical 37-fie…
keyboard — Browser-tier device adapter that normalises DOM keydown/keyup events into the canonical 37-field ControllerInput…
- keyboard — Browser-tier device adapter that normalises DOM keydown/keyup events into the canonical 37-field ControllerInput…
merger — ControllerMerger fuses an ordered list of BaseController children into a single virtual controller whose `Controlle…
- merger — ControllerMerger fuses an ordered list of BaseController children into a single virtual controller whose `Controlle…
telemetry — Owns the OpenTelemetry instruments emitted by @suaveplan/controller: two counters tracking input and state-change thr…
- telemetry — Owns the OpenTelemetry instruments emitted by @suaveplan/controller: two counters tracking input and state-change thr…
types — Provides the canonical iteration order over the 37 ControllerInput keys and a createDefaultControllerInput() factor…
- keys — Provides the canonical iteration order over the 37 ControllerInput keys and a createDefaultControllerInput() factor…

Modules

base/base.md — BaseController lifecycle, state, normalisation, pollRate gating.
events/events.md — InputEventEmitter typed dispatcher with disposable listeners.
error-codes.md — CONTROLLER_CODES registry and ControllerError class.
telemetry.md — controller_inputs_total, controller_state_changes_total counters and the pattern-match duration histogram.
types/keys.md — CONTROLLER_INPUT_KEYS and createDefaultControllerInput.

Status

0.1.0 — Chunk A foundation. Chunks B (device adapters) and C (merger) extend the barrel with additional named exports.

Verification

bunx turbo lint typecheck test --filter=@suaveplan/controller
bunx turbo test:coverage --filter=@suaveplan/controller

The coverage gate is 100/100/100/100 (istanbul). The package's tests/setup/polyfills.ts registers an in-memory MeterProvider before source modules import the OTel meter so the telemetry assertions resolve against a real exporter, with no mocks.