qr-generator-styled 1.0.0 → 2.0.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Luis Yerena Sosa
+Copyright (c) 2026 Luis Manuel Yerena Sosa
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -11,13 +11,131 @@ A professional Node.js/TypeScript library for generating QR codes with advanced
 - 🎨 **Customizable Styles**: Solid colors or multi-color gradients
 - 🔷 **Rounded Modules**: Smooth, modern edges with radius control
 - 🖼️ **Logo Support**: Add logos with circular or square backgrounds
-- 📦 **Multiple Output Formats**: File, Buffer, Data URL, or Canvas
+- � **Specialized QR Types**: vCard, WiFi, Email, SMS, Geo location
+- 📄 **SVG Export**: Vector format for perfect scalability
+- 👁️ **Eye Customization**: Custom colors and shapes for finder patterns
+- 📏 **Proper Margins**: Standard QR quiet zone support
+- 📦 **Multiple Output Formats**: PNG, JPEG, SVG, Buffer, Data URL, or Canvas
 - 🛠️ **CLI & API**: Use from command line or programmatically
 - ✅ **Built-in Validation**: Options validated automatically
 - 🎯 **Full TypeScript Support**: Complete type definitions included
 - 🔧 **Modular Architecture**: Clean, maintainable code
 
-## 📦 Installation
+## �️ Visual Examples
+### Advanced Features
+<table>
+  <tr>
+    <td align="center" valign="top">
+      <img src="docs/images/vcard-contact.png" width="180" alt="vCard Contact QR"/>
+      <br/>
+      <b>vCard Contact</b>
+      <br/>
+      <sub>Purple gradient with custom eyes</sub>
+    </td>
+    <td align="center" valign="top">
+      <img src="docs/images/wifi-network.png" width="180" alt="WiFi Network QR"/>
+      <br/>
+      <b>WiFi Network</b>
+      <br/>
+      <sub>Green gradient with rounded modules</sub>
+    </td>
+    <td align="center" valign="top">
+      <img src="docs/images/email-contact.png" width="180" alt="Email Contact QR"/>
+      <br/>
+      <b>Email Contact</b>
+      <br/>
+      <sub>Pink gradient with eye customization</sub>
+    </td>
+    <td align="center" valign="top">
+      <img src="docs/images/custom-eyes.png" width="180" alt="Custom Eyes QR"/>
+      <br/>
+      <b>Custom Eyes</b>
+      <br/>
+      <sub>Red eye accents (square modules)</sub>
+    </td>
+  </tr>
+</table>
+
+### Basic Styles
+
+<table>
+  <tr>
+    <td align="center" valign="top">
+      <img src="docs/images/basic-classic.png" width="150" alt="Classic Black & White QR"/>
+      <br/>
+      <b>Classic</b>
+      <br/>
+      <sub>Traditional black & white</sub>
+    </td>
+    <td align="center" valign="top">
+      <img src="docs/images/basic-blue.png" width="150" alt="Professional Blue QR"/>
+      <br/>
+      <b>Professional</b>
+      <br/>
+      <sub>Blue rounded design</sub>
+    </td>
+    <td align="center" valign="top">
+      <img src="docs/images/basic-green.png" width="150" alt="Eco Green QR"/>
+      <br/>
+      <b>Eco</b>
+      <br/>
+      <sub>Green with custom eyes</sub>
+    </td>
+    <td align="center" valign="top">
+      <img src="docs/images/basic-red.png" width="150" alt="Alert Red QR"/>
+      <br/>
+      <b>Alert</b>
+      <br/>
+      <sub>Red attention-grabbing</sub>
+    </td>
+    <td align="center" valign="top">
+      <img src="docs/images/basic-purple.png" width="150" alt="Creative Purple QR"/>
+      <br/>
+      <b>Creative</b>
+      <br/>
+      <sub>Purple artistic</sub>
+    </td>
+  </tr>
+</table>
+
+### With Logos
+
+<table>
+  <tr>
+    <td align="center" valign="top">
+      <img src="docs/images/logo-corporate.png" width="160" alt="Corporate QR with Logo"/>
+      <br/>
+      <b>Corporate</b>
+      <br/>
+      <sub>Circle logo, professional blue</sub>
+    </td>
+    <td align="center" valign="top">
+      <img src="docs/images/logo-eco.png" width="160" alt="Eco Brand QR with Logo"/>
+      <br/>
+      <b>Eco Brand</b>
+      <br/>
+      <sub>Square logo, green gradient</sub>
+    </td>
+    <td align="center" valign="top">
+      <img src="docs/images/logo-tech.png" width="160" alt="Tech Startup QR with Logo"/>
+      <br/>
+      <b>Tech Startup</b>
+      <br/>
+      <sub>Circle logo, purple gradient</sub>
+    </td>
+    <td align="center" valign="top">
+      <img src="docs/images/logo-restaurant.png" width="160" alt="Restaurant QR with Logo"/>
+      <br/>
+      <b>Restaurant</b>
+      <br/>
+      <sub>Square logo, red gradient</sub>
+    </td>
+  </tr>
+</table>
+
+> 💡 **Tip**: All examples shown above were generated with this library! Check the [`examples/`](examples/) directory for source code.
+
+## �📦 Installation
 
 ```bash
 npm install qr-generator-styled
@@ -49,20 +167,57 @@ qr-styled --url "https://github.com" --logo ./my-logo.png --out my-qr.png
 ```typescript
 import { QRGenerator, generateQRToFile } from 'qr-generator-styled';
 
