@pixzle/core 0.0.19 → 0.0.20

package/dist/block-utils.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RGBA_CHANNELS = void 0;
+exports.calculateBlockCounts = calculateBlockCounts;
+exports.calculateBlockRange = calculateBlockRange;
+exports.calculateBlockCountsForCrossImages = calculateBlockCountsForCrossImages;
+exports.calculateBlockCountsPerImage = calculateBlockCountsPerImage;
+exports.calculateTotalBlocks = calculateTotalBlocks;
+/**
+ * Number of channels in RGBA format
+ */
+exports.RGBA_CHANNELS = 4;
+/**
+ * Calculate block counts for width and height
+ * @param width Image width
+ * @param height Image height
+ * @param blockSize Block size
+ * @returns Object with blockCountX and blockCountY
+ */
+function calculateBlockCounts(width, height, blockSize) {
+    return {
+        blockCountX: Math.ceil(width / blockSize),
+        blockCountY: Math.ceil(height / blockSize),
+    };
+}
+/**
+ * Calculate the range of blocks for a specific image index
+ * @param blockCounts Array of block counts per image
+ * @param targetIndex Target image index
+ * @returns Object with start and end indices
+ */
+function calculateBlockRange(blockCounts, targetIndex) {
+    const start = blockCounts
+        .slice(0, targetIndex)
+        .reduce((sum, count) => sum + count, 0);
+    const end = start + blockCounts[targetIndex];
+    return { start, end };
+}
+/**
+ * Calculate how many blocks each fragment should contain for cross-image shuffling
+ * @param totalBlocks Total number of blocks to distribute
+ * @param fragmentCount Number of fragments to create
+ * @returns Array of block counts for each fragment
+ */
+function calculateBlockCountsForCrossImages(totalBlocks, fragmentCount) {
+    if (fragmentCount <= 0) {
+        throw new Error("Fragment count must be greater than 0");
+    }
+    if (totalBlocks <= 0) {
+        return new Array(fragmentCount).fill(0);
+    }
+    const baseBlocksPerFragment = Math.ceil(totalBlocks / fragmentCount);
+    const fragmentBlockCounts = [];
+    let remainingBlocks = totalBlocks;
+    // Distribute blocks, ensuring no fragment gets more blocks than available
+    for (let i = 0; i < fragmentCount; i++) {
+        const blocksForThisFragment = Math.min(baseBlocksPerFragment, remainingBlocks);
+        fragmentBlockCounts.push(blocksForThisFragment);
+        remainingBlocks -= blocksForThisFragment;
+        // If no blocks remain, fill remaining fragments with 0
+        if (remainingBlocks <= 0) {
+            for (let j = i + 1; j < fragmentCount; j++) {
+                fragmentBlockCounts.push(0);
+            }
+            break;
+        }
+    }
+    return fragmentBlockCounts;
+}
+/**
+ * Calculate block counts for each image
+ * @param images Array of ImageInfo objects
+ * @returns Array of block counts per image (x * y)
+ */
+function calculateBlockCountsPerImage(images) {
+    return images.map((info) => info.x * info.y);
+}
+/**
+ * Calculate total number of blocks from images
+ * @param images Array of ImageInfo objects
+ * @returns Total block count
+ */
+function calculateTotalBlocks(images) {
+    return images.reduce((total, image) => total + image.x * image.y, 0);
+}
+//# sourceMappingURL=block-utils.js.map

package/dist/block-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-utils.js","sourceRoot":"","sources":["../src/block-utils.ts"],"names":[],"mappings":";;;AAmBA,oDASC;AAQD,kDAUC;AAQD,gFAmCC;AAOD,oEAEC;AAOD,oDAEC;AAzGD;;GAEG;AACU,QAAA,aAAa,GAAG,CAAC,CAAC;AAO/B;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAClC,KAAa,EACb,MAAc,EACd,SAAiB;IAEjB,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACzC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,WAAqB,EACrB,WAAmB;IAEnB,MAAM,KAAK,GAAG,WAAW;SACtB,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;SACrB,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IAE7C,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kCAAkC,CAChD,WAAmB,EACnB,aAAqB;IAErB,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,qBAAqB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,aAAa,CAAC,CAAC;IACrE,MAAM,mBAAmB,GAAa,EAAE,CAAC;IACzC,IAAI,eAAe,GAAG,WAAW,CAAC;IAElC,0EAA0E;IAC1E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,qBAAqB,GAAG,IAAI,CAAC,GAAG,CACpC,qBAAqB,EACrB,eAAe,CAChB,CAAC;QACF,mBAAmB,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAChD,eAAe,IAAI,qBAAqB,CAAC;QAEzC,uDAAuD;QACvD,IAAI,eAAe,IAAI,CAAC,EAAE,CAAC;YACzB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9B,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,SAAgB,4BAA4B,CAAC,MAAmB;IAC9D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,MAAmB;IACtD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/constants.cjs

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_FRAGMENTATION_CONFIG = exports.MANIFEST_FILE_NAME = void 0;
+exports.MANIFEST_FILE_NAME = "manifest.json";
+exports.DEFAULT_FRAGMENTATION_CONFIG = {
+    BLOCK_SIZE: 2,
+    PREFIX: "img",
+    PRESERVE_NAME: false,
+    CROSS_IMAGE_SHUFFLE: false,
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.d.cts

@@ -0,0 +1,8 @@
+export declare const MANIFEST_FILE_NAME = "manifest.json";
+export declare const DEFAULT_FRAGMENTATION_CONFIG: {
+    BLOCK_SIZE: number;
+    PREFIX: string;
+    PRESERVE_NAME: boolean;
+    CROSS_IMAGE_SHUFFLE: boolean;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const MANIFEST_FILE_NAME = "manifest.json";
+export declare const DEFAULT_FRAGMENTATION_CONFIG: {
+    BLOCK_SIZE: number;
+    PREFIX: string;
+    PRESERVE_NAME: boolean;
+    CROSS_IMAGE_SHUFFLE: boolean;
+};

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,eAAO,MAAM,4BAA4B;;;;;CAKxC,CAAC"}

package/dist/constants.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_FRAGMENTATION_CONFIG = exports.MANIFEST_FILE_NAME = void 0;
+exports.MANIFEST_FILE_NAME = "manifest.json";
+exports.DEFAULT_FRAGMENTATION_CONFIG = {
+    BLOCK_SIZE: 2,
+    PREFIX: "img",
+    PRESERVE_NAME: false,
+    CROSS_IMAGE_SHUFFLE: false,
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,kBAAkB,GAAG,eAAe,CAAC;AAErC,QAAA,4BAA4B,GAAG;IAC1C,UAAU,EAAE,CAAC;IACb,MAAM,EAAE,KAAK;IACb,aAAa,EAAE,KAAK;IACpB,mBAAmB,EAAE,KAAK;CAC3B,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

@@ -0,0 +1,44 @@
+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;

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

@@ -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.js.map

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

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

@@ -0,0 +1,7 @@
+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";

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

@@ -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.js.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,64 @@
+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[];
+}