Update from flow-php/flow@b905973

Author: flow-php

changelog/index.html

@@ -218,9 +218,11 @@ <h2 class="my-2 text-2xl font-semibold tracking-wide">Loads</h2>
 </div>
 
             <section id="changelog" class="py-10 px-2 sm:px-4 mx-auto max-w-screen-xl">
-        <h2><a id="flow-php-unreleased---2025-10-22" href="#content-unreleased---2025-10-22" class="mr-2" aria-hidden="true" title="Permalink">#</a>[Unreleased] - 2025-10-22</h2>
+        <h2><a id="flow-php-unreleased---2025-10-24" href="#content-unreleased---2025-10-24" class="mr-2" aria-hidden="true" title="Permalink">#</a>[Unreleased] - 2025-10-24</h2>
 <h3><a id="flow-php-added" href="#content-added" class="mr-2" aria-hidden="true" title="Permalink">#</a>Added</h3>
 <ul>
+<li><a rel="noopener noreferrer" target="_blank" href="https://github.com/flow-php/flow/pull/1901">#1901</a> - <strong>DataFrame::batchBy()</strong> - <a rel="noopener noreferrer" target="_blank" href="https://github.com/norberttech">@norberttech</a></li>
+<li><a rel="noopener noreferrer" target="_blank" href="https://github.com/flow-php/flow/pull/1901">#1901</a> - <strong>SortedByConstraint</strong> - <a rel="noopener noreferrer" target="_blank" href="https://github.com/norberttech">@norberttech</a></li>
 <li><a rel="noopener noreferrer" target="_blank" href="https://github.com/flow-php/flow/pull/1898">#1898</a> - <strong>3rd level of nesting to examples - Topic / Example / Option</strong> - <a rel="noopener noreferrer" target="_blank" href="https://github.com/norberttech">@norberttech</a></li>
 <li><a rel="noopener noreferrer" target="_blank" href="https://github.com/flow-php/flow/pull/1898">#1898</a> - <strong>Examples of reusable Transformations</strong> - <a rel="noopener noreferrer" target="_blank" href="https://github.com/norberttech">@norberttech</a></li>
 <li><a rel="noopener noreferrer" target="_blank" href="https://github.com/flow-php/flow/pull/1882">#1882</a> - <strong>Reusable action to setup php version in github workflows</strong> - <a rel="noopener noreferrer" target="_blank" href="https://github.com/norberttech">@norberttech</a></li>

data_frame/batch_by/index.html

@@ -371,7 +371,7 @@ <h2 class="text-xl mt-5">Description</h2>
 
 declare(strict_types=1);
 
-use function Flow\ETL\DSL\{data_frame, from_array, to_stream};
+use function Flow\ETL\DSL\{constraint_sorted_by, data_frame, from_array, ref, to_stream};
 
 require __DIR__ . &#039;/vendor/autoload.php&#039;;
 
@@ -383,11 +383,35 @@ <h2 class="text-xl mt-5">Description</h2>
         [&#039;order_id&#039; =&gt; 2, &#039;item&#039; =&gt; &#039;Gizmo&#039;, &#039;qty&#039; =&gt; 3],
         [&#039;order_id&#039; =&gt; 3, &#039;item&#039; =&gt; &#039;Widget&#039;, &#039;qty&#039; =&gt; 1],
     ]))
