voku/arrayy

[*]: update the README + CHANGELOG

• add findKey() — find the key/index of the first element matching a predicate callable
• fix deprecated PHP patterns: implicit nullable parameters, dynamic properties, deprecated callable syntax
• update PHP requirement to >=8.0.0 (drop PHP 7.x support)
• update PHPStan to v2, migrate to inline @phpstan-ignore identifiers
• update phpdocumentor/reflection-docblock to v6

[*]: update the changelog

• "Json"-Mapper: support objects in "Arrayy"-collections

[*]: update the changelog

• try to optimize autocompletion for PhpStorm

[-]: small clean-up only

• try to fix phpstan (1.8.4) reported issues

[*]: update the changelog (fix typo)

• "Collection" -> fix phpstan check for offset

[*]: update the changelog

• optimize some phpdocs (phpstan)
• simplify some code

[*]: "To people of Russia" -> Info about the war in Ukraine

• "To people of Russia": There is a war in Ukraine right now. The forces of the Russian Federation are attacking civilians.
• fix phpdocs for "chunk()"
• try to optimize support for PhpStorm auto-completion

[*]: update the changelog

• remove "gitbook" from "dev-dependencies"
• add "containsOnly()"
• add "getBackwardsGenerator()"
• add "reverseKeepIndex()"

[*]: update the changelog

• add more support for Generics + phpstan checks
• fix PHP 8.1 compatibility -> thanks @frenchcomp

• add "NonEmptyString"-Collections (accepts "non-empty-string")
• add "Numeric"-Collections (accepts "numeric" e.g.: 1, '1', 1.1, '1.1')
• add "NumericString"-Collections (accepts "numeric" e.g.: '1', '1.1')

• fix "Float"-Collections (only accepts "float" now)
• add "FloatInt"-Collections (accepts "float" and "int")

• fix fatal error from "ArrayyRewindableExtendedGenerator"

• add more support for Generics + phpstan checks

• fix code style
• use Github Actions

• add more support for Generics + phpstan checks

• optimize Json Mapper with nested Arrayy elements

• use more Generators v3.1
• add more support for Generics + phpstan checks
• auto-generate the README

• fix some internal Generator usage
• add more support for Generics + phpstan checks

• use more Generators v3
• auto-generate the README
• use property type check for "Arrayy->unshift(...)"

• use more Generators v2
• auto-generate the README

• use more Generators
• auto-generate the README

• search for PhpDoc @property in parent classes -> this is working for "Arrayy" classes and "ArrayyMeta" classes

• add "prependImmutable()"
• add "appendImmutable()"
• add prefix for "implode()"
• use more Generators
• add more tests

• fix "offsetGet()" usage -> now e.g. $a['foo'] will return a reference instead of a new variable, so that we can overwrite the key of an array like this $a['foo']['counter'] += 1

• add support for "A->get('*.key)"

• add support for JSON-Mappings

• add "Callable"-Collections
• add "Object"-Collections
• add "Resource"-Collections
• add "Scalar"-Collections

• add & use "Arrayy->getGeneratorByReference()"
• update "phpdocumentor/reflection-docblock"

• fix "Arrayy->offsetUnset()" -> unset of non array values + fix phpdoc
• fix "Arrayy->merge*" -> now accepts also Arrayy elements in the array
• update "Arrayy->has()" -> now you can check multiple keys
• add "$key" for "Arrayy->clear()"
• add "Arrayy->flatten()"
• add "Arrayy->createFromArray()"

• fix check for "\Arrayy\collection()"

• use generics for "\Arrayy\array_first()" & "\Arrayy\array_last()"

• fix phpdoc from "toPermutation()"

• fix "@psalm-mutation-free" - via psalm

• fix generics support - via psalm

• more generics support - via psalm + phpstan
• add some more "Immutable" versions of sort methods
• fix "createFromObject()" -> will return static instead of self

• fix more phpdocs

• add "@psalm-mutation-free" - via psalm
• fix more phpdocs

• more generics support - via phpstan (>= 0.12)

• normalize $closure (value => key instead of key => value) for "forAll()"
• normalize $closure (value => key instead of key => value) for "partition()"
• rename "forAll()" into "validate()"
• use "iterator_count()" if possible
• add "nth()"
• add "toPermutation()"

• fix phpstan (0.12) generic support

• use phpstan (0.12) generic support
• split "InstanceCollection" into "InstancesCollection" && "InstanceCollection"

• instance of "InvalidArgumentException" we now use "TypeError" for type errors
• add "Arrayy->checkPropertiesMismatch"
• add pre-defined typified collections (TypeInterface)
• merge type check from Arrayy & Collection
• add "TypeCheckInterface"
• fix type checks

• fix serialization of "Arrayy" + "Property" (Property !== instance of ReflectionProperty anymore)
• fix for php 7.4 (ArrayObject use __serialize + __unserialize)

• fix "Arrayy->keys()" -> use strict and non-strict comparision

• optimize "array_last"-polyfill (php < 7.3)

• add "Arrayy->diffKey" + "Arrayy->diffKeyAndValue"
• add more test cases
• update "phpdocumentor/reflection-docblock"

• fix "array_first()" + "array_last()" (move from global namespace into Arrayy)

• fix return type of "Arrayy->internalGetArray()"

• add Arrayy->moveElementToFirstPlace()
• add Arrayy->moveElementToLastPlace()

• fix for php >= 7.3

• add new array key functions + most value functions

  -> "Arrayy->firstKey()", "Arrayy->lastKey()", "Arrayy->mostUsedValue()", "Arrayy->mostUsedValues()"

• Collection -> fix some string methods from the parent "Arrayy"-class

• AbstractCollection -> accept collections (self) as valid source + fix phpdoc

• add "keyExists()" / "delete()" / "pull()"

• "first()" / "last()" -> fix -> do not change the current array, if it's not needed

• "group()" / "sorter()" -> fix phpdoc
• "keys()" / "values()" -> optimize generator usage
• "replace()" -> fix immutable of the input
• "sizeIs()" / "sizeIsLessThan()" / "sizeIsGreaterThan()" / "sizeIsBetween()" -> added
• "invoke()" -> improve generator usage + fix phpdoc
• "map()" -> allow to use the key, in the callable + additional parameter
• "containsCaseInsensitive()" -> optimize for generator usage

• optimize performance from "Arrayy->unshift()"
• optimize performance from "Arrayy->push()"

• add a simple "Collection" implementation + function alias \Arrayy\collection()
• fix errors reported by phpstan (level 7)
• improve performance (use "dot-notation" internally only if needed)
• improve "dot-notation" handling for non "Arrayy" objects

• "AbstractCollection" -> optimize foreach usage
• "AbstractCollection" -> fix merge && where methods

• optimize property check in the constructor
• better support for PhpDoc @property checks
• allow callable<mixed, \Generator> as input (Arrayy::createFromGeneratorFunction())
• add a abstract "Collection" implementation