CI Updates

This commit is contained in:
2025-12-16 21:39:57 -06:00
parent 0a176f7c17
commit 9374a427f1
6 changed files with 529 additions and 228 deletions

View File

@@ -13,9 +13,60 @@ permissions:
contents: read
jobs:
formatting-fixes:
name: Run formatting fix scripts
runs-on: ubuntu-latest
steps:
- name: Check out repository
uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: "3.11"
- name: Run fix_tabs.py if present
shell: bash
run: |
set -euo pipefail
cd "${GITHUB_WORKSPACE}"
if [ -f "scripts/fix_tabs.py" ]; then
echo "Running scripts/fix_tabs.py"
python scripts/fix_tabs.py
else
echo "scripts/fix_tabs.py not found. Skipping."
fi
- name: Run fix_paths.py if present
shell: bash
run: |
set -euo pipefail
cd "${GITHUB_WORKSPACE}"
if [ -f "scripts/fix_paths.py" ]; then
echo "Running scripts/fix_paths.py"
python scripts/fix_paths.py
else
echo "scripts/fix_paths.py not found. Skipping."
fi
fi
- name: Fail if formatting scripts modified files
run: |
set -e
if ! git diff --quiet; then
echo "Formatting scripts introduced changes."
echo "Run fix_tabs.py and fix_paths.py locally and commit the results."
git diff
exit 1
fi
php-lint:
name: PHP lint
runs-on: ubuntu-latest
needs: formatting-fixes
steps:
- name: Check out repository
@@ -104,7 +155,7 @@ jobs:
echo "No manifest validation script found (scripts/validate_manifest.*). Skipping manifest validation step."
fi
- name: Run changelog update/verification script if present
- name: Run changelog update or verification script if present
run: |
set -e
echo "Checking for changelog update or verification scripts"

View File

@@ -23,10 +23,12 @@
## [TODO]
- `./docs/*`
- Repair `/.github/workflows/build_template.zip.yml`
- `/.github/workflows/build_updatexml.yml`
- Repair `\.github\workflows\ci.yml`
- Repair `\scripts\..`
## [UNRELEASED]
- Placeholder for next release
-
## [03.01.00] 2025-12-16
- Created `.github/workflows/`

119
scripts/fix_paths.sh Normal file
View File

@@ -0,0 +1,119 @@
#!/usr/bin/env python3
"""
fix_paths.py
Normalizes invalid Windows-style backslash separators in repository *paths*.
What it does
- Uses `git ls-files` as the authoritative inventory of tracked paths.
- Detects any tracked path that contains a backslash (\\).
- Renames the path to a forward-slash (/) equivalent via `git mv`.
- Fails fast on collisions (when the normalized target path already exists).
What it does NOT do
- Does not rewrite file contents.
- Does not alter untracked files.
Intended usage
- Called by CI (GitHub Actions) and locally.
- Safe to run repeatedly (idempotent when no invalid paths exist).
Exit codes
- 0: Success, no invalid paths or all renames completed
- 1: Operational error (git failure, collision, or unexpected exception)
"""
from __future__ import annotations
import os
import subprocess
import sys
def run(cmd: list[str]) -> subprocess.CompletedProcess:
return subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
def ensure_repo_root() -> None:
# In CI we usually start at the repo root, but this enforces determinism.
workspace = os.environ.get("GITHUB_WORKSPACE")
if workspace and os.path.isdir(workspace):
os.chdir(workspace)
def require_git_repo() -> None:
p = run(["git", "rev-parse", "--is-inside-work-tree"])
if p.returncode != 0 or p.stdout.strip() != "true":
print("Error: not inside a git work tree", file=sys.stderr)
sys.exit(1)
def list_tracked_paths() -> list[str]:
p = run(["git", "ls-files"])
if p.returncode != 0:
print("Error: git ls-files failed", file=sys.stderr)
print(p.stderr, file=sys.stderr)
sys.exit(1)
return [line for line in p.stdout.splitlines() if line.strip()]
def path_exists(path: str) -> bool:
# Use git to evaluate existence of a tracked path when possible.
# For collision detection we use filesystem existence because the target may not be tracked yet.
return os.path.exists(path)
def normalize_path(p: str) -> str:
return p.replace("\\", "/")
def git_mv(old: str, new: str) -> None:
p = run(["git", "mv", "-f", old, new])
if p.returncode != 0:
print(f"Error: git mv failed for {old} -> {new}", file=sys.stderr)
print(p.stderr, file=sys.stderr)
sys.exit(1)
def main() -> int:
ensure_repo_root()
require_git_repo()
tracked = list_tracked_paths()
bad = [p for p in tracked if "\\" in p]
if not bad:
print("No invalid backslash separators detected in tracked paths")
return 0
print(f"Detected {len(bad)} invalid tracked path(s). Normalizing.")
# Sort longest-first to reduce rename issues in nested scenarios.
bad.sort(key=len, reverse=True)
for old in bad:
new = normalize_path(old)
if old == new:
continue
# Collision check: if target exists and is not the same logical file.
if path_exists(new):
print("Collision detected. Aborting.", file=sys.stderr)
print(f"Source: {old}", file=sys.stderr)
print(f"Target: {new}", file=sys.stderr)
return 1
# Ensure destination directory exists.
dest_dir = os.path.dirname(new)
if dest_dir:
os.makedirs(dest_dir, exist_ok=True)
git_mv(old, new)
print(f"Renamed: {old} -> {new}")
return 0
if __name__ == "__main__":
sys.exit(main())

