chore: removed ffmpeg statics deps

Author: heristop

.github/workflows/.ci.yml

@@ -11,13 +11,20 @@ jobs:
       - name: Checkout Repository
         uses: actions/checkout@v3
 
+      - name: Install FFmpeg
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y ffmpeg
+          ffmpeg -version
+          ffprobe -version
+
       - uses: pnpm/action-setup@v2
         with:
           version: 9
 
       - uses: actions/setup-node@v3
         with:
-          node-version: 18
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install Dependencies
@@ -39,6 +46,12 @@ jobs:
   #     - name: Checkout Repository
   #       uses: actions/checkout@v3
 
+  #     - name: Install FFmpeg
+  #       run: |
+  #         sudo apt-get update
+  #         sudo apt-get install -y ffmpeg
+  #         ffmpeg -version
+
   #     - uses: pnpm/action-setup@v2
   #       with:
   #         version: 9

.husky/pre-commit

@@ -1,4 +1 @@
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
 pnpm lint-staged

.lintstagedrc

@@ -1,4 +1,7 @@
 {
   "*.{ts,json,md,yml}": ["prettier --write"],
-  "*.{ts}": ["pnpm lint", "pnpm test"]
+  "**/*.ts": [
+    "pnpm lint --fix",
+    "pnpm run test:precommit --"
+  ]
 }

.npmrc

@@ -0,0 +1 @@
+use-node-version=22.14.0

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Alexandre Mogère
+Copyright (c) 2025 Alexandre Mogère
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,6 +1,6 @@
 # FFmpeg Video Composer
 
