AccueilGuidesMigration v2

Migration v2

Guide destiné à être donné tel quel à un agent IA (ou suivi à la main) pour migrer une application de @alveole/* 1.10 vers 2.0. Chaque section donne : comment trouver les appels, comment les réécrire, et les pièges qui font échouer le typecheck ou changent le comportement. Aucun alias n'est conservé : tout ce qui est retiré casse au typecheck. Le typecheck est donc la liste de travail de référence.
Procédure
•Mettre à jour les paquets en version exacte : @alveole/components, @alveole/core, @alveole/theme, @alveole/storybook, @alveole/eslint-config → 2.0.0. •Mettre à jour les peer dependencies (section Dépendances). •Lancer les recherches git grep de chaque section, appliquer les réécritures section par section (l'ordre du document est l'ordre conseillé : les champs avant les icônes, car un même appel est souvent concerné par les deux). •Lancer le typecheck du projet. Chaque erreur restante correspond à une ligne d'un tableau ci-dessous. •Lancer les tests et vérifier visuellement les formulaires (libellé, erreur, bordure rouge). Règle générale à retenir : un champ ne porte plus son libellé. Le libellé, l'aide (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é aux deux : FormControl affiche le message sous le champ, le contrôle colore sa bordure. Avant, le *Field faisait les deux tout seul.
1. Dépendances
git grep -nE "lucide-react-native|@lucide/lab|@react-native-picker/picker|expo-linear-gradient|react-native-code-highlighter" -- package.json
PaquetAction
expo-web-browserAjouter (npx expo install expo-web-browser) : requis par A / Link (target).
expo-image-pickerAjouter (npx expo install expo-image-picker) : requis par FileInput (galerie, appareil photo).
lucide-react-native, @lucide/lab, @react-native-picker/picker, expo-linear-gradient, react-native-code-highlighterPlus requis par Alveole. Retirer seulement si l'application ne les importe pas elle-même.
eslint@alveole/eslint-config accepte maintenant ESLint 9 ou 10.
Vérifier qu'un paquet est encore importé avant de le retirer :
git grep -nE "from '(lucide-react-native|@lucide/lab|@react-native-picker/picker|expo-linear-gradient)'"
2. Champs de saisie *Field → FormControl + contrôle
git grep -nE "\b(TextField|TextareaField|EmailField|EmailInput|PasswordField|PhoneField|PhoneInput|NumberField|OtpField|FileField|FormControlNumberInput|FormControlOtpInput|FormControlFileInput)\b"
AvantAprès (dans un FormControl)
TextFieldTextInput
TextareaFieldTextareaInput
EmailField, EmailInputTextInput type="email"
PasswordFieldTextInput type="password"
PhoneField, PhoneInputTextInput type="tel"
NumberField, FormControlNumberInputNumberInput
OtpField, FormControlOtpInputOtpInput
FileField, FormControlFileInputFileInput
type FileFieldValue, FormControlFileInputValueFileInputValue
types *FieldPropsTextInputProps, NumberInputProps, OtpInputProps, FileInputProps
Props qui montent sur FormControl : label, labelRight, hint, error, success, required, disabled (et disabled reste aussi sur le contrôle). Tout le reste reste sur le contrôle.

FormControl composé à la main → props

En 1.x, 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>

Piège n°1 : onChange des champs texte

Les anciens TextField, TextareaField, EmailField, PasswordField, PhoneField, PhoneInput avaient un alias onChange(text: string). Il disparaît : TextInput reprend les props de React Native, où onChange reçoit un événement, pas une chaîne. Le typecheck ne le signale pas toujours (ex. onChange={setValue} avec un setState non typé). ➡️ Sur TextInput / TextareaInput : renommer systématiquement onChange en onChangeText. Ne concerne pas NumberInput, OtpInput, FileInput, Select, DateInput, TimeInput, DurationInput : leur onChange reçoit toujours la valeur.

Piège n°1 bis : FileInput affiche désormais une liste de fichiers

git grep -nE "<(FileInput|DragAndDropFile)\b"
AvantAprès
placeholder="…"labels={{ addFile: '…' }} (tous les libellés se règlent par labels)
previewURL={url}un fichier enregistré dans value : { id, uri: url, name, persisted: true }
hideFilename, canChange, forcePlaceholderretirer
Changements de comportement : •Le champ montre un bouton « Ajouter un fichier » puis la liste des fichiers (aperçu, ouverture, retrait). •Sur natif, le bouton ouvre une feuille Galerie / Appareil photo / Document (ajouter expo-image-picker, voir Dépendances). •multiple : une nouvelle sélection ou un dépôt s'ajoute aux fichiers déjà présents au lieu de les remplacer. •Champ simple : le bouton est désactivé tant qu'un fichier est affiché ; le retirer d'abord. •Retirer un fichier ajouté l'enlève de value ; retirer un fichier enregistré le garde, marqué removed: true, pour le supprimer côté serveur à l'envoi. •Annuler le sélecteur n'appelle plus onChange(null) : la valeur reste inchangée.

DragAndDropFile → FileDropZone

DragAndDropFile est supprimé. La zone de dépôt 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.

Piège n°2 : réglages imposés retirés

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 … />}).

Exemples

// 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>;
Si un ref était passé au *Field, le passer au contrôle (<TextInput ref={ref} />).

TextareaInput (le composant existe toujours)

En 1.10, son type reprenait celui de TextField : label y était obligatoire, et hint, labelRight, optional, onChange acceptés… mais aucun n'était affiché ni branché. Les appels existants passent donc presque tous un 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>

FormControlLabel et RadioGroup : optional / optionalText supprimés

La mention « (optionnel) » disparaît au profit de l'astérisque sur les champs requis.
git grep -nE "\boptional(Text)?[=:]"
AvantAprès
optional / optionalText="…"retirer ; marquer à l'inverse les champs obligatoires : <FormControl required>
<FormControlLabel error="…" success="…" />retirer error/success (le libellé ne se colore plus) ; message via FormControl error
<RadioGroup label=… optional />retirer optional (label devient facultatif)
3. DateInput, TimeInput, DurationInput : libellé retiré
git grep -nE "<(DateInput|TimeInput|DurationInput)\b"
Ces composants existent toujours mais n'acceptent plus 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>
4. Select, SelectMultiple, Autocomplete, AutocompleteAddress → Select
git grep -nE "\b(Select|SelectMultiple|SelectInput|NativePicker|Autocomplete|AutocompleteChip|AutocompleteAddress|AutocompleteOption\w*|SelectMultipleOption)\b"
Le nouveau Select couvre tous les cas : simple, multiple, recherche (locale ou distante), création. Il est nu (dans un FormControl) et strictement contrôlé. Types exportés : SelectOption ({ value: string; label: string; leading?; group?; disabled? }), SelectProps, SelectRef, SelectItem. Supprimés : NativePicker, SelectInput, SelectMultipleOption, AutocompleteOption*, isAutocompleteOptionWithGroup*.

4.1 Select simple

// 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).

4.2 SelectMultiple → Select multiple

// 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>
Piège : value doit être un string[] (plus de number) et obligatoire (passer [], 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.

4.3 Autocomplete → Select

AutocompleteSelect
value: AutocompleteOption[]value: string | null (simple) / string[] (multiple) — des valeurs, plus des objets
isMultimultiple
isSearchablesearchable
disabledFilterSearchlocalFilter={false}
disabledSearchretirer searchable
allowEmptyclearable
allowCreatecreatable (implique searchable)
onCreateOption(option)onCreateOption(query: string) — l'appelant crée l'option
createOptionLabelcreateLabel
createOptionValuesupprimé : l'appelant fabrique value dans onCreateOption
onChange(options, meta)onChange(value) — plus de second argument meta
onSearchChangeonSearchChange (émis après 300 ms, jamais au montage)
label, hint, errorsur FormControl (et error aussi sur Select)
autoFocusref (SelectRef.open() / focus()) dans un useEffect
option { group }inchangé : options consécutives de même group regroupées
Conversion de la valeur, le point qui demande le plus d'attention :
// 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>;
Recherche distante (anciennement 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>

4.4 AutocompleteAddress → Select

AutocompleteAddressSelect
suggestionsoptions
onPlaceSelected(placeId)onChange(value) avec value !== null
onCustomAddress(address)onCreateOption(query)
onClear()onChange(null) (avec clearable)
disabledCreationretirer creatable
label (défaut "Adresse")FormControl label="Adresse"
// 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>
Attention : quand la recherche distante remplace 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]}.
5. Icônes → leading / trailing
Détail et justification : leading-trailing.md.
git grep -nE "startIcon|endIcon|\bicon[=:]"
ComposantAvantAprès
ButtonstartIcon / endIconleading / trailing
AccordionItemstartIconleading
Tagiconleading
Tabs (élément de tabs), TabsTabiconleading
SidebarItemiconleading
ActionMenu.Itemiconleading
RadioGroupCardiconleading
SelectOption{ icon }{ leading }
ToastView, toast.present(…, opts)iconleading
Ne pas toucher 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.

Noms d'icônes retirés

Le catalogue d'icônes est désormais embarqué dans Alveole. Ces noms ne sont plus acceptés (name, icon, leading, trailing, IconProps.name…) :
NomRemplacement
broom, carton, cartonOff, houses, textSquare (Lab)choisir une icône proche dans le catalogue (story LucideIcon)
Icon, LucideProvider, createLucideIcon, useLucideContextce n'étaient pas des icônes : retirer
git grep -nE "['\"](broom|carton|cartonOff|houses|textSquare|Icon|LucideProvider|createLucideIcon|useLucideContext)['\"]"
6. Button, ButtonIcon, Badge
git grep -nE "variant=['\"]link['\"]|size=['\"]xs['\"]|\b(noPadding|borderNone|leftAlign)\b|<Button\b[^>]*\bactive\b"
AvantAprès
<Button size="xs" …>size="sm"
<Button variant="link" title="…" onPress={go} /> qui navigue<Link href="/chemin">…</Link> (ou A)
<Button variant="link" …> qui agit sur placevariant="tertiary"
<Button leftAlign …>contentAlign="start"
<Button noPadding …>, <Button borderNone …>retirer ; si l'effet était voulu : variant="tertiary" ou un Pressable maison
<Button active={open} …>expanded={open} (active est déprécié, pas encore supprimé)
<Button startIcon="X" /> sans title<ButtonIcon variant="…" icon="X" accessibilityLabel="Action décrite" />
<ButtonIcon icon="X" /> sans accessibilityLabelajouter accessibilityLabel="…" (obligatoire)
<Badge variant="disabled" …>variant="default"
title est désormais obligatoire sur 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).
6 bis. Tag, ToolbarTop
git grep -nE "<Tag\b[^>]*\bcolor=|\b(onActions|actionsIcon)\b|onNavigate="
AvantAprès
<Tag color="default" …>retirer color (le Tag est toujours gris)
<Tag color="action" …>une couleur porteuse de sens → Badge ; un compteur → Counter
ToolbarTop onActions={…} actionsIcon="X"supprimés : passer le bouton dans actions
ToolbarTop onNavigate={…}navigationLabel devient obligatoire avec onNavigate (nom accessible du bouton retour)
// 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} />}
/>
Nouveautés du Tag, si utiles : selected, interactive, closable + onClose, leading.
6 ter. Switch : taille md par défaut
git grep -nE "<Switch\b"
Switch accepte size (sm, md, lg) et vaut md par défaut, plus petit qu'en 1.x. Pour garder le rendu actuel, ajouter size="lg" à chaque appel :
// Avant
<Switch label="Notifications" checked={on} onCheckedChange={setOn} />
// Après
<Switch size="lg" label="Notifications" checked={on} onCheckedChange={setOn} />
Le pouce coché passe aussi du rose à la couleur primaire (bleu) : aucun code à changer.
7. @alveole/theme
git grep -nE "\b(Mandarine|Shakespeare|Pacifika|ButteryWhite|CoralRed|Lochmara|BigStone|LimeGreen|Purple)\b|Inter|Barlow|generateDefaultThemeCSS|generateFontSmoothingCSS|color-(sun|950)\b|illustration"
AvantAprès
Rampes Mandarine, Shakespeare, Pacifika, ButteryWhite, CoralRed, Lochmara, BigStone, LimeGreen, Purplesupprimées : choisir la rampe restante la plus proche (ou copier la valeur hex localement)
Polices Inter (corps) et Barlowtout est en Geist : 'Inter-Light' / 'Inter-Regular' / 'Inter-Medium' / 'Inter-Bold' et 'Barlow-*' → 'Geist-Light' / 'Geist-Regular' / 'Geist-Medium' / 'Geist-Bold' (clés de FontsMap, FontWeightMap, fontStyle(…)) ; retirer @expo-google-fonts/inter / barlow si plus importés
Palette illustration imbriquée (illustration["color-sun"].default.yellow, idem color-950)clés aplaties : color-sun-default-yellow, color-950-default-yellow
generateDefaultThemeCSS()generateThemeCSSParts(theme).join('\n')
generateFontSmoothingCSS()supprimé : plus d'antialiasing global. Le recréer côté app seulement si nécessaire.
injectVariableCSS(theme: Theme), generateCSSVariables(theme: Theme)même appel ; le paramètre est typé SourceDuCSS (un Theme reste accepté s'il fournit les mêmes clés)
Radius / Box.borderRadius : numbernumber | 'var(--radius-…)' sur web : ne plus faire de calcul sur un rayon du thème
Les clés de spacing dépréciées existent toujours pour theme.spacing() (non cassant) mais leurs usages sont à migrer vers l'échelle V/W quand on y passe. Box les refuse (section 8 ter).
8. Tamagui v2
Détail, changements de rendu et relevé par application : tamagui-v2.md. Alveole 2.0 exige Tamagui 3 (section 8 bis) : une application en Tamagui 1 fait d'abord ce saut vers la v2, puis celui vers la v3, dans cet ordre. Monter tous les paquets 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"
AvantAprès
animation="…" sur un composant Tamaguitransition="…"
onHoverIn / onHoverOut sur Tamagui ou BoxonMouseEnter / onMouseLeave
disablePassBorderRadiusretirer
dataSet sur un composant Tamaguiattribut direct data-x="…"
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). Changements de rendu, invisibles au typecheck et en jsdom : •chaque vue reprend la police de l'app, hauteur de ligne comprise : un style de texte posé sur une vue ne descend plus aux enfants, et un texte sans hauteur de ligne prend celle de la config (23 px en @tamagui/config v3). Les Typography d'Alveole posent normal par défaut ; •plus de position: relative par défaut : poser position: 'relative' sur le conteneur d'un enfant absolu, ou settings.defaultPosition: 'relative' ; •flex: 1 devient 1 1 0px sur le web : flexGrow: 1, ou settings.styleCompat: 'legacy' ; •Image rend un vrai <img> (alt exigé) ; Switch ne compte plus padding ni bordure.
8 bis. Tamagui v3
Détail, changements de rendu et relevé par application : tamagui-v3.md. Les peer dependencies Tamagui d'Alveole sont en ^3.0.0 seul. •config : @tamagui/config/v3 et /v4 n'existent plus ; passer à @tamagui/config/v5 avec les animations de @tamagui/config/v5-css ; •SafeAreaProvider enveloppe TamaguiProvider, tests compris ; •@tamagui/babel-plugin n'a pas de version 3 : le retirer de package.json et de babel.config.js ; •pseudo-états en clauses : 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"
Ce qu'Alveole ne prend pas en charge suit le guide officiel : How to upgrade.
8 ter. Box : tokens du thème uniquement
Tables de correspondance, valeurs hors échelle, couleurs et relevé par application : box-tokens.md. Les espacements, rayons et couleurs de Box n'acceptent plus que les clés du thème (ADR 0033) : •espacements : p={8} → p="1W", mt="100" → mt="2W" ; les marges gardent 'auto' et les pourcentages ; •rayons : 'sm', 'md', 'lg', 'full' ; 1000 → 'full' ; •couleurs : lues dans useTheme().color, 'transparent' ou clause objet { hover } ; une couleur venue des données passe par style.
9. Vérification finale
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-"
Doit ne rien renvoyer. Puis : typecheck, lint, tests. Points à contrôler à l'œil : •chaque champ en erreur a le message (FormControl error) et la bordure rouge (error du contrôle) ; •aucun TextInput avec onChange= (doit être onChangeText=) : git grep -nE "<(TextInput|TextareaInput)\b[^>]*\bonChange=" ; •les Select multiples et créables affichent bien la valeur sélectionnée après création.
Alveole UI Kit — v2.0.0-alpha.30