qr-terminal 1.0.0 → 1.1.0

package/index.js

@@ -16,10 +16,26 @@ import { printHeader, log } from './src/ui.js';
 import { runMainFlow } from './src/prompts.js';
 import { detectTerminalBgColor } from './src/luma.js';
 
-// Ensure stdout supports TrueColor
-process.env.FORCE_COLOR = process.env.FORCE_COLOR ?? '3';
+// ── CLI flags ────────────────────────────────────────────────────────────────
+const args    = process.argv.slice(2);
+const isPlain = args.includes('--plain') || args.includes('--no-color');
+
+if (isPlain) {
+  process.env._QR_PLAIN  = '1';
+  process.env.FORCE_COLOR = '0';
+} else {
+  // Ensure stdout supports TrueColor
+  process.env.FORCE_COLOR = process.env.FORCE_COLOR ?? '3';
+}
 
 async function main() {
+  if (isPlain) {
+    // Plain mode: minimal header, no color
+    console.log('QR Terminal — plain/no-color mode\n');
+    await runMainFlow();
+    return;
+  }
+
   // ── Splash ──────────────────────────────────────────────────────────────
   process.stdout.write('\x1Bc'); // Full terminal clear (preserves scroll buffer)
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "qr-terminal",
-  "version": "1.0.0",
-  "description": "Cinematic terminal QR code generator — half-block, braille, particle fly-in, matrix rain, device handshake",
+  "version": "1.1.0",
+  "description": "Cinematic terminal QR code generator — half-block, braille, particle fly-in, matrix rain, device handshake, history, PDF/GIF export, shareable links",
   "type": "module",
   "main": "index.js",
   "bin": {
@@ -15,7 +15,19 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "keywords": ["qr", "qr-code", "terminal", "cli", "tui", "unicode", "half-block", "braille", "gradient", "websocket", "generator"],
+  "keywords": [
+    "qr",
+    "qr-code",
+    "terminal",
+    "cli",
+    "tui",
+    "unicode",
+    "half-block",
+    "braille",
+    "gradient",
+    "websocket",
+    "generator"
+  ],
   "author": "Boweii22",
   "license": "MIT",
   "repository": {
@@ -38,9 +50,11 @@
     "chalk": "^5.3.0",
     "clipboardy": "^4.0.0",
     "figlet": "^1.7.0",
+    "gif-encoder-2": "^1.0.5",
     "gradient-string": "^2.0.2",
     "localtunnel": "^2.0.2",
     "ora": "^8.1.0",
+    "pdfkit": "^0.18.0",
     "qrcode": "^1.5.4",
     "ws": "^8.18.0"
   }

package/src/export-gif.js

@@ -0,0 +1,170 @@
+/**
+ * GIF export — two modes:
+ *   exportStaticGIF   — single-frame colored QR (like PNG but as GIF)
+ *   exportParticleGIF — animated fly-in: modules scatter → assemble
+ *
+ * Uses gif-encoder-2 (CJS) via createRequire.
+ * Renders pixel data directly without a canvas context.
+ */
+
+import { createRequire }                    from 'module';
+import { writeFile }                        from 'fs/promises';
+import { GRADIENT_PRESETS, computeColor }   from './engine.js';
+
+const require = createRequire(import.meta.url);
+
+const MODULE_PX = 8; // pixels per QR module
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+/**
+ * Fill a MODULE_PX × MODULE_PX square into a Uint8ClampedArray RGBA buffer.
+ */
+function drawModule(pixels, width, col, row, r, g, b) {
+  const px = col * MODULE_PX;
+  const py = row * MODULE_PX;
+  for (let dy = 0; dy < MODULE_PX; dy++) {
+    for (let dx = 0; dx < MODULE_PX; dx++) {
+      const idx = ((py + dy) * width + (px + dx)) * 4;
+      if (idx < 0 || idx + 3 >= pixels.length) continue;
+      pixels[idx]     = r;
+      pixels[idx + 1] = g;
+      pixels[idx + 2] = b;
+      pixels[idx + 3] = 255;
+    }
+  }
+}
+
+/**
+ * Build a white RGBA pixel buffer with the QR matrix drawn into it.
+ */
+function buildStaticFrame(modules, preset, quietZone) {
+  const { size, data } = modules;
+  const total  = size + quietZone * 2;
+  const width  = total * MODULE_PX;
+  const height = total * MODULE_PX;
+  const pixels = new Uint8ClampedArray(width * height * 4).fill(255);
+
+  for (let r = 0; r < total; r++) {
+    for (let c = 0; c < total; c++) {
+      const mr    = r - quietZone;
+      const mc    = c - quietZone;
+      const isDark = (mr >= 0 && mr < size && mc >= 0 && mc < size) && data[mr * size + mc];
+      if (!isDark) continue;
+
+      const tx = total > 1 ? c / (total - 1) : 0;
+      const ty = total > 1 ? r / (total - 1) : 0;
+      const [cr, cg, cb] = computeColor(preset, tx, ty);
+      drawModule(pixels, width, c, r, cr, cg, cb);
+    }
+  }
+
+  return { pixels, width, height };
+}
+
+/**
+ * Build particle descriptors at module level (one particle per dark module).
+ */
+function buildModuleParticles(modules, preset, quietZone) {
+  const { size, data } = modules;
+  const total = size + quietZone * 2;
+
+  const particles = [];
+  for (let r = 0; r < total; r++) {
+    for (let c = 0; c < total; c++) {
+      const mr    = r - quietZone;
+      const mc    = c - quietZone;
+      const isDark = (mr >= 0 && mr < size && mc >= 0 && mc < size) && data[mr * size + mc];
+      if (!isDark) continue;
+
+      const tx    = total > 1 ? c / (total - 1) : 0;
+      const ty    = total > 1 ? r / (total - 1) : 0;
+      const color = computeColor(preset, tx, ty);
+      particles.push({ targetRow: r, targetCol: c, color });
+    }
+  }
+  return { particles, total };
+}
+
+// ── Public API ────────────────────────────────────────────────────────────────
+
+/**
+ * Export a single-frame GIF (same visual as PNG, GIF container).
+ */
+export async function exportStaticGIF(modules, filePath, { gradient = 'none' } = {}) {
+  const GIFEncoder = require('gif-encoder-2');
+  const preset     = GRADIENT_PRESETS[gradient] ?? GRADIENT_PRESETS.none;
+  const quietZone  = 4;
+
+  const { pixels, width, height } = buildStaticFrame(modules, preset, quietZone);
+
+  const encoder = new GIFEncoder(width, height);
+  encoder.start();
+  encoder.setRepeat(0);
+  encoder.setDelay(100);
+  encoder.addFrame(pixels);
+  encoder.finish();
+
+  await writeFile(filePath, encoder.out.getData());
+}
+
+/**
+ * Export an animated particle fly-in GIF.
+ *
+ * @param {object} modules      - QR modules from createMatrix()
+ * @param {string} filePath     - Output path (e.g. "qr-anim.gif")
+ * @param {object} opts
+ * @param {string} opts.gradient  - Color theme
+ * @param {number} opts.frames    - Number of animation frames (default 30)
+ * @param {number} opts.delay     - ms per frame (default 50)
+ */
+export async function exportParticleGIF(modules, filePath, {
+  gradient = 'none',
+  frames   = 30,
+  delay    = 50,
+} = {}) {
+  const GIFEncoder = require('gif-encoder-2');
+  const preset     = GRADIENT_PRESETS[gradient] ?? GRADIENT_PRESETS.none;
+  const quietZone  = 4;
+
+  const { particles, total } = buildModuleParticles(modules, preset, quietZone);
+  const width  = total * MODULE_PX;
+  const height = total * MODULE_PX;
+
+  // Randomise start positions and stagger delays
+  const seeded = particles.map(p => ({
+    ...p,
+    startRow: Math.random() * total,
+    startCol: (Math.random() - 0.5) * total * 2 + total / 2,
+    delay:    Math.random() * 0.30,
+  }));
+
+  const encoder = new GIFEncoder(width, height, 'neuquant', false, frames + 1);
+  encoder.start();
+  encoder.setRepeat(0);
+  encoder.setDelay(delay);
+  encoder.setQuality(10);
+
+  for (let f = 0; f <= frames; f++) {
+    const globalT = f / frames;
+    const pixels  = new Uint8ClampedArray(width * height * 4).fill(255);
+
+    for (const p of seeded) {
+      const localT = Math.max(0, (globalT - p.delay) / (1 - p.delay));
+      const e      = 1 - Math.pow(1 - localT, 3); // cubic ease-out
+
+      const row = Math.round(p.startRow + (p.targetRow - p.startRow) * e);
+      const col = Math.round(p.startCol + (p.targetCol - p.startCol) * e);
+
+      if (row < 0 || row >= total || col < 0 || col >= total) continue;
+
+      const [r, g, b] = p.color;
+      drawModule(pixels, width, col, row, r, g, b);
+    }
+
+    encoder.addFrame(pixels);
+  }
+
+  encoder.finish();
+  await writeFile(filePath, encoder.out.getData());
+}

package/src/export-pdf.js

@@ -0,0 +1,80 @@
+/**
+ * PDF export — embed a high-res QR code in an A4 PDF document.
+ * Uses pdfkit (CJS) via createRequire, with qrcode's PNG buffer as the image source.
+ */
+
+import { createRequire } from 'module';
+import { writeFile }     from 'fs/promises';
+import QRCode            from 'qrcode';
+
+const require = createRequire(import.meta.url);
+
+/**
+ * @param {string} text       - Data to encode
+ * @param {string} filePath   - Output path (e.g. "qr-code.pdf")
+ * @param {object} opts
+ * @param {string} opts.errorLevel  - QR error correction level (default 'M')
+ * @param {string} opts.label       - Human-readable label printed below the QR
+ * @param {string} opts.darkColor   - Hex color for dark modules (default '#000000')
+ * @param {string} opts.lightColor  - Hex color for light modules (default '#ffffff')
+ */
+export async function exportPDF(text, filePath, {
+  errorLevel = 'M',
+  label      = '',
+  darkColor  = '#000000',
+  lightColor = '#ffffff',
+} = {}) {
+  const PDFDocument = require('pdfkit');
+
+  // Generate the QR as a PNG buffer
+  const pngBuffer = await QRCode.toBuffer(text, {
+    type:                 'png',
+    width:                600,
+    margin:               4,
+    errorCorrectionLevel: errorLevel,
+    color: { dark: darkColor, light: lightColor },
+  });
+
+  return new Promise((resolve, reject) => {
+    const doc    = new PDFDocument({ size: 'A4', margin: 50 });
+    const chunks = [];
+
+    doc.on('data',  chunk => chunks.push(chunk));
+    doc.on('error', reject);
+    doc.on('end',   async () => {
+      try {
+        await writeFile(filePath, Buffer.concat(chunks));
+        resolve();
+      } catch (e) {
+        reject(e);
+      }
+    });
+
+    const pageW  = doc.page.width;
+    const qrSize = 340;
+    const x      = (pageW - qrSize) / 2;
+    const y      = 80;
+
+    doc.image(pngBuffer, x, y, { width: qrSize });
+
+    if (label) {
+      doc
+        .moveDown()
+        .fontSize(14)
+        .fillColor('#222222')
+        .text(label, 50, y + qrSize + 20, { align: 'center', width: pageW - 100 });
+    }
+
+    doc
+      .fontSize(9)
+      .fillColor('#999999')
+      .text(
+        `Generated by QR Terminal · ${new Date().toLocaleDateString()}`,
+        50,
+        doc.page.height - 60,
+        { align: 'center', width: pageW - 100 },
+      );
+
+    doc.end();
+  });
+}

package/src/history.js

@@ -0,0 +1,65 @@
+/**
+ * History — persist and recall previously generated QR codes.
+ * Stored in ~/.qr-history.json, newest first, max 20 entries.
+ */
+
+import { readFile, writeFile } from 'fs/promises';
+import { homedir } from 'os';
+import { join } from 'path';
+
+const HISTORY_PATH = join(homedir(), '.qr-history.json');
+const MAX_ENTRIES  = 20;
+
+export async function loadHistory() {
+  try {
+    const raw = await readFile(HISTORY_PATH, 'utf8');
+    return JSON.parse(raw);
+  } catch {
+    return { entries: [] };
+  }
+}
+
+/**
+ * Save a generated QR to history.
+ * Secrets are stored without their payload (dataLabel only).
+ */
+export async function saveToHistory({ inputType, dataLabel, qrData, gradient, errorLevel, renderMode }) {
+  const history = await loadHistory();
+
+  const entry = {
+    id:         Date.now().toString(36),
+    timestamp:  new Date().toISOString(),
+    inputType,
+    dataLabel,
+    qrData:     inputType === 'secret' ? null : qrData,
+    gradient,
+    errorLevel,
+    renderMode,
+  };
+
+  history.entries.unshift(entry);
+  if (history.entries.length > MAX_ENTRIES) {
+    history.entries = history.entries.slice(0, MAX_ENTRIES);
+  }
+
+  await writeFile(HISTORY_PATH, JSON.stringify(history, null, 2), 'utf8');
+  return entry;
+}
+
+/**
+ * Format a history entry as an @inquirer/prompts choice object.
+ */
+export function historyChoice(entry, index) {
+  const d       = new Date(entry.timestamp);
+  const dateStr = d.toLocaleDateString() + ' ' + d.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+  const preview = entry.qrData
+    ? (entry.qrData.slice(0, 48) + (entry.qrData.length > 48 ? '…' : ''))
+    : '[secret — payload not stored]';
+
+  return {
+    name:        `  ${String(index + 1).padStart(2)} ·  ${entry.dataLabel.padEnd(22)}${preview}`,
+    value:       entry,
+    description: `${dateStr}  ·  theme: ${entry.gradient}  ·  EC: ${entry.errorLevel}  ·  engine: ${entry.renderMode}`,
+    disabled:    !entry.qrData ? '(secret)' : false,
+  };
+}

package/src/prompts.js

@@ -3,7 +3,7 @@
  * Orchestrates inquirer prompts → live preview → QR generation → export.
  */
 
-import { select, input, confirm, checkbox, password } from '@inquirer/prompts';
+import { select, input, confirm, password } from '@inquirer/prompts';
 import chalk from 'chalk';
 import ora from 'ora';
 import clipboard from 'clipboardy';
@@ -12,6 +12,8 @@ import { createMatrix, renderHalfBlock, renderASCII } from './engine.js';
 import { liveInput } from './live-preview.js';
 import { formatWifi, formatVCard, ERROR_LEVELS, GRADIENT_OPTIONS } from './formatters.js';
 import { exportPNG, exportSVG, exportTXT } from './export.js';
+import { exportPDF } from './export-pdf.js';
+import { exportStaticGIF, exportParticleGIF } from './export-gif.js';
 import { shortenUrl, isValidUrl, estimateSavings } from './shortlink.js';
 import { printQR, revealQR, printDivider, detectDarkMode, log } from './ui.js';
 import { animateParticleFlyIn } from './particle.js';
@@ -19,6 +21,10 @@ import { matrixRainQR } from './matrix-rain.js';
 import { renderBraille } from './braille.js';
 import { startHandshakeServer } from './handshake.js';
 import { createDestructQR, showExplosion } from './destruct.js';
+import { loadHistory, saveToHistory, historyChoice } from './history.js';
+import { buildShareableLink } from './shareable.js';
+
+const isPlain = process.env._QR_PLAIN === '1';
 
 export async function runMainFlow() {
   // ──────────────────────────────────────────────
@@ -47,9 +53,43 @@ export async function runMainFlow() {
         value:       'secret',
         description: 'Tokens, keys, passwords, or any sensitive payload',
       },
+      {
+        name:        '  🕐  View History',
+        value:       'history',
+        description: 'Recall and re-render a previously generated QR code',
+      },
     ],
   });
 
