@pixzle/core 0.0.19 → 0.0.21

package/dist/block-operations.cjs

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractBlock = extractBlock;
+exports.placeBlock = placeBlock;
+exports.splitImageToBlocks = splitImageToBlocks;
+exports.blocksToImageBuffer = blocksToImageBuffer;
+const block_utils_1 = require("./block-utils");
+/**
+ * Extract a block from an image buffer
+ * @param buffer Source image buffer (RGBA format)
+ * @param imageWidth Image width in pixels
+ * @param imageHeight Image height in pixels (optional, defaults to calculated height)
+ * @param startX Block top-left X coordinate
+ * @param startY Block top-left Y coordinate
+ * @param blockSize Maximum block size
+ * @returns Block buffer containing pixel data
+ */
+function extractBlock(buffer, imageWidth, imageHeight, startX, startY, blockSize) {
+    // Calculate actual block dimensions considering image boundaries
+    const blockWidth = Math.min(blockSize, imageWidth - startX);
+    const blockHeight = imageHeight !== undefined
+        ? Math.min(blockSize, imageHeight - startY)
+        : blockSize;
+    const blockData = [];
+    // Extract pixel data row by row
+    for (let y = 0; y < blockHeight; y++) {
+        for (let x = 0; x < blockWidth; x++) {
+            const pixelX = startX + x;
+            const pixelY = startY + y;
+            const pixelIndex = (pixelY * imageWidth + pixelX) * block_utils_1.RGBA_CHANNELS;
+            // Copy RGBA channels
+            for (let channel = 0; channel < block_utils_1.RGBA_CHANNELS; channel++) {
+                blockData.push(buffer[pixelIndex + channel] || 0);
+            }
+        }
+    }
+    return new Uint8Array(blockData);
+}
+/**
+ * Place block data at the specified position in the target image buffer
+ * @param targetBuffer Target image buffer to place the block into
+ * @param blockData Block data to place
+ * @param targetWidth Target image width in pixels
+ * @param destX Destination X coordinate
+ * @param destY Destination Y coordinate
+ * @param blockSize Standard block size
+ * @param blockWidth Actual block width (optional, defaults to blockSize)
+ * @param blockHeight Actual block height (optional, defaults to blockSize)
+ */
+function placeBlock(targetBuffer, blockData, targetWidth, destX, destY, blockSize, blockWidth, blockHeight) {
+    const actualWidth = blockWidth ?? blockSize;
+    const actualHeight = blockHeight ?? blockSize;
+    // Place pixels row by row
+    for (let y = 0; y < actualHeight; y++) {
+        for (let x = 0; x < actualWidth; x++) {
+            const sourceIndex = (y * actualWidth + x) * block_utils_1.RGBA_CHANNELS;
+            const targetIndex = ((destY + y) * targetWidth + (destX + x)) * block_utils_1.RGBA_CHANNELS;
+            // Ensure we don't write beyond buffer bounds
+            if (targetIndex + block_utils_1.RGBA_CHANNELS <= targetBuffer.length) {
+                // Copy RGBA channels
+                for (let channel = 0; channel < block_utils_1.RGBA_CHANNELS; channel++) {
+                    targetBuffer[targetIndex + channel] =
+                        blockData[sourceIndex + channel];
+                }
+            }
+        }
+    }
+}
+/**
+ * Calculate actual block dimensions at edge positions
+ * @param position Block position (x or y)
+ * @param blockSize Standard block size
+ * @param imageSize Image dimension (width or height)
+ * @param blockCount Total block count in that dimension
+ * @returns Actual block dimension
+ */
+function calculateActualBlockSize(position, blockSize, imageSize, blockCount) {
+    const isEdgeBlock = position === blockCount - 1;
+    return isEdgeBlock ? imageSize - position * blockSize : blockSize;
+}
+/**
+ * Calculate block dimensions considering edge cases
+ * @param position Block position
+ * @param blockSize Standard block size
+ * @param imageWidth Image width
+ * @param imageHeight Image height
+ * @param blockCounts Block counts
+ * @returns Block dimensions
+ */
+function calculateBlockDimensions(position, blockSize, imageWidth, imageHeight, blockCounts) {
+    return {
+        width: calculateActualBlockSize(position.x, blockSize, imageWidth, blockCounts.blockCountX),
+        height: calculateActualBlockSize(position.y, blockSize, imageHeight, blockCounts.blockCountY),
+    };
+}
+/**
+ * Split an RGBA image buffer into an array of blocks
+ * @param buffer Source image buffer (RGBA format)
+ * @param width Image width in pixels
+ * @param height Image height in pixels
+ * @param blockSize Block size in pixels
+ * @returns Array of block buffers
+ */
+function splitImageToBlocks(buffer, width, height, blockSize) {
+    const blocks = [];
+    const blockCounts = (0, block_utils_1.calculateBlockCounts)(width, height, blockSize);
+    // Process blocks row by row, left to right
+    for (let blockY = 0; blockY < blockCounts.blockCountY; blockY++) {
+        for (let blockX = 0; blockX < blockCounts.blockCountX; blockX++) {
+            const startX = blockX * blockSize;
+            const startY = blockY * blockSize;
+            const block = extractBlock(buffer, width, height, startX, startY, blockSize);
+            blocks.push(block);
+        }
+    }
+    return blocks;
+}
+/**
+ * Reconstruct an RGBA image buffer from an array of blocks
+ * @param blocks Array of block buffers
+ * @param width Target image width in pixels
+ * @param height Target image height in pixels
+ * @param blockSize Block size in pixels
+ * @returns Reconstructed image buffer
+ */
+function blocksToImageBuffer(blocks, width, height, blockSize) {
+    const imageBuffer = new Uint8Array(width * height * block_utils_1.RGBA_CHANNELS);
+    const blockCounts = (0, block_utils_1.calculateBlockCounts)(width, height, blockSize);
+    let blockIndex = 0;
+    // Place blocks row by row, left to right
+    for (let blockY = 0; blockY < blockCounts.blockCountY; blockY++) {
+        for (let blockX = 0; blockX < blockCounts.blockCountX; blockX++) {
+            if (blockIndex >= blocks.length) {
+                break;
+            }
+            const position = { x: blockX, y: blockY };
+            const dimensions = calculateBlockDimensions(position, blockSize, width, height, blockCounts);
+            const destX = blockX * blockSize;
+            const destY = blockY * blockSize;
+            placeBlock(imageBuffer, blocks[blockIndex], width, destX, destY, blockSize, dimensions.width, dimensions.height);
+            blockIndex++;
+        }
+    }
+    return imageBuffer;
+}
+//# sourceMappingURL=block-operations.js.map

