@jonathankablan/noraivoire-fx-text 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,64 @@
+NORAIVOIRE — LICENCE PROPRIÉTAIRE
+Copyright (c) 2026 Jonathan KABLAN. Tous droits réservés.
+
+Le présent logiciel, incluant sans limitation son code source, ses spécifications
+(fichiers .nora.json), son compilateur, son moteur d'effets, ses adaptateurs, ses
+modèles (templates), sa documentation, ses jeux de tests et ses éléments graphiques
+(ci-après « le Logiciel »), est la propriété exclusive de Jonathan KABLAN
+(ci-après « le Titulaire »).
+
+1. ABSENCE DE LICENCE OPEN SOURCE
+   Le Logiciel n'est pas distribué sous une licence open source. Aucun droit
+   n'est concédé implicitement, par estoppel ou autrement. La simple mise à
+   disposition du Logiciel, y compris dans un dépôt privé ou un registre de
+   paquets privé, ne vaut pas concession de licence.
+
+2. USAGE AUTORISÉ
+   Tout usage du Logiciel est subordonné à un contrat de licence écrit et signé
+   par le Titulaire (ci-après « Contrat de Licence »). En l'absence d'un tel
+   contrat, seul le Titulaire est autorisé à utiliser le Logiciel.
+
+3. INTERDICTIONS
+   Sauf autorisation écrite et préalable du Titulaire, il est interdit de :
+   a) copier, reproduire, modifier, adapter, traduire ou créer des œuvres
+      dérivées du Logiciel, en tout ou partie ;
+   b) distribuer, publier, sous-licencier, louer, prêter, vendre ou mettre à
+      disposition le Logiciel à des tiers, y compris sous forme de service
+      (SaaS) ou intégré dans un autre produit distribué ;
+   c) décompiler, désassembler ou procéder à de l'ingénierie inverse du
+      Logiciel, sauf dans les limites strictement prévues par l'article
+      L.122-6-1 du Code de la propriété intellectuelle ;
+   d) supprimer ou altérer les mentions de propriété, de copyright ou la
+      présente licence ;
+   e) utiliser le Logiciel, ses spécifications ou sa documentation pour
+      entraîner, affiner ou évaluer un modèle d'intelligence artificielle
+      destiné à des tiers, ou pour concevoir un produit concurrent.
+
+4. PRODUITS GÉNÉRÉS
+   Les fichiers produits par le compilateur NoraIvoire pour le compte d'un
+   licencié (CSS, Dart, TypeScript générés) peuvent être intégrés dans les
+   applications de ce licencié dans les conditions fixées par son Contrat de
+   Licence. Ils ne peuvent pas être redistribués en tant que bibliothèque,
+   framework ou kit de design autonome.
+
+5. CONFIDENTIALITÉ
+   Le Logiciel contient des informations confidentielles et des secrets
+   d'affaires du Titulaire. Toute personne y ayant accès s'engage à en
+   préserver la confidentialité.
+
+6. ABSENCE DE GARANTIE
+   Sauf stipulation contraire du Contrat de Licence, le Logiciel est fourni
+   « EN L'ÉTAT », sans garantie d'aucune sorte, expresse ou implicite. Dans
+   les limites autorisées par la loi, le Titulaire ne saurait être tenu
+   responsable d'aucun dommage résultant de l'utilisation du Logiciel.
+
+7. COMPOSANTS TIERS
+   Le Logiciel peut référencer des composants tiers soumis à leurs propres
+   licences, listés dans THIRD_PARTY_NOTICES.md. La présente licence ne
+   modifie pas ces licences.
+
+8. DROIT APPLICABLE
+   La présente licence est régie par le droit français. Tout litige relève de
+   la compétence des tribunaux du ressort de la Cour d'appel de Paris.
+
+Contact licences : jonathan.kablan@gmail.com

package/README.md

@@ -1,3 +1,16 @@
-# Temporary Holding Version
+# @jonathankablan/noraivoire-fx-text
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Effets de texte optionnels de NoraIvoire 0.1.0 : `split`, `scramble`. Chargés à la demande, texte complet lu une seule fois par les lecteurs d'écran, DOM restauré au démontage, mouvement réduit respecté.
+
+```html
+<link rel="stylesheet" href="node_modules/@jonathankablan/noraivoire-core/dist/fx/fx-text.css">
+<script type="module">
+  import * as moteur from '@jonathankablan/noraivoire-core/engine';
+  import { install } from '@jonathankablan/noraivoire-fx-text';
+  install(moteur);
+  moteur.start();
+</script>
+<h1 data-fx="split" data-fx-split="words:true;stagger:60">Bonjour Abidjan</h1>
+```
+
+Logiciel propriétaire © 2026 Jonathan KABLAN, tous droits réservés (voir LICENSE). La mise à disposition sur npm ne vaut pas concession de licence : tout usage est subordonné à un contrat de licence écrit.

package/package.json

