@zebrash/core 0.1.0 → 0.1.4

package/dist/svg/font_embed.d.ts

@@ -0,0 +1,12 @@
+import type { SvgFontEmbedMode } from "../drawer-options.ts";
+import { type FontKey } from "../assets/fonts.ts";
+/**
+ * Build the `<style>` body that goes inside the SVG's `<defs>` for the
+ * fonts the label actually uses.
+ *
+ * `mode === "url"`  → `@font-face { src: url("<cdn>/font.ttf") format("truetype"); }`
+ * `mode === "embed"` → `@font-face { src: url("data:font/ttf;base64,…") format("truetype"); }`
+ * `mode === "none"` → empty string (caller's `<text font-family>` is on its own).
+ */
+export declare function buildFontFaceCss(usedFonts: ReadonlySet<FontKey>, mode: SvgFontEmbedMode): Promise<string>;
+//# sourceMappingURL=font_embed.d.ts.map

package/dist/svg/font_embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"font_embed.d.ts","sourceRoot":"","sources":["../../src/svg/font_embed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,KAAK,OAAO,EAAoD,MAAM,oBAAoB,CAAC;AAUpG;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,EAC/B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/dist/svg/font_embed.js

@@ -0,0 +1,61 @@
+import { getEmbeddedFont, getFontBaseUrl, getFontFilename } from "../assets/fonts.js";
+import { EmbeddedFontFamilies } from "../assets/register.js";
+const familyByKey = {
+    HelveticaBold: EmbeddedFontFamilies.HelveticaBold,
+    DejavuSansMono: EmbeddedFontFamilies.DejavuSansMono,
+    DejavuSansMonoBold: EmbeddedFontFamilies.DejavuSansMonoBold,
+    ZplGS: EmbeddedFontFamilies.ZplGS,
+};
+/**
+ * Build the `<style>` body that goes inside the SVG's `<defs>` for the
+ * fonts the label actually uses.
+ *
+ * `mode === "url"`  → `@font-face { src: url("<cdn>/font.ttf") format("truetype"); }`
+ * `mode === "embed"` → `@font-face { src: url("data:font/ttf;base64,…") format("truetype"); }`
+ * `mode === "none"` → empty string (caller's `<text font-family>` is on its own).
+ */
+export async function buildFontFaceCss(usedFonts, mode) {
+    if (mode === "none" || usedFonts.size === 0)
+        return "";
+    if (mode === "url") {
+        const base = getFontBaseUrl();
+        const rules = [...usedFonts].map((key) => {
+            const url = base + getFontFilename(key);
+            return faceRule(familyByKey[key], `url("${url}") format("truetype")`);
+        });
+        return wrap(rules);
+    }
+    // mode === "embed"
+    const rules = await Promise.all([...usedFonts].map(async (key) => {
+        const bytes = await getEmbeddedFont(key);
+        const b64 = base64Encode(bytes);
+        return faceRule(familyByKey[key], `url("data:font/ttf;base64,${b64}") format("truetype")`);
+    }));
+    return wrap(rules);
+}
+function faceRule(family, src) {
+    return `@font-face{font-family:"${family}";src:${src};font-weight:normal;font-style:normal;}`;
+}
+function wrap(rules) {
+    return `<style>${rules.join("")}</style>`;
+}
+/**
+ * Universal base64 encoder. Uses `Buffer` on Node (faster, handles huge
+ * inputs without repeated string concat), falls back to `btoa(String
+ * .fromCharCode(...))` chunked-loop on the browser. The `fromCharCode`
+ * spread is chunked to stay under the JS engine's argument-count limit on
+ * very large arrays.
+ */
+function base64Encode(bytes) {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(bytes).toString("base64");
+    }
+    let bin = "";
+    const chunk = 0x8000;
+    for (let i = 0; i < bytes.length; i += chunk) {
+        const slice = bytes.subarray(i, Math.min(i + chunk, bytes.length));
+        bin += String.fromCharCode(...slice);
+    }
+    return btoa(bin);
+}
+//# sourceMappingURL=font_embed.js.map

