oh-my-design-cli 1.8.7 → 1.9.0

package/web/references/stripe/DESIGN.md

@@ -8,53 +8,108 @@ primary_color: "#635bff"
 logo:
   type: simpleicons
   slug: stripe
-verified: "2026-05-15"
-
+verified: "2026-07-13"
 omd: "0.1"
+verification_v2:
+  schema: 2
+  checked: "2026-07-13"
+  surfaces:
+    - { id: docs-home, kind: product, url: "https://docs.stripe.com/", inspected: "2026-07-13" }
+    - { id: docs-payments, kind: product, url: "https://docs.stripe.com/payments", inspected: "2026-07-13" }
+    - { id: docs-api, kind: product, url: "https://docs.stripe.com/api", inspected: "2026-07-13" }
+  sources:
+    - { id: docs-home-live, kind: product-surface, url: "https://docs.stripe.com/", captured: "2026-07-13" }
+    - { id: docs-payments-live, kind: product-surface, url: "https://docs.stripe.com/payments", captured: "2026-07-13" }
+    - { id: docs-api-live, kind: product-surface, url: "https://docs.stripe.com/api", captured: "2026-07-13" }
+    - { id: newsroom, kind: brand-asset, url: "https://stripe.com/newsroom/information", captured: "2026-07-13" }
+    - { id: culture, kind: official-doc, url: "https://stripe.com/jobs/culture", captured: "2026-07-13" }
+    - { id: soehne-foundry, kind: license, url: "https://klim.co.nz/fonts/soehne/", captured: "2026-07-13" }
+    - { id: source-code-license, kind: license, url: "https://github.com/adobe-fonts/source-code-pro/blob/release/LICENSE.md", captured: "2026-07-13" }
+  conflicts: []
+  claims:
+    "tokens.colors.foreground": &docsHome { surface_id: docs-home, source_id: docs-home-live, method: live-inspect, captured: "2026-07-13" }
+    "tokens.colors.foreground-strong": &docsApi { surface_id: docs-api, source_id: docs-api-live, method: live-inspect, captured: "2026-07-13" }
+    "tokens.colors.muted": *docsHome
+    "tokens.colors.link": *docsHome
+    "tokens.colors.accent": *docsApi
+    "tokens.colors.canvas": *docsHome
+    "tokens.colors.surface-subtle": *docsHome
+    "tokens.colors.hairline": *docsHome
+    "tokens.colors.hairline-hover": *docsHome
+    "tokens.colors.on-dark": *docsApi
+    "tokens.typography.body.size": *docsHome
+    "tokens.typography.body.weight": *docsHome
+    "tokens.typography.body.lineHeight": *docsHome
+    "tokens.typography.body.use": *docsHome
+    "tokens.typography.heading.size": *docsApi
+    "tokens.typography.heading.weight": *docsApi
+    "tokens.typography.heading.lineHeight": *docsApi
+    "tokens.typography.heading.use": *docsApi
+    "tokens.typography.control.size": *docsHome
+    "tokens.typography.control.weight": *docsHome
+    "tokens.typography.control.lineHeight": *docsHome
+    "tokens.typography.control.use": *docsHome
+    "tokens.spacing.xs": *docsHome
+    "tokens.spacing.sm": *docsHome
+    "tokens.spacing.md": *docsHome
+    "tokens.spacing.lg": *docsHome
+    "tokens.spacing.xl": *docsHome
+    "tokens.spacing.xxl": *docsHome
+    "tokens.rounded.sm": *docsHome
+    "tokens.rounded.md": *docsHome
+    "tokens.rounded.lg": *docsApi
+    "tokens.components.docs-search-prompt.type": *docsHome
+    "tokens.components.docs-search-prompt.bg": *docsHome
+    "tokens.components.docs-search-prompt.fg": *docsHome
+    "tokens.components.docs-search-prompt.radius": *docsHome
+    "tokens.components.docs-search-prompt.padding": *docsHome
+    "tokens.components.docs-search-prompt.font": *docsHome
+    "tokens.components.docs-search-prompt.hover": *docsHome
+    "tokens.components.docs-search-prompt.pressed": *docsHome
+    "tokens.components.docs-search-prompt.focus": *docsHome
+    "tokens.components.docs-search-prompt.states": *docsHome
+    "tokens.components.docs-secondary-action.type": *docsHome
+    "tokens.components.docs-secondary-action.bg": *docsHome
+    "tokens.components.docs-secondary-action.fg": *docsHome
+    "tokens.components.docs-secondary-action.border": *docsHome
+    "tokens.components.docs-secondary-action.radius": *docsHome
+    "tokens.components.docs-secondary-action.padding": *docsHome
+    "tokens.components.docs-secondary-action.font": *docsHome
+    "tokens.components.docs-secondary-action.hover": *docsHome
+    "tokens.components.docs-secondary-action.pressed": *docsHome
+    "tokens.components.docs-secondary-action.focus": *docsHome
+    "tokens.components.docs-secondary-action.states": *docsHome
+    "tokens.components.docs-content-tab.type": *docsHome
+    "tokens.components.docs-content-tab.fg": *docsHome
+    "tokens.components.docs-content-tab.radius": *docsHome
+    "tokens.components.docs-content-tab.padding": *docsHome
+    "tokens.components.docs-content-tab.font": *docsHome
+    "tokens.components.docs-content-tab.states": *docsHome
 tokens:
   source: reconciled
-  extracted: "2026-06-08"
-  note: "primary = live interactive purple (#533afd); brand = documented logo/marketing purple (#635bff)"
+  extracted: "2026-07-13"
+  note: "Only selector-backed public Docs values are tokens. Stripe marketing, newsroom assets, Docs chrome, and declared-only font assets are separate evidence domains."
   colors:
-    primary: "#533afd"
-    primary-hover: "#4434d4"
-    primary-deep: "#2e2b8c"
-    brand: "#635bff"
-    brand-dark: "#1c1e54"
+    foreground: "#414552"
+    foreground-strong: "#1a2c44"
+    muted: "#50617a"
+    link: "#5469d4"
+    accent: "#533afd"
     canvas: "#ffffff"
-    heading: "#061b31"
-    label: "#273951"
-    body: "#64748d"
-    on-primary: "#ffffff"
-    ruby: "#ea2261"
-    magenta: "#f96bee"
-    success: "#15be53"
-    success-text: "#108c3d"
-    hairline: "#e5edf5"
-    border-purple: "#b9b9f9"
+    surface-subtle: "#f4f7fa"
+    hairline: "#d4dee9"
+    hairline-hover: "#95a4ba"
+    on-dark: "#ffffff"
   typography:
-    family: { sans: "sohne-var", mono: "SourceCodePro" }
-    display-hero: { size: 56, weight: 300, lineHeight: 1.03, tracking: -1.4, use: "Hero headlines, whisper-weight authority" }
-    display-lg:   { size: 48, weight: 300, lineHeight: 1.15, tracking: -0.96, use: "Secondary hero headlines" }
-    section:      { size: 32, weight: 300, lineHeight: 1.10, tracking: -0.64, use: "Feature section titles" }
-    subheading:   { size: 22, weight: 300, lineHeight: 1.10, tracking: -0.22, use: "Card / sub-section heads" }
-    body-lg:      { size: 18, weight: 300, lineHeight: 1.40, use: "Feature descriptions, intro" }
-    body:         { size: 16, weight: 400, lineHeight: 1.40, use: "Standard reading text" }
-    button:       { size: 16, weight: 400, lineHeight: 1.00, use: "Primary button label" }
-    caption:      { size: 13, weight: 400, use: "Small labels, metadata" }
-    code:         { size: 12, weight: 500, lineHeight: 2.00, use: "Code blocks, syntax" }
-  spacing: { xs: 4, sm: 8, md: 12, base: 16, lg: 24, xl: 32, xxl: 48, section: 64 }
-  rounded: { sm: 4, md: 8, lg: 16, full: 9999 }
-  shadow:
-    ambient: "rgba(23,23,23,0.06) 0px 3px 6px"
-    standard: "rgba(23,23,23,0.08) 0px 15px 35px"
-    elevated: "rgba(50,50,93,0.25) 0px 30px 45px -30px, rgba(0,0,0,0.1) 0px 18px 36px -18px"
+    body: { size: 14, weight: 400, lineHeight: 1.43, use: "Repeated public Docs text; operating-system stack, not a named Stripe UI family" }
+    heading: { size: 32, weight: 700, lineHeight: 1.25, use: "Observed Docs h1 only; not a complete display scale" }
+    control: { size: 14, weight: 400, lineHeight: 1.43, use: "Public Docs prompt, action, input, and tab samples" }
+  spacing: { xs: 4, sm: 6, md: 8, lg: 12, xl: 16, xxl: 24 }
+  rounded: { sm: 4, md: 6, lg: 8 }
   components:
