@gratiaos/ui 1.0.0

package/styles/field.css

@@ -0,0 +1,195 @@
+/* ─────────────────────────────────────────────────────────────
+   Garden UI — Field skin (opt‑in)
+   Whisper: "clarity first; comfort follows." 🌬️
+
+   Purpose
+     • Selector-only skin for the headless Field primitive.
+     • Driven by Garden tokens; no hardcoded hex.
+
+   Data API
+     • [data-ui='field']                          — root
+     • [data-part='label|hint|description|error|control|optional']
+     • [data-state='error|disabled']              — this skin handles these; 'invalid' may map to 'error' upstream
+     • [data-required] on label — calm bullet (•) suffix
+     • [data-disabled] on root when control is disabled (preferred over data-state)
+
+   Notes
+     • Focus ring uses --ring-accent (falls back to accent mix).
+     • Control shell holds visuals; native input/textarea/select are reset inside it.
+     • Keep motion subtle; avoid intrusive animations in forms.
+     • Back-compat: this skin also honors [data-state='disabled'] and [data-state='error'] in addition to 'invalid'.
+   ──────────────────────────────────────────────────────────── */
+@layer components {
+  [data-ui='field'] {
+    display: flex;
+    flex-direction: column;
+    gap: 0.375rem;
+    color: var(--text);
+  }
+
+  /* parts */
+  [data-ui='field'] [data-part='label'] {
+    font-size: 0.875rem;
+    font-weight: 600;
+    color: var(--text);
+  }
+  [data-ui='field'] [data-part='label'] {
+    display: inline-flex;
+    align-items: baseline;
+    gap: 0.25rem;
+  }
+  [data-ui='field'] [data-part='optional'] {
+    margin-left: 0.375rem;
+    font-size: 0.75rem;
+    font-weight: 500;
+    color: var(--text-faint);
+  }
+  [data-ui='field'] [data-part='hint'] {
+    font-size: 0.75rem;
+    color: var(--text-faint);
+  }
+  [data-ui='field'] [data-part='description'] {
+    font-size: 0.875rem;
+    color: var(--text-subtle);
+  }
+  [data-ui='field'] [data-part='error'] {
+    font-size: 0.875rem;
+    color: var(--color-danger);
+  }
+
+  /* input shell (when you wrap a native input inside) */
+  [data-ui='field'] [data-part='control'] {
+    /* control shell (keeps visuals on container; native element stays clean) */
+    display: block;
+    width: 100%;
+    border: 1px solid var(--color-border);
+    background: var(--color-surface);
+    color: var(--text);
+    border-radius: var(--radius-md, 0.375rem);
+    padding: 0.5rem 0.75rem;
+    transition: border-color 0.15s ease, background-color 0.15s ease, box-shadow 0.15s ease, outline-color 0.15s ease;
+    position: relative;
+    --_ring-size: var(--ring-size, 1px);
+    --_ring-color: var(--ring-accent, color-mix(in oklab, var(--color-accent) 85%, white 15%));
+  }
+  [data-ui='field'] [data-part='control']:hover {
+    border-color: color-mix(in oklab, var(--color-accent) 28%, var(--color-border));
+  }
+  [data-ui='field'] [data-part='control']:focus-within {
+    outline: none;
+    border-color: var(--color-accent);
+    box-shadow: 0 0 0 var(--_ring-size) var(--_ring-color), 0 2px 14px color-mix(in oklab, var(--color-accent) 10%, transparent);
+  }
+
+  /* Native control resets inside the shell */
+  [data-ui='field']
+    [data-part='control']
+    :is(
+      input[type='text'],
+      input[type='email'],
+      input[type='search'],
+      input[type='password'],
+      input[type='tel'],
+      input[type='url'],
+      input[type='number'],
+      textarea,
+      select
+    ) {
+    background: transparent;
+    border: 0;
+    outline: none;
+    margin: 0;
+    padding: 0;
+    width: 100%;
+    min-width: 0; /* allow shrinking in flex/overflow layouts */
+    font: inherit;
+    line-height: 1.4;
+    color: var(--text);
+    caret-color: var(--color-accent);
+  }
+
+  /* Placeholder & selection */
+  [data-ui='field'] [data-part='control'] :is(input, textarea)::placeholder {
+    color: var(--text-faint);
+    opacity: 1;
+  }
+  [data-ui='field'] [data-part='control'] *::selection {
+    background: color-mix(in oklab, var(--color-accent) 22%, transparent);
+  }
+
+  /* Textarea sizing */
+  [data-ui='field'] [data-part='control'] textarea {
+    resize: vertical;
+    min-height: 2.5rem;
+  }
+
+  /* Select tweaks */
+  [data-ui='field'] [data-part='control'] select {
+    appearance: none;
+    padding-right: 1.5rem; /* room for chevron */
+    background-image: linear-gradient(45deg, transparent 50%, currentColor 50%), linear-gradient(135deg, currentColor 50%, transparent 50%);
+    background-position: right 0.5rem center, right 0.25rem center;
+    background-size: 6px 6px, 6px 6px;
+    background-repeat: no-repeat;
+    color: var(--text);
+  }
+
+  /* Disabled/read-only native controls (mirrors root [data-disabled]) */
+  [data-ui='field'] [data-part='control'] :is(input, textarea, select):disabled,
+  [data-ui='field'][data-disabled] [data-part='control'] :is(input, textarea, select) {
+    cursor: not-allowed;
+    opacity: 0.7;
+  }
+  [data-ui='field'] [data-part='control'] :is(input, textarea, select)[readonly] {
+    opacity: 0.85;
+  }
+
+  /* states */
+  [data-ui='field'][data-state='invalid'] [data-part='control'] {
+    border-color: var(--color-danger);
+    box-shadow: 0 0 0 var(--_ring-size) color-mix(in oklab, var(--color-danger) 60%, transparent);
+  }
+  /* alias: some callers emit 'error' instead of 'invalid' */
+  [data-ui='field'][data-state='error'] [data-part='control'] {
+    border-color: var(--color-danger);
+    box-shadow: 0 0 0 var(--_ring-size) color-mix(in oklab, var(--color-danger) 60%, transparent);
+  }
+
+  /* Disabled — prefer [data-disabled] on root; keep data-state='disabled' for back-compat */
+  [data-ui='field'][data-disabled] [data-part='label'] {
+    color: var(--text-subtle);
+  }
+  [data-ui='field'][data-disabled] [data-part='hint'],
+  [data-ui='field'][data-disabled] [data-part='description'] {
+    color: var(--text-faint);
+  }
+  [data-ui='field'][data-disabled] [data-part='control'] {
+    cursor: not-allowed;
+    opacity: 0.6;
+    background: color-mix(in oklab, var(--surface) 92%, var(--elev) 8%);
+    box-shadow: none;
+    outline: none;
+  }
+  /* Back-compat: support the old state hook */
+  [data-ui='field'][data-state='disabled'] [data-part='label'] {
+    color: var(--text-subtle);
+  }
+  [data-ui='field'][data-state='disabled'] [data-part='hint'],
+  [data-ui='field'][data-state='disabled'] [data-part='description'] {
+    color: var(--text-faint);
+  }
+  [data-ui='field'][data-state='disabled'] [data-part='control'] {
+    cursor: not-allowed;
+    opacity: 0.6;
+    background: color-mix(in oklab, var(--surface) 92%, var(--elev) 8%);
+    box-shadow: none;
+    outline: none;
+  }
+
+  /* calm required marker (dot) */
+  [data-ui='field'] [data-part='label'][data-required]::after {
+    content: '•';
+    margin-left: 0.25rem;
+    opacity: 0.55;
+  }
+}

