@valkyrjaio/valkyrja 26.0.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025-present Melech Mizrachi
+
+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 NONINFRINGEMENT. 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.

package/README.md

@@ -0,0 +1,136 @@
+<p align="center"><a href="https://valkyrja.io" target="_blank">
+    <img src="https://raw.githubusercontent.com/valkyrjaio/art/refs/heads/master/full-logo/orange/java.png" width="400">
+</a></p>
+
+# Valkyrja
+
+[Valkyrja][Valkyrja url] is a Java framework for web and console applications.
+
+## About Valkyrja
+
+> This repository contains the core code of the Valkyrja framework.
+
+Valkyrja (pronounced "Valk-ear-ya") is the Old Norse spelling for Valkyrie, a
+mythical creature that would guide warriors to Valhalla (the afterlife and a
+better place) after death. In a similar sense, the Valkyrja framework guides
+your application to be in a better state. Let this fast, light, and robust
+framework do the heavy lifting for your app.
+
+<p>
+    <a href="https://packagist.org/packages/valkyrja/valkyrja"><img src="https://poser.pugx.org/valkyrja/valkyrja-java/require/java" alt="Java Version Require"></a>
+    <a href="https://packagist.org/packages/valkyrja/valkyrja"><img src="https://poser.pugx.org/valkyrja/valkyrja-java/v" alt="Latest Stable Version"></a>
+    <a href="https://packagist.org/packages/valkyrja/valkyrja"><img src="https://poser.pugx.org/valkyrja/valkyrja-java/license" alt="License"></a>
+    <!-- <a href="https://packagist.org/packages/valkyrja/valkyrja"><img src="https://poser.pugx.org/valkyrja/valkyrja-java/downloads" alt="Total Downloads"></a>-->
+    <a href="https://scrutinizer-ci.com/g/valkyrjaio/valkyrja/?branch=26.x"><img src="https://scrutinizer-ci.com/g/valkyrjaio/valkyrja-java/badges/quality-score.png?b=26.x" alt="Scrutinizer"></a>
+    <a href="https://coveralls.io/github/valkyrjaio/valkyrja?branch=26.x"><img src="https://coveralls.io/repos/github/valkyrjaio/valkyrja-java/badge.svg?branch=26.x" alt="Coverage Status" /></a>
+    <a href="https://shepherd.dev/github/valkyrjaio/valkyrja"><img src="https://shepherd.dev/github/valkyrjaio/valkyrja-java/coverage.svg" alt="Psalm Shepherd" /></a>
+    <a href="https://sonarcloud.io/summary/new_code?id=valkyrjaio_valkyrja-java"><img src="https://sonarcloud.io/api/project_badges/measure?project=valkyrjaio_valkyrja-java&metric=sqale_rating" alt="Maintainability Rating" /></a>
+</p>
+
+## Build Status
+
+<table>
+    <tbody>
+        <tr>
+            <td>Linting</td>
+            <td>
+                <a href="https://github.com/valkyrjaio/valkyrja-java/actions/workflows/spotless.yml?query=branch%3A26.x"><img src="https://github.com/valkyrjaio/valkyrja-java/actions/workflows/spotless.yml/badge.svg?branch=26.x" alt="PHP Code Sniffer Build Status"></a>
+            </td>
+        </tr>
+        <tr>
+            <td>Coding Rules</td>
+            <td>
+                <a href="https://github.com/valkyrjaio/valkyrja-java/actions/workflows/phparkitect.yml?query=branch%3A26.x"><img src="https://github.com/valkyrjaio/valkyrja/actions/workflows/phparkitect.yml/badge.svg?branch=26.x" alt="PHPArkitect Build Status"></a>
+            </td>
+            <td>
+                <a href="https://github.com/valkyrjaio/valkyrja-java/actions/workflows/rector.yml?query=branch%3A26.x"><img src="https://github.com/valkyrjaio/valkyrja/actions/workflows/rector.yml/badge.svg?branch=26.x" alt="Rector Build Status"></a>
+            </td>
+        </tr>
+        <tr>
+            <td>Static Analysis</td>
+            <td>
+                <a href="https://github.com/valkyrjaio/valkyrja-java/actions/workflows/phpstan.yml?query=branch%3A26.x"><img src="https://github.com/valkyrjaio/valkyrja/actions/workflows/phpstan.yml/badge.svg?branch=26.x" alt="PHPStan Build Status"></a>
+            </td>
+            <td>
+                <a href="https://github.com/valkyrjaio/valkyrja-java/actions/workflows/psalm.yml?query=branch%3A26.x"><img src="https://github.com/valkyrjaio/valkyrja/actions/workflows/psalm.yml/badge.svg?branch=26.x" alt="Psalm Build Status"></a>
+            </td>
+        </tr>
+        <tr>
+            <td>Testing</td>
+            <td>
+                <a href="https://github.com/valkyrjaio/valkyrja-java/actions/workflows/phpunit.yml?query=branch%3A26.x"><img src="https://github.com/valkyrjaio/valkyrja/actions/workflows/phpunit.yml/badge.svg?branch=26.x" alt="PHPUnit Build Status"></a>
+            </td>
+            <td>
+                <a href="https://github.com/valkyrjaio/valkyrja-java/actions/workflows/validate-composer.yml?query=branch%3A26.x"><img src="https://github.com/valkyrjaio/valkyrja/actions/workflows/validate-composer.yml/badge.svg?branch=26.x" alt="Validate Composer Build Status"></a>
+            </td>
+        </tr>
+    </tbody>
+</table>
+
+## Documentation
+
+The Valkyrja [documentation][docs url] is baked into the repo so you can
+access it even when working offline.
+
+## Installation
+
+There are two ways to install the Valkyrja framework.
+
+### Application Skeleton
+
+Clone the [Valkyrja Application][Valkyrja Application url] and start from there.
+
+## Versioning and Release Process
+
+Valkyrja uses [semantic versioning][semantic versioning url] with a major
+release every year, and support for each major version for 2 years from the
+date of release.
+
+For more information view our
+[Versioning and Release Process documentation][Versioning and Release Process url].
+
+### Supported Versions
+
+Bug fixes will be provided until 3 months after the next major release. Security
+fixes will be provided for 2 years after the initial release.
+
+| Version | PHP (\*)  | Release | Bug Fixes Until | Security Fixes Until |
+| :------ | :-------- | :------ | :-------------- | :------------------- |
+| 26      | 8.4 - 8.6 | Q2 2026 | Q2 2027         | Q1 2028              |
+| 27      | 8.5 - 8.6 | Q1 2027 | Q2 2028         | Q1 2029              |
+| 28      | 8.6+      | Q1 2028 | Q2 2029         | Q1 2030              |
+
+(\*) Supported PHP versions
+
+## Contributing
+
+Valkyrja is an Open Source, community-driven project.
+
+Thank you for your interest in helping us develop, maintain, and release the
+Valkyrja framework!
+
+You can find more information in our
+[Contributing documentation][contributing url].
+
+## Security Issues
+
+If you discover a security vulnerability within Valkyrja, please follow our
+[disclosure procedure][security vulnerabilities url].
+
+## License
+
+The Valkyrja framework is open-sourced software licensed under
+the [MIT license][MIT license url]. You can view the
+[Valkyrja License here][license url].
+
+[Valkyrja url]: https://valkyrja.io
+[github main]: https://github.com/valkyrjaio
+[Valkyrja Application url]: https://github.com/valkyrjaio/application-java
+[docs url]: ./src/main/java/io/valkyrja/README.md
+[New Project Guide url]: src/main/java/io/valkyrja/GETTING_STARTED.md
+[Versioning and Release Process url]: ./src/main/java/io/valkyrja/VERSIONING_AND_RELEASE_PROCESS.md
+[security vulnerabilities url]: ./SECURITY.md
+[semantic versioning url]: https://semver.org/
+[MIT license url]: https://opensource.org/licenses/MIT
+[license url]: ./LICENSE.md
+[contributing url]: ./CONTRIBUTING.md