-    button-primary: { type: button, bg: "#533afd", fg: "#ffffff", radius: 4, padding: "8px 16px", font: "16px/400 sohne-var", use: "Primary CTA, hover #4434d4" }
-    button-ghost: { type: button, fg: "#533afd", radius: 4, padding: "8px 16px", font: "16px/400 sohne-var", use: "Secondary action, 1px #b9b9f9 border" }
-    card: { type: card, bg: "#ffffff", radius: 8, use: "Content card, 1px #e5edf5 border, blue-tinted standard shadow" }
-    input-text: { type: input, fg: "#061b31", radius: 4, font: "14px sohne-var", use: "Form input, 1px #e5edf5 border, focus #533afd, placeholder #64748d" }
-    badge-success: { type: badge, fg: "#108c3d", radius: 4, padding: "1px 6px", font: "10px/300 sohne-var", use: "Success badge, success #15be53 tinted bg" }
+    docs-search-prompt: { type: button, bg: "#ffffff", fg: "#5469d4", radius: 8, padding: "2px 8px", font: "14px/400 operating-system stack", hover: "#273951 text with #95a4ba border", pressed: "#f4f7fa background with #3c4f69 text and #d4dee9 border", focus: "captured without a distinct computed value", states: "focus, hover, pressed; home and payments only" }
+    docs-secondary-action: { type: button, bg: "#ffffff", fg: "#50617a", border: "0px #d4dee9", radius: 8, padding: "6px 12px", font: "14px/400/20px operating-system stack", hover: "#273951 text with #95a4ba border", pressed: "#f4f7fa background with #3c4f69 text", focus: "#f4f7fa background with #50617a text", states: "focus, hover, pressed; home and payments only" }
+    docs-content-tab: { type: tab, fg: "#414552", radius: 0, padding: "0px", font: "14px/400 operating-system stack", states: "selected; static aria-tab capture on Docs home and payments" }
   components_harvested: true
 ---
 
@@ -62,510 +117,176 @@ tokens:
 
 ## 1. Visual Theme & Atmosphere
 
-Stripe's website is the gold standard of fintech design -- a system that manages to feel simultaneously technical and luxurious, precise and warm. The page opens on a clean white canvas (`#ffffff`) with deep navy headings (`#061b31`) and a signature purple (`#533afd`) that functions as both brand anchor and interactive accent. This isn't the cold, clinical purple of enterprise software; it's a rich, saturated violet that reads as confident and premium. The overall impression is of a financial institution redesigned by a world-class type foundry.
-
-The custom `sohne-var` variable font is the defining element of Stripe's visual identity. Every text element enables the OpenType `"ss01"` stylistic set, which modifies character shapes for a distinctly geometric, modern feel. At display sizes (48px-56px), sohne-var runs at weight 300 -- an extraordinarily light weight for headlines that creates an ethereal, almost whispered authority. This is the opposite of the "bold hero headline" convention; Stripe's headlines feel like they don't need to shout. The negative letter-spacing (-1.4px at 56px, -0.96px at 48px) tightens the text into dense, engineered blocks. At smaller sizes, the system also uses weight 300 with proportionally reduced tracking, and tabular numerals via `"tnum"` for financial data display.
+Stripe builds economic infrastructure for internet businesses, from payments to broader business-management software. Its official newsroom frames that mission around increasing the GDP of the internet, while the current public Docs surfaces turn the same infrastructure stance into an information-dense, quiet interface. The supplied capture covers Docs home, Payments documentation, and API reference—not the marketing home, Dashboard, or checkout. Across those public documentation routes, a restrained blue-gray text hierarchy sits on white and faintly cool surfaces, with purple/indigo used for links and API-reference accents. The visual character is therefore best described as product documentation chrome: readable, compact, and deliberately non-promotional. Stripe’s official operating principles add the relevant brand context—users first, craft and beauty, urgency and focus, and careful foundations—but they do not authorize treating marketing art direction as a Docs token.
 
-What truly distinguishes Stripe is its shadow system. Rather than the flat or single-layer approach of most sites, Stripe uses multi-layer, blue-tinted shadows: the signature `rgba(50,50,93,0.25)` combined with `rgba(0,0,0,0.1)` creates shadows with a cool, almost atmospheric depth -- like elements are floating in a twilight sky. The blue-gray undertone of the primary shadow color (50,50,93) ties directly to the navy-purple brand palette, making even elevation feel on-brand.
+**Key characteristics:**
 
-**Key Characteristics:**
-- sohne-var with OpenType `"ss01"` on all text -- a custom stylistic set that defines the brand's letterforms
-- Weight 300 as the signature headline weight -- light, confident, anti-convention
-- Negative letter-spacing at display sizes (-1.4px at 56px, progressive relaxation downward)
-- Blue-tinted multi-layer shadows using `rgba(50,50,93,0.25)` -- elevation that feels brand-colored
-- Deep navy (`#061b31`) headings instead of black -- warm, premium, financial-grade
-- Conservative border-radius (4px-8px) -- nothing pill-shaped, nothing harsh
-- Ruby (`#ea2261`) and magenta (`#f96bee`) accents for gradient and decorative elements
-- `SourceCodePro` as the monospace companion for code and technical labels
+- Public Docs use `#414552` as repeated foreground text and `#1a2c44` in API-reference content.
+- `#5469d4` is the selector-backed Docs link/action color; `#533afd` occurs on API-reference actions and borders.
+- White `#ffffff` is the repeated canvas; `#f4f7fa` appears in pressed/subtle controls.
+- Captured geometry is compact: 4px, 6px, and 8px radii; the evidence does not support a universal radius rule.
+- Marketing, Docs, newsroom assets, and unauthenticated product UI remain separate evidence domains.
 
 ## 2. Color Palette & Roles
 
