Merge pull request 'sync: update workflows and build files from MokoJoomGallery' (#11) from dev into main

.mokogitea/workflows/ci-joomla.yml

@@ -35,25 +35,32 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@v4
 
       - name: Setup PHP
         run: |
+          if ! command -v php &> /dev/null; 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
           php -v && composer --version
 
-      - name: Clone MokoStandards
+      - name: Setup moko-platform tools
         env:
-          GA_TOKEN: ${{ secrets.GA_TOKEN || secrets.GA_TOKEN || github.token }}
+          MOKO_CLONE_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
-          MOKO_CLONE_TOKEN: ${{ secrets.GA_TOKEN || secrets.GA_TOKEN || github.token }}
           MOKO_CLONE_HOST: ${{ secrets.GA_TOKEN && 'git.mokoconsulting.tech/MokoConsulting' || 'github.com/mokoconsulting-tech' }}
         run: |
-          git clone --depth 1 --branch main --quiet \
+          if [ -d "/tmp/moko-platform" ] || [ -d "/opt/moko-platform" ]; then
-            "https://${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git" \
+            echo "moko-platform already available on runner — skipping clone"
-            /tmp/mokostandards-api
+          else
+            git clone --depth 1 --branch main --quiet \
+              "https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git" \
+              /tmp/moko-platform 2>/dev/null || echo "moko-platform clone skipped — continuing without it"
+          fi
 
       - name: Install dependencies
         env:
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || secrets.GA_TOKEN || github.token }}"}}'
         run: |
           if [ -f "composer.json" ]; then
             composer install \
@@ -124,8 +131,8 @@ jobs:
               echo "Manifest is well-formed XML." >> $GITHUB_STEP_SUMMARY
             fi
 
-            # Check required tags: name, version, author, namespace (Joomla 5+)
+            # Check required tags: name, version, author
-            for TAG in name version author namespace; do
+            for TAG in name version author; do
               if ! grep -q "<${TAG}>" "$MANIFEST" 2>/dev/null; then
                 echo "Missing required tag: \`<${TAG}>\`" >> $GITHUB_STEP_SUMMARY
                 ERRORS=$((ERRORS + 1))
@@ -133,6 +140,19 @@ jobs:
                 echo "Found required tag: \`<${TAG}>\`" >> $GITHUB_STEP_SUMMARY
               fi
             done
+
+            # Namespace is required for components/plugins but not packages
+            EXT_TYPE=$(grep -oP '<extension[^>]*\btype="\K[^"]+' "$MANIFEST" | head -1)
+            if [ "$EXT_TYPE" != "package" ]; then
+              if ! grep -q "<namespace" "$MANIFEST" 2>/dev/null; then
+                echo "Missing required tag: \`<namespace>\` (required for Joomla 5+ ${EXT_TYPE} extensions)" >> $GITHUB_STEP_SUMMARY
+                ERRORS=$((ERRORS + 1))
+              else
+                echo "Found required tag: \`<namespace>\`" >> $GITHUB_STEP_SUMMARY
+              fi
+            else
+              echo "Package extension — \`<namespace>\` not required." >> $GITHUB_STEP_SUMMARY
+            fi
           fi
 
           if [ "${ERRORS}" -gt 0 ]; then
@@ -232,7 +252,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@v4
 
       - name: Validate release readiness
         run: |
@@ -338,15 +358,19 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@v4
 
       - name: Setup PHP ${{ matrix.php }}
         run: |
+          if ! command -v php &> /dev/null; 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
           php -v && composer --version
 
       - name: Install dependencies
         env:
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || secrets.GA_TOKEN || github.token }}"}}'
         run: |
           if [ -f "composer.json" ]; then
             composer install \
@@ -384,14 +408,19 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@v4
 
       - name: Setup PHP
-        run: php -v && composer --version
+        run: |
+          if ! command -v php &> /dev/null; 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
+          php -v && composer --version
 
       - name: Install dependencies
         env:
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || secrets.GA_TOKEN || github.token }}"}}'
         run: |
           if [ -f "composer.json" ]; then
             composer install --no-interaction --prefer-dist --optimize-autoloader
@@ -448,3 +477,24 @@ jobs:
             echo '```' >> $GITHUB_STEP_SUMMARY
           fi
           exit $EXIT
