@pixzle/core 0.1.6 → 0.1.8

package/dist/block-operations.d.ts

@@ -35,6 +35,11 @@ export declare function extractBlock(buffer: Uint8Array, imageWidth: number, ima
  * @param blockHeight Actual block height (optional, defaults to blockSize)
  */
 export declare function placeBlock(targetBuffer: Uint8Array, blockData: Uint8Array, targetWidth: number, destX: number, destY: number, blockSize: number, blockWidth?: number, blockHeight?: number): void;
+/**
+ * Copy a block from a source image buffer into a target image buffer.
+ * This avoids allocating intermediate block buffers.
+ */
+export declare function copyBlockFromImageBuffer(sourceBuffer: Uint8Array, sourceWidth: number, sourceHeight: number, blockSize: number, sourceBlockIndex: number, targetBuffer: Uint8Array, targetWidth: number, targetHeight: number, targetBlockIndex: number, targetBlocksPerRow: number): void;
 /**
  * Split an RGBA image buffer into an array of blocks
  * @param buffer Source image buffer (RGBA format)

package/dist/block-operations.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractBlock = extractBlock;
 exports.placeBlock = placeBlock;
+exports.copyBlockFromImageBuffer = copyBlockFromImageBuffer;
 exports.splitImageToBlocks = splitImageToBlocks;
 exports.blocksToImageBuffer = blocksToImageBuffer;
 const block_utils_1 = require("./block-utils");
@@ -67,6 +68,39 @@ function placeBlock(targetBuffer, blockData, targetWidth, destX, destY, blockSiz
         }
     }
 }
+/**
+ * Copy a block from a source image buffer into a target image buffer.
+ * This avoids allocating intermediate block buffers.
+ */
+function copyBlockFromImageBuffer(sourceBuffer, sourceWidth, sourceHeight, blockSize, sourceBlockIndex, targetBuffer, targetWidth, targetHeight, targetBlockIndex, targetBlocksPerRow) {
+    if (blockSize <= 0)
+        return;
+    const sourceBlocksPerRow = Math.ceil(sourceWidth / blockSize);
+    if (sourceBlocksPerRow <= 0 || targetBlocksPerRow <= 0)
+        return;
+    const sourceBlockX = sourceBlockIndex % sourceBlocksPerRow;
+    const sourceBlockY = Math.floor(sourceBlockIndex / sourceBlocksPerRow);
+    const sourceStartX = sourceBlockX * blockSize;
+    const sourceStartY = sourceBlockY * blockSize;
+    const targetBlockX = targetBlockIndex % targetBlocksPerRow;
+    const targetBlockY = Math.floor(targetBlockIndex / targetBlocksPerRow);
+    const targetStartX = targetBlockX * blockSize;
+    const targetStartY = targetBlockY * blockSize;
+    const availableSourceWidth = sourceWidth - sourceStartX;
+    const availableSourceHeight = sourceHeight - sourceStartY;
+    const availableTargetWidth = targetWidth - targetStartX;
+    const availableTargetHeight = targetHeight - targetStartY;
+    const actualWidth = Math.min(blockSize, availableSourceWidth, availableTargetWidth);
+    const actualHeight = Math.min(blockSize, availableSourceHeight, availableTargetHeight);
+    if (actualWidth <= 0 || actualHeight <= 0)
+        return;
+    const rowLength = actualWidth * block_utils_1.RGBA_CHANNELS;
+    for (let y = 0; y < actualHeight; y++) {
+        const srcRowStart = ((sourceStartY + y) * sourceWidth + sourceStartX) * block_utils_1.RGBA_CHANNELS;
+        const destRowStart = ((targetStartY + y) * targetWidth + targetStartX) * block_utils_1.RGBA_CHANNELS;
+        targetBuffer.set(sourceBuffer.subarray(srcRowStart, srcRowStart + rowLength), destRowStart);
+    }
+}
 /**
  * Calculate actual block dimensions at edge positions
  * @param position Block position (x or y)

package/dist/block-operations.js.map

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

package/dist/block-permutation.d.ts

@@ -0,0 +1,7 @@
+export declare function createPermutation(length: number, seed: number | string): number[];
+export declare function invertPermutation(permutation: number[]): number[];
+export declare function buildCumulativeCounts(counts: number[]): number[];
+export declare function findIndexInCumulative(cumulativeEnds: number[], counts: number[], index: number): {
+    rangeIndex: number;
+    localIndex: number;
+};

package/dist/block-permutation.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPermutation = createPermutation;
+exports.invertPermutation = invertPermutation;
+exports.buildCumulativeCounts = buildCumulativeCounts;
+exports.findIndexInCumulative = findIndexInCumulative;
+const seeded_shuffle_1 = require("@tuki0918/seeded-shuffle");
+function createPermutation(length, seed) {
+    if (length <= 0)
+        return [];
+    const indices = Array.from({ length }, (_, i) => i);
+    return (0, seeded_shuffle_1.shuffle)(indices, seed);
+}
+function invertPermutation(permutation) {
+    const inverse = new Array(permutation.length);
+    for (let i = 0; i < permutation.length; i++) {
+        inverse[permutation[i]] = i;
+    }
+    return inverse;
+}
+function buildCumulativeCounts(counts) {
+    const ends = [];
+    let sum = 0;
+    for (const count of counts) {
+        sum += count;
+        ends.push(sum);
+    }
+    return ends;
+}
+function findIndexInCumulative(cumulativeEnds, counts, index) {
+    let low = 0;
+    let high = cumulativeEnds.length - 1;
+    while (low < high) {
+        const mid = Math.floor((low + high) / 2);
+        if (index < cumulativeEnds[mid]) {
+            high = mid;
+        }
+        else {
+            low = mid + 1;
+        }
+    }
+    const start = cumulativeEnds[low] - counts[low];
+    return { rangeIndex: low, localIndex: index - start };
+}
+//# sourceMappingURL=block-permutation.js.map

package/dist/block-permutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-permutation.js","sourceRoot":"","sources":["../src/block-permutation.ts"],"names":[],"mappings":";;AAEA,8CAOC;AAED,8CAMC;AAED,sDAQC;AAED,sDAmBC;AAhDD,6DAAmD;AAEnD,SAAgB,iBAAiB,CAC/B,MAAc,EACd,IAAqB;IAErB,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,IAAA,wBAAO,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,SAAgB,iBAAiB,CAAC,WAAqB;IACrD,MAAM,OAAO,GAAG,IAAI,KAAK,CAAS,WAAW,CAAC,MAAM,CAAC,CAAC;IACtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,qBAAqB,CAAC,MAAgB;IACpD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,GAAG,IAAI,KAAK,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,qBAAqB,CACnC,cAAwB,EACxB,MAAgB,EAChB,KAAa;IAEb,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,IAAI,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;IAErC,OAAO,GAAG,GAAG,IAAI,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,IAAI,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,IAAI,GAAG,GAAG,CAAC;QACb,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,GAAG,KAAK,EAAE,CAAC;AACxD,CAAC"}

package/dist/fragment-buffers.d.ts

@@ -0,0 +1,9 @@
+import type { FragmentationConfig, ImageBufferData } from "./types";
+type FragmentBufferConfig = Pick<Required<FragmentationConfig>, "blockSize" | "seed" | "crossImageShuffle">;
+export declare function fragmentImageBuffers(images: ImageBufferData[], config: FragmentBufferConfig): ImageBufferData[];
+export declare function calculateFragmentLayout(blockCount: number, blockSize: number): {
+    blocksPerRow: number;
+    width: number;
+    height: number;
+};
+export {};

package/dist/fragment-buffers.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fragmentImageBuffers = fragmentImageBuffers;
+exports.calculateFragmentLayout = calculateFragmentLayout;
+const block_operations_1 = require("./block-operations");
+const block_permutation_1 = require("./block-permutation");
+const block_utils_1 = require("./block-utils");
+function fragmentImageBuffers(images, config) {
+    if (config.crossImageShuffle) {
+        return fragmentAcrossImages(images, config);
+    }
+    return fragmentEachImage(images, config);
+}
+function calculateFragmentLayout(blockCount, blockSize) {
+    if (blockCount <= 0 || blockSize <= 0) {
+        return { blocksPerRow: 0, width: 0, height: 0 };
+    }
+    const blocksPerRow = Math.ceil(Math.sqrt(blockCount));
+    const width = blocksPerRow * blockSize;
+    const height = Math.ceil(blockCount / blocksPerRow) * blockSize;
+    return { blocksPerRow, width, height };
+}
+function fragmentEachImage(images, config) {
+    return images.map((image) => {
+        const { blockCountX, blockCountY } = (0, block_utils_1.calculateBlockCounts)(image.width, image.height, config.blockSize);
+        const blockCount = blockCountX * blockCountY;
+        const permutation = (0, block_permutation_1.createPermutation)(blockCount, config.seed);
+        const { width, height } = calculateFragmentLayout(blockCount, config.blockSize);
+        const buffer = new Uint8Array(width * height * block_utils_1.RGBA_CHANNELS);
+        for (let targetBlockIndex = 0; targetBlockIndex < blockCount; targetBlockIndex++) {
+            (0, block_operations_1.copyBlockFromImageBuffer)(image.buffer, image.width, image.height, config.blockSize, permutation[targetBlockIndex], buffer, width, height, targetBlockIndex, Math.ceil(width / config.blockSize));
+        }
+        return {
+            buffer,
+            width,
+            height,
+        };
+    });
+}
+function fragmentAcrossImages(images, config) {
+    const sourceCounts = images.map((image) => {
+        const { blockCountX, blockCountY } = (0, block_utils_1.calculateBlockCounts)(image.width, image.height, config.blockSize);
+        return blockCountX * blockCountY;
+    });
+    const totalBlocks = sourceCounts.reduce((sum, blockCount) => sum + blockCount, 0);
+    const sourceEnds = (0, block_permutation_1.buildCumulativeCounts)(sourceCounts);
+    const permutation = (0, block_permutation_1.createPermutation)(totalBlocks, config.seed);
+    const fragmentBlockCounts = (0, block_utils_1.calculateBlockCountsForCrossImages)(totalBlocks, images.length);
+    let offset = 0;
+    return fragmentBlockCounts.map((blockCount) => {
+        const { width, height } = calculateFragmentLayout(blockCount, config.blockSize);
+        const buffer = new Uint8Array(width * height * block_utils_1.RGBA_CHANNELS);
+        const blocksPerRow = Math.ceil(width / config.blockSize);
+        for (let localBlockIndex = 0; localBlockIndex < blockCount; localBlockIndex++) {
+            const globalIndex = offset + localBlockIndex;
+            const sourceGlobalIndex = permutation[globalIndex];
+            const { rangeIndex, localIndex: sourceBlockIndex } = (0, block_permutation_1.findIndexInCumulative)(sourceEnds, sourceCounts, sourceGlobalIndex);
+            const source = images[rangeIndex];
+            (0, block_operations_1.copyBlockFromImageBuffer)(source.buffer, source.width, source.height, config.blockSize, sourceBlockIndex, buffer, width, height, localBlockIndex, blocksPerRow);
+        }
+        offset += blockCount;
+        return { buffer, width, height };
+    });
+}
+//# sourceMappingURL=fragment-buffers.js.map

package/dist/fragment-buffers.js.map

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

package/dist/index.d.ts

@@ -1,7 +1,10 @@
 export * from "./types";
 export * from "./constants";
 export * from "./helpers";
+export * from "./fragment-buffers";
 export * from "./block-utils";
 export * from "./block-operations";
+export * from "./block-permutation";
+export * from "./restore-buffers";
 export * from "./validators";
 export { DEFAULT_FRAGMENTATION_CONFIG } from "./constants";

package/dist/index.js

@@ -18,8 +18,11 @@ exports.DEFAULT_FRAGMENTATION_CONFIG = void 0;
 __exportStar(require("./types"), exports);
 __exportStar(require("./constants"), exports);
 __exportStar(require("./helpers"), exports);
+__exportStar(require("./fragment-buffers"), exports);
 __exportStar(require("./block-utils"), exports);
 __exportStar(require("./block-operations"), exports);
+__exportStar(require("./block-permutation"), exports);
+__exportStar(require("./restore-buffers"), exports);
 __exportStar(require("./validators"), exports);
 // Re-export constants with old name for backward compatibility
 var constants_1 = require("./constants");

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,8CAA4B;AAC5B,4CAA0B;AAC1B,qDAAmC;AACnC,gDAA8B;AAC9B,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC;AAClC,+CAA6B;AAE7B,+DAA+D;AAC/D,yCAA2D;AAAlD,yHAAA,4BAA4B,OAAA"}

package/dist/restore-buffers.d.ts

@@ -0,0 +1,3 @@
+import type { FragmentationConfig, ImageBufferData, ImageInfo, ManifestData } from "./types";
+export declare function restoreImageBuffers(fragments: ImageBufferData[], manifest: ManifestData): Uint8Array[];
+export declare function restoreSingleImageBuffer(fragment: ImageBufferData, config: Pick<Required<FragmentationConfig>, "blockSize" | "seed">, imageInfo: ImageInfo): Uint8Array;

package/dist/restore-buffers.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.restoreImageBuffers = restoreImageBuffers;
+exports.restoreSingleImageBuffer = restoreSingleImageBuffer;
+const block_operations_1 = require("./block-operations");
+const block_permutation_1 = require("./block-permutation");
+const block_utils_1 = require("./block-utils");
+const validators_1 = require("./validators");
+function restoreImageBuffers(fragments, manifest) {
+    (0, validators_1.validateFragmentImageCount)(fragments, manifest);
+    if (manifest.config.crossImageShuffle) {
+        return restoreAcrossImages(fragments, manifest);
+    }
+    return restoreEachImage(fragments, manifest);
+}
+function restoreSingleImageBuffer(fragment, config, imageInfo) {
+    const { blockCountX, blockCountY } = (0, block_utils_1.calculateBlockCounts)(imageInfo.w, imageInfo.h, config.blockSize);
+    const blockCount = blockCountX * blockCountY;
+    const permutation = (0, block_permutation_1.createPermutation)(blockCount, config.seed);
+    const inverse = (0, block_permutation_1.invertPermutation)(permutation);
+    const outputBuffer = new Uint8Array(imageInfo.w * imageInfo.h * block_utils_1.RGBA_CHANNELS);
+    for (let blockIndex = 0; blockIndex < blockCount; blockIndex++) {
+        (0, block_operations_1.copyBlockFromImageBuffer)(fragment.buffer, fragment.width, fragment.height, config.blockSize, inverse[blockIndex], outputBuffer, imageInfo.w, imageInfo.h, blockIndex, blockCountX);
+    }
+    return outputBuffer;
+}
+function restoreEachImage(fragments, manifest) {
+    return manifest.images.map((imageInfo, imageIndex) => restoreSingleImageBuffer(fragments[imageIndex], manifest.config, imageInfo));
+}
+function restoreAcrossImages(fragments, manifest) {
+    const totalBlocks = (0, block_utils_1.calculateTotalBlocks)(manifest.images, manifest.config.blockSize);
+    const blockCountsForCrossImages = (0, block_utils_1.calculateBlockCountsForCrossImages)(totalBlocks, fragments.length);
+    const blockCountsPerImage = (0, block_utils_1.calculateBlockCountsPerImage)(manifest.images, manifest.config.blockSize);
+    const fragmentEnds = (0, block_permutation_1.buildCumulativeCounts)(blockCountsForCrossImages);
+    const imageEnds = (0, block_permutation_1.buildCumulativeCounts)(blockCountsPerImage);
+    const permutation = (0, block_permutation_1.createPermutation)(totalBlocks, manifest.config.seed);
+    const inverse = (0, block_permutation_1.invertPermutation)(permutation);
+    return manifest.images.map((imageInfo, imageIndex) => {
+        const blockCount = blockCountsPerImage[imageIndex];
+        const imageStart = imageEnds[imageIndex] - blockCount;
+        const outputBuffer = new Uint8Array(imageInfo.w * imageInfo.h * block_utils_1.RGBA_CHANNELS);
+        const targetBlocksPerRow = (0, block_utils_1.calculateBlockCounts)(imageInfo.w, imageInfo.h, manifest.config.blockSize).blockCountX;
+        for (let localIndex = 0; localIndex < blockCount; localIndex++) {
+            const sourceIndex = inverse[imageStart + localIndex];
+            const { rangeIndex, localIndex: fragmentLocalIndex } = (0, block_permutation_1.findIndexInCumulative)(fragmentEnds, blockCountsForCrossImages, sourceIndex);
+            const fragment = fragments[rangeIndex];
+            (0, block_operations_1.copyBlockFromImageBuffer)(fragment.buffer, fragment.width, fragment.height, manifest.config.blockSize, fragmentLocalIndex, outputBuffer, imageInfo.w, imageInfo.h, localIndex, targetBlocksPerRow);
+        }
+        return outputBuffer;
+    });
+}
+//# sourceMappingURL=restore-buffers.js.map

package/dist/restore-buffers.js.map

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

package/dist/types.d.ts

@@ -55,6 +55,14 @@ export interface ManifestData {
     /** Image information */
     images: ImageInfo[];
 }
