@aexol/spectral 0.7.0 → 0.7.1

package/dist/designer/data/systems/default/tokens.css

@@ -0,0 +1,200 @@
+/* ─────────────────────────────────────────────────────────────────────────
+ * design-systems/default/tokens.css
+ *
+ * Structured token bindings for "Neutral Modern" — the canonical
+ * starter design system. This file is the *machine-readable* form of
+ * the values described in `DESIGN.md`. Agents are expected to paste
+ * the `:root { … }` block verbatim into the first `<style>` of every
+ * artifact they generate against this design system, then reference
+ * tokens via `var(--name)` from then on.
+ *
+ * Why this file exists:
+ *   DESIGN.md gives humans context ("Accent #2F6FEB — primary CTAs"),
+ *   but agents have to translate prose names like "Accent" into the
+ *   standard token names the lint enforces (`--accent`). That
+ *   translation is where token misuse happens. This file pre-translates
+ *   the brand once, so agents copy structure instead of inventing it.
+ *
+ * Contract sources:
+ *   - Standard token names: craft/color.md
+ *       (--bg / --surface / --fg / --muted / --border / --accent
+ *        / --success / --warn / --danger)
+ *   - Display-face contract: craft/anti-ai-slop.md
+ *       (--font-display, must be referenced via var())
+ *   - Lint enforcement: apps/daemon/src/lint-artifact.ts
+ *       (raw-hex >12 outside :root → P1; indigo laundering → P0)
+ *
+ * Schema notes (the shared schema grew from kami's stress test —
+ * see design-systems/kami/tokens.css for the rich form, and the
+ * #Gap N tags below for what each addition resolves):
+ *   #Gap 1  — 4-level foreground ramp (fg / fg-2 / muted / meta)
+ *   #Gap 2  — 3-level surface (bg / surface / surface-warm)
+ *   #Gap 3  — 2-level border (border / border-soft)
+ *   #Gap 4  — accent-hover binds to value, not formula
+ *   #Gap 5  — ring elevation as a first-class level (--elev-ring)
+ *
+ * Default doesn't differentiate every level kami needs, so the
+ * shallow tokens (`--fg-2`, `--meta`, `--surface-warm`, `--border-soft`)
+ * collapse to their richer siblings via `var()`. The names still
+ * exist so components can reference them uniformly across brands.
+ *
+ * Keep this file additive: never invent token names not also documented
+ * in DESIGN.md or the craft contracts. New brands cloning this template
+ * should overwrite values, not rename keys.
+ * ─────────────────────────────────────────────────────────────────── */
+
+:root {
+  /* ─── Surface (3 levels — #Gap 2) ─────────────────────────────────
+   * Per craft/color.md: never pure black, never pure white. Default
+   * uses #FAFAFA for bg and #FFFFFF for surface — the cream-to-white
+   * contrast gives cards lift without a shadow. `--surface-warm` is a
+   * schema slot for brands that need a tertiary tier (kami's warm-sand
+   * button bg); default has no third tier and aliases it to surface. */
+  --bg: #fafafa;
+  --surface: #ffffff;
+  --surface-warm: var(--surface);   /* alias — default has no warm tier */
+
+  /* ─── Foreground ramp (4 levels — #Gap 1) ───────────────────────
+   * Default differentiates only two text levels (primary + muted).
+   * `--fg-2` and `--meta` are schema slots for brands with richer
+   * ramps (kami uses near-black / dark-warm / olive / stone). They
+   * alias here so components targeting the full ramp resolve. */
+  --fg: #111111;
+  --fg-2: var(--fg);                /* alias — default has no secondary tier */
+  --muted: #6b6b6b;
+  --meta: var(--muted);             /* alias — default has no metadata tier */
+
+  /* ─── Border (2 levels — #Gap 3) ────────────────────────────────
+   * Default has one border weight; `--border-soft` is a schema slot
+   * for brands with row-separator vs card-edge differentiation. */
+  --border: #e5e5e5;
+  --border-soft: var(--border);     /* alias — default has no soft tier */
+
+  /* ─── Accent ──────────────────────────────────────────────────────
+   * Cobalt — primary CTAs, links, ONE hero element per screen.
+   * Hard cap of 2 visible uses per screen is enforced by lint
+   * (`accent-overuse` P1 fires at >6 inline occurrences). */
+  --accent: #2f6feb;
+  --accent-on: #ffffff; /* fg when accent is the bg (e.g. button label) */
+
+  /* ─── Accent states (#Gap 4) ────────────────────────────────────
+   * Hover and active variants for any element using --accent as bg.
+   * Default's mid-luminance cobalt admits a black-mix formula
+   * cleanly; that's a brand-specific binding, NOT a schema rule.
+   * kami binds --accent-hover to var(--accent) (no color shift,
+   * hover via elevation) because ink-blue is too dark for further
+   * darkening to read; other brands with light accents must
+   * hand-pick.
+   *
+   * Schema rule: every brand provides --accent-hover and
+   * --accent-active. The binding strategy (formula / identity /
+   * hand-picked) is brand-decided.
+   *
+   * Why these two are tokens (and other tints stay inline):
+   *   - cross-component (button, chip, tab, dropdown all need them)
+   *   - cross-mode reversal (dark-mode hover should mix white, not
+   *     black — token re-binding is one line per mode)
+   *   - cross-brand customization (formula breaks on light accents)
+   *   - lint-enforceable contract (every brand must provide these)
+   * Other inline `color-mix(...)` calls in components don't yet hit
+   * any of the above — promote them to tokens when a second use
+   * appears. */
+  --accent-hover: color-mix(in oklab, var(--accent), black 8%);
+  --accent-active: color-mix(in oklab, var(--accent), black 14%);
+
+  /* ─── Semantic ────────────────────────────────────────────────────
+   * Reserved for state, not decoration. Keep total semantic-color
+   * pixels under 5% of the surface. */
+  --success: #17a34a;
+  --warn: #eab308;
+  --danger: #dc2626;
+
+  /* ─── Typography ──────────────────────────────────────────────────
+   * Inter for display is the documented "modern minimal" override
+   * to anti-ai-slop's serif-display rule (see DESIGN.md
+   * §Visual Theme & Atmosphere — "Calm, functional, quietly
+   * confident"). Other brands should rebind --font-display to a
+   * serif unless their direction is also tech/utility. */
+  --font-display: "Inter", -apple-system, system-ui, sans-serif;
+  --font-body: "Inter", -apple-system, system-ui, sans-serif;
+  --font-mono: ui-monospace, "JetBrains Mono", monospace;
+
+  /* Type scale (px) — direct copy of DESIGN.md §Typography Rules */
+  --text-xs: 12px;
+  --text-sm: 14px;
+  --text-base: 16px;
+  --text-lg: 20px;
+  --text-xl: 24px;
+  --text-2xl: 32px;
+  --text-3xl: 48px;
+  --text-4xl: 64px;
+
+  --leading-body: 1.5;
+  --leading-tight: 1.2;
+  --tracking-display: -0.01em; /* applied to display sizes ≥32px */
+
+  /* ─── Spacing ─────────────────────────────────────────────────────
+   * 4px base unit. Section rhythm (80/48/32) lives below as named
+   * tokens because DESIGN.md §Layout Principles treats them as
+   * breakpoint-specific decisions, not generic spacing. */
+  --space-1: 4px;
+  --space-2: 8px;
+  --space-3: 12px;
+  --space-4: 16px;
+  --space-5: 20px;
+  --space-6: 24px;
+  --space-8: 32px;
+  --space-12: 48px;
+  --space-20: 80px;
+
+  --section-y-desktop: 80px;
+  --section-y-tablet: 48px;
+  --section-y-phone: 32px;
+
+  /* ─── Radius ──────────────────────────────────────────────────────
+   * Two intents: small (button/input) and medium (card/modal).
+   * `--radius-pill` reserved for chips/avatars; do not use it on
+   * cards or buttons. */
+  --radius-sm: 8px;
+  --radius-md: 12px;
+  --radius-lg: 16px;
+  --radius-pill: 9999px;
+
+  /* ─── Elevation (3 levels — #Gap 5) ─────────────────────────────
+   * Default uses two levels (flat + raised blur shadow) per its own
+   * DESIGN.md §Depth & Elevation. The schema gains `--elev-ring` as
+   * a first-class level so brands using ring shadows as primary
+   * elevation (kami, paper, editorial) don't need to rebind
+   * --elev-raised away from blur. Default declares all three; ring
+   * is available for hairline edges where a 1px border would shift
+   * layout. No fourth level — that's neumorphism territory. */
+  --elev-flat: none;
+  --elev-ring: 0 0 0 1px var(--border);
+  --elev-raised: 0 2px 8px color-mix(in oklab, var(--fg), transparent 92%);
+
+  /* ─── Focus ring ──────────────────────────────────────────────────
+   * Single source of truth for keyboard-focus indicators. Every
+   * `:focus-visible` rule on buttons, inputs, links, and tabs must
+   * use this token — uniform behavior is itself a brand signal, and
+   * craft/accessibility-baseline.md treats focus visibility as a
+   * non-negotiable. Implemented as a `box-shadow` so it layers
+   * outside the element without affecting layout. */
+  --focus-ring: 0 0 0 3px color-mix(in oklab, var(--accent), transparent 70%);
+
+  /* ─── Motion ──────────────────────────────────────────────────────
+   * Two durations + one easing curve, per anti-ai-slop's "short,
+   * purposeful transitions (150–250ms) with stable easing". Add a
+   * third duration only when a real interaction needs it; do not
+   * invent `--motion-slow` speculatively. */
+  --motion-fast: 150ms;            /* hover, focus, micro-states */
+  --motion-base: 200ms;            /* general state changes */
+  --ease-standard: cubic-bezier(0.2, 0, 0, 1);
+
+  /* ─── Layout ──────────────────────────────────────────────────────
+   * Container width and per-breakpoint gutter. Skill-side responsive
+   * code reads these to decide grid columns. */
+  --container-max: 1200px;
+  --container-gutter-desktop: 24px;
+  --container-gutter-tablet: 16px;
+  --container-gutter-phone: 12px;
+}