package/dist/block-operations.d.cts

@@ -0,0 +1,56 @@
+/**
+ * Position of a block in the image grid
+ */
+export interface BlockPosition {
+    x: number;
+    y: number;
+}
+/**
+ * Dimensions of a block
+ */
+export interface BlockDimensions {
+    width: number;
+    height: number;
+}
+/**
+ * Extract a block from an image buffer
+ * @param buffer Source image buffer (RGBA format)
+ * @param imageWidth Image width in pixels
+ * @param imageHeight Image height in pixels (optional, defaults to calculated height)
+ * @param startX Block top-left X coordinate
+ * @param startY Block top-left Y coordinate
+ * @param blockSize Maximum block size
+ * @returns Block buffer containing pixel data
+ */
+export declare function extractBlock(buffer: Uint8Array, imageWidth: number, imageHeight: number | undefined, startX: number, startY: number, blockSize: number): Uint8Array;
+/**
+ * Place block data at the specified position in the target image buffer
+ * @param targetBuffer Target image buffer to place the block into
+ * @param blockData Block data to place
+ * @param targetWidth Target image width in pixels
+ * @param destX Destination X coordinate
+ * @param destY Destination Y coordinate
+ * @param blockSize Standard block size
+ * @param blockWidth Actual block width (optional, defaults to blockSize)
+ * @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;
+/**
+ * Split an RGBA image buffer into an array of blocks
+ * @param buffer Source image buffer (RGBA format)
+ * @param width Image width in pixels
+ * @param height Image height in pixels
+ * @param blockSize Block size in pixels
+ * @returns Array of block buffers
+ */
+export declare function splitImageToBlocks(buffer: Uint8Array, width: number, height: number, blockSize: number): Uint8Array[];
+/**
+ * Reconstruct an RGBA image buffer from an array of blocks
+ * @param blocks Array of block buffers
+ * @param width Target image width in pixels
+ * @param height Target image height in pixels
+ * @param blockSize Block size in pixels
+ * @returns Reconstructed image buffer
+ */
+export declare function blocksToImageBuffer(blocks: Uint8Array[], width: number, height: number, blockSize: number): Uint8Array;
+//# sourceMappingURL=block-operations.d.ts.map