+
+  pre-release:
+    name: Build RC Pre-Release
+    runs-on: ubuntu-latest
+    needs: [lint-and-validate, test]
+    if: github.event_name == 'pull_request'
+
+    steps:
+      - name: Trigger pre-release build
+        env:
+          GA_TOKEN: ${{ secrets.GA_TOKEN }}
+          REPO: ${{ github.repository }}
+          BRANCH: ${{ github.head_ref }}
+        run: |
+          curl -s -X POST \
+            "${GITEA_URL:-https://git.mokoconsulting.tech}/api/v1/repos/${REPO}/actions/workflows/pre-release.yml/dispatches" \
+            -H "Authorization: token ${GA_TOKEN}" \
+            -H "Content-Type: application/json" \
+            -d "{\"ref\":\"${BRANCH}\",\"inputs\":{\"stability\":\"release-candidate\"}}"
+          echo "### Pre-Release" >> $GITHUB_STEP_SUMMARY
+          echo "Triggered RC build on branch \`${BRANCH}\`" >> $GITHUB_STEP_SUMMARY

.mokogitea/workflows/pr-check.yml

@@ -193,31 +193,24 @@ jobs:
           echo "Source: ${FILE_COUNT} files"
           [ "$FILE_COUNT" -gt 0 ] || { echo "::error::Source directory is empty"; exit 1; }
 
-  # ── Changelog Gate ────────────────────────────────────────────────────
+  # ── Pre-Release RC Build ─────────────────────────────────────────────────
-  changelog:
+  pre-release:
-    name: Changelog Updated
+    name: Build RC Package
     runs-on: ubuntu-latest
-    if: github.base_ref == 'main'
+    needs: [branch-policy, validate]
+
     steps:
-      - uses: actions/checkout@v4
+      - name: Trigger RC pre-release
-        with:
+        env:
-          fetch-depth: 0
+          GA_TOKEN: ${{ secrets.GA_TOKEN }}
-
+          REPO: ${{ github.repository }}
-      - name: Check CHANGELOG.md was updated
+          BRANCH: ${{ github.head_ref }}
+          GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
         run: |
-          BASE="${{ github.event.pull_request.base.sha }}"
+          curl -s -X POST \
-          HEAD="${{ github.event.pull_request.head.sha }}"
+            "${GITEA_URL}/api/v1/repos/${REPO}/actions/workflows/pre-release.yml/dispatches" \
-
+            -H "Authorization: token ${GA_TOKEN}" \
-          if git diff --name-only "$BASE" "$HEAD" | grep -q "^CHANGELOG.md$"; then
+            -H "Content-Type: application/json" \
-            echo "CHANGELOG.md updated"
+            -d "{\"ref\":\"${BRANCH}\",\"inputs\":{\"stability\":\"release-candidate\"}}"
-          else
+          echo "### Pre-Release" >> $GITHUB_STEP_SUMMARY
-            # Allow [skip changelog] in PR title or body
+          echo "Triggered RC build on branch \`${BRANCH}\`" >> $GITHUB_STEP_SUMMARY
-            PR_TITLE="${{ github.event.pull_request.title }}"
-            PR_BODY="${{ github.event.pull_request.body }}"
-            if echo "$PR_TITLE $PR_BODY" | grep -qi "\[skip changelog\]"; then
-              echo "::warning::Changelog skip requested via [skip changelog]"
-              exit 0
-            fi
-            echo "::error::CHANGELOG.md must be updated before merging to main. Add [skip changelog] to the PR title to bypass."
-            exit 1
-          fi

.mokogitea/workflows/repo-health.yml

@@ -153,7 +153,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
@@ -248,7 +248,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
@@ -362,7 +362,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 

.mokogitea/workflows/update-server.yml

@@ -73,12 +73,12 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@v4
         with:
           token: ${{ secrets.GA_TOKEN }}
           fetch-depth: 0
 
-      - name: Setup MokoStandards tools
+      - name: Setup moko-platform tools
         env:
           MOKO_CLONE_TOKEN: ${{ secrets.GA_TOKEN }}
           MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
@@ -87,11 +87,15 @@ jobs:
           if ! command -v composer &> /dev/null; 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
