@hex-core/themes 0.1.0 → 0.2.0

package/dist/presets/_briefs/vodafone.js

@@ -0,0 +1,429 @@
+// src/presets/_briefs/vodafone.ts
+var vodafoneBrief = `# Design System Inspired by Vodafone
+
+## 1. Visual Theme & Atmosphere
+
+Vodafone's corporate web system carries the confident, broadcast-scale presence of a global telecom brand \u2014 built around a single, fiercely-owned brand red and a restrained, editorial layout that lets imagery and type carry the emotional weight. Every page opens the same way: a cinematic dark hero image behind a towering, tight-tracked uppercase display headline ("EVERYONE. CONNECTED.", "INVESTORS", "OUR BUSINESS") followed by a deep red full-width band that acts as a chapter break, then a crisp white editorial grid or a near-black section reserved for institutional content (share ticker, global map, ESG data). The voice is institutional but human: warm documentary photography \u2014 cable-laying crews, coral reefs, pine forests, urban twilight \u2014 photographed with color-graded realism and set against clean neutral surfaces that never compete with the content.
+
+The typography system is the signature. A custom Vodafone display face runs all the way up to 144px in heavy 800-weight uppercase with negative tracking, and it holds that voice consistently across every page template. Body copy sits in a calm 16-18px mid-weight rhythm. This dual scale \u2014 monumental at the top, almost quiet at the bottom \u2014 creates the "corporate newsroom" feeling: every page reads like the front of a national paper whose masthead happens to be red.
+
+Surface treatment is disciplined and predictable: a three-surface pass of white (editorial canvas) \u2192 Vodafone red (band dividers, CTA buttons, the famous speech-mark logo) \u2192 near-black charcoal (footer, share-ticker panel, global-impact map). There is almost no decorative shadow, almost no gradient, and almost no rounded-corner softness. Edges are small and clinical (2px and 6px), buttons operate as a two-tier system \u2014 tight 2px rectangles for utility/form actions, and fully-rounded 60px pills for primary content CTAs. This is a design system that trusts the brand color to do the heavy lifting and gets out of its way everywhere else.
+
+**Key Characteristics:**
+- Vodafone Red (\`#e60000\`) is the single dominant accent \u2014 used for CTAs, dividers, band sections, the speech-mark logo, and the rotated "IMPACT" brand-mark type on the sustainability map
+- Monumental uppercase display type (up to 144px, weight 800, negative letter-spacing) paired with calm 16-18px body copy
+- A universal page rhythm: dark atmospheric hero \u2192 monumental uppercase headline \u2192 full-width red band \u2192 white editorial canvas \u2192 dark charcoal institutional panel \u2192 charcoal footer
+- Two-tier button system: tight 2px-radius rectangles for utility actions, fully-pill 60px buttons for primary content CTAs (both equally primary, selected by context)
+- Documentary photography (people, infrastructure, cities, nature) dominates over illustration; no stock-icon noise
+- Near-absence of shadows and gradients \u2014 hierarchy comes from type weight, color blocks, and spacing rather than elevation
+- Deep charcoal surface (\`#25282b\`) is reused as the footer AND the institutional data panel (share ticker, world map) \u2014 a single material for anything formal and numeric
+
+## 2. Color Palette & Roles
+
+### Primary
+
+- **Vodafone Red** (\`#e60000\`): The brand's single, non-negotiable signature \u2014 used for primary CTA backgrounds, the speech-mark logo, full-bleed band dividers between editorial sections, tag-pill outlines, and the rotated brand-mark type that labels the global-impact map. This red must never be substituted or tinted; it is the identity.
+
+### Secondary & Accent
+
+- **Pure White** (\`#ffffff\`): The dominant editorial canvas \u2014 page background, card backgrounds, reversed text on dark or red surfaces, and circular icon-button fills.
+- **Signal Blue** (\`#3860be\`): Reserved for inline text links in their resting state (underlined), providing a calm accessible blue that reads clearly against both white and dark surfaces.
+- **Deep Brand Red Shade** (\`#ac1811\`): A darker red appears on quiet label chips (notably on the sustainability page) \u2014 used sparingly for low-prominence tag elements that need red identity without drawing primary attention.
+
+### Surface & Background
+
+- **Canvas White** (\`#ffffff\`): The primary page and card surface. Every editorial module sits on this canvas.
+- **Light Neutral** (\`#f2f2f2\`): Used for filled neutral pill-badge backgrounds and quiet UI chrome where full white would disappear against the canvas.
+- **Charcoal Institutional Panel** (\`#25282b\`): The same color used for text is reused as a full-width dark surface for the footer, the share-ticker panel, and the global-impact map section. It transforms the page into a "data mode" environment.
+- **Translucent White Overlay** (\`rgba(255,255,255,0.1)\`): A soft glass tint used for pill buttons that sit on dark hero imagery \u2014 lets the photo breathe through the button.
+
+### Neutrals & Text
+
+- **Charcoal Headline** (\`#25282b\`): All heading text on light surfaces and the charcoal surface color itself \u2014 a near-black with a faint cool tint, never pure black.
+- **Secondary Body Grey** (\`#7e7e7e\`): Body copy, meta text, and secondary labels \u2014 a true mid-grey that reads as unemphatic but still legible.
+- **Form Text Grey** (\`#333333\`): Borders on input-style ghost buttons and the text color inside them.
+- **Disabled Grey** (\`#bebebe\`): Inactive chip text on subtle ghost-style controls.
+- **Translucent White Divider** (\`rgba(255,255,255,0.25)\`): Hairline column dividers on dark institutional panels (footer columns, map legend rows).
+
+### Semantic & Accent
+
+- **Surface Red Band** (\`#e60000\`): The same brand red deployed as a full-width band between editorial sections \u2014 functions as a chapter divider and a visual amplifier for the brand. Appears on every page template.
+- **Tag Pill Red Border** (\`#e60000\`): 1px outline on light tag pills, letting the brand color touch small UI without drowning card content.
+
+### Gradient System
+
+Vodafone's design is intentionally gradient-free. The only tonal variation is a subtle photographic vignette on hero imagery (dim coral reefs, pine forests, cable-laying crews, urban twilight), where the image itself \u2014 not a CSS gradient \u2014 provides the tonal ramp. No linear gradients are used on buttons, cards, or surfaces.
+
+## 3. Typography Rules
+
+### Font Family
+
+- **Primary**: \`Vodafone\` (custom corporate sans-serif)
+- **Fallback stack**: \`Vodafone, "Helvetica Neue", Arial, sans-serif\`
+- **Icon font**: \`icomoon\` \u2014 carries pictograph glyphs at 18px/24px/48px fixed sizes
+- **Rendering**: \`font-smoothing: antialiased\` across the board; OpenType features are not aggressively used \u2014 the design relies on weight and tracking, not stylistic alternates
+
+### Hierarchy
+
+| Role | Size | Weight | Line Height | Letter Spacing | Notes |
+|------|------|--------|-------------|----------------|-------|
+| Display / Hero XL | 144px | 800 | 0.79 | -1px | Uppercase; the signature "EVERYONE. CONNECTED." treatment |
+| Display / Hero L | 126px | 800 | 0.90 | -1px | Uppercase; used when the hero headline is longer |
+| Display / Hero M | 90px | 800 | 0.93 | \u2014 | Uppercase; secondary hero or full-bleed section heads |
+| Display / Impact | 70px | 800 | 1.17 | -1px | Sustainability section numeric / callout scale |
+| H1 \u2014 Light | 48px | 300 | 1.08 | \u2014 | Section headlines set in light weight for editorial calm |
+| H1 \u2014 Bold | 48px | 800 | 1.00 | -1px | Institutional data headers (share price on charcoal panel) |
+| H2 \u2014 Light | 40px | 300 | 1.10 | \u2014 | Sub-section headers |
+| H2 \u2014 Bold | 40px | 700 | 1.10 | \u2014 | Denser sub-section headers |
+| H3 \u2014 Bold | 32px | 700 | 1.25 | \u2014 | Card cluster titles and feature intros |
+| H4 \u2014 Bold | 24px | 700 | 1.00 | \u2014 | Card titles (news, feature, article modules) |
+| H4 \u2014 Light | 24px | 300 | 1.42 | \u2014 | Intro paragraphs on investor / sustainability pages |
+| H5 \u2014 Bold | 20px | 700 | 1.30 | \u2014 | Compact module titles and side callouts |
+| Lead Body | 20px | 400 | 1.40 | \u2014 | Introductory paragraphs under large headlines |
+| Body Large | 18px | 400 | 1.56 | \u2014 | Long-form article body and prominent copy |
+| Body Bold | 18px | 600 | 1.56 | \u2014 | Emphasized inline phrases |
+| Body Base | 16px | 400 | 1.38 | \u2014 | Default paragraph size |
+| Label Uppercase | 16px | 800 | 1.50 | \u2014 | Uppercase navigational labels |
+| Eyebrow / Date | 14px | 400/700 | 1.43 | \u2014 | Article date stamps and meta (14 APR 2026) |
+| Tag Pill | 14px | 700 | 1.50 | \u2014 | Badge text inside red-outlined pills |
+| Caption Uppercase | 14px | 400 | 1.14 | \u2014 | Uppercase meta label |
+| Caption | 12px | 500 | 2.00 | \u2014 | Footer meta, legal lines |
+| Micro Label | 12px | 600 | 1.33 | \u2014 | Uppercase tiny labels on badges and counters |
+| Button Primary | 14.4px | 700 | 1.00 | 0.144px | Primary filled button label |
+| Button Compact | 12px | 700 | 1.00 | 0.12px | Compact button label |
+
+### Principles
+
+- **Dual-scale drama**: the system deliberately stretches from 144px down to 8.5px without mid-range showing off. The result is a clear corporate hierarchy \u2014 monumental for brand moments, calm for reading.
+- **Uppercase display, mixed-case body**: all the largest display sizes are uppercase with negative tracking, while everything 48px and below is sentence case with normal tracking.
+- **Weight spread**: only three real weights do the work \u2014 800 (display), 700 (bold bodies, buttons, tags), and 400 (reading body). A lighter 300-weight is used for editorial-style 40px/48px headlines when a calmer voice is wanted.
+- **No italics, no decorative letterspacing on body**: the body system is deliberately neutral so the display work can shout.
+- **Rotated brand-mark type**: on the sustainability section, the word "IMPACT" is set in brand red at a large display size and rotated 90\xB0 to run vertically along the edge of a dark world-map panel \u2014 a distinctive typographic flourish that the template uses to label its institutional data surfaces.
+
+### Note on Font Substitutes
+
+The Vodafone corporate typeface is proprietary. When recreating the look in open systems, substitute with **Inter** at weights 400/600/800, or **Neue Haas Grotesk** if available. Inter needs its letter-spacing reduced by roughly 1-2% at display sizes (80px+) to approximate the Vodafone face's tight tracking; its line-height should be set to 0.85-0.95 for the uppercase display tier.
+
+## 4. Component Stylings
+
+### Buttons
+
+Vodafone operates a genuine two-tier primary button system. Both tiers are used as primary calls to action \u2014 the difference is context (form/chrome vs editorial/content), not hierarchy.
+
+**Primary Red Rectangle** (utility / form CTA \u2014 "Accept All Cookies", "Subscribe")
+- Background: Vodafone Red (\`#e60000\`)
+- Text: Pure White (\`#ffffff\`), 14.4px, weight 700, letter-spacing 0.144px
+- Padding: 12px vertical, 10px horizontal
+- Border: 1px solid Vodafone Red (\`#e60000\`)
+- Border radius: 2px \u2014 deliberately sharp-cornered
+- Default state: solid red fill with crisp 2px corners
+- Active state: brief opacity drop to \`0.9\` on press
+
+**Primary Red Pill** (editorial / content CTA \u2014 "Link to Our approach to ESG", "EXPLORE CONNECTING PEOPLE")
+- Background: Vodafone Red (\`#e60000\`)
+- Text: Pure White (\`#ffffff\`), 14.4px, weight 700, letter-spacing 0.144px
+- Padding: 16px uniform
+- Border radius: 60px \u2014 fully pill-shaped
+- Default state: solid red fill with rounded ends
+- Active state: brief opacity drop to \`0.9\` on press
+
+**Ghost White Rectangle** (secondary form action)
+- Background: Pure White (\`#ffffff\`)
+- Text: Form Text Grey (\`#333333\`), 14.4px, weight 700
+- Padding: 12px vertical, 10px horizontal
+- Border: 1px solid Form Text Grey (\`#333333\`)
+- Border radius: 2px
+- Default state: white fill with charcoal outline
+- Active state: opacity \`0.9\` on press
+
+**Glass Pill** (sits on dark hero imagery \u2014 secondary content CTA)
+- Background: Pure White at 10% opacity (\`rgba(255,255,255,0.1)\`)
+- Text: Pure White (\`#ffffff\`), weight 700
+- Padding: 8px vertical, 16px horizontal
+- Border radius: 24px \u2014 fully pill-shaped
+- Default state: soft translucent pill lets the photo breathe through
+
+**Content Ghost Pill** (inline within editorial cards \u2014 low-emphasis content CTA)
+- Background: Black at 5% opacity (\`rgba(0,0,0,0.05)\`)
+- Text: Vodafone Red (\`#e60000\`), 14.4px, weight 700
+- Padding: 15px uniform
+- Border radius: 60px \u2014 fully pill-shaped
+- Default state: nearly transparent pill with red text
+
+**Icon Control Button** (video play/pause, carousel arrows, close)
+- Background: Pure White (\`#ffffff\`)
+- Icon color: Charcoal Headline (\`#25282b\`)
+- Border radius: 50% \u2014 perfect circle
+- Outline: 1px solid white, used for focus indication
+- Size: typically 32-40px diameter
+
+### Cards & Containers
+
+**News / Editorial Card** (homepage article tile)
+- Background: Pure White (\`#ffffff\`)
+- Border radius: 6px (applied to image corners and card container)
+- Shadow: none \u2014 cards rely on spacing and the image aspect ratio for separation
+- Internal layout: 16:9 image on top \u2192 12px gap \u2192 eyebrow row (date + tag pill) \u2192 8px gap \u2192 H4 Bold title \u2192 16px card padding on sides and bottom
+- The card image uses \`object-fit: cover\` and rounded top corners (6px top-left/top-right)
+
+**Asymmetric Corner Card** (featured homepage cards)
+- Background: Pure White (\`#ffffff\`)
+- Border radius: \`0px 6px 0px 0px\` \u2014 a deliberate single-corner-rounded shape that echoes the Vodafone speech-mark logo's curved geometry
+- No shadow, no border \u2014 the asymmetric radius itself is the visual signature
+
+**Circular Portrait / Pictogram Container** (sustainability page)
+- Background: Pure White (\`#ffffff\`)
+- Border radius: 100% \u2014 perfect circle
+- Used for ESG pictograms and executive portraits inside the institutional content area
+
+### Inputs & Forms
+
+Vodafone's corporate site does not expose many inline form controls on the homepage, but button-style inputs follow these rules:
+
+- Background: Pure White (\`#ffffff\`)
+- Text: Form Text Grey (\`#333333\`), 16px, weight 400
+- Border: 1px solid Form Text Grey (\`#333333\`)
+- Border radius: 2px
+- Padding: 12px 10px
+- Error state (when shown): the 1px border shifts to Vodafone Red (\`#e60000\`) and error message text inherits the same red at 12px weight 600
+
+### Navigation
+
+**Top bar**
+- Background: transparent over hero imagery; solid white (\`#ffffff\`) on scroll or interior pages
+- Height: approximately 64px desktop, 56px mobile
+- Logo: Vodafone speech-mark, 40\xD740px red circle with a white "speech-mark" cut-out, left-aligned
+- Nav links: 16px weight 400 Charcoal Headline (\`#25282b\`) on white; reversed to white when sitting on dark hero imagery
+- Right-side utility: small icon links (search, locale, menu) rendered as 24px icomoon glyphs
+- On interior pages (Investors, Sustainable Business), the top bar shows additional secondary-nav row: "Vodafone Business / Vodafone Foundation / Our site" labels, aligned right
+
+**Mobile collapse**
+- At approximately 768px the horizontal nav collapses into a hamburger
+- Mobile menu opens as a full-width overlay with white surface, 18px weight 400 link rows, 16px vertical padding per row
+
+### Image Treatment
+
+- **Hero images**: full-bleed, dark atmospheric photography (coral reefs, pine forests, cable crews, urban twilight) with a natural vignette or cool-tone color grade \u2014 no CSS overlay is needed because the imagery itself is pre-graded
+- **Card thumbnails**: 16:9 aspect ratio, 6px top corner radius matching the card
+- **Square editorial images**: 1:1 ratio used in feature modules, always 6px corner radius
+- **Round portraits**: 100% (perfect circle) for executive headshots and ESG pictograms
+- **Loading**: lazy-loading triggers on scroll; images stabilize within ~200ms of entering the viewport
+- **No decorative borders on images** \u2014 the card radius does all the framing work
+
+### Tag Pills / Badges
+
+Two distinct pill styles appear:
+
+**Outlined Red Pill** (used inline on article card metadata, e.g., "EMPOWERING PEOPLE")
+- Background: Pure White at 80% opacity (\`rgba(255,255,255,0.8)\`)
+- Text: Near-black at 80% opacity (\`rgba(0,0,0,0.8)\`), 12px, weight 600, uppercase
+- Border: 1px solid Vodafone Red (\`#e60000\`)
+- Padding: 6px
+- Border radius: small-rounded (roughly 2px)
+
+**Filled Neutral Pill** (quieter tags)
+- Background: Light Neutral (\`#f2f2f2\`)
+- Text: Charcoal Headline (\`#25282b\`), 14px, weight 700
+- Padding: 4px 12px
+- Border radius: 32px \u2014 fully pill-shaped
+
+### Red Divider Band
+
+A signature reusable component that appears on every page template: a full-width band of Vodafone Red (\`#e60000\`) that runs horizontally across the page to separate the monumental hero from the editorial body beneath it. It carries no text and no controls \u2014 it simply is the brand's way of saying "new chapter." Typical height: 40-80px.
+
+### Share Ticker Panel (Investor pages)
+
+A distinctive institutional component that anchors the investor template:
+- Background: Charcoal Institutional Panel (\`#25282b\`)
+- Large numeric display: share price set in 48px weight 800 white type with negative letter-spacing (e.g., "116.05 GBX")
+- Metadata row: delay notice (e.g., "15-min delayed") and timestamp in 14px weight 400 secondary grey text
+- Layout: sits as a horizontal strip above the footer, spans the full content width
+- Hairline dividers (\`rgba(255,255,255,0.25)\`) separate the ticker from the footer columns
+
+### Global Impact Map Panel (Sustainability pages)
+
+A signature reusable component that anchors the sustainability template:
+- Background: Charcoal Institutional Panel (\`#25282b\`)
+- A dark minimal world-map illustration in slightly lighter grey
+- Red circular markers (\`#e60000\`) plotted on geographic locations where the brand operates
+- Vertically-rotated brand word "IMPACT" set in Vodafone Red at large display size (weight 800, uppercase, 90\xB0 rotated) running along one edge of the panel \u2014 this is the template's signature typographic move
+- Small legend with red markers and white uppercase labels at the top-left
+
+### Footer
+
+A universal component across all page templates:
+- Background: Charcoal Institutional Panel (\`#25282b\`)
+- Layout: 4-column link grid (Our company / Investors / Vodafone websites / Share price) followed by a "Connect with us" social row and legal/privacy line
+- Logo: red speech-mark repeats bottom-right at 32-40px
+- Column header type: 16px weight 800 uppercase white
+- Column link type: 14px weight 400 white, stacked vertically with 12px row spacing
+- Divider hairlines: \`rgba(255,255,255,0.25)\` between column group and legal row
+
+## 5. Layout Principles
+
+### Spacing System
+
+Base unit: **8px**. The scale accommodates both tight UI (1px, 2px, 4px) and generous editorial rhythm (16px, 20px, 24px, 32px). Two values (\`32px\` and \`38px\`) appear across every page in the analysis, making them the template's universal rhythm constants.
+
+| Token | Value | Typical Use |
+|-------|-------|-------------|
+| 2xs | 2px | Hairline separators |
+| xs | 4px | Icon-to-text gap in tight controls |
+| sm | 8px | Base rhythm unit |
+| md | 12px | Card internal padding, eyebrow-to-title gap |
+| base | 16px | Paragraph rhythm, card padding, pill button padding |
+| lg | 20px | Section-internal spacing |
+| xl | 24px | Card-to-card spacing, column gutters |
+| 2xl | 32px | Section intro-to-content breaks \u2014 universal constant |
+| 3xl | 38px | Band-to-next-section vertical push \u2014 universal constant |
+| section | 64-96px | Vertical rhythm between major editorial modules |
+
+### Grid & Container
+
+- **Max content width**: approximately 1440px on very large screens; articles and hero modules typically sit at 1200px
+- **Column pattern on cards**: 3-up or 4-up card grid at desktop (1200-1440px), 2-up at tablet (768-1024px), stacked 1-up at mobile (<768px)
+- **Horizontal padding**: 32px at desktop edge, 20px at tablet, 16px at mobile
+- **Gutters between cards**: 24px desktop, 16px mobile
+- **Institutional panel (share ticker, world map, footer)**: always full-bleed edge-to-edge at every breakpoint
+
+### Whitespace Philosophy
+
+Vodafone's editorial canvas leans generous \u2014 whitespace is used as a visual palette cleanser between a monumental headline and the card grid or data panel that follows. Sections are separated by tall vertical rhythm (64-96px) plus the occasional red band that acts as both a separator and a brand signal. Within cards, spacing is tight and efficient (12-16px) so the photography can take the stage.
+
+### Border Radius Scale
+
+| Token | Value | Typical Use |
+|-------|-------|-------------|
+| hairline | 1px | Inline text wraps, small badges |
+| button-tight | 2px | Primary and secondary rectangle button corners \u2014 the brand's utility-form look |
+| card | 6px | News cards, images, input fields |
+| asymmetric | \`0px 6px 0px 0px\` | Featured cards (top-right corner only) |
+| glass-pill | 24px | Translucent white pills sitting on dark hero imagery |
+| badge-pill | 32px | Filled neutral pill badges |
+| cta-pill | 60px | Primary red content CTAs \u2014 the brand's editorial button look |
+| circle | 50% | Icon buttons, carousel arrows, close controls |
+| portrait | 100% | Circular portraits and ESG pictograms |
+
+## 6. Depth & Elevation
+
+Vodafone's system is deliberately flat. There is almost no conventional box-shadow in the UI. Hierarchy is carried by color (red bands, charcoal institutional panels), typography weight (800 vs 400), and spacing.
+
+| Level | Treatment | Use |
+|-------|-----------|-----|
+| 0 \u2014 Surface | No shadow, no border | Default card, default section |
+| 1 \u2014 Outline | 1px solid border at low-opacity | Ghost buttons, outlined pills |
+| 2 \u2014 Inset Highlight | \`inset 0 0 0 1px\` on focus | Pressed / focused controls |
+| 3 \u2014 Photographic depth | The photography itself carries the depth | Hero imagery |
+| 4 \u2014 Surface shift | Charcoal institutional panel below a white editorial canvas | Share ticker / world map / footer |
+
+Shadow philosophy: Vodafone treats drop shadows as a distraction from brand clarity. The few extracted shadow tokens are reserved for inset focus rings. The dominant "elevation" in the system is a **color surface shift** \u2014 switching from the white editorial canvas to the charcoal institutional panel \u2014 rather than a lift-off drop shadow.
+
+### Decorative Depth
+
+The only decorative depth cues are:
+- Atmospheric dark hero photography that carries its own cinematic tonal depth (no CSS overlay needed)
+- The rotated vertical "IMPACT" wordmark on the sustainability map, which creates the illusion of a fourth wall alongside the map panel
+
+## 7. Do's and Don'ts
+
+### Do
+
+- Use Vodafone Red (\`#e60000\`) as the single loudest element on any screen \u2014 one primary CTA per fold, one red band per editorial break
+- Set display headlines in uppercase 800-weight with tight negative tracking; let them run to 90-144px on desktop
+- Pair monumental display type with calm 16-18px body copy \u2014 the scale jump is the system
+- Switch the button radius based on context: 2px rectangles for form and utility actions, 60px pills for editorial content CTAs
+- Let documentary photography breathe at 16:9 or 1:1 on a 6px radius \u2014 no decorative borders, no heavy overlays
+- Use the red band as a full-width chapter divider between every hero and the content below it
+- Anchor every page with a charcoal institutional surface (\`#25282b\`) \u2014 the footer always, and on investor/sustainability pages extend the same color up to include the share ticker or the global-impact map
+- Respect the universal page rhythm: dark hero \u2192 red band \u2192 white editorial \u2192 charcoal institutional \u2192 charcoal footer
+
+### Don't
+
+- Don't introduce a second brand hue to rival Vodafone Red \u2014 no teals, no purples, no orange accents
+- Don't soften rectangle button corners beyond 2px, and don't shrink pill button corners below 60px \u2014 the two shapes are both load-bearing
+- Don't add drop shadows to cards or buttons \u2014 the system is intentionally flat and uses surface color to carry elevation
+- Don't use gradients on backgrounds, buttons, or text
+- Don't mix uppercase tracking on body text \u2014 uppercase is reserved for display, labels, and micro-labels
+- Don't use italics for emphasis \u2014 use weight 600/700 instead
+- Don't decorate headlines with colored underlines or highlights \u2014 the type does the work
+- Don't use pure black (\`#000000\`) for text or surfaces \u2014 always use Charcoal Headline (\`#25282b\`)
+
+## 8. Responsive Behavior
+
+### Breakpoints
+
+The practical tiers observed across all three templates:
+
+| Name | Width | Key Changes |
+|------|-------|-------------|
+| Mobile | \u2264 600px | Nav collapses to hamburger; hero display drops to ~56-72px; cards stack 1-up |
+| Mobile Large | 601-767px | Hero display ~72-90px; cards still stack 1-up |
+| Tablet | 768-1023px | Nav re-expands; cards grid 2-up; hero display ~90-120px |
+| Laptop | 1024-1199px | Full nav; cards 3-up; hero display ~120-144px |
+| Desktop | 1200-1439px | Standard editorial layout; cards 3-up or 4-up |
+| Wide | \u2265 1440px | Content caps at 1440px; outer canvas padding grows |
+
+### Touch Targets
+
+All interactive controls meet a 44\xD744px minimum on mobile. Icon buttons use 40\xD740px circular hit areas which expand with 4px invisible padding on touch devices. Primary CTA buttons land at approximately 48\xD748px on mobile (16px top/bottom + text line for pills; 12px + text line for rectangles).
+
+### Collapsing Strategy
+
+- **Nav**: horizontal links collapse into a hamburger at 768px; the logo stays left-aligned at all widths
+- **Card grid**: 4-up \u2192 3-up at 1200px \u2192 2-up at 768px \u2192 1-up at 600px, with gutters shrinking from 24px to 16px
+- **Hero display type**: step-reduces through 144 \u2192 126 \u2192 90 \u2192 72 \u2192 56px as viewports shrink
+- **Section padding**: 96px vertical at desktop, 64px at tablet, 48px at mobile
+- **Red divider bands**: remain full-width at every breakpoint; their vertical height compresses from ~80px at desktop to ~40px at mobile
+- **Institutional panels (share ticker / world map)**: on mobile, multi-column content restacks into a single vertical stream but the charcoal surface stays edge-to-edge
+- **Vertically-rotated "IMPACT" wordmark**: becomes a horizontal label or is dropped entirely on mobile where vertical space is limited
+
+### Image Behavior
+
+- Hero imagery: art-directed variant at mobile (tighter crop) versus desktop (wide atmospheric frame)
+- Card thumbnails: always 16:9 regardless of viewport; \`loading="lazy"\` is standard
+- Circular portraits: fixed at 80-120px diameter on desktop, shrinking to 64-80px on mobile
+- Logo: fixed at 40\xD740px across breakpoints (consistent brand mark size)
+
+## 9. Agent Prompt Guide
+
+### Quick Color Reference
+
+- Primary CTA: "Vodafone Red (\`#e60000\`)"
+- Background: "Canvas White (\`#ffffff\`)"
+- Heading text: "Charcoal Headline (\`#25282b\`)"
+- Body text: "Secondary Body Grey (\`#7e7e7e\`)"
+- Institutional surface: "Charcoal Institutional Panel (\`#25282b\`)"
+- Inline link: "Signal Blue (\`#3860be\`)"
+- Quiet pill background: "Light Neutral (\`#f2f2f2\`)"
+
+### Example Component Prompts
+
+- "Create a primary red rectangle button: Vodafone Red (\`#e60000\`) background, pure white 14.4px weight 700 text, 2px border radius (sharp corners), 12px vertical \xD7 10px horizontal padding. Use for form and utility actions. No shadow, no gradient."
+- "Create a primary red pill CTA: Vodafone Red (\`#e60000\`) background, pure white 14.4px weight 700 text, 60px border radius (fully pill-shaped), 16px uniform padding. Use for editorial content calls-to-action."
+- "Design an editorial news card: white background, 6px border radius, 16:9 image at the top, 12px eyebrow row containing a date and a red-outlined uppercase tag pill, then a 24px weight 700 Charcoal title. No shadow \u2014 spacing alone separates cards."
+- "Build a hero section: dark atmospheric photo as the full-bleed background, monumental uppercase headline at 144px weight 800 with -1px letter-spacing, single Vodafone Red pill CTA beneath it, no overlay gradient."
+- "Create a red divider band: full-width strip of Vodafone Red (\`#e60000\`), 64px tall on desktop and 40px on mobile, no text, no controls \u2014 it acts purely as a visual chapter break between editorial sections."
+- "Design an institutional data panel: full-bleed Charcoal Institutional Panel (\`#25282b\`) background, large numeric display at 48px weight 800 white with negative letter-spacing, 14px weight 400 grey meta row beneath. Use for share ticker or stats callout."
+- "Design a global impact map: Charcoal Institutional Panel (\`#25282b\`) background, minimal grey world-map illustration, red Vodafone-red circular markers on operational locations, the brand word 'IMPACT' set at large display size in brand red and rotated 90\xB0 to run vertically along one edge."
+
+### Iteration Guide
+
+When refining existing screens generated with this design system:
+
+1. Focus on ONE component at a time \u2014 the system has few moving parts, so small refinements compound
+2. Reference specific color names and hex codes from this document when describing changes
+3. Use natural language ("sharper corners," "more generous vertical rhythm") alongside specific measurements
+4. When in doubt about radius, remember: 2px for form/utility buttons, 60px for editorial pills, 6px for cards, 50%/100% for icon and portrait circles
+5. Keep the brand rule absolute: only one Vodafone Red element should dominate any given fold
+
+### Known Gaps
+
+- Form input styles (text fields, dropdowns, toggles) are not exposed on these page templates; their specs are inferred from the ghost-button pattern and may need refinement when real forms are designed
+- The Vodafone corporate typeface is proprietary and cannot be reproduced exactly in open systems; Inter with tightened tracking at display sizes is the closest open substitute
+- Animation and transition timings are intentionally not documented \u2014 the site uses them sparingly and the values are not extractable from static analysis
+- The share ticker's exact number styling (separators, currency glyph) is documented from the investor-page screenshot; other regional variants may display differently
+`;
+export {
+  vodafoneBrief
+};
+//# sourceMappingURL=vodafone.js.map

