From 1d2c912cc858b9e678af3964b40173385abff838 Mon Sep 17 00:00:00 2001
From: Kei <budi03@gmail.com>
Date: Mon, 3 Feb 2025 12:23:45 +0700
Subject: [PATCH] conflicting

---
 app/Helpers/Helper.php | 23 ++++++++++++++++++-----
 1 file changed, 18 insertions(+), 5 deletions(-)

diff --git a/app/Helpers/Helper.php b/app/Helpers/Helper.php
index ba3e68700..57b671c84 100644
--- a/app/Helpers/Helper.php
+++ b/app/Helpers/Helper.php
@@ -73,7 +73,11 @@ public static function urlFormat(
     }
 
     /**
-     * List of potentially colliding routes with shortened link keywords.
+     * A list of route paths that could potentially conflict with shortened link
+     * keywords.
+     *
+     * This method retrieves all defined routes and filters them to identify potential
+     * conflicts with the format and reserved keywords used for shortened links.
      *
      * @return array
      */
@@ -81,13 +85,16 @@ public static function routeCollisionList()
     {
         return collect(\Illuminate\Support\Facades\Route::getRoutes()->get())
             ->map(fn(\Illuminate\Routing\Route $route) => $route->uri)
-            ->pipe(fn($value) => self::collisionCandidateFilter($value))
+            ->pipe(fn($paths) => self::collisionCandidateFilter($paths))
             ->toArray();
     }
 
     /**
-     * List of files/folders in the public/ directory that will potentially collide
-     * with shortened link keywords.
+     * A list of file/folder names in the public directory that could potentially
+     * conflict with shortened link keywords.
+     *
+     * This method scans the public directory and filters the file/folder names
+     * to identify potential conflicts with keywords used for shortened links.
      *
      * @return array
      */
@@ -99,11 +106,17 @@ public static function publicPathCollisionList()
         }
 
         return collect($publicPathList)
-            ->pipe(fn($value) => self::collisionCandidateFilter($value))
+            ->pipe(fn($paths) => self::collisionCandidateFilter($paths))
             ->toArray();
     }
 
     /**
+     * Filters a collection of strings to identify potential collisions with keywords.
+     *
+     * The resulting collection contains unique strings that "could potentially"
+     * clash with generated short link keywords. These strings are considered
+     * "collision candidates" because they have the same format as valid keywords
+     *
      * @param \Illuminate\Support\Collection $value
      * @return \Illuminate\Support\Collection
      */