Version 3.0.0

.github/FUNDING.yml

@@ -1,4 +1,4 @@
 # These are supported funding model platforms
 
-github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+github: oliverearl
 ko_fi: oliverearl

.github/workflows/dependabot-auto-merge.yml

@@ -1,4 +1,4 @@
-name: dependabot-auto-merge
+name: Dependabot Auto-Merge
 on: pull_request_target
 
 permissions:

.github/workflows/fix-php-code-style-issues.yml

@@ -1,4 +1,4 @@
-name: Fix PHP code style issues
+name: Linting (Pint)
 
 on:
   push:
@@ -19,7 +19,7 @@ jobs:
         with:
           ref: ${{ github.head_ref }}
 
-      - name: Fix PHP code style issues
+      - name: Run Laravel Pint and fix styling issues
         uses: aglipanci/laravel-pint-action@2.6
 
       - name: Commit changes

.github/workflows/phpstan.yml

@@ -1,4 +1,4 @@
-name: PHPStan
+name: Static Analysis (Larastan)
 
 on:
   push:
@@ -24,5 +24,5 @@ jobs:
       - name: Install composer dependencies
         uses: ramsey/composer-install@v3
 
-      - name: Run PHPStan
+      - name: Run Larastan
         run: ./vendor/bin/phpstan --error-format=github

.github/workflows/run-tests.yml

@@ -1,4 +1,4 @@
-name: run-tests
+name: Automated Testing (Pest)
 
 on:
   push:
@@ -17,14 +17,12 @@ jobs:
       fail-fast: true
       matrix:
         os: [ubuntu-latest]
-        php: [8.4, 8.3]
-        laravel: [12.*, 11.*]
-        stability: [prefer-lowest, prefer-stable]
+        php: [8.4, 8.5]
+        laravel: [12.*]
+        stability: [prefer-stable]
         include:
           - laravel: 12.*
             testbench: 10.*
-          - laravel: 11.*
-            testbench: 9.*
 
     name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.stability }} - ${{ matrix.os }}
 
@@ -54,3 +52,11 @@ jobs:
 
       - name: Execute tests
         run: vendor/bin/pest --ci
+
+      - name: Check Type Coverage
+        if: matrix.stability == 'prefer-stable'
+        run: vendor/bin/pest --type-coverage=100
+
+      - name: Check Profanity
+        if: matrix.stability == 'prefer-stable'
+        run: vendor/bin/pest --profanity

.github/workflows/update-changelog.yml

@@ -1,4 +1,4 @@
-name: "Update Changelog"
+name: Update Changelog
 
 on:
   release:

README.md

@@ -14,7 +14,7 @@ large sets of data.
 
 ## Requirements
 
-Currently, requires PHP 8.3 or above, and Laravel 11+.
+Currently, requires PHP 8.4 or above, and Laravel 12+.
 
 ## Installation
 