package/styles/pad.css

@@ -0,0 +1,140 @@
+/* 1) Pad runtime mappings — inherit from global theme */
+@layer base {
+  :root {
+    /* Surfaces & text */
+    --pad-surface: var(--color-surface);
+    --pad-elev: var(--color-elev);
+    --pad-border: var(--color-border);
+    --pad-text: var(--color-text);
+    --pad-text-muted: var(--color-muted);
+    --pad-text-subtle: var(--color-subtle);
+    --pad-text-faint: var(--color-faint);
+
+    /* Accent system */
+    --pad-accent: var(--color-accent);
+    --pad-onaccent: var(--color-on-accent);
+
+    /* Shape & depth */
+    --pad-radius: var(--sheet-radius, var(--radius-2xl));
+    --pad-shadow: var(--shadow-card, 0 6px 18px -6px rgb(0 0 0 / 0.2));
+    --pad-ring: var(--ring-accent, color-mix(in oklab, var(--pad-accent) 85%, white 15%));
+  }
+}
+
+/* 2) Pad-scoped utilities */
+@layer components {
+  .pad-surface {
+    background: var(--pad-surface);
+    color: var(--pad-text);
+  }
+
+  .pad-card {
+    background: var(--pad-elev);
+    color: var(--pad-text);
+    border: 1px solid var(--pad-border);
+    border-radius: var(--pad-radius);
+    box-shadow: var(--pad-shadow);
+  }
+
+  .pad-accent {
+    background: var(--pad-accent);
+    color: var(--pad-onaccent);
+  }
+
+  .pad-ring {
+    box-shadow: 0 0 0 3px var(--pad-ring);
+  }
+}
+
+/* 3) Pad mood & depth utilities (Layered Synesthetic UI) */
+@layer utilities {
+  /* Mood → glow intensity map (used by .mood-glow) */
+  [data-pad-mood='soft'] {
+    --pad-glow: 0.15;
+  }
+  [data-pad-mood='focused'] {
+    --pad-glow: 0.32;
+  }
+  [data-pad-mood='celebratory'] {
+    --pad-glow: 0.55;
+  }
+
+  /* Mood-responsive glow halo. Apply to any rounded container.
+     Tip: wrap your pad header/body in a `.mood-glow` element. */
+  .mood-glow {
+    position: relative;
+  }
+  .mood-glow::before {
+    content: '';
+    position: absolute;
+    inset: -2px;
+    border-radius: inherit;
+    pointer-events: none;
+    background: radial-gradient(120% 120% at 50% 50%, color-mix(in oklab, var(--pad-accent) 65%, transparent 35%) 0%, transparent 60%);
+    filter: blur(24px);
+    opacity: var(--pad-glow, 0.2);
+    transition: opacity var(--duration-normal, 220ms) var(--easing-soft, ease);
+  }
+
+  /* Mood ring — constant outline that scales with mood (pairs well with .mood-glow) */
+  .mood-ring {
+    position: relative;
+  }
+  .mood-ring::after {
+    content: '';
+    position: absolute;
+    inset: 0; /* hugs the element */
+    border-radius: inherit;
+    pointer-events: none;
+    /* width scales a touch with mood; color reuses --pad-ring */
+    box-shadow: 0 0 0 calc(2px + 2px * var(--pad-glow, 0.2)) var(--pad-ring);
+    opacity: clamp(0.25, var(--pad-glow, 0.35), 0.8);
+    transition: opacity var(--duration-normal, 220ms) var(--easing-soft, ease);
+  }
+
+  /* Whisper ring — depth-aware focus/hover outline */
+  .whisper-ring {
+    outline: none;
+    transition: box-shadow var(--duration-snug, 160ms) var(--easing-soft, ease);
+  }
+  [data-depth='0'] .whisper-ring:focus-visible,
+  [data-depth='0'] .whisper-ring:hover {
+    box-shadow: 0 0 0 0 var(--pad-ring);
+  }
+  [data-depth='1'] .whisper-ring:focus-visible,
+  [data-depth='1'] .whisper-ring:hover {
+    box-shadow: 0 0 0 2px var(--pad-ring);
+  }
+  [data-depth='2'] .whisper-ring:focus-visible,
+  [data-depth='2'] .whisper-ring:hover {
+    box-shadow: 0 0 0 3px var(--pad-ring);
+  }
+  [data-depth='3'] .whisper-ring:focus-visible,
+  [data-depth='3'] .whisper-ring:hover {
+    box-shadow: 0 0 0 5px var(--pad-ring);
+  }
+
+  /* Wave visual — fades in with depth (for layered ornaments) */
+  .wave-visual {
+    opacity: 0.15;
+    transition: opacity var(--duration-normal, 220ms) var(--easing-soft, ease);
+  }
+  [data-depth='1'] .wave-visual {
+    opacity: 0.35;
+  }
+  [data-depth='2'] .wave-visual {
+    opacity: 0.6;
+  }
+  [data-depth='3'] .wave-visual {
+    opacity: 0.9;
+  }
+
+  /* A11y: respect motion preferences */
+  @media (prefers-reduced-motion: reduce) {
+    .mood-glow::before,
+    .whisper-ring,
+    .wave-visual {
+      transition: none !important;
+    }
+  }
+}

