@aexol/spectral 0.7.0 → 0.7.1

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

@@ -0,0 +1,242 @@
+/* ─────────────────────────────────────────────────────────────────────────
+ * design-systems/ollama/tokens.css
+ *
+ * Structured token bindings for "Ollama" — radical minimalism for the
+ * local-LLM runtime. The brand strips every form of decoration away
+ * until only the essential tool remains: pure-white canvas, zero
+ * chromatic color anywhere on screen, no shadows ever, and a binary
+ * radius system that separates "container" (12px) from "interactive"
+ * (pill / 9999px). DESIGN.md is emphatic on every front — the absence
+ * of design IS the design.
+ *
+ * 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. The corresponding `components.html` mirrors this block
+ * with comments stripped; keep the two in sync byte-for-byte after
+ * normalization, or the `tokens-fixture-sync` guard will fail.
+ *
+ * Brand notes (the values below intentionally invert several
+ * assumptions baked into the default brand):
+ *
+ *   #Decision 1 — `--bg` is pure white, `--surface` is the lift.
+ *     Default does the opposite (cream bg, white surface) because
+ *     it wants card-lift warmth; ollama wants paper-flat purity, so
+ *     #ffffff is the canvas and #fafafa (Snow) is the subtle lift.
+ *
+ *   #Decision 2 — `--accent` is pure black, not a chromatic CTA hue.
+ *     Per DESIGN.md §2 the entire interface is grayscale; the only
+ *     chromatic exception is the keyboard focus ring (#3b82f6 at
+ *     50% alpha). The "Download" / "Create account" pills that
+ *     occupy the accent role are black-on-white, so the accent
+ *     token binds to #000 and accent-on binds to #fff.
+ *
+ *   #Decision 3 — every interactive radius collapses to pill.
+ *     DESIGN.md §5 prescribes a strictly binary radius system with
+ *     no intermediate steps. `--radius-sm`, `--radius-pill` (and
+ *     `--radius-lg` for consistency) all resolve to 9999px so any
+ *     component reaching for `--radius-sm` (button, input, tag,
+ *     chip) inherits the brand stance instead of a stray 8px.
+ *
+ *   #Decision 4 — every elevation tier is the hairline border ring,
+ *     never a blur shadow. DESIGN.md §6 is explicit: "Ollama uses
+ *     zero shadows. This is not an oversight — it's a deliberate
+ *     design decision." `--elev-raised` therefore mirrors
+ *     `--elev-ring` instead of binding to a blur drop-shadow.
+ *
+ *   #Decision 5 — display font is SF Pro Rounded. The rounded
+ *     terminals ARE the brand expression — they soften a developer
+ *     CLI tool into something approachable without compromising the
+ *     monochrome / minimal philosophy. Falls back to system-ui on
+ *     non-Apple platforms (the duplicate `system-ui` in the stack is
+ *     copied verbatim from DESIGN.md §3 to keep the prose ↔ token
+ *     mapping audit-trivial).
+ *
+ * Schema slot collapse (see _schema/AGENTS.md for the layer model):
+ *
+ *   --surface-warm aliases --surface — the canvas is grayscale by
+ *     definition, so there is no warm tertiary surface tier.
+ *   --border-soft aliases --border — DESIGN.md §6 prescribes a single
+ *     1px hairline weight; row separators and card edges share it.
+ *   --fg-2 / --meta bind to real values — ollama is monochrome but
+ *     differentiates 4 text levels (black / near-black / Stone /
+ *     Silver) so the ramp earns independent slots.
+ *
+ * Keep this file additive: never invent token names not also
+ * documented in DESIGN.md or the craft contracts. Ollama is not in
+ * BRAND_EXTENSIONS, so any unknown token will fail the
+ * `unknown-token-allowlist` guard.
+ * ─────────────────────────────────────────────────────────────── */
+
+:root {
+  /* ─── Surface (3 levels) ────────────────────────────────────────
+   * Pure white IS the brand canvas — DESIGN.md §2 is emphatic:
+   * "not off-white, not cream, pure white." `--surface` lifts to
+   * Snow (#fafafa), the subtlest possible distinction from #fff,
+   * for sections and barely-elevated containers. No third tier:
+   * `--surface-warm` aliases to surface because the brand is
+   * grayscale by definition. */
+  --bg: #ffffff;
+  --surface: #fafafa;
+  --surface-warm: var(--surface);   /* alias — ollama is monochrome */
+
+  /* ─── Foreground ramp (4 levels) ────────────────────────────────
+   * The full grayscale text ramp from DESIGN.md §2:
+   *   Pure Black  (#000000) — primary headlines, demanding attention
+   *   Near Black  (#262626) — button text, secondary headline weight
+   *   Stone       (#737373) — body, footer links, de-emphasized copy
+   *   Silver      (#a3a3a3) — placeholders, tertiary metadata
+   * The contrast between black and Stone is wide enough that the
+   * brand can avoid font-weight ≥600 entirely. */
+  --fg: #000000;
+  --fg-2: #262626;                  /* Near Black */
+  --muted: #737373;                 /* Stone */
+  --meta: #a3a3a3;                  /* Silver */
+
+  /* ─── Border (2 levels) ─────────────────────────────────────────
+   * Light Gray (#e5e5e5) is the workhorse containment color and
+   * the only border weight ollama permits. DESIGN.md §7 forbids
+   * borders heavier than 1px; `--border-soft` aliases to keep that
+   * stance intact for components that reach for a softer divider. */
+  --border: #e5e5e5;
+  --border-soft: var(--border);     /* alias — single border weight */
+
+  /* ─── Accent ────────────────────────────────────────────────────
+   * Pure Black IS the accent here — the black-pill CTA ("Download",
+   * "Create account") is ollama's maximum-emphasis element. DESIGN.md
+   * §2 forbids chromatic color in normal flow, so the accent role
+   * is fulfilled by the darkest tone rather than a brand hue.
+   *
+   * Hover and active states LIGHTEN rather than darken (pure black
+   * cannot darken further). The values come from DESIGN.md §2's
+   * documented Near-Black (#262626) and Button-Text-Dark (#404040)
+   * stops on the gray ramp, so the hover stack stays on-brand
+   * instead of formula-derived. */
+  --accent: #000000;
+  --accent-on: #ffffff;
+  --accent-hover: #262626;          /* Near Black — subtle lift */
+  --accent-active: #404040;         /* Button Text Dark — pressed */
+
+  /* ─── Semantic ──────────────────────────────────────────────────
+   * DESIGN.md §2 explicitly says "no semantic red, no accent green"
+   * in normal flow — but the schema requires these tokens for error
+   * toasts and status indicators that the runtime will eventually
+   * surface (model download failures, daemon health checks). Bound
+   * to the schema fallbacks so the names resolve; components must
+   * use them sparingly and never as decoration. */
+  --success: #16a34a;
+  --warn: #eab308;
+  --danger: #dc2626;
+
+  /* ─── Typography — fonts ────────────────────────────────────────
+   * SF Pro Rounded is Apple's rounded system font — its softened
+   * letterforms ARE the brand expression. Renders rounded terminals
+   * on macOS/iOS, falls back to the platform system sans elsewhere
+   * (the duplicate `system-ui` in the stack mirrors DESIGN.md §3
+   * verbatim — redundant but documented).
+   *
+   * Body text uses ui-sans-serif so reading copy stays platform-
+   * native; the emoji fonts in the stack come straight from DESIGN.md
+   * §3's body fallback list. Monospace gets a deliberately broad
+   * stack so `ollama run …` snippets render consistently across
+   * macOS / Linux / Windows. */
+  --font-display: "SF Pro Rounded", system-ui, -apple-system, system-ui;
+  --font-body: ui-sans-serif, system-ui, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+  --font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
+
+  /* Type scale (px) — direct copy of DESIGN.md §3 hierarchy table.
+   * Ollama's display tier tops out at 48px (versus default's 64px)
+   * because the homepage is intentionally short and uncluttered;
+   * even the hero stays restrained. */
+  --text-xs: 12px;                  /* Small */
+  --text-sm: 14px;                  /* Caption */
+  --text-base: 16px;                /* Body / Link */
+  --text-lg: 18px;                  /* Body Large */
+  --text-xl: 24px;                  /* Card Title */
+  --text-2xl: 30px;                 /* Sub-heading */
+  --text-3xl: 36px;                 /* Section Heading */
+  --text-4xl: 48px;                 /* Display / Hero */
+
+  /* Leading & tracking — DESIGN.md §3 prescribes tight (1.0) for
+   * display and comfortable (1.5) for body. Tracking is `normal`
+   * across every tier (no negative letter-spacing on display, no
+   * uppercase tightening). */
+  --leading-body: 1.5;
+  --leading-tight: 1;
+  --tracking-display: 0;
+
+  /* ─── Spacing ────────────────────────────────────────────────────
+   * 4px base unit. DESIGN.md §5 defines an extended scale up to
+   * 112px for section rhythm; the shared schema caps at --space-12
+   * so the wider tiers express themselves through the section-y
+   * tokens below. */
+  --space-1: 4px;
+  --space-2: 8px;
+  --space-3: 12px;
+  --space-4: 16px;
+  --space-5: 20px;
+  --space-6: 24px;
+  --space-8: 32px;
+  --space-12: 48px;
+
+  /* DESIGN.md §5 is direct — section vertical spacing is "very
+   * generous (88–112px)" because "the white space IS the brand."
+   * Desktop sits at the top of that range deliberately; tablet and
+   * phone collapse but stay roomy. */
+  --section-y-desktop: 112px;
+  --section-y-tablet: 88px;
+  --section-y-phone: 48px;
+
+  /* ─── Radius (binary system) ───────────────────────────────────
+   * DESIGN.md §5 prescribes a strictly binary radius system: 12px
+   * for containers, 9999px (pill) for everything interactive. No
+   * intermediate values exist on this brand. Every interactive
+   * radius — `--radius-sm`, `--radius-lg`, `--radius-pill` —
+   * resolves to the pill value so a component reaching for the
+   * small button radius inherits the brand stance. `--radius-md`
+   * holds the 12px container radius. */
+  --radius-sm: 9999px;
+  --radius-md: 12px;
+  --radius-lg: 9999px;
+  --radius-pill: 9999px;
+
+  /* ─── Elevation ────────────────────────────────────────────────
+   * "Ollama uses zero shadows. This is not an oversight — it's a
+   * deliberate design decision." (DESIGN.md §6) Every level of
+   * depth comes from a 1px hairline border ring instead of a blur
+   * shadow. `--elev-raised` mirrors `--elev-ring` so components
+   * targeting a raised tier still receive the only legitimate
+   * depth treatment ollama permits. */
+  --elev-flat: none;
+  --elev-ring: 0 0 0 1px var(--border);
+  --elev-raised: 0 0 0 1px var(--border);
+
+  /* ─── Focus ring ───────────────────────────────────────────────
+   * The single chromatic exception in the entire system — Tailwind's
+   * default ring (#3b82f6 at 50% transparency). DESIGN.md §2 explicitly
+   * carves this out for keyboard accessibility; never visible during
+   * normal interaction flow. The raw hex is documented inside the
+   * token expression so brand-aware components can stay grayscale
+   * elsewhere. */
+  --focus-ring: 0 0 0 3px color-mix(in oklab, #3b82f6, transparent 50%);
+
+  /* ─── Motion ───────────────────────────────────────────────────
+   * DESIGN.md §7 is direct: "interactions should feel instant and
+   * direct." Durations stay short enough that transitions register
+   * as responsiveness rather than animation. The easing curve stays
+   * on the standard ease-out so the snap still feels mechanical
+   * rather than abrupt. */
+  --motion-fast: 100ms;
+  --motion-base: 140ms;
+  --ease-standard: cubic-bezier(0.2, 0, 0, 1);
+
+  /* ─── Layout ───────────────────────────────────────────────────
+   * Max container width sits at the upper end of DESIGN.md §5's
+   * "~1024–1280px" range; gutters scale down through the breakpoints
+   * but stay generous to preserve the "white space IS the brand"
+   * stance. */
+  --container-max: 1280px;
+  --container-gutter-desktop: 24px;
+  --container-gutter-tablet: 16px;
+  --container-gutter-phone: 12px;
+}

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

@@ -0,0 +1,140 @@
+# Design System Inspired by OpenAI
+
+> Category: AI & LLM
+> Calm, near-monochrome system anchored in deep teal-black with generous white space and editorial typography.
+
+## 1. Visual Theme & Atmosphere
+
+OpenAI's product surface reads like a research lab dressed for the public — clinical, restrained, deliberately quiet. The page background is a true white (`#ffffff`) layered against a near-black ink (`#0d0d0d`) with a subtle teal undertone, so even the text feels slightly cooled rather than aggressively dark. The result is a chromatic neutrality that puts model output, code, and prose front and center, not the chrome around them.
+
+The signature move is the use of **Söhne** (or its system stand-in `inter`) at restrained weights — 400 for body, 500 for nav and labels, 600 for emphasis — paired with **Signifier**, a contemporary serif used for editorial display. Where most AI brands lean futuristic, OpenAI's serif headlines give the product a quietly literary tone, as if every announcement is an essay.
+
+The shape system is uniformly soft: 8px–12px radii, 9999px pills for tags and chips, no harsh corners anywhere. Section transitions are denoted by whitespace rather than dividers; when borders appear they are `#e5e5e5` hairlines that read as the absence of color rather than its presence.
+
+**Key Characteristics:**
+- True white canvas (`#ffffff`) with deep teal-black ink (`#0d0d0d`)
+- Söhne / Inter at modest weights (400, 500, 600) — restraint over assertion
+- Signifier serif for editorial display headlines
+- Soft 8–12px radii everywhere; 9999px pills for chips
+- Hairline borders (`#e5e5e5`) used sparingly; whitespace as primary divider
+- Single-color illustrations in deep teal — no gradients in marks
+- Generous line-height (1.55–1.65) and tracking near zero
+
+## 2. Color Palette & Roles
+
+### Primary
+- **Pure White** (`#ffffff`): Primary background, card surface, button background.
+- **Ink Black** (`#0d0d0d`): Primary text, brand mark, primary CTA.
+- **Soft Black** (`#1a1a1a`): Secondary heading, alternative ink for non-critical text.
+
+### Surface & Background
+- **Mist** (`#fafafa`): Section break background, footer surface.
+- **Pearl** (`#f5f5f5`): Card surface, elevated panel.
+- **Cloud** (`#ececec`): Disabled background, divider tint.
+
+### Brand Accent
+- **OpenAI Teal** (`#10a37f`): Brand primary, link, highlight badge — the lone color in an otherwise neutral system.
+- **Teal Deep** (`#0a7a5e`): Hover and pressed state for the brand color.
+- **Teal Soft** (`#e8f5f0`): Surface tint for success badges, highlight callouts.
+
+### Neutrals & Text
+- **Graphite** (`#3c3c3c`): Body text, default reading color.
+- **Slate** (`#6e6e6e`): Secondary text, captions, metadata.
+- **Ash** (`#9b9b9b`): Tertiary text, placeholder, disabled label.
+- **Stone** (`#c4c4c4`): Decorative dividers, faint icons.
+
+### Semantic & Border
+- **Border Hairline** (`#e5e5e5`): Standard hairline separator.
+- **Border Soft** (`#ededed`): Card outline on white surface.
+- **Error** (`#ef4146`): Validation, destructive action.
+- **Warning** (`#f5a623`): Soft amber for advisory states.
+- **Info** (`#2563eb`): Informational link tone (used sparingly; teal still wins).
+
+## 3. Typography Rules
+
+### Font Family
+- **Display / Editorial**: `Signifier`, with fallback: `'Source Serif Pro', Georgia, serif`
+- **Body / UI**: `Söhne`, with fallback: `Inter, system-ui, -apple-system, 'Segoe UI', sans-serif`
+- **Code / Mono**: `Söhne Mono`, with fallback: `ui-monospace, 'JetBrains Mono', Menlo, Consolas, monospace`
+
+### Hierarchy
+
+| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
+|------|------|------|--------|-------------|----------------|-------|
+| Display | Signifier | 56px (3.5rem) | 400 | 1.08 | -0.02em | Editorial hero, announcement titles |
+| H1 | Söhne | 40px (2.5rem) | 600 | 1.15 | -0.01em | Page heading |
+| H2 | Söhne | 28px (1.75rem) | 600 | 1.2 | -0.005em | Section heading |
+| H3 | Söhne | 20px (1.25rem) | 600 | 1.3 | normal | Sub-section |
+| Body Large | Söhne | 18px (1.125rem) | 400 | 1.6 | normal | Lede paragraphs |
+| Body | Söhne | 16px (1rem) | 400 | 1.65 | normal | Standard reading text |
+| Body Small | Söhne | 14px (0.875rem) | 400 | 1.55 | normal | Card body, dense UI |
+| Caption | Söhne | 13px (0.8125rem) | 500 | 1.4 | 0.01em | Metadata, badges |
+| Label | Söhne | 12px (0.75rem) | 500 | 1.3 | 0.04em | Eyebrow, uppercase nav links |
+| Code | Söhne Mono | 14px (0.875rem) | 400 | 1.55 | normal | Code blocks, terminal output |
+
+### Principles
+- **Restraint as identity**: weights cap at 600; 700+ feels off-brand. Hierarchy comes from size and color, not weight.
+- **Serif for soul, sans for system**: Signifier appears only in editorial display moments. The product UI is sans-only.
+- **Negative tracking on display**: -0.02em on display sizes; tracking returns to zero by 16px.
+
+## 4. Component Stylings
+
+### Buttons
+
+**Primary**
+- Background: `#0d0d0d`
+- Text: `#ffffff`
+- Padding: 10px 18px
+- Radius: 9999px (full pill) on chips, 12px on rectangular CTAs
+- Hover: `#1a1a1a` background
+- Use: Primary CTA, "Try ChatGPT", "Sign in"
+
+**Secondary**
+- Background: `#ffffff`
+- Text: `#0d0d0d`
+- Border: 1px solid `#e5e5e5`
+- Padding: 10px 18px
+- Radius: 12px
+- Hover: background `#fafafa`, border `#d4d4d4`
+
+**Brand Accent**
+- Background: `#10a37f`
+- Text: `#ffffff`
+- Padding: 10px 18px
+- Radius: 12px
+- Hover: `#0a7a5e`
+- Use: Highlighted upgrade CTA, success path
+
+### Cards
+- Background: `#ffffff`
+- Border: 1px solid `#ededed`
+- Radius: 16px
+- Padding: 24px–32px
+- Shadow: none by default; on hover `0 4px 16px rgba(13,13,13,0.06)`
+
+### Inputs
+- Background: `#ffffff`
+- Border: 1px solid `#e5e5e5`
+- Radius: 12px
+- Padding: 12px 14px
+- Focus: border `#10a37f`, ring `0 0 0 3px rgba(16,163,127,0.12)`
+
+### Pills & Tags
+- Background: `#f5f5f5`
+- Text: `#3c3c3c`
+- Padding: 4px 10px
+- Radius: 9999px
+- Font: 12px / 500
+
+## 5. Spacing & Layout
+
+- **Base unit**: 4px. Scale: 4, 8, 12, 16, 24, 32, 48, 64, 96, 128.
+- **Container**: max-width 1200px, 24px gutter on mobile, 48px on desktop.
+- **Section rhythm**: 96–128px vertical between major sections; 64px on mobile.
+- **Grid**: 12-column desktop, 4-column mobile, 24px gap.
+
+## 6. Motion
+
+- **Duration**: 150–220ms for hover; 280–360ms for layout transitions.
+- **Easing**: `cubic-bezier(0.16, 1, 0.3, 1)` (smooth out) for entrances.
+- **Restraint**: no parallax, no scroll-jacking. Subtle fade and translate only.