@@ -79,35 +79,51 @@ $everything = FixedArray::merge(
 
 ## Full list of working methods
 
-| Method         | Description                                                                 |                                                       Example |
-|:---------------|:----------------------------------------------------------------------------|--------------------------------------------------------------:|
-| add            | Alias for push.                                                             |                              `FixedArray::add('bacon', $arr)` |
-| addFrom        | Add an array or collection of items to an array.                            |                        `FixedArray::addFrom([1, 2, 3], $arr)` |
-| contains       | Checks whether an item exists in a given array.                             |                   `FixedArray::contains('needle', $haystack)` |
-| count          | Returns the number of items in a given array.                               |                                   `FixedArray::count($array)` |
-| create         | Creates a new fixed array.                                                  |                                      `FixedArray::create(10)` |
-| each           | Apply a callback to each item in the array without modifying the original.  |         `FixedArray::each($array, fn () => var_dump($value))` |
-| filter         | Applies a filter to a given fixed array.                                    | `FixedArray::filter($array, fn ($value) => $value % 2 === 0)` |
-| first          | Returns the first element of the array.                                     |                                   `FixedArray::first($array)` |
-| fromArray      | Creates a new fixed array from a standard array.                            |                            `FixedArray::fromArray([1, 2, 3])` |
-| fromCollection | Creates a new fixed array from an Illuminate collection.                    |               `FixedArray::fromCollection(collect([1, 2, 3])` |
-| getSize        | Alias for count.                                                            |                                 `FixedArray::getSize($array)` |
-| isFixedArray   | Returns whether a given item is a fixed array.                              |                   `FixedArray::isFixedArray($potentialArray)` |
-| last           | Returns the last element in an array.                                       |                                    `FixedArray::last($array)` |
-| map            | Applies a callback to each item in the array and returns it.                |     `FixedArray::map($array, fn ($value) => (string) $value)` |
-| merge          | Merges given arrays, fixed arrays, or collections into a given fixed array. |                 `FixedArray::merge($array, $array2, $array3)` |
-| nullify        | Overwrite all elements in an array with `null`.                             |                                 `FixedArray::nullify($array)` |
-| offsetExists   | Returns whether a given array offset exists.                                |                      `FixedArray::offsetExists(3, $haystack)` |
-| offsetGet      | Retrieves the value at a given array offset.                                |                         `FixedArray::offsetGet(3, $haystack)` |
-| offsetNull     | Replaces the value at a given array offset with `null`.                     |                        `FixedArray::offsetNull(3, $haystack)` |
-| offsetSet      | Replaces the value at a given array offset with a provided value.           |                 `FixedArray::offsetSet(3, $value, $haystack)` |
-| pop            | Pops the latest value from the array.                                       |                                     `FixedArray::pop($array)` |
-| push           | Pushes a given value to the first available space on the array.             |                            `FixedArray::push($value, $array)` |
-| resize         | Alias for setSize.                                                          |                              `FixedArray::resize(10, $array)` |
-| second         | Returns the second value from the array.                                    |                                  `FixedArray::second($array)` |
-| setSize        | Resizes the array to a given size.                                          |                             `FixedArray::setSize(10, $array)` |
-| toArray        | Converts a fixed array into a standard array.                               |                                 `FixedArray::toArray($array)` |
-| toCollection   | Converts a fixed array into an Illuminate collection.                       |                            `FixedArray::toCollection($array)` |
+| Method         | Description                                                         |
+|:---------------|:--------------------------------------------------------------------|
+| add            | Alias for push.                                                     |
+| addFrom        | Add an array or collection of items to a fixed array.               |
+| chunk          | Split a fixed array into chunks of a given size.                    |
+| chunkWhile     | Split a fixed array into chunks while a callback returns true.      |
+| contains       | Check whether an item exists in a fixed array.                      |
+| create         | Create a new fixed array of a given size.                           |
+| dsfargeg       | DSFARGEG                                                            |
+| each           | Apply a callback to each item without modifying the original array. |
+| fill           | Fill the array with a single value.                                 |
+| filter         | Filter the array using a callback.                                  |
+| find           | Return the first element matching a callback.                       |
+| findKey        | Return the key of the first element matching a callback.            |
+| findIndex      | Alias for findKey.                                                  |
+| first          | Return the first element of the array.                              |
+| fluent         | Creates a new fluent interface for chaining methods.                |
+| flatten        | Flatten nested arrays, collections, and fixed arrays.               |
+| fromArray      | Create a fixed array from a standard array.                         |
+| fromCollection | Create a fixed array from an Illuminate collection.                 |
+| getSize        | Return the number of elements in the array.                         |
+| isFixedArray   | Check whether a value is a fixed array.                             |
+| last           | Return the last element of the array.                               |
+| map            | Apply a callback to each item and return a new array.               |
+| merge          | Merge multiple arrays, fixed arrays, or collections.                |
+| nullify        | Replace all elements with null.                                     |
+| offsetExists   | Check if an index exists in the array.                              |
+| offsetGet      | Get the value at a specific index.                                  |
+| offsetNull     | Set a specific index to null.                                       |
+| offsetSet      | Set a value at a specific index.                                    |
+| pop            | Remove and return the last element.                                 |
+| push           | Add a value to the first available space.                           |
+| random         | Return a random element from the array.                             |
+| resize         | Alias for setSize.                                                  |
+| reverse        | Reverse the order of elements.                                      |
+| second         | Return the second element.                                          |
+| setSize        | Resize the array to a given size.                                   |
+| shift          | Remove and return the first element.                                |
+| shuffle        | Shuffle the array in a secure manner.                               |
+| slice          | Return a subset of the array.                                       |
+| sort           | Sort the array optionally using a callback.                         |
+| toArray        | Convert the fixed array into a standard PHP array.                  |
+| toCollection   | Convert the fixed array into an Illuminate collection.              |
+| unique         | Remove duplicate values from the array.                             |
+| unshift        | Prepend one or more values to the array.                            |
 
 ## Testing
 

composer.json

@@ -17,22 +17,25 @@
         }
     ],
     "require": {
-        "php": "^8.3",
-        "spatie/laravel-package-tools": "^1.16",
-        "illuminate/contracts": "^11.0|^12.0"
+        "php": "^8.4",
+        "spatie/laravel-package-tools": "^1.92",
+        "illuminate/contracts": "^12.0"
     },
     "require-dev": {
-        "laravel/pint": "^1.14",
-        "nunomaduro/collision": "^8.1.1",
-        "larastan/larastan": "^2.9|^3.0",
+        "larastan/larastan": "^3.7",
+        "laravel/pint": "^1.25",
+        "nunomaduro/collision": "^8.8.2",
         "orchestra/testbench": "^10.1.0",
-        "pestphp/pest": "^3.0",
-        "pestphp/pest-plugin-arch": "^3.0",
-        "pestphp/pest-plugin-laravel": "^3.0",
+        "pestphp/pest": "^4.0",
+        "pestphp/pest-plugin-laravel": "^4.0",
+        "pestphp/pest-plugin-profanity": "^4.1",
+        "pestphp/pest-plugin-type-coverage": "*",
         "phpstan/extension-installer": "^1.3",
-        "phpstan/phpstan-deprecation-rules": "^1.1|^2.0",
-        "phpstan/phpstan-phpunit": "^1.3|^2.0",
-        "spatie/laravel-ray": "^1.35"
+        "phpstan/phpstan-deprecation-rules": "^2.0",
+        "phpstan/phpstan-mockery": "^2.0",
+        "phpstan/phpstan-phpunit": "^2.0",
+        "phpstan/phpstan-strict-rules": "^2.0",
+        "roave/security-advisories": "dev-latest"
     },
     "autoload": {
         "psr-4": {
@@ -51,9 +54,11 @@
     "scripts": {
         "post-autoload-dump": "@composer run prepare",
         "prepare": "@php vendor/bin/testbench package:discover --ansi",
-        "analyse": "vendor/bin/phpstan analyse",
+        "analyse": "vendor/bin/phpstan analyse --memory-limit=2G",
         "test": "vendor/bin/pest",
-        "test-coverage": "vendor/bin/pest --coverage",
+        "test:coverage": "vendor/bin/pest --coverage --min=100 --memory-limit=2G",
+        "test:type-coverage": "vendor/bin/pest --type-coverage",
+        "test:profanity": "vendor/bin/pest --profanity",
         "format": "vendor/bin/pint"
     },
     "config": {
@@ -66,7 +71,7 @@
     "extra": {
         "laravel": {
             "providers": [
-                "Petrobolos\\FixedArray\\FixedArrayFunctionsServiceProvider"
+                "Petrobolos\\FixedArray\\Providers\\FixedArrayServiceProvider"
             ],
             "aliases": {
                 "FixedArray": "Petrobolos\\FixedArrayFunctions\\Facades\\FixedArray"

phpstan.neon.dist

@@ -2,7 +2,7 @@ includes:
     - phpstan-baseline.neon
 
 parameters:
-    level: 5
+    level: 9
     paths:
         - src
     tmpDir: build/phpstan

phpunit.xml.dist

@@ -1,23 +1,31 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd" backupGlobals="false" bootstrap="vendor/autoload.php" colors="true" processIsolation="false" stopOnFailure="false" executionOrder="random" failOnWarning="true" failOnRisky="true" failOnEmptyTestSuite="true" beStrictAboutOutputDuringTests="true" cacheDirectory=".phpunit.cache" backupStaticProperties="false">
-  <testsuites>
-    <testsuite name="Petrobolos Test Suite">
-      <directory>tests</directory>
-    </testsuite>
-  </testsuites>
-  <coverage>
-    <report>
-      <html outputDirectory="build/coverage"/>
-      <text outputFile="build/coverage.txt"/>
-      <clover outputFile="build/logs/clover.xml"/>
-    </report>
-  </coverage>
-  <logging>
-    <junit outputFile="build/report.junit.xml"/>
-  </logging>
-  <source>
-    <include>
-      <directory suffix=".php">./src</directory>
-    </include>
-  </source>
+<phpunit
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.3/phpunit.xsd"
+    backupGlobals="false"
+    bootstrap="vendor/autoload.php"
+    colors="true"
+    processIsolation="false"
+    stopOnFailure="false"
+    executionOrder="random"
+    failOnWarning="true"
+    failOnRisky="false"
+    failOnEmptyTestSuite="true"
+    beStrictAboutOutputDuringTests="true"
+    cacheDirectory=".phpunit.cache"
+    backupStaticProperties="false"
+>
+    <testsuites>
+        <testsuite name="Petrobolos Test Suite">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+    <logging>
+        <junit outputFile="build/report.junit.xml"/>
+    </logging>
+    <source>
+        <include>
+            <directory suffix=".php">./src</directory>
+        </include>
+    </source>
 </phpunit>

src/Facades/FixedArray.php

@@ -7,11 +7,14 @@
 use Illuminate\Support\Facades\Facade;
 use Petrobolos\FixedArray\FixedArray as BaseFixedArray;
 
-/**
- * @see FixedArray
- */
+/** @mixin \Petrobolos\FixedArray\FixedArray */
 class FixedArray extends Facade
 {
+    /**
+     * Get the registered name of the component.
+     *
+     * @return class-string<BaseFixedArray>
+     */
     protected static function getFacadeAccessor(): string
     {
         return BaseFixedArray::class;