@@ -22,25 +22,46 @@
/>
-[](https://github.com/The-FireHub-Project/Runtime/actions/workflows/PHPStan.yml)
-[](https://github.com/The-FireHub-Project/Runtime/actions/workflows/PHPUnit.yml)
-[](https://app.codecov.io/gh/The-FireHub-Project/Runtime/tree/develop)
-
-
+
+ 
&labelColor=31373e)
&labelColor=31373e)
Development Branch
+## Repository Purpose
-⚠️ **This is the `develop` branch**
+This repository provides a lightweight PHP runtime abstraction layer that wraps native PHP functionality into clean, consistent, and deterministic APIs.
-- Unstable
-- APIs may change without notice
-- Not intended for production use
+Its purpose is to reduce boilerplate and standardize common execution patterns across the FireHub ecosystem by offering ergonomic helper classes for arrays, strings, files, environment access, and other low-level runtime operations.
-## Branch Purpose
+It is strictly focused on execution-level concerns and does not contain domain logic, business rules, or framework-level orchestration. It exists to improve developer productivity while preserving native PHP behavior and ensuring zero framework coupling.
-The `develop` branch is the **primary integration branch** for all ongoing development.
+## Security
-It serves as the staging area where:
-- Feature branches are merged
-- Bug fixes are integrated
-- Experimental work is stabilized
-- Code is prepared for upcoming releases
+For security reporting and guidelines, please refer to our [SECURITY.md](https://github.com/The-FireHub-Project/.github/blob/master/.github/SECURITY.md) file.
-All **release branches** are created **from `develop`**.
+## Community
-## Stability Guarantee
+
+
+
-❌ No backward compatibility guarantee
-❌ APIs may change without notice
-❌ Behavior may be incomplete or inconsistent
-❌ Breaking changes are expected
+- Be sure to review the [Code of Conduct](https://github.com/The-FireHub-Project/.github/blob/master/.github/CODE_OF_CONDUCT.md).
+- Read a [Contributing](https://github.com/The-FireHub-Project/.github/blob/master/.github/CONTRIBUTING.md) file to see how you can contribute to this project.
+- Read our [Security policy](https://github.com/The-FireHub-Project/.github/blob/master/.github/SECURITY.md) file to see how you can report a vulnerability.
+- Review the project [Governance model](https://github.com/The-FireHub-Project/.github/blob/master/.github/GOVERNANCE.md), including roles, decision-making, RFC process, and releases.
-This branch is intended **only for contributors and advanced testers**.
+## Support
-## Composer Usage (Not Recommended)
+
-For internal testing only:
+For help with FireHub products, please refer to the following resources:
-```json
-{
- "require": {
- "the-firehub-project/runtime": "dev-develop"
- }
-}
-```
-⚠️ Never use dev-develop in production.
+- **General questions & discussions**: [GitHub Discussions](https://github.com/orgs/The-FireHub-Project/discussions)
+- **Bug reports & issues**: [Support](https://github.com/The-FireHub-Project/Runtime/issues)
+- **Documentation & guides**: [FireHub Docs](https://the-firehub-project.github.io)
+- **Commercial support** (Pro/Enterprise): contact your account manager
## Authors and Contributors
diff --git a/src/Filter.php b/src/Filter.php
new file mode 100644
index 0000000..b88799c
--- /dev/null
+++ b/src/Filter.php
@@ -0,0 +1,222 @@
+
+ * @copyright 2026-present The FireHub Project - All rights reserved
+ * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
+ *
+ * @php-version >=8.2
+ * @package Runtime
+ */
+
+namespace FireHub\Runtime;
+
+use FireHub\Core\Boundary\Runtime\NativeRuntime;
+
+use function filter_has_var;
+use function filter_id;
+use function filter_input;
+use function filter_input_array;
+use function filter_list;
+use function filter_var;
+use function filter_var_array;
+
+/**
+ * ### PHP Runtime Filter Utilities
+ *
+ * Provides low-level wrappers for native PHP filtering functions.
+ *
+ * Supports validation, sanitization, and inspection of filter types.
+ * @since 1.0.0
+ */
+final readonly class Filter extends NativeRuntime {
+
+ /**
+ * ### Filters a variable with a specified filter
+ * @since 1.0.0
+ *
+ * @param mixed $value + * Value to filter. + *
+ * @param int $filter [optional]+ * The filter to apply. Can be a validation filter by using one of the FILTER_VALIDATE_* constants, a + * sanitization filter by using one of the FILTER_SANITIZE_* or FILTER_UNSAFE_RAW, or a custom filter by using + * FILTER_CALLBACK. + *
+ * @param array+ * Either an associative array of options, or a bitmask of filter flag constants FILTER_FLAG_*. + * + * If the filter accepts options, flags can be provided by using the "flags" field of array. + *
+ * + * @return mixed On success returns the filtered data. On failure false is returned, unless the + * FILTER_NULL_ON_FAILURE flag is used, in which case null is returned. + */ + public static function value (mixed $value, int $filter = FILTER_UNSAFE_RAW, array|int $options = 0):mixed { + + return filter_var($value, $filter, $options); + + } + + /** + * ### Gets multiple variables and optionally filters them + * @since 1.0.0 + * + * @param array+ * An associative array containing the data to filter. + *
+ * @param array+ * Either an associative array of options, or the filter to apply to each entry, which can either be a validation + * filter by using one of the FILTER_VALIDATE_* constants, or a sanitization filter by using one of the + * FILTER_SANITIZE_* constants. + * + * The option array is an associative array where the key corresponds to a key in the input array and the + * associated value is either the filter to apply to this entry, or an associative array describing how and which + * filter should be applied to this entry. + * + * The associative array describing how a filter should be applied must contain the 'filter' key whose associated + * value is the filter to apply, which can be one of the FILTER_VALIDATE_*, FILTER_SANITIZE_*, FILTER_UNSAFE_RAW, + * or FILTER_CALLBACK constants. It can optionally contain the 'flags' key which specifies any flags that apply + * to the filter, and the 'options' key which specifies any options that apply to the filter. + *
+ * @param bool $add_empty [optional]+ * Add missing keys as null to the return value. + *
+ * + * @return array+ * Name of a filter to get. + *
+ * + * @return int|false D of a filter on success or false if filter doesn't exist. + */ + public static function id (string $name):int|false { + + return filter_id($name); + + } + + /** + * ### Gets a specific external variable by name and optionally filters it + * @since 1.0.0 + * + * @param 0|1|2|4|5 $type+ * One of the INPUT_* constants. + *
+ * @param string $name+ * Name of a variable to filter inside the corresponding type superglobal. + *
+ * @param int $filter [optional]+ * The filter to apply. Can be a validation filter by using one of the FILTER_VALIDATE_* constants, a + * sanitization filter by using one of the FILTER_SANITIZE_* or FILTER_UNSAFE_RAW, or a custom filter by using + * FILTER_CALLBACK. + *
+ * @param array+ * Either an associative array of options, or a bitmask of filter flag constants FILTER_FLAG_*. + * + * If the filter accepts options, flags can be provided by using the "flags" field of array. + *
+ * + * @return mixed Value of the requested variable on success, false if the filter fails, or null if the var_name + * variable is not set. If the flag FILTER_NULL_ON_FAILURE is used, it returns false if the variable is not set + * and null if the filter fails. + */ + public static function input (int $type, string $name, int $filter = FILTER_UNSAFE_RAW, array|int $options = 0):mixed { + + return filter_input($type, $name, $filter, $options); + + } + + /** + * ### Gets external variables and optionally filters them + * @since 1.0.0 + * + * @param 0|1|2|4|5 $type+ * One of the INPUT_* constants. + *
+ * @param array+ * Either an associative array of options, or the filter to apply to each entry, which can either be a + * validation filter by using one of the FILTER_VALIDATE_* constants, or a sanitization filter by using one of + * the FILTER_SANITIZE_* constants. + * + * The option array is an associative array where the key corresponds to a key in the input array and the + * associated value is either the filter to apply to this entry, or an associative array describing how and which + * filter should be applied to this entry. + * + * The associative array describing how a filter should be applied must contain the 'filter' key whose associated + * value is the filter to apply, which can be one of the FILTER_VALIDATE_*, FILTER_SANITIZE_*, FILTER_UNSAFE_RAW, + * or FILTER_CALLBACK constants. It can optionally contain the 'flags' key which specifies any flags that apply + * to the filter, and the 'options' key which specifies any options that apply to the filter. + *
+ * @param bool $add_empty [optional]+ * Add missing keys as null to the return value. + *
+ * + * @return array+ * One of INPUT_GET, INPUT_POST, INPUT_COOKIE, INPUT_SERVER, or INPUT_ENV. + *
+ * @param string $name+ * Name of a variable to check. + *
+ * + * @return bool Returns true on success or false on failure. + */ + public static function has (int $type, string $name):bool { + + return filter_has_var($type, $name); + + } + + /** + * ### Returns a list of all supported filters + * @since 1.0.0 + * + * @return list
