@qrdx/cli 0.0.1 → 0.0.2

package/README.md

@@ -1,4 +1,4 @@
-# qrdx-cli
+# @qrdx/cli
 
 QR code generator CLI for developers. Generate styled, scannable QR codes as SVG or PNG — fully non-interactive, CI-friendly.
 
@@ -9,7 +9,7 @@ QR code generator CLI for developers. Generate styled, scannable QR codes as SVG
 npm install -g qrdx
 
 # Or install the standalone CLI package
-npm install -g qrdx-cli
+npm install -g @qrdx/cli
 ```
 
 Or run without installing:
@@ -72,9 +72,9 @@ qrdx generate
 
 **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`
+**Eye** (`--eye`): `square` `rounded` `gear` `circle` `diya` `extra-rounded` `message` `pointy` `curly`
 
-**Dot** (`--dot`): `square` `rounded` `circle` `heart` `diamond` `star`
+**Dot** (`--dot`): `square` `rounded` `circle` `diamond` `message` `message-reverse` `diya` `diya-reverse` `rounded-triangle` `star` `banner`
 
 ## Interactive mode
 

package/dist/index.js

@@ -55,6 +55,16 @@ var RESET = "\x1B[0m";
 var TEXT = "\x1B[38;5;145m";
 var GREEN = "\x1B[38;5;114m";
 var DIM = "\x1B[38;5;102m";