package/dist/svg-drawers/barcode_128.d.ts

@@ -0,0 +1,3 @@
+import type { SvgElementDrawer } from "./svg_element_drawer.ts";
+export declare function newBarcode128SvgDrawer(): SvgElementDrawer;
+//# sourceMappingURL=barcode_128.d.ts.map

package/dist/svg-drawers/barcode_128.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcode_128.d.ts","sourceRoot":"","sources":["../../src/svg-drawers/barcode_128.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAehE,wBAAgB,sBAAsB,IAAI,gBAAgB,CAsDzD"}

package/dist/svg-drawers/barcode_128.js

@@ -0,0 +1,74 @@
+// SVG analogue of `drawers/barcode_128.ts`.
+import { ESCAPE_FNC_1, encodeCode128Auto, encodeCode128NoMode } from "../barcodes/code128/index.js";
+import { adjustImageTypeSetPosition } from "../drawers/element_drawer.js";
+import { BarcodeModeEan, BarcodeModeNo, BarcodeModeUcc, } from "../elements/index.js";
+import { paintBitArrayBarsSvg, paintHumanReadableTextSvg } from "./barcode_paint_svg.js";
+import { rotateForOrientation } from "./transform.js";
+const PARENS_AND_SPACES = /[()\s]+/g;
+export function newBarcode128SvgDrawer() {
+    return {
+        draw(emitter, element) {
+            const barcode = element;
+            if (!barcode || barcode._kind !== "Barcode128WithData")
+                return;
+            let content = barcode.data;
+            let text = barcode.data;
+            if (barcode.mode === BarcodeModeEan) {
+                const ean = modifyBarcodeContentEanMode(content);
+                content = ean.content;
+                text = ean.text;
+            }
+            else if (barcode.mode === BarcodeModeUcc) {
+                content = modifyBarcodeContentUccMode(content);
+            }
+            const moduleWidth = Math.max(barcode.width, 1);
+            const moduleHeight = Math.max(barcode.height, 1);
+            let bits;
+            if (barcode.mode === BarcodeModeNo) {
+                const out = encodeCode128NoMode(content);
+                bits = [...out.bits];
+                text = out.humanReadable;
+            }
+            else {
+                const out = encodeCode128Auto(content);
+                bits = [...out.bits];
+            }
+            const width = bits.length * moduleWidth;
+            const height = moduleHeight;
+            const pos = adjustImageTypeSetPosition(width, height, barcode.position, barcode.orientation);
+            emitter.save();
+            try {
+                rotateForOrientation(emitter, width, height, pos, barcode.orientation);
+                paintBitArrayBarsSvg(emitter, bits, pos, moduleWidth, height);
+                if (barcode.line) {
+                    paintHumanReadableTextSvg(emitter, text, pos, barcode.lineAbove, moduleWidth, width, height);
+                }
+            }
+            finally {
+                emitter.restore();
+            }
+        },
+    };
+}
+function modifyBarcodeContentEanMode(content) {
+    const text = content.replaceAll(">8", "");
+    let next = content.replace(PARENS_AND_SPACES, "");
+    next = next.replaceAll(">8", ESCAPE_FNC_1);
+    if (!next.startsWith(ESCAPE_FNC_1))
+        next = ESCAPE_FNC_1 + next;
+    return { content: next, text };
+}
+function modifyBarcodeContentUccMode(content) {
+    const padded = content.padStart(19, "0").slice(0, 19);
+    const checksumDigit = calculateUccBarcodeChecksumDigit(padded);
+    return ESCAPE_FNC_1 + padded + checksumDigit;
+}
+function calculateUccBarcodeChecksumDigit(content) {
+    let checksum = 0;
+    for (let i = 0; i < 19; i++) {
+        const code = content.charCodeAt(i) - 48;
+        checksum += code * ((i % 2) * 2 + 7);
+    }
+    return checksum % 10;
+}
+//# sourceMappingURL=barcode_128.js.map

package/dist/svg-drawers/barcode_2of5.d.ts

