@pudge-ui/mcp-server 0.1.0 → 0.2.0

package/spec/spec/components/buttons/clear-button.md

@@ -1,89 +0,0 @@
----
-name: Clear/Glass Button
-id: clear-btn
-class: .clear-btn
-category: buttons
-index: 4
-materials: [glass]
-sizes: [md]
-interactive: true
-requires_js: false
-canvas: false
----
-
-# Clear/Glass Button
-
-## Physical Analog
-**Reference devices**: iMac G3 (1998) power button, clear PSP UMD door latch, transparent phone cases (2003-2006 era).
-**Mechanism**: Dome switch underneath with optically clear or frosted PMMA (acrylic) / polycarbonate keycap. Chemically etched or bead-blasted surface scatters light creating translucent diffusion effect.
-
-## Geometry
-
-| Property | Value |
-|----------|-------|
-| Material | Clear or frosted PMMA / polycarbonate |
-| Surface | Transparent with light scattering |
-| Shadow | None (glass sits flush, minimal edge profile) |
-| Blur | 4px backdrop-filter for frosted glass effect |
-
-## CSS Recipe
-
-### Default State
-```css
-.clear-btn {
-  display: inline-flex; align-items: center; justify-content: center;
-  font-family: var(--font-ui); font-size: 10px; font-weight: 500;
-  letter-spacing: 1px; color: var(--text-secondary);
-  background: var(--clear-glass);
-  border: 1px solid var(--border-subtle); border-radius: var(--radius-md);
-  cursor: pointer; backdrop-filter: blur(4px);
-  height: 36px; min-width: 60px; padding: 0 12px;
-  transition: background 0.15s, border-color 0.15s;
-}
-```
-
-### Hover State
-```css
-.clear-btn:hover { background: var(--glossy-md); border-color: var(--border-mid); }
-```
-
-### Active (Pressed) State
-```css
-.clear-btn:active { transform: translateY(1px); }
-```
-
-### Active (Selected) State
-```css
-.clear-btn.active { border-color: var(--blue-info); color: var(--blue-info); }
-```
-
-## HTML Structure
-```html
-<!-- Basic -->
-<button class="clear-btn">CLEAR</button>
-
-<!-- Active -->
-<button class="clear-btn active">ACTIVE</button>
-```
-
-## Size Variants
-No explicit size variants defined. Default only.
-
-## Material Variants
-Single material: glass (translucent). No gradient, flat transparency with `backdrop-filter`.
-
-## Theme Behavior
-- Dark: `--clear-glass: rgba(255,255,255,0.08)` -- mostly transparent
-- Light: `--clear-glass: rgba(255,255,255,0.5)` -- more opaque frosted effect
-- Border colors swap via `--border-subtle` token
-
-## Constraints
-1. Background MUST be flat `rgba` (no gradient). Glass does not have gradient appearance.
-2. `backdrop-filter: blur(4px)` is REQUIRED for the frosted glass effect.
-3. MUST NOT have a bottom-edge shadow (`0 Npx 0`). Glass does not cast the same hard edge as plastic.
-4. Border MUST be subtle (1px solid border-subtle). Glass edges are thin.
-
-## Accessibility
-- Uses native `<button>` element
-- Keyboard: Enter/Space to activate
-- Focus: Browser default focus ring preserved

package/spec/spec/components/buttons/fn-grid.md

