From 5e7d55560aa63846b47f5da399c13cfe8d22fc5c Mon Sep 17 00:00:00 2001
From: Jonathan Miller <1+jmiller@noreply.git.mokoconsulting.tech>
Date: Sat, 30 May 2026 20:36:10 +0000
Subject: [PATCH 1/3] chore: sync updates.xml 01.04.00 from main [skip ci]

---
 updates.xml | 142 ++++++++++++++++++++++++++--------------------------
 1 file changed, 71 insertions(+), 71 deletions(-)

diff --git a/updates.xml b/updates.xml
index 074f79f..f04a1a8 100644
--- a/updates.xml
+++ b/updates.xml
@@ -1,81 +1,24 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!-- Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
  SPDX-License-Identifier: GPL-3.0-or-later
- VERSION: 01.03.02-dev
+ VERSION: 01.04.00
  -->
 
 <updates>
   <update>
-    <name>Module - MokoJoomHero</name>
-    <description>Module - MokoJoomHero alpha build.</description>
+    <name>MokoJoomHero</name>
+    <description>MokoJoomHero dev build.</description>
     <element>mod_mokojoomhero</element>
     <type>module</type>
     <client>site</client>
-    <version>01.03.00-alpha</version>
+    <version>01.04.00-dev</version>
     <creationDate>2026-05-30</creationDate>
-    <infourl title="Module - MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/alpha</infourl>
+    <infourl title="MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/development</infourl>
     <downloads>
-      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/alpha/mod_mokojoomhero-01.03.00-alpha.zip</downloadurl>
+      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/development/mod_mokojoomhero-01.04.00-dev.zip</downloadurl>
     </downloads>
-    <sha256>aee01c13697258c0aa5e918e1c028f5c490bce2991f04a3fbcb1e60062d79876</sha256>
-    <tags><tag>alpha</tag></tags>
-    <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
-    <maintainer>Moko Consulting</maintainer>
-    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
-    <targetplatform name="joomla" version="(5|6)\..*"/>
-  </update>
-  <update>
-    <name>Module - MokoJoomHero</name>
-    <description>Module - MokoJoomHero beta build.</description>
-    <element>mod_mokojoomhero</element>
-    <type>module</type>
-    <client>site</client>
-    <version>01.03.00-beta</version>
-    <creationDate>2026-05-30</creationDate>
-    <infourl title="Module - MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/beta</infourl>
-    <downloads>
-      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/beta/mod_mokojoomhero-01.03.00-beta.zip</downloadurl>
-    </downloads>
-    <sha256>aee01c13697258c0aa5e918e1c028f5c490bce2991f04a3fbcb1e60062d79876</sha256>
-    <tags><tag>beta</tag></tags>
-    <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
-    <maintainer>Moko Consulting</maintainer>
-    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
-    <targetplatform name="joomla" version="(5|6)\..*"/>
-  </update>
-  <update>
-    <name>Module - MokoJoomHero</name>
-    <description>Module - MokoJoomHero rc build.</description>
-    <element>mod_mokojoomhero</element>
-    <type>module</type>
-    <client>site</client>
-    <version>01.03.00-rc</version>
-    <creationDate>2026-05-30</creationDate>
-    <infourl title="Module - MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/release-candidate</infourl>
-    <downloads>
-      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/release-candidate/mod_mokojoomhero-01.03.00-rc.zip</downloadurl>
-    </downloads>
-    <sha256>aee01c13697258c0aa5e918e1c028f5c490bce2991f04a3fbcb1e60062d79876</sha256>
-    <tags><tag>rc</tag></tags>
-    <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
-    <maintainer>Moko Consulting</maintainer>
-    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
-    <targetplatform name="joomla" version="(5|6)\..*"/>
-  </update>
-  <update>
-    <name>Module - MokoJoomHero</name>
-    <description>Module - MokoJoomHero stable build.</description>
-    <element>mod_mokojoomhero</element>
-    <type>module</type>
-    <client>site</client>
-    <version>01.03.00</version>
-    <creationDate>2026-05-30</creationDate>
-    <infourl title="Module - MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/stable</infourl>
-    <downloads>
-      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/stable/mod_mokojoomhero-01.03.00.zip</downloadurl>
-    </downloads>
-    <sha256>aee01c13697258c0aa5e918e1c028f5c490bce2991f04a3fbcb1e60062d79876</sha256>
-    <tags><tag>stable</tag></tags>
+    <sha256>ed48980c7cbd71c535f61e6eacc3f54159a1301237cbdb62ac58bdae2192c5a3</sha256>
+    <tags><tag>dev</tag></tags>
     <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
     <maintainer>Moko Consulting</maintainer>
     <maintainerurl>https://mokoconsulting.tech</maintainerurl>