+    -&gt;constrain(constraint_sorted_by(ref(&#039;order_id&#039;)))
     -&gt;batchBy(&#039;order_id&#039;)
     -&gt;write(to_stream(__DIR__ . &#039;/output.txt&#039;, truncate: false))
     -&gt;run();
 </code></pre></div>            </div>
 
+                        <h2 class="text-xl mt-5 mb-5">Output</h2>
+            <div id="output" class="relative">
+                <button class="absolute top-[12px] right-[12px] bg-orange-100 rounded px-4 leading-9 [&.copied]:before:content-['Copied!'] before:absolute before:-translate-x-20" data-clipboard-target="#output" data-controller="clipboard"><img src="https://flow-php.com/assets/images/icons/copy-c890d86c179d4c56059b8a0e9c88cd23.svg" alt="copy code" width="20" height="20" class="inline"></button><pre class="rounded p-4 shadow-2xl shadow-gray rounded border-gray border-2"><code id="output" class="language-shell overflow-auto" data-controller="syntax-highlight">+----------+--------+-----+
+| order_id |   item | qty |
++----------+--------+-----+
+|        1 | Widget |   2 |
+|        1 | Gadget |   1 |
++----------+--------+-----+
+2 rows
++----------+--------+-----+
+| order_id |   item | qty |
++----------+--------+-----+
+|        2 | Widget |   5 |
+|        2 |  Gizmo |   3 |
++----------+--------+-----+
+2 rows
++----------+--------+-----+
+| order_id |   item | qty |
++----------+--------+-----+
+|        3 | Widget |   1 |
++----------+--------+-----+
+1 rows
+</code></pre>            </div>
 
             <div class="mt-5">
                 <script src="https://giscus.app/client.js"

documentation/api/core/classes/Flow-ETL-Transformer-GroupToArrayTransformer.html

@@ -308,7 +308,6 @@ <h3>G</h3>
                             <li><a href="files/src-core-etl-src-flow-etl-function-greatest.html"><abbr title="src/core/etl/src/Flow/ETL/Function/Greatest.php">Greatest.php</abbr></a></li>
                             <li><a href="files/src-core-etl-src-flow-etl-groupby.html"><abbr title="src/core/etl/src/Flow/ETL/GroupBy.php">GroupBy.php</abbr></a></li>
                             <li><a href="files/src-core-etl-src-flow-etl-pipeline-groupbypipeline.html"><abbr title="src/core/etl/src/Flow/ETL/Pipeline/GroupByPipeline.php">GroupByPipeline.php</abbr></a></li>
-                            <li><a href="files/src-core-etl-src-flow-etl-transformer-grouptoarraytransformer.html"><abbr title="src/core/etl/src/Flow/ETL/Transformer/GroupToArrayTransformer.php">GroupToArrayTransformer.php</abbr></a></li>
                             <li><a href="files/src-core-etl-src-flow-etl-dataframe-groupeddataframe.html"><abbr title="src/core/etl/src/Flow/ETL/DataFrame/GroupedDataFrame.php">GroupedDataFrame.php</abbr></a></li>
                         </ul>
                                                         <h3>H</h3>

documentation/api/core/files/src-core-etl-src-flow-etl-transformer-grouptoarraytransformer.html

@@ -11775,21 +11775,6 @@ Search.appendIndex(
             "name": "transform",
             "summary": "",
             "url": "classes/Flow-ETL-Transformer-EntryNameStyleConverterTransformer.html#method_transform"
-        },                {
-            "fqsen": "\\Flow\\ETL\\Transformer\\GroupToArrayTransformer",
-            "name": "GroupToArrayTransformer",
-            "summary": "",
-            "url": "classes/Flow-ETL-Transformer-GroupToArrayTransformer.html"
-        },                {
-            "fqsen": "\\Flow\\ETL\\Transformer\\GroupToArrayTransformer\u003A\u003A__construct\u0028\u0029",
-            "name": "__construct",
-            "summary": "",
-            "url": "classes/Flow-ETL-Transformer-GroupToArrayTransformer.html#method___construct"
-        },                {
-            "fqsen": "\\Flow\\ETL\\Transformer\\GroupToArrayTransformer\u003A\u003Atransform\u0028\u0029",
-            "name": "transform",
-            "summary": "",
-            "url": "classes/Flow-ETL-Transformer-GroupToArrayTransformer.html#method_transform"
         },                {
             "fqsen": "\\Flow\\ETL\\Transformer\\JoinEachRowsTransformer",
             "name": "JoinEachRowsTransformer",