@@ -1,104 +0,0 @@
----
-name: Function Grid
-id: fn-btn
-class: .fn-btn
-category: buttons
-index: 7
-materials: [panel]
-sizes: [md]
-interactive: true
-requires_js: false
-canvas: false
----
-
-# Function Grid
-
-## Physical Analog
-**Reference devices**: Sony Alpha custom button matrix (C1-C4), Fujifilm X-T4 Fn button grid, Nikon Z9 illuminated button panel.
-**Mechanism**: Identical dome switches to push-btn, arranged in a 2x2 or 2x3 grid on a sub-panel. Each button has a printed icon and label. On pro cameras, buttons often have backlit legends -- a small LED behind translucent legend text illuminates the active function.
-
-## Geometry
-
-| Property | Value |
-|----------|-------|
-| Grid layout | 2 or 3 columns |
-| Button height | 52px |
-| Gap | 8px |
-| Icon size | 20x20px SVG |
-| Label font | 8px, 1.5px letter-spacing |
-
-## CSS Recipe
-
-### Grid Container
-```css
-.fn-grid { display: grid; gap: 8px; }
-.fn-grid.cols-2 { grid-template-columns: repeat(2, 1fr); }
-.fn-grid.cols-3 { grid-template-columns: repeat(3, 1fr); }
-```
-
-### Button Default State
-```css
-.fn-btn {
-  height: 52px; background: var(--bg-surface);
-  border: 1px solid var(--border-deep); border-radius: var(--radius-md);
-  cursor: pointer; display: flex; align-items: center; justify-content: center;
-  flex-direction: column; gap: 4px;
-  box-shadow: 0 2px 0 var(--border-deep), inset 0 1px 0 var(--border-hi);
-  transition: transform 0.07s, box-shadow 0.07s, background 0.1s;
-  color: var(--text-secondary); outline: none;
-}
-```
-
-### Active (Pressed) State
-```css
-.fn-btn:active {
-  transform: translateY(1px);
-  box-shadow: 0 1px 0 var(--border-deep); background: var(--bg-panel);
-}
-```
-
-### Active (Selected/Backlit) State
-```css
-.fn-btn.fn-active { background: #1c1a14; border-color: #3a3000; color: var(--amber); }
-```
-
-### Child Elements
-```css
-.fn-btn svg { width: 20px; height: 20px; flex-shrink: 0; }
-.fn-btn span { font-size: 8px; letter-spacing: 1.5px; color: inherit; text-transform: uppercase; }
-```
-
-## HTML Structure
-```html
-<div class="fn-grid cols-3" style="width:180px">
-  <button class="fn-btn fn-active"><span>WB</span></button>
-  <button class="fn-btn"><span>ISO</span></button>
-  <button class="fn-btn"><span>AF</span></button>
-  <button class="fn-btn"><span>DR</span></button>
-  <button class="fn-btn"><span>EV</span></button>
-  <button class="fn-btn"><span>MF</span></button>
-</div>
-```
-
-## Size Variants
-No explicit size variants. Button height is fixed at 52px; grid width is set by container.
-
-## Material Variants
-Default material is panel surface. Active state uses a warm dark background with amber border.
-
-## Theme Behavior
-- Surface colors swap via `--bg-surface` token
-- Active state uses hardcoded dark tones (`#1c1a14`, `#3a3000`) -- may need light theme override
-- Text color inherits, swapping with theme
-
-## Constraints
-1. Grid MUST use CSS Grid with explicit column count classes (`.cols-2`, `.cols-3`).
-2. Active button legend MUST turn amber to simulate backlit LED.
-3. Label text MUST be uppercase, 8px, with wide letter-spacing.
-4. Icons and labels stack vertically (flex-direction: column).
-
-## Accessibility
-- Uses native `<button>` elements
-- Keyboard: Enter/Space to activate, Tab to navigate between buttons
-- Focus: Browser default focus ring preserved
-- Grid semantics could use `role="group"` on container

package/spec/spec/components/buttons/gel-button.md

