Indentation Correction

# Conflicts:
#	CHANGELOG.md
#	src/ncc/CLI/Commands/BuildCommand.php
#	src/ncc/Classes/GithubExtension/GithubRepository.php
#	src/ncc/Managers/PackageManager.php
#	src/ncc/VERSION
#	src/ncc/version.json

.github/workflows/ci.yml

@@ -0,0 +1,136 @@
+name: CI Pipeline
+
+on:
+  push:
+    branches:
+      - '**'
+  pull_request:
+    branches:
+      - '**'
+  release:
+    types:
+      - created
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.3'
+          extensions: mbstring, ctype, common, zip
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y git libpq-dev libzip-dev zip make wget gnupg
+
+      - name: Install Phive
+        run: |
+          wget -O phive.phar https://phar.io/releases/phive.phar
+          wget -O phive.phar.asc https://phar.io/releases/phive.phar.asc
+          gpg --keyserver hkps://keys.openpgp.org --recv-keys 0x9D8A98B29B2D5D79
+          gpg --verify phive.phar.asc phive.phar
+          chmod +x phive.phar
+          sudo mv phive.phar /usr/local/bin/phive
+
+      - name: Install PHPAB
+        run: sudo phive install phpab --global --trust-gpg-keys 0x2A8299CE842DD38C
+
+      - name: Build project
+        run: make redist
+
+      - name: Find NCC build directory
+        id: find-ncc-dir
+        run: echo "NCC_DIR=$(find build/ -type d -name 'ncc_*' | head -n 1)" >> $GITHUB_ENV
+
+      - name: Upload NCC build directory
+        uses: actions/upload-artifact@v3
+        with:
+          name: ncc-build
+          path: ${{ env.NCC_DIR }}
+
+      - name: Create redist.zip
+        run: zip -r redist.zip ${{ env.NCC_DIR }}
+
+      - name: Upload redist.zip
+        uses: actions/upload-artifact@v3
+        with:
+          name: redist-zip
+          path: redist.zip
+
+      - name: Build Debian package
+        run: make deb
+
+      - name: Find Debian package
+        id: find-deb
+        run: echo "DEB_FILE=$(find build/ -type f -name '*.deb' | head -n 1)" >> $GITHUB_ENV
+
+      - name: Upload Debian package
+        uses: actions/upload-artifact@v3
+        with:
+          name: ncc-deb
+          path: ${{ env.DEB_FILE }}
+
+  test-install:
+    runs-on: ubuntu-latest
+    needs: build
+
+    steps:
+      - name: Download NCC build directory
+        uses: actions/download-artifact@v3
+        with:
+          name: ncc-build
+          path: build
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.3'
+          extensions: mbstring, ctype, common, zip
+
+      - name: Test NCC installation
+        run: |
+          ls -l build
+          sudo php build/INSTALL --auto
+
+  upload-release:
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name == 'release' && github.event.action == 'created'
+    permissions: write-all
+
+    steps:
+      - name: Download redist.zip
+        uses: actions/download-artifact@v3
+        with:
+          name: redist-zip
+          path: .
+
+      - name: Download Debian package
+        uses: actions/download-artifact@v3
+        with:
+          name: ncc-deb
+          path: .
+
+      - name: Set DEB_FILE environment variable
+        run: echo "DEB_FILE=$(find . -type f -name '*.deb' | head -n 1)" >> $GITHUB_ENV
+
+      - name: Upload redist.zip to release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: redist.zip
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload ncc.deb to release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: ${{ env.DEB_FILE }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -8,7 +8,7 @@
 build
 
 # Autoload files
-src/ncc/ThirdParty/composer/semver/autoload_spl.php
+src/ncc/ThirdParty/composer/Semver/autoload_spl.php
 src/ncc/ThirdParty/defuse/php-encryption/autoload_spl.php
 src/ncc/ThirdParty/jelix/version/autoload_spl.php
 src/ncc/ThirdParty/nikic/PhpParser/autoload_spl.php
@@ -29,3 +29,6 @@ src/ncc/autoload.php
 tests/example_project/project.json
 tests/example_project/ncc
 tests/example_project/build
+/.phpunit.result.cache
+/.idea/php-test-framework.xml
+/.idea/gbrowser_project.xml

.idea/codeStyles/Project.xml

@@ -0,0 +1,7 @@
+<component name="ProjectCodeStyleConfiguration">
+  <code_scheme name="Project" version="173">
+    <ScalaCodeStyleSettings>
+      <option name="MULTILINE_STRING_CLOSING_QUOTES_ON_NEW_LINE" value="true" />
+    </ScalaCodeStyleSettings>
+  </code_scheme>
+</component>

.idea/php.xml

@@ -12,10 +12,9 @@
   <component name="PhpIncludePathManager">
     <include_path>
       <path value="/usr/share/php" />
-      <path value="$PROJECT_DIR$/../loglib" />
     </include_path>
   </component>
-  <component name="PhpProjectSharedConfiguration" php_language_level="8.2">
+  <component name="PhpProjectSharedConfiguration" php_language_level="8.3">
     <option name="suggestChangeDefaultLanguageLevel" value="false" />
   </component>
   <component name="PhpRuntimeConfiguration">
@@ -26,6 +25,11 @@
   <component name="PhpStanOptionsConfiguration">
     <option name="transferred" value="true" />
   </component>
+  <component name="PhpUnit">
+    <phpunit_settings>
+      <PhpUnitSettings load_method="PHPUNIT_PHAR" custom_loader_path="" phpunit_phar_path="$USER_HOME$/phpunit.phar" />
+    </phpunit_settings>
+  </component>
   <component name="PsalmOptionsConfiguration">
     <option name="transferred" value="true" />
   </component>

CHANGELOG.md

@@ -5,6 +5,170 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.6] - 2024-10-29
+
+This update introduces critical bug fixes
+
+### Fixed
+ - Validate package instance before checking execution policy
+
+
+
+## [2.1.5] - 2024-10-14
+
+This update introduces a critical bug fix
+
+
+
+## [2.1.4] - 2024-10-13
+
+This update introduces minor bug fixes & improvements
+
+### Added
+ - Added new constant `%DEFAULT_BUILD_CONFIGURATION%` which points to the project's default build configuration
+ - Added new dynamic constant `%BUILD_OUTPUT_PATH%` which can be used as `%BUILD_OUTPUT_PATH%:release` to show the
+   output path of a specific build configuration
+ - Refactor CI templates to support dynamic build targets
+ - Added template `phpexe` & `phpgz` for generating executable binaries and compressed executables for the project
+
+### Changed
+ - Refactor phpmake template to support dynamic build targets
+
+### Fixed
+ - ncc will now correctly handle package execution where the main unit is not defined in the package instead of
+   throwing an exception.
+ - Executable Compiler will now correctly create a directory if it does not exist when compiling a package using gcc
+
+
+
+## [2.1.3] - 2024-09-27
+
+This update introduces bug fixes
+
+### Fixed
+ - Null-pointer fix
+
+
+## [2.1.2] - 2024-09-27
+
+This update introduces bug fixes
+
+### Added
+ - Add getter methods for installation lifecycle steps
+ - Added pre-install & post-install execution unit handling
+
+### Changed
+ - Updated DocStrings in PackageManager
+
+### Fixed
+ - Fixed incorrect enum usage in RepositoryMenu
+
+
+## [2.1.1] - 2024-09-24
+
+This update introduces a couple of new features and quality of life improvements
+
+### Added
+ - Added new PHP template `phpunit` for generating PhpUnit tests for the project
+ - Added new PHP template `phpmake` for generating a Makefile for the project
+ - Added new PHP template `phplib_full` That combines `phplib`, `phpmake` and `phpunit` templates
+ - Added new PHP template `phpcli_full` That combines `phpcli`, `phplib`, `phpmake` and `phpunit` templates
+ - Added new PHP template `phpci_github` that generates a Github CI workflow for the project
+
+### Changed
+ - The template `phpcli` no longer includes a Makefile, instead use `phpmake` to generate a Makefile for the project
+
+### Fixed
+ - Fixed incorrect enum usage with a logging method call.
+
+
+## [2.1.0] - 2024-09-20
+
+This update introduces a refactored code-base, code quality improvements, and better exception handling.
+
+### Added
+ - Added Test unit tests/ncc/Objects/Package/ComponentTest.php
+ - Added Test unit tests/ncc/Utilities/ResolverTest.php
+ - Added Test unit tests/ncc/Utilities/SecurityTest.php
+ - Added Test unit tests/ncc/Utilities/ValidateTest.php
+ - Add support for runtime constants
+
+### Changed
+ - Convert Versions constants to enum cases
+ - Update Scopes to enum and adjust scope checks
+ - Convert Runners class to enum with string cases
+ - Convert RegexPatterns constants to enum cases
+ - Convert ProjectTemplates constants to enum cases
+ - Convert PackageStructureVersions constants to enum cases
+ - Convert PackageStructure constants to enum cases
+ - Convert PackageDirectory constants to enum cases
+ - Convert LogLevel constants to enum cases
+ - Convert FileDescriptor constants to enum cases
+ - Convert ExceptionCodes constants to enum cases
+ - Convert ConsoleColors constants to enum cases
+ - Convert CompilerExtensions constants to enum cases
+ - Convert RepositoryType constants to enum cases
+ - Convert RepositoryResultType constants to enum cases
+ - Convert ProjectType constants to enum cases
+ - Convert HttpRequestType constants to enum cases
+ - Convert ComposerStabilityTypes constants to enum cases
+ - Convert ComposerPackageTypes constants to enum cases
+ - Convert ComponentDataType constants to enum cases
+ - Convert BuildOutputType constants to enum cases
+ - Convert AuthenticationType constants to enum cases
+ - Convert RuntimeConstants constants to enum cases
+ - Convert InstallConstants constants to enum cases
+ - Convert DateTimeConstants constants to enum cases
+ - Convert BuildConstants constants to enum cases
+ - Convert AssemblyConstants constants to enum cases
+ - Convert ProjectOptions constants to enum cases
+ - Convert InstallPackageOptions constants to enum cases
+ - Convert InitializeProjectOptions constants to enum cases
+ - Convert ComponentDecodeOptions constants to enum cases
+ - Convert BuildConfigurationValues constants to enum cases
+ - Convert BuildConfigurationOptions constants to enum cases
+ - Convert CompressionOptions constants to enum cases
+ - Convert PackageFlags constants to enum cases
+ - Convert NccBuildFlags constants to enum cases
+ - Convert ComponentFlags constants to enum cases
+ - Refactor flag handling to use PackageFlags enum directly
+ - Refactor checkLogLevel to correctly utilize LogLevel cases
+ - Refactor code to improve readability in Resolver.php
+ - Update PHP include paths in project configuration
+ - Refactor logging level checks to use LogLevel enum directly
+ - Refactor log level parsing with enum method
+ - Refactor log level checking to enum method
+ - Updated Symfony/Filesystem from version 6.3.1 to 7.1.2
+ - Refactor ProjectType handling
+ - Validate and enforce repository type enum usage
+ - Updated Composer/Semver to 3.4.3
+ - Rename 'semver' directory to 'Semver' in composer package
+ - Refactor project constants handling in NccCompiler
+ - Updated Symfony/Yaml to version 7.1.4
+ - Updated Symfony/Uid to version 7.1.4
+ - Updated Symfony/Process to version 7.1.3
+ - Updated Symfony/polyfill-ctype to version 1.31.0
+ - Updated Symfony/polyfill-mbstring to version 1.31.0
+ - Updated Symfony/polyfill-uuid to version 1.31.0
+ - Updated nikic/PhpParser to version 5.2.0
+
+### Fixed
+ - Fixed Division by zero in PackageManager
+ - Fixed runner argument passing for ExecCommand
+
+### Removed
+ - Removed EncoderType enum file, unused.
+ - Removed PackageStandardVersions.php
+ - Removed ConstantReferences.php
+ - Removed HttpStatusCodes.php
+ - Removed CompilerExtensionDefaultVersions.php
+ - Removed RemoteSourceType
+ - Removed DependencySourceType
+ - Removed BuiltinRemoteSourceType
+ - Removed RuntimeImportOptions
+ - Remove ComponentFileExtensions enum
+ - Remove unused import and redundant scope validation method
+
 ## [2.0.3] - 2023-10-17
 
 This update includes enhanced support for PHP statements in AST traversal, a friendly CLI Progress Bar, and fixes
@@ -20,7 +184,7 @@ The changes improve the system's efficiency, error resilience, and user experien
 
 ### Fixed
  - When finding package versions in the package lock, ncc will try to find a satisfying version rather than the exact
-   version, this is to prevent errors when the package lock contains a version that is not available in the repository.
+   version, this is to prevent[CHANGELOG.md](CHANGELOG.md) errors when the package lock contains a version that is not available in the repository.
  - Fixed issue when registering ncc's extension, when using the INSTALLER, the installation path used in the process
   appears to be incorrect, added a optional parameter to the `registerExtension` method to allow the installer to pass
   the correct installation path.

Makefile

