@nocha/experience-input

Primitives d’entrée pour expériences autonomes. Aucun moteur, SDK ou accès réseau requis.

npm install --save-exact @nocha/[email protected]

import { mountTouchFoundation, createAnalogControl, createGamepadInput } from "@nocha/experience-input";
import "@nocha/experience-input/style.css";

const touch = mountTouchFoundation({ mode: "game" });
// Au démontage :
touch.dispose();

Importer explicitement @nocha/experience-input/style.css une fois dans la composition de l’expérience ; les bundlers doivent conserver cet effet de bord. Les dispositions et classes visuelles restent dans chaque expérience. Les fonctions doivent être appelées dans un document navigateur.

mountTouchFoundation({ mode: 'game' | 'app' }) protège les commandes des appuis longs et glissements natifs, préserve les champs éditables, transmet les marges Nocha validées et émet experience-input-reset lors des pertes d'activité et de l'entrée dans un champ. Le mode application conserve la sélection du contenu. Dans un jeu, data-touch-selectable réactive explicitement la sélection. Les liens et médias conservent leur menu contextuel. Aucun blocage global de touchmove ni du défilement.

createAnalogControl({ element, knob, axis, deadzone, onChange }) fournit un stick fixe à sortie normalisée : zone morte radiale, amplitude progressive, un pointeur par commande, capture et annulation. L'axe vertical sert au zoom à rappel central. La sortie utilise les coordonnées écran (+y vers le bas). Le consommateur applique la vitesse avec le temps écoulé et suspend explicitement ses commandes lorsque son panneau s'ouvre. Appeler reset() à la suspension et dispose() au démontage.

Les boutons tactiles ont une cible minimale de 44 px ; data-touch-compact permet une exception locale justifiée. Les champs utilisent au moins 16 px sur appareil tactile pour éviter le zoom de saisie. Les styles de disposition restent locaux et peuvent utiliser --experience-safe-top/right/bottom/left.

createGamepadInput({ deadzone: 0.16 }) lit les manettes à mapping standard, dont DualSense. Appeler poll() dans la boucle du jeu : move est le stick gauche, look le droit (+y vers le bas), buttons contient les amplitudes 0–1 et pressed les indices activés à cette image seulement. Le jeu définit ses propres actions ; aucun faux événement clavier n’est émis. reset() suspend les entrées jusqu’au retour physique au neutre ; les pertes de focus, champs éditables, onglets masqués et déconnexions font de même. Appeler dispose() au démontage.

Associer d’abord la DualSense dans les réglages Bluetooth de l’appareil (ou la brancher en USB), puis activer la vue de jeu et appuyer et relâcher une touche dans l’expérience. Le navigateur ne peut pas effectuer l’appairage. Les commandes restent neutralisées dans un champ et doivent être explicitement suspendues par le jeu pour ses panneaux. Mapping standard : Croix 0, Rond 1, Carré 2, Triangle 3, L1/R1 4/5, L2/R2 6/7, Options 9, L3/R3 10/11, croix directionnelle 12–15.

Distribution

npm run build vérifie le JavaScript avec TypeScript puis prépare dist/ avec le JavaScript, les déclarations et le CSS. npm pack reconstruit ces fichiers. Publier ce paquet sur le registre utilisé par le build Nocha avant de mettre à jour les dépendances des expériences ; verrouiller la version dans chaque package-lock.json. Aucun import voisin, lien de workspace ou dépendance file: ne doit entrer dans une archive.

Version 0.2.0

Cette version reprend le socle déployé des jeux disposant du bandeau manette. claimExperienceFocus() active le focus de l’expérience ; isDualSenseId, isDualSenseGamepad, isUsableGamepad et pickPhysicalGamepad sélectionnent les manettes physiques compatibles. createGamepadInput().poll() expose aussi ready, vrai après le retour au neutre. mountGamepadStrip({ root?, hint?, className? }) affiche l’état de connexion et les indications ; appeler dispose() au démontage.

Le mode jeu bloque désormais le défilement natif et protège la capture tactile sur iOS. Ajouter data-touch-scroll aux zones de défilement du jeu ; les champs et éléments data-touch-selectable restent éditables ou sélectionnables. Les applications conservent leur mode app. Ces différences de gestes et de styles justifient une migration explicite : les expériences utilisant les règles précédentes restent verrouillées sur 0.1.0 jusqu’à leur adaptation.