@@ -0,0 +1,3 @@
+import type { SvgElementDrawer } from "./svg_element_drawer.ts";
+export declare function newBarcode2of5SvgDrawer(): SvgElementDrawer;
+//# sourceMappingURL=barcode_2of5.d.ts.map

package/dist/svg-drawers/barcode_2of5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcode_2of5.d.ts","sourceRoot":"","sources":["../../src/svg-drawers/barcode_2of5.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAShE,wBAAgB,uBAAuB,IAAI,gBAAgB,CAsC1D"}

package/dist/svg-drawers/barcode_2of5.js

@@ -0,0 +1,36 @@
+// SVG analogue of `drawers/barcode_2of5.ts`.
+import { encodeInterleaved2of5 } from "../barcodes/twooffive/index.js";
+import { adjustImageTypeSetPosition } from "../drawers/element_drawer.js";
+import { paintBitArrayBarsSvg, paintHumanReadableTextSvg } from "./barcode_paint_svg.js";
+import { rotateForOrientation } from "./transform.js";
+const NON_DIGIT = /[^0-9]+/g;
+export function newBarcode2of5SvgDrawer() {
+    return {
+        draw(emitter, element) {
+            const barcode = element;
+            if (!barcode || barcode._kind !== "Barcode2of5WithData")
+                return;
+            const content = barcode.data.replace(NON_DIGIT, "");
+            const moduleWidth = Math.max(barcode.width, 1);
+            const moduleHeight = Math.max(barcode.height, 1);
+            const result = encodeInterleaved2of5(content, barcode.checkDigit);
+            const bits = result.bits;
+            const text = result.content;
+            const width = bits.length * moduleWidth;
+            const height = moduleHeight;
+            const pos = adjustImageTypeSetPosition(width, height, barcode.position, barcode.orientation);
+            emitter.save();
+            try {
+                rotateForOrientation(emitter, width, height, pos, barcode.orientation);
+                paintBitArrayBarsSvg(emitter, bits, pos, moduleWidth, height);
+                if (barcode.line) {
+                    paintHumanReadableTextSvg(emitter, text, pos, barcode.lineAbove, moduleWidth, width, height);
+                }
+            }
+            finally {
+                emitter.restore();
+            }
+        },
+    };
+}
+//# sourceMappingURL=barcode_2of5.js.map

package/dist/svg-drawers/barcode_39.d.ts

@@ -0,0 +1,3 @@
+import type { SvgElementDrawer } from "./svg_element_drawer.ts";
+export declare function newBarcode39SvgDrawer(): SvgElementDrawer;
+//# sourceMappingURL=barcode_39.d.ts.map

package/dist/svg-drawers/barcode_39.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcode_39.d.ts","sourceRoot":"","sources":["../../src/svg-drawers/barcode_39.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAOhE,wBAAgB,qBAAqB,IAAI,gBAAgB,CAqCxD"}

package/dist/svg-drawers/barcode_39.js

@@ -0,0 +1,34 @@
+// SVG analogue of `drawers/barcode_39.ts`.
+import { encodeCode39 } from "../barcodes/code39/index.js";
+import { adjustImageTypeSetPosition } from "../drawers/element_drawer.js";
+import { paintBitArrayBarsSvg, paintHumanReadableTextSvg } from "./barcode_paint_svg.js";
+import { rotateForOrientation } from "./transform.js";
+export function newBarcode39SvgDrawer() {
+    return {
+        draw(emitter, element) {
+            const barcode = element;
+            if (!barcode || barcode._kind !== "Barcode39WithData")
+                return;
+            const content = barcode.data;
+            const text = `*${barcode.data}*`;
+            const moduleWidth = Math.max(barcode.width, 1);
+            const moduleHeight = Math.max(barcode.height, 1);
+            const bits = encodeCode39(content);
+            const width = bits.length * moduleWidth;
+            const height = moduleHeight;
+            const pos = adjustImageTypeSetPosition(width, height, barcode.position, barcode.orientation);
+            emitter.save();
+            try {
+                rotateForOrientation(emitter, width, height, pos, barcode.orientation);
+                paintBitArrayBarsSvg(emitter, bits, pos, moduleWidth, height);
+                if (barcode.line) {
+                    paintHumanReadableTextSvg(emitter, text, pos, barcode.lineAbove, moduleWidth, width, height);
+                }
+            }
+            finally {
+                emitter.restore();
+            }
+        },
+    };
+}
+//# sourceMappingURL=barcode_39.js.map

