v1.1.4: light-theme support (LED wells, panel buttons, readouts)

The controls whose chrome was hardcoded dark now adapt to a light base — previously they rendered as dark chips/holes on light themes. (Flat knobs and faders already adapted: their face is the `face` token.) - `ledWell` theme token — the recessed screen behind LED segments (LEDKnob, LEDFader, Meter) and the default well of SegmentDisplay / AlphaDisplay now comes from the theme. Dark base keeps #0b0d0e; light base is `transparent`, so LED controls and readouts render as clean flat rings / bars / digits on the light panel. faceColor / background props still override. - `scheme` theme token ('dark' | 'light', set by base) + a shared panelButtonChrome() helper drive the raised gradient/border/shadow of PushButton (and Button), TransportButton and SegmentSwitch — light raised buttons on light themes instead of dark chips; unlit LED pips flip to a faint dark so they still read. - Docs: a "Light theme" gallery card showing the panel family under base="light"; ledWell/scheme documented; install URLs bumped to v1.1.4. Library + docs typecheck and build; 46 tests pass.
v1.1.3: Radix-composable buttons, meter ballistics/dBFS/loudness, PanKnob
2026-07-14 14:21:57 -07:00 · 2026-07-14 12:08:20 -07:00 · 2026-07-14 06:36:39 -07:00 · 2026-07-14 06:33:15 -07:00
26 changed files with 1174 additions and 129 deletions
--- a/README.md
+++ b/README.md
@ -35,10 +35,11 @@ import { MetalKnob, LEDKnob, Fader, logTaper } from 'dreamknob'
  rounding, discrete `values` lists, evenly spaced detents (`steps`), linear / log /
  power / custom tapers.
 - **Styles**: `FlatKnob`, `MetalKnob`, `RubberKnob`, `VintageKnob`, `LEDKnob`, `NeonKnob`,
-  `SteppedKnob`, `ImageKnob` (film-strips), `Fader`, `LEDFader`, `Meter`, `MeterBridge`,
-  `Gauge`, `XYPad`, `PushButton`, `IndicatorLamp`, `LampRow`, `ToggleSwitch`,
-  `SegmentSwitch`, `TransportButton`, `ScrubField`, `SegmentDisplay`, `AlphaDisplay`,
-  plus `LabeledField`/`Rack` layout — every color themeable per instance.
+  `SteppedKnob`, `PanKnob`, `ImageKnob` (film-strips), `Fader`, `LEDFader`, `Meter`
+  (PPM ballistics · dBFS · loudness), `MeterBridge`, `Gauge`, `XYPad`, `PushButton`,
+  `Button`, `IndicatorLamp`, `LampRow`, `ToggleSwitch`, `SegmentSwitch`,
+  `TransportButton`, `ScrubField`, `SegmentDisplay`, `AlphaDisplay`, plus
+  `LabeledField`/`Rack` layout — every color themeable per instance.
 - **Composable**: `<Knob>` + primitives (`Arc`, `Pointer`, `Ticks`, `TickLabels`, `Face`,
  `KnobValue`, `KnobLabel`, `GlowFilter`) for custom designs, or go fully headless with
  `useKnob`.
@ -50,7 +51,7 @@ See `packages/dreamknob/README.md` and the docs app for the full API.
 The easiest way is the published release on our Forgejo:

 ```bash
-pnpm add https://git.dreamodus.software/Dreamodus/DreamKnob/releases/download/v1.1.1/dreamknob-1.1.1.tgz
+pnpm add https://git.dreamodus.software/Dreamodus/DreamKnob/releases/download/v1.1.4/dreamknob-1.1.4.tgz
 ```

 Or build locally — the package builds to `packages/dreamknob/dist` (ESM + CJS + types):
--- a/apps/docs/src/App.tsx
+++ b/apps/docs/src/App.tsx
@ -1,6 +1,7 @@
 import React from 'react';
 import { AdvancedGuide } from './sections/AdvancedGuide';
 import { ApiDocs } from './sections/ApiDocs';
+import { Buttons } from './sections/Buttons';
 import { Console } from './sections/Console';
 import { Gallery } from './sections/Gallery';
 import { GettingStarted } from './sections/GettingStarted';
