@@ -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/Type/Str/RegexDelimiter.php b/src/Type/Str/RegexDelimiter.php
new file mode 100644
index 0000000..2a68dfc
--- /dev/null
+++ b/src/Type/Str/RegexDelimiter.php
@@ -0,0 +1,74 @@
+
+ * @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.1
+ * @package Runtime
+ */
+
+namespace FireHub\Runtime\Type\Str;
+
+/**
+ * ### Defines delimiters used for regular expression patterns
+ *
+ * Provides supported delimiters used to wrap regular expression patterns when performing PCRE-based string operations.
+ *
+ * Delimiters separate the pattern body from optional regular expression modifiers and help avoid unnecessary
+ * escaping of characters inside patterns.
+ */
+enum RegexDelimiter:string {
+
+ /**
+ * ### Forward slash delimiter
+ *
+ * The default delimiter is commonly used in PHP regular expressions.
+ * @since 1.0.0
+ */
+ case SLASH = '/';
+
+ /**
+ * ### Hash delimiter
+ *
+ * Useful for patterns containing forward slashes such as URLs and paths.
+ * @since 1.0.0
+ */
+ case HASH = '#';
+
+ /**
+ * ### Tilde delimiter
+ *
+ * Commonly used as an alternative delimiter for readable expressions.
+ * @since 1.0.0
+ */
+ case TILDE = '~';
+
+ /**
+ * ### Percent delimiter
+ *
+ * Alternative delimiter for reducing escaping requirements.
+ * @since 1.0.0
+ */
+ case PERCENT = '%';
+
+ /**
+ * ### At sign delimiter
+ *
+ * Alternative delimiter suitable for patterns containing common symbols.
+ * @since 1.0.0
+ */
+ case AT = '@';
+
+ /**
+ * ### Exclamation delimiter
+ *
+ * Alternative delimiter for expressions where other delimiters are present.
+ * @since 1.0.0
+ */
+ case EXCLAMATION = '!';
+
+}
\ No newline at end of file