+  // ──────────────────────────────────────────────
+  // HISTORY — recall a past QR
+  // ──────────────────────────────────────────────
+  if (inputType === 'history') {
+    const history = await loadHistory();
+    if (!history.entries.length) {
+      log.info('No history yet — generate a QR first.');
+      return;
+    }
+
+    const entry = await select({
+      message: chalk.bold('Pick a previous QR to re-render:'),
+      choices: history.entries.map((e, i) => historyChoice(e, i)),
+      pageSize: 10,
+    });
+
+    // Re-run with saved settings
+    await renderAndExport({
+      inputType:  entry.inputType,
+      qrData:     entry.qrData,
+      dataLabel:  entry.dataLabel,
+      gradient:   entry.gradient,
+      errorLevel: entry.errorLevel,
+      renderMode: entry.renderMode,
+      fromHistory: true,
+    });
+    return;
+  }
+
   // ──────────────────────────────────────────────
   // STEP 2 — Error correction level
   // ──────────────────────────────────────────────
@@ -66,13 +106,13 @@ export async function runMainFlow() {
   // ──────────────────────────────────────────────
   // STEP 3 — Visual gradient theme
   // ──────────────────────────────────────────────
-  const gradient = await select({
+  const gradient = isPlain ? 'none' : await select({
     message: chalk.bold('Color theme for the QR code?'),
     choices: GRADIENT_OPTIONS,
   });
 
   // ── Render engine selection ─────────────────────────────────────────────
-  const renderMode = await select({
+  const renderMode = isPlain ? 'halfblock' : await select({
     message: chalk.bold('Render engine?'),
     choices: [
       { name: '  ▀▄  Half-Block    — Standard high-density (default)',        value: 'halfblock' },
@@ -93,11 +133,12 @@ export async function runMainFlow() {
 
     // ── URL ─────────────────────────────────────
     case 'url': {
-      console.log(chalk.dim('\n  Live preview active — QR updates as you type\n'));
+      if (!isPlain) console.log(chalk.dim('\n  Live preview active — QR updates as you type\n'));
 
-      let rawUrl = await liveInput({ label: 'URL', errorLevel, gradient });
+      let rawUrl = isPlain
+        ? await input({ message: 'URL:' })
+        : await liveInput({ label: 'URL', errorLevel, gradient });
 
-      // Auto-prepend protocol if missing
       if (rawUrl && !rawUrl.match(/^https?:\/\//i)) {
         rawUrl = 'https://' + rawUrl;
       }
@@ -107,22 +148,17 @@ export async function runMainFlow() {
       qrData    = rawUrl;
       dataLabel = 'URL';
 
-      // Optional URL shortening
-      if (isValidUrl(qrData) && qrData.length > 40) {
+      if (!isPlain && isValidUrl(qrData) && qrData.length > 40) {
         const shouldShorten = await confirm({
           message: `Shorten via TinyURL? ${chalk.dim('(reduces QR complexity)')}`,
           default: false,
         });
 
         if (shouldShorten) {
-          const spinner = ora({
-            text:    'Connecting to TinyURL…',
-            spinner: 'dots',
-          }).start();
-
+          const spinner = ora({ text: 'Connecting to TinyURL…', spinner: 'dots' }).start();
           try {
-            const short = await shortenUrl(qrData);
-            const savings = estimateSavings(qrData.length, short.length);
+            const short    = await shortenUrl(qrData);
+            const savings  = estimateSavings(qrData.length, short.length);
             spinner.succeed(chalk.green('Shortened: ') + chalk.white(short) + chalk.dim(`  (${savings})`));
             qrData = short;
           } catch (e) {
@@ -153,8 +189,8 @@ export async function runMainFlow() {
       let wifiPassword = '';
       if (security !== 'nopass') {
         wifiPassword = await password({
-          message: chalk.cyan('Password:'),
-          mask:    '●',
+          message:  chalk.cyan('Password:'),
+          mask:     '●',
           validate: (v) => v.length > 0 || 'Password cannot be empty',
         });
       }
@@ -173,11 +209,11 @@ export async function runMainFlow() {
     case 'vcard': {
       console.log();
       const firstName = await input({ message: chalk.cyan('First name:') });
-      const lastName  = await input({ message: chalk.cyan('Last name:'),  default: '' });
-      const phone     = await input({ message: chalk.cyan('Phone:'),      default: '' });
-      const email     = await input({ message: chalk.cyan('Email:'),      default: '' });
+      const lastName  = await input({ message: chalk.cyan('Last name:'),    default: '' });
+      const phone     = await input({ message: chalk.cyan('Phone:'),        default: '' });
+      const email     = await input({ message: chalk.cyan('Email:'),        default: '' });
       const org       = await input({ message: chalk.cyan('Organization:'), default: '' });
-      const url       = await input({ message: chalk.cyan('Website:'),    default: '' });
+      const url       = await input({ message: chalk.cyan('Website:'),      default: '' });
 
       if (!firstName && !lastName) { log.error('Name is required.'); return; }
 
@@ -190,8 +226,8 @@ export async function runMainFlow() {
     case 'secret': {
       console.log();
       const secret = await password({
-        message: chalk.cyan('Secret payload:'),
-        mask:    '●',
+        message:  chalk.cyan('Secret payload:'),
+        mask:     '●',
         validate: (v) => v.length > 0 || 'Cannot encode an empty secret',
       });
 
@@ -204,6 +240,20 @@ export async function runMainFlow() {
 
   if (!qrData) return;
 
+  await renderAndExport({ inputType, qrData, dataLabel, gradient, errorLevel, renderMode });
+}
+
+// ── Core render + export pipeline ────────────────────────────────────────────
+
+async function renderAndExport({
+  inputType,
+  qrData,
+  dataLabel,
+  gradient,
+  errorLevel,
+  renderMode,
+  fromHistory = false,
+}) {
   // ──────────────────────────────────────────────
   // STEP 5 — Generate & render the QR code
   // ──────────────────────────────────────────────
@@ -221,9 +271,7 @@ export async function runMainFlow() {
     return;
   }
 
-  // ──────────────────────────────────────────────
-  // STEP 5b — Render with chosen engine
-  // ──────────────────────────────────────────────
+  // ── Render ──────────────────────────────────────────────────────────────
 
   // Special case: handshake mode
   if (renderMode === 'handshake') {
@@ -237,7 +285,6 @@ export async function runMainFlow() {
       return;
     }
 
-    // Generate QR for the server URL
     const linkModules = createMatrix(server.url, { errorLevel: 'M' });
     const linkLines   = renderHalfBlock(linkModules, { gradient: 'neon' });
 
@@ -258,12 +305,10 @@ export async function runMainFlow() {
     console.log(chalk.cyan('\n  Phone is now linked. Messages will appear below.\n'));
     console.log(chalk.dim('  Press Ctrl+C to close the connection.\n'));
 
-    // Stream phone messages to terminal
     server.onMessage((text) => {
       console.log(chalk.bold.cyanBright('\n  📱 From phone: ') + chalk.white(text) + '\n');
     });
 
-    // Keep alive until Ctrl+C
     await new Promise((_, reject) => {
       process.on('SIGINT', () => {
         server.close();
@@ -274,6 +319,14 @@ export async function runMainFlow() {
     return;
   }
 
+  // ── Plain mode — print raw ASCII, no color ──────────────────────────────
+  if (isPlain) {
+    console.log();
+    console.log(renderASCII(modules));
+    console.log();
+    return;
+  }
+
   const qrLines = renderMode === 'braille'
     ? renderBraille(modules, { gradient })
     : renderHalfBlock(modules, { gradient });
@@ -312,40 +365,49 @@ export async function runMainFlow() {
   console.log();
 
   // ──────────────────────────────────────────────
-  // STEP 6 — Post-generation actions
+  // STEP 6 — Save to history
+  // ──────────────────────────────────────────────
+  if (!fromHistory) {
+    try {
+      await saveToHistory({ inputType, dataLabel, qrData, gradient, errorLevel, renderMode });
+    } catch {
+      // history is non-critical — fail silently
+    }
+  }
+
+  // ──────────────────────────────────────────────
+  // STEP 7 — Post-generation actions (looped select)
   // ──────────────────────────────────────────────
   printDivider('Export');
 
-  const actions = await checkbox({
-    message: chalk.bold('What would you like to do with this QR code?'),
-    choices: [
-      {
-        name:    '  📋  Copy ASCII to clipboard  (paste into Slack, README, terminal)',
-        value:   'clipboard',
-        checked: true,
-      },
-      {
-        name:  '  🖼   Save as PNG  (high-res image)',
-        value: 'png',
-      },
-      {
-        name:  '  📐  Save as SVG  (scalable vector)',
-        value: 'svg',
-      },
-      {
-        name:  '  📄  Save as TXT  (plain Unicode half-blocks)',
-        value: 'txt',
-      },
-      {
-        name:  '  ☠   Self-destruct share  (host file via public QR, auto-destroy on download)',
-        value: 'destruct',
-      },
-    ],
-  });
+  const exportChoices = [
+    { name: '  📋  Copy ASCII to clipboard', value: 'clipboard' },
+    { name: '  🖼   Save as PNG',             value: 'png'       },
+    { name: '  📐  Save as SVG',             value: 'svg'       },
+    { name: '  📄  Save as PDF',             value: 'pdf'       },
+    { name: '  🎞   Save as GIF',            value: 'gif'       },
+    { name: '  📝  Save as TXT',             value: 'txt'       },
+    ...(inputType !== 'secret'
+      ? [{ name: '  🔗  Get shareable link', value: 'share' }]
+      : []),
+    { name: '  ☠   Self-destruct share',    value: 'destruct'  },
+    { name: '  ✓   Done',                   value: 'done'      },
+  ];
 
-  console.log();
+  // Reset terminal state after animations before prompting
+  process.stdout.write('\x1b[?25h\x1b[0m');
+
+  // eslint-disable-next-line no-constant-condition
+  while (true) {
+    const action = await select({
+      message: chalk.bold('What would you like to do?  (pick one, repeat as needed)'),
+      choices: exportChoices,
+    });
+
+    if (action === 'done') break;
+
+    console.log();
 
-  for (const action of actions) {
     switch (action) {
 
       case 'clipboard': {
@@ -390,6 +452,44 @@ export async function runMainFlow() {
         break;
       }
 
+      case 'pdf': {
+        const fileName = await input({
+          message: 'PDF filename:',
+          default: sanitizeFilename(dataLabel) + '.pdf',
+        });
+        const sp = ora({ text: 'Rendering PDF…', spinner: 'arc' }).start();
+        try {
+          await exportPDF(qrData, fileName, { errorLevel, label: dataLabel });
+          sp.succeed(`PDF saved → ${chalk.underline(fileName)}`);
+        } catch (e) {
+          sp.fail('PDF export failed: ' + e.message);
+        }
+        break;
+      }
+
+      case 'gif': {
+        const animated = renderMode === 'particle' || renderMode === 'matrix';
+        const fileName = await input({
+          message: 'GIF filename:',
+          default: sanitizeFilename(dataLabel) + (animated ? '-anim' : '') + '.gif',
+        });
+        const sp = ora({
+          text:    animated ? 'Rendering animated GIF…' : 'Rendering GIF…',
+          spinner: 'arc',
+        }).start();
+        try {
+          if (animated) {
+            await exportParticleGIF(modules, fileName, { gradient, frames: 30, delay: 50 });
+          } else {
+            await exportStaticGIF(modules, fileName, { gradient });
+          }
+          sp.succeed(`GIF saved → ${chalk.underline(fileName)}${animated ? chalk.dim('  (animated)') : ''}`);
+        } catch (e) {
+          sp.fail('GIF export failed: ' + e.message);
+        }
+        break;
+      }
+
       case 'txt': {
         const fileName = await input({
           message: 'TXT filename:',
@@ -405,6 +505,27 @@ export async function runMainFlow() {
         break;
       }
 
+      case 'share': {
+        const link = buildShareableLink(qrData, { errorLevel });
+        console.log(
+          chalk.bold.cyanBright('  🔗 Shareable link:\n') +
+          '     ' + chalk.underline.white(link) + '\n'
+        );
+        const copyLink = await confirm({
+          message: 'Copy link to clipboard?',
+          default: true,
+        });
+        if (copyLink) {
+          try {
+            await clipboard.write(link);
+            log.success('Link copied to clipboard.');
+          } catch {
+            log.warn('Could not write to clipboard.');
+          }
+        }
+        break;
+      }
+
       case 'destruct': {
         const filePath = await input({ message: 'File to share (path):' });
         const sp = ora({ text: 'Creating tunnel…', spinner: 'arc' }).start();
@@ -429,9 +550,10 @@ export async function runMainFlow() {
         break;
       }
     }
+
+    console.log();
   }
 
-  console.log();
   printDivider();
   log.tip('Hold your phone camera over the QR code — no scanner app needed on iOS 11+ / Android 10+.');
   log.info(`Encoded ${qrData.length} characters with ${errorLevel}-level error correction.`);

package/src/shareable.js

@@ -0,0 +1,17 @@
+/**
+ * Shareable link — build a browser-openable URL that renders the QR in an image.
+ * Uses QuickChart.io's free public QR API (no auth required, rate-limited generously).
+ *
+ * Opening the link in any browser shows a 400×400 QR code PNG inline.
+ */
+
+export function buildShareableLink(qrData, { errorLevel = 'M', size = 400 } = {}) {
+  const params = new URLSearchParams({
+    text:    qrData,
+    size:    size.toString(),
+    margin:  '4',
+    ecLevel: errorLevel,
+    format:  'png',
+  });
+  return `https://quickchart.io/qr?${params.toString()}`;
+}

package/src/ui.js

@@ -22,7 +22,7 @@ export function printHeader() {
   }
 
   const coloredArt  = gradient(['#FF416C', '#FF4B2B', '#F7971E', '#FFD200', '#4ECDC4', '#556270'])(art);
-  const subtitle    = chalk.dim('  High-Density Half-Block Rendering Engine  ·  v1.0.0');
+  const subtitle    = chalk.dim('  High-Density Half-Block Rendering Engine  ·  v1.1.0');
   const badges      = [
     chalk.bgRgb(40,40,80).rgb(100,180,255)(' URL '),
     chalk.bgRgb(40,40,80).rgb(100,255,160)(' WiFi '),