Merge pull request #154 from voku/copilot/add-index-of-min-max-element

Document callable index lookup for min/max values with focused regression coverage

Author: voku

AGENTS.md

@@ -79,6 +79,17 @@ This reads `src/Arrayy.php` docblocks and `build/docs/base.md`, then writes `REA
 
 ---
 
+## Findings from Task: README regeneration
+
+- Rebuild the README with `php build/generate_docs.php`
+- That script requires both:
+  - `vendor/autoload.php`
+  - `build/vendor/autoload.php`
+- On this branch, rerunning the generator completed successfully and did not change `README.md`
+- `AGENTS.md` is manually maintained and should be updated separately after README regeneration when task-specific context needs to be preserved
+
+---
+
 ## Adding New Methods
 
 All public methods in `src/Arrayy.php` follow this pattern:

tests/ArrayyTest.php

@@ -3281,6 +3281,27 @@ public function testFindKeyWithKeyParameter()
         static::assertFalse($arrayy->findKey($closureNoMatch));
     }
 
+    public function testFindKeyForMinAndMaxValues()
+    {
+        $arrayy = A::create([
+            3 => 10,
+            4 => -5,
+            8 => 99,
+            9 => -5,
+            10 => 99,
+        ]);
+
+        $min = $arrayy->min();
+        $max = $arrayy->max();
+
+        static::assertSame(4, $arrayy->findKey(static function ($value) use ($min) {
+            return $value === $min;
+        }));
+        static::assertSame(8, $arrayy->findKey(static function ($value) use ($max) {
+            return $value === $max;
+        }));
+    }
+
     /**
      * @dataProvider firstProvider()
      *