@pixzle/core 0.0.23 → 0.0.25

package/dist/helpers.cjs

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

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

@@ -1 +0,0 @@
-{"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/index.cjs

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

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

@@ -1 +0,0 @@
-{"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/types.cjs

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

package/dist/types.d.cts

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

@@ -1 +0,0 @@
-{"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/validators.cjs

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

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

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