+function parseColorFlag(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith("{")) {
+    try {
+      return JSON.parse(trimmed);
+    } catch {
+    }
+  }
+  return trimmed;
+}
 var IS_TTY = Boolean(process.stdin.isTTY);
 function parseFlags(args) {
   const flags = {};
@@ -93,19 +103,19 @@ function parseFlags(args) {
         i += 2;
         break;
       case "--fg":
-        flags.fg = next;
+        flags.fg = next ? parseColorFlag(next) : void 0;
         i += 2;
         break;
       case "--bg":
-        flags.bg = next;
+        flags.bg = next ? parseColorFlag(next) : void 0;
         i += 2;
         break;
       case "--eye-color":
-        flags.eyeColor = next;
+        flags.eyeColor = next ? parseColorFlag(next) : void 0;
         i += 2;
         break;
       case "--dot-color":
-        flags.dotColor = next;
+        flags.dotColor = next ? parseColorFlag(next) : void 0;
         i += 2;
         break;
       case "--logo":
@@ -113,7 +123,7 @@ function parseFlags(args) {
         i += 2;
         break;
       case "--margin":
-        flags.margin = next ? Number.parseInt(next, 10) : 0;
+        flags.margin = next ? Number.parseInt(next, 10) : qrdx.DEFAULT_MARGIN;
         i += 2;
         break;
       case "--size":
@@ -124,6 +134,10 @@ function parseFlags(args) {
         flags.noLogo = true;
         i++;
         break;
+      case "--template":
+        flags.template = next;
+        i += 2;
+        break;
       default:
         i++;
     }
@@ -148,7 +162,7 @@ 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
+    flags.body || flags.eye || flags.dot || flags.fg || flags.bg || flags.eyeColor || flags.dotColor || flags.logo || flags.level || flags.margin !== void 0 || flags.template
   );
   p__namespace.intro(`${TEXT}qrdx${RESET} ${DIM}\u2014 QR Code Generator${RESET}`);
   let value = flags.value;
@@ -209,7 +223,8 @@ async function runGenerate(args) {
   let eyeColor = flags.eyeColor;
   let dotColor = flags.dotColor;
   let logo = flags.logo;
-  let margin = flags.margin ?? 0;
+  let margin = flags.margin ?? qrdx.DEFAULT_MARGIN;
+  let template = flags.template;
   if (wantAdvanced && !nonInteractive) {
     if (!flags.level) {
       const res = await p__namespace.select({
@@ -266,42 +281,75 @@ async function runGenerate(args) {
     }
     if (!flags.fg) {
       const res = await p__namespace.text({
-        message: "Foreground color",
+        message: `Foreground color ${DIM}(hex or JSON gradient)${RESET}`,
         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 (!v) {
+            return void 0;
+          }
+          if (v.trim().startsWith("{")) {
+            try {
+              JSON.parse(v.trim());
+            } catch {
+              return "Enter a valid hex color or JSON gradient object";
+            }
+            return void 0;
+          }
+          if (!/^#[0-9a-fA-F]{3,8}$/.test(v)) {
+            return "Enter a valid hex color (e.g. #000000) or JSON gradient";
           }
         }
       });
       if (isCancel2(res)) {
         handleCancel();
       }
-      fg = res || "#000000";
+      fg = parseColorFlag(res || "#000000");
     }
     if (!flags.bg) {
       const res = await p__namespace.text({
-        message: "Background color",
+        message: `Background color ${DIM}(hex or JSON gradient)${RESET}`,
         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 (!v) {
+            return void 0;
+          }
+          if (v.trim().startsWith("{")) {
+            try {
+              JSON.parse(v.trim());
+            } catch {
+              return "Enter a valid hex color or JSON gradient object";
+            }
+            return void 0;
+          }
+          if (!/^#[0-9a-fA-F]{3,8}$/.test(v)) {
+            return "Enter a valid hex color (e.g. #ffffff) or JSON gradient";
           }
         }
       });
       if (isCancel2(res)) {
         handleCancel();
       }
-      bg = res || "#ffffff";
+      bg = parseColorFlag(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,
+        placeholder: "leave blank",
         validate(v) {
-          if (v && !/^#[0-9a-fA-F]{3,8}$/.test(v)) {
+          if (!v) {
+            return void 0;
+          }
+          if (v.trim().startsWith("{")) {
+            try {
+              JSON.parse(v.trim());
+            } catch {
+              return "Enter a valid hex color or JSON gradient object";
+            }
+            return void 0;
+          }
+          if (!/^#[0-9a-fA-F]{3,8}$/.test(v)) {
             return "Enter a valid hex color or leave blank";
           }
         }
@@ -309,14 +357,26 @@ async function runGenerate(args) {
       if (isCancel2(res)) {
         handleCancel();
       }
-      eyeColor = res || void 0;
+      const eyeVal = res;
+      eyeColor = eyeVal ? parseColorFlag(eyeVal) : 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,
+        placeholder: "leave blank",
         validate(v) {
-          if (v && !/^#[0-9a-fA-F]{3,8}$/.test(v)) {
+          if (!v) {
+            return void 0;
+          }
+          if (v.trim().startsWith("{")) {
+            try {
+              JSON.parse(v.trim());
+            } catch {
+              return "Enter a valid hex color or JSON gradient object";
+            }
+            return void 0;
+          }
+          if (!/^#[0-9a-fA-F]{3,8}$/.test(v)) {
             return "Enter a valid hex color or leave blank";
           }
         }
@@ -324,7 +384,23 @@ async function runGenerate(args) {
       if (isCancel2(res)) {
         handleCancel();
       }
-      dotColor = res || void 0;
+      const dotVal = res;
+      dotColor = dotVal ? parseColorFlag(dotVal) : void 0;
+    }
+    if (!flags.template) {
+      const templateIds = qrdx.getTemplateIds();
+      const res = await p__namespace.select({
+        message: `Template ${DIM}(decorative wrapper around the QR code)${RESET}`,
+        options: [
+          { value: "", label: "none" },
+          ...templateIds.filter((id) => id !== "default").map((id) => ({ value: id, label: id }))
+        ],
+        initialValue: ""
+      });
+      if (isCancel2(res)) {
+        handleCancel();
+      }
+      template = res || void 0;
     }
     if (logo === void 0 && !flags.noLogo) {
       const addLogo = await p__namespace.confirm({
@@ -358,8 +434,8 @@ async function runGenerate(args) {
     if (flags.margin === void 0) {
       const res = await p__namespace.text({
         message: "Quiet zone margin (modules)",
-        placeholder: "0",
-        defaultValue: "0",
+        placeholder: String(qrdx.DEFAULT_MARGIN),
+        defaultValue: String(qrdx.DEFAULT_MARGIN),
         validate(v) {
           if (v && Number.isNaN(Number.parseInt(v, 10))) {
             return "Enter a number";
@@ -372,7 +448,7 @@ async function runGenerate(args) {
       if (isCancel2(res)) {
         handleCancel();
       }
-      margin = Number.parseInt(res || "0", 10);
+      margin = Number.parseInt(res || String(qrdx.DEFAULT_MARGIN), 10);
     }
   }
   const spinner2 = p__namespace.spinner();
@@ -390,6 +466,7 @@ async function runGenerate(args) {
       ...dotColor ? { dotColor } : {},
       margin,
       size,
+      ...template ? { templateId: template } : {},
       ...logo ? {
         imageSettings: {
           src: logo,
@@ -473,7 +550,7 @@ function showBanner() {
     `  ${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(`  ${DIM2}try:${RESET2} npx @qrdx/cli generate "https://qrdx.dev"`);
   console.log();
 }
 function showHelp() {
@@ -498,13 +575,20 @@ ${BOLD}Generate Options:${RESET2}
                         ${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}
+  --fg                Foreground color \u2014 hex or JSON gradient  ${DIM2}(default: #000000)${RESET2}
+  --bg                Background color \u2014 hex or JSON gradient  ${DIM2}(default: #ffffff)${RESET2}
+  --eye-color         Corner eye color \u2014 hex or JSON gradient  ${DIM2}(default: matches --fg)${RESET2}
+  --dot-color         Corner dot color \u2014 hex or JSON gradient  ${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}
+  --template          Decorative template wrapper:
+                        ${DIM2}Arrow, StandardBox, SquareBorder, StrikedBox, Halloween${RESET2}
+
+${BOLD}Gradient Colors:${RESET2}
+  Pass a JSON object to --fg / --bg / --eye-color / --dot-color for gradients:
+  ${DIM2}Linear:  '{"type":"linear","stops":[{"color":"#f00","offset":0},{"color":"#00f","offset":100}],"angle":45}'${RESET2}
+  ${DIM2}Radial:  '{"type":"radial","stops":[{"color":"#f00","offset":0},{"color":"#00f","offset":100}]}'${RESET2}
 
 ${BOLD}Global Options:${RESET2}
   --help, -h          Show this help message
@@ -516,7 +600,10 @@ ${BOLD}Examples:${RESET2}
   ${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
+  ${DIM2}$${RESET2} qrdx generate "https://qrdx.dev" --logo "https://qrdx.dev/logo.png" --level H -o branded.svg
+  ${DIM2}$${RESET2} qrdx generate "https://qrdx.dev" --template Arrow -o arrow.svg
+  ${DIM2}$${RESET2} qrdx generate "https://qrdx.dev" --template Halloween --body circle --eye gear -o halloween.svg
+  ${DIM2}$${RESET2} qrdx generate "https://qrdx.dev" --fg '{"type":"linear","stops":[{"color":"#6366f1","offset":0},{"color":"#ec4899","offset":100}],"angle":135}' -o gradient.svg
 
   Visit ${TEXT2}https://qrdx.dev${RESET2} for more.
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qrdx/cli",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "QR code generator CLI for developers",
   "bin": {
     "qrdx": "./dist/index.js"
@@ -15,7 +15,7 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "sharp": "^0.34.2",
-    "qrdx": "0.0.43"
+    "qrdx": "0.0.46"
   },
   "devDependencies": {
     "@types/node": "^25.1.0",