package/dist/svg-drawers/barcode_aztec.d.ts

@@ -0,0 +1,3 @@
+import type { SvgElementDrawer } from "./svg_element_drawer.ts";
+export declare function newBarcodeAztecSvgDrawer(): SvgElementDrawer;
+//# sourceMappingURL=barcode_aztec.d.ts.map

package/dist/svg-drawers/barcode_aztec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcode_aztec.d.ts","sourceRoot":"","sources":["../../src/svg-drawers/barcode_aztec.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAahE,wBAAgB,wBAAwB,IAAI,gBAAgB,CAwC3D"}

package/dist/svg-drawers/barcode_aztec.js

@@ -0,0 +1,48 @@
+// SVG analogue of `drawers/barcode_aztec.ts`.
+import { AZTEC_DEFAULT_EC_PERCENT, AZTEC_DEFAULT_LAYERS, encodeAztec, } from "../barcodes/aztec/index.js";
+import { adjustImageTypeSetPosition } from "../drawers/element_drawer.js";
+import { paintBitMatrixCellsSvg } from "./barcode_paint_svg.js";
+import { rotateForOrientation } from "./transform.js";
+const SIZE_FULL_RANGE_OFFSET = 200;
+export function newBarcodeAztecSvgDrawer() {
+    return {
+        draw(emitter, element) {
+            const barcode = element;
+            if (!barcode || barcode._kind !== "BarcodeAztecWithData")
+                return;
+            let layers = AZTEC_DEFAULT_LAYERS;
+            let minECCPercent = AZTEC_DEFAULT_EC_PERCENT;
+            if (barcode.size > 0) {
+                if (barcode.size >= SIZE_FULL_RANGE_OFFSET && barcode.size <= SIZE_FULL_RANGE_OFFSET + 32) {
+                    layers = barcode.size - SIZE_FULL_RANGE_OFFSET;
+                }
+                else if (barcode.size >= 1 && barcode.size <= 99) {
+                    minECCPercent = barcode.size;
+                }
+                else if (barcode.size >= 101 && barcode.size <= 104) {
+                    layers = -(barcode.size - 100);
+                }
+                else {
+                    throw new Error(`aztec barcode size/mode ${barcode.size} is not supported`);
+                }
+            }
+            const magnification = Math.max(barcode.magnification, 1);
+            const matrix = encodeAztec(new TextEncoder().encode(barcode.data), {
+                minECCPercent,
+                userSpecifiedLayers: layers,
+            });
+            const width = matrix.width * magnification;
+            const height = matrix.height * magnification;
+            const pos = adjustImageTypeSetPosition(width, height, barcode.position, barcode.orientation);
+            emitter.save();
+            try {
+                rotateForOrientation(emitter, width, height, pos, barcode.orientation);
+                paintBitMatrixCellsSvg(emitter, matrix, pos, magnification);
+            }
+            finally {
+                emitter.restore();
+            }
+        },
+    };
+}
+//# sourceMappingURL=barcode_aztec.js.map

package/dist/svg-drawers/barcode_datamatrix.d.ts

@@ -0,0 +1,3 @@
+import type { SvgElementDrawer } from "./svg_element_drawer.ts";
+export declare function newBarcodeDatamatrixSvgDrawer(): SvgElementDrawer;
+//# sourceMappingURL=barcode_datamatrix.d.ts.map

package/dist/svg-drawers/barcode_datamatrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcode_datamatrix.d.ts","sourceRoot":"","sources":["../../src/svg-drawers/barcode_datamatrix.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAWhE,wBAAgB,6BAA6B,IAAI,gBAAgB,CAsChE"}