-### Primary
-- **Stripe Purple** (`#533afd`): Primary brand color, CTA backgrounds, link text, interactive highlights. A saturated blue-violet that anchors the entire system.
-- **Deep Navy** (`#061b31`): `--hds-color-heading-solid`. Primary heading color. Not black, not gray -- a very dark blue that adds warmth and depth to text.
-- **Pure White** (`#ffffff`): Page background, card surfaces, button text on dark backgrounds.
-
-### Brand & Dark
-- **Brand Dark** (`#1c1e54`): `--hds-color-util-brand-900`. Deep indigo for dark sections, footer backgrounds, and immersive brand moments.
-- **Dark Navy** (`#0d253d`): `--hds-color-core-neutral-975`. The darkest neutral -- almost-black with a blue undertone for maximum depth without harshness.
-
-### Accent Colors
-- **Ruby** (`#ea2261`): `--hds-color-accentColorMode-ruby-icon-solid`. Warm red-pink for icons, alerts, and accent elements.
-- **Magenta** (`#f96bee`): `--hds-color-accentColorMode-magenta-icon-gradientMiddle`. Vivid pink-purple for gradients and decorative highlights.
-- **Magenta Light** (`#ffd7ef`): `--hds-color-util-accent-magenta-100`. Tinted surface for magenta-themed cards and badges.
-
-### Interactive
-- **Primary Purple** (`#533afd`): Primary link color, active states, selected elements.
-- **Purple Hover** (`#4434d4`): Darker purple for hover states on primary elements.
-- **Purple Deep** (`#2e2b8c`): `--hds-color-button-ui-iconHover`. Dark purple for icon hover states.
-- **Purple Light** (`#b9b9f9`): `--hds-color-action-bg-subduedHover`. Soft lavender for subdued hover backgrounds.
-- **Purple Mid** (`#665efd`): `--hds-color-input-selector-text-range`. Range selector and input highlight color.
-
-### Neutral Scale
-- **Heading** (`#061b31`): Primary headings, nav text, strong labels.
-- **Label** (`#273951`): `--hds-color-input-text-label`. Form labels, secondary headings.
-- **Body** (`#64748d`): Secondary text, descriptions, captions.
-- **Success Green** (`#15be53`): Status badges, success indicators (with 0.2-0.4 alpha for backgrounds/borders).
-- **Success Text** (`#108c3d`): Success badge text color.
-- **Lemon** (`#9b6829`): `--hds-color-core-lemon-500`. Warning and highlight accent.
-
-### Surface & Borders
-- **Border Default** (`#e5edf5`): Standard border color for cards, dividers, and containers.
-- **Border Purple** (`#b9b9f9`): Active/selected state borders on buttons and inputs.
-- **Border Soft Purple** (`#d6d9fc`): Subtle purple-tinted borders for secondary elements.
-- **Border Magenta** (`#ffd7ef`): Pink-tinted borders for magenta-themed elements.
-- **Border Dashed** (`#362baa`): Dashed borders for drop zones and placeholder elements.
-
-### Shadow Colors
-- **Shadow Blue** (`rgba(50,50,93,0.25)`): The signature -- blue-tinted primary shadow color.
-- **Shadow Dark Blue** (`rgba(3,3,39,0.25)`): Deeper blue shadow for elevated elements.
-- **Shadow Black** (`rgba(0,0,0,0.1)`): Secondary shadow layer for depth reinforcement.
-- **Shadow Ambient** (`rgba(23,23,23,0.08)`): Soft ambient shadow for subtle elevation.
-- **Shadow Soft** (`rgba(23,23,23,0.06)`): Minimal ambient shadow for light lift.
+### Selector-backed public Docs colors
+
+- **Docs Foreground** (`#414552`): repeated text and tab color on Docs home, Payments docs, and API reference.
+- **API Foreground** (`#1a2c44`): stronger text on captured API-reference and Payments documentation content.
+- **Muted Docs Text** (`#50617a`): compact secondary-action text.
+- **Docs Link** (`#5469d4`): repeated Docs home/Payments link and prompt-action color.
+- **API Accent** (`#533afd`): API-reference action/link and border samples; it is not promoted as a universal Docs fill.
+- **Canvas / On-dark** (`#ffffff`): repeated white public Docs canvas and dark-control text.
+- **Subtle Pressed Surface** (`#f4f7fa`): observed only on pressed/focused compact Docs controls.
+- **Hairline** (`#d4dee9`): observed compact-control border; **Hairline Hover** (`#95a4ba`) appears in captured hover styles.
+
+### Brand-asset boundary
+
+Stripe’s newsroom says its wordmark is available in slate, blurple, and white. The catalog’s `primary_color` remains `#635bff`, but the current packet contains no computed marketing-surface sample that would make it a Docs token. Do not substitute the marketing/wordmark color for `#5469d4` or `#533afd` on the captured Docs routes.
 
 ## 3. Typography Rules
 
-### Font Family
-- **Primary**: `sohne-var`, with fallback: `SF Pro Display`
-- **Monospace**: `SourceCodePro`, with fallback: `SFMono-Regular`
-- **OpenType Features**: `"ss01"` enabled globally on all sohne-var text; `"tnum"` for tabular numbers on financial data and captions.
-
-### Hierarchy
-
-| Role | Font | Size | Weight | Line Height | Letter Spacing | Features | Notes |
-|------|------|------|--------|-------------|----------------|----------|-------|
-| Display Hero | sohne-var | 56px (3.50rem) | 300 | 1.03 (tight) | -1.4px | ss01 | Maximum size, whisper-weight authority |
-| Display Large | sohne-var | 48px (3.00rem) | 300 | 1.15 (tight) | -0.96px | ss01 | Secondary hero headlines |
-| Section Heading | sohne-var | 32px (2.00rem) | 300 | 1.10 (tight) | -0.64px | ss01 | Feature section titles |
-| Sub-heading Large | sohne-var | 26px (1.63rem) | 300 | 1.12 (tight) | -0.26px | ss01 | Card headings, sub-sections |
-| Sub-heading | sohne-var | 22px (1.38rem) | 300 | 1.10 (tight) | -0.22px | ss01 | Smaller section heads |
-| Body Large | sohne-var | 18px (1.13rem) | 300 | 1.40 | normal | ss01 | Feature descriptions, intro text |
-| Body | sohne-var | 16px (1.00rem) | 300-400 | 1.40 | normal | ss01 | Standard reading text |
-| Button | sohne-var | 16px (1.00rem) | 400 | 1.00 (tight) | normal | ss01 | Primary button text |
-| Button Small | sohne-var | 14px (0.88rem) | 400 | 1.00 (tight) | normal | ss01 | Secondary/compact buttons |
-| Link | sohne-var | 14px (0.88rem) | 400 | 1.00 (tight) | normal | ss01 | Navigation links |
-| Caption | sohne-var | 13px (0.81rem) | 400 | normal | normal | ss01 | Small labels, metadata |
-| Caption Small | sohne-var | 12px (0.75rem) | 300-400 | 1.33-1.45 | normal | ss01 | Fine print, timestamps |
-| Caption Tabular | sohne-var | 12px (0.75rem) | 300-400 | 1.33 | -0.36px | tnum | Financial data, numbers |
-| Micro | sohne-var | 10px (0.63rem) | 300 | 1.15 (tight) | 0.1px | ss01 | Tiny labels, axis markers |
-| Micro Tabular | sohne-var | 10px (0.63rem) | 300 | 1.15 (tight) | -0.3px | tnum | Chart data, small numbers |
-| Nano | sohne-var | 8px (0.50rem) | 300 | 1.07 (tight) | normal | ss01 | Smallest labels |
-| Code Body | SourceCodePro | 12px (0.75rem) | 500 | 2.00 (relaxed) | normal | -- | Code blocks, syntax |
-| Code Bold | SourceCodePro | 12px (0.75rem) | 700 | 2.00 (relaxed) | normal | -- | Bold code, keywords |
-| Code Label | SourceCodePro | 12px (0.75rem) | 500 | 2.00 (relaxed) | normal | uppercase | Technical labels |
-| Code Micro | SourceCodePro | 9px (0.56rem) | 500 | 1.00 (tight) | normal | ss01 | Tiny code annotations |
-
-### Principles
-- **Light weight as signature**: Weight 300 at display sizes is Stripe's most distinctive typographic choice. Where others use 600-700 to command attention, Stripe uses lightness as luxury -- the text is so confident it doesn't need weight to be authoritative.
-- **ss01 everywhere**: The `"ss01"` stylistic set is non-negotiable. It modifies specific glyphs (likely alternate `a`, `g`, `l` forms) to create a more geometric, contemporary feel across all sohne-var text.
-- **Two OpenType modes**: `"ss01"` for display/body text, `"tnum"` for tabular numerals in financial data. These never overlap -- a number in a paragraph uses ss01, a number in a data table uses tnum.
-- **Progressive tracking**: Letter-spacing tightens proportionally with size: -1.4px at 56px, -0.96px at 48px, -0.64px at 32px, -0.26px at 26px, normal at 16px and below.
-- **Two-weight simplicity**: Primarily 300 (body and headings) and 400 (UI/buttons). No bold (700) in the primary font -- SourceCodePro uses 500/700 for code contrast.
+### Evidence classes
+
+| Evidence class | Family and boundary |
+|---|---|
+| Official product-use | No supplied official Stripe statement establishes a named type family for the three captured Docs routes. |
+| Live computed surface-use | The Docs capture records an operating-system stack beginning `-apple-system` in 355 visible uses. It is system typography, not a Stripe-owned family or a substitute for one. |
+| Official distributed brand asset | Klim Type Foundry’s Söhne page lists Stripe in its separate “Söhne in use” showcase and describes available WOFF2/web licensing. This is foundry/brand context only; it is not evidence that the captured Docs routes loaded Söhne. |
+| Declared-only | Heiti SC, Hiragino Kaku Gothic ProN, Hiragino Sans, Hiragino Sans GB, Meiryo UI, Microsoft JhengHei, Microsoft YaHei, PingFang SC, and Yu Gothic UI have declarations but no visible use in the supplied capture. |
+| System / unresolved | `Source Code Pro` (four computed occurrences) and Menlo (two) have no matching loaded FontFace/source URL in the artifact, so neither is promoted. Adobe’s Source Code Pro repository/license establishes the font’s OFL status, not Stripe deployment. |
+
+### Captured hierarchy
+
+| Role | Family boundary | Size | Weight | Line height | Evidence boundary |
+|---|---|---:|---:|---:|---|
+| Public Docs body | operating-system stack | 14px | 400 | 20px or normal | repeated Docs samples; no named UI family claim |
+| API Docs h1 | operating-system stack | 32px | 700 | 40px | two observed API-reference samples only |
+| Docs control | operating-system stack | 14px | 400 | 20px or normal | prompt, action, input, and tab samples |
+| Code-adjacent sample | Source Code Pro | 12px | 700 | 20px | four computed occurrences; unresolved because FontFace/source corroboration is absent |
+
+Do not render a system fallback as Söhne or Source Code Pro. The capture supports system-stack documentation typography only.
 
 ## 4. Component Stylings
 
