@mostajs/qrpanel 0.2.0 → 0.3.1

package/dist/config.js

@@ -0,0 +1,113 @@
+// @mostajs/qrpanel/config — runtime config layer
+// Author: Dr Hamid MADANI <drmdh@msn.com>
+//
+// Cascade :
+//   1. defaults compilés (ce fichier)
+//   2. .qrconfig.json (ou .qrconfig.js / .qrconfig) à process.cwd()
+//   3. options passées explicitement à l'appel generateQr* (highest)
+//
+// Cache : la lecture du fichier est cachée en mémoire avec invalidation
+// par mtime — édite le fichier, le prochain appel le relit. Pas de
+// watcher (overkill pour ce cas d'usage).
+import { readFileSync, existsSync, statSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+// ─── Defaults ──────────────────────────────────────────────────────
+export const DEFAULT_CONFIG = {
+    default: {
+        genimage: true,
+        format: 'svg',
+        width: 600,
+        margin: 2,
+        errorCorrectionLevel: 'H',
+        darkColor: '#0f172a',
+        lightColor: '#ffffff',
+        theme: 'random',
+        themePool: [
+            'baby', 'animals', 'science', 'physics', 'chemistry', 'math',
+            'nature', 'tech', 'space', 'music', 'book', 'health',
+        ],
+        framePadding: 0.5,
+        centerWhiteRatio: 0.62,
+        themeOpacity: 1.0,
+        themeColor: '#1e293b',
+    },
+};
+// ─── Lookup file paths ─────────────────────────────────────────────
+const CONFIG_FILES = ['.qrconfig.json', '.qrconfig.js', '.qrconfig'];
+/** Cherche le fichier config existant à `cwd`, retourne le path absolu ou null. */
+function findConfigFile(cwd) {
+    for (const name of CONFIG_FILES) {
+        const p = join(cwd, name);
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+const _cache = new Map();
+// ─── Readers ───────────────────────────────────────────────────────
+/**
+ * Lit la config depuis `cwd` (default `process.cwd()`).
+ * Retourne `DEFAULT_CONFIG` si aucun fichier trouvé.
+ * Cache invalidé par mtime du fichier.
+ */
+export function loadQrConfig(cwd = process.cwd()) {
+    const path = findConfigFile(cwd);
+    if (!path)
+        return DEFAULT_CONFIG;
+    const stat = statSync(path);
+    const cached = _cache.get(path);
+    if (cached && cached.mtimeMs === stat.mtimeMs) {
+        return cached.config;
+    }
+    let parsed;
+    try {
+        if (path.endsWith('.js')) {
+            // require() interop pour .js — sync, pas d'import dynamique
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const mod = (require)(path);
+            parsed = (mod.default ?? mod);
+        }
+        else {
+            const raw = readFileSync(path, 'utf-8');
+            parsed = JSON.parse(raw);
+        }
+    }
+    catch (e) {
+        throw new Error(`[qrpanel] failed to parse ${path}: ${e.message}`);
+    }
+    const merged = {
+        default: { ...DEFAULT_CONFIG.default, ...(parsed.default ?? {}) },
+        customThemes: parsed.customThemes,
+    };
+    _cache.set(path, { mtimeMs: stat.mtimeMs, config: merged });
+    return merged;
+}
+/**
+ * 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 function ensureQrConfig(cwd = process.cwd(), overrides = {}) {
+    const existing = findConfigFile(cwd);
+    if (existing)
+        return existing;
+    const path = join(resolve(cwd), '.qrconfig.json');
+    const config = {
+        default: { ...DEFAULT_CONFIG.default, ...overrides },
+    };
+    const header = '// @mostajs/qrpanel — édite ce fichier pour piloter la génération QR.\n'
+        + '// Le master toggle "genimage": false bypass tout le pipeline thématique.\n'
+        + '// "theme": "random" tire dans themePool ; figer un thème = "theme": "science" par exemple.\n';
+    const body = JSON.stringify(config, null, 2) + '\n';
+    // JSON pur (pas de commentaire dans .qrconfig.json) — header en commentaire
+    // de fichier .json est invalide, on l'ignore. On garde juste le JSON.
+    void header;
+    writeFileSync(path, body, { mode: 0o644 });
+    return path;
+}
+/** Vide le cache mémoire (utile pour les tests). */
+export function clearConfigCache() {
+    _cache.clear();
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export * from './server.js';
 export * from './client.js';
+export { type ThemeKey, type ThemeAsset, THEME_KEYS, listThemes, getTheme, } from './themes.js';
+export { type QrConfig, type QrConfigDefaults, type QrFormat, type QrEcc, DEFAULT_CONFIG, loadQrConfig, ensureQrConfig, clearConfigCache, } from './config.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,OAAO,EACL,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,GACjE,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAC/D,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,GAC/D,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -6,4 +6,6 @@
 // éviter d'inclure React côté serveur ou qrcode côté client.
 export * from './server.js';
 export * from './client.js';
+export { THEME_KEYS, listThemes, getTheme, } from './themes.js';
+export { DEFAULT_CONFIG, loadQrConfig, ensureQrConfig, clearConfigCache, } from './config.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"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;AAC3B,OAAO,EAC2B,UAAU,EAAE,UAAU,EAAE,QAAQ,GACjE,MAAM,aAAa,CAAA;AACpB,OAAO,EAEL,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,GAC/D,MAAM,aAAa,CAAA"}

package/dist/server.d.ts

@@ -1,28 +1,50 @@
+import type { ThemeKey } from './themes.js';
 export interface QrOptions {
-    /** Largeur/hauteur de l'image en pixels. Default 600. */
+    /** Largeur/hauteur de l'image en pixels. Default 600 (ou config). */
     width?: number;
-    /** Marge blanche autour du QR (en modules). Default 2. */
+    /** Marge blanche autour du QR (en modules). Default 2 (ou config). */
     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)
+     * Niveau de correction d'erreur :
+     *   L = 7 % | M = 15 % | Q = 25 % | H = 30 % (recommandé pour overlay)
      */
     errorCorrectionLevel?: 'L' | 'M' | 'Q' | 'H';
-    /** Couleur des modules sombres. Default '#0f172a' (slate-900). */
+    /** Couleur des modules sombres. Default '#0f172a'. */
     darkColor?: string;
     /** Couleur du fond. Default '#ffffff'. */
     lightColor?: string;
+    /**
+     * Master toggle. `false` court-circuite tout le pipeline thématique
+     * et retombe sur le QR pur (comportement v0.2.x). Override de la
+     * valeur config.
+     */
+    genimage?: boolean;
+    /**
+     * Thème à appliquer en cadre (4 motifs aux coins). Pris dans le
+     * registry natif (12 thèmes). 'random' tire dans `themePool`.
+     * 'none' désactive le composite ponctuellement.
+     * Objet `{ svg }` → motif custom inline.
+     */
+    theme?: ThemeKey | 'random' | 'none' | {
+        svg: string;
+        label?: string;
+    };
+    /** Sous-set des thèmes pour le tirage 'random'. Default = tous. */
+    themePool?: ThemeKey[];
+    /** Marge cadre image / canvas (proportion). Default 0.13. */
+    framePadding?: number;
+    /** Taille du cartouche blanc central (proportion 0..1). Default 0.62. */
+    centerWhiteRatio?: number;
+    /** Opacité du cadre image (0..1). Default 1. */
+    themeOpacity?: number;
+    /** Couleur monochrome du cadre image. Default '#1e293b'. */
+    themeColor?: 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é. */
+/** Génère un Data URL `data:image/png;base64,...` */
 export declare function generateQrDataUrl(text: string, opts?: QrOptions): Promise<string>;
 export interface BuildInviteUrlsOptions {
     /** Base absolue (https://app.example.com), sans slash final. */
@@ -35,7 +57,7 @@ export interface BuildInviteUrlsOptions {
     inviteId: string;
     /** TTL en ms (default 60 jours). */
     ttlMs?: number;
-    /** Path du callback invite (default '/invite'). Le token est appended : `${baseUrl}${invitePath}/${token}`. */
+    /** Path du callback invite (default '/invite'). */
     invitePath?: string;
     /** Meta libre encodée dans le token. */
     inviteMeta?: Record<string, string | number | boolean>;
@@ -51,15 +73,8 @@ export interface InviteUrls {
 /**
  * Helper combiné — signe un invite-token et construit la paire d'URLs
  * (direct + invite) prête à passer à `<QrPanel>` côté client.
- *
- * @example
- *   const { directUrl, inviteUrl } = buildInviteUrls({
- *     baseUrl: 'https://app.example.com',
- *     directPath: `/${project.slug}`,
- *     inviteSecret: process.env.INVITE_SECRET!,
- *     inviteId: project.id,
- *     inviteMeta: { kind: 'cohort-invite' },
- *   })
  */
 export declare function buildInviteUrls(opts: BuildInviteUrlsOptions): InviteUrls;
+export { listThemes, THEME_KEYS, THEMES, getTheme, type ThemeKey, type ThemeAsset } from './themes.js';
+export { loadQrConfig, ensureQrConfig, DEFAULT_CONFIG, type QrConfig } from './config.js';
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAWA,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;AAID,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,GAAG,MAAM,CAAA;IAC7B,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAA;IAChB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+GAA+G;IAC/G,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,UAAU;IACzB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,UAAU,CAUxE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAI3C,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,oBAAoB,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IAC5C,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAA;IAGnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACtE,mEAAmE;IACnE,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IACtB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAuCD,2DAA2D;AAC3D,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,SAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBvF;AAED,2DAA2D;AAC3D,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,SAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBvF;AAED,qDAAqD;AACrD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,SAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAe3F;AAID,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,GAAG,MAAM,CAAA;IAC7B,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAA;IAChB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,UAAU;IACzB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,UAAU,CAUxE;AAID,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AACtG,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA"}

package/dist/server.js

@@ -1,62 +1,117 @@
 // @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.
-// + helpers haut-niveau combinant invite-token (@mostajs/auth) pour
-// builder la paire (directUrl, inviteUrl) en une ligne.
+// Wrap minimaliste de la lib `qrcode` (npm) + extension thématique
+// pilotée par .qrconfig.json (chargée à process.cwd() au runtime, cache
+// invalidé par mtime).
+//
+// Cross-OS natif (Linux, macOS, Windows) — qrcode est pure-JS, et la
+// rasterization PNG composite passe par @resvg/resvg-js (rust prebuilt
+// binaries cross-OS, pas de chromium ni puppeteer).
+//
+// API legacy 100% rétro-compatible :
+//   - generateQrPng/Svg/DataUrl(text, opts) marchent comme en 0.2.x
+//     si .qrconfig.json est absent ET opts.genimage non-précisé.
+//   - Le master toggle genimage=false (config ou opts) court-circuite
+//     toute la chaîne thématique.
 import QRCode from 'qrcode';
 import { signInviteToken } from '@mostajs/auth/lib/invite-token';
+import { loadQrConfig, } from './config.js';
+import { composeThemedSvg, composeThemedPng, composeThemedDataUrl, mergeComposeOpts, } from './composer.js';
+// ─── Internal helpers ──────────────────────────────────────────────
+/**
+ * Décide si on bascule sur le pipeline composite ou le legacy.
+ * Order : opts.genimage > config.default.genimage. theme='none' force legacy.
+ */
+function shouldComposite(opts, cfg) {
+    if (opts.genimage === false)
+        return false;
+    if (opts.genimage === true) {
+        // explicit on : ne respecte pas theme=none ? Si l'app dit explicitement
+        // genimage=true mais theme=none, on respecte theme=none (QR pur ponctuel).
+        const theme = opts.theme ?? cfg.theme;
+        return theme !== 'none';
+    }
+    // Pas d'override opts → suit la config
+    if (cfg.genimage === false)
+        return false;
+    const theme = opts.theme ?? cfg.theme;
+    return theme !== 'none';
+}
+function composeOptsFromQrOptions(opts, cfg) {
+    return mergeComposeOpts(cfg, {
+        width: opts.width,
+        errorCorrectionLevel: opts.errorCorrectionLevel,
+        darkColor: opts.darkColor,
+        lightColor: opts.lightColor,
+        theme: opts.theme,
+        themePool: opts.themePool,
+        framePadding: opts.framePadding,
+        centerWhiteRatio: opts.centerWhiteRatio,
+        themeOpacity: opts.themeOpacity,
+        themeColor: opts.themeColor,
+    });
+}
+// ─── Public API : 3 generators ─────────────────────────────────────
 /** Génère un PNG (Buffer) d'un QR code encodant `text`. */
-export function generateQrPng(text, opts = {}) {
+export async function generateQrPng(text, opts = {}) {
+    const cfg = loadQrConfig().default;
+    if (shouldComposite(opts, cfg)) {
+        const composed = await composeThemedPng(text, composeOptsFromQrOptions(opts, cfg));
+        if (composed)
+            return composed;
+    }
+    // Legacy QR pur (qrcode lib direct)
     return QRCode.toBuffer(text, {
-        width: opts.width ?? 600,
+        width: opts.width ?? cfg.width,
         margin: opts.margin ?? 2,
-        errorCorrectionLevel: opts.errorCorrectionLevel ?? 'M',
+        errorCorrectionLevel: opts.errorCorrectionLevel ?? cfg.errorCorrectionLevel,
         color: {
-            dark: opts.darkColor ?? '#0f172a',
-            light: opts.lightColor ?? '#ffffff',
+            dark: opts.darkColor ?? cfg.darkColor,
+            light: opts.lightColor ?? cfg.lightColor,
         },
     });
 }
 /** Génère un SVG (string) d'un QR code encodant `text`. */
-export function generateQrSvg(text, opts = {}) {
+export async function generateQrSvg(text, opts = {}) {
+    const cfg = loadQrConfig().default;
+    if (shouldComposite(opts, cfg)) {
+        const composed = await composeThemedSvg(text, composeOptsFromQrOptions(opts, cfg));
+        if (composed)
+            return composed;
+    }
     return QRCode.toString(text, {
         type: 'svg',
-        width: opts.width ?? 600,
+        width: opts.width ?? cfg.width,
         margin: opts.margin ?? 2,
-        errorCorrectionLevel: opts.errorCorrectionLevel ?? 'M',
+        errorCorrectionLevel: opts.errorCorrectionLevel ?? cfg.errorCorrectionLevel,
         color: {
-            dark: opts.darkColor ?? '#0f172a',
-            light: opts.lightColor ?? '#ffffff',
+            dark: opts.darkColor ?? cfg.darkColor,
+            light: opts.lightColor ?? cfg.lightColor,
         },
     });
 }
-/** 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 = {}) {
+/** Génère un Data URL `data:image/png;base64,...` */
+export async function generateQrDataUrl(text, opts = {}) {
+    const cfg = loadQrConfig().default;
+    if (shouldComposite(opts, cfg)) {
+        const composed = await composeThemedDataUrl(text, composeOptsFromQrOptions(opts, cfg));
+        if (composed)
+            return composed;
+    }
     return QRCode.toDataURL(text, {
-        width: opts.width ?? 600,
+        width: opts.width ?? cfg.width,
         margin: opts.margin ?? 2,
-        errorCorrectionLevel: opts.errorCorrectionLevel ?? 'M',
+        errorCorrectionLevel: opts.errorCorrectionLevel ?? cfg.errorCorrectionLevel,
         color: {
-            dark: opts.darkColor ?? '#0f172a',
-            light: opts.lightColor ?? '#ffffff',
+            dark: opts.darkColor ?? cfg.darkColor,
+            light: opts.lightColor ?? cfg.lightColor,
         },
     });
 }
 /**
  * Helper combiné — signe un invite-token et construit la paire d'URLs
  * (direct + invite) prête à passer à `<QrPanel>` côté client.
- *
- * @example
- *   const { directUrl, inviteUrl } = buildInviteUrls({
- *     baseUrl: 'https://app.example.com',
- *     directPath: `/${project.slug}`,
- *     inviteSecret: process.env.INVITE_SECRET!,
- *     inviteId: project.id,
- *     inviteMeta: { kind: 'cohort-invite' },
- *   })
  */
 export function buildInviteUrls(opts) {
     const base = String(opts.baseUrl).replace(/\/+$/, '');
@@ -69,4 +124,7 @@ export function buildInviteUrls(opts) {
         inviteToken,
     };
 }
+// ─── Re-exports utiles côté serveur ────────────────────────────────
+export { listThemes, THEME_KEYS, THEMES, getTheme } from './themes.js';
+export { loadQrConfig, ensureQrConfig, DEFAULT_CONFIG } from './config.js';
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,0CAA0C;AAC1C,EAAE;AACF,oEAAoE;AACpE,sDAAsD;AACtD,oEAAoE;AACpE,wDAAwD;AAExD,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAsBhE,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;AA8BD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,IAA4B;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,UAAU,CAAA;IACxF,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACrE,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;IAClG,OAAO;QACL,SAAS,EAAE,IAAI,GAAG,MAAM;QACxB,SAAS,EAAE,GAAG,IAAI,GAAG,UAAU,IAAI,WAAW,EAAE;QAChD,WAAW;KACZ,CAAA;AACH,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/themes.d.ts

@@ -0,0 +1,55 @@
+export type ThemeKey = 'baby' | 'animals' | 'science' | 'physics' | 'chemistry' | 'math' | 'nature' | 'tech' | 'space' | 'music' | 'book' | 'health';
+export interface ThemeAsset {
+    key: ThemeKey;
+    label: string;
+    /** Fragment SVG (sans <svg> wrapper) — un motif centré sur (0,0). */
+    motif: string;
+}
+export declare const THEMES: Record<ThemeKey, ThemeAsset>;
+/** Liste des clés thèmes natifs (ordre fixe pour itération déterministe). */
+export declare const THEME_KEYS: ThemeKey[];
+/** Renvoie la liste des clés thèmes natifs. */
+export declare function listThemes(): ThemeKey[];
+/** Récupère un thème par clé. Lance si inconnu. */
+export declare function getTheme(key: ThemeKey): ThemeAsset;
+/**
+ * Tire un thème au hasard dans le pool fourni (ou tous les thèmes si pool absent).
+ * Utilise Math.random() — pas de seed (déterminisme = à la charge du caller s'il
+ * en a besoin).
+ */
+export declare function pickRandomTheme(pool?: ThemeKey[]): ThemeKey;
+/**
+ * Construit le fragment SVG du cadre thématique :
+ *   4 instances du motif aux 4 coins, monochrome via CSS color, opacité.
+ *
+ * Le fragment est destiné à être inséré dans un SVG composite global
+ * (viewBox 0 0 width width). Coordonnées dans l'espace [0..width].
+ */
+export interface BuildFrameOpts {
+    /** Largeur du canvas SVG englobant en unités utilisateur. */
+    width: number;
+    /** Couleur monochrome appliquée via CSS. Default '#1e293b'. */
+    color?: string;
+    /** Opacité 0..1. Default 1. */
+    opacity?: number;
+    /**
+     * Proportion du cartouche blanc central / canvas (0..1). Détermine la
+     * largeur de la zone-marge où sont placés les motifs.
+     * Default 0.62.
+     */
+    centerWhiteRatio?: number;
+    /**
+     * Position du motif dans la zone-marge (0..1) :
+     *   0   = motif collé au bord du canvas
+     *   0.5 = motif centré dans la zone-marge (default, optimal)
+     *   1   = motif collé contre le cartouche blanc
+     */
+    framePadding?: number;
+    /**
+     * Échelle du motif (override de l'auto-calc).
+     * Auto = (marginZone × 0.65 / 14) où 14 ≈ envergure locale du motif.
+     */
+    motifScale?: number;
+}
+export declare function buildThemeFrameSvg(theme: ThemeAsset, opts: BuildFrameOpts): string;
+//# sourceMappingURL=themes.d.ts.map

package/dist/themes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../src/themes.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,SAAS,GACT,SAAS,GACT,SAAS,GACT,WAAW,GACX,MAAM,GACN,QAAQ,GACR,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM,GACN,QAAQ,CAAA;AAEZ,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,QAAQ,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAA;CACd;AAMD,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,CA4I/C,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,UAAU,EAAE,QAAQ,EAGhC,CAAA;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,IAAI,QAAQ,EAAE,CAEvC;AAED,mDAAmD;AACnD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,UAAU,CAIlD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAG3D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAKD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAsBlF"}