@qr-styled/node 1.0.0

package/dist/cli/index.d.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import yargs from 'yargs';
+interface CLIArguments {
+    url: string;
+    out: string;
+    size: number;
+    color: string;
+    logo: string;
+    rounded: boolean;
+    moduleRadius: number;
+    logoPadding: number;
+    logoShape: 'circle' | 'square';
+    logoRadius: number;
+    gradient: boolean;
+    gradientColors: string;
+    gradientAngle: number;
+    padding: number;
+    cornerRadius: number;
+}
+/**
+ * CLI argument parser configuration
+ */
+export declare function buildCLI(): yargs.Argv<CLIArguments>;
+/**
+ * Executes the CLI command
+ */
+export declare function runCLI(): Promise<void>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,QAAQ,IA2FP,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CACxC;AAED;;GAEG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB5C"}

package/dist/cli/index.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+import yargs from 'yargs';
+import { hideBin } from 'yargs/helpers';
+import { QRGenerator } from '../lib/QRGenerator.js';
+import chalk from 'chalk';
+/**
+ * CLI argument parser configuration
+ */
+export function buildCLI() {
+    return yargs(hideBin(process.argv))
+        .usage('Usage: $0 --url <text> [options]')
+        .option('url', {
+        type: 'string',
+        demandOption: true,
+        describe: 'URL or text for the QR code',
+        alias: 'u'
+    })
+        .option('out', {
+        type: 'string',
+        default: 'qr.png',
+        describe: 'Output file path',
+        alias: 'o'
+    })
+        .option('size', {
+        type: 'number',
+        default: 600,
+        describe: 'Canvas size in pixels'
+    })
+        .option('color', {
+        type: 'string',
+        default: '#000000',
+        describe: 'QR code color (hex format)',
+        alias: 'c'
+    })
+        .option('logo', {
+        type: 'string',
+        default: '',
+        describe: 'Logo image path or URL',
+        alias: 'l'
+    })
+        .option('rounded', {
+        type: 'boolean',
+        default: true,
+        describe: 'Use rounded module corners'
+    })
+        .option('moduleRadius', {
+        type: 'number',
+        default: 0.35,
+        describe: 'Module corner radius (0.0 - 0.5)'
+    })
+        .option('logoPadding', {
+        type: 'number',
+        default: 10,
+        describe: 'Padding around logo'
+    })
+        .option('logoShape', {
+        type: 'string',
+        default: 'circle',
+        choices: ['circle', 'square'],
+        describe: 'Logo background shape'
+    })
+        .option('logoRadius', {
+        type: 'number',
+        default: 20,
+        describe: 'Corner radius for square logo background'
+    })
+        .option('gradient', {
+        type: 'boolean',
+        default: false,
+        describe: 'Use gradient colors',
+        alias: 'g'
+    })
+        .option('gradientColors', {
+        type: 'string',
+        default: '#FEDA75,#FA7E1E,#D62976,#962FBF,#4F5BD5',
+        describe: 'Comma-separated gradient colors'
+    })
+        .option('gradientAngle', {
+        type: 'number',
+        default: 45,
+        describe: 'Gradient angle in degrees (0-360)'
+    })
+        .option('padding', {
+        type: 'number',
+        default: 40,
+        describe: 'Padding around QR code'
+    })
+        .option('cornerRadius', {
+        type: 'number',
+        default: 60,
+        describe: 'Background corner radius'
+    })
+        .example('$0 --url "https://example.com"', 'Generate basic QR code')
+        .example('$0 --url "https://example.com" --gradient', 'QR with gradient')
+        .example('$0 --url "https://example.com" --logo ./logo.png', 'QR with logo')
+        .help('h')
+        .alias('h', 'help')
+        .version()
+        .alias('v', 'version')
+        .strict();
+}
+/**
+ * Executes the CLI command
+ */
+export async function runCLI() {
+    try {
+        const argv = await buildCLI().argv;
+        // Extract output path and create options object for generator
+        const { out, ...options } = argv;
+        console.log(chalk.blue('🔄 Generating QR code...'));
+        const generator = new QRGenerator(options);
+        await generator.generateToFile(out);
+        console.log(chalk.green(`✅ QR code generated successfully: ${out}`));
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(chalk.red('❌ Error generating QR code:'), errorMessage);
+        process.exit(1);
+    }
+}
+// Run CLI if this file is executed directly
+const isMainModule = process.argv[1] === new URL(import.meta.url).pathname;
+if (isMainModule) {
+    runCLI();
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module qr-generator-styled
+ * @description A professional QR code generator library with advanced styling options
+ */
+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, 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

@@ -0,0 +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,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

@@ -0,0 +1,14 @@
+/**
+ * @module qr-generator-styled
+ * @description A professional QR code generator library with advanced styling options
+ */
+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

@@ -0,0 +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;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

@@ -0,0 +1,53 @@
+import { Canvas } from 'canvas';
+import { QROptions } from './utils/types.js';
+/**
+ * QR Code Generator with advanced styling options
+ */
+export declare class QRGenerator {
+    private options;
+    /**
+     * Creates a new QR generator instance
+     */
+    constructor(options: QROptions);
+    /**
+     * Generates QR code content from options
+     */
+    private getQRContent;
+    /**
+     * Generates QR code and returns the canvas
+     */
+    generate(): Promise<Canvas>;
+    /**
+     * Generates QR code and saves to file
+     */
+    generateToFile(outputPath: string): Promise<void>;
+    /**
+     * Generates QR code and returns buffer
+     */
+    generateToBuffer(format?: 'png' | 'jpeg'): Promise<Buffer>;
+    /**
+     * 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
+     */
+    updateOptions(options: Partial<QROptions>): void;
+}
+/**
+ * Helper function to quickly generate a QR code
+ */
+export declare function generateQR(options: QROptions): Promise<Canvas>;
+/**
+ * Helper function to quickly generate and save a QR code
+ */
+export declare function generateQRToFile(options: QROptions, outputPath: string): Promise<void>;
+//# sourceMappingURL=QRGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,150 @@
+import QRCode from 'qrcode';
+import { createCanvas } from 'canvas';
+import fs from 'fs';
+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
+ */
+export class QRGenerator {
+    /**
+     * Creates a new QR generator instance
+     */
+    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 { 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(content, {
+            errorCorrectionLevel
+        }); // margin option not in types but works
+        const modules = qrData.modules;
+        const moduleCount = modules.size;
+        const moduleSize = qrSize / moduleCount;
+        // Create canvas
+        const canvas = createCanvas(size, size);
+        const ctx = canvas.getContext('2d');
+        // Render background
+        const backgroundRenderer = new BackgroundRenderer(ctx, this.options);
+        backgroundRenderer.render();
+        backgroundRenderer.applyClipping();
+        // Create fill style (gradient or solid)
+        const gradientRenderer = new GradientRenderer(ctx, this.options);
+        const fillStyle = gradientRenderer.getFillStyle();
+        // Render QR modules with eye customization support
+        const moduleRenderer = new ModuleRenderer(ctx, modules, {
+            ...this.options,
+            color: foregroundColor, // Use new foregroundColor
+            moduleCount,
+            moduleSize
+        });
+        moduleRenderer.render(fillStyle);
+        backgroundRenderer.restoreClipping();
+        // Render logo if provided
+        if (this.options.logo) {
+            const logoRenderer = new LogoRenderer(ctx, this.options);
+            await logoRenderer.render(this.options.logo);
+        }
+        return canvas;
+    }
+    /**
+     * Generates QR code and saves to file
+     */
+    async generateToFile(outputPath) {
+        const canvas = await this.generate();
+        const buffer = canvas.toBuffer('image/png');
+        fs.writeFileSync(outputPath, buffer);
+    }
+    /**
+     * Generates QR code and returns buffer
+     */
+    async generateToBuffer(format = 'png') {
+        const canvas = await this.generate();
+        const mimeType = format === 'jpeg' ? 'image/jpeg' : 'image/png';
+        return canvas.toBuffer(mimeType);
+    }
+    /**
+     * Generates QR code and returns data URL
+     */
+    async generateToDataURL(format = 'png') {
+        const canvas = await this.generate();
+        if (format === 'jpeg') {
+            return canvas.toDataURL('image/jpeg');
+        }
+        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);
+    }
+}
+/**
+ * Helper function to quickly generate a QR code
+ */
+export async function generateQR(options) {
+    const generator = new QRGenerator(options);
+    return generator.generate();
+}
+/**
+ * Helper function to quickly generate and save a QR code
+ */
+export async function generateQRToFile(options, outputPath) {
+    const generator = new QRGenerator(options);
+    return generator.generateToFile(outputPath);
+}
+//# sourceMappingURL=QRGenerator.js.map