-### Buttons
-
-**Primary Purple**
-- Background: `#533afd`
-- Text: `#ffffff`
-- Padding: 8px 16px
-- Radius: 4px
-- Font: 16px sohne-var weight 400, `"ss01"`
-- Hover: `#4434d4` background
-- Use: Primary CTA ("Start now", "Contact sales")
-
-**Ghost / Outlined**
-- Background: transparent
-- Text: `#533afd`
-- Padding: 8px 16px
-- Radius: 4px
-- Border: `1px solid #b9b9f9`
-- Font: 16px sohne-var weight 400, `"ss01"`
-- Hover: background shifts to `rgba(83,58,253,0.05)`
-- Use: Secondary actions
-
-**Transparent Info**
-- Background: transparent
-- Text: `#2874ad`
-- Padding: 8px 16px
-- Radius: 4px
-- Border: `1px solid rgba(43,145,223,0.2)`
-- Use: Tertiary/info-level actions
-
-**Neutral Ghost**
-- Background: transparent (`rgba(255,255,255,0)`)
-- Text: `rgba(16,16,16,0.3)`
-- Padding: 8px 16px
-- Radius: 4px
-- Outline: `1px solid rgb(212,222,233)`
-- Use: Disabled or muted actions
-
-#### Sessions / `.CtaButton` system — `stripe.com/payments` and product surfaces
-
-Stripe runs a **second button system** on product/payment surfaces, distinct from the HDS marketing chrome. Different color (`#9966ff` lavender vs HDS `#533afd` Deep Violet), different geometry (16.5px pill vs 4px sharp), different weight (425 vs 400).
-
-**Sessions Primary**
-- Background: `#9966ff` (rgb(153, 102, 255) — lighter lavender)
-- Text: `#ffffff`
-- Padding: 3px 12px 6px 16px (asymmetric)
-- Radius: 16.5px (pill-like, much rounder than HDS 4px)
-- Height: 33px
-- Font: 15px / weight **425** / sohne-var (note: 425 is between regular and medium)
-- Use: Product-page primary CTA on stripe.com/payments — "Start accepting payments", "Start now"
-
-**Sessions Link**
-- Background: transparent
-- Text: `#9966ff`
-- Padding: 3px 0px 6px
-- Radius: 16.5px
-- Height: 33px
-- Font: 15px / 425 / sohne-var
-- Use: Inline link CTA — "Try the demo", "Explore full page", "Read the story"
-
-**Sessions Quiet** (carousel)
-- Background: transparent
-- Text: `#000000`
-- Padding: 1px 6px
-- Radius: 14px
-- Height: 28px
-- Font: 13.3px / 400
-- Use: Carousel prev/next arrows on product pages
-
-### Cards & Containers
+### Public Docs actions
+
+**Search Prompt**
 - Background: `#ffffff`
-- Border: `1px solid #e5edf5` (standard) or `1px solid #061b31` (dark accent)
-- Radius: 4px (tight), 5px (standard), 6px (comfortable), 8px (featured)
-- Shadow (standard): `rgba(50,50,93,0.25) 0px 30px 45px -30px, rgba(0,0,0,0.1) 0px 18px 36px -18px`
-- Shadow (ambient): `rgba(23,23,23,0.08) 0px 15px 35px 0px`
-- Hover: shadow intensifies, often adding the blue-tinted layer
-
-### Badges / Tags / Pills
-**Neutral Pill**
+- Text: `#5469d4`
+- Border: 0px `#5469d4`
+- Radius: 8px
+- Padding: 2px 8px
+- Font: 14px / 400 / operating-system stack
+- Hover: `#273951` text with `#95a4ba` border
+- Pressed: `#f4f7fa` background with `#3c4f69` text and `#d4dee9` border
+- Focus: captured without a distinct computed value
+- Use: Docs home and Payments search-prompt action; selector `home::[data-omd-capture="2"]`.
+
+**Secondary Action**
 - Background: `#ffffff`
-- Text: `#000000`
-- Padding: 0px 6px
-- Radius: 4px
-- Border: `1px solid #f6f9fc`
-- Font: 11px weight 400
-
-**Success Badge**
-- Background: `rgba(21,190,83,0.2)`
-- Text: `#108c3d`
-- Padding: 1px 6px
-- Radius: 4px
-- Border: `1px solid rgba(21,190,83,0.4)`
-- Font: 10px weight 300
-
-### Inputs & Forms
-- Border: `1px solid #e5edf5`
-- Radius: 4px
-- Focus: `1px solid #533afd` or purple ring
-- Label: `#273951`, 14px sohne-var
-- Text: `#061b31`
-- Placeholder: `#64748d`
-
-### Navigation
-- Clean horizontal nav on white, sticky with blur backdrop
-- Brand logotype left-aligned
-- Links: sohne-var 14px weight 400, `#061b31` text with `"ss01"`
-- Radius: 6px on nav container
-- CTA: purple button right-aligned ("Sign in", "Start now")
-- Mobile: hamburger toggle with 6px radius
-
-### Decorative Elements
-**Dashed Borders**
-- `1px dashed #362baa` (purple) for placeholder/drop zones
-- `1px dashed #ffd7ef` (magenta) for magenta-themed decorative borders
-
-**Gradient Accents**
-- Ruby-to-magenta gradients (`#ea2261` to `#f96bee`) for hero decorations
-- Brand dark sections use `#1c1e54` backgrounds with white text
+- Text: `#50617a`
+- Border: 0px `#d4dee9`
+- Radius: 8px
+- Padding: 6px 12px
+- Font: 14px / 400 / 20px / operating-system stack
+- Hover: `#273951` text with `#95a4ba` border
+- Pressed: `#f4f7fa` background with `#3c4f69` text
+- Focus: `#f4f7fa` background with `#50617a` text
+- Use: Docs home and Payments compact action; selector `home::[data-omd-capture="4"]`.
+
+### Public Docs navigation
+
+**Content Tab**
+- Text: `#414552`
+- Border: 0px `#414552`
+- Radius: 0px
+- Padding: 0px
+- Font: 14px / 400 / operating-system stack
+- State: selected is present as a static ARIA-tab capture; no interaction transition was captured.
+- Use: Docs home and Payments content tabs; selectors `home::[data-omd-capture="7"]` and `surface-2::[data-omd-capture="46"]`.
+
+### Scope boundary
+
+The supplied collector records `interactionCount: 0`. Hover, pressed, focus, and selected values above are only the individual static state samples retained in the artifact; no menu, dialog, toast, form-error, disabled, or authenticated-product variant is inferred. Low-confidence card/badge detections and Docs input styling are preserved in verification evidence but not promoted into canonical components.
 
 ---
