text-compress 2.0.0

package/dist/encoding/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @module encoding
+ *
+ * Facade that selects Base64 or Z85 encoding based on the {@link Encoding}
+ * discriminator. Higher layers (compression API, streaming pipeline) call
+ * only `encodeBuffer` / `decodeBuffer` — they never import z85 or base64
+ * directly.
+ *
+ * ## Strategy pattern
+ *
+ * This is a simple strategy pattern: the `encoding` parameter picks the
+ * algorithm at runtime without branching scattered across the codebase.
+ */
+import type { Encoding } from "../types.js";
+/** Encode a binary buffer to a pasteable text string. */
+export declare function encodeBuffer(buffer: Buffer, encoding: Encoding): string;
+/** Decode a pasteable text string back to a binary buffer. */
+export declare function decodeBuffer(str: string, encoding: Encoding): Buffer;
+/**
+ * Estimate the character length of an encoded string without encoding.
+ *
+ * Used by the streaming pipeline to pre-calculate split part counts
+ * before writing files to disk.
+ *
+ * - Base64: `ceil(bytes / 3) × 4`
+ * - Z85: accounts for the 1-byte pad prefix and block padding
+ */
+export declare function estimatedEncodedLength(binaryBytes: number, encoding: Encoding): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/encoding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/encoding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAI3C,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAIvE;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAIpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAItF"}

package/dist/encoding/index.js

@@ -0,0 +1,47 @@
+/**
+ * @module encoding
+ *
+ * Facade that selects Base64 or Z85 encoding based on the {@link Encoding}
+ * discriminator. Higher layers (compression API, streaming pipeline) call
+ * only `encodeBuffer` / `decodeBuffer` — they never import z85 or base64
+ * directly.
+ *
+ * ## Strategy pattern
+ *
+ * This is a simple strategy pattern: the `encoding` parameter picks the
+ * algorithm at runtime without branching scattered across the codebase.
+ */
+import { decodeBase64, encodeBase64 } from "./base64.js";
+import { decodeBase85, encodeBase85 } from "./z85.js";
+/** Encode a binary buffer to a pasteable text string. */
+export function encodeBuffer(buffer, encoding) {
+    if (encoding === 64)
+        return encodeBase64(buffer);
+    if (encoding === 85)
+        return encodeBase85(buffer);
+    throw new Error(`Unsupported encoding: ${encoding}`);
+}
+/** Decode a pasteable text string back to a binary buffer. */
+export function decodeBuffer(str, encoding) {
+    if (encoding === 64)
+        return decodeBase64(str);
+    if (encoding === 85)
+        return decodeBase85(str);
+    throw new Error(`Unsupported encoding: ${encoding}`);
+}
+/**
+ * Estimate the character length of an encoded string without encoding.
+ *
+ * Used by the streaming pipeline to pre-calculate split part counts
+ * before writing files to disk.
+ *
+ * - Base64: `ceil(bytes / 3) × 4`
+ * - Z85: accounts for the 1-byte pad prefix and block padding
+ */
+export function estimatedEncodedLength(binaryBytes, encoding) {
+    if (encoding === 64)
+        return Math.ceil(binaryBytes / 3) * 4;
+    const padded = 1 + binaryBytes + ((4 - ((binaryBytes + 1) % 4)) % 4);
+    return (padded / 4) * 5;
+}
+//# sourceMappingURL=index.js.map

package/dist/encoding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/encoding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAErD,yDAAyD;AACzD,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,QAAkB;IAC7D,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAA;IAChD,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAA;IAChD,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAA;AACtD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,QAAkB;IAC1D,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,YAAY,CAAC,GAAG,CAAC,CAAA;IAC7C,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,YAAY,CAAC,GAAG,CAAC,CAAA;IAC7C,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAA;AACtD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB,EAAE,QAAkB;IAC5E,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;IAC1D,MAAM,MAAM,GAAG,CAAC,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACpE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;AACzB,CAAC"}

