chore(version): pre-release bump to 01.00.02-dev [skip ci]

4 sub-extensions: com, system plugin, webservices, content plugin.
4 DB tables: forms, fields, submissions, notifications.

.mokogitea/workflows/issue-branch.yml

@@ -5,7 +5,7 @@
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
 # INGROUP: moko-platform.Automation
-# VERSION: 01.00.00
+# VERSION: 01.00.02
 # BRIEF: Auto-create feature branch when an issue is opened
 
 name: "Universal: Issue Branch"

.mokogitea/workflows/pre-release.yml

@@ -8,4 +8,245 @@
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
 # PATH: /templates/workflows/universal/pre-release.yml.template
 # VERSION: 05.01.00
-# BRIEF: Auto pre-release on push to dev/alpha/beta/rc branches
+# BRIEF: Auto pre-release on push to dev/alpha/beta/rc branches
+
+name: "Universal: Pre-Release"
+
+on:
+  push:
+    branches:
+      - dev
+      - 'fix/**'
+      - 'patch/**'
+      - 'hotfix/**'
+      - 'bugfix/**'
+      - 'chore/**'
+      - alpha
+      - beta
+      - rc
+  workflow_dispatch:
+    inputs:
+      stability:
+        description: 'Pre-release channel'
+        required: true
+        type: choice
+        options:
+          - development
+          - alpha
+          - beta
+          - release-candidate
+
+permissions:
+  contents: write
+
+env:
+  GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
+  GITEA_ORG: ${{ vars.GITEA_ORG || github.repository_owner }}
+  GITEA_REPO: ${{ vars.GITEA_REPO || github.event.repository.name }}
+
+jobs:
+  build:
+    name: "Build Pre-Release (${{ inputs.stability || github.ref_name }})"
+    runs-on: release
+    if: >-
+      github.event_name == 'workflow_dispatch' ||
+      github.event_name == 'push'
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.MOKOGITEA_TOKEN }}
+          ref: ${{ github.ref_name }}
+
+      - name: Setup moko-platform tools
+        env:
+          MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
+          MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
+        run: |
+          # Use pre-installed /opt/moko-platform if available (updated by cron every 6h)
+          if [ -f /opt/moko-platform/cli/version_bump.php ] && [ -f /opt/moko-platform/cli/manifest_element.php ] && [ -f /opt/moko-platform/vendor/autoload.php ]; then
+            echo Using pre-installed /opt/moko-platform
+            echo MOKO_CLI=/opt/moko-platform/cli >> $GITHUB_ENV
+          else
+            echo Falling back to fresh clone
+            if ! command -v composer > /dev/null 2>&1; then
+              sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer > /dev/null 2>&1
+            fi
+            rm -rf /tmp/moko-platform-api
+            CLONE_URL=https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git
+            git clone --depth 1 --branch main --quiet $CLONE_URL /tmp/moko-platform-api
+            cd /tmp/moko-platform-api && composer install --no-dev --no-interaction --quiet
+            echo MOKO_CLI=/tmp/moko-platform-api/cli >> $GITHUB_ENV
+          fi
+
+      - name: Detect platform
+        id: platform
+        run: |
+          # Auto-detect and update platform if not set in manifest
+          php ${MOKO_CLI}/platform_detect.php --path . --github-output 2>/dev/null || true
+          php ${MOKO_CLI}/manifest_read.php --path . --github-output
+
+      - name: Resolve metadata and bump version
+        id: meta
+        run: |
+          # Auto-detect stability from branch name on push, or use input on dispatch
+          if [ "${{ github.event_name }}" = "push" ]; then
+            case "${{ github.ref_name }}" in
+              rc)    STABILITY="release-candidate" ;;
+              alpha) STABILITY="alpha" ;;
+              beta)  STABILITY="beta" ;;
+              *)     STABILITY="development" ;;
+            esac
+          else
+            STABILITY="${{ inputs.stability || 'development' }}"
+          fi
+
+          case "$STABILITY" in
+            development)        SUFFIX="-dev";   TAG="development" ;;
+            alpha)              SUFFIX="-alpha"; TAG="alpha" ;;
+            beta)               SUFFIX="-beta";  TAG="beta" ;;
+            release-candidate)  SUFFIX="-rc";    TAG="release-candidate" ;;
+          esac
+
+          # Bump version via CLI: patch for dev/alpha/beta, minor for RC
+          case "$STABILITY" in
+            release-candidate) BUMP="minor" ;;
+            *)                 BUMP="patch" ;;
+          esac
+
+          php ${MOKO_CLI}/version_bump.php --path . $([ "$BUMP" = "minor" ] && echo "--minor") 2>/dev/null || true
+
+          # Set stability suffix and verify consistency
+          VERSION=$(php ${MOKO_CLI}/version_read.php --path . 2>/dev/null || echo "00.00.01")
+          VERSION=$(echo "$VERSION" | sed 's/-\(dev\|alpha\|beta\|rc\)$//')
+
+          php ${MOKO_CLI}/version_set_platform.php \
+            --path . --version "$VERSION" --branch "${{ github.ref_name }}" --stability "$STABILITY" 2>/dev/null || true
+          php ${MOKO_CLI}/version_check.php --path . --fix 2>/dev/null || true
+
+          # Ensure licensing tags (updateservers, dlid) if enabled in manifest.xml
+          php ${MOKO_CLI}/manifest_licensing.php --path . --fix 2>/dev/null || true
+
+          # Append suffix for output
+          if [ -n "$SUFFIX" ]; then
+            VERSION="${VERSION}${SUFFIX}"
+          fi
+
+          # Commit version bump
+          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+          git config --local user.name "gitea-actions[bot]"
+          git remote set-url origin "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
+          git add -A
+          git diff --cached --quiet || {
+            git commit -m "chore(version): pre-release bump to ${VERSION} [skip ci]"
+            git push origin HEAD 2>&1
+          }
+
+          # Auto-detect element via manifest_element.php
+          php ${MOKO_CLI}/manifest_element.php \
+            --path . --version "$VERSION" --stability "$STABILITY" \
+            --repo "${GITEA_REPO}" --github-output
+
+          # Read back element outputs
+          EXT_ELEMENT=$(grep '^ext_element=' "$GITHUB_OUTPUT" | tail -1 | cut -d= -f2)
+          ZIP_NAME=$(grep '^zip_name=' "$GITHUB_OUTPUT" | tail -1 | cut -d= -f2)
+          [ -z "$EXT_ELEMENT" ] && EXT_ELEMENT=$(echo "${GITEA_REPO}" | tr '[:upper:]' '[:lower:]' | tr -d ' -')
+          [ -z "$ZIP_NAME" ] && ZIP_NAME="${EXT_ELEMENT}-${VERSION}.zip"
+
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "stability=${STABILITY}" >> "$GITHUB_OUTPUT"
+          echo "suffix=${SUFFIX}" >> "$GITHUB_OUTPUT"
+          echo "tag=${TAG}" >> "$GITHUB_OUTPUT"
+          echo "zip_name=${ZIP_NAME}" >> "$GITHUB_OUTPUT"
+          echo "ext_element=${EXT_ELEMENT}" >> "$GITHUB_OUTPUT"
+
+          echo "=== Pre-Release: ${EXT_ELEMENT} ${VERSION}${SUFFIX} ==="
+
+      - name: Create release
+        id: release
+        run: |
+          TAG="${{ steps.meta.outputs.tag }}"
+          VERSION="${{ steps.meta.outputs.version }}"
+          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
+          php ${MOKO_CLI}/release_create.php \
+            --path . --version "$VERSION" --tag "$TAG" \
+            --token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
+            --repo "${GITEA_REPO}" --branch "${{ github.ref_name }}" --prerelease
+
+      - name: Update release notes from CHANGELOG.md
+        run: |
+          TAG="${{ steps.meta.outputs.tag }}"
+          VERSION="${{ steps.meta.outputs.version }}"
+          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
+
+          # Extract [Unreleased] section from changelog (everything between [Unreleased] and next ## heading)
+          if [ -f "CHANGELOG.md" ]; then
+            NOTES=$(awk '/^## \[Unreleased\]/{found=1; next} /^## \[/{if(found) exit} found{print}' CHANGELOG.md)
+            [ -z "$NOTES" ] && NOTES="Release ${VERSION}"
+          else
+            NOTES="Release ${VERSION}"
+          fi
+
+          # Update release body via API
+          RELEASE_ID=$(curl -sf -H "Authorization: token ${{ secrets.MOKOGITEA_TOKEN }}" \
+            "${API_BASE}/releases/tags/${TAG}" | python3 -c "import json,sys; print(json.load(sys.stdin).get('id',''))" 2>/dev/null || true)
+
+          if [ -n "$RELEASE_ID" ]; then
+            python3 -c "
+          import json, urllib.request
+          body = open('/dev/stdin').read()
+          payload = json.dumps({'body': body}).encode()
+          req = urllib.request.Request(
+              '${API_BASE}/releases/${RELEASE_ID}',
+              data=payload, method='PATCH',
+              headers={
+                  'Authorization': 'token ${{ secrets.MOKOGITEA_TOKEN }}',
+                  'Content-Type': 'application/json'
+              })
+          urllib.request.urlopen(req)
+          " <<< "$NOTES"
+            echo "Release notes updated from CHANGELOG.md"
+          fi
+
+      - name: Build package and upload
+        id: package
+        run: |
+          VERSION="${{ steps.meta.outputs.version }}"
+          TAG="${{ steps.meta.outputs.tag }}"
+          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
+          php ${MOKO_CLI}/release_package.php \
+            --path . --version "$VERSION" --tag "$TAG" \
+            --token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
+            --repo "${GITEA_REPO}" --output /tmp || true
+
+      # updates.xml is generated dynamically by MokoGitea license server
+      # No need to build, commit, or sync updates.xml from workflows
+
+      - name: "Delete lesser pre-release channels (cascade)"
+        continue-on-error: true
+        run: |
+          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
+          TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
+
+          php ${MOKO_CLI}/release_cascade.php \
+            --stability "${{ steps.meta.outputs.stability }}" \
+            --token "${TOKEN}" \
+            --api-base "${API_BASE}"
+
+      - name: Summary
+        if: always()
+        run: |
+          VERSION="${{ steps.meta.outputs.version }}"
+          STABILITY="${{ steps.meta.outputs.stability }}"
+          ZIP_NAME="${{ steps.meta.outputs.zip_name }}"
+          SHA256="${{ steps.package.outputs.sha256_zip }}"
+          echo "## Pre-Release Complete" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "| Field | Value |" >> $GITHUB_STEP_SUMMARY
+          echo "|-------|-------|" >> $GITHUB_STEP_SUMMARY
+          echo "| Version | \`${VERSION}\` |" >> $GITHUB_STEP_SUMMARY
+          echo "| Channel | ${STABILITY} |" >> $GITHUB_STEP_SUMMARY
+          echo "| Package | \`${ZIP_NAME}\` |" >> $GITHUB_STEP_SUMMARY
+          echo "| SHA-256 | \`${SHA256:-n/a}\` |" >> $GITHUB_STEP_SUMMARY

