@mostajs/qrpanel 0.3.3 → 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,44 @@
+# @mostajs/qrpanel — Changelog
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com>
+
+## 0.5.0 — 2026-05-21
+
+### Feature — `<QrImage>` : génération QR locale côté navigateur
+
+Nouveau sous-export **`@mostajs/qrpanel/qr-image`** comblant le cas non
+couvert jusqu'ici : générer un QR code **dans le navigateur**, sans
+round-trip serveur ni service externe.
+
+- **`<QrImage data size … />`** — composant React qui génère le QR
+  localement (data URL via `qrcode`) et le rend en `<img>`. Style-neutre
+  (`style` / `className`), utilisable sans Tailwind.
+- **`useQrDataUrl(data, opts)`** — hook primitif renvoyant
+  `{ src, loading, error }`.
+- **COEP-safe** : sous cross-origin isolation (`require-corp`), une image
+  QR cross-origin est bloquée par la politique ; la génération locale est
+  alors la seule option côté client.
+- Sous-export dédié : `qrcode` n'entre dans le bundle client que pour les
+  consumers qui importent `@mostajs/qrpanel/qr-image`.
+
+Complémentarité des trois briques :
+- `./server` — `generateQr{Png,Svg,DataUrl}` (Node, thèmes, @resvg natif).
+- `./client` — `<QrPanel>` (copie / partage / mailto, `qrSrc` fourni).
+- `./qr-image` — `<QrImage>` (génération locale navigateur).
+
+### Change — `@mostajs/auth` et `@resvg/resvg-js` en peer deps optionnelles
+
+Ces deux dépendances ne servent qu'à `./server` (`@resvg` pour la
+rasterisation thématique, `@mostajs/auth` pour `buildInviteUrls`). Elles
+passent de `dependencies` à **`peerDependencies` optionnelles** : un
+consumer de `./qr-image` ou `./client` n'embarque plus la galaxie
+auth/rbac/net ni un binaire natif inutile. Les consumers de `./server`
+doivent désormais installer `@mostajs/auth` et `@resvg/resvg-js`
+eux-mêmes.
+
+## 0.4.0
+
+Générateur QR serveur (PNG/SVG/DataUrl) avec 12 thèmes intégrés
+(image-as-frame, ECC=H), pilotage par `.qrconfig.json`, cross-OS sans
+chromium ; composant React `<QrPanel>` (copie / ouvrir / mailto) ;
+helper `buildInviteUrls` (invite-token HMAC) ; CLI `qrpanel`.

package/README.md

@@ -15,10 +15,11 @@ Aucune dépendance Chromium / Puppeteer / node-gyp. Pure-JS pour `qrcode`, prebu
 ```js
 /** @type {import('next').NextConfig} */
 const nextConfig = {
-  serverExternalPackages: [
-    '@mostajs/qrpanel',
-    '@resvg/resvg-js',
-  ],
+  // Seulement @resvg/resvg-js (vraie dep native).
+  // ⚠️ Ne PAS mettre '@mostajs/qrpanel' ici : ça externaliserait
+  //    aussi /client (composant React <QrPanel>), et un Server
+  //    Component qui le rend crasherait avec "React.useState=null".
+  serverExternalPackages: ['@resvg/resvg-js'],
 }
 export default nextConfig
 ```

package/dist/client.d.ts

@@ -21,10 +21,21 @@ export interface QrPanelProps {
     mailSubject?: string;
     /** Pré-remplissage `mailto` body — `{url}` est remplacé par l'URL courante. */
     mailBodyTemplate?: string;
+    /**
+     * Destinataires placés dans `To:` du `mailto:` *(visibles entre eux)*.
+     * Liste d'emails (array ou string CSV). Combinable avec `mailBcc`.
+     */
+    mailTo?: string[] | string;
+    /**
+     * Destinataires placés dans `Bcc:` *(invisibles entre eux — recommandé
+     * pour les listes de cohort où les participants ne doivent pas voir
+     * les adresses des autres)*. Liste d'emails (array ou string CSV).
+     */
+    mailBcc?: string[] | string;
     /** Taille de l'image QR. Default 260. */
     qrSize?: number;
     /** Classe CSS racine optionnelle. */
     className?: string;
 }
