@connectedxm/zpl-generator 0.0.4-beta.1 → 0.0.4-beta.10

package/dist/src/generate.d.ts

@@ -2,26 +2,14 @@ import { Badge, Field, TextField } from './validate';
 import { SourceData } from './interfaces';
 export declare function generate(badge: Badge, data?: SourceData): string;
 export declare function getFieldValue(field: Field, data?: SourceData): string | undefined;
-/**
- * ZPL ^FB blocks have no vertical alignment — text always starts at line 1.
- * To simulate "end" (bottom) alignment, we count how many lines the data
- * will occupy and prepend empty ZPL line breaks (\&) to push it down.
- *
- * Two counting strategies:
- *   - wordWidths provided: simulate word-wrap using pre-measured pixel widths
- *   - wordWidths omitted: approximate chars per line from maxWidth / fontHeight
- */
-export declare function applyVerticalAlignment(field: TextField, value: string): string;
 /**
  * Counts how many lines the field data will occupy inside a ^FB field.
  * Exported so consuming projects (e.g. React label previews) can reuse
  * the same logic to stay in sync with the generator.
  *
- * When wordWidths are provided, simulates ZPL word-wrap: words are placed
- * on the current line until the next word would exceed maxWidth, then a
- * new line is started. Explicit \& breaks always start a new line.
+ * When measuredWidth is provided (total rendered width in dots, as measured
+ * by the consumer), line count is estimated via ceil(measuredWidth / maxWidth).
  *
- * When wordWidths are not provided, falls back to a character-width
- * heuristic using fontHeight.
+ * Otherwise falls back to a character-width heuristic using charsPerLine.
  */
 export declare function countLines(field: TextField, value: string): number;

package/dist/src/validate.d.ts

@@ -238,7 +238,9 @@ export declare const textFieldSchema: z.ZodObject<{
         readonly passAttributes: "passAttributes";
     }>;
     sourceLookup: z.ZodString;
+    sourceSeperator: z.ZodString;
     hideEmpty: z.ZodBoolean;
+    editable: z.ZodBoolean;
     type: z.ZodLiteral<"text">;
     font: z.ZodString;
     fontOrientation: z.ZodEnum<{
@@ -270,6 +272,7 @@ export declare const textFieldSchema: z.ZodObject<{
         readonly Capitalize: "Capitalize";
     }>;
     maxCharacters: z.ZodNumber;
+    measuredWidth: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type TextField = z.infer<typeof textFieldSchema>;
 export declare const barcodeFieldSchema: z.ZodObject<{
@@ -286,7 +289,9 @@ export declare const barcodeFieldSchema: z.ZodObject<{
         readonly passAttributes: "passAttributes";
     }>;
     sourceLookup: z.ZodString;
+    sourceSeperator: z.ZodString;
     hideEmpty: z.ZodBoolean;
+    editable: z.ZodBoolean;
     type: z.ZodLiteral<"barcode">;
     barWidth: z.ZodNumber;
     orientation: z.ZodEnum<{
@@ -324,7 +329,9 @@ export declare const qrcodeFieldSchema: z.ZodObject<{
         readonly passAttributes: "passAttributes";
     }>;
     sourceLookup: z.ZodString;
+    sourceSeperator: z.ZodString;
     hideEmpty: z.ZodBoolean;
+    editable: z.ZodBoolean;
     type: z.ZodLiteral<"qrcode">;
     orientation: z.ZodLiteral<"N">;
     model: z.ZodLiteral<"2">;
@@ -352,7 +359,9 @@ export declare const fieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         readonly passAttributes: "passAttributes";
     }>;
     sourceLookup: z.ZodString;
+    sourceSeperator: z.ZodString;
     hideEmpty: z.ZodBoolean;
+    editable: z.ZodBoolean;
     type: z.ZodLiteral<"text">;
     font: z.ZodString;
     fontOrientation: z.ZodEnum<{
@@ -384,6 +393,7 @@ export declare const fieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         readonly Capitalize: "Capitalize";
     }>;
     maxCharacters: z.ZodNumber;
+    measuredWidth: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
     name: z.ZodString;
     x: z.ZodNumber;
@@ -398,7 +408,9 @@ export declare const fieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         readonly passAttributes: "passAttributes";
     }>;
     sourceLookup: z.ZodString;
+    sourceSeperator: z.ZodString;
     hideEmpty: z.ZodBoolean;
+    editable: z.ZodBoolean;
     type: z.ZodLiteral<"barcode">;
     barWidth: z.ZodNumber;
     orientation: z.ZodEnum<{
@@ -434,7 +446,9 @@ export declare const fieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         readonly passAttributes: "passAttributes";
     }>;
     sourceLookup: z.ZodString;
+    sourceSeperator: z.ZodString;
     hideEmpty: z.ZodBoolean;
+    editable: z.ZodBoolean;
     type: z.ZodLiteral<"qrcode">;
     orientation: z.ZodLiteral<"N">;
     model: z.ZodLiteral<"2">;
@@ -448,6 +462,11 @@ export declare const fieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     mask: z.ZodNumber;
 }, z.core.$strip>], "type">;
 export type Field = z.infer<typeof fieldSchema>;