-
-**Verified:** 2026-05-08 (omd:migrate Apple-tier — run 3/10)
-**Tier 1 sources:** stripe.com/ (HDS `.hds-button` system, live DOM 2 surfaces); stripe.com/payments (Sessions `.CtaButton` system, second surface — distinct from HDS)
-**Tier 2 sources:** styles.refero.design/style/48e5de76-05d5-4c4e-a269-c7c245b291ec (HDS Primary `#533afd` / 4px confirmed); getdesign.md/stripe — directory only
-**Conflicts resolved:** Two-system split documented as intentional (not a conflict): HDS `#533afd` 4px sharp on marketing/home / Sessions `#9966ff` 16.5px pill 425-weight on product pages. Both retained as separate variant subgroups in §4.
-**Earlier gap:** §4 had only HDS variants; Sessions `#9966ff` system was missing. Now added.
-**Philosophy citations:** Wikipedia (Patrick + John Collison), YC Startup Library, KITRUM (Auctomatic prior exit), Founded.com ($159B valuation).
-**`.verification.md`:** `web/references/stripe/.verification.md`
+**Verified:** 2026-07-13
+**Tier 1 sources:** https://docs.stripe.com/ ; https://docs.stripe.com/payments ; https://docs.stripe.com/api ; https://stripe.com/newsroom/information ; https://stripe.com/jobs/culture
+**Tier 2 sources:** https://getdesign.md/stripe (independent analysis; no numeric token promoted); https://styles.refero.design/?q=stripe and https://styles.refero.design/style/48e5de76-05d5-4c4e-a269-c7c245b291ec (independent, older marketing-system record)
+**Conflicts unresolved:** none
 
 ## 5. Layout Principles
 
-### Spacing System
-- Base unit: 8px
-- Scale: 1px, 2px, 4px, 6px, 8px, 10px, 11px, 12px, 14px, 16px, 18px, 20px
-- Notable: The scale is dense at the small end (every 2px from 4-12), reflecting Stripe's precision-oriented UI for financial data
-
-### Grid & Container
-- Max content width: approximately 1080px
-- Hero: centered single-column with generous padding, lightweight headlines
-- Feature sections: 2-3 column grids for feature cards
-- Full-width dark sections with `#1c1e54` background for brand immersion
-- Code/dashboard previews as contained cards with blue-tinted shadows
-
-### Whitespace Philosophy
-- **Precision spacing**: Unlike the vast emptiness of minimalist systems, Stripe uses measured, purposeful whitespace. Every gap is a deliberate typographic choice.
-- **Dense data, generous chrome**: Financial data displays (tables, charts) are tightly packed, but the UI chrome around them is generously spaced. This creates a sense of controlled density -- like a well-organized spreadsheet in a beautiful frame.
-- **Section rhythm**: White sections alternate with dark brand sections (`#1c1e54`), creating a dramatic light/dark cadence that prevents monotony without introducing arbitrary color.
-
-### Border Radius Scale
-- Micro (1px): Fine-grained elements, subtle rounding
-- Standard (4px): Buttons, inputs, badges, cards -- the workhorse
-- Comfortable (5px): Standard card containers
-- Relaxed (6px): Navigation, larger interactive elements
-- Large (8px): Featured cards, hero elements
-- Compound: `0px 0px 6px 6px` for bottom-rounded containers (tab panels, dropdown footers)
+The capture supports documentation layout behavior only: Docs body/list text repeats at 14px, API-reference headings at 32px, and repeated gaps cluster at 4px, 6px, 8px, 12px, 16px, and 24px. Tabs, prompts, and compact actions use zero or low-radius chrome. It does not establish public marketing-grid, Dashboard, checkout, or mobile breakpoint rules.
 
 ## 6. Depth & Elevation
 
-| Level | Treatment | Use |
-|-------|-----------|-----|
-| Flat (Level 0) | No shadow | Page background, inline text |
-| Ambient (Level 1) | `rgba(23,23,23,0.06) 0px 3px 6px` | Subtle card lift, hover hints |
-| Standard (Level 2) | `rgba(23,23,23,0.08) 0px 15px 35px` | Standard cards, content panels |
-| Elevated (Level 3) | `rgba(50,50,93,0.25) 0px 30px 45px -30px, rgba(0,0,0,0.1) 0px 18px 36px -18px` | Featured cards, dropdowns, popovers |
-| Deep (Level 4) | `rgba(3,3,39,0.25) 0px 14px 21px -14px, rgba(0,0,0,0.1) 0px 8px 17px -8px` | Modals, floating panels |
-| Ring (Accessibility) | `2px solid #533afd` outline | Keyboard focus ring |
-
-**Shadow Philosophy**: Stripe's shadow system is built on a principle of chromatic depth. Where most design systems use neutral gray or black shadows, Stripe's primary shadow color (`rgba(50,50,93,0.25)`) is a deep blue-gray that echoes the brand's navy palette. This creates shadows that don't just add depth -- they add brand atmosphere. The multi-layer approach pairs this blue-tinted shadow with a pure black secondary layer (`rgba(0,0,0,0.1)`) at a different offset, creating a parallax-like depth where the branded shadow sits farther from the element and the neutral shadow sits closer. The negative spread values (-30px, -18px) ensure shadows don't extend beyond the element's footprint horizontally, keeping elevation vertical and controlled.
-
-### Decorative Depth
-- Dark brand sections (`#1c1e54`) create immersive depth through background color contrast
-- Gradient overlays with ruby-to-magenta transitions for hero decorations
-- Shadow color `rgba(0,55,112,0.08)` (`--hds-color-shadow-sm-top`) for top-edge shadows on sticky elements
+Captured Docs controls are principally flat. The search prompt and secondary action use white `#ffffff`; their pressed/focused states use `#f4f7fa` and hairline values rather than a documented universal shadow scale. An API-only dark sample has a shadow, but a single route-local control is insufficient to publish an elevation system.
 
 ## 7. Do's and Don'ts
 
 ### Do
-- Use sohne-var with `"ss01"` on every text element -- the stylistic set IS the brand
-- Use weight 300 for all headlines and body text -- lightness is the signature
-- Apply blue-tinted shadows (`rgba(50,50,93,0.25)`) for all elevated elements
-- Use `#061b31` (deep navy) for headings instead of `#000000` -- the warmth matters
-- Keep border-radius between 4px-8px -- conservative rounding is intentional
-- Use `"tnum"` for any tabular/financial number display
-- Layer shadows: blue-tinted far + neutral close for depth parallax
-- Use `#533afd` purple as the primary interactive/CTA color
+
+- Keep the captured Docs hierarchy compact: 14px public text/control samples and a 32px API h1 sample.
+- Use `#5469d4` for the observed Docs prompt/link treatment and reserve `#533afd` for the captured API-reference accent context.
+- Preserve selector/surface boundaries when using the 8px compact actions or zero-radius content tabs.
+- Treat Söhne, Source Code Pro, and declared CJK faces according to their evidence class rather than loading a substitute.
 
 ### Don't
