@pixzle/node 0.0.18 → 0.0.20

package/dist/esm/block.js.map

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

package/dist/esm/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: string;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,QAAU,CAAC"}

package/dist/esm/constants.js

@@ -0,0 +1,3 @@
+import { version } from "./../package.json";
+export const VERSION = version;
+//# sourceMappingURL=constants.js.map

package/dist/esm/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/esm/file.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Create a directory
+ * @param dir Directory path
+ * @param recursive Create parent directories if they don't exist
+ */
+export declare function createDir(dir: string, recursive?: boolean): Promise<void>;
+/**
+ * Write a file
+ * @param dir Directory path
+ * @param filename Filename
+ * @param data Data to write
+ * @returns Path to the file
+ */
+export declare function writeFile(dir: string, filename: string, data: string | Buffer): Promise<string>;
+/**
+ * Read a JSON file and return its content
+ * @param filePath Path to the JSON file
+ * @returns Content of the JSON file
+ */
+export declare function readJsonFile<T>(filePath: string): Promise<T>;
+/**
+ * Read a file and return its content
+ * @param filePath Path to the file
+ * @returns Content of the file
+ */
+export declare function readFileBuffer(filePath: string): Promise<Buffer>;
+/**
+ * Get the filename without the extension
+ * @param filePath Path to the file
+ * @returns Filename without the extension
+ */
+export declare function fileNameWithoutExtension(filePath: string): string;
+//# sourceMappingURL=file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/file.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,UAAQ,iBAE7D;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GAAG,MAAM,mBAKtB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAElE;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/esm/file.js

@@ -0,0 +1,47 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+/**
+ * Create a directory
+ * @param dir Directory path
+ * @param recursive Create parent directories if they don't exist
+ */
+export async function createDir(dir, recursive = false) {
+    await fs.mkdir(dir, { recursive });
+}
+/**
+ * Write a file
+ * @param dir Directory path
+ * @param filename Filename
+ * @param data Data to write
+ * @returns Path to the file
+ */
+export async function writeFile(dir, filename, data) {
+    const filePath = path.join(dir, filename);
+    await fs.writeFile(filePath, data);
+    return filePath;
+}
+/**
+ * Read a JSON file and return its content
+ * @param filePath Path to the JSON file
+ * @returns Content of the JSON file
+ */
+export async function readJsonFile(filePath) {
+    return JSON.parse(await fs.readFile(filePath, "utf8"));
+}
+/**
+ * Read a file and return its content
+ * @param filePath Path to the file
+ * @returns Content of the file
+ */
+export async function readFileBuffer(filePath) {
+    return await fs.readFile(filePath);
+}
+/**
+ * Get the filename without the extension
+ * @param filePath Path to the file
+ * @returns Filename without the extension
+ */
+export function fileNameWithoutExtension(filePath) {
+    return path.basename(filePath, path.extname(filePath));
+}
+//# sourceMappingURL=file.js.map

package/dist/esm/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,SAAS,GAAG,KAAK;IAC5D,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,QAAgB,EAChB,IAAqB;IAErB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/esm/fragmenter.d.ts

@@ -0,0 +1,14 @@
+import { type FragmentationConfig, type FragmentationResult } from "@pixzle/core";
+export declare class ImageFragmenter {
+    private config;
+    constructor(config: FragmentationConfig);
+    private _initializeConfig;
+    fragmentImages(paths: string[]): Promise<FragmentationResult>;
+    private _createImages;
+    private _createManifest;
+    private _prepareData;
+    private _processImages;
+    private _processImage;
+    private _createImage;
+}
+//# sourceMappingURL=fragmenter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fragmenter.d.ts","sourceRoot":"","sources":["../../src/fragmenter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAQzB,MAAM,cAAc,CAAC;AAOtB,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgC;gBAElC,MAAM,EAAE,mBAAmB;IAIvC,OAAO,CAAC,iBAAiB;IAenB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;YA6BrD,aAAa;IAc3B,OAAO,CAAC,eAAe;YAaT,YAAY;YAyBZ,cAAc;YAcd,aAAa;YAuBb,YAAY;CAW3B"}

package/dist/esm/fragmenter.js

