Anti-AI-slop design skill for Claude Code, Cursor, and Codex.
CSS
Initial commit: Hallmark v0.2.0
Youssefc49b190911bd
diff --git a/.gitignore b/.gitignorenew file mode 100644index 0000000..7028650--- /dev/null+++ b/.gitignore@@ -0,0 +1,24 @@+# macOS+.DS_Store+.AppleDouble+.LSOverride++# Editor+.vscode/+.idea/+*.swp+*.swo+*~++# Node (in case future tooling lands)+node_modules/+npm-debug.log*+yarn-debug.log*+yarn-error.log*+.pnpm-debug.log*++# Build / temp+dist/+build/+.cache/+*.logdiff --git a/LICENSE b/LICENSEnew file mode 100644index 0000000..f4bfc53--- /dev/null+++ b/LICENSE@@ -0,0 +1,21 @@+MIT License++Copyright (c) 2026 Hallmark contributors++Permission is hereby granted, free of charge, to any person obtaining a copy+of this software and associated documentation files (the "Software"), to deal+in the Software without restriction, including without limitation the rights+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell+copies of the Software, and to permit persons to whom the Software is+furnished to do so, subject to the following conditions:++The above copyright notice and this permission notice shall be included in all+copies or substantial portions of the Software.++THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE+SOFTWARE.diff --git a/README.md b/README.mdnew file mode 100644index 0000000..6eb5758--- /dev/null+++ b/README.md@@ -0,0 +1,108 @@+# Hallmark++A design skill for AI coding assistants. Makes the UIs they generate look made, not generated.++**Powered by Together AI.**++---++## What it is++Hallmark is a single, opinionated skill — short on purpose — that teaches Claude Code / Cursor / Codex a firm, consensus-backed set of rules for typography, colour, layout, motion, interaction, responsive behaviour, and copy. It refuses to design without a confirmed audience, use case, and tone. It refuses to emit the on-distribution defaults every LLM was trained into (Inter + purple gradient + centred hero + 3-column icon tiles).++It ships one holistic verb and two auxiliary ones:++| Invocation | What it does |+| --- | --- |+| *(default)* | Build / edit UI. Requires design context before touching code. |+| `hallmark audit <target>` | Score existing code against the named anti-patterns. Returns a punch list. |+| `hallmark refine <target>` | Apply the ruleset to polish existing code with the smallest possible diff. |++---++## Install++### Any harness, via npx++```+npx skills add hallmark+```++### Claude Code++Copy [`skill/SKILL.md`](skill/SKILL.md) and [`skill/references/`](skill/references/) into `~/.claude/skills/hallmark/`.++### Cursor++Create `.cursor/rules/hallmark.mdc` with the body of `SKILL.md` (no frontmatter).++### Manual++`git clone` this repo; copy `skill/` into whatever config directory your agent uses.++---++## Philosophy++Five skills — [impeccable](https://github.com/pbakaus/impeccable), [kami](https://github.com/tw93/kami), [taste-skill](https://github.com/Leonxlnx/taste-skill), Anthropic's [frontend-design skill](https://github.com/anthropics/skills), and the Claude [frontend aesthetics cookbook](https://platform.claude.com/cookbook/coding-prompting-for-frontend-aesthetics) — have converged on roughly the same anti-slop ruleset. Hallmark takes that consensus, restates it in one voice, and keeps the surface small so it actually gets loaded into context.++Hallmark's distinct choices:++- **One skill, three verbs.** Not eighteen commands. Use the default; reach for `audit` or `refine` when you need them.+- **Design-context gate.** No audience + use case + tone → no design. The skill will ask.+- **Tone as a first-class decision.** "Clean and modern" is rejected. You pick an extreme: editorial, brutalist, soft, utilitarian, luxury, playful, technical, austere.+- **The slop test.** Before handing back, the skill runs ten yes/no checks. One yes fails the output.++---++## The landing page++[`site/`](site/) is a live specimen — it's the skill applied to itself. Serve it statically:++```+cd site && python3 -m http.server 4173+# → http://localhost:4173+```++The page uses Together AI's "The Future" typeface (distributed here with permission for demonstration), an OKLCH warm-oat palette anchored at hue 80, a single signal-orange accent (`#FC4C02`, ≤ 3 % of any view), and a drafting-specimen layout language — hairline rules, small-caps section numbering, asymmetric columns.++No framework. No build step. One `index.html`, four stylesheets, one ES module.++---++## Repo layout++```+hallmark/+├── README.md ← you are here+├── LICENSE ← MIT+├── package.json ← for `npx skills add`+├── skill/+│ ├── SKILL.md ← main routing + principles+│ └── references/+│ ├── typography.md+│ ├── color.md+│ ├── layout-and-space.md+│ ├── motion.md+│ ├── interaction-and-states.md+│ ├── responsive.md+│ ├── copy.md+│ └── anti-patterns.md+└── site/+ ├── index.html+ ├── css/{tokens,base,components,sections}.css+ ├── js/main.js+ └── fonts/the-future-*.woff2+```++---++## Credits++Built on the open work of Paul Bakaus ([impeccable](https://github.com/pbakaus/impeccable)), tw93 ([kami](https://github.com/tw93/kami)), Leonxlnx ([taste-skill](https://github.com/Leonxlnx/taste-skill)), and Anthropic's skills team. Where their rules overlapped, Hallmark adopted them; where they diverged, Hallmark picked. See each source for its own deeper treatment of the same problem.++---++## Licence++MIT. Use it, fork it, ship it.diff --git a/ROADMAP.md b/ROADMAP.mdnew file mode 100644index 0000000..9d31b57--- /dev/null+++ b/ROADMAP.md@@ -0,0 +1,167 @@+# Hallmark — Roadmap++A forward-looking plan for what to build next, drawn from the gaps the latest research surfaced and from where the field is heading. Ordered by impact-to-effort.++---++## Tier 1 — Ship next (high impact, contained scope)++### 1.1 Theme-aware microinteraction tokens++**Status now.** [`microinteractions.md`](skill/references/microinteractions.md) describes a duration multiplier per theme as a table — but the multipliers aren't actually expressed in CSS. Atelier and Salon should *feel* slower than Brutal and Sport, but right now they share the same `--dur-short` / `--dur-long`.++**Build.** Move `--dur-micro`, `--dur-short`, `--dur-long` into per-theme overrides in [`tokens.css`](site/css/tokens.css), scaled by the table in `microinteractions.md`. Newsprint and Terminal use `0ms` for spatial motion (they're print/terminal metaphors). One pass through the file; small diff.++**Why it matters.** Today a Salon page and a Brutal page animate at the same speed. They shouldn't. The principle of structural variety should extend to motion variety.++### 1.2 DESIGN.md output protocol++**Status now.** Hallmark produces code. It does not produce a portable design spec.++**Context from research.** [VoltAgent's `awesome-design-md`](https://github.com/VoltAgent/awesome-design-md) hit 35K stars in 10 days — fastest growing "awesome" list in GitHub history. DESIGN.md is becoming the lingua franca between humans and AI agents for design systems.++**Build.** When Hallmark generates new work, also emit a `DESIGN.md` in the project root containing: chosen tone, palette tokens (with OKLCH values), type stack, spacing scale, structural fingerprint, motion tokens, and the named anti-patterns the page must continue to avoid. Other AI tools (Cursor, v0, Bolt) can read this file directly to keep iterating on the same design language.++**Why it matters.** Closes the loop between Hallmark and the rest of the agent ecosystem. The skill stops being a one-shot generator and becomes a system that hands its decisions forward.++### 1.3 `hallmark variant` — three fingerprints, user picks one++**Status now.** Hallmark produces *one* designed output per brief.++**Build.** New verb: `hallmark variant <target>` produces three structurally distinct versions of the same brief — different fingerprints across the six axes — and presents them as a side-by-side comparison. The user picks the one that fits, or asks for a fourth. This is the workflow `taste-skill v3.0` parameterises with dials; Hallmark would expose it as a verb.++**Why it matters.** The biggest cause of "AI feel" isn't bad output — it's the user accepting the *first* output because they don't know it could be different. Showing three forces a judgement call and surfaces taste.++### 1.4 Theme switcher polish on the landing page++**Status now.** The 12-theme picker is good but a few rough edges remain.++**Build.**+- Trap the focus inside the popover when open (currently focus can escape).+- Make the swatch dots match each theme's *exact* paper/ink/accent (some currently approximate).+- On theme apply, briefly flash the orange accent rule under the trigger label to confirm — *silent success* via a 200ms colour pulse, not a toast.+- The kbd hint (`press T`) currently sits next to the trigger but only on hover — also reveal on `:focus-within` of the navbar, for keyboard users who haven't reached for the mouse.++**Why it matters.** The landing page itself is the strongest demo of Hallmark's microinteraction taste. It has to be exemplary.++---++## Tier 2 — Build after Tier 1 lands (still concrete, more scope)++### 2.1 `references/structural-cookbook.md` — concrete recipes++**Status now.** [`structure.md`](skill/references/structure.md) catalogues the *axes* of structural variety. It doesn't show *what* a left-margin-headed, single-column, hairline-divided, unstyled-link, no-image, no-reveal page actually looks like assembled.++**Build.** A cookbook file with 12–20 *complete* structural fingerprints, each with a short HTML/CSS sketch, a paragraph explaining when to reach for it, and a real-world reference (NYT Mag, Stripe, Linear, Pentagram, etc.). The cookbook teaches the model patterns the same way recipe books teach cooking — through *worked examples*, not just *principles*.++**Why it matters.** Models are pattern-matchers. Catalogued patterns + named recipes are easier to reach for than principles + axes.++### 2.2 `references/tactile-rebellion.md` — controlled imperfection++**Status now.** Hallmark assumes pixel-precision is the goal. The 2026 cultural movement is the opposite: handmade textures, controlled imperfection, *wabi-sabi*. 73% of designers (per CreativeBloq's 2026 trends report) are deliberately adding imperfections to differentiate from AI.++**Build.** A new reference file covering: when to apply texture (sparingly; one element per page max); how to do it without falling into kitsch (real letterpress reference, not "letterpress filter"); free SVG noise/grain generators; hand-drawn SVG path techniques; controlled-jitter typography (a 0.5° rotation on a single mark is taste; on every word it's chaos).++**Why it matters.** This is where the field is going and the current canon (impeccable, kami) has nothing on it. First-mover advantage.++### 2.3 `references/data-viz.md` — Tufte-leaning anti-slop charts++**Status now.** Nothing about charts. Yet a dashboard or analytics page is half data viz, and AI-generated charts are *especially* bad — rainbow palettes, 3D pies, gridlines everywhere, sparkles instead of lines.++**Build.** A reference file covering: small multiples over single dense charts; tabular numbers; restraint in colour (one accent for the focal series, neutrals for context); axis design (minimum gridlines, no chartjunk); when to use bars vs lines vs sparklines; banned chart types (3D anything, donut charts where pie would do, dual-axis line charts).++**Why it matters.** Data-density is the next frontier of "looks AI-generated" — and Tufte is the canonical reference no current skill cites.++### 2.4 Multi-page coherence rules++**Status now.** Hallmark's structural-variety rule says "two consecutive pages in the same session should not share more than three of the six structural axes." That's correct for variety but wrong for *brand consistency* across a real product where every page should feel like the same site.++**Build.** A new reference: `references/coherence.md`. When working within a multi-page project, lock the first three axes (typography, colour, divider language — the *brand* axes) and vary the remaining three (heading placement, body composition, button voice — the *page-voice* axes). Different *pages* of the same site, not different *sites*. Add a test: "if I removed the navigation, would these two pages look like they're from the same product?" Yes. Continue. No. Re-anchor.++**Why it matters.** Right now the structural-variety rule is too strong. Real products need *coherent variety*, not chaotic variety.++### 2.5 `hallmark extract` — read existing code, output DESIGN.md++**Status now.** Hallmark generates from briefs. It can't ingest existing systems.++**Build.** New verb: `hallmark extract <directory>`. Reads the codebase. Identifies tokens (colour vars, type ramps, spacing scale, easings). Identifies the structural fingerprint actually in use. Writes a DESIGN.md the user can hand to other agents — or to Hallmark itself for `redesign` work. SkillUI does this for visual designs; Hallmark would do it taste-aware.++**Why it matters.** Most users come to Hallmark *with* an existing codebase, not a greenfield brief. The skill needs an entry point for the existing case.++---++## Tier 3 — Long horizon (research-grade, ambitious)++### 3.1 `hallmark explain` — pedagogy verb++A verb that explains the choices made, *axis by axis*, in plain language. "I picked left-margin headings because the brief was editorial and the audience is reading-led; I picked hairline dividers because the tone was austere and ornament would have warmed the page; I picked silent success on the form because the user can see the row was saved." Teaches users to make the same choices themselves over time. The skill becomes a *teacher*, not just a generator.++### 3.2 Negative-capability rules++[PencilPlaybook](https://github.com/stevembarclay/pencilplaybook) embeds *perceptual psychology* in its anti-patterns — not just "don't use side-stripe cards" but "side-stripe cards trigger a horizontal cognitive scan that splits the user's attention from the content; the brain has to process two reading axes at once, which costs ~120ms per card." That's a different kind of teaching.++Build a `references/why.md` that, for each major anti-pattern, includes the perceptual or cognitive reason it fails. Models that *understand* an anti-pattern reach for the alternative more reliably than models that just *know* the anti-pattern.++### 3.3 Emotion-first prompting++Today: tone words (editorial, brutalist, austere). Tomorrow: emotion words (anxious, optimistic, nostalgic, sceptical). The brief "build me a page that feels nostalgic but also forward-looking" should produce different work than "build me a page that feels confident and warm" — even if the audience and use case are the same.++This requires a new mapping: emotion → tone → fingerprint. Worth building once the field has converged on what these mappings are. (Currently nobody has mapped them.)++### 3.4 Sound and haptic policy++Currently [`microinteractions.md`](skill/references/microinteractions.md) says "no sound on web" — correct default. But Hallmark could ship a tiny module covering: when sound is appropriate (gaming, AAA brands, accessibility-augmenting); haptic feedback (Vibration API on mobile); and how to do them without crossing into kitsch. Small file; long horizon.++### 3.5 Live preview as a Claude Code MCP server++The most ambitious direction. Today Hallmark writes code into files; the user runs a static server to preview. A Claude Code MCP server could:+- Watch the file+- Render it in a sandbox+- Take a screenshot+- Feed the screenshot back to the model for self-critique against the slop test+- Iterate++This closes the loop between *generation* and *audit*, automatically. The skill audits itself before handing back. Anthropic's [canvas-design](https://github.com/anthropics/skills) skill is a step toward this for static art; Hallmark could be the interactive equivalent.++---++## Things to *not* do++A list of tempting directions that would make Hallmark worse, not better. Forcing the discipline.++- **Don't add a fifth verb** before the existing four are battle-tested. `default / audit / refine / redesign` is enough surface area for the next six months. Adding `polish / typeset / colorize / animate / ...` (impeccable's path) trades comprehensibility for surface area. Resist.+- **Don't add more than 12 themes.** The cognitive cost of 16 themes is higher than the value of 16 themes. If anything, *cut* underperforming ones.+- **Don't ship a UI library.** Hallmark is a *taste* skill, not a component kit. shadcn/ui and Geist exist; refer users to them. Building components inside Hallmark dilutes the focus.+- **Don't add A/B testing or analytics** to the skill. It's not a SaaS product.+- **Don't build a Figma plugin.** The skill works in code; that's a feature, not a limit. Designers who want Figma have other tools.+- **Don't add prompts to "match a brand"** by URL scraping. That's SkillUI's job — point users there.+- **Don't add image generation.** Out of scope; AI imagery is its own problem space, and the right answer is usually "use real photos" or "no image."++---++## Measurement++How we know Hallmark is getting better, not just bigger:++1. **Slop test pass rate.** Every output should pass all 20 questions. Track failures and categorise.+2. **Structural-fingerprint diversity.** Across the last 10 outputs of the skill, how many *unique* fingerprints? Target ≥ 8/10.+3. **Microinteraction tells per output.** Target 0. (`transition-all`, `hover:scale-105`, bouncy easing on UI, etc. are flagged.)+4. **User picks the first output without revision.** A high "first try" rate is the single best taste indicator. Track it.+5. **DESIGN.md re-import round-trip.** A user runs `hallmark extract` then `hallmark` with the extracted DESIGN.md in scope. The result should match the original within token boundaries. If it drifts, the extraction or the application is wrong.++---++## What's already shipped++For reference. Everything below is in current `0.2.0`.++- ✓ Skill: 4 verbs (default, audit, refine, redesign)+- ✓ References: typography, color, layout-and-space, motion, microinteractions, structure, interaction-and-states, responsive, copy, anti-patterns+- ✓ 12 themes with structural fingerprints+- ✓ Theme picker UI on the landing page+- ✓ Working install path: `cp skill/* ~/.claude/skills/hallmark/`+- ✓ Two test specimens: bakery (`site/_example-bakery/`) and command palette (`site/_example-cmdk/`)+- ✓ Slop test extended from 12 to 20 questions covering microinteractions+- ✓ View Transitions on theme switch, with reduced-motion fallback+- ✓ Copy-to-clipboard with silent success on install code blocks+- ✓ Keyboard shortcut (`T`) to open theme picker, with delay-revealed hintdiff --git a/package.json b/package.jsonnew file mode 100644index 0000000..7951114--- /dev/null+++ b/package.json@@ -0,0 +1,36 @@+{+ "name": "hallmark",+ "version": "0.1.0",+ "description": "A design skill for AI coding assistants. Makes the UIs they generate look made, not generated. Powered by Together AI.",+ "keywords": [+ "claude",+ "claude-code",+ "cursor",+ "codex",+ "skill",+ "design",+ "ui",+ "anti-ai-slop",+ "typography",+ "oklch",+ "together-ai"+ ],+ "license": "MIT",+ "type": "module",+ "files": [+ "skill/SKILL.md",+ "skill/references"+ ],+ "skill": {+ "entry": "skill/SKILL.md",+ "references": "skill/references",+ "harnesses": [+ "claude-code",+ "cursor",+ "codex"+ ]+ },+ "scripts": {+ "serve": "python3 -m http.server --directory site 4173"+ }+}diff --git a/site/_example-bakery/index.html b/site/_example-bakery/index.htmlnew file mode 100644index 0000000..8d96666--- /dev/null+++ b/site/_example-bakery/index.html@@ -0,0 +1,764 @@+<!doctype html>+<html lang="en">+<head>+ <meta charset="utf-8" />+ <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />+ <meta name="color-scheme" content="light" />+ <title>Marlow Street Bread — opening 8 May</title>+ <meta name="description" content="A neighborhood sourdough bakery. Local flour, long ferment, a few loaves a day. Opening on Marlow Street in May." />++ <link rel="preconnect" href="https://fonts.googleapis.com" />+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />+ <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,300..500;1,9..144,300..500&family=IBM+Plex+Sans:wght@300;400;500&family=IBM+Plex+Mono:wght@400;500&display=swap" />++ <style>+ /*+ Marlow Street Bread — a single-page announcement.+ Tone: quietly confident, editorial. Anchor hue: 45 (wheat / crust).+ */++ :root {+ /* Colour */+ --color-paper: oklch(96% 0.016 75);+ --color-paper-2: oklch(93% 0.020 72);+ --color-rule: oklch(82% 0.018 70);+ --color-rule-2: oklch(70% 0.022 65);+ --color-muted: oklch(52% 0.022 60);+ --color-ink-2: oklch(32% 0.025 55);+ --color-ink: oklch(22% 0.026 50);+ --color-accent: oklch(48% 0.15 45);+ --color-focus: oklch(48% 0.15 45);+ --color-error: oklch(45% 0.18 25);+ --color-success: oklch(42% 0.10 140);++ /* Type */+ --font-display: "Fraunces", "Tiempos", ui-serif, Georgia, serif;+ --font-body: "IBM Plex Sans", "Söhne", ui-sans-serif, sans-serif;+ --font-serif: "Fraunces", ui-serif, Georgia, serif;+ --font-label: "IBM Plex Mono", ui-monospace, monospace;++ --text-xs: 0.75rem;+ --text-sm: 0.875rem;+ --text-base: 1rem;+ --text-md: 1.125rem;+ --text-lg: 1.375rem;+ --text-xl: 1.75rem;+ --text-2xl: 2.25rem;+ --text-display: clamp(3rem, 7vw + 1rem, 7.25rem);+ --text-display-s: clamp(2rem, 3vw + 1rem, 3rem);++ --lh-tight: 1.02;+ --lh-snug: 1.18;+ --lh-normal: 1.45;+ --lh-relaxed: 1.65;++ --tracking-display: -0.028em;+ --tracking-tight: -0.012em;+ --tracking-label: 0.14em;++ /* Spacing */+ --space-2xs: 0.25rem;+ --space-xs: 0.5rem;+ --space-sm: 0.75rem;+ --space-md: 1rem;+ --space-lg: 1.5rem;+ --space-xl: 2.5rem;+ --space-2xl: 4.5rem;+ --space-3xl: 7rem;+ --space-4xl: 11rem;++ /* Motion */+ --ease-out: cubic-bezier(0.16, 1, 0.3, 1);+ --ease-in: cubic-bezier(0.7, 0, 0.84, 0);+ --dur-micro: 120ms;+ --dur-short: 220ms;+ --dur-long: 520ms;++ --page-max: 64rem;+ --page-gutter: clamp(1.25rem, 4vw, 3rem);+ --measure: 58ch;+ }++ *, *::before, *::after { box-sizing: border-box; }+ body, h1, h2, h3, p, figure, blockquote, dl, dd { margin: 0; }+ img, picture, svg { display: block; max-width: 100%; height: auto; }+ button, input, select { font: inherit; color: inherit; }+ button { background: none; border: 0; padding: 0; cursor: pointer; }+ a { color: inherit; text-decoration: none; }+ ul, ol { margin: 0; padding: 0; list-style: none; }++ :focus { outline: none; }+ :focus-visible {+ outline: 2px solid var(--color-focus);+ outline-offset: 3px;+ border-radius: 2px;+ }++ html { background: var(--color-paper); color: var(--color-ink); }++ body {+ font-family: var(--font-body);+ font-weight: 400;+ font-size: var(--text-base);+ line-height: var(--lh-relaxed);+ -webkit-font-smoothing: antialiased;+ -moz-osx-font-smoothing: grayscale;+ min-height: 100dvh;+ padding-inline: max(var(--page-gutter), env(safe-area-inset-left));+ padding-block-end: env(safe-area-inset-bottom);+ overflow-x: hidden;+ }++ ::selection { background: var(--color-accent); color: var(--color-paper); }++ h1, h2, h3 {+ font-family: var(--font-display);+ font-weight: 300;+ line-height: var(--lh-tight);+ letter-spacing: var(--tracking-display);+ color: var(--color-ink);+ font-optical-sizing: auto;+ }++ p { max-width: var(--measure); }++ em { font-style: italic; }++ code { font-family: var(--font-label); font-size: 0.9em; }++ .page {+ max-width: var(--page-max);+ margin-inline: auto;+ display: grid;+ gap: var(--space-3xl);+ padding-block: var(--space-md) var(--space-3xl);+ }++ /* Nav */+ .nav {+ display: flex;+ align-items: center;+ justify-content: space-between;+ padding-block: var(--space-md);+ border-bottom: 0.5px solid var(--color-rule);+ }++ .wordmark {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ font-weight: 500;+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-ink);+ }++ .nav__note {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-muted);+ display: inline-flex;+ align-items: center;+ gap: 0.55em;+ }++ .mark {+ display: inline-block;+ width: 0.5em;+ height: 0.5em;+ background: var(--color-accent);+ border-radius: 50%;+ }++ /* Hero */+ .hero {+ display: grid;+ grid-template-columns: 9fr 3fr;+ gap: var(--space-2xl);+ align-items: end;+ padding-block: var(--space-xl) var(--space-md);+ }++ @media (max-width: 58rem) {+ .hero { grid-template-columns: 1fr; }+ }++ .hero__eyebrow {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-muted);+ margin-bottom: var(--space-xl);+ display: inline-flex;+ align-items: center;+ gap: 0.55em;+ }++ .hero__title {+ font-family: var(--font-display);+ font-weight: 300;+ font-size: var(--text-display);+ line-height: 0.98;+ letter-spacing: -0.03em;+ font-variation-settings: "opsz" 144;+ color: var(--color-ink);+ max-width: 12ch;+ }++ .hero__title em {+ font-style: italic;+ font-weight: 300;+ }++ .hero__lede {+ font-family: var(--font-serif);+ font-weight: 300;+ font-size: var(--text-md);+ line-height: var(--lh-normal);+ color: var(--color-ink-2);+ max-width: 38ch;+ margin-top: var(--space-xl);+ }++ .hero__aside {+ display: grid;+ gap: var(--space-sm);+ padding-top: var(--space-xl);+ }++ .hero__meta-row {+ display: grid;+ grid-template-columns: auto 1fr;+ gap: var(--space-sm) var(--space-md);+ padding-block: var(--space-sm);+ border-block: 0.5px solid var(--color-rule);+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-muted);+ }++ .hero__meta-row dt { color: var(--color-muted); }+ .hero__meta-row dd { color: var(--color-ink); margin: 0; }++ /* Section scaffolding */+ .section {+ display: grid;+ grid-template-columns: 10rem 1fr;+ gap: var(--space-xl);+ align-items: start;+ }++ @media (max-width: 50rem) {+ .section { grid-template-columns: 1fr; gap: var(--space-md); }+ }++ .section__label {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-muted);+ padding-top: 0.35rem;+ }++ .section__label .num { color: var(--color-ink); font-weight: 500; }++ .section__body {+ display: grid;+ gap: var(--space-lg);+ }++ .section__title {+ font-family: var(--font-display);+ font-weight: 300;+ font-style: italic;+ font-size: var(--text-2xl);+ line-height: var(--lh-snug);+ letter-spacing: var(--tracking-tight);+ color: var(--color-ink);+ max-width: 22ch;+ font-variation-settings: "opsz" 72;+ }++ .section__prose {+ font-family: var(--font-body);+ font-size: var(--text-md);+ line-height: var(--lh-normal);+ color: var(--color-ink-2);+ max-width: var(--measure);+ }++ /* Loaves list */+ .loaves {+ display: grid;+ gap: 0;+ }++ .loaf {+ display: grid;+ grid-template-columns: 2rem 10rem 1fr auto;+ gap: var(--space-md);+ align-items: baseline;+ padding-block: var(--space-md);+ border-top: 0.5px solid var(--color-rule);+ }++ .loaf:last-child { border-bottom: 0.5px solid var(--color-rule); }++ @media (max-width: 50rem) {+ .loaf {+ grid-template-columns: 2rem 1fr;+ grid-template-rows: auto auto;+ }+ .loaf__desc { grid-column: 1 / -1; padding-left: 2.75rem; }+ .loaf__days { grid-column: 1 / -1; padding-left: 2.75rem; color: var(--color-muted); }+ }++ .loaf__num {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: var(--tracking-label);+ color: var(--color-muted);+ font-variant-numeric: tabular-nums;+ }++ .loaf__name {+ font-family: var(--font-display);+ font-weight: 400;+ font-size: var(--text-lg);+ line-height: 1;+ letter-spacing: -0.01em;+ color: var(--color-ink);+ font-variation-settings: "opsz" 48;+ }++ .loaf__desc {+ font-family: var(--font-body);+ font-size: var(--text-sm);+ line-height: var(--lh-normal);+ color: var(--color-ink-2);+ max-width: 52ch;+ }++ .loaf__days {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: 0.08em;+ text-transform: uppercase;+ color: var(--color-muted);+ white-space: nowrap;+ }++ /* Pull quote */+ .pull {+ font-family: var(--font-display);+ font-style: italic;+ font-weight: 300;+ font-size: clamp(1.75rem, 3vw + 1rem, 2.75rem);+ line-height: 1.15;+ letter-spacing: -0.02em;+ color: var(--color-ink);+ max-width: 26ch;+ padding-block: var(--space-lg);+ font-variation-settings: "opsz" 96;+ }++ .pull__attr {+ display: block;+ margin-top: var(--space-md);+ font-family: var(--font-label);+ font-style: normal;+ font-size: var(--text-xs);+ font-weight: 400;+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-muted);+ }++ /* Where */+ .where {+ display: grid;+ gap: var(--space-sm);+ }++ .where dt {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-muted);+ margin-bottom: 0.25rem;+ }++ .where dd {+ font-family: var(--font-serif);+ font-weight: 400;+ font-size: var(--text-md);+ color: var(--color-ink);+ margin: 0;+ }++ .where .row {+ display: grid;+ grid-template-columns: 8rem 1fr;+ gap: var(--space-md);+ align-items: baseline;+ padding-block: var(--space-sm);+ border-top: 0.5px solid var(--color-rule);+ }+ .where .row:last-of-type { border-bottom: 0.5px solid var(--color-rule); }++ /* Signup form */+ .signup {+ background: var(--color-paper-2);+ padding: var(--space-xl) var(--space-xl) var(--space-2xl);+ border: 0.5px solid var(--color-rule);+ }++ .signup__head {+ font-family: var(--font-display);+ font-weight: 300;+ font-style: italic;+ font-size: var(--text-2xl);+ line-height: var(--lh-snug);+ letter-spacing: var(--tracking-tight);+ color: var(--color-ink);+ max-width: 20ch;+ font-variation-settings: "opsz" 72;+ }++ .signup__note {+ font-family: var(--font-body);+ font-size: var(--text-sm);+ line-height: var(--lh-normal);+ color: var(--color-ink-2);+ max-width: 46ch;+ margin-top: var(--space-md);+ margin-bottom: var(--space-lg);+ }++ .form {+ display: grid;+ gap: var(--space-sm);+ max-width: 32rem;+ }++ .form__label {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-muted);+ }++ .form__row {+ display: grid;+ grid-template-columns: 1fr auto;+ gap: 0;+ border-bottom: 1px solid var(--color-ink);+ }++ .form__input {+ font-family: var(--font-body);+ font-size: var(--text-md);+ padding: var(--space-sm) 0;+ background: transparent;+ border: 0;+ color: var(--color-ink);+ min-height: 44px;+ }++ .form__input::placeholder { color: var(--color-muted); }+ .form__input:focus-visible { outline: none; }++ .form__row:focus-within { border-bottom-color: var(--color-accent); }++ .form__submit {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-ink);+ padding: 0 var(--space-md);+ min-height: 44px;+ align-self: stretch;+ transition: color var(--dur-micro) var(--ease-out);+ cursor: pointer;+ }++ @media (hover: hover) and (pointer: fine) {+ .form__submit:hover { color: var(--color-accent); }+ }++ .form__submit:disabled { color: var(--color-muted); cursor: not-allowed; }++ .form__hint {+ font-family: var(--font-body);+ font-size: var(--text-xs);+ color: var(--color-muted);+ margin-top: var(--space-xs);+ line-height: var(--lh-normal);+ }++ .form__hint--error { color: var(--color-error); }+ .form__hint--success { color: var(--color-success); }++ .form[data-state="error"] .form__row { border-bottom-color: var(--color-error); }+ .form[data-state="success"] .form__row { border-bottom-color: var(--color-success); }++ /* Footer */+ .foot {+ display: grid;+ grid-template-columns: 1fr auto;+ gap: var(--space-lg);+ padding-top: var(--space-xl);+ border-top: 1px solid var(--color-ink);+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: 0.04em;+ color: var(--color-muted);+ align-items: end;+ }++ .foot__address { line-height: 1.7; }+ .foot__credit { text-align: right; }+ .foot__credit a { color: var(--color-ink); }++ /* Reveals — one orchestrated entrance */+ .reveal {+ opacity: 0;+ transform: translateY(8px);+ animation: reveal var(--dur-long) var(--ease-out) forwards;+ animation-delay: calc(var(--i, 0) * 80ms);+ }++ @keyframes reveal {+ to { opacity: 1; transform: none; }+ }++ @media (prefers-reduced-motion: reduce) {+ .reveal {+ transform: none;+ animation-duration: 150ms;+ }+ @keyframes reveal { to { opacity: 1; } }+ *, *::before, *::after {+ animation-duration: 150ms !important;+ transition-duration: 150ms !important;+ }+ }+ </style>+</head>+<body>++ <main class="page">++ <!-- Nav -->+ <nav class="nav reveal" style="--i:0" aria-label="Primary">+ <span class="wordmark">Marlow Street Bread</span>+ <span class="nav__note"><span class="mark" aria-hidden="true"></span>Opens 8 May</span>+ </nav>++ <!-- Hero -->+ <header class="hero reveal" style="--i:1">+ <div>+ <p class="hero__eyebrow">+ <span class="mark" aria-hidden="true"></span>+ Opening · 8 May 2026+ </p>+ <h1 class="hero__title">+ Bread, when it’s <em>ready.</em>+ </h1>+ <p class="hero__lede">+ A naturally leavened loaf, made with local flour and a thirty-six hour ferment. A few of them, baked daily. When they’re gone, we close.+ </p>+ </div>+ <aside class="hero__aside">+ <dl class="hero__meta-row">+ <dt>Kind</dt>+ <dd>Neighborhood bakery</dd>+ <dt>Where</dt>+ <dd>137 Marlow St</dd>+ <dt>Open</dt>+ <dd>Tue – Sat, 8 a.m.</dd>+ </dl>+ </aside>+ </header>++ <!-- What we bake -->+ <section class="section reveal" style="--i:2" aria-labelledby="s-loaves">+ <div class="section__label">+ <span class="num">01</span> ⁄ What we bake+ </div>+ <div class="section__body">+ <h2 class="section__title" id="s-loaves">+ A short list, done properly.+ </h2>+ <ul class="loaves">+ <li class="loaf">+ <span class="loaf__num">01</span>+ <span class="loaf__name">Country</span>+ <span class="loaf__desc">Stone-milled wheat, a little rye, a long cold ferment. Our everyday loaf.</span>+ <span class="loaf__days">Daily</span>+ </li>+ <li class="loaf">+ <span class="loaf__num">02</span>+ <span class="loaf__name">Seeded</span>+ <span class="loaf__desc">Pumpkin, sesame, poppy. The country base with a denser crumb.</span>+ <span class="loaf__days">Daily</span>+ </li>+ <li class="loaf">+ <span class="loaf__num">03</span>+ <span class="loaf__name">Miche</span>+ <span class="loaf__desc">A broad round, 1.4 kg. Keeps four days on the counter, longer under cloth.</span>+ <span class="loaf__days">Fri & Sat</span>+ </li>+ <li class="loaf">+ <span class="loaf__num">04</span>+ <span class="loaf__name">Rye</span>+ <span class="loaf__desc">Seventy percent rye, caraway, a little molasses. Dense, dark, patient.</span>+ <span class="loaf__days">Thursdays</span>+ </li>+ </ul>+ <p class="section__prose">+ We bake in small numbers because we’d rather bake four loaves well than forty in a hurry. If a loaf is sold out by ten, that’s how it goes.+ </p>+ </div>+ </section>++ <!-- Pull quote -->+ <blockquote class="section reveal" style="--i:3">+ <div class="section__label">+ <span class="num">02</span> ⁄ Why+ </div>+ <p class="pull">+ “Good bread is mostly time — a long fermentation, a patient oven, and flour that wasn’t rushed.”+ <cite class="pull__attr">— from the opening letter</cite>+ </p>+ </blockquote>++ <!-- Flour & farmers -->+ <section class="section reveal" style="--i:4" aria-labelledby="s-flour">+ <div class="section__label">+ <span class="num">03</span> ⁄ Flour & farmers+ </div>+ <div class="section__body">+ <h2 class="section__title" id="s-flour">+ Milled in Paxton, grown twenty-three miles away.+ </h2>+ <p class="section__prose">+ Our flour is stone-milled at the Paxton mill, north of town. The wheat comes from two farms — Linnea Berg’s in the valley and the Holdfast Co-op on the ridge. We work with what they grow, when they grow it, which means the flour shifts a little with the seasons. We think that’s a feature.+ </p>+ </div>+ </section>++ <!-- Where -->+ <section class="section reveal" style="--i:5" aria-labelledby="s-where">+ <div class="section__label">+ <span class="num">04</span> ⁄ When & where+ </div>+ <div class="section__body">+ <h2 class="section__title" id="s-where">+ Marlow Street, off Fifth.+ </h2>+ <dl class="where">+ <div class="row"><dt>Address</dt><dd>137 Marlow Street</dd></div>+ <div class="row"><dt>Opening</dt><dd>8 May 2026, 8 a.m.</dd></div>+ <div class="row"><dt>Hours</dt><dd>Tuesday — Saturday, 8 a.m. until sold out (usually by 1 p.m.)</dd></div>+ <div class="row"><dt>Closed</dt><dd>Sunday & Monday</dd></div>+ </dl>+ </div>+ </section>++ <!-- Signup -->+ <section class="section reveal" style="--i:6" aria-labelledby="s-signup">+ <div class="section__label">+ <span class="num">05</span> ⁄ The notice+ </div>+ <div class="signup">+ <h2 class="signup__head" id="s-signup">+ We’ll write when the doors open.+ </h2>+ <p class="signup__note">+ One email on opening day, and one a week later with the first weekend’s hours. Nothing else. Your address stays with us.+ </p>++ <form class="form" id="signup-form" novalidate>+ <label class="form__label" for="email">Email address</label>+ <div class="form__row">+ <input+ class="form__input"+ type="email"+ id="email"+ name="email"+ autocomplete="email"+ required+ placeholder="[email protected]"+ aria-describedby="email-hint"+ />+ <button class="form__submit" type="submit">Send me the notice →</button>+ </div>+ <p class="form__hint" id="email-hint">We'll send two emails. No list-sharing.</p>+ </form>+ </div>+ </section>++ <!-- Footer -->+ <footer class="foot reveal" style="--i:7" role="contentinfo">+ <div class="foot__address">+ Marlow Street Bread · 137 Marlow Street · Tue – Sat from 8 a.m.+ </div>+ <div class="foot__credit">+ Designed with <a href="/" class="link">Hallmark</a>+ </div>+ </footer>++ </main>++ <script type="module">+ const form = document.getElementById("signup-form");+ const input = document.getElementById("email");+ const hint = document.getElementById("email-hint");+ const submit = form.querySelector(".form__submit");++ form.addEventListener("submit", (e) => {+ e.preventDefault();+ const value = input.value.trim();+ const valid = /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);++ if (!valid) {+ form.dataset.state = "error";+ input.setAttribute("aria-invalid", "true");+ hint.className = "form__hint form__hint--error";+ hint.textContent = "That doesn’t look like an email address. Try again?";+ return;+ }++ submit.disabled = true;+ submit.textContent = "Sending…";++ // Demo only — pretend we sent it.+ setTimeout(() => {+ form.dataset.state = "success";+ input.removeAttribute("aria-invalid");+ hint.className = "form__hint form__hint--success";+ hint.textContent = "On the list. We’ll be in touch on 8 May.";+ submit.textContent = "Sent";+ }, 350);+ });++ input.addEventListener("input", () => {+ if (form.dataset.state === "error") {+ delete form.dataset.state;+ input.removeAttribute("aria-invalid");+ hint.className = "form__hint";+ hint.textContent = "We'll send two emails. No list-sharing.";+ }+ });+ </script>+</body>+</html>diff --git a/site/_example-cmdk/index.html b/site/_example-cmdk/index.htmlnew file mode 100644index 0000000..9badf59--- /dev/null+++ b/site/_example-cmdk/index.html@@ -0,0 +1,886 @@+<!doctype html>+<html lang="en">+<head>+ <meta charset="utf-8" />+ <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />+ <meta name="color-scheme" content="light" />+ <title>Lectern — a personal library</title>+ <meta name="description" content="A keyboard-first command palette for a personal reading list. Press ⌘K to find any book in seconds." />++ <link rel="preconnect" href="https://fonts.googleapis.com" />+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />+ <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@300;400;500;600&family=JetBrains+Mono:wght@400;500&display=swap" />++ <style>+ /*+ Lectern — keyboard-first book library.+ Tone: technical, calm. Anchor hue: 240 (cool slate).+ Structure: single column, hairline rules, typographic-only CTAs, no reveals.+ */++ :root {+ --color-paper: oklch(97% 0.005 250);+ --color-paper-2: oklch(94% 0.007 250);+ --color-paper-3: oklch(91% 0.008 250);+ --color-rule: oklch(86% 0.008 245);+ --color-rule-2: oklch(74% 0.010 240);+ --color-muted: oklch(54% 0.012 245);+ --color-neutral: oklch(40% 0.014 245);+ --color-ink-2: oklch(28% 0.014 245);+ --color-ink: oklch(18% 0.016 245);+ --color-accent: oklch(48% 0.16 240);+ --color-focus: oklch(48% 0.16 240);+ --color-mark-bg: oklch(92% 0.06 95);+ --color-row-hover: oklch(94% 0.012 245);+ --color-row-active: oklch(88% 0.030 240);++ --font-sans: "IBM Plex Sans", "Söhne", ui-sans-serif, sans-serif;+ --font-mono: "JetBrains Mono", "IBM Plex Mono", ui-monospace, monospace;++ --text-xs: 0.75rem;+ --text-sm: 0.8125rem;+ --text-base: 0.9375rem;+ --text-md: 1.0625rem;+ --text-lg: 1.25rem;+ --text-xl: 1.5rem;++ --lh-tight: 1.1;+ --lh-snug: 1.3;+ --lh-normal: 1.5;+ --lh-relaxed: 1.65;++ --tracking-label: 0.10em;++ --space-2xs: 0.25rem;+ --space-xs: 0.5rem;+ --space-sm: 0.75rem;+ --space-md: 1rem;+ --space-lg: 1.5rem;+ --space-xl: 2rem;+ --space-2xl: 3rem;+ --space-3xl: 4.5rem;++ --ease-out: cubic-bezier(0.16, 1, 0.3, 1);+ --ease-in: cubic-bezier(0.7, 0, 0.84, 0);+ --ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);+ --dur-micro: 120ms;+ --dur-short: 220ms;+ --dur-long: 300ms;++ --page-max: 58rem;+ --page-gutter: clamp(1rem, 4vw, 2.5rem);+ }++ *, *::before, *::after { box-sizing: border-box; }+ body, h1, h2, h3, p, dl, dd { margin: 0; }+ button, input { font: inherit; color: inherit; }+ button { background: none; border: 0; padding: 0; cursor: pointer; }+ a { color: inherit; text-decoration: none; }+ ul, ol { margin: 0; padding: 0; list-style: none; }++ /* Focus rings — instant, never animated in/out */+ :focus { outline: none; }+ :focus-visible {+ outline: 2px solid var(--color-focus);+ outline-offset: 2px;+ border-radius: 1px;+ }++ html {+ background: var(--color-paper);+ color: var(--color-ink);+ }++ body {+ font-family: var(--font-sans);+ font-weight: 400;+ font-size: var(--text-base);+ line-height: var(--lh-relaxed);+ -webkit-font-smoothing: antialiased;+ -moz-osx-font-smoothing: grayscale;+ min-height: 100dvh;+ padding-inline: max(var(--page-gutter), env(safe-area-inset-left));+ padding-block-end: env(safe-area-inset-bottom);+ }++ ::selection {+ background: var(--color-accent);+ color: var(--color-paper);+ }++ /* Page scaffold */+ .page {+ max-width: var(--page-max);+ margin-inline: auto;+ padding-block: var(--space-xl) var(--space-3xl);+ }++ /* Header */+ .head {+ display: flex;+ justify-content: space-between;+ align-items: baseline;+ gap: var(--space-md);+ padding-block: var(--space-md);+ border-bottom: 1px solid var(--color-ink);+ margin-bottom: var(--space-xl);+ }++ .wordmark {+ font-family: var(--font-mono);+ font-size: var(--text-sm);+ font-weight: 500;+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-ink);+ }++ .wordmark .count {+ color: var(--color-muted);+ font-weight: 400;+ margin-left: 0.6rem;+ }++ .meta {+ font-family: var(--font-mono);+ font-size: var(--text-xs);+ color: var(--color-muted);+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ }++ /* Status legend */+ .legend {+ display: flex;+ gap: var(--space-lg);+ font-family: var(--font-mono);+ font-size: var(--text-xs);+ letter-spacing: 0.06em;+ color: var(--color-muted);+ padding-bottom: var(--space-md);+ margin-bottom: var(--space-xs);+ }+ .legend__item { display: inline-flex; align-items: center; gap: 0.4em; }++ /* Book list (ambient) */+ .books { display: grid; gap: 0; }++ .book {+ display: grid;+ grid-template-columns: 4rem 1fr 1.25rem;+ gap: var(--space-md);+ padding: 0.6rem 0.4rem;+ align-items: baseline;+ border-top: 0.5px solid var(--color-rule);+ transition: background-color var(--dur-micro) var(--ease-out);+ }+ .book:last-child { border-bottom: 0.5px solid var(--color-rule); }++ @media (hover: hover) and (pointer: fine) {+ .book:hover { background-color: var(--color-row-hover); }+ }++ .book__year {+ font-family: var(--font-mono);+ font-size: var(--text-xs);+ color: var(--color-muted);+ font-variant-numeric: tabular-nums;+ }++ .book__title {+ font-size: var(--text-md);+ font-weight: 500;+ color: var(--color-ink);+ letter-spacing: -0.005em;+ line-height: 1.25;+ }++ .book__author {+ font-size: var(--text-sm);+ color: var(--color-neutral);+ margin-left: 0.6rem;+ font-weight: 400;+ }++ .book__status {+ font-family: var(--font-mono);+ font-size: var(--text-sm);+ text-align: center;+ color: var(--color-muted);+ font-weight: 400;+ }++ .book__status[data-state="reading"] { color: var(--color-accent); }+ .book__status[data-state="read"] { color: var(--color-muted); }+ .book__status[data-state="queued"] { color: var(--color-rule-2); }++ /* ⌘K invitation — visible, persistent, never animated */+ .invite {+ position: fixed;+ bottom: max(1rem, env(safe-area-inset-bottom));+ right: max(1rem, env(safe-area-inset-right));+ display: inline-flex;+ align-items: center;+ gap: 0.6rem;+ padding: 0.6rem 0.85rem;+ background: var(--color-paper);+ border: 1px solid var(--color-ink);+ font-family: var(--font-mono);+ font-size: var(--text-xs);+ letter-spacing: 0.06em;+ color: var(--color-ink);+ cursor: pointer;+ min-height: 36px;+ transition: background-color var(--dur-micro) var(--ease-out),+ color var(--dur-micro) var(--ease-out);+ }++ @media (hover: hover) and (pointer: fine) {+ .invite:hover { background: var(--color-ink); color: var(--color-paper); }+ }++ .invite:active { transition-duration: 60ms; }++ .kbd {+ display: inline-flex;+ align-items: center;+ gap: 0.2em;+ font-family: var(--font-mono);+ font-size: 0.6875rem;+ letter-spacing: 0;+ padding: 0.05rem 0.4rem;+ border: 1px solid currentColor;+ opacity: 0.7;+ font-weight: 500;+ min-height: 1.2em;+ }++ /* Footer hint */+ .foot {+ margin-top: var(--space-3xl);+ padding-top: var(--space-md);+ border-top: 1px solid var(--color-ink);+ font-family: var(--font-mono);+ font-size: var(--text-xs);+ letter-spacing: 0.04em;+ color: var(--color-muted);+ display: flex;+ justify-content: space-between;+ gap: var(--space-md);+ }++ /* ─────────────────────────────────────────────────────────+ Command palette — the heart of this demo+ ───────────────────────────────────────────────────────── */++ /* Native <dialog> as palette */+ dialog.palette {+ padding: 0;+ border: 0;+ background: transparent;+ max-width: 36rem;+ width: calc(100% - 2rem);+ margin-top: 12vh;+ color: var(--color-ink);+ }++ dialog.palette::backdrop {+ background-color: oklch(20% 0.012 245 / 0.45);+ backdrop-filter: blur(4px);+ -webkit-backdrop-filter: blur(4px);+ }++ /* Entrance animation — content + backdrop, ease-out, 300ms */+ dialog.palette[open] {+ animation: palette-in var(--dur-long) var(--ease-out) forwards;+ }+ dialog.palette[open]::backdrop {+ animation: backdrop-in var(--dur-long) var(--ease-out) forwards;+ }++ @keyframes palette-in {+ from { opacity: 0; transform: scale(0.96); }+ to { opacity: 1; transform: scale(1); }+ }+ @keyframes backdrop-in {+ from { opacity: 0; }+ to { opacity: 1; }+ }++ /* Exit — applied via .closing class for the brief moment before close */+ dialog.palette.closing {+ animation: palette-out 220ms var(--ease-in) forwards;+ }+ dialog.palette.closing::backdrop {+ animation: backdrop-out 220ms var(--ease-in) forwards;+ }+ @keyframes palette-out {+ to { opacity: 0; transform: scale(0.98); }+ }+ @keyframes backdrop-out {+ to { opacity: 0; }+ }++ .pal {+ background: var(--color-paper);+ border: 1px solid var(--color-rule-2);+ box-shadow: 0 24px 60px -20px oklch(20% 0.05 245 / 0.25);+ display: grid;+ grid-template-rows: auto 1fr auto;+ max-height: 70vh;+ }++ /* Input row */+ .pal__input-row {+ display: grid;+ grid-template-columns: 2.25rem 1fr auto;+ align-items: center;+ gap: var(--space-sm);+ padding: 0.85rem 1rem;+ border-bottom: 1px solid var(--color-rule);+ }++ .pal__leading {+ font-family: var(--font-mono);+ font-size: var(--text-md);+ color: var(--color-muted);+ text-align: center;+ line-height: 1;+ }++ .pal__input {+ width: 100%;+ background: transparent;+ border: 0;+ padding: 0.4rem 0;+ font-family: var(--font-sans);+ font-size: var(--text-md);+ color: var(--color-ink);+ letter-spacing: -0.005em;+ min-height: 32px;+ }++ .pal__input:focus { outline: none; }+ .pal__input::placeholder { color: var(--color-muted); }++ .pal__count {+ font-family: var(--font-mono);+ font-size: var(--text-xs);+ color: var(--color-muted);+ letter-spacing: 0.06em;+ font-variant-numeric: tabular-nums;+ }++ /* Results scroll area */+ .pal__results {+ position: relative;+ overflow-y: auto;+ padding: 0.4rem 0;+ scroll-padding-block: 0.4rem;+ scrollbar-color: var(--color-rule-2) transparent;+ }++ .pal__results::-webkit-scrollbar { width: 6px; }+ .pal__results::-webkit-scrollbar-track { background: transparent; }+ .pal__results::-webkit-scrollbar-thumb { background: var(--color-rule-2); }++ /* The selection tracker — single element, transitions translateY between rows.+ Linear / Raycast / Vercel pattern: items don't move, the tracker does. */+ .pal__tracker {+ position: absolute;+ left: 0.4rem;+ right: 0.4rem;+ height: 2.4rem;+ background: var(--color-row-active);+ pointer-events: none;+ transform: translateY(0);+ transition: transform 120ms var(--ease-out),+ opacity var(--dur-micro) var(--ease-out);+ }++ .pal__results[data-empty="true"] .pal__tracker { opacity: 0; }++ /* Result row */+ .pal__row {+ position: relative;+ display: grid;+ grid-template-columns: 3.25rem 1fr auto 1.5rem;+ gap: var(--space-sm);+ align-items: baseline;+ padding: 0.55rem 1rem;+ cursor: pointer;+ height: 2.4rem;+ transition: background-color 0ms; /* hover is instant */+ }++ @media (hover: hover) and (pointer: fine) {+ .pal__row:hover { background-color: var(--color-row-hover); }+ }++ .pal__row[aria-selected="true"] { background: transparent; /* tracker shows selection */ }++ .pal__row__year {+ font-family: var(--font-mono);+ font-size: var(--text-xs);+ color: var(--color-muted);+ font-variant-numeric: tabular-nums;+ }++ .pal__row__title {+ font-size: var(--text-base);+ color: var(--color-ink);+ font-weight: 500;+ letter-spacing: -0.003em;+ overflow: hidden;+ white-space: nowrap;+ text-overflow: ellipsis;+ }++ .pal__row__author {+ font-size: var(--text-sm);+ color: var(--color-neutral);+ font-weight: 400;+ margin-left: 0.5rem;+ }++ .pal__row__status {+ font-family: var(--font-mono);+ font-size: var(--text-sm);+ text-align: center;+ color: var(--color-muted);+ }++ .pal__row__status[data-state="reading"] { color: var(--color-accent); }+ .pal__row__status[data-state="queued"] { color: var(--color-rule-2); }++ /* Match highlighting */+ .pal__row mark {+ background: var(--color-mark-bg);+ color: inherit;+ padding: 0;+ border-radius: 1px;+ box-shadow: 0 -1px 0 var(--color-accent) inset;+ }++ /* Empty state */+ .pal__empty {+ padding: 2rem 1rem;+ text-align: center;+ font-family: var(--font-sans);+ color: var(--color-muted);+ font-size: var(--text-sm);+ line-height: var(--lh-relaxed);+ }+ .pal__empty .q {+ color: var(--color-ink);+ font-weight: 500;+ }++ /* Footer (kbd hints) */+ .pal__foot {+ display: flex;+ gap: var(--space-md);+ justify-content: flex-end;+ align-items: center;+ padding: 0.55rem 1rem;+ border-top: 1px solid var(--color-rule);+ font-family: var(--font-mono);+ font-size: 0.6875rem;+ letter-spacing: 0.06em;+ color: var(--color-muted);+ }++ .pal__hint { display: inline-flex; align-items: center; gap: 0.4rem; }+ .pal__hint .kbd { color: var(--color-ink-2); border-color: var(--color-rule-2); opacity: 1; }++ /* Reduced motion: collapse spatial motion to opacity */+ @media (prefers-reduced-motion: reduce) {+ dialog.palette[open],+ dialog.palette[open]::backdrop,+ dialog.palette.closing,+ dialog.palette.closing::backdrop {+ animation-duration: 150ms !important;+ }+ @keyframes palette-in { from { opacity: 0; } to { opacity: 1; } }+ @keyframes palette-out { to { opacity: 0; } }++ .pal__tracker { transition: none; }+ *, *::before, *::after {+ animation-duration: 150ms !important;+ transition-duration: 150ms !important;+ }+ }++ /* Mobile palette tweaks */+ @media (max-width: 36rem) {+ dialog.palette { margin-top: 4vh; max-height: 92vh; }+ .pal { max-height: 90vh; }+ .pal__row { grid-template-columns: 2.5rem 1fr 1.5rem; }+ .pal__row__author { display: block; margin-left: 0; }+ .pal__row__status { display: none; }+ }+ </style>+</head>+<body>++ <main class="page">++ <header class="head">+ <h1 class="wordmark">+ Lectern+ <span class="count" id="library-count"></span>+ </h1>+ <p class="meta">A personal library</p>+ </header>++ <div class="legend" aria-label="Status legend">+ <span class="legend__item"><span style="color: var(--color-accent)">●</span> reading</span>+ <span class="legend__item"><span style="color: var(--color-muted)">✓</span> read</span>+ <span class="legend__item"><span style="color: var(--color-rule-2)">○</span> queued</span>+ </div>++ <ul class="books" id="library" role="list" aria-label="Books"></ul>++ <footer class="foot">+ <span>Press <span class="kbd">⌘K</span> to find a book</span>+ <span>esc to close · ↵ to open</span>+ </footer>++ </main>++ <button class="invite" type="button" id="invite" aria-label="Open command palette">+ <span>Find a book</span>+ <span class="kbd">⌘K</span>+ </button>++ <dialog class="palette" id="palette" aria-label="Command palette">+ <div class="pal">++ <div class="pal__input-row">+ <span class="pal__leading" aria-hidden="true">/</span>+ <input+ class="pal__input"+ id="pal-input"+ type="search"+ autocomplete="off"+ autocorrect="off"+ autocapitalize="off"+ spellcheck="false"+ placeholder="Search 31 books"+ aria-label="Search books"+ aria-controls="pal-results"+ aria-activedescendant=""+ />+ <span class="pal__count" id="pal-count">31</span>+ </div>++ <div class="pal__results" id="pal-results" role="listbox" aria-label="Search results">+ <div class="pal__tracker" aria-hidden="true"></div>+ </div>++ <div class="pal__foot">+ <span class="pal__hint"><span class="kbd">↑</span><span class="kbd">↓</span> navigate</span>+ <span class="pal__hint"><span class="kbd">↵</span> open</span>+ <span class="pal__hint"><span class="kbd">esc</span> close</span>+ </div>++ </div>+ </dialog>++ <script type="module">+ /* ─── Data: ~31 books a developer might keep on a personal reading list ── */+ const BOOKS = [+ { y: 1968, t: "The Art of Computer Programming", a: "Donald E. Knuth", s: "queued" },+ { y: 1974, t: "Zen and the Art of Motorcycle Maintenance", a: "Robert M. Pirsig", s: "read" },+ { y: 1975, t: "The Mythical Man-Month", a: "Frederick P. Brooks Jr.", s: "read" },+ { y: 1977, t: "A Pattern Language", a: "Christopher Alexander", s: "read" },+ { y: 1979, t: "Gödel, Escher, Bach", a: "Douglas R. Hofstadter", s: "reading" },+ { y: 1981, t: "The Soul of a New Machine", a: "Tracy Kidder", s: "read" },+ { y: 1983, t: "The Visual Display of Quantitative Information", a: "Edward R. Tufte", s: "read" },+ { y: 1985, t: "Structure and Interpretation of Computer Programs", a: "Abelson & Sussman", s: "queued" },+ { y: 1985, t: "Tools for Thought", a: "Howard Rheingold", s: "read" },+ { y: 1988, t: "The Design of Everyday Things", a: "Don Norman", s: "read" },+ { y: 1989, t: "The Cuckoo's Egg", a: "Cliff Stoll", s: "read" },+ { y: 1990, t: "Envisioning Information", a: "Edward R. Tufte", s: "read" },+ { y: 1992, t: "The Elements of Typographic Style", a: "Robert Bringhurst", s: "read" },+ { y: 1994, t: "Out of Control", a: "Kevin Kelly", s: "queued" },+ { y: 1996, t: "Where Wizards Stay Up Late", a: "Hafner & Lyon", s: "read" },+ { y: 1997, t: "The Innovator's Dilemma", a: "Clayton M. Christensen", s: "read" },+ { y: 1998, t: "Seeing Like a State", a: "James C. Scott", s: "reading" },+ { y: 1999, t: "Code", a: "Charles Petzold", s: "read" },+ { y: 1999, t: "The Pragmatic Programmer", a: "Hunt & Thomas", s: "read" },+ { y: 1999, t: "Refactoring", a: "Martin Fowler", s: "read" },+ { y: 2000, t: "Don't Make Me Think", a: "Steve Krug", s: "read" },+ { y: 2003, t: "Domain-Driven Design", a: "Eric Evans", s: "read" },+ { y: 2003, t: "Universal Principles of Design", a: "Lidwell, Holden & Butler", s: "queued" },+ { y: 2004, t: "Hackers and Painters", a: "Paul Graham", s: "read" },+ { y: 2004, t: "Working Effectively with Legacy Code", a: "Michael Feathers", s: "read" },+ { y: 2008, t: "Clean Code", a: "Robert C. Martin", s: "read" },+ { y: 2011, t: "The Information", a: "James Gleick", s: "read" },+ { y: 2017, t: "Designing Data-Intensive Applications", a: "Martin Kleppmann", s: "reading" },+ { y: 2019, t: "Software Engineering at Google", a: "Winters, Manshreck & Wright", s: "queued" },+ { y: 2021, t: "A Philosophy of Software Design", a: "John Ousterhout", s: "read" },+ { y: 2024, t: "Tidy First?", a: "Kent Beck", s: "queued" }+ ];++ /* ─── Render ambient library list ── */+ const STATUS_GLYPH = { reading: "●", read: "✓", queued: "○" };++ const lib = document.getElementById("library");+ const libraryCount = document.getElementById("library-count");+ libraryCount.textContent = `· ${BOOKS.length} books`;++ function renderLibrary() {+ const sorted = [...BOOKS].sort((a, b) => b.y - a.y);+ lib.innerHTML = sorted.map((b) => `+ <li class="book" role="listitem">+ <span class="book__year">${b.y}</span>+ <span><span class="book__title">${escape(b.t)}</span><span class="book__author">${escape(b.a)}</span></span>+ <span class="book__status" data-state="${b.s}" title="${b.s}" aria-label="${b.s}">${STATUS_GLYPH[b.s]}</span>+ </li>+ `).join("");+ }++ function escape(s) {+ return s.replace(/[&<>"']/g, (c) => ({ "&":"&", "<":"<", ">":">", '"':""", "'":"'" }[c]));+ }++ renderLibrary();++ /* ─── Fuzzy match: in-order character match, score by spread + length ── */+ function fuzzyMatch(query, text) {+ if (!query) return { match: true, score: 0, positions: [] };+ const q = query.toLowerCase();+ const t = text.toLowerCase();+ const positions = [];+ let qi = 0;+ for (let ti = 0; ti < t.length && qi < q.length; ti++) {+ if (t[ti] === q[qi]) {+ positions.push(ti);+ qi++;+ }+ }+ if (qi !== q.length) return { match: false };+ const spread = positions[positions.length - 1] - positions[0];+ // Lower score is better+ const score = spread + text.length * 0.2;+ return { match: true, score, positions };+ }++ function highlight(text, positions) {+ if (!positions.length) return escape(text);+ const set = new Set(positions);+ let out = "";+ let inMark = false;+ for (let i = 0; i < text.length; i++) {+ if (set.has(i) && !inMark) { out += "<mark>"; inMark = true; }+ if (!set.has(i) && inMark) { out += "</mark>"; inMark = false; }+ const c = text[i];+ out += ({ "&":"&", "<":"<", ">":">", '"':""", "'":"'" }[c]) || c;+ }+ if (inMark) out += "</mark>";+ return out;+ }++ /* ─── Palette state ── */+ const dlg = document.getElementById("palette");+ const input = document.getElementById("pal-input");+ const results = document.getElementById("pal-results");+ const tracker = results.querySelector(".pal__tracker");+ const count = document.getElementById("pal-count");+ const invite = document.getElementById("invite");++ let currentResults = [];+ let selectedIndex = 0;+ let debounce = null;++ function search(query) {+ const matches = BOOKS+ .map((b, i) => {+ const titleHit = fuzzyMatch(query, b.t);+ const authorHit = fuzzyMatch(query, b.a);+ // Best of (title, author); prefer title hits+ if (titleHit.match) return { book: b, on: "title", hit: titleHit, score: titleHit.score };+ if (authorHit.match) return { book: b, on: "author", hit: authorHit, score: authorHit.score + 100 };+ return null;+ })+ .filter(Boolean)+ .sort((a, z) => a.score - z.score);++ return matches;+ }++ function render() {+ const q = input.value.trim();+ currentResults = search(q);+ count.textContent = String(currentResults.length);++ // clamp selection+ if (selectedIndex >= currentResults.length) selectedIndex = currentResults.length - 1;+ if (selectedIndex < 0) selectedIndex = 0;++ // Empty state+ if (!currentResults.length) {+ results.dataset.empty = "true";+ // Preserve the tracker element when re-rendering+ results.innerHTML = "";+ results.appendChild(tracker);+ const empty = document.createElement("div");+ empty.className = "pal__empty";+ empty.innerHTML = q+ ? `Nothing matches <span class="q">“${escape(q)}”</span>. Try a shorter query, or check the year.`+ : `Start typing to search.`;+ results.appendChild(empty);+ input.setAttribute("aria-activedescendant", "");+ return;+ }++ results.dataset.empty = "false";+ const html = currentResults.map((m, i) => {+ const { book, on, hit } = m;+ const titleHtml = on === "title" ? highlight(book.t, hit.positions) : escape(book.t);+ const authorHtml = on === "author" ? highlight(book.a, hit.positions) : escape(book.a);+ return `+ <div class="pal__row" role="option" id="pal-row-${i}" data-index="${i}" aria-selected="${i === selectedIndex}">+ <span class="pal__row__year">${book.y}</span>+ <span><span class="pal__row__title">${titleHtml}</span><span class="pal__row__author">${authorHtml}</span></span>+ <span></span>+ <span class="pal__row__status" data-state="${book.s}" aria-label="${book.s}" title="${book.s}">${STATUS_GLYPH[book.s]}</span>+ </div>+ `;+ }).join("");++ results.innerHTML = "";+ results.appendChild(tracker);+ const wrap = document.createElement("div");+ wrap.innerHTML = html;+ while (wrap.firstChild) results.appendChild(wrap.firstChild);++ input.setAttribute("aria-activedescendant", `pal-row-${selectedIndex}`);+ moveTracker();+ }++ function moveTracker() {+ const row = results.querySelector(`[data-index="${selectedIndex}"]`);+ if (!row) { tracker.style.opacity = "0"; return; }+ tracker.style.opacity = "1";+ // Position the tracker over the selected row+ const rowOffset = row.offsetTop;+ tracker.style.transform = `translateY(${rowOffset}px)`;+ // Ensure visible in scroll area+ row.scrollIntoView({ block: "nearest", behavior: "instant" });+ }++ function move(delta) {+ if (!currentResults.length) return;+ selectedIndex = (selectedIndex + delta + currentResults.length) % currentResults.length;+ results.querySelectorAll(".pal__row").forEach((el) => {+ el.setAttribute("aria-selected", el.dataset.index == selectedIndex ? "true" : "false");+ });+ input.setAttribute("aria-activedescendant", `pal-row-${selectedIndex}`);+ moveTracker();+ }++ function commit() {+ const m = currentResults[selectedIndex];+ if (!m) return;+ // "Open the book" — silent success: just close the palette.+ // In a real app, this would route to /book/<slug>.+ console.log("Open:", m.book.t);+ close();+ }++ function open() {+ input.value = "";+ selectedIndex = 0;+ render();+ dlg.showModal();+ // Auto-focus input — already handled by autofocus+ showModal+ requestAnimationFrame(() => input.focus());+ }++ function close() {+ // Apply a brief exit animation then close+ const reduced = matchMedia("(prefers-reduced-motion: reduce)").matches;+ if (reduced) {+ dlg.close();+ return;+ }+ dlg.classList.add("closing");+ const onEnd = () => {+ dlg.classList.remove("closing");+ dlg.close();+ dlg.removeEventListener("animationend", onEnd);+ };+ dlg.addEventListener("animationend", onEnd);+ }++ /* ─── Event wiring ── */++ // ⌘K / Ctrl+K to open+ document.addEventListener("keydown", (e) => {+ if ((e.metaKey || e.ctrlKey) && (e.key === "k" || e.key === "K")) {+ e.preventDefault();+ if (dlg.open) close(); else open();+ }+ });++ invite.addEventListener("click", open);++ // Click outside to close (the dialog backdrop)+ dlg.addEventListener("click", (e) => {+ const rect = dlg.getBoundingClientRect();+ const inDialog = e.clientX >= rect.left && e.clientX <= rect.right+ && e.clientY >= rect.top && e.clientY <= rect.bottom;+ if (!inDialog) close();+ });++ // Cancel (Escape) — let dialog handle its native close, but use our exit animation+ dlg.addEventListener("cancel", (e) => {+ e.preventDefault();+ close();+ });++ // Input — search-as-you-type, debounced 180ms+ input.addEventListener("input", () => {+ clearTimeout(debounce);+ debounce = setTimeout(render, 180);+ // Also reset selection to top on each keystroke+ selectedIndex = 0;+ });++ // Keyboard nav on the input+ input.addEventListener("keydown", (e) => {+ if (e.key === "ArrowDown") { e.preventDefault(); move(1); }+ else if (e.key === "ArrowUp") { e.preventDefault(); move(-1); }+ else if (e.key === "Home") { e.preventDefault(); selectedIndex = 0; move(0); }+ else if (e.key === "End") { e.preventDefault(); selectedIndex = currentResults.length - 1; move(0); }+ else if (e.key === "Enter") { e.preventDefault(); commit(); }+ });++ // Click a result to select + open+ results.addEventListener("click", (e) => {+ const row = e.target.closest(".pal__row");+ if (!row) return;+ selectedIndex = Number(row.dataset.index);+ commit();+ });++ // Hover updates selection visually (matches Linear / Raycast behaviour)+ results.addEventListener("mousemove", (e) => {+ const row = e.target.closest(".pal__row");+ if (!row) return;+ const idx = Number(row.dataset.index);+ if (idx !== selectedIndex) {+ selectedIndex = idx;+ results.querySelectorAll(".pal__row").forEach((el) => {+ el.setAttribute("aria-selected", el.dataset.index == selectedIndex ? "true" : "false");+ });+ input.setAttribute("aria-activedescendant", `pal-row-${selectedIndex}`);+ moveTracker();+ }+ });++ </script>+</body>+</html>diff --git a/site/css/base.css b/site/css/base.cssnew file mode 100644index 0000000..6ec8f34--- /dev/null+++ b/site/css/base.css@@ -0,0 +1,239 @@+/* Hallmark — base: fonts, reset, body */++/* — The Future (Together AI's typeface) ——————————————— */+@font-face {+ font-family: "The Future";+ font-style: normal;+ font-weight: 300;+ font-display: swap;+ src: url("../fonts/the-future-light.woff2") format("woff2");+}+@font-face {+ font-family: "The Future";+ font-style: normal;+ font-weight: 400;+ font-display: swap;+ src: url("../fonts/the-future-regular.woff2") format("woff2");+}+@font-face {+ font-family: "The Future";+ font-style: normal;+ font-weight: 500;+ font-display: swap;+ src: url("../fonts/the-future-medium.woff2") format("woff2");+}+@font-face {+ font-family: "The Future";+ font-style: normal;+ font-weight: 700;+ font-display: swap;+ src: url("../fonts/the-future-bold.woff2") format("woff2");+}+@font-face {+ font-family: "The Future Mono";+ font-style: normal;+ font-weight: 300;+ font-display: swap;+ src: url("../fonts/the-future-mono-light.woff2") format("woff2");+}+@font-face {+ font-family: "The Future Mono";+ font-style: normal;+ font-weight: 400;+ font-display: swap;+ src: url("../fonts/the-future-mono-regular.woff2") format("woff2");+}+@font-face {+ font-family: "The Future Mono";+ font-style: normal;+ font-weight: 500;+ font-display: swap;+ src: url("../fonts/the-future-mono-medium.woff2") format("woff2");+}+@font-face {+ font-family: "The Future Mono";+ font-style: normal;+ font-weight: 700;+ font-display: swap;+ src: url("../fonts/the-future-mono-bold.woff2") format("woff2");+}++/* — Google Fonts — all theme display & alt faces ——————————— */+@import url("https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,300..700;1,9..144,300..700&family=Instrument+Serif:ital@0;1&family=Cormorant+Garamond:ital,wght@0,300..700;1,300..700&family=Crimson+Pro:ital,wght@0,200..900;1,200..900&family=Newsreader:ital,opsz,wght@0,6..72,200..800;1,6..72,200..800&family=DM+Serif+Display:ital@0;1&family=Space+Grotesk:wght@300;400;500;600;700&family=Bricolage+Grotesque:opsz,[email protected],200..800&family=Plus+Jakarta+Sans:ital,wght@0,200..800;1,200..700&family=Hanken+Grotesk:ital,wght@0,100..900;1,100..900&family=IBM+Plex+Sans:ital,wght@0,300;0,400;0,500;0,600;1,400;1,500&family=IBM+Plex+Mono:ital,wght@0,300;0,400;0,500;0,600;1,400&family=JetBrains+Mono:ital,wght@0,400;0,500;0,700;1,400&display=swap");++/* — Reset ———————————————————————————————————————————— */+*, *::before, *::after { box-sizing: border-box; }++html { -webkit-text-size-adjust: 100%; }++body, h1, h2, h3, h4, p, figure, blockquote, dl, dd {+ margin: 0;+}++img, picture, svg, video { display: block; max-width: 100%; height: auto; }++button, input, select, textarea {+ font: inherit;+ color: inherit;+}++button { background: none; border: 0; padding: 0; cursor: pointer; }++a { color: inherit; text-decoration: none; }++ul, ol { margin: 0; padding: 0; list-style: none; }++:focus { outline: none; }+:focus-visible {+ outline: 2px solid var(--color-focus);+ outline-offset: 3px;+ border-radius: 2px;+}++/* — Theme transitions — targeted so type swap feels intentional —— */+html,+body,+.nav,+.opening__title,+.opening__sub,+.section__title,+.spec__name,+.spec__rule,+.tell,+.tell__viz,+.tell__meta,+.tell__name,+.tell__why,+.step__head,+.step__sub,+.install__body,+.foot,+.foot__credits,+.code,+.swatch,+.section__head,+.vs,+.vs__col,+.vs__caption,+hr.rule,+.themer,+.themer__btn {+ transition:+ background-color var(--dur-short) var(--ease-out),+ color var(--dur-short) var(--ease-out),+ border-color var(--dur-short) var(--ease-out);+}++/* — Body ————————————————————————————————————————————— */+html {+ background: var(--color-paper);+ color: var(--color-ink);+}++body {+ font-family: var(--font-body);+ font-weight: 400;+ font-size: var(--text-base);+ line-height: var(--lh-relaxed);+ letter-spacing: var(--tracking-normal);+ font-feature-settings: "ss01", "ss02", "cv01";+ -webkit-font-smoothing: antialiased;+ -moz-osx-font-smoothing: grayscale;+ min-height: 100dvh;+ padding-inline: max(var(--page-gutter), env(safe-area-inset-left));+ padding-block-end: env(safe-area-inset-bottom);+ overflow-x: hidden;+}++/* — Selection ——————————————————————————————————————— */+::selection {+ background: var(--color-accent);+ color: var(--color-paper);+}++/* — Typography primitives ——————————————————————————— */+h1, h2, h3, h4 {+ font-family: var(--font-display);+ font-weight: var(--display-weight, 400);+ font-style: var(--display-style, normal);+ line-height: var(--lh-tight);+ letter-spacing: var(--tracking-display);+ color: var(--color-ink);+ font-optical-sizing: auto;+ font-variation-settings:+ "opsz" var(--display-optical, 48),+ "SOFT" var(--display-soft, 0);+}++h1 { font-size: var(--text-display); }+h2 { font-size: var(--text-display-s); }+h3 { font-size: var(--text-xl); font-weight: 500; line-height: var(--lh-snug); letter-spacing: var(--tracking-tight); font-style: normal; font-variation-settings: normal; }+h4 { font-size: var(--text-md); font-weight: 500; line-height: var(--lh-snug); letter-spacing: var(--tracking-tight); font-style: normal; font-variation-settings: normal; }++p { max-width: var(--measure); }++strong { font-weight: 500; }++em { font-style: italic; }++code, kbd, samp, pre {+ font-family: var(--font-mono);+ font-size: 0.9em;+ font-feature-settings: "tnum";+}++/* — Utility: label (small caps numbering) —————————— */+.label {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ font-weight: 400;+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-muted);+}++/* — Utility: rule (hairline divider) ———————————————— */+.rule {+ border: 0;+ border-top: var(--rule-hair) solid var(--color-rule);+ margin: 0;+}++.rule-strong {+ border-top-color: var(--color-rule-2);+ border-top-width: var(--rule-fine);+}++/* — Utility: serif (editorial emphasis) ———————————— */+.serif {+ font-family: var(--font-serif);+ font-weight: 400;+ font-optical-sizing: auto;+ font-variant-numeric: oldstyle-nums;+}++.serif-italic {+ font-family: var(--font-serif);+ font-style: italic;+ font-weight: 400;+}++/* — Utility: tabular numbers ————————————————————————— */+.tnum { font-variant-numeric: tabular-nums; }++/* — Utility: container ————————————————————————————————— */+.container {+ max-width: var(--page-max);+ margin-inline: auto;+ width: 100%;+}++/* — Orange square (the accent mark) ——————————————————— */+.mark {+ display: inline-block;+ width: 0.55em;+ height: 0.55em;+ background: var(--color-accent);+ vertical-align: 0.04em;+ transition: background-color var(--dur-short) var(--ease-out);+}diff --git a/site/css/components.css b/site/css/components.cssnew file mode 100644index 0000000..9edcb30--- /dev/null+++ b/site/css/components.css@@ -0,0 +1,766 @@+/* Hallmark — components */++/* — Wordmark ——————————————————————————————————————— */+.wordmark {+ font-family: var(--font-label);+ font-weight: 500;+ font-size: var(--text-sm);+ letter-spacing: 0.22em;+ text-transform: uppercase;+ color: var(--color-ink);+}++[data-theme="manifesto"] .wordmark {+ font-family: var(--font-display);+ font-weight: 800;+ letter-spacing: -0.02em;+ text-transform: uppercase;+ font-size: var(--text-md);+}++[data-theme="terminal"] .wordmark::before {+ content: "$ ";+ color: var(--color-accent);+}++/* — Theme picker (button + popover) ————————————————————————— */+.themer {+ position: relative;+ display: inline-flex;+ align-items: center;+ gap: var(--space-xs);+ font-family: var(--font-label);+ font-size: 0.6875rem;+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-ink);+}++.themer__trigger {+ display: inline-flex;+ align-items: center;+ gap: 0.5rem;+ padding: 0.55rem 0.9rem;+ background: var(--color-paper-2);+ border: var(--rule-hair) solid var(--color-rule-2);+ color: var(--color-ink);+ font: inherit;+ letter-spacing: 0.14em;+ cursor: pointer;+ min-height: 36px;+}++.themer__trigger:focus-visible {+ outline: 2px solid var(--color-focus);+ outline-offset: 2px;+}++.themer__trigger-label {+ color: var(--color-muted);+}++.themer__trigger-current {+ color: var(--color-ink);+ font-weight: 500;+}++.themer__trigger-caret {+ width: 0.45em;+ height: 0.45em;+ border-right: 1.5px solid currentColor;+ border-bottom: 1.5px solid currentColor;+ transform: rotate(45deg) translateY(-1px);+ transition: transform var(--dur-short) var(--ease-out);+}++.themer[aria-expanded="true"] .themer__trigger-caret {+ transform: rotate(225deg) translateY(2px);+}++/* Keyboard-shortcut hint — delay-reveals on hover (Linear / Notion pattern) */+.themer__kbd {+ display: inline-flex;+ align-items: center;+ gap: 0.3em;+ margin-left: 0.5rem;+ padding: 0.15rem 0.4rem;+ font-family: var(--font-label);+ font-size: 0.625rem;+ letter-spacing: 0.08em;+ color: var(--color-muted);+ background: var(--color-paper-3);+ border: var(--rule-hair) solid var(--color-rule);+ opacity: 0;+ transform: translateX(-4px);+ pointer-events: none;+ /* hover delay: 1.2s before reveal — Notion/Linear pattern */+ transition: opacity 180ms var(--ease-out) 1.2s,+ transform 180ms var(--ease-out) 1.2s;+}++.themer__trigger:hover ~ .themer__kbd {+ opacity: 1;+ transform: none;+}++.themer__trigger:focus-visible ~ .themer__kbd,+.themer[aria-expanded="true"] .themer__kbd {+ opacity: 1;+ transform: none;+ /* no delay on focus or open — keyboard users want it now */+ transition: opacity 180ms var(--ease-out),+ transform 180ms var(--ease-out);+}++.themer__kbd-key {+ font-weight: 500;+ color: var(--color-ink);+}++@media (max-width: 56rem) {+ .themer__kbd { display: none; }+}++@media (prefers-reduced-motion: reduce) {+ .themer__kbd { transition-duration: 0.01ms; transition-delay: 0.01ms; }+}++/* Popover panel */+.themer__panel {+ position: absolute;+ top: calc(100% + 0.5rem);+ left: 50%;+ transform: translateX(-50%) translateY(-4px);+ width: min(48rem, calc(100vw - 2rem));+ background: var(--color-paper);+ border: var(--rule-hair) solid var(--color-rule-2);+ padding: var(--space-lg);+ z-index: var(--z-dropdown);+ display: grid;+ grid-template-columns: repeat(4, 1fr);+ gap: var(--space-lg);+ opacity: 0;+ pointer-events: none;+ transition: opacity var(--dur-short) var(--ease-out),+ transform var(--dur-short) var(--ease-out);+}++.themer[aria-expanded="true"] .themer__panel {+ opacity: 1;+ pointer-events: auto;+ transform: translateX(-50%) translateY(0);+}++@media (max-width: 60rem) {+ .themer__panel {+ grid-template-columns: repeat(2, 1fr);+ width: min(28rem, calc(100vw - 2rem));+ left: auto;+ right: 0;+ transform: translateY(-4px);+ }+ .themer[aria-expanded="true"] .themer__panel { transform: translateY(0); }+}++.themer__group {+ display: grid;+ gap: var(--space-xs);+}++.themer__group-label {+ font-family: var(--font-label);+ font-size: 0.625rem;+ letter-spacing: 0.18em;+ text-transform: uppercase;+ color: var(--color-muted);+ padding-bottom: 0.4rem;+ border-bottom: var(--rule-hair) solid var(--color-rule);+}++.themer__btn {+ font: inherit;+ font-family: var(--font-label);+ display: grid;+ grid-template-columns: 1fr auto;+ align-items: center;+ gap: 0.5rem;+ padding: 0.5rem 0.55rem;+ background: transparent;+ border: 0;+ cursor: pointer;+ text-align: left;+ color: var(--color-neutral);+ letter-spacing: 0.10em;+ text-transform: uppercase;+ font-size: 0.6875rem;+ min-height: 32px;+}++.themer__btn:hover { color: var(--color-ink); background: var(--color-paper-2); }++.themer__btn:focus-visible {+ outline: 2px solid var(--color-focus);+ outline-offset: -2px;+}++.themer__btn[aria-pressed="true"] {+ color: var(--color-ink);+ background: var(--color-paper-2);+ position: relative;+}++.themer__btn[aria-pressed="true"]::before {+ content: "";+ position: absolute;+ left: 0;+ top: 0.5rem;+ bottom: 0.5rem;+ width: 2px;+ background: var(--color-accent);+}++.themer__swatches {+ display: inline-flex;+ gap: 2px;+}++.themer__swatch {+ width: 0.55rem;+ height: 0.55rem;+ border-radius: 50%;+}++/* — Section label (01 / FOUNDATIONS) —————————————————— */+.section-label {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ font-weight: 400;+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-muted);+ display: flex;+ align-items: baseline;+ gap: var(--space-sm);+}++.section-label .num { color: var(--color-ink); font-weight: 500; }+.section-label .divider { color: var(--color-rule-2); font-weight: 300; }++[data-theme="terminal"] .section-label::before {+ content: "> ";+ color: var(--color-accent);+}++[data-theme="manifesto"] .section-label .num {+ color: var(--color-accent);+ font-family: var(--font-display);+ font-weight: 800;+ font-size: var(--text-md);+}++[data-theme="sport"] .section-label .num {+ color: var(--color-accent);+ font-weight: 700;+ font-family: var(--font-display);+ font-size: var(--text-md);+ font-style: italic;+}++[data-theme="almanac"] .section-label {+ font-family: var(--font-mono);+}++/* — Button (outlined default) ————————————————————————— */+.btn {+ display: inline-flex;+ align-items: center;+ gap: var(--space-sm);+ padding: var(--space-sm) var(--space-lg);+ font-family: var(--font-label);+ font-size: var(--text-sm);+ font-weight: 500;+ letter-spacing: 0.04em;+ color: var(--color-ink);+ background: transparent;+ border: var(--rule-fine) solid var(--color-ink);+ border-radius: 0;+ min-height: 44px;+ /* explicit properties — never `transition: all` */+ transition: transform 100ms var(--ease-out),+ background-color var(--dur-micro) var(--ease-out),+ color var(--dur-micro) var(--ease-out),+ border-color var(--dur-micro) var(--ease-out);+ cursor: pointer;+}++@media (hover: hover) and (pointer: fine) {+ .btn:hover {+ background: var(--color-ink);+ color: var(--color-paper);+ transform: translateY(-1px);+ }+}+.btn:active { transform: translateY(1px); transition-duration: 60ms; }++/* — Inline link ————————————————————————————————————— */+.link {+ color: var(--color-ink);+ text-decoration: none;+ background-image: linear-gradient(var(--color-accent), var(--color-accent));+ background-repeat: no-repeat;+ background-position: 0 100%;+ background-size: 100% 1px;+ padding-bottom: 0.08em;+ transition: background-size var(--dur-short) var(--ease-out);+}++@media (hover: hover) and (pointer: fine) {+ .link:hover { background-size: 100% 2px; }+}++[data-theme="terminal"] .link {+ background: none;+ text-decoration: underline;+ text-underline-offset: 2px;+}++/* — Code block ——————————————————————————————————————— */+.code {+ font-family: var(--font-mono);+ font-size: var(--text-sm);+ font-weight: 400;+ color: var(--color-ink);+ background: var(--color-paper-2);+ border: var(--rule-hair) solid var(--color-rule);+ padding: var(--space-md) var(--space-lg);+ overflow-x: auto;+ white-space: nowrap;+ line-height: 1.7;+ display: flex;+ align-items: center;+ gap: var(--space-md);+ position: relative;+}++.code .prompt { color: var(--color-muted); user-select: none; }+.code--block { white-space: pre; display: block; }++/* — Copy-to-clipboard button (silent success pattern) ————— */+.code__copy {+ position: absolute;+ top: 50%;+ right: var(--space-sm);+ transform: translateY(-50%);+ font-family: var(--font-label);+ font-size: 0.6875rem;+ letter-spacing: 0.14em;+ text-transform: uppercase;+ color: var(--color-muted);+ background: var(--color-paper);+ border: var(--rule-hair) solid var(--color-rule);+ padding: 0.35rem 0.65rem;+ cursor: pointer;+ opacity: 0;+ transition: opacity var(--dur-short) var(--ease-out),+ color var(--dur-short) var(--ease-out),+ border-color var(--dur-short) var(--ease-out);+ min-height: 28px;+ display: inline-flex;+ align-items: center;+ gap: 0.4rem;+}++.code:hover .code__copy,+.code:focus-within .code__copy,+.code__copy:focus-visible {+ opacity: 1;+}++@media (pointer: coarse) {+ .code__copy { opacity: 1; }+}++.code__copy:hover { color: var(--color-ink); border-color: var(--color-rule-2); }++.code__copy[data-state="copied"] {+ color: var(--color-accent);+ border-color: var(--color-accent);+ opacity: 1;+}++.code__copy-default { display: inline; }+.code__copy-done { display: none; }++.code__copy[data-state="copied"] .code__copy-default { display: none; }+.code__copy[data-state="copied"] .code__copy-done { display: inline; }++[data-theme="terminal"] .code__copy {+ background: var(--color-paper-2);+ border-color: var(--color-rule);+}++[data-theme="manifesto"] .code__copy {+ background: var(--color-paper);+ color: var(--color-paper);+ border-color: var(--color-paper);+ font-weight: 500;+}++[data-theme="manifesto"] .code__copy:hover {+ color: var(--color-paper);+ background: var(--color-accent);+ border-color: var(--color-accent);+}++[data-theme="terminal"] .code {+ background: var(--color-paper-3);+ border-color: var(--color-rule-2);+}++[data-theme="manifesto"] .code {+ background: var(--color-ink);+ color: var(--color-paper);+ border-color: var(--color-ink);+}++[data-theme="manifesto"] .code .prompt { color: var(--color-accent); }++/* — Specimen card ——————————————————————————————————— */+.spec {+ display: flex;+ flex-direction: column;+ gap: var(--space-lg);+ padding: var(--space-xl) 0;+ border-top: var(--rule-hair) solid var(--color-rule);+}++.spec__head {+ display: flex;+ align-items: baseline;+ justify-content: space-between;+ gap: var(--space-md);+}++.spec__name {+ font-family: var(--font-display);+ font-weight: var(--display-weight, 400);+ font-style: var(--display-style, normal);+ font-size: var(--text-xl);+ letter-spacing: var(--tracking-tight);+ color: var(--color-ink);+ line-height: 1;+ font-optical-sizing: auto;+}++.spec__num {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ color: var(--color-muted);+ letter-spacing: var(--tracking-label);+}++.spec__rule {+ font-family: var(--font-serif);+ font-weight: 400;+ font-size: var(--text-md);+ line-height: var(--lh-snug);+ color: var(--color-ink-2);+ font-style: italic;+ max-width: 40ch;+}++[data-theme="brutal"] .spec__rule,+[data-theme="manifesto"] .spec__rule,+[data-theme="terminal"] .spec__rule,+[data-theme="sport"] .spec__rule,+[data-theme="almanac"] .spec__rule {+ font-style: normal;+ font-family: var(--font-body);+ font-weight: 500;+}++[data-theme="manifesto"] .spec__name { text-transform: uppercase; }++.spec__body { margin-top: var(--space-xs); }++/* — Swatches ——————————————————————————————————————— */+.swatch-row {+ display: grid;+ grid-template-columns: repeat(5, 1fr);+ gap: var(--space-2xs);+ height: 3rem;+}++.swatch {+ display: flex;+ align-items: flex-end;+ padding: var(--space-2xs) var(--space-xs);+ font-family: var(--font-label);+ font-size: 0.625rem;+ letter-spacing: 0.08em;+ color: var(--color-paper);+ text-transform: uppercase;+}++.swatch--light { color: var(--color-ink); }++/* — Type specimen ——————————————————————————————————— */+.type-spec { display: grid; gap: var(--space-xs); }++.type-spec__display {+ font-family: var(--font-display);+ font-size: var(--text-2xl);+ font-weight: var(--display-weight, 400);+ font-style: var(--display-style, normal);+ line-height: var(--lh-tight);+ letter-spacing: var(--tracking-display);+ font-optical-sizing: auto;+}++.type-spec__body {+ font-family: var(--font-serif);+ font-style: italic;+ font-size: var(--text-md);+ line-height: var(--lh-normal);+ color: var(--color-ink-2);+ max-width: 32ch;+}++[data-theme="brutal"] .type-spec__body,+[data-theme="manifesto"] .type-spec__body,+[data-theme="terminal"] .type-spec__body,+[data-theme="sport"] .type-spec__body,+[data-theme="almanac"] .type-spec__body {+ font-style: normal;+ font-family: var(--font-body);+}++/* — Easing curve SVG ——————————————————————————————— */+.curve {+ width: 100%;+ height: 4.5rem;+ color: var(--color-ink);+}++/* — Tell card (gallery) ————————————————————————————— */+.tell {+ flex: 0 0 18rem;+ display: grid;+ grid-template-rows: 13rem auto;+ border: var(--rule-hair) solid var(--color-rule);+ scroll-snap-align: start;+ background: var(--color-paper);+}++.tell__viz {+ position: relative;+ overflow: hidden;+ background: var(--color-paper-2);+}++.tell__meta {+ padding: var(--space-md) var(--space-md) var(--space-lg);+ display: grid;+ gap: var(--space-xs);+ border-top: var(--rule-hair) solid var(--color-rule);+}++.tell__name {+ font-family: var(--font-display);+ font-weight: var(--display-weight, 400);+ font-style: var(--display-style, normal);+ font-size: var(--text-lg);+ color: var(--color-ink);+ letter-spacing: var(--tracking-tight);+ line-height: 1;+ font-optical-sizing: auto;+}++[data-theme="manifesto"] .tell__name { text-transform: uppercase; }++.tell__why {+ font-family: var(--font-serif);+ font-style: italic;+ font-weight: 400;+ font-size: var(--text-sm);+ color: var(--color-neutral);+ max-width: 34ch;+ line-height: var(--lh-snug);+}++[data-theme="brutal"] .tell__why,+[data-theme="manifesto"] .tell__why,+[data-theme="terminal"] .tell__why,+[data-theme="sport"] .tell__why,+[data-theme="almanac"] .tell__why {+ font-style: normal;+ font-family: var(--font-body);+}++/* — Tell visualisations (intentional anti-pattern demos) ————————— */+.viz-purple-hero {+ position: absolute; inset: 0;+ background: linear-gradient(135deg, #6b4de0 0%, #e04db4 60%, #e0904d 100%);+ display: grid; place-items: center;+ color: #fff;+ font-family: "Inter", sans-serif;+ font-size: 1rem; font-weight: 700;+ letter-spacing: -0.02em;+}+.viz-purple-hero::after { content: "Unleash the future"; }++.viz-gradient-text {+ position: absolute; inset: 0;+ display: grid; place-items: center;+ background: #fff;+}+.viz-gradient-text::after {+ content: "Supercharged";+ font-family: "Inter", sans-serif;+ font-weight: 800; font-size: 2rem;+ letter-spacing: -0.03em;+ background: linear-gradient(90deg, #8a3fe0, #e03f8a);+ -webkit-background-clip: text;+ background-clip: text;+ color: transparent;+}++.viz-icon-tile {+ position: absolute; inset: 0;+ display: grid;+ grid-template-columns: 1fr 1fr 1fr;+ gap: 0.5rem; padding: 0.75rem;+ background: #fff;+}+.viz-icon-tile > div {+ background: #f7f7f9;+ border-radius: 8px; padding: 0.5rem;+ display: grid; gap: 0.35rem;+ align-content: start;+ box-shadow: 0 1px 3px rgba(0,0,0,0.04);+}+.viz-icon-tile .icon {+ width: 1.4rem; height: 1.4rem;+ background: #e5e4ff; border-radius: 6px;+}+.viz-icon-tile .h { height: 0.45rem; background: #222; border-radius: 2px; width: 80%; }+.viz-icon-tile .t { height: 0.3rem; background: #d7d8df; border-radius: 2px; }++.viz-centered-hero {+ position: absolute; inset: 0;+ background: #fff;+ display: grid; place-items: center; align-content: center;+ gap: 0.5rem; text-align: center;+ font-family: "Inter", sans-serif; padding: 1rem;+}+.viz-centered-hero .h { font-size: 1.3rem; font-weight: 800; color: #111; letter-spacing: -0.03em; }+.viz-centered-hero .s { font-size: 0.8rem; color: #666; max-width: 20ch; margin: 0 auto; }+.viz-centered-hero .c {+ display: inline-block;+ padding: 0.5rem 1rem;+ background: linear-gradient(90deg, #6366f1, #a855f7);+ color: #fff;+ border-radius: 9999px;+ font-size: 0.72rem; font-weight: 600;+ margin-top: 0.25rem;+}++/* — Install block ————————————————————————————————————— */+.install { display: grid; gap: var(--space-sm); }++.install__head {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-muted);+}++.install__body {+ font-family: var(--font-mono);+ font-size: var(--text-sm);+ color: var(--color-ink);+ padding: var(--space-md) 0;+ border-top: var(--rule-hair) solid var(--color-rule);+ border-bottom: var(--rule-hair) solid var(--color-rule);+ line-height: 1.7;+ white-space: pre-wrap;+ position: relative;+ display: flex;+ align-items: center;+ justify-content: space-between;+ gap: var(--space-md);+}++.install__body .code__copy--block {+ position: static;+ transform: none;+ flex-shrink: 0;+}++/* — Reveals ————————————————————————————————————————— */+.reveal {+ opacity: 0;+ transform: translateY(10px);+}++.reveal.is-in {+ animation: reveal var(--dur-long) var(--ease-out) forwards;+ animation-delay: calc(var(--i, 0) * 60ms);+}++@keyframes reveal { to { opacity: 1; transform: none; } }++/* Theme-specific reveal patterns */+[data-theme="brutal"] .reveal,+[data-theme="manifesto"] .reveal,+[data-theme="sport"] .reveal {+ transform: translateX(-16px);+}++@keyframes reveal-sweep { to { opacity: 1; transform: none; } }++[data-theme="brutal"] .reveal.is-in,+[data-theme="manifesto"] .reveal.is-in,+[data-theme="sport"] .reveal.is-in {+ animation: reveal-sweep var(--dur-long) var(--ease-out) forwards;+ animation-delay: calc(var(--i, 0) * 60ms);+}++[data-theme="atelier"] .reveal,+[data-theme="salon"] .reveal,+[data-theme="newsprint"] .reveal {+ transform: none; /* no spatial reveal — fade only */+}++[data-theme="atelier"] .reveal.is-in,+[data-theme="salon"] .reveal.is-in,+[data-theme="newsprint"] .reveal.is-in {+ animation: reveal-fade calc(var(--dur-long) * 1.4) var(--ease-out) forwards;+ animation-delay: calc(var(--i, 0) * 80ms);+}++@keyframes reveal-fade { to { opacity: 1; } }++[data-theme="terminal"] .reveal,+[data-theme="terminal"] .reveal.is-in {+ transform: none;+ opacity: 1;+ animation: none;+}++@media (prefers-reduced-motion: reduce) {+ .reveal { transform: none; animation-duration: 150ms !important; }+ @keyframes reveal { to { opacity: 1; } }+ *, *::before, *::after {+ animation-duration: 150ms !important;+ transition-duration: 150ms !important;+ }+}++/* — View transitions ————————————————————————————————— */+::view-transition-old(root),+::view-transition-new(root) {+ animation-duration: 280ms;+ animation-timing-function: var(--ease-out);+}diff --git a/site/css/sections.css b/site/css/sections.cssnew file mode 100644index 0000000..dc5bc25--- /dev/null+++ b/site/css/sections.css@@ -0,0 +1,766 @@+/* Hallmark — sections (with per-theme structural overrides) */++/* — Page scaffold ——————————————————————————————————— */+.page {+ max-width: var(--page-max);+ margin-inline: auto;+ display: grid;+ gap: var(--section-gap);+ padding-block: var(--space-lg) var(--space-4xl);+}++/* — Nav ————————————————————————————————————————————— */+.nav {+ display: grid;+ grid-template-columns: auto 1fr auto;+ align-items: center;+ gap: var(--space-lg);+ padding-block: var(--space-md);+}++.nav__themer { justify-self: center; }++.nav__meta {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ color: var(--color-muted);+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ justify-self: end;+}++.nav__meta a { color: var(--color-ink); }++@media (max-width: 56rem) {+ .nav {+ grid-template-columns: auto auto;+ grid-template-rows: auto auto;+ row-gap: var(--space-md);+ }+ .nav__themer { grid-column: 1 / -1; justify-self: stretch; }+}++/* — Section container ——————————————————————————————— */+.section {+ display: grid;+ gap: var(--space-2xl);+}++.section__head {+ display: grid;+ grid-template-columns: 10rem 1fr;+ gap: var(--space-xl);+ align-items: baseline;+ padding-bottom: var(--section-head-gap);+ border-bottom: var(--rule-hair) solid var(--color-rule-2);+}++.section__title {+ font-family: var(--font-display);+ font-weight: var(--display-weight, 400);+ font-style: var(--display-style, normal);+ font-size: var(--text-2xl);+ line-height: var(--lh-snug);+ letter-spacing: var(--tracking-display);+ max-width: 24ch;+ color: var(--color-ink);+ font-optical-sizing: auto;+}++@media (max-width: 48rem) {+ .section__head {+ grid-template-columns: 1fr;+ gap: var(--space-md);+ }+}++/* — 01 · Opening ——————————————————————————————————— */+.opening {+ display: grid;+ grid-template-columns: 8fr 4fr;+ gap: var(--space-2xl);+ padding-block: var(--space-xl) var(--space-lg);+ align-items: end;+}++@media (max-width: 60rem) {+ .opening { grid-template-columns: 1fr; gap: var(--space-xl); align-items: start; }+}++.opening__eyebrow {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-muted);+ margin-bottom: var(--space-lg);+ display: inline-flex;+ align-items: center;+ gap: 0.55em;+}++.opening__title {+ font-family: var(--font-display);+ font-weight: var(--display-weight, 400);+ font-style: var(--display-style, normal);+ font-size: var(--text-display);+ line-height: var(--lh-tight);+ letter-spacing: var(--tracking-display);+ color: var(--color-ink);+ max-width: 15ch;+ font-optical-sizing: auto;+ font-variation-settings:+ "opsz" var(--display-optical, 144),+ "SOFT" var(--display-soft, 0);+}++.opening__title em {+ font-family: var(--font-serif);+ font-style: italic;+ font-weight: 400;+ color: var(--color-ink);+}++.opening__sub {+ font-family: var(--font-body);+ font-weight: 400;+ font-size: var(--text-md);+ line-height: var(--lh-normal);+ color: var(--color-ink-2);+ max-width: 42ch;+ margin-top: var(--space-lg);+}++.opening__aside {+ display: grid;+ gap: var(--space-md);+ padding-top: var(--space-xl);+}++.opening__rule {+ height: 0.5rem;+ width: 3rem;+ background: var(--color-accent);+}++.opening__cta {+ display: grid;+ gap: var(--space-sm);+ padding-top: var(--space-md);+ border-top: var(--rule-hair) solid var(--color-rule);+}++/* — 02 · Problem (vs) ——————————————————————————————— */+.vs {+ display: grid;+ grid-template-columns: 1fr 1fr;+ gap: 0;+ border: var(--rule-hair) solid var(--color-rule-2);+}++@media (max-width: 50rem) {+ .vs { grid-template-columns: 1fr; }+ .vs__col:first-child { border-right: 0; border-bottom: var(--rule-hair) solid var(--color-rule-2); }+}++.vs__col {+ padding: var(--space-xl);+ display: grid;+ gap: var(--space-md);+}++.vs__col:first-child {+ border-right: var(--rule-hair) solid var(--color-rule-2);+ background: var(--color-paper-2);+}++.vs__head { padding-bottom: var(--space-sm); border-bottom: var(--rule-hair) solid var(--color-rule); }++.vs__label {+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-muted);+}++.vs__caption {+ font-family: var(--font-body);+ font-size: var(--text-sm);+ color: var(--color-neutral);+ max-width: 44ch;+ line-height: var(--lh-normal);+}++.vs__demo {+ min-height: 12rem;+ position: relative;+ overflow: hidden;+}++.vs__demo--good {+ display: grid;+ place-content: start;+ gap: 0.75rem;+ padding: 1.25rem;+ background: var(--color-paper);+}++.vs__demo--good .label { color: var(--color-muted); }++.vs__demo--good .title {+ font-family: var(--font-display);+ font-weight: var(--display-weight, 400);+ font-style: var(--display-style, normal);+ font-size: 2rem;+ line-height: 1.05;+ letter-spacing: -0.03em;+ color: var(--color-ink);+ max-width: 10ch;+ font-optical-sizing: auto;+}++.vs__demo--good .title em {+ font-family: var(--font-serif);+ font-style: italic;+ font-weight: 400;+}++/* — 03 · Foundations grid ——————————————————————————— */+.foundations {+ display: grid;+ grid-template-columns: 1fr 1fr;+ gap: var(--space-2xl) var(--space-2xl);+}++@media (max-width: 56rem) {+ .foundations { grid-template-columns: 1fr; gap: 0; }+}++/* — 04 · Gallery rail ——————————————————————————————— */+.rail {+ display: flex;+ gap: var(--space-md);+ overflow-x: auto;+ overflow-y: hidden;+ scroll-snap-type: x mandatory;+ padding-bottom: var(--space-sm);+ scrollbar-color: var(--color-rule-2) transparent;+}++.rail::-webkit-scrollbar { height: 6px; }+.rail::-webkit-scrollbar-track { background: transparent; }+.rail::-webkit-scrollbar-thumb { background: var(--color-rule-2); border-radius: 0; }++/* — 05 · How it works ——————————————————————————————— */+.how { display: grid; gap: var(--space-xl); }++.step {+ display: grid;+ grid-template-columns: 3rem 1fr 2fr;+ gap: var(--space-lg);+ align-items: start;+ padding-top: var(--space-lg);+ border-top: var(--rule-hair) solid var(--color-rule);+}++@media (max-width: 50rem) {+ .step { grid-template-columns: 1fr; gap: var(--space-sm); }+}++.step__num {+ font-family: var(--font-label);+ font-weight: 500;+ font-size: var(--text-md);+ color: var(--color-ink);+ letter-spacing: 0.08em;+}++.step__head {+ font-family: var(--font-display);+ font-weight: var(--display-weight, 400);+ font-style: var(--display-style, normal);+ font-size: var(--text-lg);+ line-height: var(--lh-snug);+ letter-spacing: var(--tracking-tight);+ color: var(--color-ink);+ font-optical-sizing: auto;+}++.step__sub {+ font-family: var(--font-body);+ font-size: var(--text-sm);+ color: var(--color-neutral);+ margin-top: var(--space-xs);+ max-width: 40ch;+ line-height: var(--lh-normal);+}++.step__body { display: grid; gap: var(--space-sm); }++/* — 06 · Install blocks ————————————————————————————— */+.installs {+ display: grid;+ grid-template-columns: repeat(2, 1fr);+ gap: var(--space-xl);+}++@media (max-width: 40rem) { .installs { grid-template-columns: 1fr; } }++/* — 07 · Footer ————————————————————————————————————— */+.foot {+ display: grid;+ grid-template-columns: 1fr auto;+ gap: var(--space-lg);+ padding-top: var(--space-xl);+ border-top: var(--rule-fine) solid var(--color-ink);+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: 0.04em;+ color: var(--color-muted);+ align-items: end;+}++.foot__credits { max-width: 64ch; line-height: 1.7; }+.foot__credits a { color: var(--color-ink); }++.foot__powered { text-align: right; }++.foot__powered-mark {+ display: inline-flex;+ align-items: center;+ gap: 0.4em;+ color: var(--color-ink);+ font-weight: 500;+ letter-spacing: 0.12em;+ text-transform: uppercase;+ font-size: var(--text-xs);+}++.foot__powered-mark::before {+ content: "";+ width: 0.55em;+ height: 0.55em;+ background: var(--color-accent);+}++/* — Dimension callout ——————————————————————————————— */+.dim {+ display: inline-flex;+ align-items: center;+ gap: 0.5em;+ font-family: var(--font-label);+ font-size: var(--text-xs);+ letter-spacing: var(--tracking-label);+ text-transform: uppercase;+ color: var(--color-muted);+}++/* ════════════════════════════════════════════════════════════ */+/* STRUCTURAL FINGERPRINTS — per-theme overrides */+/* Each theme picks distinct values across six axes: */+/* heading placement · body composition · divider · button */+/* · image · reveal */+/* ════════════════════════════════════════════════════════════ */++/* ── ATELIER — centered display, generous, narrow column ────── */+[data-theme="atelier"] .opening {+ grid-template-columns: 1fr;+ text-align: center;+ align-items: center;+ padding-block: var(--space-3xl) var(--space-xl);+}+[data-theme="atelier"] .opening__title {+ margin-inline: auto;+ max-width: 16ch;+}+[data-theme="atelier"] .opening__sub {+ margin-inline: auto;+ margin-top: var(--space-xl);+}+[data-theme="atelier"] .opening__eyebrow {+ justify-content: center;+}+[data-theme="atelier"] .opening__aside {+ display: none;+}+[data-theme="atelier"] .section__head {+ grid-template-columns: 1fr;+ text-align: center;+ border-bottom: 0;+ padding-bottom: var(--space-2xl);+}+[data-theme="atelier"] .section-label {+ justify-content: center;+}+[data-theme="atelier"] .section__title {+ max-width: 22ch;+ margin-inline: auto;+}+[data-theme="atelier"] .foundations {+ grid-template-columns: 1fr;+ max-width: 38rem;+ margin-inline: auto;+}+[data-theme="atelier"] .spec {+ text-align: center;+ border-top: 0;+ border-bottom: var(--rule-hair) solid var(--color-rule);+ padding: var(--space-2xl) 0;+}+[data-theme="atelier"] .spec__head {+ justify-content: center;+ gap: var(--space-md);+}+[data-theme="atelier"] .spec__rule {+ margin-inline: auto;+}+[data-theme="atelier"] .step {+ grid-template-columns: 1fr;+ text-align: center;+}+[data-theme="atelier"] .vs { grid-template-columns: 1fr; border: 0; }+[data-theme="atelier"] .vs__col:first-child {+ border-right: 0;+ border-bottom: var(--rule-hair) solid var(--color-rule-2);+}++/* ── NEWSPRINT — bottom-aligned head, multi-column body, double rule ── */+[data-theme="newsprint"] .opening {+ grid-template-columns: 1fr;+ border-top: 4px double var(--color-ink);+ border-bottom: 1px solid var(--color-ink);+ padding-block: var(--space-md);+ align-items: start;+}+[data-theme="newsprint"] .opening__aside {+ border-top: var(--rule-hair) solid var(--color-rule);+ margin-top: var(--space-md);+ padding-top: var(--space-md);+}+[data-theme="newsprint"] .opening__title {+ max-width: none;+ font-weight: 700;+ margin-block: var(--space-md);+}+[data-theme="newsprint"] .opening__sub {+ column-count: 2;+ column-gap: 2.5rem;+ column-rule: 0.5px solid var(--color-rule-2);+ hyphens: auto;+ text-align: justify;+ max-width: none;+ margin-top: var(--space-md);+}+@media (max-width: 50rem) {+ [data-theme="newsprint"] .opening__sub { column-count: 1; }+}+[data-theme="newsprint"] .section__head {+ grid-template-columns: 1fr;+ border-top: 3px double var(--color-ink);+ border-bottom: 1px solid var(--color-ink);+ padding-block: 0.5rem;+ align-items: baseline;+}+[data-theme="newsprint"] .foundations {+ grid-template-columns: repeat(3, 1fr);+ column-gap: var(--space-xl);+ row-gap: 0;+}+@media (max-width: 70rem) {+ [data-theme="newsprint"] .foundations { grid-template-columns: repeat(2, 1fr); }+}+@media (max-width: 50rem) {+ [data-theme="newsprint"] .foundations { grid-template-columns: 1fr; }+}+[data-theme="newsprint"] .spec {+ border-top: 1px solid var(--color-ink);+ padding: var(--space-lg) 0;+}++/* ── TERMINAL — inline `>` headings, mono everywhere ────────── */+[data-theme="terminal"] .opening {+ grid-template-columns: 1fr;+ padding-block: var(--space-xl) var(--space-md);+}+[data-theme="terminal"] .opening__aside {+ display: grid;+ grid-template-columns: 1fr;+ padding-top: var(--space-md);+ border-top: var(--rule-hair) dashed var(--color-rule-2);+}+[data-theme="terminal"] .opening__title {+ text-transform: uppercase;+ font-weight: 500;+ letter-spacing: 0.02em;+ max-width: none;+}+[data-theme="terminal"] .opening__title::before {+ content: "$ ";+ color: var(--color-accent);+}+[data-theme="terminal"] .opening__title em {+ font-family: var(--font-display);+ font-style: normal;+ text-decoration: underline;+ text-decoration-color: var(--color-accent);+ text-underline-offset: 0.15em;+}+[data-theme="terminal"] .section__head {+ grid-template-columns: 1fr;+ border-bottom: var(--rule-hair) dashed var(--color-rule-2);+}+[data-theme="terminal"] .section__title {+ text-transform: uppercase;+ letter-spacing: 0.04em;+ font-weight: 500;+}+[data-theme="terminal"] .section__title::before {+ content: "// ";+ color: var(--color-accent);+}+[data-theme="terminal"] .opening__rule {+ height: 1rem;+ width: 0.6rem;+ background: var(--color-accent);+ animation: blink 1.05s steps(2) infinite;+}+@keyframes blink { 50% { opacity: 0; } }+[data-theme="terminal"] .vs__col:first-child { background: var(--color-paper-3); }+[data-theme="terminal"] .step__num::before { content: "[ "; color: var(--color-accent); }+[data-theme="terminal"] .step__num::after { content: " ]"; color: var(--color-accent); }++/* ── MANIFESTO — full-bleed, ALL CAPS, colour blocks ────────── */+[data-theme="manifesto"] .opening {+ grid-template-columns: 1fr;+ padding-block: var(--space-2xl) var(--space-xl);+}+[data-theme="manifesto"] .opening__aside { display: none; }+[data-theme="manifesto"] .opening__title {+ text-transform: uppercase;+ font-weight: 800;+ max-width: 11ch;+ font-style: normal;+}+[data-theme="manifesto"] .opening__title em {+ font-family: var(--font-display);+ font-style: normal;+ font-weight: 800;+ background: var(--color-accent);+ color: var(--color-paper);+ padding: 0 0.12em;+ box-decoration-break: clone;+ -webkit-box-decoration-break: clone;+}+[data-theme="manifesto"] .opening__sub {+ text-transform: uppercase;+ font-weight: 500;+ letter-spacing: 0.02em;+ max-width: 56ch;+}+[data-theme="manifesto"] .section__head {+ grid-template-columns: 1fr;+ border-bottom: 3px solid var(--color-ink);+ padding-bottom: var(--space-sm);+}+[data-theme="manifesto"] .section__title {+ text-transform: uppercase;+ max-width: 18ch;+ font-weight: 800;+}+[data-theme="manifesto"] .vs { border: 3px solid var(--color-ink); }+[data-theme="manifesto"] .vs__col:first-child {+ background: var(--color-ink);+ color: var(--color-paper);+}+[data-theme="manifesto"] .vs__col:first-child .vs__label,+[data-theme="manifesto"] .vs__col:first-child .vs__caption {+ color: var(--color-paper);+}+[data-theme="manifesto"] .step { border-top: 3px solid var(--color-ink); }++/* ── SALON — centered narrow, fleuron divider ───────────────── */+[data-theme="salon"] .opening {+ grid-template-columns: 1fr;+ text-align: center;+ align-items: center;+ padding-block: var(--space-3xl) var(--space-xl);+}+[data-theme="salon"] .opening__title {+ font-style: italic;+ font-weight: 400;+ margin-inline: auto;+ max-width: 14ch;+}+[data-theme="salon"] .opening__title em {+ font-style: normal;+ font-family: var(--font-display);+}+[data-theme="salon"] .opening__sub {+ margin-inline: auto;+ margin-top: var(--space-xl);+ font-family: var(--font-serif);+ font-style: italic;+}+[data-theme="salon"] .opening__eyebrow { justify-content: center; }+[data-theme="salon"] .opening__aside { display: none; }+[data-theme="salon"] .section__head {+ grid-template-columns: 1fr;+ text-align: center;+ border-bottom: 0;+ padding-bottom: var(--space-md);+}+[data-theme="salon"] .section__head::after {+ content: "❦";+ display: block;+ text-align: center;+ color: var(--color-accent);+ font-size: 1.2rem;+ margin-top: var(--space-md);+ font-family: var(--font-serif);+}+[data-theme="salon"] .section-label { justify-content: center; }+[data-theme="salon"] .section__title { margin-inline: auto; }+[data-theme="salon"] .foundations {+ grid-template-columns: 1fr;+ max-width: 36rem;+ margin-inline: auto;+}+[data-theme="salon"] .spec { text-align: left; }++/* ── LINEN — hanging headings, two-column asymmetric ────────── */+[data-theme="linen"] .opening { grid-template-columns: 7fr 5fr; gap: var(--space-3xl); }+[data-theme="linen"] .section__head {+ grid-template-columns: 1fr;+ border-bottom: 0;+ padding-bottom: 0;+}+[data-theme="linen"] .section__title { margin-bottom: var(--space-2xl); }+[data-theme="linen"] .section-label { margin-bottom: var(--space-md); }+[data-theme="linen"] .foundations {+ grid-template-columns: 5fr 7fr;+ gap: var(--space-xl) var(--space-2xl);+}+@media (max-width: 56rem) { [data-theme="linen"] .foundations { grid-template-columns: 1fr; } }+[data-theme="linen"] .spec { border-top: 0; border-bottom: var(--rule-hair) solid var(--color-rule); }++/* ── ALMANAC — sticky labels, 3-col equal, dense ────────────── */+[data-theme="almanac"] .section__head {+ position: sticky;+ top: 0;+ z-index: var(--z-sticky);+ background: var(--color-paper);+ padding-block: var(--space-sm);+ border-bottom: 1px solid var(--color-ink);+ grid-template-columns: 8rem 1fr;+}+[data-theme="almanac"] .section__title { font-size: var(--text-xl); }+[data-theme="almanac"] .foundations {+ grid-template-columns: repeat(3, 1fr);+ gap: 0;+ border-left: var(--rule-hair) solid var(--color-rule);+}+@media (max-width: 70rem) {+ [data-theme="almanac"] .foundations { grid-template-columns: repeat(2, 1fr); }+}+@media (max-width: 50rem) {+ [data-theme="almanac"] .foundations { grid-template-columns: 1fr; border-left: 0; }+}+[data-theme="almanac"] .spec {+ border-top: 0;+ border-right: var(--rule-hair) solid var(--color-rule);+ padding: var(--space-md) var(--space-md);+}+[data-theme="almanac"] .opening { grid-template-columns: 6fr 6fr; }+[data-theme="almanac"] .opening__title { max-width: 18ch; }++/* ── SPORT — italic display, asymmetric spans, bleed-colour ── */+[data-theme="sport"] .opening {+ grid-template-columns: 9fr 3fr;+ align-items: end;+ padding-block: var(--space-2xl) var(--space-xl);+}+[data-theme="sport"] .opening__title {+ font-style: italic;+ font-weight: 700;+ text-transform: uppercase;+ max-width: 14ch;+}+[data-theme="sport"] .opening__title em {+ font-family: var(--font-display);+ font-style: italic;+ color: var(--color-accent);+ font-weight: 700;+}+[data-theme="sport"] .opening__sub { font-weight: 500; }+[data-theme="sport"] .section__head {+ grid-template-columns: 6rem 1fr;+ border-bottom: 2px solid var(--color-rule-2);+ padding-bottom: var(--space-md);+ align-items: end;+}+[data-theme="sport"] .section__title {+ font-style: italic;+ font-weight: 700;+ text-transform: uppercase;+ letter-spacing: -0.02em;+}+[data-theme="sport"] .foundations {+ grid-template-columns: 7fr 5fr;+ gap: var(--space-xl) var(--space-2xl);+}+@media (max-width: 56rem) { [data-theme="sport"] .foundations { grid-template-columns: 1fr; } }+[data-theme="sport"] .spec { border-top: var(--rule-hair) solid var(--color-rule-2); }+[data-theme="sport"] .vs__col:first-child {+ background: var(--color-accent);+ color: var(--color-paper);+}+[data-theme="sport"] .vs__col:first-child .vs__label,+[data-theme="sport"] .vs__col:first-child .vs__caption {+ color: var(--color-paper);+}+[data-theme="sport"] .step__num {+ font-style: italic;+ color: var(--color-accent);+ font-weight: 700;+}++/* ── BRUTAL existing — augment with structural overrides ───── */+[data-theme="brutal"] .opening__title em {+ font-style: normal;+ text-decoration: underline;+ text-decoration-thickness: 4px;+ text-underline-offset: 0.12em;+ text-decoration-color: var(--color-accent);+}+[data-theme="brutal"] .section__head {+ border-bottom: 3px solid var(--color-ink);+}+[data-theme="brutal"] .vs__col:first-child {+ background: var(--color-accent);+ color: var(--color-paper);+}+[data-theme="brutal"] .vs__col:first-child .vs__label,+[data-theme="brutal"] .vs__col:first-child .vs__caption {+ color: var(--color-paper);+}++/* ── GARDEN existing — augment ──────────────────────────────── */+[data-theme="garden"] .section__head {+ grid-template-columns: 1fr;+ border-bottom: 0;+ padding-bottom: var(--space-lg);+}+[data-theme="garden"] .section__title { margin-top: var(--space-md); }+[data-theme="garden"] .foundations { grid-template-columns: 5fr 7fr; }+@media (max-width: 56rem) { [data-theme="garden"] .foundations { grid-template-columns: 1fr; } }++/* ── MIDNIGHT existing — numbered display style ─────────────── */+[data-theme="midnight"] .section-label .num {+ color: var(--color-accent);+}+[data-theme="midnight"] .opening__title em {+ font-family: var(--font-serif);+ font-style: italic;+ color: var(--color-accent-ink);+}diff --git a/site/css/tokens.css b/site/css/tokens.cssnew file mode 100644index 0000000..df6843a--- /dev/null+++ b/site/css/tokens.css@@ -0,0 +1,619 @@+/*+ Hallmark — tokens+ Twelve themes. Each one a complete palette + type + spacing + structural fingerprint.+ Switched via [data-theme="..."] on <html>.++ Theme index:+ 01 specimen — workshop / typographic specimen, warm oat+ 02 midnight — dark technical+ 03 brutal — high-contrast statement+ 04 garden — soft botanical, italic serif+ 05 atelier — luxury fashion-house, cream + gold+ 06 newsprint — broadsheet newspaper+ 07 terminal — phosphor CRT monospace+ 08 manifesto — political poster+ 09 salon — boutique apothecary, restrained ornament+ 10 linen — quietly modern, natural fibres+ 11 almanac — encyclopaedic data density+ 12 sport — italic energy, condensed numerals+*/++/* ——————————————————————————————————————————————————————————— */+/* 01 · SPECIMEN — default */+/* ——————————————————————————————————————————————————————————— */++:root,+[data-theme="specimen"] {+ --color-paper: oklch(96% 0.012 80);+ --color-paper-2: oklch(93% 0.014 80);+ --color-paper-3: oklch(89% 0.016 75);+ --color-rule: oklch(82% 0.010 75);+ --color-rule-2: oklch(72% 0.008 70);+ --color-muted: oklch(52% 0.008 65);+ --color-neutral: oklch(38% 0.008 60);+ --color-ink-2: oklch(26% 0.010 60);+ --color-ink: oklch(18% 0.010 60);+ --color-accent: #FC4C02;+ --color-accent-ink: oklch(55% 0.21 32);+ --color-focus: #FC4C02;++ --font-display: "Fraunces", "Tiempos", "Newsreader", ui-serif, Georgia, serif;+ --font-body: "The Future", "Söhne", ui-sans-serif, sans-serif;+ --font-serif: "Fraunces", ui-serif, Georgia, serif;+ --font-label: "The Future Mono", "Berkeley Mono", ui-monospace, monospace;+ --font-mono: "The Future Mono", "Berkeley Mono", ui-monospace, monospace;++ --display-weight: 340;+ --display-optical: 144;+ --display-style: normal;+ --display-soft: 20;++ --text-xs: 0.75rem;+ --text-sm: 0.875rem;+ --text-base: 1rem;+ --text-md: 1.125rem;+ --text-lg: 1.375rem;+ --text-xl: 1.75rem;+ --text-2xl: 2.25rem;+ --text-3xl: 2.75rem;+ --text-display: clamp(3rem, 5.5vw + 1rem, 5.75rem);+ --text-display-s: clamp(2rem, 3vw + 1rem, 3rem);++ --lh-tight: 1.02;+ --lh-snug: 1.18;+ --lh-normal: 1.45;+ --lh-relaxed: 1.6;++ --tracking-display: -0.025em;+ --tracking-tight: -0.01em;+ --tracking-normal: 0;+ --tracking-label: 0.12em;++ --space-3xs: 0.125rem;+ --space-2xs: 0.25rem;+ --space-xs: 0.5rem;+ --space-sm: 0.75rem;+ --space-md: 1rem;+ --space-lg: 1.5rem;+ --space-xl: 2.5rem;+ --space-2xl: 4rem;+ --space-3xl: 6.5rem;+ --space-4xl: 10rem;+ --space-5xl: 13rem;++ --section-gap: 8rem;+ --section-head-gap: 2rem;++ --page-max: 76rem;+ --page-gutter: clamp(1.25rem, 4vw, 3rem);+ --measure: 62ch;+ --rule-hair: 0.5px;+ --rule-fine: 1px;++ --ease-out: cubic-bezier(0.16, 1, 0.3, 1);+ --ease-in: cubic-bezier(0.7, 0, 0.84, 0);+ --ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);+ --dur-micro: 120ms;+ --dur-short: 220ms;+ --dur-long: 420ms;++ --z-base: 1;+ --z-raised: 10;+ --z-dropdown: 100;+ --z-sticky: 200;+ --z-modal: 400;+ --z-toast: 500;+ --z-tooltip: 600;+}++/* ——————————————————————————————————————————————————————————— */+/* 02 · MIDNIGHT */+/* ——————————————————————————————————————————————————————————— */++[data-theme="midnight"] {+ --color-paper: oklch(14% 0.010 40);+ --color-paper-2: oklch(18% 0.012 40);+ --color-paper-3: oklch(22% 0.014 40);+ --color-rule: oklch(30% 0.010 40);+ --color-rule-2: oklch(40% 0.010 40);+ --color-muted: oklch(56% 0.010 45);+ --color-neutral: oklch(70% 0.008 60);+ --color-ink-2: oklch(82% 0.008 70);+ --color-ink: oklch(94% 0.006 80);+ --color-accent: #FC4C02;+ --color-accent-ink: oklch(72% 0.18 50);+ --color-focus: oklch(72% 0.18 50);++ --font-display: "The Future", "Futura", "Avenir Next", ui-sans-serif, sans-serif;+ --font-body: "The Future", "Söhne", ui-sans-serif, sans-serif;+ --font-serif: "Instrument Serif", "Tiempos", ui-serif, Georgia, serif;+ --font-label: "The Future Mono", "Berkeley Mono", ui-monospace, monospace;+ --font-mono: "The Future Mono", "Berkeley Mono", ui-monospace, monospace;++ --display-weight: 300;+ --display-optical: 144;+ --display-soft: 0;++ --text-display: clamp(2.75rem, 5vw + 1rem, 5.25rem);+ --text-display-s: clamp(1.75rem, 2.5vw + 1rem, 2.75rem);++ --tracking-display: -0.03em;+ --tracking-label: 0.16em;++ --section-gap: 7rem;+ --section-head-gap: 1.75rem;+ --measure: 60ch;+}++/* ——————————————————————————————————————————————————————————— */+/* 03 · BRUTAL */+/* ——————————————————————————————————————————————————————————— */++[data-theme="brutal"] {+ --color-paper: oklch(98% 0.003 90);+ --color-paper-2: oklch(95% 0.004 85);+ --color-paper-3: oklch(91% 0.004 80);+ --color-rule: oklch(15% 0.005 60);+ --color-rule-2: oklch(12% 0.005 60);+ --color-muted: oklch(40% 0.008 60);+ --color-neutral: oklch(28% 0.008 60);+ --color-ink-2: oklch(15% 0.008 60);+ --color-ink: oklch(10% 0.005 60);+ --color-accent: #FF2E2E;+ --color-accent-ink: oklch(58% 0.24 25);+ --color-focus: #FF2E2E;++ --font-display: "Space Grotesk", "GT America", "Söhne", ui-sans-serif, sans-serif;+ --font-body: "Space Grotesk", "The Future", ui-sans-serif, sans-serif;+ --font-serif: "Space Grotesk", ui-sans-serif, sans-serif;+ --font-label: "JetBrains Mono", "The Future Mono", ui-monospace, monospace;+ --font-mono: "JetBrains Mono", "The Future Mono", ui-monospace, monospace;++ --display-weight: 700;+ --display-soft: 0;++ --text-display: clamp(3.5rem, 8vw + 1rem, 8rem);+ --text-display-s: clamp(2.25rem, 4vw + 1rem, 3.75rem);+ --text-2xl: 2.75rem;+ --text-xl: 2rem;+ --text-lg: 1.5rem;++ --tracking-display: -0.045em;+ --tracking-tight: -0.02em;+ --tracking-label: 0.04em;++ --lh-tight: 0.94;+ --lh-snug: 1.08;++ --section-gap: 6rem;+ --section-head-gap: 1.5rem;++ --rule-hair: 1px;+ --rule-fine: 2px;+ --measure: 58ch;+}++/* ——————————————————————————————————————————————————————————— */+/* 04 · GARDEN */+/* ——————————————————————————————————————————————————————————— */++[data-theme="garden"] {+ --color-paper: oklch(96% 0.020 115);+ --color-paper-2: oklch(93% 0.024 115);+ --color-paper-3: oklch(89% 0.028 120);+ --color-rule: oklch(80% 0.020 120);+ --color-rule-2: oklch(68% 0.028 130);+ --color-muted: oklch(52% 0.040 150);+ --color-neutral: oklch(38% 0.050 155);+ --color-ink-2: oklch(30% 0.050 158);+ --color-ink: oklch(24% 0.050 160);+ --color-accent: #B6485E;+ --color-accent-ink: oklch(55% 0.14 18);+ --color-focus: #B6485E;++ --font-display: "Instrument Serif", "Fraunces", "Newsreader", ui-serif, Georgia, serif;+ --font-body: "The Future", "Söhne", ui-sans-serif, sans-serif;+ --font-serif: "Instrument Serif", "Fraunces", ui-serif, Georgia, serif;+ --font-label: "The Future Mono", "Berkeley Mono", ui-monospace, monospace;+ --font-mono: "The Future Mono", "Berkeley Mono", ui-monospace, monospace;++ --display-weight: 400;+ --display-style: italic;+ --display-soft: 0;++ --text-display: clamp(3.25rem, 6vw + 1rem, 6.5rem);+ --text-display-s: clamp(2.25rem, 3.5vw + 1rem, 3.5rem);++ --tracking-display: -0.015em;+ --tracking-tight: -0.005em;+ --tracking-label: 0.10em;++ --lh-tight: 1.05;+ --lh-snug: 1.22;++ --section-gap: 9rem;+ --section-head-gap: 2.5rem;+ --measure: 58ch;+}++/* ——————————————————————————————————————————————————————————— */+/* 05 · ATELIER — luxury fashion-house, cream + charcoal + gold */+/* ——————————————————————————————————————————————————————————— */++[data-theme="atelier"] {+ --color-paper: oklch(96% 0.012 70);+ --color-paper-2: oklch(94% 0.014 65);+ --color-paper-3: oklch(91% 0.016 65);+ --color-rule: oklch(78% 0.010 60);+ --color-rule-2: oklch(60% 0.012 55);+ --color-muted: oklch(48% 0.012 50);+ --color-neutral: oklch(28% 0.014 45);+ --color-ink-2: oklch(18% 0.014 45);+ --color-ink: oklch(12% 0.012 40);+ --color-accent: oklch(58% 0.115 65);+ --color-accent-ink: oklch(45% 0.13 60);+ --color-focus: oklch(58% 0.115 65);++ --font-display: "Cormorant Garamond", "Playfair Display", "Tiempos Headline", ui-serif, Georgia, serif;+ --font-body: "Hanken Grotesk", "The Future", ui-sans-serif, sans-serif;+ --font-serif: "Cormorant Garamond", "Playfair Display", ui-serif, Georgia, serif;+ --font-label: "IBM Plex Mono", "The Future Mono", ui-monospace, monospace;+ --font-mono: "IBM Plex Mono", ui-monospace, monospace;++ --display-weight: 300;+ --display-optical: 144;+ --display-style: italic;+ --display-soft: 0;++ --text-display: clamp(3.75rem, 7vw + 1rem, 7.5rem);+ --text-display-s: clamp(2.5rem, 4vw + 1rem, 4rem);++ --tracking-display: -0.012em;+ --tracking-tight: -0.006em;+ --tracking-label: 0.22em;++ --lh-tight: 1.0;+ --lh-snug: 1.16;+ --lh-normal: 1.5;+ --lh-relaxed: 1.65;++ --section-gap: 11rem;+ --section-head-gap: 3rem;+ --measure: 56ch;+ --page-max: 68rem;+}++/* ——————————————————————————————————————————————————————————— */+/* 06 · NEWSPRINT — broadsheet */+/* ——————————————————————————————————————————————————————————— */++[data-theme="newsprint"] {+ --color-paper: oklch(95% 0.020 60);+ --color-paper-2: oklch(92% 0.026 55);+ --color-paper-3: oklch(88% 0.028 50);+ --color-rule: oklch(70% 0.018 50);+ --color-rule-2: oklch(40% 0.012 50);+ --color-muted: oklch(48% 0.012 50);+ --color-neutral: oklch(32% 0.014 45);+ --color-ink-2: oklch(22% 0.014 250);+ --color-ink: oklch(18% 0.012 250);+ --color-accent: oklch(48% 0.13 30);+ --color-accent-ink: oklch(45% 0.13 30);+ --color-focus: oklch(48% 0.13 30);++ --font-display: "Crimson Pro", "Crimson Text", "Noto Serif", ui-serif, Georgia, serif;+ --font-body: "Crimson Pro", "Newsreader", ui-serif, Georgia, serif;+ --font-serif: "Crimson Pro", "Crimson Text", ui-serif, Georgia, serif;+ --font-label: "IBM Plex Sans", "The Future", ui-sans-serif, sans-serif;+ --font-mono: "IBM Plex Mono", ui-monospace, monospace;++ --display-weight: 600;+ --display-optical: 48;+ --display-style: normal;+ --display-soft: 0;++ --text-base: 1.0625rem;+ --text-md: 1.1875rem;+ --text-lg: 1.375rem;+ --text-xl: 1.625rem;+ --text-2xl: 2rem;+ --text-display: clamp(2.75rem, 5vw + 1rem, 5rem);+ --text-display-s: clamp(2rem, 3vw + 1rem, 2.875rem);++ --tracking-display: -0.018em;+ --tracking-tight: -0.006em;+ --tracking-label: 0.06em;++ --lh-normal: 1.55;+ --lh-relaxed: 1.65;++ --section-gap: 6.5rem;+ --section-head-gap: 1.25rem;+ --measure: 58ch;+}++/* ——————————————————————————————————————————————————————————— */+/* 07 · TERMINAL — phosphor CRT, monospace-led */+/* ——————————————————————————————————————————————————————————— */++[data-theme="terminal"] {+ --color-paper: oklch(11% 0.010 145);+ --color-paper-2: oklch(15% 0.014 145);+ --color-paper-3: oklch(19% 0.016 145);+ --color-rule: oklch(28% 0.024 140);+ --color-rule-2: oklch(40% 0.040 140);+ --color-muted: oklch(58% 0.080 140);+ --color-neutral: oklch(68% 0.110 140);+ --color-ink-2: oklch(78% 0.130 138);+ --color-ink: oklch(86% 0.150 138);+ --color-accent: oklch(78% 0.180 138);+ --color-accent-ink: oklch(78% 0.180 138);+ --color-focus: oklch(86% 0.180 138);++ --font-display: "JetBrains Mono", "IBM Plex Mono", "The Future Mono", ui-monospace, monospace;+ --font-body: "JetBrains Mono", "IBM Plex Mono", ui-monospace, monospace;+ --font-serif: "JetBrains Mono", ui-monospace, monospace;+ --font-label: "JetBrains Mono", ui-monospace, monospace;+ --font-mono: "JetBrains Mono", ui-monospace, monospace;++ --display-weight: 500;+ --display-style: normal;++ --text-display: clamp(2.25rem, 4vw + 1rem, 4rem);+ --text-display-s: clamp(1.625rem, 2.25vw + 1rem, 2.5rem);+ --text-xl: 1.5rem;+ --text-2xl: 1.875rem;++ --tracking-display: 0.01em;+ --tracking-tight: 0;+ --tracking-label: 0.18em;++ --lh-tight: 1.2;+ --lh-snug: 1.35;+ --lh-normal: 1.55;++ --section-gap: 5.5rem;+ --section-head-gap: 1.25rem;+ --measure: 70ch;+}++/* ——————————————————————————————————————————————————————————— */+/* 08 · MANIFESTO — political poster, ALL CAPS heavy */+/* ——————————————————————————————————————————————————————————— */++[data-theme="manifesto"] {+ --color-paper: oklch(98% 0.004 90);+ --color-paper-2: oklch(94% 0.005 85);+ --color-paper-3: oklch(90% 0.006 80);+ --color-rule: oklch(8% 0.005 60);+ --color-rule-2: oklch(8% 0.005 60);+ --color-muted: oklch(38% 0.006 60);+ --color-neutral: oklch(20% 0.006 60);+ --color-ink-2: oklch(12% 0.005 60);+ --color-ink: oklch(8% 0.005 60);+ --color-accent: #E51A1A;+ --color-accent-ink: oklch(56% 0.24 28);+ --color-focus: #E51A1A;++ --font-display: "Bricolage Grotesque", "Libre Franklin", "Space Grotesk", ui-sans-serif, sans-serif;+ --font-body: "IBM Plex Sans", "Public Sans", "The Future", ui-sans-serif, sans-serif;+ --font-serif: "Bricolage Grotesque", ui-sans-serif, sans-serif;+ --font-label: "JetBrains Mono", ui-monospace, monospace;+ --font-mono: "JetBrains Mono", ui-monospace, monospace;++ --display-weight: 800;+ --display-optical: 96;+ --display-style: normal;++ --text-display: clamp(4rem, 11vw + 1rem, 12rem);+ --text-display-s: clamp(2.75rem, 6vw + 1rem, 5.5rem);+ --text-2xl: 3rem;+ --text-xl: 2rem;++ --tracking-display: -0.05em;+ --tracking-tight: -0.025em;+ --tracking-label: 0.08em;++ --lh-tight: 0.86;+ --lh-snug: 1.0;++ --section-gap: 5rem;+ --section-head-gap: 1.25rem;++ --rule-hair: 1px;+ --rule-fine: 3px;+ --measure: 56ch;+}++/* ——————————————————————————————————————————————————————————— */+/* 09 · SALON — boutique, restrained ornament */+/* ——————————————————————————————————————————————————————————— */++[data-theme="salon"] {+ --color-paper: oklch(95% 0.014 65);+ --color-paper-2: oklch(92% 0.020 60);+ --color-paper-3: oklch(88% 0.024 50);+ --color-rule: oklch(78% 0.020 50);+ --color-rule-2: oklch(62% 0.028 45);+ --color-muted: oklch(48% 0.024 40);+ --color-neutral: oklch(34% 0.024 35);+ --color-ink-2: oklch(28% 0.024 35);+ --color-ink: oklch(22% 0.024 35);+ --color-accent: oklch(58% 0.105 130);+ --color-accent-ink: oklch(48% 0.10 130);+ --color-focus: oklch(58% 0.105 130);++ --font-display: "Cormorant Garamond", "Playfair Display", ui-serif, Georgia, serif;+ --font-body: "Plus Jakarta Sans", "Hanken Grotesk", "The Future", ui-sans-serif, sans-serif;+ --font-serif: "Cormorant Garamond", ui-serif, Georgia, serif;+ --font-label: "IBM Plex Mono", "The Future Mono", ui-monospace, monospace;+ --font-mono: "IBM Plex Mono", ui-monospace, monospace;++ --display-weight: 400;+ --display-style: italic;+ --display-optical: 48;++ --text-display: clamp(3rem, 5vw + 1rem, 5rem);+ --text-display-s: clamp(2rem, 3vw + 1rem, 3rem);++ --tracking-display: -0.005em;+ --tracking-tight: 0;+ --tracking-label: 0.18em;++ --lh-tight: 1.06;+ --lh-snug: 1.18;+ --lh-normal: 1.55;++ --section-gap: 9rem;+ --section-head-gap: 2rem;+ --measure: 52ch;+ --page-max: 60rem;+}++/* ——————————————————————————————————————————————————————————— */+/* 10 · LINEN — quietly modern, natural fibres */+/* ——————————————————————————————————————————————————————————— */++[data-theme="linen"] {+ --color-paper: oklch(94% 0.018 95);+ --color-paper-2: oklch(91% 0.022 100);+ --color-paper-3: oklch(88% 0.024 105);+ --color-rule: oklch(78% 0.020 110);+ --color-rule-2: oklch(64% 0.022 115);+ --color-muted: oklch(50% 0.022 130);+ --color-neutral: oklch(38% 0.024 140);+ --color-ink-2: oklch(30% 0.024 140);+ --color-ink: oklch(24% 0.022 140);+ --color-accent: oklch(54% 0.080 140);+ --color-accent-ink: oklch(46% 0.085 140);+ --color-focus: oklch(54% 0.080 140);++ --font-display: "DM Serif Display", "Newsreader", "Fraunces", ui-serif, Georgia, serif;+ --font-body: "Hanken Grotesk", "Plus Jakarta Sans", "The Future", ui-sans-serif, sans-serif;+ --font-serif: "DM Serif Display", "Newsreader", ui-serif, Georgia, serif;+ --font-label: "IBM Plex Mono", "The Future Mono", ui-monospace, monospace;+ --font-mono: "IBM Plex Mono", ui-monospace, monospace;++ --display-weight: 400;+ --display-style: normal;++ --text-display: clamp(3rem, 5.5vw + 1rem, 5.75rem);+ --text-display-s: clamp(2rem, 3vw + 1rem, 3rem);++ --tracking-display: -0.018em;+ --tracking-tight: -0.006em;+ --tracking-label: 0.14em;++ --lh-tight: 1.04;+ --lh-snug: 1.18;+ --lh-normal: 1.55;+ --lh-relaxed: 1.7;++ --section-gap: 10rem;+ --section-head-gap: 2.5rem;+ --measure: 56ch;+}++/* ——————————————————————————————————————————————————————————— */+/* 11 · ALMANAC — encyclopaedic, data-dense */+/* ——————————————————————————————————————————————————————————— */++[data-theme="almanac"] {+ --color-paper: oklch(94% 0.012 80);+ --color-paper-2: oklch(91% 0.014 75);+ --color-paper-3: oklch(87% 0.016 70);+ --color-rule: oklch(74% 0.012 70);+ --color-rule-2: oklch(40% 0.014 60);+ --color-muted: oklch(46% 0.014 55);+ --color-neutral: oklch(28% 0.014 50);+ --color-ink-2: oklch(20% 0.012 45);+ --color-ink: oklch(16% 0.012 45);+ --color-accent: oklch(38% 0.135 250);+ --color-accent-ink: oklch(40% 0.13 250);+ --color-focus: oklch(38% 0.135 250);++ --font-display: "Newsreader", "Fraunces", ui-serif, Georgia, serif;+ --font-body: "IBM Plex Sans", "The Future", ui-sans-serif, sans-serif;+ --font-serif: "Newsreader", ui-serif, Georgia, serif;+ --font-label: "IBM Plex Mono", "The Future Mono", ui-monospace, monospace;+ --font-mono: "IBM Plex Mono", "JetBrains Mono", ui-monospace, monospace;++ --display-weight: 500;+ --display-optical: 48;+ --display-style: normal;++ --text-xs: 0.6875rem;+ --text-sm: 0.8125rem;+ --text-base: 0.9375rem;+ --text-md: 1.0625rem;+ --text-lg: 1.25rem;+ --text-xl: 1.5rem;+ --text-2xl: 1.875rem;+ --text-display: clamp(2.25rem, 3.5vw + 1rem, 3.75rem);+ --text-display-s: clamp(1.5rem, 2vw + 1rem, 2.25rem);++ --tracking-display: -0.012em;+ --tracking-tight: -0.005em;+ --tracking-label: 0.06em;++ --lh-tight: 1.1;+ --lh-snug: 1.22;+ --lh-normal: 1.5;++ --space-xl: 2rem;+ --space-2xl: 3rem;+ --space-3xl: 4.5rem;++ --section-gap: 4.5rem;+ --section-head-gap: 1rem;+ --measure: 64ch;+ --page-max: 84rem;+}++/* ——————————————————————————————————————————————————————————— */+/* 12 · SPORT — italic energy */+/* ——————————————————————————————————————————————————————————— */++[data-theme="sport"] {+ --color-paper: oklch(96% 0.006 250);+ --color-paper-2: oklch(93% 0.008 250);+ --color-paper-3: oklch(89% 0.010 250);+ --color-rule: oklch(78% 0.008 250);+ --color-rule-2: oklch(36% 0.060 255);+ --color-muted: oklch(50% 0.020 250);+ --color-neutral: oklch(30% 0.040 255);+ --color-ink-2: oklch(22% 0.060 258);+ --color-ink: oklch(16% 0.080 260);+ --color-accent: oklch(58% 0.190 35);+ --color-accent-ink: oklch(54% 0.20 35);+ --color-focus: oklch(58% 0.190 35);++ --font-display: "Bricolage Grotesque", "Space Grotesk", ui-sans-serif, sans-serif;+ --font-body: "Plus Jakarta Sans", "Hanken Grotesk", "The Future", ui-sans-serif, sans-serif;+ --font-serif: "Bricolage Grotesque", ui-sans-serif, sans-serif;+ --font-label: "JetBrains Mono", "IBM Plex Mono", ui-monospace, monospace;+ --font-mono: "JetBrains Mono", ui-monospace, monospace;++ --display-weight: 700;+ --display-style: italic;+ --display-optical: 96;++ --text-display: clamp(3.5rem, 8vw + 1rem, 8.5rem);+ --text-display-s: clamp(2.25rem, 4vw + 1rem, 4rem);+ --text-2xl: 2.5rem;+ --text-xl: 1.875rem;++ --tracking-display: -0.04em;+ --tracking-tight: -0.018em;+ --tracking-label: 0.10em;++ --lh-tight: 0.94;+ --lh-snug: 1.06;++ --section-gap: 6rem;+ --section-head-gap: 1.5rem;++ --rule-hair: 1px;+ --rule-fine: 2px;+ --measure: 58ch;+}diff --git a/site/fonts/the-future-bold.woff2 b/site/fonts/the-future-bold.woff2new file mode 100644index 0000000..5fa2901Binary files /dev/null and b/site/fonts/the-future-bold.woff2 differdiff --git a/site/fonts/the-future-light.woff2 b/site/fonts/the-future-light.woff2new file mode 100644index 0000000..b269838Binary files /dev/null and b/site/fonts/the-future-light.woff2 differdiff --git a/site/fonts/the-future-medium.woff2 b/site/fonts/the-future-medium.woff2new file mode 100644index 0000000..4e0a155Binary files /dev/null and b/site/fonts/the-future-medium.woff2 differdiff --git a/site/fonts/the-future-mono-bold.woff2 b/site/fonts/the-future-mono-bold.woff2new file mode 100644index 0000000..439307dBinary files /dev/null and b/site/fonts/the-future-mono-bold.woff2 differdiff --git a/site/fonts/the-future-mono-light.woff2 b/site/fonts/the-future-mono-light.woff2new file mode 100644index 0000000..351ea7bBinary files /dev/null and b/site/fonts/the-future-mono-light.woff2 differdiff --git a/site/fonts/the-future-mono-medium.woff2 b/site/fonts/the-future-mono-medium.woff2new file mode 100644index 0000000..b6cf5a5Binary files /dev/null and b/site/fonts/the-future-mono-medium.woff2 differdiff --git a/site/fonts/the-future-mono-regular.woff2 b/site/fonts/the-future-mono-regular.woff2new file mode 100644index 0000000..f67b2a1Binary files /dev/null and b/site/fonts/the-future-mono-regular.woff2 differdiff --git a/site/fonts/the-future-regular.woff2 b/site/fonts/the-future-regular.woff2new file mode 100644index 0000000..7d32ef0Binary files /dev/null and b/site/fonts/the-future-regular.woff2 differdiff --git a/site/index.html b/site/index.htmlnew file mode 100644index 0000000..a80cc1a--- /dev/null+++ b/site/index.html@@ -0,0 +1,531 @@+<!doctype html>+<html lang="en" data-theme="specimen">+<head>+ <meta charset="utf-8" />+ <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />+ <meta name="color-scheme" content="light" />+ <title>Hallmark — A design skill that refuses to look AI-generated</title>+ <meta name="description" content="Hallmark is a design skill for AI coding assistants. It encodes the anti-AI-slop consensus — typography, colour, layout, motion, interaction — into one holistic ruleset. Powered by Together AI." />++ <meta property="og:title" content="Hallmark — A design skill that refuses to look AI-generated" />+ <meta property="og:description" content="A design skill for AI coding assistants. Encodes the anti-slop consensus into one ruleset. Powered by Together AI." />+ <meta property="og:type" content="website" />++ <link rel="preload" href="fonts/the-future-regular.woff2" as="font" type="font/woff2" crossorigin />+ <link rel="preload" href="fonts/the-future-medium.woff2" as="font" type="font/woff2" crossorigin />+ <link rel="preload" href="fonts/the-future-mono-regular.woff2" as="font" type="font/woff2" crossorigin />++ <link rel="stylesheet" href="css/tokens.css" />+ <link rel="stylesheet" href="css/base.css" />+ <link rel="stylesheet" href="css/components.css" />+ <link rel="stylesheet" href="css/sections.css" />++ <script>+ // Load stored theme before paint to avoid flash+ try {+ const t = localStorage.getItem("hallmark-theme");+ if (t) document.documentElement.dataset.theme = t;+ } catch (e) {}+ </script>+</head>+<body>++ <main class="page">++ <!-- NAV -->+ <nav class="nav" aria-label="Primary">+ <a href="#top" class="wordmark">Hallmark</a>++ <div class="themer nav__themer" aria-expanded="false">+ <button class="themer__trigger" type="button" id="themer-trigger" aria-haspopup="dialog" aria-expanded="false">+ <span class="themer__trigger-label">Theme · </span>+ <span class="themer__trigger-current" data-theme-current>Specimen</span>+ <span class="themer__trigger-caret" aria-hidden="true"></span>+ </button>++ <span class="themer__kbd" aria-hidden="true">+ press <span class="themer__kbd-key">T</span>+ </span>++ <div class="themer__panel" id="themer-panel" role="dialog" aria-label="Choose a theme">++ <div class="themer__group">+ <p class="themer__group-label">Editorial</p>+ <button class="themer__btn" type="button" data-theme-btn="specimen" aria-pressed="true">+ <span>Specimen</span>+ <span class="themer__swatches" aria-hidden="true">+ <span class="themer__swatch" style="background: oklch(96% 0.012 80)"></span>+ <span class="themer__swatch" style="background: oklch(18% 0.010 60)"></span>+ <span class="themer__swatch" style="background: #FC4C02"></span>+ </span>+ </button>+ <button class="themer__btn" type="button" data-theme-btn="newsprint" aria-pressed="false">+ <span>Newsprint</span>+ <span class="themer__swatches" aria-hidden="true">+ <span class="themer__swatch" style="background: oklch(95% 0.020 60)"></span>+ <span class="themer__swatch" style="background: oklch(18% 0.012 250)"></span>+ <span class="themer__swatch" style="background: oklch(48% 0.13 30)"></span>+ </span>+ </button>+ <button class="themer__btn" type="button" data-theme-btn="atelier" aria-pressed="false">+ <span>Atelier</span>+ <span class="themer__swatches" aria-hidden="true">+ <span class="themer__swatch" style="background: oklch(96% 0.012 70)"></span>+ <span class="themer__swatch" style="background: oklch(12% 0.012 40)"></span>+ <span class="themer__swatch" style="background: oklch(58% 0.115 65)"></span>+ </span>+ </button>+ </div>++ <div class="themer__group">+ <p class="themer__group-label">Soft</p>+ <button class="themer__btn" type="button" data-theme-btn="garden" aria-pressed="false">+ <span>Garden</span>+ <span class="themer__swatches" aria-hidden="true">+ <span class="themer__swatch" style="background: oklch(96% 0.020 115)"></span>+ <span class="themer__swatch" style="background: oklch(24% 0.050 160)"></span>+ <span class="themer__swatch" style="background: #B6485E"></span>+ </span>+ </button>+ <button class="themer__btn" type="button" data-theme-btn="salon" aria-pressed="false">+ <span>Salon</span>+ <span class="themer__swatches" aria-hidden="true">+ <span class="themer__swatch" style="background: oklch(95% 0.014 65)"></span>+ <span class="themer__swatch" style="background: oklch(22% 0.024 35)"></span>+ <span class="themer__swatch" style="background: oklch(58% 0.105 130)"></span>+ </span>+ </button>+ <button class="themer__btn" type="button" data-theme-btn="linen" aria-pressed="false">+ <span>Linen</span>+ <span class="themer__swatches" aria-hidden="true">+ <span class="themer__swatch" style="background: oklch(94% 0.018 95)"></span>+ <span class="themer__swatch" style="background: oklch(24% 0.022 140)"></span>+ <span class="themer__swatch" style="background: oklch(54% 0.080 140)"></span>+ </span>+ </button>+ </div>++ <div class="themer__group">+ <p class="themer__group-label">Technical</p>+ <button class="themer__btn" type="button" data-theme-btn="midnight" aria-pressed="false">+ <span>Midnight</span>+ <span class="themer__swatches" aria-hidden="true">+ <span class="themer__swatch" style="background: oklch(14% 0.010 40)"></span>+ <span class="themer__swatch" style="background: oklch(94% 0.006 80)"></span>+ <span class="themer__swatch" style="background: #FC4C02"></span>+ </span>+ </button>+ <button class="themer__btn" type="button" data-theme-btn="terminal" aria-pressed="false">+ <span>Terminal</span>+ <span class="themer__swatches" aria-hidden="true">+ <span class="themer__swatch" style="background: oklch(11% 0.010 145)"></span>+ <span class="themer__swatch" style="background: oklch(86% 0.150 138)"></span>+ <span class="themer__swatch" style="background: oklch(78% 0.180 138)"></span>+ </span>+ </button>+ <button class="themer__btn" type="button" data-theme-btn="almanac" aria-pressed="false">+ <span>Almanac</span>+ <span class="themer__swatches" aria-hidden="true">+ <span class="themer__swatch" style="background: oklch(94% 0.012 80)"></span>+ <span class="themer__swatch" style="background: oklch(16% 0.012 45)"></span>+ <span class="themer__swatch" style="background: oklch(38% 0.135 250)"></span>+ </span>+ </button>+ </div>++ <div class="themer__group">+ <p class="themer__group-label">Bold</p>+ <button class="themer__btn" type="button" data-theme-btn="brutal" aria-pressed="false">+ <span>Brutal</span>+ <span class="themer__swatches" aria-hidden="true">+ <span class="themer__swatch" style="background: oklch(98% 0.003 90)"></span>+ <span class="themer__swatch" style="background: oklch(10% 0.005 60)"></span>+ <span class="themer__swatch" style="background: #FF2E2E"></span>+ </span>+ </button>+ <button class="themer__btn" type="button" data-theme-btn="manifesto" aria-pressed="false">+ <span>Manifesto</span>+ <span class="themer__swatches" aria-hidden="true">+ <span class="themer__swatch" style="background: oklch(98% 0.004 90)"></span>+ <span class="themer__swatch" style="background: oklch(8% 0.005 60)"></span>+ <span class="themer__swatch" style="background: #E51A1A"></span>+ </span>+ </button>+ <button class="themer__btn" type="button" data-theme-btn="sport" aria-pressed="false">+ <span>Sport</span>+ <span class="themer__swatches" aria-hidden="true">+ <span class="themer__swatch" style="background: oklch(96% 0.006 250)"></span>+ <span class="themer__swatch" style="background: oklch(16% 0.080 260)"></span>+ <span class="themer__swatch" style="background: oklch(58% 0.190 35)"></span>+ </span>+ </button>+ </div>++ </div>+ </div>++ <div class="nav__meta">+ v0.1 · <a href="#install" class="link">Install</a>+ </div>+ </nav>++ <!-- 01 · OPENING -->+ <header class="opening reveal" style="--i:0" id="top">+ <div>+ <p class="opening__eyebrow">+ <span class="mark" aria-hidden="true"></span>+ A design skill · Powered by Together AI+ </p>+ <h1 class="opening__title">+ Designs that refuse to look <em>AI-generated.</em>+ </h1>+ <p class="opening__sub">+ Hallmark is a skill for Claude Code, Cursor, and Codex. It encodes the anti-slop consensus — typography, colour, layout, motion, interaction — into one holistic ruleset your AI assistant will actually follow.+ </p>+ </div>+ <aside class="opening__aside">+ <div class="opening__rule" aria-hidden="true"></div>+ <div class="opening__cta">+ <p class="label">01 ⁄ Install</p>+ <pre class="code" data-copy-source><span class="prompt">$</span><span data-copy-text>npx skills add hallmark</span><button class="code__copy" type="button" data-copy-btn aria-label="Copy install command"><span class="code__copy-default">Copy</span><span class="code__copy-done">Copied</span></button></pre>+ <a href="#install" class="link">Other ways to install →</a>+ </div>+ </aside>+ </header>++ <!-- 02 · THE PROBLEM -->+ <section class="section reveal" style="--i:1" aria-labelledby="s2">+ <header class="section__head">+ <p class="section-label">+ <span class="num">02</span><span class="divider">⁄</span><span>The problem</span>+ </p>+ <h2 class="section__title" id="s2">+ Every LLM was trained on the same templates. Without a firm hand, they all emit the same page.+ </h2>+ </header>++ <div class="vs">+ <div class="vs__col">+ <div class="vs__head"><span class="vs__label">Without Hallmark</span></div>+ <div class="vs__demo"><div class="viz-purple-hero"></div></div>+ <p class="vs__caption">+ Centred hero. Purple-to-pink gradient. Inter display. Startup-cliché tagline. Rounded-pill CTA. A view every LLM has produced ten thousand times.+ </p>+ </div>+ <div class="vs__col">+ <div class="vs__head"><span class="vs__label">With Hallmark</span></div>+ <div class="vs__demo vs__demo--good">+ <span class="label">01 ⁄ Specimen</span>+ <span class="title">A quiet <em>instrument.</em></span>+ </div>+ <p class="vs__caption">+ Asymmetric, left-biased. One accent, barely visible. A distinctive display face paired with a serif for emphasis. No gradient, no pill, no slop.+ </p>+ </div>+ </div>+ </section>++ <!-- 03 · FOUNDATIONS -->+ <section class="section reveal" style="--i:2" aria-labelledby="s3">+ <header class="section__head">+ <p class="section-label">+ <span class="num">03</span><span class="divider">⁄</span><span>Foundations</span>+ </p>+ <h2 class="section__title" id="s3">+ Eight dimensions. A short, opinionated rule on each.+ </h2>+ </header>++ <div class="foundations">++ <article class="spec">+ <header class="spec__head">+ <span class="spec__name">Typography</span>+ <span class="spec__num">F / 01</span>+ </header>+ <p class="spec__rule">Banned defaults. Distinctive display paired with a refined body. Commit to weight extremes.</p>+ <div class="spec__body type-spec">+ <span class="type-spec__display">Display face</span>+ <span class="type-spec__body">paired with a <em>workhorse</em> body.</span>+ </div>+ </article>++ <article class="spec">+ <header class="spec__head">+ <span class="spec__name">Colour</span>+ <span class="spec__num">F / 02</span>+ </header>+ <p class="spec__rule">OKLCH only. One accent, under 3% of any view. No pure black. No pure white. No purple gradients.</p>+ <div class="spec__body">+ <div class="swatch-row">+ <div class="swatch swatch--light" style="background: var(--color-paper);">Paper</div>+ <div class="swatch swatch--light" style="background: var(--color-paper-3);">Rule</div>+ <div class="swatch" style="background: var(--color-neutral);">Mute</div>+ <div class="swatch" style="background: var(--color-ink);">Ink</div>+ <div class="swatch" style="background: var(--color-accent);">Accent</div>+ </div>+ </div>+ </article>++ <article class="spec">+ <header class="spec__head">+ <span class="spec__name">Space</span>+ <span class="spec__num">F / 03</span>+ </header>+ <p class="spec__rule">4-point scale, named semantically. <code>gap</code> for siblings. Break the grid on purpose, not by accident.</p>+ <div class="spec__body" style="display:flex; align-items:end; gap:var(--space-2xs); height:3rem;">+ <span style="width:4px; height:25%; background:var(--color-ink);"></span>+ <span style="width:4px; height:35%; background:var(--color-ink);"></span>+ <span style="width:4px; height:45%; background:var(--color-ink);"></span>+ <span style="width:4px; height:60%; background:var(--color-ink);"></span>+ <span style="width:4px; height:78%; background:var(--color-ink);"></span>+ <span style="width:4px; height:100%; background:var(--color-ink);"></span>+ <span class="label" style="margin-left:.75rem;">4 ⁄ 8 ⁄ 12 ⁄ 16 ⁄ 24 ⁄ 40</span>+ </div>+ </article>++ <article class="spec">+ <header class="spec__head">+ <span class="spec__name">Motion</span>+ <span class="spec__num">F / 04</span>+ </header>+ <p class="spec__rule">Animate <code>transform</code> and <code>opacity</code> only. One orchestrated entrance beats ten micro-bounces.</p>+ <div class="spec__body">+ <svg class="curve" viewBox="0 0 200 80" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">+ <path d="M 0 80 C 32 80, 60 8, 200 0" fill="none" stroke="currentColor" stroke-width="1.2" />+ <line x1="0" y1="80" x2="200" y2="80" stroke="var(--color-rule-2)" stroke-width="0.5" />+ <line x1="0" y1="0" x2="200" y2="0" stroke="var(--color-rule-2)" stroke-width="0.5" stroke-dasharray="2 2" />+ </svg>+ <span class="label">cubic-bezier(0.16, 1, 0.3, 1) · 420 ms</span>+ </div>+ </article>++ <article class="spec">+ <header class="spec__head">+ <span class="spec__name">States</span>+ <span class="spec__num">F / 05</span>+ </header>+ <p class="spec__rule">Eight states, not two. <code>:focus-visible</code> ring. 44 px hit target. Labels above inputs.</p>+ <div class="spec__body" style="display:flex; flex-wrap:wrap; gap:var(--space-xs) var(--space-md);">+ <span class="label">default</span>+ <span class="label">hover</span>+ <span class="label">focus</span>+ <span class="label">active</span>+ <span class="label">disabled</span>+ <span class="label">loading</span>+ <span class="label">error</span>+ <span class="label">success</span>+ </div>+ </article>++ <article class="spec">+ <header class="spec__head">+ <span class="spec__name">Responsive</span>+ <span class="spec__num">F / 06</span>+ </header>+ <p class="spec__rule">Mobile-first. Breakpoints where content breaks, not where a device sits. <code>dvh</code>, not <code>vh</code>.</p>+ <div class="spec__body">+ <span class="dim">40 rem 60 rem 90 rem</span>+ </div>+ </article>++ <article class="spec">+ <header class="spec__head">+ <span class="spec__name">Copy</span>+ <span class="spec__num">F / 07</span>+ </header>+ <p class="spec__rule">Specific verbs. Three-part errors. Link text that reads alone. Proper punctuation, not straight quotes.</p>+ <div class="spec__body">+ <span class="serif-italic" style="font-size:var(--text-md); color:var(--color-ink-2);">+ “Save changes” beats “OK”. “View pricing plans” beats “Click here”.+ </span>+ </div>+ </article>++ <article class="spec">+ <header class="spec__head">+ <span class="spec__name">Anti-patterns</span>+ <span class="spec__num">F / 08</span>+ </header>+ <p class="spec__rule">The named tells. Flagged by <code>hallmark audit</code>, erased by <code>hallmark refine</code>.</p>+ <div class="spec__body">+ <span class="dim">21 tells catalogued</span>+ </div>+ </article>++ </div>+ </section>++ <!-- 04 · GALLERY OF TELLS -->+ <section class="section reveal" style="--i:3" aria-labelledby="s4">+ <header class="section__head">+ <p class="section-label">+ <span class="num">04</span><span class="divider">⁄</span><span>Gallery of tells</span>+ </p>+ <h2 class="section__title" id="s4">+ The patterns every LLM reaches for by default. Hallmark catches each one by name.+ </h2>+ </header>++ <div class="rail" role="list" aria-label="Named anti-patterns">+ <article class="tell" role="listitem">+ <div class="tell__viz"><div class="viz-purple-hero"></div></div>+ <div class="tell__meta">+ <span class="tell__name">Purple-gradient hero</span>+ <span class="tell__why">Diagonal gradient behind centred white display type. The most-recognised AI aesthetic.</span>+ </div>+ </article>++ <article class="tell" role="listitem">+ <div class="tell__viz"><div class="viz-gradient-text"></div></div>+ <div class="tell__meta">+ <span class="tell__name">Gradient headline</span>+ <span class="tell__why">Headline with <code>background-clip: text</code> filled by a two-stop gradient. Decorative; carries no meaning.</span>+ </div>+ </article>++ <article class="tell" role="listitem">+ <div class="tell__viz">+ <div class="viz-icon-tile">+ <div><span class="icon"></span><span class="h"></span><span class="t"></span><span class="t"></span></div>+ <div><span class="icon"></span><span class="h"></span><span class="t"></span><span class="t"></span></div>+ <div><span class="icon"></span><span class="h"></span><span class="t"></span><span class="t"></span></div>+ </div>+ </div>+ <div class="tell__meta">+ <span class="tell__name">Icon-tile feature grid</span>+ <span class="tell__why">Three identical columns, icon-above-heading-above-two-lines. The universal LLM feature section.</span>+ </div>+ </article>++ <article class="tell" role="listitem">+ <div class="tell__viz">+ <div class="viz-centered-hero">+ <span class="h">Build what's next</span>+ <span class="s">Unleash the power of seamless AI for your team.</span>+ <span class="c">Get started</span>+ </div>+ </div>+ <div class="tell__meta">+ <span class="tell__name">Centred-everything hero</span>+ <span class="tell__why">Hero, sub-head, CTA — all centred, all gradient-pilled. A template masquerading as a page.</span>+ </div>+ </article>+ </div>+ </section>++ <!-- 05 · HOW IT WORKS -->+ <section class="section reveal" style="--i:4" aria-labelledby="s5">+ <header class="section__head">+ <p class="section-label">+ <span class="num">05</span><span class="divider">⁄</span><span>How it works</span>+ </p>+ <h2 class="section__title" id="s5">+ Install once. Describe what you need. Hallmark routes the rest.+ </h2>+ </header>++ <div class="how">++ <article class="step">+ <span class="step__num">I</span>+ <div>+ <h3 class="step__head">Install the skill</h3>+ <p class="step__sub">One command. Works in Claude Code, Cursor, and Codex out of the box.</p>+ </div>+ <div class="step__body">+ <pre class="code" data-copy-source><span class="prompt">$</span><span data-copy-text>npx skills add hallmark</span><button class="code__copy" type="button" data-copy-btn aria-label="Copy install command"><span class="code__copy-default">Copy</span><span class="code__copy-done">Copied</span></button></pre>+ </div>+ </article>++ <article class="step">+ <span class="step__num">II</span>+ <div>+ <h3 class="step__head">Ask for a UI</h3>+ <p class="step__sub">In plain language. Hallmark refuses to design without a confirmed audience, use case, and tone — so it asks first.</p>+ </div>+ <div class="step__body">+ <pre class="code code--block">> build a landing page for a local bookshop's+ new poetry collection. editorial tone,+ for literary-minded customers.</pre>+ </div>+ </article>++ <article class="step">+ <span class="step__num">III</span>+ <div>+ <h3 class="step__head">Ship, audit, refine</h3>+ <p class="step__sub">The default verb builds. <code>hallmark audit</code> scores existing code against the tells. <code>hallmark refine</code> polishes in place.</p>+ </div>+ <div class="step__body">+ <pre class="code code--block">$ claude "hallmark audit ./components/hero.tsx"+ → 2 critical · 3 major · 1 minor+ → verdict: reads as AI-generated</pre>+ </div>+ </article>++ </div>+ </section>++ <!-- 06 · INSTALL -->+ <section class="section reveal" style="--i:5" id="install" aria-labelledby="s6">+ <header class="section__head">+ <p class="section-label">+ <span class="num">06</span><span class="divider">⁄</span><span>Install</span>+ </p>+ <h2 class="section__title" id="s6">+ Four ways in. Pick the one that matches your harness.+ </h2>+ </header>++ <div class="installs">++ <div class="install">+ <p class="install__head">npx · any harness</p>+ <pre class="install__body" data-copy-source><span data-copy-text>npx skills add hallmark</span><button class="code__copy code__copy--block" type="button" data-copy-btn aria-label="Copy install command"><span class="code__copy-default">Copy</span><span class="code__copy-done">Copied</span></button></pre>+ </div>++ <div class="install">+ <p class="install__head">Claude Code</p>+ <pre class="install__body">~/.claude/skills/hallmark/+ SKILL.md+ references/*.md</pre>+ </div>++ <div class="install">+ <p class="install__head">Cursor</p>+ <pre class="install__body">.cursor/rules/hallmark.mdc+ (body of SKILL.md,+ no frontmatter)</pre>+ </div>++ <div class="install">+ <p class="install__head">Manual</p>+ <pre class="install__body">git clone &&+ copy skill/ into+ your agent config</pre>+ </div>++ </div>+ </section>++ <!-- 07 · FOOTER -->+ <footer class="foot reveal" style="--i:6" role="contentinfo">+ <div class="foot__credits">+ MIT licensed. Built on the research of+ <a href="https://github.com/pbakaus/impeccable" class="link">impeccable</a>,+ <a href="https://github.com/tw93/kami" class="link">kami</a>,+ <a href="https://github.com/Leonxlnx/taste-skill" class="link">taste-skill</a>,+ and Anthropic's <a href="https://github.com/anthropics/skills" class="link">frontend-design skill</a>.+ Where rules overlapped, Hallmark adopted. Where they diverged, Hallmark picked.+ </div>+ <div class="foot__powered">+ <span class="foot__powered-mark">Powered by Together AI</span>+ </div>+ </footer>++ </main>++ <script type="module" src="js/main.js"></script>+</body>+</html>diff --git a/site/js/main.js b/site/js/main.jsnew file mode 100644index 0000000..c26f007--- /dev/null+++ b/site/js/main.js@@ -0,0 +1,185 @@+// Hallmark — reveals + theme picker + microinteractions.+// Dogfoods the patterns in skill/references/microinteractions.md.++const reduced = matchMedia("(prefers-reduced-motion: reduce)").matches;++/* — Page-load reveals (one orchestrated entrance) ——————————— */+const reveals = document.querySelectorAll(".reveal");+if (reduced || !("IntersectionObserver" in window)) {+ reveals.forEach((el) => el.classList.add("is-in"));+} else {+ const io = new IntersectionObserver(+ (entries) => {+ for (const entry of entries) {+ if (entry.isIntersecting) {+ entry.target.classList.add("is-in");+ io.unobserve(entry.target);+ }+ }+ },+ { threshold: 0.08, rootMargin: "0px 0px -5% 0px" }+ );+ reveals.forEach((el) => io.observe(el));+}++/* — Copy-to-clipboard (silent success, label swap pattern) ————— */+const copyBtns = document.querySelectorAll("[data-copy-btn]");+copyBtns.forEach((btn) => {+ btn.addEventListener("click", async () => {+ const source = btn.closest("[data-copy-source]");+ const textNode = source && source.querySelector("[data-copy-text]");+ const text = textNode ? textNode.textContent.trim() : "";+ if (!text) return;++ try {+ await navigator.clipboard.writeText(text);+ } catch (err) {+ // Fallback for older browsers / non-secure contexts+ const ta = document.createElement("textarea");+ ta.value = text;+ ta.setAttribute("readonly", "");+ ta.style.position = "fixed";+ ta.style.left = "-9999px";+ document.body.appendChild(ta);+ ta.select();+ try { document.execCommand("copy"); } catch (e) {}+ document.body.removeChild(ta);+ }++ btn.dataset.state = "copied";+ btn.setAttribute("aria-live", "polite");+ clearTimeout(btn._copyTimer);+ btn._copyTimer = setTimeout(() => {+ delete btn.dataset.state;+ }, 2200);+ });+});++/* — Theme picker ————————————————————————————————————— */+const THEMES = {+ specimen: "Specimen",+ midnight: "Midnight",+ brutal: "Brutal",+ garden: "Garden",+ atelier: "Atelier",+ newsprint: "Newsprint",+ terminal: "Terminal",+ manifesto: "Manifesto",+ salon: "Salon",+ linen: "Linen",+ almanac: "Almanac",+ sport: "Sport",+};+const STORAGE_KEY = "hallmark-theme";++const root = document.documentElement;+const themer = document.querySelector(".themer");+const trigger = document.getElementById("themer-trigger");+const panel = document.getElementById("themer-panel");+const currentLabel = document.querySelector("[data-theme-current]");+const buttons = document.querySelectorAll("[data-theme-btn]");++function setPressed(theme) {+ buttons.forEach((btn) => {+ const active = btn.dataset.themeBtn === theme;+ btn.setAttribute("aria-pressed", active ? "true" : "false");+ });+ if (currentLabel) currentLabel.textContent = THEMES[theme] || "Specimen";+}++function applyTheme(theme) {+ if (!THEMES[theme]) return;+ const apply = () => {+ root.dataset.theme = theme;+ setPressed(theme);+ try { localStorage.setItem(STORAGE_KEY, theme); } catch (e) {}+ };+ if (!reduced && document.startViewTransition) {+ document.startViewTransition(apply);+ } else {+ apply();+ }+}++const stored = (() => {+ try { return localStorage.getItem(STORAGE_KEY); } catch (e) { return null; }+})();+const initial = THEMES[stored] ? stored : (root.dataset.theme || "specimen");+setPressed(initial);++buttons.forEach((btn) => {+ btn.addEventListener("click", () => {+ applyTheme(btn.dataset.themeBtn);+ closePanel();+ trigger.focus();+ });+});++/* — Popover open/close ————————————————————————————————— */+function isOpen() { return themer.getAttribute("aria-expanded") === "true"; }++function openPanel() {+ themer.setAttribute("aria-expanded", "true");+ trigger.setAttribute("aria-expanded", "true");+ document.addEventListener("keydown", onKey);+ document.addEventListener("click", onOutside, { capture: true });+ // Focus the currently-pressed theme button so arrow keys make sense+ const active = panel.querySelector('[aria-pressed="true"]') || panel.querySelector("[data-theme-btn]");+ if (active) {+ requestAnimationFrame(() => active.focus());+ }+}++function closePanel() {+ themer.setAttribute("aria-expanded", "false");+ trigger.setAttribute("aria-expanded", "false");+ document.removeEventListener("keydown", onKey);+ document.removeEventListener("click", onOutside, { capture: true });+}++function togglePanel() { isOpen() ? closePanel() : openPanel(); }++trigger.addEventListener("click", (e) => {+ e.stopPropagation();+ togglePanel();+});++function onKey(e) {+ if (e.key === "Escape") {+ closePanel();+ trigger.focus();+ }+}++function onOutside(e) {+ if (!themer.contains(e.target)) closePanel();+}++// Arrow-key navigation in the panel+panel.addEventListener("keydown", (e) => {+ const focusables = Array.from(panel.querySelectorAll("[data-theme-btn]"));+ const i = focusables.indexOf(document.activeElement);+ if (i < 0) return;+ let next = i;+ if (e.key === "ArrowDown" || e.key === "ArrowRight") next = (i + 1) % focusables.length;+ else if (e.key === "ArrowUp" || e.key === "ArrowLeft") next = (i - 1 + focusables.length) % focusables.length;+ else if (e.key === "Home") next = 0;+ else if (e.key === "End") next = focusables.length - 1;+ else return;+ e.preventDefault();+ focusables[next].focus();+});++/* — Global keyboard shortcuts ————————————————————————————— */+// "T" opens the theme picker — shown via the delay-revealed kbd hint.+document.addEventListener("keydown", (e) => {+ // Don't intercept if the user is typing in an input+ const tag = (e.target.tagName || "").toLowerCase();+ if (tag === "input" || tag === "textarea" || e.target.isContentEditable) return;+ if (e.metaKey || e.ctrlKey || e.altKey) return;++ if (e.key === "t" || e.key === "T") {+ e.preventDefault();+ if (!isOpen()) openPanel();+ }+});diff --git a/skill/SKILL.md b/skill/SKILL.mdnew file mode 100644index 0000000..8ea5dd6--- /dev/null+++ b/skill/SKILL.md@@ -0,0 +1,217 @@+---+name: hallmark+description: Use this skill when the user asks to design, build, redesign, audit, or refine a UI, web page, landing page, dashboard, component, or interface — or when they ask to make something "feel less AI-generated." Hallmark forces intentional design decisions (typography, color, layout, motion, interaction, structure) and refuses to default to the generic AI-UI template. Trigger phrases include "design a", "build a landing page", "make a dashboard", "redesign this site", "redesign the page", "refine this UI", "audit this design", "this looks AI-generated", "fix the design", "polish this", "give this a different look", and any request that will produce HTML / CSS / JSX / Tailwind output.+version: 0.2.0+---++# Hallmark++A design skill for AI coding assistants. Makes the UIs they generate look made, not generated.++Hallmark is opinionated, short, and boring on purpose. It encodes a tight set of rules — drawn from the consensus of the anti-AI-slop design field (impeccable, kami, Anthropic's frontend-design skill, taste-skill, the Claude cookbook on frontend aesthetics, and the 2026 "tactile rebellion" movement) — and refuses to let the model fall back to the defaults every LLM was trained on.++The differentiator: Hallmark insists on **structural variety**, not just visual variety. Two pages by Hallmark for two different briefs should not share the same hero → 3-feature → CTA → footer rhythm. They should feel like different sites, not different colour-swaps of the same template. See [`references/structure.md`](references/structure.md).++**Powered by Together AI.**++---++## How to use this skill++Hallmark has one default behaviour and three explicit verbs.++| Invocation | What it does |+| --- | --- |+| *(default)* | The user asked you to design or build something new. Follow the **Design flow** below. |+| `hallmark audit <target>` | Read the target, score it against the anti-pattern list, return a ranked punch list. **Do not edit.** |+| `hallmark refine <target>` | Apply the ruleset to polish the target in place. Preserve layout structure. **Smallest possible diff.** No redesign. |+| `hallmark redesign <target> [--mood <name>]` | Take the target's content and intent, throw out the structure, and **rebuild it from scratch with a deliberately different structural fingerprint.** New section rhythm, new heading placement, new component voice. Preserve copy, brand, and information architecture; replace everything else. |++If the user types anything that does not clearly map to `audit`, `refine`, or `redesign`, treat it as default.++---++## Design flow (default)++### 1. Design-context gate++Before writing a single line of code, confirm you have all three:++1. **Audience.** Who will use this? What do they already know?+2. **Use case.** What single job does this interface do? What is the one action the user should be able to take?+3. **Tone.** Pick an extreme — *editorial, brutalist, soft, utilitarian, luxury, playful, technical, austere*. "Clean and modern" is not a tone and is not acceptable.++If any of the three is missing, ask for it in one short message. Ask for all missing items at once, not one at a time. Do not guess. Do not infer from the filename, the framework, or surrounding code.++Once you have the three, restate them in one sentence and proceed.++### 2. Pick a structural fingerprint++Before loading the visual ruleset, decide the **structural fingerprint** of this page along these axes (one decision each — see [`references/structure.md`](references/structure.md) for the full catalogue):++- **Section-heading placement.** Left margin / hanging / centered / bottom-aligned / overlapping image / sticky / numbered display / inline.+- **Body composition.** Single column / two-column asymmetric / multi-column justified / marginalia / three-column equal / full-bleed with reset / asymmetric spans.+- **Divider language.** Hairline rule / ornament / negative space / bleed-color block.+- **Button voice.** Outlined / unstyled link / oversized solid / typographic-only.+- **Image treatment.** Full-bleed / tightly cropped / inline / margin-aligned / none.+- **Reveal pattern.** Fade-up stagger / horizontal sweep / type-unmask / number-tick / typewriter / none.++Pick a *combination*. The combination is the page's voice. Two combinations should never be identical across pages you build for the same user. If a previous page in this session used left-margin labels with hairline dividers, this one should not.++### 3. Load the visual ruleset++The non-negotiables live in [`references/`](references/). Read only what you need:++- [`typography.md`](references/typography.md) — fonts, scale, pairing, weights, measure+- [`color.md`](references/color.md) — OKLCH, palette construction, accent discipline, dark mode+- [`layout-and-space.md`](references/layout-and-space.md) — 4pt scale, grid-breaks, asymmetry, depth+- [`structure.md`](references/structure.md) — heading patterns, body composition, dividers, component voice, reveal style+- [`motion.md`](references/motion.md) — durations, easings, what to animate, reduced-motion+- [`microinteractions.md`](references/microinteractions.md) — per-interaction recipes (button press, focus, modal, toast, optimistic update, command palette, drag, copy-to-clipboard, search-as-you-type) and the named microinteraction tells+- [`interaction-and-states.md`](references/interaction-and-states.md) — the eight states, focus, hit-targets, forms+- [`responsive.md`](references/responsive.md) — mobile-first, content-driven breakpoints, safe areas+- [`copy.md`](references/copy.md) — verbs, labels, error structure, link text+- [`anti-patterns.md`](references/anti-patterns.md) — the named tells you must not emit++For most design work you need `typography`, `color`, `layout-and-space`, `structure`, and `anti-patterns`. **Load `microinteractions` whenever the output has *any* interactive element** — buttons, links, inputs, forms, modals, tabs, dropdowns, toasts, drag handles, command palettes, copy buttons, anything with hover/focus/active states. That is most pages.++### 4. Build++Emit code that satisfies the tone and structural fingerprint. Match the complexity of the code to the ambition of the tone — a brutalist page needs raw, heavy CSS; an austere page needs restraint.++Always:++- Use OKLCH for every colour. Declare tokens as CSS custom properties at `:root`.+- Use a 4pt spacing scale with semantic names (`--space-sm`, `--space-md`, …).+- Pick a distinctive display face and a refined body face. Pairings, not single-font pages — *unless* the single-font choice IS the design (a true terminal-aesthetic page is monospace-only on purpose; that's allowed).+- Design every interactive element for its full eight states (see [`interaction-and-states.md`](references/interaction-and-states.md)).+- Animate `transform` and `opacity` only — never layout properties.+- Use the three named easings (`--ease-out`, `--ease-in`, `--ease-in-out`) — never the browser default `ease`, never bounce/overshoot on UI state.+- Support `prefers-reduced-motion: reduce`. Spatial motion collapses to ≤150ms opacity crossfade.+- Include `:focus-visible` with a visible ring at ≥3:1 contrast. **Never animate the ring's appearance** — it must show instantly on focus.+- For each interaction in the output (button, input, modal, toast, drag, copy, etc.), apply the recipe in [`microinteractions.md`](references/microinteractions.md). Pick *silent success* over celebratory toasts. Pick *optimistic update + Undo* over confirmation dialogs. Pick *delay 800ms* on hover tooltips and *0ms* on focus tooltips.+- Cut motion before adding it. Most pages have too much, not too little. If removing an animation wouldn't lose the user information, remove it.++### 5. The slop test++Before handing back, run the output through these twenty questions. Every answer must be **no**.++**Visual:**++1. Is the display font Inter, Roboto, Open Sans, Poppins, Lato, or a system default?+2. Is there a purple-to-blue (or cyan-to-magenta) gradient anywhere?+3. Is there a 3-equal-column card grid with icon-above-heading tiles?+4. Is any card nested inside another card?+5. Is there a `background-clip: text` gradient headline?+6. Is any card using a thick coloured left/right side-stripe border?+7. Is the hero `min-height: 100vh` with everything centred?+8. Is pure `#000` or pure `#fff` used as a base colour anywhere?++**Structural:**++9. Does the page use the *same* structural fingerprint as the last page you built? (Hero → 3 features → CTA → footer is the AI structural template; reject it.)+10. Are sections separated only by equal whitespace, with no rule, no ornament, no colour shift — every section identical in rhythm?++**Microinteractions:**++11. Is `transition-all` (or `transition: all`) used anywhere? (Specify the properties.)+12. Is `hover:scale-105` (or any uniform hover-scale) applied across multiple unrelated elements?+13. Are bouncy / overshoot easings (`cubic-bezier(0.34, 1.56, ...)`, etc.) used on UI state changes — buttons, modals, tooltips? (Reserve overshoots for physical interactions only.)+14. Does any element have *more than one* hover effect at the same time (translate + scale + shadow + colour + rotate)?+15. Are you animating `width`, `height`, `top`, `left`, `margin`, or `padding` anywhere?+16. Does the focus ring transition into existence (fade in)? (Focus rings must appear instantly — keyboard users need an immediate indicator.)+17. Is there a celebratory success toast for an action whose effect the user can already see? (Silent success is taste; toasts are for failures and invisible effects.)+18. Are tooltip hover-delay and focus-delay equal? (Hover should delay 800–1000 ms; focus should be 0 ms.)+19. Is auto-rotating content (carousel, banner, stats) lacking pause-on-hover-and-focus? (WCAG 2.2.2.)+20. Is there a placeholder name "Jane Doe / John Smith" or a startup cliché (Acme, Nexus, Seamless, Unleash)?++If any answer is yes, fix it. Do not ship slop.++---++## `hallmark audit`++Read the file(s) the user pointed at. For each finding, return:++- **Tell** — the named anti-pattern from `anti-patterns.md`.+- **Where** — file path and line range.+- **Severity** — `critical` (ships as slop), `major` (looks AI-generated), `minor` (small taste issue).+- **Fix** — one-line concrete correction.++Group by severity. Do not edit. Do not redesign. End with a count: `N critical · M major · K minor`.++Audit *also* checks structural fingerprint: if the page uses the AI template (centered hero, 3 equal feature cards, CTA, footer, with no asymmetry or surprise), flag it as a critical structural finding even if the visual treatment is fine.++---++## `hallmark refine`++The user has code they are happy with structurally but wants polished. Your job is to apply the ruleset with the smallest possible diff.++- Do not move or rename elements unless necessary.+- Do not restructure the DOM.+- Do swap fonts, rewrite colour tokens to OKLCH, tighten the type scale, correct easings, add missing states, fix any flagged anti-patterns.+- At the end, list what you changed and which reference file prompted each change.++---++## `hallmark redesign`++The user wants a different page from the same content. They are not happy with the current structure — typically because it reads as templated, generic, or AI-shaped. Your job is to throw the structure out and build a new one.++**What to preserve:**+- The copy (every word, ideally)+- The information architecture (which sections exist, in roughly what order)+- The brand (colours and fonts they've named, if any)+- The primary action++**What to replace:**+- The structural fingerprint — pick a **different** combination from `structure.md` than the source had.+- The component voice — different button style, different divider language, different image treatment.+- The reveal pattern — if the original faded everything in on scroll, the new one might have no reveals at all.+- The visual rhythm — different sections having different padding, different alignments, deliberate breaks.++**Optional `--mood <name>` argument:**++If the user specifies a mood (`hallmark redesign ./hero.tsx --mood luxury`), pick a tone aligned to that mood and let it drive the structural fingerprint. Mood names map to tones from `references/typography.md` and `references/structure.md`. If no mood is given, ask the user what *feeling* they want — one word — and proceed.++**Output:**++Return the redesigned code, plus a short note explaining:++- The structural fingerprint you picked, axis by axis.+- Why this combination fits the brief better than the original.+- One thing you removed and why.++---++## Output contract++When producing new work:++- Put design tokens in one place at the top of the stylesheet (`:root` custom properties) or in a `tokens.css` / `tokens.ts` file if the project uses one.+- Name tokens by semantic role, not value. `--color-ink`, not `--color-black`.+- If the project uses Tailwind, extend the theme; do not inline arbitrary values across components.+- If the project uses a framework, match the framework's file conventions — don't reinvent them.+- Include a short comment block at the top of the stylesheet naming the tone the user picked, the palette's anchor hue, and the structural fingerprint. This is the only comment you need.++---++## Scope and limits++Hallmark is a *taste* skill. It will not:++- Invent product copy. If the user hasn't given you the words, ask.+- Pick a brand identity. It will follow one you give it.+- Enforce a specific style (dark mode, glassmorphism, brutalism). It will execute whichever tone the user committed to.+- Build logic — state management, data fetching, business rules. It is a visual / interaction layer only.++If a request falls outside taste — "build the auth flow", "wire up Stripe" — do the work, but apply Hallmark to the rendered surface.++---++## Credits++Built on the research and open work of [impeccable](https://github.com/pbakaus/impeccable) (Paul Bakaus), [kami](https://github.com/tw93/kami) (tw93), [taste-skill](https://github.com/Leonxlnx/taste-skill) (Leonxlnx), Anthropic's [frontend-design skill](https://github.com/anthropics/skills) and [canvas-design skill](https://github.com/anthropics/skills), [DESIGN.md](https://getdesign.md) (Google Stitch), MC Dean's [63 design skills collection](https://marieclairedean.substack.com/p/i-built-63-design-skills-for-claude), the [Slopless](https://slopless.design) tactile-rebellion canon, and the Claude [frontend aesthetics cookbook](https://platform.claude.com/cookbook/coding-prompting-for-frontend-aesthetics). Where rules overlapped across those sources, Hallmark adopted them. Where they diverged, Hallmark picked.++MIT licensed. Powered by Together AI.diff --git a/skill/references/anti-patterns.md b/skill/references/anti-patterns.mdnew file mode 100644index 0000000..67e0a3d--- /dev/null+++ b/skill/references/anti-patterns.md@@ -0,0 +1,264 @@+# Anti-patterns — the named tells++The `hallmark audit` verb flags these by name. Every one of these is a signature of AI-generated UI. Seeing one is a problem; seeing two in the same view is a confirmation.++Each entry: the tell, why it reads as AI-generated, and the fix.++---++## Critical (ships as slop)++### The purple-gradient hero++A hero section with a background gradient from purple to blue or purple to pink, often with white centred text. This is the single most-recognised AI aesthetic.++**Fix.** Pick a single anchor hue. One accent. No gradient backgrounds on heroes. If you want warmth, tint the neutrals.++### Inter-everywhere++Inter (or Roboto, or Open Sans) used as both display and body, with no pairing face. A one-font page is a template page.++**Fix.** Pair a distinctive display face with a refined body face. See [`typography.md`](typography.md).++### The 3-column feature grid++Three equal columns, each with an icon above a two-line heading above a three-line body. Usually spanned full-width with 24px gap. Every LLM emits this.++**Fix.** Break the grid. Vary column widths. Mix card heights. Remove one card and use negative space. Move the icons inline, not above. Or drop the cards entirely and use typographic rhythm.++### Card-in-card++A bordered container with cards inside it. Or: a card containing another card containing a small "micro-card". Visual nesting with no semantic reason.++**Fix.** Pick one containment layer. Usually the outer one is the wrong one.++### The gradient headline++A headline with `background-clip: text` fill set to a linear gradient (usually purple-to-pink or blue-to-cyan). Signals "AI generated" faster than almost anything else.++**Fix.** Solid ink. If you want the headline to feel alive, use weight or italic or a display face — not a gradient fill.++### The side-stripe card++A card with a thick coloured border on one edge (usually left, 4–6px, purple or green). Very recognisable; very 2018-SaaS-AI.++**Fix.** Use a hairline border all around, or no border, or a small accent square beside the heading. Never an asymmetric thick stripe.++### Full-viewport centred hero++`min-height: 100vh` (or `100dvh`), everything centred, one short sentence, one big CTA. The default LLM landing page.++**Fix.** Let the hero be the height of its content. Bias left or right. Put more than a sentence in it.++### Pure black, pure white++`#000000` background or `#ffffff` surface. Both read as flat and synthetic.++**Fix.** Tint toward your anchor hue. See [`color.md`](color.md).++---++## Major (looks AI-generated)++### Bounce and elastic easing++Buttons that bounce in, icons that wobble on hover. These easings were trendy a decade ago.++**Fix.** Exponential ease-out. See [`motion.md`](motion.md).++### Centred everything++Headline centred, body centred, button centred, section after section of centred columns.++**Fix.** Bias the layout. Wide left margin, narrow right. Or the reverse. Breaking symmetry once is enough.++### Shadow-glow on dark++A card on a dark background with a `box-shadow` that leaves a soft coloured halo around it.++**Fix.** On dark surfaces, use elevation via *lightness* (brighter surface = higher), not shadow. If you must shadow, keep it tight and dark.++### Icon-tile feature card++Rounded rectangle, icon in a coloured square at the top-left, heading below it, two lines of copy, optional "Learn more →" link. The universal template.++**Fix.** If you need these, let them be asymmetric — vary sizes, vary alignments, pull the icon inline with the heading, or drop the icon entirely.++### Glassmorphism without purpose++Frosted-glass panels everywhere — usually layered over a gradient that you also shouldn't have.++**Fix.** Glassmorphism can work when it communicates depth (overlay over content). It cannot work as decoration.++### Hover-only affordances++Hover reveals a menu; hover shows a delete button; hover triggers a tooltip that contains crucial information. Touch users get nothing.++**Fix.** Every hover affordance has a focus state and is accessible via tap/click on coarse pointers.++### Tabular data without tabular-nums++A list of prices, dates, or metrics where the numbers don't align vertically because the font uses proportional figures.++**Fix.** `font-variant-numeric: tabular-nums;` on any container displaying columns of numbers.++### Animate-on-scroll on everything++Every section fades in when it enters the viewport. Every list staggers. The page never settles.++**Fix.** Pick one orchestrated entrance. Let the rest just *be there*.++---++## Microinteraction tells++These are the named tells of AI-generated *motion*. See [`microinteractions.md`](microinteractions.md) for the full catalogue and recipes.++### `transition-all`++Every property animating, including ones that should be instant (visibility, focus rings).++**Fix.** Specify the properties. `transition: background-color var(--dur-short) var(--ease-out), transform 100ms var(--ease-out)`.++### Universal `hover:scale-105`++Every card lifts on hover, with no shadow change, no easing specified, no purpose.++**Fix.** Pick one signal per element. A 1px translate, or a colour shift, or an underline thickening — never all four.++### Bouncy overshoot easings on UI++`cubic-bezier(0.34, 1.56, 0.64, 1)` and friends on buttons, modals, tooltips. Tasteless throwback.++**Fix.** Reserve overshoots for genuine physical interactions (drag-and-drop release). For UI state, use `--ease-out` from `motion.md`.++### Animated hover gradients++Background gradient slides through colour space on hover.++**Fix.** Cut. Or pick one colour shift, instant.++### Cursor follower dots++A trailing dot that lags behind the pointer.++**Fix.** Cut.++### Auto-rotating carousels with no pause++WCAG 2.2.2 failure.++**Fix.** Manual advance only, or pause-on-hover-and-focus, or autoplay disabled by default.++### Celebratory success toasts++"Done!" when the user just saved a thing they can see was saved.++**Fix.** Silent success. Toasts only for failures, async actions whose effect isn't visible, and explicit confirmations the user will need.++### Confirmation dialogs for reversible actions++"Are you sure you want to delete this?" before a one-row delete.++**Fix.** Optimistic delete + 5–10s Undo toast. Reserve the modal for irreversible destructive actions, and even then, type-the-name confirmation, not click-OK.++### Tooltips with the same delay on hover and focus++Both delay 800ms.++**Fix.** Hover delay 800–1000ms. Focus delay 0ms. Different intents, different timing.++### Focus rings that animate in++The ring fades in over 200ms — keyboard users have no indicator at the start of the transition.++**Fix.** Focus rings appear instantly. Always. Don't transition `outline` or `box-shadow` when the element gains focus.++### Toasts that shift layout++New toast pushes content down; dismissed toast lets it spring back.++**Fix.** Stack at a viewport corner, fixed positioning. Existing toasts don't move when a new one arrives.++### Universal scroll-triggered fade-up++Every section fades in on intersection. The page never settles.++**Fix.** One orchestrated entrance on first load. After that, content is just there.++### Spinners that flash++A spinner appears for 50ms while a fast action completes.++**Fix.** Either delay-show the spinner (150ms before showing) or enforce a minimum visible duration (300ms once shown). Skeletons over spinners when the layout is known.++---++## Minor (small taste issues)++### Straight quotes++`"Hello"` and `'word'` in rendered text. A sign nothing was proof-read.++**Fix.** Curly quotes: `"Hello"`, `'word'`.++### Double-hyphen dashes++`--` in body copy where an em-dash belongs.++**Fix.** `—` (U+2014).++### Three periods instead of ellipsis++`...` in body copy.++**Fix.** `…` (U+2026).++### Placeholder names++"Jane Doe", "John Smith", "Example User".++**Fix.** Plausible placeholder names reflecting the audience, or pull from a seeded faker. "Maya Okonkwo", "Sam Tan", "Elena Ruiz".++### Startup-cliché product names++"Acme", "Nexus", "Pulse", "Unleash", "Seamless", "Supercharge".++**Fix.** Name the thing concretely. If it's a demo, use a domain-specific placeholder — "Maple Weekly", "Ridgeline Inventory" — not abstract startup bingo.++### `z-index: 9999`++Arbitrary large z-values.++**Fix.** Use the six-level named scale. See [`layout-and-space.md`](layout-and-space.md).++### Every section padded the same++Top padding, bottom padding, horizontal padding — all equal across every section.++**Fix.** Vary. Tighten one, expand another.++### 100vw widths++`width: 100vw` on anything. Breaks on scrollbar-visible desktops.++**Fix.** `width: 100%` with container padding.++---++## How `hallmark audit` should report++For each finding:++```+[severity] Tell name — file:line+ why it's a tell (one line)+ → fix (one line)+```++Then:++```+Summary — N critical · M major · K minor+Verdict — [ships as slop | reads as AI-generated | close, fix the minors]+```diff --git a/skill/references/color.md b/skill/references/color.mdnew file mode 100644index 0000000..6bf19ca--- /dev/null+++ b/skill/references/color.md@@ -0,0 +1,95 @@+# Colour++Most AI-generated UI fails on colour. It picks blue. It uses pure black. It draws a gradient from purple to cyan. It leaves accents on 30% of the page. Fix all of this.++## Principles++- **OKLCH only.** Perceptually uniform; predictable lightness; consistent hue across tints. `hsl()` and `rgb()` lie about brightness.+- **One accent.** Maximum two. Everything else is neutral. The accent should occupy **3% or less** of any given viewport.+- **No pure extremes.** No `#000`, no `#fff`. Always tint with a trace of chroma toward the palette's anchor hue.+- **Tint the greys.** If your anchor hue is orange, your neutrals lean warm. If it's blue, they lean cool. A page with a warm accent and cool grey body copy looks wrong and most people can't name why.++## Palette construction++A complete Hallmark palette has four layers.++1. **Paper** — the base surface. `oklch(96–98% 0.005–0.015 <anchor hue>)` for light mode, `oklch(12–16% 0.008–0.015 <anchor hue>)` for dark.+2. **Ink** — the primary text. `oklch(16–22% 0.005–0.015 <anchor hue>)` for light mode, `oklch(92–96% 0.005–0.01 <anchor hue>)` for dark.+3. **Neutrals** — 5 to 9 steps between Paper and Ink, each with the anchor's chroma tint at low values (0.005–0.015).+4. **Accent** — one saturated colour with meaningful chroma (0.12–0.22). Used for links, active states, highlights, focus rings. Never as a background fill that covers more than a few percent of the surface.++Example (warm-oat anchor, hue 80):++```css+:root {+ --color-paper: oklch(96% 0.012 80);+ --color-paper-2: oklch(93% 0.014 80);+ --color-rule: oklch(82% 0.010 80);+ --color-neutral: oklch(56% 0.008 80);+ --color-muted: oklch(40% 0.008 70);+ --color-ink: oklch(18% 0.010 60);+ --color-accent: #FC4C02; /* signal orange */+ --color-focus: oklch(55% 0.19 55);+}+```++Example (midnight anchor, hue 40):++```css+:root {+ --color-paper: oklch(14% 0.008 40);+ --color-paper-2: oklch(18% 0.010 40);+ --color-rule: oklch(30% 0.008 40);+ --color-neutral: oklch(58% 0.008 40);+ --color-muted: oklch(72% 0.006 40);+ --color-ink: oklch(94% 0.006 80);+ --color-accent: #FC4C02;+ --color-focus: oklch(70% 0.19 55);+}+```++## Contrast++Use the APCA contrast check when you can; otherwise WCAG 2.1 ratios.++| Content | Minimum | Target |+| --- | --- | --- |+| Body text | 4.5:1 | 7:1 |+| Large text (≥ 18.66px bold or 24px) | 3:1 | 4.5:1 |+| UI component boundaries | 3:1 | 4.5:1 |+| Placeholder / helper text | 4.5:1 | 4.5:1 |++Verify with the browser devtools vision-deficiency emulator before shipping.++## Dark mode recipe++- Paper: lightness 12–18% (not `#000`).+- Ink: lightness 92–96% (not `#fff`).+- Body font-weight: reduce by 50 units (400 → 350) to compensate for the optical weight of light text on dark.+- Accent: reduce chroma by 0.02–0.04; increase lightness by 5–10%.+- Elevation: higher surfaces are *lighter*, not darker. Add ~3% lightness per level.+- Never switch the hue between modes. Keep the anchor. Only lightness and chroma move.++## Bans++- **Pure `#000000`** anywhere. Use `oklch(16% 0.01 <hue>)` or similar.+- **Pure `#ffffff`** as a base surface. Use a tinted paper.+- **Flat grey** (`oklch(L 0 H)` with zero chroma). Add at least 0.005.+- **Purple-to-cyan gradients, purple-to-blue gradients, orange-to-pink gradients.** Every LLM picks these. Don't.+- **Accent as background fill** covering more than ~5% of any view.+- **Grey text on coloured background.** Always reads washed out.+- **Red–green pairing as the only signal.** Add an icon or pattern.+- **Alpha transparency as the definition of a colour.** If it's a named token, it's opaque. Transparency is a *modifier* for overlays and shadows, not a palette.+- **Three-colour gradients.** Two-stop gradients only. The third stop is vanity.++## Use of the accent++The accent is a highlighter, not a colour block. Reach for it to:++- Mark an active nav item.+- Draw a focus ring.+- Underline a link on hover.+- Indicate a primary CTA's border or text.+- Place a small square beside a heading as a visual anchor.++Do not fill giant buttons with it. Do not set whole sections on it. Do not use it for decorative gradients. If you feel the urge to use more, that's the slop defaulting. Use less.diff --git a/skill/references/copy.md b/skill/references/copy.mdnew file mode 100644index 0000000..b321fa3--- /dev/null+++ b/skill/references/copy.md@@ -0,0 +1,64 @@+# Copy++Words are part of the design. A great layout with stock copy looks generic. Tight copy in an average layout reads as considered.++## Principles++- **Specific verbs.** "Save changes" beats "OK" beats "Submit".+- **Labels describe.** "Email address" beats "Email".+- **Link text stands alone.** "View pricing plans" beats "Click here".+- **Errors are instructions.** Describe what broke, why, how to fix — in that order.+- **Active voice.** "We couldn't find your account" beats "Your account could not be found".+- **Consistency.** Pick one of "Delete" or "Remove". Pick one of "Sign in" or "Log in". Use it everywhere.++## Buttons++Use the verb for the action the button performs.++Good: `Save changes`, `Create account`, `Send invitation`, `Copy link`, `Open file`.+Bad: `OK`, `Submit`, `Click here`, `Continue` (only as the secondary button of a multi-step flow).++## Error messages++Three parts:++1. **What happened.** Past tense, factual. "That card was declined."+2. **Why, if known.** "Your bank flagged the charge."+3. **What to do.** Imperative. "Try another card, or contact your bank."++Never apologetic for the *user's* input. Don't say "Oops!" on a validation error. A form that won't accept a value should explain the value, not perform embarrassment.++## Empty states++Three beats:++1. One line naming what's empty. "No projects yet."+2. One line on why this matters / what projects are. "Projects group your tasks and team."+3. One button. The single next action. "Create a project".++## Loading++- Short wait: spinner with no text.+- Medium wait (>2s): spinner + "Loading…".+- Long wait (>10s): spinner + progress indication + an honest label — "Compiling (this can take a minute)."++## Microcopy bans++- "Click here." Link text must stand alone.+- "Oops!", "Uh oh!", "Something went wrong." Name the thing that broke.+- "Enter your email below." If the input is below, you don't need to say so.+- Exclamation marks in error states.+- Humour in frustration paths (forgot-password, payment-failed, account-locked).+- Stock placeholder names: Jane Doe, John Smith, Lorem Ipsum (unless the page is a lorem-ipsum tool).+- Startup clichés in product copy: Acme, Nexus, Unleash, Seamless, Supercharge, Transform, Elevate, Empower, Delight, Magical.+- Marketing copy that promises a feeling without naming a feature. "Experience the power of ___" is empty.++## Proper typography++- Curly quotes: `"Hello"`, `'word'`.+- Em-dash for interruption: `—` (U+2014). En-dash for ranges: `10–20` (U+2013). Never `--`.+- Ellipsis: `…` (U+2026). Never `...`.+- Apostrophe: `’`. Never the prime `'`.+- Non-breaking space before units: `10 kg`, `5 min` (use ` ` or U+00A0).++If the text is loaded from a CMS, configure Smart Quotes in the CMS. If it's hard-coded, write it correctly.diff --git a/skill/references/interaction-and-states.md b/skill/references/interaction-and-states.mdnew file mode 100644index 0000000..29dc21f--- /dev/null+++ b/skill/references/interaction-and-states.md@@ -0,0 +1,102 @@+# Interaction and states++Every interactive element has eight states. Most AI-generated UI styles two (default, hover) and forgets the rest. That's where interfaces break.++## The eight states++| State | When | Treatment |+| --- | --- | --- |+| Default | At rest | Base styling |+| Hover | Pointer over (only with `@media (hover: hover)`) | Small shift: colour, 1px translate, subtle border |+| Focus | Keyboard or programmatic focus | Visible ring, `:focus-visible` |+| Active / Pressed | During press | Pressed-in: darker, translate(0 1px) |+| Disabled | Not interactive | Reduced opacity (0.5) + `cursor: not-allowed` + `aria-disabled` |+| Loading | Processing | Inline spinner or progress, label stays readable |+| Error | Failed state | Red border, error icon, message, `aria-invalid` |+| Success | Completed | Green check, confirmation, auto-dismiss |++If any of these is missing on a production element, the element isn't finished.++## Focus rings++Visible, always, on every interactive element. The default focus ring most browsers give you is fine; a custom one is better.++```css+:focus { outline: none; }+:focus-visible {+ outline: 2px solid var(--color-focus);+ outline-offset: 2px;+ border-radius: inherit;+}+```++Requirements:++- 2–3px, ≥ 3:1 contrast against both element and page.+- 2px offset from the element.+- `:focus-visible`, not `:focus`, so it's keyboard-only.+- Never `outline: none` without a replacement. `outline: none` with no other focus style is the most common accessibility bug and an immediate audit failure.++## Hit targets++Minimum 44×44 CSS px for any touch-reachable element. Use padding or an `::before` overlay to expand the hit target without changing visual size:++```css+.icon-btn {+ position: relative;+}+.icon-btn::before {+ content: "";+ position: absolute;+ inset: -12px;+}+```++## Forms++- Labels above inputs. Visible. Never placeholder-as-label.+- Placeholders show format, not instruction. `Placeholder: 01 Jan 2026`, not `Placeholder: Enter your birth date`.+- Helper text below input. Error text replaces helper text.+- Validate on **blur**, not on every keystroke. Revalidate on change once the field has been blurred once (the "touched" pattern).+- Error message: (1) what broke, (2) why, (3) what to do. One sentence if possible.+- Associate errors with `aria-describedby`. Set `aria-invalid="true"` on the field.+- Required fields marked with `aria-required`, never with colour alone.+- Disable the submit button only when the form is in a known-invalid or in-flight state. Never on idle.++## Modals and overlays++- Use the native `<dialog>` element. It handles focus trap, escape to close, and `::backdrop` styling for free.+- Set `inert` on the page content behind a modal so tab order doesn't leak.+- Close on: escape key, backdrop click, explicit close button.+- First focus goes to the first interactive element, not the close button.++## Dropdowns, tooltips, popovers++- Use the Popover API (`popover` attribute). It handles light-dismiss, stacking, and escape for free, and works in every modern browser.+- Position with CSS Anchor Positioning where it's available; fall back to `position: fixed` + `getBoundingClientRect()`.+- Never put a dropdown inside an `overflow: hidden` container without escape. It will clip.+- Flip when near the viewport edge.++## Undo over confirm++- For reversible actions, skip the confirm dialog. Do the thing. Show a toast with an Undo button for 5–10 seconds.+- For destructive, irreversible actions (delete account, drop table), keep the confirm — and make the user type the thing being destroyed, not just click "OK".++## Loading and empty states++- **Skeleton** screens over spinners for content that has a predictable shape (lists, cards, tables).+- **Inline spinners** for in-button state. Replace the label, don't add beside it.+- **Empty states** always have: an illustration or icon (a small one), a one-line explanation of why it's empty, an action to fix it.+- Never show a generic "No results" with no context.++## Bans++- Placeholder-as-label.+- Hover-only functionality (touch users can't hover).+- Focus rings removed without replacement.+- Confirmation dialogs for low-stakes actions.+- Touch targets < 44px.+- Custom cursors on interactive elements.+- Disabled elements with no explanation of why they're disabled.+- Colour-only error states.+- Spinners where a skeleton would show layout.diff --git a/skill/references/layout-and-space.md b/skill/references/layout-and-space.mdnew file mode 100644index 0000000..da14bba--- /dev/null+++ b/skill/references/layout-and-space.md@@ -0,0 +1,89 @@+# Layout and space++Layout is where "AI-generated" gets caught. Equal columns, everything centred, every card identical — these are the tells.++## Principles++- A layout has a **primary axis**. Left-biased, right-biased, top-heavy, or bottom-weighted. Centre-biased is a default, not a choice.+- **Asymmetry reads as intentional.** Symmetry reads as generated. When in doubt, shift.+- **Spacing is a scale, not a value.** Pick one scale. Use it everywhere. Don't type raw px.+- **Varied spacing.** If every gap is 24px, the page is a template. Mix small, medium, and large gaps within the same layout.+- **Break the grid on purpose.** A page with one element crossing the grid is stronger than a page that never does.++## The spacing scale++4pt base. Nine steps. Named by role, not size.++```css+:root {+ --space-3xs: 0.125rem; /* 2px */+ --space-2xs: 0.25rem; /* 4px */+ --space-xs: 0.5rem; /* 8px */+ --space-sm: 0.75rem; /* 12px */+ --space-md: 1rem; /* 16px */+ --space-lg: 1.5rem; /* 24px */+ --space-xl: 2.5rem; /* 40px */+ --space-2xl: 4rem; /* 64px */+ --space-3xl: 6rem; /* 96px */+ --space-4xl: 9rem; /* 144px */+}+```++- Use `gap` for sibling spacing. It's cleaner than stacked margins, it participates in flex/grid, and it collapses predictably.+- Use `margin` only for optical adjustments or breaking out of the flow. Never `margin` for a list of siblings.++## Grids++- **Prefer CSS Grid** for page layout, **Flexbox** for component internals.+- `grid-template-columns: repeat(auto-fit, minmax(280px, 1fr))` for fluid responsive grids without media queries.+- **Don't default to 3 columns of equal cards with icon-above-heading-above-copy.** This is *the* AI feature-grid. Break it: vary column widths with `grid-template-columns: 1.2fr 1fr 0.8fr`, or use a 12-column underlying grid and give each item a different span, or use 4-up with a 2-span hero, etc.+- Use **named grid areas** for complex layouts and rename them at breakpoints.++## Asymmetry techniques++- **Wide left margin.** Treat the left as a permanent negative space — narrow column of labels, wide column of content.+- **Hanging headers.** Section labels sit in the left margin; content flows to the right.+- **Offset grids.** Odd columns wider than even. Or the other way.+- **Grid-breaks.** One element that deliberately extends past a column boundary: a pull-quote, a photograph, a rule, a number.+- **Generous top, tight bottom** (or vice-versa). Sections don't need to be evenly padded.++## Depth++- Depth is **weight and scale**, not shadow. A heavier weight, a larger size, a warmer hue — these create hierarchy better than drop shadows.+- If you use shadow, use one:+ - **Whisper** — `0 1px 2px oklch(20% 0.01 <hue> / 0.05)` for hovering cards.+ - **Hairline** — `0 0 0 1px oklch(30% 0.01 <hue> / 0.06)` as an alternative to a 1px border.+- Never stack multiple shadows. Never use a coloured glow on a light background.+- Z-index has **six levels, named.** Don't freestyle numbers.++```css+:root {+ --z-base: 1;+ --z-raised: 10;+ --z-dropdown: 100;+ --z-sticky: 200;+ --z-modal: 400;+ --z-toast: 500;+ --z-tooltip: 600;+}+```++## Bans++- **Centre-aligned everything.** Headings + body + CTA all centred is the landing-page template every LLM emits.+- **`min-height: 100vh` hero with one centred sentence.** Stop.+- **Card-in-card.** A bordered container inside a bordered container. Pick one.+- **Identical feature grid.** Three columns, three icons, three two-line headings, three three-line bodies. Change *something*.+- **Equal padding on everything.** If the card padding equals the section padding equals the page padding, the rhythm is flat.+- **`z-index: 9999`** and other ad-hoc z values. Use the scale.+- **Shadow-on-dark accidental glow.** A drop shadow on a dark card creates a glow; that's wrong.++## When in doubt++If the layout looks fine but flat, do one of these before shipping:++1. Add one break-out element.+2. Unbalance a column width.+3. Move the primary CTA out of the centre.+4. Remove a card and replace it with negative space.+5. Change one section's padding so the rhythm is uneven.diff --git a/skill/references/microinteractions.md b/skill/references/microinteractions.mdnew file mode 100644index 0000000..236172e--- /dev/null+++ b/skill/references/microinteractions.md@@ -0,0 +1,221 @@+# Microinteractions++The single biggest gap in 2026's anti-slop canon. Most skills correct typography and colour; very few correct *the small, repeated moments where an interface either feels designed or feels generated.* This file is the correction.++A microinteraction is one event with four parts: trigger → rules → feedback → loops/modes (Saffer). Get any of those wrong and the interface feels uncrafted. Ship them all right and the interface feels *made* — even when nothing else is unusual.++## Principles++- **Motion has intent or motion is cut.** Every animation must clarify, guide, or confirm. If you cannot name what a transition communicates, it is decoration. Decoration is slop.+- **Silent success.** A successful action does *not* deserve a "Done!" toast. If the user sees the result, they don't need a confirmation. Reserve toasts for failures and for actions that hide their own effect.+- **Optimism with rollback.** Update the UI immediately on user action. Send the request in the background. If it fails, animate the rollback and offer Undo. Round-trip latency is a perception killer.+- **Restraint, not restraint-as-personality.** Hallmark is not "no motion." Hallmark is *the right motion in the right place.* A drag handle that springs into focus on grab is good. A page where every card pulses on hover is slop.+- **Reduced motion is a first-class state, not an afterthought.** Every interaction defines its reduced-motion behaviour explicitly. Default is: collapse spatial motion to opacity crossfade, keep duration ≤ 150ms, preserve functional state changes.+- **Keyboard first, hover second.** Every hover affordance has a focus equivalent. No interaction is hover-only.++## The timing canon++Pick from these durations. Do not invent new ones.++| Bucket | Use for |+| --- | --- |+| **80–120 ms** | Instant feedback (button press tick, checkbox state, keystroke echo). The brain reads anything in this window as immediate. |+| **150–200 ms** | Hover state transitions, focus rings appearing, single-property fades, tooltip appears (with delay before — see below). |+| **250–300 ms** | Modal / dropdown / sheet opens, content fades in, validation icon scales in, tab content crossfade. |+| **400–500 ms** | Toast slides in, page-load section reveal, complex multi-property transitions, accordion open. |+| **0 ms** | The right answer surprisingly often. Focus state, keyboard navigation, error appearance — many things should not animate at all. |++Exit durations are 60–75% of the corresponding entrance. A 300ms enter pairs with a 200ms exit. Never the reverse.++## The easing canon++Three curves cover ~90% of UI motion. Tokenise them and never freestyle.++```css+:root {+ /* Entering elements — decelerate into place */+ --ease-out: cubic-bezier(0.16, 1, 0.3, 1);++ /* Exiting elements — accelerate away */+ --ease-in: cubic-bezier(0.7, 0, 0.84, 0);++ /* State toggles — symmetrical */+ --ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);++ /* Material 3 standard alternative — slightly less aggressive */+ --ease-standard: cubic-bezier(0.4, 0, 0.2, 1);+}+```++Spring physics replaces eases for **physical** interactions only — drag-and-drop release, swipe-to-dismiss, picker wheel snap, satisfying button press scale-bounce. Otherwise: ease.++| Spring config | Feel | Use for |+| --- | --- | --- |+| `stiffness: 50, damping: 20` | Gentle, no overshoot | Calm reveals; almost an ease |+| `stiffness: 180, damping: 22` | Snappy, slight overshoot | Drag release; toggle handle |+| `stiffness: 280, damping: 26` | Stiff, minimal bounce | Picker snap; haptic-like button press |+| `stiffness: 400, damping: 40` | Very stiff, no bounce | Position corrections; not a spring per se |++**Banned curves:** `ease` (the browser default — flat and uncrafted), `linear` except for progress bars and infinite loaders, anything with overshoot above ~110% (`cubic-bezier(0.34, 1.56, 0.64, 1)` and friends). Bounce is dated and signals templated work.++## Recipes++Each recipe: trigger, what changes, duration, easing, accessibility note. If a recipe is missing here, return to the principles and derive it from them.++### Button press++Trigger: pointer down. Changes: `transform: scale(0.98)` on press, base styling on release. Duration: 100ms in, 150ms out. Easing: in `--ease-in`, out `--ease-out`. A11y: focus ring stays visible; never animate the focus ring's existence.++```css+.btn {+ transition: background-color var(--dur-short) var(--ease-out),+ transform 100ms var(--ease-out);+}+.btn:hover { background: var(--color-ink); color: var(--color-paper); }+.btn:active { transform: translateY(1px); }+.btn:focus-visible { outline: 2px solid var(--color-focus); outline-offset: 3px; }+```++### Input focus + label float++Trigger: focus event. Changes: border-bottom colour, label slides up + shrinks, optional subtle background tint. Duration: 200ms. Easing: `--ease-out`. **Critical:** the change happens *before* the user types — Stripe / Linear use this to confirm the field is alive. A11y: `:focus-visible` only, not `:focus`; respect reduced-motion by removing the slide and keeping only the colour change.++### Form validation++Trigger: blur after the field has been touched once (the "touched" pattern), then re-validate on every input. Never validate on every keystroke from the start — it's hostile. Changes: icon scales in (200ms `--ease-out`), border tints, helper text replaces. Three-part error message: what broke, why, how to fix.++### Toast notification++Trigger: action completes (or fails). Stack at one viewport corner; new toasts push existing ones in one direction; existing toasts do **not** reposition when a new one arrives. Duration: 400ms slide-in `--ease-out`, 4–6s dwell, 300ms slide-out `--ease-in`. Pause auto-dismiss on hover/focus. **Use sparingly:** if the action's effect is visible (a row was deleted; you can see the row is gone), no toast. Errors *always* get a toast with retry/undo.++### Modal open / close++Trigger: explicit user action (click, key shortcut). Backdrop fades 300ms `--ease-out`. Content scales 0.96 → 1.0 + opacity 0 → 1, 300ms `--ease-out`. Close: 220ms `--ease-in`, scale 1.0 → 0.98, opacity → 0. Use the native `<dialog>` element — it handles focus trap and `::backdrop` for free. `inert` on background. First focus to first interactive element, not the close button. Reduced motion: opacity-only crossfade, 150ms.++### Dropdown / menu++Trigger: click or key shortcut. Open: 180ms `--ease-out`, optional 30ms-stagger items if there are ≤ 8 of them. Close: 140ms `--ease-in`. Light-dismiss on outside click and Escape. Use the Popover API where available. Anchor positioning: flip when within 16px of viewport edge.++### Tooltip++Trigger: mouse hover (with **800–1000ms delay** to prevent flash on casual movement) OR keyboard focus (with **0ms delay** — keyboard users reached this deliberately, never delay them). Animation: 150ms `--ease-out` opacity. WCAG 1.4.13: tooltip must be hoverable (you can move pointer onto it without it disappearing), persistent (doesn't disappear on accidental movement), and dismissible (Escape).++### Tab change++Trigger: click or arrow-key. Underline slides `transform: translateX()` + width transition, 250ms `--ease-out`. Outgoing content fades 100ms `--ease-in`, incoming fades 150ms `--ease-out` with a 50ms delay. **Never animate the tab content's height** — animate `grid-template-rows: 0fr → 1fr` if the tabs change height.++### Number tick++Trigger: data loaded. Counter increments from 0 to value over 400ms with `--ease-out` applied to the *value*, not the element. Use `Intl.NumberFormat` for locale-correct separators. A11y: announce the final value with `aria-live="polite"`, *not* every tick. Reduced motion: skip the tick, show the final value.++### Copy-to-clipboard++Trigger: click. Changes: button label swaps to "Copied" with a check icon; revert after 2.5s. **No toast.** The label change *is* the feedback. Restore on `mouseleave` if user moves away sooner.++```js+btn.addEventListener("click", async () => {+ await navigator.clipboard.writeText(value);+ btn.dataset.state = "copied";+ setTimeout(() => delete btn.dataset.state, 2500);+});+```++```css+.copy-btn[data-state="copied"] .copy-btn__label::after { content: " ✓ Copied"; }+.copy-btn[data-state="copied"] .copy-btn__label > * { opacity: 0; }+```++### Drag handle++Trigger: hover (after **1–2s delay** — Notion's pattern). Changes: handle reveals via opacity transition, cursor switches to `grab`. On grab: cursor `grabbing`, ghost element at 50% opacity follows pointer, drop indicator (1px line, accent colour) tracks the nearest valid drop target. Spring stiffness 280 / damping 26 on release-snap. A11y: arrow-key reorder when the row is focused; announce drag state with `aria-live`.++### Optimistic update with rollback++Trigger: any action with a known-correct local prediction (toggle, like, archive, reorder). Changes: state mutates immediately; the row visibly updates. Async request fires. On success: nothing happens — silent success is the marker of taste. On failure: 200ms colour rollback animation + a toast with one Undo button. The toast does not auto-dismiss while the user might still want it.++```js+const prevState = item.completed;+item.completed = !prevState; render();+try {+ await api.update(item);+} catch {+ item.completed = prevState; render();+ toast({ tone: "error", message: "Couldn't save.", action: { label: "Try again", run: retry } });+}+```++### Search-as-you-type++Trigger: input event. Debounce by 250ms before requesting; while debouncing, show a subtle indicator (border opacity or label colour shift). Highlight matches in results with `<mark>`. A11y: announce result count with `aria-live="polite"` after debounce settles, never per keystroke.++### Command palette navigation++Trigger: ⌘K or `/`. Open: instant, no animation. Arrow-keys move selection — **the indicator transitions** between rows (120ms `--ease-out` on the highlight's `transform: translateY()`), but the items themselves don't move. Enter selects. Escape closes. Items stagger-fade in on first open only, never on filter change. The text input stays focused throughout. This is the Linear / Raycast / Vercel pattern.++### Page-load reveals++One orchestrated entrance. Stagger by DOM index, capped at ~500ms total. Use `IntersectionObserver`, never scroll listeners. After first reveal, no more on-scroll animations — let the page just *be there*. Theme-specific themes (Atelier, Salon, Newsprint) skip reveals entirely; that is correct, not a bug.++## The named tells (what AI defaults produce)++These are the microinteraction signatures of generated code. The slop test in [`SKILL.md`](../SKILL.md) checks for them; treat any one as a critical finding.++1. **`transition-all`.** Every property animating, including ones that should be instant (visibility, display, focus rings). Always specify the properties. The class is banned in Hallmark output.+2. **Universal `hover:scale-105`.** Every card lifts on hover, with no shadow change, no easing specified, no purpose. AI's reflexive "make it interactive" gesture.+3. **Bouncy overshoot easings.** `cubic-bezier(0.34, 1.56, 0.64, 1)` and friends on UI elements. Tasteless 2018-throwback. Reserve overshoots for genuine physical interactions (drag release).+4. **Multiple simultaneous hover effects.** A card that translates, scales, shadows, colour-shifts, and rotates on hover. Pick *one* signal.+5. **Animated gradient backgrounds on hover.** The gradient slides through colour space. Distracting, expensive, communicates nothing.+6. **Glow halos on text.** Heavy `text-shadow` for "neon" — destroys contrast, hurts legibility.+7. **Cursor-follower dots.** A trailing dot that lags behind the pointer. Adds nothing; triggers vestibular issues.+8. **Custom cursors on every interactive element.** Conflicts with OS conventions; users learn nothing about what's clickable.+9. **Auto-rotating carousels with no controls.** WCAG 2.2.2 violation. Always.+10. **Parallax on scroll.** Different layers moving at different speeds. Vestibular trigger; rarely serves the content.+11. **`transition` applied to layout properties.** Animating `width`, `height`, `padding`, `margin`, `top`, `left`. Triggers reflow on every frame. Use `transform` or `grid-template-rows: 0fr → 1fr`.+12. **Universal scroll-triggered fade-up-stagger.** Every section fades in on intersection. Page never settles. Pick *one* orchestrated entrance.+13. **Celebratory success toasts.** "Done!" when the user just saved a thing they can see was saved. Silent success is taste.+14. **Confirmation dialogs for reversible actions.** "Are you sure you want to delete this?" Replace with optimistic delete + Undo toast.+15. **Spinners with no minimum visible time.** Spinner flashes on/off when the action completes in 80ms. Either delay showing it (150ms) or set a minimum visible duration (300ms).+16. **Tooltips with the same delay on hover and focus.** Hover should delay 800–1000ms; focus should appear immediately. They are different intents.+17. **Focus rings that animate in.** The ring fades in over 200ms, leaving keyboard users without an indicator at the start of the transition. Focus rings appear instantly. Always.+18. **Color-only state change.** A field turns red on error with no icon, no text, no border style change. Fails WCAG 1.4.1 and is unreadable for ~8% of men.+19. **Toasts that move existing content.** New toast pushes the page down; dismissed toast lets it spring back. Stack toasts; don't shift layout.+20. **Hover delays on touch.** A `:hover` state that the touch user can never reach because there's no equivalent focus / tap behaviour.++## Theme-aware microinteractions++Microinteractions adapt to the theme. The same button press is louder in Brutal than in Atelier. Apply a multiplier per theme:++| Theme | Duration scale | Easing flavour | Notes |+| --- | --- | --- | --- |+| Specimen | 1.0× | `--ease-out` | Default. Restrained. |+| Midnight | 0.9× | `--ease-out` | Snappy, technical. |+| Brutal | 0.75× | `--ease-out` (sharper) | Fast, decisive. No spring. |+| Garden | 1.2× | `--ease-out` | Calm. Springs welcome. |+| Atelier | 1.3× | `--ease-out` (very gentle) | Generous; almost no movement. |+| Newsprint | 0× | none | Static. Print metaphor. |+| Terminal | 0× | none, except cursor blink | Print + monospace metaphor. |+| Manifesto | 0.7× | `--ease-out` (sharp) | Snap into place. |+| Salon | 1.4× | `--ease-out` (very gentle) | Softest. |+| Linen | 1.2× | `--ease-out` | Calm. |+| Almanac | 0.85× | `--ease-out` | Functional, like a reference book. |+| Sport | 0.7× | `--ease-out` (sharp) | Quick, italic-energy. |++If the theme has duration scale `0×`, you do not animate. The page does not move. That is a deliberate design choice; it is not broken.++## Accessibility ground truth++Every recipe in this file must pass these checks before shipping.++- **`prefers-reduced-motion: reduce`** is honoured. Spatial motion collapses to opacity crossfade ≤ 150ms. Functional state changes (progress bars, spinners) slow but remain.+- **Focus rings** are 2–3 px, ≥ 3:1 contrast, never animated in/out, present on every interactive element via `:focus-visible`.+- **Hit targets** ≥ 44 × 44 CSS px on touch surfaces.+- **No reliance on colour alone** for state. Pair with icon, text, or pattern.+- **No flashing** above 3 Hz. Even subtle pulse animations need rate caps.+- **Keyboard equivalents** for every hover affordance. No exceptions.+- **`aria-live`** on async state updates, but `polite` not `assertive` unless safety-critical.++## When in doubt, cut++Most pages have too much motion, not too little. Before shipping, walk through every animation in your output and ask: *what would happen if this animation were instant?* If the answer is "nothing — the user wouldn't notice", remove the animation. If the answer is "the user would lose information about what changed", keep it.++Reaching for a static answer is a sign of taste. Reaching for more motion is the AI default.diff --git a/skill/references/motion.md b/skill/references/motion.mdnew file mode 100644index 0000000..e3207a1--- /dev/null+++ b/skill/references/motion.md@@ -0,0 +1,109 @@+# Motion++Most AI-generated motion is scattered — hover lifts on every card, fade-in on every scroll, bouncing icons. Quiet it. One orchestrated moment beats ten small ones.++> For per-interaction recipes (button press, focus, modal, toast, optimistic update, command palette, drag handle, etc.), see [`microinteractions.md`](microinteractions.md). This file is the *language* of motion; that file is the *vocabulary*.++## Principles++- **Animate only `transform` and `opacity`.** These are GPU-composited; they don't trigger layout. Anything else is a performance bug waiting.+- **Duration is three buckets.** Micro (100–150ms), minor (200–300ms), major (300–500ms). Exits are ~75% of the enter.+- **Easing is exponential ease-out.** Elements coming in slow down into place. Elements leaving accelerate away.+- **Motion serves perception.** If you can't explain what a transition communicates, cut it.+- **Reduced motion is non-optional.** `@media (prefers-reduced-motion: reduce)` collapses all spatial motion to opacity crossfade.++## Easings++Use these three. Name them as tokens.++```css+:root {+ --ease-out: cubic-bezier(0.16, 1, 0.3, 1); /* elements entering */+ --ease-in: cubic-bezier(0.7, 0, 0.84, 0); /* elements leaving */+ --ease-in-out: cubic-bezier(0.65, 0, 0.35, 1); /* state toggles */+}+```++`ease`, `ease-in-out` (default), `cubic-bezier(0.25, 0.1, 0.25, 1)` — these are the browser defaults and they read as uncrafted.++## Durations++```css+:root {+ --dur-micro: 120ms; /* button press, toggle tick, color shift */+ --dur-short: 220ms; /* hover lift, tooltip, menu open */+ --dur-long: 420ms; /* modal, drawer, accordion, page reveal */+}+```++Exits use roughly 75% of the enter:++```css+.menu.is-open { transition: transform var(--dur-short) var(--ease-out); }+.menu.is-close { transition: transform calc(var(--dur-short) * 0.75) var(--ease-in); }+```++## Page-load orchestration++One sequence on page load. Stagger by DOM index using a CSS custom property, not by JS.++```html+<section style="--i: 0">…</section>+<section style="--i: 1">…</section>+<section style="--i: 2">…</section>+```++```css+.reveal {+ opacity: 0;+ transform: translateY(8px);+ animation: reveal var(--dur-long) var(--ease-out) forwards;+ animation-delay: calc(var(--i, 0) * 60ms);+}+@keyframes reveal {+ to { opacity: 1; transform: none; }+}+```++Cap total stagger at ~500ms. Beyond that the page feels slow to settle.++## Scroll-linked motion++- Use IntersectionObserver, **never** `scroll` event listeners.+- Use it only for *reveal once* effects. No parallax. No scroll-scrubbed animations unless there is a specific reason.+- Every scroll-triggered motion must have a reduced-motion fallback.++## State transitions++- Button hover / active: micro duration, `--ease-out`, `transform: translateY(-1px)` on hover, `translateY(0)` on active. Never a `box-shadow` transition on hover on a dark background (glow effect).+- Menu / tooltip / dropdown: short duration, `--ease-out` on open, `--ease-in` on close. Use the popover API or `inert` to manage focus.+- Modal: long duration, scale-in (0.96 → 1) + opacity crossfade. Backdrop fades in at the same duration.+- Accordion: animate `grid-template-rows: 0fr` → `grid-template-rows: 1fr` (not `height`). With `--ease-in-out`.++## Reduced motion++```css+@media (prefers-reduced-motion: reduce) {+ *, *::before, *::after {+ animation-duration: 150ms !important;+ animation-iteration-count: 1 !important;+ transition-duration: 150ms !important;+ }+ .reveal { animation: reveal-reduced 150ms linear forwards; }+ @keyframes reveal-reduced { to { opacity: 1; transform: none; } }+}+```++Functional motion (progress bars, loading spinners, skeletons) still runs — just slower.++## Bans++- `ease` (browser default, mediocre).+- `linear` on anything except progress bars and ticking loaders.+- Bounce / elastic / overshoot on UI elements. Dated; signals "template".+- Animating `width`, `height`, `top`, `left`, `margin`, `padding`.+- `will-change` set preemptively across a whole class. Only on the element, only while it's animating.+- Parallax.+- Custom cursors.+- Scroll-driven animations without a reduced-motion fallback.+- Infinite loops (other than functional loaders) — they pull the eye and never let go.diff --git a/skill/references/responsive.md b/skill/references/responsive.mdnew file mode 100644index 0000000..f65652c--- /dev/null+++ b/skill/references/responsive.md@@ -0,0 +1,91 @@+# Responsive++Mobile-first. Content-driven breakpoints. No desktop-only interactions.++## Principles++- Base styles are for the smallest viewport. `min-width` media queries add as you go up. Never `max-width` as the primary direction.+- Breakpoints are where the *content* breaks, not where a device sits. If the headline reflows awkwardly at 720px, that's a breakpoint — regardless of what the Tailwind defaults say.+- Use `pointer` and `hover` media queries instead of width to detect *interaction capability*.++## Breakpoints++Three or four, content-driven. As a default:++```css+@media (min-width: 40rem) { /* ~640px — tablet, small laptop */ }+@media (min-width: 60rem) { /* ~960px — desktop baseline */ }+@media (min-width: 90rem) { /* ~1440px — wide */ }+```++Use `rem` so the breakpoints respect the user's font size.++## Fluid scaling++Prefer `clamp()` for sizes that change continuously; use media queries for layouts that change discretely.++```css+h1 { font-size: clamp(2.5rem, 4vw + 1rem, 6rem); }+.container { padding-inline: clamp(1rem, 4vw, 4rem); }+```++## Pointer and hover queries++```css+@media (hover: hover) and (pointer: fine) {+ .card:hover { transform: translateY(-2px); }+}+@media (pointer: coarse) {+ .btn { min-height: 48px; }+}+```++Never build a mouse-hover interaction that has no touch equivalent.++## Viewport units++- Use `dvh` / `svh` / `lvh` instead of `vh` for heights that interact with mobile chrome.+- Never `width: 100vw`. Use `width: 100%` with padding; `100vw` includes the scrollbar on desktop and causes overflow.++## Safe areas++For iOS notch / Android navigation bars:++```html+<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">+```++```css+body {+ padding-inline: max(1rem, env(safe-area-inset-left));+ padding-bottom: max(1rem, env(safe-area-inset-bottom));+}+```++## Tables on small screens++Tables of data that won't fit: collapse to cards. Use `display: block` on `<tr>` and `data-label` attributes keyed from `<th>`, rendered via `::before`. Or, the better option: redesign the data for small screens — tables are rarely the right mobile representation.++## Images++- `srcset` with width descriptors for responsive sizing.+- `<picture>` for art direction (different crop at different widths).+- `loading="lazy"` on anything below the fold.+- `width` and `height` attributes on every image, always, to avoid CLS.++## Internationalisation++- Reserve 30–40% extra horizontal space for German, Russian, and Finnish translations.+- Use logical properties: `margin-inline-start`, `padding-block`, `border-inline-end`. Not `margin-left` etc. RTL comes for free.+- Don't hard-code language-specific punctuation or date formats.++## Bans++- Desktop-first media queries (`max-width: 768px` as the primary direction).+- `vh` on full-height layouts (use `dvh`).+- `100vw` widths.+- Device-sniffing UA strings instead of feature queries.+- Hover-only interactions.+- Ignoring `prefers-color-scheme` when the app claims to support dark mode.+- Fixed pixel breakpoints that don't respect `rem`.+- Tables of 10+ columns on mobile without a redesign.diff --git a/skill/references/structure.md b/skill/references/structure.mdnew file mode 100644index 0000000..5e4f423--- /dev/null+++ b/skill/references/structure.md@@ -0,0 +1,125 @@+# Structure++Most AI-generated UIs are visually distinct but structurally identical: hero → three features → CTA → footer. Same heading positions, same column counts, same component vocabulary. **Structural sameness is the AI fingerprint, not visual sameness.** Hallmark's job is to break it.++This file catalogues the axes of structural variety. Pick one option from each axis to form a *structural fingerprint*. Two pages should never share the same fingerprint.++## The six axes++### 1. Section-heading placement++Where does a section's title live in space? Pick one per page.++| Pattern | Description | Real-world reference |+| --- | --- | --- |+| **Left-margin** | Eyebrow / number / label sits in a narrow left column; heading and body to the right. Editorial / specimen. | The New York Times Magazine; our Specimen theme. |+| **Hanging** | Heading floats in negative space *above* the section, with generous breathing room. | David Airey's portfolio; minimal modernist. |+| **Centered display** | Heading dominates centre stage, symmetrical. Formal, welcoming, can feel static if used everywhere. | Apple product pages; Atelier-style runway invitations. |+| **Bottom-aligned** | Heading anchors the *base* of a section, content flows above. Inverts hierarchy. | Swiss editorial; Newsprint masthead-below pattern. |+| **Overlapping image** | Heading layered atop photography or colour block. Demands strong contrast. | Pentagram project pages; Manifesto posters. |+| **Sticky / pinned** | Heading remains visible while content scrolls beneath. Orientation aid. | GSAP ScrollTrigger docs; Almanac-style references. |+| **Numbered display** | "01." with a rule line and the heading right beside it. Procedural, sequenced. | Rauno Freiberg's portfolio. |+| **Inline with body** | No section break — the heading emerges from the paragraph flow. Conversational. | Medium articles; long-form essays. |++### 2. Body composition++How does long-form content lay out beyond "single column at 65ch"?++| Pattern | When | Reference |+| --- | --- | --- |+| **Single column** | Narrative-first, reading-led. The default for editorial. | Most blogs. |+| **Two-column asymmetric** | Wide body + narrow margin column for metadata, captions, marginalia. | Semplice; Linen-style. |+| **Multi-column justified** | Newspaper rhythm; 2–3 narrow columns, hyphenated, justified. | The Guardian; FT.com; Newsprint. |+| **Marginalia** | Sidenotes in a generous outer margin run alongside core text. | Tufte CSS; scholarly publications. |+| **Three-column equal** | Encyclopedia / reference / data-density. Chunked, scannable. | Wikipedia; Whole Earth Catalog; Almanac. |+| **Full-bleed with margin reset** | Body at 65ch, but pull-quotes or images bleed full-viewport. Emphasis via scale change. | Medium pull-quotes; Manifesto sections. |+| **Asymmetric spans** | Columns vary widthwise; intentional 2-1-3 ratios via CSS Grid. | Locomotive; portfolio sites. |++### 3. Divider language++How do sections separate?++- **Hairline rule.** 0.5–1px line, inset or full-bleed. Hallmark's default; modernist.+- **Ornament.** Fleuron (`❦`), centered dot, geometric mark. Salon, editorial classic.+- **Negative space.** No rule at all — the gap *is* the divider. Apple, Linen, modern minimalism.+- **Bleed-color block.** Section background colour shifts; the colour edge is the divider. Manifesto, Brutal.+- **Double rule / typographic mark.** Top + bottom line tight together; signals masthead in Newsprint.++### 4. Button voice++How do CTAs happen?++- **Outlined.** Border, no fill. Secondary or quiet primary. Hallmark default.+- **Unstyled link.** Underlined word, no box. Trust the typography. Editorial / craft sites.+- **Oversized solid.** Big block of accent colour, full padding. Manifesto, Sport, statement-CTA.+- **Typographic-only.** A word in a specific weight/size/colour, no rule, no box. Looks like a headline that happens to be clickable. Atelier, Salon.+- **Form-as-CTA.** The button is part of an inline form; the action *is* fill-this-field. Newsletter signups.++### 5. Image treatment++How does imagery enter the page?++- **Full-bleed.** Edge-to-edge, viewport width, image as architecture. Manifesto, Sport.+- **Tightly cropped.** Small, deliberate, sized to grid. Almanac, Atelier still-life.+- **Inline with text.** Image flows within the paragraph rhythm, sized to measure. Editorial, Newsprint.+- **Margin-aligned.** Image sits in the wide outer margin; body unbroken. Linen, Tufte.+- **None.** No imagery; typography carries everything. Specimen, Manifesto-as-text-poster, Terminal.++### 6. Reveal pattern++What happens on page-load and on scroll?++- **Fade-up stagger.** Default. Subtle, broadly safe; orchestrated once with exponential ease-out.+- **Horizontal sweep.** Element slides in from one edge; clip-path or transform. Directional momentum.+- **Type-unmask.** clip-path animates open over text. Graceful when the type is the hero.+- **Number-tick.** Counter from 0 to final value; for stats, prices, dates. Almanac, dashboards.+- **Typewriter.** Character-by-character; honest about the medium. Terminal only.+- **None.** Everything is just there at load. Some sites should not move. Pentagram, brutalist sites.++## Picking a fingerprint++A fingerprint = one choice per axis. There are 8 × 7 × 5 × 5 × 5 × 6 = **42 000** fingerprints. You will never run out.++Two rules govern choices:++1. **Coherence.** A Newsprint page with multi-column justified body should have a typographic CTA, not an oversized solid button — those don't share a voice. Pick choices that belong to the same *world*.+2. **Anti-repetition.** Across consecutive pages built in the same session, no two should share more than three of the six axes. If the previous page used left-margin headings + single column + hairline divider + outlined button, this page should differ on at least three of those.++## Theme-suggested fingerprints++Each Hallmark theme has a default structural fingerprint. Use them as starting points, deviate when the brief demands.++| Theme | Heading | Body | Divider | Button | Image | Reveal |+| --- | --- | --- | --- | --- | --- | --- |+| Specimen | Left-margin | Asymmetric spans | Hairline | Outlined | None | Fade-up |+| Midnight | Numbered display | Single column | Hairline | Typographic-only | None | Typewriter |+| Brutal | Overlapping image | Full-bleed reset | Bleed-colour | Oversized solid | Full-bleed | Horizontal sweep |+| Garden | Hanging | Marginalia | Negative space | Unstyled link | Margin-aligned | None |+| Atelier | Centered | Single column | Negative space | Typographic-only | Tightly cropped | Type-unmask |+| Newsprint | Bottom-aligned | Multi-column justified | Double rule | Outlined | Inline | None |+| Terminal | Inline (with `>` prompt) | Single column | Negative space | Typographic-only `[ go ]` | None | Typewriter |+| Manifesto | Overlapping image | Full-bleed reset | Bleed-colour | Oversized solid | Full-bleed | Horizontal sweep |+| Salon | Centered | Single column narrow | Ornament (fleuron) | Outlined | Tightly cropped | None |+| Linen | Hanging | Two-column asymmetric | Negative space | Unstyled link | Margin-aligned | Fade-up |+| Almanac | Sticky | Three-column equal | Hairline | Outlined | Inline | Number-tick |+| Sport | Numbered display | Asymmetric spans | Bleed-colour | Oversized solid | Full-bleed | Horizontal sweep |++## Anti-patterns of structural sameness++Reject these structural fingerprints. They are the AI-template fingerprint.++- **The SaaS hero.** Centered display heading, centered subhead, centered pill CTA, full-viewport hero, fade-up. The single most-recognised AI structural fingerprint.+- **The 3-feature row.** Three equal columns of icon-above-heading-above-two-line-body, gapped at 24px, identical card padding.+- **The benefits-then-CTA.** A list of feature bullets followed by a "Sign up" button block. Predictable rhythm.+- **The everything-fades-in.** Every section gets the same scroll-triggered fade-up animation. Makes the page feel like a presentation.+- **The carbon-copy footer.** Logo, four columns of links, social row, copyright. The same on every site you've ever seen.++## When you don't know++If the brief doesn't suggest a fingerprint and the user hasn't picked a theme, ask:++> One word for the *feeling* of this page — editorial, brutalist, soft, technical, luxury, austere, playful?++Their answer maps to a theme; the theme maps to a fingerprint. Proceed.++If they answer "modern", "clean", or "professional", say so isn't a feeling and ask again.diff --git a/skill/references/typography.md b/skill/references/typography.mdnew file mode 100644index 0000000..596d860--- /dev/null+++ b/skill/references/typography.md@@ -0,0 +1,92 @@+# Typography++Type carries the design. If the type is wrong, nothing else matters.++## Principles++- A page is a pairing, not a single font. Display face + body face, minimum. *Single-font pages are allowed only when the single font IS the design choice* — a true terminal aesthetic is monospace-everywhere on purpose; a Manifesto poster might be one display face on purpose. The default is a pairing.+- Commit to extremes. Weight 200 next to weight 800 reads as intentional. Weight 400 next to weight 600 reads as a default setting.+- Size steps should be ratios, not increments. Major third (1.25), perfect fourth (1.333), perfect fifth (1.5), or golden (1.618). Pick one and use it.+- Line-height changes with size. Tight for display (1.05–1.2), comfortable for body (1.5–1.65).+- Measure — line length — lives between 45 and 75 characters. Use `max-width: 65ch` as the default.++## Banned defaults++These fonts are on-distribution for every LLM. Do not reach for them without a deliberate reason:++- **Sans-serif:** Inter, Roboto, Open Sans, Lato, Poppins, Source Sans, Nunito, Montserrat, Raleway, Work Sans, DM Sans, system-ui, Arial, Helvetica.+- **Serif:** Merriweather, Playfair Display (as body — banned as overused body serif; ok as display in moderation), Lora, Source Serif, Georgia-as-default.+- **Mono:** Courier New, Consolas-as-default, system mono.++If the user insists on one, do it. Otherwise pick from the allowlist below.++## Pairing patterns that work++| Tone | Display | Body | Mono |+| --- | --- | --- | --- |+| Editorial | Fraunces, Tiempos, Newsreader | Söhne, Haffer, IBM Plex Sans | JetBrains Mono |+| Technical | Söhne Mono, Berkeley Mono | IBM Plex Sans, Inter Display (*not* Inter) | Berkeley Mono |+| Brutalist | Druk, Monument Extended, NaN Jaune | Neue Haas Grotesk, GT America | GT Pressura Mono |+| Luxury | Canela, Tiempos Headline | Suisse Int'l, Söhne | — |+| Playful | Clash Display, Cabinet Grotesk | Satoshi, Plus Jakarta Sans | Space Mono |+| Austere | ABC Diatype, ABC Monument Grotesk | ABC Diatype, Söhne | ABC Diatype Mono |+| Workshop (Hallmark's own) | The Future, Futura, Avenir Next | The Future, Söhne | The Future Mono, Berkeley Mono |++If the project's license budget is zero, free alternatives that are not on-distribution: **Fraunces, Newsreader, Space Grotesk, Plus Jakarta Sans, Bricolage Grotesque, Gabarito, Cabinet Grotesk (via Indian Type Foundry sample), JetBrains Mono, Geist, Geist Mono**.++## Scale++Pick a ratio. The default for Hallmark work is **1.25** (major third). Build the scale from a 16px body, then clamp display sizes for responsive.++```css+:root {+ --text-xs: 0.64rem; /* 10.24px */+ --text-sm: 0.8rem; /* 12.8px */+ --text-base: 1rem; /* 16px */+ --text-md: 1.25rem; /* 20px */+ --text-lg: 1.5625rem; /* 25px */+ --text-xl: 1.9531rem; /* 31.25px */+ --text-2xl: 2.4414rem;+ --text-3xl: 3.0518rem;+ --text-4xl: 3.8147rem;+ --text-display: clamp(3rem, 8vw + 1rem, 8rem);+}+```++Use no more than five sizes on a single page. If you need more hierarchy, use weight and colour, not another size.++## Weights++- Body: one weight (typically 400 or 350). Bold for emphasis only.+- Headings: a weight that contrasts the body by at least 300 units. If body is 400, headings are 700 or 200 — not 500 or 600.+- Never synthesise. Load the weight you need; don't rely on `font-weight: bold` against a single-weight file.++## Required features++- `font-display: swap` on every web font.+- Match fallback metrics with `size-adjust`, `ascent-override`, `descent-override`, `line-gap-override` to prevent CLS.+- Tabular numbers on any data display: `font-variant-numeric: tabular-nums;`.+- Oldstyle figures for body copy where the face supports them: `font-variant-numeric: oldstyle-nums;`.+- Proper typographic punctuation: `" " — … ‘ ’`. Never straight quotes, never `--` or `...`.++## Body text rules++- Minimum 16px. Below 14px is accessibility-hostile.+- Line-height 1.5–1.65 on body copy, tighter (1.1–1.3) on display.+- Measure 45–75 characters (`max-width: 65ch`).+- Never all-caps body copy. Never justified text without hyphenation. Never letter-spacing above 0.05em on body.++## Headings rules++- Tight tracking on display sizes (`letter-spacing: -0.02em` to `-0.04em` depending on the face).+- Loose tracking on small caps / labels (`letter-spacing: 0.08em` to `0.14em`, `text-transform: uppercase`, use small caps if the face has them: `font-variant-caps: all-small-caps;`).+- Skip no levels. `h1` → `h2` → `h3`. Style them visually how you like, but keep semantic order.++## Bans++- No Inter, no Roboto, no Open Sans. No system stack as the *only* stack.+- No gradient text on headings (`background-clip: text` with a gradient fill).+- No single-font pages.+- No all-caps paragraphs.+- No font-size below 14px for body copy, below 10px anywhere.+- No hard-synthesised bold or italic.