-          git clone --depth 1 --branch main --quiet \
+          if [ -d "/tmp/moko-platform" ]; then
-            "https://${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git" \
+            echo "moko-platform already available — skipping clone"
-            /tmp/mokostandards-api 2>/dev/null || true
+          else
-          if [ -d "/tmp/mokostandards-api" ] && [ -f "/tmp/mokostandards-api/composer.json" ]; then
+            git clone --depth 1 --branch main --quiet \
-            cd /tmp/mokostandards-api && composer install --no-dev --no-interaction --quiet 2>/dev/null || true
+              "https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git" \
+              /tmp/moko-platform 2>/dev/null || true
+          fi
+          if [ -d "/tmp/moko-platform" ] && [ -f "/tmp/moko-platform/composer.json" ]; then
+            cd /tmp/moko-platform && composer install --no-dev --no-interaction --quiet 2>/dev/null || true
           fi
 
       - name: Generate updates.xml entry
@@ -100,14 +104,14 @@ jobs:
           BRANCH="${{ github.ref_name }}"
           REPO="${{ github.repository }}"
           API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
-          VERSION=$(php /tmp/mokostandards-api/cli/version_read.php --path . 2>/dev/null || echo "0.0.0")
+          VERSION=$(php /tmp/moko-platform/cli/version_read.php --path . 2>/dev/null || echo "0.0.0")
 
           # Auto-bump patch on all branches (dev, alpha, beta, rc)
           git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
           git config --local user.name "gitea-actions[bot]"
-          BUMPED=$(php /tmp/mokostandards-api/cli/version_bump.php --path . 2>/dev/null || true)
+          BUMPED=$(php /tmp/moko-platform/cli/version_bump.php --path . 2>/dev/null || true)
           if [ -n "$BUMPED" ]; then
-            VERSION=$(php /tmp/mokostandards-api/cli/version_read.php --path . 2>/dev/null || echo "$VERSION")
+            VERSION=$(php /tmp/moko-platform/cli/version_read.php --path . 2>/dev/null || echo "$VERSION")
             git add -A
             git commit -m "chore(version): auto-bump patch ${VERSION} [skip ci]" \
               --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>" 2>/dev/null || true
@@ -442,11 +446,11 @@ jobs:
             printf ',"password":"%s"}' "$DEV_PASS" >> /tmp/sftp-config.json
           fi
 
-          PLATFORM=$(php /tmp/mokostandards-api/cli/platform_detect.php --path . 2>/dev/null || true)
+          PLATFORM=$(php /tmp/moko-platform/cli/platform_detect.php --path . 2>/dev/null || true)
-          if [ "$PLATFORM" = "waas-component" ] && [ -f "/tmp/mokostandards-api/deploy/deploy-joomla.php" ]; then
+          if [ "$PLATFORM" = "waas-component" ] && [ -f "/tmp/moko-platform/deploy/deploy-joomla.php" ]; then
-            php /tmp/mokostandards-api/deploy/deploy-joomla.php --path . --src-dir "$SOURCE_DIR" --config /tmp/sftp-config.json
+            php /tmp/moko-platform/deploy/deploy-joomla.php --path . --src-dir "$SOURCE_DIR" --config /tmp/sftp-config.json
-          elif [ -f "/tmp/mokostandards-api/deploy/deploy-sftp.php" ]; then
+          elif [ -f "/tmp/moko-platform/deploy/deploy-sftp.php" ]; then
-            php /tmp/mokostandards-api/deploy/deploy-sftp.php --path . --src-dir "$SOURCE_DIR" --config /tmp/sftp-config.json
+            php /tmp/moko-platform/deploy/deploy-sftp.php --path . --src-dir "$SOURCE_DIR" --config /tmp/sftp-config.json
           fi
           rm -f /tmp/deploy_key /tmp/sftp-config.json
           echo "SFTP deploy to dev complete" >> $GITHUB_STEP_SUMMARY

Makefile

@@ -2,18 +2,15 @@
 # Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
-# This is a reference Makefile for building Joomla extensions.
+# MokoJoomGallery — Photo gallery management for Joomla
-# Copy this to your repository root as "Makefile" and customize as needed.
-#
-# Supports: Modules, Plugins, Components, Packages, Templates
 
 # ==============================================================================
 # CONFIGURATION - Customize these for your extension
 # ==============================================================================
 
 # Extension Configuration
-EXTENSION_NAME := mokoexample
+EXTENSION_NAME := mokojoomgallery
-EXTENSION_TYPE := module
+EXTENSION_TYPE := package
 # Options: module, plugin, component, package, template
 EXTENSION_VERSION := 1.0.0
 
