Skip to content

Dates, sécurité et suivi mobiles ​

Ce lot ajoute les 17 modules précédemment À créer dans la matrice web/mobile. Ils restent expérimentaux et sont implémentés pour la prochaine publication. Les 13 modules auparavant À adapter, désormais couverts par le lot suivant, restent identifiés séparément ; l’agenda d’EventManager ne constitue pas une livraison des grilles spécialisées d’EventCalendar.

Installation et démonstration ​

Depuis le workspace : pnpm install, puis pnpm native. La démo dispose de 109 fiches dans Composants → Tous et de quatre nouveaux écrans :

ÉcranEssais proposés
Dates et périodesAnnée, mois, semaine ISO, calendrier compact, plage normale/de nuit, raccourcis ; normal, lecture seule et désactivé.
Sécurité et suiviBascules, tailles et variantes ; secrets et permissions ; JSON valide/invalide et copie ; pause/reprise des compteurs et statuts de tâche.
AgendaChoix de date, création, détail, modification, suppression confirmée, lecture seule et erreur serveur simulée.
Journal d’activitéRecherche, filtre d’action, pagination, consultation d’une entrée, erreur et actualisation.

BrandIcon utilise le peer react-native-svg >=15.16 <16 ; la démo fixe 15.16.0, compatible avec son socle Expo 58. Dans un projet Expo, utiliser npx expo install react-native-svg et respecter les versions du socle documenté. Il n’embarque aucune collection de logos : passer {title, path, hex} comme sur le web. La taille est numérique ; les marques trop sombres/claires prennent la couleur du texte lorsque leur couleur serait illisible. colored={false} et decorative permettent les usages monochromes et purement décoratifs.

Bascules, secrets et permissions ​

Toggle expose pressed, defaultPressed, onPressedChange, icône, libellé, état désactivé, taille, ton, variante et animation configurable. ToggleGroup propose les modes simple et multiple ; deselectable={false} maintient un choix en mode simple. Les composants conservent un état local si aucune valeur contrôlée n’est fournie.

SecretFields conserve l’identité de ses lignes pendant la frappe. storedKeys sert à initialiser les noms existants sans aucune valeur de secret ; dans un formulaire contrôlé, fournir ces entrées dans value avec value: ''. Une valeur laissée vide pour un nom stocké signifie « conserver » ; saisir une nouvelle valeur signifie « remplacer ». templates propose des noms et keyPattern valide leur forme, sans dépendre de RegExp.lastIndex. validateSecretEntries expose les doublons et noms invalides au formulaire appelant. Les valeurs restent masquées par PasswordInput, sauf révélation explicite. Hors de Form, placer la saisie dans KeyboardScrollView pour garder le champ visible au-dessus du clavier ; la démo applique ce conteneur.

Le composant n’appelle aucun serveur : l’application décide de la conservation, rotation ou suppression à partir de sa liste avant/après. Ne pas sérialiser les secrets dans l’URL, les toasts ou les messages d’erreur.

PermissionMatrix montre des sections par domaine. canGrant(permission) verrouille les permissions non accordables. Un joker de domaine implique ses actions et les verrouille individuellement ; le joker global * met l’ensemble en lecture seule. Les permissions absentes de la configuration restent dans la valeur. La sélection de tout un domaine est bloquée si elle retirerait ou accorderait un droit non modifiable. Le serveur reste responsable de l’autorisation.

Périodes et dates civiles ​

ComposantValeur et comportement
YearPickerNombre, bornes min/max entre 1 et 9999, liste virtualisée à lignes de hauteur connue, validation explicite.
MonthPickerYYYY-MM, bornes du même format, navigation d’année, sélection et confirmation.
WeekPickerYYYY-Www ISO : lundi–dimanche et année de semaine ISO ; le 1er janvier peut appartenir à l’année ISO précédente.
MiniCalendarCalendar compact avec ses bornes, jours désactivés, thème et choix du jour.
TimeRangePicker{start: 'HH:mm', end: 'HH:mm'}, roues, pas de minutes, bornes et brouillon partagé. Fin antérieure interdite sauf allowOvernight.
DateRangeFilterDateRangePicker contrôlé, raccourcis et onClear ; les bornes et la lecture seule s’appliquent aussi aux raccourcis.

Les feuilles n’émettent que lors de la confirmation ; fermer ou revenir annule le brouillon. Mois/semaine et plage peuvent être effacés quand le contrat le prévoit ; YearPicker correspond à une sélection d’année, sans effacement. isoWeekFromDate et isoWeekRange rendent les conversions explicites et rejettent les semaines inexistantes. WeekPicker exige que les deux extrémités de la semaine respectent ses limites. Aucune conversion UTC implicite n’est appliquée aux dates civiles. TimeRangePicker autorise une traversée de minuit, pas un nombre arbitraire de journées ; les règles de fuseau et heure d’été restent applicatives.