package/dist/encoding/z85.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @module encoding/z85
+ *
+ * Z85 (ZeroMQ RFC 32) Base85 encoder and decoder.
+ *
+ * ## Why Z85 instead of Ascii85?
+ *
+ * Standard Ascii85 uses `"` and `\` — characters that break when pasted
+ * into chat or JSON strings. Z85 picks an alphabet of 85 printable ASCII
+ * characters that avoid quotes, backslashes, and backticks, making the
+ * output safe to paste verbatim into most code contexts.
+ *
+ * ## Algorithm (base-85 positional encoding)
+ *
+ * Z85 groups input into 4-byte blocks and maps each block to 5 printable
+ * characters:
+ *
+ * ```
+ *   value = b0·256³ + b1·256² + b2·256 + b3     (0 ≤ value < 256⁴)
+ *   char[j] = alphabet[value mod 85]             (j = 4 … 0)
+ *   value   = floor(value / 85)
+ * ```
+ *
+ * Decoding reverses the process: 5 characters → one 32-bit value → 4 bytes.
+ *
+ * ## Padding scheme
+ *
+ * Z85 requires input length to be a multiple of 4 bytes. We prefix a
+ * 1-byte pad count (`0–3`) so arbitrary-length payloads round-trip exactly:
+ *
+ * ```
+ *   [padCount: u8][payload bytes…][zero padding to multiple of 4]
+ * ```
+ *
+ * @see https://rfc.zeromq.org/spec/32/ — Z85 specification
+ */
+/** 85-character alphabet defined by the Z85 specification. */
+export declare const Z85_ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ.-:+=^!/*?&<>()[]{}@%$#";
+/**
+ * Encode a buffer whose length is already a multiple of 4 into a Z85 string.
+ *
+ * @param buffer - Raw bytes; length must be divisible by 4.
+ * @returns Z85-encoded string (length = buffer.length / 4 × 5).
+ */
+export declare function z85Encode(buffer: Buffer): string;
+/**
+ * Decode a Z85 string back to raw bytes.
+ *
+ * @param str - Z85 string; length must be a multiple of 5.
+ * @throws If length is wrong or an unknown character appears.
+ */
+export declare function z85Decode(str: string): Buffer;
+/**
+ * Encode arbitrary-length bytes to Z85, handling padding automatically.
+ *
+ * Pattern: length-prefix padding — a common technique when a codec requires
+ * fixed block sizes but the payload length is arbitrary.
+ */
+export declare function encodeBase85(buffer: Buffer): string;
+/**
+ * Decode a Z85 string produced by {@link encodeBase85}, stripping padding.
+ */
+export declare function decodeBase85(str: string): Buffer;
+//# sourceMappingURL=z85.d.ts.map

package/dist/encoding/z85.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"z85.d.ts","sourceRoot":"","sources":["../../src/encoding/z85.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,YAAY,0FACgE,CAAA;AAEzF;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAYhD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkB7C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAInD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD"}

package/dist/encoding/z85.js

@@ -0,0 +1,99 @@
+/**
+ * @module encoding/z85
+ *
+ * Z85 (ZeroMQ RFC 32) Base85 encoder and decoder.
+ *
+ * ## Why Z85 instead of Ascii85?
+ *
+ * Standard Ascii85 uses `"` and `\` — characters that break when pasted
+ * into chat or JSON strings. Z85 picks an alphabet of 85 printable ASCII
+ * characters that avoid quotes, backslashes, and backticks, making the
+ * output safe to paste verbatim into most code contexts.
+ *
+ * ## Algorithm (base-85 positional encoding)
+ *
+ * Z85 groups input into 4-byte blocks and maps each block to 5 printable
+ * characters:
+ *
+ * ```
+ *   value = b0·256³ + b1·256² + b2·256 + b3     (0 ≤ value < 256⁴)
+ *   char[j] = alphabet[value mod 85]             (j = 4 … 0)
+ *   value   = floor(value / 85)
+ * ```
+ *
+ * Decoding reverses the process: 5 characters → one 32-bit value → 4 bytes.
+ *
+ * ## Padding scheme
+ *
+ * Z85 requires input length to be a multiple of 4 bytes. We prefix a
+ * 1-byte pad count (`0–3`) so arbitrary-length payloads round-trip exactly:
+ *
+ * ```
+ *   [padCount: u8][payload bytes…][zero padding to multiple of 4]
+ * ```
+ *
+ * @see https://rfc.zeromq.org/spec/32/ — Z85 specification
+ */
+/** 85-character alphabet defined by the Z85 specification. */
+export const Z85_ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ.-:+=^!/*?&<>()[]{}@%$#";
+/**
+ * Encode a buffer whose length is already a multiple of 4 into a Z85 string.
+ *
+ * @param buffer - Raw bytes; length must be divisible by 4.
+ * @returns Z85-encoded string (length = buffer.length / 4 × 5).
+ */
+export function z85Encode(buffer) {
+    let out = "";
+    for (let i = 0; i < buffer.length; i += 4) {
+        let value = buffer[i] * 16777216 + buffer[i + 1] * 65536 + buffer[i + 2] * 256 + buffer[i + 3];
+        const chars = new Array(5);
+        for (let j = 4; j >= 0; j--) {
+            chars[j] = Z85_ALPHABET[value % 85];
+            value = Math.floor(value / 85);
+        }
+        out += chars.join("");
+    }
+    return out;
+}
+/**
+ * Decode a Z85 string back to raw bytes.
+ *
+ * @param str - Z85 string; length must be a multiple of 5.
+ * @throws If length is wrong or an unknown character appears.
+ */
+export function z85Decode(str) {
+    if (str.length % 5 !== 0)
+        throw new Error("Invalid base85 (Z85) input length.");
+    const bytes = [];
+    for (let i = 0; i < str.length; i += 5) {
+        let value = 0;
+        for (let j = 0; j < 5; j++) {
+            const digit = Z85_ALPHABET.indexOf(str[i + j]);
+            if (digit === -1)
+                throw new Error(`Invalid base85 (Z85) character: "${str[i + j]}"`);
+            value = value * 85 + digit;
+        }
+        bytes.push(Math.floor(value / 16777216) % 256, Math.floor(value / 65536) % 256, Math.floor(value / 256) % 256, value % 256);
+    }
+    return Buffer.from(bytes);
+}
+/**
+ * Encode arbitrary-length bytes to Z85, handling padding automatically.
+ *
+ * Pattern: length-prefix padding — a common technique when a codec requires
+ * fixed block sizes but the payload length is arbitrary.
+ */
+export function encodeBase85(buffer) {
+    const padLength = (4 - ((buffer.length + 1) % 4)) % 4;
+    const padded = Buffer.concat([Buffer.from([padLength]), buffer, Buffer.alloc(padLength)]);
+    return z85Encode(padded);
+}
+/**
+ * Decode a Z85 string produced by {@link encodeBase85}, stripping padding.
+ */
+export function decodeBase85(str) {
+    const padded = z85Decode(str);
+    const padLength = padded[0];
+    return padded.subarray(1, padded.length - padLength);
+}
+//# sourceMappingURL=z85.js.map