package/dist/svg-drawers/barcode_datamatrix.js

@@ -0,0 +1,44 @@
+// SVG analogue of `drawers/barcode_datamatrix.ts`.
+import { SymbolShapeHint } from "../barcodes/datamatrix/encoder/symbol_shape_hint.js";
+import { encodeDatamatrix } from "../barcodes/datamatrix/index.js";
+import { adjustImageTypeSetPosition } from "../drawers/element_drawer.js";
+import { DatamatrixRatioRectangular } from "../elements/index.js";
+import { paintBitMatrixCellsSvg } from "./barcode_paint_svg.js";
+import { rotateForOrientation } from "./transform.js";
+const GS_BYTE = String.fromCharCode(29);
+export function newBarcodeDatamatrixSvgDrawer() {
+    return {
+        draw(emitter, element) {
+            const barcode = element;
+            if (!barcode || barcode._kind !== "BarcodeDatamatrixWithData")
+                return;
+            const columns = Math.max(barcode.columns, 1);
+            const rows = Math.max(barcode.rows, 1);
+            const shape = barcode.ratio === DatamatrixRatioRectangular
+                ? SymbolShapeHint.FORCE_RECTANGLE
+                : SymbolShapeHint.FORCE_SQUARE;
+            let data = barcode.data;
+            const fnc1 = `${barcode.escape}1`;
+            let gs1 = false;
+            if (data.startsWith(fnc1)) {
+                gs1 = true;
+                data = data.slice(fnc1.length);
+            }
+            data = data.replaceAll(fnc1, GS_BYTE);
+            const matrix = encodeDatamatrix(data, columns, rows, { shape, gs1 });
+            const scale = Math.max(barcode.height, 1);
+            const width = matrix.width * scale;
+            const height = matrix.height * scale;
+            const pos = adjustImageTypeSetPosition(width, height, barcode.position, barcode.orientation);
+            emitter.save();
+            try {
+                rotateForOrientation(emitter, width, height, pos, barcode.orientation);
+                paintBitMatrixCellsSvg(emitter, matrix, pos, scale);
+            }
+            finally {
+                emitter.restore();
+            }
+        },
+    };
+}
+//# sourceMappingURL=barcode_datamatrix.js.map

package/dist/svg-drawers/barcode_ean13.d.ts

@@ -0,0 +1,3 @@
+import type { SvgElementDrawer } from "./svg_element_drawer.ts";
+export declare function newBarcodeEan13SvgDrawer(): SvgElementDrawer;
+//# sourceMappingURL=barcode_ean13.d.ts.map

package/dist/svg-drawers/barcode_ean13.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcode_ean13.d.ts","sourceRoot":"","sources":["../../src/svg-drawers/barcode_ean13.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAqBhE,wBAAgB,wBAAwB,IAAI,gBAAgB,CAwC3D"}

package/dist/svg-drawers/barcode_ean13.js

