@mostajs/qrpanel 0.2.0 → 0.3.1

package/README.md

@@ -1,12 +1,12 @@
 # @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)*.
+QR code panel — générateur server-side *(PNG / SVG / data URL via la lib `qrcode`)* avec **12 thèmes natifs** *(image-as-frame composite, ECC=H par défaut)*, piloté par un fichier de config `.qrconfig.json` éditable. 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.
+Aucune dépendance Chromium / Puppeteer / node-gyp. Pure-JS pour `qrcode`, prebuilt-binaries Rust pour le rasterizer (`@resvg/resvg-js`). Fonctionne identiquement sur **Linux, macOS, Windows** *(Node ≥18)*.
 
 ## Installation
 
@@ -14,23 +14,102 @@ Aucune dépendance native. La lib `qrcode` est pure JS — fonctionne identiquem
 npm install @mostajs/qrpanel
 ```
 
-## Usage côté serveur
+## Quickstart
 
 ```ts
-import { generateQrPng, generateQrSvg, generateQrDataUrl } from '@mostajs/qrpanel/server'
+import { generateQrPng, ensureQrConfig } from '@mostajs/qrpanel/server'
+
+// (Optionnel) écrire .qrconfig.json à la racine — lifecycle init / boot.
+ensureQrConfig()
+
+// Génère un PNG composite (cadre thème "random" tiré dans themePool).
+const png = await generateQrPng('https://example.com/invite/abc')
+```
+
+## v0.3 — thèmes & config
+
+Le module embarque **12 thèmes vectoriels** *(SVG inline mono-color, ~2-3 Ko chacun, libres de droits — création maison)*, répliqués aux 4 coins d'un cadre décoratif. Le QR reste centré sur un cartouche blanc plein, ECC=H par défaut → scannable même avec cadre coloré.
+
+### Thèmes natifs
+
+| Clé | Label | Clé | Label |
+|---|---|---|---|
+| `baby` | Bébé | `nature` | Nature |
+| `animals` | Animaux | `tech` | Tech |
+| `science` | Science | `space` | Espace |
+| `physics` | Physique | `music` | Musique |
+| `chemistry` | Chimie | `book` | Livre |
+| `math` | Mathématique | `health` | Santé |
+
+### Fichier `.qrconfig.json`
+
+Généré à `process.cwd()` via `ensureQrConfig()` ou `npx qrpanel init`. Pilote tous les générateurs au runtime *(cache invalidé par `mtime` — édite le fichier, le prochain appel le relit)*.
+
+```jsonc
+{
+  "default": {
+    "genimage": true,                  // ← master toggle (false = QR pur, bypass total)
+    "format": "svg",
+    "width": 600,
+    "margin": 2,
+    "errorCorrectionLevel": "H",       // overlay-safe (30% redondance)
+    "darkColor": "#0f172a",
+    "lightColor": "#ffffff",
+    "theme": "random",                 // 'random' | clé thème | 'none'
+    "themePool": [
+      "baby", "animals", "science", "physics",
+      "chemistry", "math", "nature", "tech",
+      "space", "music", "book", "health"
+    ],
+    "framePadding": 0.13,
+    "centerWhiteRatio": 0.62,
+    "themeOpacity": 1.0,
+    "themeColor": "#1e293b"
+  }
+}
+```
+
+### Cascade de résolution
+
+```
+defaults compilés  <  .qrconfig.json (cwd)  <  options passées à l'appel
+```
+
+### Master toggle `genimage`
+
+```jsonc
+{ "default": { "genimage": false } }    // OU :
+generateQrPng(url, { genimage: false }) // override ponctuel
+```
+
+→ court-circuite tout le pipeline composite, retombe sur le **QR pur** *(comportement v0.2.x identique)*. Utile en debug / CI / mode "print neutre".
+
+## Usage côté serveur
 
-// Buffer PNG pour streamer dans une route
-const png = await generateQrPng('https://example.com/invite/abc', {
+```ts
+import {
+  generateQrPng, generateQrSvg, generateQrDataUrl,
+  listThemes, ensureQrConfig,
+} from '@mostajs/qrpanel/server'
+
+// Buffer PNG composite (cadre thème science)
+const png = await generateQrPng('https://example.com/x', {
+  theme: 'science',
   width: 600,
-  errorCorrectionLevel: 'M',
-  darkColor: '#2563eb',
+  themeColor: '#0ea5e9',
+})
+
+// SVG composite avec random tiré dans un sous-set
+const svg = await generateQrSvg('https://example.com/x', {
+  theme: 'random',
+  themePool: ['math', 'physics', 'chemistry'],
 })
 
