@mostajs/qrpanel 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+@mostajs/config
+Copyright (C) 2026 Dr Hamid MADANI <drmdh@msn.com>
+
+This program is free software: you can redistribute it and/or modify it under
+the terms of the GNU Affero General Public License as published by the Free
+Software Foundation, either version 3 of the License, or (at your option) any
+later version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/agpl-3.0.html>.

package/README.md

@@ -0,0 +1,141 @@
+# @mostajs/qrpanel
+
+QR code panel — générateur server-side *(PNG / SVG / data URL via la lib `qrcode`)* et composant React `<QrPanel>` *(QR + lien hypertexte copiable + actions copier / ouvrir / mailto)*.
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com>
+
+## Cross-OS
+
+Aucune dépendance native. La lib `qrcode` est pure JS — fonctionne identiquement sur **Linux, macOS, Windows**, en runtime Node ou Edge. Pas de chromium, pas de node-gyp.
+
+## Installation
+
+```bash
+npm install @mostajs/qrpanel
+```
+
+## Usage côté serveur
+
+```ts
+import { generateQrPng, generateQrSvg, generateQrDataUrl } from '@mostajs/qrpanel/server'
+
+// Buffer PNG pour streamer dans une route
+const png = await generateQrPng('https://example.com/invite/abc', {
+  width: 600,
+  errorCorrectionLevel: 'M',
+  darkColor: '#2563eb',
+})
+
+// SVG pour embed inline
+const svg = await generateQrSvg('https://...', { width: 200 })
+
+// Data URL pour <img src> direct
+const dataUrl = await generateQrDataUrl('https://...')
+```
+
+### Endpoint Next.js (App Router)
+
+```ts
+// app/api/qr/route.ts
+import { NextResponse } from 'next/server'
+import { generateQrPng } from '@mostajs/qrpanel/server'
+
+export const runtime = 'nodejs'
+
+export async function GET(req: Request) {
+  const url = new URL(req.url).searchParams.get('text') ?? ''
+  const png = await generateQrPng(url)
+  return new NextResponse(png as any, {
+    headers: { 'Content-Type': 'image/png' },
+  })
+}
+```
+
+## Usage côté client (React)
+
+```tsx
+import { QrPanel } from '@mostajs/qrpanel/client'
+
+<QrPanel
+  modes={[
+    {
+      key: 'direct',
+      label: 'Direct',
+      url: 'https://app.example.com/projet-x',
+      qrSrc: '/api/qr?text=' + encodeURIComponent('https://app.example.com/projet-x'),
+      description: 'Le QR mène directement au questionnaire.',
+    },
+    {
+      key: 'invite',
+      label: 'Invite token',
+      url: 'https://app.example.com/invite/eyJ...',
+      qrSrc: '/api/qr?text=' + encodeURIComponent('https://app.example.com/invite/eyJ...'),
+      description: 'Token signé valable 60 jours, idéal pour mailing.',
+    },
+  ]}
+  title="QR code & lien d'invitation"
+  mailSubject="Invitation au questionnaire"
+/>
+```
+
+### Avec un seul mode
+
+```tsx
+<QrPanel modes={[
+  { key: 'd', label: 'Direct', url, qrSrc },
+]} />
+```
+
+Le toggle de modes est masqué automatiquement quand `modes.length === 1`.
+
+## API
+
+### Server
+
+| Fonction | Retour | Cas |
+|----------|--------|-----|
+| `generateQrPng(text, opts)` | `Promise<Buffer>` | Stream PNG dans une route |
+| `generateQrSvg(text, opts)` | `Promise<string>` | Embed inline, scalable |
+| `generateQrDataUrl(text, opts)` | `Promise<string>` | `<img src>` direct |
+
+### Options communes
+
+```ts
+interface QrOptions {
+  width?: number              // px, default 600
+  margin?: number             // modules, default 2
+  errorCorrectionLevel?: 'L' | 'M' | 'Q' | 'H'   // default 'M'
+  darkColor?: string          // hex, default '#0f172a'
+  lightColor?: string         // hex, default '#ffffff'
+}
+```
+
+### Client `<QrPanel>`
+
+```ts
+interface QrPanelMode {
+  key: string                 // identifiant interne
+  label: string               // bouton
+  url: string                 // URL textuelle copiable
+  qrSrc: string               // src de l'image QR
+  description?: string
+}
+
+interface QrPanelProps {
+  modes: QrPanelMode[]
+  initialModeIndex?: number   // default 0
+  title?: string
+  mailSubject?: string        // default 'Invitation'
+  mailBodyTemplate?: string   // {url} = placeholder
+  qrSize?: number             // px, default 260
+  className?: string
+}
+```
+
+## Style
+
+Le composant utilise des classes Tailwind v3+. L'app consumer doit avoir Tailwind dans son pipeline. Les classes sont des chaînes, le composant reste portable *(utilisable même si l'app override le CSS)*.
+
+## Licence
+
+AGPL-3.0-or-later.