@@ -83,18 +26,75 @@
   </update>
   <update>
     <name>MokoJoomHero</name>
-    <description>MokoJoomHero development build.</description>
+    <description>MokoJoomHero alpha build.</description>
     <element>mod_mokojoomhero</element>
     <type>module</type>
     <client>site</client>
-    <version>01.03.02-dev</version>
+    <version>01.04.00-alpha</version>
     <creationDate>2026-05-30</creationDate>
-    <infourl title='MokoJoomHero'>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/development</infourl>
+    <infourl title="MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/alpha</infourl>
     <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/development/mod_mokojoomhero-01.03.02-dev.zip</downloadurl>
+      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/alpha/mod_mokojoomhero-01.04.00-alpha.zip</downloadurl>
     </downloads>
-    <sha256>f6842ab176d55cc8b1f767de2b08b6ab69bdc06510bc5bb19bd54292e6dafbe5</sha256>
-    <tags><tag>dev</tag></tags>
+    <sha256>ed48980c7cbd71c535f61e6eacc3f54159a1301237cbdb62ac58bdae2192c5a3</sha256>
+    <tags><tag>alpha</tag></tags>
+    <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
+    <maintainer>Moko Consulting</maintainer>
+    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
+    <targetplatform name="joomla" version="(5|6)\..*"/>
+  </update>
+  <update>
+    <name>MokoJoomHero</name>
+    <description>MokoJoomHero beta build.</description>
+    <element>mod_mokojoomhero</element>
+    <type>module</type>
+    <client>site</client>
+    <version>01.04.00-beta</version>
+    <creationDate>2026-05-30</creationDate>
+    <infourl title="MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/beta</infourl>
+    <downloads>
+      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/beta/mod_mokojoomhero-01.04.00-beta.zip</downloadurl>
+    </downloads>
+    <sha256>ed48980c7cbd71c535f61e6eacc3f54159a1301237cbdb62ac58bdae2192c5a3</sha256>
+    <tags><tag>beta</tag></tags>
+    <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
+    <maintainer>Moko Consulting</maintainer>
+    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
+    <targetplatform name="joomla" version="(5|6)\..*"/>
+  </update>
+  <update>
+    <name>MokoJoomHero</name>
+    <description>MokoJoomHero rc build.</description>
+    <element>mod_mokojoomhero</element>
+    <type>module</type>
+    <client>site</client>
+    <version>01.04.00-rc</version>
+    <creationDate>2026-05-30</creationDate>
+    <infourl title="MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/release-candidate</infourl>
+    <downloads>
+      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/release-candidate/mod_mokojoomhero-01.04.00-rc.zip</downloadurl>
+    </downloads>
+    <sha256>ed48980c7cbd71c535f61e6eacc3f54159a1301237cbdb62ac58bdae2192c5a3</sha256>
+    <tags><tag>rc</tag></tags>
+    <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
+    <maintainer>Moko Consulting</maintainer>
+    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
+    <targetplatform name="joomla" version="(5|6)\..*"/>
+  </update>
+  <update>
+    <name>MokoJoomHero</name>
+    <description>MokoJoomHero stable build.</description>
+    <element>mod_mokojoomhero</element>
+    <type>module</type>
+    <client>site</client>
+    <version>01.04.00</version>
+    <creationDate>2026-05-30</creationDate>
+    <infourl title='MokoJoomHero'>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/stable</infourl>
+    <downloads>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/stable/mod_mokojoomhero-01.04.00.zip</downloadurl>
+    </downloads>
+    <sha256>ed48980c7cbd71c535f61e6eacc3f54159a1301237cbdb62ac58bdae2192c5a3</sha256>
+    <tags><tag>stable</tag></tags>
     <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
     <maintainer>Moko Consulting</maintainer>
     <maintainerurl>https://mokoconsulting.tech</maintainerurl>
-- 
2.52.0