-// SVG pour embed inline
-const svg = await generateQrSvg('https://...', { width: 200 })
+// DataURL PNG composite (image inline)
+const dataUrl = await generateQrDataUrl('https://example.com/x')
 
-// Data URL pour <img src> direct
-const dataUrl = await generateQrDataUrl('https://...')
+// Override ponctuel — désactive le composite ne serait-ce qu'une fois
+const plain = await generateQrPng('https://example.com/x', { genimage: false })
 ```
 
 ### Endpoint Next.js (App Router)
@@ -44,13 +123,23 @@ export const runtime = 'nodejs'
 
 export async function GET(req: Request) {
   const url = new URL(req.url).searchParams.get('text') ?? ''
-  const png = await generateQrPng(url)
+  const theme = (new URL(req.url).searchParams.get('theme') ?? 'random') as any
+  const png = await generateQrPng(url, { theme })
   return new NextResponse(png as any, {
     headers: { 'Content-Type': 'image/png' },
   })
 }
 ```
 
+### Thème custom inline
+
+```ts
+const png = await generateQrPng(url, {
+  theme: { svg: '<circle cx="0" cy="0" r="5" fill="currentColor"/>', label: 'My logo' },
+  themeColor: '#ff0000',
+})
+```
+
 ## Usage côté client (React)
 
 ```tsx
@@ -62,14 +151,14 @@ import { QrPanel } from '@mostajs/qrpanel/client'
       key: 'direct',
       label: 'Direct',
       url: 'https://app.example.com/projet-x',
-      qrSrc: '/api/qr?text=' + encodeURIComponent('https://app.example.com/projet-x'),
+      qrSrc: '/api/qr?text=' + encodeURIComponent('https://app.example.com/projet-x') + '&theme=science',
       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...'),
+      qrSrc: '/api/qr?text=...&theme=random',
       description: 'Token signé valable 60 jours, idéal pour mailing.',
     },
   ]}
@@ -78,15 +167,30 @@ import { QrPanel } from '@mostajs/qrpanel/client'
 />
 ```
 
-### Avec un seul mode
+## CLI
 
-```tsx
-<QrPanel modes={[
-  { key: 'd', label: 'Direct', url, qrSrc },
-]} />
+```bash
+npx qrpanel init           # écrit .qrconfig.json (idempotent)
+npx qrpanel themes         # liste les 12 thèmes
+npx qrpanel --version
 ```
 
-Le toggle de modes est masqué automatiquement quand `modes.length === 1`.
+## Helper combiné — `buildInviteUrls`
+
+Inchangé depuis v0.2.
+
+```ts
+import { buildInviteUrls } from '@mostajs/qrpanel/server'
+
+const { directUrl, inviteUrl, inviteToken } = buildInviteUrls({
+  baseUrl: 'https://app.example.com',
+  directPath: '/projet-x',
+  inviteSecret: process.env.INVITE_SECRET!,
+  inviteId: project.id,
+  ttlMs: 60 * 24 * 3600 * 1000,
+  inviteMeta: { kind: 'cohort-invite' },
+})
+```
 
 ## API
 
@@ -94,47 +198,57 @@ Le toggle de modes est masqué automatiquement quand `modes.length === 1`.
 
 | 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 |
+| `generateQrPng(text, opts?)` | `Promise<Buffer>` | PNG composite ou QR pur si genimage=false |
+| `generateQrSvg(text, opts?)` | `Promise<string>` | SVG composite ou QR pur |
+| `generateQrDataUrl(text, opts?)` | `Promise<string>` | DataURL PNG |
+| `loadQrConfig(cwd?)` | `QrConfig` | Lit `.qrconfig.json` *(cached mtime)* |
+| `ensureQrConfig(cwd?, overrides?)` | `string` | Crée `.qrconfig.json` si absent (idempotent) |
+| `listThemes()` | `ThemeKey[]` | Liste des 12 clés natives |
+| `buildInviteUrls(opts)` | `InviteUrls` | URL builder + invite-token signé |
 
-### Options communes
+### `QrOptions`
 
 ```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'