package/dist/client.d.ts

@@ -0,0 +1,30 @@
+export interface QrPanelMode {
+    /** Identifiant interne du mode (libre — sera passé en argument à `qrSrc`). */
+    key: string;
+    /** Libellé bouton. */
+    label: string;
+    /** URL absolue à afficher / copier dans ce mode. */
+    url: string;
+    /** URL de l'image QR pour ce mode (endpoint API ou data URL). */
+    qrSrc: string;
+    /** Description courte affichée sous l'en-tête. */
+    description?: string;
+}
+export interface QrPanelProps {
+    /** Liste des modes proposés (1 ou plusieurs). */
+    modes: QrPanelMode[];
+    /** Mode initial — index dans `modes`. Default 0. */
+    initialModeIndex?: number;
+    /** Titre du panel. Default 'QR code & lien d\'invitation'. */
+    title?: string;
+    /** Pré-remplissage `mailto`. Default 'Invitation'. */
+    mailSubject?: string;
+    /** Pré-remplissage `mailto` body — `{url}` est remplacé par l'URL courante. */
+    mailBodyTemplate?: 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;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +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"}

package/dist/client.js

@@ -0,0 +1,40 @@
+// @mostajs/qrpanel/client — React component
+// Author: Dr Hamid MADANI <drmdh@msn.com>
+//
+// Composant `<QrPanel>` agnostique de l'app. Affiche un QR + l'URL
+// textuelle copiable + 3 actions (copier, ouvrir, mailto).
+// Le composant ne génère pas le QR lui-même : l'app fournit le `qrSrc`
+// (URL d'un endpoint API ou data URL inline).
+//
+// Style : Tailwind classes — l'app les compile dans son build (le
+// component reste portable car les classes sont des chaînes).
+//
+// Note: marqué 'use client' pour Next.js App Router. Pour SPA (Vite,
+// CRA, etc.), la directive est ignorée — le component fonctionne tel
+// quel.
+'use client';
+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 = '', }) {
+    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))}`;
+    async function copy() {
+        try {
+            await navigator.clipboard.writeText(current.url);
+            setCopied(true);
+            setTimeout(() => setCopied(false), 2000);
+        }
+        catch {
+            const el = document.getElementById(textareaId);
+            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" })] })] })] })] }));
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,0CAA0C;AAC1C,EAAE;AACF,mEAAmE;AACnE,2DAA2D;AAC3D,uEAAuE;AACvE,8CAA8C;AAC9C,EAAE;AACF,kEAAkE;AAClE,8DAA8D;AAC9D,EAAE;AACF,qEAAqE;AACrE,qEAAqE;AACrE,QAAQ;AAER,YAAY,CAAA;;AACZ,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAgCvC,MAAM,YAAY,GAAG,qDAAqD,CAAA;AAE1E,MAAM,UAAU,OAAO,CAAC,EACtB,KAAK,EAAE,gBAAgB,GAAG,CAAC,EAAE,KAAK,GAAG,8BAA8B,EACnE,WAAW,GAAG,YAAY,EAAE,gBAAgB,GAAG,YAAY,EAC3D,MAAM,GAAG,GAAG,EAAE,SAAS,GAAG,EAAE,GACf;IACb,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;IACzF,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC3C,MAAM,UAAU,GAAG,KAAK,EAAE,CAAA;IAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAA;IACtC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IAEzB,MAAM,MAAM,GAAG,mBAAmB,kBAAkB,CAAC,WAAW,CAAC,SAAS,kBAAkB,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAA;IAE9I,KAAK,UAAU,IAAI;QACjB,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YAChD,SAAS,CAAC,IAAI,CAAC,CAAA;YACf,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAA;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,EAAE,GAAG,QAAQ,CAAC,cAAc,CAAC,UAAU,CAA+B,CAAA;YAC5E,EAAE,EAAE,MAAM,EAAE,CAAA;QACd,CAAC;IACH,CAAC;IAED,OAAO,CACL,eAAK,SAAS,EAAE,4DAA4D,GAAG,SAAS,aACtF,eAAK,SAAS,EAAC,yCAAyC,aACtD,aAAI,SAAS,EAAC,8BAA8B,YAAE,KAAK,GAAM,EACxD,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CACnB,cAAK,SAAS,EAAC,iCAAiC,YAC7C,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CACnB,iBACc,IAAI,EAAC,QAAQ,EAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAClD,SAAS,EAAE,oBAAoB,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,iCAAiC,CAAC,YAE3G,CAAC,CAAC,KAAK,IAHH,CAAC,CAAC,GAAG,CAIH,CACV,CAAC,GACE,CACP,IACG,EAEL,OAAO,CAAC,WAAW,IAAI,CACtB,YAAG,SAAS,EAAC,wBAAwB,YAAE,OAAO,CAAC,WAAW,GAAK,CAChE,EAED,eAAK,SAAS,EAAC,uCAAuC,aACpD,eAAK,SAAS,EAAC,kCAAkC,aAC/C,cACE,GAAG,EAAE,OAAO,CAAC,KAAK,EAClB,GAAG,EAAE,MAAM,OAAO,CAAC,KAAK,EAAE,EAC1B,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,SAAS,EAAC,oCAAoC,GAC9C,EACF,YACE,IAAI,EAAE,OAAO,CAAC,KAAK,EACnB,QAAQ,EAAE,MAAM,OAAO,CAAC,GAAG,MAAM,EACjC,SAAS,EAAC,2GAA2G,oDAGnH,IACA,EAEN,eAAK,SAAS,EAAC,WAAW,aACxB,iBAAO,SAAS,EAAC,OAAO,aACtB,eAAM,SAAS,EAAC,+CAA+C,4DAExD,EACP,mBACE,EAAE,EAAE,UAAU,EACd,QAAQ,QACR,KAAK,EAAE,OAAO,CAAC,GAAG,EAClB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACrC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAE,CAAC,CAAC,aAAqC,CAAC,MAAM,EAAE,EACjE,SAAS,EAAC,4FAA4F,GACtG,IACI,EACR,eAAK,SAAS,EAAC,mCAAmC,aAChD,iBACE,IAAI,EAAC,QAAQ,EAAC,OAAO,EAAE,IAAI,EAC3B,SAAS,EAAC,sEAAsE,YAE/E,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,GAClC,EACT,YACE,IAAI,EAAE,OAAO,CAAC,GAAG,EACjB,MAAM,EAAC,QAAQ,EAAC,GAAG,EAAC,YAAY,EAChC,SAAS,EAAC,4EAA4E,8BAGpF,EACJ,YACE,IAAI,EAAE,MAAM,EACZ,SAAS,EAAC,mGAAmG,gDAG3G,IACA,IACF,IACF,IACF,CACP,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './server.js';
+export * from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// @mostajs/qrpanel — barrel
+// Author: Dr Hamid MADANI <drmdh@msn.com>
+//
+// Re-export complet pour les consumers qui ne séparent pas client/server.
+// Préfère `@mostajs/qrpanel/server` ou `@mostajs/qrpanel/client` pour
+// éviter d'inclure React côté serveur ou qrcode côté client.
+export * from './server.js';
+export * from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,0CAA0C;AAC1C,EAAE;AACF,0EAA0E;AAC1E,sEAAsE;AACtE,6DAA6D;AAE7D,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/dist/server.d.ts

@@ -0,0 +1,27 @@
+export interface QrOptions {
+    /** Largeur/hauteur de l'image en pixels. Default 600. */
+    width?: number;
+    /** Marge blanche autour du QR (en modules). Default 2. */
+    margin?: number;
+    /**
+     * Niveau de correction d'erreur. Plus élevé = plus de redondance →
+     * QR plus dense mais résistant aux occlusions / impressions.
+     *   L = 7 %    (default qrcode lib)
+     *   M = 15 %   (recommandé pour usage écran)
+     *   Q = 25 %
+     *   H = 30 %   (recommandé si logo overlay)
+     */
+    errorCorrectionLevel?: 'L' | 'M' | 'Q' | 'H';
+    /** Couleur des modules sombres. Default '#0f172a' (slate-900). */
+    darkColor?: string;
+    /** Couleur du fond. Default '#ffffff'. */
+    lightColor?: string;
+}
+/** Génère un PNG (Buffer) d'un QR code encodant `text`. */
+export declare function generateQrPng(text: string, opts?: QrOptions): Promise<Buffer>;
+/** Génère un SVG (string) d'un QR code encodant `text`. */
+export declare function generateQrSvg(text: string, opts?: QrOptions): Promise<string>;
+/** Génère un Data URL `data:image/png;base64,...` — pratique pour
+ *  embarquer directement dans une balise `<img src>` sans endpoint dédié. */
+export declare function generateQrDataUrl(text: string, opts?: QrOptions): Promise<string>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IAC5C,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,SAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAUjF;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,SAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAWjF;AAED;6EAC6E;AAC7E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,SAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAUrF"}

package/dist/server.js

@@ -0,0 +1,45 @@
+// @mostajs/qrpanel/server — server-side QR generation (Node)
+// Author: Dr Hamid MADANI <drmdh@msn.com>
+//
+// Wrap minimaliste de la lib `qrcode` (npm). Cross-OS natif (Linux,
+// macOS, Windows) — pas de chromium/puppeteer requis.
+import QRCode from 'qrcode';
+/** Génère un PNG (Buffer) d'un QR code encodant `text`. */
+export function generateQrPng(text, opts = {}) {
+    return QRCode.toBuffer(text, {
+        width: opts.width ?? 600,
+        margin: opts.margin ?? 2,
+        errorCorrectionLevel: opts.errorCorrectionLevel ?? 'M',
+        color: {
+            dark: opts.darkColor ?? '#0f172a',
+            light: opts.lightColor ?? '#ffffff',
+        },
+    });
+}
+/** Génère un SVG (string) d'un QR code encodant `text`. */
+export function generateQrSvg(text, opts = {}) {
+    return QRCode.toString(text, {
+        type: 'svg',
+        width: opts.width ?? 600,
+        margin: opts.margin ?? 2,
+        errorCorrectionLevel: opts.errorCorrectionLevel ?? 'M',
+        color: {
+            dark: opts.darkColor ?? '#0f172a',
+            light: opts.lightColor ?? '#ffffff',
+        },
+    });
+}
+/** Génère un Data URL `data:image/png;base64,...` — pratique pour
+ *  embarquer directement dans une balise `<img src>` sans endpoint dédié. */
+export function generateQrDataUrl(text, opts = {}) {
+    return QRCode.toDataURL(text, {
+        width: opts.width ?? 600,
+        margin: opts.margin ?? 2,
+        errorCorrectionLevel: opts.errorCorrectionLevel ?? 'M',
+        color: {
+            dark: opts.darkColor ?? '#0f172a',
+            light: opts.lightColor ?? '#ffffff',
+        },
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,0CAA0C;AAC1C,EAAE;AACF,oEAAoE;AACpE,sDAAsD;AAEtD,OAAO,MAAM,MAAM,QAAQ,CAAA;AAsB3B,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAAkB,EAAE;IAC9D,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG;QACxB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC;QACxB,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,IAAI,GAAG;QACtD,KAAK,EAAE;YACL,IAAI,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS;YACjC,KAAK,EAAE,IAAI,CAAC,UAAU,IAAI,SAAS;SACpC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAAkB,EAAE;IAC9D,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC3B,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG;QACxB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC;QACxB,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,IAAI,GAAG;QACtD,KAAK,EAAE;YACL,IAAI,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS;YACjC,KAAK,EAAE,IAAI,CAAC,UAAU,IAAI,SAAS;SACpC;KACF,CAAC,CAAA;AACJ,CAAC;AAED;6EAC6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAkB,EAAE;IAClE,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;QAC5B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG;QACxB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC;QACxB,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,IAAI,GAAG;QACtD,KAAK,EAAE;YACL,IAAI,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS;YACjC,KAAK,EAAE,IAAI,CAAC,UAAU,IAAI,SAAS;SACpC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@mostajs/qrpanel",
+  "version": "0.1.0",
+  "description": "QR code panel — server-side PNG generator (qrcode npm, cross-OS, no chromium) + React client component <QrPanel> with copy/share/mailto.",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "default": "./dist/server.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "default": "./dist/client.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "qrcode",
+    "qr",
+    "react",
+    "invite",
+    "magic-link"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "qrcode": "^1.5.4"
+  },
+  "peerDependencies": {
+    "react": ">=18 <20"
+  },
+  "peerDependenciesMeta": {
+    "react": { "optional": true }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/qrcode": "^1.5.5",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "typescript": "^5.6.0"
+  }
+}