@@ -1,6 +1,32 @@
 {
   "name": "@jonathankablan/noraivoire-fx-text",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "license": "UNLICENSED",
+  "description": "Effets de texte optionnels NoraIvoire (split, scramble), chargés à la demande. Propriétaire.",
+  "author": "Jonathan KABLAN",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {},
+  "keywords": [
+    "noraivoire",
+    "text",
+    "animation",
+    "effects"
+  ],
+  "files": [
+    "src",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/src/index.js

@@ -0,0 +1,122 @@
+// NoraIvoire — Effets de texte optionnels : split, scramble.
+// © 2026 Jonathan KABLAN — Propriétaire, tous droits réservés.
+//
+// Arbitrage documenté (docs/SECURITY.md §moteur) : découper ou brouiller un texte
+// impose de créer des nœuds. Ce paquet étend donc, et SEULEMENT lui, le contrat
+// du moteur, de façon contrôlée et vérifiée par `nora audit` :
+//  - création de <span> par document.createElement + textContent (jamais de HTML) ;
+//  - attributs posés limités à aria-hidden et data-fx-* ;
+//  - styles limités aux variables --fx-* ;
+//  - les nœuds d'origine sont conservés et remis en place au démontage
+//    (mêmes objets : un framework qui les référence les retrouve).
+// N'agit que sur un élément qui ne contient QUE du texte (≤ 500 caractères).
+// Le texte complet reste lisible une seule fois par les lecteurs d'écran
+// (copie visuellement masquée data-fx-sr), la version animée est aria-hidden.
+
+const MAX_TEXT = 500;
+const GLYPHS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789#%&*+=<>';
+
+/** Découpe pure : graphèmes (ou mots) ; les espaces restent des segments à part. */
+export function segments(text, words = false) {
+  if (words) return text.split(/(\s+)/).filter(Boolean);
+  if (typeof Intl !== 'undefined' && typeof Intl.Segmenter === 'function') {
+    return [...new Intl.Segmenter(undefined, { granularity: 'grapheme' }).segment(text)].map((s) => s.segment);
+  }
+  return Array.from(text);
+}
+
+/** Texte brouillé : les `progress` premiers pourcents sont révélés, espaces conservés. */
+export function scrambleText(text, progress, rand = Math.random) {
+  const chars = Array.from(text);
+  const shown = Math.floor(chars.length * Math.min(1, Math.max(0, progress)));
+  return chars.map((c, i) => (i < shown || /\s/.test(c) ? c : GLYPHS[Math.floor(rand() * GLYPHS.length)])).join('');
+}
+
+/** Élément texte seul, non vide et borné ; sinon l'effet ne touche à rien. */
+function plainText(el) {
+  for (const n of el.childNodes) if (n.nodeType !== 3) return null;
+  const text = el.textContent ?? '';
+  return text.trim() && text.length <= MAX_TEXT ? text : null;
+}
+
+function span(attr, text) {
+  const s = document.createElement('span');
+  s.setAttribute(attr, '');
+  if (text !== undefined) s.textContent = text;
+  return s;
+}
+
+/** Remplace le contenu par [copie lue | version animée aria-hidden] ; renvoie la restauration. */
+function stage(el, text) {
+  const original = [...el.childNodes];
+  const visual = span('data-fx-visual');
+  visual.setAttribute('aria-hidden', 'true');
+  el.replaceChildren(span('data-fx-sr', text), visual);
+  return { visual, restore: () => el.replaceChildren(...original) };
+}
+
+export const effects = Object.freeze({
+  split: {
+    options: {
+      words: { type: 'boolean', default: false },
+      stagger: { type: 'number', default: 30, min: 0, max: 200 },
+    },
+    mount(el, opts, ctx) {
+      const text = plainText(el);
+      if (ctx.reducedMotion || text === null) return;
+      const { visual, restore } = stage(el, text);
+      let i = 0;
+      for (const seg of segments(text, opts.words)) {
+        if (/^\s+$/.test(seg)) { visual.append(seg); continue; }
+        const piece = span('data-fx-piece', seg);
+        piece.style.setProperty('--fx-i', String(i++));
+        visual.append(piece);
+      }
+      ctx.set('--fx-stagger', `${opts.stagger}ms`);
+      const show = () => el.setAttribute('data-fx-visible', '');
+      if (typeof IntersectionObserver === 'undefined') show();
+      else ctx.onVisible((v) => { if (v) show(); });
+      return () => {
+        restore();
+        el.style.removeProperty('--fx-stagger');
+        el.removeAttribute('data-fx-visible');
+      };
+    },
+  },
+
+  scramble: {
+    options: { duration: { type: 'number', default: 800, min: 0, max: 5000 } },
+    mount(el, opts, ctx) {
+      const text = plainText(el);
+      if (ctx.reducedMotion || text === null || opts.duration === 0) return;
+      let staged = null;
+      let played = false;
+      const finish = () => { if (staged) { staged.restore(); staged = null; } };
+      const play = () => {
+        if (played) return;
+        played = true;
+        staged = stage(el, text);
+        const t0 = performance.now();
+        const tick = () => {
+          if (!staged) return;
+          const p = (performance.now() - t0) / opts.duration;
+          if (p >= 1) { finish(); return; }
+          staged.visual.textContent = scrambleText(text, p);
+          ctx.frame(tick);
+        };
+        tick();
+      };
+      if (typeof IntersectionObserver === 'undefined') play();
+      else ctx.onVisible((v) => { if (v) play(); });
+      return finish;
+    },
+  },
+});
+
+/** Enregistre split et scramble dans le moteur fourni. Idempotent. */
+export function install(engine) {
+  if (!engine || typeof engine.defineEffect !== 'function') throw new TypeError('NoraIvoire : install() attend le module du moteur');
+  for (const [name, def] of Object.entries(effects)) {
+    if (!engine.hasEffect?.(name)) engine.defineEffect(name, def);
+  }
+}