qrlayout-core 1.0.5 → 1.0.7

package/README.md

@@ -9,7 +9,7 @@ A powerful, framework-agnostic QR code layout engine for designing and printing
 
 -  **Precise Layouts**: Define stickers in `mm`, `cm`, `in`, or `px`.
 -  **Multiple Formats**: Export to Canvas (preview), PNG/JPEG (image), PDF (print), or ZPL (industrial thermal printers).
--  **Dynamic Content**: Use variable placeholders (e.g., `{{name}}`, `{{sku}}`) to batch generate unique stickers.
+-  **Dynamic Content**: Use variable placeholders (e.g., `{{name}}`, `{{visitorId}}`) to batch generate unique stickers.
 -  **Lightweight**: Minimal dependencies. PDF export is optional to keep bundle size small.
 
 ## Keywords
@@ -125,19 +125,32 @@ pdfDoc.save("badges.pdf");
 
 | Property | Type | Description |
 |----------|------|-------------|
+| `id` | `string` | Unique identifier for the layout. |
+| `name` | `string` | Human-readable name of the layout. |
 | `width` | `number` | Width of the sticker. |
 | `height` | `number` | Height of the sticker. |
 | `unit` | `"mm" \| "cm" \| "in" \| "px"` | Unit of measurement. |
 | `elements` | `StickerElement[]` | List of items on the sticker. |
+| `backgroundColor` | `string` | (Optional) Background color hex. |
+| `backgroundImage` | `string` | (Optional) Background image URL. |
 
 ### `StickerElement` Interface
 
 | Property | Type | Description |
 |----------|------|-------------|
+| `id` | `string` | Unique identifier for the element. |
 | `type` | `"text" \| "qr"` | Type of element. |
 | `x`, `y` | `number` | Position from top-left. |
 | `w`, `h` | `number` | Width and height. |
 | `content` | `string` | Text, URL, source. Supports `{{key}}` syntax. |
+| `qrSeparator` | `string` | (Optional) Separator used to join consecutive `{{variables}}` (e.g., `|`, `,`). |
+| `style.fontFamily` | `string` | Font family (e.g., 'sans-serif', 'Inter'). |
+| `style.fontSize` | `number` | Font size (px). |
+| `style.fontWeight` | `string \| number` | Font weight (e.g., 'bold', 700). |
+| `style.textAlign` | `"left" \| "center" \| "right"` | Horizontal alignment. |
+| `style.verticalAlign` | `"top" \| "middle" \| "bottom"` | Vertical alignment. |
+| `style.color` | `string` | Text color hex code. |
+| `style.backgroundColor` | `string` | Background color for the element. |
 
 ## License
 

package/dist/layout/schema.d.ts

@@ -17,6 +17,7 @@ export interface StickerElement {
     w: number;
     h: number;
     content: string;
+    qrSeparator?: string;
     style?: ElementStyle;
 }
 export type StickerData = Record<string, unknown>;

package/dist/pdf.js

@@ -1,7 +1,11 @@
 import jsPDF from "jspdf";
 import { generateQR } from "./qr/generator";
-function parseContent(content, data) {
-    return content.replace(/\{\{(.*?)\}\}/g, (_, key) => {
+function parseContent(content, data, separator) {
+    let processed = content;
+    if (separator) {
+        processed = processed.replace(/\}\}\s*\{\{/g, `}}${separator}{{`);
+    }
+    return processed.replace(/\{\{(.*?)\}\}/g, (_, key) => {
         const trimmedKey = String(key).trim();
         return data[trimmedKey] !== undefined ? String(data[trimmedKey]) : "";
     });
@@ -51,7 +55,7 @@ export async function exportToPDF(layout, dataList) {
             }
         }
         for (const element of layout.elements) {
-            const filledContent = parseContent(element.content, data);
+            const filledContent = parseContent(element.content, data, element.type === "qr" ? element.qrSeparator : undefined);
             const { x, y, w, h } = element;
             if (element.type === "qr") {
                 if (filledContent) {

package/dist/printer/StickerPrinter.js

@@ -12,8 +12,13 @@ export class StickerPrinter {
         }
     }
     // Parse variable content like "{{name}}"
-    parseContent(content, data) {
-        return content.replace(/\{\{(.*?)\}\}/g, (_, key) => {
+    parseContent(content, data, separator) {
+        let processed = content;
+        if (separator) {
+            // Replace spaces between braces or just consecutive braces with the separator
+            processed = processed.replace(/\}\}\s*\{\{/g, `}}${separator}{{`);
+        }
+        return processed.replace(/\{\{(.*?)\}\}/g, (_, key) => {
             const trimmedKey = key.trim();
             return data[trimmedKey] !== undefined ? String(data[trimmedKey]) : "";
         });
@@ -41,7 +46,7 @@ export class StickerPrinter {
             const y = this.toPx(element.y, layout.unit);
             const w = this.toPx(element.w, layout.unit);
             const h = this.toPx(element.h, layout.unit);
-            const filledContent = this.parseContent(element.content, data);
+            const filledContent = this.parseContent(element.content, data, element.type === "qr" ? element.qrSeparator : undefined);
             if (element.type === "qr") {
                 if (filledContent) {
                     const qrUrl = await generateQR(filledContent);
@@ -153,7 +158,7 @@ export class StickerPrinter {
             zpl += `^PW${widthDots}\n`;
             zpl += `^LL${heightDots}\n`;
             for (const element of layout.elements) {
-                const filledContent = this.parseContent(element.content, data);
+                const filledContent = this.parseContent(element.content, data, element.type === "qr" ? element.qrSeparator : undefined);
                 const x = toDots(element.x, layout.unit);
                 const y = toDots(element.y, layout.unit);
                 zpl += `^FO${x},${y}`;

package/package.json

@@ -1,20 +1,19 @@
 {
   "name": "qrlayout-core",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "QR code layout builder, renderer, and exporter for stickers, labels, and PDFs",
   "keywords": [
     "qr",
     "qrcode",
     "qr-code",
-    "qr code",
+    "qr-layout",
+    "qr-layout-designer",
     "layout",
-    "sticker",
-    "label",
+    "qr-sticker",
+    "qr-label",
     "generator",
     "renderer",
-    "pdf",
     "zpl",
-    "barcode",
     "thermal-printer"
   ],
   "author": "Shashidhar Naik <shashidharnaik8@gmail.com>",
@@ -57,8 +56,7 @@
     "jspdf": "^3.0.4"
   },
   "devDependencies": {
-    "@types/jspdf": "^1.3.3",
     "@types/qrcode": "^1.5.6",
     "typescript": "^5.3.3"
   }
-}
+}