CODE_OF_CONDUCT.md

@@ -14,7 +14,7 @@
 	DEFGROUP: MokoStandards-Template-Joomla-Plugin
 	INGROUP: MokoStandards-Template-Joomla-Plugin.Documentation
 	REPO: https://github.com/mokoconsulting-tech/MokoStandards-Template-Joomla-Plugin/
-  VERSION: 01.01.00
+  VERSION: 01.00.02
   PATH: ./CODE_OF_CONDUCT.md
   BRIEF: Community expectations and enforcement guidelines
   NOTE: Adapted with attribution from the Contributor Covenant v2.1

GOVERNANCE.md

@@ -19,7 +19,7 @@
  DEFGROUP: mokoconsulting-tech.MokoStandards-Template-Joomla-Plugin
  INGROUP: MokoStandards.Governance
  REPO: https://github.com/mokoconsulting-tech/MokoStandards-Template-Joomla-Plugin
- VERSION: 01.01.00
+ VERSION: 01.00.02
  PATH: /GOVERNANCE.md
  BRIEF: Project governance rules, roles, and decision process for MokoStandards-Template-Joomla-Plugin
 -->

SECURITY.md

@@ -23,7 +23,7 @@ DEFGROUP: MokoStandards-Template-Joomla-Plugin
 INGROUP: MokoStandards-Template-Joomla-Plugin.Documentation
 REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards-Template-Joomla-Plugin
 PATH: /SECURITY.md