@@ -26,7 +23,7 @@ PLUGIN_GROUP := system
 # Options: system, content, user, authentication, etc.
 
 # Directories
-SRC_DIR := .
+SRC_DIR := src
 BUILD_DIR := build
 DIST_DIR := dist
 DOCS_DIR := docs
@@ -69,11 +66,6 @@ help: ## Show this help message
 	@echo "$(COLOR_GREEN)Available targets:$(COLOR_RESET)"
 	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  $(COLOR_BLUE)%-20s$(COLOR_RESET) %s\n", $$1, $$2}'
 	@echo ""
-	@echo "$(COLOR_YELLOW)Quick Start:$(COLOR_RESET)"
-	@echo "  1. make install-deps  # Install dependencies"
-	@echo "  2. make build         # Build extension package"
-	@echo "  3. make test          # Run tests"
-	@echo ""
 
 .PHONY: install-deps
 install-deps: ## Install all dependencies (Composer + npm)
@@ -82,22 +74,6 @@ install-deps: ## Install all dependencies (Composer + npm)
 		$(COMPOSER) install; \
 		echo "$(COLOR_GREEN)✓ Composer dependencies installed$(COLOR_RESET)"; \
 	fi
-	@if [ -f "package.json" ]; then \
-		$(NPM) install; \
-		echo "$(COLOR_GREEN)✓ npm dependencies installed$(COLOR_RESET)"; \
-	fi
-
-.PHONY: update-deps
-update-deps: ## Update all dependencies
-	@echo "$(COLOR_BLUE)Updating dependencies...$(COLOR_RESET)"
-	@if [ -f "composer.json" ]; then \
-		$(COMPOSER) update; \
-		echo "$(COLOR_GREEN)✓ Composer dependencies updated$(COLOR_RESET)"; \
-	fi
-	@if [ -f "package.json" ]; then \
-		$(NPM) update; \
-		echo "$(COLOR_GREEN)✓ npm dependencies updated$(COLOR_RESET)"; \
-	fi
 
 .PHONY: lint
 lint: ## Run PHP linter (syntax check)
@@ -115,39 +91,10 @@ phpcs: ## Run PHP CodeSniffer (Joomla standards)
 		echo "$(COLOR_YELLOW)⚠ PHP CodeSniffer not installed. Run: make install-deps$(COLOR_RESET)"; \
 	fi
 
-.PHONY: phpcbf
-phpcbf: ## Fix coding standards automatically
-	@echo "$(COLOR_BLUE)Running PHP Code Beautifier...$(COLOR_RESET)"
-	@if [ -f "$(PHPCBF)" ]; then \
-		$(PHPCBF) --standard=$(PHPCS_STANDARD) --extensions=php --ignore=vendor,node_modules,$(BUILD_DIR) .; \
-		echo "$(COLOR_GREEN)✓ Code formatting applied$(COLOR_RESET)"; \
-	else \
-		echo "$(COLOR_YELLOW)⚠ PHP Code Beautifier not installed. Run: make install-deps$(COLOR_RESET)"; \
-	fi
-
 .PHONY: validate
 validate: lint phpcs ## Run all validation checks
 	@echo "$(COLOR_GREEN)✓ All validation checks passed$(COLOR_RESET)"
 
-.PHONY: test
-test: ## Run PHPUnit tests
-	@echo "$(COLOR_BLUE)Running tests...$(COLOR_RESET)"
-	@if [ -f "$(PHPUNIT)" ] && [ -f "phpunit.xml" ]; then \
-		$(PHPUNIT); \
-	else \
-		echo "$(COLOR_YELLOW)⚠ PHPUnit not configured$(COLOR_RESET)"; \
-	fi
-
-.PHONY: test-coverage
-test-coverage: ## Run tests with coverage report
-	@echo "$(COLOR_BLUE)Running tests with coverage...$(COLOR_RESET)"
-	@if [ -f "$(PHPUNIT)" ] && [ -f "phpunit.xml" ]; then \
-		$(PHPUNIT) --coverage-html $(BUILD_DIR)/coverage; \
-		echo "$(COLOR_GREEN)✓ Coverage report: $(BUILD_DIR)/coverage/index.html$(COLOR_RESET)"; \
-	else \
-		echo "$(COLOR_YELLOW)⚠ PHPUnit not configured$(COLOR_RESET)"; \
-	fi
-
 .PHONY: clean
 clean: ## Clean build artifacts
 	@echo "$(COLOR_BLUE)Cleaning build artifacts...$(COLOR_RESET)"