package/package.json

@@ -0,0 +1,63 @@
+{
+    "name": "@valkyrjaio/valkyrja",
+    "version": "26.0.0",
+    "description": "The Valkyrja Framework.",
+    "keywords": [
+        "framework",
+        "valkyrja"
+    ],
+    "homepage": "https://www.valkyrja.io",
+    "bugs": {
+        "url": "https://github.com/valkyrjaio/valkyrja-ts/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/valkyrjaio/valkyrja-ts.git"
+    },
+    "license": "MIT",
+    "author": "Melech Mizrachi <melechmizrachi@gmail.com>",
+    "type": "module",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "main": "index.js",
+    "directories": {
+        "test": "tests"
+    },
+    "files": [
+        "dist",
+        "src"
+    ],
+    "scripts": {
+        "typescript": "cd .github/ci/typescript && npm run check",
+        "typescript-outdated-check": "cd .github/ci/typescript && npm install && npm outdated",
+        "typescript-outdated-check-major-release": "cd .github/ci/typescript && npm install && npm outdated",
+        "typescript-npm-update": "cd .github/ci/typescript && npm update",
+        "eslint": "cd .github/ci/eslint && npm run fix",
+        "eslint-check": "cd .github/ci/eslint && npm run check",
+        "eslint-outdated-check": "cd .github/ci/eslint && npm install && npm outdated",
+        "eslint-outdated-check-major-release": "cd .github/ci/eslint && npm install && npm outdated",
+        "eslint-npm-update": "cd .github/ci/eslint && npm update",
+        "prettier": "cd .github/ci/prettier && npm run fix",
+        "prettier-check": "cd .github/ci/prettier && npm run check",
+        "prettier-outdated-check": "cd .github/ci/prettier && npm install && npm outdated",
+        "prettier-outdated-check-major-release": "cd .github/ci/prettier && npm install && npm outdated",
+        "prettier-npm-update": "cd .github/ci/prettier && npm update",
+        "vitest": "cd .github/ci/vitest && npm run check",
+        "vitest-coverage": "cd .github/ci/vitest && npm run coverage",
+        "vitest-outdated-check": "cd .github/ci/vitest && npm install && npm outdated",
+        "vitest-outdated-check-major-release": "cd .github/ci/vitest && npm install && npm outdated",
+        "vitest-npm-update": "cd .github/ci/vitest && npm update",
+        "root-outdated-check": "npm install && npm outdated",
+        "root-outdated-check-major-release": "npm install && npm outdated",
+        "root-and-suggested-outdated-check": "cd .github/ci/root-and-suggested && npm install && npm outdated",
+        "root-and-suggested-outdated-check-major-release": "cd .github/ci/root-and-suggested && npm install && npm outdated",
+        "root-and-suggested-npm-update": "cd .github/ci/root-and-suggested && npm update"
+    },
+    "engines": {
+        "node": ">=22"
+    }
+}