package/dist/encoding/z85.js.map

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

package/dist/fs/gitignore.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @module fs/gitignore
+ *
+ * Git-style `.gitignore` filtering for directory walks.
+ *
+ * Rules are applied **outside → inside**:
+ *
+ * 1. If the tree is inside a git repo, load every `.gitignore` on the path
+ *    from the repo root down to (but not including) the compression root.
+ * 2. While walking, load each directory's `.gitignore` before visiting
+ *    children and drop it when leaving the directory.
+ *
+ * Later rules can negate earlier ones, matching git's behaviour.
+ */
+/**
+ * Stateful filter that accumulates `.gitignore` rules while descending
+ * a directory tree.
+ */
+export declare class GitignoreFilter {
+    private readonly layers;
+    constructor(rootDir: string);
+    /** Load `.gitignore` for `absDir` if present. */
+    enterDirectory(absDir: string): void;
+    /** Remove rules loaded for `absDir`. */
+    leaveDirectory(absDir: string): void;
+    /** Whether `absPath` should be excluded from the archive. */
+    isIgnored(absPath: string, isDirectory: boolean): boolean;
+    private pushLayer;
+}
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/fs/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/fs/gitignore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA0CH;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAE3C,YAAY,OAAO,EAAE,MAAM,EAM1B;IAED,iDAAiD;IACjD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEnC;IAED,wCAAwC;IACxC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAQnC;IAED,6DAA6D;IAC7D,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAmBxD;IAED,OAAO,CAAC,SAAS;CAKlB"}

package/dist/fs/gitignore.js

