@connectedxm/zpl-generator 0.0.20 → 0.0.21

package/dist/src/generate.d.ts

@@ -4,6 +4,14 @@ export declare function generate(badge: Badge, data?: SourceData, overrides?: {
     [key: string]: string;
 }): string;
 export declare function getFieldValue(field: Field, data?: SourceData): string | undefined;
+export declare function applyTextTransformation(field: TextField, value: string): string;
+/**
+ * Splits a field value the way the printer lays it out: explicit \& breaks
+ * delimit segments, whitespace delimits words within a segment. Exported so
+ * consumers measuring word widths (e.g. injectMeasuredWidths) tokenize
+ * identically to the wrap simulation in countLinesAtHeight.
+ */
+export declare function tokenizeWords(value: string): string[][];
 /**
  * Counts how many lines the field data will occupy inside a ^FB field at
  * a given font height. The field's own `fontHeight` is treated as the
@@ -18,10 +26,9 @@ export declare function countLinesAtHeight(field: TextField, value: string, heig
  * Exported so consuming projects (e.g. React label previews) can reuse
  * the same logic to stay in sync with the generator.
  *
- * When measuredWidth is provided (total rendered width in dots, as measured
- * by the consumer), line count is estimated via ceil(measuredWidth / maxWidth).
- *
- * Otherwise falls back to a character-width heuristic using charsPerLine.
+ * Priority: wordWidths (exact ^FB word-wrap simulation, when the measured
+ * words match the rendered value) → measuredWidth (continuous-stream
+ * estimate) → charsPerLine heuristic.
  */
 export declare function countLines(field: TextField, value: string): number;
 /**

package/dist/src/validate.d.ts

@@ -287,6 +287,11 @@ export declare const textFieldSchema: z.ZodObject<{
     }>;
     maxCharacters: z.ZodNumber;
     measuredWidth: z.ZodOptional<z.ZodNumber>;
+    wordWidths: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        word: z.ZodString;
+        width: z.ZodNumber;
+        spaceWidth: z.ZodNumber;
+    }, z.core.$strip>>>;
     minFontHeight: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type TextField = z.infer<typeof textFieldSchema>;
@@ -452,6 +457,11 @@ export declare const fieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>;
     maxCharacters: z.ZodNumber;
     measuredWidth: z.ZodOptional<z.ZodNumber>;
+    wordWidths: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        word: z.ZodString;
+        width: z.ZodNumber;
+        spaceWidth: z.ZodNumber;
+    }, z.core.$strip>>>;
     minFontHeight: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
     name: z.ZodString;
@@ -718,6 +728,11 @@ export declare const badgeSchema: z.ZodObject<{
         }>;
         maxCharacters: z.ZodNumber;
         measuredWidth: z.ZodOptional<z.ZodNumber>;
+        wordWidths: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            word: z.ZodString;
+            width: z.ZodNumber;
+            spaceWidth: z.ZodNumber;
+        }, z.core.$strip>>>;
         minFontHeight: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
         name: z.ZodString;
@@ -910,6 +925,11 @@ export declare function validateBadge(data: Badge): z.ZodSafeParseResult<{
         transformation: "None" | "Uppercase" | "Lowercase" | "Capitalize";
         maxCharacters: number;
         measuredWidth?: number | undefined;
+        wordWidths?: {
+            word: string;
+            width: number;
+            spaceWidth: number;
+        }[] | undefined;
         minFontHeight?: number | undefined;
     } | {
         name: string;
@@ -1020,6 +1040,11 @@ export declare function validateBadgeOrThrow(data: Badge): {
         transformation: "None" | "Uppercase" | "Lowercase" | "Capitalize";
         maxCharacters: number;
         measuredWidth?: number | undefined;
+        wordWidths?: {
+            word: string;
+            width: number;
+            spaceWidth: number;
+        }[] | undefined;
         minFontHeight?: number | undefined;
     } | {
         name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@connectedxm/zpl-generator",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "description": "",
   "license": "ISC",
   "author": "",