@jonathankablan/noraivoire-fx-scroll 0.0.0-stage → 0.1.1

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-scroll
 
-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 défilement optionnels de NoraIvoire 0.1.1 : `pin`, `scrub`, `parallax`. Chargés à la demande, aucun effet de bord à l'import, ≤ 2 Kio gzip, mouvement réduit respecté.
+
+```html
+<link rel="stylesheet" href="node_modules/@jonathankablan/noraivoire-core/dist/fx/fx-scroll.css">
+<script type="module">
+  import * as moteur from '@jonathankablan/noraivoire-core/engine';
+  import { install } from '@jonathankablan/noraivoire-fx-scroll';
+  install(moteur);
+  moteur.start();
+</script>
+<img data-fx="parallax" data-fx-parallax="speed:30" src="…" alt="…">
+```
+
+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-scroll",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "license": "UNLICENSED",
+  "description": "Effets de défilement optionnels NoraIvoire (pin, scrub, parallax), 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",
+    "scroll",
+    "parallax",
+    "effects"
+  ],
+  "files": [
+    "src",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/src/index.js

@@ -0,0 +1,105 @@
+// NoraIvoire — Effets de défilement optionnels : pin, scrub, parallax.
+// © 2026 Jonathan KABLAN — Propriétaire, tous droits réservés.
+//
+// Mêmes règles que le moteur (vérifiées par `nora audit`) : aucune écriture hors
+// des variables --fx-* (ctx.set) et des attributs data-fx-*, aucun effet de bord
+// à l'import. Les effets sont enregistrés par install(moteur), à la demande :
+//   const fx = await import('…/fx/fx-scroll.js'); fx.install(moteur);
+
+const clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
+
+/** Progression de l'élément dans la fenêtre : 0 quand il entre par le bas, 1 quand il sort par le haut. */
+export function viewProgress(top, height, viewport) {
+  const vh = viewport > 0 ? viewport : 1;
+  return clamp((vh - top) / (vh + Math.max(0, height)), 0, 1);
+}
+
+/** Décalage de parallaxe en pixels pour une progression donnée. */
+export function parallaxOffset(progress, speed, reverse = false) {
+  return (0.5 - progress) * speed * 4 * (reverse ? -1 : 1);
+}
+
+/** Écoute passive du défilement, regroupée par rAF, suspendue hors de la fenêtre. */
+function onScroll(el, ctx, update) {
+  const run = () => ctx.frame(update);
+  window.addEventListener('scroll', run, { passive: true, signal: ctx.signal });
+  window.addEventListener('resize', run, { passive: true, signal: ctx.signal });
+  if (typeof IntersectionObserver !== 'undefined') {
+    ctx.onVisible((visible) => { ctx.visible = visible; if (visible) run(); });
+  }
+  run();
+}
+
+const nativeTimeline = () => typeof CSS !== 'undefined' && CSS.supports?.('animation-timeline: view()') === true;
+
+export const effects = Object.freeze({
+  pin: {
+    options: { top: { type: 'number', default: 0, min: 0, max: 400 } },
+    mount(el, opts, ctx) {
+      // L'épinglage lui-même est en CSS (position: sticky) : il fonctionne sans JS.
+      ctx.set('--fx-pin-top', `${opts.top}px`);
+      const track = el.parentElement;
+      if (!track) return () => el.style.removeProperty('--fx-pin-top');
+      onScroll(el, ctx, () => {
+        const t = track.getBoundingClientRect();
+        const r = el.getBoundingClientRect();
+        const room = t.height - r.height;
+        const p = room > 0 ? clamp((opts.top - t.top) / room, 0, 1) : 0;
+        ctx.set('--fx-pin-progress', p.toFixed(4));
+        el.toggleAttribute('data-fx-pinned', p > 0 && p < 1);
+      });
+      return () => {
+        el.style.removeProperty('--fx-pin-top');
+        el.style.removeProperty('--fx-pin-progress');
+        el.removeAttribute('data-fx-pinned');
+      };
+    },
+  },
+
+  scrub: {
+    options: {
+      start: { type: 'number', default: 0, min: 0, max: 100 },
+      end: { type: 'number', default: 100, min: 0, max: 100 },
+    },
+    mount(el, opts, ctx) {
+      const cleanup = () => el.style.removeProperty('--fx-progress');
+      // Mouvement réduit : état final immédiat, aucun contenu masqué.
+      if (ctx.reducedMotion) { ctx.set('--fx-progress', '1'); return cleanup; }
+      const a = Math.min(opts.start, opts.end) / 100;
+      const span = Math.max(opts.end / 100 - a, 0.0001);
+      onScroll(el, ctx, () => {
+        const r = el.getBoundingClientRect();
+        const p = clamp((viewProgress(r.top, r.height, window.innerHeight) - a) / span, 0, 1);
+        ctx.set('--fx-progress', p.toFixed(4));
+      });
+      return cleanup;
+    },
+  },
+
+  parallax: {
+    options: {
+      speed: { type: 'number', default: 20, min: 0, max: 100 },
+      reverse: { type: 'boolean', default: false },
+    },
+    mount(el, opts, ctx) {
+      if (ctx.reducedMotion) return;
+      const cleanup = () => { el.style.removeProperty('--fx-speed'); el.style.removeProperty('--fx-parallax'); };
+      // Le CSS natif (animation-timeline: view()) fait le travail : on ne transmet que la vitesse.
+      if (nativeTimeline()) { ctx.set('--fx-speed', opts.reverse ? -opts.speed : opts.speed); return cleanup; }
+      onScroll(el, ctx, () => {
+        const r = el.getBoundingClientRect();
+        const off = parallaxOffset(viewProgress(r.top, r.height, window.innerHeight), opts.speed, opts.reverse);
+        ctx.set('--fx-parallax', `${off.toFixed(1)}px`);
+      });
+      return cleanup;
+    },
+  },
+});
+
+/** Enregistre pin, scrub et parallax 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);
+  }
+}