@@ -0,0 +1,104 @@
+/**
+ * @module fs/gitignore
+ *
+ * Git-style `.gitignore` filtering for directory walks.
+ *
+ * Rules are applied **outside → inside**:
+ *
+ * 1. If the tree is inside a git repo, load every `.gitignore` on the path
+ *    from the repo root down to (but not including) the compression root.
+ * 2. While walking, load each directory's `.gitignore` before visiting
+ *    children and drop it when leaving the directory.
+ *
+ * Later rules can negate earlier ones, matching git's behaviour.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import ignore from "ignore";
+function readGitignoreFile(absDir) {
+    const gitignorePath = join(absDir, ".gitignore");
+    if (!existsSync(gitignorePath))
+        return null;
+    return ignore().add(readFileSync(gitignorePath, "utf-8"));
+}
+/** Walk upward until a `.git` directory is found; return that path or null. */
+function findGitRoot(dir) {
+    let current = resolve(dir);
+    while (true) {
+        if (existsSync(join(current, ".git")))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+/** Directories on the path from `from` up to but excluding `to`. */
+function ancestorDirs(from, to) {
+    const ancestors = [];
+    let current = resolve(from);
+    const target = resolve(to);
+    while (current !== target) {
+        ancestors.push(current);
+        const parent = dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return ancestors;
+}
+/**
+ * Stateful filter that accumulates `.gitignore` rules while descending
+ * a directory tree.
+ */
+export class GitignoreFilter {
+    layers = [];
+    constructor(rootDir) {
+        const gitRoot = findGitRoot(rootDir);
+        const ancestorRoot = gitRoot ?? resolve(rootDir);
+        for (const dir of ancestorDirs(ancestorRoot, rootDir)) {
+            this.pushLayer(dir);
+        }
+    }
+    /** Load `.gitignore` for `absDir` if present. */
+    enterDirectory(absDir) {
+        this.pushLayer(absDir);
+    }
+    /** Remove rules loaded for `absDir`. */
+    leaveDirectory(absDir) {
+        const resolved = resolve(absDir);
+        for (let index = this.layers.length - 1; index >= 0; index--) {
+            if (this.layers[index].baseDir === resolved) {
+                this.layers.splice(index, 1);
+                return;
+            }
+        }
+    }
+    /** Whether `absPath` should be excluded from the archive. */
+    isIgnored(absPath, isDirectory) {
+        const resolved = resolve(absPath);
+        let ignored = false;
+        for (const { baseDir, matcher } of this.layers) {
+            const rel = relative(baseDir, resolved);
+            if (rel === "" || rel.startsWith(`..${sep}`) || isAbsolute(rel)) {
+                continue;
+            }
+            const candidates = isDirectory ? [`${rel}/`, rel] : [rel];
+            for (const candidate of candidates) {
+                const result = matcher.test(candidate);
+                if (result.unignored)
+                    ignored = false;
+                else if (result.ignored)
+                    ignored = true;
+            }
+        }
+        return ignored;
+    }
+    pushLayer(absDir) {
+        const matcher = readGitignoreFile(absDir);
+        if (!matcher)
+            return;
+        this.layers.push({ baseDir: resolve(absDir), matcher });
+    }
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/fs/gitignore.js.map

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

package/dist/fs/paths.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module fs/paths
+ *
+ * Filesystem path validation and safe file reading.
+ *
+ * Centralises stat/read error handling so CLI and library callers get
+ * consistent, actionable error messages (e.g. distinguishing "path is a
+ * directory" from "path not found").
+ */
+/**
+ * Assert that a path exists and is a directory.
+ *
+ * @throws If the path is a file or does not exist.
+ */
+export declare function assertDirectory(path: string): void;
+/**
+ * Read a UTF-8 text file with context-aware error messages.
+ *
+ * @param purpose - `"compress"` vs `"decompress"` changes the directory hint.
+ */
+export declare function readTextFile(path: string, purpose?: "compress" | "decompress"): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/fs/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/fs/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKlD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,UAAU,GAAG,YAAyB,GAC9C,MAAM,CAaR"}

package/dist/fs/paths.js

@@ -0,0 +1,55 @@
+/**
+ * @module fs/paths
+ *
+ * Filesystem path validation and safe file reading.
+ *
+ * Centralises stat/read error handling so CLI and library callers get
+ * consistent, actionable error messages (e.g. distinguishing "path is a
+ * directory" from "path not found").
+ */
+import { readFileSync, statSync } from "node:fs";
+/**
+ * Stat a path, translating ENOENT into a friendly error message.
+ */
+function statPath(path) {
+    try {
+        return statSync(path);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT") {
+            throw new Error(`Path not found: ${path}`);
+        }
+        throw err;
+    }
+}
+/**
+ * Assert that a path exists and is a directory.
+ *
+ * @throws If the path is a file or does not exist.
+ */
+export function assertDirectory(path) {
+    const stat = statPath(path);
+    if (!stat.isDirectory()) {
+        throw new Error(`"${path}" is not a directory. Pass a file path instead.`);
+    }
+}
+/**
+ * Read a UTF-8 text file with context-aware error messages.
+ *
+ * @param purpose - `"compress"` vs `"decompress"` changes the directory hint.
+ */
+export function readTextFile(path, purpose = "compress") {
+    const stat = statPath(path);
+    if (stat.isDirectory()) {
+        const hint = purpose === "decompress"
+            ? "Pass the compressed .txt file, not a decompressed output folder."
+            : "Pass a folder path to compress a directory, or a file path for a single file.";
+        throw new Error(`"${path}" is a directory, not a file. ${hint}`);
+    }
+    if (!stat.isFile()) {
+        throw new Error(`Cannot read "${path}": not a regular file.`);
+    }
+    return readFileSync(path, "utf-8");
+}
+//# sourceMappingURL=paths.js.map

package/dist/fs/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/fs/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEhD;;GAEG;AACH,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAA;QAChD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAA;QAC5C,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC3B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,iDAAiD,CAAC,CAAA;IAC5E,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,OAAO,GAA8B,UAAU;IAE/C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC3B,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACvB,MAAM,IAAI,GACR,OAAO,KAAK,YAAY;YACtB,CAAC,CAAC,kEAAkE;YACpE,CAAC,CAAC,+EAA+E,CAAA;QACrF,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,iCAAiC,IAAI,EAAE,CAAC,CAAA;IAClE,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,wBAAwB,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AACpC,CAAC"}

package/dist/fs/walk.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module fs/walk
+ *
+ * Shared depth-first directory walker used by in-memory and streaming
+ * folder compression. Applies `.gitignore` rules when enabled.
+ */
+export interface DirectoryWalkHandlers {
+    /** Called for every directory except the compression root (`relDir === ""`). */
+    onDirectory?: (absDir: string, relDir: string) => void;
+    onFile: (absPath: string, relPath: string) => void;
+}
+/**
+ * Walk `rootDir` depth-first with sorted children.
+ *
+ * @param rootDir - Absolute path to the folder root.
+ * @param handlers - Callbacks for directories and files.
+ * @param options.useGitignore - Apply `.gitignore` rules (default: true).
+ */
+export declare function walkDirectory(rootDir: string, handlers: DirectoryWalkHandlers, options?: {
+    useGitignore?: boolean;
+}): void;
+//# sourceMappingURL=walk.d.ts.map

package/dist/fs/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/fs/walk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACtD,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACnD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,IAAI,CAiCN"}

package/dist/fs/walk.js

@@ -0,0 +1,49 @@
+/**
+ * @module fs/walk
+ *
+ * Shared depth-first directory walker used by in-memory and streaming
+ * folder compression. Applies `.gitignore` rules when enabled.
+ */
+import { readdirSync } from "node:fs";
+import { join } from "node:path";
+import { GitignoreFilter } from "./gitignore.js";
+/**
+ * Walk `rootDir` depth-first with sorted children.
+ *
+ * @param rootDir - Absolute path to the folder root.
+ * @param handlers - Callbacks for directories and files.
+ * @param options.useGitignore - Apply `.gitignore` rules (default: true).
+ */
+export function walkDirectory(rootDir, handlers, options = {}) {
+    const useGitignore = options.useGitignore !== false;
+    const filter = useGitignore ? new GitignoreFilter(rootDir) : null;
+    function walk(absDir, relDir) {
+        filter?.enterDirectory(absDir);
+        try {
+            if (relDir !== "")
+                handlers.onDirectory?.(absDir, relDir);
+            const dirents = readdirSync(absDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
+            for (const dirent of dirents) {
+                const abs = join(absDir, dirent.name);
+                const rel = relDir ? `${relDir}/${dirent.name}` : dirent.name;
+                const isDirectory = dirent.isDirectory();
+                const isFile = dirent.isFile();
+                if (!isDirectory && !isFile)
+                    continue;
+                if (filter?.isIgnored(abs, isDirectory))
+                    continue;
+                if (isDirectory) {
+                    walk(abs, rel);
+                }
+                else {
+                    handlers.onFile(abs, rel);
+                }
+            }
+        }
+        finally {
+            filter?.leaveDirectory(absDir);
+        }
+    }
+    walk(rootDir, "");
+}
+//# sourceMappingURL=walk.js.map

package/dist/fs/walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../../src/fs/walk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAQhD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,QAA+B,EAC/B,OAAO,GAA+B,EAAE;IAExC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,KAAK,KAAK,CAAA;IACnD,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAEjE,SAAS,IAAI,CAAC,MAAc,EAAE,MAAc;QAC1C,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;QAC9B,IAAI,CAAC;YACH,IAAI,MAAM,KAAK,EAAE;gBAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YAEzD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACzE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAC7B,CAAA;YACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;gBACrC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAA;gBAC7D,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;gBACxC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAA;gBAE9B,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM;oBAAE,SAAQ;gBACrC,IAAI,MAAM,EAAE,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC;oBAAE,SAAQ;gBAEjD,IAAI,WAAW,EAAE,CAAC;oBAChB,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;gBAChB,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;AACnB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @module index
+ *
+ * Public API barrel — re-exports everything consumers import from
+ * `@startdoing/tc`. Internal modules (`streaming/`, `cli/`) are not
+ * exported here; only this file defines the npm package surface.
+ *
+ * @example
+ * ```ts
+ * import { compress, decompress, compressFolder } from "text-compress";
+ * ```
+ */
+export { compressFolder, decompressToPath } from "./api/folder.js";
+export { compress, decompress } from "./api/text.js";
+export { unpackDirectory } from "./archive/unpack.js";
+export { assertDirectory, readTextFile } from "./fs/paths.js";
+export { decompressPayload, TAG_FOLDER, TAG_TEXT } from "./payload/tags.js";
+export type { SplitChunk } from "./split/parts.js";
+export { AUTO_SPLIT_CHARS, assembleSplitChunks, createSplitChunkHeader, extractFilenamePrefix, formatSplitOutputPath, parseSplitBuffer, parseSplitPartPath, readSplitInput, resolveSplitChunkSize, resolveSplitInputPaths, SPLIT_MAGIC, splitString, tryParseSplitChunks, wrapSplitChunk, } from "./split/parts.js";
+export type { Encoding } from "./types.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;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAGlE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE7D,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC3E,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,cAAc,GACf,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * @module index
+ *
+ * Public API barrel — re-exports everything consumers import from
+ * `@startdoing/tc`. Internal modules (`streaming/`, `cli/`) are not
+ * exported here; only this file defines the npm package surface.
+ *
+ * @example
+ * ```ts
+ * import { compress, decompress, compressFolder } from "text-compress";
+ * ```
+ */
+// Folder API
+export { compressFolder, decompressToPath } from "./api/folder.js";
+// Text API
+export { compress, decompress } from "./api/text.js";
+// Archive unpack (exposed for advanced use / tests)
+export { unpackDirectory } from "./archive/unpack.js";
+// Path validation helpers
+export { assertDirectory, readTextFile } from "./fs/paths.js";
+// Low-level payload access
+export { decompressPayload, TAG_FOLDER, TAG_TEXT } from "./payload/tags.js";
+// Split-file helpers
+export { AUTO_SPLIT_CHARS, assembleSplitChunks, createSplitChunkHeader, extractFilenamePrefix, formatSplitOutputPath, parseSplitBuffer, parseSplitPartPath, readSplitInput, resolveSplitChunkSize, resolveSplitInputPaths, SPLIT_MAGIC, splitString, tryParseSplitChunks, wrapSplitChunk, } from "./split/parts.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;;;;;;;;;;;GAWG;AAEH,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAElE,WAAW;AACX,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AACpD,oDAAoD;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,0BAA0B;AAC1B,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC7D,2BAA2B;AAC3B,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE3E,qBAAqB;AACrB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,cAAc,GACf,MAAM,kBAAkB,CAAA"}