83
scripts/fix_tabs.h Normal file
View File

@@ -0,0 +1,83 @@
#!/usr/bin/env python3
"""
fix_tabs.py
Replaces all tab characters (\t) in tracked text files with two spaces.
Behavior
- Operates only on Git-tracked files.
- Skips binary files automatically via Git attributes.
- Modifies files in place.
- Intended for CI and local formatting enforcement.
Exit codes
- 0: Success, no errors
- 1: One or more files failed processing
"""
import subprocess
import sys
from pathlib import Path
REPLACEMENT = " " # two spaces
def get_tracked_files():
try:
result = subprocess.run(
["git", "ls-files"],
check=True,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
text=True,
)
return [Path(p) for p in result.stdout.splitlines() if p.strip()]
except subprocess.CalledProcessError as e:
print("Error: unable to list git-tracked files", file=sys.stderr)
print(e.stderr, file=sys.stderr)
sys.exit(1)
def is_binary(path: Path) -> bool:
try:
with path.open("rb") as f:
chunk = f.read(1024)
return b"\0" in chunk
except Exception:
return True
def process_file(path: Path) -> bool:
try:
if is_binary(path):
return True
content = path.read_text(encoding="utf-8", errors="strict")
if "\t" not in content:
return True
updated = content.replace("\t", REPLACEMENT)
path.write_text(updated, encoding="utf-8")
print(f"Normalized tabs: {path}")
return True
except UnicodeDecodeError:
# Non-UTF8 text file, skip safely
return True
except Exception as e:
print(f"Failed processing {path}: {e}", file=sys.stderr)
return False
def main() -> int:
failures = False
for file_path in get_tracked_files():
if not process_file(file_path):
failures = True
return 1 if failures else 0
if __name__ == "__main__":
sys.exit(main())

View File

@@ -1,25 +1,71 @@
#!/bin/bash
set -e
<?php
/**
* verify_changelog.php
*
* Verifies that CHANGELOG.md is compliant with basic release governance rules.
*
* Enforced rules
* - CHANGELOG.md must exist at repository root.
* - File must not contain unresolved placeholders such as "UNRELEASED" or "TBD".
* - Headings must follow semantic version format: ## [NN.NN.NN]
* - The highest version must appear first.
*
* Intended usage
* - CI validation step (read-only).
* - Does not modify files.
*
* Exit codes
* - 0: Changelog is valid
* - 1: Validation failure
*/
echo "Running changelog verifier"
$changelog = 'CHANGELOG.md';
BRANCH="${GITHUB_REF_NAME}"
if (!file_exists($changelog)) {
fwrite(STDERR, "ERROR: CHANGELOG.md not found at repository root\n");
exit(1);
}
if [[ ! "$BRANCH" =~ ^version/ ]]; then
echo "Not on a version branch. Skipping changelog verification."
exit 0
fi
$content = file_get_contents($changelog);
if ($content === false) {
fwrite(STDERR, "ERROR: Unable to read CHANGELOG.md\n");
exit(1);
}
VERSION="${BRANCH#version/}"
$errors = [];
if [ ! -f "CHANGELOG.md" ]; then
echo "ERROR: CHANGELOG.md does not exist."
exit 1
fi
// Rule: no unresolved placeholders
$placeholders = ['UNRELEASED', 'TBD', 'TO DO', 'TODO'];
foreach ($placeholders as $token) {
if (stripos($content, $token) !== false) {
$errors[] = "Unresolved placeholder detected: {$token}";
}
}
if ! grep -q "$VERSION" CHANGELOG.md; then
echo "ERROR: CHANGELOG.md missing entry for version $VERSION"
exit 1
fi
// Rule: extract version headings
preg_match_all('/^## \[([0-9]+\.[0-9]+\.[0-9]+)\]/m', $content, $matches);
$versions = $matches[1] ?? [];
echo "Changelog contains correct version section."
if (empty($versions)) {
$errors[] = 'No version headings found (expected format: ## [NN.NN.NN])';
} else {
// Rule: highest version first
$sorted = $versions;
usort($sorted, 'version_compare');
$sorted = array_reverse($sorted);
if ($versions !== $sorted) {
$errors[] = 'Versions are not ordered from newest to oldest';
}
}
if (!empty($errors)) {
fwrite(STDERR, "CHANGELOG.md validation failed:\n");
foreach ($errors as $err) {
fwrite(STDERR, " - {$err}\n");
}
exit(1);
}
echo "CHANGELOG.md validation passed\n";
exit(0);

