COMPONENT
IntentControlSegmented
Segmented control intent-first : groupe de boutons toggle (single/multi) pour choisir un état, sans navigation.
controlsince 0.2.0
DESIGN SYSTEM
mode
Intent
Variant (DS)
Glow
Intensity
State (DS)
PLAYGROUND
Behavior
Size
Layout
Variants (segments)
inactiveVariant
activeVariant
Options
State (local)
Astuce: en multiple=true, chaque segment devient un toggle (aria-pressed). En single, allowEmpty autorise un “unselect”.
PREVIEW
value: dragons
RESOLVED
{
  "mode": "dark",
  "intent": "informed",
  "variant": "elevated",
  "intensity": "medium",
  "toneEffective": "informed",
  "glowKey": null,
  "glowBackground": null,
  "style": {
    "--intent-bg": "rgb(var(--ids-informed))",
    "--intent-ring": "rgb(var(--ids-informed))",
    "--intent-text": "var(--ids-color-blue-200)",
    "--intent-bg-opacity": "0.16",
    "--intent-ring-opacity": "0.3045",
    "--intent-border": "rgb(var(--ids-informed))",
    "--intent-glow-bg": "",
    "--intent-glow-fill-opacity": "0",
    "--intent-glow-border-opacity": "0",
    "--intent-glow-filter": "none"
  },
  "classes": {
    "base": "intent-surface inline-flex items-center gap-2",
    "surface": "intent-bg",
    "border": "intent-ring",
    "text": "intent-text",
    "ring": "",
    "shadow": "intent-shadow-soft",
    "glow": "",
    "disabled": ""
  },
  "warnings": []
}
PROPS
PropTypeDefault
PROPS SYSTÈME
intent
Intent sémantique (informed/empowered/warned/threatened/themed/toned/glowed).
IntentNameDEFAULT_INTENT
variant
Variant visuel (flat/outlined/elevated/ghost).
VariantNameDEFAULT_VARIANT
tone
Override de tone (n’a d’effet que si intent='toned').
ToneNameDEFAULT_TONE (si toned)
glow
Glow normal (true/false) ou glow esthétique (uniquement si intent='glowed').
boolean | GlowNamefalse (ou DEFAULT_GLOW_BY_INTENT)
intensity
Intensité (soft/medium/strong).
Intensitymedium
mode
Mode colorimétrique (dark/light).
ModeNamedark
disabled
Désactive l’état visuel (hooks + styles).
booleanfalse
PROPS LOCALES
optionsrequis
Segments rendus (value/label, disabled optionnel).
IntentControlSegmentedOption[]—
value
Valeur contrôlée: string|null (single) ou string[] (multiple).
string | null | string[]—
defaultValue
Valeur initiale non contrôlée.
string | null | string[]—
onValueChange
Callback appelé quand la sélection change.
(value: string | null | string[]) => void—
multiple
Active le multi-select (toggle group).
booleanfalse
allowEmpty
En single: autorise aucune sélection (value=null).
booleantrue
size
Taille du segmented control (padding/hauteur/typo).
"xs" | "sm" | "md" | "lg" | "xl"md
fullWidth
Étire le groupe sur toute la largeur.
booleanfalse
inactiveVariant
Variant des segments inactifs.
"ghost" | "outlined" | "flat" | "elevated"ghost
activeVariant
Variant des segments actifs.
"ghost" | "outlined" | "flat" | "elevated"elevated
ariaLabel
Label ARIA du groupe.
stringSegmented control
(native props)
Props natives du div root (id, data-*, style...).
Omit<React.HTMLAttributes<HTMLDivElement>, 'className' | 'children' | 'onChange'>—
TYPES & CONSTANTES
APIValeur / Référence
TYPES
IntentNametype
Type union des intents sémantiques.
"informed" | "empowered" | "warned" | "threatened" | "themed" | "toned" | "glowed"
VariantNametype
Type union des variants visuels.
"flat" | "outlined" | "elevated" | "ghost"
ToneNametype
Type union des tones (familles Tailwind + theme + black).
("slate" | "gray" | ... | "theme" | "black")
GlowNametype
Type union des aesthetic glows (utilisable quand intent='glowed').
"aurora" | "ember" | "cosmic" | "mythic" | "royal" | "mono"
Intensitytype
Intensité des effets (glow/contraste).
"soft" | "medium" | "strong"
ModeNametype
Mode colorimétrique.
"dark" | "light"
CONSTANTES
DEFAULT_INTENTconst
Intent par défaut si aucun intent n’est fourni.
informed
DEFAULT_VARIANTconst
Variant par défaut si aucun variant n’est fourni.
elevated
DEFAULT_GLOW_BY_INTENTconst
Mapping intent → glow par défaut (quand glow est implicite).
DEFAULT_GLOW_BY_INTENT