package/dist/block-operations.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Position of a block in the image grid
+ */
+export interface BlockPosition {
+    x: number;
+    y: number;
+}
+/**
+ * Dimensions of a block
+ */
+export interface BlockDimensions {
+    width: number;
+    height: number;
+}
+/**
+ * Extract a block from an image buffer
+ * @param buffer Source image buffer (RGBA format)
+ * @param imageWidth Image width in pixels
+ * @param imageHeight Image height in pixels (optional, defaults to calculated height)
+ * @param startX Block top-left X coordinate
+ * @param startY Block top-left Y coordinate
+ * @param blockSize Maximum block size
+ * @returns Block buffer containing pixel data
+ */
+export declare function extractBlock(buffer: Uint8Array, imageWidth: number, imageHeight: number | undefined, startX: number, startY: number, blockSize: number): Uint8Array;
+/**
+ * Place block data at the specified position in the target image buffer
+ * @param targetBuffer Target image buffer to place the block into
+ * @param blockData Block data to place
+ * @param targetWidth Target image width in pixels
+ * @param destX Destination X coordinate
+ * @param destY Destination Y coordinate
+ * @param blockSize Standard block size
+ * @param blockWidth Actual block width (optional, defaults to blockSize)
+ * @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;
+/**
+ * Split an RGBA image buffer into an array of blocks
+ * @param buffer Source image buffer (RGBA format)
+ * @param width Image width in pixels
+ * @param height Image height in pixels
+ * @param blockSize Block size in pixels
+ * @returns Array of block buffers
+ */
+export declare function splitImageToBlocks(buffer: Uint8Array, width: number, height: number, blockSize: number): Uint8Array[];
+/**
+ * Reconstruct an RGBA image buffer from an array of blocks
+ * @param blocks Array of block buffers
+ * @param width Target image width in pixels
+ * @param height Target image height in pixels
+ * @param blockSize Block size in pixels
+ * @returns Reconstructed image buffer
+ */
+export declare function blocksToImageBuffer(blocks: Uint8Array[], width: number, height: number, blockSize: number): Uint8Array;

package/dist/block-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-operations.d.ts","sourceRoot":"","sources":["../src/block-operations.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,UAAU,CAyBZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,YAAY,EAAE,UAAU,EACxB,SAAS,EAAE,UAAU,EACrB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAqBN;AAoDD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,UAAU,EAAE,CAwBd;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAAE,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,UAAU,CAyCZ"}

