feat: zip と zip_with を追加する

[Javakky]

概要（What / Why）

2 つの配列を反復順序で組み合わせる zip と、ペアに関数を適用する zip_with を追加します。

変更点

• src/zip.php — list<array{0: L, 1: R}> または左のキーを維持した assoc を返す。長さは min(count($left), count($right))
• src/zip_with.php — 同じ組み合わせ規則で callback を適用
• tests/ZipTest.php / tests/ZipWithTest.php
• composer.json の autoload.files に 2 件追加

動作確認

• 手動：
  • zip([1, 2, 3], ['a', 'b']) → [[1, 'a'], [2, 'b']]
  • zip(['x' => 1, 'y' => 2], [10, 20]) → ['x' => [1, 10], 'y' => [2, 20]] (左が assoc なので AUTO で キー維持)
  • 同じ入力に Mode::MODE_LIST → [[1, 10], [2, 20]]
• 自動：
  • vendor/bin/php-cs-fixer fix --dry-run --diff / vendor/bin/phpstan analyse -c phpstan.neon / vendor/bin/phpunit tests
  • 結果：OK (137 tests, 144 assertions) / PHPStan level 10 [OK] No errors / CS Fixer Fixed 0 of 35 files

補足（任意）

Mode の扱い

当初は「キーを一切使わない」仕様で Mode を省いていましたが、新規関数には Mode を持たせる方針に合わせて追加しました。

• MODE_LIST: 左右のキーを無視して 0 始まり連番の list
• MODE_ASSOC: 左のキーを維持。右のキーは使わない (右は反復順のみ)
• MODE_AUTO: 左 の形状で判定 (Mode::check_mode($mode, $left))

右のキーは mode によらず一切使いません。左右で役割が非対称なので phpdoc に明記しています。

この変更で MODE_AUTO の既定が「左の形状で判定」になったため、assoc 同士を渡していた既存テストは「MODE_LIST を明示すればキーが無視される」形に書き換えました (削除ではなく改名 + 明示指定)。

zip_with は独立実装です

zip に委譲せず for ループで直接 callback に渡しています。zip と同じループ構造にして姉妹関数間の対称性を取り、中間のペア配列の生成も無くしています。

その他

• array_values() の結果は $leftValues / $rightValues という別変数に受けています (引数への再代入だと「入力を破壊しない」ことの確認に一手間かかるため)
• 3 引数以上の可変長版は作っていません
• @phpstan-param の条件型は付けていません (「assoc 入力 + MODE_LIST」が型エラーになるため。slice.php / map.php / intersect.php と同じ形)

Closes #68
Closes #69

🤖 Generated with Claude Code