@pixzle/cli 0.0.1

package/README.md

@@ -0,0 +1,268 @@
+# @pixzle/cli
+
+CLI implementation of image fragmentation and restoration using the `@pixzle/node` library.
+
+## Installation
+
+```bash
+npm install @pixzle/cli
+```
+
+## Usage
+
+The CLI provides two main commands: `shuffle` and `restore`.
+
+### Global Help
+
+```bash
+pixzle --help
+```
+
+```
+Usage: pixzle [options] [command]
+
+CLI tool for image fragmentation and restoration
+
+Options:
+  -V, --version                     output the version number
+  -h, --help                        display help for command
+
+Commands:
+  shuffle [options] <images...>     Fragment images
+  restore [options] <fragments...>  Restore fragmented images
+  help [command]                    display help for command
+```
+
+### Shuffle Command
+
+Fragment images into multiple pieces.
+
+```bash
+pixzle shuffle <images...> -o <output_directory> [options]
+```
+
+#### Options
+
+| Option | Description | Required | Default |
+|--------|-------------|----------|---------|
+| `-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" |
+| `-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) |
+
+#### Examples
+
+**Basic fragmentation:**
+```bash
+pixzle shuffle image1.jpg image2.png -o ./fragments
+```
+
+**Custom configuration:**
+```bash
+pixzle shuffle *.jpg -o ./output -b 20 -p "my_fragment" --preserve-name
+```
+
+**With seed for reproducible results:**
+```bash
+pixzle shuffle image.png -o ./output -s 12345
+```
+
+**Cross-image shuffle (shuffle blocks across all images):**
+```bash
+pixzle shuffle image1.png image2.png image3.png -o ./output --cross-image-shuffle
+```
+
+#### Output Structure
+
+After fragmentation, the output directory will contain:
+```
+output/
+├── manifest.json          # Metadata for restoration
+├── fragment_0000.png      # Fragment files
+├── fragment_0001.png
+└── ...
+```
+
+### Restore Command
+
+Restore fragmented images using the manifest file.
+
+```bash
+pixzle restore <fragments...> -m <manifest_path> -o <output_directory> [options]
+```
+
+#### Options
+
+| Option | Description | Required |
+|--------|-------------|----------|
+| `-m, --manifest <path>` | Path to the manifest.json file | ✅ |
+| `-o, --output <dir>` | Output directory for restored images | ✅ |
+
+#### Examples
+
+**Basic restoration:**
+```bash
+pixzle restore ./fragments/*.png -m ./fragments/manifest.json -o ./restored
+```
+
+**Specific fragments:**
+```bash
+pixzle restore fragment_0000.png fragment_0001.png fragment_0002.png -m manifest.json -o ./output
+```
+
+## Error Handling
+
+The CLI provides clear error messages for common issues:
+
+- **File not found**: When input images or manifest don't exist
+- **Invalid options**: When required options are missing or invalid
+- **Restoration errors**: When fragments are corrupted or manifest doesn't match
+- **Permission errors**: When output directory cannot be created
+
+## Examples Workflow
+
+### Complete Workflow Example
+
+1. **Prepare images:**
+   ```bash
+   ls images/
+   # photo1.jpg  photo2.png  document.pdf
+   ```
+
+2. **Fragment images:**
+   ```bash
+   pixzle shuffle images/photo1.jpg images/photo2.png -o ./backup --preserve-name
+   ```
+   ```
+   🔀 Starting image fragmentation...
+   ✅ Images fragmented successfully to: /path/to/backup
+   ```
+
+3. **Check output:**
+   ```bash
+   ls backup/
+   # manifest.json  fragment_0000.png  fragment_0001.png  fragment_0002.png  fragment_0003.png
+   ```
+
+4. **Restore images:**
+   ```bash
+   pixzle restore backup/*.png -m backup/manifest.json -o ./restored
+   ```
+   ```
+   🔀 Starting image restoration...
+   ✅ Images restored successfully to: /path/to/restored
+   ```
+
+5. **Verify restoration:**
+   ```bash
+   ls restored/
+   # photo1.jpg  photo2.png
+   ```
+
+### Advanced Configuration Example
+
+For custom fragmentation:
+
+```bash
+# Fragment with custom settings
+pixzle shuffle sensitive/*.jpg \
+  -o ./vault \
+  -b 5 \
+  -p "secure_chunk" \
+  -s 42 \
+  --preserve-name
+
+# The output will use smaller blocks (5x5 pixels) and custom naming
+```
+
+## Integration with Scripts
+
+### Bash Script Example
+
+```bash
+#!/bin/bash
+
+# Backup script
+IMAGES_DIR="./photos"
+BACKUP_DIR="./backup"
+
+# Create backup
+echo "Creating backup..."
+pixzle shuffle "$IMAGES_DIR"/*.{jpg,png} \
+  -o "$BACKUP_DIR" \
+  --preserve-name
+
+if [ $? -eq 0 ]; then
+  echo "✅ Backup completed successfully"
+  # Optionally remove original files or move them
+else
+  echo "❌ Backup failed"
+  exit 1
+fi
+```
+
+### Recovery Script Example
+
+```bash
+#!/bin/bash
+
+# Recovery script
+BACKUP_DIR="./backup"
+RESTORE_DIR="./recovered_photos"
+
+# Restore from backup
+echo "Restoring from backup..."
+pixzle restore "$BACKUP_DIR"/fragment_*.png \
+  -m "$BACKUP_DIR/manifest.json" \
+  -o "$RESTORE_DIR"
+
+if [ $? -eq 0 ]; then
+  echo "✅ Recovery completed successfully"
+else
+  echo "❌ Recovery failed"
+  exit 1
+fi
+```
+
+## Development
+
+### Building from Source
+
+```bash
+# Clone the repository
+git clone https://github.com/tuki0918/pixzle.git
+cd pixzle
+
+# Install dependencies
+npm install
+
+# Build the CLI
+npm run build
+
+# Test the CLI
+cd packages/cli
+npm test
+```
+
+### Running in Development Mode
+
+```bash
+cd packages/cli
+npm run dev -- shuffle --help
+```
+
+## Related Packages
+
+- [`@pixzle/core`](../core) - Core fragmentation logic
+- [`@pixzle/node`](../node) - Node.js implementation
+- [`@pixzle/browser`](../browser) - Browser implementation (coming soon)
+
+## License
+
+See the [LICENSE](../../LICENSE) file in the root directory.
+
+## Support
+
+For issues and questions, please visit the [GitHub repository](https://github.com/tuki0918/pixzle/issues).

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { registerRestoreCommand } from "./commands/restore";
+import { registerShuffleCommand } from "./commands/shuffle";
+const program = new Command();
+program
+    .name("pixzle")
+    .description("CLI tool for image fragmentation and restoration")
+    .version("0.8.1");
+// Register commands
+registerShuffleCommand(program);
+registerRestoreCommand(program);
+// Error handling
+program.on("command:*", () => {
+    console.error("Invalid command. See --help for available commands.");
+    process.exit(1);
+});
+// Parse arguments
+program.parse(process.argv);
+// Show help if no command provided
+if (process.argv.length <= 2) {
+    program.help();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,kDAAkD,CAAC;KAC/D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,oBAAoB;AACpB,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAEhC,iBAAiB;AACjB,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;IAC3B,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,kBAAkB;AAClB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,mCAAmC;AACnC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;IAC7B,OAAO,CAAC,IAAI,EAAE,CAAC;AACjB,CAAC"}

package/dist/commands/restore.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from "commander";
+/**
+ * Configures and registers the restore command
+ * @param program Commander program instance
+ */
+export declare function registerRestoreCommand(program: Command): void;

package/dist/commands/restore.js

@@ -0,0 +1,39 @@
+import Pixzle from "@pixzle/node";
+import { validateImagePaths, validateManifestPath, validateOutputDirectory, } from "../validators";
+/**
+ * Configures and registers the restore command
+ * @param program Commander program instance
+ */
+export function registerRestoreCommand(program) {
+    program
+        .command("restore")
+        .description("Restore fragmented images")
+        .argument("<fragments...>", "Fragment file paths")
+        .requiredOption("-m, --manifest <path>", "Manifest file path")
+        .requiredOption("-o, --output <dir>", "Output directory")
+        .action(handleRestoreCommand);
+}
+/**
+ * Handles the restore command execution
+ * @param fragments Array of fragment file paths
+ * @param options Command options
+ */
+async function handleRestoreCommand(fragments, options) {
+    try {
+        console.log("🔀 Starting image restoration...");
+        const imagePaths = validateImagePaths(fragments);
+        const manifestPath = validateManifestPath(options.manifest);
+        const outputDir = validateOutputDirectory(options.output);
+        await Pixzle.restore({
+            imagePaths,
+            manifestPath,
+            outputDir,
+        });
+        console.log(`✅ Images restored successfully to: ${outputDir}`);
+    }
+    catch (error) {
+        console.error(`❌ Restoration failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=restore.js.map

package/dist/commands/restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../src/commands/restore.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,cAAc,CAAC;AAGlC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB;;;GAGG;AACH,MAAM,UAAU,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,kBAAkB,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,oBAAoB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,uBAAuB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE1D,MAAM,MAAM,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"}

package/dist/commands/shuffle.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from "commander";
+/**
+ * Configures and registers the shuffle command
+ * @param program Commander program instance
+ */
+export declare function registerShuffleCommand(program: Command): void;

package/dist/commands/shuffle.js

@@ -0,0 +1,65 @@
+import Pixzle from "@pixzle/node";
+import { validateImagePaths, validateOutputDirectory } from "../validators";
+/**
+ * Configures and registers the shuffle command
+ * @param program Commander program instance
+ */
+export function registerShuffleCommand(program) {
+    program
+        .command("shuffle")
+        .description("Fragment images")
+        .argument("<images...>", "Input image file paths")
+        .requiredOption("-o, --output <dir>", "Output directory")
+        .option("-b, --block-size <size>", "Pixel block size", (value) => {
+        const num = Number.parseInt(value, 10);
+        if (Number.isNaN(num) || num <= 0) {
+            throw new Error("Block size must be a positive integer");
+        }
+        return num;
+    })
+        .option("-p, --prefix <prefix>", "Prefix for fragment files")
+        .option("-s, --seed <seed>", "Random seed", (value) => {
+        const num = Number.parseInt(value, 10);
+        if (Number.isNaN(num)) {
+            throw new Error("Seed must be an integer");
+        }
+        return num;
+    })
+        .option("--preserve-name", "Preserve original file names")
+        .option("--cross-image-shuffle", "Shuffle blocks across all images instead of within each image independently")
+        .action(handleShuffleCommand);
+}
+/**
+ * Handles the shuffle command execution
+ * @param images Array of image file paths
+ * @param options Command options
+ */
+async function handleShuffleCommand(images, options) {
+    try {
+        console.log("🔀 Starting image fragmentation...");
+        const imagePaths = validateImagePaths(images);
+        const outputDir = validateOutputDirectory(options.output);
+        const config = {};
+        if (options.blockSize !== undefined)
+            config.blockSize = options.blockSize;
+        if (options.prefix !== undefined)
+            config.prefix = options.prefix;
+        if (options.seed !== undefined)
+            config.seed = options.seed;
+        if (options.preserveName)
+            config.preserveName = true;
+        if (options.crossImageShuffle)
+            config.crossImageShuffle = true;
+        await Pixzle.shuffle({
+            imagePaths,
+            outputDir,
+            config: Object.keys(config).length > 0 ? config : undefined,
+        });
+        console.log(`✅ Images fragmented successfully to: ${outputDir}`);
+    }
+    catch (error) {
+        console.error(`❌ Fragmentation failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=shuffle.js.map

package/dist/commands/shuffle.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { default as Pixzle } from "@pixzle/node";
+export type { FragmentationConfig } from "@pixzle/core";
+export type { RestoreOptions, ShuffleOptions } from "./types";

package/dist/index.js

@@ -0,0 +1,3 @@
+// Export CLI functionality for programmatic usage if needed
+export { default as Pixzle } from "@pixzle/node";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,cAAc,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+export interface ShuffleOptions {
+    output: string;
+    blockSize?: number;
+    prefix?: string;
+    seed?: number;
+    preserveName?: boolean;
+    crossImageShuffle?: boolean;
+}
+export interface RestoreOptions {
+    manifest: string;
+    output: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validators.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Validates an array of image file paths
+ * @param paths Array of file paths to validate
+ * @returns Array of resolved absolute paths
+ */
+export declare function validateImagePaths(paths: string[]): string[];
+/**
+ * Validates output directory path
+ * @param outputPath Output directory path
+ * @returns Resolved absolute path
+ */
+export declare function validateOutputDirectory(outputPath: string): string;
+/**
+ * Validates manifest file path
+ * @param manifestPath Path to manifest file
+ * @returns Resolved absolute path
+ */
+export declare function validateManifestPath(manifestPath: string): string;

package/dist/validators.js

@@ -0,0 +1,56 @@
+import { existsSync, lstatSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+/**
+ * Validates an array of image file paths
+ * @param paths Array of file paths to validate
+ * @returns Array of resolved absolute paths
+ */
+export function validateImagePaths(paths) {
+    const resolvedPaths = [];
+    for (const path of paths) {
+        const resolvedPath = resolve(path);
+        if (!existsSync(resolvedPath)) {
+            console.error(`Error: File not found: ${path}`);
+            process.exit(1);
+        }
+        if (!lstatSync(resolvedPath).isFile()) {
+            console.error(`Error: Not a file: ${path}`);
+            process.exit(1);
+        }
+        resolvedPaths.push(resolvedPath);
+    }
+    return resolvedPaths;
+}
+/**
+ * Validates output directory path
+ * @param outputPath Output directory path
+ * @returns Resolved absolute path
+ */
+export function validateOutputDirectory(outputPath) {
+    const resolvedPath = resolve(outputPath);
+    // Create parent directory if it doesn't exist
+    const parentDir = dirname(resolvedPath);
+    if (!existsSync(parentDir)) {
+        console.error(`Error: Parent directory does not exist: ${parentDir}`);
+        process.exit(1);
+    }
+    return resolvedPath;
+}
+/**
+ * Validates manifest file path
+ * @param manifestPath Path to manifest file
+ * @returns Resolved absolute path
+ */
+export function validateManifestPath(manifestPath) {
+    const resolvedPath = resolve(manifestPath);
+    if (!existsSync(resolvedPath)) {
+        console.error(`Error: Manifest file not found: ${manifestPath}`);
+        process.exit(1);
+    }
+    if (!lstatSync(resolvedPath).isFile()) {
+        console.error(`Error: Manifest path is not a file: ${manifestPath}`);
+        process.exit(1);
+    }
+    return resolvedPath;
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAe;IAChD,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAEnC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACxD,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzC,8CAA8C;IAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,2CAA2C,SAAS,EAAE,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACvD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE3C,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,mCAAmC,YAAY,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QACtC,OAAO,CAAC,KAAK,CAAC,uCAAuC,YAAY,EAAE,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@pixzle/cli",
+  "version": "0.0.1",
+  "description": "CLI implementation of image fragmentation and restoration (RESERVED)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "pixzle": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:check": "tsc -p tsconfig.build.json --noEmit",
+    "test": "vitest",
+    "dev": "tsx src/cli.ts"
+  },
+  "keywords": [],
+  "author": "tuki0918",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tuki0918/pixzle.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pixzle/core": "file:../core",
+    "@pixzle/node": "file:../node",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "tsx": "^4.20.5",
+    "typescript": "^5.7.2",
+    "vitest": "^3.1.4"
+  }
+}