package/dist/block-operations.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractBlock = extractBlock;
+exports.placeBlock = placeBlock;
+exports.splitImageToBlocks = splitImageToBlocks;
+exports.blocksToImageBuffer = blocksToImageBuffer;
+const block_utils_1 = require("./block-utils");
+/**
+ * Extract a block from an image buffer
+ * @param buffer Source image buffer (RGBA format)
+ * @param imageWidth Image width in pixels
+ * @param imageHeight Image height in pixels (optional, defaults to calculated height)
+ * @param startX Block top-left X coordinate
+ * @param startY Block top-left Y coordinate
+ * @param blockSize Maximum block size
+ * @returns Block buffer containing pixel data
+ */
+function extractBlock(buffer, imageWidth, imageHeight, startX, startY, blockSize) {
+    // Calculate actual block dimensions considering image boundaries
+    const blockWidth = Math.min(blockSize, imageWidth - startX);
+    const blockHeight = imageHeight !== undefined
+        ? Math.min(blockSize, imageHeight - startY)
+        : blockSize;
+    const blockData = new Uint8Array(blockSize * blockSize * block_utils_1.RGBA_CHANNELS);
+    // Extract pixel data row by row
+    for (let y = 0; y < blockHeight; y++) {
+        for (let x = 0; x < blockWidth; x++) {
+            const pixelX = startX + x;
+            const pixelY = startY + y;
+            const pixelIndex = (pixelY * imageWidth + pixelX) * block_utils_1.RGBA_CHANNELS;
+            const blockIndex = (y * blockSize + x) * block_utils_1.RGBA_CHANNELS;
+            // Copy RGBA channels
+            for (let channel = 0; channel < block_utils_1.RGBA_CHANNELS; channel++) {
+                blockData[blockIndex + channel] = buffer[pixelIndex + channel] || 0;
+            }
+        }
+    }
+    return blockData;
+}
+/**
+ * Place block data at the specified position in the target image buffer
+ * @param targetBuffer Target image buffer to place the block into
+ * @param blockData Block data to place
+ * @param targetWidth Target image width in pixels
+ * @param destX Destination X coordinate
+ * @param destY Destination Y coordinate
+ * @param blockSize Standard block size
+ * @param blockWidth Actual block width (optional, defaults to blockSize)
+ * @param blockHeight Actual block height (optional, defaults to blockSize)
+ */
+function placeBlock(targetBuffer, blockData, targetWidth, destX, destY, blockSize, blockWidth, blockHeight) {
+    const actualWidth = blockWidth ?? blockSize;
+    const actualHeight = blockHeight ?? blockSize;
+    // Place pixels row by row
+    for (let y = 0; y < actualHeight; y++) {
+        for (let x = 0; x < actualWidth; x++) {
+            const sourceIndex = (y * blockSize + x) * block_utils_1.RGBA_CHANNELS;
+            const targetIndex = ((destY + y) * targetWidth + (destX + x)) * block_utils_1.RGBA_CHANNELS;
+            // Ensure we don't write beyond buffer bounds
+            if (targetIndex + block_utils_1.RGBA_CHANNELS <= targetBuffer.length) {
+                // Copy RGBA channels
+                for (let channel = 0; channel < block_utils_1.RGBA_CHANNELS; channel++) {
+                    targetBuffer[targetIndex + channel] =
+                        blockData[sourceIndex + channel];
+                }
+            }
+        }
+    }
+}
+/**
+ * Calculate actual block dimensions at edge positions
+ * @param position Block position (x or y)
+ * @param blockSize Standard block size
+ * @param imageSize Image dimension (width or height)
+ * @param blockCount Total block count in that dimension
+ * @returns Actual block dimension
+ */
+function calculateActualBlockSize(position, blockSize, imageSize, blockCount) {
+    const isEdgeBlock = position === blockCount - 1;
+    return isEdgeBlock ? imageSize - position * blockSize : blockSize;
+}
+/**
+ * Calculate block dimensions considering edge cases
+ * @param position Block position
+ * @param blockSize Standard block size
+ * @param imageWidth Image width
+ * @param imageHeight Image height
+ * @param blockCounts Block counts
+ * @returns Block dimensions
+ */
+function calculateBlockDimensions(position, blockSize, imageWidth, imageHeight, blockCounts) {
+    return {
+        width: calculateActualBlockSize(position.x, blockSize, imageWidth, blockCounts.blockCountX),
+        height: calculateActualBlockSize(position.y, blockSize, imageHeight, blockCounts.blockCountY),
+    };
+}
+/**
+ * Split an RGBA image buffer into an array of blocks
+ * @param buffer Source image buffer (RGBA format)
+ * @param width Image width in pixels
+ * @param height Image height in pixels
+ * @param blockSize Block size in pixels
+ * @returns Array of block buffers
+ */
+function splitImageToBlocks(buffer, width, height, blockSize) {
+    const blocks = [];
+    const blockCounts = (0, block_utils_1.calculateBlockCounts)(width, height, blockSize);
+    // Process blocks row by row, left to right
+    for (let blockY = 0; blockY < blockCounts.blockCountY; blockY++) {
+        for (let blockX = 0; blockX < blockCounts.blockCountX; blockX++) {
+            const startX = blockX * blockSize;
+            const startY = blockY * blockSize;
+            const block = extractBlock(buffer, width, height, startX, startY, blockSize);
+            blocks.push(block);
+        }
+    }
+    return blocks;
+}
+/**
+ * Reconstruct an RGBA image buffer from an array of blocks
+ * @param blocks Array of block buffers
+ * @param width Target image width in pixels
+ * @param height Target image height in pixels
+ * @param blockSize Block size in pixels
+ * @returns Reconstructed image buffer
+ */
+function blocksToImageBuffer(blocks, width, height, blockSize) {
+    const imageBuffer = new Uint8Array(width * height * block_utils_1.RGBA_CHANNELS);
+    const blockCounts = (0, block_utils_1.calculateBlockCounts)(width, height, blockSize);
+    let blockIndex = 0;
+    // Place blocks row by row, left to right
+    for (let blockY = 0; blockY < blockCounts.blockCountY; blockY++) {
+        for (let blockX = 0; blockX < blockCounts.blockCountX; blockX++) {
+            if (blockIndex >= blocks.length) {
+                break;
+            }
+            const position = { x: blockX, y: blockY };
+            const dimensions = calculateBlockDimensions(position, blockSize, width, height, blockCounts);
+            const destX = blockX * blockSize;
+            const destY = blockY * blockSize;
+            placeBlock(imageBuffer, blocks[blockIndex], width, destX, destY, blockSize, dimensions.width, dimensions.height);
+            blockIndex++;
+        }
+    }
+    return imageBuffer;
+}
+//# sourceMappingURL=block-operations.js.map