package/src/Valkyrja/Application/Constant/ApplicationInfo.ts

@@ -0,0 +1,26 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export class ApplicationInfo {
+    static readonly VERSION = '26.0.0' as const;
+    static readonly VERSION_BUILD_DATE_TIME = 'June 17 2026 09:06:29 MST' as const;
+    static readonly ASCII = `
+                 _ _               _
+     /\\   /\\__ _| | | ___   _ _ __(_) __ _
+     \\ \\ / / _\` | | |/ / | | | '__| |/ _\` |
+      \\ V / (_| | |   <| |_| | |  | | (_| |
+       \\_/ \\__,_|_|_|\\_\\\\__, |_| _/ |\\__,_|
+                        |___/   |__/
+    ` as const;
+    static readonly ICON = `\
+    ▗▄▄▖     ▗▄▄▖
+    ▝▜██▄▄▄▄▄██▛▘
+       ▝▜███▛▘
+          █` as const;
+}

package/src/Valkyrja/Application/Constant/ApplicationServiceId.ts

@@ -0,0 +1,16 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export class ApplicationServiceId {
+    static readonly ApplicationContract = 'Valkyrja.Application.Kernel.ApplicationContract' as const;
+    static readonly ConfigContract = 'Valkyrja.Application.Data.ConfigContract' as const;
+    static readonly CliConfigContract = 'Valkyrja.Application.Data.CliConfigContract' as const;
+    static readonly HttpConfigContract = 'Valkyrja.Application.Data.HttpConfigContract' as const;
+    static readonly Config = 'Valkyrja.Application.Data.Config' as const;
+}

