Migration v2
@alveole/* 1.10 vers 2.0. Chaque section donne : @alveole/components, @alveole/core, @alveole/theme, @alveole/storybook, @alveole/eslint-config → 2.0.0.git grep de chaque section, appliquer les réécritures hint) et le message (error / success) vont sur FormControl, le contrôle nu va dedans.<FormControl label="…" hint="…" error={error} required>
<Controle … error={error} />
</FormControl>
error est passé FormControl affiche le message sous le champ, le contrôle colore sa bordure. Avant, le *Field faisait les deux tout seul.git grep -nE "lucide-react-native|@lucide/lab|@react-native-picker/picker|expo-linear-gradient|react-native-code-highlighter" -- package.json
git grep -nE "from '(lucide-react-native|@lucide/lab|@react-native-picker/picker|expo-linear-gradient)'"
git grep -nE "\b(TextField|TextareaField|EmailField|EmailInput|PasswordField|PhoneField|PhoneInput|NumberField|OtpField|FileField|FormControlNumberInput|FormControlOtpInput|FormControlFileInput)\b"
FormControllabel, labelRight, hint, error, success, required, disabled (et disabled reste aussi sur le contrôle). Tout le reste reste sur le contrôle.FormControl n'était qu'un conteneur : le libellé, l'aide et la légende s'y assemblaient à la main. Il les porte désormais, et relie le libellé au champ (id, required, disabled), ce que la composition manuelle ne fait pas.git grep -nE "<(InputHeading|FormControlLabel|FormControlHint|FormControlCaption)\b"
// Avant
<FormControl>
<InputHeading>
<FormControlLabel label="Adresse email" />
<FormControlHint hint="Votre email professionnel" />
</InputHeading>
<TextInput value={email} onChangeText={setEmail} />
<FormControlCaption error={error} />
</FormControl>
// Après
<FormControl label="Adresse email" hint="Votre email professionnel" error={error}>
<TextInput type="email" value={email} onChangeText={setEmail} error={error} />
</FormControl>
TextField, TextareaField, EmailField, PasswordField, PhoneField, PhoneInput avaient un alias onChange(text: string). TextInput reprend les props de React Native, où onChange reçoit un onChange={setValue} avec un setState non typé).TextInput / TextareaInput : onChange en onChangeText.NumberInput, OtpInput, FileInput, Select, DateInput, TimeInput, DurationInput : leur onChange reçoit toujours la valeur.git grep -nE "<(FileInput|DragAndDropFile)\b"
expo-image-picker, voir Dépendances).multiple : une nouvelle sélection ou un dépôt value ; retirer un removed: true, pour le supprimer côté serveur à l'envoi.onChange(null) : la valeur reste inchangée.DragAndDropFile est supprimé. La FileDropZone enveloppe désormais toute une région (souvent le formulaire entier) et se branche sur le même état que le FileInput. Web uniquement : sur natif, elle rend simplement ses enfants. Elle n'ouvre plus le sélecteur au clic : c'est le bouton du FileInput qui s'en charge.// Avant
<DragAndDropFile label="Pièces jointes" hint="PDF ou image" multiple value={f} onChange={setF} />
// Après
<FileDropZone value={f} onChange={setF} multiple>
<FormControl label="Pièces jointes" hint="PDF ou image">
<FileInput value={f} onChange={setF} multiple />
</FormControl>
</FileDropZone>
label, hint, error, success montent sur FormControl ; leading disparaît. Pour couvrir tout le formulaire, placer FileDropZone autour du formulaire plutôt qu'autour du seul champ.TextField forçait autoComplete="off", textContentType="none", autoCapitalize="sentences". TextInput ne force plus rien. Si un champ doit rester sans remplissage automatique, l'écrire explicitement : <TextInput autoComplete="off" textContentType="none" />. type="text" et type="hidden" de TextField n'avaient aucun effet : retirer type="text" (valeur par défaut de TextInput) et type="hidden", sans autre changement. type="hidden" n'a jamais masqué le champ (ignoré en natif, réécrit en type="text" par react-native-web) : si un appel comptait dessus pour cacher une valeur, ne pas rendre le champ ({visible && <TextInput … />}).// Avant
<TextField
label="Nom"
hint="Tel qu'il apparaît sur la pièce d'identité"
placeholder="Jean Dupont"
value={nom}
onChange={setNom}
error={errors.nom}
/>
// Après
<FormControl label="Nom" hint="Tel qu'il apparaît sur la pièce d'identité" error={errors.nom}>
<TextInput placeholder="Jean Dupont" value={nom} onChangeText={setNom} error={errors.nom} />
</FormControl>
// Avant
<EmailField label="Email" value={email} onChange={setEmail} />
<PasswordField label="Mot de passe" value={password} onChange={setPassword} />
<PhoneField label="Téléphone" value={tel} onChange={setTel} />
// Après
<FormControl label="Email">
<TextInput type="email" value={email} onChangeText={setEmail} />
</FormControl>
<FormControl label="Mot de passe">
<TextInput type="password" value={password} onChangeText={setPassword} />
</FormControl>
<FormControl label="Téléphone">
<TextInput type="tel" value={tel} onChangeText={setTel} />
</FormControl>
// Avant
<TextareaField label="Message" numberOfLines={4} value={msg} onChange={setMsg} />
// Après
<FormControl label="Message">
<TextareaInput numberOfLines={4} value={msg} onChangeText={setMsg} />
</FormControl>
// Avant
<NumberField label="Montant" value={montant} onChange={setMontant} error={err} />
// Après — onChange inchangé : (value: number | null) => void
<FormControl label="Montant" error={err}>
<NumberInput value={montant} onChange={setMontant} error={err} />
</FormControl>
// Avant
<OtpField label="Code reçu" numberOfDigits={6} onChange={setCode} />
// Après — onChange inchangé
<FormControl label="Code reçu">
<OtpInput numberOfDigits={6} onChange={setCode} />
</FormControl>
// Avant
const [file, setFile] = useState<FileFieldValue>(null);
<FileField label="Justificatif" type="application/pdf" value={file} onChange={setFile} />;
// Après — la vérification du type de fichier (alerte « Type de fichier incorrect ») est conservée dans FileInput
const [file, setFile] = useState<FileInputValue>(null);
<FormControl label="Justificatif">
<FileInput type="application/pdf" value={file} onChange={setFile} />
</FormControl>;
ref était passé au *Field, le passer au contrôle (<TextInput ref={ref} />).TextField : label y était hint, labelRight, optional, onChange acceptés… mais label invisible. Ces props n'existent plus.git grep -nE "<TextareaInput\b"
label / hint : les déplacer sur un FormControl autour. ⚠️ Changement visuel : le libellé devient visible. S'il ne doit pas l'être (libellé déjà affiché ailleurs), supprimer simplement la prop.onChange : ne fonctionnait pas avec une chaîne (React Native lui passait un événement) ; renommer en onChangeText.// Avant
<TextareaInput label="Commentaire" value={c} onChangeText={setC} />
// Après (libellé visible)
<FormControl label="Commentaire">
<TextareaInput value={c} onChangeText={setC} />
</FormControl>
git grep -nE "\boptional(Text)?[=:]"
git grep -nE "<(DateInput|TimeInput|DurationInput)\b"
label, labelRight, hint (ni la légende error/success affichée sous le champ pour DateInput). Même règle : on les entoure.// Avant
<DateInput label="Date de naissance" hint="JJ/MM/AAAA" value={date} onChange={setDate} error={err} />
<TimeInput label="Heure" value={heure} onChange={setHeure} />
// Après — onChange inchangé
<FormControl label="Date de naissance" hint="JJ/MM/AAAA" error={err}>
<DateInput value={date} onChange={setDate} error={err} />
</FormControl>
<FormControl label="Heure">
<TimeInput value={heure} onChange={setHeure} />
</FormControl>
git grep -nE "\b(Select|SelectMultiple|SelectInput|NativePicker|Autocomplete|AutocompleteChip|AutocompleteAddress|AutocompleteOption\w*|SelectMultipleOption)\b"
Select couvre tous les cas : simple, multiple, recherche (locale ou distante), création. Il est FormControl) et SelectOption ({ value: string; label: string; leading?; group?; disabled? }), SelectProps, SelectRef, SelectItem. Supprimés : NativePicker, SelectInput, SelectMultipleOption, AutocompleteOption*, isAutocompleteOptionWithGroup*.// Avant
<Select label="Pays" hint="…" options={pays} value={code} onChange={setCode} error={err} />
// Après
<FormControl label="Pays" hint="…" error={err}>
<Select options={pays} value={code} onChange={setCode} error={err} />
</FormControl>
value: string | null, onChange(value: string | null) : inchangés. Ajouter clearable si l'utilisateur doit pouvoir revenir à « aucune valeur ». Le titre du bottom sheet mobile est par défaut le label du FormControl (sinon sheetTitle).// Avant
<SelectMultiple label="Rôles" options={roles} value={ids} onChange={setIds} />
// Après
<FormControl label="Rôles">
<Select multiple options={roles} value={ids} onChange={setIds} />
</FormControl>
value doit être un string[] (plus de number) et [], pas undefined). Les value numériques des options deviennent des chaînes : options.map(o => ({ ...o, value: String(o.value) })), et reconvertir dans onChange si besoin.// Avant : l'état contenait des objets option
const [selected, setSelected] = useState<AutocompleteOption[]>([]);
<Autocomplete label="Client" isSearchable options={clients} value={selected} onChange={setSelected} />;
// lecture : selected[0]?.value
// Après : l'état contient la valeur
const [clientId, setClientId] = useState<string | null>(null);
<FormControl label="Client">
<Select searchable options={clients} value={clientId} onChange={setClientId} />
</FormControl>;
// lecture : clientId
// besoin du libellé : clients.find(c => c.value === clientId)?.label
// Avant : multi + création
<Autocomplete
label="Étiquettes"
isMulti
allowCreate
options={tags}
value={selected}
onChange={(value, meta) => {
setSelected(value);
meta?.created.forEach(save);
}}
/>;
// Après
const [tags, setTags] = useState<SelectOption[]>(initialTags);
const [values, setValues] = useState<string[]>([]);
<FormControl label="Étiquettes">
<Select
multiple
creatable
options={tags}
value={values}
onChange={setValues}
onCreateOption={query => {
// obligatoire : ajouter l'option PUIS la sélectionner, sinon rien ne s'affiche
setTags(current => [...current, { label: query, value: query }]);
setValues(current => [...current, query]);
save(query);
}}
/>
</FormControl>;
disabledFilterSearch + onSearchChange) :<FormControl label="Recherche">
<Select
searchable
localFilter={false}
loading={loading}
emptyMessage="Saisir au moins 3 caractères"
options={resultats}
value={value}
onChange={setValue}
onSearchChange={rechercher}
/>
</FormControl>
// Avant
<AutocompleteAddress
value={value}
suggestions={suggestions}
error={err}
onSearchChange={search}
onPlaceSelected={placeId => selectPlace(placeId)}
onCustomAddress={address => setCustom(address)}
onClear={reset}
/>
// Après
<FormControl label="Adresse" error={err}>
<Select
placeholder="ex : 3 rue Robespierre"
searchable
localFilter={false}
creatable
clearable
emptyMessage="Saisir au moins 3 caractères"
createLabel={query => `Utiliser « ${query} »`}
options={suggestions}
value={placeId}
error={err}
onSearchChange={search}
onChange={value => (value === null ? reset() : selectPlace(value))}
onCreateOption={address => {
setSuggestions(current => [...current, { label: address, value: address }]);
setPlaceId(address);
setCustom(address);
}}
/>
</FormControl>
options, l'option sélectionnée doit rester dans options, sinon son libellé n'est plus affiché dans le champ fermé. Garder l'option retenue en tête de la liste : options={[...selectedOption ? [selectedOption] : [], ...suggestions]}.git grep -nE "startIcon|endIcon|\bicon[=:]"
icon sur ButtonIcon, InputButtonAdornment, DocumentViewerToolbarButton, ni name sur LucideIcon. Renommage mécanique : la valeur (nom d'icône) ne change pas.<Button variant="secondary" title="Filtres" startIcon="Plus" endIcon="ChevronDown" />
// →
<Button variant="secondary" title="Filtres" leading="Plus" trailing="ChevronDown" />
leading={null} retire l'icône par défaut de Toast.name, icon, leading, trailing, IconProps.name…) :git grep -nE "['\"](broom|carton|cartonOff|houses|textSquare|Icon|LucideProvider|createLucideIcon|useLucideContext)['\"]"
git grep -nE "variant=['\"]link['\"]|size=['\"]xs['\"]|\b(noPadding|borderNone|leftAlign)\b|<Button\b[^>]*\bactive\b"
title est désormais Button : toute erreur « Property 'title' is missing » est un bouton-icône à convertir en ButtonIcon. ButtonIcon accepte seulement les variantes primary, secondary, tertiary.// Avant
<Button variant="tertiary" startIcon="Trash" onPress={remove} />
<Button variant="link" title="Voir le dossier" onPress={() => router.push(`/dossiers/${id}`)} />
// Après
<ButtonIcon variant="tertiary" icon="Trash" accessibilityLabel="Supprimer" onPress={remove} />
<Link href={`/dossiers/${id}`}>Voir le dossier</Link>
Link n'accepte qu'une chaîne en children, et href + target (target="_blank" pour un lien externe dans un nouvel onglet web / navigateur intégré en natif).git grep -nE "<Tag\b[^>]*\bcolor=|\b(onActions|actionsIcon)\b|onNavigate="
// Avant
<ToolbarTop title="Dossier" onNavigate={back} onActions={openMenu} actionsIcon="EllipsisVertical" />
// Après
<ToolbarTop
title="Dossier"
onNavigate={back}
navigationLabel="Retour"
actions={<ButtonIcon variant="tertiary" icon="EllipsisVertical" accessibilityLabel="Plus d'actions" onPress={openMenu} />}
/>
Tag, si utiles : selected, interactive, closable + onClose, leading.git grep -nE "<Switch\b"
Switch accepte size (sm, md, lg) et vaut mdsize="lg" à chaque appel :// Avant
<Switch label="Notifications" checked={on} onCheckedChange={setOn} />
// Après
<Switch size="lg" label="Notifications" checked={on} onCheckedChange={setOn} />
git grep -nE "\b(Mandarine|Shakespeare|Pacifika|ButteryWhite|CoralRed|Lochmara|BigStone|LimeGreen|Purple)\b|Inter|Barlow|generateDefaultThemeCSS|generateFontSmoothingCSS|color-(sun|950)\b|illustration"
theme.spacing() (non cassant) mais leurs usages sont à migrer vers l'échelle V/W quand on y passe. Box les refuse (section 8 ter).tamagui / @tamagui/* de l'application au même numéro exact, et aligner la clé allowScripts sur la version des paquets @alveole/* (version unique, ADR 0029).git grep -nE "[^a-zA-Z]animation=|onHover(In|Out)|disablePassBorderRadius"
onHoverIn reste valable sur un Pressable React Native. Ne change pas : tag de Box et Typography, et les éléments DOM rendus (un sélecteur CSS sur data-table reste valable).@tamagui/config v3). Les Typography d'Alveole posent normal par défaut ;position: relative par défautposition: 'relative' sur le conteneur d'un enfant absolu, ou settings.defaultPosition: 'relative' ;flex: 1 devient 1 1 0pxflexGrow: 1, ou settings.styleCompat: 'legacy' ;Image rend un vrai <img> (alt exigé) ; Switch ne compte plus padding ni bordure.^3.0.0 seul.@tamagui/config/v3 et /v4 n'existent plus ; passer à @tamagui/config/v5 avec les animations de @tamagui/config/v5-css ;SafeAreaProviderTamaguiProvider, tests compris ;@tamagui/babel-pluginpackage.json et de babel.config.js ;hoverStyle et ses voisins disparaissent, de Box et Typography aussi (ADR 0031). La valeur de repos et sa clause vivent sur la même prop : backgroundColor={{ default: repos, hover: survol }}, propriété sortie de style.git grep -nwE "hoverStyle|pressStyle|focusStyle|focusVisibleStyle|enterStyle|exitStyle|disabledStyle"
Box n'acceptent plus que les clés du thème (ADR 0033) :p={8} → p="1W", mt="100" → mt="2W" ; les marges gardent 'auto' et les pourcentages ;'sm', 'md', 'lg', 'full' ; 1000 → 'full' ;useTheme().color, 'transparent' ou clause objet { hover } ; une couleur venue des données passe par style.git grep -nE "\b(TextField|TextareaField|EmailField|EmailInput|PasswordField|PhoneField|PhoneInput|NumberField|OtpField|FileField|SelectMultiple|Autocomplete\w*|NativePicker|SelectInput)\b|startIcon|endIcon|variant=['\"]link['\"]|size=['\"]xs['\"]|noPadding|borderNone|leftAlign|\boptional(Text)?[=:]|onActions|actionsIcon|<Tag\b[^>]*\bcolor=|Inter-|Barlow-"
FormControl error) error du contrôle) ;TextInput avec onChange= (doit être onChangeText=) : git grep -nE "<(TextInput|TextareaInput)\b[^>]*\bonChange=" ;Select multiples et créables affichent bien la valeur sélectionnée après création.