From 730deaca3a6dbfda6f04c156531ccb6572c09f62 Mon Sep 17 00:00:00 2001
From: shahzadamodassir <shahzadamodassir@gmail.com>
Date: Mon, 21 Oct 2024 03:34:05 +0530
Subject: [PATCH] Released regexp v1.0.0

---
 composer.json                          |  29 +++++++
 src/Common/Commons.php                 |  63 +++++++++++++++
 src/Data/RegExpMaker.php               |  33 ++++++++
 src/RegExp.php                         |  65 +++++++++++++++
 src/Resolver/BackReferenceResolver.php | 107 +++++++++++++++++++++++++
 src/function/RegExp.php                |  33 ++++++++
 6 files changed, 330 insertions(+)
 create mode 100644 composer.json
 create mode 100644 src/Common/Commons.php
 create mode 100644 src/Data/RegExpMaker.php
 create mode 100644 src/RegExp.php
 create mode 100644 src/Resolver/BackReferenceResolver.php
 create mode 100644 src/function/RegExp.php

diff --git a/composer.json b/composer.json
new file mode 100644
index 0000000..2172b1a
--- /dev/null
+++ b/composer.json
@@ -0,0 +1,29 @@
+{
+  "name": "javercel/regexp",
+  "description": "The RegExp object is used for matching text with a pattern.",
+  "type": "library",
+  "keywords": ["regexp", "regex", "phpregex"],
+  "license": "MIT",
+  "autoload": {
+    "files": [
+      "src/function/RegExp.php"
+    ],
+    "psr-4": {
+      "RegExp\\": "src/"
+    }
+  },
+  "authors": [
+    {
+      "name": "Coding Modassir",
+      "email": "codingmodassir@gmail.com",
+      "homepage": "https://github.com/lazervel"
+    },
+    {
+      "name": "Shahzada Modassir",
+      "email": "codingmodassir@gmail.com",
+      "homepage": "https://github.com/shahzadamodassir"
+    }
+  ],
+  "minimum-stability": "alpha",
+  "require": {}
+}
\ No newline at end of file
diff --git a/src/Common/Commons.php b/src/Common/Commons.php
new file mode 100644
index 0000000..0f66ee9
--- /dev/null
+++ b/src/Common/Commons.php
@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace RegExp\Common;
+
+use RegExp\Resolver\BackReferenceResolver;
+
+final class Commons extends BackReferenceResolver
+{
+  private const RANGE = '/%s|\\[(?:(\\d+)-(\\d+|\\*))\\]/';
+  public static $output = [];
+  private static $commons;
+
+  /**
+   * 
+   * @param array<string|int|array> $commons [required]
+   * @return void
+   */
+  public function __construct(array $commons)
+  {
+    self::$commons = $commons;
+  }
+
+  /**
+   * 
+   * @param array<string|int|array> $commons [required]
+   * @return \RegExp\Common\Commons
+   */
+  public static function store(array $commons)
+  {
+    return new self(BackReferenceResolver::resolve($commons, null));
+  }
+
+  /*
+  |-------------------------------------------------------------------------------------
+  | Method get() of Commons
+  |-------------------------------------------------------------------------------------
+  |
+  |
+  */
+  public static function fetch(?string $expression = null)
+  {
+    // Returns all stored commons if $expression is null
+    if ($expression===null)
+    {
+      return self::$commons;
+    }
+
+    // Otherwise returns the specific commons value with custom [Range] or [BackReference]
+    preg_replace_callback(\sprintf(self::RANGE, \trim(self::rReference('\\$'), '/')), function($matched)
+    {
+      $start = (int)($matched[1]);
+      \array_push(self::$output,
+        ...(\count($matched) >= 3 ? self::getRange($matched[2], $matched[3], self::makeGroup(self::$commons)) :
+        [self::findMatcher($start, self::makeGroup(self::$commons))])
+      );
+    }, $expression);
+
+    return self::$output;
+  }
+}
+?>
\ No newline at end of file
diff --git a/src/Data/RegExpMaker.php b/src/Data/RegExpMaker.php
new file mode 100644
index 0000000..0d85215
--- /dev/null
+++ b/src/Data/RegExpMaker.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace RegExp\Data;
+
+use RegExp\Resolver\BackReferenceResolver;
+use RegExp\RegExp;
+
+final class RegExpMaker
+{
+  private const RFLAGS = '/^(?!.*(.).*\1)[dimsuvy]+$/';
+  public const DEF_SRC = '(?:)';
+  private const FLAGS  = array(
+    'dotAll'      => '/(s)/',
+    'ignoreCase'  => '/(i)/',
+    'multiline'   => '/(m)/',
+    'hasIndices'  => '/(d)/',
+    'sticky'      => '/(y)/',
+    'unicode'     => '/(u)/',
+    'unicodeSets' => '/(v)/'
+  );
+
+  public function __construct(RegExp $regexp, $resolver, string $source, ?string $flags = null, array $commons)
+  {
+    $regexp->flags   = $flags;
+    $regexp->commons = BackReferenceResolver::resolve($commons, null);
+    $regexp->source  = BackReferenceResolver::resolve(BackReferenceResolver::addSlash($source), $regexp->commons, '\\%');
+    foreach(self::FLAGS as $prop => $rflag) ($regexp->$prop = @\preg_match($rflag, $regexp->flags ?? ''));
+    if ($flags && !@\preg_match(self::RFLAGS, $flags)) throw new \Exception("Invalid regular expression flags");
+  }
+}
+?>
\ No newline at end of file
diff --git a/src/RegExp.php b/src/RegExp.php
new file mode 100644
index 0000000..2d15cab
--- /dev/null
+++ b/src/RegExp.php
@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+namespace RegExp;
+
+use RegExp\Resolver\BackReferenceResolver;
+use RegExp\Data\RegExpMaker;
+
+class RegExp
+{
+  /**
+   * 
+   * 
+   * @var bool $dotAll,
+   * @var bool $ignoreCase
+   * @var bool $multiline
+   * @var bool $hasIndices
+   * @var bool $sticky
+   * @var bool $unicode
+   * @var bool $unicodeSets
+   */
+  public $dotAll, $ignoreCase, $multiline, $hasIndices, $sticky, $unicode, $unicodeSets;
+
+  /**
+   * 
+   * 
+   * @var string $source
+   * @var string $flags
+   * @var array  $commons
+   */
+  public $source, $flags, $commons;
+
+  /*
+  |-------------------------------------------------------------------------------------
+  | Regular Expression [RegExp]
+  |-------------------------------------------------------------------------------------
+  |
+  | Arrange Regular Expression Component core LIKE placeholder and source and flags
+  | Returns PHP Regular Expression Object in __toString format for use to searching and
+  |   replacing characters in strings
+  |
+  */
+  public function __toString()
+  {
+    return \sprintf('/%s/%s', $this->source, $this->flags);
+  }
+
+  /**
+   * Create a Regular Expression RegExp fn instance use to without new keyword
+   * A PHP regular expression is a pattern of characters. The pattern is used for
+   * searching and replacing characters in strings.
+   * 
+   * @param string|null $source  [required]
+   * @param string|null $flags   [optional]
+   * @param string|int  $commons [optional]
+   * 
+   * @return string RegExp
+   */
+  public function __construct(?string $source=RegExpMaker::DEF_SRC, ?string $flags = null, ...$commons)
+  {
+    return new RegExpMaker($this, \get_class_vars($this::class), $source, $flags, $commons);
+  }
+}
+?>
\ No newline at end of file
diff --git a/src/Resolver/BackReferenceResolver.php b/src/Resolver/BackReferenceResolver.php
new file mode 100644
index 0000000..891d5d6
--- /dev/null
+++ b/src/Resolver/BackReferenceResolver.php
@@ -0,0 +1,107 @@
+<?php
+
+declare(strict_types=1);
+
+namespace RegExp\Resolver;
+
+class BackReferenceResolver
+{
+  private const RBACK_REFERENCE = '/(?<!\\\)%s(-?\\d+)/';
+  private const RSPECIALCHARS   = '/([\/-])/';
+  private const DEF_REFERENCE   = '\\$';
+
+  /**
+   * 
+   * @param int   $index   [required]
+   * @param array $entries [required]
+   * @param array $extra   [optional]
+   * 
+   * @return mixed $matched
+   */
+  protected static function findMatcher(int $index, array $entries, array $extra = [])
+  {
+
+    $i = $index < 0 ? \count($entries) + $index : $index - 1;
+    return $entries[$i] ?? $extra[$i] ?? '';
+  }
+
+  public static function addSlash(string $source)
+  {
+    return \preg_replace(self::RSPECIALCHARS, '\\\$1', $source);
+  }
+
+  /**
+   * 
+   * @param mixed $target [required]
+   * @param mixed $forced [optional]
+   * 
+   * @return mixed $value
+   */
+  protected static function force($target, $forced="")
+  {
+    return !!$target ? $target : $forced;
+  }
+
+  /**
+   * 
+   * @param string|int $start   [required]
+   * @param string|int $end     [required]
+   * @param array      $groups  [required]
+   * 
+   * @return array $range
+   */
+  protected static function getRange($start, $end, array $groups)
+  {
+    $l = \count($groups) - 1;
+    return \array_slice($groups, (int)$start, ($end === '*' ? $l : (int)$end));
+  }
+
+  /**
+   * 
+   * @param string $reference [required]
+   * @return string BackReference Regular-Expression
+   */
+  protected static function rReference(string $reference)
+  {
+    return \sprintf(self::RBACK_REFERENCE, $reference);
+  }
+
+  /**
+   * 
+   * @param array $groups [required]
+   * @param mixed $extra  [required]
+   * @return array new-groups
+   */
+  protected static function makeGroup(array $groups, $extra = null)
+  {
+    $groups = (array)self::force($groups, (array)$extra);
+    return $groups;
+  }
+
+  /**
+   * 
+   * @param array|string $target    [required]
+   * @param array|null   $groups    [required]
+   * @param string       $reference [optional]
+   * 
+   * @return array
+   */
+  public static function resolve($target, ?array $groups, string $reference = self::DEF_REFERENCE)
+  {
+    $groups  = self::makeGroup((array)$groups, $target);
+    $pattern = self::rReference($reference);
+    $isArr   = \is_array($target);
+    $output  = (array)($target);
+
+    foreach($output as $i=>$value)
+    {
+      $output[$i] = \preg_replace_callback($pattern, function($matched) use ($groups)
+      {
+        return self::findMatcher((int)$matched[1], $groups);
+      }, (string) $value);
+    }
+    
+    return !$isArr ? \join('', $output) : $output;
+  }
+}
+?>
\ No newline at end of file
diff --git a/src/function/RegExp.php b/src/function/RegExp.php
new file mode 100644
index 0000000..3b1edd7
--- /dev/null
+++ b/src/function/RegExp.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+use RegExp\RegExp;
+
+/*
+│––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
+│ Regular Expression [RegExp]
+│––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
+│
+│ Create a Regular Expression RegExp fn instance use to without new keyword
+│ A PHP regular expression is a pattern of characters. The pattern is used for
+│ searching and replacing characters in strings.
+│
+*/
+
+if (!\function_exists('RegExp'))
+{
+  /**
+   * Create a Regular Expression RegExp fn instance use to without new keyword
+   * 
+   * @param string|null $source  [required]
+   * @param string|null $flags   [optional]
+   * @param string|int  $commons [optional]
+   * 
+   * @return string RegExp
+   */
+  function RegExp(?string $source = null, ?string $flags = null, ...$commons)
+  {
+    return (string) new RegExp($source, $flags, ...$commons);
+  }
+}
\ No newline at end of file