-export declare function QrPanel({ modes, initialModeIndex, title, mailSubject, mailBodyTemplate, qrSize, className, }: QrPanelProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function QrPanel({ modes, initialModeIndex, title, mailSubject, mailBodyTemplate, mailTo, mailBcc, qrSize, className, }: QrPanelProps): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAkBA,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAA;IACX,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAID,wBAAgB,OAAO,CAAC,EACtB,KAAK,EAAE,gBAAoB,EAAE,KAAsC,EACnE,WAA0B,EAAE,gBAA+B,EAC3D,MAAY,EAAE,SAAc,GAC7B,EAAE,YAAY,kDAkGd"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAkBA,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAA;IACX,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IAC3B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAWD,wBAAgB,OAAO,CAAC,EACtB,KAAK,EAAE,gBAAoB,EAAE,KAAsC,EACnE,WAA0B,EAAE,gBAA+B,EAC3D,MAAM,EAAE,OAAO,EACf,MAAY,EAAE,SAAc,GAC7B,EAAE,YAAY,kDA8Gd"}

package/dist/client.js

@@ -16,14 +16,33 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState, useId } from 'react';
 const DEFAULT_BODY = 'Bonjour,\n\nVoici ton lien personnel :\n\n{url}\n\n';
-export function QrPanel({ modes, initialModeIndex = 0, title = 'QR code & lien d\'invitation', mailSubject = 'Invitation', mailBodyTemplate = DEFAULT_BODY, qrSize = 260, className = '', }) {
+/** Accepte une string CSV ou un array, normalise en array d'emails non-vides. */
+function normaliseRecipients(input) {
+    if (!input)
+        return [];
+    const arr = Array.isArray(input) ? input : input.split(',');
+    return arr.map(s => s.trim()).filter(s => s.length > 0);
+}
+export function QrPanel({ modes, initialModeIndex = 0, title = 'QR code & lien d\'invitation', mailSubject = 'Invitation', mailBodyTemplate = DEFAULT_BODY, mailTo, mailBcc, qrSize = 260, className = '', }) {
     const [idx, setIdx] = useState(Math.min(Math.max(0, initialModeIndex), modes.length - 1));
     const [copied, setCopied] = useState(false);
     const textareaId = useId();
     const current = modes[idx] ?? modes[0];
     if (!current)
         return null;
-    const mailto = `mailto:?subject=${encodeURIComponent(mailSubject)}&body=${encodeURIComponent(mailBodyTemplate.replace('{url}', current.url))}`;
+    const toList = normaliseRecipients(mailTo);
+    const bccList = normaliseRecipients(mailBcc);
+    const parts = [];
+    parts.push(`subject=${encodeURIComponent(mailSubject)}`);
+    parts.push(`body=${encodeURIComponent(mailBodyTemplate.replace('{url}', current.url))}`);
+    if (bccList.length > 0)
+        parts.push(`bcc=${encodeURIComponent(bccList.join(','))}`);
+    // `To:` est positionné juste après `mailto:` quand fourni (les
+    // destinataires To: sont rendus visibles entre eux par tous les clients).
+    // Les Bcc: passent par query param `&bcc=`.
+    const toPart = toList.length > 0 ? encodeURIComponent(toList.join(',')) : '';
+    const mailto = `mailto:${toPart}?${parts.join('&')}`;
+    const recipientCount = toList.length + bccList.length;
     async function copy() {
         try {
             await navigator.clipboard.writeText(current.url);
@@ -35,6 +54,6 @@ export function QrPanel({ modes, initialModeIndex = 0, title = 'QR code & lien d
             el?.select();
         }
     }
-    return (_jsxs("div", { className: 'bg-white border border-slate-200 rounded-xl p-4 space-y-3 ' + className, children: [_jsxs("div", { className: "flex items-center justify-between gap-2", children: [_jsx("h2", { className: "font-semibold text-slate-900", children: title }), modes.length > 1 && (_jsx("div", { className: "flex items-center gap-1 text-xs", children: modes.map((m, i) => (_jsx("button", { type: "button", onClick: () => setIdx(i), className: 'px-2 py-1 rounded ' + (i === idx ? 'bg-blue-600 text-white' : 'bg-slate-100 hover:bg-slate-200'), children: m.label }, m.key))) }))] }), current.description && (_jsx("p", { className: "text-xs text-slate-500", children: current.description })), _jsxs("div", { className: "grid md:grid-cols-2 gap-4 items-start", children: [_jsxs("div", { className: "flex flex-col items-center gap-2", children: [_jsx("img", { src: current.qrSrc, alt: `QR ${current.label}`, width: qrSize, height: qrSize, className: "border border-slate-200 rounded-lg" }), _jsx("a", { href: current.qrSrc, download: `qr-${current.key}.png`, className: "px-3 py-1.5 rounded text-xs bg-emerald-50 hover:bg-emerald-100 text-emerald-700 border border-emerald-200", children: "\u2B07 T\u00E9l\u00E9charger le PNG" })] }), _jsxs("div", { className: "space-y-2", children: [_jsxs("label", { className: "block", children: [_jsx("span", { className: "block text-xs font-medium text-slate-700 mb-1", children: "Lien direct *(\u00E0 coller dans un email)*" }), _jsx("textarea", { id: textareaId, readOnly: true, value: current.url, rows: current.url.length > 60 ? 4 : 2, onClick: (e) => e.currentTarget.select(), className: "w-full px-2 py-1.5 border border-slate-300 rounded text-xs font-mono bg-slate-50 break-all" })] }), _jsxs("div", { className: "flex items-center gap-2 flex-wrap", children: [_jsx("button", { type: "button", onClick: copy, className: "px-3 py-1.5 rounded text-xs bg-blue-600 text-white hover:bg-blue-700", children: copied ? '✓ Copié' : '📋 Copier le lien' }), _jsx("a", { href: current.url, target: "_blank", rel: "noreferrer", className: "px-3 py-1.5 rounded text-xs bg-slate-100 hover:bg-slate-200 text-slate-700", children: "\u2197 Ouvrir" }), _jsx("a", { href: mailto, className: "px-3 py-1.5 rounded text-xs bg-amber-50 hover:bg-amber-100 text-amber-700 border border-amber-200", children: "\u2709 Pr\u00E9-remplir un mail" })] })] })] })] }));
+    return (_jsxs("div", { className: 'bg-white border border-slate-200 rounded-xl p-4 space-y-3 ' + className, children: [_jsxs("div", { className: "flex items-center justify-between gap-2", children: [_jsx("h2", { className: "font-semibold text-slate-900", children: title }), modes.length > 1 && (_jsx("div", { className: "flex items-center gap-1 text-xs", children: modes.map((m, i) => (_jsx("button", { type: "button", onClick: () => setIdx(i), className: 'px-2 py-1 rounded ' + (i === idx ? 'bg-blue-600 text-white' : 'bg-slate-100 hover:bg-slate-200'), children: m.label }, m.key))) }))] }), current.description && (_jsx("p", { className: "text-xs text-slate-500", children: current.description })), _jsxs("div", { className: "grid md:grid-cols-2 gap-4 items-start", children: [_jsxs("div", { className: "flex flex-col items-center gap-2", children: [_jsx("img", { src: current.qrSrc, alt: `QR ${current.label}`, width: qrSize, height: qrSize, className: "border border-slate-200 rounded-lg" }), _jsx("a", { href: current.qrSrc, download: `qr-${current.key}.png`, className: "px-3 py-1.5 rounded text-xs bg-emerald-50 hover:bg-emerald-100 text-emerald-700 border border-emerald-200", children: "\u2B07 T\u00E9l\u00E9charger le PNG" })] }), _jsxs("div", { className: "space-y-2", children: [_jsxs("label", { className: "block", children: [_jsx("span", { className: "block text-xs font-medium text-slate-700 mb-1", children: "Lien direct *(\u00E0 coller dans un email)*" }), _jsx("textarea", { id: textareaId, readOnly: true, value: current.url, rows: current.url.length > 60 ? 4 : 2, onClick: (e) => e.currentTarget.select(), className: "w-full px-2 py-1.5 border border-slate-300 rounded text-xs font-mono bg-slate-50 break-all" })] }), _jsxs("div", { className: "flex items-center gap-2 flex-wrap", children: [_jsx("button", { type: "button", onClick: copy, className: "px-3 py-1.5 rounded text-xs bg-blue-600 text-white hover:bg-blue-700", children: copied ? '✓ Copié' : '📋 Copier le lien' }), _jsx("a", { href: current.url, target: "_blank", rel: "noreferrer", className: "px-3 py-1.5 rounded text-xs bg-slate-100 hover:bg-slate-200 text-slate-700", children: "\u2197 Ouvrir" }), _jsxs("a", { href: mailto, className: "px-3 py-1.5 rounded text-xs bg-amber-50 hover:bg-amber-100 text-amber-700 border border-amber-200", title: recipientCount > 0 ? `Ouvre le client mail avec ${recipientCount} destinataire(s) pré-remplis` : 'Ouvre le client mail avec sujet + corps pré-remplis', children: ["\u2709 Pr\u00E9-remplir un mail", recipientCount > 0 ? ` (${recipientCount})` : ''] })] })] })] })] }));
 }
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"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"}

package/dist/qr-image.d.ts

@@ -0,0 +1,32 @@
+export interface QrDataUrlOptions {
+    /** Côté de l'image en pixels. Défaut 200. */
+    size?: number;
+    /** Marge blanche autour du QR (en modules). Défaut 2. */
+    margin?: number;
+    /** Correction d'erreur : L 7 % | M 15 % | Q 25 % | H 30 %. Défaut 'M'. */
+    errorCorrectionLevel?: 'L' | 'M' | 'Q' | 'H';
+    /** Couleur des modules sombres. Défaut '#0f172a'. */
+    darkColor?: string;
+    /** Couleur du fond. Défaut '#ffffff'. */
+    lightColor?: string;
+}
+export interface UseQrDataUrlResult {
+    /** Data URL `data:image/png;base64,…` du QR, ou '' tant que non prêt. */
+    src: string;
+    /** True pendant la génération. */
+    loading: boolean;
+    /** Message d'erreur si la génération a échoué, sinon null. */
+    error: string | null;
+}
+/** Hook : génère le data URL d'un QR localement (navigateur). */
+export declare function useQrDataUrl(data: string, opts?: QrDataUrlOptions): UseQrDataUrlResult;
+export interface QrImageProps extends QrDataUrlOptions {
+    /** Donnée encodée dans le QR (URL, texte…). */
+    data: string;
+    alt?: string;
+    style?: React.CSSProperties;
+    className?: string;
+}
+/** QR code généré localement et rendu en `<img>` data-URL (COEP-safe). */
+export default function QrImage({ data, alt, style, className, ...opts }: QrImageProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=qr-image.d.ts.map

package/dist/qr-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-image.d.ts","sourceRoot":"","sources":["../src/qr-image.tsx"],"names":[],"mappings":"AAuBA,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0EAA0E;IAC1E,oBAAoB,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IAC5C,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAA;IACX,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,kBAAkB,CAwB1F;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,0EAA0E;AAC1E,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAC9B,IAAI,EAAE,GAAe,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,EACjD,EAAE,YAAY,2CAqBd"}

package/dist/qr-image.js

@@ -0,0 +1,68 @@
+// @mostajs/qrpanel/qr-image — composant QR généré côté navigateur
+// Author: Dr Hamid MADANI <drmdh@msn.com>
+//
+// QR code généré 100% dans le navigateur (data URL via `qrcode`), sans
+// appel réseau ni round-trip serveur. Complète les deux briques
+// existantes de qrpanel :
+//   - `<QrPanel>` (./client) attend un `qrSrc` déjà fourni par l'app.
+//   - `generateQr*` (./server) génère côté Node uniquement (@resvg natif).
+// `<QrImage>` couvre le cas manquant : génération locale, côté client.
+//
+// Cas d'usage clé — COEP `require-corp` : sous cross-origin isolation
+// (requise par ex. par ffmpeg.wasm / SharedArrayBuffer), une image QR
+// servie par un service externe est bloquée par la politique. La
+// génération locale est alors la seule option côté client.
+//
+// Sub-export dédié (`@mostajs/qrpanel/qr-image`) : `qrcode` n'est
+// embarqué dans le bundle client que pour les consumers qui l'importent.
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import QRCode from 'qrcode';
+/** Hook : génère le data URL d'un QR localement (navigateur). */
+export function useQrDataUrl(data, opts = {}) {
+    const { size = 200, margin = 2, errorCorrectionLevel = 'M', darkColor = '#0f172a', lightColor = '#ffffff', } = opts;
+    const [src, setSrc] = useState('');
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        let alive = true;
+        setLoading(true);
+        setError(null);
+        setSrc('');
+        QRCode.toDataURL(data, {
+            width: size, margin, errorCorrectionLevel,
+            color: { dark: darkColor, light: lightColor },
+        })
+            .then((url) => { if (alive) {
+            setSrc(url);
+            setLoading(false);
+        } })
+            .catch((e) => {
+            if (alive) {
+                setError(e?.message || 'QR generation failed');
+                setLoading(false);
+            }
+        });
+        return () => { alive = false; };
+    }, [data, size, margin, errorCorrectionLevel, darkColor, lightColor]);
+    return { src, loading, error };
+}
+/** QR code généré localement et rendu en `<img>` data-URL (COEP-safe). */
+export default function QrImage({ data, alt = 'QR code', style, className, ...opts }) {
+    const size = opts.size ?? 200;
+    const { src, loading, error } = useQrDataUrl(data, opts);
+    const box = {
+        width: size, height: size, display: 'flex',
+        alignItems: 'center', justifyContent: 'center',
+        background: '#fff', borderRadius: 6, border: '1px solid #e2e8f0',
+        fontSize: 11, color: '#94a3b8', textAlign: 'center',
+        ...style,
+    };
+    if (error)
+        return _jsx("div", { style: box, className: className, children: "QR indisponible" });
+    if (loading || !src)
+        return _jsx("div", { style: box, className: className, "aria-busy": "true", children: "\u2026" });
+    return (_jsx("img", { src: src, alt: alt, width: size, height: size, style: { background: '#fff', borderRadius: 6, display: 'block', ...style }, className: className }));
+}
+//# sourceMappingURL=qr-image.js.map

package/dist/qr-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-image.js","sourceRoot":"","sources":["../src/qr-image.tsx"],"names":[],"mappings":"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"}

package/llms.txt

@@ -0,0 +1,103 @@
+# @mostajs/qrpanel — fiche LLM
+> Panneau QR code : générateur serveur PNG/SVG à 12 thèmes (image-as-frame, ECC=H), piloté par config (.qrconfig.json), sans chromium, + composant React <QrPanel> avec copier/partager/mailto.
+
+- Version: 0.5.0 · Licence: AGPL-3.0-or-later · Auteur: Dr Hamid MADANI <drmdh@msn.com>
+- Chemin: mostajs/mosta-qrpanel · Statut audit: complet (dist/)
+
+## RÔLE
+Génère des QR codes pour apps Node/React. Trois briques complémentaires : (1) serveur —
+PNG/SVG/DataURL thématiques rendus côté Node via @resvg/resvg-js (pas de chromium) ;
+(2) client `<QrPanel>` — panneau d'invitation interactif (QR + lien + copier/partager) ;
+(3) `<QrImage>` — génération locale navigateur, COEP-safe. Inclut un CLI `qrpanel`.
+
+## INSTALLATION
+npm i @mostajs/qrpanel
+Dépendance directe : qrcode. Peers optionnelles : react (>=18 <20) pour ./client et
+./qr-image ; @mostajs/auth + @resvg/resvg-js requis uniquement par ./server.
+
+## EXPORTS
+- ./server : generateQrPng, generateQrSvg, generateQrDataUrl, buildInviteUrls + (ré-export) themes & config
+- ./client : QrPanel
+- ./qr-image : QrImage (default), useQrDataUrl
+- ./themes : THEMES, THEME_KEYS, listThemes, getTheme, pickRandomTheme, buildThemeFrameSvg
+- ./config : DEFAULT_CONFIG, loadQrConfig, ensureQrConfig, clearConfigCache
+- "." (barrel) : ré-exporte server + client + themes + config
+- bin `qrpanel` → CLI
+
+## EXPORTS PAR SOUS-CHEMIN
+- "." → barrel complet (server + client + themes + config) — ⚠ tire le code natif serveur
+- "./server" → generateQr*, buildInviteUrls, themes, config (Node uniquement)
+- "./client" → QrPanel (React, qrSrc fourni par l'app)
+- "./qr-image" → QrImage, useQrDataUrl (React, génération locale)
+- "./themes" → registry des 12 thèmes natifs
+- "./config" → chargement/écriture de .qrconfig.json
+
+## API — SIGNATURES
+- function generateQrPng(text: string, opts?: QrOptions): Promise<Buffer>
+- function generateQrSvg(text: string, opts?: QrOptions): Promise<string>
+- function generateQrDataUrl(text: string, opts?: QrOptions): Promise<string>   // data:image/png;base64
+- function buildInviteUrls(opts: BuildInviteUrlsOptions): InviteUrls
+- function QrPanel(props: QrPanelProps): JSX.Element | null
+- function QrImage(props: QrImageProps): JSX.Element
+- function useQrDataUrl(data: string, opts?: QrDataUrlOptions): { src: string; loading: boolean; error: string|null }
+- function listThemes(): ThemeKey[]
+- function getTheme(key: ThemeKey): ThemeAsset
+- function pickRandomTheme(pool?: ThemeKey[]): ThemeKey
+- function buildThemeFrameSvg(theme: ThemeAsset, opts: BuildFrameOpts): string
+- function loadQrConfig(cwd?: string): QrConfig
+- function ensureQrConfig(cwd?: string, overrides?: Partial<QrConfigDefaults>): string
+- function clearConfigCache(): void
+
+## TYPES CLÉS
+- QrOptions { width?=600; margin?=2; errorCorrectionLevel?='L'|'M'|'Q'|'H'; darkColor?='#0f172a';
+    lightColor?='#ffffff'; genimage?: boolean; theme?: ThemeKey|'random'|'none'|{ svg; label? };
+    themePool?: ThemeKey[]; framePadding?=0.13; centerWhiteRatio?=0.62; themeOpacity?=1; themeColor?='#1e293b' }
+- BuildInviteUrlsOptions { baseUrl: string; directPath: string; inviteSecret: string|Buffer;
+    inviteId: string; ttlMs?; invitePath?='/invite'; inviteMeta? }
+- InviteUrls { directUrl: string; inviteUrl: string; inviteToken: string }
+- QrPanelMode { key; label; url; qrSrc: string; description? }
+- QrPanelProps { modes: QrPanelMode[]; initialModeIndex?=0; title?; mailSubject?; mailBodyTemplate?;
+    mailTo?: string[]|string; mailBcc?: string[]|string; qrSize?=260; className? }
+- QrImageProps extends QrDataUrlOptions { data: string; alt?; style?; className? }
+- QrDataUrlOptions { size?=200; margin?=2; errorCorrectionLevel?='M'; darkColor?='#0f172a'; lightColor?='#ffffff' }
+- ThemeKey = 'baby'|'animals'|'science'|'physics'|'chemistry'|'math'|'nature'|'tech'|'space'|'music'|'book'|'health'
+- ThemeAsset { key: ThemeKey; label: string; motif: string }
+- QrConfig { default: QrConfigDefaults; customThemes?: Record<string,{svg;label?}> }
+- QrFormat = 'svg'|'png'|'dataUrl' ; QrEcc = 'L'|'M'|'Q'|'H'
+
+## PATTERN
+```ts
+// Serveur — QR thématique en route API (Node uniquement)
+import { generateQrPng } from '@mostajs/qrpanel/server';
+const png = await generateQrPng('https://app.example.com/x', { theme: 'tech', errorCorrectionLevel: 'H' });
+
+// Client — panneau d'invitation
+import { QrPanel } from '@mostajs/qrpanel/client';
+<QrPanel modes={[{ key: 'direct', label: 'Lien', url, qrSrc: '/api/qr?u=' + url }]} />
+
+// Génération locale navigateur (COEP-safe)
+import QrImage from '@mostajs/qrpanel/qr-image';
+<QrImage data="https://example.com" size={240} />
+```
+
+## DÉPEND DE
+- @mostajs/auth (peer optionnel, >=3.2.0) — requis par buildInviteUrls (signature HMAC du token)
+- @resvg/resvg-js (peer optionnel, >=2.6.2) — requis par generateQr* (rasterisation SVG → PNG)
+- react (peer optionnel, >=18 <20) — pour ./client et ./qr-image
+
+## PIÈGES
+- Ne PAS importer le barrel "." ni "./server" dans un bundle navigateur : @resvg/resvg-js
+  est un binaire natif Node. Côté client, utiliser exclusivement ./client ou ./qr-image.
+- `<QrPanel>` NE génère PAS le QR : l'app fournit `qrSrc` (endpoint API ou data URL).
+- `<QrPanel>` requiert Tailwind (style compilé par l'app) ; `<QrImage>` est style-neutre.
+- `genimage: false` court-circuite tout le pipeline thématique (QR pur, comportement legacy).
+- `theme: 'H'` (ECC=30%) recommandé pour les thèmes image-as-frame ; un ECC plus bas peut
+  rendre le QR illisible avec un cadre.
+- `loadQrConfig` peut auto-créer `.qrconfig.json` à `process.cwd()` ; désactiver via
+  `QRPANEL_AUTO_ENSURE=false`. Échec d'écriture → fallback transparent sur DEFAULT_CONFIG.
+- `mailBcc` recommandé pour les cohortes (les destinataires ne se voient pas) vs `mailTo`.
+
+## RÉFÉRENCES
+- README.md
+- CHANGELOG.md
+- src/, dist/cli.js (CLI `npx qrpanel`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/qrpanel",
-  "version": "0.3.3",
+  "version": "0.5.0",
   "description": "QR code panel — server-side PNG/SVG generator with 12 built-in themes (image-as-frame composite, ECC=H), config-driven (.qrconfig.json), cross-OS no chromium, + React <QrPanel> client with copy/share/mailto.",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
   "license": "AGPL-3.0-or-later",
@@ -26,6 +26,11 @@
       "import": "./dist/client.js",
       "default": "./dist/client.js"
     },
+    "./qr-image": {
+      "types": "./dist/qr-image.d.ts",
+      "import": "./dist/qr-image.js",
+      "default": "./dist/qr-image.js"
+    },
     "./themes": {
       "types": "./dist/themes.d.ts",
       "import": "./dist/themes.js",
@@ -40,7 +45,9 @@
   "files": [
     "dist",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md",
+    "llms.txt"
   ],
   "keywords": [
     "qrcode",
@@ -58,20 +65,24 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "qrcode": "^1.5.4",
-    "@mostajs/auth": "^3.2.0",
-    "@resvg/resvg-js": "^2.6.2"
+    "qrcode": "^1.5.4"
   },
   "peerDependencies": {
-    "react": ">=18 <20"
+    "react": ">=18 <20",
+    "@mostajs/auth": ">=3.2.0",
+    "@resvg/resvg-js": ">=2.6.2"
   },
   "peerDependenciesMeta": {
-    "react": { "optional": true }
+    "react": { "optional": true },
+    "@mostajs/auth": { "optional": true },
+    "@resvg/resvg-js": { "optional": true }
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/qrcode": "^1.5.5",
     "@types/react": "^19.0.0",
+    "@mostajs/auth": "^3.2.0",
+    "@resvg/resvg-js": "^2.6.2",
     "react": "^19.0.0",
     "typescript": "^5.6.0"
   }