@ -26,6 +27,7 @@ export const App: React.FC = () => (
        <div className="nav-links">
          <a href="#start">Start</a>
          <a href="#gallery">Gallery</a>
+          <a href="#buttons">Buttons</a>
          <a href="#synth">Synth</a>
          <a href="#playground">Playground</a>
          <a href="#guide">Guide</a>
@ -36,6 +38,7 @@ export const App: React.FC = () => (
    <Hero />
    <GettingStarted />
    <Gallery />
+    <Buttons />
    <Console />
    <Synth />
    <Playground />
--- a/apps/docs/src/sections/ApiDocs.tsx
+++ b/apps/docs/src/sections/ApiDocs.tsx
@ -128,14 +128,16 @@ export const ApiDocs: React.FC = () => (
        <Row name="<LEDKnob />" type="digital" desc="Segmented LED ring + seven-segment readout. color, offColor, segments, digits, displayDecimals (any precision), unit label under the digits." />
        <Row name="<NeonKnob />" type="2D" desc="Glowing arc + dot pointer. color, trackColor, arcFrom." />
        <Row name="<SteppedKnob />" type="selector" desc="Detented switch. positions (named) or steps (numeric), color, faceColor." />
+        <Row name="<PanKnob />" type="2D · bipolar" desc="Stereo pan: fills from center, snaps to a center detent, reads out L<n>/C/R<n>. Defaults to −50…50 centered at 0; pass min/max for other conventions." />
        <Row name="<Fader />" type="linear" desc="Channel fader. orientation, length, breadth, color, tickCount, showFill, unit, format, valuePosition ('top' | 'end' | 'none'), fill (stretch to container)." />
-        <Row name="<LEDFader />" type="linear · digital" desc="Segmented LED meter-fader. orientation, length, segments, color or zones ([{upTo, color}] — defaults to the theme's green/amber/red), glow, digits, unit." />
+        <Row name="<LEDFader />" type="linear · digital" desc="Segmented LED meter-fader. orientation, length, segments, color or zones ([{upTo, color}] — defaults to the theme's green/amber/red), glow, digits, unit, fill (stretch to container)." />
        <Row name="<ImageKnob />" type="sprite" desc="Film-strip knob (KnobMan-style PNG strips): src, frames, stripOrientation. Photoreal skins with zero drawing code." />
-        <Row name="<Meter />" type="display" desc="Read-only LED level meter: value (number or [l, r, ...]), zones (theme green/amber/red), peakHold, peakColor, orientation, unit, fill (stretch to container), disabled, seven-segment readout. Clip LED: showClip, clipThreshold, clipHold (ms or 'latch'), clipColor, onClip." />
+        <Row name="<Meter />" type="display" desc="LED level meter: value (number or [l, r, ...]), zones, peakHold, peakDecay (fall tail), ballistics (PPM attack/decay), scale='db' (feed amplitude → dBFS + reference lines), integrated (windowed loudness), fill, disabled, seven-seg readout, clip LED (showClip/clipThreshold/clipHold 'latch'/clipColor/onClip). All the new metering is opt-in." />
        <Row name="<MeterBridge />" type="display" desc="Labeled multi-strip meter block: channels ([{label, value, clipValue?}]), per-channel peak-hold text, shared clip LED — the mixer meter row, prebuilt." />
        <Row name="<XYPad />" type="2D control" desc="Two-parameter pad: x/y axis configs (each with min/max/step/invert/detents), drag + arrow keys (arrows follow the visual direction), grid, crosshair, Escape cancel, double-click reset." />
-        <Row name="<PushButton />" type="switch" desc="Panel button: toggle or momentary, controlled/uncontrolled, aria-pressed. led: 'strip' | 'dot'. leadingIcon slot tinted to the LED." />
-        <Row name="<IndicatorLamp />" type="switch · display" desc="Panel LED lamp: pressable toggle (role='switch') or read-only status light, blink, momentary, label either side — the checkbox, in hardware form." />
+        <Row name="<Button />" type="action" desc="Click-to-fire command button in the panel style (Regenerate, Add, Apply). PushButton locked to mode='action' — never latches, press-down, onClick. No LED by default (an action has no state); opt in with led='dot' | 'strip'. Forwards native button props → usable as a Radix asChild trigger." />
+        <Row name="<PushButton />" type="switch" desc="Panel button: mode 'toggle' | 'momentary' | 'action', controlled/uncontrolled, aria-pressed. led defaults to 'strip' for toggle/momentary (state) and off for action; also 'dot'. leadingIcon slot. Forwards ...rest and composes handlers, so it works as a dropdown/tooltip/popover trigger." />
+        <Row name="<IndicatorLamp />" type="switch · display" desc="Panel LED lamp: pressable toggle (role='switch') or read-only status light, blink, momentary, label either side (labelSize to shrink the caption below its 10px floor) — the checkbox, in hardware form." />
        <Row name="<SegmentSwitch />" type="selector" desc="Segmented option switch (radiogroup): options list, LED tick on the active cell, arrow/Home/End keys, controlled/uncontrolled index." />
        <Row name="<ScrubField />" type="numeric field" desc="After-Effects-style number field: drag the label to scrub (Shift = fine), click to type (Enter commits, Esc reverts), arrows step, wheel nudges. role='spinbutton'." />
        <Row name="<AlphaDisplay />" type="digital" desc="Fourteen-segment alphanumeric LED: A–Z 0–9 and symbols (now incl. : $ %), chars padding, align, weight, gap, glow, skew. Defaults to theme.ledAmber." />
@ -193,6 +195,7 @@ export const ApiDocs: React.FC = () => (
    ledGreen: '#3df2ad',            // SegmentDisplay default lit color
    ledAmber: '#ffb84d',            // AlphaDisplay default lit color
    panel:    'rgba(255,255,255,0.03)', // Rack / panel chrome
+    ledWell:  '#0b0d0e',            // LED display well (LEDKnob/LEDFader/Meter)
  }}
 >
  <FlatKnob ... /> <Fader ... /> <LEDKnob ... />
@ -310,12 +313,25 @@ function MyKnob() {
  <ToggleSwitch defaultOn showStateLabel />
 </LabeledField>

-// A declarative channel strip
+// A declarative channel strip — now with a pan knob
 <Rack orientation="column" title="Channel 1">
  <FlatKnob label="Gain" sublabel="dB" />
+  <PanKnob size={56} defaultValue={0} />
  <Fader orientation="horizontal" fill valuePosition="end" />
  <Meter value={level} min={-60} max={6} fill orientation="horizontal" />
-</Rack>`}
+</Rack>
+
+// A pro dBFS meter — feed amplitude, get ballistics + peak-decay + loudness
+<Meter value={[ampL, ampR]} scale="db" ballistics
+  peakHold={1500} peakDecay={0.25} integrated showValue unit="dB" />
+
+// A Button as a Radix dropdown trigger (it forwards + composes handlers)
+<DropdownMenu>
+  <DropdownMenuTrigger asChild>
+    <Button led={false}>Add channel</Button>
+  </DropdownMenuTrigger>
+  <DropdownMenuContent>{/* … */}</DropdownMenuContent>
+</DropdownMenu>`}
      />

      <h3 className="api-h">Precision &amp; number handling</h3>
--- a/apps/docs/src/sections/Buttons.tsx
+++ b/apps/docs/src/sections/Buttons.tsx
@ -0,0 +1,157 @@
+import React from 'react';
+import {
+  Button,
+  PushButton,
+  TransportButton,
+  ToggleSwitch,
+  SegmentSwitch,
+} from 'dreamknob';
+
+/** Small glyph for a button's leadingIcon (the docs app has no icon dep). */
+const Glyph: React.FC<{ children: React.ReactNode }> = ({ children }) => (
+  <span aria-hidden="true" style={{ fontSize: 14, lineHeight: 1 }}>
+    {children}
+  </span>
+);
+
+/** The button/switch family, side by side, with a "which do I use?" guide. */
+export const Buttons: React.FC = () => {
+  const [playing, setPlaying] = React.useState(false);
+  const [armed, setArmed] = React.useState(false);
+  const [bypass, setBypass] = React.useState(false);
+  const [fresh, setFresh] = React.useState(true);
+  const [mode, setMode] = React.useState(0);
+  const [fired, setFired] = React.useState(0);
+
+  return (
+    <section className="block" id="buttons">
+      <div className="container">
+        <div className="section-kicker">Buttons &amp; switches</div>
+        <h2 className="section-title">Press, latch, or pick</h2>
+        <p className="section-sub">
+          Five components cover every panel control that isn&apos;t a dial. The
+          only question is what the press <em>means</em>:
+        </p>
+
+        <div className="guide-grid">
+          <GuideRow
+            code="<Button>"
+            when="Fire a one-off action"
+            eg="Regenerate · Add · Apply · Refresh"
+          />
+          <GuideRow
+            code="<PushButton>"
+            when="Latch a boolean state (or hold it)"
+            eg="Mute · Solo · Bypass · push-to-talk"
+          />
+          <GuideRow
+            code="<TransportButton>"
+            when="Transport / deck control"
+            eg="Play · Stop · Record · Panic"
+          />
+          <GuideRow
+            code="<ToggleSwitch>"
+            when="An on/off setting that reads as a switch"
+            eg="Fresh seed · Monitor · Loop"
+          />
+          <GuideRow
+            code="<SegmentSwitch>"
+            when="Pick one of a few modes"
+            eg="Linear · Radial · Conic"
+          />
+        </div>
+
+        <div className="btn-demo">
+          <Demo label={`<Button> — action, fired ${fired}×`}>
+            <Button
+              color="#4cc2ff"
+              leadingIcon={<Glyph>↻</Glyph>}
+              onClick={() => setFired(n => n + 1)}
+              aria-label="Regenerate"
+            >
+              Regenerate
+            </Button>
+            <Button
+              color="#3df2ad"
+              led="dot"
+              leadingIcon={<Glyph>✦</Glyph>}
+              onClick={() => setFired(n => n + 1)}
+              aria-label="Fresh"
+            >
+              Fresh
+            </Button>
+            <Button
+              color="#ff4d6b"
+              led="strip"
+              leadingIcon={<Glyph>✕</Glyph>}
+              onClick={() => setFired(n => n + 1)}
+              aria-label="Clear"
+            >
+              Clear
+            </Button>
+          </Demo>
+
+          <Demo label="<PushButton> — latch / hold">
+            <PushButton
+              pressed={bypass}
+              onChange={setBypass}
+              color="#ffd23e"
+              aria-label="Bypass"
+            >
+              Bypass
+            </PushButton>
+            <PushButton
+              mode="momentary"
+              color="#4cc2ff"
+              led="dot"
+              size={30}
+              aria-label="Talk"
+            >
+              Talk
+            </PushButton>
+          </Demo>
+
+          <Demo label="<TransportButton>">
+            <TransportButton kind="play" active={playing} onClick={() => setPlaying(p => !p)} size={34} />
+            <TransportButton kind="stop" onClick={() => setPlaying(false)} size={34} />
+            <TransportButton kind="record" active={armed} onClick={() => setArmed(a => !a)} size={34} />
+          </Demo>
+
+          <Demo label="<ToggleSwitch> · <SegmentSwitch>">
+            <ToggleSwitch on={fresh} onChange={setFresh} color="#c9a6ff" showStateLabel aria-label="Fresh seed" />
+            <SegmentSwitch
+              options={['LINEAR', 'RADIAL', 'CONIC']}
+              value={mode}
+              onChange={setMode}
+              color="#4cc2ff"
+              aria-label="Gradient kind"
+            />
+          </Demo>
+        </div>
+
+        <p className="section-sub" style={{ marginTop: 20 }}>
+          <code>&lt;Button&gt;</code> is <code>&lt;PushButton mode=&quot;action&quot;&gt;</code> —
+          it never latches, shows a press-down, and calls <code>onClick</code>. It has{' '}
+          <strong>no LED by default</strong> — an action has no state to indicate, unlike a
+          toggle. Add <code>led=&quot;dot&quot;</code> for a corner dot that flashes on
+          press, or <code>led=&quot;strip&quot;</code> for the full strip.
+        </p>
+      </div>
+    </section>
+  );
+};
+
+const GuideRow: React.FC<{ code: string; when: string; eg: string }> = ({ code, when, eg }) => (
+  <div className="guide-row">
+    <code className="guide-code">{code}</code>
+    <span className="guide-when">{when}</span>
+    <span className="guide-eg">{eg}</span>
+  </div>
+);
+
+const Demo: React.FC<{ label: string; children: React.ReactNode }> = ({ label, children }) => (
+  <div className="btn-demo-cell">
+    <div className="btn-demo-label">{label}</div>
+    <div className="btn-demo-row">{children}</div>
+  </div>
+);
--- a/apps/docs/src/sections/Gallery.tsx
+++ b/apps/docs/src/sections/Gallery.tsx
@ -2,6 +2,7 @@ import React from 'react';
 import {
  AlphaDisplay,
  Arc,
+  Button,
  DreamknobProvider,
  Fader,
  FlatKnob,
@ -18,6 +19,7 @@ import {
  Meter,
  MeterBridge,
  NeonKnob,
+  PanKnob,
  Pointer,
  PushButton,
  Rack,
@ -280,7 +282,10 @@ const PanelDemo: React.FC = () => {
      <LabeledField label="Fresh seed" labelWidth={78}>
        <ToggleSwitch on={fresh} onChange={setFresh} color="#c9a6ff" showStateLabel aria-label="Fresh seed" />
      </LabeledField>
-      <SegmentSwitch options={['SOLID', 'GRAD', 'NOISE']} value={mode} onChange={setMode} color="#c9a6ff" aria-label="Fill mode" />
+      <div style={{ display: 'flex', gap: 8, alignItems: 'center' }}>
+        <SegmentSwitch options={['SOLID', 'GRAD', 'NOISE']} value={mode} onChange={setMode} color="#c9a6ff" aria-label="Fill mode" />
+        <Button color="#c9a6ff" size={30} title="Regenerate the world" aria-label="Regenerate">↻</Button>
+      </div>
      <LampRow
        lamps={[
          { label: 'Cue', on: playing, color: '#3df2ad' },
@ -292,6 +297,97 @@ const PanelDemo: React.FC = () => {
  );
 };

+const DbMeterDemo: React.FC = () => {
+  // Drive with linear amplitude; the meter converts to dBFS internally.
+  const [amp, setAmp] = React.useState<[number, number]>([0.3, 0.28]);
+  React.useEffect(() => {
+    let t = 0;
+    const id = setInterval(() => {
+      t += 0.11;
+      const spike = Math.random() < 0.05 ? 0.4 : 0;
+      setAmp([
+        Math.max(0.001, Math.min(1.2, 0.34 + Math.sin(t) * 0.22 + Math.random() * 0.16 + spike)),
+        Math.max(0.001, Math.min(1.2, 0.32 + Math.sin(t * 1.25 + 1) * 0.22 + Math.random() * 0.16 + spike)),
+      ]);
+    }, 90);
+    return () => clearInterval(id);
+  }, []);
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 20, alignItems: 'center' }}>
+      <Meter
+        value={amp}
+        scale="db"
+        ballistics
+        peakHold={1400}
+        peakDecay={0.22}
+        integrated
+        clipThreshold={0}
+        length={140}
+        showValue
+        unit="dB"
+        label="Vertical"
+        aria-label="dBFS meter"
+      />
+      <Meter
+        value={amp}
+        scale="db"
+        ballistics
+        peakHold={1400}
+        peakDecay={0.22}
+        clipThreshold={0}
+        orientation="horizontal"
+        length={190}
+        breadth={14}
+        label="Horizontal"
+        aria-label="dBFS meter horizontal"
+      />
+    </div>
+  );
+};
+
+const PanDemo: React.FC = () => (
+  <div style={{ display: 'flex', gap: 22, alignItems: 'center' }}>
+    <PanKnob size={84} defaultValue={0} color="#4cc2ff" aria-label="Pan center" />
+    <PanKnob size={84} defaultValue={-30} color="#3df2ad" label="Track 2" aria-label="Pan left" />
+  </div>
+);
+
+const LightThemeDemo: React.FC = () => {
+  const [play, setPlay] = React.useState(false);
+  const [mute, setMute] = React.useState(true);
+  return (
+    <DreamknobProvider base="light" theme={{ accent: '#0868c8' }}>
+      <div
+        style={{
+          background: '#eceef2',
+          borderRadius: 12,
+          padding: 18,
+          display: 'flex',
+          flexDirection: 'column',
+          gap: 16,
+          alignItems: 'center',
+        }}
+      >
+        <div style={{ display: 'flex', gap: 18, alignItems: 'center' }}>
+          <LEDKnob size={74} min={20} max={2000} defaultValue={440} taper={logTaper} label="Freq" unit="Hz" aria-label="Light freq" />
+          <SegmentDisplay value={128.4} digits={4} decimals={1} height={22} />
+          <Meter value={[62, 44]} min={0} max={100} length={92} breadth={14} aria-label="Light meter" />
+        </div>
+        <div style={{ display: 'flex', gap: 10, alignItems: 'center' }}>
+          <PushButton pressed={mute} onChange={setMute} color="#d92546" size={32} aria-label="Mute">
+            Mute
+          </PushButton>
+          <Button color="#0868c8" size={32} onClick={() => undefined} aria-label="Apply">
+            Apply
+          </Button>
+          <TransportButton kind="play" active={play} onClick={() => setPlay(p => !p)} size={32} />
+          <SegmentSwitch options={['LP', 'BP', 'HP']} defaultValue={1} aria-label="Light filter" />
+        </div>
+      </div>
+    </DreamknobProvider>
+  );
+};
+
 const ImageKnobDemo: React.FC = () => {
  const src = useGeneratedStrip();
  if (!src) return null;
@ -505,10 +601,18 @@ export const Gallery: React.FC = () => (
          </div>
        </Card>

+        <Card title="Light theme" desc="base='light' adapts the whole panel — LED wells go transparent so readouts and meters read as flat segments, and the buttons/switches become light raised chrome instead of dark chips." tag="<DreamknobProvider base='light' />">
+          <LightThemeDemo />
+        </Card>
+
        <Card title="Meters" desc="Stereo metering from one component (value={[l, r]}), or a full labeled bridge with per-channel peak text. Click the clip LED to clear it." tag="<Meter /> · <MeterBridge />">
          <MeterDemo />
        </Card>

+        <Card title="dBFS meter" desc="The same <Meter>, in dB mode: feed linear amplitude and it shows dBFS with PPM ballistics, a peak-decay tail, reference lines and a windowed loudness readout." tag="<Meter scale='db' ballistics integrated />">
+          <DbMeterDemo />
+        </Card>
+
        <Card title="Lamps & switches" desc="A segmented option switch, pressable indicator lamps (blink included) and a corner-dot button — the whole panel family." tag="<SegmentSwitch /> · <IndicatorLamp />">
          <LampSwitchDemo />
        </Card>
@ -536,6 +640,10 @@ export const Gallery: React.FC = () => (
          <PanelDemo />
        </Card>

+        <Card title="Pan" desc="Bipolar stereo pan: fills from center, snaps to a center detent, and reads out L/C/R." tag="<PanKnob />">
+          <PanDemo />
+        </Card>
+
        <Card title="Gradient arc" desc="Position-anchored gradient — the red zone stays at the top of travel." tag="<Arc gradient={...} />">
          <Knob size={96} min={-60} max={6} step={0.5} defaultValue={-8} aria-label="Gradient arc demo">
            <Arc
--- a/apps/docs/src/sections/GettingStarted.tsx
+++ b/apps/docs/src/sections/GettingStarted.tsx
@ -30,12 +30,12 @@ export const GettingStarted: React.FC = () => (

      <Step n={1} title="Install">
        <CodeBlock
-          code={`pnpm add https://git.dreamodus.software/Dreamodus/DreamKnob/releases/download/v1.1.1/dreamknob-1.1.1.tgz\n# (or npm install <same url>)  ·  peer deps: react >= 18, react-dom >= 18`}
+          code={`pnpm add https://git.dreamodus.software/Dreamodus/DreamKnob/releases/download/v1.1.4/dreamknob-1.1.4.tgz\n# (or npm install <same url>)  ·  peer deps: react >= 18, react-dom >= 18`}
        />
        <p className="api-note" style={{ marginTop: 10 }}>
          Installs straight from the{' '}
          <a href="https://git.dreamodus.software/Dreamodus/DreamKnob/releases">
-            v1.1.1 release
+            v1.1.4 release
          </a>{' '}
          on our Forgejo. Zero runtime dependencies, ESM + CJS, full TypeScript types. No
          CSS file to import — everything is SVG and inline styles.
--- a/apps/docs/src/sections/Hero.tsx
+++ b/apps/docs/src/sections/Hero.tsx
@ -25,10 +25,10 @@ export const Hero: React.FC = () => {
          range, any decimal precision, and colors you fully control.
        </p>
        <div className="install">
-          <span>pnpm add https://git.dreamodus.software/Dreamodus/DreamKnob/releases/download/v1.1.1/dreamknob-1.1.1.tgz</span>
+          <span>pnpm add https://git.dreamodus.software/Dreamodus/DreamKnob/releases/download/v1.1.4/dreamknob-1.1.4.tgz</span>
          <button
            onClick={() => {
-              navigator.clipboard.writeText('pnpm add https://git.dreamodus.software/Dreamodus/DreamKnob/releases/download/v1.1.1/dreamknob-1.1.1.tgz');
+              navigator.clipboard.writeText('pnpm add https://git.dreamodus.software/Dreamodus/DreamKnob/releases/download/v1.1.4/dreamknob-1.1.4.tgz');
              setCopied(true);
              setTimeout(() => setCopied(false), 1400);
            }}
--- a/apps/docs/src/styles.css
+++ b/apps/docs/src/styles.css
@ -353,6 +353,76 @@ h2.section-title {
  text-transform: uppercase;
 }

+/* Buttons section: decision guide + live demo grid */
+.guide-grid {
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+  margin: 8px 0 28px;
+  border-radius: 12px;
+  overflow: hidden;
+  border: 1px solid var(--line);
+  background: var(--line);
+}
+.guide-row {
+  display: grid;
+  grid-template-columns: 190px 1fr;
+  gap: 4px 18px;
+  align-items: baseline;
+  padding: 12px 16px;
+  background: #101219;
+}
+.guide-code {
+  font-family: var(--font-mono);
+  font-size: 13px;
+  color: #4cc2ff;
+}
+.guide-when {
+  font-size: 14px;
+  color: var(--text);
+}
+.guide-eg {
+  grid-column: 2;
+  font-size: 12.5px;
+  color: var(--text-dim);
+}
+.btn-demo {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
+  gap: 12px;
+}
+.btn-demo-cell {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+  padding: 18px;
+  border-radius: 12px;
+  background: linear-gradient(180deg, #16181f, #0e0f14);
+  border: 1px solid var(--line-strong);
+}
+.btn-demo-label {
+  font-family: var(--font-mono);
+  font-size: 11px;
+  letter-spacing: 0.08em;
+  color: var(--text-dim);
+  text-transform: uppercase;
+}
+.btn-demo-row {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+  min-height: 40px;
+}
+@media (max-width: 560px) {
+  .guide-row {
+    grid-template-columns: 1fr;
+  }
+  .guide-eg {
+    grid-column: 1;
+  }
+}
+
 /* ---- synth panel ---- */
 .synth-rows {
  display: flex;
--- a/packages/dreamknob/CHANGELOG.md
+++ b/packages/dreamknob/CHANGELOG.md
@ -1,5 +1,101 @@
 # Changelog

+## 1.1.4 — 2026-07-14
+
+Light-theme support — the controls whose chrome was hardcoded dark now adapt.
+
+### Themeable LED well
+- **`ledWell` theme token** — the recessed "screen" fill behind the LED
+  segments of `LEDKnob`, `LEDFader`, `Meter`, and the default well of
+  `SegmentDisplay` / `AlphaDisplay`, now comes from the theme instead of a
+  hardcoded near-black. Dark base keeps the classic dark well (`#0b0d0e`); the
+  **light base is `transparent`**, so LED controls and readouts render as clean
+  flat segment rings / bar meters / digits on the light panel (still clearly
+  "LED" from the lit segments) instead of dark blobs. The `faceColor` /
+  `background` props still override per-instance.
+
+### Light-theme panel chrome
+- **`scheme` theme token** (`'dark' | 'light'`, set by the `base`) drives the
+  raised gradient/border/shadow of `PushButton` (and `Button`),
+  `TransportButton` and `SegmentSwitch`. On a light base they render as light
+  raised buttons instead of dark chips; unlit LED pips flip to a faint dark so
+  they still read. New `panelButtonChrome(scheme, pressed)` helper.
+- Fixes the whole panel-button/switch family looking like dark chips on light
+  themes; the flat knobs and faders already adapted (their face is the `face`
+  token).
+
+## 1.1.3 — 2026-07-14
+
+Fourth integration-feedback release — a composability fix for buttons, a much
+smarter meter, and the pan control the mixer was missing.
+
+### Buttons
+- **Action buttons no longer show an LED by default.** `Button` (and
+  `PushButton mode="action"`) are plain by default — an action has no state to
+  indicate. `led` defaults to `'strip'` for `toggle`/`momentary` (which do have
+  a state) and to `false` for `action`; pass `led="dot"` / `led="strip"` to opt
+  a command button back in.
+
+### Buttons compose as Radix triggers
+- `PushButton` / `Button` now forward unknown props (`...rest`) to the
+  underlying `<button>` and **compose** their own event handlers with any the
+  consumer (or a Radix `asChild` slot) injects. A `Button` can now be a
+  dropdown / tooltip / popover trigger: `onPointerDown`, `onKeyDown`,
+  `data-state`, `aria-expanded` etc. all reach the DOM and fire alongside the
+  button's own press behavior. The prop types now extend the native button
+  attributes.
+
+### Meter — ballistics, dBFS, loudness
+- **`ballistics`** — PPM-style attack/decay smoothing of the displayed level
+  (`true` ≈ 5 ms attack / 350 ms decay, or `{ attack, decay }` in ms).
+- **`peakDecay`** — the peak-hold marker falls with a decay tail (normalized
+  units/second) after `peakHold` instead of snapping back.
+- **`scale="db"`** — feed linear amplitude (0..1) and the meter displays dBFS;
+  `min`/`max` default to -60 / 0 dB and faint reference gridlines are drawn
+  (`showScale` / `referenceTicks` to tune). New `ampToDb` / `dbToAmp` helpers.
+- **`integrated`** — a time-windowed loudness estimate (LUFS-ish on the dB
+  scale — a windowed mean of channel power, not a full BS.1770 measurement),
+  shown as a secondary readout and a marker line (`integrationWindow`,
+  `loudnessColor`).
+- All of the above are opt-in; the default meter behaves exactly as before.
+
+### New component
+- **`PanKnob`** — a bipolar stereo-pan knob: fills from center, snaps to a
+  center detent, reads out `L<n>` / `C` / `R<n>`. Defaults to a −50…50 range
+  centered at 0.
+
+## 1.1.2 — 2026-07-14
+
+Third integration-feedback release — a general action button, responsive
+faders everywhere, and the label-scaling gap, all surfaced building a
+resizable streaming studio.
+
+### New components
+- `Button` — a normal **click-to-fire** command button in the panel style
+  (Regenerate, Add, Apply, Refresh), the non-latching sibling of `PushButton`.
+  It's `PushButton` locked to the new `mode="action"`: never latches, shows a
+  press-down + a brief LED flash, calls `onClick`. `led="dot"` (default) gives
+  the corner-dot look; `led={false}` a plain button.
+
+### Buttons
+- `PushButton` gains **`mode="action"`** (alongside `toggle`/`momentary`) and
+  an `onClick` prop — the stateless command-button behavior `Button` wraps.
+
+### Responsive faders
+- **`fill`** on `LEDFader` (matching `Fader`) — the fader stretches along its
+  travel axis to fill the container instead of a fixed `length`, so faders in
+  resizable dock panels size themselves with no wrapper measurement.
+
+### Label scaling
+- **`labelSize`** on `IndicatorLamp` — the caption otherwise tracks `size` but
+  is floored at 10px; set this to shrink it with a small lamp (e.g. matching a
+  dense header row). Also on `LampRow` for parity.
+
+### Docs
+- A dedicated **Buttons & switches** section with a "which do I use?" guide
+  (Button = action · PushButton = latch · TransportButton = transport ·
+  ToggleSwitch = boolean · SegmentSwitch = mode) and a live demo of each.
+
 ## 1.1.1 — 2026-07-13

 Second integration-feedback release — the friction that showed up once the
--- a/packages/dreamknob/README.md
+++ b/packages/dreamknob/README.md
@ -5,7 +5,7 @@ headless core, any number range, any decimal precision, and colors you fully con
 Zero runtime dependencies.

 ```
-pnpm add https://git.dreamodus.software/Dreamodus/DreamKnob/releases/download/v1.1.1/dreamknob-1.1.1.tgz
+pnpm add https://git.dreamodus.software/Dreamodus/DreamKnob/releases/download/v1.1.4/dreamknob-1.1.4.tgz
 ```

 (Latest release tarballs: https://git.dreamodus.software/Dreamodus/DreamKnob/releases)
@ -95,14 +95,16 @@ import {
  LEDKnob,      // segmented LED ring + true seven-segment readout
  NeonKnob,     // glowing arc for dark UIs
  SteppedKnob,  // detented selector (positions={['LP','BP','HP']})
+  PanKnob,      // bipolar stereo pan — center detent, L<n>/C/R<n> readout
  Fader,        // linear channel fader, vertical or horizontal
  LEDFader,     // segmented LED meter-fader with color zones
  ImageKnob,    // film-strip sprite knob (KnobMan-style PNG strips)
-  Meter,        // read-only LED level meter — mono or multi-channel (value={[l, r]})
+  Meter,        // LED level meter — multi-channel, PPM ballistics, dBFS scale, loudness
  MeterBridge,  // labeled multi-strip meter block with per-channel peak text
  Gauge,        // read-only radial arc meter (round sibling of Meter) for CPU/RAM/load
  XYPad,        // two-parameter pad (cutoff/resonance, vector mixing)
-  PushButton,   // panel button with LED strip or corner dot (toggle or momentary)
+  PushButton,   // latch/hold panel button — LED strip or corner dot (toggle/momentary)
+  Button,         // click-to-fire command button (no LED by default; led="dot" opt-in)
  IndicatorLamp,  // pressable LED lamp — the hardware checkbox (blink, momentary)
  LampRow,        // row of indicator lamps with console-print captions
  ToggleSwitch,   // rocker/slider boolean — the knob slides OFF↔ON
@ -118,7 +120,10 @@ import {

 Knob skins also take `sublabel` (a second caption line) and `labelSize` (caption
 size independent of the dial); `Meter` and `Fader` take `fill` to stretch to their
-container.
+container. `Meter` adds `ballistics` (PPM attack/decay), `peakDecay`, `scale="db"`
+(feed amplitude, show dBFS) and `integrated` (windowed loudness) — all opt-in.
+`PushButton`/`Button` forward native button props and compose handlers, so a
+`Button` works as a Radix `asChild` trigger.

 ## Theming

@ -132,7 +137,9 @@ import { DreamknobProvider } from 'dreamknob'

 `base="light"` swaps in light-background defaults. Tokens: `accent`, `track`, `face`,
 `text`, `label`, `ticks`, `focusRing`, `zoneGood`/`zoneWarn`/`zoneHot` (meter zones),
-`ledGreen`/`ledAmber` (display defaults), `panel` (rack chrome), `fontMono`, `fontUI`.
+`ledGreen`/`ledAmber` (display defaults), `panel` (rack chrome), `ledWell` (LED display
+well — transparent on the light base), `fontMono`, `fontUI`. `scheme` (`'dark'|'light'`)
+is set by `base` and drives the panel-button/switch chrome; you rarely set it directly.

 Every knob skin and fader takes the core props plus `size`, `label`, `showValue`,
 `unit`, `format`, and per-part color props (`color`, `trackColor`, `faceColor`,
--- a/packages/dreamknob/package.json
+++ b/packages/dreamknob/package.json
@ -1,6 +1,6 @@
 {
  "name": "dreamknob",
-  "version": "1.1.1",
+  "version": "1.1.4",
  "description": "A feature-full, studio-grade React knob & fader library. Rotary, linear, 2D, 3D, digital and analog styles with a headless core.",
  "license": "MIT",
  "author": "Dreamodus Software Inc.",
--- a/packages/dreamknob/src/core/theme.tsx
+++ b/packages/dreamknob/src/core/theme.tsx
@ -40,10 +40,58 @@ export interface KnobTheme {
  ledAmber: string;
  /** Panel/rack chrome background (`Rack`, panel containers). */
  panel: string;
+  /**
+   * The "well" behind LED displays — the recessed screen of `LEDKnob`,
+   * `LEDFader`, `Meter` and the default panel of `SegmentDisplay` /
+   * `AlphaDisplay`. Dark base keeps the classic near-black well (`#0b0d0e`) so
+   * lit segments read as glowing; the light base is `transparent`, so LED
+   * controls and readouts render as clean flat segment rings / bar meters /
+   * digits on the light panel instead of dark blobs. Per-instance
+   * `faceColor` / `background` props still override it.
+   */
+  ledWell: string;
+  /**
+   * Which base this theme derives from. Panel chrome that can't be expressed
+   * as a single token — the raised gradient/border/shadow of `PushButton`,
+   * `TransportButton`, `SegmentSwitch` — switches between dark and light
+   * treatments on this. Set automatically by the `base`; overrides rarely
+   * need to touch it.
+   */
+  scheme: 'dark' | 'light';
  fontMono: string;
  fontUI: string;
 }

+/** Raised panel-button chrome (background gradient, border, inset/drop shadow)
+ *  for the current scheme — shared by PushButton, TransportButton and the
+ *  SegmentSwitch container so they stay consistent and adapt to light themes
+ *  instead of being hardcoded dark chips. */
+export function panelButtonChrome(
+  scheme: 'dark' | 'light',
+  pressed: boolean,
+): { background: string; border: string; boxShadow: string } {
+  if (scheme === 'light') {
+    return {
+      border: '1px solid rgba(0,0,0,0.16)',
+      background: pressed
+        ? 'linear-gradient(180deg, #d9dbe0, #e9eaee)'
+        : 'linear-gradient(180deg, #ffffff, #e7e8ec)',
+      boxShadow: pressed
+        ? 'inset 0 2px 4px rgba(0,0,0,0.16)'
+        : 'inset 0 1px 0 rgba(255,255,255,0.9), 0 1px 2px rgba(0,0,0,0.13)',
+    };
+  }
+  return {
+    border: '1px solid rgba(0,0,0,0.7)',
+    background: pressed
+      ? 'linear-gradient(180deg, #17181d, #232429)'
+      : 'linear-gradient(180deg, #35363d, #1d1e24)',
+    boxShadow: pressed
+      ? 'inset 0 2px 5px rgba(0,0,0,0.65)'
+      : 'inset 0 1px 0 rgba(255,255,255,0.09), 0 2px 4px rgba(0,0,0,0.45)',
+  };
+}
+
 export const darkTheme: KnobTheme = {
  track: 'rgba(255,255,255,0.12)',
  face: 'rgba(255,255,255,0.05)',
@ -57,6 +105,8 @@ export const darkTheme: KnobTheme = {
  ledGreen: '#3df2ad',
  ledAmber: '#ffb84d',
  panel: 'rgba(255,255,255,0.03)',
+  ledWell: '#0b0d0e',
+  scheme: 'dark',
  fontMono: MONO_FONT,
  fontUI: UI_FONT,
 };
@ -74,6 +124,8 @@ export const lightTheme: KnobTheme = {
  ledGreen: '#0fa571',
  ledAmber: '#b26a00',
  panel: 'rgba(0,0,0,0.04)',
+  ledWell: 'transparent',
+  scheme: 'light',
  fontMono: MONO_FONT,
  fontUI: UI_FONT,
 };
--- a/packages/dreamknob/src/digital/AlphaDisplay.tsx
+++ b/packages/dreamknob/src/digital/AlphaDisplay.tsx
@ -145,7 +145,7 @@ export const AlphaDisplay: React.FC<AlphaDisplayProps> = ({
  color,
  weight = 1,
  gap = DEFAULT_GAP,
-  background = '#0a0d0c',
+  background: backgroundProp,
  ghostOpacity = 0.08,
  skew = 6,
  glow = 1.4,
@ -156,6 +156,9 @@ export const AlphaDisplay: React.FC<AlphaDisplayProps> = ({
 }) => {
  const theme = useKnobTheme();
  const lit = color ?? theme.ledAmber;
+  // Default the display well to the theme's ledWell (transparent on the light
+  // base) so readouts adapt to light themes.
+  const background = backgroundProp ?? theme.ledWell ?? '#0a0d0c';
  const filterId = React.useId();
  const half = BASE_HALF * weight;
  const POLY = buildPoly(half);
--- a/packages/dreamknob/src/digital/SegmentDisplay.tsx
+++ b/packages/dreamknob/src/digital/SegmentDisplay.tsx
@ -57,7 +57,7 @@ export const SegmentDisplay: React.FC<SegmentDisplayProps> = ({
  zones,
  weight = 1,
  gap,
-  background = '#0a0d0c',
+  background: backgroundProp,
  ghostOpacity = 0.09,
  skew = 6,
  glow = 1.6,
@ -67,6 +67,9 @@ export const SegmentDisplay: React.FC<SegmentDisplayProps> = ({
  style,
 }) => {
  const theme = useKnobTheme();
+  // Default the display well to the theme's ledWell (dark base = dark well,
+  // light base = transparent) so readouts adapt to light themes.
+  const background = backgroundProp ?? theme.ledWell ?? '#0a0d0c';
  const filterId = React.useId();
  const numeric = typeof value === 'number' ? value : NaN;
  const resolved =
--- a/packages/dreamknob/src/index.ts
+++ b/packages/dreamknob/src/index.ts
@ -64,13 +64,15 @@ export { VintageKnob, type VintageKnobProps } from './skins/VintageKnob';
 export { LEDKnob, type LEDKnobProps } from './skins/LEDKnob';
 export { NeonKnob, type NeonKnobProps } from './skins/NeonKnob';
 export { SteppedKnob, type SteppedKnobProps } from './skins/SteppedKnob';
+export { PanKnob, type PanKnobProps } from './skins/PanKnob';
 export { Fader, type FaderProps } from './skins/Fader';
 export { LEDFader, type LEDFaderProps, type LEDFaderZone } from './skins/LEDFader';
 export { ImageKnob, type ImageKnobProps } from './skins/ImageKnob';
 export { Meter, type MeterProps } from './skins/Meter';
+export { ampToDb, dbToAmp, type Ballistics } from './skins/meterEngine';
 export { MeterBridge, type MeterBridgeProps, type MeterBridgeChannel } from './skins/MeterBridge';
 export { Gauge, type GaugeProps } from './skins/Gauge';
-export { PushButton, type PushButtonProps } from './skins/PushButton';
+export { PushButton, type PushButtonProps, Button, type ButtonProps } from './skins/PushButton';
 export { IndicatorLamp, type IndicatorLampProps } from './skins/IndicatorLamp';
 export { LampRow, type LampRowProps, type LampRowItem } from './skins/LampRow';
 export { ToggleSwitch, type ToggleSwitchProps } from './skins/ToggleSwitch';
--- a/packages/dreamknob/src/skins/IndicatorLamp.tsx
+++ b/packages/dreamknob/src/skins/IndicatorLamp.tsx
@ -19,6 +19,12 @@ export interface IndicatorLampProps {
  readOnly?: boolean;
  /** Caption beside the lamp. */
  label?: string;
+  /**
+   * Caption font size in px, independent of the lamp diameter. Without it the
+   * label tracks `size` but is floored at 10px; set this to shrink the caption
+   * with a small lamp (e.g. matching a dense header row's height).
+   */
+  labelSize?: number;
  labelPosition?: 'right' | 'left';
  disabled?: boolean;
  /** Render a hidden form input carrying "on"/"off". */
@ -45,6 +51,7 @@ export const IndicatorLamp = React.forwardRef<HTMLButtonElement, IndicatorLampPr
      blink = false,
      readOnly = false,
      label,
+      labelSize,
      labelPosition = 'right',
      disabled = false,
      name,
@ -166,7 +173,7 @@ export const IndicatorLamp = React.forwardRef<HTMLButtonElement, IndicatorLampPr
          <span
            style={{
              fontFamily: theme.fontUI,
-              fontSize: Math.max(10, size * 0.9),
+              fontSize: labelSize ?? Math.max(10, size * 0.9),
              letterSpacing: '0.07em',
              textTransform: 'uppercase',
              color: lit ? theme.text : theme.label,
--- a/packages/dreamknob/src/skins/LEDFader.tsx
+++ b/packages/dreamknob/src/skins/LEDFader.tsx
@ -15,6 +15,13 @@ export interface LEDFaderProps extends Omit<KnobCoreProps, 'interaction'> {
  orientation?: 'vertical' | 'horizontal';
  /** Travel length in px. Default: 160. */
  length?: number;
+  /**
+   * Stretch along the travel axis to fill the container (horizontal fills
+   * width, vertical fills height) instead of a fixed `length` — the same
+   * responsive behavior as `Fader`, so faders in resizable dock panels size
+   * themselves instead of needing wrapper measurement.
+   */
+  fill?: boolean;
  /** Cross-axis size in px. Default: 34. */
  breadth?: number;
  /** Number of LED segments. Default: 24. */
@ -57,13 +64,14 @@ export interface LEDFaderProps extends Omit<KnobCoreProps, 'interaction'> {
 export const LEDFader = React.forwardRef<HTMLDivElement, LEDFaderProps>(function LEDFader({
  orientation = 'vertical',
  length = 160,
+  fill = false,
  breadth = 34,
  segments = 24,
  color: colorProp,
  zones,
  offOpacity = 0.13,
  glow = true,
-  faceColor = '#0b0d0e',
+  faceColor: faceColorProp,
  focusRing,
  label,
  showValue = true,
@ -81,6 +89,7 @@ export const LEDFader = React.forwardRef<HTMLDivElement, LEDFaderProps>(function
  const [editing, setEditing] = React.useState(false);
  const theme = useKnobTheme();
  const color = colorProp ?? theme.accent;
+  const faceColor = faceColorProp ?? theme.ledWell ?? '#0b0d0e';
  const ring = focusRing ?? theme.focusRing;
  const vertical = orientation === 'vertical';
  const pad = 5;
@ -95,6 +104,12 @@ export const LEDFader = React.forwardRef<HTMLDivElement, LEDFaderProps>(function

  const w = vertical ? breadth : length;
  const h = vertical ? length : breadth;
+  // Fill stretches the travel axis (via preserveAspectRatio='none'); the cross
+  // axis stays at `breadth`. The LED geometry is computed in the fixed viewBox
+  // and scaled to the element — pointer mapping measures the real element, so
+  // interaction stays correct at any rendered width.
+  const ctrlW = fill && !vertical ? '100%' : w;
+  const ctrlH = fill && vertical ? '100%' : h;
  const zoneList: readonly LEDFaderZone[] = React.useMemo(() => {
    if (zones) return [...zones].sort((a, b) => a.upTo - b.upTo);
    if (color) return [{ upTo: 1, color }];
@ -157,7 +172,8 @@ export const LEDFader = React.forwardRef<HTMLDivElement, LEDFaderProps>(function
        flexDirection: 'column',
        alignItems: 'center',
        gap: 6,
-        width: w,
+        width: fill && !vertical ? '100%' : w,
+        height: fill && vertical ? '100%' : undefined,
        opacity: core.disabled ? 0.45 : undefined,
        ...style,
      }}
@ -218,14 +234,21 @@ export const LEDFader = React.forwardRef<HTMLDivElement, LEDFaderProps>(function
        style={{
          ...knob.bind.style,
          opacity: undefined, // the outer wrapper owns disabled dimming
-          width: w,
-          height: h,
-          display: 'inline-flex',
+          width: ctrlW,
+          height: ctrlH,
+          display: fill ? 'flex' : 'inline-flex',
          borderRadius: 6,
          ...(knob.isFocusVisible && ring ? { boxShadow: `0 0 0 2px ${ring}` } : undefined),
        }}
      >
-        <svg width={w} height={h} viewBox={`0 0 ${w} ${h}`} style={{ display: 'block' }} aria-hidden="true">
+        <svg
+          width={ctrlW}
+          height={ctrlH}
+          viewBox={`0 0 ${w} ${h}`}
+          preserveAspectRatio={fill ? 'none' : undefined}
+          style={{ display: 'block' }}
+          aria-hidden="true"
+        >
          <defs>
            <filter
              id={glowId}
--- a/packages/dreamknob/src/skins/LEDKnob.tsx
+++ b/packages/dreamknob/src/skins/LEDKnob.tsx
@ -90,7 +90,7 @@ export const LEDKnob = React.forwardRef<HTMLDivElement, LEDKnobProps>(function L
  digits = 3,
  displayDecimals,
  labelColor,
-  faceColor = '#0b0d0e',
+  faceColor: faceColorProp,
  label,
  sublabel,
  labelSize,
@ -102,6 +102,7 @@ export const LEDKnob = React.forwardRef<HTMLDivElement, LEDKnobProps>(function L
 }, ref) {
  const theme = useKnobTheme();
  const color = colorProp ?? theme.accent ?? '#3df2ad';
+  const faceColor = faceColorProp ?? theme.ledWell ?? '#0b0d0e';
  const id = React.useId();
  const glowId = `${id}-glow`;
  return (
--- a/packages/dreamknob/src/skins/LampRow.tsx
+++ b/packages/dreamknob/src/skins/LampRow.tsx
@ -11,6 +11,8 @@ export interface LampRowProps {
  lamps: readonly LampRowItem[];
  /** Lamp diameter in px. Default: 9. */
  size?: number;
+  /** Caption font size in px. Default: 9.5. */
+  labelSize?: number;
  /** Caption placement relative to each lamp. Default: 'right'. */
  labelPosition?: 'right' | 'below';
  /** Make lamps clickable (a compact indicator toggle bank). */
@ -31,6 +33,7 @@ export interface LampRowProps {
 export const LampRow: React.FC<LampRowProps> = ({
  lamps,
  size = 9,
+  labelSize,
  labelPosition = 'right',
  onToggle,
  gap = 14,
@ -80,7 +83,7 @@ export const LampRow: React.FC<LampRowProps> = ({
          <span
            style={{
              fontFamily: theme.fontUI,
-              fontSize: 9.5,
+              fontSize: labelSize ?? 9.5,
              fontWeight: 600,
              letterSpacing: '0.12em',
              textTransform: 'uppercase',
--- a/packages/dreamknob/src/skins/Meter.tsx
+++ b/packages/dreamknob/src/skins/Meter.tsx
@ -4,16 +4,25 @@ import type { Taper } from '../core/math';
 import { useKnobTheme } from '../core/theme';
 import type { LEDFaderZone } from './LEDFader';
 import { SegmentDisplay } from '../digital/SegmentDisplay';
+import { ampToDb, useMeterEngine, type Ballistics } from './meterEngine';

 export interface MeterProps {
  /**
   * Level to display — a single number, or an array for a multi-channel
-   * meter (e.g. `[l, r]` for stereo). The meter is read-only.
+   * meter (e.g. `[l, r]` for stereo). The meter is read-only. With
+   * `scale="db"` these are linear amplitudes (0..1); otherwise they are in the
+   * `min`..`max` domain directly.
   */
  value: number | readonly number[];
  min?: number;
  max?: number;
  taper?: Taper;
+  /**
+   * 'linear' (default) shows `value` in the `min`..`max` domain. 'db' treats
+   * `value`/`clipValue` as linear amplitude and displays dBFS; `min`/`max`
+   * then default to -60 / 0 dB.
+   */
+  scale?: 'linear' | 'db';
  orientation?: 'vertical' | 'horizontal';
  /** Travel length in px. Default: 160. */
  length?: number;
@ -35,16 +44,42 @@ export interface MeterProps {
  zones?: readonly LEDFaderZone[];
  /** Opacity of unlit segments. Default: 0.1. */
  offOpacity?: number;
+  /**
+   * Attack/decay ballistics — smooth the displayed level like a PPM meter.
+   * `true` uses ~5 ms attack / ~350 ms decay; pass `{ attack, decay }` (ms) to
+   * tune. Default: off (the level follows the value directly).
+   */
+  ballistics?: boolean | Ballistics;
  /**
   * Peak hold time in ms — the highest recent segment stays lit and falls
   * back after this long. `false` disables. Default: 1200.
   */
  peakHold?: number | false;
+  /**
+   * After `peakHold`, let the peak marker fall at this many normalized units
+   * per second (a decay tail) instead of snapping back. Requires the rAF
+   * engine (also enabled by `ballistics`/`integrated`).
+   */
+  peakDecay?: number;
  /** Peak indicator color. Defaults to the peak's zone color. */
  peakColor?: string;
+  /**
+   * Show a time-windowed loudness estimate (LUFS-ish on the 'db' scale — a
+   * mean of channel power over `integrationWindow`, not a full BS.1770
+   * measurement). Rendered as a small secondary readout + a marker line.
+   */
+  integrated?: boolean;
+  /** Loudness integration window in ms. Default: 3000. */
+  integrationWindow?: number;
+  /** Color for the integrated-loudness readout and marker line. */
+  loudnessColor?: string;
+  /** Faint reference gridlines across the meter. Default: on for scale='db'. */
+  showScale?: boolean;
+  /** Reference marks in the value domain. Defaults to dBFS marks for 'db'. */
+  referenceTicks?: readonly number[];
  /** Dedicated clip LED at the hot end (shared across channels). Default: true. */
  showClip?: boolean;
-  /** Value at/above which the clip LED lights. Default: `max`. */
+  /** Value (in the display domain — dB for scale='db') at/above which it lights. Default: `max`. */
  clipThreshold?: number;
  /**
   * Signal(s) used for clip detection when different from the displayed
@ -78,15 +113,20 @@ export interface MeterProps {
 const asArray = (v: number | readonly number[]): readonly number[] =>
  Array.isArray(v) ? v : [v as number];

+const DEFAULT_DB_TICKS = [0, -6, -12, -18, -24, -36, -48];
+
 /**
 * Read-only LED level meter with peak hold and a latching clip LED — pass an
 * array of values for stereo/multi-channel bars sharing one clip indicator.
+ * Optional PPM ballistics, a peak-decay tail, a dBFS scale and a windowed
+ * loudness readout (all opt-in).
 */
 export const Meter: React.FC<MeterProps> = ({
  value,
-  min = 0,
-  max = 100,
+  min: minProp,
+  max: maxProp,
  taper = linearTaper,
+  scale = 'linear',
  orientation = 'vertical',
  length = 160,
  fill = false,
@ -96,15 +136,22 @@ export const Meter: React.FC<MeterProps> = ({
  color,
  zones,
  offOpacity = 0.1,
+  ballistics,
  peakHold = 1200,
+  peakDecay,
  peakColor,
+  integrated = false,
+  integrationWindow = 3000,
+  loudnessColor,
+  showScale,
+  referenceTicks,
  showClip = true,
  clipThreshold,
  clipValue,
  clipHold = 1500,
  clipColor = '#ff2b39',
  onClip,
-  faceColor = '#0b0d0e',
+  faceColor: faceColorProp,
  label,
  showValue = false,
  digits = 4,
@ -116,27 +163,51 @@ export const Meter: React.FC<MeterProps> = ({
  ...aria
 }) => {
  const theme = useKnobTheme();
+  const faceColor = faceColorProp ?? theme.ledWell ?? '#0b0d0e';
  const vertical = orientation === 'vertical';
+  const dbScale = scale === 'db';
+  const min = minProp ?? (dbScale ? -60 : 0);
+  const max = maxProp ?? (dbScale ? 0 : 100);
+
  const values = asArray(value);
  const channels = values.length;
-  const ns = values.map(v => clamp(taper.toNormalized(clamp(v, min, max), min, max), 0, 1));
+  // Value-domain per channel (dB for scale='db', else the value itself).
+  const domain = values.map(v => (dbScale ? ampToDb(v) : v));
+  const targetNs = domain.map(d => clamp(taper.toNormalized(clamp(d, min, max), min, max), 0, 1));

-  // Peaks: per channel, falling back together after `peakHold` ms of no rise.
-  const [peaks, setPeaks] = React.useState<readonly number[]>(ns);
+  // rAF engine (ballistics / peak-decay / loudness). Null on the legacy path.
+  const animated = !!ballistics || peakDecay != null || integrated;
+  const engine = useMeterEngine(targetNs, domain, {
+    enabled: animated,
+    ballistics,
+    peakHold,
+    peakDecay: peakDecay ?? null,
+    integrated,
+    integrationWindow,
+    scale,
+  });
+  const levels = animated && engine ? engine.levels : targetNs;
+
+  // Legacy timer-based peaks (only when the engine is off).
+  const [legacyPeaks, setLegacyPeaks] = React.useState<readonly number[]>(targetNs);
  React.useEffect(() => {
-    if (peakHold === false) return;
-    setPeaks(prev => {
-      const rose = ns.map((n, i) => n >= (prev[i] ?? 0));
-      if (rose.every(Boolean) || prev.length !== ns.length) return ns.map((n, i) => Math.max(n, prev[i] ?? 0));
-      return prev.map((p, i) => Math.max(p, ns[i] ?? 0));
+    if (animated || peakHold === false) return;
+    setLegacyPeaks(prev => {
+      const rose = targetNs.map((n, i) => n >= (prev[i] ?? 0));
+      if (rose.every(Boolean) || prev.length !== targetNs.length)
+        return targetNs.map((n, i) => Math.max(n, prev[i] ?? 0));
+      return prev.map((p, i) => Math.max(p, targetNs[i] ?? 0));
    });
-    const t = setTimeout(() => setPeaks(ns), peakHold);
+    const t = setTimeout(() => setLegacyPeaks(targetNs), peakHold);
    return () => clearTimeout(t);
    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [JSON.stringify(ns), peakHold]);
+  }, [JSON.stringify(targetNs), peakHold, animated]);
+  const peaks = animated && engine ? engine.peaks : legacyPeaks;

  // Clip: latch when any channel's raw (unclamped) signal reaches threshold.
-  const clipSignals = clipValue !== undefined ? asArray(clipValue) : values;
+  const clipSignals = (clipValue !== undefined ? asArray(clipValue) : values).map(v =>
+    dbScale ? ampToDb(v) : v,
+  );
  const hottest = Math.max(...clipSignals);
  const [clipped, setClipped] = React.useState(false);
  const clipTimer = React.useRef<ReturnType<typeof setTimeout>>();
@ -182,14 +253,20 @@ export const Meter: React.FC<MeterProps> = ({

  const clipLed = 7;
  const clipSpan = showClip ? clipLed + 3 : 0;
-  const slot = Math.max(1, (along - pad * 2 - clipSpan) / segments);
+  const innerLen = along - pad * 2 - clipSpan;
+  const slot = Math.max(1, innerLen / segments);
  const gap = Math.min(2.5, slot * 0.35);
  const segSize = Math.max(0.5, slot - gap);

+  // Position (px along the travel axis) of a normalized value, measured from
+  // the cold end.
+  const posOf = (nrm: number) =>
+    vertical ? along - pad - nrm * innerLen : pad + nrm * innerLen;
+
  const bars: React.ReactNode[] = [];
  for (let c = 0; c < channels; c++) {
    const offset = c * (breadth + chGap) + pad;
-    const lit = Math.round((ns[c] ?? 0) * segments);
+    const lit = Math.round((levels[c] ?? 0) * segments);
    const peakIdx =
      peakHold !== false && (peaks[c] ?? 0) > 0
        ? Math.min(segments - 1, Math.ceil((peaks[c] ?? 0) * segments) - 1)
@ -198,8 +275,8 @@ export const Meter: React.FC<MeterProps> = ({
      const zone = zoneFor((i + 1) / segments);
      const isPeak = i === peakIdx && i >= lit;
      const on = i < lit || isPeak;
-      const fill = isPeak ? (peakColor ?? zone) : zone;
-      const common = { rx: 1.2, fill, opacity: on ? 1 : offOpacity };
+      const barFill = isPeak ? (peakColor ?? zone) : zone;
+      const common = { rx: 1.2, fill: barFill, opacity: on ? 1 : offOpacity };
      bars.push(
        vertical ? (
          <rect
@ -224,7 +301,43 @@ export const Meter: React.FC<MeterProps> = ({
    }
  }

-  const hottestShown = Math.max(...values.map(v => clamp(v, min, max)));
+  // Reference gridlines (value domain -> position across the bar area).
+  const ticks = referenceTicks ?? (dbScale ? DEFAULT_DB_TICKS : []);
+  const drawScale = (showScale ?? dbScale) && ticks.length > 0;
+  const scaleLines: React.ReactNode[] = [];
+  if (drawScale) {
+    for (const tv of ticks) {
+      if (tv < min || tv > max) continue;
+      const nrm = clamp(taper.toNormalized(clamp(tv, min, max), min, max), 0, 1);
+      const p = posOf(nrm);
+      scaleLines.push(
+        vertical ? (
+          <line key={`s${tv}`} x1={pad} y1={p} x2={w - pad} y2={p} stroke="rgba(255,255,255,0.14)" strokeWidth={0.6} strokeDasharray="2 2" />
+        ) : (
+          <line key={`s${tv}`} x1={p} y1={pad} x2={p} y2={h - pad} stroke="rgba(255,255,255,0.14)" strokeWidth={0.6} strokeDasharray="2 2" />
+        ),
+      );
+    }
+  }
+
+  // Integrated-loudness marker line.
+  const loud = loudnessColor ?? theme.zoneWarn;
+  let loudnessLine: React.ReactNode = null;
+  if (integrated && engine && engine.integrated != null && Number.isFinite(engine.integrated)) {
+    const nrm = clamp(taper.toNormalized(clamp(engine.integrated, min, max), min, max), 0, 1);
+    if (nrm > 0.001) {
+      const p = posOf(nrm);
+      loudnessLine = vertical ? (
+        <line x1={pad} y1={p} x2={w - pad} y2={p} stroke={loud} strokeWidth={1.4} />
+      ) : (
+        <line x1={p} y1={pad} x2={p} y2={h - pad} stroke={loud} strokeWidth={1.4} />
+      );
+    }
+  }
+
+  const shownDomain = domain.length ? domain.map(d => clamp(d, min, max)) : [min];
+  const hottestShown = Math.max(...shownDomain);
+  const readoutColor = zoneFor(Math.max(...levels, 0));

  return (
    <div
@ -247,21 +360,43 @@ export const Meter: React.FC<MeterProps> = ({
        ...style,
      }}
    >
-      {showValue && (
-        <div style={{ width: '100%', display: 'flex', justifyContent: 'center', alignItems: 'baseline', gap: 4 }}>
-          <SegmentDisplay
-            value={hottestShown}
-            digits={digits}
-            decimals={displayDecimals}
-            height={11}
-            color={zoneFor(Math.max(...ns))}
-            background="none"
-            ghostOpacity={0.06}
-          />
-          {unit && (
-            <span style={{ fontFamily: theme.fontMono, fontSize: 10, color: theme.label, whiteSpace: 'nowrap' }}>
-              {unit}
-            </span>
+      {(showValue || (integrated && engine && engine.integrated != null && Number.isFinite(engine.integrated))) && (
+        // Each readout is its own stack: the value with its unit centered
+        // directly underneath — peak above, loudness below.
+        <div style={{ display: 'flex', flexDirection: 'column', alignItems: 'center', gap: 6 }}>
+          {showValue && (
+            <div style={{ display: 'flex', flexDirection: 'column', alignItems: 'center', gap: 1 }}>
+              <SegmentDisplay
+                value={hottestShown}
+                digits={digits}
+                decimals={displayDecimals}
+                height={11}
+                color={readoutColor}
+                background="none"
+                ghostOpacity={0}
+              />
+              {unit && (
+                <span style={{ fontFamily: theme.fontMono, fontSize: 9, letterSpacing: '0.06em', color: theme.label, whiteSpace: 'nowrap' }}>
+                  {unit}
+                </span>
+              )}
+            </div>
+          )}
+          {integrated && engine && engine.integrated != null && Number.isFinite(engine.integrated) && (
+            <div style={{ display: 'flex', flexDirection: 'column', alignItems: 'center', gap: 1 }}>
+              <SegmentDisplay
+                value={clamp(engine.integrated, min, max)}
+                digits={digits}
+                decimals={displayDecimals}
+                height={9}
+                color={loud}
+                background="none"
+                ghostOpacity={0}
+              />
+              <span style={{ fontFamily: theme.fontMono, fontSize: 9, letterSpacing: '0.06em', color: theme.label, whiteSpace: 'nowrap' }}>
+                {dbScale ? 'LUFS' : 'AVG'}
+              </span>
+            </div>
          )}
        </div>
      )}
@ -274,7 +409,9 @@ export const Meter: React.FC<MeterProps> = ({
        aria-hidden="true"
      >
        <rect x={0.5} y={0.5} width={w - 1} height={h - 1} rx={4} fill={faceColor} stroke="rgba(255,255,255,0.09)" />
+        {scaleLines}
        {bars}
+        {loudnessLine}
        {showClip && (
          <rect
            data-part="clip"
--- a/packages/dreamknob/src/skins/PanKnob.tsx
+++ b/packages/dreamknob/src/skins/PanKnob.tsx
@ -0,0 +1,60 @@
+import * as React from 'react';
+import { FlatKnob, type FlatKnobProps } from './FlatKnob';
+
+export interface PanKnobProps extends Omit<FlatKnobProps, 'arcFrom'> {
+  /**
+   * Readout precision for the L/R amount. Default: 0 (whole numbers).
+   * The formatter shows `C` at center, `L<n>` left, `R<n>` right.
+   */
+  panDecimals?: number;
+}
+
+/**
+ * A stereo pan control — a bipolar knob that fills from the center, snaps to a
+ * center detent, and reads out `L<n>` / `C` / `R<n>`. Defaults to a −50…50
+ * range centered at 0; pass `min`/`max` for other conventions (e.g. −1…1).
+ */
+export const PanKnob = React.forwardRef<HTMLDivElement, PanKnobProps>(function PanKnob(
+  {
+    min = -50,
+    max = 50,
+    defaultValue,
+    origin,
+    detents,
+    detentSize,
+    format,
+    label = 'Pan',
+    panDecimals = 0,
+    ...rest
+  },
+  ref,
+) {
+  const center = (min + max) / 2;
+  const panFormat = React.useMemo(
+    () =>
+      format ??
+      ((v: number) => {
+        const amount = Math.abs(v - center);
+        if (amount < Math.pow(10, -panDecimals) / 2) return 'C';
+        const n = amount.toFixed(panDecimals);
+        return v < center ? `L${n}` : `R${n}`;
+      }),
+    [format, center, panDecimals],
+  );
+
+  return (
+    <FlatKnob
+      ref={ref}
+      arcFrom="center"
+      min={min}
+      max={max}
+      defaultValue={defaultValue ?? center}
+      origin={origin ?? center}
+      detents={detents ?? [center]}
+      detentSize={detentSize ?? 0.04}
+      format={panFormat}
+      label={label}
+      {...rest}
+    />
+  );
+});
--- a/packages/dreamknob/src/skins/PushButton.tsx
+++ b/packages/dreamknob/src/skins/PushButton.tsx
@ -1,19 +1,35 @@
 import * as React from 'react';
-import { useKnobTheme } from '../core/theme';
+import { panelButtonChrome, useKnobTheme } from '../core/theme';

-export interface PushButtonProps {
+/** Call every handler in order (skipping undefined) — for merging our own
+ * handlers with consumer/Radix-injected ones on the same event. */
+const chain =
+  <E,>(...fns: Array<((e: E) => void) | undefined>) =>
+  (e: E) => {
+    for (const fn of fns) if (typeof fn === 'function') fn(e);
+  };
+
+export interface PushButtonProps
+  extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'onClick'> {
  /** Controlled pressed state. Pair with `onChange`. */
  pressed?: boolean;
  defaultPressed?: boolean;
  onChange?: (pressed: boolean) => void;
-  /** 'toggle' latches; 'momentary' is only on while held. Default: 'toggle'. */
-  mode?: 'toggle' | 'momentary';
+  /**
+   * 'toggle' latches; 'momentary' is on only while held; 'action' is a normal
+   * click-to-fire command button — it never latches, shows a press-down + a
+   * brief LED flash, and calls `onClick`. Default: 'toggle'.
+   */
+  mode?: 'toggle' | 'momentary' | 'action';
+  /** Fired on activation in `action` mode (click, Enter, or Space). */
+  onClick?: () => void;
  /** LED / active color. */
  color?: string;
  /**
-   * LED style: 'strip' (default, above the caption), 'dot' (small corner
-   * dot — scales down better for icon-only toggles), or false for none.
-   * `true` is an alias for 'strip'.
+   * LED style: 'strip' (above the caption), 'dot' (small corner dot — scales
+   * down better for icon-only toggles), or false for none. `true` is an alias
+   * for 'strip'. Defaults to 'strip' for toggle/momentary (they indicate a
+   * state) and to false for `mode="action"` (a command has no state to show).
   */
  led?: boolean | 'strip' | 'dot';
  /** Button height in px. Default: 36. */
@ -29,7 +45,6 @@ export interface PushButtonProps {
  children?: React.ReactNode;
  className?: string;
  style?: React.CSSProperties;
-  'aria-label'?: string;
 }

 /** Studio panel button with an LED strip — mute/solo/bypass in matching style. */
@ -39,9 +54,10 @@ export const PushButton = React.forwardRef<HTMLButtonElement, PushButtonProps>(
      pressed,
      defaultPressed = false,
      onChange,
+      onClick,
      mode = 'toggle',
      color,
-      led = true,
+      led: ledProp,
      size = 36,
      width,
      disabled = false,
@ -50,25 +66,57 @@ export const PushButton = React.forwardRef<HTMLButtonElement, PushButtonProps>(
      children,
      className,
      style,
-      ...aria
+      ...rest
    },
    ref,
  ) {
    const theme = useKnobTheme();
    const accent = color ?? theme.accent ?? '#4cc2ff';
+    // The LED indicates a persistent/held state, so it defaults on for
+    // toggle/momentary but off for `action` (a command has no state).
+    const led = ledProp ?? (mode === 'action' ? false : true);
    const isControlled = pressed !== undefined;
    const [internal, setInternal] = React.useState(defaultPressed);
    const [focusVisible, setFocusVisible] = React.useState(false);
-    const on = isControlled ? (pressed as boolean) : internal;
+    // Action mode is stateless: a transient `held` (pointer down) drives the
+    // press-down look and a short `flash` lights the LED on activation.
+    const [held, setHeld] = React.useState(false);
+    const [flash, setFlash] = React.useState(false);
+    const flashTimer = React.useRef<ReturnType<typeof setTimeout>>();
+    React.useEffect(() => () => clearTimeout(flashTimer.current), []);
+    const latched = isControlled ? (pressed as boolean) : internal;
+    const on = mode === 'action' ? held : latched; // press-down / background inset
+    const ledOn = mode === 'action' ? held || flash : latched;
+    const chrome = panelButtonChrome(theme.scheme, on);
+    // Unlit LED tint: faint white on dark chrome, faint black on light.
+    const ledOff = theme.scheme === 'light' ? 'rgba(0,0,0,0.13)' : 'rgba(255,255,255,0.09)';

    const set = (next: boolean) => {
-      if (next === on) return;
+      if (next === latched) return;
      if (!isControlled) setInternal(next);
      onChange?.(next);
    };

+    const fire = () => {
+      onClick?.();
+      setFlash(true);
+      clearTimeout(flashTimer.current);
+      flashTimer.current = setTimeout(() => setFlash(false), 160);
+    };
+
    const momentaryProps =
-      mode === 'momentary'
+      mode === 'action'
+        ? {
+            onClick: fire,
+            onPointerDown: (e: React.PointerEvent) => {
+              e.currentTarget.setPointerCapture(e.pointerId);
+              setHeld(true);
+            },
+            onPointerUp: () => setHeld(false),
+            onPointerCancel: () => setHeld(false),
+            onPointerLeave: () => setHeld(false),
+          }
+        : mode === 'momentary'
        ? {
            onPointerDown: (e: React.PointerEvent) => {
              e.currentTarget.setPointerCapture(e.pointerId);
@ -83,27 +131,40 @@ export const PushButton = React.forwardRef<HTMLButtonElement, PushButtonProps>(
              if (e.key === ' ' || e.key === 'Enter') set(false);
            },
          }
-        : { onClick: () => set(!on) };
+        : { onClick: () => set(!latched) };
+
+    // Merge our own handlers with any consumer/Radix-injected ones of the same
+    // name (from {...rest}), so the button works as a Radix `asChild` trigger:
+    // the injected onPointerDown/onKeyDown/data-state/aria-* all reach the DOM.
+    const restHandlers = rest as Record<string, ((e: unknown) => void) | undefined>;
+    const composedHandlers = Object.fromEntries(
+      Object.entries(momentaryProps).map(([k, fn]) => [
+        k,
+        chain(restHandlers[k], fn as (e: unknown) => void),
+      ]),
+    );
+    const handleFocus = chain(restHandlers.onFocus, (e: React.FocusEvent<HTMLButtonElement>) => {
+      try {
+        setFocusVisible(e.currentTarget.matches(':focus-visible'));
+      } catch {
+        setFocusVisible(true);
+      }
+    });
+    const handleBlur = chain(restHandlers.onBlur, () => setFocusVisible(false));

    return (
      <button
+        {...rest}
        ref={ref}
        type="button"
        disabled={disabled}
-        aria-pressed={on}
-        aria-label={aria['aria-label']}
+        aria-pressed={mode === 'action' ? undefined : latched}
        data-pressed={on ? '' : undefined}
        data-focus-visible={focusVisible ? '' : undefined}
        className={className}
-        onFocus={e => {
-          try {
-            setFocusVisible(e.currentTarget.matches(':focus-visible'));
-          } catch {
-            setFocusVisible(true);
-          }
-        }}
-        onBlur={() => setFocusVisible(false)}
-        {...momentaryProps}
+        onFocus={handleFocus}
+        onBlur={handleBlur}
+        {...composedHandlers}
        style={{
          position: 'relative',
          display: 'inline-flex',
@ -116,16 +177,12 @@ export const PushButton = React.forwardRef<HTMLButtonElement, PushButtonProps>(
          minWidth: size * 1.4,
          padding: '0 12px',
          borderRadius: 7,
-          border: '1px solid rgba(0,0,0,0.7)',
-          background: on
-            ? 'linear-gradient(180deg, #17181d, #232429)'
-            : 'linear-gradient(180deg, #35363d, #1d1e24)',
+          border: chrome.border,
+          background: chrome.background,
          outline: 'none',
-          boxShadow: `${
-            on
-              ? 'inset 0 2px 5px rgba(0,0,0,0.65)'
-              : 'inset 0 1px 0 rgba(255,255,255,0.09), 0 2px 4px rgba(0,0,0,0.45)'
-          }${focusVisible ? `, 0 0 0 2px ${theme.focusRing}` : ''}`,
+          boxShadow: `${chrome.boxShadow}${
+            focusVisible ? `, 0 0 0 2px ${theme.focusRing}` : ''
+          }`,
          color: on ? theme.text : theme.label,
          fontFamily: theme.fontUI,
          fontSize: Math.max(10, size * 0.28),
@ -148,8 +205,8 @@ export const PushButton = React.forwardRef<HTMLButtonElement, PushButtonProps>(
              width: '55%',
              height: Math.max(3, size * 0.09),
              borderRadius: 3,
-              background: on ? accent : 'rgba(255,255,255,0.09)',
-              boxShadow: on ? `0 0 ${size * 0.22}px ${accent}` : 'inset 0 1px 1px rgba(0,0,0,0.6)',
+              background: ledOn ? accent : ledOff,
+              boxShadow: ledOn ? `0 0 ${size * 0.22}px ${accent}` : 'inset 0 1px 1px rgba(0,0,0,0.6)',
              transition: 'background 80ms, box-shadow 80ms',
            }}
          />
@ -164,8 +221,8 @@ export const PushButton = React.forwardRef<HTMLButtonElement, PushButtonProps>(
              width: Math.max(4, size * 0.14),
              height: Math.max(4, size * 0.14),
              borderRadius: '50%',
-              background: on ? accent : 'rgba(255,255,255,0.09)',
-              boxShadow: on ? `0 0 ${size * 0.25}px ${accent}` : 'inset 0 1px 1px rgba(0,0,0,0.6)',
+              background: ledOn ? accent : ledOff,
+              boxShadow: ledOn ? `0 0 ${size * 0.25}px ${accent}` : 'inset 0 1px 1px rgba(0,0,0,0.6)',
              transition: 'background 80ms, box-shadow 80ms',
            }}
          />
@ -177,7 +234,7 @@ export const PushButton = React.forwardRef<HTMLButtonElement, PushButtonProps>(
                aria-hidden="true"
                style={{
                  display: 'inline-flex',
-                  color: on ? accent : theme.label,
+                  color: ledOn ? accent : theme.label,
                  transition: 'color 80ms',
                }}
              >
@ -187,8 +244,26 @@ export const PushButton = React.forwardRef<HTMLButtonElement, PushButtonProps>(
            {children}
          </span>
        )}
-        {name && <input type="hidden" name={name} value={on ? 'on' : 'off'} readOnly />}
+        {name && <input type="hidden" name={name} value={latched ? 'on' : 'off'} readOnly />}
      </button>
    );
  },
 );
+
+export interface ButtonProps
+  extends Omit<PushButtonProps, 'mode' | 'pressed' | 'defaultPressed' | 'onChange'> {
+  onClick?: () => void;
+}
+
+/**
+ * A normal click-to-fire command button in the studio-panel style — the
+ * non-latching sibling of `PushButton`. Use it for actions (Regenerate,
+ * Add, Apply, Refresh). It's `PushButton` locked to `mode="action"`. Plain by
+ * default (no LED — an action has no state); pass `led="dot"` for a corner dot
+ * that flashes on press, or `led="strip"` for the full strip.
+ */
+export const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+  function Button({ led, ...rest }, ref) {
+    return <PushButton ref={ref} mode="action" led={led} {...rest} />;
+  },
+);
--- a/packages/dreamknob/src/skins/SegmentSwitch.tsx
+++ b/packages/dreamknob/src/skins/SegmentSwitch.tsx
@ -46,6 +46,7 @@ export const SegmentSwitch = React.forwardRef<HTMLDivElement, SegmentSwitchProps
  ) {
    const theme = useKnobTheme();
    const accent = color ?? theme.accent ?? '#4cc2ff';
+    const light = theme.scheme === 'light';
    const isControlled = value !== undefined;
    const [internal, setInternal] = React.useState(defaultValue);
    const active = Math.max(0, Math.min(options.length - 1, isControlled ? (value as number) : internal));
@ -88,9 +89,13 @@ export const SegmentSwitch = React.forwardRef<HTMLDivElement, SegmentSwitchProps
          display: 'inline-flex',
          height: size,
          borderRadius: 8,
-          border: '1px solid rgba(0,0,0,0.7)',
-          background: 'linear-gradient(180deg, #16171c, #101116)',
-          boxShadow: 'inset 0 1px 0 rgba(255,255,255,0.06), 0 2px 4px rgba(0,0,0,0.4)',
+          border: light ? '1px solid rgba(0,0,0,0.14)' : '1px solid rgba(0,0,0,0.7)',
+          background: light
+            ? 'linear-gradient(180deg, #e3e4e8, #edeef1)'
+            : 'linear-gradient(180deg, #16171c, #101116)',
+          boxShadow: light
+            ? 'inset 0 1px 2px rgba(0,0,0,0.1)'
+            : 'inset 0 1px 0 rgba(255,255,255,0.06), 0 2px 4px rgba(0,0,0,0.4)',
          overflow: 'hidden',
          opacity: disabled ? 0.45 : 1,
          userSelect: 'none',
@ -122,11 +127,20 @@ export const SegmentSwitch = React.forwardRef<HTMLDivElement, SegmentSwitchProps
                padding: '0 12px',
                minWidth: size * 1.6,
                border: 'none',
-                borderRight: i < options.length - 1 ? '1px solid rgba(0,0,0,0.55)' : 'none',
+                borderRight:
+                  i < options.length - 1
+                    ? `1px solid ${light ? 'rgba(0,0,0,0.1)' : 'rgba(0,0,0,0.55)'}`
+                    : 'none',
                background: isActive
-                  ? 'linear-gradient(180deg, rgba(0,0,0,0.5), rgba(0,0,0,0.25))'
+                  ? light
+                    ? 'linear-gradient(180deg, #ffffff, #f4f5f7)'
+                    : 'linear-gradient(180deg, rgba(0,0,0,0.5), rgba(0,0,0,0.25))'
                  : 'transparent',
-                boxShadow: isActive ? 'inset 0 2px 4px rgba(0,0,0,0.55)' : undefined,
+                boxShadow: isActive
+                  ? light
+                    ? '0 1px 2px rgba(0,0,0,0.16)'
+                    : 'inset 0 2px 4px rgba(0,0,0,0.55)'
+                  : undefined,
                color: isActive ? theme.text : theme.label,
                fontFamily: theme.fontUI,
                fontSize: Math.max(10, size * 0.34),
@ -145,7 +159,7 @@ export const SegmentSwitch = React.forwardRef<HTMLDivElement, SegmentSwitchProps
                    width: '55%',
                    height: Math.max(2, size * 0.08),
                    borderRadius: 2,
-                    background: isActive ? accent : 'rgba(255,255,255,0.08)',
+                    background: isActive ? accent : light ? 'rgba(0,0,0,0.12)' : 'rgba(255,255,255,0.08)',
                    boxShadow: isActive ? `0 0 ${size * 0.2}px ${accent}` : undefined,
                    transition: 'background 80ms, box-shadow 80ms',
                  }}
--- a/packages/dreamknob/src/skins/TransportButton.tsx
+++ b/packages/dreamknob/src/skins/TransportButton.tsx
@ -1,5 +1,5 @@
 import * as React from 'react';
-import { useKnobTheme } from '../core/theme';
+import { panelButtonChrome, useKnobTheme } from '../core/theme';

 export type TransportKind =
  | 'play'
@ -90,6 +90,7 @@ export const TransportButton = React.forwardRef<HTMLButtonElement, TransportButt
    const theme = useKnobTheme();
    const [focusVisible, setFocusVisible] = React.useState(false);
    const glyphRef = React.useRef<SVGSVGElement>(null);
+    const chrome = panelButtonChrome(theme.scheme, active);

    const accent =
      color ??
@ -145,17 +146,11 @@ export const TransportButton = React.forwardRef<HTMLButtonElement, TransportButt
          height: size,
          padding: 0,
          borderRadius: 8,
-          border: '1px solid rgba(0,0,0,0.6)',
-          background: active
-            ? 'linear-gradient(180deg, #17181d, #232429)'
-            : 'linear-gradient(180deg, #35363d, #1d1e24)',
-          boxShadow: `${
-            active
-              ? 'inset 0 2px 5px rgba(0,0,0,0.6)'
-              : 'inset 0 1px 0 rgba(255,255,255,0.09), 0 2px 4px rgba(0,0,0,0.45)'
-          }${active ? `, 0 0 ${size * 0.28}px ${accent}55` : ''}${
-            focusVisible ? `, 0 0 0 2px ${theme.focusRing}` : ''
-          }`,
+          border: chrome.border,
+          background: chrome.background,
+          boxShadow: `${chrome.boxShadow}${
+            active ? `, 0 0 ${size * 0.28}px ${accent}55` : ''
+          }${focusVisible ? `, 0 0 0 2px ${theme.focusRing}` : ''}`,
          outline: 'none',
          cursor: disabled ? 'not-allowed' : 'pointer',
          opacity: disabled ? 0.45 : 1,
--- a/packages/dreamknob/src/skins/meterEngine.test.ts
+++ b/packages/dreamknob/src/skins/meterEngine.test.ts
@ -0,0 +1,45 @@
+import { describe, expect, it } from 'vitest';
+import { ampToDb, dbToAmp, smoothingCoeff } from './meterEngine';
+
+describe('ampToDb', () => {
+  it('maps unity amplitude to 0 dBFS', () => {
+    expect(ampToDb(1)).toBeCloseTo(0, 6);
+  });
+
+  it('halving amplitude is about -6 dB', () => {
+    expect(ampToDb(0.5)).toBeCloseTo(-6.0206, 3);
+  });
+
+  it('a tenth is -20 dB', () => {
+    expect(ampToDb(0.1)).toBeCloseTo(-20, 6);
+  });
+
+  it('silence is -Infinity', () => {
+    expect(ampToDb(0)).toBe(-Infinity);
+    expect(ampToDb(-0.2)).toBe(-Infinity);
+  });
+
+  it('round-trips through dbToAmp', () => {
+    for (const amp of [1, 0.5, 0.25, 0.031]) {
+      expect(dbToAmp(ampToDb(amp))).toBeCloseTo(amp, 6);
+    }
+  });
+});
+
+describe('smoothingCoeff', () => {
+  it('is in (0,1) and rises with dt', () => {
+    const a = smoothingCoeff(5, 100);
+    const b = smoothingCoeff(50, 100);
+    expect(a).toBeGreaterThan(0);
+    expect(b).toBeLessThan(1);
+    expect(b).toBeGreaterThan(a);
+  });
+
+  it('reaches ~63% of the way after one time constant', () => {
+    expect(smoothingCoeff(100, 100)).toBeCloseTo(1 - Math.exp(-1), 6);
+  });
+
+  it('a shorter tau (faster attack) moves further per step', () => {
+    expect(smoothingCoeff(10, 5)).toBeGreaterThan(smoothingCoeff(10, 350));
+  });
+});
--- a/packages/dreamknob/src/skins/meterEngine.ts
+++ b/packages/dreamknob/src/skins/meterEngine.ts
@ -0,0 +1,167 @@
+import * as React from 'react';
+
+/** Linear amplitude (0..1+) to dBFS. 0 (or below) maps to -Infinity. */
+export const ampToDb = (amp: number): number => (amp <= 0 ? -Infinity : 20 * Math.log10(amp));
+
+/** dBFS back to linear amplitude. */
+export const dbToAmp = (db: number): number => Math.pow(10, db / 20);
+
+/** One-pole smoothing coefficient for a time constant `tau` (ms) over `dt` (ms). */
+export const smoothingCoeff = (dt: number, tau: number): number =>
+  1 - Math.exp(-dt / Math.max(1, tau));
+
+export interface Ballistics {
+  /** Rise time constant in ms (fast). */
+  attack?: number;
+  /** Fall time constant in ms (slow). */
+  decay?: number;
+}
+
+export interface MeterEngineOptions {
+  /** Run the rAF engine at all. When false the hook returns null (legacy path). */
+  enabled: boolean;
+  /** Smooth the displayed level with attack/decay ballistics. */
+  ballistics?: boolean | Ballistics;
+  /** Peak-hold time in ms before the peak marker starts to fall. */
+  peakHold?: number | false;
+  /** Peak fall rate in normalized units per second once the hold expires. */
+  peakDecay?: number | null;
+  /** Compute a time-windowed loudness (LUFS-ish) from `rawDomain`. */
+  integrated?: boolean;
+  /** Loudness integration window in ms. */
+  integrationWindow?: number;
+  /** 'db' integrates power in the log domain; 'linear' uses RMS. */
+  scale?: 'linear' | 'db';
+}
+
+export interface MeterEngineState {
+  /** Ballistics-smoothed (or raw) normalized levels, per channel. */
+  levels: readonly number[];
+  /** Peak-hold markers, per channel, in normalized [0,1]. */
+  peaks: readonly number[];
+  /** Windowed loudness in the value domain (dB for 'db' scale), or null. */
+  integrated: number | null;
+}
+
+const DEFAULT_ATTACK = 5;
+const DEFAULT_DECAY = 350;
+
+/**
+ * A requestAnimationFrame meter engine: attack/decay ballistics, peak-hold with
+ * a decay tail, and an optional time-windowed loudness estimate. Returns null
+ * when disabled so the caller can keep its cheap legacy (timer) path.
+ *
+ * `targetNs` are the instantaneous normalized levels; `rawDomain` are the same
+ * channels in value space (dB or linear) for loudness integration.
+ */
+export const useMeterEngine = (
+  targetNs: readonly number[],
+  rawDomain: readonly number[],
+  opts: MeterEngineOptions,
+): MeterEngineState | null => {
+  const {
+    enabled,
+    ballistics,
+    peakHold = 1200,
+    peakDecay = null,
+    integrated = false,
+    integrationWindow = 3000,
+    scale = 'linear',
+  } = opts;
+
+  const useBallistics = !!ballistics;
+  const attack = (typeof ballistics === 'object' && ballistics?.attack) || DEFAULT_ATTACK;
+  const decay = (typeof ballistics === 'object' && ballistics?.decay) || DEFAULT_DECAY;
+
+  const targetRef = React.useRef(targetNs);
+  targetRef.current = targetNs;
+  const rawRef = React.useRef(rawDomain);
+  rawRef.current = rawDomain;
+
+  const [state, setState] = React.useState<MeterEngineState>(() => ({
+    levels: targetNs,
+    peaks: targetNs,
+    integrated: null,
+  }));
+
+  // Per-channel timestamp of the last time the peak was refreshed.
+  const holdAt = React.useRef<number[]>([]);
+  // Ring buffer of {t, power} for loudness integration.
+  const powerBuf = React.useRef<{ t: number; p: number }[]>([]);
+
+  React.useEffect(() => {
+    if (!enabled) return;
+    let raf = 0;
+    let last =
+      typeof performance !== 'undefined' && performance.now ? performance.now() : 0;
+
+    const tick = (now: number) => {
+      const dt = Math.min(100, now - last);
+      last = now;
+      const tgt = targetRef.current;
+      const raw = rawRef.current;
+
+      setState(prev => {
+        const n = tgt.length;
+        const prevLevels = prev.levels.length === n ? prev.levels : tgt;
+        const prevPeaks = prev.peaks.length === n ? prev.peaks : tgt;
+
+        const levels = tgt.map((t, i) => {
+          const l = prevLevels[i] ?? 0;
+          if (!useBallistics) return t;
+          const tau = t >= l ? attack : decay;
+          return l + (t - l) * smoothingCoeff(dt, tau);
+        });
+
+        const holdMs = peakHold === false ? Infinity : peakHold;
+        const peaks = levels.map((lvl, i) => {
+          const p = prevPeaks[i] ?? 0;
+          if (lvl >= p) {
+            holdAt.current[i] = now;
+            return lvl;
+          }
+          const heldFor = now - (holdAt.current[i] ?? now);
+          if (heldFor < holdMs) return p;
+          if (peakDecay == null) return lvl; // no decay tail — track the level
+          return Math.max(lvl, p - (peakDecay / 1000) * dt);
+        });
+
+        let integratedOut = prev.integrated;
+        if (integrated) {
+          const power =
+            raw.length > 0
+              ? raw.reduce(
+                  (s, d) => s + (scale === 'db' ? Math.pow(10, d / 10) : d * d),
+                  0,
+                ) / raw.length
+              : 0;
+          const buf = powerBuf.current;
+          buf.push({ t: now, p: power });
+          while (buf.length > 1 && now - buf[0].t > integrationWindow) buf.shift();
+          const meanP = buf.reduce((s, b) => s + b.p, 0) / (buf.length || 1);
+          integratedOut =
+            scale === 'db' ? 10 * Math.log10(Math.max(meanP, 1e-12)) : Math.sqrt(meanP);
+        }
+
+        return { levels, peaks, integrated: integratedOut };
+      });
+
+      raf = requestAnimationFrame(tick);
+    };
+
+    raf = requestAnimationFrame(tick);
+    return () => cancelAnimationFrame(raf);
+  }, [
+    enabled,
+    useBallistics,
+    attack,
+    decay,
+    peakHold,
+    peakDecay,
+    integrated,
+    integrationWindow,
+    scale,
+  ]);
+
+  return enabled ? state : null;
+};
Author	SHA1	Message	Date
Dreamodus	8b462dfb83	v1.1.4: light-theme support (LED wells, panel buttons, readouts) The controls whose chrome was hardcoded dark now adapt to a light base — previously they rendered as dark chips/holes on light themes. (Flat knobs and faders already adapted: their face is the `face` token.) - `ledWell` theme token — the recessed screen behind LED segments (LEDKnob, LEDFader, Meter) and the default well of SegmentDisplay / AlphaDisplay now comes from the theme. Dark base keeps #0b0d0e; light base is `transparent`, so LED controls and readouts render as clean flat rings / bars / digits on the light panel. faceColor / background props still override. - `scheme` theme token ('dark' \| 'light', set by base) + a shared panelButtonChrome() helper drive the raised gradient/border/shadow of PushButton (and Button), TransportButton and SegmentSwitch — light raised buttons on light themes instead of dark chips; unlit LED pips flip to a faint dark so they still read. - Docs: a "Light theme" gallery card showing the panel family under base="light"; ledWell/scheme documented; install URLs bumped to v1.1.4. Library + docs typecheck and build; 46 tests pass.	2026-07-14 14:21:57 -07:00
Dreamodus	d183d7d16b	v1.1.3: Radix-composable buttons, meter ballistics/dBFS/loudness, PanKnob - PushButton/Button forward native button props (...rest) and compose their own event handlers with consumer/Radix-injected ones, so a Button works as a Radix `asChild` trigger (dropdowns/tooltips/popovers). Prop types now extend React.ButtonHTMLAttributes. - Meter gains opt-in metering: `ballistics` (PPM attack/decay), `peakDecay` (peak-hold fall tail), `scale="db"` (feed amplitude → dBFS with reference lines; min/max default -60/0), and `integrated` (windowed LUFS-ish loudness readout + marker). New rAF engine in meterEngine.ts with ampToDb/dbToAmp helpers; default behavior unchanged. - New `PanKnob` — bipolar stereo pan: fills from center, center detent, L<n>/C/R<n> readout, -50..50 default. - Docs: ApiDocs rows + recipes (dBFS meter, pan strip, Button-as-trigger), gallery cards (dBFS meter, Pan) + a Regenerate Button in the panel. CHANGELOG 1.1.3; version 1.1.3; install URLs bumped. Library + docs typecheck and build; 46 tests pass. - Meter dBFS readout: muted-grey unit labels (LUFS matched to dB), value-first layout in an aligned 2-column grid so peak/loudness decimals line up, and ghost pad digits removed — the loudness row no longer looks like a stray tag. - Action buttons (Button / PushButton mode="action") no longer show an LED by default — an action has no state to indicate. led defaults to 'strip' for toggle/momentary and false for action; led="dot"/"strip" opts back in. - Meter dBFS readout: units (dB / LUFS) sit centered directly under each value; grid alignment tidied and ghost pad digits removed. Docs: dBFS-meter card moved next to the Meters card (same component) + a horizontal example.	2026-07-14 12:08:20 -07:00
Dreamodus	605c38af51	docs: point the site install command at the v1.1.2 release tarball The READMEs were bumped for 1.1.2 but the docs Hero/GettingStarted still showed the v1.1.1 URL.	2026-07-14 06:36:39 -07:00
Dreamodus	a6348d5c46	v1.1.2: action button, responsive faders, label scaling Third integration-feedback release from building the streaming studio. - New `Button` — a click-to-fire command button in the panel style, the non-latching sibling of PushButton. Implemented as PushButton's new `mode="action"` (never latches, press-down + brief LED flash, `onClick`); led="dot" (default) matches the corner-dot look, led={false} is plain. - `fill` on LEDFader (parity with Fader) — faders stretch to fill their container in resizable panels instead of a fixed pixel length. - `labelSize` on IndicatorLamp (and LampRow) — shrink the caption below its 10px floor to match dense header rows. - Docs: a dedicated "Buttons & switches" section with a decision guide (Button/PushButton/TransportButton/ToggleSwitch/SegmentSwitch) + live demos. Library + docs typecheck and build; 38 tests pass.	2026-07-14 06:33:15 -07:00