-VERSION: 01.01.00
+VERSION: 01.00.02
 BRIEF: Security vulnerability reporting and handling policy
 -->
 

source/language/en-GB/pkg_mokosuiteforms.sys.ini

@@ -0,0 +1,2 @@
+PKG_MOKOSUITEFORMS="MokoSuiteForms"
+PKG_MOKOSUITEFORMS_DESCRIPTION="Form builder package — custom forms, submissions, notifications, and data export."

source/language/en-US/pkg_mokosuiteforms.sys.ini

@@ -0,0 +1,2 @@
+PKG_MOKOSUITEFORMS="MokoSuiteForms"
+PKG_MOKOSUITEFORMS_DESCRIPTION="Form builder package — custom forms, submissions, notifications, and data export."

source/packages/com_mokosuiteforms/language/en-GB/com_mokosuiteforms.ini

@@ -0,0 +1,7 @@
+COM_MOKOSUITEFORMS="MokoSuiteForms"
+COM_MOKOSUITEFORMS_DESCRIPTION="Form builder — custom forms, submissions, notifications, and data export."
+COM_MOKOSUITEFORMS_DASHBOARD_TITLE="Form Builder Dashboard"
+COM_MOKOSUITEFORMS_DASHBOARD_DESC="Manage your forms, view submissions, and configure notifications."
+COM_MOKOSUITEFORMS_QUICK_LINKS="Quick Links"
+COM_MOKOSUITEFORMS_FORMS="Forms"
+COM_MOKOSUITEFORMS_SUBMISSIONS="Submissions"

source/packages/com_mokosuiteforms/language/en-GB/com_mokosuiteforms.sys.ini

@@ -0,0 +1,3 @@
+COM_MOKOSUITEFORMS="MokoSuiteForms"
+COM_MOKOSUITEFORMS_DESCRIPTION="Form builder — custom forms, submissions, notifications, and data export."
+COM_MOKOSUITEFORMS_XML_DESCRIPTION="MokoSuiteForms component for building and managing custom forms."

source/packages/com_mokosuiteforms/language/en-US/com_mokosuiteforms.ini

@@ -0,0 +1,7 @@
+COM_MOKOSUITEFORMS="MokoSuiteForms"
+COM_MOKOSUITEFORMS_DESCRIPTION="Form builder — custom forms, submissions, notifications, and data export."
+COM_MOKOSUITEFORMS_DASHBOARD_TITLE="Form Builder Dashboard"
+COM_MOKOSUITEFORMS_DASHBOARD_DESC="Manage your forms, view submissions, and configure notifications."
+COM_MOKOSUITEFORMS_QUICK_LINKS="Quick Links"
+COM_MOKOSUITEFORMS_FORMS="Forms"
+COM_MOKOSUITEFORMS_SUBMISSIONS="Submissions"

source/packages/com_mokosuiteforms/language/en-US/com_mokosuiteforms.sys.ini

@@ -0,0 +1,3 @@
+COM_MOKOSUITEFORMS="MokoSuiteForms"
+COM_MOKOSUITEFORMS_DESCRIPTION="Form builder — custom forms, submissions, notifications, and data export."
+COM_MOKOSUITEFORMS_XML_DESCRIPTION="MokoSuiteForms component for building and managing custom forms."