package/dist/presets/_briefs/vodafone.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/presets/_briefs/vodafone.ts"],"sourcesContent":["// AUTO-GENERATED — do not hand-edit. Source: https://github.com/voltagent/awesome-design-md\nexport const vodafoneBrief = `# Design System Inspired by Vodafone\n\n## 1. Visual Theme & Atmosphere\n\nVodafone's corporate web system carries the confident, broadcast-scale presence of a global telecom brand — built around a single, fiercely-owned brand red and a restrained, editorial layout that lets imagery and type carry the emotional weight. Every page opens the same way: a cinematic dark hero image behind a towering, tight-tracked uppercase display headline (\"EVERYONE. CONNECTED.\", \"INVESTORS\", \"OUR BUSINESS\") followed by a deep red full-width band that acts as a chapter break, then a crisp white editorial grid or a near-black section reserved for institutional content (share ticker, global map, ESG data). The voice is institutional but human: warm documentary photography — cable-laying crews, coral reefs, pine forests, urban twilight — photographed with color-graded realism and set against clean neutral surfaces that never compete with the content.\n\nThe typography system is the signature. A custom Vodafone display face runs all the way up to 144px in heavy 800-weight uppercase with negative tracking, and it holds that voice consistently across every page template. Body copy sits in a calm 16-18px mid-weight rhythm. This dual scale — monumental at the top, almost quiet at the bottom — creates the \"corporate newsroom\" feeling: every page reads like the front of a national paper whose masthead happens to be red.\n\nSurface treatment is disciplined and predictable: a three-surface pass of white (editorial canvas) → Vodafone red (band dividers, CTA buttons, the famous speech-mark logo) → near-black charcoal (footer, share-ticker panel, global-impact map). There is almost no decorative shadow, almost no gradient, and almost no rounded-corner softness. Edges are small and clinical (2px and 6px), buttons operate as a two-tier system — tight 2px rectangles for utility/form actions, and fully-rounded 60px pills for primary content CTAs. This is a design system that trusts the brand color to do the heavy lifting and gets out of its way everywhere else.\n\n**Key Characteristics:**\n- Vodafone Red (\\`#e60000\\`) is the single dominant accent — used for CTAs, dividers, band sections, the speech-mark logo, and the rotated \"IMPACT\" brand-mark type on the sustainability map\n- Monumental uppercase display type (up to 144px, weight 800, negative letter-spacing) paired with calm 16-18px body copy\n- A universal page rhythm: dark atmospheric hero → monumental uppercase headline → full-width red band → white editorial canvas → dark charcoal institutional panel → charcoal footer\n- Two-tier button system: tight 2px-radius rectangles for utility actions, fully-pill 60px buttons for primary content CTAs (both equally primary, selected by context)\n- Documentary photography (people, infrastructure, cities, nature) dominates over illustration; no stock-icon noise\n- Near-absence of shadows and gradients — hierarchy comes from type weight, color blocks, and spacing rather than elevation\n- Deep charcoal surface (\\`#25282b\\`) is reused as the footer AND the institutional data panel (share ticker, world map) — a single material for anything formal and numeric\n\n## 2. Color Palette & Roles\n\n### Primary\n\n- **Vodafone Red** (\\`#e60000\\`): The brand's single, non-negotiable signature — used for primary CTA backgrounds, the speech-mark logo, full-bleed band dividers between editorial sections, tag-pill outlines, and the rotated brand-mark type that labels the global-impact map. This red must never be substituted or tinted; it is the identity.\n\n### Secondary & Accent\n\n- **Pure White** (\\`#ffffff\\`): The dominant editorial canvas — page background, card backgrounds, reversed text on dark or red surfaces, and circular icon-button fills.\n- **Signal Blue** (\\`#3860be\\`): Reserved for inline text links in their resting state (underlined), providing a calm accessible blue that reads clearly against both white and dark surfaces.\n- **Deep Brand Red Shade** (\\`#ac1811\\`): A darker red appears on quiet label chips (notably on the sustainability page) — used sparingly for low-prominence tag elements that need red identity without drawing primary attention.\n\n### Surface & Background\n\n- **Canvas White** (\\`#ffffff\\`): The primary page and card surface. Every editorial module sits on this canvas.\n- **Light Neutral** (\\`#f2f2f2\\`): Used for filled neutral pill-badge backgrounds and quiet UI chrome where full white would disappear against the canvas.\n- **Charcoal Institutional Panel** (\\`#25282b\\`): The same color used for text is reused as a full-width dark surface for the footer, the share-ticker panel, and the global-impact map section. It transforms the page into a \"data mode\" environment.\n- **Translucent White Overlay** (\\`rgba(255,255,255,0.1)\\`): A soft glass tint used for pill buttons that sit on dark hero imagery — lets the photo breathe through the button.\n\n### Neutrals & Text\n\n- **Charcoal Headline** (\\`#25282b\\`): All heading text on light surfaces and the charcoal surface color itself — a near-black with a faint cool tint, never pure black.\n- **Secondary Body Grey** (\\`#7e7e7e\\`): Body copy, meta text, and secondary labels — a true mid-grey that reads as unemphatic but still legible.\n- **Form Text Grey** (\\`#333333\\`): Borders on input-style ghost buttons and the text color inside them.\n- **Disabled Grey** (\\`#bebebe\\`): Inactive chip text on subtle ghost-style controls.\n- **Translucent White Divider** (\\`rgba(255,255,255,0.25)\\`): Hairline column dividers on dark institutional panels (footer columns, map legend rows).\n\n### Semantic & Accent\n\n- **Surface Red Band** (\\`#e60000\\`): The same brand red deployed as a full-width band between editorial sections — functions as a chapter divider and a visual amplifier for the brand. Appears on every page template.\n- **Tag Pill Red Border** (\\`#e60000\\`): 1px outline on light tag pills, letting the brand color touch small UI without drowning card content.\n\n### Gradient System\n\nVodafone's design is intentionally gradient-free. The only tonal variation is a subtle photographic vignette on hero imagery (dim coral reefs, pine forests, cable-laying crews, urban twilight), where the image itself — not a CSS gradient — provides the tonal ramp. No linear gradients are used on buttons, cards, or surfaces.\n\n## 3. Typography Rules\n\n### Font Family\n\n- **Primary**: \\`Vodafone\\` (custom corporate sans-serif)\n- **Fallback stack**: \\`Vodafone, \"Helvetica Neue\", Arial, sans-serif\\`\n- **Icon font**: \\`icomoon\\` — carries pictograph glyphs at 18px/24px/48px fixed sizes\n- **Rendering**: \\`font-smoothing: antialiased\\` across the board; OpenType features are not aggressively used — the design relies on weight and tracking, not stylistic alternates\n\n### Hierarchy\n\n| Role | Size | Weight | Line Height | Letter Spacing | Notes |\n|------|------|--------|-------------|----------------|-------|\n| Display / Hero XL | 144px | 800 | 0.79 | -1px | Uppercase; the signature \"EVERYONE. CONNECTED.\" treatment |\n| Display / Hero L | 126px | 800 | 0.90 | -1px | Uppercase; used when the hero headline is longer |\n| Display / Hero M | 90px | 800 | 0.93 | — | Uppercase; secondary hero or full-bleed section heads |\n| Display / Impact | 70px | 800 | 1.17 | -1px | Sustainability section numeric / callout scale |\n| H1 — Light | 48px | 300 | 1.08 | — | Section headlines set in light weight for editorial calm |\n| H1 — Bold | 48px | 800 | 1.00 | -1px | Institutional data headers (share price on charcoal panel) |\n| H2 — Light | 40px | 300 | 1.10 | — | Sub-section headers |\n| H2 — Bold | 40px | 700 | 1.10 | — | Denser sub-section headers |\n| H3 — Bold | 32px | 700 | 1.25 | — | Card cluster titles and feature intros |\n| H4 — Bold | 24px | 700 | 1.00 | — | Card titles (news, feature, article modules) |\n| H4 — Light | 24px | 300 | 1.42 | — | Intro paragraphs on investor / sustainability pages |\n| H5 — Bold | 20px | 700 | 1.30 | — | Compact module titles and side callouts |\n| Lead Body | 20px | 400 | 1.40 | — | Introductory paragraphs under large headlines |\n| Body Large | 18px | 400 | 1.56 | — | Long-form article body and prominent copy |\n| Body Bold | 18px | 600 | 1.56 | — | Emphasized inline phrases |\n| Body Base | 16px | 400 | 1.38 | — | Default paragraph size |\n| Label Uppercase | 16px | 800 | 1.50 | — | Uppercase navigational labels |\n| Eyebrow / Date | 14px | 400/700 | 1.43 | — | Article date stamps and meta (14 APR 2026) |\n| Tag Pill | 14px | 700 | 1.50 | — | Badge text inside red-outlined pills |\n| Caption Uppercase | 14px | 400 | 1.14 | — | Uppercase meta label |\n| Caption | 12px | 500 | 2.00 | — | Footer meta, legal lines |\n| Micro Label | 12px | 600 | 1.33 | — | Uppercase tiny labels on badges and counters |\n| Button Primary | 14.4px | 700 | 1.00 | 0.144px | Primary filled button label |\n| Button Compact | 12px | 700 | 1.00 | 0.12px | Compact button label |\n\n### Principles\n\n- **Dual-scale drama**: the system deliberately stretches from 144px down to 8.5px without mid-range showing off. The result is a clear corporate hierarchy — monumental for brand moments, calm for reading.\n- **Uppercase display, mixed-case body**: all the largest display sizes are uppercase with negative tracking, while everything 48px and below is sentence case with normal tracking.\n- **Weight spread**: only three real weights do the work — 800 (display), 700 (bold bodies, buttons, tags), and 400 (reading body). A lighter 300-weight is used for editorial-style 40px/48px headlines when a calmer voice is wanted.\n- **No italics, no decorative letterspacing on body**: the body system is deliberately neutral so the display work can shout.\n- **Rotated brand-mark type**: on the sustainability section, the word \"IMPACT\" is set in brand red at a large display size and rotated 90° to run vertically along the edge of a dark world-map panel — a distinctive typographic flourish that the template uses to label its institutional data surfaces.\n\n### Note on Font Substitutes\n\nThe Vodafone corporate typeface is proprietary. When recreating the look in open systems, substitute with **Inter** at weights 400/600/800, or **Neue Haas Grotesk** if available. Inter needs its letter-spacing reduced by roughly 1-2% at display sizes (80px+) to approximate the Vodafone face's tight tracking; its line-height should be set to 0.85-0.95 for the uppercase display tier.\n\n## 4. Component Stylings\n\n### Buttons\n\nVodafone operates a genuine two-tier primary button system. Both tiers are used as primary calls to action — the difference is context (form/chrome vs editorial/content), not hierarchy.\n\n**Primary Red Rectangle** (utility / form CTA — \"Accept All Cookies\", \"Subscribe\")\n- Background: Vodafone Red (\\`#e60000\\`)\n- Text: Pure White (\\`#ffffff\\`), 14.4px, weight 700, letter-spacing 0.144px\n- Padding: 12px vertical, 10px horizontal\n- Border: 1px solid Vodafone Red (\\`#e60000\\`)\n- Border radius: 2px — deliberately sharp-cornered\n- Default state: solid red fill with crisp 2px corners\n- Active state: brief opacity drop to \\`0.9\\` on press\n\n**Primary Red Pill** (editorial / content CTA — \"Link to Our approach to ESG\", \"EXPLORE CONNECTING PEOPLE\")\n- Background: Vodafone Red (\\`#e60000\\`)\n- Text: Pure White (\\`#ffffff\\`), 14.4px, weight 700, letter-spacing 0.144px\n- Padding: 16px uniform\n- Border radius: 60px — fully pill-shaped\n- Default state: solid red fill with rounded ends\n- Active state: brief opacity drop to \\`0.9\\` on press\n\n**Ghost White Rectangle** (secondary form action)\n- Background: Pure White (\\`#ffffff\\`)\n- Text: Form Text Grey (\\`#333333\\`), 14.4px, weight 700\n- Padding: 12px vertical, 10px horizontal\n- Border: 1px solid Form Text Grey (\\`#333333\\`)\n- Border radius: 2px\n- Default state: white fill with charcoal outline\n- Active state: opacity \\`0.9\\` on press\n\n**Glass Pill** (sits on dark hero imagery — secondary content CTA)\n- Background: Pure White at 10% opacity (\\`rgba(255,255,255,0.1)\\`)\n- Text: Pure White (\\`#ffffff\\`), weight 700\n- Padding: 8px vertical, 16px horizontal\n- Border radius: 24px — fully pill-shaped\n- Default state: soft translucent pill lets the photo breathe through\n\n**Content Ghost Pill** (inline within editorial cards — low-emphasis content CTA)\n- Background: Black at 5% opacity (\\`rgba(0,0,0,0.05)\\`)\n- Text: Vodafone Red (\\`#e60000\\`), 14.4px, weight 700\n- Padding: 15px uniform\n- Border radius: 60px — fully pill-shaped\n- Default state: nearly transparent pill with red text\n\n**Icon Control Button** (video play/pause, carousel arrows, close)\n- Background: Pure White (\\`#ffffff\\`)\n- Icon color: Charcoal Headline (\\`#25282b\\`)\n- Border radius: 50% — perfect circle\n- Outline: 1px solid white, used for focus indication\n- Size: typically 32-40px diameter\n\n### Cards & Containers\n\n**News / Editorial Card** (homepage article tile)\n- Background: Pure White (\\`#ffffff\\`)\n- Border radius: 6px (applied to image corners and card container)\n- Shadow: none — cards rely on spacing and the image aspect ratio for separation\n- Internal layout: 16:9 image on top → 12px gap → eyebrow row (date + tag pill) → 8px gap → H4 Bold title → 16px card padding on sides and bottom\n- The card image uses \\`object-fit: cover\\` and rounded top corners (6px top-left/top-right)\n\n**Asymmetric Corner Card** (featured homepage cards)\n- Background: Pure White (\\`#ffffff\\`)\n- Border radius: \\`0px 6px 0px 0px\\` — a deliberate single-corner-rounded shape that echoes the Vodafone speech-mark logo's curved geometry\n- No shadow, no border — the asymmetric radius itself is the visual signature\n\n**Circular Portrait / Pictogram Container** (sustainability page)\n- Background: Pure White (\\`#ffffff\\`)\n- Border radius: 100% — perfect circle\n- Used for ESG pictograms and executive portraits inside the institutional content area\n\n### Inputs & Forms\n\nVodafone's corporate site does not expose many inline form controls on the homepage, but button-style inputs follow these rules:\n\n- Background: Pure White (\\`#ffffff\\`)\n- Text: Form Text Grey (\\`#333333\\`), 16px, weight 400\n- Border: 1px solid Form Text Grey (\\`#333333\\`)\n- Border radius: 2px\n- Padding: 12px 10px\n- Error state (when shown): the 1px border shifts to Vodafone Red (\\`#e60000\\`) and error message text inherits the same red at 12px weight 600\n\n### Navigation\n\n**Top bar**\n- Background: transparent over hero imagery; solid white (\\`#ffffff\\`) on scroll or interior pages\n- Height: approximately 64px desktop, 56px mobile\n- Logo: Vodafone speech-mark, 40×40px red circle with a white \"speech-mark\" cut-out, left-aligned\n- Nav links: 16px weight 400 Charcoal Headline (\\`#25282b\\`) on white; reversed to white when sitting on dark hero imagery\n- Right-side utility: small icon links (search, locale, menu) rendered as 24px icomoon glyphs\n- On interior pages (Investors, Sustainable Business), the top bar shows additional secondary-nav row: \"Vodafone Business / Vodafone Foundation / Our site\" labels, aligned right\n\n**Mobile collapse**\n- At approximately 768px the horizontal nav collapses into a hamburger\n- Mobile menu opens as a full-width overlay with white surface, 18px weight 400 link rows, 16px vertical padding per row\n\n### Image Treatment\n\n- **Hero images**: full-bleed, dark atmospheric photography (coral reefs, pine forests, cable crews, urban twilight) with a natural vignette or cool-tone color grade — no CSS overlay is needed because the imagery itself is pre-graded\n- **Card thumbnails**: 16:9 aspect ratio, 6px top corner radius matching the card\n- **Square editorial images**: 1:1 ratio used in feature modules, always 6px corner radius\n- **Round portraits**: 100% (perfect circle) for executive headshots and ESG pictograms\n- **Loading**: lazy-loading triggers on scroll; images stabilize within ~200ms of entering the viewport\n- **No decorative borders on images** — the card radius does all the framing work\n\n### Tag Pills / Badges\n\nTwo distinct pill styles appear:\n\n**Outlined Red Pill** (used inline on article card metadata, e.g., \"EMPOWERING PEOPLE\")\n- Background: Pure White at 80% opacity (\\`rgba(255,255,255,0.8)\\`)\n- Text: Near-black at 80% opacity (\\`rgba(0,0,0,0.8)\\`), 12px, weight 600, uppercase\n- Border: 1px solid Vodafone Red (\\`#e60000\\`)\n- Padding: 6px\n- Border radius: small-rounded (roughly 2px)\n\n**Filled Neutral Pill** (quieter tags)\n- Background: Light Neutral (\\`#f2f2f2\\`)\n- Text: Charcoal Headline (\\`#25282b\\`), 14px, weight 700\n- Padding: 4px 12px\n- Border radius: 32px — fully pill-shaped\n\n### Red Divider Band\n\nA signature reusable component that appears on every page template: a full-width band of Vodafone Red (\\`#e60000\\`) that runs horizontally across the page to separate the monumental hero from the editorial body beneath it. It carries no text and no controls — it simply is the brand's way of saying \"new chapter.\" Typical height: 40-80px.\n\n### Share Ticker Panel (Investor pages)\n\nA distinctive institutional component that anchors the investor template:\n- Background: Charcoal Institutional Panel (\\`#25282b\\`)\n- Large numeric display: share price set in 48px weight 800 white type with negative letter-spacing (e.g., \"116.05 GBX\")\n- Metadata row: delay notice (e.g., \"15-min delayed\") and timestamp in 14px weight 400 secondary grey text\n- Layout: sits as a horizontal strip above the footer, spans the full content width\n- Hairline dividers (\\`rgba(255,255,255,0.25)\\`) separate the ticker from the footer columns\n\n### Global Impact Map Panel (Sustainability pages)\n\nA signature reusable component that anchors the sustainability template:\n- Background: Charcoal Institutional Panel (\\`#25282b\\`)\n- A dark minimal world-map illustration in slightly lighter grey\n- Red circular markers (\\`#e60000\\`) plotted on geographic locations where the brand operates\n- Vertically-rotated brand word \"IMPACT\" set in Vodafone Red at large display size (weight 800, uppercase, 90° rotated) running along one edge of the panel — this is the template's signature typographic move\n- Small legend with red markers and white uppercase labels at the top-left\n\n### Footer\n\nA universal component across all page templates:\n- Background: Charcoal Institutional Panel (\\`#25282b\\`)\n- Layout: 4-column link grid (Our company / Investors / Vodafone websites / Share price) followed by a \"Connect with us\" social row and legal/privacy line\n- Logo: red speech-mark repeats bottom-right at 32-40px\n- Column header type: 16px weight 800 uppercase white\n- Column link type: 14px weight 400 white, stacked vertically with 12px row spacing\n- Divider hairlines: \\`rgba(255,255,255,0.25)\\` between column group and legal row\n\n## 5. Layout Principles\n\n### Spacing System\n\nBase unit: **8px**. The scale accommodates both tight UI (1px, 2px, 4px) and generous editorial rhythm (16px, 20px, 24px, 32px). Two values (\\`32px\\` and \\`38px\\`) appear across every page in the analysis, making them the template's universal rhythm constants.\n\n| Token | Value | Typical Use |\n|-------|-------|-------------|\n| 2xs | 2px | Hairline separators |\n| xs | 4px | Icon-to-text gap in tight controls |\n| sm | 8px | Base rhythm unit |\n| md | 12px | Card internal padding, eyebrow-to-title gap |\n| base | 16px | Paragraph rhythm, card padding, pill button padding |\n| lg | 20px | Section-internal spacing |\n| xl | 24px | Card-to-card spacing, column gutters |\n| 2xl | 32px | Section intro-to-content breaks — universal constant |\n| 3xl | 38px | Band-to-next-section vertical push — universal constant |\n| section | 64-96px | Vertical rhythm between major editorial modules |\n\n### Grid & Container\n\n- **Max content width**: approximately 1440px on very large screens; articles and hero modules typically sit at 1200px\n- **Column pattern on cards**: 3-up or 4-up card grid at desktop (1200-1440px), 2-up at tablet (768-1024px), stacked 1-up at mobile (<768px)\n- **Horizontal padding**: 32px at desktop edge, 20px at tablet, 16px at mobile\n- **Gutters between cards**: 24px desktop, 16px mobile\n- **Institutional panel (share ticker, world map, footer)**: always full-bleed edge-to-edge at every breakpoint\n\n### Whitespace Philosophy\n\nVodafone's editorial canvas leans generous — whitespace is used as a visual palette cleanser between a monumental headline and the card grid or data panel that follows. Sections are separated by tall vertical rhythm (64-96px) plus the occasional red band that acts as both a separator and a brand signal. Within cards, spacing is tight and efficient (12-16px) so the photography can take the stage.\n\n### Border Radius Scale\n\n| Token | Value | Typical Use |\n|-------|-------|-------------|\n| hairline | 1px | Inline text wraps, small badges |\n| button-tight | 2px | Primary and secondary rectangle button corners — the brand's utility-form look |\n| card | 6px | News cards, images, input fields |\n| asymmetric | \\`0px 6px 0px 0px\\` | Featured cards (top-right corner only) |\n| glass-pill | 24px | Translucent white pills sitting on dark hero imagery |\n| badge-pill | 32px | Filled neutral pill badges |\n| cta-pill | 60px | Primary red content CTAs — the brand's editorial button look |\n| circle | 50% | Icon buttons, carousel arrows, close controls |\n| portrait | 100% | Circular portraits and ESG pictograms |\n\n## 6. Depth & Elevation\n\nVodafone's system is deliberately flat. There is almost no conventional box-shadow in the UI. Hierarchy is carried by color (red bands, charcoal institutional panels), typography weight (800 vs 400), and spacing.\n\n| Level | Treatment | Use |\n|-------|-----------|-----|\n| 0 — Surface | No shadow, no border | Default card, default section |\n| 1 — Outline | 1px solid border at low-opacity | Ghost buttons, outlined pills |\n| 2 — Inset Highlight | \\`inset 0 0 0 1px\\` on focus | Pressed / focused controls |\n| 3 — Photographic depth | The photography itself carries the depth | Hero imagery |\n| 4 — Surface shift | Charcoal institutional panel below a white editorial canvas | Share ticker / world map / footer |\n\nShadow philosophy: Vodafone treats drop shadows as a distraction from brand clarity. The few extracted shadow tokens are reserved for inset focus rings. The dominant \"elevation\" in the system is a **color surface shift** — switching from the white editorial canvas to the charcoal institutional panel — rather than a lift-off drop shadow.\n\n### Decorative Depth\n\nThe only decorative depth cues are:\n- Atmospheric dark hero photography that carries its own cinematic tonal depth (no CSS overlay needed)\n- The rotated vertical \"IMPACT\" wordmark on the sustainability map, which creates the illusion of a fourth wall alongside the map panel\n\n## 7. Do's and Don'ts\n\n### Do\n\n- Use Vodafone Red (\\`#e60000\\`) as the single loudest element on any screen — one primary CTA per fold, one red band per editorial break\n- Set display headlines in uppercase 800-weight with tight negative tracking; let them run to 90-144px on desktop\n- Pair monumental display type with calm 16-18px body copy — the scale jump is the system\n- Switch the button radius based on context: 2px rectangles for form and utility actions, 60px pills for editorial content CTAs\n- Let documentary photography breathe at 16:9 or 1:1 on a 6px radius — no decorative borders, no heavy overlays\n- Use the red band as a full-width chapter divider between every hero and the content below it\n- Anchor every page with a charcoal institutional surface (\\`#25282b\\`) — the footer always, and on investor/sustainability pages extend the same color up to include the share ticker or the global-impact map\n- Respect the universal page rhythm: dark hero → red band → white editorial → charcoal institutional → charcoal footer\n\n### Don't\n\n- Don't introduce a second brand hue to rival Vodafone Red — no teals, no purples, no orange accents\n- Don't soften rectangle button corners beyond 2px, and don't shrink pill button corners below 60px — the two shapes are both load-bearing\n- Don't add drop shadows to cards or buttons — the system is intentionally flat and uses surface color to carry elevation\n- Don't use gradients on backgrounds, buttons, or text\n- Don't mix uppercase tracking on body text — uppercase is reserved for display, labels, and micro-labels\n- Don't use italics for emphasis — use weight 600/700 instead\n- Don't decorate headlines with colored underlines or highlights — the type does the work\n- Don't use pure black (\\`#000000\\`) for text or surfaces — always use Charcoal Headline (\\`#25282b\\`)\n\n## 8. Responsive Behavior\n\n### Breakpoints\n\nThe practical tiers observed across all three templates:\n\n| Name | Width | Key Changes |\n|------|-------|-------------|\n| Mobile | ≤ 600px | Nav collapses to hamburger; hero display drops to ~56-72px; cards stack 1-up |\n| Mobile Large | 601-767px | Hero display ~72-90px; cards still stack 1-up |\n| Tablet | 768-1023px | Nav re-expands; cards grid 2-up; hero display ~90-120px |\n| Laptop | 1024-1199px | Full nav; cards 3-up; hero display ~120-144px |\n| Desktop | 1200-1439px | Standard editorial layout; cards 3-up or 4-up |\n| Wide | ≥ 1440px | Content caps at 1440px; outer canvas padding grows |\n\n### Touch Targets\n\nAll interactive controls meet a 44×44px minimum on mobile. Icon buttons use 40×40px circular hit areas which expand with 4px invisible padding on touch devices. Primary CTA buttons land at approximately 48×48px on mobile (16px top/bottom + text line for pills; 12px + text line for rectangles).\n\n### Collapsing Strategy\n\n- **Nav**: horizontal links collapse into a hamburger at 768px; the logo stays left-aligned at all widths\n- **Card grid**: 4-up → 3-up at 1200px → 2-up at 768px → 1-up at 600px, with gutters shrinking from 24px to 16px\n- **Hero display type**: step-reduces through 144 → 126 → 90 → 72 → 56px as viewports shrink\n- **Section padding**: 96px vertical at desktop, 64px at tablet, 48px at mobile\n- **Red divider bands**: remain full-width at every breakpoint; their vertical height compresses from ~80px at desktop to ~40px at mobile\n- **Institutional panels (share ticker / world map)**: on mobile, multi-column content restacks into a single vertical stream but the charcoal surface stays edge-to-edge\n- **Vertically-rotated \"IMPACT\" wordmark**: becomes a horizontal label or is dropped entirely on mobile where vertical space is limited\n\n### Image Behavior\n\n- Hero imagery: art-directed variant at mobile (tighter crop) versus desktop (wide atmospheric frame)\n- Card thumbnails: always 16:9 regardless of viewport; \\`loading=\"lazy\"\\` is standard\n- Circular portraits: fixed at 80-120px diameter on desktop, shrinking to 64-80px on mobile\n- Logo: fixed at 40×40px across breakpoints (consistent brand mark size)\n\n## 9. Agent Prompt Guide\n\n### Quick Color Reference\n\n- Primary CTA: \"Vodafone Red (\\`#e60000\\`)\"\n- Background: \"Canvas White (\\`#ffffff\\`)\"\n- Heading text: \"Charcoal Headline (\\`#25282b\\`)\"\n- Body text: \"Secondary Body Grey (\\`#7e7e7e\\`)\"\n- Institutional surface: \"Charcoal Institutional Panel (\\`#25282b\\`)\"\n- Inline link: \"Signal Blue (\\`#3860be\\`)\"\n- Quiet pill background: \"Light Neutral (\\`#f2f2f2\\`)\"\n\n### Example Component Prompts\n\n- \"Create a primary red rectangle button: Vodafone Red (\\`#e60000\\`) background, pure white 14.4px weight 700 text, 2px border radius (sharp corners), 12px vertical × 10px horizontal padding. Use for form and utility actions. No shadow, no gradient.\"\n- \"Create a primary red pill CTA: Vodafone Red (\\`#e60000\\`) background, pure white 14.4px weight 700 text, 60px border radius (fully pill-shaped), 16px uniform padding. Use for editorial content calls-to-action.\"\n- \"Design an editorial news card: white background, 6px border radius, 16:9 image at the top, 12px eyebrow row containing a date and a red-outlined uppercase tag pill, then a 24px weight 700 Charcoal title. No shadow — spacing alone separates cards.\"\n- \"Build a hero section: dark atmospheric photo as the full-bleed background, monumental uppercase headline at 144px weight 800 with -1px letter-spacing, single Vodafone Red pill CTA beneath it, no overlay gradient.\"\n- \"Create a red divider band: full-width strip of Vodafone Red (\\`#e60000\\`), 64px tall on desktop and 40px on mobile, no text, no controls — it acts purely as a visual chapter break between editorial sections.\"\n- \"Design an institutional data panel: full-bleed Charcoal Institutional Panel (\\`#25282b\\`) background, large numeric display at 48px weight 800 white with negative letter-spacing, 14px weight 400 grey meta row beneath. Use for share ticker or stats callout.\"\n- \"Design a global impact map: Charcoal Institutional Panel (\\`#25282b\\`) background, minimal grey world-map illustration, red Vodafone-red circular markers on operational locations, the brand word 'IMPACT' set at large display size in brand red and rotated 90° to run vertically along one edge.\"\n\n### Iteration Guide\n\nWhen refining existing screens generated with this design system:\n\n1. Focus on ONE component at a time — the system has few moving parts, so small refinements compound\n2. Reference specific color names and hex codes from this document when describing changes\n3. Use natural language (\"sharper corners,\" \"more generous vertical rhythm\") alongside specific measurements\n4. When in doubt about radius, remember: 2px for form/utility buttons, 60px for editorial pills, 6px for cards, 50%/100% for icon and portrait circles\n5. Keep the brand rule absolute: only one Vodafone Red element should dominate any given fold\n\n### Known Gaps\n\n- Form input styles (text fields, dropdowns, toggles) are not exposed on these page templates; their specs are inferred from the ghost-button pattern and may need refinement when real forms are designed\n- The Vodafone corporate typeface is proprietary and cannot be reproduced exactly in open systems; Inter with tightened tracking at display sizes is the closest open substitute\n- Animation and transition timings are intentionally not documented — the site uses them sparingly and the values are not extractable from static analysis\n- The share ticker's exact number styling (separators, currency glyph) is documented from the investor-page screenshot; other regional variants may display differently\n`;\n"],"mappings":";AACO,IAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;","names":[]}

