@connectedxm/zpl-generator 0.0.1 → 0.0.2-beta.3

package/dist/index.es.js

@@ -130,10 +130,10 @@ class O extends Error {
         else if (i.path.length === 0)
           r._errors.push(t(i));
         else {
-          let o = r, h = 0;
-          for (; h < i.path.length; ) {
-            const f = i.path[h];
-            h === i.path.length - 1 ? (o[f] = o[f] || { _errors: [] }, o[f]._errors.push(t(i))) : o[f] = o[f] || { _errors: [] }, o = o[f], h++;
+          let o = r, f = 0;
+          for (; f < i.path.length; ) {
+            const h = i.path[f];
+            f === i.path.length - 1 ? (o[h] = o[h] || { _errors: [] }, o[h]._errors.push(t(i))) : o[h] = o[h] || { _errors: [] }, o = o[h], f++;
           }
         }
     };
@@ -239,9 +239,9 @@ const Me = (n) => {
       message: s.message
     };
   let o = "";
-  const h = r.filter((f) => !!f).slice().reverse();
-  for (const f of h)
-    o = f(i, { data: e, defaultError: o }).message;
+  const f = r.filter((h) => !!h).slice().reverse();
+  for (const h of f)
+    o = h(i, { data: e, defaultError: o }).message;
   return {
     ...s,
     path: a,
@@ -266,7 +266,7 @@ function c(n, e) {
   });
   n.common.issues.push(r);
 }
-class b {
+class w {
   constructor() {
     this.value = "valid";
   }
@@ -294,7 +294,7 @@ class b {
         value: i
       });
     }
-    return b.mergeObjectSync(e, r);
+    return w.mergeObjectSync(e, r);
   }
   static mergeObjectSync(e, t) {
     const r = {};
@@ -344,8 +344,8 @@ function g(n) {
   if (e && (t || r))
     throw new Error(`Can't use "invalid_type_error" or "required_error" in conjunction with custom error map.`);
   return e ? { errorMap: e, description: s } : { errorMap: (i, o) => {
-    const { message: h } = n;
-    return i.code === "invalid_enum_value" ? { message: h ?? o.defaultError } : typeof o.data > "u" ? { message: h ?? r ?? o.defaultError } : i.code !== "invalid_type" ? { message: o.defaultError } : { message: h ?? t ?? o.defaultError };
+    const { message: f } = n;
+    return i.code === "invalid_enum_value" ? { message: f ?? o.defaultError } : typeof o.data > "u" ? { message: f ?? r ?? o.defaultError } : i.code !== "invalid_type" ? { message: o.defaultError } : { message: f ?? t ?? o.defaultError };
   }, description: s };
 }
 class _ {
@@ -367,7 +367,7 @@ class _ {
   }
   _processInputParams(e) {
     return {
-      status: new b(),
+      status: new w(),
       ctx: {
         common: e.parent.common,
         data: e.data,
@@ -469,7 +469,7 @@ class _ {
         code: d.custom,
         ...r(s)
       });
-      return typeof Promise < "u" && i instanceof Promise ? i.then((h) => h ? !0 : (o(), !1)) : i ? !0 : (o(), !1);
+      return typeof Promise < "u" && i instanceof Promise ? i.then((f) => f ? !0 : (o(), !1)) : i ? !0 : (o(), !1);
     });
   }
   refinement(e, t) {
@@ -612,7 +612,7 @@ class R extends _ {
         received: a.parsedType
       }), m;
     }
-    const r = new b();
+    const r = new w();
     let s;
     for (const a of this._def.checks)
       if (a.kind === "min")
@@ -1003,7 +1003,7 @@ class B extends _ {
       }), m;
     }
     let r;