@@ -169,124 +116,39 @@ minify: ## Minify CSS/JS assets
 	fi
 
 .PHONY: build
-build: clean validate minify ## Build extension package
+build: clean minify ## Build extension package
-	@echo "$(COLOR_BLUE)Building Joomla extension package...$(COLOR_RESET)"
+	@echo "$(COLOR_BLUE)Building Joomla package extension...$(COLOR_RESET)"
-	@mkdir -p $(DIST_DIR) $(BUILD_DIR)
+	@mkdir -p $(DIST_DIR) $(BUILD_DIR)/packages
 
-	# Determine package prefix based on extension type
+	@# --- Build each sub-extension as a separate ZIP ---
-	@case "$(EXTENSION_TYPE)" in \
+	@for EXT_DIR in $(SRC_DIR)/packages/*/; do \
-		module) \
+		EXT_NAME=$$(basename "$$EXT_DIR"); \
-			PACKAGE_PREFIX="mod_$(EXTENSION_NAME)"; \
+		[ "$$EXT_NAME" = "index.html" ] && continue; \
-			BUILD_TARGET="$(BUILD_DIR)/$$PACKAGE_PREFIX"; \
+		echo "  Packaging $$EXT_NAME..."; \
-			;; \
+		cd "$$EXT_DIR" && $(ZIP) -r "$(CURDIR)/$(BUILD_DIR)/packages/$${EXT_NAME}.zip" . \
-		plugin) \
+			-x "*.git*" -x "*/index.html" 2>/dev/null; \
-			PACKAGE_PREFIX="plg_$(PLUGIN_GROUP)_$(EXTENSION_NAME)"; \
+		cd "$(CURDIR)"; \
-			BUILD_TARGET="$(BUILD_DIR)/$$PACKAGE_PREFIX"; \
+	done
-			;; \
+
-		component) \
+	@# --- Build the outer package ZIP ---
-			PACKAGE_PREFIX="com_$(EXTENSION_NAME)"; \
+	@echo "  Assembling pkg_$(EXTENSION_NAME)..."
-			BUILD_TARGET="$(BUILD_DIR)/$$PACKAGE_PREFIX"; \
+	@cp $(SRC_DIR)/pkg_mokojoomgallery.xml $(BUILD_DIR)/pkg_mokojoomgallery.xml
-			;; \
+	@cp $(SRC_DIR)/script.php $(BUILD_DIR)/script.php
-		package) \
+	@[ -d "$(SRC_DIR)/language" ] && cp -r $(SRC_DIR)/language $(BUILD_DIR)/language || true
-			PACKAGE_PREFIX="pkg_$(EXTENSION_NAME)"; \
+	@cd $(BUILD_DIR) && $(ZIP) -r "$(CURDIR)/$(DIST_DIR)/pkg_$(EXTENSION_NAME)-$(EXTENSION_VERSION).zip" \
-			BUILD_TARGET="$(BUILD_DIR)/$$PACKAGE_PREFIX"; \
+		pkg_mokojoomgallery.xml script.php language/ packages/
-			;; \
+
-		template) \
+	@echo "$(COLOR_GREEN)✓ Package created: $(DIST_DIR)/pkg_$(EXTENSION_NAME)-$(EXTENSION_VERSION).zip$(COLOR_RESET)"
-			PACKAGE_PREFIX="tpl_$(EXTENSION_NAME)"; \
+	@echo "  Contents:"
-			BUILD_TARGET="$(BUILD_DIR)/$$PACKAGE_PREFIX"; \
+	@unzip -l "$(DIST_DIR)/pkg_$(EXTENSION_NAME)-$(EXTENSION_VERSION).zip" | tail -n +4 | head -20
-			;; \
-		*) \
-			echo "$(COLOR_RED)✗ Unknown extension type: $(EXTENSION_TYPE)$(COLOR_RESET)"; \
-			exit 1; \
-			;; \
-	esac; \
-	\
-	mkdir -p "$$BUILD_TARGET"; \
-	\
-	echo "Building $$PACKAGE_PREFIX..."; \
-	\
-	rsync -av --progress \
-		--exclude='$(BUILD_DIR)' \
-		--exclude='$(DIST_DIR)' \
-		--exclude='.git*' \
-		--exclude='vendor/' \
-		--exclude='node_modules/' \
-		--exclude='tests/' \
-		--exclude='Makefile' \
-		--exclude='composer.json' \
-		--exclude='composer.lock' \
-		--exclude='package.json' \
-		--exclude='package-lock.json' \
-		--exclude='phpunit.xml' \
-		--exclude='*.md' \
-		--exclude='.editorconfig' \
-		. "$$BUILD_TARGET/"; \
-	\
-	cd $(BUILD_DIR) && $(ZIP) -r "../$(DIST_DIR)/$${PACKAGE_PREFIX}-$(EXTENSION_VERSION).zip" "$${PACKAGE_PREFIX}"; \
-	\
-	echo "$(COLOR_GREEN)✓ Package created: $(DIST_DIR)/$${PACKAGE_PREFIX}-$(EXTENSION_VERSION).zip$(COLOR_RESET)"
 
 .PHONY: package
 package: build ## Alias for build
 	@echo "$(COLOR_GREEN)✓ Package ready for distribution$(COLOR_RESET)"
 
