palcarazm / bootstrap5-toggle / 39146254923

95%

v5: 95%

push

github

feat: integrate component-lifecycle library into Toggle component (#371)

* feat: integrate component-lifecycle library into Toggle component

Refactor Toggle to extend Component<"toggle"> from component-lifecycle,
replacing the manual eventsBound flag and destroy() method with the
library's deterministic state machine (idle → initialized → attached ↔
disposed → destroyed). This adds automatic lifecycle event emission
(toggle:initialized, toggle:attached, toggle:disposed,
toggle:destroyed), state introspection (isAttached, isDisposed,
isDestroyed, isInitialized), and typed domain events via
ExtendableEventMap.

Lifecycle hooks (doInit, doAttach, doDispose, doDestroy) replace the
inline constructor setup. The lifecycle is kicked off by the ECMAS and
jQuery entry points with init().then(attach) to preserve the
auto-initialization path via [data-toggle="toggle"]. rerender() now
routes through dispose() then attach(), preserving instance identity
while emitting lifecycle events.

component-lifecycle is bundled into the UMD builds and externalized as
a runtime dependency for the ESM/CJS dist builds.

Implements #317

BREAKING CHANGE: on() and off() instance methods renamed to toggleOn()
and toggleOff() to avoid collision with Component's event subscription
API. The public element.bootstrapToggle("on") / ("off") wrapper API is
unchanged.

BREAKING CHANGE: destroy() and rerender() now return Promise<void>.
Callers must await the result to ensure teardown or rebuild completion
before reinitializing.

BREAKING CHANGE: constructing a Toggle no longer starts the lifecycle.
Consumers using the class directly must call await toggle.init() then
await toggle.attach(). Auto-initialization via element.bootstrapToggle()
or [data-toggle="toggle"] continues to work via the fire-and-forget
chain in the entry points.

BREAKING CHANGE: interceptInputProperties() runs asynchronously during
attach(). External input property changes (checked, disabled, readOnly,
indeterminate)... (continued)

391 of 428 branches covered (91.36%)

Branch coverage included in aggregate %.

24 of 25 new or added lines in 1 file covered. (96.0%)

482 of 489 relevant lines covered (98.57%)

110.4 hits per line