-- Don't use weight 600-700 for sohne-var headlines -- weight 300 is the brand voice
-- Don't use large border-radius (12px+, pill shapes) on cards or buttons -- Stripe is conservative
-- Don't use neutral gray shadows -- always tint with blue (`rgba(50,50,93,...)`)
-- Don't skip `"ss01"` on any sohne-var text -- the alternate glyphs define the personality
-- Don't use pure black (`#000000`) for headings -- always `#061b31` deep navy
-- Don't use warm accent colors (orange, yellow) for interactive elements -- purple is primary
-- Don't apply positive letter-spacing at display sizes -- Stripe tracks tight
-- Don't use the magenta/ruby accents for buttons or links -- they're decorative/gradient only
+
+- Don't apply a marketing purple, gradient, shadow, font, or button treatment to Docs merely because it is associated with Stripe elsewhere.
+- Don't claim menu, dialog, toast, error, disabled, or authenticated Dashboard states from this zero-interaction packet.
+- Don't render the operating-system stack as though it were a named Stripe typeface.
+- Don't turn a low-confidence generic card/badge detection into a reusable component token.
 
 ## 8. Responsive Behavior
 
-### Breakpoints
-| Name | Width | Key Changes |
-|------|-------|-------------|
-| Mobile | <640px | Single column, reduced heading sizes, stacked cards |
-| Tablet | 640-1024px | 2-column grids, moderate padding |
-| Desktop | 1024-1280px | Full layout, 3-column feature grids |
-| Large Desktop | >1280px | Centered content with generous margins |
-
-### Touch Targets
-- Buttons use comfortable padding (8px-16px vertical)
-- Navigation links at 14px with adequate spacing
-- Badges have 6px horizontal padding minimum for tap targets
-- Mobile nav toggle with 6px radius button
-
-### Collapsing Strategy
-- Hero: 56px display -> 32px on mobile, weight 300 maintained
-- Navigation: horizontal links + CTAs -> hamburger toggle
-- Feature cards: 3-column -> 2-column -> single column stacked
-- Dark brand sections: maintain full-width treatment, reduce internal padding
-- Financial data tables: horizontal scroll on mobile
-- Section spacing: 64px+ -> 40px on mobile
-- Typography scale compresses: 56px -> 48px -> 32px hero sizes across breakpoints
-
-### Image Behavior
-- Dashboard/product screenshots maintain blue-tinted shadow at all sizes
-- Hero gradient decorations simplify on mobile
-- Code blocks maintain `SourceCodePro` treatment, may horizontally scroll
-- Card images maintain consistent 4px-6px border-radius
+No mobile viewport or responsive transition was captured. The public Docs routes may be responsive, but this packet supports no breakpoint, collapsed-navigation, or touch-target specification.
 
 ## 9. Agent Prompt Guide
 
-### Quick Color Reference
-- Primary CTA: Stripe Purple (`#533afd`)
-- CTA Hover: Purple Dark (`#4434d4`)
-- Background: Pure White (`#ffffff`)
-- Heading text: Deep Navy (`#061b31`)
-- Body text: Slate (`#64748d`)
-- Label text: Dark Slate (`#273951`)
-- Border: Soft Blue (`#e5edf5`)
-- Link: Stripe Purple (`#533afd`)
-- Dark section: Brand Dark (`#1c1e54`)
-- Success: Green (`#15be53`)
-- Accent decorative: Ruby (`#ea2261`), Magenta (`#f96bee`)
-
-### Example Component Prompts
-- "Create a hero section on white background. Headline at 48px sohne-var weight 300, line-height 1.15, letter-spacing -0.96px, color #061b31, font-feature-settings 'ss01'. Subtitle at 18px weight 300, line-height 1.40, color #64748d. Purple CTA button (#533afd, 4px radius, 8px 16px padding, white text) and ghost button (transparent, 1px solid #b9b9f9, #533afd text, 4px radius)."
-- "Design a card: white background, 1px solid #e5edf5 border, 6px radius. Shadow: rgba(50,50,93,0.25) 0px 30px 45px -30px, rgba(0,0,0,0.1) 0px 18px 36px -18px. Title at 22px sohne-var weight 300, letter-spacing -0.22px, color #061b31, 'ss01'. Body at 16px weight 300, #64748d."
-- "Build a success badge: rgba(21,190,83,0.2) background, #108c3d text, 4px radius, 1px 6px padding, 10px sohne-var weight 300, border 1px solid rgba(21,190,83,0.4)."
-- "Create navigation: white sticky header with backdrop-filter blur(12px). sohne-var 14px weight 400 for links, #061b31 text, 'ss01'. Purple CTA 'Start now' right-aligned (#533afd bg, white text, 4px radius). Nav container 6px radius."
-- "Design a dark brand section: #1c1e54 background, white text. Headline 32px sohne-var weight 300, letter-spacing -0.64px, 'ss01'. Body 16px weight 300, rgba(255,255,255,0.7). Cards inside use rgba(255,255,255,0.1) border with 6px radius."
-
-### Iteration Guide
-1. Always enable `font-feature-settings: "ss01"` on sohne-var text -- this is the brand's typographic DNA
-2. Weight 300 is the default; use 400 only for buttons/links/navigation
-3. Shadow formula: `rgba(50,50,93,0.25) 0px Y1 B1 -S1, rgba(0,0,0,0.1) 0px Y2 B2 -S2` where Y1/B1 are larger (far shadow) and Y2/B2 are smaller (near shadow)
-4. Heading color is `#061b31` (deep navy), body is `#64748d` (slate), labels are `#273951` (dark slate)
-5. Border-radius stays in the 4px-8px range -- never use pill shapes or large rounding
-6. Use `"tnum"` for any numbers in tables, charts, or financial displays
-7. Dark sections use `#1c1e54` -- not black, not gray, but a deep branded indigo
-8. SourceCodePro for code at 12px/500 with 2.00 line-height (very generous for readability)
-
----
+For a Docs-local reference implementation, use a white `#ffffff` canvas, `#414552` foreground text, 14px operating-system-stack controls, a `#5469d4` compact prompt action with an 8px radius, and `#d4dee9`/`#95a4ba` hairline states. Do not describe this as Stripe marketing, Dashboard, or checkout styling, and omit any named font specimen unless a future capture supplies computed usage plus FontFace/source corroboration.
 
 ## 10. Voice & Tone
 
-Stripe's voice is that of a careful engineer who happens to have literary sensibilities — precise, understated, quietly confident, and anti-hype. The official tagline *"Growing the GDP of the internet"* captures the register: ambitious in scope, economist-flavored in vocabulary, zero exclamation points. Button labels are austere ("Start now", "Sign in", "Contact sales"), never "Get started FREE 🚀". Developer-facing surfaces (docs, API reference, error messages) and business-facing surfaces (pricing, marketing) share the same voice; only the density changes.
+Stripe’s operating principles emphasize users first, craft and beauty, urgency and focus, egoless collaboration, talent, and curiosity. Its product-facing public copy can therefore be direct and concrete: state the capability, then the mechanism or next action. The supplied Docs capture supports documentation context but does not itself establish a complete marketing-copy corpus.
 
-| Context | Tone |
+| Context | Supported direction |
 |---|---|
-| Hero headlines | Declarative, measured. Reads like a white-paper summary. Never superlative. |
-| Product descriptions | One verb + concrete capability. "Accept payments online." Never "Transform your business." |
-| CTAs | Austere imperatives. "Start now", "Contact sales", "Read the docs". |
-| API error messages | Structured as developer errors: error type + precise explanation + link to docs. |
-| Docs / API reference | Dense, precise, respects reader as a peer. Examples precede explanations. |
-| Marketing / enterprise | Slightly more formal register, same voice. Never shifts into sales-speak. |
-| Careers / About | Confident but humble. Celebrates rigor, not scale. |
-| Legal / compliance | Formal, reads like a carefully edited regulatory filing. |
-| Changelog / release notes | Chronological, specific, engineer-to-engineer. |
-
-**Forbidden phrases.** "Revolutionary", "game-changer", "unleash", "supercharge", "cutting-edge", "disrupt/disruption" as verbs. "Simply...", "Just...". Exclamation marks on routine CTAs. Emoji anywhere on marketing, product, docs, or developer surfaces. Performative hedging ("We're so excited to announce..."). Stacked adjectives on capabilities ("world-class, enterprise-grade, battle-tested payment infrastructure" — pick one, usually none).
+| Product / Docs | Lead with the operation or capability; keep terminology precise. |
+| Action labels | Use short, literal labels that name the next task. |
+| Brand narrative | Connect financial infrastructure to what businesses can build, without inventing a product claim. |
 
 ## 11. Brand Narrative
 
