@pixzle/core 0.0.18 → 0.0.20

package/dist/esm/types.d.ts

@@ -0,0 +1,65 @@
+export interface ShuffleOptions {
+    /** Image paths (e.g., ["image1.png", "image2.png"]) */
+    imagePaths: string[];
+    /** Fragmentation config */
+    config?: FragmentationConfig;
+    /** Output directory (e.g., "./output/fragments") */
+    outputDir: string;
+}
+export interface RestoreOptions {
+    /** Image paths (e.g., ["fragment1.png", "fragment2.png"]) */
+    imagePaths: string[];
+    /** Manifest path (e.g., "./output/fragments/manifest.json") */
+    manifestPath: string;
+    /** Output directory (e.g., "./output/restored") */
+    outputDir: string;
+}
+export interface FragmentationConfig {
+    /** Pixel block size (e.g., 10x10 to 10) */
+    blockSize?: number;
+    /** Prefix for fragment files (optional, default: "fragment") */
+    prefix?: string;
+    /** Random seed (auto-generated if not specified) */
+    seed?: number | string;
+    /** Preserve original file name (optional, default: false) */
+    preserveName?: boolean;
+    /** Shuffle blocks across all images instead of within each image independently (optional, default: false) */
+    crossImageShuffle?: boolean;
+}
+/**
+ * Information about the image before fragmentation.
+ * This includes dimensions, channels, and block counts.
+ */
+export interface ImageInfo {
+    /** Width */
+    w: number;
+    /** Height */
+    h: number;
+    /** Number of channels */
+    c: number;
+    /** Number of blocks X */
+    x: number;
+    /** Number of blocks Y */
+    y: number;
+    /** Original file name in base64 encoding (optional) */
+    name?: string;
+}
+export interface ManifestData {
+    /** UUID */
+    id: string;
+    /** Version */
+    version: string;
+    /** Timestamp */
+    timestamp: string;
+    /** Config */
+    config: Required<FragmentationConfig>;
+    /** Image information */
+    images: ImageInfo[];
+}
+export interface FragmentationResult {
+    /** Manifest data */
+    manifest: ManifestData;
+    /** Fragmented images */
+    fragmentedImages: Buffer[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6GAA6G;IAC7G,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,aAAa;IACb,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,EAAE,EAAE,MAAM,CAAC;IACX,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,MAAM,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACtC,wBAAwB;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B"}

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/esm/validators.d.ts

@@ -0,0 +1,16 @@
+import type { ImageInfo, ManifestData } from "./types";
+/**
+ * Validates that the number of fragment images matches the number of images in the manifest
+ * @param fragmentImages - Array of fragment images (file paths or buffers)
+ * @param manifest - The manifest data containing image information
+ * @throws {Error} When the counts don't match
+ */
+export declare function validateFragmentImageCount(fragmentImages: (string | Buffer)[], manifest: ManifestData): void;
+/**
+ * Validates that there are no duplicate file names in the image infos
+ * @param imageInfos - Array of image information objects
+ * @param preserveName - Whether name preservation is enabled
+ * @throws {Error} When duplicate file names are detected
+ */
+export declare function validateFileNames(imageInfos: ImageInfo[], preserveName: boolean): void;
+//# sourceMappingURL=validators.d.ts.map

package/dist/esm/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/validators.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EACnC,QAAQ,EAAE,YAAY,GACrB,IAAI,CASN;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,EAAE,EACvB,YAAY,EAAE,OAAO,GACpB,IAAI,CAuBN"}

package/dist/esm/validators.js

@@ -0,0 +1,44 @@
+import { decodeFileName } from "./helpers";
+/**
+ * Validates that the number of fragment images matches the number of images in the manifest
+ * @param fragmentImages - Array of fragment images (file paths or buffers)
+ * @param manifest - The manifest data containing image information
+ * @throws {Error} When the counts don't match
+ */
+export function validateFragmentImageCount(fragmentImages, manifest) {
+    const manifestImageCount = manifest.images.length;
+    const fragmentImageCount = fragmentImages.length;
+    if (manifestImageCount !== fragmentImageCount) {
+        throw new Error(`Fragment image count mismatch: expected ${manifestImageCount} but got ${fragmentImageCount}`);
+    }
+}
+/**
+ * Validates that there are no duplicate file names in the image infos
+ * @param imageInfos - Array of image information objects
+ * @param preserveName - Whether name preservation is enabled
+ * @throws {Error} When duplicate file names are detected
+ */
+export function validateFileNames(imageInfos, preserveName) {
+    if (!preserveName || imageInfos.length <= 1) {
+        return;
+    }
+    const nameSet = new Set();
+    for (const info of imageInfos) {
+        if (info.name !== undefined) {
+            // Decode base64 to get original name for comparison
+            let decodedName;
+            try {
+                decodedName = decodeFileName(info.name);
+            }
+            catch {
+                // If decoding fails, treat as already decoded (backward compatibility)
+                decodedName = info.name;
+            }
+            if (nameSet.has(decodedName)) {
+                throw new Error(`Duplicate file name detected: ${decodedName}`);
+            }
+            nameSet.add(decodedName);
+        }
+    }
+}
+//# sourceMappingURL=validators.js.map

package/dist/esm/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/validators.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,cAAmC,EACnC,QAAsB;IAEtB,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAClD,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC;IAEjD,IAAI,kBAAkB,KAAK,kBAAkB,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,2CAA2C,kBAAkB,YAAY,kBAAkB,EAAE,CAC9F,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAuB,EACvB,YAAqB;IAErB,IAAI,CAAC,YAAY,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,oDAAoD;YACpD,IAAI,WAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,uEAAuE;gBACvE,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC;YAC1B,CAAC;YACD,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,iCAAiC,WAAW,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/helpers.cjs

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeFileName = encodeFileName;
+exports.decodeFileName = decodeFileName;
+exports.generateFileName = generateFileName;
+exports.generateFragmentFileName = generateFragmentFileName;
+exports.generateRestoredFileName = generateRestoredFileName;
+exports.generateRestoredOriginalFileName = generateRestoredOriginalFileName;
+/**
+ * Encode file name to base64 for safe storage (cross-platform)
+ * @param name - Original file name
+ * @returns Base64 encoded file name
+ */
+function encodeFileName(name) {
+    // Use TextEncoder for UTF-8 encoding (available in both browser and Node.js)
+    const encoder = new TextEncoder();
+    const bytes = encoder.encode(name);
+    // Convert bytes to binary string for btoa (cross-platform)
+    // Use loop to avoid stack overflow with large arrays
+    let binaryString = "";
+    for (let i = 0; i < bytes.length; i++) {
+        const byte = bytes[i];
+        binaryString += String.fromCharCode(byte);
+    }
+    return btoa(binaryString);
+}
+/**
+ * Decode file name from base64 (cross-platform)
+ * @param encodedName - Base64 encoded file name
+ * @returns Decoded original file name
+ */
+function decodeFileName(encodedName) {
+    // Use atob for base64 decoding (cross-platform)
+    const binaryString = atob(encodedName);
+    // Convert binary string to bytes
+    const bytes = Uint8Array.from(binaryString, (c) => c.charCodeAt(0));
+    // Use TextDecoder for UTF-8 decoding (available in both browser and Node.js)
+    const decoder = new TextDecoder();
+    return decoder.decode(bytes);
+}
+/**
+ * Generate a file name with prefix, 1-based zero-padded index, and extension
+ * @param manifest - Manifest data
+ * @param index - Index number (0-based, but output is 1-based)
+ * @param options - Options for the file name
+ * @param options.isFragmented - Whether the fragment is fragmented
+ * @returns File name (e.g., img_1.png.enc)
+ */
+function generateFileName(manifest, index, options = {
+    isFragmented: false,
+}) {
+    const prefix = manifest.config.prefix;
+    const totalLength = manifest.images.length;
+    const extension = "png";
+    const numDigits = String(totalLength).length;
+    const paddedIndex = String(index + 1).padStart(numDigits, "0");
+    const filenameSuffix = options.isFragmented ? "_fragmented" : "";
+    const filename = `${prefix}_${paddedIndex}${filenameSuffix}`;
+    return `${filename}.${extension}`;
+}
+/**
+ * Generate a fragment file name
+ * @param manifest - Manifest data
+ * @param index - Index number (0-based, but output is 1-based)
+ * @returns Fragment file name (e.g., img_1_fragmented.png)
+ */
+function generateFragmentFileName(manifest, index) {
+    return generateFileName(manifest, index, {
+        isFragmented: true,
+    });
+}
+/**
+ * Generate a restored file name
+ * @param manifest - Manifest data
+ * @param index - Index number (0-based, but output is 1-based)
+ * @returns Restored file name (e.g., img_1.png)
+ */
+function generateRestoredFileName(manifest, index) {
+    return generateFileName(manifest, index, {
+        isFragmented: false,
+    });
+}
+/**
+ * Generate a restored original file name
+ * @param imageInfo - Image information
+ * @returns Restored original file name
+ */
+function generateRestoredOriginalFileName(imageInfo) {
+    if (!imageInfo.name) {
+        return undefined;
+    }
+    try {
+        const decodedName = decodeFileName(imageInfo.name);
+        return decodedName ? `${decodedName}.png` : undefined;
+    }
+    catch {
+        // Fallback: if decoding fails, treat as already decoded (backward compatibility)
+        return `${imageInfo.name}.png`;
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.d.cts

@@ -0,0 +1,45 @@
+import type { ManifestData } from "./types";
+/**
+ * Encode file name to base64 for safe storage (cross-platform)
+ * @param name - Original file name
+ * @returns Base64 encoded file name
+ */
+export declare function encodeFileName(name: string): string;
+/**
+ * Decode file name from base64 (cross-platform)
+ * @param encodedName - Base64 encoded file name
+ * @returns Decoded original file name
+ */
+export declare function decodeFileName(encodedName: string): string;
+/**
+ * Generate a file name with prefix, 1-based zero-padded index, and extension
+ * @param manifest - Manifest data
+ * @param index - Index number (0-based, but output is 1-based)
+ * @param options - Options for the file name
+ * @param options.isFragmented - Whether the fragment is fragmented
+ * @returns File name (e.g., img_1.png.enc)
+ */
+export declare function generateFileName(manifest: ManifestData, index: number, options?: {
+    isFragmented: boolean;
+}): string;
+/**
+ * Generate a fragment file name
+ * @param manifest - Manifest data
+ * @param index - Index number (0-based, but output is 1-based)
+ * @returns Fragment file name (e.g., img_1_fragmented.png)
+ */
+export declare function generateFragmentFileName(manifest: ManifestData, index: number): string;
+/**
+ * Generate a restored file name
+ * @param manifest - Manifest data
+ * @param index - Index number (0-based, but output is 1-based)
+ * @returns Restored file name (e.g., img_1.png)
+ */
+export declare function generateRestoredFileName(manifest: ManifestData, index: number): string;
+/**
+ * Generate a restored original file name
+ * @param imageInfo - Image information
+ * @returns Restored original file name
+ */
+export declare function generateRestoredOriginalFileName(imageInfo: ManifestData["images"][number]): string | undefined;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IACP,YAAY,EAAE,OAAO,CAAC;CAGvB,GACA,MAAM,CASR;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,GACZ,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,GACZ,MAAM,CAIR;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GACxC,MAAM,GAAG,SAAS,CAWpB"}

package/dist/helpers.js

@@ -1,9 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeFileName = encodeFileName;
+exports.decodeFileName = decodeFileName;
+exports.generateFileName = generateFileName;
+exports.generateFragmentFileName = generateFragmentFileName;
+exports.generateRestoredFileName = generateRestoredFileName;
+exports.generateRestoredOriginalFileName = generateRestoredOriginalFileName;
 /**
  * Encode file name to base64 for safe storage (cross-platform)
  * @param name - Original file name
  * @returns Base64 encoded file name
  */
-export function encodeFileName(name) {
+function encodeFileName(name) {
     // Use TextEncoder for UTF-8 encoding (available in both browser and Node.js)
     const encoder = new TextEncoder();
     const bytes = encoder.encode(name);
@@ -21,7 +29,7 @@ export function encodeFileName(name) {
  * @param encodedName - Base64 encoded file name
  * @returns Decoded original file name
  */
-export function decodeFileName(encodedName) {
+function decodeFileName(encodedName) {
     // Use atob for base64 decoding (cross-platform)
     const binaryString = atob(encodedName);
     // Convert binary string to bytes
@@ -38,7 +46,7 @@ export function decodeFileName(encodedName) {
  * @param options.isFragmented - Whether the fragment is fragmented
  * @returns File name (e.g., img_1.png.enc)
  */
-export function generateFileName(manifest, index, options = {
+function generateFileName(manifest, index, options = {
     isFragmented: false,
 }) {
     const prefix = manifest.config.prefix;
@@ -56,7 +64,7 @@ export function generateFileName(manifest, index, options = {
  * @param index - Index number (0-based, but output is 1-based)
  * @returns Fragment file name (e.g., img_1_fragmented.png)
  */
-export function generateFragmentFileName(manifest, index) {
+function generateFragmentFileName(manifest, index) {
     return generateFileName(manifest, index, {
         isFragmented: true,
     });
@@ -67,7 +75,7 @@ export function generateFragmentFileName(manifest, index) {
  * @param index - Index number (0-based, but output is 1-based)
  * @returns Restored file name (e.g., img_1.png)
  */
-export function generateRestoredFileName(manifest, index) {
+function generateRestoredFileName(manifest, index) {
     return generateFileName(manifest, index, {
         isFragmented: false,
     });
@@ -77,7 +85,7 @@ export function generateRestoredFileName(manifest, index) {
  * @param imageInfo - Image information
  * @returns Restored original file name
  */
-export function generateRestoredOriginalFileName(imageInfo) {
+function generateRestoredOriginalFileName(imageInfo) {
     if (!imageInfo.name) {
         return undefined;
     }

package/dist/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":";;AAOA,wCAYC;AAOD,wCAQC;AAUD,4CAiBC;AAQD,4DAOC;AAQD,4DAOC;AAOD,4EAaC;AA7GD;;;;GAIG;AACH,SAAgB,cAAc,CAAC,IAAY;IACzC,6EAA6E;IAC7E,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,2DAA2D;IAC3D,qDAAqD;IACrD,IAAI,YAAY,GAAG,EAAE,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,WAAmB;IAChD,gDAAgD;IAChD,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IACvC,iCAAiC;IACjC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,6EAA6E;IAC7E,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAC9B,QAAsB,EACtB,KAAa,EACb,UAEI;IACF,YAAY,EAAE,KAAK;CACpB;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACtC,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3C,MAAM,SAAS,GAAG,KAAK,CAAC;IACxB,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC/D,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,WAAW,GAAG,cAAc,EAAE,CAAC;IAC7D,OAAO,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,wBAAwB,CACtC,QAAsB,EACtB,KAAa;IAEb,OAAO,gBAAgB,CAAC,QAAQ,EAAE,KAAK,EAAE;QACvC,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,wBAAwB,CACtC,QAAsB,EACtB,KAAa;IAEb,OAAO,gBAAgB,CAAC,QAAQ,EAAE,KAAK,EAAE;QACvC,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAgB,gCAAgC,CAC9C,SAAyC;IAEzC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,iFAAiF;QACjF,OAAO,GAAG,SAAS,CAAC,IAAI,MAAM,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/index.cjs

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_FRAGMENTATION_CONFIG = void 0;
+__exportStar(require("./types"), exports);
+__exportStar(require("./constants"), exports);
+__exportStar(require("./helpers"), exports);
+__exportStar(require("./block-utils"), exports);
+__exportStar(require("./block-operations"), exports);
+__exportStar(require("./validators"), exports);
+// Re-export constants with old name for backward compatibility
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "DEFAULT_FRAGMENTATION_CONFIG", { enumerable: true, get: function () { return constants_1.DEFAULT_FRAGMENTATION_CONFIG; } });
+//# sourceMappingURL=index.js.map

package/dist/index.d.cts

@@ -0,0 +1,8 @@
+export * from "./types";
+export * from "./constants";
+export * from "./helpers";
+export * from "./block-utils";
+export * from "./block-operations";
+export * from "./validators";
+export { DEFAULT_FRAGMENTATION_CONFIG } from "./constants";
+//# 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,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,9 +1,27 @@
-export * from "./types";
-export * from "./constants";
-export * from "./helpers";
-export * from "./block-utils";
-export * from "./block-operations";
-export * from "./validators";
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_FRAGMENTATION_CONFIG = void 0;
+__exportStar(require("./types"), exports);
+__exportStar(require("./constants"), exports);
+__exportStar(require("./helpers"), exports);
+__exportStar(require("./block-utils"), exports);
+__exportStar(require("./block-operations"), exports);
+__exportStar(require("./validators"), exports);
 // Re-export constants with old name for backward compatibility
-export { DEFAULT_FRAGMENTATION_CONFIG } from "./constants";
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "DEFAULT_FRAGMENTATION_CONFIG", { enumerable: true, get: function () { return constants_1.DEFAULT_FRAGMENTATION_CONFIG; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAE7B,+DAA+D;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,8CAA4B;AAC5B,4CAA0B;AAC1B,gDAA8B;AAC9B,qDAAmC;AACnC,+CAA6B;AAE7B,+DAA+D;AAC/D,yCAA2D;AAAlD,yHAAA,4BAA4B,OAAA"}

package/dist/types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.d.cts

@@ -0,0 +1,65 @@
+export interface ShuffleOptions {
+    /** Image paths (e.g., ["image1.png", "image2.png"]) */
+    imagePaths: string[];
+    /** Fragmentation config */
+    config?: FragmentationConfig;
+    /** Output directory (e.g., "./output/fragments") */
+    outputDir: string;
+}
+export interface RestoreOptions {
+    /** Image paths (e.g., ["fragment1.png", "fragment2.png"]) */
+    imagePaths: string[];
+    /** Manifest path (e.g., "./output/fragments/manifest.json") */
+    manifestPath: string;
+    /** Output directory (e.g., "./output/restored") */
+    outputDir: string;
+}
+export interface FragmentationConfig {
+    /** Pixel block size (e.g., 10x10 to 10) */
+    blockSize?: number;
+    /** Prefix for fragment files (optional, default: "fragment") */
+    prefix?: string;
+    /** Random seed (auto-generated if not specified) */
+    seed?: number | string;
+    /** Preserve original file name (optional, default: false) */
+    preserveName?: boolean;
+    /** Shuffle blocks across all images instead of within each image independently (optional, default: false) */
+    crossImageShuffle?: boolean;
+}
+/**
+ * Information about the image before fragmentation.
+ * This includes dimensions, channels, and block counts.
+ */
+export interface ImageInfo {
+    /** Width */
+    w: number;
+    /** Height */
+    h: number;
+    /** Number of channels */
+    c: number;
+    /** Number of blocks X */
+    x: number;
+    /** Number of blocks Y */
+    y: number;
+    /** Original file name in base64 encoding (optional) */
+    name?: string;
+}
+export interface ManifestData {
+    /** UUID */
+    id: string;
+    /** Version */
+    version: string;
+    /** Timestamp */
+    timestamp: string;
+    /** Config */
+    config: Required<FragmentationConfig>;
+    /** Image information */
+    images: ImageInfo[];
+}
+export interface FragmentationResult {
+    /** Manifest data */
+    manifest: ManifestData;
+    /** Fragmented images */
+    fragmentedImages: Buffer[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6GAA6G;IAC7G,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,aAAa;IACb,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,EAAE,EAAE,MAAM,CAAC;IACX,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,MAAM,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACtC,wBAAwB;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B"}

package/dist/types.js

@@ -1,2 +1,3 @@
-export {};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=types.js.map

package/dist/validators.cjs

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFragmentImageCount = validateFragmentImageCount;
+exports.validateFileNames = validateFileNames;
+const helpers_1 = require("./helpers");
+/**
+ * Validates that the number of fragment images matches the number of images in the manifest
+ * @param fragmentImages - Array of fragment images (file paths or buffers)
+ * @param manifest - The manifest data containing image information
+ * @throws {Error} When the counts don't match
+ */
+function validateFragmentImageCount(fragmentImages, manifest) {
+    const manifestImageCount = manifest.images.length;
+    const fragmentImageCount = fragmentImages.length;
+    if (manifestImageCount !== fragmentImageCount) {
+        throw new Error(`Fragment image count mismatch: expected ${manifestImageCount} but got ${fragmentImageCount}`);
+    }
+}
+/**
+ * Validates that there are no duplicate file names in the image infos
+ * @param imageInfos - Array of image information objects
+ * @param preserveName - Whether name preservation is enabled
+ * @throws {Error} When duplicate file names are detected
+ */
+function validateFileNames(imageInfos, preserveName) {
+    if (!preserveName || imageInfos.length <= 1) {
+        return;
+    }
+    const nameSet = new Set();
+    for (const info of imageInfos) {
+        if (info.name !== undefined) {
+            // Decode base64 to get original name for comparison
+            let decodedName;
+            try {
+                decodedName = (0, helpers_1.decodeFileName)(info.name);
+            }
+            catch {
+                // If decoding fails, treat as already decoded (backward compatibility)
+                decodedName = info.name;
+            }
+            if (nameSet.has(decodedName)) {
+                throw new Error(`Duplicate file name detected: ${decodedName}`);
+            }
+            nameSet.add(decodedName);
+        }
+    }
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.d.cts

@@ -0,0 +1,16 @@
+import type { ImageInfo, ManifestData } from "./types";
+/**
+ * Validates that the number of fragment images matches the number of images in the manifest
+ * @param fragmentImages - Array of fragment images (file paths or buffers)
+ * @param manifest - The manifest data containing image information
+ * @throws {Error} When the counts don't match
+ */
+export declare function validateFragmentImageCount(fragmentImages: (string | Buffer)[], manifest: ManifestData): void;
+/**
+ * Validates that there are no duplicate file names in the image infos
+ * @param imageInfos - Array of image information objects
+ * @param preserveName - Whether name preservation is enabled
+ * @throws {Error} When duplicate file names are detected
+ */
+export declare function validateFileNames(imageInfos: ImageInfo[], preserveName: boolean): void;
+//# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EACnC,QAAQ,EAAE,YAAY,GACrB,IAAI,CASN;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,EAAE,EACvB,YAAY,EAAE,OAAO,GACpB,IAAI,CAuBN"}

package/dist/validators.js

@@ -1,11 +1,15 @@
-import { decodeFileName } from "./helpers";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFragmentImageCount = validateFragmentImageCount;
+exports.validateFileNames = validateFileNames;
+const helpers_1 = require("./helpers");
 /**
  * Validates that the number of fragment images matches the number of images in the manifest
  * @param fragmentImages - Array of fragment images (file paths or buffers)
  * @param manifest - The manifest data containing image information
  * @throws {Error} When the counts don't match
  */
-export function validateFragmentImageCount(fragmentImages, manifest) {
+function validateFragmentImageCount(fragmentImages, manifest) {
     const manifestImageCount = manifest.images.length;
     const fragmentImageCount = fragmentImages.length;
     if (manifestImageCount !== fragmentImageCount) {
@@ -18,7 +22,7 @@ export function validateFragmentImageCount(fragmentImages, manifest) {
  * @param preserveName - Whether name preservation is enabled
  * @throws {Error} When duplicate file names are detected
  */
-export function validateFileNames(imageInfos, preserveName) {
+function validateFileNames(imageInfos, preserveName) {
     if (!preserveName || imageInfos.length <= 1) {
         return;
     }
@@ -28,7 +32,7 @@ export function validateFileNames(imageInfos, preserveName) {
             // Decode base64 to get original name for comparison
             let decodedName;
             try {
-                decodedName = decodeFileName(info.name);
+                decodedName = (0, helpers_1.decodeFileName)(info.name);
             }
             catch {
                 // If decoding fails, treat as already decoded (backward compatibility)