source/packages/com_mokosuiteforms/mokosuiteforms.xml

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<extension type="component" method="upgrade">
+    <name>com_mokosuiteforms</name>
+    <version>01.00.02</version>
+    <creationDate>2026-06-10</creationDate>
+    <author>Moko Consulting</author>
+    <authorEmail>hello@mokoconsulting.tech</authorEmail>
+    <authorUrl>https://mokoconsulting.tech</authorUrl>
+    <copyright>(C) 2026 Moko Consulting. All rights reserved.</copyright>
+    <license>GPL-3.0-or-later</license>
+    <description>COM_MOKOSUITEFORMS_DESCRIPTION</description>
+    <namespace path="src">MokoConsulting\Component\MokoSuiteForms</namespace>
+    <install>
+        <sql><file driver="mysql" charset="utf8">sql/install.mysql.sql</file></sql>
+    </install>
+    <uninstall>
+        <sql><file driver="mysql" charset="utf8">sql/uninstall.mysql.sql</file></sql>
+    </uninstall>
+    <update>
+        <schemas><schemapath type="mysql">sql/updates/mysql</schemapath></schemas>
+    </update>
+    <files folder=".">
+        <folder>forms</folder>
+        <folder>services</folder>
+        <folder>sql</folder>
+        <folder>src</folder>
+        <folder>tmpl</folder>
+    </files>
+    <languages folder="language">
+        <language tag="en-GB">en-GB/com_mokosuiteforms.ini</language>
+        <language tag="en-GB">en-GB/com_mokosuiteforms.sys.ini</language>
+        <language tag="en-US">en-US/com_mokosuiteforms.ini</language>
+        <language tag="en-US">en-US/com_mokosuiteforms.sys.ini</language>
+    </languages>
+    <administration>
+        <menu>COM_MOKOSUITEFORMS</menu>
+    </administration>
+</extension>

source/packages/com_mokosuiteforms/services/provider.php

@@ -0,0 +1,35 @@
+<?php
+
+/**
+ * @copyright  (C) 2026 Moko Consulting. All rights reserved.
+ * @license    GPL-3.0-or-later
+ */
+
+declare(strict_types=1);
+
+use Joomla\CMS\Dispatcher\ComponentDispatcherFactoryInterface;
+use Joomla\CMS\Extension\ComponentInterface;
+use Joomla\CMS\Extension\Service\Provider\ComponentDispatcherFactory;
+use Joomla\CMS\Extension\Service\Provider\MVCFactory;
+use Joomla\CMS\MVC\Factory\MVCFactoryInterface;
+use Joomla\DI\Container;
+use Joomla\DI\ServiceProviderInterface;
+use MokoConsulting\Component\MokoSuiteForms\Administrator\Extension\MokoSuiteFormsComponent;
+
+return new class () implements ServiceProviderInterface {
+    public function register(Container $container): void
+    {
+        $container->registerServiceProvider(new MVCFactory('\\MokoConsulting\\Component\\MokoSuiteForms'));
+        $container->registerServiceProvider(new ComponentDispatcherFactory('\\MokoConsulting\\Component\\MokoSuiteForms'));
+
+        $container->set(
+            ComponentInterface::class,
+            function (Container $container) {
+                $component = new MokoSuiteFormsComponent($container->get(ComponentDispatcherFactoryInterface::class));
+                $component->setMVCFactory($container->get(MVCFactoryInterface::class));
+
+                return $component;
+            }
+        );
+    }
+};

source/packages/com_mokosuiteforms/sql/install.mysql.sql