package/dist/presets/_briefs/voltagent.d.ts

@@ -0,0 +1,3 @@
+declare const voltagentBrief = "# Design System Inspired by VoltAgent\n\n## 1. Visual Theme & Atmosphere\n\nVoltAgent's interface is a deep-space command terminal for the AI age \u2014 a developer-facing darkness built on near-pure-black surfaces (`#050507`) where the only interruption is the electric pulse of emerald green energy. The entire experience evokes the feeling of staring into a high-powered IDE at 2am: dark, focused, and alive with purpose. This is not a friendly SaaS landing page \u2014 it's an engineering platform that announces itself through code snippets, architectural diagrams, and raw technical confidence.\n\nThe green accent (`#00d992`) is used with surgical precision \u2014 it glows from headlines, borders, and interactive elements like a circuit board carrying a signal. Against the carbon-black canvas, this green reads as \"power on\" \u2014 a deliberate visual metaphor for an AI agent engineering platform. The supporting palette is built entirely from warm-neutral grays (`#3d3a39`, `#8b949e`, `#b8b3b0`) that soften the darkness without introducing color noise, creating a cockpit-like warmth that pure blue-grays would lack.\n\nTypography leans on the system font stack for headings \u2014 achieving maximum rendering speed and native-feeling authority \u2014 while Inter carries the body and UI text with geometric precision. Code blocks use SFMono-Regular, the same font developers see in their terminals, reinforcing the tool's credibility at every scroll.\n\n**Key Characteristics:**\n- Carbon-black canvas (`#050507`) with warm-gray border containment (`#3d3a39`) \u2014 not cold or sterile\n- Single-accent identity: Emerald Signal Green (`#00d992`) as the sole chromatic energy source\n- Dual-typography system: system-ui for authoritative headings, Inter for precise UI/body text, SFMono for code credibility\n- Ultra-tight heading line-heights (1.0\u20131.11) creating dense, compressed power blocks\n- Warm neutral palette (`#3d3a39`, `#8b949e`, `#b8b3b0`) that prevents the dark theme from feeling clinical\n- Developer-terminal aesthetic where code snippets ARE the hero content\n- Green glow effects (`drop-shadow`, border accents) that make UI elements feel electrically alive\n\n## 2. Color Palette & Roles\n\n### Primary\n- **Emerald Signal Green** (`#00d992`): The core brand energy \u2014 used for accent borders, glow effects, and the highest-signal interactive moments. This is the \"power-on\" indicator of the entire interface.\n- **VoltAgent Mint** (`#2fd6a1`): The button-text variant of the brand green \u2014 slightly warmer and more readable than pure Signal Green, used specifically for CTA text on dark surfaces.\n- **Tailwind Emerald** (`#10b981`): The ecosystem-standard green used at low opacity (30%) for subtle background tints and link defaults. Bridges VoltAgent's custom palette with Tailwind's utility classes.\n\n### Secondary & Accent\n- **Soft Purple** (`#818cf8`): A cool indigo-violet used sparingly for secondary categorization, code syntax highlights, and visual variety without competing with green.\n- **Cobalt Primary** (`#306cce`): Docusaurus primary dark \u2014 used in documentation contexts for links and interactive focus states.\n- **Deep Cobalt** (`#2554a0`): The darkest primary shade, reserved for pressed/active states in documentation UI.\n- **Ring Blue** (`#3b82f6`): Tailwind's ring color at 50% opacity \u2014 visible only during keyboard focus for accessibility compliance.\n\n### Surface & Background\n- **Abyss Black** (`#050507`): The landing page canvas \u2014 a near-pure black with the faintest warm undertone, darker than most \"dark themes\" for maximum contrast with green accents.\n- **Carbon Surface** (`#101010`): The primary card and button background \u2014 one shade lighter than Abyss, creating a barely perceptible elevation layer. Used across all contained surfaces.\n- **Warm Charcoal Border** (`#3d3a39`): The signature containment color \u2014 not a cold gray but a warm, almost brownish dark tone that prevents borders from feeling harsh against the black canvas.\n\n### Neutrals & Text\n- **Snow White** (`#f2f2f2`): The primary text color on dark surfaces \u2014 not pure white (`#ffffff`) but a softened, eye-friendly off-white. The most-used color on the site (1008 instances).\n- **Pure White** (`#ffffff`): Reserved for the highest-emphasis moments \u2014 ghost button text and maximum-contrast headings. Used at low opacity (5%) for subtle overlay effects.\n- **Warm Parchment** (`#b8b3b0`): Secondary body text \u2014 a warm light gray with a slight pinkish undertone that reads as \"paper\" against the dark canvas.\n- **Steel Slate** (`#8b949e`): Tertiary text, metadata, timestamps, and de-emphasized content. A cool blue-gray that provides clear hierarchy below Warm Parchment.\n- **Fog Gray** (`#bdbdbd`): Footer links and supporting navigation text \u2014 brightens on hover to Pure White.\n- **Mist Gray** (`#dcdcdc`): Slightly brighter than Fog, used for secondary link text that transitions to bright green on hover.\n- **Near White** (`#eeeeee`): Highest-contrast secondary text, one step below Snow White.\n\n### Semantic & Accent\n- **Success Emerald** (`#008b00`): Deep green for success states and positive confirmations in documentation contexts.\n- **Success Light** (`#80d280`): Soft pastel green for success backgrounds and subtle positive indicators.\n- **Warning Amber** (`#ffba00`): Bright amber for warning alerts and caution states.\n- **Warning Pale** (`#ffdd80`): Softened amber for warning background fills.\n- **Danger Coral** (`#fb565b`): Vivid red for error states and destructive action warnings.\n- **Danger Rose** (`#fd9c9f`): Softened coral-pink for error backgrounds.\n- **Info Teal** (`#4cb3d4`): Cool teal-blue for informational callouts and tip admonitions.\n- **Dashed Border Slate** (`#4f5d75` at 40%): A muted blue-gray used exclusively for decorative dashed borders in workflow diagrams.\n\n### Gradient System\n- **Green Signal Glow**: `drop-shadow(0 0 2px #00d992)` animating to `drop-shadow(0 0 8px #00d992)` \u2014 creates a pulsing \"electric charge\" effect on the VoltAgent bolt logo and interactive elements. The glow expands and contracts like a heartbeat.\n- **Warm Ambient Haze**: `rgba(92, 88, 85, 0.2) 0px 0px 15px` \u2014 a warm-toned diffused shadow that creates a soft atmospheric glow around elevated cards, visible at the edges without sharp boundaries.\n- **Deep Dramatic Elevation**: `rgba(0, 0, 0, 0.7) 0px 20px 60px` with `rgba(148, 163, 184, 0.1) 0px 0px 0px 1px inset` \u2014 a heavy, dramatic downward shadow paired with a faint inset slate ring for the most prominent floating elements.\n\n## 3. Typography Rules\n\n### Font Family\n- **Primary (Headings)**: `system-ui`, with fallbacks: `-apple-system, Segoe UI, Roboto, Ubuntu, Cantarell, Noto Sans, Helvetica, Arial, Apple Color Emoji, Segoe UI Emoji, Segoe UI Symbol`\n- **Secondary (Body/UI)**: `Inter`, with fallbacks inheriting from system-ui stack. OpenType features: `\"calt\", \"rlig\"` (contextual alternates and required ligatures)\n- **Monospace (Code)**: `SFMono-Regular`, with fallbacks: `Menlo, Monaco, Consolas, Liberation Mono, Courier New, monospace`\n\n### Hierarchy\n\n| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |\n|------|------|------|--------|-------------|----------------|-------|\n| Display / Hero | system-ui | 60px (3.75rem) | 400 | 1.00 (tight) | -0.65px | Maximum impact, compressed blocks |\n| Section Heading | system-ui | 36px (2.25rem) | 400 | 1.11 (tight) | -0.9px | Tightest letter-spacing in the system |\n| Sub-heading | system-ui | 24px (1.50rem) | 700 | 1.33 | -0.6px | Bold weight for emphasis at this size |\n| Sub-heading Light | system-ui / Inter | 24px (1.50rem) | 300\u2013400 | 1.33 | -0.6px | Light weight variant for softer hierarchy |\n| Overline | system-ui | 20px (1.25rem) | 600 | 1.40 | 0.5px | Uppercase transform, positive letter-spacing |\n| Feature Title | Inter | 20px (1.25rem) | 500\u2013600 | 1.40 | normal | Card headings, feature names |\n| Overline Small | Inter | 18px (1.13rem) | 600 | 1.56 | 0.45px | Uppercase section labels |\n| Body / Button | Inter | 16px (1.00rem) | 400\u2013600 | 1.50\u20131.65 | normal | Standard text, nav links, buttons |\n| Nav Link | Inter | 14.45px (0.90rem) | 500 | 1.65 | normal | Navigation-specific sizing |\n| Caption / Label | Inter | 14px (0.88rem) | 400\u2013600 | 1.43\u20131.65 | normal | Descriptions, metadata, badge text |\n| Tag / Overline Tiny | system-ui | 14px (0.88rem) | 600 | 1.43 | 2.52px | Widest letter-spacing \u2014 reserved for uppercase tags |\n| Micro | Inter | 12px (0.75rem) | 400\u2013500 | 1.33 | normal | Smallest sans-serif text |\n| Code Body | SFMono-Regular | 13\u201314px | 400\u2013686 | 1.23\u20131.43 | normal | Inline code, terminal output, variable weight for syntax |\n| Code Small | SFMono-Regular | 11\u201312px | 400 | 1.33\u20131.45 | normal | Tiny code references, line numbers |\n| Code Button | monospace | 13px (0.81rem) | 700 | 1.65 | normal | Copy-to-clipboard button labels |\n\n### Principles\n- **System-native authority**: Display headings use system-ui rather than a custom web font \u2014 this means the largest text renders instantly (no FOIT/FOUT) and inherits the operating system's native personality. On macOS it's SF Pro, on Windows it's Segoe UI. The design accepts this variability as a feature, not a bug.\n- **Tight compression creates density**: Hero line-heights are extremely compressed (1.0) with negative letter-spacing (-0.65px to -0.9px), creating text blocks that feel like dense technical specifications rather than airy marketing copy.\n- **Weight gradient, not weight contrast**: The system uses a gentle 300\u2192400\u2192500\u2192600\u2192700 weight progression. Bold (700) is reserved for sub-headings and code-button emphasis. Most body text lives at 400\u2013500, creating subtle rather than dramatic hierarchy.\n- **Uppercase is earned and wide**: When uppercase appears, it's always paired with generous letter-spacing (0.45px\u20132.52px), transforming dense words into spaced-out overline labels. This treatment is never applied to headings.\n- **OpenType by default**: Both system-ui and Inter enable `\"calt\"` and `\"rlig\"` features, ensuring contextual character adjustments and ligature rendering throughout.\n\n## 4. Component Stylings\n\n### Buttons\n\n**Ghost / Outline (Standard)**\n- Background: transparent\n- Text: Pure White (`#ffffff`)\n- Padding: comfortable (12px 16px)\n- Border: thin solid Warm Charcoal (`1px solid #3d3a39`)\n- Radius: comfortably rounded (6px)\n- Hover: background darkens to `rgba(0, 0, 0, 0.2)`, opacity drops to 0.4\n- Outline: subtle green tint (`rgba(33, 196, 93, 0.5)`)\n- The default interactive element \u2014 unassuming but clearly clickable\n\n**Primary Green CTA**\n- Background: Carbon Surface (`#101010`)\n- Text: VoltAgent Mint (`#2fd6a1`)\n- Padding: comfortable (12px 16px)\n- Border: none visible (outline-based focus indicator)\n- Outline: VoltAgent Mint (`rgb(47, 214, 161)`)\n- Hover: same darkening behavior as Ghost\n- The \"powered on\" button \u2014 green text on dark surface reads as an active terminal command\n\n**Tertiary / Emphasized Container Button**\n- Background: Carbon Surface (`#101010`)\n- Text: Snow White (`#f2f2f2`)\n- Padding: generous (20px all sides)\n- Border: thick solid Warm Charcoal (`3px solid #3d3a39`)\n- Radius: comfortably rounded (8px)\n- A card-like button treatment for larger interactive surfaces (code copy blocks, feature CTAs)\n\n### Cards & Containers\n- Background: Carbon Surface (`#101010`) \u2014 one shade lighter than the page canvas\n- Border: `1px solid #3d3a39` (Warm Charcoal) for standard containment; `2px solid #00d992` for highlighted/active cards\n- Radius: comfortably rounded (8px) for content cards; subtly rounded (4\u20136px) for smaller inline containers\n- Shadow Level 1: Warm Ambient Haze (`rgba(92, 88, 85, 0.2) 0px 0px 15px`) for standard elevation\n- Shadow Level 2: Deep Dramatic (`rgba(0, 0, 0, 0.7) 0px 20px 60px` + `rgba(148, 163, 184, 0.1) 0px 0px 0px 1px inset`) for hero/feature showcase cards\n- Hover behavior: likely border color shift toward green accent or subtle opacity increase\n- Dashed variant: `1px dashed rgba(79, 93, 117, 0.4)` for workflow/diagram containers \u2014 visually distinct from solid-border content cards\n\n### Inputs & Forms\n- No explicit input token data extracted \u2014 the site is landing-page focused with minimal form UI\n- The npm install command (`npm create voltagent-app@latest`) is presented as a code block rather than an input field\n- Inferred style: Carbon Surface background, Warm Charcoal border, VoltAgent Mint focus ring, Snow White text\n\n### Navigation\n- Sticky top nav bar on Abyss Black canvas\n- Logo: VoltAgent bolt icon with animated green glow (`drop-shadow` cycling 2px\u20138px)\n- Nav structure: Logo \u2192 Product dropdown \u2192 Use Cases dropdown \u2192 Resources dropdown \u2192 GitHub stars badge \u2192 Docs CTA\n- Link text: Snow White (`#f2f2f2`) at 14\u201316px Inter, weight 500\n- Hover: links transition to green variants (`#00c182` or `#00ffaa`)\n- GitHub badge: social proof element integrated directly into nav\n- Mobile: collapses to hamburger menu, single-column vertical layout\n\n### Image Treatment\n- Dark-themed product screenshots and architectural diagrams dominate\n- Code blocks are treated as primary visual content \u2014 syntax-highlighted with SFMono-Regular\n- Agent workflow visualizations appear as interactive node graphs with green connection lines\n- Decorative dot-pattern backgrounds appear behind hero sections\n- Full-bleed within card containers, respecting 8px radius rounding\n\n### Distinctive Components\n\n**npm Install Command Block**\n- A prominent code snippet (`npm create voltagent-app@latest`) styled as a copyable command\n- SFMono-Regular on Carbon Surface with a copy-to-clipboard button\n- Functions as the primary CTA \u2014 \"install first, read later\" developer psychology\n\n**Company Logo Marquee**\n- Horizontal scrolling strip of developer/company logos\n- Infinite animation (`scrollLeft`/`scrollRight`, 25\u201380s durations)\n- Pauses on hover and for users with reduced-motion preferences\n- Demonstrates ecosystem adoption without cluttering the layout\n\n**Feature Section Cards**\n- Large cards combining code examples with descriptive text\n- Left: code snippet with syntax highlighting; Right: feature description\n- Green accent border (`2px solid #00d992`) on highlighted/active features\n- Internal padding: generous (24\u201332px estimated)\n\n**Agent Flow Diagrams**\n- Interactive node-graph visualizations showing agent coordination\n- Connection lines use VoltAgent green variants\n- Nodes styled as mini-cards within the Warm Charcoal border system\n\n**Community / GitHub Section**\n- Large GitHub icon as the visual anchor\n- Star count and contributor metrics prominently displayed\n- Warm social proof: Discord, X, Reddit, LinkedIn, YouTube links in footer\n\n## 5. Layout Principles\n\n### Spacing System\n- Base unit: 8px\n- Scale: 2px, 4px, 5px, 6px, 6.4px, 8px, 12px, 16px, 20px, 24px, 28px, 32px, 40px, 48px, 64px\n- Button padding: 12px 16px (standard), 20px (container-button)\n- Card internal padding: approximately 24\u201332px\n- Section vertical spacing: generous (estimated 64\u201396px between major sections)\n- Component gap: 16\u201324px between sibling cards/elements\n\n### Grid & Container\n- Max container width: approximately 1280\u20131440px, centered\n- Hero: centered single-column with maximum breathing room\n- Feature sections: alternating asymmetric layouts (code left / text right, then reversed)\n- Logo marquee: full-width horizontal scroll, breaking the container constraint\n- Card grids: 2\u20133 column for feature showcases\n- Integration grid: responsive multi-column for partner/integration icons\n\n### Whitespace Philosophy\n- **Cinematic breathing room between sections**: Massive vertical gaps create a \"scroll-through-chapters\" experience \u2014 each section feels like a new scene.\n- **Dense within components**: Cards and code blocks are internally compact, with tight line-heights and controlled padding. Information is concentrated, not spread thin.\n- **Border-defined separation**: Rather than relying solely on whitespace, VoltAgent uses the Warm Charcoal border system (`#3d3a39`) to delineate content zones. The border IS the whitespace signal.\n- **Hero-first hierarchy**: The top of the page commands the most space \u2014 the \"AI Agent Engineering Platform\" headline and npm command get maximum vertical runway before the first content section appears.\n\n### Border Radius Scale\n- Nearly squared (4px): Small inline elements, SVG containers, code spans \u2014 the sharpest treatment, conveying technical precision\n- Subtly rounded (6px): Buttons, links, clipboard actions \u2014 the workhorse radius for interactive elements\n- Code-specific (6.4px): Code blocks, `pre` elements, clipboard copy targets \u2014 a deliberate micro-distinction from standard 6px\n- Comfortably rounded (8px): Content cards, feature containers, emphasized buttons \u2014 the standard containment radius\n- Pill-shaped (9999px): Tags, badges, status indicators, pill-shaped navigation elements \u2014 the roundest treatment for small categorical labels\n\n## 6. Depth & Elevation\n\n| Level | Treatment | Use |\n|-------|-----------|-----|\n| Flat (Level 0) | No shadow, no border | Page background (`#050507`), inline text |\n| Contained (Level 1) | `1px solid #3d3a39`, no shadow | Standard cards, nav bar, code blocks |\n| Emphasized (Level 2) | `3px solid #3d3a39`, no shadow | Large interactive buttons, emphasized containers |\n| Accent (Level 3) | `2px solid #00d992`, no shadow | Active/highlighted feature cards, selected states |\n| Ambient Glow (Level 4) | `rgba(92, 88, 85, 0.2) 0px 0px 15px` | Elevated cards, hover states, soft atmospheric lift |\n| Dramatic Float (Level 5) | `rgba(0, 0, 0, 0.7) 0px 20px 60px` + `rgba(148, 163, 184, 0.1) 1px inset` | Hero feature showcase, modals, maximum-elevation content |\n\n**Shadow Philosophy**: VoltAgent communicates depth primarily through **border weight and color**, not shadows. The standard `1px solid #3d3a39` border IS the elevation \u2014 adding a `3px` border weight or switching to green (`#00d992`) communicates importance more than adding shadow does. When shadows do appear, they're either warm and diffused (Level 4) or cinematic and dramatic (Level 5) \u2014 never medium or generic.\n\n### Decorative Depth\n- **Green Signal Glow**: The VoltAgent bolt logo pulses with a `drop-shadow` animation cycling between 2px and 8px blur radius in Emerald Signal Green. This is the most distinctive decorative element \u2014 it makes the logo feel \"powered on.\"\n- **Warm Charcoal Containment Lines**: The warm tone of `#3d3a39` borders creates a subtle visual warmth against the cool black, as if the cards are faintly heated from within.\n- **Dashed Workflow Lines**: `1px dashed rgba(79, 93, 117, 0.4)` creates a blueprint-like aesthetic for architecture diagrams, visually distinct from solid content borders.\n\n## 7. Do's and Don'ts\n\n### Do\n- Use Abyss Black (`#050507`) as the landing page background and Carbon Surface (`#101010`) for all contained elements \u2014 the two-shade dark system is essential\n- Reserve Emerald Signal Green (`#00d992`) exclusively for high-signal moments: active borders, glow effects, and the most important interactive accents\n- Use VoltAgent Mint (`#2fd6a1`) for button text on dark surfaces \u2014 it's more readable than pure Signal Green\n- Keep heading line-heights compressed (1.0\u20131.11) with negative letter-spacing for dense, authoritative text blocks\n- Use the warm gray palette (`#3d3a39`, `#8b949e`, `#b8b3b0`) for borders and secondary text \u2014 warmth prevents the dark theme from feeling sterile\n- Present code snippets as primary content \u2014 they're hero elements, not supporting illustrations\n- Use border weight (1px \u2192 2px \u2192 3px) and color shifts (`#3d3a39` \u2192 `#00d992`) to communicate depth and importance, rather than relying on shadows\n- Pair system-ui for headings with Inter for body text \u2014 the speed/authority of native fonts combined with the precision of a geometric sans\n- Use SFMono-Regular for all code content \u2014 it's the developer credibility signal\n- Apply `\"calt\"` and `\"rlig\"` OpenType features across all text\n\n### Don't\n- Don't use bright or light backgrounds as primary surfaces \u2014 the entire identity lives on near-black\n- Don't introduce warm colors (orange, red, yellow) as decorative accents \u2014 the palette is strictly green + warm neutrals on black. Warm colors are reserved for semantic states (warning, error) only\n- Don't use Emerald Signal Green (`#00d992`) on large surfaces or as background fills \u2014 it's an accent, never a surface\n- Don't increase heading line-heights beyond 1.33 \u2014 the compressed density is core to the engineering-platform identity\n- Don't use heavy shadows generously \u2014 depth comes from border treatment, not box-shadow. Shadows are reserved for Level 4\u20135 elevation only\n- Don't use pure white (`#ffffff`) as default body text \u2014 Snow White (`#f2f2f2`) is the standard. Pure white is reserved for maximum-emphasis headings and button text\n- Don't mix in serif or decorative fonts \u2014 the entire system is geometric sans + monospace\n- Don't use border-radius larger than 8px on content cards \u2014 9999px (pill) is only for small tags and badges\n- Don't skip the warm-gray border system \u2014 cards without `#3d3a39` borders lose their containment and float ambiguously on the dark canvas\n- Don't animate aggressively \u2014 animations are slow and subtle (25\u2013100s durations for marquee, gentle glow pulses). Fast motion contradicts the \"engineering precision\" atmosphere\n\n## 8. Responsive Behavior\n\n### Breakpoints\n| Name | Width | Key Changes |\n|------|-------|-------------|\n| Small Mobile | <420px | Minimum layout, stacked everything, reduced hero text to ~24px |\n| Mobile | 420\u2013767px | Single column, hamburger nav, full-width cards, hero text ~36px |\n| Tablet | 768\u20131024px | 2-column grids begin, condensed nav, medium hero text |\n| Desktop | 1025\u20131440px | Full multi-column layout, expanded nav with dropdowns, large hero (60px) |\n| Large Desktop | >1440px | Max-width container centered (est. 1280\u20131440px), generous horizontal margins |\n\n*23 breakpoints detected in total, ranging from 360px to 1992px \u2014 indicating a fluid, heavily responsive grid system rather than fixed breakpoint snapping.*\n\n### Touch Targets\n- Buttons use comfortable padding (12px 16px minimum) ensuring adequate touch area\n- Navigation links spaced with sufficient gap for thumb navigation\n- Interactive card surfaces are large enough to serve as full touch targets\n- Minimum recommended touch target: 44x44px\n\n### Collapsing Strategy\n- **Navigation**: Full horizontal nav with dropdowns collapses to hamburger menu on mobile\n- **Feature grids**: 3-column \u2192 2-column \u2192 single-column vertical stacking\n- **Hero text**: 60px \u2192 36px \u2192 24px progressive scaling with maintained compression ratios\n- **Logo marquee**: Adjusts scroll speed and item sizing; maintains infinite loop\n- **Code blocks**: Horizontal scroll on smaller viewports rather than wrapping \u2014 preserving code readability\n- **Section padding**: Reduces proportionally but maintains generous vertical rhythm between chapters\n- **Cards**: Stack vertically on mobile with full-width treatment and maintained internal padding\n\n### Image Behavior\n- Dark-themed screenshots and diagrams scale proportionally within containers\n- Agent flow diagrams simplify or scroll horizontally on narrow viewports\n- Dot-pattern decorative backgrounds scale with viewport\n- No visible art direction changes between breakpoints \u2014 same crops, proportional scaling\n- Lazy loading for below-fold images (Docusaurus default behavior)\n\n## 9. Agent Prompt Guide\n\n### Quick Color Reference\n- Brand Accent: \"Emerald Signal Green (#00d992)\"\n- Button Text: \"VoltAgent Mint (#2fd6a1)\"\n- Page Background: \"Abyss Black (#050507)\"\n- Card Surface: \"Carbon Surface (#101010)\"\n- Border / Containment: \"Warm Charcoal (#3d3a39)\"\n- Primary Text: \"Snow White (#f2f2f2)\"\n- Secondary Text: \"Warm Parchment (#b8b3b0)\"\n- Tertiary Text: \"Steel Slate (#8b949e)\"\n\n### Example Component Prompts\n- \"Create a feature card on Carbon Surface (#101010) with a 1px solid Warm Charcoal (#3d3a39) border, comfortably rounded corners (8px). Use Snow White (#f2f2f2) for the title in system-ui at 24px weight 700, and Warm Parchment (#b8b3b0) for the description in Inter at 16px. Add a subtle Warm Ambient shadow (rgba(92, 88, 85, 0.2) 0px 0px 15px).\"\n- \"Design a ghost button with transparent background, Snow White (#f2f2f2) text in Inter at 16px, a 1px solid Warm Charcoal (#3d3a39) border, and subtly rounded corners (6px). Padding: 12px vertical, 16px horizontal. On hover, background shifts to rgba(0, 0, 0, 0.2).\"\n- \"Build a hero section on Abyss Black (#050507) with a massive heading at 60px system-ui, line-height 1.0, letter-spacing -0.65px. The word 'Platform' should be colored in Emerald Signal Green (#00d992). Below the heading, place a code block showing 'npm create voltagent-app@latest' in SFMono-Regular at 14px on Carbon Surface (#101010) with a copy button.\"\n- \"Create a highlighted feature card using a 2px solid Emerald Signal Green (#00d992) border instead of the standard Warm Charcoal. Keep Carbon Surface background, comfortably rounded corners (8px), and include a code snippet on the left with feature description text on the right.\"\n- \"Design a navigation bar on Abyss Black (#050507) with the VoltAgent logo (bolt icon with animated green glow) on the left, nav links in Inter at 14px weight 500 in Snow White, and a green CTA button (Carbon Surface bg, VoltAgent Mint text) on the right. Add a 1px solid Warm Charcoal bottom border.\"\n\n### Iteration Guide\nWhen refining existing screens generated with this design system:\n1. Focus on ONE component at a time\n2. Reference specific color names and hex codes \u2014 \"use Warm Parchment (#b8b3b0)\" not \"make it lighter\"\n3. Use border treatment to communicate elevation: \"change the border to 2px solid Emerald Signal Green (#00d992)\" for emphasis\n4. Describe the desired \"feel\" alongside measurements \u2014 \"compressed and authoritative heading at 36px with line-height 1.11 and -0.9px letter-spacing\"\n5. For glow effects, specify \"Emerald Signal Green (#00d992) as a drop-shadow with 2\u20138px blur radius\"\n6. Always specify which font \u2014 system-ui for headings, Inter for body/UI, SFMono-Regular for code\n7. Keep animations slow and subtle \u2014 marquee scrolls at 25\u201380s, glow pulses gently\n";
+
+export { voltagentBrief };