package/dist/lib/QRGenerator.js.map

@@ -0,0 +1 @@
+{"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":""}

package/dist/lib/QRGenerator.new-features.test.js

@@ -0,0 +1,235 @@
+import { describe, it, expect } from 'vitest';
+import { QRGenerator } from './QRGenerator.js';
+describe('QRGenerator - New Features', () => {
+    describe('Specialized QR Types', () => {
+        it('should generate vCard QR code', async () => {
+            const generator = new QRGenerator({
+                type: 'vcard',
+                data: {
+                    firstName: 'John',
+                    lastName: 'Doe',
+                    phone: '+1234567890',
+                    email: 'john@example.com'
+                },
+                size: 300
+            });
+            const buffer = await generator.generateToBuffer();
+            expect(buffer).toBeInstanceOf(Buffer);
+            expect(buffer.length).toBeGreaterThan(0);
+        });
+        it('should generate WiFi QR code', async () => {
+            const generator = new QRGenerator({
+                type: 'wifi',
+                data: {
+                    ssid: 'MyNetwork',
+                    password: 'SecurePass123',
+                    encryption: 'WPA'
+                },
+                size: 300
+            });
+            const buffer = await generator.generateToBuffer();
+            expect(buffer).toBeInstanceOf(Buffer);
+            expect(buffer.length).toBeGreaterThan(0);
+        });
+        it('should generate email QR code', async () => {
+            const generator = new QRGenerator({
+                type: 'email',
+                data: {
+                    email: 'contact@example.com',
+                    subject: 'Hello',
+                    body: 'Test message'
+                },
+                size: 300
+            });
+            const buffer = await generator.generateToBuffer();
+            expect(buffer).toBeInstanceOf(Buffer);
+            expect(buffer.length).toBeGreaterThan(0);
+        });
+        it('should generate SMS QR code', async () => {
+            const generator = new QRGenerator({
+                type: 'sms',
+                data: {
+                    phone: '+1234567890',
+                    message: 'Hello from QR'
+                },
+                size: 300
+            });
+            const buffer = await generator.generateToBuffer();
+            expect(buffer).toBeInstanceOf(Buffer);
+            expect(buffer.length).toBeGreaterThan(0);
+        });
+        it('should generate geo location QR code', async () => {
+            const generator = new QRGenerator({
+                type: 'geo',
+                data: {
+                    latitude: 40.7128,
+                    longitude: -74.006
+                },
+                size: 300
+            });
+            const buffer = await generator.generateToBuffer();
+            expect(buffer).toBeInstanceOf(Buffer);
+            expect(buffer.length).toBeGreaterThan(0);
+        });
+    });
+    describe('SVG Generation', () => {
+        it('should generate SVG QR code', async () => {
+            const generator = new QRGenerator({
+                url: 'https://example.com',
+                size: 300
+            });
+            const svg = await generator.generateToSVG();
+            expect(svg).toContain('<?xml');
+            expect(svg).toContain('<svg');
+            expect(svg).toContain('</svg>');
+            expect(svg).toContain('xmlns="http://www.w3.org/2000/svg"');
+        });
+        it('should include correct dimensions in SVG', async () => {
+            const generator = new QRGenerator({
+                url: 'https://test.com',
+                size: 500
+            });
+            const svg = await generator.generateToSVG();
+            expect(svg).toContain('width="500"');
+            expect(svg).toContain('height="500"');
+            expect(svg).toContain('viewBox="0 0 500 500"');
+        });
+        it('should apply colors in SVG', async () => {
+            const generator = new QRGenerator({
+                url: 'https://test.com',
+                size: 300,
+                foregroundColor: '#FF0000',
+                backgroundColor: '#FFFFFF'
+            });
+            const svg = await generator.generateToSVG();
+            expect(svg).toContain('#FF0000');
+            expect(svg).toContain('#FFFFFF');
+        });
+    });
+    describe('New Options', () => {
+        it('should support margin option', async () => {
+            const generator = new QRGenerator({
+                url: 'https://example.com',
+                size: 300,
+                margin: 2
+            });
+            const buffer = await generator.generateToBuffer();
+            expect(buffer).toBeInstanceOf(Buffer);
+        });
+        it('should support foregroundColor', async () => {
+            const generator = new QRGenerator({
+                url: 'https://example.com',
+                size: 300,
+                foregroundColor: '#0000FF'
+            });
+            const buffer = await generator.generateToBuffer();
+            expect(buffer).toBeInstanceOf(Buffer);
+        });
+        it('should support eye customization', async () => {
+            const generator = new QRGenerator({
+                url: 'https://example.com',
+                size: 300,
+                eyeColor: '#FF0000',
+                eyeRadius: 0.3
+            });
+            const buffer = await generator.generateToBuffer();
+            expect(buffer).toBeInstanceOf(Buffer);
+        });
+        it('should maintain backward compatibility with color option', async () => {
+            const generator = new QRGenerator({
+                url: 'https://example.com',
+                size: 300,
+                color: '#00FF00'
+            });
+            const buffer = await generator.generateToBuffer();
+            expect(buffer).toBeInstanceOf(Buffer);
+        });
+        it('should support logoSize and logoBackgroundColor', async () => {
+            const generator = new QRGenerator({
+                url: 'https://example.com',
+                size: 300,
+                logoSize: 80,
+                logoBackgroundColor: '#FFFFFF'
+            });
+            const buffer = await generator.generateToBuffer();
+            expect(buffer).toBeInstanceOf(Buffer);
+        });
+    });
+    describe('Validation', () => {
+        it('should reject vCard without name', () => {
+            expect(() => {
+                new QRGenerator({
+                    type: 'vcard',
+                    data: {} // No firstName or lastName
+                });
+            }).toThrow('vCard requires at least a first name or last name');
+        });
+        it('should reject WiFi without SSID', () => {
+            expect(() => {
+                new QRGenerator({
+                    type: 'wifi',
+                    data: {
+                        password: 'test'
+                    }
+                });
+            }).toThrow('WiFi QR code requires SSID');
+        });
+        it('should reject email without email address', () => {
+            expect(() => {
+                new QRGenerator({
+                    type: 'email',
+                    data: {}
+                });
+            }).toThrow('Email QR code requires email address');
+        });
+        it('should reject SMS without phone number', () => {
+            expect(() => {
+                new QRGenerator({
+                    type: 'sms',
+                    data: {}
+                });
+            }).toThrow('SMS QR code requires phone number');
+        });
+        it('should reject geo without coordinates', () => {
+            expect(() => {
+                new QRGenerator({
+                    type: 'geo',
+                    data: {}
+                });
+            }).toThrow('Geo QR code requires latitude and longitude');
+        });
+        it('should reject invalid margin', () => {
+            expect(() => {
+                new QRGenerator({
+                    url: 'https://test.com',
+                    margin: -1
+                });
+            }).toThrow('Margin must be between 0 and 10 modules');
+        });
+        it('should reject invalid eyeRadius', () => {
+            expect(() => {
+                new QRGenerator({
+                    url: 'https://test.com',
+                    eyeRadius: 1.5
+                });
+            }).toThrow('Eye radius must be between 0.0 and 0.5');
+        });
+        it('should reject invalid logoSize', () => {
+            expect(() => {
+                new QRGenerator({
+                    url: 'https://test.com',
+                    logoSize: 600
+                });
+            }).toThrow('Logo size must be between 50 and 500 pixels');
+        });
+        it('should reject specialized type without data', () => {
+            expect(() => {
+                new QRGenerator({
+                    type: 'wifi'
+                    // Missing data
+                });
+            }).toThrow('URL, text content, or structured data is required');
+        });
+    });
+});
+//# sourceMappingURL=QRGenerator.new-features.test.js.map