+export declare const fontSchema: z.ZodObject<{
+    name: z.ZodString;
+    alias: z.ZodString;
+}, z.core.$strip>;
+export type Font = z.infer<typeof fontSchema>;
 export declare const badgeSchema: z.ZodObject<{
     type: z.ZodLiteral<"thermal">;
     tearOffAdjustment: z.ZodNumber;
@@ -535,7 +554,9 @@ export declare const badgeSchema: z.ZodObject<{
             readonly passAttributes: "passAttributes";
         }>;
         sourceLookup: z.ZodString;
+        sourceSeperator: z.ZodString;
         hideEmpty: z.ZodBoolean;
+        editable: z.ZodBoolean;
         type: z.ZodLiteral<"text">;
         font: z.ZodString;
         fontOrientation: z.ZodEnum<{
@@ -567,6 +588,7 @@ export declare const badgeSchema: z.ZodObject<{
             readonly Capitalize: "Capitalize";
         }>;
         maxCharacters: z.ZodNumber;
+        measuredWidth: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
         name: z.ZodString;
         x: z.ZodNumber;
@@ -581,7 +603,9 @@ export declare const badgeSchema: z.ZodObject<{
             readonly passAttributes: "passAttributes";
         }>;
         sourceLookup: z.ZodString;
+        sourceSeperator: z.ZodString;
         hideEmpty: z.ZodBoolean;
+        editable: z.ZodBoolean;
         type: z.ZodLiteral<"barcode">;
         barWidth: z.ZodNumber;
         orientation: z.ZodEnum<{
@@ -617,7 +641,9 @@ export declare const badgeSchema: z.ZodObject<{
             readonly passAttributes: "passAttributes";
         }>;
         sourceLookup: z.ZodString;
+        sourceSeperator: z.ZodString;
         hideEmpty: z.ZodBoolean;
+        editable: z.ZodBoolean;
         type: z.ZodLiteral<"qrcode">;
         orientation: z.ZodLiteral<"N">;
         model: z.ZodLiteral<"2">;
@@ -630,6 +656,10 @@ export declare const badgeSchema: z.ZodObject<{
         }>;
         mask: z.ZodNumber;
     }, z.core.$strip>], "type">>;
+    fonts: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        alias: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type Badge = z.infer<typeof badgeSchema>;
 export type ThermalBadge = Badge;
@@ -679,7 +709,9 @@ export declare function validateBadge(data: Badge): z.ZodSafeParseResult<{
         defaultValue: string;
         sourceType: "account" | "accountAttributes" | "accountTiers" | "pass" | "passResponses" | "passAttributes";
         sourceLookup: string;
+        sourceSeperator: string;
         hideEmpty: boolean;
+        editable: boolean;
         type: "text";
         font: string;
         fontOrientation: "N" | "B" | "I" | "R";
@@ -693,6 +725,7 @@ export declare function validateBadge(data: Badge): z.ZodSafeParseResult<{
         charsPerLine: number;
         transformation: "None" | "Uppercase" | "Lowercase" | "Capitalize";
         maxCharacters: number;
+        measuredWidth?: number | undefined;
     } | {
         name: string;
         x: number;
@@ -700,7 +733,9 @@ export declare function validateBadge(data: Badge): z.ZodSafeParseResult<{
         defaultValue: string;
         sourceType: "account" | "accountAttributes" | "accountTiers" | "pass" | "passResponses" | "passAttributes";
         sourceLookup: string;
+        sourceSeperator: string;
         hideEmpty: boolean;
+        editable: boolean;
         type: "barcode";
         barWidth: number;
         orientation: "N" | "B" | "I" | "R";
@@ -715,7 +750,9 @@ export declare function validateBadge(data: Badge): z.ZodSafeParseResult<{
         defaultValue: string;
         sourceType: "account" | "accountAttributes" | "accountTiers" | "pass" | "passResponses" | "passAttributes";
         sourceLookup: string;
+        sourceSeperator: string;
         hideEmpty: boolean;
+        editable: boolean;
         type: "qrcode";
         orientation: "N";
         model: "2";
@@ -723,6 +760,10 @@ export declare function validateBadge(data: Badge): z.ZodSafeParseResult<{
         errorCorrection: "M" | "L" | "H" | "Q";
         mask: number;
     })[];
+    fonts: {
+        name: string;
+        alias: string;
+    }[];
 }>;
 /**
  * Validates a JSON object against the Badge schema and throws on error.
@@ -760,7 +801,9 @@ export declare function validateBadgeOrThrow(data: Badge): {
         defaultValue: string;
         sourceType: "account" | "accountAttributes" | "accountTiers" | "pass" | "passResponses" | "passAttributes";
         sourceLookup: string;
+        sourceSeperator: string;
         hideEmpty: boolean;
+        editable: boolean;
         type: "text";
         font: string;
         fontOrientation: "N" | "B" | "I" | "R";
@@ -774,6 +817,7 @@ export declare function validateBadgeOrThrow(data: Badge): {
         charsPerLine: number;
         transformation: "None" | "Uppercase" | "Lowercase" | "Capitalize";
         maxCharacters: number;
+        measuredWidth?: number | undefined;
     } | {
         name: string;
         x: number;
@@ -781,7 +825,9 @@ export declare function validateBadgeOrThrow(data: Badge): {
         defaultValue: string;
         sourceType: "account" | "accountAttributes" | "accountTiers" | "pass" | "passResponses" | "passAttributes";
         sourceLookup: string;
+        sourceSeperator: string;
         hideEmpty: boolean;
+        editable: boolean;
         type: "barcode";
         barWidth: number;
         orientation: "N" | "B" | "I" | "R";
@@ -796,7 +842,9 @@ export declare function validateBadgeOrThrow(data: Badge): {
         defaultValue: string;
         sourceType: "account" | "accountAttributes" | "accountTiers" | "pass" | "passResponses" | "passAttributes";
         sourceLookup: string;
+        sourceSeperator: string;
         hideEmpty: boolean;
+        editable: boolean;
         type: "qrcode";
         orientation: "N";
         model: "2";
@@ -804,4 +852,8 @@ export declare function validateBadgeOrThrow(data: Badge): {
         errorCorrection: "M" | "L" | "H" | "Q";
         mask: number;
     })[];
+    fonts: {
+        name: string;
+        alias: string;
+    }[];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@connectedxm/zpl-generator",
-  "version": "0.0.4-beta.1",
+  "version": "0.0.4-beta.10",
   "description": "",
   "license": "ISC",
   "author": "",