package/src/Valkyrja/Application/Data/CliConfig.ts

@@ -0,0 +1,51 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { ApplicationInfo } from '../Constant/ApplicationInfo.js';
+import { ApplicationServiceId } from '../Constant/ApplicationServiceId.js';
+import { CliWithHttpApplicationComponentProvider } from '../Provider/CliWithHttpApplicationComponentProvider.js';
+import { CliServerServiceId } from '../../Cli/Server/Constant/CliServerServiceId.js';
+import { CliCommandName } from '../../Cli/Server/Constant/CommandName.js';
+
+import type { ApplicationContract } from '../Kernel/Contract/ApplicationContract.js';
+import type { ComponentProviderContract } from '../Provider/Contract/ComponentProviderContract.js';
+import type { CliConfigContract } from './Contract/CliConfigContract.js';
+
+export class CliConfig implements CliConfigContract {
+    static readonly id = ApplicationServiceId.CliConfigContract;
+
+    constructor(
+        public readonly namespace: string = 'App',
+        public readonly dir: string = process.cwd(),
+        public readonly version: string = ApplicationInfo.VERSION,
+        public readonly environment: string = 'production',
+        public readonly debugMode: boolean = false,
+        public readonly timezone: string = 'UTC',
+        public readonly key: string = 'some_secret_app_key',
+        public readonly dataPath: string = 'App/Provider/Data',
+        public readonly dataNamespace: string = 'App/Provider/Data',
+        public readonly applicationName: string = 'valkyrja',
+        public readonly defaultCommandName: string = CliCommandName.LIST,
+        public readonly providers: ComponentProviderContract[] = [new CliWithHttpApplicationComponentProvider()],
+        public readonly callbacks: ((app: ApplicationContract) => void)[] = [],
+        public readonly inputReceivedMiddleware: string[] = [
+            CliServerServiceId.CheckForHelpOptionsMiddleware,
+            CliServerServiceId.CheckForVersionOptionsMiddleware,
+            CliServerServiceId.CheckGlobalInteractionOptionsMiddleware,
+        ],
+        public readonly routeMatchedMiddleware: string[] = [],
+        public readonly routeNotMatchedMiddleware: string[] = [CliServerServiceId.CheckCommandForTypoMiddleware],
+        public readonly routeDispatchedMiddleware: string[] = [],
+        public readonly throwableCaughtMiddleware: string[] = [
+            CliServerServiceId.LogThrowableCaughtMiddleware,
+            CliServerServiceId.OutputThrowableCaughtMiddleware,
+        ],
+        public readonly exitedMiddleware: string[] = [],
+    ) {}
+}

package/src/Valkyrja/Application/Data/Config.ts