package/dist/block-operations.js.map

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

package/dist/block-utils.cjs

@@ -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.d.cts

@@ -0,0 +1,47 @@
+import type { ImageInfo } from "./types";
+/**
+ * Number of channels in RGBA format
+ */
+export declare const RGBA_CHANNELS = 4;
+export interface BlockCounts {
+    blockCountX: number;
+    blockCountY: number;
+}
+/**
+ * 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
+ */
+export declare function calculateBlockCounts(width: number, height: number, blockSize: number): BlockCounts;
+/**
+ * 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
+ */
+export declare function calculateBlockRange(blockCounts: number[], targetIndex: number): {
+    start: number;
+    end: number;
+};
+/**
+ * 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
+ */
+export declare function calculateBlockCountsForCrossImages(totalBlocks: number, fragmentCount: number): number[];
+/**
+ * Calculate block counts for each image
+ * @param images Array of ImageInfo objects
+ * @returns Array of block counts per image (x * y)
+ */
+export declare function calculateBlockCountsPerImage(images: ImageInfo[]): number[];
+/**
+ * Calculate total number of blocks from images
+ * @param images Array of ImageInfo objects
+ * @returns Total block count
+ */
+export declare function calculateTotalBlocks(images: ImageInfo[]): number;
+//# sourceMappingURL=block-utils.d.ts.map

package/dist/block-utils.d.ts

@@ -0,0 +1,48 @@
+import type { ImageInfo } from "./types";
+/**
+ * Number of channels in RGBA format
+ */
+export declare const RGBA_CHANNELS = 4;
+export interface BlockCounts {
+    blockCountX: number;
+    blockCountY: number;
+}
+/**
+ * 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
+ */
+export declare function calculateBlockCounts(width: number, height: number, blockSize: number): BlockCounts;
+/**
+ * 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
+ */
+export declare function calculateBlockRange(blockCounts: number[], targetIndex: number): {
+    start: number;
+    end: number;
+};
+/**
+ * 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
+ */
+export declare function calculateBlockCountsForCrossImages(totalBlocks: number, fragmentCount: number): number[];
+/**
+ * Calculate block counts for each image
+ * @param images Array of ImageInfo objects
+ * @param blockSize Block size
+ * @returns Array of block counts per image (x * y)
+ */
+export declare function calculateBlockCountsPerImage(images: ImageInfo[], blockSize: number): number[];
+/**
+ * Calculate total number of blocks from images
+ * @param images Array of ImageInfo objects
+ * @param blockSize Block size
+ * @returns Total block count
+ */
+export declare function calculateTotalBlocks(images: ImageInfo[], blockSize: number): number;

package/dist/block-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-utils.d.ts","sourceRoot":"","sources":["../src/block-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,WAAW,CAKb;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,EAAE,MAAM,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAOhC;AAED;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,MAAM,EAAE,CAgCV;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAE1E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAEhE"}