@@ -0,0 +1,67 @@
+CREATE TABLE IF NOT EXISTS `#__mokosuiteforms_forms` (
+    `id` INT UNSIGNED NOT NULL AUTO_INCREMENT,
+    `title` VARCHAR(255) NOT NULL DEFAULT '',
+    `alias` VARCHAR(400) NOT NULL DEFAULT '',
+    `description` TEXT,
+    `config` TEXT COMMENT 'JSON form configuration',
+    `email_admin` VARCHAR(255) DEFAULT NULL,
+    `email_submitter_field` INT UNSIGNED DEFAULT NULL,
+    `css_class` VARCHAR(255) DEFAULT '',
+    `published` TINYINT(1) NOT NULL DEFAULT 1,
+    `ordering` INT NOT NULL DEFAULT 0,
+    `checked_out` INT UNSIGNED DEFAULT NULL,
+    `checked_out_time` DATETIME DEFAULT NULL,
+    `created_by` INT NOT NULL DEFAULT 0,
+    `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
+    `modified_at` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    PRIMARY KEY (`id`),
+    KEY `idx_mokosuiteforms_forms_published` (`published`),
+    KEY `idx_mokosuiteforms_forms_alias` (`alias`(191))
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS `#__mokosuiteforms_fields` (
+    `id` INT UNSIGNED NOT NULL AUTO_INCREMENT,
+    `form_id` INT UNSIGNED NOT NULL,
+    `title` VARCHAR(255) NOT NULL DEFAULT '',
+    `name` VARCHAR(255) NOT NULL DEFAULT '',
+    `field_type` VARCHAR(50) NOT NULL DEFAULT 'text',
+    `config` TEXT COMMENT 'JSON field config (placeholder, options, validation)',
+    `required` TINYINT(1) NOT NULL DEFAULT 0,
+    `css_class` VARCHAR(255) DEFAULT '',
+    `conditional_field_id` INT UNSIGNED DEFAULT NULL,
+    `conditional_value` VARCHAR(255) DEFAULT NULL,
+    `page_number` INT UNSIGNED NOT NULL DEFAULT 1,
+    `published` TINYINT(1) NOT NULL DEFAULT 1,
+    `ordering` INT NOT NULL DEFAULT 0,
+    PRIMARY KEY (`id`),
+    KEY `idx_mokosuiteforms_fields_form` (`form_id`),
+    KEY `idx_mokosuiteforms_fields_ordering` (`form_id`, `ordering`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS `#__mokosuiteforms_submissions` (
+    `id` INT UNSIGNED NOT NULL AUTO_INCREMENT,
+    `form_id` INT UNSIGNED NOT NULL,
+    `submitted_by` INT NOT NULL DEFAULT 0,
+    `ip_address` VARCHAR(45) DEFAULT NULL,
+    `user_agent` VARCHAR(512) DEFAULT NULL,
+    `data` MEDIUMTEXT COMMENT 'JSON field_id => value pairs',
+    `status` VARCHAR(20) NOT NULL DEFAULT 'new',
+    `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
+    PRIMARY KEY (`id`),
+    KEY `idx_mokosuiteforms_submissions_form` (`form_id`),
+    KEY `idx_mokosuiteforms_submissions_status` (`status`),
+    KEY `idx_mokosuiteforms_submissions_created` (`created_at`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS `#__mokosuiteforms_notifications` (
+    `id` INT UNSIGNED NOT NULL AUTO_INCREMENT,
+    `form_id` INT UNSIGNED NOT NULL,
+    `event` VARCHAR(50) NOT NULL DEFAULT 'on_submit',
+    `recipient_type` VARCHAR(20) NOT NULL DEFAULT 'admin',
+    `recipient_email` VARCHAR(255) DEFAULT NULL,
+    `subject_template` VARCHAR(500) DEFAULT NULL,
+    `body_template` TEXT,
+    `published` TINYINT(1) NOT NULL DEFAULT 1,
+    PRIMARY KEY (`id`),
+    KEY `idx_mokosuiteforms_notifications_form` (`form_id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;

source/packages/com_mokosuiteforms/sql/uninstall.mysql.sql

@@ -0,0 +1,4 @@
+DROP TABLE IF EXISTS `#__mokosuiteforms_notifications`;
+DROP TABLE IF EXISTS `#__mokosuiteforms_submissions`;
+DROP TABLE IF EXISTS `#__mokosuiteforms_fields`;
+DROP TABLE IF EXISTS `#__mokosuiteforms_forms`;

source/packages/com_mokosuiteforms/sql/updates/mysql/01.00.00.sql

@@ -0,0 +1 @@
+-- Initial version — no updates needed (tables created by install.mysql.sql)

source/packages/com_mokosuiteforms/src/Controller/DisplayController.php

@@ -0,0 +1,17 @@
+<?php
+
+/**
+ * @copyright  (C) 2026 Moko Consulting. All rights reserved.
+ * @license    GPL-3.0-or-later
+ */
+
+declare(strict_types=1);
+
+namespace MokoConsulting\Component\MokoSuiteForms\Administrator\Controller;
+
+use Joomla\CMS\MVC\Controller\BaseController;
+
+final class DisplayController extends BaseController
+{
+    protected $default_view = 'dashboard';
+}

source/packages/com_mokosuiteforms/src/Extension/MokoSuiteFormsComponent.php

@@ -0,0 +1,16 @@
+<?php
+
+/**
+ * @copyright  (C) 2026 Moko Consulting. All rights reserved.
+ * @license    GPL-3.0-or-later
+ */
+
+declare(strict_types=1);
+
+namespace MokoConsulting\Component\MokoSuiteForms\Administrator\Extension;
+
+use Joomla\CMS\Extension\MVCComponent;
+
+final class MokoSuiteFormsComponent extends MVCComponent
+{
+}

source/packages/com_mokosuiteforms/src/View/Dashboard/HtmlView.php

@@ -0,0 +1,24 @@
+<?php
+
+/**
+ * @copyright  (C) 2026 Moko Consulting. All rights reserved.
+ * @license    GPL-3.0-or-later
+ */
+
+declare(strict_types=1);
+
+namespace MokoConsulting\Component\MokoSuiteForms\Administrator\View\Dashboard;
+
+use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;
+use Joomla\CMS\Toolbar\ToolbarHelper;
+
+final class HtmlView extends BaseHtmlView
+{
+    public function display($tpl = null): void
+    {
+        ToolbarHelper::title('MokoSuiteForms — Dashboard', 'file-alt');
+        ToolbarHelper::preferences('com_mokosuiteforms');
+
+        parent::display($tpl);
+    }
+}

source/packages/com_mokosuiteforms/tmpl/dashboard/default.php

@@ -0,0 +1,35 @@
+<?php
+
+/**
+ * @copyright  (C) 2026 Moko Consulting. All rights reserved.
+ * @license    GPL-3.0-or-later
+ */
+
+declare(strict_types=1);
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Language\Text;
+
+?>
+<div class="row">
+    <div class="col-lg-8">
+        <div class="card">
+            <div class="card-body">
+                <h2><?php echo Text::_('COM_MOKOSUITEFORMS_DASHBOARD_TITLE'); ?></h2>
+                <p><?php echo Text::_('COM_MOKOSUITEFORMS_DASHBOARD_DESC'); ?></p>
+            </div>
+        </div>
+    </div>
+    <div class="col-lg-4">
+        <div class="card">
+            <div class="card-body">
+                <h4><?php echo Text::_('COM_MOKOSUITEFORMS_QUICK_LINKS'); ?></h4>
+                <ul class="list-unstyled">
+                    <li><a href="<?php echo $this->escape('index.php?option=com_mokosuiteforms&view=forms'); ?>"><?php echo Text::_('COM_MOKOSUITEFORMS_FORMS'); ?></a></li>
+                    <li><a href="<?php echo $this->escape('index.php?option=com_mokosuiteforms&view=submissions'); ?>"><?php echo Text::_('COM_MOKOSUITEFORMS_SUBMISSIONS'); ?></a></li>
+                </ul>
+            </div>
+        </div>
+    </div>
+</div>

source/packages/plg_content_mokosuiteforms/language/en-GB/plg_content_mokosuiteforms.sys.ini

@@ -0,0 +1,2 @@
+PLG_CONTENT_MOKOSUITEFORMS="Content - MokoSuiteForms"
+PLG_CONTENT_MOKOSUITEFORMS_DESCRIPTION="Embeds forms in articles via {mokosuiteform id=N} shortcode."

source/packages/plg_content_mokosuiteforms/language/en-US/plg_content_mokosuiteforms.sys.ini

@@ -0,0 +1,2 @@
+PLG_CONTENT_MOKOSUITEFORMS="Content - MokoSuiteForms"
+PLG_CONTENT_MOKOSUITEFORMS_DESCRIPTION="Embeds forms in articles via {mokosuiteform id=N} shortcode."

source/packages/plg_content_mokosuiteforms/mokosuiteforms.php

@@ -0,0 +1 @@
+<?php defined("_JEXEC") or die;

source/packages/plg_content_mokosuiteforms/mokosuiteforms.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<extension type="plugin" group="content" method="upgrade">
+    <name>plg_content_mokosuiteforms</name>
+    <version>01.00.02</version>
+    <creationDate>2026-06-10</creationDate>
+    <author>Moko Consulting</author>
+    <license>GPL-3.0-or-later</license>
+    <description>PLG_CONTENT_MOKOSUITEFORMS_DESCRIPTION</description>
+    <namespace path="src">MokoConsulting\Plugin\Content\MokoSuiteForms</namespace>
+    <files><folder>services</folder><folder>src</folder></files>
+    <languages folder="language">
+        <language tag="en-GB">en-GB/plg_content_mokosuiteforms.sys.ini</language>
+    </languages>
+</extension>

source/packages/plg_content_mokosuiteforms/services/provider.php

@@ -0,0 +1,21 @@
+<?php
+declare(strict_types=1);
+use Joomla\CMS\Extension\PluginInterface;
+use Joomla\CMS\Plugin\PluginHelper;
+use Joomla\DI\Container;
+use Joomla\DI\ServiceProviderInterface;
+use Joomla\Event\DispatcherInterface;
+use MokoConsulting\Plugin\Content\MokoSuiteForms\Extension\MokoSuiteFormsContent;
+
+return new class () implements ServiceProviderInterface {
+    public function register(Container $container): void {
+        $container->set(PluginInterface::class, function (Container $container) {
+            $plugin = new MokoSuiteFormsContent(
+                $container->get(DispatcherInterface::class),
+                (array) PluginHelper::getPlugin('content', 'mokosuiteforms')
+            );
+            $plugin->setApplication(\Joomla\CMS\Factory::getApplication());
+            return $plugin;
+        });
+    }
+};

source/packages/plg_content_mokosuiteforms/src/Extension/MokoSuiteFormsContent.php

@@ -0,0 +1,20 @@
+<?php
+declare(strict_types=1);
+namespace MokoConsulting\Plugin\Content\MokoSuiteForms\Extension;
+
+use Joomla\CMS\Plugin\CMSPlugin;
+use Joomla\Event\SubscriberInterface;
+
+final class MokoSuiteFormsContent extends CMSPlugin implements SubscriberInterface
+{
+    public static function getSubscribedEvents(): array
+    {
+        return ['onContentPrepare' => 'onContentPrepare'];
+    }
+
+    public function onContentPrepare($event): void
+    {
+        // Parse {mokosuiteform id=N} shortcodes and render forms inline
+        // TODO: Implement in #4
+    }
+}

source/packages/plg_system_mokosuiteforms/language/en-GB/plg_system_mokosuiteforms.ini

@@ -0,0 +1,2 @@
+PLG_SYSTEM_MOKOSUITEFORMS="System - MokoSuiteForms"
+PLG_SYSTEM_MOKOSUITEFORMS_DESCRIPTION="System plugin for MokoSuiteForms."

source/packages/plg_system_mokosuiteforms/language/en-GB/plg_system_mokosuiteforms.sys.ini

@@ -0,0 +1,2 @@
+PLG_SYSTEM_MOKOSUITEFORMS="System - MokoSuiteForms"
+PLG_SYSTEM_MOKOSUITEFORMS_DESCRIPTION="System plugin for MokoSuiteForms."

source/packages/plg_system_mokosuiteforms/language/en-US/plg_system_mokosuiteforms.ini

@@ -0,0 +1,2 @@
+PLG_SYSTEM_MOKOSUITEFORMS="System - MokoSuiteForms"
+PLG_SYSTEM_MOKOSUITEFORMS_DESCRIPTION="System plugin for MokoSuiteForms."

source/packages/plg_system_mokosuiteforms/language/en-US/plg_system_mokosuiteforms.sys.ini

@@ -0,0 +1,2 @@
+PLG_SYSTEM_MOKOSUITEFORMS="System - MokoSuiteForms"
+PLG_SYSTEM_MOKOSUITEFORMS_DESCRIPTION="System plugin for MokoSuiteForms."

source/packages/plg_system_mokosuiteforms/mokosuiteforms.php

@@ -0,0 +1 @@
+<?php defined('_JEXEC') or die;

source/packages/plg_system_mokosuiteforms/mokosuiteforms.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<extension type="plugin" group="system" method="upgrade">
+    <name>plg_system_mokosuiteforms</name>
+    <version>01.00.02</version>
+    <creationDate>2026-06-10</creationDate>
+    <author>Moko Consulting</author>
+    <license>GPL-3.0-or-later</license>
+    <description>PLG_SYSTEM_MOKOSUITEFORMS_DESCRIPTION</description>
+    <namespace path="src">MokoConsulting\Plugin\System\MokoSuiteForms</namespace>
+    <files>
+        <folder>services</folder>
+        <folder>src</folder>
+    </files>
+    <languages folder="language">
+        <language tag="en-GB">en-GB/plg_system_mokosuiteforms.ini</language>
+        <language tag="en-GB">en-GB/plg_system_mokosuiteforms.sys.ini</language>
+    </languages>
+</extension>

source/packages/plg_system_mokosuiteforms/services/provider.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+use Joomla\CMS\Extension\PluginInterface;
+use Joomla\CMS\Plugin\PluginHelper;
+use Joomla\DI\Container;
+use Joomla\DI\ServiceProviderInterface;
+use Joomla\Event\DispatcherInterface;
+use MokoConsulting\Plugin\System\MokoSuiteForms\Extension\MokoSuiteForms;
+
+return new class () implements ServiceProviderInterface {
+    public function register(Container $container): void
+    {
+        $container->set(
+            PluginInterface::class,
+            function (Container $container) {
+                $plugin = new MokoSuiteForms(
+                    $container->get(DispatcherInterface::class),
+                    (array) PluginHelper::getPlugin('system', 'mokosuiteforms')
+                );
+                $plugin->setApplication(\Joomla\CMS\Factory::getApplication());
+                return $plugin;
+            }
+        );
+    }
+};

source/packages/plg_system_mokosuiteforms/src/Extension/MokoSuiteForms.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MokoConsulting\Plugin\System\MokoSuiteForms\Extension;
+
+use Joomla\CMS\Plugin\CMSPlugin;
+use Joomla\Event\SubscriberInterface;
+
+final class MokoSuiteForms extends CMSPlugin implements SubscriberInterface
+{
+    public static function getSubscribedEvents(): array
+    {
+        return [];
+    }
+}

source/packages/plg_webservices_mokosuiteforms/language/en-GB/plg_webservices_mokosuiteforms.sys.ini

@@ -0,0 +1,2 @@
+PLG_WEBSERVICES_MOKOSUITEFORMS="Web Services - MokoSuiteForms"
+PLG_WEBSERVICES_MOKOSUITEFORMS_DESCRIPTION="REST API for MokoSuiteForms."

source/packages/plg_webservices_mokosuiteforms/language/en-US/plg_webservices_mokosuiteforms.sys.ini

@@ -0,0 +1,2 @@
+PLG_WEBSERVICES_MOKOSUITEFORMS="Web Services - MokoSuiteForms"
+PLG_WEBSERVICES_MOKOSUITEFORMS_DESCRIPTION="REST API for MokoSuiteForms."

source/packages/plg_webservices_mokosuiteforms/mokosuiteforms.php

@@ -0,0 +1 @@
+<?php defined("_JEXEC") or die;

source/packages/plg_webservices_mokosuiteforms/mokosuiteforms.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<extension type="plugin" group="webservices" method="upgrade">
+    <name>plg_webservices_mokosuiteforms</name>
+    <version>01.00.02</version>
+    <creationDate>2026-06-10</creationDate>
+    <author>Moko Consulting</author>
+    <license>GPL-3.0-or-later</license>
+    <description>PLG_WEBSERVICES_MOKOSUITEFORMS_DESCRIPTION</description>
+    <namespace path="src">MokoConsulting\Plugin\WebServices\MokoSuiteForms</namespace>
+    <files><folder>services</folder><folder>src</folder></files>
+    <languages folder="language">
+        <language tag="en-GB">en-GB/plg_webservices_mokosuiteforms.sys.ini</language>
+    </languages>
+</extension>

source/packages/plg_webservices_mokosuiteforms/services/provider.php

@@ -0,0 +1,19 @@
+<?php
+declare(strict_types=1);
+use Joomla\CMS\Extension\PluginInterface;
+use Joomla\CMS\Plugin\PluginHelper;
+use Joomla\DI\Container;
+use Joomla\DI\ServiceProviderInterface;
+use Joomla\Event\DispatcherInterface;
+use MokoConsulting\Plugin\WebServices\MokoSuiteForms\Extension\MokoSuiteFormsWebServices;
+
+return new class () implements ServiceProviderInterface {
+    public function register(Container $container): void {
+        $container->set(PluginInterface::class, function (Container $container) {
+            return new MokoSuiteFormsWebServices(
+                $container->get(DispatcherInterface::class),
+                (array) PluginHelper::getPlugin('webservices', 'mokosuiteforms')
+            );
+        });
+    }
+};

source/packages/plg_webservices_mokosuiteforms/src/Extension/MokoSuiteFormsWebServices.php

@@ -0,0 +1,21 @@
+<?php
+declare(strict_types=1);
+namespace MokoConsulting\Plugin\WebServices\MokoSuiteForms\Extension;
+
+use Joomla\CMS\Plugin\CMSPlugin;
+use Joomla\Event\SubscriberInterface;
+
+final class MokoSuiteFormsWebServices extends CMSPlugin implements SubscriberInterface
+{
+    public static function getSubscribedEvents(): array
+    {
+        return ['onBeforeApiRoute' => 'registerRoutes'];
+    }
+
+    public function registerRoutes($event): void
+    {
+        $router = $event->getArgument('router');
+        $router->createCRUDRoutes('v1/mokosuiteforms/forms', 'forms', ['component' => 'com_mokosuiteforms']);
+        $router->createCRUDRoutes('v1/mokosuiteforms/submissions', 'submissions', ['component' => 'com_mokosuiteforms']);
+    }
+}

source/pkg_mokosuiteforms.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<extension type="package" method="upgrade">
+    <name>MokoSuiteForms</name>
+    <packagename>mokosuiteforms</packagename>
+    <version>01.00.02</version>
+    <creationDate>2026-06-10</creationDate>
+    <author>Moko Consulting</author>
+    <authorEmail>hello@mokoconsulting.tech</authorEmail>
+    <authorUrl>https://mokoconsulting.tech</authorUrl>
+    <copyright>(C) 2026 Moko Consulting. All rights reserved.</copyright>
+    <license>GPL-3.0-or-later</license>
+    <description>PKG_MOKOSUITEFORMS_DESCRIPTION</description>
+    <scriptfile>script.php</scriptfile>
+    <files folder="packages">
+        <file type="component" id="com_mokosuiteforms">com_mokosuiteforms</file>
+        <file type="plugin" id="plg_system_mokosuiteforms" group="system">plg_system_mokosuiteforms</file>
+        <file type="plugin" id="plg_webservices_mokosuiteforms" group="webservices">plg_webservices_mokosuiteforms</file>
+        <file type="plugin" id="plg_content_mokosuiteforms" group="content">plg_content_mokosuiteforms</file>
+    </files>
+    <languages folder="language">
+        <language tag="en-GB">en-GB/pkg_mokosuiteforms.sys.ini</language>
+        <language tag="en-US">en-US/pkg_mokosuiteforms.sys.ini</language>
+    </languages>
+</extension>

source/script.php

@@ -0,0 +1,56 @@
+<?php
+
+/**
+ * @copyright  (C) 2026 Moko Consulting. All rights reserved.
+ * @license    GPL-3.0-or-later
+ */
+
+declare(strict_types=1);
+
+use Joomla\CMS\Installer\InstallerAdapter;
+use Joomla\CMS\Language\Text;
+use Joomla\CMS\Log\Log;
+
+defined('_JEXEC') or die;
+
+class Pkg_MokoSuiteFormsInstallerScript
+{
+    protected string $minimumPhp = '8.1';
+    protected string $minimumJoomla = '5.0.0';
+
+    public function preflight(string $type, InstallerAdapter $adapter): bool
+    {
+        if (version_compare(PHP_VERSION, $this->minimumPhp, '<')) {
+            Log::add(
+                sprintf('MokoSuiteForms requires PHP %s or later. You are running PHP %s.', $this->minimumPhp, PHP_VERSION),
+                Log::WARNING,
+                'jerror'
+            );
+            return false;
+        }
+
+        return true;
+    }
+
+    public function postflight(string $type, InstallerAdapter $adapter): void
+    {
+        if ($type === 'install') {
+            // Enable plugins after first install
+            $this->enablePlugin('system', 'mokosuiteforms');
+            $this->enablePlugin('webservices', 'mokosuiteforms');
+            $this->enablePlugin('content', 'mokosuiteforms');
+        }
+    }
+
+    private function enablePlugin(string $group, string $element): void
+    {
+        $db = \Joomla\CMS\Factory::getContainer()->get(\Joomla\Database\DatabaseInterface::class);
+        $query = $db->getQuery(true)
+            ->update($db->quoteName('#__extensions'))
+            ->set($db->quoteName('enabled') . ' = 1')
+            ->where($db->quoteName('type') . ' = ' . $db->quote('plugin'))
+            ->where($db->quoteName('folder') . ' = ' . $db->quote($group))
+            ->where($db->quoteName('element') . ' = ' . $db->quote($element));
+        $db->setQuery($query)->execute();
+    }
+}