-// Option 1: Using QRGenerator class
+// Basic URL QR code
 const generator = new QRGenerator({
   url: 'https://github.com',
   gradient: true,
   gradientColors: '#667eea,#764ba2'
 });
 
-await generator.generateToFile('qr- output.png');
+await generator.generateToFile('qr-output.png');
+
+// vCard contact QR code
+const vCardGenerator = new QRGenerator({
+  type: 'vcard',
+  data: {
+    firstName: 'John',
+    lastName: 'Doe',
+    phone: '+1234567890',
+    email: 'john@example.com',
+    organization: 'Tech Corp'
+  }
+});
+
+await vCardGenerator.generateToFile('contact-qr.png');
+
+// WiFi QR code
+const wifiGenerator = new QRGenerator({
+  type: 'wifi',
+  data: {
+    ssid: 'MyNetwork',
+    password: 'SecurePassword123',
+    encryption: 'WPA'
+  }
+});
+
+await wifiGenerator.generateToFile('wifi-qr.png');
 
-// Option 2: Using helper function
+// SVG export for scalability
+const svgGenerator = new QRGenerator({
+  url: 'https://example.com',
+  foregroundColor: '#2196F3',
+  eyeColor: '#FF5722',
+  eyeRadius: 0.4
+});
+
+const svg = await svgGenerator.generateToSVG();
+await svgGenerator.generateToSVGFile('qr.svg');
+
+// Helper function
 await generateQRToFile(
   {
     url: 'https://github.com',
-    color: '#2d3748'
+    foregroundColor: '#2d3748'
   },
   'qr-output.png'
 );