@@ -0,0 +1,76 @@
+// SVG analogue of `drawers/barcode_ean13.ts`.
+import { calculateEan13GuardExtension, encodeEan13, isGuardBar, sanitizeContent, } from "../barcodes/ean13/index.js";
+import { adjustImageTypeSetPosition } from "../drawers/element_drawer.js";
+import { FieldOrientation90, FieldOrientation180, } from "../elements/index.js";
+import { paintEan13TextSvg } from "./barcode_paint_svg.js";
+import { rotateForOrientation } from "./transform.js";
+const BLACK = "#000000";
+export function newBarcodeEan13SvgDrawer() {
+    return {
+        draw(emitter, element) {
+            const barcode = element;
+            if (!barcode || barcode._kind !== "BarcodeEan13WithData")
+                return;
+            const moduleWidth = Math.max(barcode.width, 1);
+            const moduleHeight = Math.max(barcode.height, 1);
+            const text = sanitizeContent(barcode.data);
+            const bits = encodeEan13(text);
+            if (bits === null)
+                return;
+            const width = bits.length * moduleWidth;
+            const height = moduleHeight;
+            const guardExtension = calculateEan13GuardExtension(moduleWidth);
+            let pos = adjustImageTypeSetPosition(width, height, barcode.position, barcode.orientation);
+            pos = adjustEan13Position(pos, barcode.orientation, guardExtension);
+            emitter.save();
+            try {
+                rotateForOrientation(emitter, width, height, pos, barcode.orientation);
+                paintEan13BarsSvg(emitter, bits, pos, moduleWidth, height, guardExtension);
+                if (barcode.line) {
+                    paintEan13TextSvg(emitter, text, pos, barcode.lineAbove, width, height, moduleWidth, guardExtension);
+                }
+            }
+            finally {
+                emitter.restore();
+            }
+        },
+    };
+}
+/**
+ * EAN-13 bar painting: guard bars (start, middle, end groups) extend the
+ * full `barHeight + guardExtension`; data bars stop at `barHeight` so the
+ * digits sit in the remaining white space.
+ *
+ * Two-height variant precludes the run-collapse trick used elsewhere —
+ * adjacent bars may differ in height, so we emit them per-module.
+ */
+function paintEan13BarsSvg(emitter, bits, pos, moduleWidth, barHeight, guardExtension) {
+    const len = bits.length;
+    for (let i = 0; i < len; i++) {
+        if (!bits.at(i))
+            continue;
+        const x = pos.x + i * moduleWidth;
+        const h = isGuardBar(i) ? barHeight + guardExtension : barHeight;
+        emitter.rect(x, pos.y, moduleWidth, h, BLACK);
+    }
+}
+function adjustEan13Position(pos, ori, guardExtension) {
+    if (pos.calculateFromBottom)
+        return pos;
+    let { x, y } = pos;
+    switch (ori) {
+        case FieldOrientation90:
+            x -= guardExtension;
+            break;
+        case FieldOrientation180:
+            y -= guardExtension;
+            break;
+    }
+    return {
+        x,
+        y,
+        calculateFromBottom: pos.calculateFromBottom,
+        automaticPosition: pos.automaticPosition,
+    };
+}
+//# sourceMappingURL=barcode_ean13.js.map

package/dist/svg-drawers/barcode_paint_svg.d.ts

@@ -0,0 +1,35 @@
+import type { BitMatrix } from "../barcodes/utils/index.ts";
+import type { LabelPosition } from "../elements/index.ts";
+import type { SvgEmitter } from "../svg/emitter.ts";
+/** Minimal shape for any 1D bit sequence painter input — same as canvas helper. */
+export interface BitSequence {
+    readonly length: number;
+    at(i: number): boolean | undefined;
+}
+/**
+ * Walk a 1D bit pattern and emit vertical bars `moduleWidth` wide and
+ * `barHeight` tall, starting at `pos`. Adjacent dark modules merge into a
+ * single wider `<rect>`.
+ */
+export declare function paintBitArrayBarsSvg(emitter: SvgEmitter, bits: BitSequence | readonly boolean[], pos: LabelPosition, moduleWidth: number, barHeight: number): void;
+/**
+ * Walk a 2D bit matrix and emit cells. `moduleSize` is the cell width;
+ * `moduleHeight` defaults to a square cell (used by QR/Aztec/DataMatrix)
+ * but can be passed separately for PDF417 where rows are taller than they
+ * are wide. Horizontally adjacent dark cells in a row collapse into one
+ * `<rect>`.
+ */
+export declare function paintBitMatrixCellsSvg(emitter: SvgEmitter, matrix: BitMatrix, pos: LabelPosition, moduleSize: number, moduleHeight?: number): void;
+/**
+ * Render the barcode's human-readable line below (or above) the bars.
+ * Mirrors `paintHumanReadableText` on the canvas side.
+ */
+export declare function paintHumanReadableTextSvg(emitter: SvgEmitter, text: string, pos: LabelPosition, lineAbove: boolean, barWidth: number, width: number, height: number): void;
+/**
+ * EAN-13's specialised human-readable rendering. Mirrors `paintEan13Text`
+ * on the canvas side, including the layout where the first digit sits to
+ * the LEFT of the bars and the remaining 12 are split into two groups of
+ * six centred under each half of the bars.
+ */
+export declare function paintEan13TextSvg(emitter: SvgEmitter, text: string, pos: LabelPosition, lineAbove: boolean, width: number, height: number, barWidth: number, guardExtension: number): void;
+//# sourceMappingURL=barcode_paint_svg.d.ts.map