From 7733eaba4768529eeff4f9b2891c148042da52b0 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <jmiller-moko@noreply.git.mokoconsulting.tech>
Date: Sat, 30 May 2026 15:56:18 -0500
Subject: [PATCH 2/3] docs: clean up and update changelog through 01.04.00

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 CHANGELOG.md | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ca2ab67..4742fa2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,25 +1,25 @@
 # Changelog
 
-## [Unreleased]
-
-
-## [01.03.00] --- 2026-05-30
-
-
 All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 Version format: `XX.YY.ZZ` (zero-padded semver).
 
-## [01.01.00] --- 2026-05-30
+## [Unreleased]
 
-## [01.02.00] - 2026-05-30
+## [01.04.00] - 2026-05-30
+
+### Added
+- Local Video hero mode with Joomla Media Manager file picker (`localVideoFile` param)
+- Install script (`script.php`) creates `images/heroes/` folder on install/update
+
+## [01.03.00] - 2026-05-30
 
 ### Added
 - Configurable card fade-in delay with slide-up animation (`cardDelay` param, 0-5000ms) (#39)
-- Video mute/unmute toggle button (`showMuteToggle` param) — supports YouTube, Vimeo, and native video (#40)
+- Video mute/unmute toggle button (`showMuteToggle` param) -- supports YouTube, Vimeo, and native video (#40)
 
-## [01.01.00] - 2026-05-30
+## [01.02.00] - 2026-05-30
 
 ### Fixed
 - WebAsset registration: added `#style`/`#script` suffixes to preset dependencies (was causing `UnsatisfiedDependencyException`)
@@ -32,6 +32,8 @@ Version format: `XX.YY.ZZ` (zero-padded semver).
 - IntersectionObserver pauses/resumes videos when the hero scrolls out of/into the viewport (YouTube, Vimeo, and native `<video>`)
 - YouTube embeds include `enablejsapi=1` for postMessage playback control
 
+## [01.01.00] - 2026-05-30
+
 ### Changed
 - Migrated all workflow and template paths from `.github/` to `.mokogitea/`
 - Template source paths updated
-- 
2.52.0


From 00d9f35cd7acb170de35e7bd964c1bfc7687da91 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <1+jmiller@noreply.git.mokoconsulting.tech>
Date: Sat, 30 May 2026 21:08:57 +0000
Subject: [PATCH 3/3] chore: sync updates.xml 01.05.00-rc from rc [skip ci]

---
 updates.xml | 66 ++++++++++++++++++++++++++---------------------------
 1 file changed, 33 insertions(+), 33 deletions(-)

diff --git a/updates.xml b/updates.xml
index f04a1a8..ff00bbc 100644
--- a/updates.xml
+++ b/updates.xml
@@ -1,23 +1,42 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!-- Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
  SPDX-License-Identifier: GPL-3.0-or-later
- VERSION: 01.04.00
+ VERSION: 01.05.00-rc
  -->
 
 <updates>
+  <update>
+    <name>MokoJoomHero</name>
+    <description>MokoJoomHero stable build.</description>
+    <element>mod_mokojoomhero</element>
+    <type>module</type>
+    <client>site</client>
+    <version>01.04.00</version>
+    <creationDate>2026-05-30</creationDate>
+    <infourl title="MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/stable</infourl>
+    <downloads>
+      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/stable/mod_mokojoomhero-01.04.00.zip</downloadurl>
+    </downloads>
+    <sha256>ed48980c7cbd71c535f61e6eacc3f54159a1301237cbdb62ac58bdae2192c5a3</sha256>
+    <tags><tag>stable</tag></tags>
+    <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
+    <maintainer>Moko Consulting</maintainer>
+    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
+    <targetplatform name="joomla" version="(5|6)\..*"/>
+  </update>
   <update>
     <name>MokoJoomHero</name>
     <description>MokoJoomHero dev build.</description>
     <element>mod_mokojoomhero</element>
     <type>module</type>
     <client>site</client>
-    <version>01.04.00-dev</version>
+    <version>01.05.00-dev</version>
     <creationDate>2026-05-30</creationDate>
     <infourl title="MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/development</infourl>
     <downloads>
-      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/development/mod_mokojoomhero-01.04.00-dev.zip</downloadurl>
+      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/development/mod_mokojoomhero-01.05.00-dev.zip</downloadurl>
     </downloads>
-    <sha256>ed48980c7cbd71c535f61e6eacc3f54159a1301237cbdb62ac58bdae2192c5a3</sha256>
+    <sha256>8d96e95497407fc5dbd4854120232b2dbcd8055222dfe2abd65c23bc33f9606a</sha256>
     <tags><tag>dev</tag></tags>
     <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
     <maintainer>Moko Consulting</maintainer>
@@ -30,13 +49,13 @@
     <element>mod_mokojoomhero</element>
     <type>module</type>
     <client>site</client>
-    <version>01.04.00-alpha</version>
+    <version>01.05.00-alpha</version>
     <creationDate>2026-05-30</creationDate>
     <infourl title="MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/alpha</infourl>
     <downloads>
-      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/alpha/mod_mokojoomhero-01.04.00-alpha.zip</downloadurl>
+      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/alpha/mod_mokojoomhero-01.05.00-alpha.zip</downloadurl>
     </downloads>
-    <sha256>ed48980c7cbd71c535f61e6eacc3f54159a1301237cbdb62ac58bdae2192c5a3</sha256>
+    <sha256>8d96e95497407fc5dbd4854120232b2dbcd8055222dfe2abd65c23bc33f9606a</sha256>
     <tags><tag>alpha</tag></tags>
     <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
     <maintainer>Moko Consulting</maintainer>
@@ -49,13 +68,13 @@
     <element>mod_mokojoomhero</element>
     <type>module</type>
     <client>site</client>
-    <version>01.04.00-beta</version>
+    <version>01.05.00-beta</version>
     <creationDate>2026-05-30</creationDate>
     <infourl title="MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/beta</infourl>
     <downloads>
-      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/beta/mod_mokojoomhero-01.04.00-beta.zip</downloadurl>
+      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/beta/mod_mokojoomhero-01.05.00-beta.zip</downloadurl>
     </downloads>
-    <sha256>ed48980c7cbd71c535f61e6eacc3f54159a1301237cbdb62ac58bdae2192c5a3</sha256>
+    <sha256>8d96e95497407fc5dbd4854120232b2dbcd8055222dfe2abd65c23bc33f9606a</sha256>
     <tags><tag>beta</tag></tags>
     <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
     <maintainer>Moko Consulting</maintainer>
@@ -68,36 +87,17 @@
     <element>mod_mokojoomhero</element>
     <type>module</type>
     <client>site</client>
-    <version>01.04.00-rc</version>
+    <version>01.05.00-rc</version>
     <creationDate>2026-05-30</creationDate>
-    <infourl title="MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/release-candidate</infourl>
+    <infourl title='MokoJoomHero'>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/release-candidate</infourl>
     <downloads>
-      <downloadurl type="full" format="zip">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/release-candidate/mod_mokojoomhero-01.04.00-rc.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/release-candidate/mod_mokojoomhero-01.05.00-rc.zip</downloadurl>
     </downloads>
-    <sha256>ed48980c7cbd71c535f61e6eacc3f54159a1301237cbdb62ac58bdae2192c5a3</sha256>
+    <sha256>8d96e95497407fc5dbd4854120232b2dbcd8055222dfe2abd65c23bc33f9606a</sha256>
     <tags><tag>rc</tag></tags>
     <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
     <maintainer>Moko Consulting</maintainer>
     <maintainerurl>https://mokoconsulting.tech</maintainerurl>
-    <targetplatform name="joomla" version="(5|6)\..*"/>
-  </update>
-  <update>
-    <name>MokoJoomHero</name>
-    <description>MokoJoomHero stable build.</description>
-    <element>mod_mokojoomhero</element>
-    <type>module</type>
-    <client>site</client>
-    <version>01.04.00</version>
-    <creationDate>2026-05-30</creationDate>
-    <infourl title='MokoJoomHero'>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/stable</infourl>
-    <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/stable/mod_mokojoomhero-01.04.00.zip</downloadurl>
-    </downloads>
-    <sha256>ed48980c7cbd71c535f61e6eacc3f54159a1301237cbdb62ac58bdae2192c5a3</sha256>
-    <tags><tag>stable</tag></tags>
-    <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
-    <maintainer>Moko Consulting</maintainer>
-    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
     <targetplatform name="joomla" version="(5|6)\..*" />
   </update>
 </updates>
-- 
2.52.0