package/dist/designer/data/systems/discord/DESIGN.md

@@ -0,0 +1,162 @@
+# Design System Inspired by Discord
+
+> Category: Productivity & SaaS
+> Voice / chat platform. Deep blurple, dark-first surfaces, playful accent moments.
+
+## 1. Visual Theme & Atmosphere
+
+Discord's product is engineered for evenings, raids, and group voice — so the entire surface is dark-first. The default canvas is the deep `Background Primary` (`#313338` light theme, `#1e1f22` dark theme), with chat columns layered on slightly lighter or darker shades to denote channels, threads, and side panels. The signature **Blurple** (`#5865f2`) is reserved for the brand mark, primary CTAs, mentions, and the "you" affordance — used sparingly so it pops against the muted neutrals.
+
+Typography is **gg sans** (Discord's custom Whitney-replacement) for prose and chrome, with rounded geometric shapes that feel approachable but still legible at the small sizes a chat client demands. Headings step up incrementally; chat rows are tight (4–8px between message groups) so hours of scrollback feel scannable.
+
+The shape language is rounded but not balloon-soft: 8px radii on cards, 4px on inputs, full pills on status badges and tags. Servers are rounded-square avatars at 48px that morph to circles on hover — a tiny piece of motion that has become part of the brand's identity.
+
+**Key Characteristics:**
+- Dark-first surfaces: `#1e1f22` / `#2b2d31` / `#313338` (3-step depth)
+- Blurple `#5865f2` as the only saturated accent in the chat surface
+- gg sans (Whitney-style) for all text — friendly, geometric, neutral
+- Rounded-square server avatars (16px radius) that snap to circles on hover
+- Tight chat-row spacing, generous side-panel padding
+- Status dots: green online, yellow idle, red dnd, gray offline
+- Pixel-snapped 1px dividers in subtle off-white at low alpha
+
+## 2. Color Palette & Roles
+
+### Primary
+- **Blurple** (`#5865f2`): Brand primary, primary CTA, mention highlight.
+- **Blurple Hover** (`#4752c4`): Hover/active for blurple.
+- **Blurple Soft** (`#7289da`): Legacy blurple, secondary accent in marketing.
+
+### Surface (Dark Theme — default)
+- **Background Tertiary** (`#1e1f22`): Server list rail, deepest background.
+- **Background Secondary** (`#2b2d31`): Channel sidebar, settings sidebar.
+- **Background Primary** (`#313338`): Chat surface, message column.
+- **Background Floating** (`#111214`): Floating popovers, tooltips, autocomplete.
+- **Background Modifier Hover** (`rgba(78, 80, 88, 0.3)`): Hover overlay on rows.
+- **Background Modifier Selected** (`rgba(78, 80, 88, 0.6)`): Active row.
+
+### Surface (Light Theme)
+- **Light Bg Primary** (`#ffffff`): Chat surface in light theme.
+- **Light Bg Secondary** (`#f2f3f5`): Sidebar in light theme.
+- **Light Bg Tertiary** (`#e3e5e8`): Deepest light surface.
+
+### Text
+- **Header Primary** (`#f2f3f5`): Channel headers, modal titles in dark theme.
+- **Header Secondary** (`#b5bac1`): Muted headers.
+- **Text Normal** (`#dbdee1`): Body text in dark theme — slightly cooler than pure white.
+- **Text Muted** (`#949ba4`): Timestamps, server names, secondary metadata.
+- **Text Link** (`#00a8fc`): Hyperlinks in messages — sky blue, distinct from blurple.
+- **Channels Default** (`#80848e`): Inactive channel name in sidebar.
+
+### Status & Semantic
+- **Status Online** (`#23a55a`): Online dot, success states.
+- **Status Idle** (`#f0b232`): Idle dot, away.
+- **Status DND** (`#f23f43`): Do-not-disturb, also serves as destructive red.
+- **Status Streaming** (`#593695`): "Streaming" purple.
+- **Status Offline** (`#80848e`): Offline gray.
+- **Mention Highlight** (`rgba(88, 101, 242, 0.1)`): Soft blurple wash on @mention rows.
+
+### Border & Divider
+- **Background Modifier Accent** (`rgba(255, 255, 255, 0.06)`): Standard divider in dark.
+- **Border Subtle** (`#3f4147`): Solid divider for cards.
+
+## 3. Typography Rules
+
+### Font Family
+- **Body / UI / Headings**: `gg sans`, with fallback: `"Helvetica Neue", Helvetica, Arial, sans-serif`
+- **Display (legacy / Whitney)**: `Whitney`, with fallback: `gg sans`
+- **Code / Mono**: `"gg mono"`, with fallback: `Consolas, Andale Mono, Courier New, Courier, monospace`
+
+### Hierarchy
+
+| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
+|------|------|------|--------|-------------|----------------|-------|
+| Display Hero | gg sans | 56px (3.5rem) | 800 | 1.1 | -0.02em | Marketing hero |
+| Page Heading | gg sans | 24px (1.5rem) | 700 | 1.25 | normal | Settings/profile titles |
+| Channel Name | gg sans | 16px (1rem) | 600 | 1.25 | normal | `#general`, channel header |
+| Message Body | gg sans | 16px (1rem) | 400 | 1.375 | normal | Standard chat text |
+| Username | gg sans | 16px (1rem) | 500 | 1.25 | normal | Author of a message |
+| Timestamp | gg sans | 12px (0.75rem) | 500 | 1.25 | normal | "Today at 4:32 PM" |
+| Sidebar Channel | gg sans | 16px (1rem) | 500 | 1.25 | normal | Channel list rows |
+| Server Name | gg sans | 16px (1rem) | 600 | 1.25 | normal | Server header |
+| Caption / Meta | gg sans | 12px (0.75rem) | 400 | 1.3 | 0.02em | Status text, edited tag |
+| Code Inline | gg mono | 0.875em | 400 | inherit | normal | Inline `code` |
+| Code Block | gg mono | 14px (0.875rem) | 400 | 1.5 | normal | ```triple-fenced``` block |
+
+### Principles
+- **Friendly geometry**: gg sans replaces Whitney with rounded terminals on a/g/s — the brand wants warmth without breaking legibility.
+- **Weight contrast over color contrast**: hierarchy comes from 400→500→600→700→800 weight steps; the surface stays neutral.
+- **16px body**: chat messages do not shrink below 16px. Density comes from line-height (1.375), not font size.
+
+## 4. Component Stylings
+
+### Buttons
+
+**Primary**
+- Background: `#5865f2`
+- Text: `#ffffff`
+- Padding: 8px 16px
+- Radius: 4px
+- Hover: `#4752c4`
+- Use: Primary CTAs, "Continue", "Join Server"
+
+**Secondary**
+- Background: `#4e5058`
+- Text: `#ffffff`
+- Padding: 8px 16px
+- Radius: 4px
+- Hover: `#6d6f78`
+
+**Tertiary / Subtle (Link-style)**
+- Background: transparent
+- Text: `#dbdee1`
+- Hover: text underlined, no background change
+
+**Danger**
+- Background: `#da373c`
+- Text: `#ffffff`
+- Hover: `#a12d2f`
+
+### Inputs
+- Background: `#1e1f22`
+- Text: `#dbdee1`
+- Border: 1px solid `#1e1f22`
+- Radius: 4px
+- Padding: 10px 12px
+- Focus: border `#5865f2`
+
+### Server Avatars
+- Size: 48×48px
+- Radius: 16px (rounded square) by default; transitions to 50% on hover and active.
+- Active state: 4px white pill on the left edge of the icon column.
+
+### Status Dots
+- Size: 10×10px
+- Border: 3px solid background-tertiary (creates the "notch" effect)
+- Position: bottom-right of avatar.
+
+### Cards / Embeds
+- Background: `#2b2d31` (dark) or `#f2f3f5` (light)
+- Left border: 4px solid embed accent color.
+- Radius: 4px
+- Padding: 8px 16px
+
+### Mention Pill
+- Background: `rgba(88, 101, 242, 0.3)`
+- Text: `#c9cdfb`
+- Padding: 0 2px
+- Radius: 3px
+
+## 5. Spacing & Layout
+
+- **Base unit**: 4px. Scale: 4, 8, 12, 16, 20, 24, 32, 40.
+- **Server rail**: 72px wide, fixed.
+- **Channel sidebar**: 240px wide.
+- **Member list**: 240px wide on desktop.
+- **Chat column**: fluid, min 380px.
+
+## 6. Motion
+
+- **Duration**: 200ms for hover; 350ms for the avatar circle-morph; 80ms for tooltip fade.
+- **Easing**: `cubic-bezier(0.215, 0.61, 0.355, 1)` for the avatar morph (snappy then settle).
+- **Notification pulse**: 1.4s ease-in-out infinite on unread mention indicator.