zpl-image-ts 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2019 Mark Warren (original zpl-image, https://github.com/metafloor/zpl-image)
+Copyright (c) 2026 Mika Salminen (TypeScript port)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,62 @@
+# Credits and attribution
+
+This package is a TypeScript port of [`zpl-image`](https://github.com/metafloor/zpl-image)
+by **Mark Warren** (`metafloor`), originally published 2019 under the MIT license.
+
+The algorithm in `src/index.ts` -- luminance thresholding, optional rotation,
+1-bit packing, deflate compression, base64 + CRC16 envelope -- is a direct
+translation of the corresponding routines in the upstream
+`zpl-image.js`. The bit-level output of `rgbaToZ64` is verified to match the
+original implementation byte-for-byte via the golden vector test suite under
+`test/fixtures/`.
+
+## What was changed in this port
+
+- Rewritten in TypeScript with full type declarations.
+- Isomorphic: runs in Node.js 18+ and any modern browser with zero runtime
+  dependencies. Uses the web-standard `CompressionStream('deflate')`
+  (global in Node 18+ and all evergreen browsers since 2023) instead of
+  `pako` or `node:zlib`. Uses native
+  `Uint8Array.prototype.toBase64()` when available (Node 22+, Chrome 133+,
+  Firefox 133+, Safari 18.2+) with a portable `btoa` fallback.
+- Public `rgbaToZ64` is async (returns `Promise<Result>`) because
+  `CompressionStream` is stream-based. Output is byte-identical to upstream.
+- ESM with named exports (the original was a UMD bundle whose
+  `module.exports = factory()` pattern hid named exports from Node's
+  cjs-module-lexer, breaking `import {rgbaToZ64}` under real ESM).
+- Narrowed scope: `rgbaToZ64` and `rgbaToACS` are exported.
+  `imageToZ64` / `imageToACS` are browser DOM helpers that wrap
+  `<canvas>.getImageData()`. With `createImageBitmap()` +
+  `OffscreenCanvas` they are a one-liner at the call site, so they are not
+  bundled.
+- Vitest test suite with golden vectors captured from the upstream package
+  guarantees bit-exact compatibility for both `rgbaToZ64` and `rgbaToACS`.
+
+## Original upstream license
+
+The upstream `zpl-image` is distributed under the MIT license. The full
+upstream `LICENSE` text reads:
+
+```
+zpl-image
+
+Copyright 2019 Mark Warren
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/README.md

@@ -0,0 +1,289 @@
+# zpl-image-ts
+
+TypeScript port of [`metafloor/zpl-image`](https://github.com/metafloor/zpl-image).
+Converts an RGBA bitmap into a Zebra `^GFA`-ready Z64 payload (zlib-deflate +
+base64 + CRC16 envelope). Isomorphic: runs in Node.js 18+ and any modern
+browser, with zero runtime dependencies.
+
+```ts
+import {rgbaToZ64} from 'zpl-image-ts';
+
+const result = await rgbaToZ64(rgbaBuffer, width, {rotate: 'R'});
+// result.gfa === `^GFA,${result.length},${result.length},${result.rowlen},${result.z64}`
+const zpl = '^XA' + result.gfa + '^FS^XZ';
+```
+
+## Import paths
+
+Five entry points -- pick whichever matches what you need:
+
+```ts
+// Convenience barrel. Bundlers with sideEffects:false respect it and
+// tree-shake unused encoders automatically.
+import {rgbaToZ64, rgbaToACS, buildZpl} from 'zpl-image-ts';
+
+// Explicit subpath -- guarantees the other encoder, its compression glue,
+// and (for /z64) the 256-entry CRC16 table are never bundled.
+import {rgbaToZ64} from 'zpl-image-ts/z64';
+import {rgbaToACS} from 'zpl-image-ts/acs';
+
+// Browser DOM helpers -- rasterise an ImageBitmapSource (HTMLImageElement,
+// Blob, ImageData, ImageBitmap, OffscreenCanvas, ...) before encoding.
+// Pulls in zero DOM types on the server side because it lives behind its
+// own subpath.
+import {imageToZ64, imageToACS} from 'zpl-image-ts/browser';
+
+// ZPL label builder -- wrap one or more ^GFA blocks in a complete
+// ^XA...^XZ payload with darkness, print rate, copies, etc. Tiny and
+// dependency-free, so importing it from the barrel is fine too.
+import {buildZpl} from 'zpl-image-ts/zpl';
+```
+
+All five paths re-export `RgbaInput` and `RgbaOptions` where relevant.
+The encoder subpaths additionally export their own `RgbaToZ64Result` /
+`RgbaToACSResult` types; the `zpl` subpath exports `ZplLabelOptions`.
+
+## Why a fork?
+
+- Native TypeScript types (no community-maintained shim drift).
+- Pure ESM with named exports -- the upstream UMD bundle's
+  `module.exports = factory()` shape is opaque to Node's `cjs-module-lexer`,
+  so `import {rgbaToZ64} from 'zpl-image'` throws `SyntaxError: The
+  requested module does not provide an export named 'rgbaToZ64'` under
+  real Node ESM (tsx/esbuild masks this).
+- Isomorphic with zero dependencies: drops `pako` in favour of the
+  web-standard `CompressionStream('deflate')` (global in Node 18+ and all
+  evergreen browsers since 2023). No Node-specific imports.
+- `result.gfa` ergonomic: every encoder result includes a ready-to-emit
+  `^GFA,length,length,rowlen,payload` string, so call sites do not have
+  to template the four fields by hand.
+- Optional browser DOM helpers (`imageToZ64` / `imageToACS`) under the
+  separate `zpl-image-ts/browser` entry point, tree-shaken out of
+  server bundles.
+- Optional ZPL label builder (`buildZpl`) under `zpl-image-ts/zpl`:
+  darkness, print rate, copies, field origin, multi-page batches. So
+  callers never have to learn ZPL syntax just to print an image.
+
+## Credits
+
+All credit for the algorithm goes to **Mark Warren** (`metafloor`) -- this is
+strictly a transliteration, not a redesign. See [NOTICE.md](NOTICE.md) for the
+full attribution and upstream license. Both this port and the upstream are
+distributed under the MIT license.
+
+## API
+
+```ts
+type RgbaInput = Uint8Array | Uint8ClampedArray | readonly number[];
+
+interface RgbaOptions {
+    /** Blackness threshold 1..99. Default 50. */
+    black?: number;
+    /** Skip auto-trimming whitespace padding. Default false. */
+    notrim?: boolean;
+    /** 'N' (none), 'L' / 'B' (90 CCW), 'R' (90 CW), 'I' (180). */
+    rotate?: 'N' | 'L' | 'R' | 'I' | 'B';
+}
+
+// Deflate + base64 + CRC16 (preferred -- shorter on the wire, supported on
+// every modern Zebra printer). Async because CompressionStream is the
+// underlying web-standard primitive.
+function rgbaToZ64(
+    rgba: RgbaInput,
+    width: number,
+    opts?: RgbaOptions,
+): Promise<{
+    length: number; // uncompressed byte count -> ^GFA arg 1 & 2
+    rowlen: number; // packed bytes per row    -> ^GFA arg 3
+    width: number;  // rotated image width in pixels
+    height: number; // rotated image height in pixels
+    z64: string;    // ':Z64:<base64>:<crc16hex>' -> ^GFA arg 4
+    gfa: string;    // '^GFA,length,length,rowlen,z64' -- ready to splice into ZPL
+}>;
+
+// Hex + run-length codes (Alternative Data Compression Scheme).
+// Synchronous -- no compression library needed. Useful when you want a
+// hex-readable payload for debugging, or for older Zebra firmware that
+// predates Z64 support.
+function rgbaToACS(
+    rgba: RgbaInput,
+    width: number,
+    opts?: RgbaOptions,
+): {
+    length: number;
+    rowlen: number;
+    width: number;
+    height: number;
+    acs: string;    // hex with G..Y / g..z / z run-length codes
+    gfa: string;    // '^GFA,length,length,rowlen,acs' -- ready to splice into ZPL
+};
+
+// Browser-only convenience helpers -- subpath `zpl-image-ts/browser`.
+// Rasterise any ImageBitmapSource (HTMLImageElement, Blob, ImageData,
+// ImageBitmap, OffscreenCanvas, ...) via createImageBitmap +
+// OffscreenCanvas, then run it through rgbaToZ64 / rgbaToACS.
+function imageToZ64(
+    source: ImageBitmapSource,
+    opts?: RgbaOptions,
+): Promise<RgbaToZ64Result>;
+
+function imageToACS(
+    source: ImageBitmapSource,
+    opts?: RgbaOptions,
+): Promise<RgbaToACSResult>;
+
+// Wrap one or more ^GFA blocks in a complete ^XA...^XZ label. Subpath
+// `zpl-image-ts/zpl`. Re-exported from the barrel.
+interface ZplLabelOptions {
+    darkness?: number;                  // ~SD, 0..30, one decimal
+    printRate?: number;                 // ^PR, 1..14 (inches/sec on most printers)
+    copies?: number;                    // ^PQ, omitted when <= 1
+    fieldOrigin?: {x: number; y: number}; // ^FO before the ^GFA block
+    prelude?: string;                   // raw ZPL after ^XA  (e.g. ^PW, ^LL, ^MM)
+    postlude?: string;                  // raw ZPL before ^XZ (e.g. ^XB)
+}
+
+function buildZpl(
+    gfa: string | readonly string[],
+    opts?: ZplLabelOptions,
+): string;
+```
+
+### Splicing into a ZPL label
+
+```ts
+const result = await rgbaToZ64(rgba, width);
+const zpl = '^XA' + result.gfa + '^XZ';
+// equivalent to manually writing:
+//   '^XA^GFA,' + result.length + ',' + result.length + ',' +
+//   result.rowlen + ',' + result.z64 + '^XZ'
+```
+
+For anything beyond the bare `^XA…^XZ` framing -- darkness, print rate,
+copy count, field origin -- use the `buildZpl` helper from
+`zpl-image-ts/zpl` (also re-exported from the barrel). It exists so the
+caller never has to learn ZPL syntax just to get an image onto paper:
+
+```ts
+import {rgbaToZ64, buildZpl} from 'zpl-image-ts';
+
+const result = await rgbaToZ64(rgba, width);
+const zpl = buildZpl(result.gfa, {
+    darkness: 15,        // ~SD15.0   (media darkness, 0..30, one decimal)
+    printRate: 4,        // ^PR4,A,A  (inches/sec, 1..14)
+    copies: 2,           // ^PQ2      (omitted when <= 1)
+    fieldOrigin: {x: 30, y: 15}, // ^FO30,15 before the ^GFA block
+});
+// -> '^XA^PR4,A,A~SD15.0^FO30,15^GFA,...^PQ2^XZ'
+```
+
+`buildZpl` also accepts an array of `gfa` strings -- e.g. one per page
+rasterised from a PDF -- and emits one `^XA…^XZ` block per entry,
+joined with `\n`. The same options apply to every label in the batch.
+For advanced cases the `prelude` and `postlude` options accept raw ZPL
+inserted directly after `^XA` and before `^XZ` respectively
+(e.g. `^PW`, `^LL`, `^MM`, `^XB`).
+
+### End-to-end: image to printer over TCP
+
+Zebra network printers accept raw ZPL on TCP port 9100. Combined with
+`imageToZ64` (browser/worker) or `rgbaToZ64` (Node + mupdf, sharp, etc.)
+the full pipeline is a handful of lines and the caller never types `^XA`:
+
+```ts
+// Node: PNG/JPG on disk -> ZPL -> printer
+import {readFile} from 'node:fs/promises';
+import {createConnection} from 'node:net';
+import sharp from 'sharp';
+import {rgbaToZ64, buildZpl} from 'zpl-image-ts';
+
+const png = await readFile('label.png');
+const {data, info} = await sharp(png)
+    .ensureAlpha()
+    .raw()
+    .toBuffer({resolveWithObject: true});
+
+const result = await rgbaToZ64(data, info.width, {rotate: 'R'});
+const zpl = buildZpl(result.gfa, {darkness: 15, printRate: 4});
+
+await new Promise<void>((resolve, reject) => {
+    const sock = createConnection({host: '192.168.1.42', port: 9100}, () => {
+        sock.end(zpl, 'ascii', () => resolve());
+    });
+    sock.once('error', reject);
+});
+```
+
+```ts
+// Browser: <input type="file"> -> ZPL -> POST to your print proxy
+import {imageToZ64} from 'zpl-image-ts/browser';
+import {buildZpl} from 'zpl-image-ts/zpl';
+
+const file: Blob = input.files![0];
+const result = await imageToZ64(file, {rotate: 'R'});
+const zpl = buildZpl(result.gfa, {darkness: 15, printRate: 4});
+
+await fetch('/api/print', {method: 'POST', body: zpl});
+```
+
+`Node.js Buffer` is accepted at runtime since `Buffer extends Uint8Array`;
+the type was dropped from the signature to keep the package free of
+`@types/node` requirements in browser builds.
+
+## Runtime requirements
+
+| Runtime | Required APIs | Status |
+| --- | --- | --- |
+| Node.js | `CompressionStream`, `Blob`, `Response`, `btoa` | All global since Node 18 |
+| Chromium | same | All shipped, evergreen |
+| Firefox | same | All shipped, evergreen |
+| Safari | same | Shipped 16.4+ (March 2023) |
+
+Native `Uint8Array.prototype.toBase64()` (TC39, Node 22+, Chrome 133+,
+Firefox 133+, Safari 18.2+) is used when available; otherwise a portable
+`btoa(String.fromCharCode(...))` fallback kicks in.
+
+## Compatibility
+
+Output is verified bit-exact against upstream `zpl-image@0.3.0` for both
+`rgbaToZ64` and `rgbaToACS` via golden-vector suites in
+`test/fixtures/fixtures.json` and `test/fixtures/fixtures-acs.json`. Any
+drift fails the test run.
+
+## What is intentionally not ported
+
+### Legacy browser support (pre-2023)
+
+`rgbaToZ64` relies on the web-standard `CompressionStream('deflate')` API.
+That global is available in:
+
+- Node.js 18+ (April 2022)
+- Chrome / Edge 80+ (February 2020)
+- Safari 16.4+ (March 2023)
+- Firefox 113+ (May 2023)
+
+Runtimes older than the above (Safari 16.3 and below, Firefox 112 and below,
+any Internet Explorer) **are not supported and no polyfill is bundled**.
+
+If you need to support those runtimes, wrap this library yourself in three
+lines using [`fflate`](https://github.com/101arrowz/fflate) (~8 kB min+gz,
+faster and smaller than `pako`):
+
+```ts
+import {zlibSync} from 'fflate';
+import {rgbaToACS} from 'zpl-image-ts/acs';
+// ...build your own rgbaToZ64 by replacing the deflate step with zlibSync().
+```
+
+## Development
+
+```sh
+npm install
+npm run typecheck
+npm test
+npm run build
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE) and [NOTICE.md](NOTICE.md).

package/dist/acs.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ACS encoder: hex + ZPL's Alternative Data Compression Scheme run-length
+ * codes. Synchronous (no compression library needed).
+ *
+ * Algorithm credit: Mark Warren (https://github.com/metafloor/zpl-image),
+ * MIT 2019. See ../NOTICE.md for full attribution.
+ *
+ * Importing this module directly (`import {rgbaToACS} from 'zpl-image-ts/acs'`)
+ * leaves the Z64 encoder, its CRC16 table, and CompressionStream glue out of
+ * the bundle entirely.
+ */
+import { type BitmapResult, type RgbaInput, type RgbaOptions } from './internal/bitmap.js';
+export type { RgbaInput, RgbaOptions };
+export interface RgbaToACSResult extends BitmapResult {
+    /** Hex-encoded payload with ACS run-length codes; used for `^GFA` arg 4. */
+    acs: string;
+}
+/**
+ * Convert an RGBA bitmap to a Zebra ACS-encoded `^GFA` payload.
+ *
+ * @example
+ * ```ts
+ * const r = rgbaToACS(rgba, width);
+ * const cmd = `^GFA,${r.length},${r.length},${r.rowlen},${r.acs}`;
+ * ```
+ */
+export declare function rgbaToACS(rgba: RgbaInput, width: number, opts?: RgbaOptions): RgbaToACSResult;
+//# sourceMappingURL=acs.d.ts.map

package/dist/acs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acs.d.ts","sourceRoot":"","sources":["../src/acs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAU,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAC,MAAM,sBAAsB,CAAC;AAElG,YAAY,EAAC,SAAS,EAAE,WAAW,EAAC,CAAC;AAErC,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACjD,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACrB,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,WAAgB,GACvB,eAAe,CA+CjB"}

package/dist/acs.js

@@ -0,0 +1,75 @@
+/**
+ * ACS encoder: hex + ZPL's Alternative Data Compression Scheme run-length
+ * codes. Synchronous (no compression library needed).
+ *
+ * Algorithm credit: Mark Warren (https://github.com/metafloor/zpl-image),
+ * MIT 2019. See ../NOTICE.md for full attribution.
+ *
+ * Importing this module directly (`import {rgbaToACS} from 'zpl-image-ts/acs'`)
+ * leaves the Z64 encoder, its CRC16 table, and CompressionStream glue out of
+ * the bundle entirely.
+ */
+import { prepare } from './internal/bitmap.js';
+/**
+ * Convert an RGBA bitmap to a Zebra ACS-encoded `^GFA` payload.
+ *
+ * @example
+ * ```ts
+ * const r = rgbaToACS(rgba, width);
+ * const cmd = `^GFA,${r.length},${r.length},${r.rowlen},${r.acs}`;
+ * ```
+ */
+export function rgbaToACS(rgba, width, opts = {}) {
+    const { buf, rowlen } = prepare(rgba, width, opts);
+    let hex = '';
+    for (let i = 0, n = buf.data.length; i < n; i++) {
+        hex += hexmap[buf.data[i]];
+    }
+    // ACS run-length codes:
+    //   G..Y  -> repeats of 1..19
+    //   g..y  -> repeats of 20..380 (in steps of 20)
+    //   z     -> repeats of 400 (combined with above for higher counts)
+    const lowRun = '_ghijklmnopqrstuvwxy';
+    const highRun = '_GHIJKLMNOPQRSTUVWXY';
+    const re = /([0-9a-fA-F])\1{2,}/g;
+    let acs = '';
+    let offset = 0;
+    let match = re.exec(hex);
+    while (match) {
+        acs += hex.substring(offset, match.index);
+        let l = match[0].length;
+        while (l >= 400) {
+            acs += 'z';
+            l -= 400;
+        }
+        if (l >= 20) {
+            acs += lowRun[Math.trunc(l / 20)];
+            l = l % 20;
+        }
+        if (l) {
+            acs += highRun[l];
+        }
+        acs += match[1];
+        offset = re.lastIndex;
+        match = re.exec(hex);
+    }
+    acs += hex.substring(offset);
+    const length = buf.data.length;
+    return {
+        length,
+        rowlen,
+        width: buf.width,
+        height: buf.height,
+        acs,
+        gfa: '^GFA,' + length + ',' + length + ',' + rowlen + ',' + acs,
+    };
+}
+const hexmap = (() => {
+    const arr = new Array(256);
+    for (let i = 0; i < 16; i++)
+        arr[i] = '0' + i.toString(16);
+    for (let i = 16; i < 256; i++)
+        arr[i] = i.toString(16);
+    return arr;
+})();
+//# sourceMappingURL=acs.js.map

package/dist/acs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acs.js","sourceRoot":"","sources":["../src/acs.ts"],"names":[],"mappings":"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"}

package/dist/browser.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Browser DOM helpers: rasterize an image source via `createImageBitmap` +
+ * `OffscreenCanvas`, then run it through `rgbaToZ64` / `rgbaToACS`.
+ *
+ * Subpath-only entry (`zpl-image-ts/browser`). Not re-exported from the
+ * main barrel because both APIs require browser-only globals
+ * (`createImageBitmap`, `OffscreenCanvas`) that do not exist in Node.
+ *
+ * Mirrors upstream `imageToZ64` / `imageToACS` but accepts any
+ * `ImageBitmapSource` -- not just `HTMLImageElement` -- so a `Blob` from
+ * `fetch()` or an `ImageData` you already have can be passed directly.
+ */
+import { type RgbaToZ64Result } from './z64.js';
+import { type RgbaToACSResult } from './acs.js';
+import type { RgbaOptions } from './internal/bitmap.js';
+export type { RgbaOptions, RgbaToZ64Result, RgbaToACSResult };
+/**
+ * Decode `source` into RGBA pixels via the platform's image decoder, then
+ * compress with Z64. Available in any context that has `createImageBitmap`
+ * (every evergreen browser, plus modern web workers).
+ */
+export declare function imageToZ64(source: ImageBitmapSource, opts?: RgbaOptions): Promise<RgbaToZ64Result>;
+/**
+ * Decode `source` into RGBA pixels and encode with ACS run-length codes.
+ * Sync compression -- only the rasterisation step is async because
+ * `createImageBitmap` is.
+ */
+export declare function imageToACS(source: ImageBitmapSource, opts?: RgbaOptions): Promise<RgbaToACSResult>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAY,KAAK,eAAe,EAAC,MAAM,UAAU,CAAC;AACzD,OAAO,EAAY,KAAK,eAAe,EAAC,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,sBAAsB,CAAC;AAEtD,YAAY,EAAC,WAAW,EAAE,eAAe,EAAE,eAAe,EAAC,CAAC;AAE5D;;;;GAIG;AACH,wBAAsB,UAAU,CAC5B,MAAM,EAAE,iBAAiB,EACzB,IAAI,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC5B,MAAM,EAAE,iBAAiB,EACzB,IAAI,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC,CAG1B"}

package/dist/browser.js

@@ -0,0 +1,51 @@
+/**
+ * Browser DOM helpers: rasterize an image source via `createImageBitmap` +
+ * `OffscreenCanvas`, then run it through `rgbaToZ64` / `rgbaToACS`.
+ *
+ * Subpath-only entry (`zpl-image-ts/browser`). Not re-exported from the
+ * main barrel because both APIs require browser-only globals
+ * (`createImageBitmap`, `OffscreenCanvas`) that do not exist in Node.
+ *
+ * Mirrors upstream `imageToZ64` / `imageToACS` but accepts any
+ * `ImageBitmapSource` -- not just `HTMLImageElement` -- so a `Blob` from
+ * `fetch()` or an `ImageData` you already have can be passed directly.
+ */
+import { rgbaToZ64 } from './z64.js';
+import { rgbaToACS } from './acs.js';
+/**
+ * Decode `source` into RGBA pixels via the platform's image decoder, then
+ * compress with Z64. Available in any context that has `createImageBitmap`
+ * (every evergreen browser, plus modern web workers).
+ */
+export async function imageToZ64(source, opts) {
+    const { rgba, width } = await rasterize(source);
+    return rgbaToZ64(rgba, width, opts);
+}
+/**
+ * Decode `source` into RGBA pixels and encode with ACS run-length codes.
+ * Sync compression -- only the rasterisation step is async because
+ * `createImageBitmap` is.
+ */
+export async function imageToACS(source, opts) {
+    const { rgba, width } = await rasterize(source);
+    return rgbaToACS(rgba, width, opts);
+}
+async function rasterize(source) {
+    const bitmap = source instanceof ImageBitmap ? source : await createImageBitmap(source);
+    try {
+        const canvas = new OffscreenCanvas(bitmap.width, bitmap.height);
+        const ctx = canvas.getContext('2d');
+        if (!ctx) {
+            throw new Error('imageToZ64/imageToACS: OffscreenCanvas 2D context unavailable in this runtime');
+        }
+        ctx.drawImage(bitmap, 0, 0);
+        const imageData = ctx.getImageData(0, 0, bitmap.width, bitmap.height);
+        return { rgba: imageData.data, width: imageData.width };
+    }
+    finally {
+        // Only close the bitmap we just created -- never the caller's.
+        if (source !== bitmap)
+            bitmap.close();
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAC,SAAS,EAAuB,MAAM,UAAU,CAAC;AACzD,OAAO,EAAC,SAAS,EAAuB,MAAM,UAAU,CAAC;AAKzD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC5B,MAAyB,EACzB,IAAkB;IAElB,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9C,OAAO,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC5B,MAAyB,EACzB,IAAkB;IAElB,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9C,OAAO,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,SAAS,CACpB,MAAyB;IAEzB,MAAM,MAAM,GAAG,MAAM,YAAY,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACxF,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,MAAM,IAAI,KAAK,CACX,+EAA+E,CAClF,CAAC;QACN,CAAC;QACD,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACtE,OAAO,EAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAC,CAAC;IAC1D,CAAC;YAAS,CAAC;QACP,+DAA+D;QAC/D,IAAI,MAAM,KAAK,MAAM;YAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1C,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * zpl-image-ts -- TypeScript port of metafloor/zpl-image.
+ *
+ * This is the convenience barrel re-export. For maximum tree-shaking, import
+ * the specific encoder you need directly:
+ *
+ * ```ts
+ * import {rgbaToZ64} from 'zpl-image-ts/z64';  // ACS code not bundled
+ * import {rgbaToACS} from 'zpl-image-ts/acs';  // Z64 code not bundled
+ * ```
+ *
+ * Most modern bundlers (Vite, esbuild, Rollup, Webpack 5) tree-shake this
+ * barrel correctly too, because `package.json` declares `"sideEffects": false`
+ * and both subentries are pure named exports.
+ */
+export { rgbaToZ64, type RgbaToZ64Result } from './z64.js';
+export { rgbaToACS, type RgbaToACSResult } from './acs.js';
+export { buildZpl, type ZplLabelOptions } from './zpl.js';
+export type { RgbaInput, RgbaOptions } from './internal/bitmap.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAC,SAAS,EAAE,KAAK,eAAe,EAAC,MAAM,UAAU,CAAC;AACzD,OAAO,EAAC,SAAS,EAAE,KAAK,eAAe,EAAC,MAAM,UAAU,CAAC;AACzD,OAAO,EAAC,QAAQ,EAAE,KAAK,eAAe,EAAC,MAAM,UAAU,CAAC;AACxD,YAAY,EAAC,SAAS,EAAE,WAAW,EAAC,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * zpl-image-ts -- TypeScript port of metafloor/zpl-image.
+ *
+ * This is the convenience barrel re-export. For maximum tree-shaking, import
+ * the specific encoder you need directly:
+ *
+ * ```ts
+ * import {rgbaToZ64} from 'zpl-image-ts/z64';  // ACS code not bundled
+ * import {rgbaToACS} from 'zpl-image-ts/acs';  // Z64 code not bundled
+ * ```
+ *
+ * Most modern bundlers (Vite, esbuild, Rollup, Webpack 5) tree-shake this
+ * barrel correctly too, because `package.json` declares `"sideEffects": false`
+ * and both subentries are pure named exports.
+ */
+export { rgbaToZ64 } from './z64.js';
+export { rgbaToACS } from './acs.js';
+export { buildZpl } from './zpl.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAC,SAAS,EAAuB,MAAM,UAAU,CAAC;AACzD,OAAO,EAAC,SAAS,EAAuB,MAAM,UAAU,CAAC;AACzD,OAAO,EAAC,QAAQ,EAAuB,MAAM,UAAU,CAAC"}

package/dist/internal/bitmap.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Shared bitmap pipeline: input validation, monochrome conversion, rotation,
+ * 1-bit packing. Direct transliteration of routines from upstream
+ * metafloor/zpl-image (MIT 2019). See ../../NOTICE.md.
+ *
+ * Internal: imported by `../z64.ts` and `../acs.ts`. Not part of the public
+ * API surface. The dist still ships compiled .js/.d.ts for it (so source
+ * maps and declaration maps resolve cleanly), but it is not listed in
+ * `package.json` "exports" -- consumers cannot reach it.
+ */
+/** Pixel data input. Each pixel is four consecutive bytes: R, G, B, A. */
+export type RgbaInput = Uint8Array | Uint8ClampedArray | readonly number[];
+/** Options shared by every encoder. */
+export interface RgbaOptions {
+    /** Blackness threshold, 1..99. Default 50. */
+    black?: number;
+    /** If true, do not auto-trim surrounding whitespace. Default false. */
+    notrim?: boolean;
+    /**
+     * Rotation:
+     *  - 'N' (default): no rotation
+     *  - 'L' or 'B': 90 degrees counter-clockwise
+     *  - 'R': 90 degrees clockwise
+     *  - 'I': 180 degrees
+     */
+    rotate?: 'N' | 'L' | 'R' | 'I' | 'B';
+}
+/** Common fields on every encoder's result. */
+export interface BitmapResult {
+    /** Uncompressed byte count; used for `^GFA` args 1 and 2. */
+    length: number;
+    /** Packed bytes per row; used for `^GFA` arg 3. */
+    rowlen: number;
+    /** Image width after rotation (pixels). */
+    width: number;
+    /** Image height after rotation (pixels). */
+    height: number;
+    /**
+     * Ready-to-emit `^GFA,length,length,rowlen,payload` command string.
+     * Wrap it in `^XA ... ^XZ` (with any `^FO` / `^PR` / `~SD` etc. you need)
+     * and send to the printer. Saves consumers from re-templating the
+     * length-twice, rowlen-third structure by hand.
+     */
+    gfa: string;
+}
+export interface MonoBuffer {
+    data: Uint8Array;
+    width: number;
+    height: number;
+}
+export interface PreparedBitmap {
+    buf: MonoBuffer;
+    rowlen: number;
+}
+/**
+ * Validate input, convert to monochrome, and apply the requested rotation.
+ * The returned `buf.data` is 1-bit-packed and ready for hex or deflate
+ * encoding.
+ */
+export declare function prepare(rgba: RgbaInput, width: number, opts: RgbaOptions): PreparedBitmap;
+//# sourceMappingURL=bitmap.d.ts.map

package/dist/internal/bitmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmap.d.ts","sourceRoot":"","sources":["../../src/internal/bitmap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,iBAAiB,GAAG,SAAS,MAAM,EAAE,CAAC;AAE3E,uCAAuC;AACvC,MAAM,WAAW,WAAW;IACxB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CACxC;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IACzB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,cAAc,CA2BzF"}

package/dist/internal/bitmap.js

@@ -0,0 +1,176 @@
+/**
+ * Shared bitmap pipeline: input validation, monochrome conversion, rotation,
+ * 1-bit packing. Direct transliteration of routines from upstream
+ * metafloor/zpl-image (MIT 2019). See ../../NOTICE.md.
+ *
+ * Internal: imported by `../z64.ts` and `../acs.ts`. Not part of the public
+ * API surface. The dist still ships compiled .js/.d.ts for it (so source
+ * maps and declaration maps resolve cleanly), but it is not listed in
+ * `package.json` "exports" -- consumers cannot reach it.
+ */
+/**
+ * Validate input, convert to monochrome, and apply the requested rotation.
+ * The returned `buf.data` is 1-bit-packed and ready for hex or deflate
+ * encoding.
+ */
+export function prepare(rgba, width, opts) {
+    const w = width | 0;
+    if (!w || w < 0) {
+        throw new Error('Invalid width');
+    }
+    const height = Math.trunc(rgba.length / w / 4);
+    const black = +(opts.black ?? 0) || 50;
+    const mono = monochrome(rgba, w, height, black, opts.notrim === true);
+    let buf;
+    switch (opts.rotate) {
+        case 'R':
+            buf = right(mono);
+            break;
+        case 'B':
+        case 'L':
+            buf = left(mono);
+            break;
+        case 'I':
+            buf = invert(mono);
+            break;
+        default:
+            buf = normal(mono);
+            break;
+    }
+    return { buf, rowlen: Math.trunc((buf.width + 7) / 8) };
+}
+function normal(mono) {
+    const { width, height, data: src } = mono;
+    const buf = new Uint8Array(Math.trunc((width + 7) / 8) * height);
+    let idx = 0;
+    let byte = 0;
+    let bitx = 0;
+    for (let i = 0, n = src.length; i < n; i++) {
+        byte |= src[i] << (7 - (bitx++ & 7));
+        if (bitx === width || !(bitx & 7)) {
+            buf[idx++] = byte;
+            byte = 0;
+            if (bitx === width) {
+                bitx = 0;
+            }
+        }
+    }
+    return { data: buf, width, height };
+}
+function invert(mono) {
+    const { width, height, data: src } = mono;
+    const buf = new Uint8Array(Math.trunc((width + 7) / 8) * height);
+    let idx = 0;
+    let byte = 0;
+    let bitx = 0;
+    for (let i = src.length - 1; i >= 0; i--) {
+        byte |= src[i] << (7 - (bitx++ & 7));
+        if (bitx === width || !(bitx & 7)) {
+            buf[idx++] = byte;
+            byte = 0;
+            if (bitx === width) {
+                bitx = 0;
+            }
+        }
+    }
+    return { data: buf, width, height };
+}
+function left(mono) {
+    const { width, height, data: src } = mono;
+    const buf = new Uint8Array(Math.trunc((height + 7) / 8) * width);
+    let idx = 0;
+    let byte = 0;
+    for (let x = width - 1; x >= 0; x--) {
+        let bitx = 0;
+        for (let y = 0; y < height; y++) {
+            byte |= src[y * width + x] << (7 - (bitx++ & 7));
+            if (y === height - 1 || !(bitx & 7)) {
+                buf[idx++] = byte;
+                byte = 0;
+            }
+        }
+    }
+    return { data: buf, width: height, height: width };
+}
+function right(mono) {
+    const { width, height, data: src } = mono;
+    const buf = new Uint8Array(Math.trunc((height + 7) / 8) * width);
+    let idx = 0;
+    let byte = 0;
+    for (let x = 0; x < width; x++) {
+        let bitx = 0;
+        for (let y = height - 1; y >= 0; y--) {
+            byte |= src[y * width + x] << (7 - (bitx++ & 7));
+            if (y === 0 || !(bitx & 7)) {
+                buf[idx++] = byte;
+                byte = 0;
+            }
+        }
+    }
+    return { data: buf, width: height, height: width };
+}
+/**
+ * Convert RGBA to monochrome, 1 bit per byte. Crops empty space around the
+ * edges unless `notrim` is true. Uses Rec.601-style luminance weights with
+ * straight alpha blending against a white background.
+ */
+function monochrome(rgba, width, height, blackPercent, notrim) {
+    const black = (255 * blackPercent) / 100;
+    let minx;
+    let maxx;
+    let miny;
+    let maxy;
+    if (notrim) {
+        minx = 0;
+        miny = 0;
+        maxx = width - 1;
+        maxy = height - 1;
+    }
+    else {
+        maxx = 0;
+        maxy = 0;
+        minx = width;
+        miny = height;
+        let x = 0;
+        let y = 0;
+        for (let i = 0, n = width * height * 4; i < n; i += 4) {
+            const a = rgba[i + 3] / 255;
+            const r = rgba[i] * 0.3 * a + 255 * (1 - a);
+            const g = rgba[i + 1] * 0.59 * a + 255 * (1 - a);
+            const b = rgba[i + 2] * 0.11 * a + 255 * (1 - a);
+            const gray = r + g + b;
+            if (gray <= black) {
+                if (minx > x)
+                    minx = x;
+                if (miny > y)
+                    miny = y;
+                if (maxx < x)
+                    maxx = x;
+                if (maxy < y)
+                    maxy = y;
+            }
+            if (++x === width) {
+                x = 0;
+                y++;
+            }
+        }
+    }
+    const cx = maxx - minx + 1;
+    const cy = maxy - miny + 1;
+    const buf = new Uint8Array(cx * cy);
+    let idx = 0;
+    for (let y = miny; y <= maxy; y++) {
+        let i = (y * width + minx) * 4;
+        for (let x = minx; x <= maxx; x++) {
+            const a = rgba[i + 3] / 255;
+            const r = rgba[i] * 0.3 * a + 255 * (1 - a);
+            const g = rgba[i + 1] * 0.59 * a + 255 * (1 - a);
+            const b = rgba[i + 2] * 0.11 * a + 255 * (1 - a);
+            const gray = r + g + b;
+            buf[idx++] = gray <= black ? 1 : 0;
+            i += 4;
+        }
+    }
+    return { data: buf, width: cx, height: cy };
+}
+//# sourceMappingURL=bitmap.js.map

package/dist/internal/bitmap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmap.js","sourceRoot":"","sources":["../../src/internal/bitmap.ts"],"names":[],"mappings":"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"}

package/dist/z64.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Z64 encoder: zlib-deflate + base64 + CRC16 envelope.
+ *
+ * Algorithm credit: Mark Warren (https://github.com/metafloor/zpl-image),
+ * MIT 2019. See ../NOTICE.md for full attribution.
+ *
+ * Isomorphic: uses web-standard `CompressionStream('deflate')` (global in
+ * Node 18+ and every evergreen browser) and `Uint8Array.prototype.toBase64()`
+ * when available, with a portable btoa-based fallback. Zero runtime deps.
+ *
+ * Importing this module directly (`import {rgbaToZ64} from 'zpl-image-ts/z64'`)
+ * leaves the ACS encoder out of the bundle entirely.
+ */
+import { type BitmapResult, type RgbaInput, type RgbaOptions } from './internal/bitmap.js';
+export type { RgbaInput, RgbaOptions };
+export interface RgbaToZ64Result extends BitmapResult {
+    /** `:Z64:<base64>:<crc16hex>` payload; used for `^GFA` arg 4. */
+    z64: string;
+}
+/**
+ * Convert an RGBA bitmap to a Zebra Z64-encoded `^GFA` payload.
+ *
+ * @example
+ * ```ts
+ * const r = await rgbaToZ64(rgba, width);
+ * const cmd = `^GFA,${r.length},${r.length},${r.rowlen},${r.z64}`;
+ * ```
+ */
+export declare function rgbaToZ64(rgba: RgbaInput, width: number, opts?: RgbaOptions): Promise<RgbaToZ64Result>;
+//# sourceMappingURL=z64.d.ts.map

package/dist/z64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"z64.d.ts","sourceRoot":"","sources":["../src/z64.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAU,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAC,MAAM,sBAAsB,CAAC;AAElG,YAAY,EAAC,SAAS,EAAE,WAAW,EAAC,CAAC;AAErC,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACjD,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC3B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,WAAgB,GACvB,OAAO,CAAC,eAAe,CAAC,CAc1B"}

package/dist/z64.js

@@ -0,0 +1,97 @@
+/**
+ * Z64 encoder: zlib-deflate + base64 + CRC16 envelope.
+ *
+ * Algorithm credit: Mark Warren (https://github.com/metafloor/zpl-image),
+ * MIT 2019. See ../NOTICE.md for full attribution.
+ *
+ * Isomorphic: uses web-standard `CompressionStream('deflate')` (global in
+ * Node 18+ and every evergreen browser) and `Uint8Array.prototype.toBase64()`
+ * when available, with a portable btoa-based fallback. Zero runtime deps.
+ *
+ * Importing this module directly (`import {rgbaToZ64} from 'zpl-image-ts/z64'`)
+ * leaves the ACS encoder out of the bundle entirely.
+ */
+import { prepare } from './internal/bitmap.js';
+/**
+ * Convert an RGBA bitmap to a Zebra Z64-encoded `^GFA` payload.
+ *
+ * @example
+ * ```ts
+ * const r = await rgbaToZ64(rgba, width);
+ * const cmd = `^GFA,${r.length},${r.length},${r.rowlen},${r.z64}`;
+ * ```
+ */
+export async function rgbaToZ64(rgba, width, opts = {}) {
+    const { buf, rowlen } = prepare(rgba, width, opts);
+    const deflated = await deflateZlib(buf.data);
+    const b64 = bytesToBase64(deflated);
+    const z64 = ':Z64:' + b64 + ':' + crc16(b64);
+    const length = buf.data.length;
+    return {
+        length,
+        rowlen,
+        width: buf.width,
+        height: buf.height,
+        z64,
+        gfa: '^GFA,' + length + ',' + length + ',' + rowlen + ',' + z64,
+    };
+}
+async function deflateZlib(buf) {
+    // Cast: TS DOM lib types Blob parts as needing ArrayBuffer-backed views,
+    // but the spec accepts any BufferSource (incl. SharedArrayBuffer-backed).
+    const stream = new Blob([buf])
+        .stream()
+        .pipeThrough(new CompressionStream('deflate'));
+    return new Uint8Array(await new Response(stream).arrayBuffer());
+}
+function bytesToBase64(buf) {
+    // TC39 native: Node 22+, Chrome 133+, Firefox 133+, Safari 18.2+.
+    const native = buf.toBase64;
+    if (typeof native === 'function')
+        return native.call(buf);
+    // Portable fallback: btoa is global in Node 16+ and all browsers.
+    let s = '';
+    for (let i = 0; i < buf.length; i++)
+        s += String.fromCharCode(buf[i]);
+    return btoa(s);
+}
+// CRC16 used by Zebra. Initial value 0 (not the usual 0xffff) to match the
+// printer's expectation.
+const crcTable = [
+    0x0000, 0x1021, 0x2042, 0x3063, 0x4084, 0x50a5, 0x60c6, 0x70e7, 0x8108, 0x9129, 0xa14a, 0xb16b,
+    0xc18c, 0xd1ad, 0xe1ce, 0xf1ef, 0x1231, 0x0210, 0x3273, 0x2252, 0x52b5, 0x4294, 0x72f7, 0x62d6,
+    0x9339, 0x8318, 0xb37b, 0xa35a, 0xd3bd, 0xc39c, 0xf3ff, 0xe3de, 0x2462, 0x3443, 0x0420, 0x1401,
+    0x64e6, 0x74c7, 0x44a4, 0x5485, 0xa56a, 0xb54b, 0x8528, 0x9509, 0xe5ee, 0xf5cf, 0xc5ac, 0xd58d,
+    0x3653, 0x2672, 0x1611, 0x0630, 0x76d7, 0x66f6, 0x5695, 0x46b4, 0xb75b, 0xa77a, 0x9719, 0x8738,
+    0xf7df, 0xe7fe, 0xd79d, 0xc7bc, 0x48c4, 0x58e5, 0x6886, 0x78a7, 0x0840, 0x1861, 0x2802, 0x3823,
+    0xc9cc, 0xd9ed, 0xe98e, 0xf9af, 0x8948, 0x9969, 0xa90a, 0xb92b, 0x5af5, 0x4ad4, 0x7ab7, 0x6a96,
+    0x1a71, 0x0a50, 0x3a33, 0x2a12, 0xdbfd, 0xcbdc, 0xfbbf, 0xeb9e, 0x9b79, 0x8b58, 0xbb3b, 0xab1a,
+    0x6ca6, 0x7c87, 0x4ce4, 0x5cc5, 0x2c22, 0x3c03, 0x0c60, 0x1c41, 0xedae, 0xfd8f, 0xcdec, 0xddcd,
+    0xad2a, 0xbd0b, 0x8d68, 0x9d49, 0x7e97, 0x6eb6, 0x5ed5, 0x4ef4, 0x3e13, 0x2e32, 0x1e51, 0x0e70,
+    0xff9f, 0xefbe, 0xdfdd, 0xcffc, 0xbf1b, 0xaf3a, 0x9f59, 0x8f78, 0x9188, 0x81a9, 0xb1ca, 0xa1eb,
+    0xd10c, 0xc12d, 0xf14e, 0xe16f, 0x1080, 0x00a1, 0x30c2, 0x20e3, 0x5004, 0x4025, 0x7046, 0x6067,
+    0x83b9, 0x9398, 0xa3fb, 0xb3da, 0xc33d, 0xd31c, 0xe37f, 0xf35e, 0x02b1, 0x1290, 0x22f3, 0x32d2,
+    0x4235, 0x5214, 0x6277, 0x7256, 0xb5ea, 0xa5cb, 0x95a8, 0x8589, 0xf56e, 0xe54f, 0xd52c, 0xc50d,
+    0x34e2, 0x24c3, 0x14a0, 0x0481, 0x7466, 0x6447, 0x5424, 0x4405, 0xa7db, 0xb7fa, 0x8799, 0x97b8,
+    0xe75f, 0xf77e, 0xc71d, 0xd73c, 0x26d3, 0x36f2, 0x0691, 0x16b0, 0x6657, 0x7676, 0x4615, 0x5634,
+    0xd94c, 0xc96d, 0xf90e, 0xe92f, 0x99c8, 0x89e9, 0xb98a, 0xa9ab, 0x5844, 0x4865, 0x7806, 0x6827,
+    0x18c0, 0x08e1, 0x3882, 0x28a3, 0xcb7d, 0xdb5c, 0xeb3f, 0xfb1e, 0x8bf9, 0x9bd8, 0xabbb, 0xbb9a,
+    0x4a75, 0x5a54, 0x6a37, 0x7a16, 0x0af1, 0x1ad0, 0x2ab3, 0x3a92, 0xfd2e, 0xed0f, 0xdd6c, 0xcd4d,
+    0xbdaa, 0xad8b, 0x9de8, 0x8dc9, 0x7c26, 0x6c07, 0x5c64, 0x4c45, 0x3ca2, 0x2c83, 0x1ce0, 0x0cc1,
+    0xef1f, 0xff3e, 0xcf5d, 0xdf7c, 0xaf9b, 0xbfba, 0x8fd9, 0x9ff8, 0x6e17, 0x7e36, 0x4e55, 0x5e74,
+    0x2e93, 0x3eb2, 0x0ed1, 0x1ef0,
+];
+function crc16(s) {
+    let crc = 0;
+    for (let i = 0; i < s.length; i++) {
+        const c = s.charCodeAt(i);
+        if (c > 255) {
+            throw new RangeError('crc16: non-byte character at offset ' + i);
+        }
+        const j = (c ^ (crc >> 8)) & 0xff;
+        crc = crcTable[j] ^ (crc << 8);
+    }
+    const hex = (crc & 0xffff).toString(16).toLowerCase();
+    return '0000'.slice(hex.length) + hex;
+}
+//# sourceMappingURL=z64.js.map

package/dist/z64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"z64.js","sourceRoot":"","sources":["../src/z64.ts"],"names":[],"mappings":"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AE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9F,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CACjC,CAAC;AAEF,SAAS,KAAK,CAAC,CAAS;IACpB,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;YACV,MAAM,IAAI,UAAU,CAAC,sCAAsC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QAClC,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACtD,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;AAC1C,CAAC"}

package/dist/zpl.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Tiny, dependency-free ZPL II label builder.
+ *
+ * Wraps one or more `^GFA` blocks (produced by `rgbaToZ64` / `rgbaToACS`
+ * via their `gfa` field, or by `imageToZ64` / `imageToACS`) in a complete
+ * `^XA ... ^XZ` payload with the most common printer-control directives:
+ *
+ *   `~SD` (set darkness), `^PR` (print rate), `^PQ` (quantity / copies),
+ *   `^FO` (field origin) and arbitrary pre/postlude ZPL for advanced use.
+ *
+ * The point of this module is so that **callers can stay completely
+ * ignorant of ZPL syntax** -- pass an image in, get bytes ready to write
+ * to TCP port 9100 out. No knowledge of `^XA`, `^GFA`, darkness scale,
+ * or print-rate units required.
+ */
+/**
+ * Options that decorate the generated ZPL with printer-control commands.
+ * Every field is optional -- omit to defer to the printer's stored
+ * defaults (configured from the LCD panel or via ZPL stored elsewhere).
+ */
+export interface ZplLabelOptions {
+    /**
+     * Media darkness, ZPL `~SD` command. Range `0.0`..`30.0` (in tenths;
+     * one decimal of precision). Values outside the range are clamped.
+     * Typical thermal-transfer setting is `10`..`20`.
+     *
+     * Omit to leave the printer at its stored darkness.
+     */
+    darkness?: number;
+    /**
+     * Print rate, ZPL `^PR` command. Inches/second on most Zebra
+     * desktop and tabletop printers; integer `1`..`14`. Values outside
+     * the range are clamped. Print, slew and backfeed rates are all
+     * set to the same value (mirroring the existing print-server
+     * conventions in metafloor/zpl-image-based stacks).
+     *
+     * Omit to leave the printer at its stored print rate.
+     */
+    printRate?: number;
+    /**
+     * Number of copies of the label, ZPL `^PQ` command. Positive
+     * integer; values `< 1` are coerced to `1`. Omit (or pass `1`) to
+     * print a single copy and skip emitting `^PQ` entirely.
+     */
+    copies?: number;
+    /**
+     * Field origin in dots, ZPL `^FO` command, emitted directly before
+     * the `^GFA` block. Useful for offsetting the graphic from the
+     * top-left of the label. Negative values are clamped to `0`.
+     *
+     * Omit to print the graphic at `(0, 0)` without emitting `^FO`.
+     */
+    fieldOrigin?: {
+        x: number;
+        y: number;
+    };
+    /**
+     * Raw ZPL inserted **immediately after `^XA`** and before any of
+     * the directives above. Use to set label dimensions (`^PW`,
+     * `^LL`), print mode (`^MM`), media tracking (`^MN`), etc. The
+     * string is concatenated verbatim -- caller is responsible for
+     * correctness.
+     */
+    prelude?: string;
+    /**
+     * Raw ZPL inserted **immediately before `^XZ`** (after the `^GFA`
+     * block and any `^PQ`). Use for end-of-label directives such as
+     * `^XB` (suppress backfeed) that some workflows need.
+     */
+    postlude?: string;
+}
+/**
+ * Build a complete ZPL payload from one or more `^GFA` graphic blocks.
+ *
+ * - Pass a single `gfa` string to produce a single `^XA...^XZ` label.
+ * - Pass an array (e.g. one entry per page rasterised from a PDF) to
+ *   produce one `^XA...^XZ` block per entry, joined with `\n`. The
+ *   same options apply to every label in the batch.
+ *
+ * The returned string is byte-for-byte ready to write to TCP port
+ * 9100, USB, or whichever transport your printer speaks.
+ *
+ * @example
+ * const res = await rgbaToZ64(rgba, width);
+ * const zpl = buildZpl(res.gfa, {darkness: 15, printRate: 4});
+ * // -> '^XA^PR4,A,A~SD15.0^GFA,...^XZ'
+ */
+export declare function buildZpl(gfa: string | readonly string[], opts?: ZplLabelOptions): string;
+//# sourceMappingURL=zpl.d.ts.map

package/dist/zpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zpl.d.ts","sourceRoot":"","sources":["../src/zpl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;IAErC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAAE,IAAI,GAAE,eAAoB,GAAG,MAAM,CAG5F"}

package/dist/zpl.js

@@ -0,0 +1,71 @@
+/**
+ * Tiny, dependency-free ZPL II label builder.
+ *
+ * Wraps one or more `^GFA` blocks (produced by `rgbaToZ64` / `rgbaToACS`
+ * via their `gfa` field, or by `imageToZ64` / `imageToACS`) in a complete
+ * `^XA ... ^XZ` payload with the most common printer-control directives:
+ *
+ *   `~SD` (set darkness), `^PR` (print rate), `^PQ` (quantity / copies),
+ *   `^FO` (field origin) and arbitrary pre/postlude ZPL for advanced use.
+ *
+ * The point of this module is so that **callers can stay completely
+ * ignorant of ZPL syntax** -- pass an image in, get bytes ready to write
+ * to TCP port 9100 out. No knowledge of `^XA`, `^GFA`, darkness scale,
+ * or print-rate units required.
+ */
+/**
+ * Build a complete ZPL payload from one or more `^GFA` graphic blocks.
+ *
+ * - Pass a single `gfa` string to produce a single `^XA...^XZ` label.
+ * - Pass an array (e.g. one entry per page rasterised from a PDF) to
+ *   produce one `^XA...^XZ` block per entry, joined with `\n`. The
+ *   same options apply to every label in the batch.
+ *
+ * The returned string is byte-for-byte ready to write to TCP port
+ * 9100, USB, or whichever transport your printer speaks.
+ *
+ * @example
+ * const res = await rgbaToZ64(rgba, width);
+ * const zpl = buildZpl(res.gfa, {darkness: 15, printRate: 4});
+ * // -> '^XA^PR4,A,A~SD15.0^GFA,...^XZ'
+ */
+export function buildZpl(gfa, opts = {}) {
+    const blocks = typeof gfa === 'string' ? [gfa] : gfa;
+    return blocks.map((g) => buildSingleLabel(g, opts)).join('\n');
+}
+function buildSingleLabel(gfa, opts) {
+    const parts = ['^XA'];
+    if (opts.prelude)
+        parts.push(opts.prelude);
+    if (opts.printRate !== undefined) {
+        const rate = clampInt(opts.printRate, 1, 14);
+        // ^PR<print>,<slew>,<backfeed> -- mirror all three to the same
+        // rate, which is the safe default the upstream print server uses.
+        parts.push(`^PR${rate},A,A`);
+    }
+    if (opts.darkness !== undefined) {
+        const dark = clampFloat(opts.darkness, 0, 30);
+        // ~SD accepts one decimal of precision.
+        parts.push(`~SD${dark.toFixed(1)}`);
+    }
+    if (opts.fieldOrigin) {
+        const x = Math.max(0, Math.trunc(opts.fieldOrigin.x));
+        const y = Math.max(0, Math.trunc(opts.fieldOrigin.y));
+        parts.push(`^FO${x},${y}`);
+    }
+    parts.push(gfa);
+    if (opts.copies !== undefined && opts.copies > 1) {
+        parts.push(`^PQ${Math.trunc(opts.copies)}`);
+    }
+    if (opts.postlude)
+        parts.push(opts.postlude);
+    parts.push('^XZ');
+    return parts.join('');
+}
+function clampInt(value, min, max) {
+    return Math.min(Math.max(Math.trunc(value), min), max);
+}
+function clampFloat(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+//# sourceMappingURL=zpl.js.map

package/dist/zpl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zpl.js","sourceRoot":"","sources":["../src/zpl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA6DH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,QAAQ,CAAC,GAA+B,EAAE,OAAwB,EAAE;IAChF,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,IAAqB;IACxD,MAAM,KAAK,GAAa,CAAC,KAAK,CAAC,CAAC;IAEhC,IAAI,IAAI,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE3C,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7C,+DAA+D;QAC/D,kEAAkE;QAClE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,wCAAwC;QACxC,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEhB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE7C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACrD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACvD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC"}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "zpl-image-ts",
+  "version": "1.0.0",
+  "description": "Image to Zebra ZPL: encode RGBA bitmaps to ^GFA (Z64 + ACS), wrap in ^XA…^XZ with darkness/print-rate/copies. TypeScript-native, isomorphic, tree-shakeable ESM port of metafloor/zpl-image.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./z64": {
+      "types": "./dist/z64.d.ts",
+      "import": "./dist/z64.js"
+    },
+    "./acs": {
+      "types": "./dist/acs.d.ts",
+      "import": "./dist/acs.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js"
+    },
+    "./zpl": {
+      "types": "./dist/zpl.d.ts",
+      "import": "./dist/zpl.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build && npm test",
+    "typecheck": "tsc -p tsconfig.check.json",
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\" \"*.{json,md}\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\" \"*.{json,md}\"",
+    "test": "vitest run",
+    "test:node": "vitest run --project node",
+    "test:browser": "vitest run --project browser",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "zebra",
+    "zpl",
+    "z64",
+    "gfa",
+    "label",
+    "label-printer",
+    "barcode",
+    "rgba",
+    "bitmap",
+    "typescript",
+    "esm"
+  ],
+  "author": "Mika Salminen",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/damischa1/zpl-image-ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/damischa1/zpl-image-ts/issues"
+  },
+  "homepage": "https://github.com/damischa1/zpl-image-ts#readme",
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^24.12.4",
+    "@vitest/browser": "^4.1.7",
+    "@vitest/browser-playwright": "^4.1.7",
+    "eslint": "^10.4.0",
+    "playwright": "^1.60.0",
+    "prettier": "^3.8.3",
+    "rimraf": "^6.1.2",
+    "typescript": "^6.0.0",
+    "typescript-eslint": "^8.49.0",
+    "vitest": "^4.1.7"
+  }
+}