+export interface ImageBufferData {
+    /** Raw RGBA pixel buffer */
+    buffer: Uint8Array;
+    /** Image width */
+    width: number;
+    /** Image height */
+    height: number;
+}
 export interface FragmentationResult {
     /** Manifest data */
     manifest: ManifestData;

package/dist/validators.d.ts

@@ -5,7 +5,25 @@ import type { ImageInfo, ManifestData } from "./types";
  * @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;
+export declare function validateFragmentImageCount(fragmentImages: {
+    length: number;
+}, manifest: ManifestData): void;
+export declare function validateOptionsWithImages<T extends {
+    images: unknown;
+}>(options: T, context: string): T;
+export declare function validateOutputDirectoryOption<T extends {
+    outputDir?: unknown;
+}>(options: T, context: string): T;
+export declare function validateManifestOptions<T extends {
+    manifest?: unknown;
+    manifestData?: ManifestData;
+}>(options: T, context: string): T;
+export declare function validateRestoreImageOptions<T extends {
+    image?: unknown;
+    blockSize?: unknown;
+    seed?: unknown;
+    imageInfo?: ImageInfo;
+}>(options: T, context: string): T;
 /**
  * Validates that there are no duplicate file names in the image infos
  * @param imageInfos - Array of image information objects

package/dist/validators.js

@@ -1,8 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateFragmentImageCount = validateFragmentImageCount;
+exports.validateOptionsWithImages = validateOptionsWithImages;
+exports.validateOutputDirectoryOption = validateOutputDirectoryOption;
+exports.validateManifestOptions = validateManifestOptions;
+exports.validateRestoreImageOptions = validateRestoreImageOptions;
 exports.validateFileNames = validateFileNames;
 const helpers_1 = require("./helpers");
+function validateOptionsObject(options, context) {
+    if (!options) {
+        throw new Error(`[${context}] Options object is required.`);
+    }
+    return options;
+}
 /**
  * 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)
@@ -16,6 +26,48 @@ function validateFragmentImageCount(fragmentImages, manifest) {
         throw new Error(`Fragment image count mismatch: expected ${manifestImageCount} but got ${fragmentImageCount}`);
     }
 }
+function validateOptionsWithImages(options, context) {
+    validateOptionsObject(options, context);
+    if (!Array.isArray(options.images) || options.images.length === 0) {
+        throw new Error(`[${context}] images must be a non-empty array.`);
+    }
+    return options;
+}
+function validateOutputDirectoryOption(options, context) {
+    validateOptionsObject(options, context);
+    if (typeof options.outputDir !== "string" || options.outputDir.length === 0) {
+        throw new Error(`[${context}] outputDir is required and must be a string.`);
+    }
+    return options;
+}
+function validateManifestOptions(options, context) {
+    validateOptionsObject(options, context);
+    if (!options.manifest && !options.manifestData) {
+        throw new Error(`[${context}] Either manifest or manifestData is required.`);
+    }
+    if (options.manifest !== undefined && typeof options.manifest !== "string") {
+        throw new Error(`[${context}] manifest must be a string.`);
+    }
+    return options;
+}
+function validateRestoreImageOptions(options, context) {
+    validateOptionsObject(options, context);
+    if (!options.image) {
+        throw new Error(`[${context}] image is required.`);
+    }
+    if (typeof options.blockSize !== "number" || options.blockSize <= 0) {
+        throw new Error(`[${context}] blockSize must be a positive number.`);
+    }
+    if (typeof options.seed !== "number") {
+        throw new Error(`[${context}] seed must be a number.`);
+    }
+    if (!options.imageInfo ||
+        typeof options.imageInfo.w !== "number" ||
+        typeof options.imageInfo.h !== "number") {
+        throw new Error(`[${context}] imageInfo with valid w and h is required.`);
+    }
+    return options;
+}
 /**
  * Validates that there are no duplicate file names in the image infos
  * @param imageInfos - Array of image information objects

package/dist/validators.js.map

@@ -1 +1 @@
-{"version":3,"file":"validators.js","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":";;AASA,gEAYC;AAQD,8CA0BC;AAvDD,uCAA2C;AAG3C;;;;;GAKG;AACH,SAAgB,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,SAAgB,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,IAAA,wBAAc,EAAC,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"}
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixzle/core",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Core image fragmentation and restoration logic",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -22,6 +22,9 @@
     "directory": "packages/core"
   },
   "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
   "publishConfig": {
     "access": "public"
   },