@@ -72,16 +227,29 @@ await generateQRToFile(
 
 ### Configuration Options
 
-| Option            | Type      | Default      | Description                 |
-| ----------------- | --------- | ------------ | --------------------------- |
-| `url`             | `string`  | **required** | URL or text for the QR code |
-| `size`            | `number`  | `600`        | Canvas size in pixels       |
-| `padding`         | `number`  | `40`         | Padding around QR code      |
-| `color`           | `string`  | `'#000000'`  | QR code color (hex format)  |
-| `rounded`         | `boolean` | `true`       | Use rounded module corners  |
-| `moduleRadius`    | `number`  | `0.35`       | Corner radius (0.0 - 0.5)   |
-| `cornerRadius`    | `number`  | `60`         | Background corner radius    |
-| `backgroundColor` | `string`  | `'#ffffff'`  | Background color            |
+#### Basic Options
+
+| Option            | Type         | Default      | Description                                            |
+| ----------------- | ------------ | ------------ | ------------------------------------------------------ |
+| `url`             | `string`     | _optional_   | URL or text content                                    |
+| `type`            | `QRDataType` | `'text'`     | QR data type (url, text, vcard, wifi, email, sms, geo) |
+| `data`            | `object`     | _optional_   | Structured data for specialized types                  |
+| `size`            | `number`     | `600`        | Canvas size in pixels                                  |
+| `margin`          | `number`     | `4`          | Quiet zone margin (4 modules standard)                 |
+| `padding`         | `number`     | `40`         | Canvas padding in pixels                               |
+| `foregroundColor` | `string`     | `'#000000'`  | QR code color (hex format)                             |
+| `color`           | `string`     | _deprecated_ | Use `foregroundColor` instead                          |
+| `rounded`         | `boolean`    | `true`       | Use rounded module corners                             |
+| `moduleRadius`    | `number`     | `0.35`       | Corner radius (0.0 - 0.5)                              |
+| `cornerRadius`    | `number`     | `60`         | Background corner radius                               |
+| `backgroundColor` | `string`     | `'#ffffff'`  | Background color                                       |
+
+#### Eye Customization
+
+| Option      | Type     | Default | Description                       |
+| ----------- | -------- | ------- | --------------------------------- |
+| `eyeColor`  | `string` | `''`    | Custom eye (finder pattern) color |
+| `eyeRadius` | `number` | `0`     | Eye corner radius (0.0 - 0.5)     |
 
 #### Gradient Options
 
@@ -93,12 +261,91 @@ await generateQRToFile(
 
 #### Logo Options
 
-| Option        | Type                 | Default    | Description                |
-| ------------- | -------------------- | ---------- | -------------------------- |
-| `logo`        | `string`             | `''`       | Logo image path or URL     |
-| `logoPadding` | `number`             | `10`       | Padding around logo        |
-| `logoShape`   | `'circle'\|'square'` | `'circle'` | Logo background shape      |
-| `logoRadius`  | `number`             | `20`       | Corner radius (for square) |
+| Option                | Type                 | Default     | Description                    |
+| --------------------- | -------------------- | ----------- | ------------------------------ |
+| `logo`                | `string`             | `''`        | Logo image path or URL         |
+| `logoSize`            | `number`             | `120`       | Logo size in pixels            |
+| `logoPadding`         | `number`             | `10`        | Padding around logo            |
+| `logoShape`           | `'circle'\|'square'` | `'circle'`  | Logo background shape          |
+| `logoBackgroundColor` | `string`             | `'#ffffff'` | Logo background color          |
+| `logoRadius`          | `number`             | `20`        | Corner radius for square logos |
+
+### Specialized QR Codes
+
+#### vCard (Contact Card)
+
+```typescript
+{
+  type: 'vcard',
+  data: {
+    firstName: 'John',
+    lastName: 'Doe',
+    organization: 'Tech Corp',
+    title: 'CEO',
+    phone: '+1234567890',
+    email: 'john@example.com',
+    url: 'https://example.com',
+    address: '123 Main St',
+    city: 'New York',
+    state: 'NY',
+    zip: '10001',
+    country: 'USA'
+  }
+}
+```
+
+#### WiFi Network
+
+```typescript
+{
+  type: 'wifi',
+  data: {
+    ssid: 'MyNetwork',
+    password: 'SecurePassword123',
+    encryption: 'WPA', // 'WPA' | 'WEP' | 'nopass'
+    hidden: false      // optional
+  }
+}
+```
+
+#### Email
+
+```typescript
+{
+  type: 'email',
+  data: {
+    email: 'contact@example.com',
+    subject: 'Hello',    // optional
+    body: 'Message text' // optional
+  }
+}
+```
+
+#### SMS
+
+```typescript
+{
+  type: 'sms',
+  data: {
+    phone: '+1234567890',
+    message: 'Hello!'  // optional
+  }
+}
+```
+
+#### Geo Location
+
+```typescript
+{
+  type: 'geo',
+  data: {
+    latitude: 40.7128,
+    longitude: -74.0060
+  }
+}
+```
+
+| `logoRadius` | `number` | `20` | Corner radius (for square) |
 
 ### API Reference
 
@@ -203,7 +450,7 @@ await generator.generateToFile('instagram-qr.png');
 ```typescript
 const generator = new QRGenerator({
   url: 'https://your-company.com',
-  color: '#1a365d',
+  foregroundColor: '#1a365d',
   logo: './company-logo.png',
   logoShape: 'square',
   logoRadius: 15,

package/dist/index.d.ts

@@ -4,10 +4,12 @@
  */
 export { QRGenerator, generateQR, generateQRToFile } from './lib/QRGenerator.js';
 export { DEFAULT_OPTIONS, VALID_LOGO_SHAPES, VALID_ERROR_CORRECTION_LEVELS } from './lib/utils/types.js';
-export type { QROptions, LogoShape, ErrorCorrectionLevel } from './lib/utils/types.js';
+export type { QROptions, QRDataType, VCardData, WiFiData, EmailData, SMSData, GeoData, LogoShape, ErrorCorrectionLevel } from './lib/utils/types.js';
 export { validateOptions, normalizeOptions } from './lib/utils/validators.js';
+export { formatVCard, formatWiFi, formatEmail, formatSMS, formatGeo, formatQRData } from './lib/utils/formatters.js';
 export { BackgroundRenderer } from './lib/renderers/BackgroundRenderer.js';
 export { GradientRenderer } from './lib/renderers/GradientRenderer.js';
 export { ModuleRenderer } from './lib/renderers/ModuleRenderer.js';
 export { LogoRenderer } from './lib/renderers/LogoRenderer.js';
+export { SVGRenderer } from './lib/renderers/SVGRenderer.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":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,6BAA6B,EAC9B,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,SAAS,EACT,SAAS,EACT,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,6BAA6B,EAC9B,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,QAAQ,EACR,SAAS,EACT,OAAO,EACP,OAAO,EACP,SAAS,EACT,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACT,YAAY,EACb,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -5,8 +5,10 @@
 export { QRGenerator, generateQR, generateQRToFile } from './lib/QRGenerator.js';
 export { DEFAULT_OPTIONS, VALID_LOGO_SHAPES, VALID_ERROR_CORRECTION_LEVELS } from './lib/utils/types.js';
 export { validateOptions, normalizeOptions } from './lib/utils/validators.js';
+export { formatVCard, formatWiFi, formatEmail, formatSMS, formatGeo, formatQRData } from './lib/utils/formatters.js';
 export { BackgroundRenderer } from './lib/renderers/BackgroundRenderer.js';
 export { GradientRenderer } from './lib/renderers/GradientRenderer.js';
 export { ModuleRenderer } from './lib/renderers/ModuleRenderer.js';
 export { LogoRenderer } from './lib/renderers/LogoRenderer.js';
+export { SVGRenderer } from './lib/renderers/SVGRenderer.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;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,6BAA6B,EAC9B,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,6BAA6B,EAC9B,MAAM,sBAAsB,CAAC;AAc9B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACT,YAAY,EACb,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/lib/QRGenerator.d.ts

@@ -9,6 +9,10 @@ export declare class QRGenerator {
      * Creates a new QR generator instance
      */
     constructor(options: QROptions);
+    /**
+     * Generates QR code content from options
+     */
+    private getQRContent;
     /**
      * Generates QR code and returns the canvas
      */
@@ -25,6 +29,14 @@ export declare class QRGenerator {
      * Generates QR code and returns data URL
      */
     generateToDataURL(format?: 'png' | 'jpeg'): Promise<string>;
+    /**
+     * Generates QR code as SVG string
+     */
+    generateToSVG(): Promise<string>;
+    /**
+     * Generates QR code as SVG and saves to file
+     */
+    generateToSVGFile(outputPath: string): Promise<void>;
     /**
      * Updates generator options
      */

package/dist/lib/QRGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QRGenerator.d.ts","sourceRoot":"","sources":["../../src/lib/QRGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,MAAM,EAAE,MAAM,QAAQ,CAAC;AAM9C,OAAO,EAAE,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AAG9D;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAsB;IAErC;;OAEG;gBACS,OAAO,EAAE,SAAS;IAQ9B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IA6CjC;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD;;OAEG;IACG,gBAAgB,CAAC,MAAM,GAAE,KAAK,GAAG,MAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAMvE;;OAEG;IACG,iBAAiB,CAAC,MAAM,GAAE,KAAK,GAAG,MAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;CAOjD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAGpE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,SAAS,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAGf"}
+{"version":3,"file":"QRGenerator.d.ts","sourceRoot":"","sources":["../../src/lib/QRGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,MAAM,EAAE,MAAM,QAAQ,CAAC;AAO9C,OAAO,EAAE,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AAI9D;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAsB;IAErC;;OAEG;gBACS,OAAO,EAAE,SAAS;IAc9B;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAmDjC;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD;;OAEG;IACG,gBAAgB,CAAC,MAAM,GAAE,KAAK,GAAG,MAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAMvE;;OAEG;IACG,iBAAiB,CAAC,MAAM,GAAE,KAAK,GAAG,MAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAgBtC;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1D;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;CAajD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAGpE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,SAAS,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/lib/QRGenerator.js

@@ -5,8 +5,10 @@ import { BackgroundRenderer } from './renderers/BackgroundRenderer.js';
 import { GradientRenderer } from './renderers/GradientRenderer.js';
 import { ModuleRenderer } from './renderers/ModuleRenderer.js';
 import { LogoRenderer } from './renderers/LogoRenderer.js';
+import { SVGRenderer } from './renderers/SVGRenderer.js';
 import { DEFAULT_OPTIONS } from './utils/types.js';
 import { validateOptions, normalizeOptions } from './utils/validators.js';
+import { formatQRData } from './utils/formatters.js';
 /**
  * QR Code Generator with advanced styling options
  */
@@ -16,18 +18,32 @@ export class QRGenerator {
      */
     constructor(options) {
         this.options = normalizeOptions(options, DEFAULT_OPTIONS);
+        // Support deprecated 'color' field with backward compatibility
+        if (options.color && !options.foregroundColor) {
+            this.options.foregroundColor = options.color;
+        }
         validateOptions(this.options);
     }
+    /**
+     * Generates QR code content from options
+     */
+    getQRContent() {
+        const { type, url, data } = this.options;
+        // Use formatter to handle different data types
+        return formatQRData(type, url, data);
+    }
     /**
      * Generates QR code and returns the canvas
      */
     async generate() {
-        const { url, errorCorrectionLevel, size, padding } = this.options;
+        const { errorCorrectionLevel, size, padding, foregroundColor } = this.options;
         const qrSize = size - padding * 2;
+        // Get formatted content based on type
+        const content = this.getQRContent();
         // Generate QR data
-        const qrData = await QRCode.create(url, {
+        const qrData = await QRCode.create(content, {
             errorCorrectionLevel
-        });
+        }); // margin option not in types but works
         const modules = qrData.modules;
         const moduleCount = modules.size;
         const moduleSize = qrSize / moduleCount;
@@ -41,9 +57,10 @@ export class QRGenerator {
         // Create fill style (gradient or solid)
         const gradientRenderer = new GradientRenderer(ctx, this.options);
         const fillStyle = gradientRenderer.getFillStyle();
-        // Render QR modules
+        // Render QR modules with eye customization support
         const moduleRenderer = new ModuleRenderer(ctx, modules, {
             ...this.options,
+            color: foregroundColor, // Use new foregroundColor
             moduleCount,
             moduleSize
         });
@@ -82,11 +99,37 @@ export class QRGenerator {
         }
         return canvas.toDataURL('image/png');
     }
+    /**
+     * Generates QR code as SVG string
+     */
+    async generateToSVG() {
+        const { errorCorrectionLevel, size } = this.options;
+        // Get formatted content based on type
+        const content = this.getQRContent();
+        // Generate QR data
+        const qrData = await QRCode.create(content, {
+            errorCorrectionLevel
+        });
+        // Use SVG renderer
+        const svgRenderer = new SVGRenderer(qrData, this.options, size);
+        return svgRenderer.generate();
+    }
+    /**
+     * Generates QR code as SVG and saves to file
+     */
+    async generateToSVGFile(outputPath) {
+        const svg = await this.generateToSVG();
+        fs.writeFileSync(outputPath, svg, 'utf-8');
+    }
     /**
      * Updates generator options
      */
     updateOptions(options) {
         this.options = normalizeOptions({ ...this.options, ...options }, DEFAULT_OPTIONS);
+        // Support deprecated 'color' field
+        if (options.color && !options.foregroundColor) {
+            this.options.foregroundColor = options.color;
+        }
         validateOptions(this.options);
     }
 }

package/dist/lib/QRGenerator.js.map

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

package/dist/lib/QRGenerator.new-features.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=QRGenerator.new-features.test.d.ts.map

package/dist/lib/QRGenerator.new-features.test.d.ts.map

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