@mediaproc/core 1.0.0

package/README.md

@@ -0,0 +1,414 @@
+# @mediaproc/core
+
+> Core utilities for MediaProc CLI and Plugins
+
+[![Version](https://img.shields.io/npm/v/@mediaproc/core.svg)](https://www.npmjs.com/package/@mediaproc/core)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)
+
+This package contains shared utilities used across MediaProc CLI and all plugins, ensuring consistency and reducing code duplication.
+
+## 📦 Installation (Don't need install directly, this package will install automatically with cli and plugins)
+
+```bash
+# For plugin developers
+npm install @mediaproc/core
+
+# or
+pnpm add @mediaproc/core
+
+# or
+yarn add @mediaproc/core
+```
+
+## 🎯 What's Included
+
+### 1. Branding Utilities
+
+Consistent CLI/plugin footers with version information and links.
+
+```typescript
+import { showBranding, showPluginBranding } from "@mediaproc/core";
+
+// Show CLI branding
+showBranding();
+// Output:
+// ────────────────────────────────────────────────────────────
+//   💙 Powered by MediaProc CLI v0.6.0
+//   📚 Documentation: https://docs-mediaproc.vercel.app/
+//   ⭐ Star us: https://github.com/0xshariq/mediaproc-cli
+// ────────────────────────────────────────────────────────────
+
+// Show plugin branding (automatically detects version)
+showPluginBranding("Image");
+// Output:
+// ────────────────────────────────────────────────────────────
+//   💎 Image Plugin v1.3.3 · Powered by MediaProc
+//   📚 Documentation: https://docs-mediaproc.vercel.app/
+//   ⭐ Star us: https://github.com/0xshariq/mediaproc-cli
+// ────────────────────────────────────────────────────────────
+```
+
+### 2. Help Formatter
+
+Standardized, beautiful help displays for commands.
+
+```typescript
+import { displayCommandHelp } from "@mediaproc/core";
+
+displayCommandHelp({
+  commandName: "resize",
+  description:
+    "Resize images to specified dimensions while maintaining aspect ratio",
+  usage: [
+    "resize <input> [options]",
+    "resize <input> -w 1920 -h 1080",
+    "resize folder/*.jpg -w 800",
+  ],
+  options: [
+    { flag: "-w, --width <number>", description: "Target width in pixels" },
+    { flag: "-h, --height <number>", description: "Target height in pixels" },
+    {
+      flag: "-f, --fit <mode>",
+      description: "Fit mode: cover, contain, fill, inside, outside",
+    },
+  ],
+  examples: [
+    {
+      command: "resize photo.jpg -w 1920",
+      description: "Resize to 1920px wide, auto height",
+    },
+    {
+      command: "resize img.png -w 800 -h 600 --fit cover",
+      description: "Resize and crop to exact size",
+    },
+  ],
+  notes: [
+    "Maintains aspect ratio by default",
+    "Supports all major image formats (JPEG, PNG, WebP, AVIF, TIFF)",
+    "Use --fit option to control resize behavior",
+  ],
+  tips: [
+    "Use -w only to maintain aspect ratio",
+    "Combine with --quality for web optimization",
+  ],
+});
+```
+
+### 3. Path Validator
+
+Robust file and directory path validation and resolution.
+
+```typescript
+import {
+  validateAndResolvePath,
+  validateInputPath,
+  validateOutputPath,
+  ensureOutputDirectory,
+  isDirectory,
+  isSupportedImageFormat,
+} from "@mediaproc/core";
+
+// Validate and resolve input path
+const inputPath = validateAndResolvePath("./images/photo.jpg", "input");
+// Returns: '/absolute/path/to/images/photo.jpg'
+// Throws error if file doesn't exist
+
+// Validate output path (creates directories if needed)
+const outputPath = validateOutputPath("./output/resized.jpg");
+
+// Check if path is a directory
+if (isDirectory("./images")) {
+  console.log("It's a directory!");
+}
+
+// Validate image format
+if (isSupportedImageFormat("photo.jpg")) {
+  console.log("Supported format!");
+}
+```
+
+### 4. Explain Formatter
+
+Detailed operation explanations when `--explain` flag is used.
+
+```typescript
+import { explainOperation } from "@mediaproc/core";
+
+// Show detailed explanation of what will happen
+if (options.explain) {
+  explainOperation({
+    operation: "resize",
+    parameters: {
+      width: 1920,
+      height: 1080,
+      fit: "cover",
+    },
+    inputFiles: ["photo1.jpg", "photo2.jpg"],
+    outputPath: "./output",
+    details: [
+      "Images will be resized to exactly 1920x1080 pixels",
+      "Aspect ratio will be maintained by cropping (fit: cover)",
+      "Original files will not be modified",
+      "Output files will be saved to ./output directory",
+    ],
+  });
+  return; // Exit before actual processing
+}
+```
+
+### 5. Supported Extensions
+
+Registry of supported file extensions for various media types.
+
+```typescript
+import {
+  SUPPORTED_IMAGE_FORMATS,
+  SUPPORTED_VIDEO_FORMATS,
+  SUPPORTED_AUDIO_FORMATS,
+  isSupportedImageFormat,
+  isSupportedVideoFormat,
+} from "@mediaproc/core";
+
+console.log(SUPPORTED_IMAGE_FORMATS);
+// ['jpg', 'jpeg', 'png', 'webp', 'avif', 'tiff', 'gif', 'svg']
+
+console.log(SUPPORTED_VIDEO_FORMATS);
+// ['mp4', 'webm', 'avi', 'mkv', 'mov']
+
+console.log(SUPPORTED_AUDIO_FORMATS);
+// ['mp3', 'aac', 'wav', 'flac', 'ogg', 'opus']
+```
+
+## 📚 API Reference
+
+### Branding
+
+#### `showBranding(): void`
+
+Displays CLI branding footer with version, documentation, and GitHub links.
+
+#### `showPluginBranding(pluginName: string, pluginPath?: string): void`
+
+Displays plugin-specific branding with plugin version and MediaProc attribution.
+
+- `pluginName` - Display name of the plugin (e.g., 'Image', 'Video', 'Audio')
+- `pluginPath` - Optional custom path to plugin's package.json (auto-detected if omitted)
+
+### Help Formatter
+
+#### `displayCommandHelp(config: CommandHelpConfig): void`
+
+Displays formatted help information for a command.
+
+**CommandHelpConfig:**
+
+```typescript
+interface CommandHelpConfig {
+  commandName: string; // Command name
+  description: string; // Short description
+  usage: string | string[]; // Usage examples
+  options: HelpOption[]; // Command options
+  examples: HelpExample[]; // Usage examples
+  sections?: HelpSection[]; // Additional custom sections
+  notes?: string[]; // Important notes
+  tips?: string[]; // Pro tips
+  warnings?: string[]; // Warnings
+  seeAlso?: string[]; // Related commands
+}
+```
+
+### Path Validator
+
+#### `validateAndResolvePath(path: string, type: 'input' | 'output'): string`
+
+Validates and resolves a file path to absolute path.
+
+- Throws error if input file doesn't exist
+- Creates parent directories for output paths
+- Returns absolute path
+
+#### `validateInputPath(path: string): string`
+
+Validates that input path exists and is accessible.
+
+#### `validateOutputPath(path: string): string`
+
+Validates output path and creates parent directories if needed.
+
+#### `ensureOutputDirectory(dirPath: string): void`
+
+Creates directory and all parent directories if they don't exist.
+
+#### `isDirectory(path: string): boolean`
+
+Checks if path is a directory.
+
+#### `isSupportedImageFormat(filePath: string): boolean`
+
+Checks if file has supported image extension.
+
+### Explain Formatter
+
+#### `explainOperation(config: ExplainConfig): void`
+
+Displays detailed explanation of what an operation will do.
+
+**ExplainConfig:**
+
+```typescript
+interface ExplainConfig {
+  operation: string; // Operation name
+  parameters: Record<string, any>; // Operation parameters
+  inputFiles: string[]; // Input files
+  outputPath?: string; // Output path
+  details: string[]; // Detailed explanation steps
+}
+```
+
+### Supported Extensions
+
+#### Constants
+
+- `SUPPORTED_IMAGE_FORMATS: string[]` - Array of supported image extensions
+- `SUPPORTED_VIDEO_FORMATS: string[]` - Array of supported video extensions
+- `SUPPORTED_AUDIO_FORMATS: string[]` - Array of supported audio extensions
+
+#### Functions
+
+- `isSupportedImageFormat(filePath: string): boolean`
+- `isSupportedVideoFormat(filePath: string): boolean`
+- `isSupportedAudioFormat(filePath: string): boolean`
+
+## 🔧 Usage in Plugins
+
+### Example: Image Plugin Command
+
+```typescript
+import { Command } from "commander";
+import {
+  showPluginBranding,
+  displayCommandHelp,
+  validateAndResolvePath,
+  explainOperation,
+} from "@mediaproc/core";
+
+export function resizeCommand(imageCmd: Command): void {
+  imageCmd
+    .command("resize")
+    .description("Resize images to specified dimensions")
+    .argument("<input>", "Input image file")
+    .option("-w, --width <number>", "Target width")
+    .option("-h, --height <number>", "Target height")
+    .option("--explain", "Show what will happen without processing")
+    .action(async (input: string, options) => {
+      // Show help if requested
+      if (options.help) {
+        displayCommandHelp({
+          commandName: "resize",
+          description: "Resize images to specified dimensions",
+          usage: ["resize <input> -w <width> -h <height>"],
+          options: [
+            { flag: "-w, --width <number>", description: "Target width" },
+            { flag: "-h, --height <number>", description: "Target height" },
+          ],
+          examples: [
+            {
+              command: "resize photo.jpg -w 1920",
+              description: "Resize to 1920px wide",
+            },
+          ],
+        });
+        return;
+      }
+
+      // Validate input path
+      const inputPath = validateAndResolvePath(input, "input");
+
+      // Show explanation if requested
+      if (options.explain) {
+        explainOperation({
+          operation: "resize",
+          parameters: { width: options.width, height: options.height },
+          inputFiles: [inputPath],
+          details: [
+            `Image will be resized to ${options.width}x${options.height}`,
+            "Aspect ratio will be maintained",
+            "Output will be saved with same format",
+          ],
+        });
+        return;
+      }
+
+      // Actual processing logic here
+      console.log("✓ Image resized successfully");
+
+      // Show branding footer
+      showPluginBranding("Image");
+    });
+}
+```
+
+## 🏗️ Architecture
+
+The core package is designed to be:
+
+- **Lightweight** - Only essential utilities, no heavy dependencies
+- **Type-safe** - Full TypeScript support with exported types
+- **Tree-shakeable** - ES modules with granular exports
+- **Zero-config** - Works out of the box with sensible defaults
+- **Extensible** - Easy to add new utilities as needed
+
+## 📦 Package Structure
+
+```
+@mediaproc/core/
+├── dist/                   # Compiled JavaScript + TypeScript definitions
+│   ├── index.js           # Main entry point
+│   ├── index.d.ts         # Type definitions
+│   ├── branding.js
+│   ├── branding.d.ts
+│   ├── helpFormatter.js
+│   ├── helpFormatter.d.ts
+│   ├── pathValidator.js
+│   ├── pathValidator.d.ts
+│   ├── explainFormatter.js
+│   ├── explainFormatter.d.ts
+│   ├── supportedExtensions.js
+│   └── supportedExtensions.d.ts
+├── src/                   # TypeScript source files
+│   ├── index.ts
+│   ├── branding.ts
+│   ├── helpFormatter.ts
+│   ├── pathValidator.ts
+│   ├── explainFormatter.ts
+│   └── supportedExtensions.ts
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## 🔗 Related Packages
+
+- [@mediaproc/cli](https://www.npmjs.com/package/@mediaproc/cli) - Main CLI tool
+- [@mediaproc/image](https://www.npmjs.com/package/@mediaproc/image) - Image processing plugin
+- [@mediaproc/video](https://www.npmjs.com/package/@mediaproc/video) - Video processing plugin
+- [@mediaproc/audio](https://www.npmjs.com/package/@mediaproc/audio) - Audio processing plugin
+
+## 📝 License
+
+MIT © [0xshariq](https://github.com/0xshariq)
+
+## 🔗 Links
+
+- **Documentation:** [https://docs-mediaproc.vercel.app](https://docs-mediaproc.vercel.app)
+- **GitHub:** [https://github.com/0xshariq/mediaproc-cli](https://github.com/0xshariq/mediaproc-cli)
+- **Issues:** [https://github.com/0xshariq/mediaproc-cli/issues](https://github.com/0xshariq/mediaproc-cli/issues)
+
+---
+
+<div align="center">
+
+**Built with ❤️ for the MediaProc ecosystem**
+
+</div>

package/dist/branding.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Show CLI branding footer with documentation and GitHub links
+ */
+export declare function showBranding(): void;
+/**
+ * Show plugin branding footer with version
+ * @param pluginName - Name of the plugin (e.g., 'image', 'video', 'audio')
+ * @param pluginPath - Path to plugin's package.json
+ */
+export declare function showPluginBranding(pluginName: string, pluginPath: string): void;
+//# sourceMappingURL=branding.d.ts.map

package/dist/branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../src/branding.ts"],"names":[],"mappings":"AAmCA;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAOnC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAO/E"}

package/dist/branding.js

@@ -0,0 +1,59 @@
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * Get version from package.json
+ */
+function getVersion(packagePath) {
+    try {
+        const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));
+        return packageJson.version || '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/**
+ * Get CLI version from root package.json
+ */
+function getCliVersion() {
+    try {
+        // For ES modules, use import.meta.url
+        if (typeof import.meta.url !== 'undefined') {
+            const currentDir = dirname(fileURLToPath(import.meta.url));
+            const packagePath = join(currentDir, '../../package.json');
+            return getVersion(packagePath);
+        }
+        // Fallback: try from process.cwd()
+        const packagePath = join(process.cwd(), 'package.json');
+        return getVersion(packagePath);
+    }
+    catch {
+        return '0.6.0'; // Fallback version
+    }
+}
+/**
+ * Show CLI branding footer with documentation and GitHub links
+ */
+export function showBranding() {
+    const version = getCliVersion();
+    console.log('\n' + '─'.repeat(60));
+    console.log(`  💙 Powered by MediaProc CLI v${version}`);
+    console.log('  📚 Documentation: \x1b[36mhttps://docs-mediaproc.vercel.app/\x1b[0m');
+    console.log('  ⭐ Star us: \x1b[36mhttps://github.com/0xshariq/mediaproc-cli\x1b[0m');
+    console.log('─'.repeat(60) + '\n');
+}
+/**
+ * Show plugin branding footer with version
+ * @param pluginName - Name of the plugin (e.g., 'image', 'video', 'audio')
+ * @param pluginPath - Path to plugin's package.json
+ */
+export function showPluginBranding(pluginName, pluginPath) {
+    const version = getVersion(pluginPath);
+    console.log('\n' + '─'.repeat(60));
+    console.log(`  💙 ${pluginName.charAt(0).toUpperCase() + pluginName.slice(1)} Plugin v${version} · Powered by MediaProc`);
+    console.log('  📚 Documentation: \x1b[36mhttps://docs-mediaproc.vercel.app/\x1b[0m');
+    console.log('  ⭐ Star us: \x1b[36mhttps://github.com/0xshariq/mediaproc-cli\x1b[0m');
+    console.log('─'.repeat(60) + '\n');
+}
+//# sourceMappingURL=branding.js.map

package/dist/branding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.js","sourceRoot":"","sources":["../src/branding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,SAAS,UAAU,CAAC,WAAmB;IACrC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,OAAO,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,aAAa;IACpB,IAAI,CAAC;QACH,sCAAsC;QACtC,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;YAC3D,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QACD,mCAAmC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACxD,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,CAAC,mBAAmB;IACrC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,UAAkB;IACvE,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,QAAQ,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,OAAO,yBAAyB,CAAC,CAAC;IAC1H,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/explainFormatter.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=explainFormatter.d.ts.map

package/dist/explainFormatter.d.ts.map

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

package/dist/explainFormatter.js

@@ -0,0 +1,4 @@
+import chalk from "chalk";
+console.log(chalk.gray('Explain Flag Formatter Coming Soon...'));
+console.log(chalk.gray('This utility will format and display explanations for image command operations in a detailed manner.'));
+//# sourceMappingURL=explainFormatter.js.map

package/dist/explainFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainFormatter.js","sourceRoot":"","sources":["../src/explainFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC,CAAC;AACjE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sGAAsG,CAAC,CAAC,CAAC"}

package/dist/helpFormatter.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Standardized Help Formatter for MediaProc Image CLI
+ * Creates consistent, beautiful help displays for all image commands
+ */
+/**
+ * Interface for command help options
+ */
+export interface HelpOption {
+    flag: string;
+    description: string;
+}
+/**
+ * Interface for command help examples
+ */
+export interface HelpExample {
+    command: string;
+    description: string;
+}
+/**
+ * Interface for help section
+ */
+export interface HelpSection {
+    title: string;
+    items: string[];
+}
+/**
+ * Interface for command help configuration
+ */
+export interface CommandHelpConfig {
+    commandName: string;
+    emoji: string;
+    description: string;
+    usage: string[];
+    options: HelpOption[];
+    examples: HelpExample[];
+    additionalSections?: HelpSection[];
+    tips?: string[];
+}
+/**
+ * Create standardized help display for commands
+ */
+export declare function createStandardHelp(config: CommandHelpConfig): void;
+/**
+ * Quick help display for commands with minimal options
+ */
+export declare function createQuickHelp(commandName: string, emoji: string, description: string, usage: string, options: string[]): void;
+/**
+ * Create error help display
+ */
+export declare function createErrorHelp(commandName: string, error: string, suggestion?: string): void;
+/**
+ * Create success message display
+ */
+export declare function createSuccessMessage(message: string, details?: string[]): void;
+/**
+ * Create info message display
+ */
+export declare function createInfoMessage(title: string, items: string[]): void;
+/**
+ * Create warning message display
+ */
+export declare function createWarningMessage(message: string, details?: string[]): void;
+//# sourceMappingURL=helpFormatter.d.ts.map

package/dist/helpFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpFormatter.d.ts","sourceRoot":"","sources":["../src/helpFormatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,kBAAkB,CAAC,EAAE,WAAW,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAsCD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAiFlE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,GAChB,IAAI,CAgBN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAa7F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAW9E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAMtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAW9E"}

package/dist/helpFormatter.js

@@ -0,0 +1,171 @@
+/**
+ * Standardized Help Formatter for MediaProc Image CLI
+ * Creates consistent, beautiful help displays for all image commands
+ */
+import chalk from 'chalk';
+/**
+ * Create a gradient-like effect using chalk
+ */
+function createGradientText(text, startColor) {
+    // Simple gradient simulation using chalk colors
+    return chalk.hex(startColor)(text);
+}
+/**
+ * Create a box around content
+ */
+function createBox(content, borderColor = 'cyan') {
+    const lines = content.split('\n');
+    const maxLength = Math.max(...lines.map(line => stripAnsi(line).length));
+    const width = Math.min(maxLength + 4, 100);
+    const colorFn = chalk[borderColor];
+    const topBorder = colorFn('╭' + '─'.repeat(width - 2) + '╮');
+    const bottomBorder = colorFn('╰' + '─'.repeat(width - 2) + '╯');
+    const boxedLines = lines.map(line => {
+        const stripped = stripAnsi(line);
+        const padding = ' '.repeat(Math.max(0, width - stripped.length - 4));
+        return colorFn('│ ') + line + padding + colorFn(' │');
+    });
+    return '\n' + topBorder + '\n' + boxedLines.join('\n') + '\n' + bottomBorder + '\n';
+}
+/**
+ * Strip ANSI codes from string for length calculation
+ */
+function stripAnsi(str) {
+    return str.replace(/\x1b\[[0-9;]*m/g, '');
+}
+/**
+ * Create standardized help display for commands
+ */
+export function createStandardHelp(config) {
+    let helpContent = '';
+    // Header
+    helpContent += createGradientText(`${config.emoji} MediaProc Image - ${config.commandName} Command`, '#4facfe') + '\n\n';
+    // Description
+    helpContent += chalk.white(config.description) + '\n\n';
+    // Usage
+    helpContent += chalk.cyan.bold('Usage:') + '\n';
+    config.usage.forEach(usage => {
+        helpContent += chalk.white(`  ${chalk.magenta('mediaproc')} ${chalk.cyan('image')} ${usage}`) + '\n';
+    });
+    helpContent += '\n';
+    // Options
+    helpContent += chalk.cyan.bold('Options:') + '\n';
+    // Check if help flag already exists
+    const hasHelpFlag = config.options && config.options.some(option => option.flag.includes('-h') || option.flag.includes('--help'));
+    // Add custom options first
+    if (config.options && config.options.length > 0) {
+        config.options.forEach(option => {
+            const flagPart = chalk.yellow(option.flag.padEnd(30));
+            const descPart = chalk.gray(option.description);
+            helpContent += `  ${flagPart} ${descPart}\n`;
+        });
+    }
+    // Add the global help flag only if it doesn't already exist
+    if (!hasHelpFlag) {
+        helpContent += `  ${chalk.yellow('-h, --help'.padEnd(30))} ${chalk.gray('Show this help message')}\n`;
+    }
+    helpContent += '\n';
+    // Examples
+    if (config.examples && config.examples.length > 0) {
+        helpContent += chalk.cyan.bold('Examples:') + '\n';
+        config.examples.forEach(example => {
+            // Check if command already starts with 'mediaproc image', if not add it
+            const command = example.command.startsWith('mediaproc image ')
+                ? example.command
+                : `mediaproc image ${example.command}`;
+            const formattedCommand = command
+                .replace(/^mediaproc /, `${chalk.magenta('mediaproc')} `)
+                .replace(/image /, `${chalk.cyan('image')} `);
+            helpContent += chalk.white(`  ${formattedCommand}`) + '\n';
+            helpContent += chalk.dim(`    → ${example.description}`) + '\n\n';
+        });
+    }
+    // Additional sections
+    if (config.additionalSections && config.additionalSections.length > 0) {
+        config.additionalSections.forEach(section => {
+            helpContent += chalk.hex('#00d2d3').bold(`💡 ${section.title}:`) + '\n';
+            section.items.forEach(item => {
+                helpContent += chalk.hex('#95afc0')(`  • ${item}`) + '\n';
+            });
+            helpContent += '\n';
+        });
+    }
+    // Tips
+    if (config.tips && config.tips.length > 0) {
+        config.tips.forEach(tip => {
+            helpContent += chalk.yellow(`💡 Tip: ${tip}`) + '\n';
+        });
+        helpContent += '\n';
+    }
+    // Footer
+    helpContent += chalk.dim(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`) + '\n';
+    helpContent += chalk.hex('#636e72')(`🖼️  MediaProc Image Plugin • Powered by Sharp • High Performance`);
+    console.log(createBox(helpContent, 'cyan'));
+}
+/**
+ * Quick help display for commands with minimal options
+ */
+export function createQuickHelp(commandName, emoji, description, usage, options) {
+    let helpContent = '';
+    helpContent += createGradientText(`${emoji} ${commandName.toUpperCase()} COMMAND`, '#4facfe') + '\n\n';
+    helpContent += chalk.white(description) + '\n\n';
+    helpContent += chalk.cyan.bold('Usage:') + '\n';
+    helpContent += chalk.white(`  ${chalk.magenta('mediaproc')} ${chalk.cyan('image')} ${usage}`) + '\n\n';
+    if (options.length > 0) {
+        helpContent += chalk.cyan.bold('Options:') + '\n';
+        options.forEach(option => {
+            helpContent += chalk.gray(`  ${option}`) + '\n';
+        });
+    }
+    console.log(createBox(helpContent, 'cyan'));
+}
+/**
+ * Create error help display
+ */
+export function createErrorHelp(commandName, error, suggestion) {
+    let helpContent = '';
+    helpContent += chalk.red.bold(`❌ ${commandName.toUpperCase()} ERROR`) + '\n\n';
+    helpContent += chalk.white(error) + '\n';
+    if (suggestion) {
+        helpContent += '\n' + chalk.yellow(`💡 Suggestion: ${suggestion}`) + '\n';
+    }
+    helpContent += '\n' + chalk.gray(`Run: `) + chalk.cyan(`mediaproc image ${commandName} --help`) + chalk.gray(` for more information`);
+    console.log(createBox(helpContent, 'red'));
+}
+/**
+ * Create success message display
+ */
+export function createSuccessMessage(message, details) {
+    let content = chalk.green.bold('✓ ' + message) + '\n';
+    if (details && details.length > 0) {
+        content += '\n';
+        details.forEach(detail => {
+            content += chalk.dim(`  ${detail}`) + '\n';
+        });
+    }
+    console.log(content);
+}
+/**
+ * Create info message display
+ */
+export function createInfoMessage(title, items) {
+    let content = chalk.blue.bold('ℹ ' + title) + '\n';
+    items.forEach(item => {
+        content += chalk.gray(`  • ${item}`) + '\n';
+    });
+    console.log(content);
+}
+/**
+ * Create warning message display
+ */
+export function createWarningMessage(message, details) {
+    let content = chalk.yellow.bold('⚠ ' + message) + '\n';
+    if (details && details.length > 0) {
+        content += '\n';
+        details.forEach(detail => {
+            content += chalk.dim(`  ${detail}`) + '\n';
+        });
+    }
+    console.log(content);
+}
+//# sourceMappingURL=helpFormatter.js.map

