@pixzle/cli 0.0.20 → 0.0.21

package/README.md

@@ -47,7 +47,7 @@ pixzle shuffle <images...> -o <output_directory> [options]
 |--------|-------------|----------|---------|
 | `-o, --output <dir>` | Output directory for fragments and manifest | ✅ | - |
 | `-b, --block-size <size>` | Pixel block size (positive integer) | ❌ | 10 |
-| `-p, --prefix <prefix>` | Prefix for fragment files | ❌ | "fragment" |
+| `-p, --prefix <prefix>` | Prefix for fragment files | ❌ | "img" |
 | `-s, --seed <seed>` | Random seed (integer) | ❌ | auto-generated |
 | `--preserve-name` | Preserve original file names | ❌ | false |
 | `--cross-image-shuffle` | Shuffle blocks across all images instead of within each image independently | ❌ | false (per-image shuffle by default) |
@@ -87,7 +87,7 @@ output/
 
 ### Restore Command
 
-Restore fragmented images using the manifest file.
+Restore fragmented images using the manifest file or manual configuration.
 
 ```bash
 pixzle restore <fragments...> -m <manifest_path> -o <output_directory> [options]
@@ -97,16 +97,28 @@ pixzle restore <fragments...> -m <manifest_path> -o <output_directory> [options]
 
 | Option | Description | Required |
 |--------|-------------|----------|
-| `-m, --manifest <path>` | Path to the manifest.json file | ✅ |
+| `-m, --manifest <path>` | Path to the manifest.json file | ⚠️ |
 | `-o, --output <dir>` | Output directory for restored images | ✅ |
+| `-b, --block-size <number>` | Pixel block size (positive integer) | ❌ (required if manifest missing) |
+| `-s, --seed <number>` | Random seed (integer) | ❌ (required if manifest missing) |
+| `-w, --width <number>` | Image width | ❌ (required if manifest missing) |
+| `-h, --height <number>` | Image height | ❌ (required if manifest missing) |
+
+> [!NOTE]
+> When using manual options (`-b`, `-s`, `-w`, `-h`), only a single image can be restored.
 
 #### Examples
 
-**Basic restoration:**
+**Basic restoration (using manifest):**
 ```bash
 pixzle restore ./fragments/*.png -m ./fragments/manifest.json -o ./restored
 ```
 
+**Manual restoration (without manifest):**
+```bash
+pixzle restore ./fragment.png -o ./restored -b 10 -s 12345 -w 500 -h 500
+```
+
 **Specific fragments:**
 ```bash
 pixzle restore fragment_0000.png fragment_0001.png fragment_0002.png -m manifest.json -o ./output

package/dist/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@pixzle/cli",
-    "version": "0.0.1",
-    "description": "CLI implementation of image fragmentation and restoration (RESERVED)",
+    "version": "0.0.20",
+    "description": "CLI implementation of image fragmentation and restoration",
     "type": "commonjs",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -14,7 +14,8 @@
     "scripts": {
         "build": "tsc -p tsconfig.build.json",
         "build:check": "tsc -p tsconfig.build.json --noEmit",
-        "test": "vitest",
+        "test": "vitest run",
+        "test:watch": "vitest",
         "dev": "tsx src/cli.ts"
     },
     "keywords": [],

package/dist/src/commands/restore.js

@@ -15,8 +15,12 @@ function registerRestoreCommand(program) {
         .command("restore")
         .description("Restore fragmented images")
         .argument("<fragments...>", "Fragment file paths")
-        .requiredOption("-m, --manifest <path>", "Manifest file path")
+        .option("-m, --manifest <path>", "Manifest file path")
         .requiredOption("-o, --output <dir>", "Output directory")
+        .option("-b, --block-size <number>", "Block size", Number.parseInt)
+        .option("-s, --seed <number>", "Random seed", Number.parseInt)
+        .option("-w, --width <number>", "Image width", Number.parseInt)
+        .option("-h, --height <number>", "Image height", Number.parseInt)
         .action(handleRestoreCommand);
 }
 /**
@@ -28,13 +32,41 @@ async function handleRestoreCommand(fragments, options) {
     try {
         console.log("🔀 Starting image restoration...");
         const imagePaths = (0, validators_1.validateImagePaths)(fragments);
-        const manifestPath = (0, validators_1.validateManifestPath)(options.manifest);
         const outputDir = (0, validators_1.validateOutputDirectory)(options.output);
-        await node_1.default.restore({
+        const restoreOptions = {
             imagePaths,
-            manifestPath,
             outputDir,
-        });
+        };
+        if (options.manifest) {
+            restoreOptions.manifestPath = (0, validators_1.validateManifestPath)(options.manifest);
+        }
+        else if (options.blockSize !== undefined &&
+            options.seed !== undefined &&
+            options.width !== undefined &&
+            options.height !== undefined) {
+            if (imagePaths.length > 1) {
+                throw new Error("When using manual options (blockSize, seed, width, height), only a single image can be restored.");
+            }
+            const { width, height } = options;
+            const manifestData = {
+                id: "cli-restore",
+                version: "0.0.0",
+                timestamp: new Date().toISOString(),
+                config: {
+                    blockSize: options.blockSize,
+                    seed: options.seed,
+                    prefix: "img",
+                    preserveName: false,
+                    crossImageShuffle: false,
+                },
+                images: [{ w: width, h: height }],
+            };
+            restoreOptions.manifestData = manifestData;
+        }
+        else {
+            throw new Error("Either manifest path or (blockSize, seed, width, height) must be provided.");
+        }
+        await node_1.default.restore(restoreOptions);
         console.log(`✅ Images restored successfully to: ${outputDir}`);
     }
     catch (error) {

package/dist/src/commands/restore.js.map

@@ -1 +1 @@
-{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../../src/commands/restore.ts"],"names":[],"mappings":";;;;;AAaA,wDAQC;AArBD,wDAAkC;AAGlC,8CAIuB;AAEvB;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,2BAA2B,CAAC;SACxC,QAAQ,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;SACjD,cAAc,CAAC,uBAAuB,EAAE,oBAAoB,CAAC;SAC7D,cAAc,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;SACxD,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,oBAAoB,CACjC,SAAmB,EACnB,OAAuB;IAEvB,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAEhD,MAAM,UAAU,GAAG,IAAA,+BAAkB,EAAC,SAAS,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,IAAA,iCAAoB,EAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,IAAA,oCAAuB,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE1D,MAAM,cAAM,CAAC,OAAO,CAAC;YACnB,UAAU;YACV,YAAY;YACZ,SAAS;SACV,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,sCAAsC,SAAS,EAAE,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAClF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../../src/commands/restore.ts"],"names":[],"mappings":"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"}

package/dist/src/types.d.ts

@@ -7,6 +7,10 @@ export interface ShuffleOptions {
     crossImageShuffle?: boolean;
 }
 export interface RestoreOptions {
-    manifest: string;
+    manifest?: string;
     output: string;
+    blockSize?: number;
+    seed?: number;
+    width?: number;
+    height?: number;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pixzle/cli",
-  "version": "0.0.20",
-  "description": "CLI implementation of image fragmentation and restoration (RESERVED)",
+  "version": "0.0.21",
+  "description": "CLI implementation of image fragmentation and restoration",
   "type": "commonjs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,8 +24,8 @@
   },
   "dependencies": {
     "commander": "^12.1.0",
-    "@pixzle/core": "0.0.20",
-    "@pixzle/node": "0.0.20"
+    "@pixzle/node": "0.0.21",
+    "@pixzle/core": "0.0.21"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",
@@ -36,7 +36,8 @@
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "build:check": "tsc -p tsconfig.build.json --noEmit",
-    "test": "vitest",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "dev": "tsx src/cli.ts"
   }
 }