@@ -0,0 +1,91 @@
+import { DEFAULT_FRAGMENTATION_CONFIG, calculateBlockCountsForCrossImages, calculateBlockCountsPerImage, calculateBlockRange, encodeFileName, validateFileNames, } from "@pixzle/core";
+import { SeededRandom, shuffle } from "@tuki0918/seeded-shuffle";
+import { blocksPerImage, blocksToPngImage, imageFileToBlocks } from "./block";
+import { VERSION } from "./constants";
+import { fileNameWithoutExtension, readFileBuffer } from "./file";
+import { generateManifestId } from "./utils";
+export class ImageFragmenter {
+    config;
+    constructor(config) {
+        this.config = this._initializeConfig(config);
+    }
+    _initializeConfig(config) {
+        return {
+            blockSize: config.blockSize ?? DEFAULT_FRAGMENTATION_CONFIG.BLOCK_SIZE,
+            prefix: config.prefix ?? DEFAULT_FRAGMENTATION_CONFIG.PREFIX,
+            seed: config.seed || SeededRandom.generateSeed(),
+            preserveName: config.preserveName ?? DEFAULT_FRAGMENTATION_CONFIG.PRESERVE_NAME,
+            crossImageShuffle: config.crossImageShuffle ??
+                DEFAULT_FRAGMENTATION_CONFIG.CROSS_IMAGE_SHUFFLE,
+        };
+    }
+    async fragmentImages(paths) {
+        const { manifest, blocks, blockCountsForCrossImages, blockCountsPerImage } = await this._prepareData(paths);
+        const shuffled = this.config.crossImageShuffle
+            ? shuffle(blocks, manifest.config.seed)
+            : blocksPerImage(blocks, blockCountsPerImage, manifest.config.seed, shuffle);
+        const blockCounts = this.config.crossImageShuffle
+            ? blockCountsForCrossImages
+            : blockCountsPerImage;
+        const fragmentedImages = await this._createImages(shuffled, blockCounts, manifest);
+        return {
+            manifest,
+            fragmentedImages,
+        };
+    }
+    async _createImages(blocks, blockCounts, manifest) {
+        return await Promise.all(manifest.images.map(async (_, index) => {
+            const { start, end } = calculateBlockRange(blockCounts, index);
+            const imageBlocks = blocks.slice(start, end);
+            return await this._createImage(imageBlocks, manifest.config.blockSize);
+        }));
+    }
+    _createManifest(manifestId, imageInfos) {
+        return {
+            id: manifestId,
+            version: VERSION,
+            timestamp: new Date().toISOString(),
+            config: this.config,
+            images: imageInfos,
+        };
+    }
+    async _prepareData(paths) {
+        const manifestId = generateManifestId();
+        const { imageInfos, blocks } = await this._processImages(paths);
+        validateFileNames(imageInfos, this.config.preserveName);
+        const manifest = this._createManifest(manifestId, imageInfos);
+        const blockCountsForCrossImages = calculateBlockCountsForCrossImages(blocks.length, paths.length);
+        // Calculate actual block counts per image for per-image shuffle
+        const blockCountsPerImage = calculateBlockCountsPerImage(imageInfos);
+        return { manifest, blocks, blockCountsForCrossImages, blockCountsPerImage };
+    }
+    async _processImages(paths) {
+        const results = await Promise.all(paths.map((path) => this._processImage(path)));
+        const imageInfos = results.map((r) => r.imageInfo);
+        const blocks = results.flatMap((r) => r.blocks);
+        return { imageInfos, blocks };
+    }
+    async _processImage(path) {
+        const buffer = await readFileBuffer(path);
+        const { blocks, width, height, blockCountX, blockCountY } = await imageFileToBlocks(buffer, this.config.blockSize);
+        const imageInfo = {
+            w: width,
+            h: height,
+            c: 4, // Always use 4 channels (RGBA) for generated PNG
+            x: blockCountX,
+            y: blockCountY,
+            name: this.config.preserveName
+                ? encodeFileName(fileNameWithoutExtension(path))
+                : undefined,
+        };
+        return { imageInfo, blocks };
+    }
+    async _createImage(blocks, blockSize) {
+        const blockCount = blocks.length;
+        const blocksPerRow = Math.ceil(Math.sqrt(blockCount));
+        const imageWidth = blocksPerRow * blockSize;
+        const imageHeight = Math.ceil(blockCount / blocksPerRow) * blockSize;
+        return await blocksToPngImage(blocks, imageWidth, imageHeight, blockSize);
+    }
+}
+//# sourceMappingURL=fragmenter.js.map