-Stripe was founded in **2010** by **Patrick Collison (CEO)** and **John Collison (President)** — two Irish brothers from **Limerick** who kept running into the same problem: accepting payments online was far harder than it should be for any developer who wanted to build something on the internet ([Patrick Collison — Wikipedia](https://en.wikipedia.org/wiki/Patrick_Collison), [John Collison — Wikipedia](https://en.wikipedia.org/wiki/John_Collison)). The brothers had prior exit experience: their previous company **Auctomatic** (originally Shuppa, 2007) merged with Oxford grads **Harjeet and Kulveer Taggar** through Y Combinator and was sold to Live Current Media on Good Friday, March 2008 — Patrick was 19, John was 17 ([KITRUM — Collison Brothers](https://kitrum.com/blog/stripe-founders-the-story-of-collison-brothers/)). Stripe entered **Y Combinator's W10 batch** ([YC Startup Library](https://www.ycombinator.com/library/Kx-patrick-john-collison-co-founders-of-stripe)) and raised a 2011 seed round of **$2M including PayPal co-founders Elon Musk and Peter Thiel + Sequoia Capital**. The first customer was YC company 280 North; its founder Ross Boucher later joined Stripe as one of the first employees. As of 2024-2025 Stripe is valued at **~$159B** ([Founded.com](https://www.founded.com/how-two-irish-brothers-built-stripe-the-online-payments-startup-now-worth-159-billion/)).
-
-The founding rejection was of every incumbent payment processor that treated integration as a multi-week enterprise-sales procurement cycle. Stripe's first pitch was, essentially: *"what if it took seven lines of code instead."*
-
-That developer-first framing shaped everything that came after: the API as the product, the docs as an interface, *"Growing the GDP of the internet"* as a mission statement that reads like an economist wrote it, and the company's obsession with reliability (99.999% uptime as a stated number, not a marketing claim). **Stripe Press** — the company's publishing imprint with the tagline *"Ideas for progress"* — makes the intellectual posture explicit: this is a company that takes ideas seriously enough to commission and print books about maintenance, scientific freedom, and efficiency.
-
-What Stripe refuses: sales-driven UX (no "Request a demo" gating of basic functionality), hype-driven marketing (no "revolutionary" superlatives), and the visual aesthetics of legacy financial services (institutional blue, corporate stock photography). What it embraces: developer-readable prose, mathematically tight typography, blue-tinted chromatic shadows that feel like atmospheric depth rather than decoration, and a restraint that signals "we plan to be here for decades".
+Stripe describes itself as a technology company building economic infrastructure for the internet. Its newsroom names Patrick Collison as co-founder and CEO and John Collison as co-founder and president, and says businesses from new startups to public companies use Stripe to accept payments and manage their businesses online. That current, first-party positioning is the basis for this reference; no unsupported origin story, valuation, customer, or historical milestone is added here.
 
 ## 12. Principles
 
-1. **Details are the product.** Stripe's own values statement says *"We focus on the details of everything we do."* A design system that gets a letter-spacing wrong on a pricing page is as broken as a payment intent that fails silently. Both cost trust.
-2. **Rigorous thinking, visible in the output.** The company states that *"Successful Stripes are rigorous thinkers who appreciate that things worth doing are rarely simple."* Design artifacts should reveal that rigor — precise tokens, tight typography, documented rationale. Hand-wavy design is not Stripe.
-3. **Kindness and boldness, calibrated.** From Stripe's values: *"We try to embrace kindness while still encouraging Stripes to take measured risks and act boldly."* In design this reads as: warm typography choices (the -0.96px tracking has personality), but no design feature exists just to be clever. Measured boldness, never showboating.
-4. **Ship today, infrastructure for decades.** Another stated value: *"We need to get projects done today, while building infrastructure that the internet will rely upon for decades."* Design decisions should not be trendy. A pill-radius button on a Stripe surface ages badly in four years; the 4px corner does not.
-5. **Lightness signals confidence.** Weight 300 at display sizes is the most un-Silicon-Valley-default choice in the system. Headlines that don't shout signal authority that doesn't need volume.
-6. **Chromatic shadows as brand.** `rgba(50,50,93,0.25)` is not just depth — it is Stripe's navy palette reappearing in the shadow layer. Generic gray shadows would make the UI indistinguishable from any other SaaS.
-7. **No pill buttons.** The 4px radius is a typographic commitment, not a visual preference. Stripe reads as engineering; pills would read as consumer app.
-8. **Developer as first-class user.** Documentation is a design surface. API reference is a design surface. Error messages are a design surface. Marketing does not outrank developer experience; they are peers.
-9. **Numbers are first-class citizens.** `"tnum"` for every financial figure, every table, every chart axis. Numbers are typography with different rules, not body text that happens to be digits.
+1. **Users first.** Work backwards from user needs; a Docs interface should make the next implementation decision easier to locate.
+   *UI implication:* preserve direct labels and source provenance instead of decorative ambiguity.
+2. **Create with craft and beauty.** Stripe states that careful thought can make work surprisingly great.
+   *UI implication:* compact spacing and quiet hierarchy must remain legible, not merely minimal.
+3. **Move with urgency and focus.** Speed should not erase the investment that makes later work faster.
+   *UI implication:* prefer predictable Docs controls and stable evidence boundaries over speculative variants.
+4. **Stay curious.** Stripe describes its work as ongoing learning about businesses and the world.
+   *UI implication:* leave unknown font/state fields absent and make a future evidence need explicit.
 
 ## 13. Personas
 
-*Personas below are fictional archetypes informed by publicly observable Stripe user segments (indie developers, startup founders, finance operations at mid-market companies, enterprise engineers), not individual people.*
+The following are stakeholder groups, not synthetic user-satisfaction claims.
 
-**Tiffany Okonkwo, 31, Lagos.** Solo indie developer launching a course-selling platform. Has integrated Stripe Checkout in an afternoon using the docs as her only guide. Measures her trust in a tool by how well the error messages explain themselves when something goes wrong. Finds Stripe's API errors the friendliest-to-debug of any payment provider she has tried. Would never use a payment processor whose primary CTA was "Book a demo" — it signals they don't trust developers to integrate without a salesperson.
+**Developer integrating Stripe.** Needs public Docs and API-reference navigation that exposes exact implementation information without pretending a marketing or Dashboard surface is the same system.
 
-**Yuto Sasaki, 36, Tokyo.** Staff engineer at a Series-C SaaS startup, responsible for the billing infrastructure. Reads Stripe's docs the way a classical musician reads a score — for the notation, not just the music. Has opinions about webhook retry semantics. Cares that the `invoice` object contract is stable across API versions because his company's ledger depends on it. Notices immediately when a SaaS product's pricing page uses phrases like "Unleash your growth" and mentally downgrades the company.
+**Business operator evaluating Stripe.** Needs the first-party account of Stripe’s economic-infrastructure role and product breadth; detailed brand claims must remain tied to official context rather than inferred visual tokens.
 
-**Mariana Valdés, 44, Mexico City.** Head of Finance Operations at a regional e-commerce company processing ~$200M annually through Stripe. Does not write code but works daily in the Stripe Dashboard. Values the product's density — she can scan 300 transactions at a glance because the tabular numerals align. Would be annoyed by any "redesign" that added whitespace at the expense of data density. Trusts the Stripe brand in part because Stripe Press publishes books she actually reads on long flights.
-
-**Arjun Menon, 27, Bangalore.** Founding engineer at a B2B fintech startup. Builds on Stripe Connect because it is the only realistic way to launch an embedded-payments product in under six months. Reads Stripe's engineering blog for reference implementations. Views the *"Growing the GDP of the internet"* tagline as earnest rather than grandiose — he believes the claim literally and that's why he chose Stripe.
+**Design or documentation contributor.** Needs clear boundaries between current Docs chrome, brand assets, declared fonts, and unobserved product UI so a local reuse does not become a false Stripe clone.
 
 ## 14. States
 
-| State | Treatment |
-|---|---|
-| **Empty (dashboard, no transactions)** | White canvas. Single sentence in Deep Navy (`#061b31`) at 18px sohne-var weight 300: "No transactions yet." One Stripe Purple CTA: "Test a payment". No illustration. Honest about what the empty state means — no activity has happened yet. |
-| **Empty (report, zero rows)** | Slate (`#64748d`) single line at 14px: "Nothing to show for this period." Filter summary visible above so user can adjust scope. Never an illustration, never "No data found". |
-| **Loading (dashboard first paint)** | Skeleton blocks at exact final dimensions in Border Default (`#e5edf5`). 1.2s shimmer. Tabular-number skeletons use narrow bars matching `tnum` width — never wider than the final value. |
-| **Loading (table in-place refresh)** | Subtle Stripe Purple 2px progress bar below the header. Previous content stays visible with previous values. Never block the table during refresh. |
-| **Error (API call failed, dashboard)** | Inline banner below the action. Ruby-adjacent tone (Ruby `#ea2261` border, tinted background). Message = error type + one-line plain-English explanation + "View in logs" link. No generic "Something went wrong". |
-| **Error (form validation)** | Field-level. Ruby border + 13px error text below field. The message describes what specifically is invalid and what would be valid — not just "Required". |
-| **Error (payment declined)** | Dedicated state. Returns the decline code verbatim (`Card declined: insufficient_funds`) plus plain-language guidance for the end customer. Developer and customer both know exactly what happened. |
-| **Success (payment succeeded)** | Brief inline confirmation. Success Green (`#15be53`, 0.2 alpha background) with `#108c3d` text: "Succeeded". Full transaction detail linked immediately below. No toast — the row itself shows the state. |
-| **Success (action saved)** | 3s auto-dismiss toast at top-right. Sentence case, past tense: "Invoice saved." No emoji, no exclamation. |
-| **Skeleton** | Border Default blocks at final dimensions. Blue-tinted shimmer (consistent with shadow system). Amount skeletons always narrower than the longest expected value — a wide skeleton that shrinks is disorienting. |
-| **Disabled** | Opacity reduced on surface and text together. Purple actions become `rgba(83,58,253,0.3)` — faded purple, not switched to gray, to preserve brand read. |
-| **API rate-limited (429)** | Banner surfaces the specific rate-limit category plus concrete retry-after guidance. Documented in the same voice as the docs — no apology, just mechanism. |
+No reusable Docs state matrix is published from this packet. The only retained control-state observations are the search-prompt and secondary-action focus/hover/pressed samples and the static selected tab in §4. Error, loading, success, empty, disabled, menu, dialog, and toast states require a future selector-backed capture.
 
 ## 15. Motion & Easing
 
-**Durations**:
-
-| Token | Value | Use |
-|---|---|---|
-| `motion-instant` | 0ms | State commits, selection ticks, focus rings |
-| `motion-fast` | 120ms | Hover, focus, button press overlays |
-| `motion-standard` | 200ms | Sheet, modal, dropdown, table-row expand |
-| `motion-slow` | 320ms | Page-level transitions, rare hero reveals |
-
-**Easings**:
-
-| Token | Curve | Use |
-|---|---|---|
-| `ease-enter` | `cubic-bezier(0.2, 0.6, 0.25, 1)` | Arriving — sheets, dropdowns, floating panels |
-| `ease-exit` | `cubic-bezier(0.4, 0.0, 1, 1)` | Dismissals |
-| `ease-standard` | `cubic-bezier(0.25, 0.1, 0.25, 1)` | Two-way transitions |
-
-**Explicitly forbidden.** No spring, no overshoot, no bounce. No `cubic-bezier` with a middle control value above `1.0` anywhere. Spring easings read as consumer-app delight; this is payments infrastructure. Infrastructure is steady.
-
-**Signature motions.**
-
-1. **Dashboard table row reveal.** New rows appearing during live event streams (webhook events, payment events) use `motion-standard / ease-enter` with a 3px fade-in-from-below. Never slide in from the side — the table's temporal order is always top-down and sideways motion would suggest a different meaning.
-2. **Gradient decoration.** On marketing surfaces, the ruby-to-magenta gradient decoration shifts hue at slow 20-second cycles using `linear` easing. This is the one place non-standard timing lives — the gradient is ambient atmosphere, not interactive.
-3. **Dark section transition.** On marketing pages, transitioning into a `#1c1e54` brand-dark section uses `motion-slow` background crossfade. Headlines do not move during the transition; the ambient light level is what changes. Cinematic-once, intentional.
-4. **Reduce motion.** Under `prefers-reduced-motion: reduce`, all `motion-*` tokens collapse to `motion-instant`. The ambient gradient freezes. Table row reveals become instantaneous. The dashboard remains fully functional; there is no delightful motion at the cost of accessibility.
-
-<!--
-OmD v0.1 Sources — Philosophy Layer (sections 10–15)
-
-Direct verification via WebFetch (2026-04-19):
-- https://stripe.com/jobs — confirms Stripe's publicly stated operating principles
-  and values (verbatim):
-    "We focus on the details of everything we do, so businesses around the
-     world can focus on what's most important to them."
-    "Successful Stripes are rigorous thinkers who appreciate that things
-     worth doing are rarely simple."
-    "We try to embrace kindness while still encouraging Stripes to take
-     measured risks and act boldly."
-    "We need to get projects done today, while building infrastructure
-     that the internet will rely upon for decades."
-  Confirms mission phrase "Growing the GDP of the internet" and the Collison
-  brothers (John and Patrick) as founders/leadership on the page.
-- https://stripe.com/about — confirms current core positioning "Financial
-  infrastructure to grow your revenue" and the published reliability number
-  ("99.999% historical uptime").
-- https://press.stripe.com/ — confirms Stripe Press tagline "Ideas for progress"
-  and stated purpose: "Stripe Press highlights ideas that we think can be
-  broadly useful." Catalog confirms the intellectual register of the imprint
-  (Tyler Cowen's Stubborn Attachments, Richard Hamming's Art of Doing Science
-  and Engineering, Will Larson's An Elegant Puzzle, Nadia Eghbal's
-  Working in Public, among others).
-
-Base DESIGN.md (sections 1–9) is the source for all token-level claims
-(Stripe Purple #533afd, Deep Navy #061b31, sohne-var with "ss01" stylistic set,
-weight-300 signature, blue-tinted multi-layer shadows, 4–8px radius scale,
-"tnum" for financial data).
-
-Not independently verified via WebFetch — widely documented public facts used:
-- Stripe was founded in 2010 by Patrick and John Collison (Irish brothers).
-- Stripe is headquartered in San Francisco and Dublin.
-- The company's original codename was "/dev/payments" before being renamed Stripe.
-- Stripe Press is the company's publishing imprint (launched ~2018).
-
-Personas (§13) are fictional archetypes informed by publicly observable Stripe
-user segments (indie developers, startup founders, finance operations at
-mid-market companies, enterprise engineers). Names are illustrative; they do
-not refer to real people.
-
-Interpretive claims (e.g., "the 4px radius is a typographic commitment, not
-a visual preference", "developer-first framing as a founding rejection of
-enterprise procurement cycles") are editorial readings connecting Stripe's
-stated values to its design system, not directly sourced Stripe statements.
--->
-
+No motion duration, easing curve, or reduced-motion behavior was measured in the supplied evidence. Omit motion tokens rather than inventing a Stripe motion system.