@pudge-ui/mcp-server 0.1.0

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

@@ -0,0 +1,89 @@
+---
+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

@@ -0,0 +1,104 @@
+---
+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

@@ -0,0 +1,125 @@
+---
+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

@@ -0,0 +1,108 @@
+---
+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

@@ -0,0 +1,123 @@
+---
+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

@@ -0,0 +1,139 @@
+---
+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)