+  // Communs
+  width?: number
+  margin?: number
+  errorCorrectionLevel?: 'L' | 'M' | 'Q' | 'H'
+  darkColor?: string
+  lightColor?: string
+
+  // v0.3 thématique
+  genimage?: boolean             // master toggle (override config)
+  theme?: ThemeKey | 'random' | 'none' | { svg: string; label?: string }
+  themePool?: ThemeKey[]
+  framePadding?: number          // 0..0.5
+  centerWhiteRatio?: number      // 0..1
+  themeOpacity?: number          // 0..1
+  themeColor?: string            // CSS color
 }
 ```
 
-### Client `<QrPanel>`
+### Client `<QrPanel>` — inchangé v0.2
 
 ```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
+  initialModeIndex?: number
   title?: string
-  mailSubject?: string        // default 'Invitation'
-  mailBodyTemplate?: string   // {url} = placeholder
-  qrSize?: number             // px, default 260
+  mailSubject?: string
+  mailBodyTemplate?: string
+  qrSize?: number
   className?: string
 }
 ```
 
-## Style
+## Dépendances
 
-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)*.
+| Package | Rôle | Pourquoi pas X |
+|---|---|---|
+| `qrcode` | Génère le QR pur (SVG/PNG) | Pure-JS, cross-OS, déjà éprouvé |
+| `@resvg/resvg-js` | Rasterise le SVG composite en PNG | Rust prebuilt binaries (no node-gyp, no chromium) |
+| `@mostajs/auth` | `signInviteToken` pour `buildInviteUrls` | Cohérence écosystème mostajs |
 
 ## Licence
 

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+// @mostajs/qrpanel — CLI
+// Author: Dr Hamid MADANI <drmdh@msn.com>
+//
+// Commandes disponibles :
+//   qrpanel init        → écrit .qrconfig.json à cwd avec les defaults
+//   qrpanel themes      → liste les 12 thèmes natifs
+//   qrpanel --version   → version du package
+import { ensureQrConfig, DEFAULT_CONFIG } from './config.js';
+import { listThemes, THEMES } from './themes.js';
+const args = process.argv.slice(2);
+const cmd = args[0] ?? 'help';
+function help() {
+    console.log(`@mostajs/qrpanel — CLI
+
+Usage:
+  qrpanel init [path]      Generate .qrconfig.json at cwd (or [path]).
+                           Idempotent — does not overwrite existing config.
+  qrpanel themes           List built-in theme keys.
+  qrpanel --version | -v   Print version.
+  qrpanel help | -h        This help.
+
+Config file (.qrconfig.json) drives all generators. Master toggle:
+  "genimage": false  → bypass theme pipeline, QR-only output.
+  "theme": "random"  → randomize from themePool at each generation.
+`);
+}
+async function main() {
+    switch (cmd) {
+        case 'init': {
+            const cwd = args[1] ?? process.cwd();
+            const path = ensureQrConfig(cwd);
+            console.log(`✓ qrpanel config ready at: ${path}`);
+            console.log(`  Edit it to customize defaults — master toggle "genimage" toggles the whole pipeline.`);
+            break;
+        }
+        case 'themes': {
+            console.log(`Built-in themes (${listThemes().length}):`);
+            for (const key of listThemes()) {
+                console.log(`  - ${key.padEnd(10)} (${THEMES[key].label})`);
+            }
+            console.log(`\nDefaults config :`);
+            console.log(`  themePool : ${DEFAULT_CONFIG.default.themePool.join(', ')}`);
+            break;
+        }
+        case '--version':
+        case '-v': {
+            // Lecture programmatique du package.json sans import JSON (cross-runtime safe)
+            const { readFileSync } = await import('node:fs');
+            const { fileURLToPath } = await import('node:url');
+            const { dirname, join } = await import('node:path');
+            const here = dirname(fileURLToPath(import.meta.url));
+            const pkgPath = join(here, '..', 'package.json');
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            console.log(pkg.version);
+            break;
+        }
+        case 'help':
+        case '--help':
+        case '-h':
+        default:
+            help();
+            break;
+    }
+}
+main().catch((e) => {
+    console.error('[qrpanel] error:', e.message);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,yBAAyB;AACzB,0CAA0C;AAC1C,EAAE;AACF,0BAA0B;AAC1B,uEAAuE;AACvE,qDAAqD;AACrD,6CAA6C;AAE7C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEhD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAClC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAA;AAE7B,SAAS,IAAI;IACX,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;CAYb,CAAC,CAAA;AACF,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;YACpC,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;YAChC,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAA;YACjD,OAAO,CAAC,GAAG,CAAC,wFAAwF,CAAC,CAAA;YACrG,MAAK;QACP,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,oBAAoB,UAAU,EAAE,CAAC,MAAM,IAAI,CAAC,CAAA;YACxD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,EAAE,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAA;YAC7D,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;YAClC,OAAO,CAAC,GAAG,CAAC,iBAAiB,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC3E,MAAK;QACP,CAAC;QACD,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI,CAAC,CAAC,CAAC;YACV,+EAA+E;YAC/E,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAA;YAChD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAA;YAClD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAA;YACnD,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;YACpD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAA;YAChD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAwB,CAAA;YAC7E,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACxB,MAAK;QACP,CAAC;QACD,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV;YACE,IAAI,EAAE,CAAA;YACN,MAAK;IACT,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAG,CAAW,CAAC,OAAO,CAAC,CAAA;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/composer.d.ts

@@ -0,0 +1,43 @@
+import { type ThemeKey, type ThemeAsset } from './themes.js';
+import type { QrConfigDefaults } from './config.js';
+export interface ComposeOptions {
+    width: number;
+    errorCorrectionLevel: 'L' | 'M' | 'Q' | 'H';
+    darkColor: string;
+    lightColor: string;
+    theme: ThemeKey | 'random' | 'none' | {
+        svg: string;
+        label?: string;
+    };
+    themePool: ThemeKey[];
+    framePadding: number;
+    centerWhiteRatio: number;
+    themeOpacity: number;
+    themeColor: string;
+}
+/**
+ * Résout la prop `theme` en thème concret.
+ * - 'random' → tire dans themePool
+ * - 'none'   → null (caller doit fallback sur QR pur)
+ * - { svg }  → thème inline custom
+ * - clé      → thème natif via registry
+ */
+export declare function resolveTheme(theme: ComposeOptions['theme'], pool: ThemeKey[]): ThemeAsset | null;
+/**
+ * Génère le SVG composite (theme frame + center white card + QR).
+ * Si theme='none', retourne null — le caller doit fallback sur le QR pur.
+ */
+export declare function composeThemedSvg(text: string, opts: ComposeOptions): Promise<string | null>;
+/**
+ * Génère le PNG composite via @resvg/resvg-js.
+ * Si theme='none', retourne null — le caller doit fallback.
+ */
+export declare function composeThemedPng(text: string, opts: ComposeOptions): Promise<Buffer | null>;
+/**
+ * Génère un Data URL PNG du composite.
+ * Si theme='none', retourne null — le caller doit fallback.
+ */
+export declare function composeThemedDataUrl(text: string, opts: ComposeOptions): Promise<string | null>;
+/** Helper de merge config + opts pour les fonctions de génération. */
+export declare function mergeComposeOpts(cfg: QrConfigDefaults, opts?: Partial<ComposeOptions>): ComposeOptions;
+//# sourceMappingURL=composer.d.ts.map

package/dist/composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../src/composer.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,KAAK,QAAQ,EAAE,KAAK,UAAU,EAE/B,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,oBAAoB,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACrE,SAAS,EAAE,QAAQ,EAAE,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAC9B,IAAI,EAAE,QAAQ,EAAE,GACf,UAAU,GAAG,IAAI,CAOnB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqDxB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIxB;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,gBAAgB,EACrB,IAAI,GAAE,OAAO,CAAC,cAAc,CAAM,GACjC,cAAc,CAahB"}

package/dist/composer.js

@@ -0,0 +1,123 @@
+// @mostajs/qrpanel/composer — themed composite generator
+// Author: Dr Hamid MADANI <drmdh@msn.com>
+//
+// Compose un SVG global :
+//   1. background blanc full canvas
+//   2. cadre thématique (4 motifs aux coins) via themes.buildThemeFrameSvg
+//   3. cartouche blanc central (rect)
+//   4. QR centré dans le cartouche, ECC élevé recommandé
+//
+// Le PNG composite est obtenu en rasterisant le SVG via @resvg/resvg-js
+// (rust prebuilt-binaries cross-OS, no chromium, no node-gyp).
+import QRCode from 'qrcode';
+import { Resvg } from '@resvg/resvg-js';
+import { getTheme, pickRandomTheme, buildThemeFrameSvg, } from './themes.js';
+/**
+ * Résout la prop `theme` en thème concret.
+ * - 'random' → tire dans themePool
+ * - 'none'   → null (caller doit fallback sur QR pur)
+ * - { svg }  → thème inline custom
+ * - clé      → thème natif via registry
+ */
+export function resolveTheme(theme, pool) {
+    if (theme === 'none')
+        return null;
+    if (typeof theme === 'object' && theme && 'svg' in theme) {
+        return { key: 'custom', label: theme.label ?? 'Custom', motif: theme.svg };
+    }
+    const key = theme === 'random' ? pickRandomTheme(pool) : theme;
+    return getTheme(key);
+}
+/**
+ * Génère le SVG composite (theme frame + center white card + QR).
+ * Si theme='none', retourne null — le caller doit fallback sur le QR pur.
+ */
+export async function composeThemedSvg(text, opts) {
+    const themeAsset = resolveTheme(opts.theme, opts.themePool);
+    if (!themeAsset)
+        return null;
+    const w = opts.width;
+    // 1. QR SVG inline — margin=0, on lui donne sa propre marge via le cartouche
+    const qrRawSvg = await QRCode.toString(text, {
+        type: 'svg',
+        margin: 0,
+        errorCorrectionLevel: opts.errorCorrectionLevel,
+        color: { dark: opts.darkColor, light: opts.lightColor },
+    });
+    // 2. Extrait le viewBox et le contenu interne du QR SVG
+    const vbMatch = qrRawSvg.match(/viewBox="([^"]+)"/);
+    const qrViewBox = vbMatch?.[1] ?? '0 0 21 21';
+    const qrInner = qrRawSvg
+        .replace(/<\?xml[^>]*\?>\s*/, '')
+        .replace(/<svg[^>]*>/, '')
+        .replace(/<\/svg>\s*$/, '');
+    // 3. Géométrie : cartouche blanc central + QR à l'intérieur (avec
+    //    une marge de respiration entre le QR et le bord du cartouche)
+    const centerSize = w * opts.centerWhiteRatio;
+    const centerX = (w - centerSize) / 2;
+    const qrInsideMargin = centerSize * 0.06; // 6% de la taille cartouche
+    const qrSize = centerSize - 2 * qrInsideMargin;
+    const qrX = centerX + qrInsideMargin;
+    const qrY = centerX + qrInsideMargin;
+    // 4. Cadre thématique (4 coins) — scale et positions auto-calculés
+    //    depuis centerWhiteRatio (zone marge entre cartouche et bord).
+    const frame = buildThemeFrameSvg(themeAsset, {
+        width: w,
+        color: opts.themeColor,
+        opacity: opts.themeOpacity,
+        framePadding: opts.framePadding,
+        centerWhiteRatio: opts.centerWhiteRatio,
+    });
+    // 5. SVG composite final
+    const svg = `<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${w} ${w}" width="${w}" height="${w}">
+  <rect width="${w}" height="${w}" fill="${opts.lightColor}"/>
+  ${frame}
+  <rect x="${centerX}" y="${centerX}" width="${centerSize}" height="${centerSize}" fill="${opts.lightColor}"/>
+  <svg x="${qrX}" y="${qrY}" width="${qrSize}" height="${qrSize}" viewBox="${qrViewBox}" shape-rendering="crispEdges">
+    ${qrInner}
+  </svg>
+</svg>`;
+    return svg;
+}
+/**
+ * Génère le PNG composite via @resvg/resvg-js.
+ * Si theme='none', retourne null — le caller doit fallback.
+ */
+export async function composeThemedPng(text, opts) {
+    const svg = await composeThemedSvg(text, opts);
+    if (!svg)
+        return null;
+    const resvg = new Resvg(svg, {
+        fitTo: { mode: 'width', value: opts.width },
+        background: opts.lightColor,
+    });
+    const rendered = resvg.render();
+    return Buffer.from(rendered.asPng());
+}
+/**
+ * Génère un Data URL PNG du composite.
+ * Si theme='none', retourne null — le caller doit fallback.
+ */
+export async function composeThemedDataUrl(text, opts) {
+    const png = await composeThemedPng(text, opts);
+    if (!png)
+        return null;
+    return `data:image/png;base64,${png.toString('base64')}`;
+}
+/** Helper de merge config + opts pour les fonctions de génération. */
+export function mergeComposeOpts(cfg, opts = {}) {
+    return {
+        width: opts.width ?? cfg.width,
+        errorCorrectionLevel: opts.errorCorrectionLevel ?? cfg.errorCorrectionLevel,
+        darkColor: opts.darkColor ?? cfg.darkColor,
+        lightColor: opts.lightColor ?? cfg.lightColor,
+        theme: opts.theme ?? cfg.theme,
+        themePool: opts.themePool ?? cfg.themePool,
+        framePadding: opts.framePadding ?? cfg.framePadding,
+        centerWhiteRatio: opts.centerWhiteRatio ?? cfg.centerWhiteRatio,
+        themeOpacity: opts.themeOpacity ?? cfg.themeOpacity,
+        themeColor: opts.themeColor ?? cfg.themeColor,
+    };
+}
+//# sourceMappingURL=composer.js.map

package/dist/composer.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,62 @@
+import type { ThemeKey } from './themes.js';
+export type QrFormat = 'svg' | 'png' | 'dataUrl';
+export type QrEcc = 'L' | 'M' | 'Q' | 'H';
+/** Valeurs par défaut éditables dans .qrconfig.json. */
+export interface QrConfigDefaults {
+    /** Master toggle — false = QR pur (legacy), bypass tout le pipeline thématique. */
+    genimage: boolean;
+    /** Format préféré quand l'app n'en spécifie pas un. */
+    format: QrFormat;
+    /** Largeur/hauteur du canvas SVG/PNG en pixels. */
+    width: number;
+    /** Marge blanche autour du QR (en modules). */
+    margin: number;
+    /** Niveau de correction d'erreur. 'H' recommandé pour composite (ECC=30%). */
+    errorCorrectionLevel: QrEcc;
+    /** Couleur des modules sombres du QR. */
+    darkColor: string;
+    /** Couleur du fond (cartouche central). */
+    lightColor: string;
+    /** 'random' = tirage dans themePool, ou clé thème, ou 'none' (= image off ponctuel). */
+    theme: ThemeKey | 'random' | 'none';
+    /** Sous-set des thèmes utilisés quand theme='random'. */
+    themePool: ThemeKey[];
+    /**
+     * Position du motif dans la zone-marge (0..1) :
+     *   0   = collé au bord
+     *   0.5 = centre de la marge (optimal — default)
+     *   1   = collé contre le cartouche
+     */
+    framePadding: number;
+    /** Taille du cartouche blanc central (proportion du canvas, 0..1). */
+    centerWhiteRatio: number;
+    /** Opacité du cadre image (0..1). */
+    themeOpacity: number;
+    /** Couleur monochrome du cadre image (CSS color). */
+    themeColor: string;
+}
+export interface QrConfig {
+    default: QrConfigDefaults;
+    /** Thèmes custom — clé arbitraire, override ou ajout. */
+    customThemes?: Record<string, {
+        svg: string;
+        label?: string;
+    }>;
+}
+export declare const DEFAULT_CONFIG: QrConfig;
+/**
+ * Lit la config depuis `cwd` (default `process.cwd()`).
+ * Retourne `DEFAULT_CONFIG` si aucun fichier trouvé.
+ * Cache invalidé par mtime du fichier.
+ */
+export declare function loadQrConfig(cwd?: string): QrConfig;
+/**
+ * Crée `.qrconfig.json` à `cwd` s'il n'existe pas. Idempotent.
+ * Retourne le path écrit (ou path existant si déjà là).
+ *
+ * @param overrides — valeurs par défaut à patcher dans le fichier généré.
+ */
+export declare function ensureQrConfig(cwd?: string, overrides?: Partial<QrConfigDefaults>): string;
+/** Vide le cache mémoire (utile pour les tests). */
+export declare function clearConfigCache(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAI3C,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAA;AAChD,MAAM,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;AAEzC,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,QAAQ,EAAE,OAAO,CAAA;IACjB,uDAAuD;IACvD,MAAM,EAAE,QAAQ,CAAA;IAChB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,oBAAoB,EAAE,KAAK,CAAA;IAC3B,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,wFAAwF;IACxF,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;IACnC,yDAAyD;IACzD,SAAS,EAAE,QAAQ,EAAE,CAAA;IACrB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,sEAAsE;IACtE,gBAAgB,EAAE,MAAM,CAAA;IACxB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,gBAAgB,CAAA;IACzB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/D;AAID,eAAO,MAAM,cAAc,EAAE,QAmB5B,CAAA;AAyBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,QAAQ,CAgClE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,GAAE,MAAsB,EAC3B,SAAS,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACxC,MAAM,CAoBR;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}