Téléphones, navigation, tokens et traitements uniques
Ces ajouts sont implémentés et en attente de publication.
Téléphones configurables
import {
normalizePhone,
toNationalNumber,
formatPhone,
} from "@sia-ui/utils/phone";
normalizePhone("690 00 00 01", { defaultCountry: "CM" }); // +237690000001
normalizePhone("00237690000001"); // +237690000001
toNationalNumber("+237690000001"); // 690000001
formatPhone("+237690000001"); // +237 690 00 00 01La table par défaut décrit le Cameroun : indicatif 237 et neuf chiffres nationaux. countries remplace cette table avec indicatif, longueurs, préfixe national éventuel et préfixes acceptés. grouping personnalise les groupes d’affichage. Les lettres, extensions, indicatifs inconnus et longueurs incorrectes sont refusés. C’est une normalisation syntaxique selon la configuration, pas une validation de l’attribution du numéro ou de son opérateur ; aucune base mondiale n’est embarquée.
Navigation sans dépendance de plateforme
navigationLinks({ lat, lng, label }) fournit googleMaps, waze, appleMaps et leurs variantes googleMapsApp, wazeApp, appleMapsApp. Les liens web permettent un repli si l’application native n’est pas installée. L’application choisit comment les ouvrir. Les coordonnées sont contrôlées ; le libellé des liens Apple est encodé. Le helper ne demande ni permission de géolocalisation ni accès au navigateur.
Presets et valeurs JavaScript
// tailwind.config.mjs — Tailwind 3, ou configuration JS chargée par @config en Tailwind 4
import sia from "@sia-ui/tokens/tailwind";
export default { presets: [sia], content: ["./src/**/*.{ts,tsx}"] };Les couleurs sont accessibles avec bg-sia-primary, le texte avec text-sia-primaryForeground, les espacements avec p-sia-md, les rayons avec rounded-sia-md et les durées avec duration-sia-fast. Le preset web lit les variables CSS du thème SIA ; installer et charger les styles SIA reste nécessaire. Les clés Tailwind standard ne sont pas remplacées.
javascriptTokens fournit les palettes light/dark, les espacements numériques, les rayons, les durées, les courbes et les ombres pour canvas, graphiques et animations. createTailwindPreset({ cssVariables: false }) fournit des couleurs concrètes. @sia-ui/tokens/nativewind exporte un preset à valeurs concrètes ; createNativeWindPreset({ mode: 'dark' }) choisit sa palette. C’est un export de tokens pur : aucun composant React Native ni dépendance NativeWind n’est ajouté. L’application configure son propre preset NativeWind et ses chemins content.
Réservation idempotente côté serveur
import { withIdempotentClaim } from "@sia-ui/realtime-server";
const result = await withIdempotentClaim(store, eventId, () => processEvent(), {
ttlSeconds: 86400,
});
if (!result.claimed) return; // déjà réservé ou traité dans la fenêtre de rétentionL’adaptateur expose setIfAbsent(key, token, ttlSeconds) atomique et deleteIfValue(key, token) atomique. Avec Redis, la première opération correspond à SET ... NX EX ; la seconde est une comparaison/suppression Lua ou transactionnelle. Un delete(key) inconditionnel ne satisfait pas le contrat : il pourrait retirer la réservation d’une autre tentative après expiration du premier bail.
Un succès conserve la clé jusqu’au TTL. Un échec libère uniquement sa propre clé et repropage l’erreur ; une erreur de libération conserve les deux causes dans un AggregateError. Le TTL doit couvrir la durée maximale du traitement et la fenêtre de déduplication souhaitée. Il n’y a pas de renouvellement automatique : passé ce TTL, une nouvelle tentative peut exécuter le travail. Pour des garanties métier durables, conserver aussi une clé unique et un résultat dans la transaction de la base. Le paquet n’embarque ni Redis ni stockage, et n’annonce pas de garantie « exactement une fois ».
Aperçus et confirmations
diffLines(before, after) produit des lignes equal, added, removed avec leurs numéros avant/après. Les fins de ligne CRLF sont normalisées. Le nombre de cellules LCS est borné ; au-delà, le milieu est présenté en suppression/ajout sans bloquer le thread. Les textes trop volumineux sont refusés. Les chaînes ne deviennent jamais du HTML : les rendre comme texte dans React, sans dangerouslySetInnerHTML. Ce helper calcule un diff ; il ne prétend pas ajouter une vue de diff ou masquer des secrets.
ConfirmDialog confirmation={{ value: 'SUPPRIMER' }} bloque la validation tant que le texte exact n’a pas été saisi. Le champ se réinitialise à chaque réouverture et changement de valeur attendue. confirmationInputProps personnalise sa présentation sans remplacer la valeur, l’identifiant ou la gestion de saisie. Le libellé par défaut existe en français et anglais. Cette protection d’interface complète les droits serveur.