- MIT license attributed to Dreamodus Software Inc. (root + package LICENSE, package.json author, README and docs-site footer) - Version 1.0.0; CHANGELOG.md summarizing the release - Package files whitelist includes LICENSE/README/CHANGELOG; tarballs gitignored - Root README: instructions for consuming the unpublished package (tarball, file dependency, or pnpm link) Verified: 32 tests, both packages typecheck, production builds clean, and a pnpm-pack tarball installed into a fresh project resolves all 50 exports via both ESM and CJS.
1.8 KiB
1.8 KiB
Changelog
1.0.0 — 2026-07-12
Initial release.
Controls
- Rotary knob skins:
FlatKnob,MetalKnob,RubberKnob,VintageKnob,LEDKnob,NeonKnob,SteppedKnob,ImageKnob(film-strip sprites) - Linear:
Fader(custom cap color/length),LEDFader(meter-zone segments) - Displays:
Meter(peak hold + latching clip LED withclipValuepeak detection),SegmentDisplay(7-seg incl. letters/hex),AlphaDisplay(14-seg alphanumeric) XYPad(two-parameter pad),PushButton(toggle/momentary with LED)- Composable
<Knob>+ primitives (Arcwith gradients,Pointer,Ticks,TickLabels,Face,KnobValue,KnobLabel,GlowFilter) and fully headlessuseKnob
Interaction core
- Rotary (absolute / relative / pickup), relative vertical/horizontal, absolute track
modes; drag acceleration; cursor hiding; magnetic detents; endless
wrapmode - Wheel with trackpad delta accumulation,
wheelStep, focus-gated capture - Full keyboard support, Escape drag-cancel, double-click reset, type-in editing
(
editable,"1.2k"parsing), Shift fine control - Value model: any range, decimal steps with float-safe rounding, discrete
values, detentsteps, linear/log/pow/custom tapers, bipolarorigin onChange/onChangeStart/onChangeEndwith gesturemeta.source; gesture-scoped undo friendlyanimateChangestween for programmatic changes (reduced-motion aware),valueBubble
Integration
- Theming via
DreamknobProvider(dark/light bases, per-instance override) - Keyboard-only focus rings,
role="slider"/role="meter"semantics,aria-orientation,data-*state attributes,data-partCSS hooks forwardRefon all interactive components, hidden form inputs vianame, touch via pointer capture (mobile verified), SSR-safe rendering