@@ -0,0 +1,31 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { ApplicationInfo } from '../Constant/ApplicationInfo.js';
+import { ApplicationComponentProvider } from '../Provider/ApplicationComponentProvider.js';
+
+import type { ApplicationContract } from '../Kernel/Contract/ApplicationContract.js';
+import type { ComponentProviderContract } from '../Provider/Contract/ComponentProviderContract.js';
+import type { ConfigContract } from './Contract/ConfigContract.js';
+
+export class Config implements ConfigContract {
+    constructor(
+        public readonly namespace: string = 'App',
+        public readonly dir: string = process.cwd(),
+        public readonly version: string = ApplicationInfo.VERSION,
+        public readonly environment: string = 'production',
+        public readonly debugMode: boolean = false,
+        public readonly timezone: string = 'UTC',
+        public readonly key: string = 'some_secret_app_key',
+        public readonly dataPath: string = 'App/Provider/Data',
+        public readonly dataNamespace: string = 'App/Provider/Data',
+        public readonly providers: ComponentProviderContract[] = [new ApplicationComponentProvider()],
+        public readonly callbacks: ((app: ApplicationContract) => void)[] = [],
+    ) {}
+}

package/src/Valkyrja/Application/Data/Contract/CliConfigContract.ts

@@ -0,0 +1,27 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { ConfigContract } from './ConfigContract.js';
+
+export interface CliConfigContract extends ConfigContract {
+    readonly applicationName: string;
+    readonly defaultCommandName: string;
+    readonly inputReceivedMiddleware: string[];
+    readonly routeMatchedMiddleware: string[];
+    readonly routeNotMatchedMiddleware: string[];
+    readonly routeDispatchedMiddleware: string[];
+    readonly throwableCaughtMiddleware: string[];
+    readonly exitedMiddleware: string[];
+}
+
+export namespace CliConfigContract {
+    export function instanceOf(value: unknown): value is CliConfigContract {
+        return typeof value === 'object' && value !== null && 'applicationName' in value;
+    }
+}

package/src/Valkyrja/Application/Data/Contract/ConfigContract.ts

@@ -0,0 +1,31 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { ApplicationContract } from '../../Kernel/Contract/ApplicationContract.js';
+import type { ComponentProviderContract } from '../../Provider/Contract/ComponentProviderContract.js';
+
+export interface ConfigContract {
+    readonly namespace: string;
+    readonly dir: string;
+    readonly version: string;
+    readonly environment: string;
+    readonly debugMode: boolean;
+    readonly timezone: string;
+    readonly key: string;
+    readonly dataPath: string;
+    readonly dataNamespace: string;
+    readonly providers: ComponentProviderContract[];
+    readonly callbacks: ((app: ApplicationContract) => void)[];
+}
+
+export namespace ConfigContract {
+    export function instanceOf(value: unknown): value is ConfigContract {
+        return typeof value === 'object' && value !== null && 'namespace' in value;
+    }
+}

package/src/Valkyrja/Application/Data/Contract/HttpConfigContract.ts

@@ -0,0 +1,26 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { ConfigContract } from './ConfigContract.js';
+
+export interface HttpConfigContract extends ConfigContract {
+    readonly requestReceivedMiddleware: string[];
+    readonly routeMatchedMiddleware: string[];
+    readonly routeNotMatchedMiddleware: string[];
+    readonly routeDispatchedMiddleware: string[];
+    readonly throwableCaughtMiddleware: string[];
+    readonly sendingResponseMiddleware: string[];
+    readonly terminatedMiddleware: string[];
+}
+
+export namespace HttpConfigContract {
+    export function instanceOf(value: unknown): value is HttpConfigContract {
+        return typeof value === 'object' && value !== null && 'requestReceivedMiddleware' in value;
+    }
+}

package/src/Valkyrja/Application/Data/HttpConfig.ts

