@paraxe/design 1.0.0

package/src/tokens.css

@@ -0,0 +1,635 @@
+/* ==========================================================================
+   @loba/design — tokens.css
+   LAYER 1 — STRUCTURAL DESIGN TOKENS
+
+   Loba Design v1.1
+   Theme-independent, non-color values.
+
+   Single source of truth for the structural design language of the
+   entire Loba ecosystem.
+
+   Consumed directly by:
+     - @loba/ui
+     - @loba/design/components.css
+     - project-owned HTML/CSS
+     - generated Loba CLI projects
+
+   v1.1 additions:
+     - expanded semantic typography vocabulary
+     - display typography roles
+     - eyebrow / label / section typography roles
+     - section composition anchors
+     - layout composition anchors
+     - media / aspect-ratio anchors
+     - button size structure
+     - form structure
+     - badge structure
+     - navigation structure
+     - accessibility geometry
+     - responsive breakpoints
+
+   ❌ colors → themes/*.css
+   ❌ font @imports → presets/*.css
+   ❌ component implementations → components.css / @loba/ui
+   ========================================================================== */
+
+:root {
+
+  /* =====================================================
+     SPACING SCALE
+     4px base
+     ===================================================== */
+
+  --space-0: 0px;
+  --space-px: 1px;
+
+  --space-1: 0.25rem;
+  --space-2: 0.5rem;
+  --space-3: 0.75rem;
+  --space-4: 1rem;
+  --space-5: 1.25rem;
+  --space-6: 1.5rem;
+  --space-7: 1.75rem;
+  --space-8: 2rem;
+  --space-9: 2.25rem;
+  --space-10: 2.5rem;
+  --space-11: 2.75rem;
+  --space-12: 3rem;
+  --space-14: 3.5rem;
+  --space-16: 4rem;
+  --space-20: 5rem;
+  --space-24: 6rem;
+  --space-28: 7rem;
+  --space-32: 8rem;
+  --space-36: 9rem;
+  --space-40: 10rem;
+  --space-44: 11rem;
+  --space-48: 12rem;
+  --space-52: 13rem;
+  --space-56: 14rem;
+  --space-60: 15rem;
+  --space-64: 16rem;
+  --space-72: 18rem;
+  --space-80: 20rem;
+  --space-96: 24rem;
+
+
+  /* =====================================================
+     SPACING ROLES
+     ===================================================== */
+
+  --section-spacing: var(--space-24);
+  --section-spacing-sm: var(--space-16);
+  --section-spacing-lg: var(--space-32);
+
+  --container-padding: var(--space-6);
+  --container-padding-lg: var(--space-8);
+
+  --card-padding: var(--space-6);
+  --card-padding-sm: var(--space-4);
+  --card-padding-lg: var(--space-8);
+
+  --stack-gap: var(--space-4);
+  --stack-gap-sm: var(--space-2);
+  --stack-gap-lg: var(--space-8);
+
+  --inline-gap: var(--space-3);
+  --inline-gap-sm: var(--space-2);
+  --inline-gap-lg: var(--space-6);
+
+  --grid-gap: var(--space-6);
+  --grid-gap-sm: var(--space-4);
+  --grid-gap-lg: var(--space-8);
+
+  --grid-min: 16rem;
+
+
+  /* =====================================================
+     LAYOUT
+     ===================================================== */
+
+  --container-max-width: 1280px;
+  --container-wide: 1440px;
+  --container-narrow: 768px;
+
+  --container-gutter: 1.5rem;
+  --container-gutter-lg: 2rem;
+
+  --content-width-narrow: 65ch;
+  --content-width-readable: 72ch;
+  --content-width-wide: 80ch;
+
+
+  /* =====================================================
+     SECTION COMPOSITION
+     ===================================================== */
+
+  --section-inner-max-width: var(--container-max-width);
+
+  --section-header-max-width: 720px;
+  --section-header-wide-max-width: 1000px;
+
+  --section-header-gap: var(--space-4);
+  --section-header-title-gap: var(--space-3);
+  --section-header-description-gap: var(--space-4);
+
+  --section-header-margin-bottom: var(--space-16);
+  --section-header-margin-bottom-sm: var(--space-12);
+  --section-header-margin-bottom-lg: var(--space-20);
+
+  --section-content-gap: var(--space-12);
+
+  --section-radius: var(--radius-3xl);
+
+
+  /* =====================================================
+     SECTION RHYTHM
+     Background roles reference theme tokens.
+     Structural only — no colours defined here.
+     ===================================================== */
+
+  --section-bg-inverse: var(--text-primary);
+  --section-bg-base: var(--background-secondary);
+  --section-bg-raised: var(--surface-raised);
+  --section-bg-surface: var(--surface-card);
+  --section-bg-subtle: var(--surface-base);
+  --section-bg-brand: var(--brand-primary-muted);
+
+
+  /* =====================================================
+     Z-INDEX
+     ===================================================== */
+
+  --z-base: 0;
+  --z-floor: 10;
+  --z-sticky: 30;
+  --z-navbar: 50;
+  --z-dropdown: 70;
+  --z-overlay: 80;
+  --z-modal: 90;
+  --z-popover: 95;
+  --z-tooltip: 100;
+
+
+  /* =====================================================
+     TYPOGRAPHY — FAMILIES
+     ===================================================== */
+
+  --font-family-display:
+    "Plus Jakarta Sans",
+    ui-sans-serif,
+    system-ui,
+    -apple-system,
+    "Segoe UI",
+    Roboto,
+    "Helvetica Neue",
+    Arial,
+    "Noto Sans";
+
+  --font-family-body:
+    "Plus Jakarta Sans",
+    ui-sans-serif,
+    system-ui,
+    -apple-system,
+    "Segoe UI",
+    Roboto,
+    "Helvetica Neue",
+    Arial,
+    "Noto Sans";
+
+  --font-family-mono:
+    "JetBrains Mono",
+    "Fira Code",
+    monospace;
+
+
+  /* =====================================================
+     TYPOGRAPHY — WEIGHTS
+     ===================================================== */
+
+  --font-weight-light: 300;
+  --font-weight-regular: 400;
+  --font-weight-medium: 500;
+  --font-weight-semibold: 600;
+  --font-weight-bold: 700;
+  --font-weight-extrabold: 800;
+
+
+  /* =====================================================
+     TYPOGRAPHY — SIZES
+     ===================================================== */
+
+  --font-size-xs: 0.75rem;
+  --font-size-sm: 0.875rem;
+  --font-size-base: 1rem;
+  --font-size-lg: 1.125rem;
+  --font-size-xl: 1.25rem;
+  --font-size-2xl: 1.5rem;
+  --font-size-3xl: 1.875rem;
+  --font-size-4xl: 2.25rem;
+  --font-size-5xl: 3rem;
+  --font-size-6xl: 3.75rem;
+  --font-size-7xl: 4.5rem;
+  --font-size-8xl: 6rem;
+  --font-size-9xl: 8rem;
+
+
+  /* =====================================================
+     TYPOGRAPHY — LINE HEIGHTS
+     ===================================================== */
+
+  --line-height-none: 1;
+  --line-height-tight: 1.1;
+  --line-height-snug: 1.25;
+  --line-height-normal: 1.5;
+  --line-height-relaxed: 1.625;
+  --line-height-loose: 2;
+
+
+  /* =====================================================
+     TYPOGRAPHY — LETTER SPACING
+     ===================================================== */
+
+  --letter-spacing-tighter: -0.04em;
+  --letter-spacing-tight: -0.025em;
+  --letter-spacing-normal: 0em;
+  --letter-spacing-wide: 0.025em;
+  --letter-spacing-wider: 0.05em;
+  --letter-spacing-widest: 0.1em;
+
+
+  /* =====================================================
+     TYPOGRAPHY — SEMANTIC SCALE
+     ===================================================== */
+
+  --typography-display-size: var(--font-size-8xl);
+  --typography-display-weight: var(--font-weight-extrabold);
+  --typography-display-lineheight: var(--line-height-tight);
+  --typography-display-letterspacing: var(--letter-spacing-tighter);
+
+  --typography-h1-size: var(--font-size-6xl);
+  --typography-h2-size: var(--font-size-4xl);
+  --typography-h3-size: var(--font-size-3xl);
+  --typography-h4-size: var(--font-size-2xl);
+
+  --typography-heading-weight: var(--font-weight-semibold);
+  --typography-heading-lineheight: var(--line-height-tight);
+  --typography-heading-letterspacing: var(--letter-spacing-tight);
+
+  --typography-lead-size: var(--font-size-xl);
+  --typography-lead-lineheight: var(--line-height-relaxed);
+  --typography-lead-weight: var(--font-weight-regular);
+
+  --typography-body-size: var(--font-size-base);
+  --typography-body-lineheight: var(--line-height-normal);
+  --typography-body-weight: var(--font-weight-regular);
+
+  --typography-body-large-size: var(--font-size-lg);
+  --typography-body-large-lineheight: var(--line-height-relaxed);
+
+  --typography-caption-size: var(--font-size-sm);
+  --typography-caption-lineheight: var(--line-height-normal);
+
+  --typography-overline-size: var(--font-size-xs);
+  --typography-overline-lineheight: var(--line-height-snug);
+  --typography-overline-weight: var(--font-weight-semibold);
+  --typography-overline-letterspacing: var(--letter-spacing-wider);
+
+  --typography-eyebrow-size: var(--font-size-sm);
+  --typography-eyebrow-lineheight: var(--line-height-none);
+  --typography-eyebrow-weight: var(--font-weight-bold);
+  --typography-eyebrow-letterspacing: var(--letter-spacing-wider);
+
+  --typography-label-size: var(--font-size-sm);
+  --typography-label-lineheight: var(--line-height-snug);
+  --typography-label-weight: var(--font-weight-semibold);
+  --typography-label-letterspacing: var(--letter-spacing-wide);
+
+  --typography-section-title-size: var(--font-size-5xl);
+  --typography-section-title-lineheight: var(--line-height-tight);
+  --typography-section-title-weight: var(--font-weight-bold);
+  --typography-section-title-letterspacing: var(--letter-spacing-tight);
+
+  --typography-section-description-size: var(--font-size-base);
+  --typography-section-description-lineheight: var(--line-height-relaxed);
+
+  --typography-nav-size: var(--font-size-sm);
+  --typography-nav-weight: var(--font-weight-medium);
+
+  --typography-button-size: var(--font-size-sm);
+  --typography-button-weight: var(--font-weight-medium);
+  --typography-button-lineheight: var(--line-height-none);
+
+  --typography-code-size: var(--font-size-sm);
+
+
+  /* =====================================================
+     RADIUS
+     ===================================================== */
+
+  --radius-none: 0px;
+  --radius-sm: 0.125rem;
+  --radius-base: 0.25rem;
+  --radius-md: 0.375rem;
+  --radius-lg: 0.5rem;
+  --radius-xl: 0.75rem;
+  --radius-2xl: 1rem;
+  --radius-3xl: 1.5rem;
+  --radius-full: 9999px;
+
+
+  /* =====================================================
+     SHADOWS
+     Structural values only.
+     Brand tint is applied in theme tokens.
+     ===================================================== */
+
+  --shadow-sm:
+    0 1px 2px 0 rgb(0 0 0 / 0.05);
+
+  --shadow-base:
+    0 1px 3px 0 rgb(0 0 0 / 0.1),
+    0 1px 2px -1px rgb(0 0 0 / 0.1);
+
+  --shadow-md:
+    0 4px 6px -1px rgb(0 0 0 / 0.1),
+    0 2px 4px -2px rgb(0 0 0 / 0.1);
+
+  --shadow-lg:
+    0 10px 15px -3px rgb(0 0 0 / 0.1),
+    0 4px 6px -4px rgb(0 0 0 / 0.1);
+
+  --shadow-xl:
+    0 20px 25px -5px rgb(0 0 0 / 0.1),
+    0 8px 10px -6px rgb(0 0 0 / 0.1);
+
+  --shadow-2xl:
+    0 25px 50px -12px rgb(0 0 0 / 0.25);
+
+  --shadow-inner:
+    inset 0 2px 4px 0 rgb(0 0 0 / 0.05);
+
+
+  /* =====================================================
+     MOTION — DURATIONS
+     ===================================================== */
+
+  --motion-duration-fast: 150ms;
+  --motion-duration-normal: 300ms;
+  --motion-duration-slow: 500ms;
+  --motion-duration-slower: 700ms;
+  --motion-duration-slowest: 1000ms;
+
+
+  /* =====================================================
+     MOTION — EASINGS
+     ===================================================== */
+
+  --motion-ease-in:
+    cubic-bezier(0.4, 0, 1, 1);
+
+  --motion-ease-out:
+    cubic-bezier(0, 0, 0.2, 1);
+
+  --motion-ease-in-out:
+    cubic-bezier(0.4, 0, 0.2, 1);
+
+  --motion-ease-spring:
+    cubic-bezier(0.175, 0.885, 0.32, 1.275);
+
+  --motion-ease-smooth:
+    cubic-bezier(0.22, 1, 0.36, 1);
+
+
+  /* =====================================================
+     MOTION — COMBINATORS
+     ===================================================== */
+
+  --motion-fast:
+    var(--motion-duration-fast)
+    var(--motion-ease-out);
+
+  --motion-normal:
+    var(--motion-duration-normal)
+    var(--motion-ease-smooth);
+
+  --motion-slow:
+    var(--motion-duration-slow)
+    var(--motion-ease-smooth);
+
+  --motion-slower:
+    var(--motion-duration-slower)
+    var(--motion-ease-smooth);
+
+  --ease-standard: var(--motion-ease-out);
+  --ease-smooth: var(--motion-ease-smooth);
+  --ease-spring: var(--motion-ease-spring);
+
+  --transition-fast:
+    all var(--motion-duration-fast) var(--motion-ease-out);
+
+  --transition-normal:
+    all var(--motion-duration-normal) var(--motion-ease-smooth);
+
+  --transition-slow:
+    all var(--motion-duration-slow) var(--motion-ease-smooth);
+
+
+  /* =====================================================
+     COMPONENT STRUCTURE — BUTTONS
+     ===================================================== */
+
+  --button-radius: var(--radius-full);
+
+  --button-padding-x: 1.5rem;
+  --button-padding-y: 0.75rem;
+
+  --button-padding-x-sm: 1rem;
+  --button-padding-y-sm: 0.5rem;
+
+  --button-padding-x-lg: 2rem;
+  --button-padding-y-lg: 1rem;
+
+  --button-gap: 0.5rem;
+
+  --button-min-height: 44px;
+  --button-min-height-sm: 36px;
+  --button-min-height-lg: 52px;
+
+  --button-icon-size: 1rem;
+  --button-icon-size-sm: 0.875rem;
+  --button-icon-size-lg: 1.125rem;
+
+
+  /* =====================================================
+     COMPONENT STRUCTURE — CARDS
+     ===================================================== */
+
+  --card-radius: var(--radius-lg);
+
+  --card-padding: var(--space-6);
+  --card-padding-sm: var(--space-4);
+  --card-padding-lg: var(--space-8);
+
+  --card-content-gap: var(--space-4);
+
+
+  /* =====================================================
+     COMPONENT STRUCTURE — BADGES
+     ===================================================== */
+
+  --badge-radius: var(--radius-full);
+
+  --badge-padding-x: var(--space-3);
+  --badge-padding-y: var(--space-1);
+
+  --badge-gap: var(--space-1);
+
+  --badge-min-height: 24px;
+
+/* =====================================================
+   COMPONENT STRUCTURE — TAGS
+   ===================================================== */
+
+--tag-radius: var(--radius-md);
+
+--tag-padding-x: var(--space-2);
+--tag-padding-y: var(--space-1);
+
+--tag-gap: var(--space-1);
+
+--tag-min-height: 24px;
+
+  /* =====================================================
+     COMPONENT STRUCTURE — NAVIGATION
+     ===================================================== */
+
+  --nav-height: 4.5rem;
+  --nav-height-sm: 4rem;
+
+  --nav-padding-x: var(--container-padding);
+  --nav-padding-x-lg: var(--container-padding-lg);
+
+  --nav-blur: 12px;
+
+  --nav-link-padding-x: 0.75rem;
+  --nav-link-padding-y: 0.5rem;
+
+  --nav-link-radius: var(--radius-md);
+
+  --nav-gap: var(--space-2);
+  --nav-content-gap: var(--space-8);
+
+
+  /* =====================================================
+     COMPONENT STRUCTURE — FORMS
+     ===================================================== */
+
+  --form-height: 44px;
+  --form-height-sm: 36px;
+  --form-height-lg: 52px;
+
+  --form-padding-x: 1rem;
+  --form-padding-y: 0.75rem;
+
+  --form-radius: var(--radius-md);
+
+  --form-gap: var(--space-2);
+
+  --form-label-gap: var(--space-2);
+  --form-field-gap: var(--space-4);
+
+  --form-textarea-min-height: 120px;
+
+
+  /* =====================================================
+     COMPONENT STRUCTURE — MEDIA
+     ===================================================== */
+
+  --media-radius: var(--radius-lg);
+  --media-radius-sm: var(--radius-md);
+  --media-radius-lg: var(--radius-2xl);
+
+  --media-aspect-square: 1 / 1;
+  --media-aspect-video: 16 / 9;
+  --media-aspect-wide: 21 / 9;
+  --media-aspect-portrait: 4 / 5;
+  --media-aspect-tall: 3 / 4;
+
+
+  /* =====================================================
+     COMPONENT STRUCTURE — ICONS
+     ===================================================== */
+
+  --icon-size-xs: 0.75rem;
+  --icon-size-sm: 1rem;
+  --icon-size-md: 1.25rem;
+  --icon-size-lg: 1.5rem;
+  --icon-size-xl: 2rem;
+
+  --icon-button-size-sm: 36px;
+  --icon-button-size: 44px;
+  --icon-button-size-lg: 52px;
+
+
+  /* =====================================================
+     COMPONENT STRUCTURE — FOCUS
+     ===================================================== */
+
+  --focus-ring-width: 2px;
+  --focus-ring-offset: 2px;
+  --focus-ring-offset-lg: 4px;
+
+
+  /* =====================================================
+     RESPONSIVE BREAKPOINTS
+     Structural reference values.
+
+     These are primarily consumed by build tooling / documentation.
+     CSS media queries may use the values directly where supported
+     through project-owned breakpoint definitions.
+     ===================================================== */
+
+  --breakpoint-sm: 640px;
+  --breakpoint-md: 768px;
+  --breakpoint-lg: 1024px;
+  --breakpoint-xl: 1280px;
+  --breakpoint-2xl: 1536px;
+
+
+  /* =====================================================
+     CONTENT / COMPOSITION LIMITS
+     ===================================================== */
+
+  --prose-measure: 65ch;
+  --prose-measure-wide: 75ch;
+
+  --text-max-width-sm: 36rem;
+  --text-max-width-md: 48rem;
+  --text-max-width-lg: 64rem;
+
+
+  /* =====================================================
+     ASPECT / GRID COMPOSITION
+     ===================================================== */
+
+
+  --grid-min-width-sm: 12rem;
+  --grid-min-width: 16rem;
+  --grid-min-width-lg: 20rem;
+
+
+  /* =====================================================
+     MOTION / INTERACTION ANCHORS
+     ===================================================== */
+
+  --interaction-lift-sm: -1px;
+  --interaction-lift: -2px;
+  --interaction-lift-lg: -4px;
+
+  --interaction-scale-sm: 0.98;
+  --interaction-scale: 0.97;
+
+  --interaction-opacity-disabled: 0.5;
+
+}