@qrdx/cli 0.0.1

package/README.md

@@ -0,0 +1,94 @@
+# qrdx-cli
+
+QR code generator CLI for developers. Generate styled, scannable QR codes as SVG or PNG — fully non-interactive, CI-friendly.
+
+## Install
+
+```bash
+# Install the qrdx library package (includes the CLI binary)
+npm install -g qrdx
+
+# Or install the standalone CLI package
+npm install -g qrdx-cli
+```
+
+Or run without installing:
+
+```bash
+npx qrdx generate "https://example.com" -o qr.svg
+```
+
+## Usage
+
+```bash
+qrdx generate <data> [options]
+```
+
+**Options**
+
+| Flag | Short | Default | Description |
+|------|-------|---------|-------------|
+| `--output` | `-o` | — | Output path — extension sets format (`.svg` or `.png`) |
+| `--size` | | `512` | Output pixel size |
+| `--level` | `-l` | `Q` | Error correction: `L` `M` `Q` `H` |
+| `--body` | | `square` | Body dot pattern |
+| `--eye` | | `square` | Corner eye pattern |
+| `--dot` | | `square` | Corner dot pattern |
+| `--fg` | | `#000000` | Foreground color |
+| `--bg` | | `#ffffff` | Background color |
+| `--eye-color` | | — | Corner eye color override |
+| `--dot-color` | | — | Corner dot color override |
+| `--logo` | | — | Center logo URL |
+| `--margin` | | `0` | Quiet zone margin (modules) |
+
+## Examples
+
+```bash
+# Basic SVG
+qrdx generate "https://qrdx.dev" -o qr.svg
+
+# High-res PNG for print
+qrdx generate "https://qrdx.dev" -o qr.png --size 2048 --level H
+
+# Branded style
+qrdx generate "https://qrdx.dev" \
+  --body circle --eye rounded \
+  --fg "#1a1a2e" --bg "#f5f5f5" \
+  -o branded.svg
+
+# With center logo
+qrdx generate "https://qrdx.dev" \
+  --logo "https://qrdx.dev/logo.png" --level H \
+  -o logo-qr.svg
+
+# Wi-Fi QR
+qrdx generate "WIFI:T:WPA;S:MyNetwork;P:MyPassword;;" -o wifi.svg
+
+# Interactive mode (TTY)
+qrdx generate
+```
+
+## Patterns
+
+**Body** (`--body`): `square` `circle` `circle-large` `diamond` `circle-mixed` `pacman` `rounded` `small-square` `vertical-line`
+
+**Eye** (`--eye`): `square` `rounded` `gear` `circle` `diya` `cushion` `boxy` `pointed`
+
+**Dot** (`--dot`): `square` `rounded` `circle` `heart` `diamond` `star`
+
+## Interactive mode
+
+When run in a TTY without flags, `qrdx generate` starts a guided prompt flow — output path, then optionally advanced customizations (patterns, colors, logo).
+
+## Requirements
+
+Node.js ≥ 18
+
+## Links
+
+- [qrdx.dev](https://qrdx.dev) — web app
+- [github.com/qrdx/qrdx](https://github.com/qrdx/qrdx) — source
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,564 @@
+#!/usr/bin/env node
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+var p = require('@clack/prompts');
+var qrdx = require('qrdx');
+var react = require('react');
+var server = require('react-dom/server');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var p__namespace = /*#__PURE__*/_interopNamespace(p);
+
+function buildSVGString(props) {
+  const element = react.createElement(qrdx.QRCodeSVG, {
+    size: props.size ?? 512,
+    ...props
+  });
+  return server.renderToStaticMarkup(element);
+}
+async function saveOutput(options) {
+  const { outputPath, format, ...qrProps } = options;
+  const svgString = buildSVGString(qrProps);
+  if (format === "svg") {
+    const svgContent = `<?xml version="1.0" encoding="UTF-8"?>
+${svgString}`;
+    fs.writeFileSync(outputPath, svgContent, "utf-8");
+    return;
+  }
+  const sharp = (await import('sharp')).default;
+  const svgBuffer = Buffer.from(svgString, "utf-8");
+  const size = qrProps.size ?? 512;
+  await sharp(svgBuffer).resize(size, size).png().toFile(outputPath);
+}
+
+// src/commands/generate.ts
+var RESET = "\x1B[0m";
+var TEXT = "\x1B[38;5;145m";
+var GREEN = "\x1B[38;5;114m";
+var DIM = "\x1B[38;5;102m";
+var IS_TTY = Boolean(process.stdin.isTTY);
+function parseFlags(args) {
+  const flags = {};
+  let i = 0;
+  while (i < args.length) {
+    const arg = args[i];
+    if (!arg.startsWith("-")) {
+      if (!flags.value) {
+        flags.value = arg;
+      }
+      i++;
+      continue;
+    }
+    const next = args[i + 1];
+    switch (arg) {
+      case "-o":
+      case "--output":
+        flags.output = next;
+        i += 2;
+        break;
+      case "-l":
+      case "--level":
+        flags.level = next;
+        i += 2;
+        break;
+      case "--body":
+        flags.body = next;
+        i += 2;
+        break;
+      case "--eye":
+        flags.eye = next;
+        i += 2;
+        break;
+      case "--dot":
+        flags.dot = next;
+        i += 2;
+        break;
+      case "--fg":
+        flags.fg = next;
+        i += 2;
+        break;
+      case "--bg":
+        flags.bg = next;
+        i += 2;
+        break;
+      case "--eye-color":
+        flags.eyeColor = next;
+        i += 2;
+        break;
+      case "--dot-color":
+        flags.dotColor = next;
+        i += 2;
+        break;
+      case "--logo":
+        flags.logo = next;
+        i += 2;
+        break;
+      case "--margin":
+        flags.margin = next ? Number.parseInt(next, 10) : 0;
+        i += 2;
+        break;
+      case "--size":
+        flags.size = next ? Number.parseInt(next, 10) : 512;
+        i += 2;
+        break;
+      case "--no-logo":
+        flags.noLogo = true;
+        i++;
+        break;
+      default:
+        i++;
+    }
+  }
+  return flags;
+}
+function isCancel2(value) {
+  return p__namespace.isCancel(value);
+}
+function handleCancel() {
+  p__namespace.cancel("Cancelled.");
+  process.exit(0);
+}
+function inferFormat(outputPath) {
+  const ext = path.extname(outputPath).toLowerCase();
+  if (ext === ".png") {
+    return "png";
+  }
+  return "svg";
+}
+async function runGenerate(args) {
+  const flags = parseFlags(args);
+  const nonInteractive = !IS_TTY;
+  const hasAdvancedFlags = Boolean(
+    flags.body || flags.eye || flags.dot || flags.fg || flags.bg || flags.eyeColor || flags.dotColor || flags.logo || flags.level || flags.margin !== void 0
+  );
+  p__namespace.intro(`${TEXT}qrdx${RESET} ${DIM}\u2014 QR Code Generator${RESET}`);
+  let value = flags.value;
+  if (!value) {
+    if (nonInteractive) {
+      p__namespace.log.error("No data provided. Pass a URL or text as an argument.");
+      process.exit(1);
+    }
+    const res = await p__namespace.text({
+      message: "URL or text to encode",
+      placeholder: "https://qrdx.dev",
+      validate(v) {
+        if (!v.trim()) {
+          return "Please enter a value to encode.";
+        }
+      }
+    });
+    if (isCancel2(res)) {
+      handleCancel();
+    }
+    value = res;
+  }
+  let outputPath = flags.output;
+  const size = flags.size ?? 512;
+  if (!(outputPath || nonInteractive)) {
+    const pathRes = await p__namespace.text({
+      message: "Output file (.svg or .png)",
+      placeholder: "qr.svg",
+      defaultValue: "qr.svg",
+      validate(v) {
+        if (!v.trim()) {
+          return "Please enter an output path.";
+        }
+      }
+    });
+    if (isCancel2(pathRes)) {
+      handleCancel();
+    }
+    outputPath = pathRes || "qr.svg";
+  }
+  let wantAdvanced = hasAdvancedFlags;
+  if (!(hasAdvancedFlags || nonInteractive)) {
+    const res = await p__namespace.confirm({
+      message: "Advanced customizations?",
+      initialValue: false
+    });
+    if (isCancel2(res)) {
+      handleCancel();
+    }
+    wantAdvanced = res;
+  }
+  let level = flags.level ?? "Q";
+  let body = flags.body ?? "square";
+  let eye = flags.eye ?? "square";
+  let dot = flags.dot ?? "square";
+  let fg = flags.fg ?? "#000000";
+  let bg = flags.bg ?? "#ffffff";
+  let eyeColor = flags.eyeColor;
+  let dotColor = flags.dotColor;
+  let logo = flags.logo;
+  let margin = flags.margin ?? 0;
+  if (wantAdvanced && !nonInteractive) {
+    if (!flags.level) {
+      const res = await p__namespace.select({
+        message: "Error correction level",
+        options: [
+          {
+            value: "Q",
+            label: "Q \u2013 Quartile (recommended)",
+            hint: "~25% data recovery"
+          },
+          { value: "L", label: "L \u2013 Low", hint: "~7% data recovery" },
+          { value: "M", label: "M \u2013 Medium", hint: "~15% data recovery" },
+          { value: "H", label: "H \u2013 High", hint: "~30% data recovery" }
+        ],
+        initialValue: "Q"
+      });
+      if (isCancel2(res)) {
+        handleCancel();
+      }
+      level = res;
+    }
+    if (!flags.body) {
+      const res = await p__namespace.select({
+        message: "Body dot pattern",
+        options: qrdx.BODY_PATTERN.map((b) => ({ value: b, label: b })),
+        initialValue: "square"
+      });
+      if (isCancel2(res)) {
+        handleCancel();
+      }
+      body = res;
+    }
+    if (!flags.eye) {
+      const res = await p__namespace.select({
+        message: "Corner eye pattern",
+        options: qrdx.CORNER_EYE_PATTERNS.map((e) => ({ value: e, label: e })),
+        initialValue: "square"
+      });
+      if (isCancel2(res)) {
+        handleCancel();
+      }
+      eye = res;
+    }
+    if (!flags.dot) {
+      const res = await p__namespace.select({
+        message: "Corner dot pattern",
+        options: qrdx.CORNER_EYE_DOT_PATTERNS.map((d) => ({ value: d, label: d })),
+        initialValue: "square"
+      });
+      if (isCancel2(res)) {
+        handleCancel();
+      }
+      dot = res;
+    }
+    if (!flags.fg) {
+      const res = await p__namespace.text({
+        message: "Foreground color",
+        placeholder: "#000000",
+        defaultValue: "#000000",
+        validate(v) {
+          if (v && !/^#[0-9a-fA-F]{3,8}$/.test(v)) {
+            return "Enter a valid hex color (e.g. #000000)";
+          }
+        }
+      });
+      if (isCancel2(res)) {
+        handleCancel();
+      }
+      fg = res || "#000000";
+    }
+    if (!flags.bg) {
+      const res = await p__namespace.text({
+        message: "Background color",
+        placeholder: "#ffffff",
+        defaultValue: "#ffffff",
+        validate(v) {
+          if (v && !/^#[0-9a-fA-F]{3,8}$/.test(v)) {
+            return "Enter a valid hex color (e.g. #ffffff)";
+          }
+        }
+      });
+      if (isCancel2(res)) {
+        handleCancel();
+      }
+      bg = res || "#ffffff";
+    }
+    if (eyeColor === void 0) {
+      const res = await p__namespace.text({
+        message: `Corner eye color ${DIM}(leave blank to match foreground)${RESET}`,
+        placeholder: fg,
+        validate(v) {
+          if (v && !/^#[0-9a-fA-F]{3,8}$/.test(v)) {
+            return "Enter a valid hex color or leave blank";
+          }
+        }
+      });
+      if (isCancel2(res)) {
+        handleCancel();
+      }
+      eyeColor = res || void 0;
+    }
+    if (dotColor === void 0) {
+      const res = await p__namespace.text({
+        message: `Corner dot color ${DIM}(leave blank to match foreground)${RESET}`,
+        placeholder: fg,
+        validate(v) {
+          if (v && !/^#[0-9a-fA-F]{3,8}$/.test(v)) {
+            return "Enter a valid hex color or leave blank";
+          }
+        }
+      });
+      if (isCancel2(res)) {
+        handleCancel();
+      }
+      dotColor = res || void 0;
+    }
+    if (logo === void 0 && !flags.noLogo) {
+      const addLogo = await p__namespace.confirm({
+        message: "Add a logo to the center?",
+        initialValue: false
+      });
+      if (isCancel2(addLogo)) {
+        handleCancel();
+      }
+      if (addLogo) {
+        const res = await p__namespace.text({
+          message: "Logo URL",
+          placeholder: "https://qrdx.dev/logo.png",
+          validate(v) {
+            if (!v.trim()) {
+              return "Please enter a URL for the logo.";
+            }
+            try {
+              new URL(v);
+            } catch {
+              return "Please enter a valid URL.";
+            }
+          }
+        });
+        if (isCancel2(res)) {
+          handleCancel();
+        }
+        logo = res;
+      }
+    }
+    if (flags.margin === void 0) {
+      const res = await p__namespace.text({
+        message: "Quiet zone margin (modules)",
+        placeholder: "0",
+        defaultValue: "0",
+        validate(v) {
+          if (v && Number.isNaN(Number.parseInt(v, 10))) {
+            return "Enter a number";
+          }
+          if (v && Number.parseInt(v, 10) < 0) {
+            return "Must be 0 or greater";
+          }
+        }
+      });
+      if (isCancel2(res)) {
+        handleCancel();
+      }
+      margin = Number.parseInt(res || "0", 10);
+    }
+  }
+  const spinner2 = p__namespace.spinner();
+  spinner2.start("Generating QR code...");
+  try {
+    const qrProps = {
+      value,
+      level,
+      bodyPattern: body,
+      cornerEyePattern: eye,
+      cornerEyeDotPattern: dot,
+      fgColor: fg,
+      bgColor: bg,
+      ...eyeColor ? { eyeColor } : {},
+      ...dotColor ? { dotColor } : {},
+      margin,
+      size,
+      ...logo ? {
+        imageSettings: {
+          src: logo,
+          height: Math.round(size * 0.2),
+          width: Math.round(size * 0.2),
+          excavate: true
+        }
+      } : {}
+    };
+    if (outputPath) {
+      const format = inferFormat(outputPath);
+      await saveOutput({ ...qrProps, outputPath, format });
+      spinner2.stop(
+        `${GREEN}\u2714${RESET}  Saved to ${TEXT}${outputPath}${RESET} ${DIM}(${size}\xD7${size})${RESET}`
+      );
+    } else {
+      spinner2.stop("QR code ready");
+    }
+  } catch (err) {
+    spinner2.stop("Failed to generate QR code");
+    const msg = err instanceof Error ? err.message : String(err);
+    p__namespace.log.error(msg);
+    process.exit(1);
+  }
+  p__namespace.outro(`${DIM}Done!${RESET}`);
+}
+
+// src/index.ts
+var RESET2 = "\x1B[0m";
+var BOLD = "\x1B[1m";
+var DIM2 = "\x1B[38;5;102m";
+var TEXT2 = "\x1B[38;5;145m";
+var GRAYS = [
+  "\x1B[38;5;250m",
+  "\x1B[38;5;248m",
+  "\x1B[38;5;245m",
+  "\x1B[38;5;243m",
+  "\x1B[38;5;240m",
+  "\x1B[38;5;238m"
+];
+var LOGO_LINES = [
+  " \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557  \u2588\u2588\u2557",
+  "\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2588\u2588\u2557\u2588\u2588\u2554\u255D",
+  "\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551  \u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2554\u255D ",
+  "\u2588\u2588\u2551\u2584\u2584 \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551 \u2588\u2588\u2554\u2588\u2588\u2557 ",
+  "\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2554\u255D \u2588\u2588\u2557",
+  " \u255A\u2550\u2550\u2550\u2588\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D"
+];
+function getVersion() {
+  try {
+    const pkgPath = path.join(__dirname, "..", "package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    return pkg.version;
+  } catch {
+    return "0.0.1";
+  }
+}
+var VERSION = getVersion();
+function showLogo() {
+  console.log();
+  LOGO_LINES.forEach((line, i) => {
+    console.log(`${GRAYS[i] ?? GRAYS[5]}${line}${RESET2}`);
+  });
+}
+function showBanner() {
+  showLogo();
+  console.log();
+  console.log(`${DIM2}QR code generator for developers${RESET2}`);
+  console.log();
+  console.log(
+    `  ${DIM2}$${RESET2} ${TEXT2}qrdx generate${RESET2}                   ${DIM2}Generate a QR code interactively${RESET2}`
+  );
+  console.log(
+    `  ${DIM2}$${RESET2} ${TEXT2}qrdx generate${RESET2} ${DIM2}<url>${RESET2}            ${DIM2}Generate from URL${RESET2}`
+  );
+  console.log();
+  console.log(
+    `  ${DIM2}$${RESET2} ${TEXT2}qrdx --help${RESET2}                     ${DIM2}Show all commands and options${RESET2}`
+  );
+  console.log(
+    `  ${DIM2}$${RESET2} ${TEXT2}qrdx --version${RESET2}                  ${DIM2}Show version${RESET2}`
+  );
+  console.log();
+  console.log(`  ${DIM2}try:${RESET2} npx qrdx-cli generate "https://qrdx.dev"`);
+  console.log();
+}
+function showHelp() {
+  showLogo();
+  console.log(`
+${BOLD}Usage:${RESET2} qrdx <command> [options]
+
+${BOLD}Commands:${RESET2}
+  generate, gen, g    Generate a QR code (fully interactive or via flags)
+
+${BOLD}Generate Options:${RESET2}
+  <data>              URL or text to encode (positional)
+  -o, --output        Output file path (.svg or .png)
+  -l, --level         Error correction: L, M, Q, H  ${DIM2}(default: Q)${RESET2}
+  --body              Body dot pattern:
+                        ${DIM2}square, circle, circle-large, diamond,${RESET2}
+                        ${DIM2}circle-mixed, pacman, rounded, small-square, vertical-line${RESET2}
+  --eye               Corner eye pattern:
+                        ${DIM2}square, rounded, gear, circle, diya,${RESET2}
+                        ${DIM2}extra-rounded, message, pointy, curly${RESET2}
+  --dot               Corner dot pattern:
+                        ${DIM2}square, rounded, circle, diamond, message,${RESET2}
+                        ${DIM2}message-reverse, diya, diya-reverse,${RESET2}
+                        ${DIM2}rounded-triangle, star, banner${RESET2}
+  --fg                Foreground color  ${DIM2}(default: #000000)${RESET2}
+  --bg                Background color  ${DIM2}(default: #ffffff)${RESET2}
+  --eye-color         Corner eye color  ${DIM2}(default: matches --fg)${RESET2}
+  --dot-color         Corner dot color  ${DIM2}(default: matches --fg)${RESET2}
+  --logo              Logo URL for center image
+  --margin            Quiet zone margin in modules  ${DIM2}(default: 0)${RESET2}
+  --size              Output pixel size for SVG/PNG  ${DIM2}(default: 512)${RESET2}
+
+${BOLD}Global Options:${RESET2}
+  --help, -h          Show this help message
+  --version, -v       Show version number
+
+${BOLD}Examples:${RESET2}
+  ${DIM2}$${RESET2} qrdx generate
+  ${DIM2}$${RESET2} qrdx generate "https://qrdx.dev"
+  ${DIM2}$${RESET2} qrdx generate "https://qrdx.dev" -o qr.svg
+  ${DIM2}$${RESET2} qrdx generate "https://qrdx.dev" -o qr.png --body circle --eye gear --dot star
+  ${DIM2}$${RESET2} qrdx generate "https://qrdx.dev" --fg "#ff0000" --bg "#ffffff" --size 1024
+  ${DIM2}$${RESET2} qrdx generate "https://qrdx.dev" --logo "https://qrdx.dev/logo.png" -o branded.svg
+
+  Visit ${TEXT2}https://qrdx.dev${RESET2} for more.
+`);
+}
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.length === 0) {
+    showBanner();
+    return;
+  }
+  const command = args[0];
+  const restArgs = args.slice(1);
+  switch (command) {
+    case "generate":
+    case "gen":
+    case "g":
+      showLogo();
+      console.log();
+      await runGenerate(restArgs);
+      break;
+    case "--help":
+    case "-h":
+    case "help":
+      showHelp();
+      break;
+    case "--version":
+    case "-v":
+      console.log(VERSION);
+      break;
+    default:
+      if (command.startsWith("-")) {
+        console.log(`Unknown command: ${command}`);
+        console.log(`Run ${BOLD}qrdx --help${RESET2} for usage.`);
+      } else {
+        showLogo();
+        console.log();
+        await runGenerate(args);
+      }
+  }
+}
+main().catch((err) => {
+  const msg = err instanceof Error ? err.message : String(err);
+  console.error(`\x1B[38;5;203m\u2717 ${msg}${RESET2}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@qrdx/cli",
+  "version": "0.0.1",
+  "description": "QR code generator CLI for developers",
+  "bin": {
+    "qrdx": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^0.10.0",
+    "picocolors": "^1.1.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "sharp": "^0.34.2",
+    "qrdx": "0.0.43"
+  },
+  "devDependencies": {
+    "@types/node": "^25.1.0",
+    "@types/react": "19.2.7",
+    "@types/react-dom": "19.2.3",
+    "tsup": "^8.5.1",
+    "typescript": "5.9.3",
+    "vitest": "^4.0.18",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "git clean -xdf .cache .turbo dist node_modules",
+    "typecheck": "tsc --noEmit"
+  }
+}