-[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.x-brightgreen.svg)](https://nodejs.org/en/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D22.x-brightgreen.svg)](https://nodejs.org/en/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 `ffmpeg-video-composer` is a tool designed to streamline the process of video compilation and audio mixing using FFmpeg. It enables dynamic template generation, video rendering, and audio composition, making it a comprehensive solution for creating personalized multimedia content programmatically.
 
@@ -14,24 +14,67 @@ https://github.com/heristop/assets/6bcd0578-7dee-4630-aa6b-c730cf5cec17
 
 ## 🚀 Features
 
-* Dynamic video and audio template generation
-* Easy video compilation and audio mixing using FFmpeg
-* Flexible JSON-based template descriptor system
-* CLI for quick video creation
-* JSON configuration for complex project setups
-* Custom project configurations support
-* Audio overlay and mixing capabilities
-* Automated video editing and composition
+- Dynamic video and audio template generation
+- Easy video compilation and audio mixing using FFmpeg
+- Flexible JSON-based template descriptor system
+- CLI for quick video creation
+- JSON configuration for complex project setups
+- Custom project configurations support
+- Audio overlay and mixing capabilities
+- Automated video editing and composition
 
-## 🛠 Installation
+## ⚠️ Prerequisites
+
+This tool requires **FFmpeg** to be installed on your system and available in your PATH. FFmpeg is used directly for all video and audio processing operations.
+
+### FFmpeg Installation Guide
+
+#### macOS
+
+Using [Homebrew](https://brew.sh/):
+
+```bash
+brew install ffmpeg
+```
+
+#### Linux
+
+For Debian/Ubuntu:
+
+```bash
+sudo apt update && sudo apt install ffmpeg
+```
+
+For Fedora:
+
+```bash
+sudo dnf install ffmpeg
+```
+
+For Arch Linux:
+
+```bash
+sudo pacman -S ffmpeg
+```
+
+#### Verify Installation
+
+After installation, verify that FFmpeg is properly installed:
+
+```bash
+ffmpeg -version
+ffprobe -version
+```
+
+## 📦 Installation
 
 ### Using npm (or yarn/pnpm)
 
 ```bash
 pnpm add ffmpeg-video-composer
 ```
 
-### Cloning the Repository
+### Development Setup
 
 ```bash
 git clone https://github.com/heristop/ffmpeg-video-composer.git
@@ -101,7 +144,7 @@ pnpm test
   }
 }}%%
 
-graph TB
+graph TD
     %% Style Definitions
     classDef core fill:#EDF7FF,stroke:#4B83B8,stroke-width:2px
     classDef abstract fill:#F9F3FF,stroke:#9D7AB8,stroke-width:2px,stroke-dasharray: 5 5
@@ -110,79 +153,67 @@ graph TB
     classDef builder fill:#FFE8E8,stroke:#E88B8B,stroke-width:2px
     classDef title fill:none,stroke:none
 
-    %% Entry Points and Director Pattern
-    subgraph Flow ["🚀 Application Flow"]
-        direction LR
-        main[("main.ts")]:::entry -->
-        index["index.ts"]:::entry
-
-        subgraph DirectorPattern ["👷 Builder Pattern Implementation"]
-            direction TB
-            director["TemplateDirector.ts"]:::builder
-            template_builder["TemplateConcreteBuilder.ts"]:::builder
-            director --> template_builder
-        end
-
-        index --> director
+    %% Entry Points
+    subgraph Flow ["🚀 Application Entry"]
+        direction TB
+        main[("main.ts")]:::entry --> index["index.ts"]:::entry
     end
 
     %% Core Domain
-    subgraph Core ["💎 Core Domain"]
+    subgraph Core ["💎 Domain Layer"]
         direction TB
-        subgraph Models ["Domain Models"]
-            direction TB
-            models_title["Core Business Objects"]:::title
+        subgraph CoreModels ["Domain Models"]
             core_project["Project.ts"]:::core
             core_segment["Segment.ts"]:::core
             core_template["Template.ts"]:::core
         end
 
-        subgraph Utils ["Core Utilities"]
-            direction TB
-            utils_title["Support Types & Config"]:::title
+        subgraph CoreUtils ["Core Utilities"]
             core_types["types.ts"]:::core
             core_config["default.config.ts"]:::core
-            core_format["FormatHelper.ts"]:::core
         end
     end
 
+    %% Director Pattern
+    subgraph Builder ["👷 Builder Pattern"]
+        direction TB
+        director["TemplateDirector.ts"]:::builder
+        template_builder["TemplateConcreteBuilder.ts"]:::builder
+    end
+
     %% Platform Layer
     subgraph Platform ["⚡ Platform Layer"]
         direction TB
-        subgraph Abstractions ["Interface Definitions"]
-            direction TB
-            abstractions_title["Abstract Interfaces"]:::title
+        subgraph PlatformCore ["Core Platform"]
+            platform_bridge["PlatformBridge.ts"]:::implementation
+            event_manager["EventManager.ts"]:::implementation
+        end
+
+        subgraph Abstractions ["Interfaces"]
             abstract_ffmpeg["AbstractFFmpeg.ts"]:::abstract
             abstract_music["AbstractMusic.ts"]:::abstract
             abstract_fs["AbstractFilesystem.ts"]:::abstract
             abstract_logger["AbstractLogger.ts"]:::abstract
         end
 
-        subgraph Adapters ["Concrete Implementations"]
-            direction TB
-            adapters_title["Platform Adapters"]:::title
+        subgraph Adapters ["Platform Adapters"]
             ffmpeg_node["FFmpegNodeAdapter.ts"]:::implementation
             music_node["MusicNodeAdapter.ts"]:::implementation
             fs_node["FilesystemNodeAdapter.ts"]:::implementation
             pino_adapter["PinoLogAdapter.ts"]:::implementation
         end
-
-        platform_bridge["PlatformBridge.ts"]:::implementation
-        event_manager["EventManager.ts"]:::implementation
     end
 
     %% Editor Components
     subgraph Editor ["🎥 Video Processing"]
         direction TB
-        subgraph EditorCore ["Core Editor Components"]
-            editor_title["Main Processing Units"]:::title
+        subgraph EditorCore ["Core Processing"]
             video_editor["VideoEditor.ts"]:::implementation
             music_composer["MusicComposer.ts"]:::implementation
             segment_builder["SegmentBuilder.ts"]:::implementation
         end
 
-        subgraph VideoSegments ["Video Segment Types"]
-            segments_title["Segment Implementations"]:::title
+        subgraph Segments ["Video Segments"]
             segment_factory["SegmentFactory.ts"]:::implementation
             video_segment["VideoSegment.ts"]:::implementation
             color_bg_segment["ColorBackgroundSegment.ts"]:::implementation
@@ -194,39 +225,42 @@ graph TB
     %% Resource Management
     subgraph Resources ["📊 Resource Management"]
         direction TB
-        resources_title["Resource Managers"]:::title
         asset_manager["AssetManager.ts"]:::implementation
         filter_manager["FilterManager.ts"]:::implementation
         formatter_manager["FormatterManager.ts"]:::implementation
         map_manager["MapManager.ts"]:::implementation
         var_manager["VariableManager.ts"]:::implementation
     end
 
-    %% Key Relationships
-    director --> |"orchestrates"| event_manager
-    director --> |"uses"| video_editor
-    template_builder --> |"creates"| segment_builder
-    template_builder --> |"uses"| segment_factory
+    %% Main Flow
+    index --> director
+    director --> template_builder
+    director --> video_editor
+    director --> event_manager
 
-    segment_factory --> |"creates"| video_segment & color_bg_segment & image_bg_segment & project_video_segment
-    video_segment & color_bg_segment & image_bg_segment & project_video_segment --> |"builds via"| segment_builder
+    %% Builder Pattern Flow
+    template_builder --> segment_builder
+    template_builder --> segment_factory
 
-    video_editor --> |"uses"| music_composer
+    %% Segment Creation Flow
+    segment_factory --> video_segment & color_bg_segment & image_bg_segment & project_video_segment
+    video_segment & color_bg_segment & image_bg_segment & project_video_segment --> segment_builder
 
-    %% Platform Implementation Relations
-    platform_bridge --> |"implements"| ffmpeg_node & music_node & fs_node & pino_adapter
+    %% Platform Relations
+    platform_bridge --> ffmpeg_node & music_node & fs_node & pino_adapter
+    ffmpeg_node --> abstract_ffmpeg
+    music_node --> abstract_music
+    fs_node --> abstract_fs
+    pino_adapter --> abstract_logger
 
-    ffmpeg_node --> |"implements"| abstract_ffmpeg
-    music_node --> |"implements"| abstract_music
-    fs_node --> |"implements"| abstract_fs
-    pino_adapter --> |"implements"| abstract_logger
+    %% Resource Management
+    segment_builder --> asset_manager & filter_manager & formatter_manager & map_manager & var_manager
 
-    %% Resource Management Relations
-    segment_builder --> |"manages"| asset_manager & filter_manager & formatter_manager & map_manager & var_manager
+    %% Core Dependencies
+    core_project --> core_config & core_types
 
-    %% Core Relations
-    core_project --> |"uses"| core_config
-    core_project --> |"uses"| core_types
+    %% Editor Flow
+    video_editor --> music_composer
 
     %% Link Styling
     linkStyle default stroke:#7C8D9D,stroke-width:1px

eslint.config.js

@@ -8,35 +8,40 @@ import globals from 'globals';
 export default [
   js.configs.recommended,
   {
-    files: ['**/*.ts', '**/*.tsx'],
+    files: ['src/**/*.ts', 'tests/**/*.ts'],
     languageOptions: {
       parser: tsParser,
       parserOptions: {
         project: './tsconfig.json',
+        ecmaVersion: 2020,
+        sourceType: 'module'
       },
+      globals: {
+        ...globals.node
+      }
     },
     plugins: {
       '@typescript-eslint': tsPlugin,
-      'prettier': prettierPlugin,
+      prettier: prettierPlugin
     },
     rules: {
-      ...tsPlugin.configs.recommended.rules,
+      ...tsPlugin.configs['recommended'].rules,
       ...prettierConfig.rules,
       '@typescript-eslint/dot-notation': 'error',
       'eol-last': 'error',
-      'prettier/prettier': 'error',
-    },
+      'prettier/prettier': 'error'
+    }
   },
   {
     files: ['**/*.test.ts', '**/*.spec.ts'],
     languageOptions: {
       globals: {
         ...globals.jest,
-        ...globals.node,
-      },
-    },
+        ...globals.node
+      }
+    }
   },
   {
-    ignores: ['eslint.config.js'],
-  },
-];
+    ignores: ['eslint.config.js', 'dist/**']
+  }
+];