-.PHONY: install-local
+.PHONY: release
-install-local: build ## Install to local Joomla (upload via admin)
+release: validate build ## Create a release (validate + build)
-	@echo "$(COLOR_BLUE)Package ready for installation$(COLOR_RESET)"
+	@echo "$(COLOR_GREEN)✓ Release package ready$(COLOR_RESET)"
-	@case "$(EXTENSION_TYPE)" in \
-		module) PACKAGE="mod_$(EXTENSION_NAME)";; \
-		plugin) PACKAGE="plg_$(PLUGIN_GROUP)_$(EXTENSION_NAME)";; \
-		component) PACKAGE="com_$(EXTENSION_NAME)";; \
-		package) PACKAGE="pkg_$(EXTENSION_NAME)";; \
-		template) PACKAGE="tpl_$(EXTENSION_NAME)";; \
-	esac; \
-	echo "$(COLOR_YELLOW)Upload $(DIST_DIR)/$${PACKAGE}-$(EXTENSION_VERSION).zip via Joomla Administrator$(COLOR_RESET)"; \
-	echo "Admin URL: $(JOOMLA_ROOT) → Extensions → Install"
-
-.PHONY: dev-install
-dev-install: ## Create symlink for development (Joomla 4+)
-	@echo "$(COLOR_BLUE)Creating development symlink...$(COLOR_RESET)"
-	@if [ ! -d "$(JOOMLA_ROOT)" ]; then \
-		echo "$(COLOR_RED)✗ Joomla root not found at $(JOOMLA_ROOT)$(COLOR_RESET)"; \
-		echo "Update JOOMLA_ROOT in Makefile"; \
-		exit 1; \
-	fi
-	
-	@case "$(EXTENSION_TYPE)" in \
-		module) \
-			if [ "$(MODULE_TYPE)" = "admin" ]; then \
-				TARGET="$(JOOMLA_ROOT)/administrator/modules/mod_$(EXTENSION_NAME)"; \
-			else \
-				TARGET="$(JOOMLA_ROOT)/modules/mod_$(EXTENSION_NAME)"; \
-			fi; \
-			;; \
-		plugin) \
-			TARGET="$(JOOMLA_ROOT)/plugins/$(PLUGIN_GROUP)/$(EXTENSION_NAME)"; \
-			;; \
-		component) \
-			echo "$(COLOR_YELLOW)⚠ Components require complex symlink setup$(COLOR_RESET)"; \
-			echo "Manual setup recommended for component development"; \
-			exit 1; \
-			;; \
-		*) \
-			echo "$(COLOR_RED)✗ dev-install not supported for $(EXTENSION_TYPE)$(COLOR_RESET)"; \
-			exit 1; \
-			;; \
-	esac; \
-	\
-	rm -rf "$$TARGET"; \
-	ln -s "$(PWD)" "$$TARGET"; \
-	echo "$(COLOR_GREEN)✓ Development symlink created at $$TARGET$(COLOR_RESET)"
-
-.PHONY: watch
-watch: ## Watch for changes and rebuild
-	@echo "$(COLOR_BLUE)Watching for changes...$(COLOR_RESET)"
-	@echo "$(COLOR_YELLOW)Press Ctrl+C to stop$(COLOR_RESET)"
-	@while true; do \
-		inotifywait -r -e modify,create,delete --exclude '($(BUILD_DIR)|$(DIST_DIR)|vendor|node_modules)' . 2>/dev/null || \
-		(echo "$(COLOR_YELLOW)⚠ inotifywait not installed. Install: apt-get install inotify-tools$(COLOR_RESET)" && sleep 5); \
-		make build; \
-	done
 
 .PHONY: version
 version: ## Display version information
