Co-authored-by: Simon Praetorius <simon@praetorius.me>

We can't easily link to [1] due to versioning, so the
auto-generated code is updated to reflect some more
implementation details.

Also some rephrasing to make things easier to read.

[1] https://docs.typo3.org/m/typo3/reference-coreapi/12.4/en-us/ApiOverview/Fluid/Syntax.html

TagBuilder::addAttribute() allows both strings and array/traversables
as attribute value. However, in the implementation only "data" and
"aria" are properly handled as arrays. For other attribute names,
this leads to a type conversion warning.

With this patch, that edge case is properly handled with an
exception. Also, test coverage is added both for data/aria and the
exception.

Resolves: #857

The SplitViewHelper splits a string by the specified separator, which
results in an array. The number of values in the resulting array can
be limited with the limit parameter, which results in an array where
the last item contains the remaining unsplit string.

This ViewHelper mimicks PHP's :php:`explode()` function.

Split with a separator:

```xml
<f:split value="1,5,8" separator="," /> <!-- Output: {0: '1', 1: '5', 2: '8'} -->
```

Split using tag content as value:

```xml
<f:split separator="-">1-5-8</f:split> <!-- Output: {0: '1', 1: '5', 2: '8'} -->
```

Split with a limit:

```xml
<f:split value="1,5,8" separator="," limit="2" /> <!-- Output: {0: '1', 1: '5,8'} -->
```

Fix array indention findings.

> composer req --dev friendsofphp/php-cs-fixer:^3.52.1

The ReplaceViewHelper replaces one or multiple strings with other
strings. This ViewHelper mimicks PHP's :php:`str_replace()` function.
However, it's also possible to provide replace pairs as associative array
via the "replace" argument.

Replace a single string:

```xml
<f:replace value="Hello World" search="World" replace="Fluid" /> <!-- Output: Hello Fluid -->
```

Replace multiple strings:

```xml
<f:replace value="Hello World" search="{0: 'World', 1: 'Hello'}" replace="{0: 'Fluid', 1: 'Hi'}" /> <!-- Output: Hi Fluid -->
```

Replace multiple strings using associative array:

```xml
<f:replace value="Hello World" replace="{'World': 'Fluid', 'Hello': 'Hi'}" /> <!-- Output: Hi Fluid -->
```

* [FEATURE] JoinViewHelper

The JoinViewHelper combines elements from an array into a single string. You can specify both a general separator and a special one for the last element that is rendered between the elements.

```html
<f:join value="{0: '1', 1: '2', 2: '3'}" />
```

Results in the output:

```html
123
```

```html
<f:join value="{0: '1', 1: '2', 2: '3'}" separator=", " />
```

Results in the output:

```html
1, 2, 3
```

```html
<f:join value="{0: '1', 1: '2', 2: '3'}" separator=", " separatorLast=" and " />
```

Results in the output:

```html
1, 2 and 3
```

* [TASK] Improve handling of iterable objects

* [TASK] Check exception type in test

* [TASK] Improve code for edge case

* [TASK] Add test case for single item

---------

Co-authored-by: Simon Praetorius <simon@praetorius.me>

The FirstViewHelper and LastViewHelper return the first or last
item of a specified array, respectively.

## Examples

```xml
<f:first value="{0: 'first', 1: 'second', 2: 'third'}" /> <!-- Outputs "first" -->
<f:last value="{0: 'first', 1: 'second', 2: 'third'}" /> <!-- Outputs "third" -->
```