WS
Docs /Design Tokens

Design Tokens

Variables CSS injectées dans <head> via la directive @wsStyles.

Couleur primaire (HSL)

La couleur principale est définie via trois tokens HSL, ce qui permet de générer automatiquement toutes les teintes (hover, focus ring, etc.).

config/ws.php
'tokens' => [
    // Bleu (défaut)
    'primary-h' => '221',
    'primary-s' => '83%',
    'primary-l' => '53%',

    // Vert émeraude
    // 'primary-h' => '160',
    // 'primary-s' => '84%',
    // 'primary-l' => '39%',

    // Violet
    // 'primary-h' => '263',
    // 'primary-s' => '70%',
    // 'primary-l' => '50%',
],
Exemples de couleurs primaires

Border radius

config/ws.php
'tokens' => [
    'radius-sm'   => '0.25rem',  // --ds-radius-sm
    'radius-md'   => '0.375rem', // --ds-radius-md
    'radius-lg'   => '0.5rem',   // --ds-radius-lg
    'radius-xl'   => '0.75rem',  // --ds-radius-xl
    'radius-2xl'  => '1rem',     // --ds-radius-2xl
    'radius-full' => '9999px',   // --ds-radius-full
],

Typographie

config/ws.php
'tokens' => [
    'font-sans' => "'Inter', ui-sans-serif, system-ui, sans-serif",
],

Ombres

config/ws.php
'tokens' => [
    'shadow-sm' => '0 1px 2px 0 rgb(0 0 0 / .05)',
    'shadow-md' => '0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1)',
    'shadow-lg' => '0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1)',
    'shadow-xl' => '0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1)',
],

Transitions

config/ws.php
'tokens' => [
    'transition-fast'   => '100ms ease',
    'transition-normal' => '180ms ease',
    'transition-slow'   => '300ms ease',
],

Référence complète des variables CSS

CSS généré (exemple)
::root {
  --ds-primary-h: 221;
  --ds-primary-s: 83%;
  --ds-primary-l: 53%;
  --ds-radius-sm: 0.25rem;
  --ds-radius-md: 0.375rem;
  --ds-radius-lg: 0.5rem;
  --ds-radius-xl: 0.75rem;
  --ds-radius-2xl: 1rem;
  --ds-radius-full: 9999px;
  --ds-font-sans: 'Instrument Sans', ui-sans-serif, system-ui, sans-serif;
  --ds-transition-fast: 100ms ease;
  --ds-transition-normal: 180ms ease;
  --ds-transition-slow: 300ms ease;
  --ds-shadow-sm: 0 1px 2px 0 rgb(0 0 0 / .05);
  --ds-shadow-md: 0 4px 6px -1px rgb(0 0 0 / .1);
  --ds-shadow-lg: 0 10px 15px -3px rgb(0 0 0 / .1);
  --ds-shadow-xl: 0 20px 25px -5px rgb(0 0 0 / .1);
}