Ces contrôles peuvent être composés directement ou reliés à Form via un champ custom et sa fonction render, sans changer la représentation stockée.

Agenda et événements ​

EventManager utilise CalendarEventInput et eventDays partagés avec headless. Le natif ajoute couleur, lieu et description textuelle. start/end portent une date civile ou une date avec heure (2026-11-17T09:00) ; les journées de l’intervalle sont inclusives selon le contrat partagé. L’application convertit ses instants serveur dans le fuseau métier avant de les transmettre.

Les callbacks de mutation sont optionnels ; leur absence masque les actions. canCreate, canEdit et canDelete affinent les droits. Les erreurs de champs retournées par onCreate/onUpdate restent dans le formulaire ; une exception est affichée par Form. La suppression est confirmée dans la même feuille et une exception garde une action réessayable. Les doubles appels sont verrouillés.

L’application conserve la source des événements : les callbacks doivent mettre à jour events après succès. Les valeurs des champs métier déjà présents sont conservées en modification. date/onDateChange permettent de charger un périmètre serveur et extraFields/extraDefaultValues ajoutent des champs métier. Une seule feuille évite d’empiler un dialogue de confirmation sur le formulaire.

Journal et JSON ​

ActivityLog prend entries, query de useTableQuery, total, filtres, chargement/erreur, actualisation et callback d’ouverture. Il ne filtre ni ne repagine silencieusement les données serveur : fournir uniquement la page chargée et le total filtré, puis utiliser query.params dans le fetcher applicatif. Les libellés/tons d’action sont personnalisables. La démo réalise ce travail sur un petit tableau local ; le rendu reste virtualisé via ResourceList.

JsonView accepte value analysée ou source prioritaire. Une source invalide reste visible avec une alerte. L’arbre limite profondeur et nombre de nœuds (par défaut 8 et 500), détecte les cycles et ne déclenche pas les getters pour l’affichage. defaultExpandDepth et collapsible contrôlent les branches. Le mode autonome est virtualisé ; scrollable={false} permet l’intégration dans un ScrollView ou le catalogue sans imbriquer des listes verticales.

La copie passe par onCopy(text) : la démo utilise expo-clipboard, qui n’est pas une dépendance du package natif. Un rejet affiche une erreur et autorise un nouvel essai. Les réponses d’une copie ancienne ne marquent pas une nouvelle source comme copiée. La copie est bornée à 10 000 valeurs et 1 000 000 de caractères ; au-delà, elle est refusée avec une erreur plutôt que de produire un export tronqué. Les valeurs non JSON comme BigInt et cycles reçoivent une représentation de debug.

Tâches, connexion et temps ​

JobProgress affiche statut, progression, étapes, essais et durée, avec callbacks asynchrones de reprise/annulation et verrou de double appui. Il ne lance aucun job et ne crée pas de connexion : les données viennent de l’application. Succès force 100 %, tandis qu’une erreur/annulation sans progression connue affiche 0 %.

LiveIndicator distingue connecting/open/closed, permet les libellés personnalisés et le mode compact. L’animation respecte le mouvement réduit et s’arrête en arrière-plan.

Timer calcule le temps écoulé depuis un horodatage, dans le sens montant ou descendant. running={false} gèle la valeur ; la reprise continue depuis cette valeur. Le passage en arrière-plan suspend les intervalles, pas le temps écoulé : le retour au premier plan recalcule immédiatement. Countdown impose simplement le sens descendant. onFinish se déclenche une fois par durée/configuration. Changer la durée ou la clé réarme le compteur. La fréquence est configurable, avec un minimum de 16 ms ; le défaut de 250 ms suffit aux durées lisibles.

Les nouveaux composants doivent encore être essayés sur appareil, en particulier les roues, la sélection de texte/secret avec clavier, le rendu SVG, la copie et le retour au premier plan. La confirmation utilisateur des composants précédents reste enregistrée séparément.

Fonctions utilisables séparément ​

  • isoWeekFromDate et isoWeekRange convertissent une date civile ou une semaine ISO.
  • validTimeRange contrôle deux heures et l’option de passage à minuit.
  • validateSecretEntries renvoie les indices invalides avec les codes duplicate ou pattern, à convertir en erreurs du formulaire appelant.
  • eventDraftErrors contrôle les valeurs du formulaire : title, allDay, startDate, endDate, startTime, endTime. Les codes sont required, invalid et order ; ce ne sont pas les champs start/end du résultat EventDraft.
  • jsonViewRows produit les lignes visibles et l’indicateur de troncature pour une intégration d’arbre personnalisée.
  • formatDuration produit l’horloge de Timer ; son option ajoute les centièmes.

Publié sous licence MIT.