package/dist/esm/fragmenter.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,12 @@
+import { type FragmentationConfig, type ManifestData, type RestoreOptions, type ShuffleOptions } from "@pixzle/core";
+import { ImageFragmenter } from "./fragmenter";
+import { ImageRestorer } from "./restorer";
+export { ImageFragmenter, ImageRestorer, type FragmentationConfig, type ManifestData, };
+declare function shuffle(options: ShuffleOptions): Promise<void>;
+declare function restore(options: RestoreOptions): Promise<void>;
+declare const pixzle: {
+    shuffle: typeof shuffle;
+    restore: typeof restore;
+};
+export default pixzle;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EAExB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EAKpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EACL,eAAe,EACf,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,YAAY,GAClB,CAAC;AAEF,iBAAe,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB7D;AAED,iBAAe,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB7D;AAED,QAAA,MAAM,MAAM;;;CAGX,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,55 @@
+import { MANIFEST_FILE_NAME, generateFragmentFileName, generateRestoredFileName, generateRestoredOriginalFileName, validateFragmentImageCount, } from "@pixzle/core";
+import { createDir, readJsonFile, writeFile } from "./file";
+import { ImageFragmenter } from "./fragmenter";
+import { ImageRestorer } from "./restorer";
+export { ImageFragmenter, ImageRestorer, };
+async function shuffle(options) {
+    const { imagePaths, config, outputDir } = validateShuffleOptions(options);
+    const fragmenter = new ImageFragmenter(config ?? {});
+    const { manifest, fragmentedImages } = await fragmenter.fragmentImages(imagePaths);
+    await createDir(outputDir, true);
+    await writeFile(outputDir, MANIFEST_FILE_NAME, JSON.stringify(manifest, null, 2));
+    await Promise.all(fragmentedImages.map((img, i) => {
+        const filename = generateFragmentFileName(manifest, i);
+        return writeFile(outputDir, filename, img);
+    }));
+}
+async function restore(options) {
+    const { imagePaths, manifestPath, outputDir } = validateRestoreOptions(options);
+    const manifest = await readJsonFile(manifestPath);
+    validateFragmentImageCount(imagePaths, manifest);
+    const restorer = new ImageRestorer();
+    const restoredImages = await restorer.restoreImages(imagePaths, manifest);
+    await createDir(outputDir, true);
+    const imageInfos = manifest.images;
+    await Promise.all(restoredImages.map((img, i) => {
+        const filename = generateRestoredOriginalFileName(imageInfos[i]) ??
+            generateRestoredFileName(manifest, i);
+        return writeFile(outputDir, filename, img);
+    }));
+}
+const pixzle = {
+    shuffle,
+    restore,
+};
+export default pixzle;
+function validateCommonOptions(options, context) {
+    if (!options)
+        throw new Error(`[${context}] Options object is required.`);
+    const { imagePaths, outputDir } = options;
+    if (!imagePaths || !Array.isArray(imagePaths) || imagePaths.length === 0)
+        throw new Error(`[${context}] imagePaths must be a non-empty array.`);
+    if (!outputDir || typeof outputDir !== "string")
+        throw new Error(`[${context}] outputDir is required and must be a string.`);
+    return options;
+}
+function validateShuffleOptions(options) {
+    return validateCommonOptions(options, "shuffle");
+}
+function validateRestoreOptions(options) {
+    const { manifestPath } = options;
+    if (!manifestPath || typeof manifestPath !== "string")
+        throw new Error("[restore] manifestPath is required and must be a string.");
+    return validateCommonOptions(options, "restore");
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/esm/restorer.d.ts

@@ -0,0 +1,10 @@
+import { type ManifestData } from "@pixzle/core";
+export declare class ImageRestorer {
+    restoreImages(fragments: (string | Buffer)[], manifest: ManifestData): Promise<Buffer[]>;
+    private _reconstructImages;
+    private _prepareData;
+    private _readBlocksFromFragment;
+    private _readBlocks;
+    private _createImage;
+}
+//# sourceMappingURL=restorer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restorer.d.ts","sourceRoot":"","sources":["../../src/restorer.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EAKlB,MAAM,cAAc,CAAC;AAKtB,qBAAa,aAAa;IAClB,aAAa,CACjB,SAAS,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAC9B,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC;YAkBN,kBAAkB;YAkBlB,YAAY;YA2BZ,uBAAuB;YAgBvB,WAAW;YAaX,YAAY;CAQ3B"}

package/dist/esm/restorer.js

@@ -0,0 +1,50 @@
+import { calculateBlockCountsForCrossImages, calculateBlockCountsPerImage, calculateBlockRange, calculateTotalBlocks, } from "@pixzle/core";
+import { unshuffle } from "@tuki0918/seeded-shuffle";
+import { blocksPerImage, blocksToPngImage, imageFileToBlocks } from "./block";
+import { readFileBuffer } from "./file";
+export class ImageRestorer {
+    async restoreImages(fragments, manifest) {
+        const { blocks, blockCountsPerImage } = await this._prepareData(fragments, manifest);
+        const restored = manifest.config.crossImageShuffle
+            ? unshuffle(blocks, manifest.config.seed)
+            : blocksPerImage(blocks, blockCountsPerImage, manifest.config.seed, unshuffle);
+        return await this._reconstructImages(restored, manifest);
+    }
+    async _reconstructImages(blocks, manifest) {
+        const blockCountsPerImage = calculateBlockCountsPerImage(manifest.images);
+        return await Promise.all(manifest.images.map(async (imageInfo, index) => {
+            const { start, end } = calculateBlockRange(blockCountsPerImage, index);
+            const imageBlocks = blocks.slice(start, end);
+            return await this._createImage(imageBlocks, manifest.config.blockSize, imageInfo);
+        }));
+    }
+    async _prepareData(fragments, manifest) {
+        const totalBlocks = calculateTotalBlocks(manifest.images);
+        const blockCountsForCrossImages = calculateBlockCountsForCrossImages(totalBlocks, fragments.length);
+        // Calculate actual block counts per image for per-image unshuffle
+        const blockCountsPerImage = calculateBlockCountsPerImage(manifest.images);
+        // Use blockCountsPerImage when crossImageShuffle is false
+        const blockCounts = manifest.config.crossImageShuffle
+            ? blockCountsForCrossImages
+            : blockCountsPerImage;
+        const blocks = await this._readBlocks(fragments, manifest, blockCounts);
+        return { blocks, blockCountsPerImage };
+    }
+    // Extract an array of blocks (Buffer) from a fragment image
+    async _readBlocksFromFragment(fragment, manifest, expectedCount) {
+        const buffer = Buffer.isBuffer(fragment)
+            ? fragment
+            : await readFileBuffer(fragment);
+        const { blocks } = await imageFileToBlocks(buffer, manifest.config.blockSize);
+        return blocks.slice(0, expectedCount);
+    }
+    async _readBlocks(fragments, manifest, blockCounts) {
+        const blockGroups = await Promise.all(fragments.map((fragment, i) => this._readBlocksFromFragment(fragment, manifest, blockCounts[i])));
+        return blockGroups.flat();
+    }
+    async _createImage(blocks, blockSize, imageInfo) {
+        const { w, h } = imageInfo;
+        return await blocksToPngImage(blocks, w, h, blockSize);
+    }
+}
+//# sourceMappingURL=restorer.js.map

package/dist/esm/restorer.js.map

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

package/dist/esm/utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generate a unique manifest ID
+ * @returns A UUID string
+ */
+export declare function generateManifestId(): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/esm/utils.js

@@ -0,0 +1,9 @@
+import crypto from "node:crypto";
+/**
+ * Generate a unique manifest ID
+ * @returns A UUID string
+ */
+export function generateManifestId() {
+    return crypto.randomUUID();
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;AAC7B,CAAC"}

package/dist/file.cjs

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDir = createDir;
+exports.writeFile = writeFile;
+exports.readJsonFile = readJsonFile;
+exports.readFileBuffer = readFileBuffer;
+exports.fileNameWithoutExtension = fileNameWithoutExtension;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Create a directory
+ * @param dir Directory path
+ * @param recursive Create parent directories if they don't exist
+ */
+async function createDir(dir, recursive = false) {
+    await node_fs_1.promises.mkdir(dir, { recursive });
+}
+/**
+ * Write a file
+ * @param dir Directory path
+ * @param filename Filename
+ * @param data Data to write
+ * @returns Path to the file
+ */
+async function writeFile(dir, filename, data) {
+    const filePath = node_path_1.default.join(dir, filename);
+    await node_fs_1.promises.writeFile(filePath, data);
+    return filePath;
+}
+/**
+ * Read a JSON file and return its content
+ * @param filePath Path to the JSON file
+ * @returns Content of the JSON file
+ */
+async function readJsonFile(filePath) {
+    return JSON.parse(await node_fs_1.promises.readFile(filePath, "utf8"));
+}
+/**
+ * Read a file and return its content
+ * @param filePath Path to the file
+ * @returns Content of the file
+ */
+async function readFileBuffer(filePath) {
+    return await node_fs_1.promises.readFile(filePath);
+}
+/**
+ * Get the filename without the extension
+ * @param filePath Path to the file
+ * @returns Filename without the extension
+ */
+function fileNameWithoutExtension(filePath) {
+    return node_path_1.default.basename(filePath, node_path_1.default.extname(filePath));
+}
+//# sourceMappingURL=file.js.map

package/dist/file.d.cts

@@ -0,0 +1,33 @@
+/**
+ * Create a directory
+ * @param dir Directory path
+ * @param recursive Create parent directories if they don't exist
+ */
+export declare function createDir(dir: string, recursive?: boolean): Promise<void>;
+/**
+ * Write a file
+ * @param dir Directory path
+ * @param filename Filename
+ * @param data Data to write
+ * @returns Path to the file
+ */
+export declare function writeFile(dir: string, filename: string, data: string | Buffer): Promise<string>;
+/**
+ * Read a JSON file and return its content
+ * @param filePath Path to the JSON file
+ * @returns Content of the JSON file
+ */
+export declare function readJsonFile<T>(filePath: string): Promise<T>;
+/**
+ * Read a file and return its content
+ * @param filePath Path to the file
+ * @returns Content of the file
+ */
+export declare function readFileBuffer(filePath: string): Promise<Buffer>;
+/**
+ * Get the filename without the extension
+ * @param filePath Path to the file
+ * @returns Filename without the extension
+ */
+export declare function fileNameWithoutExtension(filePath: string): string;
+//# sourceMappingURL=file.d.ts.map

package/dist/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,UAAQ,iBAE7D;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GAAG,MAAM,mBAKtB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAElE;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/file.js

@@ -1,12 +1,22 @@
-import { promises as fs } from "node:fs";
-import path from "node:path";
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDir = createDir;
+exports.writeFile = writeFile;
+exports.readJsonFile = readJsonFile;
+exports.readFileBuffer = readFileBuffer;
+exports.fileNameWithoutExtension = fileNameWithoutExtension;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
 /**
  * Create a directory
  * @param dir Directory path
  * @param recursive Create parent directories if they don't exist
  */
-export async function createDir(dir, recursive = false) {
-    await fs.mkdir(dir, { recursive });
+async function createDir(dir, recursive = false) {
+    await node_fs_1.promises.mkdir(dir, { recursive });
 }
 /**
  * Write a file
@@ -15,9 +25,9 @@ export async function createDir(dir, recursive = false) {
  * @param data Data to write
  * @returns Path to the file
  */
-export async function writeFile(dir, filename, data) {
-    const filePath = path.join(dir, filename);
-    await fs.writeFile(filePath, data);
+async function writeFile(dir, filename, data) {
+    const filePath = node_path_1.default.join(dir, filename);
+    await node_fs_1.promises.writeFile(filePath, data);
     return filePath;
 }
 /**
@@ -25,23 +35,23 @@ export async function writeFile(dir, filename, data) {
  * @param filePath Path to the JSON file
  * @returns Content of the JSON file
  */
-export async function readJsonFile(filePath) {
-    return JSON.parse(await fs.readFile(filePath, "utf8"));
+async function readJsonFile(filePath) {
+    return JSON.parse(await node_fs_1.promises.readFile(filePath, "utf8"));
 }
 /**
  * Read a file and return its content
  * @param filePath Path to the file
  * @returns Content of the file
  */
-export async function readFileBuffer(filePath) {
-    return await fs.readFile(filePath);
+async function readFileBuffer(filePath) {
+    return await node_fs_1.promises.readFile(filePath);
 }
 /**
  * Get the filename without the extension
  * @param filePath Path to the file
  * @returns Filename without the extension
  */
-export function fileNameWithoutExtension(filePath) {
-    return path.basename(filePath, path.extname(filePath));
+function fileNameWithoutExtension(filePath) {
+    return node_path_1.default.basename(filePath, node_path_1.default.extname(filePath));
 }
 //# sourceMappingURL=file.js.map

package/dist/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,SAAS,GAAG,KAAK;IAC5D,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,QAAgB,EAChB,IAAqB;IAErB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":";;;;;AAQA,8BAEC;AASD,8BAQC;AAOD,oCAEC;AAOD,wCAEC;AAOD,4DAEC;AAtDD,qCAAyC;AACzC,0DAA6B;AAE7B;;;;GAIG;AACI,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,SAAS,GAAG,KAAK;IAC5D,MAAM,kBAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,QAAgB,EAChB,IAAqB;IAErB,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,YAAY,CAAI,QAAgB;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,SAAgB,wBAAwB,CAAC,QAAgB;IACvD,OAAO,mBAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC"}