@connectedxm/zpl-generator 0.0.14 → 0.0.17

package/dist/src/generate.d.ts

@@ -4,6 +4,15 @@ export declare function generate(badge: Badge, data?: SourceData, overrides?: {
     [key: string]: string;
 }): string;
 export declare function getFieldValue(field: Field, data?: SourceData): string | undefined;
+/**
+ * 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
+ * reference at which `measuredWidth` and `charsPerLine` were captured.
+ *
+ * Width scales linearly with height: at half the height, each glyph is
+ * roughly half as wide, so twice as many characters fit per line.
+ */
+export declare function countLinesAtHeight(field: TextField, value: string, height: number): number;
 /**
  * Counts how many lines the field data will occupy inside a ^FB field.
  * Exported so consuming projects (e.g. React label previews) can reuse
@@ -15,3 +24,10 @@ export declare function getFieldValue(field: Field, data?: SourceData): string |
  * Otherwise falls back to a character-width heuristic using charsPerLine.
  */
 export declare function countLines(field: TextField, value: string): number;
+/**
+ * Returns the largest font height ≤ `field.fontHeight` (and ≥
+ * `field.minFontHeight ?? 1`) at which the rendered text fits within
+ * `field.maxLines`. If even the minimum height cannot make the text fit,
+ * returns the minimum (text will overflow at the smallest allowed size).
+ */
+export declare function calculateFittedFontHeight(field: TextField, value: string): number;

package/dist/src/validate.d.ts

@@ -273,6 +273,7 @@ export declare const textFieldSchema: z.ZodObject<{
     }>;
     maxCharacters: z.ZodNumber;
     measuredWidth: z.ZodOptional<z.ZodNumber>;
+    minFontHeight: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type TextField = z.infer<typeof textFieldSchema>;
 export declare const barcodeFieldSchema: z.ZodObject<{
@@ -427,6 +428,7 @@ export declare const fieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>;
     maxCharacters: z.ZodNumber;
     measuredWidth: z.ZodOptional<z.ZodNumber>;
+    minFontHeight: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
     name: z.ZodString;
     x: z.ZodNumber;
@@ -682,6 +684,7 @@ export declare const badgeSchema: z.ZodObject<{
         }>;
         maxCharacters: z.ZodNumber;
         measuredWidth: z.ZodOptional<z.ZodNumber>;
+        minFontHeight: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
         name: z.ZodString;
         x: z.ZodNumber;
@@ -864,6 +867,7 @@ export declare function validateBadge(data: Badge): z.ZodSafeParseResult<{
         transformation: "None" | "Uppercase" | "Lowercase" | "Capitalize";
         maxCharacters: number;
         measuredWidth?: number | undefined;
+        minFontHeight?: number | undefined;
     } | {
         name: string;
         x: number;
@@ -971,6 +975,7 @@ export declare function validateBadgeOrThrow(data: Badge): {
         transformation: "None" | "Uppercase" | "Lowercase" | "Capitalize";
         maxCharacters: number;
         measuredWidth?: number | undefined;
+        minFontHeight?: number | undefined;
     } | {
         name: string;
         x: number;

package/package.json

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