package/dist/svg-drawers/barcode_paint_svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcode_paint_svg.d.ts","sourceRoot":"","sources":["../../src/svg-drawers/barcode_paint_svg.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAYpD,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,WAAW,GAAG,SAAS,OAAO,EAAE,EACtC,GAAG,EAAE,aAAa,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,IAAI,CA6BN;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAAmB,GAChC,IAAI,CA+BN;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,CAWN;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,IAAI,CAwDN"}

package/dist/svg-drawers/barcode_paint_svg.js

@@ -0,0 +1,144 @@
+// SVG analogues of the canvas helpers in `drawers/barcode_paint.ts`.
+//
+// Two notable differences from the canvas versions:
+//   1. Adjacent dark cells in a row collapse into a single wider `<rect>`.
+//      A QR code with several thousand modules would otherwise emit one
+//      element per dark cell — runs are typically 10×–100× more compact.
+//   2. Text uses the SVG `<text>` element with a tracked `FontKey` so the
+//      drawer can emit a matching `@font-face` rule once.
+import { EmbeddedFontFamilies, FONT0_NAME, FONT1_NAME } from "../assets/index.js";
+const BLACK = "#000000";
+// Map canvas family-name aliases → FontKey for SvgEmitter font-tracking.
+const FONT_KEY_FOR_FAMILY = new Map([
+    [EmbeddedFontFamilies.HelveticaBold, "HelveticaBold"],
+    [EmbeddedFontFamilies.DejavuSansMono, "DejavuSansMono"],
+]);
+/**
+ * Walk a 1D bit pattern and emit vertical bars `moduleWidth` wide and
+ * `barHeight` tall, starting at `pos`. Adjacent dark modules merge into a
+ * single wider `<rect>`.
+ */
+export function paintBitArrayBarsSvg(emitter, bits, pos, moduleWidth, barHeight) {
+    const seq = bits;
+    const len = seq.length;
+    let runStart = -1;
+    for (let i = 0; i < len; i++) {
+        const on = seq.at(i) === true;
+        if (on && runStart < 0) {
+            runStart = i;
+        }
+        else if (!on && runStart >= 0) {
+            emitter.rect(pos.x + runStart * moduleWidth, pos.y, (i - runStart) * moduleWidth, barHeight, BLACK);
+            runStart = -1;
+        }
+    }
+    if (runStart >= 0) {
+        emitter.rect(pos.x + runStart * moduleWidth, pos.y, (len - runStart) * moduleWidth, barHeight, BLACK);
+    }
+}
+/**
+ * Walk a 2D bit matrix and emit cells. `moduleSize` is the cell width;
+ * `moduleHeight` defaults to a square cell (used by QR/Aztec/DataMatrix)
+ * but can be passed separately for PDF417 where rows are taller than they
+ * are wide. Horizontally adjacent dark cells in a row collapse into one
+ * `<rect>`.
+ */
+export function paintBitMatrixCellsSvg(emitter, matrix, pos, moduleSize, moduleHeight = moduleSize) {
+    const moduleW = moduleSize;
+    const moduleH = moduleHeight;
+    for (let r = 0; r < matrix.height; r++) {
+        let runStart = -1;
+        for (let c = 0; c < matrix.width; c++) {
+            const on = matrix.at(c, r);
+            if (on && runStart < 0) {
+                runStart = c;
+            }
+            else if (!on && runStart >= 0) {
+                emitter.rect(pos.x + runStart * moduleW, pos.y + r * moduleH, (c - runStart) * moduleW, moduleH, BLACK);
+                runStart = -1;
+            }
+        }
+        if (runStart >= 0) {
+            emitter.rect(pos.x + runStart * moduleW, pos.y + r * moduleH, (matrix.width - runStart) * moduleW, moduleH, BLACK);
+        }
+    }
+}
+/**
+ * Render the barcode's human-readable line below (or above) the bars.
+ * Mirrors `paintHumanReadableText` on the canvas side.
+ */
+export function paintHumanReadableTextSvg(emitter, text, pos, lineAbove, barWidth, width, height) {
+    const fontSize = Math.max(barWidth, 1) * 10;
+    const x = pos.x + width / 2;
+    const y = lineAbove ? pos.y - fontSize / 2 : pos.y + height + fontSize;
+    emitter.text(x, y, text, {
+        fontFamily: FONT1_NAME,
+        fontKey: FONT_KEY_FOR_FAMILY.get(FONT1_NAME),
+        fontSize,
+        anchor: "middle",
+        fill: BLACK,
+    });
+}
+/**
+ * EAN-13's specialised human-readable rendering. Mirrors `paintEan13Text`
+ * on the canvas side, including the layout where the first digit sits to
+ * the LEFT of the bars and the remaining 12 are split into two groups of
+ * six centred under each half of the bars.
+ */
+export function paintEan13TextSvg(emitter, text, pos, lineAbove, width, height, barWidth, guardExtension) {
+    const fontSize = Math.round(width / 13);
+    const family = FONT0_NAME;
+    const fontKey = FONT_KEY_FOR_FAMILY.get(FONT0_NAME);
+    if (text.length === 13 && !lineAbove) {
+        // Mirrors the canvas drawer's anchor placement: text top sits below the
+        // data-bar baseline; SVG `dominant-baseline: text-top` gives us the
+        // same anchor as canvas's `textBaseline = "top"`.
+        const y = pos.y + height + fontSize - guardExtension;
+        const first = text[0];
+        const left = text.slice(1, 7);
+        const right = text.slice(7, 13);
+        emitter.text(pos.x - barWidth * 2, y, first, {
+            fontFamily: family,
+            fontKey,
+            fontSize,
+            anchor: "middle",
+            baseline: "text-top",
+            fill: BLACK,
+        });
+        for (let k = 0; k < 6; k++) {
+            const cx = pos.x + (3 + k * 7 + 3.5) * barWidth;
+            emitter.text(cx, y, left[k], {
+                fontFamily: family,
+                fontKey,
+                fontSize,
+                anchor: "middle",
+                baseline: "text-top",
+                fill: BLACK,
+            });
+        }
+        for (let k = 0; k < 6; k++) {
+            const cx = pos.x + (50 + k * 7 + 3.5) * barWidth;
+            emitter.text(cx, y, right[k], {
+                fontFamily: family,
+                fontKey,
+                fontSize,
+                anchor: "middle",
+                baseline: "text-top",
+                fill: BLACK,
+            });
+        }
+    }
+    else {
+        const x = pos.x + width / 2;
+        const y = pos.y - guardExtension / 2 - fontSize;
+        emitter.text(x, y, text, {
+            fontFamily: family,
+            fontKey,
+            fontSize,
+            anchor: "middle",
+            baseline: "text-top",
+            fill: BLACK,
+        });
+    }
+}
+//# sourceMappingURL=barcode_paint_svg.js.map

package/dist/svg-drawers/barcode_pdf417.d.ts

@@ -0,0 +1,3 @@
+import type { SvgElementDrawer } from "./svg_element_drawer.ts";
+export declare function newBarcodePdf417SvgDrawer(): SvgElementDrawer;
+//# sourceMappingURL=barcode_pdf417.d.ts.map

package/dist/svg-drawers/barcode_pdf417.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcode_pdf417.d.ts","sourceRoot":"","sources":["../../src/svg-drawers/barcode_pdf417.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAuBhE,wBAAgB,yBAAyB,IAAI,gBAAgB,CA+B5D"}