Release/v0.1.3

CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [[v0.1.3](https://github.com/The-FireHub-Project/Runtime/compare/v0.1.2...v0.1.3)] – 2026-08-03
+
+### Added
+* Add `RegexFlag` enum by @dieselxxx
+
 ## [[v0.1.2](https://github.com/The-FireHub-Project/Runtime/compare/v0.1.1...v0.1.2)] – 2026-07-29
 
 ### Added

README.md

@@ -12,7 +12,7 @@
   /></a>
   <a href="#">
     <img
-      src="https://img.shields.io/badge/Version-0.1.1-d50000?style=flat&labelColor=30363d&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAzMzMuNjUxIDM4Ny4wOSI+CiAgICA8dGl0bGU+RmlyZWh1YiBJY29uPC90aXRsZT4KICAgIDxzdHlsZT4KICAgICAgICAuY29sb3Ige2ZpbGw6ICNkNTAwMDA7fQogICAgPC9zdHlsZT4KICAgIDxnPgogICAgICAgIDxwYXRoIGNsYXNzPSJjb2xvciIgZD0iTTI2Ny4xMDYsMjYyLjU2MWMxMC41LTE3LjYzMSwxOS42My0zNi45MzEsMjAuMTItNTcuNDUxYzAuNDktMjAuNTItOS42LTQyLjQxOS0yOC40Ni01MC41MmM1LjcxLDkuNjcsMTAuMjUsMjAuNjIsOS4yOCwzMS44MWMtMC45NywxMS4xOS04Ljg2LDIyLjM3LTIwLDI0Yy0xMC40OSwxLjUyOS0yMC43Ny01Ljg1MS0yNS41MS0xNS4zNGMtNC43NC05LjQ5MS00LjYyLTIwLjU2MS00LTMxLjE1QzIyNC4zOTYsNTYuMTcsMTQyLjA0Niw1Ljk0LDEyNy4yODYsMGMwLDAsMTEuNDksMTIuMzksMTMuODgsMzAuNTNjMS45LDE0LjQ0LDAuMTcsMjkuMjItMy4zNCw0My4yNGMtMTAuODgsNDMuMzUtMzYuODYsNzcuODItNTguNTksMTE2Yy0xNC41OCwyNS41OC0yNCw1NC4wNS0yMy4zMiw4My42OWMwLjc2LDM0LDE2LDY3LjksNDIuNzMsODguODdjMTMuMDUsMTAuMjI5LDI4LjMyLDE3LjY1LDQzLjg0LDIzLjI5Yy0yLjE5LTIuNjItNC44NS01LjYyLTctOC42MDFjLTE4LjY4LTI1LjkzOS0zMi4yNi01MS41LTMzLjE3LTg0LjEwOWMtMC43Ny0yOC4yMyw3LjQtNTMuOTMsMTUuMTQtODAuNjFjLTAuOTEsMy4xNCwxLjgzLDEwLjcsMi4xLDE0LjIxYzAuNDEsNS40LDAuNDYsMTAuODIsMC41LDE2LjIyMWMwLjA4LDExLjQ3LTAuMTQsMjMsMS4zMiwzNC4zNzljMy40MiwyNi43NCwxOC4yOCw0OS43MTEsNDMuMjYsNjEuMjAxYy04LjQ3LTE5LjY5LTkuMzEtMzYuMzAxLTEuMjgtNTYuNzIxYzYuMDUtMTUuMzY5LDE0LjcxLTI5Ljc3OSwxOC45NC00NS43NWM4LjYzLTMyLjU2LTIuNDItNjcuNjQtMjAuNzUtOTUuODljMTcuMzIsMTUuMzEsMzIsMzQuNDUsMzguMyw1Ni43YzcuMzYsMjYsMi44Niw1My41NiwwLDgwLjM5Yy0yLjUxLDIzLjIxLTMuNzEsNDgsNS40Miw3MC4wNWM4LDE5LjIzLDIyLjQsMjkuNTIxLDM5LjUxLDQwYy0zLjY0NC0zLjAxMS02LjU2Ni02LjgtOC41NS0xMS4wOWMtOS4xNi0xOC4zNy02LjczLTQwLjY2LDAuNzktNTkuNzZTMjU2LjYxNiwyODAuMiwyNjcuMTA2LDI2Mi41NjF6Ii8+CiAgICAgICAgPHBhdGggY2xhc3M9ImNvbG9yIiBkPSJNMTczLjEzNiwyMi40M2M1LjA3OCw0Ljk5MSw5Ljg3MiwxMC4yNjIsMTQuMzYsMTUuNzljMS43NzMsMi4xODcsMy40ODMsNC40LDUuMTMsNi42NGM3OS42NzQsMTQuMjQ0LDEzMi43MTYsOTAuMzgsMTE4LjQ3MiwxNzAuMDU0Yy02Ljk0NywzOC44NTctMjkuMjc2LDczLjI3LTYxLjkzMiw5NS40NDZjLTEuNDMsMy0yLjc3LDYtNCw5Yy0yLjUyOCw2LjM3Ny00LjMzLDEzLjAxOS01LjM3LDE5LjhjODIuODQ5LTQwLjMyOSwxMTcuMzE4LTE0MC4xODUsNzYuOTg5LTIyMy4wMzNDMjg5Ljg0OSw2MC43OSwyMzQuNjM1LDI0Ljc3NywxNzMuMTM2LDIyLjQzeiIvPgogICAgICAgIDxwYXRoIGNsYXNzPSJjb2xvciIgZD0iTTQ3LjA0NiwyNzMuNjA5di0wLjA4QzAuNDM1LDIwNy4zNTQsMTYuMjk2LDExNS45MjMsODIuNDcxLDY5LjMxM2MxNS4yNTQtMTAuNzQ0LDMyLjQyLTE4LjQ3Nyw1MC41NzUtMjIuNzgzYzAuMjEyLTQuOTYyLDAuMDA1LTkuOTMzLTAuNjItMTQuODZjLTAuMjUzLTEuODc1LTAuNjI0LTMuNzMxLTEuMTEtNS41NkM0MS4yOTksNDUuNzM4LTE1Ljc2MywxMzQuNjIzLDMuODY1LDIyNC42NGM3LjI4LDMzLjM5LDI0LjY0LDYzLjczOCw0OS43MzEsODYuOTRDNDkuNTU5LDI5OS4zMTQsNDcuMzUyLDI4Ni41Miw0Ny4wNDYsMjczLjYwOXoiLz4KICAgIDwvZz4KPC9zdmc+"
+      src="https://img.shields.io/badge/Version-0.1.3-d50000?style=flat&labelColor=30363d&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAzMzMuNjUxIDM4Ny4wOSI+CiAgICA8dGl0bGU+RmlyZWh1YiBJY29uPC90aXRsZT4KICAgIDxzdHlsZT4KICAgICAgICAuY29sb3Ige2ZpbGw6ICNkNTAwMDA7fQogICAgPC9zdHlsZT4KICAgIDxnPgogICAgICAgIDxwYXRoIGNsYXNzPSJjb2xvciIgZD0iTTI2Ny4xMDYsMjYyLjU2MWMxMC41LTE3LjYzMSwxOS42My0zNi45MzEsMjAuMTItNTcuNDUxYzAuNDktMjAuNTItOS42LTQyLjQxOS0yOC40Ni01MC41MmM1LjcxLDkuNjcsMTAuMjUsMjAuNjIsOS4yOCwzMS44MWMtMC45NywxMS4xOS04Ljg2LDIyLjM3LTIwLDI0Yy0xMC40OSwxLjUyOS0yMC43Ny01Ljg1MS0yNS41MS0xNS4zNGMtNC43NC05LjQ5MS00LjYyLTIwLjU2MS00LTMxLjE1QzIyNC4zOTYsNTYuMTcsMTQyLjA0Niw1Ljk0LDEyNy4yODYsMGMwLDAsMTEuNDksMTIuMzksMTMuODgsMzAuNTNjMS45LDE0LjQ0LDAuMTcsMjkuMjItMy4zNCw0My4yNGMtMTAuODgsNDMuMzUtMzYuODYsNzcuODItNTguNTksMTE2Yy0xNC41OCwyNS41OC0yNCw1NC4wNS0yMy4zMiw4My42OWMwLjc2LDM0LDE2LDY3LjksNDIuNzMsODguODdjMTMuMDUsMTAuMjI5LDI4LjMyLDE3LjY1LDQzLjg0LDIzLjI5Yy0yLjE5LTIuNjItNC44NS01LjYyLTctOC42MDFjLTE4LjY4LTI1LjkzOS0zMi4yNi01MS41LTMzLjE3LTg0LjEwOWMtMC43Ny0yOC4yMyw3LjQtNTMuOTMsMTUuMTQtODAuNjFjLTAuOTEsMy4xNCwxLjgzLDEwLjcsMi4xLDE0LjIxYzAuNDEsNS40LDAuNDYsMTAuODIsMC41LDE2LjIyMWMwLjA4LDExLjQ3LTAuMTQsMjMsMS4zMiwzNC4zNzljMy40MiwyNi43NCwxOC4yOCw0OS43MTEsNDMuMjYsNjEuMjAxYy04LjQ3LTE5LjY5LTkuMzEtMzYuMzAxLTEuMjgtNTYuNzIxYzYuMDUtMTUuMzY5LDE0LjcxLTI5Ljc3OSwxOC45NC00NS43NWM4LjYzLTMyLjU2LTIuNDItNjcuNjQtMjAuNzUtOTUuODljMTcuMzIsMTUuMzEsMzIsMzQuNDUsMzguMyw1Ni43YzcuMzYsMjYsMi44Niw1My41NiwwLDgwLjM5Yy0yLjUxLDIzLjIxLTMuNzEsNDgsNS40Miw3MC4wNWM4LDE5LjIzLDIyLjQsMjkuNTIxLDM5LjUxLDQwYy0zLjY0NC0zLjAxMS02LjU2Ni02LjgtOC41NS0xMS4wOWMtOS4xNi0xOC4zNy02LjczLTQwLjY2LDAuNzktNTkuNzZTMjU2LjYxNiwyODAuMiwyNjcuMTA2LDI2Mi41NjF6Ii8+CiAgICAgICAgPHBhdGggY2xhc3M9ImNvbG9yIiBkPSJNMTczLjEzNiwyMi40M2M1LjA3OCw0Ljk5MSw5Ljg3MiwxMC4yNjIsMTQuMzYsMTUuNzljMS43NzMsMi4xODcsMy40ODMsNC40LDUuMTMsNi42NGM3OS42NzQsMTQuMjQ0LDEzMi43MTYsOTAuMzgsMTE4LjQ3MiwxNzAuMDU0Yy02Ljk0NywzOC44NTctMjkuMjc2LDczLjI3LTYxLjkzMiw5NS40NDZjLTEuNDMsMy0yLjc3LDYtNCw5Yy0yLjUyOCw2LjM3Ny00LjMzLDEzLjAxOS01LjM3LDE5LjhjODIuODQ5LTQwLjMyOSwxMTcuMzE4LTE0MC4xODUsNzYuOTg5LTIyMy4wMzNDMjg5Ljg0OSw2MC43OSwyMzQuNjM1LDI0Ljc3NywxNzMuMTM2LDIyLjQzeiIvPgogICAgICAgIDxwYXRoIGNsYXNzPSJjb2xvciIgZD0iTTQ3LjA0NiwyNzMuNjA5di0wLjA4QzAuNDM1LDIwNy4zNTQsMTYuMjk2LDExNS45MjMsODIuNDcxLDY5LjMxM2MxNS4yNTQtMTAuNzQ0LDMyLjQyLTE4LjQ3Nyw1MC41NzUtMjIuNzgzYzAuMjEyLTQuOTYyLDAuMDA1LTkuOTMzLTAuNjItMTQuODZjLTAuMjUzLTEuODc1LTAuNjI0LTMuNzMxLTEuMTEtNS41NkM0MS4yOTksNDUuNzM4LTE1Ljc2MywxMzQuNjIzLDMuODY1LDIyNC42NGM3LjI4LDMzLjM5LDI0LjY0LDYzLjczOCw0OS43MzEsODYuOTRDNDkuNTU5LDI5OS4zMTQsNDcuMzUyLDI4Ni41Miw0Ny4wNDYsMjczLjYwOXoiLz4KICAgIDwvZz4KPC9zdmc+"
       alt="version"  
   /></a>  
   <a href="./LICENSE">

src/Type/Str/RegexFlag.php

@@ -0,0 +1,161 @@
+<?php declare(strict_types = 1);
+
+/**
+ * This file is part of the FireHub Project ecosystem
+ *
+ * @author Danijel Galić <danijel.galic@outlook.com>
+ * @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 regular expression flags for string pattern operations
+ *
+ * Provides a set of flags that modify the behavior of regular expression processing when performing pattern-based
+ * operations on strings.
+ *
+ * These flags control matching behavior such as case sensitivity, multiline handling, UTF mode, extended patterns,
+ * and other PCRE-specific options.
+ */
+enum RegexFlag:string {
+
+    /**
+     * ### Makes the expression match case-insensitive
+     *
+     * If this modifier is set, letters in the pattern match both upper and lower case letters.
+     * @since 1.0.0
+     */
+    case CASELESS = 'i';
+
+    /**
+     * ### Multiline characters
+     *
+     * By default, PCRE treats the subject string as consisting of a single "line" of characters (even if it actually
+     * contains several newlines). The "start of line" metacharacter (^) matches only at the start of the string, while
+     * the "end of line" metacharacter ($) matches only at the end of the string, or before a terminating newline
+     * (unless D modifier is set). This is the same as Perl. When this modifier is set, the "start of line" and
+     * "end of line" constructs match immediately following or immediately before any newline in the subject string,
+     * respectively, as well as at the very start and end. This is equivalent to Perl's /m modifier.
+     * If there are no "\n" characters in a subject string, or no occurrences of ^ or $ in a pattern, setting this
+     * modifier has no effect.
+     * @since 1.0.0
+     */
+    case MULTILINE = 'm';
+
+    /**
+     * ### Dot metacharacter matches all characters
+     *
+     * If this modifier is set, a dot metacharacter in the pattern matches all characters, including newlines.
+     * Without it, newlines are excluded. This modifier is equivalent to Perl's /s modifier. A negative class such as
+     * [^a] always matches a newline character, independent of the setting for this modifier.
+     * @since 1.0.0
+     */
+    case DOT_ALL = 's';
+
+    /**
+     * ### Dot metacharacter matches all characters
+     *
+     * If this modifier is set, whitespace data characters in the pattern are totally ignored except when escaped
+     * or inside a character class, and characters between an unescaped # outside a character class
+     * and the next newline character, inclusive, are also ignored.
+     * This is equivalent to Perl's /x modifier, and makes it possible to include commentary inside complicated
+     * patterns.
+     * Note, however, that this applies only to data characters.
+     * Whitespace characters may never appear within special character sequences in a pattern, for example, within
+     * the sequence (?( which introduces a conditional subpattern.
+     * @since 1.0.0
+     */
+    case EXTENDED = 'x';
+
+    /**
+     * ### Anchored
+     *
+     * If this modifier is set, the pattern is forced to be "anchored"; that is, it is constrained to match only at
+     * the start of the string which is being searched (the "subject string"). This effect can also be achieved by
+     * appropriate constructs in the pattern itself, which is the only way to do it in Perl.
+     * @since 1.0.0
+     */
+    case ANCHORED = 'A';
+
+    /**
+     * ### Dollar metacharacter matches only at the end
+     *
+     * If this modifier is set, a dollar metacharacter in the pattern matches only at the end of the subject string.
+     * Without this modifier, a dollar also matches immediately before the final character if it is a newline (but not
+     * before any other newlines). This modifier is ignored if m modifier is set. There is no equivalent to this
+     * modifier in Perl.
+     * @since 1.0.0
+     */
+    case DOLLAR_END_ONLY = 'D';
+
+    /**
+     * ### Extra analysis is performed
+     *
+     * When a pattern is going to be used several times, it is worth spending more time analyzing it to speed up
+     * the time taken for matching. If this modifier is set, then this extra analysis is performed. At present,
+     * studying a pattern is useful only for non-anchored patterns that don't have a single fixed starting character.
+     * @since 1.0.0
+     */
+    case EXTRA_ANALYSIS = 'S';
+
+    /**
+     * ### Inverts the greediness
+     *
+     * This modifier inverts the "greediness" of the quantifiers so that they aren't greedy by default, but become
+     * greedy if followed by ?. It is not compatible with Perl. It can also be set by a (?U) modifier setting within
+     * the pattern or by a question mark behind a quantifier (for example: .*?).
+     * @since 1.0.0
+     *
+     * @see https://www.php.net/manual/en/pcre.configuration.php#ini.pcre.backtrack-limit To see pcre.backtrack_limit
+     * configuration.
+     *
+     * @note It is usually not possible to match more than pcre.backtrack_limit characters in un greedy mode.
+     */
+    case UN_GREEDY = 'U';
+
+    /**
+     * ### Backslash in a pattern that is followed by a letter that has no special meaning causes an error
+     *
+     * This modifier turns on additional functionality of PCRE that is incompatible with Perl. Any backslash in
+     * a pattern that is followed by a letter that has no special meaning causes an error, thus reserving these
+     * combinations for future expansion. By default, as in Perl, a backslash followed by a letter with no special
+     * meaning is treated as a literal. There are at present no other features controlled by this modifier.
+     * @since 1.0.0
+     */
+    case EXTRA = 'X';
+
+    /**
+     * ### Extra analysis is performed
+     *
+     * The (?J) internal option setting changes the local PCRE_DUPNAMES option. Allow duplicate names for
+     * sub-patterns. As of PHP 7.2.0, J is supported as a modifier as well.
+     * @since 1.0.0
+     */
+    case INFO_J_CHANGED = 'J';
+
+    /**
+     * ### Pattern and subject strings are treated as UTF-8
+     *
+     * This modifier turns on additional functionality of PCRE that is incompatible with Perl. Pattern and subject
+     * strings are treated as UTF-8. An invalid subject will cause the preg_* function to match nothing; an invalid
+     * pattern will trigger an error of level E_WARNING. Five and six-octet UTF-8 sequences are regarded as invalid.
+     * @since 1.0.0
+     */
+    case MULTIBYTE = 'u';
+
+    /**
+     * ### Don't capture simple groups
+     *
+     * This modifier makes simple (xyz) groups non-capturing. Only named groups like (?<name>xyz) are captured.
+     * This only affects which groups are captured, it is still possible to use numbered subpattern references, and
+     * the matches array will still contain numbered results.
+     * @since 1.0.0
+     */
+    case NO_AUTO_CAPTURE = 'n';
+
+}