package/dist/helpFormatter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @mediaproc/core - Core utilities for MediaProc CLI and Plugins
+ *
+ * This package contains shared utilities used across MediaProc CLI and all plugins:
+ * - Branding utilities for consistent CLI/plugin footers
+ * - Help formatters for standardized command help displays
+ * - Path validators for robust file/directory handling
+ * - Explain formatters for detailed operation explanations
+ * - Supported extensions registry
+ */
+export * from './branding.js';
+export * from './helpFormatter.js';
+export * from './pathValidator.js';
+export * from './explainFormatter.js';
+export * from './supportedExtensions.js';
+export type { HelpOption, HelpExample, HelpSection, CommandHelpConfig } from './helpFormatter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AAGzC,YAAY,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EAClB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @mediaproc/core - Core utilities for MediaProc CLI and Plugins
+ *
+ * This package contains shared utilities used across MediaProc CLI and all plugins:
+ * - Branding utilities for consistent CLI/plugin footers
+ * - Help formatters for standardized command help displays
+ * - Path validators for robust file/directory handling
+ * - Explain formatters for detailed operation explanations
+ * - Supported extensions registry
+ */
+// Export all utilities
+export * from './branding.js';
+export * from './helpFormatter.js';
+export * from './pathValidator.js';
+export * from './explainFormatter.js';
+export * from './supportedExtensions.js';
+//# 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;;;;;;;;;GASG;AAEH,uBAAuB;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/dist/pathValidator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Parse input path and return array of files
+ * Supports:
+ * - Single file: "image.jpg"
+ * - Multiple files with commas: "image1.jpg,image2.jpg,image3.jpg"
+ * - Directory: "input-images/" (finds all matching files)
+ */
+export declare function parseInputPaths(inputPath: string, allowedExtensions?: string[]): string[];
+/**
+ * Resolve output paths for input files
+ *
+ * Logic:
+ * 1. Single file + output has extension (e.g., output.jpg) = Use exact file path
+ * 2. Multiple files + output has extension = Invalid (error)
+ * 3. No output provided = Use current directory
+ * 4. Output directory provided = Use that directory
+ *
+ * @param inputFiles - Array of input file paths
+ * @param outputPath - Output path (file or directory, or undefined for current dir)
+ * @param suffix - Suffix to add to filenames (default: empty)
+ * @param newExtension - New extension for output files (default: same as input)
+ */
+export declare function resolveOutputPaths(inputFiles: string[], outputPath: string | undefined, options?: {
+    suffix?: string;
+    newExtension?: string;
+}): Map<string, string>;
+/**
+ * Validate input and output paths
+ * Returns validated input files, output directory, and any errors
+ */
+export declare function validatePaths(inputPath: string, outputPath: string | undefined, options?: {
+    allowedExtensions?: string[];
+    suffix?: string;
+    newExtension?: string;
+}): {
+    inputFiles: string[];
+    outputPath: string | undefined;
+    errors: string[];
+};
+/**
+ * Get file name from path
+ */
+export declare function getFileName(filePath: string): string;
+//# sourceMappingURL=pathValidator.d.ts.map