-    const s = new b();
+    const s = new w();
     for (const a of this._def.checks)
       a.kind === "int" ? v.isInteger(e.data) || (r = this._getOrReturnCtx(e, r), c(r, {
         code: d.invalid_type,
@@ -1175,7 +1175,7 @@ class z extends _ {
     if (this._getType(e) !== u.bigint)
       return this._getInvalidInput(e);
     let r;
-    const s = new b();
+    const s = new w();
     for (const a of this._def.checks)
       a.kind === "min" ? (a.inclusive ? e.data < a.value : e.data <= a.value) && (r = this._getOrReturnCtx(e, r), c(r, {
         code: d.too_small,
@@ -1328,7 +1328,7 @@ class q extends _ {
         code: d.invalid_date
       }), m;
     }
-    const r = new b();
+    const r = new w();
     let s;
     for (const a of this._def.checks)
       a.kind === "min" ? e.data.getTime() < a.value && (s = this._getOrReturnCtx(e, s), c(s, {
@@ -1453,7 +1453,7 @@ ke.create = (n) => new ke({
   typeName: p.ZodAny,
   ...g(n)
 });
-class we extends _ {
+class be extends _ {
   constructor() {
     super(...arguments), this._unknown = !0;
   }
@@ -1461,7 +1461,7 @@ class we extends _ {
     return S(e.data);
   }
 }
-we.create = (n) => new we({
+be.create = (n) => new be({
   typeName: p.ZodUnknown,
   ...g(n)
 });
@@ -1479,7 +1479,7 @@ j.create = (n) => new j({
   typeName: p.ZodNever,
   ...g(n)
 });
-class be extends _ {
+class we extends _ {
   _parse(e) {
     if (this._getType(e) !== u.undefined) {
       const r = this._getOrReturnCtx(e);
@@ -1492,7 +1492,7 @@ class be extends _ {
     return S(e.data);
   }
 }
-be.create = (n) => new be({
+we.create = (n) => new we({
   typeName: p.ZodVoid,
   ...g(n)
 });
@@ -1532,9 +1532,9 @@ class T extends _ {
       exact: !1,
       message: s.maxLength.message
     }), r.dirty()), t.common.async)
-      return Promise.all([...t.data].map((i, o) => s.type._parseAsync(new Z(t, i, t.path, o)))).then((i) => b.mergeArray(r, i));
+      return Promise.all([...t.data].map((i, o) => s.type._parseAsync(new Z(t, i, t.path, o)))).then((i) => w.mergeArray(r, i));
     const a = [...t.data].map((i, o) => s.type._parseSync(new Z(t, i, t.path, o)));
-    return b.mergeArray(r, a);
+    return w.mergeArray(r, a);
   }
   get element() {
     return this._def.type;
@@ -1597,47 +1597,47 @@ class k extends _ {
   }
   _parse(e) {
     if (this._getType(e) !== u.object) {
-      const f = this._getOrReturnCtx(e);
-      return c(f, {
+      const h = this._getOrReturnCtx(e);
+      return c(h, {
         code: d.invalid_type,
         expected: u.object,
-        received: f.parsedType
+        received: h.parsedType
       }), m;
     }
     const { status: r, ctx: s } = this._processInputParams(e), { shape: a, keys: i } = this._getCached(), o = [];
     if (!(this._def.catchall instanceof j && this._def.unknownKeys === "strip"))
-      for (const f in s.data)
-        i.includes(f) || o.push(f);
-    const h = [];
-    for (const f of i) {
-      const y = a[f], C = s.data[f];
-      h.push({
-        key: { status: "valid", value: f },
-        value: y._parse(new Z(s, C, s.path, f)),
-        alwaysSet: f in s.data
+      for (const h in s.data)
+        i.includes(h) || o.push(h);
+    const f = [];
+    for (const h of i) {
+      const y = a[h], C = s.data[h];
+      f.push({
+        key: { status: "valid", value: h },
+        value: y._parse(new Z(s, C, s.path, h)),
+        alwaysSet: h in s.data
       });
     }
     if (this._def.catchall instanceof j) {
-      const f = this._def.unknownKeys;
-      if (f === "passthrough")
+      const h = this._def.unknownKeys;
+      if (h === "passthrough")
         for (const y of o)
-          h.push({
+          f.push({
             key: { status: "valid", value: y },
             value: { status: "valid", value: s.data[y] }
           });
-      else if (f === "strict")
+      else if (h === "strict")
         o.length > 0 && (c(s, {
           code: d.unrecognized_keys,
           keys: o
         }), r.dirty());
-      else if (f !== "strip") throw new Error("Internal ZodObject error: invalid unknownKeys value.");
+      else if (h !== "strip") throw new Error("Internal ZodObject error: invalid unknownKeys value.");
     } else {
-      const f = this._def.catchall;
+      const h = this._def.catchall;
       for (const y of o) {
         const C = s.data[y];
-        h.push({
+        f.push({
           key: { status: "valid", value: y },
-          value: f._parse(
+          value: h._parse(
             new Z(s, C, s.path, y)
             //, ctx.child(key), value, getParsedType(value)
           ),
@@ -1646,17 +1646,17 @@ class k extends _ {
       }
     }
     return s.common.async ? Promise.resolve().then(async () => {
-      const f = [];
-      for (const y of h) {
+      const h = [];
+      for (const y of f) {
         const C = await y.key, ne = await y.value;
-        f.push({
+        h.push({
           key: C,
           value: ne,
           alwaysSet: y.alwaysSet
         });
       }
-      return f;
-    }).then((f) => b.mergeObjectSync(r, f)) : b.mergeObjectSync(r, h);
+      return h;
+    }).then((h) => w.mergeObjectSync(r, h)) : w.mergeObjectSync(r, f);
   }
   get shape() {
     return this._def.shape();
@@ -1910,26 +1910,26 @@ class H extends _ {
     {
       let a;
       const i = [];
-      for (const h of r) {
-        const f = {
+      for (const f of r) {
+        const h = {
           ...t,
           common: {
             ...t.common,
             issues: []
           },
           parent: null
-        }, y = h._parseSync({
+        }, y = f._parseSync({
           data: t.data,
           path: t.path,
-          parent: f
+          parent: h
         });
         if (y.status === "valid")
           return y;
-        y.status === "dirty" && !a && (a = { result: y, ctx: f }), f.common.issues.length && i.push(f.common.issues);
+        y.status === "dirty" && !a && (a = { result: y, ctx: h }), h.common.issues.length && i.push(h.common.issues);
       }
       if (a)
         return t.common.issues.push(...a.ctx.common.issues), a.result;
-      const o = i.map((h) => new O(h));
+      const o = i.map((f) => new O(f));
       return c(t, {
         code: d.invalid_union,
         unionErrors: o
@@ -2015,10 +2015,10 @@ function de(n, e) {
   if (t === u.object && r === u.object) {
     const s = v.objectKeys(e), a = v.objectKeys(n).filter((o) => s.indexOf(o) !== -1), i = { ...n, ...e };
     for (const o of a) {
-      const h = de(n[o], e[o]);
-      if (!h.valid)
+      const f = de(n[o], e[o]);
+      if (!f.valid)
         return { valid: !1 };
-      i[o] = h.data;
+      i[o] = f.data;
     }
     return { valid: !0, data: i };
   } else if (t === u.array && r === u.array) {
@@ -2026,10 +2026,10 @@ function de(n, e) {
       return { valid: !1 };
     const s = [];
     for (let a = 0; a < n.length; a++) {
-      const i = n[a], o = e[a], h = de(i, o);
-      if (!h.valid)
+      const i = n[a], o = e[a], f = de(i, o);
+      if (!f.valid)
         return { valid: !1 };
-      s.push(h.data);
+      s.push(f.data);
     }
     return { valid: !0, data: s };
   } else return t === u.date && r === u.date && +n == +e ? { valid: !0, data: n } : { valid: !1 };
@@ -2097,10 +2097,10 @@ class E extends _ {
       type: "array"
     }), t.dirty());
     const a = [...r.data].map((i, o) => {
-      const h = this._def.items[o] || this._def.rest;
-      return h ? h._parse(new Z(r, i, r.path, o)) : null;
+      const f = this._def.items[o] || this._def.rest;
+      return f ? f._parse(new Z(r, i, r.path, o)) : null;
     }).filter((i) => !!i);
-    return r.common.async ? Promise.all(a).then((i) => b.mergeArray(t, i)) : b.mergeArray(t, a);
+    return r.common.async ? Promise.all(a).then((i) => w.mergeArray(t, i)) : w.mergeArray(t, a);
   }
   get items() {
     return this._def.items;
@@ -2137,28 +2137,28 @@ class Se extends _ {
         expected: u.map,
         received: r.parsedType
       }), m;
-    const s = this._def.keyType, a = this._def.valueType, i = [...r.data.entries()].map(([o, h], f) => ({
-      key: s._parse(new Z(r, o, r.path, [f, "key"])),
-      value: a._parse(new Z(r, h, r.path, [f, "value"]))
+    const s = this._def.keyType, a = this._def.valueType, i = [...r.data.entries()].map(([o, f], h) => ({
+      key: s._parse(new Z(r, o, r.path, [h, "key"])),
+      value: a._parse(new Z(r, f, r.path, [h, "value"]))
     }));
     if (r.common.async) {
       const o = /* @__PURE__ */ new Map();
       return Promise.resolve().then(async () => {
-        for (const h of i) {
-          const f = await h.key, y = await h.value;
-          if (f.status === "aborted" || y.status === "aborted")
+        for (const f of i) {
+          const h = await f.key, y = await f.value;
+          if (h.status === "aborted" || y.status === "aborted")
             return m;
-          (f.status === "dirty" || y.status === "dirty") && t.dirty(), o.set(f.value, y.value);
+          (h.status === "dirty" || y.status === "dirty") && t.dirty(), o.set(h.value, y.value);
         }
         return { status: t.value, value: o };
       });
     } else {
       const o = /* @__PURE__ */ new Map();
-      for (const h of i) {
-        const f = h.key, y = h.value;
-        if (f.status === "aborted" || y.status === "aborted")
+      for (const f of i) {
+        const h = f.key, y = f.value;
+        if (h.status === "aborted" || y.status === "aborted")
           return m;
-        (f.status === "dirty" || y.status === "dirty") && t.dirty(), o.set(f.value, y.value);
+        (h.status === "dirty" || y.status === "dirty") && t.dirty(), o.set(h.value, y.value);
       }
       return { status: t.value, value: o };
     }
@@ -2196,17 +2196,17 @@ class F extends _ {
       message: s.maxSize.message
     }), t.dirty());
     const a = this._def.valueType;
-    function i(h) {
-      const f = /* @__PURE__ */ new Set();
-      for (const y of h) {
+    function i(f) {
+      const h = /* @__PURE__ */ new Set();
+      for (const y of f) {
         if (y.status === "aborted")
           return m;
-        y.status === "dirty" && t.dirty(), f.add(y.value);
+        y.status === "dirty" && t.dirty(), h.add(y.value);
       }
-      return { status: t.value, value: f };
+      return { status: t.value, value: h };
     }
-    const o = [...r.data.values()].map((h, f) => a._parse(new Z(r, h, r.path, f)));
-    return r.common.async ? Promise.all(o).then((h) => i(h)) : i(o);
+    const o = [...r.data.values()].map((f, h) => a._parse(new Z(r, f, r.path, h)));
+    return r.common.async ? Promise.all(o).then((f) => i(f)) : i(o);
   }
   min(e, t) {
     return new F({
@@ -2407,12 +2407,12 @@ class M extends _ {
         return Promise.resolve(i).then(async (o) => {
           if (t.value === "aborted")
             return m;
-          const h = await this._def.schema._parseAsync({
+          const f = await this._def.schema._parseAsync({
             data: o,
             path: r.path,
             parent: r
           });
-          return h.status === "aborted" ? m : h.status === "dirty" || t.value === "dirty" ? W(h.value) : h;
+          return f.status === "aborted" ? m : f.status === "dirty" || t.value === "dirty" ? W(f.value) : f;
         });
       {
         if (t.value === "aborted")
@@ -2427,10 +2427,10 @@ class M extends _ {
     }
     if (s.type === "refinement") {
       const i = (o) => {
-        const h = s.refinement(o, a);
+        const f = s.refinement(o, a);
         if (r.common.async)
-          return Promise.resolve(h);
-        if (h instanceof Promise)
+          return Promise.resolve(f);
+        if (f instanceof Promise)
           throw new Error("Async refinement encountered during synchronous parse operation. Use .parseAsync instead.");
         return o;
       };
@@ -2656,14 +2656,14 @@ var p;
 })(p || (p = {}));
 const te = R.create, x = B.create;
 j.create;
-const $e = T.create, fe = k.create;
+const $e = T.create, he = k.create;
 H.create;
 const at = ue.create;
 Y.create;
 E.create;
 const V = J.create;
 I.create;
-const w = Q.create;
+const b = Q.create;
 X.create;
 N.create;
 L.create;
@@ -2681,29 +2681,29 @@ const it = {
   Backfeed70: "70",
   Backfeed80: "80",
   Backfeed90: "90"
-}, ot = w(it), dt = {
+}, ot = b(it), dt = {
   Continuous: "N",
   VariableLengthContinuous: "V",
   NonContinuousWebSensing: "W",
   NonContinuousWebSensingAlt: "Y",
   NonContinuousMarkSensing: "M",
   AutoDetect: "A"
-}, ct = w(dt), ut = {
+}, ct = b(dt), ut = {
   DirectThermal: "D",
   ThermalTransfer: "T"
-}, lt = w(ut), ft = {
+}, lt = b(ut), ht = {
   Invert: "I",
   Normal: "N"
-}, ht = w(ft), mt = {
+}, ft = b(ht), mt = {
   Mirror: "Y",
   Normal: "N"
-}, pt = w(mt), gt = {
+}, pt = b(mt), gt = {
   Normal: "A",
   Half: "B"
-}, yt = w(gt), _t = {
+}, yt = b(gt), _t = {
   Enable: "Y",
   Disable: "N"
-}, vt = w(_t), xt = {
+}, vt = b(_t), xt = {
   TearOff: "T",
   PeelOff: "P",
   Rewind: "R",
@@ -2712,44 +2712,44 @@ const it = {
   DelayedCut: "D",
   EncodeRFID: "F",
   Kiosk: "K"
-}, kt = w(xt), wt = {
+}, kt = b(xt), bt = {
   Prepeel: "Y",
   NoPrepeel: "N"
-}, bt = w(wt), St = {
+}, wt = b(bt), St = {
   AllMedia: "Y",
   ContinuousOnly: "N"
-}, Tt = w(St), Ct = {
+}, Tt = b(St), Ct = {
   NoRotation: "N",
   Rotate90: "R",
   Rotate180: "I",
   Rotate270: "B"
-}, Re = w(Ct), At = {
+}, Re = b(Ct), At = {
   Left: "L",
   Right: "R",
   Center: "C",
   Justified: "J"
-}, Nt = w(At), Ot = {
+}, Nt = b(At), Ot = {
   Highest: "H",
   High: "Q",
   Medium: "M",
   Lower: "L"
-}, $t = w(Ot), Rt = {
+}, $t = b(Ot), Rt = {
   Yes: "Y",
   No: "N"
-}, se = w(Rt), Ze = {
+}, se = b(Rt), Ze = {
   Start: "start",
   End: "end"
-}, Zt = w(Ze), jt = fe({
+}, Zt = b(Ze), jt = he({
   word: te(),
   width: x(),
   spaceWidth: x()
-}), he = fe({
+}), fe = he({
   name: te(),
   x: x().int(),
   y: x().int(),
   data: te()
-}), Et = he.extend({
-  type: V("field"),
+}), Et = fe.extend({
+  type: V("text"),
   // ^A font, height, width
   font: te().regex(/^[A-Z0-9]$/, "Font must be a single character A-Z or 0-9"),
   fontOrientation: Re,
@@ -2763,7 +2763,7 @@ const it = {
   hangingIndent: x().int().min(0).max(9999),
   verticalAlignment: Zt,
   wordWidths: $e(jt).optional()
-}), It = he.extend({
+}), It = fe.extend({
   type: V("barcode"),
   // ^BY barWidth
   barWidth: x().int().min(4).max(9999),
@@ -2773,7 +2773,7 @@ const it = {
   line: se,
   lineAbove: se,
   checkDigit: se
-}), Mt = he.extend({
+}), Mt = fe.extend({
   type: V("qrcode"),
   // ^BQ orientation, model, magnification, errorCorrection, mask
   orientation: V("N"),
@@ -2785,7 +2785,7 @@ const it = {
   Et,
   It,
   Mt
-]), je = fe({
+]), je = he({
   type: V("thermal"),
   // ~TA adjustment
   tearOffAdjustment: x().int().min(0).max(120),
@@ -2797,7 +2797,7 @@ const it = {
   // ^MT mediaType
   thermalMediaType: lt,
   // ^PO orientation
-  printOrientation: ht,
+  printOrientation: ft,
   // ^PM mirror
   mirror: pt,
   // ^LH x,y
@@ -2815,14 +2815,14 @@ const it = {
   reverse: vt,
   // ^MM mode, prepeel
   postPrintMode: kt,
-  prepeel: bt,
+  prepeel: wt,
   // ^PW width
   printWidth: x().int().min(2),
   // ^LL length, allMedia
   labelLength: x().int().min(1).max(32e3),
   allMedia: Tt,
-  // Blocks
-  blocks: $e(Lt)
+  // Fields
+  fields: $e(Lt)
 });
 function Yt(n) {
   return je.safeParse(n);
@@ -2837,7 +2837,7 @@ function Qt(n) {
 }
 function Pt(n) {
   const e = ["^XA", Vt(n)];
-  for (const t of n.blocks)
+  for (const t of n.fields)
     e.push(Dt(t));
   return e.push("^XZ"), e.join(`
 `);
@@ -2864,7 +2864,7 @@ function Vt(n) {
 }
 function Dt(n) {
   switch (n.type) {
-    case "field":
+    case "text":
       return Bt(n);
     case "barcode":
       return qt(n);
@@ -2872,7 +2872,7 @@ function Dt(n) {
       return Ht(n);
     default: {
       const e = n;
-      throw new Error(`Unsupported block type: ${e.type}`);
+      throw new Error(`Unsupported field type: ${e.type}`);
     }
   }
 }
@@ -2904,12 +2904,12 @@ function Ft(n, e, t) {
       continue;
     }
     const i = a.split(" ");
-    let o = 0, h = 1;
-    for (let f = 0; f < i.length; f++) {
-      const y = r.get(i[f]), C = y?.width ?? 0, ne = y?.spaceWidth ?? 0, me = o > 0 ? ne + C : C;
-      o > 0 && o + me > t ? (h++, o = C) : o += me;
+    let o = 0, f = 1;
+    for (let h = 0; h < i.length; h++) {
+      const y = r.get(i[h]), C = y?.width ?? 0, ne = y?.spaceWidth ?? 0, me = o > 0 ? ne + C : C;
+      o > 0 && o + me > t ? (f++, o = C) : o += me;
     }
-    s += h;
+    s += f;
   }
   return s;
 }
@@ -2937,9 +2937,9 @@ export {
   dt as MediaType,
   mt as MirrorMode,
   xt as PostPrintMode,
-  wt as PrepeelMode,
+  bt as PrepeelMode,
   gt as PrintDensityAdjustment,
-  ft as PrintOrientation,
+  ht as PrintOrientation,
   Ot as QRCodeErrorCorrection,
   _t as ReverseMode,
   At as TextAlignment,
@@ -2950,22 +2950,22 @@ export {
   Wt as applyVerticalAlignment,
   ot as backfeedActionSchema,
   je as badgeSchema,
-  It as barcodeBlockSchema,
-  Lt as blockSchema,
+  It as barcodeFieldSchema,
   zt as countLines,
-  Et as fieldBlockSchema,
+  Lt as fieldSchema,
   Re as fontOrientationSchema,
   Qt as generate,
   ct as mediaTypeSchema,
   pt as mirrorModeSchema,
   kt as postPrintModeSchema,
-  bt as prepeelModeSchema,
+  wt as prepeelModeSchema,
   yt as printDensityAdjustmentSchema,
-  ht as printOrientationSchema,
+  ft as printOrientationSchema,
   $t as qrCodeErrorCorrectionSchema,
-  Mt as qrcodeBlockSchema,
+  Mt as qrcodeFieldSchema,
   vt as reverseModeSchema,
   Nt as textAlignmentSchema,
+  Et as textFieldSchema,
   lt as thermalMediaTypeSchema,
   Yt as validateBadge,
   Jt as validateBadgeOrThrow,

package/dist/src/generate.d.ts

@@ -0,0 +1,29 @@
+import { Badge, TextField } from './validate';
+/**
+ * Generates ZPL (Zebra Programming Language) from a Badge configuration.
+ * Switches on badge type and renders the complete label format for thermal printers.
+ */
+export declare function generate(badge: Badge): string;
+/**
+ * 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 / font width
+ */
+export declare function applyVerticalAlignment(field: TextField): 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 wordWidths are not provided, falls back to a character-width
+ * heuristic using fontWidth (or fontHeight).
+ */
+export declare function countLines(field: TextField): number;