@@ -294,40 +156,6 @@ version: ## Display version information
 	@echo "  Name:    $(EXTENSION_NAME)"
 	@echo "  Type:    $(EXTENSION_TYPE)"
 	@echo "  Version: $(EXTENSION_VERSION)"
-	@if [ "$(EXTENSION_TYPE)" = "module" ]; then \
-		echo "  Module:  $(MODULE_TYPE)"; \
-	fi
-	@if [ "$(EXTENSION_TYPE)" = "plugin" ]; then \
-		echo "  Group:   $(PLUGIN_GROUP)"; \
-	fi
-
-.PHONY: docs
-docs: ## Generate documentation
-	@echo "$(COLOR_BLUE)Generating documentation...$(COLOR_RESET)"
-	@mkdir -p $(DOCS_DIR)
-	@echo "$(COLOR_YELLOW)⚠ Documentation generation not configured$(COLOR_RESET)"
-	@echo "Consider adding phpDocumentor or similar"
-
-.PHONY: release
-release: validate test build ## Create a release (validate + test + build)
-	@echo "$(COLOR_GREEN)✓ Release package ready$(COLOR_RESET)"
-	@echo ""
-	@echo "$(COLOR_BLUE)Release Checklist:$(COLOR_RESET)"
-	@echo "  [ ] Update CHANGELOG.md"
-	@echo "  [ ] Update version in XML manifest"
-	@echo "  [ ] Test installation in clean Joomla"
-	@echo "  [ ] Tag release in git: git tag v$(EXTENSION_VERSION)"
-	@echo "  [ ] Push tags: git push --tags"
-	@echo "  [ ] Create GitHub release"
-	@echo ""
-	@case "$(EXTENSION_TYPE)" in \
-		module) PACKAGE="mod_$(EXTENSION_NAME)";; \
-		plugin) PACKAGE="plg_$(PLUGIN_GROUP)_$(EXTENSION_NAME)";; \
-		component) PACKAGE="com_$(EXTENSION_NAME)";; \
-		package) PACKAGE="pkg_$(EXTENSION_NAME)";; \
-		template) PACKAGE="tpl_$(EXTENSION_NAME)";; \
-	esac; \
-	echo "$(COLOR_GREEN)Package: $(DIST_DIR)/$${PACKAGE}-$(EXTENSION_VERSION).zip$(COLOR_RESET)"
 
 .PHONY: security-check
 security-check: ## Run security checks on dependencies
@@ -335,12 +163,9 @@ security-check: ## Run security checks on dependencies
 	@if [ -f "composer.json" ]; then \
 		$(COMPOSER) audit || echo "$(COLOR_YELLOW)⚠ Vulnerabilities found$(COLOR_RESET)"; \
 	fi
-	@if [ -f "package.json" ]; then \
-		$(NPM) audit || echo "$(COLOR_YELLOW)⚠ Vulnerabilities found$(COLOR_RESET)"; \
-	fi
 
 .PHONY: all
-all: install-deps validate test build ## Run complete build pipeline
+all: install-deps validate build ## Run complete build pipeline
 	@echo "$(COLOR_GREEN)✓ Complete build pipeline finished$(COLOR_RESET)"
 
 # Default target

composer.json

@@ -1 +1,27 @@
-
+{
+    "name": "mokoconsulting/mokojoomgallery",
+    "description": "Photo gallery management for Joomla — galleries, images, thumbnails, lightbox, and frontend display",
+    "type": "joomla-package",
+    "version": "01.00.00",
+    "license": "GPL-3.0-or-later",
+    "authors": [
+        {
+            "name": "Moko Consulting",
+            "email": "hello@mokoconsulting.tech",
+            "homepage": "https://mokoconsulting.tech"
+        }
+    ],
+    "require": {
+        "php": ">=8.1"
+    },
+    "require-dev": {
+        "squizlabs/php_codesniffer": "^3.7",
+        "phpstan/phpstan": "^1.10",
+        "joomla/coding-standards": "3.0.x-dev"
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true,
+    "config": {
+        "sort-packages": true
+    }
+}