@@ -1,125 +0,0 @@
----
-name: Gel Button
-id: gel-btn
-class: .gel-btn
-category: buttons
-index: 2
-materials: [glossy-polycarbonate]
-sizes: [xs, sm, md, lg]
-interactive: true
-requires_js: false
-canvas: false
----
-
-# Gel Button
-
-## Physical Analog
-**Reference devices**: iPod Nano 3rd gen click buttons, Sony Ericsson W800i keys, PSP face buttons.
-**Mechanism**: Dome-switch mechanism with transparent/translucent polycarbonate (Lexan) keycap, injection-molded with high-gloss finish. 2-3mm thick, slightly convex. Strong specular highlight from Fresnel reflection at air-plastic interface.
-
-## Geometry
-
-| Property | Value |
-|----------|-------|
-| Keycap material | Transparent/translucent polycarbonate |
-| Surface | High-gloss, slightly convex |
-| Catch-light | Concentrated bright reflection on upper third, fading to transparent |
-| Thickness | 2-3mm polycarbonate |
-| Shadow depth | 3px (taller than push-btn's 2px) |
-
-## CSS Recipe
-
-### Default State
-```css
-.gel-btn {
-  display: inline-flex; align-items: center; justify-content: center;
-  flex-direction: column; gap: 2px;
-  font-family: var(--font-ui); font-size: 11px; font-weight: 500;
-  letter-spacing: 1px; color: var(--text-primary);
-  background: linear-gradient(180deg, var(--clear-glass), transparent 50%),
-              linear-gradient(180deg, var(--bg-surface), var(--bg-panel));
-  border: none; border-radius: var(--radius-md); cursor: pointer;
-  position: relative; outline: none; user-select: none;
-  height: 38px; min-width: 64px; padding: 0 16px;
-  box-shadow: 0 3px 0 var(--border-deep), inset 0 1px 0 var(--glossy-hi);
-  transition: transform 0.07s var(--snap-fast), box-shadow 0.07s var(--snap-fast);
-}
-```
-
-### Active (Pressed) State
-```css
-.gel-btn:active {
-  transform: translateY(2px);
-  box-shadow: 0 1px 0 var(--border-deep), inset 0 1px 0 transparent;
-}
-```
-
-### Selected State
-```css
-.gel-btn.active { color: var(--blue-info); }
-.gel-btn.active::after {
-  content: ''; position: absolute; bottom: 5px;
-  left: 50%; transform: translateX(-50%);
-  width: 18px; height: 2px; background: var(--blue-info); border-radius: 1px;
-}
-```
-
-### Color Variants
-```css
-.gel-btn.blue { color: var(--blue-info); }
-.gel-btn.green { color: var(--green-on); }
-.gel-btn.pink { color: var(--pink-action); }
-```
-
-### Disabled State
-```css
-.gel-btn[disabled] { opacity: 0.4; pointer-events: none; }
-```
-
-## HTML Structure
-```html
-<!-- Basic -->
-<button class="gel-btn">GEL</button>
-
-<!-- Color variants -->
-<button class="gel-btn blue">BLUE</button>
-<button class="gel-btn green">GREEN</button>
-<button class="gel-btn pink">PINK</button>
-
-<!-- Selected -->
-<button class="gel-btn active">SELECTED</button>
-
-<!-- Sizes -->
-<button class="gel-btn xs">XS</button>
-<button class="gel-btn lg">LARGE</button>
-```
-
-## Size Variants
-
-| Size | Height | Min-Width | Font-Size | Padding |
-|------|--------|-----------|-----------|---------|
-| `.xs` | 28px | 44px | 9px | 0 10px |
-| `.sm` | 32px | 52px | 10px | 0 12px |
-| default | 38px | 64px | 11px | 0 16px |
-| `.lg` | 44px | 80px | 13px | 0 20px |
-
-## Material Variants
-Single material: glossy polycarbonate. The two-layer background is the defining characteristic.
-
-## Theme Behavior
-- `--clear-glass` swaps: dark = `rgba(255,255,255,0.08)`, light = `rgba(255,255,255,0.5)`
-- `--glossy-hi` remains constant at `rgba(255,255,255,0.14)`
-- Surface colors swap via tokens
-
-## Constraints
-1. The two-layer background is MANDATORY. A single gradient cannot produce the gel look.
-2. The catch-light MUST fade to `transparent` (not to a color) so the underlying body gradient shows through.
-3. `glossy-hi` MUST be `0.14` opacity, not `0.06`. This is the primary differentiator from rubber buttons.
-4. Bottom shadow MUST be 3px (not 2px) because polycarbonate buttons sit taller than panel buttons.
-5. Press travel is 2px (not 1px like push-btn) due to the thicker keycap.
-
-## Accessibility
-- Uses native `<button>` element
-- Keyboard: Enter/Space to activate
-- Focus: Browser default focus ring preserved
-- Color variants are decorative; do not rely on color alone for state

package/spec/spec/components/buttons/icon-button.md

@@ -1,108 +0,0 @@
----
-name: Icon Button
-id: icon-btn
-class: .icon-btn
-category: buttons
-index: 8
-materials: [panel]
-sizes: [sm, md, lg]
-interactive: true
-requires_js: false
-canvas: false
----
-
-# Icon Button
-
-## Physical Analog
-**Reference devices**: Toolbar buttons on audio equipment (Tascam portastudio, Roland SP-404 sampler), camera viewfinder controls.
-**Mechanism**: Small tactile buttons with a single icon/symbol instead of text label. Typically smaller than labeled buttons (8-10mm). Round variants appear on devices where the button also serves as an indicator light (LED underneath translucent cap).
-
-## Geometry
-
-| Property | Value |
-|----------|-------|
-| Default size | 36x36px |
-| Small size | 28x28px |
-| Large size | 44x44px |
-| Icon font-size | 14px (default) |
-| Border-radius | var(--radius-md) or 50% for round |
-
-## CSS Recipe
-
-### Default State
-```css
-.icon-btn {
-  display: inline-flex; align-items: center; justify-content: center;
-  width: 36px; height: 36px; border-radius: var(--radius-md);
-  background: var(--bg-surface); border: 1px solid var(--border-subtle);
-  cursor: pointer; color: var(--text-secondary); font-size: 14px;
-  box-shadow: 0 2px 0 var(--border-deep), inset 0 1px 0 var(--glossy-hi);
-  transition: transform 0.07s var(--snap-fast), box-shadow 0.07s, color 0.12s;
-}
-```
-
-### Hover State
-```css
-.icon-btn:hover { color: var(--text-primary); }
-```
-
-### Active (Pressed) State
-```css
-.icon-btn:active {
-  transform: translateY(1px);
-  box-shadow: 0 1px 0 var(--border-deep);
-}
-```
-
-### Active (Selected) State
-```css
-.icon-btn.active { color: var(--amber); border-color: rgba(245,166,35,0.3); }
-```
-
-### Round Variant
-```css
-.icon-btn.round { border-radius: 50%; }
-```
-
-## HTML Structure
-```html
-<!-- Default -->
-<button class="icon-btn">&#9632;</button>
-
-<!-- Small -->
-<button class="icon-btn sm">&#9654;</button>
-
-<!-- Active -->
-<button class="icon-btn active">&#9733;</button>
-
-<!-- Large round -->
-<button class="icon-btn lg round">&#9881;</button>
-```
-
-## Size Variants
-
-| Size | Width/Height | Font-Size |
-|------|-------------|-----------|
-| `.sm` | 28px | 12px |
-| default | 36px | 14px |
-| `.lg` | 44px | 18px |
-
-## Material Variants
-Default panel material. No explicit material variant classes.
-
-## Theme Behavior
-- Surface and border colors swap via tokens
-- `--glossy-hi` remains constant
-- Text colors swap via `--text-secondary` and `--text-primary`
-
-## Constraints
-1. MUST be square (width equals height).
-2. Icon MUST be centered both horizontally and vertically.
-3. Shadow stack follows standard Tier 2 pattern.
-4. Round variant uses `border-radius: 50%` for circular shape.
-
-## Accessibility
-- Uses native `<button>` element
-- Keyboard: Enter/Space to activate
-- ARIA: Should include `aria-label` since there is no visible text
-- Focus: Browser default focus ring preserved

package/spec/spec/components/buttons/keypad-button.md

@@ -1,123 +0,0 @@
----
-name: Keypad Button
-id: keypad-btn
-class: .keypad-btn
-category: buttons
-index: 5
-materials: [panel, rubber]
-sizes: [md]
-interactive: true
-requires_js: false
-canvas: false
----
-
-# Keypad Button
-
-## Physical Analog
-**Reference devices**: Nokia 3210/3310/6600 keypads, Sony Ericsson T610, Motorola RAZR V3.
-**Mechanism**: Rubber dome arrays (single silicone sheet with multiple domes) or individual metal domes on PCB, with rigid plastic keycap overlay. Each key has primary number and secondary T9/multi-tap letters.
-
-## Geometry
-
-| Property | Value |
-|----------|-------|
-| Grid layout | 3 columns x 4 rows |
-| Key size | ~10-12mm square (physical) / 48x44px (UI) |
-| Spacing | 1-2mm gaps (physical) / 6px gap (UI) |
-| Primary digit | Centered, 16px Michroma |
-| T9 letters | 7px, positioned absolute at bottom |
-
-## CSS Recipe
-
-### Default State
-```css
-.keypad-btn {
-  display: inline-flex; align-items: center; justify-content: center;
-  font-family: var(--font-display); font-size: 16px; font-weight: 400;
-  color: var(--text-primary);
-  background: linear-gradient(180deg, var(--bg-surface), var(--bg-panel));
-  border: none; border-radius: var(--radius-sm); cursor: pointer;
-  width: 48px; height: 44px; position: relative;
-  box-shadow: 0 2px 0 var(--border-deep), inset 0 1px 0 var(--glossy-hi);
-  transition: transform 0.05s var(--snap-fast), box-shadow 0.05s var(--snap-fast);
-}
-```
-
-### Active (Pressed) State
-```css
-.keypad-btn:active {
-  transform: translateY(1px);
-  box-shadow: 0 1px 0 var(--border-deep);
-}
-```
-
-### T9 Letters Element
-```css
-.keypad-btn .kbd-letters {
-  font-family: var(--font-ui); font-size: 7px; color: var(--text-muted);
-  letter-spacing: 1px; position: absolute; bottom: 3px;
-}
-```
-
-### Special & Call Variants
-```css
-.keypad-btn.special { background: var(--rubber-bg); font-size: 12px; }
-.keypad-btn.call {
-  background: linear-gradient(180deg, #228833, #116622);
-  color: #fff; font-size: 10px; font-family: var(--font-ui); font-weight: 600;
-}
-```
-
-### Keypad Grid Container
-```css
-.keypad {
-  display: grid; grid-template-columns: repeat(3, 1fr); gap: 6px;
-  padding: 12px; background: var(--bg-raised);
-  border-radius: var(--radius-lg); border: 1px solid var(--border-subtle);
-  box-shadow: var(--shadow-deep); max-width: 168px;
-}
-.keypad .keypad-btn { width: 100%; height: 40px; }
-```
-
-## HTML Structure
-```html
-<!-- Individual keys -->
-<button class="keypad-btn">1</button>
-<button class="keypad-btn">2<span class="kbd-letters">ABC</span></button>
-<button class="keypad-btn">3<span class="kbd-letters">DEF</span></button>
-
-<!-- Call key -->
-<button class="keypad-btn call">CALL</button>
-
-<!-- Full keypad grid -->
-<div class="keypad">
-  <button class="keypad-btn">1</button>
-  <button class="keypad-btn">2<span class="kbd-letters">ABC</span></button>
-  <button class="keypad-btn">3<span class="kbd-letters">DEF</span></button>
-  <!-- ... -->
-</div>
-```
-
-## Size Variants
-No explicit size variants. Fixed at 48x44px (or 100% width inside `.keypad` container).
-
-## Material Variants
-- Default: Panel gradient (bg-surface to bg-panel)
-- `.special`: Rubber background for * and # keys
-- `.call`: Green-dyed keycap plastic
-
-## Theme Behavior
-- Surface gradients swap via tokens
-- Call button green gradient is fixed (not theme-dependent)
-- Rubber background for special keys swaps via `--rubber-bg`
-
-## Constraints
-1. Primary digit font MUST be `--font-display` (Michroma) at 16px -- prominent, centered.
-2. T9 letters MUST be `--font-ui` at 7px, positioned absolute at bottom -- secondary information hierarchy.
-3. Grid MUST be 3 columns when inside `.keypad` container.
-4. Green call key gradient is fixed regardless of theme.
-
-## Accessibility
-- Uses native `<button>` element
-- Keyboard: Enter/Space to activate
-- T9 letters are visible but secondary to primary digit

package/spec/spec/components/buttons/push-button.md

@@ -1,139 +0,0 @@
----
-name: Push Button
-id: push-btn
-class: .push-btn
-category: buttons
-index: 1
-materials: [panel, rubber, glossy]
-sizes: [xs, sm, md, lg, xl]
-interactive: true
-requires_js: false
-canvas: false
----
-
-# Push Button
-
-## Physical Analog
-**Reference devices**: Sony Alpha rear panel buttons, Nikon D-series function buttons, Canon EOS rear controls.
-**Mechanism**: Tactile dome switch (phosphor-bronze or stainless steel dome over PCB contact pad). Dome collapses at 160-260gf, creating an abrupt click and closing the circuit. Dome spring memory restores shape on release.
-
-## Geometry
-
-| Property | Value |
-|----------|-------|
-| Keycap | Injection-molded ABS or polycarbonate, 6-12mm wide, 2-3mm proud |
-| Surface | Slightly convex (domed) so finger naturally centers |
-| Chamfer | 30-45 degree CNC-milled bevel |
-| Travel | 0.3-0.5mm (extremely short) |
-| Gap beneath | 1-2mm proud of panel surface |
-
-## CSS Recipe
-
-### Default State
-```css
-.push-btn {
-  display: inline-flex; align-items: center; justify-content: center;
-  flex-direction: column; gap: 2px;
-  font-family: var(--font-mono); font-size: 10px; font-weight: 500;
-  letter-spacing: 1px; color: var(--text-primary);
-  background: linear-gradient(180deg, var(--bg-surface), var(--bg-panel));
-  border: none; border-radius: var(--radius-md); cursor: pointer;
-  position: relative; outline: none; user-select: none;
-  height: 36px; min-width: 64px; padding: 0 16px;
-  box-shadow: 0 2px 0 var(--border-deep), inset 0 1px 0 var(--border-hi), inset 0 -1px 0 #111;
-  transition: transform 0.07s ease, box-shadow 0.07s ease, color 0.12s ease;
-}
-```
-
-### Hover State
-```css
-.push-btn:hover { color: #fff; }
-```
-
-### Active / Pressed State
-```css
-.push-btn:active, .push-btn.pressed {
-  transform: translateY(1px);
-  box-shadow: 0 1px 0 var(--border-deep), inset 0 1px 0 #1a1a1a, inset 0 -1px 0 #111;
-}
-```
-
-### Active (Selected) State
-```css
-.push-btn.active { color: var(--amber); }
-.push-btn.active::after {
-  content: ''; position: absolute; bottom: 5px;
-  left: 50%; transform: translateX(-50%);
-  width: 20px; height: 2px; background: var(--amber);
-  border-radius: 1px; box-shadow: 0 0 6px var(--amber-glow);
-}
-```
-
-### Disabled State
-```css
-.push-btn.disabled, .push-btn[disabled] { opacity: 0.35; pointer-events: none; }
-```
-
-### Error & Special States
-```css
-.push-btn.state-amber { color: var(--amber); border-top: 1px solid rgba(245,166,35,0.2); }
-.push-btn.error { color: var(--red-alert); border-top: 1px solid rgba(204,34,0,0.2); }
-.push-btn.round { border-radius: 50%; width: 44px; height: 44px; min-width: auto; padding: 0; }
-```
-
-### Light Theme Override
-```css
-[data-theme="light"] .push-btn {
-  box-shadow: 0 2px 0 var(--border-deep), inset 0 1px 0 rgba(255,255,255,0.6), inset 0 -1px 0 var(--border-mid);
-}
-```
-
-## HTML Structure
-```html
-<!-- Basic -->
-<button class="push-btn">LABEL</button>
-
-<!-- With size -->
-<button class="push-btn sm">SM</button>
-
-<!-- Active state -->
-<button class="push-btn active">ACTIVE</button>
-
-<!-- Round variant -->
-<button class="push-btn round">Fn</button>
-
-<!-- Disabled -->
-<button class="push-btn disabled">DISABLED</button>
-```
-
-## Size Variants
-
-| Size | Analog | Height | Min-Width | Font-Size | Padding |
-|------|--------|--------|-----------|-----------|---------|
-| `.xs` | Tiny Fn buttons on Sony A7 shoulder | 26px | 36px | 9px | 0 10px |
-| `.sm` | Standard rear panel button | 32px | 48px | 10px | 0 12px |
-| default | Main function button | 36px | 64px | 10px | 0 16px |
-| `.lg` | Menu/Play button | 40px | 80px | 11px | 0 20px |
-| `.xl` | Large labeled button (pro video cameras) | 44px | 96px | 12px | 0 24px |
-
-## Material Variants
-Default material is panel (linear-gradient from bg-surface to bg-panel). No explicit material variant classes on this component.
-
-## Theme Behavior
-- Dark: `box-shadow` uses `var(--border-deep)` + `var(--border-hi)` + `#111`
-- Light: `box-shadow` uses `var(--border-deep)` + `rgba(255,255,255,0.6)` + `var(--border-mid)`
-- All surface colors swap via CSS custom properties
-
-## Constraints
-1. Travel MUST be 1-2px maximum (`translateY(1px)`). More feels like a keyboard key, not a camera button.
-2. Bottom shadow MUST be hard-edged `0 Npx 0` (no blur) -- the gap between keycap and chassis is a sharp physical edge.
-3. On press, bottom shadow MUST collapse to `0 1px 0` -- the gap nearly closes as the dome compresses.
-4. Hover state MUST subtly brighten text to white, simulating finger shadow changing light on keycap.
-5. The three-plane shadow stack (bottom edge + top chamfer + bottom chamfer) MUST NOT be simplified.
-
-## Accessibility
-- Uses native `<button>` element
-- Keyboard: Enter/Space to activate
-- Focus: Browser default focus ring preserved
-- Disabled state uses `pointer-events: none` and `opacity: 0.35`
-- ARIA: No additional ARIA needed (native button semantics)