@@ -0,0 +1,41 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { ApplicationInfo } from '../Constant/ApplicationInfo.js';
+import { ApplicationServiceId } from '../Constant/ApplicationServiceId.js';
+import { HttpApplicationComponentProvider } from '../Provider/HttpApplicationComponentProvider.js';
+
+import type { ApplicationContract } from '../Kernel/Contract/ApplicationContract.js';
+import type { ComponentProviderContract } from '../Provider/Contract/ComponentProviderContract.js';
+import type { HttpConfigContract } from './Contract/HttpConfigContract.js';
+
+export class HttpConfig implements HttpConfigContract {
+    static readonly id = ApplicationServiceId.HttpConfigContract;
+
+    constructor(
+        public readonly namespace: string = 'App',
+        public readonly dir: string = process.cwd(),
+        public readonly version: string = ApplicationInfo.VERSION,
+        public readonly environment: string = 'production',
+        public readonly debugMode: boolean = false,
+        public readonly timezone: string = 'UTC',
+        public readonly key: string = 'some_secret_app_key',
+        public readonly dataPath: string = 'App/Provider/Data',
+        public readonly dataNamespace: string = 'App/Provider/Data',
+        public readonly providers: ComponentProviderContract[] = [new HttpApplicationComponentProvider()],
+        public readonly callbacks: ((app: ApplicationContract) => void)[] = [],
+        public readonly requestReceivedMiddleware: string[] = [],
+        public readonly routeMatchedMiddleware: string[] = [],
+        public readonly routeNotMatchedMiddleware: string[] = [],
+        public readonly routeDispatchedMiddleware: string[] = [],
+        public readonly throwableCaughtMiddleware: string[] = [],
+        public readonly sendingResponseMiddleware: string[] = [],
+        public readonly terminatedMiddleware: string[] = [],
+    ) {}
+}

package/src/Valkyrja/Application/Directory/Directory.ts

@@ -0,0 +1,80 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export class Directory {
+    static basePath = process.cwd();
+    static appPath = 'app';
+    static dataPath = 'data';
+    static envPath = 'env';
+    static publicPath = 'public';
+    static resourcesPath = 'resources';
+    static srcPath = 'src';
+    static storagePath = 'storage';
+    static frameworkStoragePath = 'framework';
+    static cacheStoragePath = 'cache';
+    static logsStoragePath = 'logs';
+    static testsPath = 'tests';
+    static vendorPath = 'node_modules';
+
+    static appDirectory(path?: string): string {
+        return Directory.baseDirectory(Directory.appPath + Directory.path(path));
+    }
+
+    static baseDirectory(path?: string): string {
+        return Directory.basePath + Directory.path(path);
+    }
+
+    static path(path?: string): string {
+        return path !== undefined && path !== '' && !path.startsWith('/') ? '/' + path : (path ?? '');
+    }
+
+    static dataDirectory(path?: string): string {
+        return Directory.baseDirectory(Directory.dataPath + Directory.path(path));
+    }
+
+    static envDirectory(path?: string): string {
+        return Directory.baseDirectory(Directory.envPath + Directory.path(path));
+    }
+
+    static publicDirectory(path?: string): string {
+        return Directory.baseDirectory(Directory.publicPath + Directory.path(path));
+    }
+
+    static resourcesDirectory(path?: string): string {
+        return Directory.baseDirectory(Directory.resourcesPath + Directory.path(path));
+    }
+
+    static srcDirectory(path?: string): string {
+        return Directory.baseDirectory(Directory.srcPath + Directory.path(path));
+    }
+
+    static storageDirectory(path?: string): string {
+        return Directory.baseDirectory(Directory.storagePath + Directory.path(path));
+    }
+
+    static frameworkStorageDirectory(path?: string): string {
+        return Directory.storageDirectory(Directory.frameworkStoragePath + Directory.path(path));
+    }
+
+    static logsStorageDirectory(path?: string): string {
+        return Directory.storageDirectory(Directory.logsStoragePath + Directory.path(path));
+    }
+
+    static frameworkStorageCacheDirectory(path?: string): string {
+        return Directory.frameworkStorageDirectory(Directory.cacheStoragePath + Directory.path(path));
+    }
+
+    static testsDirectory(path?: string): string {
+        return Directory.baseDirectory(Directory.testsPath + Directory.path(path));
+    }
+
+    static vendorDirectory(path?: string): string {
+        return Directory.baseDirectory(Directory.vendorPath + Directory.path(path));
+    }
+}