package/styles/pill.css

@@ -0,0 +1,167 @@
+/* ─────────────────────────────────────────────────────────────
+   Garden UI — Pill skin (opt‑in)
+   Whisper: "labels should sit light, but speak clearly." 🌬️
+
+   Purpose
+     • Selector-only skin for the headless Pill primitive.
+     • Driven entirely by Garden tokens; no hardcoded hex.
+
+   Data API
+     • [data-ui='pill']                             — root
+     • [data-variant='soft|solid|outline|subtle']   — visual weight
+     • [data-tone='subtle|accent|positive|warning|danger']
+     • [data-density='cozy|snug']                   — vertical rhythm
+     • [data-depth='inherit|0|1|2|3']               — shadow depth passthrough (optional)
+
+   Notes
+     • Subtle variant uses neutral surface tokens (good for low-stakes tags).
+     • Variants map tone to color tokens; tones override the default accent.
+     • Keep animations out; density & colors should feel calm by default.
+   ──────────────────────────────────────────────────────────── */
+@layer components {
+  [data-ui='pill'] {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.375rem;
+    border-radius: var(--radius-pill, 9999px);
+    font-weight: 500;
+    line-height: 1;
+    white-space: nowrap;
+    border: 1px solid transparent;
+  }
+
+  /* Density — cozy (default) and snug (compact) */
+  [data-ui='pill'][data-density='cozy'] {
+    padding: 0.375rem 0.625rem;
+    font-size: 0.8125rem;
+  }
+  [data-ui='pill'][data-density='snug'] {
+    padding: 0.25rem 0.5rem;
+    font-size: 0.75rem;
+  }
+
+  [data-ui='pill'] [data-slot~='icon'] {
+    display: inline-flex;
+    align-items: center;
+    flex-shrink: 0;
+  }
+
+  /* Variants — default tone maps to accent palette */
+  [data-ui='pill'][data-variant='solid'] {
+    background: var(--color-accent);
+    color: var(--color-on-accent);
+  }
+  [data-ui='pill'][data-variant='soft'] {
+    background: color-mix(in oklab, var(--color-accent) 16%, transparent);
+    color: var(--color-accent);
+    border-color: color-mix(in oklab, var(--color-accent) 35%, transparent);
+  }
+  [data-ui='pill'][data-variant='outline'] {
+    background: transparent;
+    color: var(--color-accent);
+    border-color: var(--color-accent);
+  }
+
+  /* Tones — override accent mapping for positive|warning|danger */
+  [data-ui='pill'][data-tone='positive'][data-variant='solid'] {
+    background: var(--color-positive);
+    color: var(--color-on-accent);
+  }
+  [data-ui='pill'][data-tone='warning'][data-variant='solid'] {
+    background: var(--color-warning);
+    color: var(--color-on-accent);
+  }
+  [data-ui='pill'][data-tone='danger'][data-variant='solid'] {
+    background: var(--color-danger);
+    color: var(--color-on-accent);
+  }
+
+  [data-ui='pill'][data-tone='positive'][data-variant='soft'] {
+    background: color-mix(in oklab, var(--color-positive) 16%, transparent);
+    color: var(--color-positive);
+    border-color: color-mix(in oklab, var(--color-positive) 35%, transparent);
+  }
+  [data-ui='pill'][data-tone='warning'][data-variant='soft'] {
+    background: color-mix(in oklab, var(--color-warning) 16%, transparent);
+    color: var(--color-warning);
+    border-color: color-mix(in oklab, var(--color-warning) 35%, transparent);
+  }
+  [data-ui='pill'][data-tone='danger'][data-variant='soft'] {
+    background: color-mix(in oklab, var(--color-danger) 16%, transparent);
+    color: var(--color-danger);
+    border-color: color-mix(in oklab, var(--color-danger) 35%, transparent);
+  }
+
+  [data-ui='pill'][data-tone='positive'][data-variant='outline'] {
+    color: var(--color-positive);
+    border-color: var(--color-positive);
+  }
+  [data-ui='pill'][data-tone='warning'][data-variant='outline'] {
+    color: var(--color-warning);
+    border-color: var(--color-warning);
+  }
+  [data-ui='pill'][data-tone='danger'][data-variant='outline'] {
+    color: var(--color-danger);
+    border-color: var(--color-danger);
+  }
+
+  /* Subtle — neutral surface, gentle border; text uses neutral color token */
+  [data-ui='pill'][data-variant='subtle'] {
+    background: var(--color-fill-subtle);
+    color: var(--color-text);
+    border-color: color-mix(in oklab, var(--color-text) 12%, transparent);
+  }
+  /* Depth passthrough — opt‑in shadow for chip emphasis */
+  [data-ui='pill'][data-depth='inherit'] { box-shadow: var(--depth-shadow, var(--shadow-depth-1)); }
+  [data-ui='pill'][data-depth='0'] { box-shadow: var(--shadow-depth-0); }
+  [data-ui='pill'][data-depth='1'] { box-shadow: var(--shadow-depth-1); }
+  [data-ui='pill'][data-depth='2'] { box-shadow: var(--shadow-depth-2); }
+  [data-ui='pill'][data-depth='3'] { box-shadow: var(--shadow-depth-3); }
+
+  /* Tone → focus ring color variable (used by :focus-visible) */
+  [data-ui='pill'][data-tone='subtle']  { --ring-accent: color-mix(in oklab, var(--color-text) 80%, white 20%); }
+  [data-ui='pill'][data-tone='accent']  { --ring-accent: color-mix(in oklab, var(--color-accent) 85%, white 15%); }
+  [data-ui='pill'][data-tone='positive']{ --ring-accent: color-mix(in oklab, var(--color-positive) 85%, white 15%); }
+  [data-ui='pill'][data-tone='warning'] { --ring-accent: color-mix(in oklab, var(--color-warning) 85%, white 15%); }
+  [data-ui='pill'][data-tone='danger']  { --ring-accent: color-mix(in oklab, var(--color-danger) 85%, white 15%); }
+
+  /* Focus-visible — gentle tokenized outline for focusable pills */
+  [data-ui='pill']:focus-visible {
+    outline: 2px solid var(--ring-accent, color-mix(in oklab, var(--color-accent) 85%, white 15%));
+    outline-offset: 2px;
+  }
+  /* Optional: interactive hover/active soften (opt‑in or semantic elements) */
+  [data-ui='pill'][data-interactive='true'],
+  button[data-ui='pill'],
+  a[data-ui='pill'] {
+    transition: filter var(--duration-snug, 160ms) var(--ease-soft, ease);
+  }
+  [data-ui='pill'][data-interactive='true']:hover,
+  button[data-ui='pill']:hover,
+  a[data-ui='pill']:hover {
+    filter: brightness(1.01);
+  }
+  [data-ui='pill'][data-interactive='true']:active,
+  button[data-ui='pill']:active,
+  a[data-ui='pill']:active {
+    filter: brightness(0.99);
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    [data-ui='pill'][data-interactive='true'],
+    button[data-ui='pill'],
+    a[data-ui='pill'] {
+      transition: none;
+    }
+  }
+
+  /* Disabled state — dim + no soften; supports native and ARIA patterns */
+  [data-ui='pill'][aria-disabled='true'],
+  button[data-ui='pill'][disabled],
+  a[data-ui='pill'][aria-disabled='true'] {
+    opacity: 0.55;
+    filter: none !important;
+    cursor: not-allowed;
+    pointer-events: none;
+  }
+}