View File

@@ -28,221 +28,221 @@
=========================================================================
-->
<extension type="template" client="site" method="upgrade">
<updateservers>
<server type="extension" name="Moko Consulting">https://raw.githubusercontent.com/mokoconsulting-tech/moko-cassiopeia/refs/heads/main/updates.xml</server>
</updateservers>
<name>moko-cassiopeia</name>
<version>03.01.00</version>
<creationDate>2025-09-23</creationDate>
<author>Jonathan Miller || Moko Consulting</author>
<authorEmail>hello@mokoconsulting.tech</authorEmail>
<copyright>(C)GNU General Public License Version 2 - 2025 Moko Consulting</copyright>
<description>TPL_MOKO-CASSIOPEIA_XML_DESCRIPTION</description>
<inheritable>1</inheritable>
<files>
<filename>component.php</filename>
<filename>error.php</filename>
<filename>index.php</filename>
<filename>joomla.asset.json</filename>
<filename>offline.php</filename>
<filename>templateDetails.xml</filename>
<folder>html</folder>
</files>
<stylesheets>
<stylesheet>media/templates/site/moko-cassiopeia/css/editor.css</stylesheet>
</stylesheets>
<media destination="templates/site/moko-cassiopeia" folder="media">
<folder>js</folder>
<folder>css</folder>
<folder>images</folder>
<folder>fonts</folder>
</media>
<positions>
<position>topbar</position>
<position>below-topbar</position>
<position>below-logo</position>
<position>menu</position>
<position>search</position>
<position>banner</position>
<position>top-a</position>
<position>top-b</position>
<position>main-top</position>
<position>main-bottom</position>
<position>breadcrumbs</position>
<position>sidebar-left</position>
<position>sidebar-right</position>
<position>bottom-a</position>
<position>bottom-b</position>
<position>footer-menu</position>
<position>footer</position>
<position>debug</position>
<position>offline-header</position>
<position>offline</position>
<position>offline-footer</position>
<position>drawer-left</position>
<position>drawer-right</position>
</positions>
<languages folder="language">
<language tag="en-GB">en-GB/tpl_moko-cassiopeia.ini</language>
<language tag="en-GB">en-GB/tpl_moko-cassiopeia.sys.ini</language>
<language tag="en-US">en-US/tpl_moko-cassiopeia.ini</language>
<language tag="en-US">en-US/tpl_moko-cassiopeia.sys.ini</language>
</languages>
<config>
<fields name="params">
<!-- Advanced tab (non-theme/system options only) -->
<fieldset name="advanced">
<!--
<field name="developmentmode" type="radio" label="TPL_MOKO-CASSIOPEIA_DEVELOPMENTMODE_LABEL" description="TPL_MOKO-CASSIOPEIA_DEVELOPMENTMODE_DESC" default="1" layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
-->
<field name="fluidContainer" type="radio" layout="joomla.form.field.radio.switcher" default="0" label="TPL_MOKO-CASSIOPEIA_FLUID_LABEL">
<option value="0">TPL_MOKO-CASSIOPEIA_STATIC</option>
<option value="1">TPL_MOKO-CASSIOPEIA_FLUID</option>
</field>
</fieldset>
<updateservers>
<server type="extension" name="Moko Consulting">https://raw.githubusercontent.com/mokoconsulting-tech/moko-cassiopeia/refs/heads/main/updates.xml</server>
</updateservers>
<name>moko-cassiopeia</name>
<version>03.01.00</version>
<creationDate>2025-09-23</creationDate>
<author>Jonathan Miller || Moko Consulting</author>
<authorEmail>hello@mokoconsulting.tech</authorEmail>
<copyright>(C)GNU General Public License Version 2 - 2025 Moko Consulting</copyright>
<description>TPL_MOKO-CASSIOPEIA_XML_DESCRIPTION</description>
<inheritable>1</inheritable>
<files>
<filename>component.php</filename>
<filename>error.php</filename>
<filename>index.php</filename>
<filename>joomla.asset.json</filename>
<filename>offline.php</filename>
<filename>templateDetails.xml</filename>
<folder>html</folder>
</files>
<stylesheets>
<stylesheet>media/templates/site/moko-cassiopeia/css/editor.css</stylesheet>
</stylesheets>
<media destination="templates/site/moko-cassiopeia" folder="media">
<folder>js</folder>
<folder>css</folder>
<folder>images</folder>
<folder>fonts</folder>
</media>
<positions>
<position>topbar</position>
<position>below-topbar</position>
<position>below-logo</position>
<position>menu</position>
<position>search</position>
<position>banner</position>
<position>top-a</position>
<position>top-b</position>
<position>main-top</position>
<position>main-bottom</position>
<position>breadcrumbs</position>
<position>sidebar-left</position>
<position>sidebar-right</position>
<position>bottom-a</position>
<position>bottom-b</position>
<position>footer-menu</position>
<position>footer</position>
<position>debug</position>
<position>offline-header</position>
<position>offline</position>
<position>offline-footer</position>
<position>drawer-left</position>
<position>drawer-right</position>
</positions>
<languages folder="language">
<language tag="en-GB">en-GB/tpl_moko-cassiopeia.ini</language>
<language tag="en-GB">en-GB/tpl_moko-cassiopeia.sys.ini</language>
<language tag="en-US">en-US/tpl_moko-cassiopeia.ini</language>
<language tag="en-US">en-US/tpl_moko-cassiopeia.sys.ini</language>
</languages>
<config>
<fields name="params">
<!-- Advanced tab (non-theme/system options only) -->
<fieldset name="advanced">
<!--
<field name="developmentmode" type="radio" label="TPL_MOKO-CASSIOPEIA_DEVELOPMENTMODE_LABEL" description="TPL_MOKO-CASSIOPEIA_DEVELOPMENTMODE_DESC" default="1" layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
-->
<field name="fluidContainer" type="radio" layout="joomla.form.field.radio.switcher" default="0" label="TPL_MOKO-CASSIOPEIA_FLUID_LABEL">
<option value="0">TPL_MOKO-CASSIOPEIA_STATIC</option>
<option value="1">TPL_MOKO-CASSIOPEIA_FLUID</option>
</field>
</fieldset>
<!-- Google tab -->
<fieldset name="google">
<field name="googletagmanager" type="radio" label="TPL_MOKO-CASSIOPEIA_GOOGLETAGMANAGER_LABEL" description="TPL_MOKO-CASSIOPEIA_GOOGLETAGMANAGER_DESC" layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="googletagmanagerid" type="text" default="" label="TPL_MOKO-CASSIOPEIA_GOOGLETAGMANAGERID_LABEL" description="TPL_MOKO-CASSIOPEIA_GOOGLETAGMANAGERID_DESC" filter="string" showon="googletagmanager:1" />
<field name="googleanalytics" type="radio" label="TPL_MOKO-CASSIOPEIA_GOOGLEANALYTICS_LABEL" description="TPL_MOKO-CASSIOPEIA_GOOGLEANALYTICS_DESC" layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="googleanalyticsid" type="text" default="" label="TPL_MOKO-CASSIOPEIA_GOOGLEANALYTICSID_LABEL" description="TPL_MOKO-CASSIOPEIA_GOOGLEANALYTICSID_DESC" filter="string" showon="googleanalytics:1" />
</fieldset>
<!-- Google tab -->
<fieldset name="google">
<field name="googletagmanager" type="radio" label="TPL_MOKO-CASSIOPEIA_GOOGLETAGMANAGER_LABEL" description="TPL_MOKO-CASSIOPEIA_GOOGLETAGMANAGER_DESC" layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="googletagmanagerid" type="text" default="" label="TPL_MOKO-CASSIOPEIA_GOOGLETAGMANAGERID_LABEL" description="TPL_MOKO-CASSIOPEIA_GOOGLETAGMANAGERID_DESC" filter="string" showon="googletagmanager:1" />
<field name="googleanalytics" type="radio" label="TPL_MOKO-CASSIOPEIA_GOOGLEANALYTICS_LABEL" description="TPL_MOKO-CASSIOPEIA_GOOGLEANALYTICS_DESC" layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="googleanalyticsid" type="text" default="" label="TPL_MOKO-CASSIOPEIA_GOOGLEANALYTICSID_LABEL" description="TPL_MOKO-CASSIOPEIA_GOOGLEANALYTICSID_DESC" filter="string" showon="googleanalytics:1" />
</fieldset>
<!-- Custom Code tab -->
<fieldset name="custom_head" label="TPL_MOKO-CASSIOPEIA_CUSTOM_CODE_FIELDSET">
<field name="custom_head_start" type="textarea" default="" label="TPL_MOKO-CASSIOPEIA_CUSTOM_HEAD_START_LABEL" description="TPL_MOKO-CASSIOPEIA_CUSTOM_HEAD_START_DESC" filter="raw" />
<field name="custom_head_end" type="textarea" default="" label="TPL_MOKO-CASSIOPEIA_CUSTOM_HEAD_END_LABEL" description="TPL_MOKO-CASSIOPEIA_CUSTOM_HEAD_END_DESC" filter="raw" />
</fieldset>
<!-- Custom Code tab -->
<fieldset name="custom_head" label="TPL_MOKO-CASSIOPEIA_CUSTOM_CODE_FIELDSET">
<field name="custom_head_start" type="textarea" default="" label="TPL_MOKO-CASSIOPEIA_CUSTOM_HEAD_START_LABEL" description="TPL_MOKO-CASSIOPEIA_CUSTOM_HEAD_START_DESC" filter="raw" />
<field name="custom_head_end" type="textarea" default="" label="TPL_MOKO-CASSIOPEIA_CUSTOM_HEAD_END_LABEL" description="TPL_MOKO-CASSIOPEIA_CUSTOM_HEAD_END_DESC" filter="raw" />
</fieldset>
<!-- Drawers tab -->
<fieldset name="drawers">
<field name="drawerLeftIcon" type="text" default="fa-solid fa-chevron-right" label="TPL_MOKO-CASSIOPEIA_DRAWER_LEFT_ICON_LABEL" description="TPL_MOKO-CASSIOPEIA_DRAWER_LEFT_ICON_DESC" filter="string" />
<field name="drawerRightIcon" type="text" default="fa-solid fa-chevron-left" label="TPL_MOKO-CASSIOPEIA_DRAWER_RIGHT_ICON_LABEL" description="TPL_MOKO-CASSIOPEIA_DRAWER_RIGHT_ICON_DESC" filter="string" />
</fieldset>
<!-- Drawers tab -->
<fieldset name="drawers">
<field name="drawerLeftIcon" type="text" default="fa-solid fa-chevron-right" label="TPL_MOKO-CASSIOPEIA_DRAWER_LEFT_ICON_LABEL" description="TPL_MOKO-CASSIOPEIA_DRAWER_LEFT_ICON_DESC" filter="string" />
<field name="drawerRightIcon" type="text" default="fa-solid fa-chevron-left" label="TPL_MOKO-CASSIOPEIA_DRAWER_RIGHT_ICON_LABEL" description="TPL_MOKO-CASSIOPEIA_DRAWER_RIGHT_ICON_DESC" filter="string" />
</fieldset>
<!-- THEME TAB (all style/theme settings grouped) -->
<fieldset name="theme" label="TPL_MOKO_THEME_FIELDSET">
<!-- THEME TAB (all style/theme settings grouped) -->
<fieldset name="theme" label="TPL_MOKO_THEME_FIELDSET">
<!-- General -->
<field name="theme_sep_general" type="spacer" label="General" hr="false" class="text fw-bold" />
<field name="theme_enabled" type="radio" default="1"
label="TPL_MOKO_THEME_ENABLED" description="TPL_MOKO_THEME_ENABLED_DESC"
layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="theme_control_type" type="list" default="radios"
label="TPL_MOKO_THEME_CONTROL_TYPE" description="TPL_MOKO_THEME_CONTROL_TYPE_DESC">
<option value="switch">Switch (Light↔Dark)</option>
<option value="radios">Radios (Light/Dark/System)</option>
<option value="none">No visible control</option>
</field>
<field name="theme_default_choice" type="list" default="system"
label="TPL_MOKO_THEME_DEFAULT_CHOICE" description="TPL_MOKO_THEME_DEFAULT_CHOICE_DESC">
<option value="system">System</option>
<option value="light">Light</option>
<option value="dark">Dark</option>
</field>
<field name="theme_auto_dark" type="radio" default="0"
label="TPL_MOKO_THEME_AUTO_DARK" description="TPL_MOKO_THEME_AUTO_DARK_DESC"
layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="theme_meta_color_scheme" type="radio" default="1"
label="TPL_MOKO_THEME_META_COLOR_SCHEME" description="TPL_MOKO_THEME_META_COLOR_SCHEME_DESC"
layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="theme_meta_theme_color" type="radio" default="1"
label="TPL_MOKO_THEME_META_THEME_COLOR" description="TPL_MOKO_THEME_META_THEME_COLOR_DESC"
layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="theme_bridge_bs_aria" type="radio" default="1"
label="TPL_MOKO_THEME_BRIDGE" description="TPL_MOKO_THEME_BRIDGE_DESC"
layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<!-- General -->
<field name="theme_sep_general" type="spacer" label="General" hr="false" class="text fw-bold" />
<field name="theme_enabled" type="radio" default="1"
label="TPL_MOKO_THEME_ENABLED" description="TPL_MOKO_THEME_ENABLED_DESC"
layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="theme_control_type" type="list" default="radios"
label="TPL_MOKO_THEME_CONTROL_TYPE" description="TPL_MOKO_THEME_CONTROL_TYPE_DESC">
<option value="switch">Switch (Light↔Dark)</option>
<option value="radios">Radios (Light/Dark/System)</option>
<option value="none">No visible control</option>
</field>
<field name="theme_default_choice" type="list" default="system"
label="TPL_MOKO_THEME_DEFAULT_CHOICE" description="TPL_MOKO_THEME_DEFAULT_CHOICE_DESC">
<option value="system">System</option>
<option value="light">Light</option>
<option value="dark">Dark</option>
</field>
<field name="theme_auto_dark" type="radio" default="0"
label="TPL_MOKO_THEME_AUTO_DARK" description="TPL_MOKO_THEME_AUTO_DARK_DESC"
layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="theme_meta_color_scheme" type="radio" default="1"
label="TPL_MOKO_THEME_META_COLOR_SCHEME" description="TPL_MOKO_THEME_META_COLOR_SCHEME_DESC"
layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="theme_meta_theme_color" type="radio" default="1"
label="TPL_MOKO_THEME_META_THEME_COLOR" description="TPL_MOKO_THEME_META_THEME_COLOR_DESC"
layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="theme_bridge_bs_aria" type="radio" default="1"
label="TPL_MOKO_THEME_BRIDGE" description="TPL_MOKO_THEME_BRIDGE_DESC"
layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<!-- Variables & Palettes -->
<field name="theme_sep_vars" type="spacer" label="Variables &amp; Palettes" hr="false" class="text fw-bold" />
<field name="colorLightName" type="list" label="TPL_MOKO-CASSIOPEIA_COLOR_LIGHT_NAME_LABEL" default="colors_standard">
<option value="colors_standard">TPL_MOKO-CASSIOPEIA_COLOR_NAME_STANDARD</option>
<option value="colors_alternative">TPL_MOKO-CASSIOPEIA_COLOR_NAME_ALTERNATIVE</option>
<option value="colors_custom">TPL_MOKO-CASSIOPEIA_COLOR_NAME_CUSTOM</option>
</field>
<field name="colorDarkName" type="list" label="TPL_MOKO-CASSIOPEIA_COLOR_DARK_NAME_LABEL" default="colors_standard">
<option value="colors_standard">TPL_MOKO-CASSIOPEIA_COLOR_NAME_STANDARD</option>
<option value="colors_alternative">TPL_MOKO-CASSIOPEIA_COLOR_NAME_ALTERNATIVE</option>
<option value="colors_custom">TPL_MOKO-CASSIOPEIA_COLOR_NAME_CUSTOM</option>
</field>
<!-- Variables & Palettes -->
<field name="theme_sep_vars" type="spacer" label="Variables &amp; Palettes" hr="false" class="text fw-bold" />
<field name="colorLightName" type="list" label="TPL_MOKO-CASSIOPEIA_COLOR_LIGHT_NAME_LABEL" default="colors_standard">
<option value="colors_standard">TPL_MOKO-CASSIOPEIA_COLOR_NAME_STANDARD</option>
<option value="colors_alternative">TPL_MOKO-CASSIOPEIA_COLOR_NAME_ALTERNATIVE</option>
<option value="colors_custom">TPL_MOKO-CASSIOPEIA_COLOR_NAME_CUSTOM</option>
</field>
<field name="colorDarkName" type="list" label="TPL_MOKO-CASSIOPEIA_COLOR_DARK_NAME_LABEL" default="colors_standard">
<option value="colors_standard">TPL_MOKO-CASSIOPEIA_COLOR_NAME_STANDARD</option>
<option value="colors_alternative">TPL_MOKO-CASSIOPEIA_COLOR_NAME_ALTERNATIVE</option>
<option value="colors_custom">TPL_MOKO-CASSIOPEIA_COLOR_NAME_CUSTOM</option>
</field>
<!-- Typography -->
<field name="theme_sep_typo" type="spacer" label="Typography" hr="false" class="text fw-bold" />
<field name="useFontScheme" type="groupedlist" label="TPL_MOKO-CASSIOPEIA_FONT_LABEL" default="0">
<option value="0">JNONE</option>
<group label="TPL_MOKO-CASSIOPEIA_FONT_GROUP_LOCAL">
<option value="media/templates/site/moko-cassiopeia/css/global/fonts-local_roboto.css">Roboto (local)</option>
</group>
<group label="TPL_MOKO-CASSIOPEIA_FONT_GROUP_WEB">
<option value="https://fonts.googleapis.com/css2?family=Fira+Sans:wght@100;300;400;700&amp;display=swap">Fira Sans (web)</option>
<option value="https://fonts.googleapis.com/css2?family=Noto+Sans:wght@100;300;400;700&amp;family=Roboto:wght@100;300;400;700&amp;display=swap">Roboto + Noto Sans (web)</option>
</group>
</field>
<field name="noteFontScheme" type="note" description="TPL_MOKO-CASSIOPEIA_FONT_NOTE_TEXT" class="alert alert-warning" />
<!-- Typography -->
<field name="theme_sep_typo" type="spacer" label="Typography" hr="false" class="text fw-bold" />
<field name="useFontScheme" type="groupedlist" label="TPL_MOKO-CASSIOPEIA_FONT_LABEL" default="0">
<option value="0">JNONE</option>
<group label="TPL_MOKO-CASSIOPEIA_FONT_GROUP_LOCAL">
<option value="media/templates/site/moko-cassiopeia/css/global/fonts-local_roboto.css">Roboto (local)</option>
</group>
<group label="TPL_MOKO-CASSIOPEIA_FONT_GROUP_WEB">
<option value="https://fonts.googleapis.com/css2?family=Fira+Sans:wght@100;300;400;700&amp;display=swap">Fira Sans (web)</option>
<option value="https://fonts.googleapis.com/css2?family=Noto+Sans:wght@100;300;400;700&amp;family=Roboto:wght@100;300;400;700&amp;display=swap">Roboto + Noto Sans (web)</option>
</group>
</field>
<field name="noteFontScheme" type="note" description="TPL_MOKO-CASSIOPEIA_FONT_NOTE_TEXT" class="alert alert-warning" />
<!-- Branding & Icons -->
<field name="theme_sep_brand" type="spacer" label="Branding &amp; Icons" hr="false" class="text fw-bold" />
<field name="brand" type="radio" label="TPL_MOKO-CASSIOPEIA_BRAND_LABEL" default="1" layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="logoFile" type="media" default="media/templates/site/moko-cassiopeia/images/logo.svg" label="TPL_MOKO-CASSIOPEIA_LOGO_LABEL" showon="brand:1" />
<field name="siteTitle" type="text" default="" label="TPL_MOKO-CASSIOPEIA_TITLE" filter="string" showon="brand:1" />
<field name="siteDescription" type="text" default="" label="TPL_MOKO-CASSIOPEIA_TAGLINE_LABEL" description="TPL_MOKO-CASSIOPEIA_TAGLINE_DESC" filter="string" showon="brand:1" />
<field name="fA6KitCode" type="text" default="" label="TPL_MOKO-CASSIOPEIA_FA6KITCODE_LABEL" description="TPL_MOKO-CASSIOPEIA_FA6KITCODE_DESC" filter="string" />
<!-- Branding & Icons -->
<field name="theme_sep_brand" type="spacer" label="Branding &amp; Icons" hr="false" class="text fw-bold" />
<field name="brand" type="radio" label="TPL_MOKO-CASSIOPEIA_BRAND_LABEL" default="1" layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="logoFile" type="media" default="media/templates/site/moko-cassiopeia/images/logo.svg" label="TPL_MOKO-CASSIOPEIA_LOGO_LABEL" showon="brand:1" />
<field name="siteTitle" type="text" default="" label="TPL_MOKO-CASSIOPEIA_TITLE" filter="string" showon="brand:1" />
<field name="siteDescription" type="text" default="" label="TPL_MOKO-CASSIOPEIA_TAGLINE_LABEL" description="TPL_MOKO-CASSIOPEIA_TAGLINE_DESC" filter="string" showon="brand:1" />
<field name="fA6KitCode" type="text" default="" label="TPL_MOKO-CASSIOPEIA_FA6KITCODE_LABEL" description="TPL_MOKO-CASSIOPEIA_FA6KITCODE_DESC" filter="string" />
<!-- Header & Navigation UI -->
<field name="theme_sep_header" type="spacer" label="Header &amp; Navigation" hr="false" class="text fw-bold" />
<field name="stickyHeader" type="radio" label="TPL_MOKO-CASSIOPEIA_STICKY_LABEL" layout="joomla.form.field.radio.switcher" default="0" filter="integer">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="backTop" type="radio" label="TPL_MOKO-CASSIOPEIA_BACKTOTOP_LABEL" layout="joomla.form.field.radio.switcher" default="0" filter="integer">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<!-- Header & Navigation UI -->
<field name="theme_sep_header" type="spacer" label="Header &amp; Navigation" hr="false" class="text fw-bold" />
<field name="stickyHeader" type="radio" label="TPL_MOKO-CASSIOPEIA_STICKY_LABEL" layout="joomla.form.field.radio.switcher" default="0" filter="integer">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="backTop" type="radio" label="TPL_MOKO-CASSIOPEIA_BACKTOTOP_LABEL" layout="joomla.form.field.radio.switcher" default="0" filter="integer">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<!-- Toggle UI -->
<field name="theme_sep_toggle" type="spacer" label="Theme Toggle UI" hr="false" class="text fw-bold" />
<field name="theme_fab_enabled" type="radio" default="1"
label="TPL_MOKO_THEME_FAB_ENABLED" description="TPL_MOKO_THEME_FAB_ENABLED_DESC"
layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="theme_fab_pos" type="list" default="br"
label="TPL_MOKO_THEME_FAB_POS" description="TPL_MOKO_THEME_FAB_POS_DESC">
<option value="br">Bottom-right</option>
<option value="bl">Bottom-left</option>
<option value="tr">Top-right</option>
<option value="tl">Top-left</option>
</field>
</fieldset>
</fields>
</config>
<!-- Toggle UI -->
<field name="theme_sep_toggle" type="spacer" label="Theme Toggle UI" hr="false" class="text fw-bold" />
<field name="theme_fab_enabled" type="radio" default="1"
label="TPL_MOKO_THEME_FAB_ENABLED" description="TPL_MOKO_THEME_FAB_ENABLED_DESC"
layout="joomla.form.field.radio.switcher" filter="boolean">
<option value="0">JNO</option>
<option value="1">JYES</option>
</field>
<field name="theme_fab_pos" type="list" default="br"
label="TPL_MOKO_THEME_FAB_POS" description="TPL_MOKO_THEME_FAB_POS_DESC">
<option value="br">Bottom-right</option>
<option value="bl">Bottom-left</option>
<option value="tr">Top-right</option>
<option value="tl">Top-left</option>
</field>
</fieldset>
</fields>
</config>
</extension>