Update from flow-php/flow@3ff63c1

Author: flow-php

changelog/index.html

@@ -1080,6 +1080,11 @@ Search.appendIndex(
             "name": "map",
             "summary": "",
             "url": "classes/Flow-ETL-DataFrame.html#method_map"
+        },                {
+            "fqsen": "\\Flow\\ETL\\DataFrame\u003A\u003Amatch\u0028\u0029",
+            "name": "match",
+            "summary": "",
+            "url": "classes/Flow-ETL-DataFrame.html#method_match"
         },                {
             "fqsen": "\\Flow\\ETL\\DataFrame\u003A\u003Amode\u0028\u0029",
             "name": "mode",

documentation/api/core/classes/Flow-ETL-DataFrame.html

@@ -123,6 +123,9 @@ <h3>Table of Contents</h3>
             <table class="phpdocumentor-table_of_contents">
                                     <tr>
                         <td class="phpdocumentor-cell"><a href="reports/deprecated.html#src/core/etl/src/Flow/ETL/Config.php">src/core/etl/src/Flow/ETL/Config.php</a></td>
+                    </tr>
+                                    <tr>
+                        <td class="phpdocumentor-cell"><a href="reports/deprecated.html#src/core/etl/src/Flow/ETL/DataFrame.php">src/core/etl/src/Flow/ETL/DataFrame.php</a></td>
                     </tr>
                                     <tr>
                         <td class="phpdocumentor-cell"><a href="reports/deprecated.html#src/core/etl/src/Flow/ETL/Extractor/FileExtractor.php">src/core/etl/src/Flow/ETL/Extractor/FileExtractor.php</a></td>
@@ -159,6 +162,21 @@ <h3><abbr title="src/core/etl/src/Flow/ETL/Config.php">Config.php</abbr></h3>
                                 <td class="phpdocumentor-cell">32</td>
                                 <td class="phpdocumentor-cell"><a href="classes/Flow-ETL-Config.html#constant_SORT_MAX_MEMORY_ENV"><abbr title="\Flow\ETL\Config::SORT_MAX_MEMORY_ENV">Config::SORT_MAX_MEMORY_ENV</abbr></a></td>
                                 <td class="phpdocumentor-cell"><p>Use SortConfig::SORT_MAX_MEMORY_ENV instead</p>
+</td>
+                            </tr>
+                                                            </table>
+                            <a id="src/core/etl/src/Flow/ETL/DataFrame.php"></a>
+                <h3><abbr title="src/core/etl/src/Flow/ETL/DataFrame.php">DataFrame.php</abbr></h3>
+                <table>
+                    <tr>
+                        <th class="phpdocumentor-heading">Line</th>
+                        <th class="phpdocumentor-heading">Element</th>
+                        <th class="phpdocumentor-heading">Reason</th>
+                    </tr>
+                                                                        <tr>
+                                <td class="phpdocumentor-cell">846</td>
+                                <td class="phpdocumentor-cell"><a href="classes/Flow-ETL-DataFrame.html#method_validate"><abbr title="\Flow\ETL\DataFrame::validate()">DataFrame::validate()</abbr></a></td>
+                                <td class="phpdocumentor-cell"><p>Please use DataFrame::match instead</p>
 </td>
                             </tr>
                                                             </table>

documentation/api/core/js/searchIndex.js

@@ -371,6 +371,13 @@ <h1><a id="flow-php-upgrade-guide" href="#content-upgrade-guide" class="mr-2" ar
 <p>This document provides guidelines for upgrading between versions of Flow PHP.
 Please follow the instructions for your specific version to ensure a smooth upgrade process.</p>
 <hr />
+<h2><a id="flow-php-upgrading-from-011x-to-014x" href="#content-upgrading-from-011x-to-014x" class="mr-2" aria-hidden="true" title="Permalink">#</a>Upgrading from 0.11.x to 0.14.x</h2>
+<h3><a id="flow-php-1-replaced-flowetldataframevalidate-with-flowetldataframematch" href="#content-1-replaced-flowetldataframevalidate-with-flowetldataframematch" class="mr-2" aria-hidden="true" title="Permalink">#</a>1) Replaced <code>Flow\ETL\DataFrame::validate()</code> with <code>Flow\ETL\DataFrame::match()</code></h3>
+<p>The old method is now deprecated and will be removed in the next release.</p>
+<h3><a id="flow-php-2-replaced-flowetlfunctionscalarfunctiontypedscalarfunction-with-flowetlfunctionscalarfunctionscalarresult" href="#content-2-replaced-flowetlfunctionscalarfunctiontypedscalarfunction-with-flowetlfunctionscalarfunctionscalarresult" class="mr-2" aria-hidden="true" title="Permalink">#</a>2) Replaced <code>Flow\ETL\Function\ScalarFunction\TypedScalarFunction</code> with <code>Flow\ETL\Function\ScalarFunction\ScalarResult</code>.</h3>
+<p>The old interface was used to allow define the return type of the ScalarFunctions.
+It was replaced with a ScalarResult value object that is much more flexible than the interface,
+because it's allowing to return any type dynamically without making the scalar function stateful.</p>
 <h2><a id="flow-php-upgrading-from-010x-to-011x" href="#content-upgrading-from-010x-to-011x" class="mr-2" aria-hidden="true" title="Permalink">#</a>Upgrading from 0.10.x to 0.11.x</h2>
 <h3><a id="flow-php-1-removed-structureelementstructelementstructureelement-from-structuretype-definition" href="#content-1-removed-structureelementstructelementstructureelement-from-structuretype-definition" class="mr-2" aria-hidden="true" title="Permalink">#</a>1) Removed StructureElement/struct_element/structure_element from StructureType Definition</h3>
 <p>Before:</p>

documentation/api/core/reports/deprecated.html

@@ -1 +1 @@
-<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" ><url><loc>https://flow-php.com/blog/2025-03-16/flow-php-release-cycle</loc><lastmod>2025-04-06T17:59:26+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/blog/2025-01-25/data-processing-in-php</loc><lastmod>2025-04-06T17:59:26+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/blog/2024-08-08/scalar-functions</loc><lastmod>2025-04-06T17:59:26+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/blog/2024-04-04/building-custom-extractor-google-analytics</loc><lastmod>2025-04-06T17:59:26+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url></urlset>
+<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" ><url><loc>https://flow-php.com/blog/2025-03-16/flow-php-release-cycle</loc><lastmod>2025-04-06T20:35:37+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/blog/2025-01-25/data-processing-in-php</loc><lastmod>2025-04-06T20:35:37+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/blog/2024-08-08/scalar-functions</loc><lastmod>2025-04-06T20:35:37+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/blog/2024-04-04/building-custom-extractor-google-analytics</loc><lastmod>2025-04-06T20:35:37+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url></urlset>

documentation/upgrading/index.html

@@ -1 +1 @@
-<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" ><url><loc>https://flow-php.com/blog</loc><lastmod>2025-04-06T17:59:26+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/documentation</loc><lastmod>2025-04-06T17:59:26+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/changelog</loc><lastmod>2025-04-06T17:59:26+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/</loc><lastmod>2025-04-06T17:59:26+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url></urlset>
+<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" ><url><loc>https://flow-php.com/blog</loc><lastmod>2025-04-06T20:35:37+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/documentation</loc><lastmod>2025-04-06T20:35:37+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/changelog</loc><lastmod>2025-04-06T20:35:37+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/</loc><lastmod>2025-04-06T20:35:37+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url></urlset>

sitemap.blog.xml

@@ -1 +1 @@
-<?xml version="1.0" encoding="UTF-8"?><sitemapindex xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/siteindex.xsd" xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><sitemap><loc>https://flow-php.com/sitemap.default.xml</loc><lastmod>2025-04-06T17:59:26+00:00</lastmod></sitemap><sitemap><loc>https://flow-php.com/sitemap.examples.xml</loc><lastmod>2025-04-06T17:59:26+00:00</lastmod></sitemap><sitemap><loc>https://flow-php.com/sitemap.blog.xml</loc><lastmod>2025-04-06T17:59:26+00:00</lastmod></sitemap><sitemap><loc>https://flow-php.com/sitemap.documentation.xml</loc><lastmod>2025-04-06T17:59:26+00:00</lastmod></sitemap></sitemapindex>
+<?xml version="1.0" encoding="UTF-8"?><sitemapindex xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/siteindex.xsd" xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><sitemap><loc>https://flow-php.com/sitemap.default.xml</loc><lastmod>2025-04-06T20:35:37+00:00</lastmod></sitemap><sitemap><loc>https://flow-php.com/sitemap.examples.xml</loc><lastmod>2025-04-06T20:35:37+00:00</lastmod></sitemap><sitemap><loc>https://flow-php.com/sitemap.blog.xml</loc><lastmod>2025-04-06T20:35:37+00:00</lastmod></sitemap><sitemap><loc>https://flow-php.com/sitemap.documentation.xml</loc><lastmod>2025-04-06T20:35:37+00:00</lastmod></sitemap></sitemapindex>