@@ -18,7 +18,7 @@ DEBIAN_PACKAGE_BUILD_PATH := $(BUILD_PATH)/ncc_$(BUILD_VERSION)_all.deb
 
 # List of paths for autoloading
 AUTOLOAD_PATHS := $(addprefix $(SRC_PATH)/ncc/ThirdParty/, \
-    composer/semver \
+	composer/Semver \
 	defuse/php-encryption \
 	jelix/version \
 	nikic/PhpParser \

bootstrap.php

@@ -0,0 +1,9 @@
+<?php
+
+    $autoload_path = __DIR__ . DIRECTORY_SEPARATOR . 'src' . DIRECTORY_SEPARATOR . 'ncc' . DIRECTORY_SEPARATOR . 'autoload.php';
+    if(!file_exists($autoload_path))
+    {
+        throw new Exception("Autoload file not found");
+    }
+
+    require $autoload_path;

phpunit.xml

@@ -0,0 +1,11 @@
+<phpunit bootstrap="bootstrap.php">
+    <testsuites>
+        <testsuite name="ncc Test Suite">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+    <php>
+        <ini name="error_reporting" value="-1"/>
+        <server name="KERNEL_DIR" value="app/"/>
+    </php>
+</phpunit>

src/autoload/autoload.php

@@ -13,7 +13,7 @@
         $third_party_path = __DIR__ . DIRECTORY_SEPARATOR . 'ThirdParty' . DIRECTORY_SEPARATOR;
         $target_files = [
             __DIR__ . DIRECTORY_SEPARATOR . 'autoload_spl.php',
-            $third_party_path . 'composer' . DIRECTORY_SEPARATOR . 'semver' . DIRECTORY_SEPARATOR . 'autoload_spl.php',
+            $third_party_path . 'composer' . DIRECTORY_SEPARATOR . 'Semver' . DIRECTORY_SEPARATOR . 'autoload_spl.php',
             $third_party_path . 'defuse' . DIRECTORY_SEPARATOR . 'php-encryption' . DIRECTORY_SEPARATOR . 'autoload_spl.php',
             $third_party_path . 'jelix' . DIRECTORY_SEPARATOR . 'version' . DIRECTORY_SEPARATOR . 'autoload_spl.php',
             $third_party_path . 'nikic' . DIRECTORY_SEPARATOR . 'PhpParser' . DIRECTORY_SEPARATOR . 'autoload_spl.php',

src/debian/control

@@ -2,7 +2,7 @@ Package: ncc
 Source: ncc
 Section: devel
 Priority: optional
-Version: 2.0.3
+Version: 2.0.4
 Maintainer: netkas <netkas@nosial.net>
 Build-Depends: debhelper-compat (= 13)
 Standards-Version: 4.5.1

src/ncc/CLI/Commands/BuildCommand.php

@@ -75,7 +75,7 @@
 
             if($output_path !== null)
             {
-                $options[BuildConfigurationOptions::OUTPUT_FILE] = $output_path;
+                $options[BuildConfigurationOptions::OUTPUT_FILE->value] = $output_path;
             }
 
             // Load the project
@@ -92,7 +92,7 @@
             // Build the project
             try
             {
-                $build_configuration = $args['config'] ?? $args['c'] ?? BuildConfigurationValues::DEFAULT;
+                $build_configuration = $args['config'] ?? $args['c'] ?? BuildConfigurationValues::DEFAULT->value;
                 $output = $project_manager->build($build_configuration, $options);
             }
             catch (Exception $e)

src/ncc/CLI/Commands/ExecCommand.php

@@ -24,9 +24,11 @@
 
     use Exception;
     use ncc\Classes\Runtime;
+    use ncc\CLI\Main;
     use ncc\Objects\CliHelpSection;
     use ncc\Utilities\Console;
     use ncc\Utilities\Functions;
+    use ncc\Utilities\Resolver;
 
     class ExecCommand
     {
@@ -40,6 +42,12 @@
         {
             $package = $args['package'] ?? null;
             $version = $args['exec-version'] ?? 'latest';
+            $program_arguments = [];
+
+            if(isset($args['exec-args']))
+            {
+                $program_arguments = Resolver::splitArguments(Main::getRawArgs(), '--exec-args');
+            }
 
             if($package === null)
             {
@@ -58,7 +66,7 @@
 
             try
             {
-                return Runtime::execute($package_name);
+                return Runtime::execute($package_name, $program_arguments);
             }
             catch(Exception $e)
             {

src/ncc/CLI/Main.php

@@ -50,7 +50,12 @@
         private static $args;
 
         /**
-         * @var string|null
+         * @var array
+         */
+        private static $raw_args;
+
+        /**
+         * @var LogLevel|null
          */
         private static $log_level;
 
@@ -63,6 +68,7 @@
         public static function start(array $argv): int
         {
             self::$args = Resolver::parseArguments(implode(' ', $argv));
+            self::$raw_args = $argv;
 
             if(!isset(self::$args['ncc-cli']))
             {
@@ -91,30 +97,14 @@
 
             if(isset(self::$args['l']) || isset(self::$args['log-level']))
             {
-                switch(strtolower(self::$args['l'] ?? self::$args['log-level']))
+               self::$log_level = LogLevel::fromOrDefault(strtolower(self::$args['l'] ?? self::$args['log-level']));
-                {
-                    case LogLevel::SILENT:
-                    case LogLevel::FATAL:
-                    case LogLevel::ERROR:
-                    case LogLevel::WARNING:
-                    case LogLevel::INFO:
-                    case LogLevel::DEBUG:
-                    case LogLevel::VERBOSE:
-                        self::$log_level = strtolower(self::$args['l'] ?? self::$args['log-level']);
-                        break;
-
-                    default:
-                        Console::outWarning('Unknown log level: ' . (self::$args['l'] ?? self::$args['log-level']) . ', using \'info\'');
-                        self::$log_level = LogLevel::INFO;
-                        break;
-                }
             }
             else
             {
                 self::$log_level = LogLevel::INFO;
             }
 
-            if(Resolver::checkLogLevel(self::$log_level, LogLevel::DEBUG))
+            if(self::$log_level->checkLogLevel(LogLevel::DEBUG))
             {
                 Console::outDebug('Debug logging enabled');
 
@@ -125,12 +115,12 @@
                 Console::outDebug(sprintf('args: %s', json_encode(self::$args, JSON_UNESCAPED_SLASHES)));
             }
 
-            if(in_array(NccBuildFlags::UNSTABLE, NCC_VERSION_FLAGS, true))
+            if(in_array(NccBuildFlags::UNSTABLE->value, NCC_VERSION_FLAGS, true))
             {
                 Console::outWarning('This is an unstable build of ncc, expect some features to not work as expected');
             }
 
-            if(in_array(NccBuildFlags::BETA, NCC_VERSION_FLAGS, true))
+            if(in_array(NccBuildFlags::BETA->value, NCC_VERSION_FLAGS, true))
             {
                 Console::outWarning('This is a beta build of ncc, expect some features to not work as expected');
             }
@@ -230,9 +220,19 @@
         }
 
         /**
-         * @return string
+         * Returns the raw arguments passed to ncc
+         *
+         * @return array
          */
-        public static function getLogLevel(): string
+        public static function getRawArgs(): array
+        {
+            return self::$raw_args;
+        }
+
+        /**
+         * @return LogLevel
+         */
+        public static function getLogLevel(): LogLevel
         {
             if(self::$log_level === null)
             {

src/ncc/CLI/Management/ConfigMenu.php

@@ -101,7 +101,7 @@
 
                 if(isset($args['v']))
                 {
-                    if(Resolver::resolveScope() !== Scopes::SYSTEM)
+                    if(Resolver::resolveScope() !== Scopes::SYSTEM->value)
                     {
                         Console::outError('Insufficient permissions, cannot modify configuration values', true, 1);
                         return 1;

src/ncc/CLI/Management/CredentialMenu.php

@@ -187,7 +187,7 @@
         {
             $ResolvedScope = Resolver::resolveScope();
 
-            if($ResolvedScope !== Scopes::SYSTEM)
+            if($ResolvedScope !== Scopes::SYSTEM->value)
             {
                 Console::outError('Insufficient permissions to add entries');
             }
@@ -313,7 +313,7 @@
         {
             $ResolvedScope = Resolver::resolveScope();
 
-            if($ResolvedScope !== Scopes::SYSTEM)
+            if($ResolvedScope !== Scopes::SYSTEM->value)
             {
                 Console::outError('Insufficient permissions to remove entries');
             }

src/ncc/CLI/Management/PackageManagerMenu.php

@@ -132,7 +132,7 @@
          */
         private static function installPackage(array $args): int
         {
-            if(Resolver::resolveScope() !== Scopes::SYSTEM)
+            if(Resolver::resolveScope() !== Scopes::SYSTEM->value)
             {
                 Console::outError('You cannot install packages in a user scope, please run this command as root', true, 1);
                 return 1;
@@ -155,17 +155,22 @@
 
             if(isset($args['reinstall']))
             {
-                $options[InstallPackageOptions::REINSTALL] = true;
+                $options[InstallPackageOptions::REINSTALL->value] = true;
             }
 
             if(isset($args['prefer-static']) || isset($args['static']))
             {
-                $options[InstallPackageOptions::PREFER_STATIC] = true;
+                $options[InstallPackageOptions::PREFER_STATIC->value] = true;
             }
 
             if(isset($args['skip-dependencies']))
             {
-                $options[InstallPackageOptions::SKIP_DEPENDENCIES] = true;
+                $options[InstallPackageOptions::SKIP_DEPENDENCIES->value] = true;
+            }
+
+            if(isset($args['build-source']))
+            {
+                $options[InstallPackageOptions::BUILD_SOURCE->value] = true;
             }
 
             if($authentication !== null)
@@ -199,7 +204,7 @@
                 $authentication_entry = $entry->getPassword();
             }
 
-            if(preg_match(RegexPatterns::REMOTE_PACKAGE, $package) === 1)
+            if(preg_match(RegexPatterns::REMOTE_PACKAGE->value, $package) === 1)
             {
                 $package_input = RemotePackageInput::fromString($package);
 
@@ -388,7 +393,7 @@
          */
         private static function uninstallPackage($args): int
         {
-            if(Resolver::resolveScope() !== Scopes::SYSTEM)
+            if(Resolver::resolveScope() !== Scopes::SYSTEM->value)
             {
                 Console::outError('You cannot uninstall packages in a user scope, please run this command as root', true, 1);
                 return 1;
@@ -419,7 +424,7 @@
          */
         private static function uninstallAllPackages(array $args): int
         {
-            if(Resolver::resolveScope() !== Scopes::SYSTEM)
+            if(Resolver::resolveScope() !== Scopes::SYSTEM->value)
             {
                 Console::outError('You cannot uninstall all packages in a user scope, please run this command as root', true, 1);
                 return 1;
@@ -455,7 +460,7 @@
          */
         private static function fixBrokenPackages(array $args): int
         {
-            if(Resolver::resolveScope() !== Scopes::SYSTEM)
+            if(Resolver::resolveScope() !== Scopes::SYSTEM->value)
             {
                 Console::outError('You cannot fix broken packages in a user scope, please run this command as root', true, 1);
                 return 1;
@@ -560,6 +565,7 @@
                 new CliHelpSection(['install', '-p', '--skip-dependencies'], 'Installs a specified ncc package but skips the installation of dependencies'),
                 new CliHelpSection(['install', '-p', '--reinstall'], 'Installs a specified ncc package, reinstall if already installed'),
                 new CliHelpSection(['install', '--prefer-static', '--static'], 'Installs a static version of the package from the remote repository if available'),
+                new CliHelpSection(['install', '--build-source'], 'Forces ncc to build the packages from source rather than trying to use a pre-built binary'),
                 new CliHelpSection(['uninstall', '--package', '-p'], 'Uninstalls a specified ncc package'),
                 new CliHelpSection(['uninstall', '--package', '-p', '--version', '-v'], 'Uninstalls a specified ncc package version'),
                 new CliHelpSection(['uninstall-all'], 'Uninstalls all packages'),

src/ncc/CLI/Management/ProjectMenu.php

@@ -23,6 +23,7 @@
     namespace ncc\CLI\Management;
 
     use Exception;
+    use ncc\Enums\CompilerExtensions;
     use ncc\Enums\ProjectTemplates;
     use ncc\Enums\Scopes;
     use ncc\Managers\CredentialManager;
@@ -102,7 +103,12 @@
 
             if(isset($args['ext']))
             {
-                $compiler_extension = $args['ext'];
+                $compiler_extension = CompilerExtensions::tryFrom($args['ext']);
+                if($compiler_extension === null)
+                {
+                    Console::outError('Invalid compiler extension, please specify a valid compiler extension', true, 1);
+                    return 1;
+                }
             }
             else
             {
@@ -134,7 +140,7 @@
          */
         private static function installProject(array $args): int
         {
-            if(Resolver::resolveScope() !== Scopes::SYSTEM)
+            if(Resolver::resolveScope() !== Scopes::SYSTEM->value)
             {
                 Console::outError('You cannot install packages in a user scope, please run this command as root', true, 1);
                 return 1;
@@ -292,9 +298,9 @@
             }
 
             Console::out(PHP_EOL . 'Available Templates:');
-            foreach(ProjectTemplates::ALL as $template)
+            foreach(ProjectTemplates::cases() as $template)
             {
-                Console::out('   ' . $template);
+                Console::out('   ' . $template->value);
             }
 
             return 0;

src/ncc/CLI/Management/RepositoryMenu.php

@@ -25,6 +25,7 @@
     use Exception;
     use ncc\Enums\ConsoleColors;
     use ncc\Enums\Scopes;
+    use ncc\Enums\Types\RepositoryType;
     use ncc\Managers\RepositoryManager;
     use ncc\Objects\CliHelpSection;
     use ncc\Objects\RepositoryConfiguration;
@@ -118,7 +119,7 @@
                 $output = sprintf('%s (%s) [%s]',
                     $source->getName(),
                     Console::formatColor($source->getHost(), ConsoleColors::GREEN),
-                    Console::formatColor($source->getType(), ConsoleColors::YELLOW)
+                    Console::formatColor($source->getType()->value, ConsoleColors::YELLOW)
                 );
 
                 if(!$source->isSsl())
@@ -141,7 +142,7 @@
          */
         private static function addEntry(array $args): int
         {
-            if(Resolver::resolveScope() !== Scopes::SYSTEM)
+            if(Resolver::resolveScope() !== Scopes::SYSTEM->value)
             {
                 Console::outError('You must be running as root to add a new repository', true, 1);
                 return 1;
@@ -164,6 +165,13 @@
                 return 1;
             }
 
+            $parsed_type = RepositoryType::tryFrom($type);
+            if($parsed_type === null)
+            {
+                Console::outError(sprintf('Unknown repository type \'%s\'.', $type), true, 1);
+                return 1;
+            }
+
             if($host === null)
             {
                 Console::outError(sprintf('Missing required argument \'%s\'.', 'host'), true, 1);
@@ -172,7 +180,7 @@
 
             try
             {
-                (new RepositoryManager())->addRepository(new RepositoryConfiguration($name, $host, $type, $ssl));
+                (new RepositoryManager())->addRepository(new RepositoryConfiguration($name, $host, $parsed_type, $ssl));
             }
             catch(Exception $e)
             {
@@ -230,7 +238,7 @@
          */
         private static function removeEntry(array $args): int
         {
-            if(Resolver::resolveScope() !== Scopes::SYSTEM)
+            if(Resolver::resolveScope() !== Scopes::SYSTEM->value)
             {
                 Console::outError('You must be running as root to remove a repository', true, 1);
                 return 1;

src/ncc/Classes/ExecutionUnitRunner.php

@@ -31,6 +31,7 @@
     use ncc\Classes\PhpExtension\PhpRunner;
     use ncc\Enums\Runners;
     use ncc\Exceptions\ConfigurationException;
+    use ncc\Exceptions\IntegrityException;
     use ncc\Exceptions\IOException;
     use ncc\Exceptions\NotSupportedException;
     use ncc\Exceptions\OperationException;
@@ -54,11 +55,11 @@
         {
             $bin = match($unit->getExecutionPolicy()->getRunner())
             {
-                Runners::PHP => (new ExecutableFinder())->find('php'),
+                Runners::PHP->value => (new ExecutableFinder())->find('php'),
-                Runners::BASH => (new ExecutableFinder())->find('bash'),
+                Runners::BASH->value => (new ExecutableFinder())->find('bash'),
-                Runners::PYTHON => (new ExecutableFinder())->find('python'),
+                Runners::PYTHON->value => (new ExecutableFinder())->find('python'),
-                Runners::LUA => (new ExecutableFinder())->find('lua'),
+                Runners::LUA->value => (new ExecutableFinder())->find('lua'),
-                Runners::PERL => (new ExecutableFinder())->find('perl'),
+                Runners::PERL->value => (new ExecutableFinder())->find('perl'),
 
                 default => throw new NotSupportedException(sprintf('The execution policy %s is not supported because it uses the %s runner', $unit->getExecutionPolicy()->getName(), $unit->getExecutionPolicy()->getRunner()))
             };
@@ -76,11 +77,19 @@
             {
                 $process->setTimeout($unit->getExecutionPolicy()->getExecute()->getTimeout());
             }
+            else
+            {
+                $process->setTimeout(null);
+            }
 
             if($unit->getExecutionPolicy()->getExecute()->getIdleTimeout() !== null)
             {
                 $process->setIdleTimeout($unit->getExecutionPolicy()->getExecute()->getIdleTimeout());
             }
+            else
+            {
+                $process->setIdleTimeout(null);
+            }
 
             return $process;
         }
@@ -109,8 +118,8 @@
                 $execution_unit = ExecutionUnit::fromArray(ZiProto::decode(IO::fread($unit_path)));
                 return match ($execution_unit->getExecutionPolicy()->getRunner())
                 {
-                    Runners::PHP => PhpRunner::executeUnit($execution_unit, $args),
+                    Runners::PHP->value => PhpRunner::executeUnit($execution_unit, $args),
-                    Runners::BASH => BashRunner::executeUnit($execution_unit, $args),
+                    Runners::BASH->value => BashRunner::executeUnit($execution_unit, $args),
                     default => throw new NotSupportedException(sprintf('The execution policy %s is not supported because it uses the %s runner', $execution_unit->getExecutionPolicy()->getName(), $execution_unit->getExecutionPolicy()->getRunner())),
                 };
             }
@@ -129,6 +138,7 @@
          * @return int
          * @throws ConfigurationException
          * @throws OperationException
+         * @throws IntegrityException
          */
         public static function executeFromPackage(PackageReader $package_reader, string $policy_name, array $args=[]): int
         {
@@ -138,8 +148,8 @@
             {
                 return match ($execution_unit->getExecutionPolicy()->getRunner())
                 {
-                    Runners::PHP => PhpRunner::executeUnit($execution_unit, $args, false),
+                    Runners::PHP->value => PhpRunner::executeUnit($execution_unit, $args, false),
-                    Runners::BASH => BashRunner::executeUnit($execution_unit, $args),
+                    Runners::BASH->value => BashRunner::executeUnit($execution_unit, $args),
                     default => throw new NotSupportedException(sprintf('The execution policy %s is not supported because it uses the %s runner', $execution_unit->getExecutionPolicy()->getName(), $execution_unit->getExecutionPolicy()->getRunner())),
                 };
             }

src/ncc/Classes/GiteaExtension/GiteaRepository.php

@@ -39,6 +39,7 @@
     use ncc\Objects\Vault\Password\AccessToken;
     use ncc\Objects\Vault\Password\UsernamePassword;
     use ncc\Utilities\Console;
+    use ncc\Utilities\Resolver;
     use ncc\Utilities\RuntimeCache;
     use RuntimeException;
 
@@ -47,7 +48,7 @@
         /**
          * @inheritDoc
          */
-        public static function fetchSourceArchive(RepositoryConfiguration $repository, string $vendor, string $project, string $version=Versions::LATEST, ?AuthenticationType $authentication=null, array $options=[]): RepositoryResult
+        public static function fetchSourceArchive(RepositoryConfiguration $repository, string $vendor, string $project, string $version=Versions::LATEST->value, ?AuthenticationType $authentication=null, array $options=[]): RepositoryResult
         {
             try
             {
@@ -64,7 +65,7 @@
         /**
          * @inheritDoc
          */
-        public static function fetchPackage(RepositoryConfiguration $repository, string $vendor, string $project, string $version=Versions::LATEST, ?AuthenticationType $authentication=null, array $options=[]): RepositoryResult
+        public static function fetchPackage(RepositoryConfiguration $repository, string $vendor, string $project, string $version=Versions::LATEST->value, ?AuthenticationType $authentication=null, array $options=[]): RepositoryResult
         {
             return self::getReleasePackage($repository, $vendor, $project, $version, $authentication, $options);
         }
@@ -97,15 +98,21 @@
                 'User-Agent: ncc'
             ];
 
-
             if($authentication !== null)
             {
                 $headers = self::injectAuthentication($authentication, $curl, $headers);
             }
 
+            $resolved_host = Resolver::getResolveOption($endpoint);
+
+            if($resolved_host !== null)
+            {
+                curl_setopt($curl, CURLOPT_RESOLVE, [$resolved_host]);
+            }
+
             curl_setopt_array($curl, [
                 CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers
             ]);
 
@@ -162,7 +169,7 @@
          */
         private static function getTagArchive(RepositoryConfiguration $repository, string $group, string $project, string $tag, ?AuthenticationInterface $authentication=null): RepositoryResult
         {
-            if($tag === Versions::LATEST)
+            if($tag === Versions::LATEST->value)
             {
                 $tag = self::getLatestTag($repository, $group, $project, $authentication);
             }
@@ -186,10 +193,17 @@
                 $headers = self::injectAuthentication($authentication, $curl, $headers);
             }
 
+            $resolved_host = Resolver::getResolveOption($endpoint);
+
+            if($resolved_host !== null)
+            {
+                curl_setopt($curl, CURLOPT_RESOLVE, [$resolved_host]);
+            }
+
             curl_setopt_array($curl, [
                 CURLOPT_URL => $endpoint,
                 CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers
             ]);
 
@@ -198,11 +212,11 @@
 
             if(isset($response['zipball_url']))
             {
-                $result = new RepositoryResult($response['zipball_url'], RepositoryResultType::SOURCE, $tag);
+                $result = new RepositoryResult($response['zipball_url'], RepositoryResultType::SOURCE->value, $tag);
             }
             elseif(isset($response['tarball_url']))
             {
-                $result = new RepositoryResult($response['tarball_url'], RepositoryResultType::SOURCE, $tag);
+                $result = new RepositoryResult($response['tarball_url'], RepositoryResultType::SOURCE->value, $tag);
             }
             else
             {
@@ -246,10 +260,17 @@
                 $headers = self::injectAuthentication($authentication, $curl, $headers);
             }
 
+            $resolved_host = Resolver::getResolveOption($endpoint);
+
+            if($resolved_host !== null)
+            {
+                curl_setopt($curl, CURLOPT_RESOLVE, [$resolved_host]);
+            }
+
             curl_setopt_array($curl, [
                 CURLOPT_URL => $endpoint,
                 CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers
             ]);
 
@@ -307,7 +328,7 @@
         private static function getReleasePackage(RepositoryConfiguration $repository, string $group, string $project, string $release, ?AuthenticationInterface $authentication=null, array $options=[]): RepositoryResult
         {
             /** @noinspection DuplicatedCode */
-            if($release === Versions::LATEST)
+            if($release === Versions::LATEST->value)
             {
                 $release = self::getLatestRelease($repository, $group, $project, $authentication);
             }
@@ -337,10 +358,17 @@
                 $headers = self::injectAuthentication($authentication, $curl, $headers);
             }
 
+            $resolved_host = Resolver::getResolveOption($endpoint);
+
+            if($resolved_host !== null)
+            {
+                curl_setopt($curl, CURLOPT_RESOLVE, [$resolved_host]);
+            }
+
             curl_setopt_array($curl, [
                 CURLOPT_URL => $endpoint,
                 CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers
             ]);
 
@@ -355,7 +383,7 @@
                     $release, $group, $project));
             }
 
-            $static_preferred = isset($options[InstallPackageOptions::PREFER_STATIC]);
+            $static_preferred = isset($options[InstallPackageOptions::PREFER_STATIC->value]);
             $preferred_asset = null;
             $fallback_asset = null;
 
@@ -379,7 +407,7 @@
 
                 if($asset_url)
                 {
-                    $result = new RepositoryResult($asset_url, RepositoryResultType::PACKAGE, $release);
+                    $result = new RepositoryResult($asset_url, RepositoryResultType::PACKAGE->value, $release);
 
                     RuntimeCache::set($endpoint, $result);
                     return $result;
@@ -409,7 +437,7 @@
         private static function getReleaseArchive(RepositoryConfiguration $repository, string $group, string $project, string $release, ?AuthenticationInterface $authentication=null): RepositoryResult
         {
             /** @noinspection DuplicatedCode */
-            if ($release === Versions::LATEST)
+            if ($release === Versions::LATEST->value)
             {
                 $release = self::getLatestRelease($repository, $group, $project, $authentication);
             }
@@ -433,10 +461,17 @@
                 $headers = self::injectAuthentication($authentication, $curl, $headers);
             }
 
+            $resolved_host = Resolver::getResolveOption($endpoint);
+
+            if($resolved_host !== null)
+            {
+                curl_setopt($curl, CURLOPT_RESOLVE, [$resolved_host]);
+            }
+
             curl_setopt_array($curl, [
                 CURLOPT_URL => $endpoint,
                 CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers
             ]);
 
@@ -445,11 +480,11 @@
 
             if(isset($response['zipball_url']))
             {
-                $results = new RepositoryResult($response['zipball_url'], RepositoryResultType::SOURCE, $release);
+                $results = new RepositoryResult($response['zipball_url'], RepositoryResultType::SOURCE->value, $release);
             }
             elseif(isset($response['tarball_url']))
             {
-                $results = new RepositoryResult($response['tarball_url'], RepositoryResultType::SOURCE, $release);
+                $results = new RepositoryResult($response['tarball_url'], RepositoryResultType::SOURCE->value, $release);
             }
             else
             {
@@ -480,7 +515,7 @@
                         break;
                     }
 
-                    throw new AuthenticationException(sprintf('Invalid authentication type for Access Token, got %s instead', $authentication->getAuthenticationType()));
+                    throw new AuthenticationException(sprintf('Invalid authentication type for Access Token, got %s instead', $authentication->getAuthenticationType()->value));
 
                 case AuthenticationType::USERNAME_PASSWORD:
                     if($authentication instanceof UsernamePassword)
@@ -489,7 +524,7 @@
                         break;
                     }
 
-                    throw new AuthenticationException(sprintf('Invalid authentication type for Username/Password, got %s instead', $authentication->getAuthenticationType()));
+                    throw new AuthenticationException(sprintf('Invalid authentication type for Username/Password, got %s instead', $authentication->getAuthenticationType()->value));
             }
 
             return $headers;

src/ncc/Classes/GithubExtension/GithubRepository.php

@@ -47,7 +47,7 @@
         /**
          * @inheritDoc
          */
-        public static function fetchSourceArchive(RepositoryConfiguration $repository, string $vendor, string $project, string $version=Versions::LATEST, ?AuthenticationType $authentication=null, array $options=[]): RepositoryResult
+        public static function fetchSourceArchive(RepositoryConfiguration $repository, string $vendor, string $project, string $version=Versions::LATEST->value, ?AuthenticationType $authentication=null, array $options=[]): RepositoryResult
         {
             try
             {
@@ -64,7 +64,7 @@
         /**
          * @inheritDoc
          */
-        public static function fetchPackage(RepositoryConfiguration $repository, string $vendor, string $project, string $version = Versions::LATEST, ?AuthenticationType $authentication = null, array $options=[]): RepositoryResult
+        public static function fetchPackage(RepositoryConfiguration $repository, string $vendor, string $project, string $version = Versions::LATEST->value, ?AuthenticationType $authentication = null, array $options=[]): RepositoryResult
         {
             return self::getReleasePackage($repository, $vendor, $project, $version, $authentication, $options);
         }
@@ -104,7 +104,7 @@
 
             curl_setopt_array($curl, [
                 CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers
             ]);
 
@@ -161,7 +161,7 @@
          */
         private static function getTagArchive(RepositoryConfiguration $repository, string $group, string $project, string $tag, ?AuthenticationInterface $authentication = null): RepositoryResult
         {
-            if($tag === Versions::LATEST)
+            if($tag === Versions::LATEST->value)
             {
                 $tag = self::getLatestTag($repository, $group, $project, $authentication);
             }
@@ -186,7 +186,7 @@
             curl_setopt_array($curl, [
                 CURLOPT_RETURNTRANSFER => true,
                 CURLOPT_NOBODY => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers,
                 CURLOPT_FOLLOWLOCATION => true
             ]);
@@ -207,7 +207,7 @@
                 throw new NetworkException(sprintf('Server responded with HTTP code %s when getting tag archive for %s/%s/%s', $http_code, $group, $project, $tag));
             }
 
-            $result =  new RepositoryResult(curl_getinfo($curl, CURLINFO_EFFECTIVE_URL), RepositoryResultType::SOURCE, $tag);
+            $result =  new RepositoryResult(curl_getinfo($curl, CURLINFO_EFFECTIVE_URL), RepositoryResultType::SOURCE->value, $tag);
             curl_close($curl);
             RuntimeCache::set($endpoint, $result);
 
@@ -249,7 +249,7 @@
 
             curl_setopt_array($curl, [
                 CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers
             ]);
 
@@ -307,7 +307,7 @@
         private static function getReleasePackage(RepositoryConfiguration $repository, string $group, string $project, string $release, ?AuthenticationInterface $authentication=null, array $options=[]): RepositoryResult
         {
             /** @noinspection DuplicatedCode */
-            if($release === Versions::LATEST)
+            if($release === Versions::LATEST->value)
             {
                 $release = self::getLatestRelease($repository, $group, $project, $authentication);
             }
@@ -331,7 +331,7 @@
                 $headers = self::injectAuthentication($authentication, $curl, $headers);
             }
 
-            curl_setopt_array($curl, [CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => HttpRequestType::GET, CURLOPT_HTTPHEADER => $headers]);
+            curl_setopt_array($curl, [CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value, CURLOPT_HTTPHEADER => $headers]);
 
             Console::outDebug(sprintf('Fetching release package for %s/%s/%s from %s', $group, $project, $release, $endpoint));
             $response = self::processHttpResponse($curl, $group, $project);
@@ -341,7 +341,7 @@
                 throw new NetworkException(sprintf('Failed to get release package for %s/%s/%s: No assets found', $group, $project, $release));
             }
 
-            $static_preferred = isset($options[InstallPackageOptions::PREFER_STATIC]);
+            $static_preferred = isset($options[InstallPackageOptions::PREFER_STATIC->value]);
             $preferred_asset = null;
             $fallback_asset = null;
 
@@ -363,7 +363,7 @@
             {
                 $asset_url = $target_asset['browser_download_url'];
 
-                $result = new RepositoryResult($asset_url, RepositoryResultType::PACKAGE, $release);
+                $result = new RepositoryResult($asset_url, RepositoryResultType::PACKAGE->value, $release);
 
                 RuntimeCache::set($endpoint, $result);
                 return $result;
@@ -389,7 +389,7 @@
         private static function getReleaseArchive(RepositoryConfiguration $repository, string $group, string $project, string $release, ?AuthenticationInterface $authentication = null): RepositoryResult
         {
             /** @noinspection DuplicatedCode */
-            if($release === Versions::LATEST)
+            if($release === Versions::LATEST->value)
             {
                 $release = self::getLatestRelease($repository, $group, $project, $authentication);
             }
@@ -415,7 +415,7 @@
 
             curl_setopt_array($curl, [
                 CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers
             ]);
 
@@ -425,11 +425,11 @@
 
             if(isset($response['zipball_url']))
             {
-                $result = new RepositoryResult($response['zipball_url'], RepositoryResultType::SOURCE, $release);
+                $result = new RepositoryResult($response['zipball_url'], RepositoryResultType::SOURCE->value, $release);
             }
             elseif(isset($response['tarball_url']))
             {
-                $result = new RepositoryResult($response['tarball_url'], RepositoryResultType::SOURCE, $release);
+                $result = new RepositoryResult($response['tarball_url'], RepositoryResultType::SOURCE->value, $release);
             }
             else
             {
@@ -459,7 +459,7 @@
                         $headers[] = 'Authorization: Bearer ' . $authentication->getAccessToken();
                         break;
                     }
-                    throw new AuthenticationException(sprintf('Invalid authentication type for Access Token, got %s instead', $authentication->getAuthenticationType()));
+                    throw new AuthenticationException(sprintf('Invalid authentication type for Access Token, got %s instead', $authentication->getAuthenticationType()->value));
 
                 case AuthenticationType::USERNAME_PASSWORD:
                     if($authentication instanceof UsernamePassword)
@@ -468,7 +468,7 @@
                         break;
                     }
 
-                    throw new AuthenticationException(sprintf('Invalid authentication type for Username/Password, got %s instead', $authentication->getAuthenticationType()));
+                    throw new AuthenticationException(sprintf('Invalid authentication type for Username/Password, got %s instead', $authentication->getAuthenticationType()->value));
             }
 
             return $headers;

src/ncc/Classes/GitlabExtension/GitlabRepository.php

@@ -39,6 +39,7 @@
     use ncc\Objects\Vault\Password\AccessToken;
     use ncc\Objects\Vault\Password\UsernamePassword;
     use ncc\Utilities\Console;
+    use ncc\Utilities\Resolver;
     use ncc\Utilities\RuntimeCache;
     use RuntimeException;
 
@@ -47,7 +48,7 @@
         /**
          * @inheritDoc
          */
-        public static function fetchSourceArchive(RepositoryConfiguration $repository, string $vendor, string $project, string $version=Versions::LATEST, ?AuthenticationType $authentication=null, array $options=[]): RepositoryResult
+        public static function fetchSourceArchive(RepositoryConfiguration $repository, string $vendor, string $project, string $version=Versions::LATEST->value, ?AuthenticationType $authentication=null, array $options=[]): RepositoryResult
         {
             try
             {
@@ -64,7 +65,7 @@
         /**
          * @inheritDoc
          */
-        public static function fetchPackage(RepositoryConfiguration $repository, string $vendor, string $project, string $version=Versions::LATEST, ?AuthenticationType $authentication=null, array $options=[]): RepositoryResult
+        public static function fetchPackage(RepositoryConfiguration $repository, string $vendor, string $project, string $version=Versions::LATEST->value, ?AuthenticationType $authentication=null, array $options=[]): RepositoryResult
         {
             return self::getReleasePackage($repository, $vendor, $project, $version, $authentication, $options);
         }
@@ -103,10 +104,17 @@
                 $headers = self::injectAuthentication($authentication, $curl, $headers);
             }
 
+            $resolved_host = Resolver::getResolveOption($endpoint);
+
+            if($resolved_host !== null)
+            {
+                curl_setopt($curl, CURLOPT_RESOLVE, [$resolved_host]);
+            }
+
             curl_setopt_array($curl, [
                 CURLOPT_URL => $endpoint,
                 CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers
             ]);
 
@@ -164,7 +172,7 @@
          */
         private static function getTagArchive(RepositoryConfiguration $repository, string $group, string $project, string $tag, ?AuthenticationInterface $authentication=null): RepositoryResult
         {
-            if($tag === Versions::LATEST)
+            if($tag === Versions::LATEST->value)
             {
                 $tag = self::getLatestTag($repository, $group, $project, $authentication);
             }
@@ -187,10 +195,17 @@
                 $headers = self::injectAuthentication($authentication, $curl, $headers);
             }
 
+            $resolved_host = Resolver::getResolveOption($endpoint);
+
+            if($resolved_host !== null)
+            {
+                curl_setopt($curl, CURLOPT_RESOLVE, [$resolved_host]);
+            }
+
             curl_setopt_array($curl, [
                 CURLOPT_RETURNTRANSFER => true,
                 CURLOPT_NOBODY => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers,
                 CURLOPT_FOLLOWLOCATION => true
             ]);
@@ -210,7 +225,7 @@
                 throw new NetworkException(sprintf('Server responded with HTTP code %s when getting tag archive for %s/%s/%s', $http_code, $group, $project, $tag));
             }
 
-            $results = new RepositoryResult(curl_getinfo($curl, CURLINFO_EFFECTIVE_URL), RepositoryResultType::SOURCE, $tag);
+            $results = new RepositoryResult(curl_getinfo($curl, CURLINFO_EFFECTIVE_URL), RepositoryResultType::SOURCE->value, $tag);
             RuntimeCache::set($endpoint, $results);
 
             return $results;
@@ -250,9 +265,16 @@
                 $headers = self::injectAuthentication($authentication, $curl, $headers);
             }
 
+            $resolved_host = Resolver::getResolveOption($endpoint);
+
+            if($resolved_host !== null)
+            {
+                curl_setopt($curl, CURLOPT_RESOLVE, [$resolved_host]);
+            }
+
             curl_setopt_array($curl, [
                 CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers
             ]);
 
@@ -308,7 +330,7 @@
          */
         private static function getReleasePackage(RepositoryConfiguration $repository, string $group, string $project, string $release, ?AuthenticationInterface $authentication=null, array $options=[]): RepositoryResult
         {
-            if($release === Versions::LATEST)
+            if($release === Versions::LATEST->value)
             {
                 $release = self::getLatestRelease($repository, $group, $project, $authentication);
             }
@@ -333,14 +355,21 @@
                 $headers = self::injectAuthentication($authentication, $curl, $headers);
             }
 
+            $resolved_host = Resolver::getResolveOption($endpoint);
+
+            if($resolved_host !== null)
+            {
+                curl_setopt($curl, CURLOPT_RESOLVE, [$resolved_host]);
+            }
+
             curl_setopt_array($curl, [
                 CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers
             ]);
 
             $response = self::processHttpResponse($curl, $group, $project);
-            $static_preferred = isset($options[InstallPackageOptions::PREFER_STATIC]);
+            $static_preferred = isset($options[InstallPackageOptions::PREFER_STATIC->value]);
             $preferred_asset = null;
             $fallback_asset = null;
 
@@ -364,7 +393,7 @@
 
                 if ($asset_url)
                 {
-                    $result = new RepositoryResult($asset_url, RepositoryResultType::PACKAGE, $release);
+                    $result = new RepositoryResult($asset_url, RepositoryResultType::PACKAGE->value, $release);
 
                     RuntimeCache::set($endpoint, $result);
                     return $result;
@@ -393,7 +422,7 @@
         private static function getReleaseArchive(RepositoryConfiguration $repository, string $group, string $project, string $release, ?AuthenticationInterface $authentication=null): RepositoryResult
         {
             /** @noinspection DuplicatedCode */
-            if($release === Versions::LATEST)
+            if($release === Versions::LATEST->value)
             {
                 $release = self::getLatestRelease($repository, $group, $project, $authentication);
             }
@@ -418,9 +447,16 @@
                 $headers = self::injectAuthentication($authentication, $curl, $headers);
             }
 
+            $resolved_host = Resolver::getResolveOption($endpoint);
+
+            if($resolved_host !== null)
+            {
+                curl_setopt($curl, CURLOPT_RESOLVE, [$resolved_host]);
+            }
+
             curl_setopt_array($curl, [
                 CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                 CURLOPT_HTTPHEADER => $headers
             ]);
 
@@ -440,11 +476,11 @@
 
                 if($asset['format'] === 'zip')
                 {
-                    $results = new RepositoryResult($asset['url'], RepositoryResultType::SOURCE, $release);
+                    $results = new RepositoryResult($asset['url'], RepositoryResultType::SOURCE->value, $release);
                 }
                 elseif($asset['format'] === 'tar')
                 {
-                    $results = new RepositoryResult($asset['url'], RepositoryResultType::SOURCE, $release);
+                    $results = new RepositoryResult($asset['url'], RepositoryResultType::SOURCE->value, $release);
                 }
                 else
                 {
@@ -471,23 +507,23 @@
         {
             switch($authentication->getAuthenticationType())
             {
-                case AuthenticationType::ACCESS_TOKEN:
+                case AuthenticationType::ACCESS_TOKEN->value:
                     if($authentication instanceof AccessToken)
                     {
                         $headers[] = 'Private-Token: ' . $authentication->getAccessToken();
                         break;
                     }
 
-                    throw new AuthenticationException(sprintf('Invalid authentication type for Access Token, got %s instead', $authentication->getAuthenticationType()));
+                    throw new AuthenticationException(sprintf('Invalid authentication type for Access Token, got %s instead', $authentication->getAuthenticationType()->value));
 
-                case AuthenticationType::USERNAME_PASSWORD:
+                case AuthenticationType::USERNAME_PASSWORD->value:
                     if($authentication instanceof UsernamePassword)
                     {
                         curl_setopt($curl, CURLOPT_USERPWD, $authentication->getUsername() . ':' . $authentication->getPassword());
                         break;
                     }
 
-                    throw new AuthenticationException(sprintf('Invalid authentication type for Username/Password, got %s instead', $authentication->getAuthenticationType()));
+                    throw new AuthenticationException(sprintf('Invalid authentication type for Username/Password, got %s instead', $authentication->getAuthenticationType()->value));
             }
 
             return $headers;

src/ncc/Classes/NccExtension/ConstantCompiler.php

@@ -22,8 +22,10 @@
 
     namespace ncc\Classes\NccExtension;
 
+    use InvalidArgumentException;
     use ncc\Enums\SpecialConstants\BuildConstants;
     use ncc\Enums\SpecialConstants\DateTimeConstants;
+    use ncc\Enums\SpecialConstants\GeneralConstants;
     use ncc\Enums\SpecialConstants\InstallConstants;
     use ncc\Enums\SpecialConstants\AssemblyConstants;
     use ncc\Enums\SpecialConstants\RuntimeConstants;
@@ -47,6 +49,67 @@
             $input = self::compileBuildConstants($input);
             $input = self::compileDateTimeConstants($input, time());
             $input = self::compileRuntimeConstants($input);
+            $input = self::compileGeneralConstants($input, $project_configuration);
+
+            return $input;
+        }
+
+
+        /**
+         * Compiles general constants from the given input string based on the provided project configuration.
+         *
+         * @param string|null $input The input string containing constants to be compiled.
+         * @param ProjectConfiguration $project_configuration The project configuration used to resolve constants.
+         * @return string|null The input string with constants replaced, or null if the input was null.
+         */
+        public static function compileGeneralConstants(?string $input, ProjectConfiguration $project_configuration): ?string
+        {
+            if ($input === null)
+            {
+                return null;
+            }
+
+            // Replace %DEFAULT_BUILD_CONFIGURATION%
+            $input = str_replace(
+                [
+                    GeneralConstants::DEFAULT_BUILD_CONFIGURATION->value
+                ],
+                [
+                    $project_configuration->getBuild()->getDefaultConfiguration()
+                ],
+                $input
+            );
+
+            if (str_starts_with($input, GeneralConstants::BUILD_OUTPUT_PATH->value))
+            {
+                $build_name = null;
+                if (preg_match('/' . preg_quote(GeneralConstants::BUILD_OUTPUT_PATH->value, '/') . ':(\S+)/', $input, $matches))
+                {
+                    $build_name = $matches[1];
+                }
+
+                if ($build_name === null)
+                {
+                    Console::outWarning(sprintf("Cannot compile constant %s because it's not valid, usage: %%CONSTANT%%:<name>", $input));
+                }
+                else
+                {
+                    try
+                    {
+                        $output_path = $project_configuration->getBuild()->getBuildConfiguration($build_name)->getOutput();
+                        $input = preg_replace(
+                            '/' . preg_quote(GeneralConstants::BUILD_OUTPUT_PATH->value, '/') . ':\S+/',
+                            $output_path,
+                            $input,
+                            1
+                        );
+                    }
+                    catch (InvalidArgumentException $e)
+                    {
+                        Console::outError(sprintf("Cannot compile constant %s because it does not point to an existing build configuration name", $input));
+                    }
+                }
+            }
 
             return $input;
         }
@@ -67,10 +130,10 @@
 
             $input = str_replace(
                 [
-                    AssemblyConstants::ASSEMBLY_NAME,
+                    AssemblyConstants::ASSEMBLY_NAME->value,
-                    AssemblyConstants::ASSEMBLY_PACKAGE,
+                    AssemblyConstants::ASSEMBLY_PACKAGE->value,
-                    AssemblyConstants::ASSEMBLY_VERSION,
+                    AssemblyConstants::ASSEMBLY_VERSION->value,
-                    AssemblyConstants::ASSEMBLY_UID
+                    AssemblyConstants::ASSEMBLY_UID->value,
                 ],
                 [
                     $assembly->getName(),
@@ -81,27 +144,27 @@
 
             if($assembly->getDescription() !== null)
             {
-                $input = str_replace(AssemblyConstants::ASSEMBLY_DESCRIPTION, $assembly->getDescription(), $input);
+                $input = str_replace(AssemblyConstants::ASSEMBLY_DESCRIPTION->value, $assembly->getDescription(), $input);
             }
 
             if($assembly->getCompany() !== null)
             {
-                $input = str_replace(AssemblyConstants::ASSEMBLY_COMPANY, $assembly->getCompany(), $input);
+                $input = str_replace(AssemblyConstants::ASSEMBLY_COMPANY->value, $assembly->getCompany(), $input);
             }
 
             if($assembly->getProduct() !== null)
             {
-                $input = str_replace(AssemblyConstants::ASSEMBLY_PRODUCT, $assembly->getProduct(), $input);
+                $input = str_replace(AssemblyConstants::ASSEMBLY_PRODUCT->value, $assembly->getProduct(), $input);
             }
 
             if($assembly->getCopyright() !== null)
             {
-                $input = str_replace(AssemblyConstants::ASSEMBLY_COPYRIGHT, $assembly->getCopyright(), $input);
+                $input = str_replace(AssemblyConstants::ASSEMBLY_COPYRIGHT->value, $assembly->getCopyright(), $input);
             }
 
             if($assembly->getTrademark() !== null)
             {
-                $input = str_replace(AssemblyConstants::ASSEMBLY_TRADEMARK, $assembly->getTrademark(), $input);
+                $input = str_replace(AssemblyConstants::ASSEMBLY_TRADEMARK->value, $assembly->getTrademark(), $input);
             }
             return $input;
         }
@@ -121,10 +184,10 @@
 
             return str_replace(
                 [
-                    BuildConstants::COMPILE_TIMESTAMP,
+                    BuildConstants::COMPILE_TIMESTAMP->value,
-                    BuildConstants::NCC_BUILD_VERSION,
+                    BuildConstants::NCC_BUILD_VERSION->value,
-                    BuildConstants::NCC_BUILD_FLAGS,
+                    BuildConstants::NCC_BUILD_FLAGS->value,
-                    BuildConstants::NCC_BUILD_BRANCH
+                    BuildConstants::NCC_BUILD_BRANCH->value
                 ],
                 [
                     time(),
@@ -150,10 +213,10 @@
 
             return str_replace(
                 [
-                    InstallConstants::INSTALL_PATH,
+                    InstallConstants::INSTALL_PATH->value,
-                    InstallConstants::INSTALL_PATH_BIN,
+                    InstallConstants::INSTALL_PATH_BIN->value,
-                    InstallConstants::INSTALL_PATH_SRC,
+                    InstallConstants::INSTALL_PATH_SRC->value,
-                    InstallConstants::INSTALL_PATH_DATA
+                    InstallConstants::INSTALL_PATH_DATA->value
                 ],
                 [
                     $installation_paths->getInstallationpath(),
@@ -178,36 +241,36 @@
             }
 
             return str_replace([
-                DateTimeConstants::d,
+                DateTimeConstants::d->value,
-                DateTimeConstants::D,
+                DateTimeConstants::D->value,
-                DateTimeConstants::j,
+                DateTimeConstants::j->value,
-                DateTimeConstants::l,
+                DateTimeConstants::l->value,
-                DateTimeConstants::N,
+                DateTimeConstants::N->value,
-                DateTimeConstants::S,
+                DateTimeConstants::S->value,
-                DateTimeConstants::w,
+                DateTimeConstants::w->value,
-                DateTimeConstants::z,
+                DateTimeConstants::z->value,
-                DateTimeConstants::W,
+                DateTimeConstants::W->value,
-                DateTimeConstants::F,
+                DateTimeConstants::F->value,
-                DateTimeConstants::m,
+                DateTimeConstants::m->value,
-                DateTimeConstants::M,
+                DateTimeConstants::M->value,
-                DateTimeConstants::n,
+                DateTimeConstants::n->value,
-                DateTimeConstants::t,
+                DateTimeConstants::t->value,
-                DateTimeConstants::L,
+                DateTimeConstants::L->value,
-                DateTimeConstants::o,
+                DateTimeConstants::o->value,
-                DateTimeConstants::Y,
+                DateTimeConstants::Y->value,
-                DateTimeConstants::y,
+                DateTimeConstants::y->value,
-                DateTimeConstants::a,
+                DateTimeConstants::a->value,
-                DateTimeConstants::A,
+                DateTimeConstants::A->value,
-                DateTimeConstants::B,
+                DateTimeConstants::B->value,
-                DateTimeConstants::g,
+                DateTimeConstants::g->value,
-                DateTimeConstants::G,
+                DateTimeConstants::G->value,
-                DateTimeConstants::h,
+                DateTimeConstants::h->value,
-                DateTimeConstants::H,
+                DateTimeConstants::H->value,
-                DateTimeConstants::i,
+                DateTimeConstants::i->value,
-                DateTimeConstants::s,
+                DateTimeConstants::s->value,
-                DateTimeConstants::c,
+                DateTimeConstants::c->value,
-                DateTimeConstants::r,
+                DateTimeConstants::r->value,
-                DateTimeConstants::u
+                DateTimeConstants::u->value
             ],
             [
                 date('d', $timestamp),
@@ -257,7 +320,7 @@
 
             if(function_exists('getcwd'))
             {
-                $input = str_replace(RuntimeConstants::CWD, getcwd(), $input);
+                $input = str_replace(RuntimeConstants::CWD->value, getcwd(), $input);
             }
             else
             {
@@ -266,7 +329,7 @@
 
             if(function_exists('getmypid'))
             {
-                $input = str_replace(RuntimeConstants::PID, getmypid(), $input);
+                $input = str_replace(RuntimeConstants::PID->value, getmypid(), $input);
             }
             else
             {
@@ -275,7 +338,7 @@
 
             if(function_exists('getmyuid'))
             {
-                $input = str_replace(RuntimeConstants::UID, getmyuid(), $input);
+                $input = str_replace(RuntimeConstants::UID->value, getmyuid(), $input);
             }
             else
             {
@@ -284,7 +347,7 @@
 
             if(function_exists('getmygid'))
             {
-                $input = str_replace(RuntimeConstants::GID, getmygid(), $input);
+                $input = str_replace(RuntimeConstants::GID->value, getmygid(), $input);
             }
             else
             {
@@ -293,7 +356,7 @@
 
             if(function_exists('get_current_user'))
             {
-                $input = str_replace(RuntimeConstants::USER, get_current_user(), $input);
+                $input = str_replace(RuntimeConstants::USER->value, get_current_user(), $input);
             }
             else
             {

src/ncc/Classes/NccExtension/NccCompiler.php

@@ -59,11 +59,17 @@
          */
         private $project_manager;
 
+        /**
+         * @var array
+         */
+        private $merged_dependencies;
+
         /**
          * @param ProjectManager $project_manager
          */
         public function __construct(ProjectManager $project_manager)
         {
+            $this->merged_dependencies = [];
             $this->project_manager = $project_manager;
         }
 
@@ -87,16 +93,17 @@
          * @throws PathNotFoundException
          * @noinspection UnusedFunctionResultInspection
          */
-        public function build(string $build_configuration=BuildConfigurationValues::DEFAULT, array $options=[]): string
+        public function build(string $build_configuration=BuildConfigurationValues::DEFAULT->value, array $options=[]): string
         {
+            $this->merged_dependencies = [];
             $configuration = $this->project_manager->getProjectConfiguration()->getBuild()->getBuildConfiguration($build_configuration);
             $configuration->setOptions(array_merge($configuration->getOptions(), $options));
-            $static_dependencies = isset($configuration->getOptions()[BuildConfigurationOptions::STATIC_DEPENDENCIES]);
+            $static_dependencies = isset($configuration->getOptions()[BuildConfigurationOptions::STATIC_DEPENDENCIES->value]);
 
-            if(isset($configuration->getOptions()[BuildConfigurationOptions::OUTPUT_FILE]))
+            if(isset($configuration->getOptions()[BuildConfigurationOptions::OUTPUT_FILE->value]))
             {
                 $package_path = ConstantCompiler::compileConstants(
-                    $this->project_manager->getProjectConfiguration(), $configuration->getOptions()[BuildConfigurationOptions::OUTPUT_FILE]
+                    $this->project_manager->getProjectConfiguration(), $configuration->getOptions()[BuildConfigurationOptions::OUTPUT_FILE->value]
                 );
             }
             else
@@ -122,7 +129,7 @@
             }
 
             // Debugging information
-            if(Resolver::checkLogLevel(LogLevel::DEBUG, Main::getLogLevel()))
+            if(LogLevel::DEBUG->checkLogLevel(Main::getLogLevel()))
             {
                 foreach($this->project_manager->getProjectConfiguration()->getAssembly()->toArray() as $prop => $value)
                 {
@@ -164,7 +171,7 @@
 
                 foreach($execution_units as $unit)
                 {
-                    $progress_bar->setMiscText($unit->getExecutionPolicy()->getName());
+                    $progress_bar->setMiscText(basename($unit->getExecutionPolicy()->getName()));
                     //$progress++;
                     //Console::inlineProgressBar($progress, $steps);
                     $package_writer->addExecutionUnit($unit);
@@ -177,7 +184,7 @@
             {
                 //$progress++;
                 //Console::inlineProgressBar($progress, $steps);
-                $progress_bar->setMiscText($component);
+                $progress_bar->setMiscText(basename($component));
                 Console::outVerbose(sprintf('Compiling \'%s\'', $component));
 
                 $this->processComponent($package_writer, $component);
@@ -189,7 +196,7 @@
             {
                 //$progress++;
                 //Console::inlineProgressBar($progress, $steps);
-                $progress_bar->setMiscText($resource);
+                $progress_bar->setMiscText(basename($resource));
                 Console::outVerbose(sprintf('Processing \'%s\'', $resource));
 
                 $this->processResource($package_writer, $resource);
@@ -234,13 +241,14 @@
             /** @noinspection UnusedFunctionResultInspection */
             $package_writer->addDependencyConfiguration($dependency);
 
-            if(!$static)
+            if(!$static || in_array($dependency->getName(), $this->merged_dependencies, true))
             {
                 return;
             }
 
             $entry = (new PackageManager())->getPackageLock()->getVersionEntry($dependency->getName(), $dependency->getVersion());
             $package_writer->merge((new PackageReader($entry->getShadowPackagePath($dependency->getName()))));
+            $this->merged_dependencies[] = $dependency->getName();
 
             foreach($entry->getDependencies() as $sub_dependency)
             {
@@ -261,25 +269,25 @@
         {
             $package_writer = new PackageWriter($path);
 
-            if(isset($build_configuration->getOptions()[BuildConfigurationOptions::COMPRESSION]))
+            if(isset($build_configuration->getOptions()[BuildConfigurationOptions::COMPRESSION->value]))
             {
                 $package_writer->addFlag(PackageFlags::COMPRESSION);
-                switch(strtolower($build_configuration->getOptions()[BuildConfigurationOptions::COMPRESSION]))
+                switch(strtolower($build_configuration->getOptions()[BuildConfigurationOptions::COMPRESSION->value]))
                 {
-                    case BuildConfigurationOptions\CompressionOptions::HIGH:
+                    case BuildConfigurationOptions\CompressionOptions::HIGH->value:
                         $package_writer->addFlag(PackageFlags::HIGH_COMPRESSION);
                         break;
 
-                    case BuildConfigurationOptions\CompressionOptions::MEDIUM:
+                    case BuildConfigurationOptions\CompressionOptions::MEDIUM->value:
                         $package_writer->addFlag(PackageFlags::MEDIUM_COMPRESSION);
                         break;
 
-                    case BuildConfigurationOptions\CompressionOptions::LOW:
+                    case BuildConfigurationOptions\CompressionOptions::LOW->value:
                         $package_writer->addFlag(PackageFlags::LOW_COMPRESSION);
                         break;
 
                     default:
-                        throw new NotSupportedException(sprintf('The compression level \'%s\' is not supported', $build_configuration->getOptions()[BuildConfigurationOptions::COMPRESSION]));
+                        throw new NotSupportedException(sprintf('The compression level \'%s\' is not supported', $build_configuration->getOptions()[BuildConfigurationOptions::COMPRESSION->value]));
                 }
             }
 
@@ -327,29 +335,38 @@
          * @param string $build_configuration
          * @return void
          */
-        public function processMetadata(PackageWriter $package_writer, string $build_configuration=BuildConfigurationValues::DEFAULT): void
+        public function processMetadata(PackageWriter $package_writer, string $build_configuration=BuildConfigurationValues::DEFAULT->value): void
         {
             $metadata = new Metadata($this->project_manager->getProjectConfiguration()->getProject()->getCompiler());
 
             $metadata->addOptions($this->project_manager->getProjectConfiguration()->getBuild()->getOptions($build_configuration));
             $metadata->addOptions($this->project_manager->getProjectConfiguration()->getProject()->getOptions());
+            $metadata->addConstants($this->project_manager->getConstants($build_configuration));
             $metadata->setUpdateSource($this->project_manager->getProjectConfiguration()->getProject()->getUpdateSource());
             $metadata->setMainExecutionPolicy($this->project_manager->getProjectConfiguration()->getBuild()->getMain());
             $metadata->setInstaller($this->project_manager->getProjectConfiguration()->getInstaller());
 
             // Strip out 'output_file' build artifact.
-            if(isset($metadata->getOptions()[BuildConfigurationOptions::OUTPUT_FILE]))
+            if(isset($metadata->getOptions()[BuildConfigurationOptions::OUTPUT_FILE->value]))
             {
-                $metadata->removeOption(BuildConfigurationOptions::OUTPUT_FILE);
+                $metadata->removeOption(BuildConfigurationOptions::OUTPUT_FILE->value);
             }
 
             // Strip out 'static' build artifact, PackageFlags::STATIC_DEPENDENCIES is used instead
             // Making this option redundant.
-            if(isset($metadata->getOptions()[BuildConfigurationOptions::STATIC_DEPENDENCIES]))
+            if(isset($metadata->getOptions()[BuildConfigurationOptions::STATIC_DEPENDENCIES->value]))
             {
-                $metadata->removeOption(BuildConfigurationOptions::STATIC_DEPENDENCIES);
+                $metadata->removeOption(BuildConfigurationOptions::STATIC_DEPENDENCIES->value);
             }
 
+            $compiled_constants = [];
+            foreach($this->project_manager->getConstants() as $constant => $value)
+            {
+                $compiled_constants[$constant] = ConstantCompiler::compileConstants($this->project_manager->getProjectConfiguration(), $value);
+            }
+
+            $metadata->addConstants($compiled_constants);
+
             /** @noinspection UnusedFunctionResultInspection */
             $package_writer->setMetadata($metadata);
         }

src/ncc/Classes/PackageReader.php

@@ -29,8 +29,8 @@
     use ncc\Enums\Flags\PackageFlags;
     use ncc\Enums\PackageDirectory;
     use ncc\Exceptions\ConfigurationException;
+    use ncc\Exceptions\IntegrityException;
     use ncc\Exceptions\IOException;
-    use ncc\Exceptions\NotSupportedException;
     use ncc\Objects\Package\Component;
     use ncc\Objects\Package\ExecutionUnit;
     use ncc\Objects\Package\Metadata;
@@ -84,6 +84,11 @@
          */
         private $package_file;
 
+        /**
+         * @var string
+         */
+        private $package_path;
+
         /**
          * @var array
          */
@@ -102,7 +107,9 @@
                 throw new IOException(sprintf('File \'%s\' does not exist', $file_path));
             }
 
+            $this->package_path = $file_path;
             $this->package_file = fopen($file_path, 'rb');
+
             if($this->package_file === false)
             {
                 throw new IOException(sprintf('Failed to open file \'%s\'', $file_path));
@@ -168,27 +175,38 @@
                 throw new IOException(sprintf('File \'%s\' is not a valid package file (corrupted header)', $file_path), $e);
             }
 
-            if(!isset($this->headers[PackageStructure::FILE_VERSION]))
+            if(!isset($this->headers[PackageStructure::FILE_VERSION->value]))
             {
                 throw new IOException(sprintf('File \'%s\' is not a valid package file (invalid header)', $file_path));
             }
 
             // Seek the data until the end of the package (FF AA 55 F0)
             fseek($this->package_file, $this->data_offset);
+            $buffer = '';
             while(!feof($this->package_file))
             {
-                $buffer = fread($this->package_file, 1024);
+                $current_chunk = fread($this->package_file, 1024);
-                $this->data_length += strlen($buffer);
+                $this->data_length += strlen($current_chunk);
+                $buffer .= $current_chunk;
 
+                // If we detect the end-of-data byte sequence
                 if (($position = strpos($buffer, "\xFF\xAA\x55\xF0")) !== false)
                 {
                     $this->data_length -= strlen($buffer) - $position;
                     $this->package_length += $this->data_length + 4;
                     break;
                 }
+
+                // Check if the buffer is 1MB or larger
+                if(strlen($buffer) > 1048576)
+                {
+                    // Remove the first 512kb of the buffer
+                    $buffer = substr($buffer, 512000);
                 }
 
-            if($this->data_length === null)
+            }
+
+            if($this->data_length === null || $this->data_length === 0)
             {
                 throw new IOException(sprintf('File \'%s\' is not a valid package file (missing end of package)', $file_path));
             }
@@ -213,7 +231,7 @@
          */
         public function getFileVersion(): string
         {
-            return $this->headers[PackageStructure::FILE_VERSION];
+            return $this->headers[PackageStructure::FILE_VERSION->value];
         }
 
         /**
@@ -223,7 +241,7 @@
          */
         public function getFlags(): array
         {
-            return $this->headers[PackageStructure::FLAGS];
+            return $this->headers[PackageStructure::FLAGS->value];
         }
 
         /**
@@ -234,7 +252,7 @@
          */
         public function getFlag(string $name): bool
         {
-            return in_array($name, $this->headers[PackageStructure::FLAGS], true);
+            return in_array($name, $this->headers[PackageStructure::FLAGS->value], true);
         }
 
         /**
@@ -244,7 +262,7 @@
          */
         public function getDirectory(): array
         {
-            return $this->headers[PackageStructure::DIRECTORY];
+            return $this->headers[PackageStructure::DIRECTORY->value];
         }
 
         /**
@@ -255,15 +273,15 @@
          */
         public function get(string $name): string
         {
-            if(!isset($this->headers[PackageStructure::DIRECTORY][$name]))
+            if(!isset($this->headers[PackageStructure::DIRECTORY->value][$name]))
             {
-                throw new RuntimeException(sprintf('File \'%s\' not found in package', $name));
+                throw new RuntimeException(sprintf('File \'%s\' not found in package \'%s\'', $name, $this->package_path));
             }
 
-            $location = explode(':', $this->headers[PackageStructure::DIRECTORY][$name]);
+            $location = explode(':', $this->headers[PackageStructure::DIRECTORY->value][$name]);
             fseek($this->package_file, ($this->data_offset + (int)$location[0]));
 
-            if(in_array(PackageFlags::COMPRESSION, $this->headers[PackageStructure::FLAGS], true))
+            if(in_array(PackageFlags::COMPRESSION->value, $this->headers[PackageStructure::FLAGS->value], true))
             {
                 return gzuncompress(fread($this->package_file, (int)$location[1]));
             }
@@ -279,12 +297,12 @@
          */
         public function getPointer(string $name): array
         {
-            if(!isset($this->headers[PackageStructure::DIRECTORY][$name]))
+            if(!isset($this->headers[PackageStructure::DIRECTORY->value][$name]))
             {
-                throw new RuntimeException(sprintf('Resource \'%s\' not found in package', $name));
+                throw new RuntimeException(sprintf('Resource \'%s\' not found in package \'%s\'', $name, $this->package_path));
             }
 
-            $location = explode(':', $this->headers[PackageStructure::DIRECTORY][$name]);
+            $location = explode(':', $this->headers[PackageStructure::DIRECTORY->value][$name]);
             return [(int)$location[0], (int)$location[1]];
         }
 
@@ -296,7 +314,7 @@
          */
         public function exists(string $name): bool
         {
-            return isset($this->headers[PackageStructure::DIRECTORY][$name]);
+            return isset($this->headers[PackageStructure::DIRECTORY->value][$name]);
         }
 
         /**
@@ -317,22 +335,31 @@
          *
          * @return Assembly
          * @throws ConfigurationException
+         * @throws IntegrityException
          */
         public function getAssembly(): Assembly
         {
-            $directory = sprintf('@%s', PackageDirectory::ASSEMBLY);
+            $directory = sprintf('@%s', PackageDirectory::ASSEMBLY->value);
 
             if(isset($this->cache[$directory]))
             {
                 return $this->cache[$directory];
             }
 
-            if(!isset($this->headers[PackageStructure::DIRECTORY][$directory]))
+            if(!isset($this->headers[PackageStructure::DIRECTORY->value][$directory]))
             {
-                throw new ConfigurationException('Package does not contain an assembly');
+                throw new ConfigurationException(sprintf('Assembly object not found in package \'%s\'', $this->package_path));
             }
 
+            try
+            {
                 $assembly = Assembly::fromArray(ZiProto::decode($this->get($directory)));
+            }
+            catch(Exception $e)
+            {
+                throw new IntegrityException(sprintf('Failed to decode assembly from package \'%s\' using ZiProto: %s', $this->package_path, $e->getMessage()), $e);
+            }
+
             $this->cache[$directory] = $assembly;
             return $assembly;
         }
@@ -342,23 +369,31 @@
          *
          * @return Metadata
          * @throws ConfigurationException
-         * @throws NotSupportedException
+         * @throws IntegrityException
          */
         public function getMetadata(): Metadata
         {
-            $directory = sprintf('@%s', PackageDirectory::METADATA);
+            $directory = sprintf('@%s', PackageDirectory::METADATA->value);
 
             if(isset($this->cache[$directory]))
             {
                 return $this->cache[$directory];
             }
 
-            if(!isset($this->headers[PackageStructure::DIRECTORY][$directory]))
+            if(!isset($this->headers[PackageStructure::DIRECTORY->value][$directory]))
             {
-                throw new ConfigurationException('Package does not contain metadata');
+                throw new ConfigurationException(sprintf('Metadata object not found in package \'%s\'', $this->package_path));
             }
 
+            try
+            {
                 $metadata = Metadata::fromArray(ZiProto::decode($this->get($directory)));
+            }
+            catch(Exception $e)
+            {
+                throw new IntegrityException(sprintf('Failed to decode metadata from package \'%s\' using ZiProto: %s', $this->package_path, $e->getMessage()), $e);
+            }
+
             foreach($this->getFlags() as $flag)
             {
                 $metadata->setOption($flag, true);
@@ -372,22 +407,31 @@
          * Optional. Returns the package's installer
          *
          * @return Installer|null
+         * @throws IntegrityException
          */
         public function getInstaller(): ?Installer
         {
-            $directory = sprintf('@%s', PackageDirectory::INSTALLER);
+            $directory = sprintf('@%s', PackageDirectory::INSTALLER->value);
 
             if(isset($this->cache[$directory]))
             {
                 return $this->cache[$directory];
             }
 
-            if(!isset($this->headers[PackageStructure::DIRECTORY][$directory]))
+            if(!isset($this->headers[PackageStructure::DIRECTORY->value][$directory]))
             {
                 return null;
             }
 
+            try
+            {
                 $installer = Installer::fromArray(ZiProto::decode($this->get($directory)));
+            }
+            catch(Exception $e)
+            {
+                throw new IntegrityException(sprintf('Failed to decode installer from package \'%s\' using ZiProto: %s', $this->package_path, $e->getMessage()), $e);
+            }
+
             $this->cache[$directory] = $installer;
             return $installer;
         }
@@ -400,9 +444,9 @@
         public function getDependencies(): array
         {
             $dependencies = [];
-            $directory = sprintf('@%s:', PackageDirectory::DEPENDENCIES);
+            $directory = sprintf('@%s:', PackageDirectory::DEPENDENCIES->value);
 
-            foreach($this->headers[PackageStructure::DIRECTORY] as $name => $location)
+            foreach($this->headers[PackageStructure::DIRECTORY->value] as $name => $location)
             {
                 if(str_starts_with($name, $directory))
                 {
@@ -419,17 +463,25 @@
          * @param string $name
          * @return Dependency
          * @throws ConfigurationException
+         * @throws IntegrityException
          */
         public function getDependency(string $name): Dependency
         {
-            $dependency_name = sprintf('@%s:%s', PackageDirectory::DEPENDENCIES, $name);
+            $dependency_name = sprintf('@%s:%s', PackageDirectory::DEPENDENCIES->value, $name);
-            if(!isset($this->headers[PackageStructure::DIRECTORY][$dependency_name]))
+            if(!isset($this->headers[PackageStructure::DIRECTORY->value][$dependency_name]))
             {
-                throw new ConfigurationException(sprintf('Dependency \'%s\' not found in package', $name));
+                throw new ConfigurationException(sprintf('Dependency \'%s\' not found in package \'%s\'', $name, $this->package_path));
             }
 
+            try
+            {
                 return Dependency::fromArray(ZiProto::decode($this->get($dependency_name)));
             }
+            catch(Exception $e)
+            {
+                throw new IntegrityException(sprintf('Failed to decode dependency \'%s\' from package \'%s\' using ZiProto: %s', $name, $this->package_path, $e->getMessage()), $e);
+            }
+        }
 
         /**
          * Returns a dependency from the package by pointer
@@ -437,12 +489,19 @@
          * @param int $pointer
          * @param int $length
          * @return Dependency
-         * @throws ConfigurationException
+         * @throws IntegrityException
          */
         public function getDependencyByPointer(int $pointer, int $length): Dependency
+        {
+            try
             {
                 return Dependency::fromArray(ZiProto::decode($this->getByPointer($pointer, $length)));
             }
+            catch(Exception $e)
+            {
+                throw new IntegrityException(sprintf('Failed to decode dependency from pointer \'%s\' with length \'%s\' from package \'%s\' using ZiProto: %s', $pointer, $length, $this->package_path, $e->getMessage()), $e);
+            }
+        }
 
         /**
          * Returns an array of execution units from the package
@@ -452,9 +511,9 @@
         public function getExecutionUnits(): array
         {
             $execution_units = [];
-            $directory = sprintf('@%s:', PackageDirectory::EXECUTION_UNITS);
+            $directory = sprintf('@%s:', PackageDirectory::EXECUTION_UNITS->value);
 
-            foreach($this->headers[PackageStructure::DIRECTORY] as $name => $location)
+            foreach($this->headers[PackageStructure::DIRECTORY->value] as $name => $location)
             {
                 if(str_starts_with($name, $directory))
                 {
@@ -471,17 +530,36 @@
          * @param string $name
          * @return ExecutionUnit
          * @throws ConfigurationException
+         * @throws IntegrityException
          */
         public function getExecutionUnit(string $name): ExecutionUnit
         {
-            $execution_unit_name = sprintf('@%s:%s', PackageDirectory::EXECUTION_UNITS, $name);
+            $execution_unit_name = sprintf('@%s:%s', PackageDirectory::EXECUTION_UNITS->value, $name);
-            if(!isset($this->headers[PackageStructure::DIRECTORY][$execution_unit_name]))
+            if(!isset($this->headers[PackageStructure::DIRECTORY->value][$execution_unit_name]))
             {
-                throw new ConfigurationException(sprintf('Execution unit \'%s\' not found in package', $name));
+                throw new ConfigurationException(sprintf('Execution unit \'%s\' not found in package \'%s\'', $name, $this->package_path));
             }
 
+            try
+            {
                 return ExecutionUnit::fromArray(ZiProto::decode($this->get($execution_unit_name)));
             }
+            catch(Exception $e)
+            {
+                throw new IntegrityException(sprintf('Failed to decode execution unit \'%s\' from package file \'%s\' using ZiProto: %s', $name, $this->package_path, $e->getMessage()), $e);
+            }
+        }
+
+        /**
+         * Checks if an execution unit with the specified name exists in the package.
+         *
+         * @param string $name The name of the execution unit to check.
+         * @return bool True if the execution unit exists, false otherwise.
+         */
+        public function executionUnitExists(string $name): bool
+        {
+            return isset($this->headers[PackageStructure::DIRECTORY->value][sprintf('@%s:%s', PackageDirectory::EXECUTION_UNITS->value, $name)]);
+        }
 
         /**
          * Returns an execution unit from the package by pointer
@@ -489,12 +567,19 @@
          * @param int $pointer
          * @param int $length
          * @return ExecutionUnit
-         * @throws ConfigurationException
+         * @throws IntegrityException
          */
         public function getExecutionUnitByPointer(int $pointer, int $length): ExecutionUnit
+        {
+            try
             {
                 return ExecutionUnit::fromArray(ZiProto::decode($this->getByPointer($pointer, $length)));
             }
+            catch(Exception $e)
+            {
+                throw new IntegrityException(sprintf('Failed to decode execution unit from pointer \'%s\' with length \'%s\' from package \'%s\' using ZiProto: %s', $pointer, $length, $this->package_path, $e->getMessage()), $e);
+            }
+        }
 
         /**
          * Returns the package's component pointers
@@ -504,9 +589,9 @@
         public function getComponents(): array
         {
             $components = [];
-            $directory = sprintf('@%s:', PackageDirectory::COMPONENTS);
+            $directory = sprintf('@%s:', PackageDirectory::COMPONENTS->value);
 
-            foreach($this->headers[PackageStructure::DIRECTORY] as $name => $location)
+            foreach($this->headers[PackageStructure::DIRECTORY->value] as $name => $location)
             {
                 if(str_starts_with($name, $directory))
                 {
@@ -525,9 +610,9 @@
         public function getClassMap(): array
         {
             $class_map = [];
-            $directory = sprintf('@%s:', PackageDirectory::CLASS_POINTER);
+            $directory = sprintf('@%s:', PackageDirectory::CLASS_POINTER->value);
 
-            foreach($this->headers[PackageStructure::DIRECTORY] as $name => $location)
+            foreach($this->headers[PackageStructure::DIRECTORY->value] as $name => $location)
             {
                 if(str_starts_with($name, $directory))
                 {
@@ -544,17 +629,25 @@
          * @param string $name
          * @return Component
          * @throws ConfigurationException
+         * @throws IntegrityException
          */
         public function getComponent(string $name): Component
         {
-            $component_name = sprintf('@%s:%s', PackageDirectory::COMPONENTS, $name);
+            $component_name = sprintf('@%s:%s', PackageDirectory::COMPONENTS->value, $name);
-            if(!isset($this->headers[PackageStructure::DIRECTORY][$component_name]))
+            if(!isset($this->headers[PackageStructure::DIRECTORY->value][$component_name]))
             {
-                throw new ConfigurationException(sprintf('Component \'%s\' not found in package', $name));
+                throw new ConfigurationException(sprintf('Component \'%s\' not found in package \'%s\'', $name, $this->package_path));
             }
 
+            try
+            {
                 return Component::fromArray(ZiProto::decode($this->get($component_name)));
             }
+            catch(Exception $e)
+            {
+                throw new IntegrityException(sprintf('Failed to decode component \'%s\' from package \'%s\' using ZiProto: %s', $name, $this->package_path, $e->getMessage()), $e);
+            }
+        }
 
         /**
          * Returns a component from the package by pointer
@@ -562,12 +655,19 @@
          * @param int $pointer
          * @param int $length
          * @return Component
-         * @throws ConfigurationException
+         * @throws IntegrityException
          */
         public function getComponentByPointer(int $pointer, int $length): Component
+        {
+            try
             {
                 return Component::fromArray(ZiProto::decode($this->getByPointer($pointer, $length)));
             }
+            catch(Exception $e)
+            {
+                throw new IntegrityException(sprintf('Failed to decode component from pointer \'%s\' with length \'%s\' from package \'%s\' using ZiProto: %s', $pointer, $length, $this->package_path, $e->getMessage()), $e);
+            }
+        }
 
         /**
          * Returns a component from the package by a class pointer
@@ -575,17 +675,25 @@
          * @param string $class
          * @return Component
          * @throws ConfigurationException
+         * @throws IntegrityException
          */
         public function getComponentByClass(string $class): Component
         {
-            $class_name = sprintf('@%s:%s', PackageDirectory::CLASS_POINTER, $class);
+            $class_name = sprintf('@%s:%s', PackageDirectory::CLASS_POINTER->value, $class);
-            if(!isset($this->headers[PackageStructure::DIRECTORY][$class_name]))
+            if(!isset($this->headers[PackageStructure::DIRECTORY->value][$class_name]))
             {
-                throw new ConfigurationException(sprintf('Class map \'%s\' not found in package', $class));
+                throw new ConfigurationException(sprintf('Class map \'%s\' not found in package \'%s\'', $class, $this->package_path));
             }
 
+            try
+            {
                 return Component::fromArray(ZiProto::decode($this->get($class_name)));
             }
+            catch(Exception $e)
+            {
+                throw new IntegrityException(sprintf('Failed to decode component from class pointer \'%s\' from package \'%s\' using ZiProto: %s', $class, $this->package_path, $e->getMessage()), $e);
+            }
+        }
 
         /**
          * Returns an array of resource pointers from the package
@@ -595,9 +703,9 @@
         public function getResources(): array
         {
             $resources = [];
-            $directory = sprintf('@%s:', PackageDirectory::RESOURCES);
+            $directory = sprintf('@%s:', PackageDirectory::RESOURCES->value);
 
-            foreach($this->headers[PackageStructure::DIRECTORY] as $name => $location)
+            foreach($this->headers[PackageStructure::DIRECTORY->value] as $name => $location)
             {
                 if(str_starts_with($name, $directory))
                 {
@@ -614,17 +722,25 @@
          * @param string $name
          * @return Resource
          * @throws ConfigurationException
+         * @throws IntegrityException
          */
         public function getResource(string $name): Resource
         {
-            $resource_name = sprintf('@%s:%s', PackageDirectory::RESOURCES, $name);
+            $resource_name = sprintf('@%s:%s', PackageDirectory::RESOURCES->value, $name);
-            if(!isset($this->headers[PackageStructure::DIRECTORY][$resource_name]))
+            if(!isset($this->headers[PackageStructure::DIRECTORY->value][$resource_name]))
             {
-                throw new ConfigurationException(sprintf('Resource \'%s\' not found in package', $name));
+                throw new ConfigurationException(sprintf('Resource \'%s\' not found in package \'%s\'', $name, $this->package_path));
             }
 
+            try
+            {
                 return Resource::fromArray(ZiProto::decode($this->get($resource_name)));
             }
+            catch(Exception $e)
+            {
+                throw new IntegrityException(sprintf('Failed to decode resource \'%s\' from package \'%s\' using ZiProto: %s', $name, $this->package_path, $e->getMessage()), $e);
+            }
+        }
 
         /**
          * Returns a resource from the package by pointer
@@ -632,12 +748,19 @@
          * @param int $pointer
          * @param int $length
          * @return Resource
-         * @throws ConfigurationException
+         * @throws IntegrityException
          */
         public function getResourceByPointer(int $pointer, int $length): Resource
+        {
+            try
             {
                 return Resource::fromArray(ZiProto::decode($this->getByPointer($pointer, $length)));
             }
+            catch(Exception $e)
+            {
+                throw new IntegrityException(sprintf('Failed to decode resource from pointer \'%s\' with length \'%s\' from package \'%s\' using ZiProto: %s', $pointer, $length, $this->package_path, $e->getMessage()), $e);
+            }
+        }
 
         /**
          * Searches the package's directory for a file that matches the given filename
@@ -647,7 +770,7 @@
          */
         public function find(string $filename): string|false
         {
-            foreach($this->headers[PackageStructure::DIRECTORY] as $name => $location)
+            foreach($this->headers[PackageStructure::DIRECTORY->value] as $name => $location)
             {
                 if(str_ends_with($name, $filename))
                 {
@@ -755,7 +878,7 @@
             fseek($this->package_file, $this->package_offset);
             $remaining_bytes = $this->package_length;
 
-            while ($remaining_bytes > 0)
+            while($remaining_bytes > 0)
             {
                 $bytes_to_read = min($remaining_bytes, 4096);
                 $data = fread($this->package_file, $bytes_to_read);

src/ncc/Classes/PackageWriter.php

@@ -25,6 +25,7 @@
 
     namespace ncc\Classes;
 
+    use InvalidArgumentException;
     use ncc\Enums\Flags\PackageFlags;
     use ncc\Enums\PackageDirectory;
     use ncc\Enums\PackageStructure;
@@ -108,9 +109,9 @@
             $this->temp_file = @fopen($this->temporary_path, 'wb'); // Create a temporary data file
             $this->package_file = @fopen($file_path, 'wb');
             $this->headers = [
-                PackageStructure::FILE_VERSION => PackageStructureVersions::_2_0,
+                PackageStructure::FILE_VERSION->value => PackageStructureVersions::_2_0->value,
-                PackageStructure::FLAGS => [],
+                PackageStructure::FLAGS->value => [],
-                PackageStructure::DIRECTORY => []
+                PackageStructure::DIRECTORY->value => []
             ];
 
             if($this->temp_file === false || $this->package_file === false)
@@ -126,7 +127,7 @@
          */
         public function getFileVersion(): string
         {
-            return (string)$this->headers[PackageStructure::FILE_VERSION];
+            return (string)$this->headers[PackageStructure::FILE_VERSION->value];
         }
 
         /**
@@ -137,7 +138,7 @@
          */
         public function setFileVersion(string $version): void
         {
-            $this->headers[PackageStructure::FILE_VERSION] = $version;
+            $this->headers[PackageStructure::FILE_VERSION->value] = $version;
         }
 
         /**
@@ -147,13 +148,13 @@
          */
         public function getFlags(): array
         {
-            return (array)$this->headers[PackageStructure::FLAGS];
+            return (array)$this->headers[PackageStructure::FLAGS->value];
         }
 
         /**
          * Sets the package flags
          *
-         * @param array $flags
+         * @param string[]|PackageFlags[] $flags
          * @return void
          * @throws IOException
          */
@@ -164,26 +165,47 @@
                 throw new IOException('Cannot set flags after data has been written to the package');
             }
 
-            $this->headers[PackageStructure::FLAGS] = $flags;
+            foreach($flags as $flag)
+            {
+                if(is_string($flag))
+                {
+                    $flag = PackageFlags::tryFrom($flag);
+                    if($flag === null)
+                    {
+                        throw new InvalidArgumentException(sprintf('Unexpected flag: %s', $flag));
+                    }
+                }
+
+                $this->headers[PackageStructure::FLAGS->value] = $flag->value;
+            }
         }
 
         /**
          * Adds a flag to the package
          *
-         * @param string $flag
+         * @param PackageFlags|string $flag
          * @return void
          * @throws IOException
          */
-        public function addFlag(string $flag): void
+        public function addFlag(PackageFlags|string $flag): void
         {
+            if(is_string($flag))
+            {
+                $flag = PackageFlags::tryFrom($flag);
+                if($flag === null)
+                {
+                    throw new InvalidArgumentException(sprintf('Unexpected flag: %s', $flag));
+                }
+            }
+
             if($this->data_written)
             {
                 throw new IOException('Cannot add a flag after data has been written to the package');
             }
 
-            if(!in_array($flag, $this->headers[PackageStructure::FLAGS], true))
+            if(!in_array($flag, $this->headers[PackageStructure::FLAGS->value], true))
             {
-                $this->headers[PackageStructure::FLAGS][] = $flag;
+                $this->headers[PackageStructure::FLAGS->value][] = $flag->value;
             }
         }
 
@@ -194,14 +216,23 @@
          * @return void
          * @throws IOException
          */
-        public function removeFlag(string $flag): void
+        public function removeFlag(PackageFlags|string $flag): void
         {
+            if(is_string($flag))
+            {
+                $flag = PackageFlags::tryFrom($flag);
+                if($flag === null)
+                {
+                    throw new InvalidArgumentException(sprintf('Unexpected flag: %s', $flag));
+                }
+            }
+
             if($this->data_written)
             {
                 throw new IOException('Cannot remove a flag after data has been written to the package');
             }
 
-            $this->headers[PackageStructure::FLAGS] = array_diff($this->headers[PackageStructure::FLAGS], [$flag]);
+            $this->headers[PackageStructure::FLAGS->value] = array_diff($this->headers[PackageStructure::FLAGS->value], [$flag->value]);
         }
 
         /**
@@ -213,22 +244,22 @@
          */
         public function add(string $name, string $data): array
         {
-            if(isset($this->headers[PackageStructure::DIRECTORY][$name]))
+            if(isset($this->headers[PackageStructure::DIRECTORY->value][$name]))
             {
-                return explode(':', $this->headers[PackageStructure::DIRECTORY][$name]);
+                return explode(':', $this->headers[PackageStructure::DIRECTORY->value][$name]);
             }
 
-            if(in_array(PackageFlags::COMPRESSION, $this->headers[PackageStructure::FLAGS], true))
+            if(in_array(PackageFlags::COMPRESSION->value, $this->headers[PackageStructure::FLAGS->value], true))
             {
-                if(in_array(PackageFlags::LOW_COMPRESSION, $this->headers[PackageStructure::FLAGS], true))
+                if(in_array(PackageFlags::LOW_COMPRESSION->value, $this->headers[PackageStructure::FLAGS->value], true))
                 {
                     $data = gzcompress($data, 1);
                 }
-                else if(in_array(PackageFlags::MEDIUM_COMPRESSION, $this->headers[PackageStructure::FLAGS], true))
+                else if(in_array(PackageFlags::MEDIUM_COMPRESSION->value, $this->headers[PackageStructure::FLAGS->value], true))
                 {
                     $data = gzcompress($data, 6);
                 }
-                else if(in_array(PackageFlags::HIGH_COMPRESSION, $this->headers[PackageStructure::FLAGS], true))
+                else if(in_array(PackageFlags::HIGH_COMPRESSION->value, $this->headers[PackageStructure::FLAGS->value], true))
                 {
                     $data = gzcompress($data, 9);
                 }
@@ -239,7 +270,7 @@
             }
 
             $pointer = sprintf("%d:%d", ftell($this->temp_file), strlen($data));
-            $this->headers[PackageStructure::DIRECTORY][$name] = $pointer;
+            $this->headers[PackageStructure::DIRECTORY->value][$name] = $pointer;
             $this->data_written = true;
             fwrite($this->temp_file, $data);
 
@@ -256,12 +287,12 @@
          */
         public function addPointer(string $name, int $offset, int $length): void
         {
-            if(isset($this->headers[PackageStructure::DIRECTORY][$name]))
+            if(isset($this->headers[PackageStructure::DIRECTORY->value][$name]))
             {
                 return;
             }
 
-            $this->headers[PackageStructure::DIRECTORY][$name] = sprintf("%d:%d", $offset, $length);
+            $this->headers[PackageStructure::DIRECTORY->value][$name] = sprintf("%d:%d", $offset, $length);
         }
 
         /**
@@ -272,7 +303,7 @@
          */
         public function setAssembly(Assembly $assembly): array
         {
-            return $this->add(sprintf('@%s', PackageDirectory::ASSEMBLY), ZiProto::encode($assembly->toArray(true)));
+            return $this->add(sprintf('@%s', PackageDirectory::ASSEMBLY->value), ZiProto::encode($assembly->toArray(true)));
         }
 
         /**
@@ -283,7 +314,7 @@
          */
         public function setMetadata(Metadata $metadata): array
         {
-            return $this->add(sprintf('@%s', PackageDirectory::METADATA), ZiProto::encode($metadata->toArray(true)));
+            return $this->add(sprintf('@%s', PackageDirectory::METADATA->value), ZiProto::encode($metadata->toArray(true)));
         }
 
         /**
@@ -294,7 +325,7 @@
          */
         public function setInstaller(Installer $installer): array
         {
-            return $this->add(sprintf('@%s', PackageDirectory::INSTALLER), ZiProto::encode($installer->toArray(true)));
+            return $this->add(sprintf('@%s', PackageDirectory::INSTALLER->value), ZiProto::encode($installer->toArray(true)));
         }
 
         /**
@@ -305,7 +336,7 @@
          */
         public function addDependencyConfiguration(Dependency $dependency): array
         {
-            return $this->add(sprintf('@%s:%s', PackageDirectory::DEPENDENCIES, $dependency->getName()), ZiProto::encode($dependency->toArray(true)));
+            return $this->add(sprintf('@%s:%s', PackageDirectory::DEPENDENCIES->value, $dependency->getName()), ZiProto::encode($dependency->toArray(true)));
         }
 
         /**
@@ -316,7 +347,7 @@
          */
         public function addExecutionUnit(ExecutionUnit $unit): array
         {
-            return $this->add(sprintf('@%s:%s', PackageDirectory::EXECUTION_UNITS, $unit->getExecutionPolicy()->getName()), ZiProto::encode($unit->toArray(true)));
+            return $this->add(sprintf('@%s:%s', PackageDirectory::EXECUTION_UNITS->value, $unit->getExecutionPolicy()->getName()), ZiProto::encode($unit->toArray(true)));
         }
 
         /**
@@ -327,7 +358,7 @@
          */
         public function addComponent(Component $component): array
         {
-            return $this->add(sprintf('@%s:%s', PackageDirectory::COMPONENTS, $component->getName()), ZiProto::encode($component->toArray(true)));
+            return $this->add(sprintf('@%s:%s', PackageDirectory::COMPONENTS->value, $component->getName()), ZiProto::encode($component->toArray(true)));
         }
 
         /**
@@ -338,7 +369,7 @@
          */
         public function addResource(Resource $resource): array
         {
-            return $this->add(sprintf('@%s:%s', PackageDirectory::RESOURCES, $resource->getName()), ZiProto::encode($resource->toArray(true)));
+            return $this->add(sprintf('@%s:%s', PackageDirectory::RESOURCES->value, $resource->getName()), ZiProto::encode($resource->toArray(true)));
         }
 
         /**
@@ -351,7 +382,7 @@
          */
         public function mapClass(string $class, int $offset, int $length): void
         {
-            $this->addPointer(sprintf('@%s:%s', PackageDirectory::CLASS_POINTER, $class), $offset, $length);
+            $this->addPointer(sprintf('@%s:%s', PackageDirectory::CLASS_POINTER->value, $class), $offset, $length);
         }
 
         /**
@@ -372,10 +403,10 @@
 
                 switch((int)substr(explode(':', $name, 2)[0], 1))
                 {
-                    case PackageDirectory::METADATA:
+                    case PackageDirectory::METADATA->value:
-                    case PackageDirectory::ASSEMBLY:
+                    case PackageDirectory::ASSEMBLY->value:
-                    case PackageDirectory::INSTALLER:
+                    case PackageDirectory::INSTALLER->value:
-                    case PackageDirectory::EXECUTION_UNITS:
+                    case PackageDirectory::EXECUTION_UNITS->value:
                         Console::outDebug(sprintf('Skipping %s', $name));
                         break;
 

src/ncc/Classes/PackagistExtension/PackagistRepository.php

@@ -35,9 +35,10 @@
     use ncc\Interfaces\RepositoryInterface;
     use ncc\Objects\RepositoryConfiguration;
     use ncc\Objects\RepositoryResult;
-    use ncc\ThirdParty\composer\Semver\Comparator;
+    use ncc\ThirdParty\composer\semver\Comparator;
-    use ncc\ThirdParty\composer\Semver\Semver;
+    use ncc\ThirdParty\composer\semver\Semver;
     use ncc\Utilities\Console;
+    use ncc\Utilities\Resolver;
     use ncc\Utilities\RuntimeCache;
     use RuntimeException;
 
@@ -46,9 +47,9 @@
         /**
          * @inheritDoc
          */
-        public static function fetchSourceArchive(RepositoryConfiguration $repository, string $vendor, string $project, string $version = Versions::LATEST, ?AuthenticationType $authentication = null, array $options=[]): RepositoryResult
+        public static function fetchSourceArchive(RepositoryConfiguration $repository, string $vendor, string $project, string $version = Versions::LATEST->value, ?AuthenticationType $authentication = null, array $options=[]): RepositoryResult
         {
-            if($version === Versions::LATEST)
+            if($version === Versions::LATEST->value)
             {
                 $version = self::getLatestVersion($repository, $vendor, $project);
             }
@@ -70,9 +71,16 @@
                     'User-Agent: ncc'
                 ];
 
+                $resolved_host = Resolver::getResolveOption($endpoint);
+
+                if($resolved_host !== null)
+                {
+                    curl_setopt($curl, CURLOPT_RESOLVE, [$resolved_host]);
+                }
+
                 curl_setopt_array($curl, [
                     CURLOPT_RETURNTRANSFER => true,
-                    CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                    CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                     CURLOPT_HTTPHEADER => $headers
                 ]);
 
@@ -91,14 +99,14 @@
                 throw new NetworkException(sprintf('Invalid response from %s/%s, version %s does not have a dist URL', $vendor, $project, $version));
             }
 
-            return new RepositoryResult($response['package']['versions'][$version]['dist']['url'], RepositoryResultType::SOURCE, $version);
+            return new RepositoryResult($response['package']['versions'][$version]['dist']['url'], RepositoryResultType::SOURCE->value, $version);
         }
 
         /**
          * @inheritDoc
          * @throws NotSupportedException
          */
-        public static function fetchPackage(RepositoryConfiguration $repository, string $vendor, string $project, string $version = Versions::LATEST, ?AuthenticationType $authentication = null, array $options=[]): RepositoryResult
+        public static function fetchPackage(RepositoryConfiguration $repository, string $vendor, string $project, string $version = Versions::LATEST->value, ?AuthenticationType $authentication = null, array $options=[]): RepositoryResult
         {
             throw new NotSupportedException('Fetching ncc packages from Packagist is not supported');
         }
@@ -130,9 +138,16 @@
                     'User-Agent: ncc'
                 ];
 
+                $resolved_host = Resolver::getResolveOption($endpoint);
+
+                if($resolved_host !== null)
+                {
+                    curl_setopt($curl, CURLOPT_RESOLVE, [$resolved_host]);
+                }
+
                 curl_setopt_array($curl, [
                     CURLOPT_RETURNTRANSFER => true,
-                    CURLOPT_CUSTOMREQUEST => HttpRequestType::GET,
+                    CURLOPT_CUSTOMREQUEST => HttpRequestType::GET->value,
                     CURLOPT_HTTPHEADER => $headers
                 ]);
 
@@ -163,23 +178,21 @@
         {
             $versions = self::getVersions($repository, $vendor, $project);
 
-            /** @noinspection KeysFragmentationWithArrayFunctionsInspection */
+            // Filter out pre-release versions such as alpha, beta, rc, dev
             $versions = array_filter($versions, static function($version)
             {
                 return !preg_match('/-alpha|-beta|-rc|dev/i', $version);
             });
 
-            usort($versions, static function($a, $b)
+            // Sort versions in descending order using Semver::rsort
-            {
+            $versions = Semver::rsort($versions);
-                return Comparator::lessThanOrEqualTo($a, $b) ? 1 : -1;
-            });
 
-            if($versions[0] === null)
+            if (!isset($versions[0]))
             {
                 throw new NetworkException(sprintf('Failed to resolve latest version for %s/%s', $vendor, $project));
             }
 
-            return $versions[0];
+            return $versions[0]; // The first version in the sorted array is the latest
         }
 
         /**

src/ncc/Classes/PhpExtension/AstWalker.php

@@ -31,27 +31,6 @@
 
     class AstWalker
     {
-        /**
-         * Returns an array representation of the node recursively
-         *
-         * @param array|Node $node
-         * @return array
-         */
-        public static function serialize(array|Node $node): array
-        {
-            if(is_array($node))
-            {
-                $serialized = [];
-                foreach($node as $sub_node)
-                {
-                    $serialized[] = $sub_node->jsonSerialize();
-                }
-                return $serialized;
-            }
-
-            return $node->jsonSerialize();
-        }
-
         /**
          * Returns an array of classes associated with the node recursively
          *
@@ -112,161 +91,4 @@
 
             return $classes;
         }
-
-        /**
-         * Reconstructs nodes from an array representation recursively
-         *
-         * @param $value
-         * @return array|Comment|Node
-         * @noinspection PhpMissingReturnTypeInspection
-         * @throws ReflectionException
-         */
-        public static function decodeRecursive($value)
-        {
-            if (is_array($value))
-            {
-                if (isset($value['nodeType']))
-                {
-                    if ($value['nodeType'] === 'Comment' || $value['nodeType'] === 'Comment_Doc')
-                    {
-                        return self::decodeComment($value);
-                    }
-
-                    return self::decodeNode($value);
-                }
-
-                return self::decodeArray($value);
-            }
-
-            return $value;
-        }
-
-        /**
-         * Decodes an array by recursively decoding each value
-         *
-         * @param array $array
-         * @return array
-         * @throws ReflectionException
-         */
-        private static function decodeArray(array $array) : array
-        {
-            $decoded_array = [];
-
-            foreach ($array as $key => $value)
-            {
-                $decoded_array[$key] = self::decodeRecursive($value);
-            }
-
-            return $decoded_array;
-        }
-
-        /**
-         * Returns the node from the node type
-         *
-         * @param array $value
-         * @return Node
-         * @throws ReflectionException
-         */
-        private static function decodeNode(array $value) : Node
-        {
-            $node_type = $value['nodeType'];
-            if (!is_string($node_type))
-            {
-                throw new RuntimeException('Node type must be a string');
-            }
-
-            /** @var Node $node */
-            $node = self::reflectionClassFromNodeType($node_type)->newInstanceWithoutConstructor();
-
-            if (isset($value['attributes'])) {
-                if (!is_array($value['attributes']))
-                {
-                    throw new RuntimeException('Attributes must be an array');
-                }
-
-                $node->setAttributes(self::decodeArray($value['attributes']));
-            }
-
-            foreach ($value as $name => $sub_node) {
-                if ($name === 'nodeType' || $name === 'attributes')
-                {
-                    continue;
-                }
-
-                $node->$name = self::decodeRecursive($sub_node);
-            }
-
-            return $node;
-        }
-
-        /**
-         * Returns the comment from the node type
-         *
-         * @param array $value
-         * @return Comment
-         */
-        private static function decodeComment(array $value): Comment
-        {
-            $class_name = $value['nodeType'] === 'Comment' ? Comment::class : Comment\Doc::class;
-            if (!isset($value['text']))
-            {
-                throw new RuntimeException('Comment must have text');
-            }
-
-            return new $class_name(
-                $value['text'],
-                $value['line'] ?? -1, $value['filePos'] ?? -1, $value['tokenPos'] ?? -1,
-                $value['endLine'] ?? -1, $value['endFilePos'] ?? -1, $value['endTokenPos'] ?? -1
-            );
-        }
-
-        /**
-         * Returns the reflection class from the node type
-         *
-         * @param string $node_type
-         * @return ReflectionClass
-         * @throws ReflectionException
-         */
-        private static function reflectionClassFromNodeType(string $node_type): ReflectionClass
-        {
-            return new ReflectionClass(self::classNameFromNodeType($node_type));
-        }
-
-        /**
-         * Returns the class name from the node type
-         *
-         * @param string $nodeType
-         * @return string
-         */
-        private static function classNameFromNodeType(string $nodeType): string
-        {
-            $class_name = 'ncc\\ThirdParty\\nikic\\PhpParser\\Node\\' . str_replace('_', '\\', $nodeType);
-            if (class_exists($class_name))
-            {
-                return $class_name;
-            }
-
-            $class_name .= '_';
-            if (class_exists($class_name))
-            {
-                return $class_name;
-            }
-
-            throw new RuntimeException("Unknown node type \"$nodeType\"");
-        }
-
-        /**
-         * Transforms include, include_once, require and require_once statements into function calls.
-         *
-         * @param Node|array $stmts The AST node or array of nodes to transform.
-         * @param string|null $package Optionally. The package name to pass to the transformed function calls.
-         * @return Node|array The transformed AST node or array of nodes.
-         */
-        public static function transformRequireCalls(Node|array $stmts, ?string $package=null): Node|array
-        {
-            $traverser = new NodeTraverser();
-            $traverser->addVisitor(new ExpressionTraverser($package));
-
-            return $traverser->traverse($stmts);
-        }
     }

src/ncc/Classes/PhpExtension/ExecutableCompiler.php

@@ -41,7 +41,7 @@
          * @inheritDoc
          * @throws BuildException
          */
-        public function build(string $build_configuration = BuildConfigurationValues::DEFAULT, array $options=[]): string
+        public function build(string $build_configuration = BuildConfigurationValues::DEFAULT->value, array $options=[]): string
         {
             $configuration = $this->getProjectManager()->getProjectConfiguration()->getBuild()->getBuildConfiguration($build_configuration);
 
@@ -50,14 +50,14 @@
                 $configuration->setOptions(array_merge($configuration->getOptions(), $options));
             }
 
-            if(!isset($configuration->getOptions()[BuildConfigurationOptions::NCC_CONFIGURATION]))
+            if(!isset($configuration->getOptions()[BuildConfigurationOptions::NCC_CONFIGURATION->value]))
             {
                 throw new BuildException(sprintf("Unable to compile the binary, the build configuration '%s' does not have a ncc_configuration.", $build_configuration));
             }
 
             // Build the ncc package first
             Console::outVerbose('Building ncc package.');
-            $ncc_package = parent::build($configuration->getOptions()[BuildConfigurationOptions::NCC_CONFIGURATION]);
+            $ncc_package = parent::build($configuration->getOptions()[BuildConfigurationOptions::NCC_CONFIGURATION->value]);
 
             // Prepare the ncc package for compilation
             $hex_dump_file = PathFinder::getCachePath() . DIRECTORY_SEPARATOR . $this->getProjectManager()->getProjectConfiguration()->getAssembly()->getName() . '.c';
@@ -72,11 +72,11 @@
             // Prepare the gcc command
             $gcc_path = (new ExecutableFinder())->find('gcc');
 
-            if(isset($configuration->getOptions()[BuildConfigurationOptions::OUTPUT_FILE]))
+            if(isset($configuration->getOptions()[BuildConfigurationOptions::OUTPUT_FILE->value]))
             {
                 $binary_path = ConstantCompiler::compileConstants(
                     $this->getProjectManager()->getProjectConfiguration(),
-                    $configuration->getOptions()[BuildConfigurationOptions::OUTPUT_FILE]
+                    $configuration->getOptions()[BuildConfigurationOptions::OUTPUT_FILE->value]
                 );
             }
             else
@@ -84,6 +84,12 @@
                 $binary_path = ConstantCompiler::compileConstants($this->getProjectManager()->getProjectConfiguration(), $configuration->getOutput());
             }
 
+            // Create the directory recursively if it does not exist
+            if(!is_dir(dirname($binary_path)))
+            {
+                mkdir(dirname($binary_path), 0777, true);
+            }
+
             if($gcc_path === null)
             {
                 throw new BuildException("Unable to find gcc executable, please make sure it is installed and in your PATH environment variable.");

src/ncc/Classes/PhpExtension/NccCompiler.php

@@ -30,7 +30,9 @@
     use ncc\Exceptions\PathNotFoundException;
     use ncc\Extensions\ZiProto\ZiProto;
     use ncc\Objects\Package\Component;
+    use ncc\ThirdParty\nikic\PhpParser\NodeDumper;
     use ncc\ThirdParty\nikic\PhpParser\ParserFactory;
+    use ncc\ThirdParty\nikic\PhpParser\PhpVersion;
     use ncc\Utilities\Base64;
     use ncc\Utilities\Console;
     use ncc\Utilities\Functions;
@@ -52,13 +54,9 @@
 
             try
             {
-                $stmts = (new ParserFactory())->create(ParserFactory::PREFER_PHP7)->parse(IO::fread($file_path));
+                $stmts = ((new ParserFactory())->createForNewestSupportedVersion())->parse(IO::fread($file_path));
-                $stmts = AstWalker::transformRequireCalls(
+                $component = new Component($component_name, ZiProto::encode(Serializer::nodesToArray($stmts)), ComponentDataType::AST);
-                    $stmts, $this->getProjectManager()->getProjectConfiguration()->getAssembly()->getPackage()
+                $component->addFlag(ComponentFlags::PHP_AST->value);
-                );
-
-                $component = new Component($component_name, ZiProto::encode($stmts), ComponentDataType::AST);
-                $component->addFlag(ComponentFlags::PHP_AST);
                 $pointer = $package_writer->addComponent($component);
 
                 foreach(AstWalker::extractClasses($stmts) as $class)
@@ -74,7 +72,7 @@
             }
 
             $component = new Component($component_name, Base64::encode(IO::fread($file_path)), ComponentDataType::BASE64_ENCODED);
-            $component->addFlag(ComponentFlags::PHP_B64);
+            $component->addFlag(ComponentFlags::PHP_B64->value);
             $package_writer->addComponent($component);
         }
     }

src/ncc/Classes/PhpExtension/PhpRunner.php

@@ -44,7 +44,7 @@
          */
         public static function executeUnit(ExecutionUnit $unit, array $args=[], bool $local=true): int
         {
-            if($unit->getExecutionPolicy()->getRunner() !== Runners::PHP)
+            if($unit->getExecutionPolicy()->getRunner() !== Runners::PHP->value)
             {
                 throw new InvalidArgumentException(sprintf('The execution unit %s is not a php execution unit', $unit->getExecutionPolicy()->getName()));
             }

src/ncc/Classes/PhpExtension/Serializer.php

@@ -0,0 +1,151 @@
+<?php
+/*
+ * Copyright (c) Nosial 2022-2024, all rights reserved.
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+ *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
+ *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
+ *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
+ *  conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
+ *  of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+ *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+ *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ *  DEALINGS IN THE SOFTWARE.
+ *
+ */
+
+namespace ncc\Classes\PhpExtension;
+
+use ncc\ThirdParty\nikic\PhpParser\Comment;
+use ncc\ThirdParty\nikic\PhpParser\Node;
+use ncc\ThirdParty\nikic\PhpParser\NodeAbstract;
+use ReflectionClass;
+use RuntimeException;
+use function is_array;
+use function is_string;
+
+class Serializer
+{
+    /** @var ReflectionClass<Node>[] Node type to reflection class map */
+    private static array $reflectionClassCache;
+
+    /**
+     * @param NodeAbstract[] $nodeAbstracts
+     * @return array
+     */
+    public static function nodesToArray(array $nodeAbstracts): array
+    {
+        $serialized = [];
+
+        foreach ($nodeAbstracts as $nodeAbstract)
+        {
+            $serialized[] = $nodeAbstract->jsonSerialize();
+        }
+
+        return $serialized;
+    }
+
+    /**
+     * @param array $nodeAbstracts
+     * @return NodeAbstract[]
+     */
+    public static function arrayToNodes(array $nodeAbstracts): array
+    {
+        return self::decodeRecursive($nodeAbstracts);
+    }
+
+    /**
+     * @param mixed $value
+     * @return mixed
+     */
+    private static function decodeRecursive($value) {
+        if (is_array($value)) {
+            if (isset($value['nodeType'])) {
+                if ($value['nodeType'] === 'Comment' || $value['nodeType'] === 'Comment_Doc') {
+                    return self::decodeComment($value);
+                }
+                return self::decodeNode($value);
+            }
+            return self::decodeArray($value);
+        }
+        return $value;
+    }
+
+    private static function decodeArray(array $array): array {
+        $decodedArray = [];
+        foreach ($array as $key => $value) {
+            $decodedArray[$key] = self::decodeRecursive($value);
+        }
+        return $decodedArray;
+    }
+
+    private static function decodeNode(array $value): Node {
+        $nodeType = $value['nodeType'];
+        if (!is_string($nodeType)) {
+            throw new RuntimeException('Node type must be a string');
+        }
+
+        $reflectionClass = self::reflectionClassFromNodeType($nodeType);
+        $node = $reflectionClass->newInstanceWithoutConstructor();
+
+        if (isset($value['attributes'])) {
+            if (!is_array($value['attributes'])) {
+                throw new RuntimeException('Attributes must be an array');
+            }
+
+            $node->setAttributes(self::decodeArray($value['attributes']));
+        }
+
+        foreach ($value as $name => $subNode) {
+            if ($name === 'nodeType' || $name === 'attributes') {
+                continue;
+            }
+
+            $node->$name = self::decodeRecursive($subNode);
+        }
+
+        return $node;
+    }
+
+    private static function decodeComment(array $value): Comment {
+        $className = $value['nodeType'] === 'Comment' ? Comment::class : Comment\Doc::class;
+        if (!isset($value['text'])) {
+            throw new RuntimeException('Comment must have text');
+        }
+
+        return new $className(
+            $value['text'],
+            $value['line'] ?? -1, $value['filePos'] ?? -1, $value['tokenPos'] ?? -1,
+            $value['endLine'] ?? -1, $value['endFilePos'] ?? -1, $value['endTokenPos'] ?? -1
+        );
+    }
+
+    private static function reflectionClassFromNodeType(string $nodeType): ReflectionClass {
+        if (!isset(self::$reflectionClassCache[$nodeType])) {
+            $className = self::classNameFromNodeType($nodeType);
+            self::$reflectionClassCache[$nodeType] = new ReflectionClass($className);
+        }
+        return self::$reflectionClassCache[$nodeType];
+    }
+
+    /** @return class-string<Node> */
+    private static function classNameFromNodeType(string $nodeType): string {
+        $className = '\\ncc\\ThirdParty\\nikic\\PhpParser\\Node\\' . strtr($nodeType, '_', '\\');
+        if (class_exists($className)) {
+            return $className;
+        }
+
+        $className .= '_';
+        if (class_exists($className)) {
+            return $className;
+        }
+
+        throw new RuntimeException("Unknown node type \"$nodeType\"");
+    }
+}

src/ncc/Classes/PhpExtension/Templates/CliTemplate.php

@@ -49,32 +49,31 @@
         public static function applyTemplate(ProjectManager $project_manager): void
         {
             $project_manager->getProjectConfiguration()->addExecutionPolicy(
-                new ExecutionPolicy('main_policy', Runners::PHP, new ExecutionPolicy\Execute('main'))
+                new ExecutionPolicy('main_policy', Runners::PHP->value, new ExecutionPolicy\Execute('main'))
             );
 
             $project_manager->getProjectConfiguration()->getBuild()->setMain('main_policy');
-            $project_manager->getProjectConfiguration()->getProject()->addOption(ProjectOptions::CREATE_SYMLINK, true);
+            $project_manager->getProjectConfiguration()->getProject()->addOption(ProjectOptions::CREATE_SYMLINK->value, true);
 
             // Create the release build configuration
             $release_executable = new BuildConfiguration('release_executable',
-                'build' . DIRECTORY_SEPARATOR . 'release' . DIRECTORY_SEPARATOR . AssemblyConstants::ASSEMBLY_NAME
+                'build' . DIRECTORY_SEPARATOR . 'release' . DIRECTORY_SEPARATOR . AssemblyConstants::ASSEMBLY_NAME->value
             );
-            $release_executable->setBuildType(BuildOutputType::EXECUTABLE);
+            $release_executable->setBuildType(BuildOutputType::EXECUTABLE->value);
-            $release_executable->setOption(BuildConfigurationOptions::NCC_CONFIGURATION, 'release');
+            $release_executable->setOption(BuildConfigurationOptions::NCC_CONFIGURATION->value, 'release');
             $project_manager->getProjectConfiguration()->getBuild()->addBuildConfiguration($release_executable);
 
             // Create the debug build configuration
             $debug_executable = new BuildConfiguration('debug_executable',
-                'build' . DIRECTORY_SEPARATOR . 'debug' . DIRECTORY_SEPARATOR . AssemblyConstants::ASSEMBLY_NAME
+                'build' . DIRECTORY_SEPARATOR . 'debug' . DIRECTORY_SEPARATOR . AssemblyConstants::ASSEMBLY_NAME->value
             );
             $debug_executable->setDefinedConstant('DEBUG', '1');
-            $debug_executable->setBuildType(BuildOutputType::EXECUTABLE);
+            $debug_executable->setBuildType(BuildOutputType::EXECUTABLE->value);
-            $debug_executable->setOption(BuildConfigurationOptions::NCC_CONFIGURATION, 'debug');
+            $debug_executable->setOption(BuildConfigurationOptions::NCC_CONFIGURATION->value, 'debug');
             $project_manager->getProjectConfiguration()->getBuild()->addBuildConfiguration($debug_executable);
 
             self::writeProgramTemplate($project_manager);
             self::writeMainEntryTemplate($project_manager);
-            self::writeMakefileTemplate($project_manager);
 
             $project_manager->save();
         }
@@ -114,22 +113,4 @@
                 )
             );
         }
-
-        /**
-         * Writes the Makefile to the project directory
-         *
-         * @param ProjectManager $project_manager
-         * @return void
-         * @throws IOException
-         * @throws PathNotFoundException
-         */
-        private static function writeMakefileTemplate(ProjectManager $project_manager): void
-        {
-            IO::fwrite(
-                $project_manager->getProjectPath() . DIRECTORY_SEPARATOR . 'Makefile',
-                ConstantCompiler::compileConstants($project_manager->getProjectConfiguration(),
-                    IO::fread(__DIR__ . DIRECTORY_SEPARATOR . 'Makefile.tpl')
-                )
-            );
-        }
     }

src/ncc/Classes/PhpExtension/Templates/CompressedTemplate.php

@@ -0,0 +1,61 @@
+<?php
+    /*
+     * Copyright (c) Nosial 2022-2024, all rights reserved.
+     *
+     *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+     *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
+     *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
+     *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
+     *  conditions:
+     *
+     *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
+     *  of the Software.
+     *
+     *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+     *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+     *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+     *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+     *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+     *  DEALINGS IN THE SOFTWARE.
+     *
+     */
+
+    namespace ncc\Classes\PhpExtension\Templates;
+
+    use ncc\Enums\Options\BuildConfigurationOptions;
+    use ncc\Enums\SpecialConstants\AssemblyConstants;
+    use ncc\Enums\Types\BuildOutputType;
+    use ncc\Exceptions\IOException;
+    use ncc\Interfaces\TemplateInterface;
+    use ncc\Managers\ProjectManager;
+    use ncc\Objects\ProjectConfiguration\Build\BuildConfiguration;
+
+    class CompressedTemplate implements TemplateInterface
+    {
+
+        /**
+         * @inheritDoc
+         * @throws IOException
+         */
+        public static function applyTemplate(ProjectManager $project_manager): void
+        {
+            // Create the release build configuration
+            $release_compressed = new BuildConfiguration('release-compressed',
+                'build' . DIRECTORY_SEPARATOR . 'release' . DIRECTORY_SEPARATOR . AssemblyConstants::ASSEMBLY_PACKAGE->value . '.gz.ncc'
+            );
+            $release_compressed->setBuildType(BuildOutputType::NCC_PACKAGE->value);
+            $release_compressed->setOption(BuildConfigurationOptions::COMPRESSION->value, BuildConfigurationOptions\CompressionOptions::HIGH->value);
+            $project_manager->getProjectConfiguration()->getBuild()->addBuildConfiguration($release_compressed);
+
+            // Create the debug build configuration
+            $debug_compressed = new BuildConfiguration('debug-compressed',
+                'build' . DIRECTORY_SEPARATOR . 'debug' . DIRECTORY_SEPARATOR . AssemblyConstants::ASSEMBLY_PACKAGE->value . '.gz.ncc'
+            );
+            $debug_compressed->setBuildType(BuildOutputType::NCC_PACKAGE->value);
+            $debug_compressed->setOption(BuildConfigurationOptions::COMPRESSION->value, BuildConfigurationOptions\CompressionOptions::HIGH->value);
+            $debug_compressed->setDefinedConstant('DEBUG', '1');
+            $project_manager->getProjectConfiguration()->getBuild()->addBuildConfiguration($debug_compressed);
+
+            $project_manager->save();
+        }
+    }

src/ncc/Classes/PhpExtension/Templates/ExecutableTemplate.php

@@ -0,0 +1,77 @@
+<?php
+    /*
+     * Copyright (c) Nosial 2022-2024, all rights reserved.
+     *
+     *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+     *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
+     *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
+     *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
+     *  conditions:
+     *
+     *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
+     *  of the Software.
+     *
+     *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+     *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+     *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+     *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+     *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+     *  DEALINGS IN THE SOFTWARE.
+     *
+     */
+
+    namespace ncc\Classes\PhpExtension\Templates;
+
+    use ncc\Enums\Options\BuildConfigurationOptions;
+    use ncc\Enums\SpecialConstants\AssemblyConstants;
+    use ncc\Enums\Types\BuildOutputType;
+    use ncc\Exceptions\IOException;
+    use ncc\Interfaces\TemplateInterface;
+    use ncc\Managers\ProjectManager;
+    use ncc\Objects\ProjectConfiguration\Build\BuildConfiguration;
+
+    class ExecutableTemplate implements TemplateInterface
+    {
+
+        /**
+         * @inheritDoc
+         * @throws IOException
+         */
+        public static function applyTemplate(ProjectManager $project_manager): void
+        {
+            foreach($project_manager->getProjectConfiguration()->getBuild()->getBuildConfigurations() as $build_configuration)
+            {
+                $executable_name = sprintf('%s-executable', $build_configuration);
+                $configuration = $project_manager->getProjectConfiguration()->getBuild()->getBuildConfiguration($build_configuration);
+
+                // Skip if the executable version of the build configuration already exists
+                if($project_manager->getProjectConfiguration()->getBuild()->buildConfigurationExists($executable_name))
+                {
+                    continue;
+                }
+
+                // Skip if the build configuration is not an ncc package that the executable can be based on
+                if($configuration->getBuildType() !== BuildOutputType::NCC_PACKAGE->value)
+                {
+                    continue;
+                }
+
+                if(isset($configuration->getOptions()[BuildConfigurationOptions::COMPRESSION->value]))
+                {
+                    $output = dirname($configuration->getOutput()) . DIRECTORY_SEPARATOR . str_replace('-', '_', $executable_name);
+                }
+                else
+                {
+                    $output = dirname($configuration->getOutput()) . DIRECTORY_SEPARATOR . str_replace('-', '_', $executable_name) . '_gz';
+                }
+
+                // Create the executable build configuration
+                $executable = new BuildConfiguration($executable_name, $output);
+                $executable->setBuildType(BuildOutputType::EXECUTABLE->value);
+                $executable->setOption(BuildConfigurationOptions::NCC_CONFIGURATION->value, $configuration->getName());
+                $project_manager->getProjectConfiguration()->getBuild()->addBuildConfiguration($executable);
+            }
+
+            $project_manager->save();
+        }
+    }

src/ncc/Classes/PhpExtension/Templates/GitHubWorkflowTemplate.php

@@ -0,0 +1,117 @@
+<?php
+/*
+ * Copyright (c) Nosial 2022-2024, all rights reserved.
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+ *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
+ *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
+ *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
+ *  conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
+ *  of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+ *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+ *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ *  DEALINGS IN THE SOFTWARE.
+ *
+ */
+
+namespace ncc\Classes\PhpExtension\Templates;
+
+use ncc\Classes\NccExtension\ConstantCompiler;
+use ncc\Exceptions\IOException;
+use ncc\Exceptions\PathNotFoundException;
+use ncc\Managers\ProjectManager;
+use ncc\Utilities\IO;
+
+class GitHubWorkflowTemplate
+{
+    /**
+     * @inheritDoc
+     * @param ProjectManager $project_manager
+     * @throws IOException
+     * @throws PathNotFoundException
+     */
+    public static function applyTemplate(ProjectManager $project_manager): void
+    {
+        self::writeCiTemplate($project_manager);
+    }
+
+    /**
+     * Writes the Makefile to the project directory
+     *
+     * @param ProjectManager $project_manager
+     * @return void
+     * @throws IOException
+     * @throws PathNotFoundException
+     */
+    private static function writeCiTemplate(ProjectManager $project_manager): void
+    {
+        $ci_dir = $project_manager->getProjectPath() . DIRECTORY_SEPARATOR . '.github' . DIRECTORY_SEPARATOR . 'workflows';
+
+        if(!file_exists($ci_dir))
+        {
+            mkdir($ci_dir, 0777, true);
+        }
+
+        $template =  IO::fread(__DIR__ . DIRECTORY_SEPARATOR . 'github_ci.yml.tpl');
+        $default_configuration = $project_manager->getProjectConfiguration()->getBuild()->getDefaultConfiguration();
+        $builds = [];
+        $releases = [];
+        $downloads = [];
+        foreach($project_manager->getProjectConfiguration()->getBuild()->getBuildConfigurations() as $build_name)
+        {
+            $build_template = IO::fread(__DIR__ . DIRECTORY_SEPARATOR . 'github_ci_build.yml.tpl');
+            $build_template = str_replace('%TPL_BUILD_NAME%', $build_name, $build_template);
+            $build_template = str_replace('%TPL_BUILD_OUTPUT%',
+                $project_manager->getProjectConfiguration()->getBuild()->getBuildConfiguration($build_name)->getOutput(),
+                $build_template
+            );
+            $builds[$build_name] = $build_template;
+
+            $download_template = IO::fread(__DIR__ . DIRECTORY_SEPARATOR . 'github_ci_download.yml.tpl');
+            $download_template = str_replace('%TPL_BUILD_NAME%', $build_name, $download_template);
+            $downloads[$build_name] = $download_template;
+
+            $release_template = str_repeat(' ', 12) . $build_name . DIRECTORY_SEPARATOR . basename(
+                $project_manager->getProjectConfiguration()->getBuild()->getBuildConfiguration($build_name)->getOutput()
+            );
+            $releases[$build_name] = $release_template;
+        }
+
+        $build_jobs = '';
+        foreach($builds as $name => $build_template)
+        {
+            $build_jobs .= $build_template . PHP_EOL;
+        }
+
+        $download_jobs = '';
+        foreach($downloads as $name => $download_template)
+        {
+            $download_jobs .= $download_template . PHP_EOL;
+        }
+
+        $release_jobs = '';
+        foreach($releases as $name => $release_template)
+        {
+            $release_jobs .= $release_template . PHP_EOL;
+        }
+
+        $template = str_replace('%TPL_BUILDS%', $build_jobs, $template);
+        $template = str_replace('%TPL_DOWNLOAD_ARTIFACTS%', $download_jobs, $template);
+        $template = str_replace('%TPL_ARTIFACT_FILES%', $release_jobs, $template);
+        $template = str_replace('%TPL_BUILD_NAMES%', implode(', ', array_keys($builds)), $template);
+        $template = str_replace('%TPL_DEFAULT_BUILD_CONFIGURATION%', $default_configuration, $template);
+        $template = str_replace('%TPL_DEFAULT_ARTIFACT_BUILD_OUTPUT%', $default_configuration . DIRECTORY_SEPARATOR . basename(
+                $project_manager->getProjectConfiguration()->getBuild()->getBuildConfiguration($default_configuration)->getOutput()
+        ), $template);
+
+        IO::fwrite($ci_dir . DIRECTORY_SEPARATOR . 'ncc_workflow.yml',
+            ConstantCompiler::compileConstants($project_manager->getProjectConfiguration(), $template)
+        );
+    }
+}

src/ncc/Classes/PhpExtension/Templates/LibraryTemplate.php

@@ -48,8 +48,14 @@
          */
         private static function createClassTemplate(ProjectManager $project_manager): void
         {
+            $class_directory = $project_manager->getProjectSourcePath() . DIRECTORY_SEPARATOR . $project_manager->getProjectConfiguration()->getAssembly()->getName();
+            if(!file_exists($class_directory))
+            {
+                mkdir($class_directory, 0777, true);
+            }
+
             IO::fwrite(
-                $project_manager->getProjectSourcePath() . DIRECTORY_SEPARATOR . $project_manager->getProjectConfiguration()->getAssembly()->getName() . '.php',
+                $class_directory . DIRECTORY_SEPARATOR . $project_manager->getProjectConfiguration()->getAssembly()->getName() . '.php',
                 ConstantCompiler::compileConstants($project_manager->getProjectConfiguration(),
                     IO::fread(__DIR__ . DIRECTORY_SEPARATOR . 'class.php.tpl')
                 )

src/ncc/Classes/PhpExtension/Templates/Makefile.tpl

@@ -1,20 +1,21 @@
 # Variables
-CONFIG ?= release
+DEFAULT_CONFIGURATION ?= %TPL_DEFAULT_BUILD_CONFIGURATION%
 LOG_LEVEL = debug
-OUTDIR = build/$(CONFIG)
-PACKAGE = $(OUTDIR)/%ASSEMBLY.PACKAGE%.ncc
 
 # Default Target
-all: build
+all: %TPL_BUILD_NAMES%
 
 # Build Steps
-build:
+%TPL_BUILDS%
-	ncc build --config=$(CONFIG) --log-level $(LOG_LEVEL)
 
-install:
+install: %TPL_DEFAULT_BUILD_CONFIGURATION%
-	ncc package install --package=$(PACKAGE) --skip-dependencies --reinstall -y --log-level $(LOG_LEVEL)
+	ncc package install --package=%TPL_DEFAULT_BUILD_PATH% --skip-dependencies --build-source --reinstall -y --log-level $(LOG_LEVEL)
+
+test: %TPL_DEFAULT_BUILD_CONFIGURATION%
+	[ -f phpunit.xml ] || { echo "phpunit.xml not found"; exit 1; }
+	phpunit
 
 clean:
 	rm -rf build
 
-.PHONY: all build install clean
+.PHONY: all install test clean %TPL_BUILD_NAMES%

src/ncc/Classes/PhpExtension/Templates/MakefileTemplate.php

@@ -0,0 +1,78 @@
+<?php
+/*
+ * Copyright (c) Nosial 2022-2024, all rights reserved.
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+ *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
+ *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
+ *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
+ *  conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
+ *  of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+ *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+ *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ *  DEALINGS IN THE SOFTWARE.
+ *
+ */
+
+namespace ncc\Classes\PhpExtension\Templates;
+
+use ncc\Classes\NccExtension\ConstantCompiler;
+use ncc\Exceptions\IOException;
+use ncc\Exceptions\PathNotFoundException;
+use ncc\Managers\ProjectManager;
+use ncc\Utilities\IO;
+
+class MakefileTemplate
+{
+    /**
+     * @inheritDoc
+     * @param ProjectManager $project_manager
+     * @throws IOException
+     * @throws PathNotFoundException
+     */
+    public static function applyTemplate(ProjectManager $project_manager): void
+    {
+        self::writeMakefileTemplate($project_manager);
+    }
+
+    /**
+     * Writes the Makefile template for the given project.
+     *
+     * @param ProjectManager $project_manager The project manager containing project configurations.
+     * @throws IOException If there is an error reading or writing files.
+     * @throws PathNotFoundException If a required file path is not found.
+     */
+    private static function writeMakefileTemplate(ProjectManager $project_manager): void
+    {
+        $makefile_template = IO::fread(__DIR__ . DIRECTORY_SEPARATOR . 'Makefile.tpl');
+        $builds = [];
+
+        foreach($project_manager->getProjectConfiguration()->getBuild()->getBuildConfigurations() as $build_name)
+        {
+            $builds[$build_name] = str_replace('%TPL_BUILD_NAME%', $build_name, IO::fread(__DIR__ . DIRECTORY_SEPARATOR . 'make_build.tpl'));
+        }
+
+        $default_build = $project_manager->getProjectConfiguration()->getBuild()->getDefaultConfiguration();
+        $makefile_template = str_replace('%TPL_DEFAULT_BUILD_CONFIGURATION%', $default_build, $makefile_template);
+        $makefile_template = str_replace('%TPL_DEFAULT_BUILD_PATH%', $project_manager->getProjectConfiguration()->getBuild()->getBuildConfiguration($default_build)->getOutput(), $makefile_template);
+        $makefile_template = str_replace('%TPL_BUILD_NAMES%', implode(' ', array_keys($builds)), $makefile_template);
+
+        $build_template = '';
+        foreach($builds as $name => $template)
+        {
+            $build_template .= $template . PHP_EOL;
+        }
+
+        $makefile_template = str_replace('%TPL_BUILDS%', $build_template, $makefile_template);
+        IO::fwrite(
+            $project_manager->getProjectPath() . DIRECTORY_SEPARATOR . 'Makefile',
+            ConstantCompiler::compileConstants($project_manager->getProjectConfiguration(), $makefile_template)
+        );
+    }
+}

src/ncc/Classes/PhpExtension/Templates/PhpUnitTemplate.php

@@ -0,0 +1,93 @@
+<?php
+    /*
+     * Copyright (c) Nosial 2022-2023, all rights reserved.
+     *
+     *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+     *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
+     *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
+     *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
+     *  conditions:
+     *
+     *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
+     *  of the Software.
+     *
+     *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+     *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+     *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+     *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+     *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+     *  DEALINGS IN THE SOFTWARE.
+     *
+     */
+
+    namespace ncc\Classes\PhpExtension\Templates;
+
+    use ncc\Classes\NccExtension\ConstantCompiler;
+    use ncc\Enums\Options\BuildConfigurationOptions;
+    use ncc\Enums\Options\ProjectOptions;
+    use ncc\Enums\Runners;
+    use ncc\Enums\SpecialConstants\AssemblyConstants;
+    use ncc\Enums\Types\BuildOutputType;
+    use ncc\Exceptions\ConfigurationException;
+    use ncc\Exceptions\IOException;
+    use ncc\Exceptions\PathNotFoundException;
+    use ncc\Interfaces\TemplateInterface;
+    use ncc\Managers\ProjectManager;
+    use ncc\Objects\ProjectConfiguration\Build\BuildConfiguration;
+    use ncc\Objects\ProjectConfiguration\ExecutionPolicy;
+    use ncc\Utilities\IO;
+
+    class PhpUnitTemplate implements TemplateInterface
+    {
+        /**
+         * Applies the necessary templates for the given project.
+         *
+         * @param ProjectManager $project_manager Manager responsible for handling project-related tasks.
+         *
+         * @return void
+         */
+        public static function applyTemplate(ProjectManager $project_manager): void
+        {
+            self::createPhpUnitBootstrapTemplate($project_manager);
+            self::createPhpUnitTemplate($project_manager);
+        }
+
+        /**
+         * Creates a PHPUnit template in the specified project directory.
+         *
+         * @param ProjectManager $project_manager The project manager instance containing project configuration and path details.
+         * @return void
+         * @throws IOException
+         * @throws PathNotFoundException
+         */
+        private static function createPhpUnitTemplate(ProjectManager $project_manager): void
+        {
+            IO::fwrite(
+                $project_manager->getProjectPath() . DIRECTORY_SEPARATOR . 'phpunit.xml',
+                ConstantCompiler::compileConstants($project_manager->getProjectConfiguration(),
+                    IO::fread(__DIR__ . DIRECTORY_SEPARATOR . 'phpunit.xml.tpl')
+                )
+            );
+
+            if(!file_exists($project_manager->getProjectPath() . DIRECTORY_SEPARATOR . 'tests'))
+            {
+                mkdir($project_manager->getProjectPath() . DIRECTORY_SEPARATOR . 'tests');
+            }
+        }
+
+        /**
+         * Creates the PHPUnit bootstrap template file for the given project.
+         *
+         * @param ProjectManager $project_manager The project manager instance handling project configuration and paths.
+         * @return void
+         */
+        private static function createPhpUnitBootstrapTemplate(ProjectManager $project_manager): void
+        {
+            IO::fwrite(
+                $project_manager->getProjectPath() . DIRECTORY_SEPARATOR . 'bootstrap.php',
+                ConstantCompiler::compileConstants($project_manager->getProjectConfiguration(),
+                    IO::fread(__DIR__ . DIRECTORY_SEPARATOR . 'bootstrap.php.tpl')
+                )
+            );
+        }
+    }

src/ncc/Classes/PhpExtension/Templates/bootstrap.php.tpl

@@ -0,0 +1,3 @@
+<?php
+    require 'ncc';
+    import('%ASSEMBLY.PACKAGE%');

src/ncc/Classes/PhpExtension/Templates/github_ci.yml.tpl

@@ -0,0 +1,187 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - '**'
+  release:
+    types: [created]
+  workflow_dispatch:
+
+jobs:
+%TPL_BUILDS%
+
+  # Checking for phpunit.xml
+  check-phpunit:
+    runs-on: ubuntu-latest
+    outputs:
+      phpunit-exists: ${{ steps.check.outputs.phpunit-exists }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Check for phpunit.xml
+        id: check
+        run: |
+          if [ -f phpunit.xml ]; then
+            echo "phpunit-exists=true" >> $GITHUB_OUTPUT
+          else
+            echo "phpunit-exists=false" >> $GITHUB_OUTPUT
+          fi
+  # Checking for phpdoc.dist.xml
+  check-phpdoc:
+    runs-on: ubuntu-latest
+    outputs:
+      phpdoc-exists: ${{ steps.check.outputs.phpdoc-exists }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Check for phpdoc.dist.xml
+        id: check
+        run: |
+          if [ -f phpdoc.dist.xml ]; then
+            echo "phpdoc-exists=true" >> $GITHUB_OUTPUT
+          else
+            echo "phpdoc-exists=false" >> $GITHUB_OUTPUT
+          fi
+  generate-phpdoc:
+    needs: [%TPL_DEFAULT_BUILD_CONFIGURATION%, check-phpdoc]
+    runs-on: ubuntu-latest
+    container:
+      image: php:8.3
+    if: needs.check-phpdoc.outputs.phpdoc-exists == 'true'
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install dependencies
+        run: |
+          apt update -yqq
+          apt install git libpq-dev libzip-dev zip make wget gnupg -yqq
+
+      - name: Download PHPDocumentor
+        run: |
+          wget https://phpdoc.org/phpDocumentor.phar
+          chmod +x phpDocumentor.phar
+
+      - name: Generate PHPDoc
+        run: |
+          php phpDocumentor.phar -d src -t docs
+
+      - name: Archive PHPDoc
+        run: |
+          zip -r docs.zip docs
+
+      - name: Upload PHPDoc
+        uses: actions/upload-artifact@v4
+        with:
+          name: documentation
+          path: docs.zip
+
+  test:
+    needs: [%TPL_BUILD_NAMES%, check-phpunit]
+    runs-on: ubuntu-latest
+    container:
+      image: php:8.3
+    if: needs.check-phpunit.outputs.phpunit-exists == 'true'
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: %TPL_DEFAULT_BUILD_CONFIGURATION%
+          path: %TPL_DEFAULT_BUILD_CONFIGURATION%
+
+      - name: Install dependencies
+        run: |
+          apt update -yqq
+          apt install git libpq-dev libzip-dev zip make wget gnupg -yqq
+          curl -sSLf -o /usr/local/bin/install-php-extensions https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions
+          chmod +x /usr/local/bin/install-php-extensions
+          install-php-extensions zip
+
+      - name: Install phive
+        run: |
+          wget -O phive.phar https://phar.io/releases/phive.phar
+          wget -O phive.phar.asc https://phar.io/releases/phive.phar.asc
+          gpg --keyserver hkps://keys.openpgp.org --recv-keys 0x9D8A98B29B2D5D79
+          gpg --verify phive.phar.asc phive.phar
+          chmod +x phive.phar
+          mv phive.phar /usr/local/bin/phive
+
+      - name: Install phab
+        run: |
+          phive install phpab --global --trust-gpg-keys 0x2A8299CE842DD38C
+
+      - name: Install latest version of NCC
+        run: |
+          git clone https://git.n64.cc/nosial/ncc.git
+          cd ncc
+          make redist
+          NCC_DIR=$(find build/ -type d -name "ncc_*" | head -n 1)
+          if [ -z "$NCC_DIR" ]; then
+            echo "NCC build directory not found"
+            exit 1
+          fi
+          php "$NCC_DIR/INSTALL" --auto
+          cd .. && rm -rf ncc
+
+      - name: Install NCC packages
+        run: |
+          ncc package install --package="%TPL_DEFAULT_ARTIFACT_BUILD_OUTPUT%" --build-source --reinstall -y --log-level debug
+
+      - name: Run PHPUnit tests
+        run: |
+          wget https://phar.phpunit.de/phpunit-11.3.phar
+          php phpunit-11.3.phar --configuration phpunit.xml --log-junit reports/junit.xml --log-teamcity reports/teamcity --testdox-html reports/testdox.html --testdox-text reports/testdox.txt
+
+      - name: Upload test reports
+        uses: actions/upload-artifact@v4
+        with:
+          name: reports
+          path: reports
+
+
+  release-documentation:
+    needs: generate-phpdoc
+    permissions: write-all
+    runs-on: ubuntu-latest
+    container:
+      image: php:8.3
+    if: github.event_name == 'release'
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Download documentation artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: documentation
+          path: documentation
+
+      - name: Upload documentation artifact
+        uses: softprops/action-gh-release@v1
+        with:
+            files: |
+                documentation/*
+        env:
+            GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+
+  release-artifacts:
+    needs: [%TPL_BUILD_NAMES%]
+    permissions: write-all
+    runs-on: ubuntu-latest
+    container:
+      image: php:8.3
+    if: github.event_name == 'release'
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+%TPL_DOWNLOAD_ARTIFACTS%

src/ncc/Classes/PhpExtension/Templates/github_ci_build.yml.tpl

@@ -0,0 +1,49 @@
+  %TPL_BUILD_NAME%:
+    runs-on: ubuntu-latest
+    container:
+      image: php:8.3
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install dependencies
+        run: |
+          apt update -yqq
+          apt install git libpq-dev libzip-dev zip make wget gnupg -yqq
+
+      - name: Install phive
+        run: |
+          wget -O phive.phar https://phar.io/releases/phive.phar
+          wget -O phive.phar.asc https://phar.io/releases/phive.phar.asc
+          gpg --keyserver hkps://keys.openpgp.org --recv-keys 0x9D8A98B29B2D5D79
+          gpg --verify phive.phar.asc phive.phar
+          chmod +x phive.phar
+          mv phive.phar /usr/local/bin/phive
+
+      - name: Install phab
+        run: |
+          phive install phpab --global --trust-gpg-keys 0x2A8299CE842DD38C
+
+      - name: Install latest version of NCC
+        run: |
+          git clone https://git.n64.cc/nosial/ncc.git
+          cd ncc
+          make redist
+          NCC_DIR=$(find build/ -type d -name "ncc_*" | head -n 1)
+          if [ -z "$NCC_DIR" ]; then
+            echo "NCC build directory not found"
+            exit 1
+          fi
+          php "$NCC_DIR/INSTALL" --auto
+          cd .. && rm -rf ncc
+
+      - name: Build project
+        run: |
+          ncc build --config %TPL_BUILD_NAME% --build-source --log-level debug
+
+      - name: Upload build artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: %TPL_BUILD_NAME%
+          path: %TPL_BUILD_OUTPUT%

src/ncc/Classes/PhpExtension/Templates/github_ci_download.yml.tpl

@@ -0,0 +1,12 @@
+      - name: Download %TPL_BUILD_NAME% artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: %TPL_BUILD_NAME%
+          path: %TPL_BUILD_NAME%
+      - name: Upload %TPL_BUILD_NAME% artifact to release
+        uses: softprops/action-gh-release@v1
+        with:
+            files: |
+                %TPL_BUILD_NAME%/*
+        env:
+            GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

src/ncc/Classes/PhpExtension/Templates/make_build.tpl

@@ -0,0 +1,2 @@
+%TPL_BUILD_NAME%:
+	ncc build --config=%TPL_BUILD_NAME% --log-level $(LOG_LEVEL)

src/ncc/Classes/PhpExtension/Templates/phpunit.xml.tpl

@@ -0,0 +1,11 @@
+<phpunit bootstrap="bootstrap.php">
+    <testsuites>
+        <testsuite name="%ASSEMBLY.NAME% Test Suite">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+    <php>
+        <ini name="error_reporting" value="-1"/>
+        <server name="KERNEL_DIR" value="app/"/>
+    </php>
+</phpunit>

src/ncc/Classes/Runtime.php

@@ -34,6 +34,7 @@
     use ncc\Enums\Versions;
     use ncc\Exceptions\ConfigurationException;
     use ncc\Exceptions\ImportException;
+    use ncc\Exceptions\IntegrityException;
     use ncc\Exceptions\IOException;
     use ncc\Exceptions\NotSupportedException;
     use ncc\Exceptions\OperationException;
@@ -44,9 +45,11 @@
     use ncc\Utilities\Console;
     use ncc\Utilities\IO;
     use ncc\Utilities\Resolver;
+    use ncc\Utilities\RuntimeCache;
     use ncc\Utilities\Validate;
     use RuntimeException;
     use Throwable;
+    use function trigger_error;
 
     class Runtime
     {
@@ -75,14 +78,16 @@
          * This method may exit the program without returning a value
          *
          * @param string $package
+         * @param array $arguments
          * @return mixed
          * @throws ConfigurationException
          * @throws IOException
+         * @throws IntegrityException
          * @throws NotSupportedException
-         * @throws PathNotFoundException
          * @throws OperationException
+         * @throws PathNotFoundException
          */
-        public static function execute(string $package): int
+        public static function execute(string $package, array $arguments=[]): int
         {
             if(!self::isImported($package))
             {
@@ -91,6 +96,12 @@
 
             if(self::$imported_packages[$package] instanceof PackageReader)
             {
+                if(self::$imported_packages[$package]?->getMetadata()?->getMainExecutionPolicy() === null)
+                {
+                    Console::out('The package does not have a main execution policy, skipping execution');
+                    return 0;
+                }
+
                 return ExecutionUnitRunner::executeFromPackage(
                     self::$imported_packages[$package],
                     self::$imported_packages[$package]->getMetadata()->getMainExecutionPolicy()
@@ -99,7 +110,7 @@
 
             if(is_string(self::$imported_packages[$package]))
             {
-                $metadata_path = self::$imported_packages[$package] . DIRECTORY_SEPARATOR . FileDescriptor::METADATA;
+                $metadata_path = self::$imported_packages[$package] . DIRECTORY_SEPARATOR . FileDescriptor::METADATA->value;
 
                 if(!is_file($metadata_path))
                 {
@@ -108,7 +119,8 @@
 
                 return ExecutionUnitRunner::executeFromSystem(
                     self::$imported_packages[$package],
-                    Metadata::fromArray(ZiProto::decode(IO::fread($metadata_path)))->getMainExecutionPolicy()
+                    Metadata::fromArray(ZiProto::decode(IO::fread($metadata_path)))->getMainExecutionPolicy(),
+                    $arguments
                 );
             }
 
@@ -121,7 +133,7 @@
          * @return string
          * @throws ImportException
          */
-        public static function import(string $package, string $version=Versions::LATEST): string
+        public static function import(string $package, string $version=Versions::LATEST->value): string
         {
             if(self::isImported($package))
             {
@@ -160,7 +172,7 @@
                 }
             }
 
-            throw new RuntimeException('Importing from a package name is not supported yet');
+            throw new RuntimeException(sprintf('Failed to import package "%s" because it does not exist', $package));
         }
 
         /**
@@ -173,7 +185,7 @@
          * @throws NotSupportedException
          * @throws PathNotFoundException
          */
-        private static function importFromSystem(string $package, string $version=Versions::LATEST): string
+        private static function importFromSystem(string $package, string $version=Versions::LATEST->value): string
         {
             if(!self::getPackageManager()->getPackageLock()->entryExists($package))
             {
@@ -189,27 +201,81 @@
                 self::$class_map[strtolower($class)] = $component_path;
             }
 
-            if($entry->getMetadata($version)->getOption(BuildConfigurationOptions::REQUIRE_FILES) !== null)
+            if($entry->getMetadata($version)->getOption(BuildConfigurationOptions::REQUIRE_FILES->value) !== null)
             {
-                foreach($entry->getMetadata($version)->getOption(BuildConfigurationOptions::REQUIRE_FILES) as $item)
+                foreach($entry->getMetadata($version)->getOption(BuildConfigurationOptions::REQUIRE_FILES->value) as $item)
                 {
+                    $required_file = $entry->getPath($version) . DIRECTORY_SEPARATOR . 'bin' . DIRECTORY_SEPARATOR . $item;
+
                     try
                     {
-                        // Get the file contents and prepare it
+                        if(!file_exists($required_file))
-                        $required_file = IO::fread($entry->getPath($version) . DIRECTORY_SEPARATOR . 'bin' . DIRECTORY_SEPARATOR . $item);
-                        $required_file = preg_replace('/^<\?php|<\?PHP/', '', $required_file, 1);
-
-                        eval($required_file);
-                        unset($required_file);
-                    }
-                    catch(ConfigurationException $e)
                         {
-                        throw new ImportException(sprintf('Failed to import "%s" from %s: %s', $item, $package, $e->getMessage()), $e);
+                            throw new PathNotFoundException($required_file);
+                        }
+
+                        // Get the file contents and prepare it
+                        $evaluated_code = IO::fread($required_file);
+
+                        // Remove the PHP tags
+                        $evaluated_code = preg_replace('/^<\?php|<\?PHP/', '', $evaluated_code, 1);
+                        // Replace __DIR__ with the actual directory that the file is in
+                        $evaluated_code = str_replace('__DIR__', sprintf('"%s"', dirname($required_file)), $evaluated_code);
+
+                        set_error_handler(function ($error_number, $message, $file, $line) use ($item, $package)
+                        {
+                            throw new ImportException(sprintf('Fatal Evaluation Error: Failed to import "%s" from %s on %s:%s: %s', $item, $package, $file, $line, $message));
+                        });
+
+                        // Evaluate the code
+                        eval($evaluated_code);
+                        restore_error_handler();
+                        unset($evaluated_code);
+                    }
+                    catch (ConfigurationException $e)
+                    {
+                        throw new ImportException(sprintf('%s: Failed to import "%s" from %s: %s', $required_file, $item, $package, $e->getMessage()), $e);
+                    }
+                    catch(ImportException $e)
+                    {
+                        throw $e;
+                    }
+                    catch (Throwable $e)
+                    {
+                        throw new ImportException(sprintf('%s: Failed to import "%s" from %s: %s', $required_file, $item, $package, $e->getMessage()), $e);
                     }
                 }
             }
 
-            if(isset($entry->getMetadata($version)->getOptions()[PackageFlags::STATIC_DEPENDENCIES]))
+            $safe_package_name = strtoupper($entry->getAssembly($version)->getName());
+            foreach($entry->getMetadata($version)->getConstants() as $constant => $value)
+            {
+                $constant_full_name = sprintf("%s_%s", $safe_package_name, $constant);
+
+                // Skip if already defined.
+                if(defined($constant_full_name))
+                {
+                    if(RuntimeCache::get(sprintf("defined_%s", $constant_full_name)))
+                    {
+                        continue;
+                    }
+
+                    trigger_error(sprintf('Cannot define constant %s from package %s because the constant is already defined', $constant_full_name, $package), E_USER_WARNING);
+                    continue;
+                }
+
+                if(!Validate::constantName($constant_full_name))
+                {
+                    // trigger warning only
+                    trigger_error(sprintf('Cannot define constant %s from package %s because the constant name is invalid', $constant_full_name, $package), E_USER_WARNING);
+                    continue;
+                }
+
+                RuntimeCache::set(sprintf("defined_%s", $constant_full_name), true);
+                define($constant_full_name, $value);
+            }
+
+            if(isset($entry->getMetadata($version)->getOptions()[PackageFlags::STATIC_DEPENDENCIES->value]))
             {
                 // Fake import the dependencies
                 foreach($entry->getVersion($version)->getDependencies() as $dependency)
@@ -237,7 +303,7 @@
          * @return string
          * @throws ConfigurationException
          * @throws ImportException
-         * @throws NotSupportedException
+         * @throws IntegrityException
          * @throws OperationException
          */
         private static function importFromPackage(string $package_path): string
@@ -273,9 +339,9 @@
             }
 
             // Import the required files
-            if($package_reader->getMetadata()->getOption(BuildConfigurationOptions::REQUIRE_FILES) !== null)
+            if($package_reader->getMetadata()->getOption(BuildConfigurationOptions::REQUIRE_FILES->value) !== null)
             {
-                foreach($package_reader->getMetadata()->getOption(BuildConfigurationOptions::REQUIRE_FILES) as $item)
+                foreach($package_reader->getMetadata()->getOption(BuildConfigurationOptions::REQUIRE_FILES->value) as $item)
                 {
                     try
                     {
@@ -288,7 +354,7 @@
                 }
             }
 
-            if($package_reader->getFlag(PackageFlags::STATIC_DEPENDENCIES))
+            if($package_reader->getFlag(PackageFlags::STATIC_DEPENDENCIES->value))
             {
                 // Fake import the dependencies
                 foreach($package_reader->getDependencies() as $dependency_name)
@@ -456,6 +522,7 @@
          * @throws IOException
          * @throws OperationException
          * @throws PathNotFoundException
+         * @throws IntegrityException
          */
         private static function acquireFile(string $path, ?string $package=null): string
         {
@@ -480,8 +547,8 @@
 
                     return match (Resolver::componentType($acquired_file))
                     {
-                        PackageDirectory::RESOURCES => self::$imported_packages[$package]->getResource(Resolver::componentName($acquired_file))->getData(),
+                        PackageDirectory::RESOURCES->value => self::$imported_packages[$package]->getResource(Resolver::componentName($acquired_file))->getData(),
-                        PackageDirectory::COMPONENTS => self::$imported_packages[$package]->getComponent(Resolver::componentName($acquired_file))->getData([ComponentDecodeOptions::AS_FILE]),
+                        PackageDirectory::COMPONENTS->value => self::$imported_packages[$package]->getComponent(Resolver::componentName($acquired_file))->getData([ComponentDecodeOptions::AS_FILE->value]),
                         default => throw new IOException(sprintf('Unable to acquire file "%s" from package "%s" because it is not a resource or component', $path, $package)),
                     };
                 }
@@ -572,9 +639,16 @@
                 return;
             }
 
-            if(!in_array($path, self::$included_files, true))
+            $acquired_name = $path;
+
+            if(!is_file($path))
             {
-                self::$included_files[] = $path;
+                $acquired_name = hash('crc32', $acquired_file);
+            }
+
+            if(!in_array($acquired_name, self::$included_files, true))
+            {
+                self::$included_files[] = sprintf('virtual(%s)', $acquired_name);
             }
 
             self::extendedEvaluate($acquired_file);
@@ -617,9 +691,16 @@
                     throw new RuntimeException(sprintf('Failed to acquire file "%s" at runtime: %s', $path, $e->getMessage()), $e->getCode(), $e);
             }
 
-            if(!in_array($path, self::$included_files, true))
+            $acquired_name = $path;
+
+            if(!is_file($path))
             {
-                self::$included_files[] = $path;
+                $acquired_name = hash('crc32', $acquired_file);
+            }
+
+            if(!in_array($acquired_name, self::$included_files, true))
+            {
+                self::$included_files[] = sprintf('virtual(%s)', $acquired_name);
             }
 
             self::extendedEvaluate($acquired_file);

src/ncc/Enums/CompilerExtensionDefaultVersions.php

@@ -1,33 +0,0 @@
-<?php
-    /*
-     * Copyright (c) Nosial 2022-2023, all rights reserved.
-     *
-     *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
-     *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
-     *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
-     *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
-     *  conditions:
-     *
-     *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
-     *  of the Software.
-     *
-     *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-     *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
-     *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-     *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-     *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-     *  DEALINGS IN THE SOFTWARE.
-     *
-     */
-
-    namespace ncc\Enums;
-
-    final class CompilerExtensionDefaultVersions
-    {
-        // ----------------------------------------------------------------
-        // [0] = MinimumVersion
-        // [1] = MaximumVersion
-        // ----------------------------------------------------------------
-
-        public const PHP = ['8.0', '8.2'];
-    }

src/ncc/Enums/CompilerExtensionSupportedVersions.php

@@ -24,5 +24,6 @@
 
     final class CompilerExtensionSupportedVersions
     {
+        // TODO: Cannot convert this to enum, try another way
         public const PHP = ['8.0', '8.1', '8.2'];
     }

src/ncc/Enums/CompilerExtensions.php

@@ -22,11 +22,7 @@
 
     namespace ncc\Enums;
 
-    final class CompilerExtensions
+    enum CompilerExtensions : string
     {
-        public const PHP = 'php';
+        case PHP = 'php';
-
-        public const ALL = [
-            CompilerExtensions::PHP
-        ];
     }

src/ncc/Enums/ComponentFileExtensions.php

@@ -1,33 +0,0 @@
-<?php
-    /*
-     * Copyright (c) Nosial 2022-2023, all rights reserved.
-     *
-     *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
-     *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
-     *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
-     *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
-     *  conditions:
-     *
-     *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
-     *  of the Software.
-     *
-     *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-     *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
-     *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-     *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-     *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-     *  DEALINGS IN THE SOFTWARE.
-     *
-     */
-
-    namespace ncc\Enums;
-
-    final class ComponentFileExtensions
-    {
-        /**
-         * The file extensions that the PHP compiler extension will accept as components.
-         *
-         * @var array
-         */
-        public const PHP = ['*.php', '*.php3', '*.php4', '*.php5', '*.phtml'];
-    }

src/ncc/Enums/ConsoleColors.php

@@ -22,39 +22,39 @@
 
     namespace ncc\Enums;
 
-    final class ConsoleColors
+    enum ConsoleColors : string
     {
-        public const DEFAULT = "\e[39m";
+        case DEFAULT = "\e[39m";
 
-        public const BLACK = "\e[30m";
+        case BLACK = "\e[30m";
 
-        public const RED = "\e[31m";
+        case RED = "\e[31m";
 
-        public const GREEN = "\e[32m";
+        case GREEN = "\e[32m";
 
-        public const YELLOW = "\e[33m";
+        case YELLOW = "\e[33m";
 
-        public const BLUE = "\e[34m";
+        case BLUE = "\e[34m";
 
-        public const MAGENTA = "\e[35m";
+        case MAGENTA = "\e[35m";
 
-        public const CYAN = "\e[36m";
+        case CYAN = "\e[36m";
 
-        public const LIGHT_GREY = "\e[37m";
+        case LIGHT_GREY = "\e[37m";
 
-        public const DARK_GREY = "\e[90m";
+        case DARK_GREY = "\e[90m";
 
-        public const LIGHT_RED = "\e[91m";
+        case LIGHT_RED = "\e[91m";
 
-        public const LIGHT_GREEN = "\e[92m";
+        case LIGHT_GREEN = "\e[92m";
 
-        public const LIGHT_YELLOW = "\e[93m";
+        case LIGHT_YELLOW = "\e[93m";
 
-        public const LIGHT_BLUE = "\e[94m";
+        case LIGHT_BLUE = "\e[94m";
 
-        public const LIGHT_MAGENTA = "\e[95m";
+        case LIGHT_MAGENTA = "\e[95m";
 
-        public const LIGHT_CYAN = "\e[96m";
+        case LIGHT_CYAN = "\e[96m";
 
-        public const WHITE = "\e[97m";
+        case WHITE = "\e[97m";
     }

src/ncc/Enums/ConstantReferences.php

@@ -1,36 +0,0 @@
-<?php
-    /*
-     * Copyright (c) Nosial 2022-2023, all rights reserved.
-     *
-     *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
-     *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
-     *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
-     *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
-     *  conditions:
-     *
-     *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
-     *  of the Software.
-     *
-     *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-     *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
-     *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-     *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-     *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-     *  DEALINGS IN THE SOFTWARE.
-     *
-     */
-
-    namespace ncc\Enums;
-
-    final class ConstantReferences
-    {
-        public const ASSEMBLY = 'assembly';
-
-        public const BUILD = 'build';
-
-        public const DATE_TIME = 'date_time';
-
-        public const INSTALL = 'install';
-
-        public const RUNTIME = 'runtime';
-    }

src/ncc/Enums/ExceptionCodes.php

@@ -26,98 +26,80 @@
      * @author Zi Xing Narrakas
      * @copyright Copyright (C) 2022-2023. Nosial - All Rights Reserved.
      */
-    final class ExceptionCodes
+    enum ExceptionCodes : int
     {
         /**
          * @see RuntimeException
          */
-        public const RUNTIME = -1706;
+        case RUNTIME = -1706;
 
         /**
          * @see BuildException
          */
-        public const BUILD_EXCEPTION = -1727;
+        case BUILD_EXCEPTION = -1727;
 
         /**
          * @see IOException
          */
-        public const IO_EXCEPTION = -1735;
+        case IO_EXCEPTION = -1735;
 
         /**
          * @see ComposerException
          */
-        public const COMPOSER_EXCEPTION = -1749;
+        case COMPOSER_EXCEPTION = -1749;
 
         /**
          * @see AuthenticationException
          */
-        public const AUTHENTICATION_EXCEPTION = -1760;
+        case AUTHENTICATION_EXCEPTION = -1760;
 
         /**
          * @see NotSupportedException
          */
-        public const NOT_SUPPORTED_EXCEPTION = -1761;
+        case NOT_SUPPORTED_EXCEPTION = -1761;
 
         /**
          * @see ArchiveException
          */
-        public const ARCHIVE_EXCEPTION = -1764;
+        case ARCHIVE_EXCEPTION = -1764;
 
         /**
          * @see PathNotFoundException
          */
-        public const PATH_NOT_FOUND = -1769;
+        case PATH_NOT_FOUND = -1769;
 
         /**
          * @see GitException
          */
-        public const GIT_EXCEPTION = -1770;
+        case GIT_EXCEPTION = -1770;
 
         /**
          * @see ConfigurationException
          */
-        public const CONFIGURATION_EXCEPTION = -1772;
+        case CONFIGURATION_EXCEPTION = -1772;
 
         /**
          * @see PackageException
          */
-        public const PACKAGE_EXCEPTION = -1773;
+        case PACKAGE_EXCEPTION = -1773;
 
         /**
          * @see NetworkException
          */
-        public const NETWORK_EXCEPTION = -1774;
+        case NETWORK_EXCEPTION = -1774;
 
         /**
          * @see IntegrityException
          */
-        public const INTEGRITY_EXCEPTION = -1775;
+        case INTEGRITY_EXCEPTION = -1775;
 
         /**
          * @see OperationException
          */
-        public const OPERATION_EXCEPTION = -1776;
+        case OPERATION_EXCEPTION = -1776;
-
-        public const IMPORT_EXCEPTION = -1777;
 
         /**
-         * All the exception codes from NCC
+         * @see ImportException
          */
-        public const All = [
+        case IMPORT_EXCEPTION = -1777;
-            self::RUNTIME,
-            self::BUILD_EXCEPTION,
-            self::IO_EXCEPTION,
-            self::COMPOSER_EXCEPTION,
-            self::AUTHENTICATION_EXCEPTION,
-            self::NOT_SUPPORTED_EXCEPTION,
-            self::ARCHIVE_EXCEPTION,
-            self::PATH_NOT_FOUND,
-            self::GIT_EXCEPTION,
-            self::CONFIGURATION_EXCEPTION,
-            self::PACKAGE_EXCEPTION,
-            self::NETWORK_EXCEPTION,
-            self::INTEGRITY_EXCEPTION,
-            self::OPERATION_EXCEPTION,
-            self::IMPORT_EXCEPTION
-        ];
     }

src/ncc/Enums/FileDescriptor.php

@@ -22,17 +22,17 @@
 
     namespace ncc\Enums;
 
-    final class FileDescriptor
+    enum FileDescriptor : string
     {
-        public const ASSEMBLY = 'ASSEMBLY';
+        case ASSEMBLY = 'ASSEMBLY';
 
-        public const METADATA = 'METADATA';
+        case METADATA = 'METADATA';
 
-        public const INSTALLER = 'INSTALLER';
+        case INSTALLER = 'INSTALLER';
 
-        public const CLASS_MAP = 'CLASS_MAP';
+        case CLASS_MAP = 'CLASS_MAP';
 
-        public const UPDATE = 'UPDATE';
+        case UPDATE = 'UPDATE';
 
-        public const SHADOW_PACKAGE = 'SHADOW_PKG';
+        case SHADOW_PACKAGE = 'SHADOW_PKG';
     }

src/ncc/Enums/Flags/ComponentFlags.php

@@ -22,23 +22,15 @@
 
     namespace ncc\Enums\Flags;
 
-    final class ComponentFlags
+    enum ComponentFlags : string
     {
         /**
          * Indicates that the component is the AST of a PHP file encoded with msgpack.
          */
-        public const PHP_AST = 'php_ast';
+        case PHP_AST = 'php_ast';
 
         /**
          * Indicates that the component is a PHP file encoded with base64.
          */
-        public const PHP_B64 = 'php_b64';
+        case PHP_B64 = 'php_b64';
-
-        /**
-         * All the possible flags of a component
-         */
-        public const ALL = [
-            self::PHP_AST,
-            self::PHP_B64
-        ];
     }

src/ncc/Enums/Flags/NccBuildFlags.php

@@ -22,16 +22,16 @@
 
     namespace ncc\Enums\Flags;
 
-    final class NccBuildFlags
+    enum NccBuildFlags : string
     {
         /**
          * Indicates if the build is currently unstable and some features may not work correctly
          * and can cause errors
          */
-        public const UNSTABLE = 'unstable';
+        case UNSTABLE = 'unstable';
 
         /**
          * Indicates if the build is currently in beta testing phase
          */
-        public const BETA = 'beta';
+        case BETA = 'beta';
     }

src/ncc/Enums/Flags/PackageFlags.php

@@ -22,15 +22,15 @@
 
     namespace ncc\Enums\Flags;
 
-    final class PackageFlags
+    enum PackageFlags : string
     {
-        public const COMPRESSION = 'gzip';
+        case COMPRESSION = 'gzip';
 
-        public const LOW_COMPRESSION = 'low_gz`';
+        case LOW_COMPRESSION = 'low_gz`';
 
-        public const MEDIUM_COMPRESSION = 'medium_gz';
+        case MEDIUM_COMPRESSION = 'medium_gz';
 
-        public const HIGH_COMPRESSION = 'high_gz';
+        case HIGH_COMPRESSION = 'high_gz';
 
-        public const STATIC_DEPENDENCIES = 'static_dependencies';
+        case STATIC_DEPENDENCIES = 'static_dependencies';
     }

src/ncc/Enums/HttpStatusCodes.php

@@ -1,124 +0,0 @@
-<?php
-    /*
-     * Copyright (c) Nosial 2022-2023, all rights reserved.
-     *
-     *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
-     *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
-     *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
-     *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
-     *  conditions:
-     *
-     *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
-     *  of the Software.
-     *
-     *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-     *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
-     *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-     *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-     *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-     *  DEALINGS IN THE SOFTWARE.
-     *
-     */
-
-    namespace ncc\Enums;
-
-    final class HttpStatusCodes
-    {
-        public const OK = 200;
-        public const CREATED = 201;
-        public const ACCEPTED = 202;
-        public const NO_CONTENT = 204;
-        public const MOVED_PERMANENTLY = 301;
-        public const FOUND = 302;
-        public const SEE_OTHER = 303;
-        public const NOT_MODIFIED = 304;
-        public const TEMPORARY_REDIRECT = 307;
-        public const PERMANENT_REDIRECT = 308;
-        public const BAD_REQUEST = 400;
-        public const UNAUTHORIZED = 401;
-        public const FORBIDDEN = 403;
-        public const NOT_FOUND = 404;
-        public const METHOD_NOT_ALLOWED = 405;
-        public const NOT_ACCEPTABLE = 406;
-        public const REQUEST_TIMEOUT = 408;
-        public const CONFLICT = 409;
-        public const GONE = 410;
-        public const LENGTH_REQUIRED = 411;
-        public const PRECONDITION_FAILED = 412;
-        public const PAYLOAD_TOO_LARGE = 413;
-        public const URI_TOO_LONG = 414;
-        public const UNSUPPORTED_MEDIA_TYPE = 415;
-        public const RANGE_NOT_SATISFIABLE = 416;
-        public const EXPECTATION_FAILED = 417;
-        public const IM_A_TEAPOT = 418;
-        public const MISDIRECTED_REQUEST = 421;
-        public const UNPROCESSABLE_ENTITY = 422;
-        public const LOCKED = 423;
-        public const FAILED_DEPENDENCY = 424;
-        public const UPGRADE_REQUIRED = 426;
-        public const PRECONDITION_REQUIRED = 428;
-        public const TOO_MANY_REQUESTS = 429;
-        public const REQUEST_HEADER_FIELDS_TOO_LARGE = 431;
-        public const UNAVAILABLE_FOR_LEGAL_REASONS = 451;
-        public const INTERNAL_SERVER_ERROR = 500;
-        public const NOT_IMPLEMENTED = 501;
-        public const BAD_GATEWAY = 502;
-        public const SERVICE_UNAVAILABLE = 503;
-        public const GATEWAY_TIMEOUT = 504;
-        public const HTTP_VERSION_NOT_SUPPORTED = 505;
-        public const VARIANT_ALSO_NEGOTIATES = 506;
-        public const INSUFFICIENT_STORAGE = 507;
-        public const LOOP_DETECTED = 508;
-        public const NOT_EXTENDED = 510;
-        public const NETWORK_AUTHENTICATION_REQUIRED = 511;
-
-        public const ALL = [
-            self::OK,
-            self::CREATED,
-            self::ACCEPTED,
-            self::NO_CONTENT,
-            self::MOVED_PERMANENTLY,
-            self::FOUND,
-            self::SEE_OTHER,
-            self::NOT_MODIFIED,
-            self::TEMPORARY_REDIRECT,
-            self::PERMANENT_REDIRECT,
-            self::BAD_REQUEST,
-            self::UNAUTHORIZED,
-            self::FORBIDDEN,
-            self::NOT_FOUND,
-            self::METHOD_NOT_ALLOWED,
-            self::NOT_ACCEPTABLE,
-            self::REQUEST_TIMEOUT,
-            self::CONFLICT,
-            self::GONE,
-            self::LENGTH_REQUIRED,
-            self::PRECONDITION_FAILED,
-            self::PAYLOAD_TOO_LARGE,
-            self::URI_TOO_LONG,
-            self::UNSUPPORTED_MEDIA_TYPE,
-            self::RANGE_NOT_SATISFIABLE,
-            self::EXPECTATION_FAILED,
-            self::IM_A_TEAPOT,
-            self::MISDIRECTED_REQUEST,
-            self::UNPROCESSABLE_ENTITY,
-            self::LOCKED,
-            self::FAILED_DEPENDENCY,
-            self::UPGRADE_REQUIRED,
-            self::PRECONDITION_REQUIRED,
-            self::TOO_MANY_REQUESTS,
-            self::REQUEST_HEADER_FIELDS_TOO_LARGE,
-            self::UNAVAILABLE_FOR_LEGAL_REASONS,
-            self::INTERNAL_SERVER_ERROR,
-            self::NOT_IMPLEMENTED,
-            self::BAD_GATEWAY,
-            self::SERVICE_UNAVAILABLE,
-            self::GATEWAY_TIMEOUT,
-            self::HTTP_VERSION_NOT_SUPPORTED,
-            self::VARIANT_ALSO_NEGOTIATES,
-            self::INSUFFICIENT_STORAGE,
-            self::LOOP_DETECTED,
-            self::NOT_EXTENDED,
-            self::NETWORK_AUTHENTICATION_REQUIRED
-        ];
-    }

src/ncc/Enums/LogLevel.php

@@ -22,29 +22,65 @@
 
     namespace ncc\Enums;
 
-    final class LogLevel
+    use ncc\Utilities\Validate;
+
+    enum LogLevel : string
     {
-        public const SILENT = 'silent';
+        case SILENT = 'silent';
 
-        public const VERBOSE = 'verbose';
+        case VERBOSE = 'verbose';
 
-        public const DEBUG = 'debug';
+        case DEBUG = 'debug';
 
-        public const INFO = 'info';
+        case INFO = 'info';
 
-        public const WARNING = 'warn';
+        case WARNING = 'warn';
 
-        public const ERROR = 'error';
+        case ERROR = 'error';
 
-        public const FATAL = 'fatal';
+        case FATAL = 'fatal';
 
-        public const ALL = [
+        /**
-            self::SILENT,
+         * Checks if the current log level permits logging at the specified level.
-            self::VERBOSE,
+         *
-            self::DEBUG,
+         * @param LogLevel|null $current_level The log level to be checked. If null, the method returns false.
-            self::INFO,
+         * @return bool Returns true if logging is permitted at the specified level, otherwise false.
-            self::WARNING,
+         */
-            self::ERROR,
+        public function checkLogLevel(?LogLevel $current_level): bool
-            self::FATAL,
+        {
-        ];
+            if ($current_level === null)
+            {
+                return false;
+            }
+
+            return match ($current_level)
+            {
+                LogLevel::DEBUG => in_array($this, [LogLevel::DEBUG, LogLevel::VERBOSE, LogLevel::INFO, LogLevel::WARNING, LogLevel::FATAL, LogLevel::ERROR], true),
+                LogLevel::VERBOSE => in_array($this, [LogLevel::VERBOSE, LogLevel::INFO, LogLevel::WARNING, LogLevel::FATAL, LogLevel::ERROR], true),
+                LogLevel::INFO => in_array($this, [LogLevel::INFO, LogLevel::WARNING, LogLevel::FATAL, LogLevel::ERROR], true),
+                LogLevel::WARNING => in_array($this, [LogLevel::WARNING, LogLevel::FATAL, LogLevel::ERROR], true),
+                LogLevel::ERROR => in_array($this, [LogLevel::FATAL, LogLevel::ERROR], true),
+                LogLevel::FATAL => $this === LogLevel::FATAL,
+                default => false,
+            };
+        }
+
+        /**
+         * Converts the given string input to a LogLevel.
+         * If the input is invalid or not found, it defaults to LogLevel::INFO.
+         *
+         * @param string $input The input string to be converted to a LogLevel.
+         * @return LogLevel Returns the corresponding LogLevel for the input string or LogLevel::INFO if not found.
+         */
+        public static function fromOrDefault(string $input): LogLevel
+        {
+            $value = self::tryFrom($input);
+
+            if($value === null)
+            {
+                return self::INFO;
+            }
+
+            return $value;
+        }
     }

src/ncc/Enums/Options/BuildConfigurationOptions.php

@@ -22,15 +22,15 @@
 
     namespace ncc\Enums\Options;
 
-    final class BuildConfigurationOptions
+    enum BuildConfigurationOptions : string
     {
-        public const COMPRESSION = 'compression';
+        case COMPRESSION = 'compression';
 
-        public const REQUIRE_FILES = 'require_files';
+        case REQUIRE_FILES = 'require_files';
 
-        public const NCC_CONFIGURATION = 'ncc_configuration';
+        case NCC_CONFIGURATION = 'ncc_configuration';
 
-        public const OUTPUT_FILE = 'output_file';
+        case OUTPUT_FILE = 'output_file';
 
-        public const STATIC_DEPENDENCIES = 'static';
+        case STATIC_DEPENDENCIES = 'static';
     }

src/ncc/Enums/Options/BuildConfigurationOptions/CompressionOptions.php

@@ -22,11 +22,11 @@
 
     namespace ncc\Enums\Options\BuildConfigurationOptions;
 
-    final class CompressionOptions
+    enum CompressionOptions : string
     {
-        public const HIGH = 'high';
+        case HIGH = 'high';
 
-        public const MEDIUM = 'medium';
+        case MEDIUM = 'medium';
 
-        public const LOW = 'low';
+        case LOW = 'low';
     }

src/ncc/Enums/Options/BuildConfigurationValues.php

@@ -22,9 +22,9 @@
 
     namespace ncc\Enums\Options;
 
-    final class BuildConfigurationValues
+    enum BuildConfigurationValues : string
     {
-        public const DEFAULT = 'default';
+        case DEFAULT = 'default';
 
-        public const ALL = 'all';
+        case ALL = 'all';
     }

src/ncc/Enums/Options/ComponentDecodeOptions.php

@@ -22,7 +22,7 @@
 
     namespace ncc\Enums\Options;
 
-    final class ComponentDecodeOptions
+    enum ComponentDecodeOptions : string
     {
-        public const AS_FILE = 'as_file';
+        case AS_FILE = 'as_file';
     }

src/ncc/Enums/Options/InitializeProjectOptions.php

@@ -22,25 +22,25 @@
 
     namespace ncc\Enums\Options;
 
-    final class InitializeProjectOptions
+    enum InitializeProjectOptions : string
     {
         /**
          * A custom path to the project's source directory
          */
-        public const PROJECT_SRC_PATH = 'PROJECT_SRC_PATH';
+        case PROJECT_SRC_PATH = 'PROJECT_SRC_PATH';
 
         /**
          * A boolean option that indicates whether to overwrite the project file if it already exists
          */
-        public const OVERWRITE_PROJECT_FILE = 'OVERWRITE_PROJECT_FILE';
+        case OVERWRITE_PROJECT_FILE = 'OVERWRITE_PROJECT_FILE';
 
         /**
          * Composer Only, used to define the package's real version
          */
-        public const COMPOSER_PACKAGE_VERSION = 'COMPOSER_PACKAGE_VERSION';
+        case COMPOSER_PACKAGE_VERSION = 'COMPOSER_PACKAGE_VERSION';
 
         /**
          * Composer Only, used to define the package's update source
          */
-        public const COMPOSER_REMOTE_SOURCE = 'COMPOSER_REMOTE_SOURCE';
+        case COMPOSER_REMOTE_SOURCE = 'COMPOSER_REMOTE_SOURCE';
     }

src/ncc/Enums/Options/InstallPackageOptions.php

@@ -22,7 +22,7 @@
 
     namespace ncc\Enums\Options;
 
-    final class InstallPackageOptions
+    enum InstallPackageOptions : string
     {
         /**
          * Skips the installation of dependencies of the package
@@ -30,17 +30,23 @@
          * @warning This will cause the package to fail to import of
          *          the dependencies are not met
          */
-        public const SKIP_DEPENDENCIES = 'skip_dependencies';
+        case SKIP_DEPENDENCIES = 'skip-dependencies';
 
         /**
          * Reinstall all packages if they are already installed,
          * Including dependencies if they are being processed.
          */
-        public const REINSTALL = 'reinstall';
+        case REINSTALL = 'reinstall';
 
         /**
          * Installs a static version of the package if it's available
          * otherwise it will install non-static version
          */
-        public const PREFER_STATIC = 'prefer_static';
+        case PREFER_STATIC = 'prefer-static';
+
+        /**
+         * Forces ncc to build packages from source rather than trying to obtain
+         * a pre-built version of the package
+         */
+        case BUILD_SOURCE  = 'build-source';
     }

src/ncc/Enums/Options/ProjectOptions.php

@@ -22,7 +22,7 @@
 
     namespace ncc\Enums\Options;
 
-    final class ProjectOptions
+    enum ProjectOptions : string
     {
-        public const CREATE_SYMLINK = 'create_symlink';
+        case CREATE_SYMLINK = 'create_symlink';
     }

src/ncc/Enums/Options/RuntimeImportOptions.php

@@ -1,38 +0,0 @@
-<?php
-    /*
-     * Copyright (c) Nosial 2022-2023, all rights reserved.
-     *
-     *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
-     *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
-     *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
-     *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
-     *  conditions:
-     *
-     *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
-     *  of the Software.
-     *
-     *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-     *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
-     *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-     *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-     *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-     *  DEALINGS IN THE SOFTWARE.
-     *
-     */
-
-    namespace ncc\Enums\Options;
-
-    final class RuntimeImportOptions
-    {
-        /**
-         * Indicates if the import should require PHP's autoload.php file
-         * for the package (Only applies to PHP packages)
-         */
-        public const IMPORT_AUTOLOADER = 'import_autoloader';
-
-        /**
-         * Indicates if the import should require all static files
-         * for the package (Only applies to PHP packages)
-         */
-        public const IMPORT_STATIC_FILES = 'import_static_files';
-    }

src/ncc/Enums/PackageDirectory.php

@@ -22,21 +22,21 @@
 
     namespace ncc\Enums;
 
-    final class PackageDirectory
+    enum PackageDirectory : int
     {
-        public const ASSEMBLY = 0x61737365;
+        case ASSEMBLY = 0x61737365;
 
-        public const METADATA = 0x6D657461;
+        case METADATA = 0x6D657461;
 
-        public const INSTALLER = 0x696E7374;
+        case INSTALLER = 0x696E7374;
 
-        public const DEPENDENCIES = 0x64657065;
+        case DEPENDENCIES = 0x64657065;
 
-        public const EXECUTION_UNITS = 0x65786563;
+        case EXECUTION_UNITS = 0x65786563;
 
-        public const COMPONENTS = 0x636F6D70;
+        case COMPONENTS = 0x636F6D70;
 
-        public const RESOURCES = 0x7265736F;
+        case RESOURCES = 0x7265736F;
 
-        public const CLASS_POINTER = 0x636C6173;
+        case CLASS_POINTER = 0x636C6173;
     }

src/ncc/Enums/PackageStandardVersions.php

@@ -1,28 +0,0 @@
-<?php
-    /*
-     * Copyright (c) Nosial 2022-2023, all rights reserved.
-     *
-     *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
-     *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
-     *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
-     *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
-     *  conditions:
-     *
-     *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
-     *  of the Software.
-     *
-     *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-     *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
-     *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-     *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-     *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-     *  DEALINGS IN THE SOFTWARE.
-     *
-     */
-
-    namespace ncc\Enums;
-
-    final class PackageStandardVersions
-    {
-        public const VERSION_1 = '1.0';
-    }

src/ncc/Enums/PackageStructure.php

@@ -22,11 +22,11 @@
 
     namespace ncc\Enums;
 
-    final class PackageStructure
+    enum PackageStructure : int
     {
-        public const FILE_VERSION = 0x73746669;
+        case FILE_VERSION = 0x73746669;
 
-        public const FLAGS = 0x73736166;
+        case FLAGS = 0x73736166;
 
-        public const DIRECTORY = 0x6f746365;
+        case DIRECTORY = 0x6f746365;
     }

src/ncc/Enums/PackageStructureVersions.php

@@ -1,5 +1,5 @@
 <?php
-/*
+    /*
      * Copyright (c) Nosial 2022-2023, all rights reserved.
      *
      *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
@@ -20,25 +20,17 @@
      *
      */
 
-namespace ncc\Enums;
+    namespace ncc\Enums;
 
-    final class PackageStructureVersions
+    enum PackageStructureVersions : string
     {
         /**
          * ncc 1.0.0 to 1.0.3
          */
-        public const _1_0 = '1.0';
+        case _1_0 = '1.0';
 
         /**
          * ncc 1.0.4 and above
          */
-        public const _2_0 = '2.0';
+        case _2_0 = '2.0';
-
-        /**
-         * All supported versions
-         */
-        public const ALL = [
-            self::_1_0,
-            self::_2_0
-        ];
     }

src/ncc/Enums/ProjectTemplates.php

@@ -22,23 +22,81 @@
 
     namespace ncc\Enums;
 
-    final class ProjectTemplates
+    enum ProjectTemplates : string
     {
         /**
          * A template that is used to create a PHP library project
          */
-        public const PHP_LIBRARY = 'phplib';
+        case PHP_LIBRARY = 'phplib';
 
         /**
          * A template that is used to create a PHP CLI application project
          */
-        public const PHP_CLI = 'phpcli';
+        case PHP_CLI = 'phpcli';
 
         /**
-         * An array of all the available project templates
+         * A template for generating a Makefile for the PHP project
          */
-        public const ALL = [
+        case PHP_MAKE = 'phpmake';
-            self::PHP_LIBRARY,
+
-            self::PHP_CLI
+        /**
-        ];
+         * A template used for creating PHP Unit testing bootstrap
+         */
+        case PHP_UNIT = 'phpunit';
+
+        /**
+         * A template that is used to create a PHP executable project
+         */
+        case PHP_COMPRESSED = 'phpgz';
+
+        /**
+         * A template that is used to create a PHP executable project
+         */
+        case PHP_EXECUTABLE = 'phpexe';
+
+        /**
+         * Template that combines PHP_LIBRARY, PHP_MAKE and PHP_UNIT in one
+         */
+        case PHP_LIBRARY_FULL = 'phplib_full';
+
+        /**
+         * Template that combines PHP_LIBRARY, PHP_MAKE, PHP_UNIT and PHP_CLI in one
+         */
+        case PHP_CLI_FULL = 'phpcli_full';
+
+        /**
+         * Template that applies a GitHub workflow CI that builds the project, tests the project and creates
+         * automatic builds for releases
+         */
+        case PHP_GITHUB_CI = 'phpci_github';
+
+        /**
+         * Suggests the closest matching `ProjectTemplates` instance based on the given input string.
+         *
+         * @param string $input The input string to compare against.
+         * @return ProjectTemplates|null The closest matching `ProjectTemplates` instance, or null if no close match is found.
+         */
+        public static function suggest(string $input): ?ProjectTemplates
+        {
+            $closest = null;
+            $shortest_distance = -1;
+
+            foreach (self::cases() as $case)
+            {
+                $distance = levenshtein($input, $case->value);
+
+                if ($distance === 0)
+                {
+                    return $case;
+                }
+
+                if ($shortest_distance === -1 || $distance < $shortest_distance)
+                {
+                    $closest = $case;
+                    $shortest_distance = $distance;
+                }
+            }
+
+            return $closest ?: null;
+        }
     }

src/ncc/Enums/RegexPatterns.php

@@ -26,27 +26,27 @@
      * @author Zi Xing Narrakas
      * @copyright Copyright (C) 2022-2023. Nosial - All Rights Reserved.
      */
-    final class RegexPatterns
+    enum RegexPatterns : string
     {
-        public const UUID = '{^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$}Di';
+        case UUID = '{^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$}Di';
 
-        public const PACKAGE_NAME_FORMAT = '/^[a-z][a-z0-9_]*(\.[a-z0-9_]+)+[0-9a-z_]$/';
+        case PACKAGE_NAME_FORMAT = '/^[a-z][a-z0-9_]*(\.[a-z0-9_]+)+[0-9a-z_]$/';
 
-        public const COMPOSER_VERSION_FORMAT = '/^([0-9]+)\.([0-9]+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+)?$/';
+        case COMPOSER_VERSION_FORMAT = '/^([0-9]+)\.([0-9]+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+)?$/';
 
-        public const PYTHON_VERSION_FORMAT = '/^([0-9]+)\.([0-9]+)\.([0-9]+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+)?$/';
+        case PYTHON_VERSION_FORMAT = '/^([0-9]+)\.([0-9]+)\.([0-9]+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+)?$/';
 
-        public const SEMANTIC_VERSIONING_2 = '/^(?P<major>0|[1-9]\d*)\.(?P<minor>0|[1-9]\d*)\.(?P<patch>0|[1-9]\d*)(?:-(?P<prerelease>(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+(?P<buildmetadata>[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/m';
+        case SEMANTIC_VERSIONING_2 = '/^(?P<major>0|[1-9]\d*)\.(?P<minor>0|[1-9]\d*)\.(?P<patch>0|[1-9]\d*)(?:-(?P<prerelease>(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+(?P<buildmetadata>[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/m';
 
-        public const UNIX_PATH = '/^(((?:\.\/|\.\.\/|\/)?(?:\.?\w+\/)*)(\.?\w+\.?\w+))$/m';
+        case UNIX_PATH = '/^(((?:\.\/|\.\.\/|\/)?(?:\.?\w+\/)*)(\.?\w+\.?\w+))$/m';
 
-        public const CONSTANT_NAME = '/^([^\x00-\x7F]|[\w_\ \.\+\-]){2,64}$/';
+        case CONSTANT_NAME = '/^([^\x00-\x7F]|[\w_.+]){2,64}$/';
 
-        public const EXECUTION_POLICY_NAME = '/^[_$a-zA-Z\xA0-\uFFFF][_$a-zA-Z0-9\xA0-\uFFFF]*$/m';
+        case EXECUTION_POLICY_NAME = '/^[_$a-zA-Z\xA0-\uFFFF][_$a-zA-Z0-9\xA0-\uFFFF]*$/m';
 
         /**
          * @author <purplex>
          */
-        public const REMOTE_PACKAGE = '/^(?<vendor>[^\/\n]+)\/(?<package>[^:=\n@]+)(?:=(?<version>[^:@\n]+))?(?::(?<branch>[^@\n]+))?@(?<source>.*)$/m';
+        case REMOTE_PACKAGE = '/^(?<vendor>[^\/\n]+)\/(?<package>[^:=\n@]+)(?:=(?<version>[^:@\n]+))?(?::(?<branch>[^@\n]+))?@(?<source>.*)$/m';
 
     }

src/ncc/Enums/Runners.php

@@ -22,25 +22,15 @@
 
     namespace ncc\Enums;
 
-    final class Runners
+    enum Runners : string
     {
-        public const PHP = 'php';
+        case PHP = 'php';
 
-        public const BASH = 'bash';
+        case BASH = 'bash';
 
-        public const PYTHON = 'python';
+        case PYTHON = 'python';
 
-        public const PERL = 'perl';
+        case PERL = 'perl';
 
-        public const LUA = 'lua';
+        case LUA = 'lua';
-
-        public const ALL = [
-            self::PHP,
-            self::BASH,
-            self::PYTHON,
-            self::PYTHON_3,
-            self::PYTHON_2,
-            self::PERL,
-            self::LUA
-        ];
     }

src/ncc/Enums/Scopes.php

@@ -22,9 +22,9 @@
 
     namespace ncc\Enums;
 
-    final class Scopes
+    enum Scopes : string
     {
-        public const USER = 'USER';
+        case USER = 'USER';
 
-        public const SYSTEM = 'SYSTEM';
+        case SYSTEM = 'SYSTEM';
     }

src/ncc/Enums/SpecialConstants/AssemblyConstants.php

@@ -22,50 +22,50 @@
 
     namespace ncc\Enums\SpecialConstants;
 
-    final class AssemblyConstants
+    enum AssemblyConstants : string
     {
         /**
          * Assembly's Name Property
          */
-        public const ASSEMBLY_NAME = '%ASSEMBLY.NAME%';
+        case ASSEMBLY_NAME = '%ASSEMBLY.NAME%';
 
         /**
          * Assembly's Package Property
          */
-        public const ASSEMBLY_PACKAGE = '%ASSEMBLY.PACKAGE%';
+        case ASSEMBLY_PACKAGE = '%ASSEMBLY.PACKAGE%';
 
         /**
          * Assembly's Description Property
          */
-        public const ASSEMBLY_DESCRIPTION = '%ASSEMBLY.DESCRIPTION%';
+        case ASSEMBLY_DESCRIPTION = '%ASSEMBLY.DESCRIPTION%';
 
         /**
          * Assembly's Company Property
          */
-        public const ASSEMBLY_COMPANY = '%ASSEMBLY.COMPANY%';
+        case ASSEMBLY_COMPANY = '%ASSEMBLY.COMPANY%';
 
         /**
          * Assembly's Product Property
          */
-        public const ASSEMBLY_PRODUCT = '%ASSEMBLY.PRODUCT%';
+        case ASSEMBLY_PRODUCT = '%ASSEMBLY.PRODUCT%';
 
         /**
          * Assembly's Copyright Property
          */
-        public const ASSEMBLY_COPYRIGHT = '%ASSEMBLY.COPYRIGHT%';
+        case ASSEMBLY_COPYRIGHT = '%ASSEMBLY.COPYRIGHT%';
 
         /**
          * Assembly's Trademark Property
          */
-        public const ASSEMBLY_TRADEMARK = '%ASSEMBLY.TRADEMARK%';
+        case ASSEMBLY_TRADEMARK = '%ASSEMBLY.TRADEMARK%';
 
         /**
          * Assembly's Version Property
          */
-        public const ASSEMBLY_VERSION = '%ASSEMBLY.VERSION%';
+        case ASSEMBLY_VERSION = '%ASSEMBLY.VERSION%';
 
         /**
          * Assembly's UUID property
          */
-        public const ASSEMBLY_UID = '%ASSEMBLY.UID%';
+        case ASSEMBLY_UID = '%ASSEMBLY.UID%';
     }

src/ncc/Enums/SpecialConstants/BuildConstants.php

@@ -22,25 +22,25 @@
 
     namespace ncc\Enums\SpecialConstants;
 
-    final class BuildConstants
+    enum BuildConstants : string
     {
         /**
          * The Unix Timestamp for when the package was compiled
          */
-        public const COMPILE_TIMESTAMP = '%COMPILE_TIMESTAMP%';
+        case COMPILE_TIMESTAMP = '%COMPILE_TIMESTAMP%';
 
         /**
          * The version of NCC that was used to compile the package
          */
-        public const NCC_BUILD_VERSION = '%NCC_BUILD_VERSION%';
+        case NCC_BUILD_VERSION = '%NCC_BUILD_VERSION%';
 
         /**
          * NCC Build Flags exploded into spaces
          */
-        public const NCC_BUILD_FLAGS = '%NCC_BUILD_FLAGS%';
+        case NCC_BUILD_FLAGS = '%NCC_BUILD_FLAGS%';
 
         /**
          * NCC Build Branch
          */
-        public const NCC_BUILD_BRANCH = '%NCC_BUILD_BRANCH%';
+        case NCC_BUILD_BRANCH = '%NCC_BUILD_BRANCH%';
     }

src/ncc/Enums/SpecialConstants/DateTimeConstants.php

@@ -22,49 +22,49 @@
 
     namespace ncc\Enums\SpecialConstants;
 
-    final class DateTimeConstants
+    enum DateTimeConstants : string
     {
         // Day Format
 
         /**
          * Day of the month, 2 digits with leading zeros
          */
-        public const d = '%d%'; // 01 through 31
+        case d = '%d%'; // 01 through 31
 
         /**
          * A textual representation of a day, three letters
          */
-        public const D = '%D%'; // Mon through Sun
+        case D = '%D%'; // Mon through Sun
 
         /**
          * Day of the month without leading zeros
          */
-        public const j = '%j%'; // 1 through 31
+        case j = '%j%'; // 1 through 31
 
         /**
          * A full textual representation of the day of the week
          */
-        public const l = '%l%'; // Sunday through Saturday
+        case l = '%l%'; // Sunday through Saturday
 
         /**
          * ISO 8601 numeric representation of the day of the week
          */
-        public const N = '%N%'; // 1 (Monday) to 7 (Sunday)
+        case N = '%N%'; // 1 (Monday) to 7 (Sunday)
 
         /**
          * English ordinal suffix for the day of the month, 2 characters
          */
-        public const S = '%S%'; // st, nd, rd, th
+        case S = '%S%'; // st, nd, rd, th
 
         /**
          * Numeric representation of the day of the week
          */
-        public const w = '%w%'; // 0 (sunday) through 6 (Saturday)
+        case w = '%w%'; // 0 (sunday) through 6 (Saturday)
 
         /**
          * The day of the year (starting from 0)
          */
-        public const z = '%z%'; // 0 through 365
+        case z = '%z%'; // 0 through 365
 
 
 
@@ -73,7 +73,7 @@
         /**
          * ISO 8601 week number of year, weeks starting on Monday
          */
-        public const W = '%W%'; // 42 (42nd week in year)
+        case W = '%W%'; // 42 (42nd week in year)
 
 
 
@@ -82,27 +82,27 @@
         /**
          * A full textual representation of a month, such as January or March
          */
-        public const F = '%F%'; // January through December
+        case F = '%F%'; // January through December
 
         /**
          * Numeric representation of a month, with leading zeros
          */
-        public const m = '%m%'; // 01 through 12
+        case m = '%m%'; // 01 through 12
 
         /**
          * A short textual representation of a month, three letters
          */
-        public const M = '%M%'; // Jan through Dec
+        case M = '%M%'; // Jan through Dec
 
         /**
          * Numeric representation of a month, without leading zeros
          */
-        public const n = '%n%'; // 1 through 12
+        case n = '%n%'; // 1 through 12
 
         /**
          * Number of days in the given month
          */
-        public const t = '%t%'; // 28 through 31
+        case t = '%t%'; // 28 through 31
 
 
 
@@ -110,73 +110,73 @@
         /**
          * Whether it's a leap year
          */
-        public const L = '%L%'; // 1 (leap year), 0 otherwise
+        case L = '%L%'; // 1 (leap year), 0 otherwise
 
         /**
          * ISO 8601 week-numbering year. This has the same value as Y,
          * except that if the ISO week number (W) belongs to the previous
          * or next year, that year is used instead.
          */
-        public const o = '%o%'; // Same as Y, except that it use week number to decide which year it falls onto
+        case o = '%o%'; // Same as Y, except that it use week number to decide which year it falls onto
 
         /**
          * A full numeric representation of a year, at least 4 digits, with - for years BCE.
          */
-        public const Y = '%Y%'; // 1991, 2012, 2014, ...
+        case Y = '%Y%'; // 1991, 2012, 2014, ...
 
         /**
          * A two digit representation of a year
          */
-        public const y = '%y%'; // 91, 12, 14, ...
+        case y = '%y%'; // 91, 12, 14, ...
 
         // Time Format
         /**
          * Lowercase Ante meridiem and Post meridiem
          */
-        public const a = '%a%'; // am or pm
+        case a = '%a%'; // am or pm
 
         /**
          * Uppercase Ante meridiem and Post meridiem
          */
-        public const A = '%A%'; // AM or PM
+        case A = '%A%'; // AM or PM
 
         /**
          * Swatch Internet time
          */
-        public const B = '%B%'; // 000 through 999
+        case B = '%B%'; // 000 through 999
 
         /**
          * 12-hour format of an hour without leading zeros
          */
-        public const g = '%g%'; // 1 through 12
+        case g = '%g%'; // 1 through 12
 
         /**
          * 24-hour format of an hour without leading zeros
          */
-        public const G = '%G%'; // 0 through 23
+        case G = '%G%'; // 0 through 23
 
         /**
          * 12-hour format of an hour with leading zeros
          */
-        public const h = '%h%'; // 01 through 12
+        case h = '%h%'; // 01 through 12
 
         /**
          * 24-hour format of an hour with leading zeros
          */
-        public const H = '%H%'; // 01 through 23
+        case H = '%H%'; // 01 through 23
 
         /**
          * Minutes with leading zeros
          */
-        public const i = '%i%'; // 01 through 59
+        case i = '%i%'; // 01 through 59
 
         /**
          * Seconds with leading zeros
          */
-        public const s = '%s%'; // 00 through 59
+        case s = '%s%'; // 00 through 59
 
         // DateTime format
-        public const c = '%c%'; // 2004-02-12T15:19:21
+        case c = '%c%'; // 2004-02-12T15:19:21
-        public const r = '%r%'; // Thu, 21 Dec 2000 16:01:07
+        case r = '%r%'; // Thu, 21 Dec 2000 16:01:07
-        public const u = '%u%'; // Unix Timestamp (seconds since Jan 1 1970 00:00:00)
+        case u = '%u%'; // Unix Timestamp (seconds since Jan 1 1970 00:00:00)
     }

src/ncc/Enums/SpecialConstants/GeneralConstants.php

@@ -1,6 +1,6 @@
 <?php
     /*
-     * Copyright (c) Nosial 2022-2023, all rights reserved.
+     * Copyright (c) Nosial 2022-2024, all rights reserved.
      *
      *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
      *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
@@ -20,18 +20,18 @@
      *
      */
 
-    namespace ncc\Enums\Types;
+    namespace ncc\Enums\SpecialConstants;
 
-    final class BuiltinRemoteSourceType
+    enum GeneralConstants : string
     {
+
         /**
-         * The remote source indicates the package is to be
+         * The project's default build configuration
-         * fetched using the composer utility.
          */
-        public const COMPOSER = 'composer';
+        case DEFAULT_BUILD_CONFIGURATION = '%DEFAULT_BUILD_CONFIGURATION%';
 
-
+        /**
-        public const ALL = [
+         * Configurable build output path
-            self::COMPOSER
+         */
-        ];
+        case BUILD_OUTPUT_PATH = '%BUILD_OUTPUT_PATH%';
     }

src/ncc/Enums/SpecialConstants/InstallConstants.php

@@ -22,13 +22,13 @@
 
     namespace ncc\Enums\SpecialConstants;
 
-    final class InstallConstants
+    enum InstallConstants : string
     {
-        public const INSTALL_PATH = '%INSTALL_PATH%';
+        case INSTALL_PATH = '%INSTALL_PATH%';
 
-        public const INSTALL_PATH_BIN = '%INSTALL_PATH.BIN%';
+        case INSTALL_PATH_BIN = '%INSTALL_PATH.BIN%';
 
-        public const INSTALL_PATH_SRC = '%INSTALL_PATH.SRC%';
+        case INSTALL_PATH_SRC = '%INSTALL_PATH.SRC%';
 
-        public const INSTALL_PATH_DATA = '%INSTALL_PATH.DATA%';
+        case INSTALL_PATH_DATA = '%INSTALL_PATH.DATA%';
     }

src/ncc/Enums/SpecialConstants/RuntimeConstants.php

@@ -22,11 +22,11 @@
 
     namespace ncc\Enums\SpecialConstants;
 
-    final class RuntimeConstants
+    enum RuntimeConstants : string
     {
-        public const CWD = '%CWD%';
+        case CWD = '%CWD%';
-        public const PID = '%PID%';
+        case PID = '%PID%';
-        public const UID = '%UID%';
+        case UID = '%UID%';
-        public const GID = '%GID%';
+        case GID = '%GID%';
-        public const USER = '%USER%';
+        case USER = '%USER%';
     }

src/ncc/Enums/Types/AuthenticationType.php

@@ -22,15 +22,15 @@
 
     namespace ncc\Enums\Types;
 
-    final class AuthenticationType
+    enum AuthenticationType : int
     {
         /**
          * A combination of a username and password is used for authentication
          */
-        public const USERNAME_PASSWORD = 1;
+        case USERNAME_PASSWORD = 1;
 
         /**
          * A single private access token is used for authentication
          */
-        public const ACCESS_TOKEN = 2;
+        case ACCESS_TOKEN = 2;
     }

src/ncc/Enums/Types/BuildOutputType.php

@@ -22,8 +22,8 @@
 
     namespace ncc\Enums\Types;
 
-    final class BuildOutputType
+    enum BuildOutputType : string
     {
-        public const NCC_PACKAGE = 'ncc';
+        case NCC_PACKAGE = 'ncc';
-        public const EXECUTABLE = 'executable';
+        case EXECUTABLE = 'executable';
     }

src/ncc/Enums/Types/ComponentDataType.php

@@ -22,35 +22,25 @@
 
     namespace ncc\Enums\Types;
 
-    final class ComponentDataType
+    enum ComponentDataType : string
     {
         /**
          * Indicates whether the component is represented as an AST representation
          */
-        public const AST = 'ast';
+        case AST = 'ast';
 
         /**
          * Indicates whether the component is represented as plaintext
          */
-        public const PLAIN = 'plain';
+        case PLAIN = 'plain';
 
         /**
          * Indicates whether the component is represented as binary or executable
          */
-        public const BINARY = 'binary';
+        case BINARY = 'binary';
 
         /**
          * Indicates whether the component is represented as as a base64 encoded string (Raw bytes' representation)
          */
-        public const BASE64_ENCODED = 'b64enc';
+        case BASE64_ENCODED = 'b64enc';
-
-        /**
-         * All the possible data types of a component
-         */
-        public const ALL = [
-            self::AST,
-            self::PLAIN,
-            self::BINARY,
-            self::BASE64_ENCODED
-        ];
     }

src/ncc/Enums/Types/ComposerPackageTypes.php

@@ -22,12 +22,12 @@
 
     namespace ncc\Enums\Types;
 
-    final class ComposerPackageTypes
+    enum ComposerPackageTypes : string
     {
         /**
          * This is the default. It will copy the files to `vendor`
          */
-        public const LIBRARY = 'library';
+        case LIBRARY = 'library';
 
         /**
          * This denotes a project rather than a library. For example
@@ -37,7 +37,7 @@
          * to provide listings of projects to initialize when creating
          * a new workspace.
          */
-        public const PROJECT = 'project';
+        case PROJECT = 'project';
 
         /**
          * An empty package that contains requirements and will trigger
@@ -45,11 +45,11 @@
          * anything to the filesystem. As such, it does not require a
          * a dist or source key to be installable
          */
-        public const METAPACKAGE = 'metapackage';
+        case METAPACKAGE = 'metapackage';
 
         /**
          * A package of type `composer-plugin` may provide an installer
          * for other packages that have a custom type.
          */
-        public const COMPOSER_PLUGIN = 'composer-plugin';
+        case COMPOSER_PLUGIN = 'composer-plugin';
     }

src/ncc/Enums/Types/ComposerStabilityTypes.php

@@ -22,15 +22,15 @@
 
     namespace ncc\Enums\Types;
 
-    final class ComposerStabilityTypes
+    enum ComposerStabilityTypes : string
     {
-        public const DEV = 'dev';
+        case DEV = 'dev';
 
-        public const ALPHA = 'alpha';
+        case ALPHA = 'alpha';
 
-        public const BETA = 'beta';
+        case BETA = 'beta';
 
-        public const RC = 'rc';
+        case RC = 'rc';
 
-        public const STABLE ='stable';
+        case STABLE ='stable';
     }

src/ncc/Enums/Types/DependencySourceType.php

@@ -1,49 +0,0 @@
-<?php
-    /*
-     * Copyright (c) Nosial 2022-2023, all rights reserved.
-     *
-     *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
-     *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
-     *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
-     *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
-     *  conditions:
-     *
-     *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
-     *  of the Software.
-     *
-     *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-     *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
-     *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-     *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-     *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-     *  DEALINGS IN THE SOFTWARE.
-     *
-     */
-
-    namespace ncc\Enums\Types;
-
-    final class DependencySourceType
-    {
-        /**
-         * The dependency pointer does not point to a package
-         */
-        public const NONE = 'none';
-
-        /**
-         * Indicates if the dependency is statically linked and the
-         * reference points to the compiled package of the dependency
-         */
-        public const STATIC = 'static';
-
-        /**
-         * Indicates if the pointer reference points to a remote source
-         * to fetch the dependency from
-         */
-        public const REMOTE = 'remote';
-
-        /**
-         * Indicates if the pointer reference points to a relative file with the
-         * filename format "{package_name}=={version}.ncc" to fetch the dependency from
-         */
-        public const LOCAL = 'local';
-    }

src/ncc/Enums/Types/EncoderType.php

@@ -1,28 +0,0 @@
-<?php
-    /*
-     * Copyright (c) Nosial 2022-2023, all rights reserved.
-     *
-     *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
-     *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
-     *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
-     *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
-     *  conditions:
-     *
-     *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
-     *  of the Software.
-     *
-     *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-     *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
-     *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-     *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-     *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-     *  DEALINGS IN THE SOFTWARE.
-     *
-     */
-
-    namespace ncc\Enums\Types;
-
-    final class EncoderType
-    {
-        public const ZI_PROTO = '3';
-    }

src/ncc/Enums/Types/HttpRequestType.php

@@ -22,10 +22,10 @@
 
     namespace ncc\Enums\Types;
 
-    final class HttpRequestType
+    enum HttpRequestType : string
     {
-        public const GET = 'GET';
+        case GET = 'GET';
-        public const POST = 'POST';
+        case POST = 'POST';
-        public const PUT = 'PUT';
+        case PUT = 'PUT';
-        public const DELETE = 'DELETE';
+        case DELETE = 'DELETE';
     }

src/ncc/Enums/Types/ProjectType.php

@@ -22,14 +22,9 @@
 
     namespace ncc\Enums\Types;
 
-    final class ProjectType
+    enum ProjectType : string
     {
-        public const COMPOSER = 'composer';
+        case COMPOSER = 'composer';
 
-        public const NCC = 'ncc';
+        case NCC = 'ncc';
-
-        public const ALL = [
-            self::COMPOSER,
-            self::NCC,
-        ];
     }

src/ncc/Enums/Types/RemoteSourceType.php

@@ -1,56 +0,0 @@
-<?php
-    /*
-     * Copyright (c) Nosial 2022-2023, all rights reserved.
-     *
-     *  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
-     *  associated documentation files (the "Software"), to deal in the Software without restriction, including without
-     *  limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
-     *  Software, and to permit persons to whom the Software is furnished to do so, subject to the following
-     *  conditions:
-     *
-     *  The above copyright notice and this permission notice shall be included in all copies or substantial portions
-     *  of the Software.
-     *
-     *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-     *  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
-     *  PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-     *  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-     *  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-     *  DEALINGS IN THE SOFTWARE.
-     *
-     */
-
-    namespace ncc\Enums\Types;
-
-    final class RemoteSourceType
-    {
-        /**
-         * A builtin source type is not defined by the user but handled by
-         * an extension built into NCC
-         */
-        public const BUILTIN = 'builtin';
-
-        /**
-         * A defined source type is defined by the user in the remote sources file
-         * and handled by an extension designed by passing on the information of
-         * the source to the extension
-         */
-        public const DEFINED = 'defined';
-
-        /**
-         * Unsupported or invalid source type
-         */
-        public const UNKNOWN = 'unknown';
-
-        /**
-         * No remote source type
-         */
-        public const NONE = 'none';
-
-        public const All = [
-            self::BUILTIN,
-            self::DEFINED,
-            self::UNKNOWN,
-            self::NONE
-        ];
-    }

src/ncc/Enums/Types/RepositoryResultType.php

@@ -22,9 +22,9 @@
 
     namespace ncc\Enums\Types;
 
-    final class RepositoryResultType
+    enum RepositoryResultType : string
     {
-        public const SOURCE = 'source';
+        case SOURCE = 'source';
 
-        public const PACKAGE = 'package';
+        case PACKAGE = 'package';
     }

src/ncc/Enums/Types/RepositoryType.php

@@ -22,20 +22,13 @@
 
     namespace ncc\Enums\Types;
 
-    final class RepositoryType
+    enum RepositoryType : string
     {
-        public const GITLAB = 'gitlab';
+        case GITLAB = 'gitlab';
 
-        public const GITHUB = 'github';
+        case GITHUB = 'github';
 
-        public const GITEA = 'gitea';
+        case GITEA = 'gitea';
 
-        public const PACKAGIST = 'packagist';
+        case PACKAGIST = 'packagist';
-
-        public const ALL = [
-            self::GITLAB,
-            self::GITHUB,
-            self::GITEA,
-            self::PACKAGIST
-        ];
     }

src/ncc/Enums/Versions.php

@@ -22,25 +22,15 @@
 
     namespace ncc\Enums;
 
-    final class Versions
+    enum Versions : string
     {
         /**
          * The current version of the credentials store file format
          */
-        public const CREDENTIALS_STORE_VERSION = '1.0.0';
+        case CREDENTIALS_STORE_VERSION = '1.0.0';
-
-        /**
-         * The current version of the package structure file format
-         */
-        public const PACKAGE_STRUCTURE_VERSION = '2.0';
-
-        /**
-         * The current version of the package lock structure file format
-         */
-        public const PACKAGE_LOCK_VERSION = '2.0.0';
 
         /**
          * Generic version of the package structure file format (latest)
          */
-        public const LATEST = 'latest';
+        case LATEST = 'latest';
     }

src/ncc/Exceptions/ArchiveException.php

@@ -34,6 +34,6 @@
          */
         public function __construct(string $message = "", ?Throwable $previous = null)
         {
-            parent::__construct($message, ExceptionCodes::ARCHIVE_EXCEPTION, $previous);
+            parent::__construct($message, ExceptionCodes::ARCHIVE_EXCEPTION->value, $previous);
         }
     }

src/ncc/Exceptions/AuthenticationException.php

@@ -34,6 +34,6 @@
          */
         public function __construct(string $message = "", ?Throwable $previous = null)
         {
-            parent::__construct($message, ExceptionCodes::AUTHENTICATION_EXCEPTION, $previous);
+            parent::__construct($message, ExceptionCodes::AUTHENTICATION_EXCEPTION->value, $previous);
         }
     }

src/ncc/Exceptions/BuildException.php

@@ -34,6 +34,6 @@ namespace ncc\Exceptions;
          */
         public function __construct(string $message = "", ?Throwable $previous = null)
         {
-            parent::__construct($message, ExceptionCodes::BUILD_EXCEPTION, $previous);
+            parent::__construct($message, ExceptionCodes::BUILD_EXCEPTION->value, $previous);
         }
     }

src/ncc/Exceptions/ComposerException.php

@@ -34,6 +34,6 @@ namespace ncc\Exceptions;
          */
         public function __construct(string $message = "", ?Throwable $previous = null)
         {
-            parent::__construct($message, ExceptionCodes::COMPOSER_EXCEPTION, $previous);
+            parent::__construct($message, ExceptionCodes::COMPOSER_EXCEPTION->value, $previous);
         }
     }

src/ncc/Exceptions/ConfigurationException.php

@@ -34,6 +34,6 @@
          */
         public function __construct(string $message = "", ?Throwable $previous = null)
         {
-            parent::__construct($message, ExceptionCodes::CONFIGURATION_EXCEPTION, $previous);
+            parent::__construct($message, ExceptionCodes::CONFIGURATION_EXCEPTION->value, $previous);
         }
     }