package/dist/pathValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathValidator.d.ts","sourceRoot":"","sources":["../src/pathValidator.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,iBAAiB,GAAE,MAAM,EAA6D,GACrF,MAAM,EAAE,CA8BV;AAkCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA6DrB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,GAAE;IACP,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL;IACD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CA2BA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/pathValidator.js

@@ -0,0 +1,166 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { AUDIO_EXTENSIONS, IMAGE_EXTENSIONS, VIDEO_EXTENSIONS } from './supportedExtensions';
+/**
+ * Parse input path and return array of files
+ * Supports:
+ * - Single file: "image.jpg"
+ * - Multiple files with commas: "image1.jpg,image2.jpg,image3.jpg"
+ * - Directory: "input-images/" (finds all matching files)
+ */
+export function parseInputPaths(inputPath, allowedExtensions = IMAGE_EXTENSIONS || VIDEO_EXTENSIONS || AUDIO_EXTENSIONS) {
+    const files = [];
+    // Split by comma for multiple files
+    const paths = inputPath.split(',').map(p => p.trim());
+    for (const p of paths) {
+        const resolvedPath = path.resolve(p);
+        // Check if path exists
+        if (!fs.existsSync(resolvedPath)) {
+            continue; // Skip non-existent paths
+        }
+        const stats = fs.statSync(resolvedPath);
+        if (stats.isFile()) {
+            // Check if file has allowed extension
+            const ext = path.extname(resolvedPath).toLowerCase();
+            if (allowedExtensions.includes(ext)) {
+                files.push(resolvedPath);
+            }
+        }
+        else if (stats.isDirectory()) {
+            // Recursively find all files in directory
+            const dirFiles = findFilesInDirectory(resolvedPath, allowedExtensions);
+            files.push(...dirFiles);
+        }
+    }
+    return files;
+}
+/**
+ * Recursively find all files with allowed extensions in a directory
+ */
+function findFilesInDirectory(dir, allowedExtensions) {
+    const files = [];
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // Recursively search subdirectories
+                files.push(...findFilesInDirectory(fullPath, allowedExtensions));
+            }
+            else if (entry.isFile()) {
+                const ext = path.extname(fullPath).toLowerCase();
+                if (allowedExtensions.includes(ext)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    catch (error) {
+        // Ignore directories that can't be read
+    }
+    return files;
+}
+/**
+ * Resolve output paths for input files
+ *
+ * Logic:
+ * 1. Single file + output has extension (e.g., output.jpg) = Use exact file path
+ * 2. Multiple files + output has extension = Invalid (error)
+ * 3. No output provided = Use current directory
+ * 4. Output directory provided = Use that directory
+ *
+ * @param inputFiles - Array of input file paths
+ * @param outputPath - Output path (file or directory, or undefined for current dir)
+ * @param suffix - Suffix to add to filenames (default: empty)
+ * @param newExtension - New extension for output files (default: same as input)
+ */
+export function resolveOutputPaths(inputFiles, outputPath, options = {}) {
+    const { suffix = '', newExtension } = options;
+    const outputMap = new Map();
+    // No input files - return empty map
+    if (inputFiles.length === 0) {
+        return outputMap;
+    }
+    // Determine output directory or file
+    let outputDir;
+    let isExplicitFile = false;
+    if (!outputPath) {
+        // No output provided - use current directory
+        outputDir = process.cwd();
+    }
+    else {
+        const resolvedOutput = path.resolve(outputPath);
+        const outputExt = path.extname(resolvedOutput).toLowerCase();
+        if (outputExt) {
+            // Output has extension - it's a file path
+            if (inputFiles.length > 1) {
+                throw new Error('Cannot specify a file output path for multiple input files. Use a directory instead.');
+            }
+            // Single file with explicit output file
+            isExplicitFile = true;
+            outputDir = resolvedOutput;
+        }
+        else {
+            // No extension - it's a directory path
+            outputDir = resolvedOutput;
+        }
+    }
+    // Case 1: Single file with explicit output file path
+    if (isExplicitFile && inputFiles.length === 1) {
+        // Create parent directory if needed
+        const parentDir = path.dirname(outputDir);
+        if (!fs.existsSync(parentDir)) {
+            fs.mkdirSync(parentDir, { recursive: true });
+        }
+        outputMap.set(inputFiles[0], outputDir);
+        return outputMap;
+    }
+    // Case 2: Multiple files or directory output
+    // Create output directory if it doesn't exist
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    // Map each input file to output path
+    for (const inputFile of inputFiles) {
+        const inputParsed = path.parse(inputFile);
+        const ext = newExtension || inputParsed.ext;
+        const outputFilename = `${inputParsed.name}${suffix}${ext}`;
+        const outputFilePath = path.join(outputDir, outputFilename);
+        outputMap.set(inputFile, outputFilePath);
+    }
+    return outputMap;
+}
+/**
+ * Validate input and output paths
+ * Returns validated input files, output directory, and any errors
+ */
+export function validatePaths(inputPath, outputPath, options = {}) {
+    const { allowedExtensions = IMAGE_EXTENSIONS } = options;
+    const errors = [];
+    // Parse input files
+    const inputFiles = parseInputPaths(inputPath, allowedExtensions);
+    if (inputFiles.length === 0) {
+        errors.push(`No valid files found. Supported extensions: ${allowedExtensions.join(', ')}`);
+    }
+    // Validate output path if provided
+    if (outputPath) {
+        const resolvedOutput = path.resolve(outputPath);
+        const outputExt = path.extname(resolvedOutput).toLowerCase();
+        // If output has extension but multiple input files
+        if (outputExt && inputFiles.length > 1) {
+            errors.push('Cannot specify a file output path for multiple input files. Use a directory instead.');
+        }
+    }
+    return {
+        inputFiles,
+        outputPath,
+        errors,
+    };
+}
+/**
+ * Get file name from path
+ */
+export function getFileName(filePath) {
+    return path.basename(filePath);
+}
+//# sourceMappingURL=pathValidator.js.map

package/dist/pathValidator.js.map

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

package/dist/supportedExtensions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Supported media file extensions
+ */
+export declare const IMAGE_EXTENSIONS: string[];
+export declare const VIDEO_EXTENSIONS: string[];
+export declare const AUDIO_EXTENSIONS: string[];
+export declare const DOCUMENT_EXTENSIONS: string[];
+export declare const THREED_EXTENSIONS: string[];
+export declare const ANIMATION_EXTENSIONS: string[];
+//# sourceMappingURL=supportedExtensions.d.ts.map

package/dist/supportedExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportedExtensions.d.ts","sourceRoot":"","sources":["../src/supportedExtensions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAc5B,CAAC;AACF,eAAO,MAAM,gBAAgB,UAgB5B,CAAC;AACF,eAAO,MAAM,gBAAgB,UAE5B,CAAC;AACF,eAAO,MAAM,mBAAmB,UAAqG,CAAC;AACtI,eAAO,MAAM,iBAAiB,UAA8E,CAAC;AAC7G,eAAO,MAAM,oBAAoB,UAAqC,CAAC"}

package/dist/supportedExtensions.js

@@ -0,0 +1,42 @@
+/**
+ * Supported media file extensions
+ */
+export const IMAGE_EXTENSIONS = [
+    '.jpg',
+    '.jpeg',
+    '.png',
+    '.gif',
+    '.bmp',
+    '.webp',
+    '.tiff',
+    '.tif',
+    '.svg',
+    '.ico',
+    '.heic',
+    '.heif',
+    '.avif',
+];
+export const VIDEO_EXTENSIONS = [
+    '.mp4',
+    '.avi',
+    '.mkv',
+    '.mov',
+    '.webm',
+    '.flv',
+    '.wmv',
+    '.mpg',
+    '.mpeg',
+    '.m4v',
+    '.3gp',
+    '.f4v',
+    '.ts',
+    '.mts',
+    '.m2ts',
+];
+export const AUDIO_EXTENSIONS = [
+    '.mp3', '.wav', '.flac', '.aac', '.ogg', '.m4a', '.wma', '.opus', '.ape', '.alac', '.mov', '.mkv'
+];
+export const DOCUMENT_EXTENSIONS = ['.pdf', '.doc', '.docx', '.txt', '.rtf', '.odt', '.md', '.html', '.xml', '.tex', '.csv', '.pptx'];
+export const THREED_EXTENSIONS = ['.obj', '.fbx', '.gltf', '.glb', '.stl', '.dae', '.3ds', '.blend', '.ply'];
+export const ANIMATION_EXTENSIONS = ['.gif', '.apng', '.webp', '.mp4'];
+//# sourceMappingURL=supportedExtensions.js.map

package/dist/supportedExtensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportedExtensions.js","sourceRoot":"","sources":["../src/supportedExtensions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;CACV,CAAC;AACF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,OAAO;CACV,CAAC;AACF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;CACpG,CAAC;AACF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACtI,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC7G,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@mediaproc/core",
+  "version": "1.0.0",
+  "description": "Core utilities for MediaProc CLI and Plugins",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./branding": {
+      "import": "./dist/branding.js",
+      "types": "./dist/branding.d.ts"
+    },
+    "./helpFormatter": {
+      "import": "./dist/helpFormatter.js",
+      "types": "./dist/helpFormatter.d.ts"
+    },
+    "./pathValidator": {
+      "import": "./dist/pathValidator.js",
+      "types": "./dist/pathValidator.d.ts"
+    },
+    "./explainFormatter": {
+      "import": "./dist/explainFormatter.js",
+      "types": "./dist/explainFormatter.d.ts"
+    },
+    "./supportedExtensions": {
+      "import": "./dist/supportedExtensions.js",
+      "types": "./dist/supportedExtensions.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "prepublishOnly": "pnpm clean && pnpm build"
+  },
+  "keywords": [
+    "mediaproc",
+    "core",
+    "utilities",
+    "cli",
+    "plugins"
+  ],
+  "author": {
+    "name": "0xshariq",
+    "url": "https://github.com/0xshariq"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/0xshariq/mediaproc-cli.git",
+    "directory": "core"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.3"
+  }
+}