Реализация механизма плейсхолдеров

.github/workflows/CI.yml

@@ -2,121 +2,58 @@
 
 on:
   push:
-    branches: [master]
+    branches: [master, feature/**, fix/**]
     paths-ignore:
       - "**.md"
-      - "**.bat"
-
   pull_request:
     types: [opened, reopened, synchronize]
   release:
     types: [published]
 
-env:
-  PACKAGE_NAME: ParamsController
-  STORE_READMY: 0
-
 jobs:
   build:
-    name: "Build"
+    name: Build
     runs-on: ubuntu-latest
     outputs:
-      COMMIT_SHA: ${{ steps.declare_sha.outputs.COMMIT_SHA }}
-      SEMVER: ${{ steps.declare_sha.outputs.SEMVER }}
+      sha:  ${{ steps.sha.outputs.SHORT }}
+      name: ${{ steps.build.outputs.name }}
     steps:
-      - name: Checkout
-        uses: actions/checkout@v4.1.1
-        with:
-          fetch-depth: 0
-
-      - name: Parse SemVer string (release)
-        id: semver_parser
-        if: |
-          github.event_name == 'release' &&
-          github.event.action == 'published' &&
-          startsWith(github.ref, 'refs/tags/')
-        uses: booxmedialtd/ws-action-parse-semver@v1.4.7
-        with:
-          input_string: ${{ github.ref }}
-          version_extractor_regex: 'refs\/tags\/(.*)$'
+      - uses: actions/checkout@v4
 
-      - name: Declare SHA & package name
-        id: declare_sha
-        shell: bash
-        run: |
-          SHA=$(git rev-parse --short HEAD)
-          echo "COMMIT_SHA=$SHA" >> $GITHUB_OUTPUT        
-          echo "SEMVER=${{ steps.semver_parser.outputs.fullversion }}" >> $GITHUB_OUTPUT
+      - id: sha
+        run: echo "SHORT=$(git rev-parse --short HEAD)" >> $GITHUB_OUTPUT
 
-      - name: Setup AMXXPawn Compiler
-        uses: wopox1337/setup-amxxpawn@v1.1.0
+      - id: build
+        uses: AmxxModularEcosystem/amxx-builder@v1
         with:
-          version: "1.10.5428"
-
-      - name: Compile plugins
-        working-directory: amxmodx/scripting/
-        env:
-          REAPI_INCLUDE: ${{ env.REAPI_INCLUDE_PATH }}
-          PARAMS_CONRTOLLER_INCLUDE: ${{ env.PARAMS_CONRTOLLER_INCLUDE_PATH }}
-        run: |
-          compile() {
-            sourcefile=$1
-            amxxfile="$(echo $sourcefile | sed -e 's/\.sma$/.amxx/')"
-            output_path="../plugins/$amxxfile"
+          set: |
+            output.pack=false
+            output.dir=./artifact
 
-            mkdir -p $(dirname $output_path)
-
-            echo -n "Compiling $sourcefile ... "
-            amxxpc $sourcefile -o"$output_path" \
-              -i"include" \
-              -i"$REAPI_INCLUDE" \
-              -i"$PARAMS_CONRTOLLER_INCLUDE"
-          }
-          export -f compile
-
-          find . -type f -name "*.sma" -exec bash -c 'compile "$0"' {} \;
-
-      - name: Move files
-        env:
-          STORE_READMY: ${{ env.STORE_READMY }}
-        run: |
-          mkdir -p publish/${{ env.PACKAGE_NAME }}/addons
-          mv amxmodx/ publish/${{ env.PACKAGE_NAME }}/addons/
-
-          if [ ! -z "${STORE_READMY}" ]; then
-            mv README.md publish/
-          fi
-
-      - name: Deploy artifact
-        uses: actions/upload-artifact@v4.3.1
+      - uses: actions/upload-artifact@v4
         with:
-          name: ${{ env.PACKAGE_NAME }}-${{ steps.declare_sha.outputs.COMMIT_SHA }}-dev
-          path: publish/*
+          name: ${{ steps.build.outputs.name }}-${{ steps.sha.outputs.SHORT }}-dev
+          path: artifact/
 
   publish:
-    name: "Publish release"
+    name: Publish release
     runs-on: ubuntu-latest
     needs: [build]
     if: |
       github.event_name == 'release' &&
       github.event.action == 'published' &&
       startsWith(github.ref, 'refs/tags/')
     steps:
-      - name: Download artifact
-        uses: actions/download-artifact@v4.1.7
+      - uses: actions/download-artifact@v4
         with:
-          name: ${{ env.PACKAGE_NAME }}-${{ needs.build.outputs.COMMIT_SHA }}-dev
+          name: ${{ needs.build.outputs.name }}-${{ needs.build.outputs.sha }}-dev
+          path: artifact/
 
-      - name: Packaging binaries
-        id: packaging
-        run: 7z a -mm=Deflate -mfb=258 -mpass=15 -r ${{ env.PACKAGE_NAME }}-${{ needs.build.outputs.SEMVER }}.zip
+      - name: Package for release
+        run: |
+          cd artifact
+          zip -r "../${{ needs.build.outputs.name }}-${{ github.ref_name }}.zip" .
 
-      - name: Publish artifacts
-        uses: softprops/action-gh-release@v2.0.4
-        id: publish-job
-        if: |
-          startsWith(github.ref, 'refs/tags/') &&
-          steps.packaging.outcome == 'success'
+      - uses: softprops/action-gh-release@v2
         with:
-          files: |
-            *.zip
+          files: "${{ needs.build.outputs.name }}-*.zip"

.gitignore

@@ -1,4 +1,7 @@
 *.amxx
 *.zip
-.build
-plugins-*.ini
+.env
+.amxb-cache
+.claude
+build
+dist

.opencode/opencode.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "amxx-dep-resolver": {
+      "type": "local",
+      "command": [
+        "amxb",
+        "mcp"
+      ],
+      "enabled": true
+    }
+  }
+}

CLAUDE.md

@@ -0,0 +1,45 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build
+
+**Requirements:** AmxModX 1.9.0+, AMxModX compiler configured as `amxx190` in `config.bat`
+
+```bat
+build.bat
+```
+
+Output goes to `.build/` directory, final artifact is a ZIP package. Build settings are in `.build-config`. Нужен только для локальной сборки.
+
+There are no test or lint commands — the CI pipeline (`.github/workflows/CI.yml`) compiles all `.sma` files as the validation step.
+
+## Architecture
+
+ParamsController is an AmxModX plugin library (written in PAWN) that provides a JSON-based parameter parsing framework for other plugins.
+
+**Core flow:** A consumer plugin calls `ParamsController_Init()`, constructs typed parameters with `ParamsController_Param_Construct()`, then reads a JSON object using `ParamsController_Param_ReadList()`. Each parameter is validated against its registered type handler.
+
+### Layer structure
+
+| Layer | Path | Role |
+|---|---|---|
+| Public API | `amxmodx/scripting/include/ParamsController.inc` | All native/forward declarations; this is what consumers include |
+| Main plugin | `amxmodx/scripting/ParamsController.sma` | Entry point, library registration, forward init |
+| API impl | `ParamsController/API/` | Native implementations (General, Param, ParamType, Utils) |
+| Object model | `ParamsController/Objects/` | `Param.inc` (Array + free-list storage), `ParamType.inc` (Trie-keyed type registry) |
+| Built-in types | `ParamsController/DefaultObjects/ParamType/` | 14 type handlers: Boolean, Integer, Float, String, RGB, Model, Sound, Resource, File, Dir, ChatMessage, Time, TimeInterval, WeekDay, Flags |
+| Placeholders | `ParamsController/Placeholders/` | Global and per-player placeholder substitution system |
+| Registrars | `ParamsController/DefaultObjects/Registrar.inc`, `PlaceholderRegistrar.inc` | Wire up default types and placeholders on plugin load |
+| Forwards | `ParamsController/Forwards.inc` | Generic forward registration utility used throughout |
+
+### Key design patterns
+
+- **Parameter storage:** Array-based with a free-list for handle reuse (`Param.inc`)
+- **Type registry:** Trie-keyed by type name string (`ParamType.inc`)
+- **Extensibility:** `CreateMultiForward` / `ExecuteForward` — consumers can register custom parameter types and placeholder groups via natives
+- **Error reporting:** `E_ParamsReadErrorType` enum returned from `ReadList`; error details (param name, expected/got type) accessible via `ParamsController_GetErrorInfo()`
+
+### Language notes
+
+PAWN uses `#include` for all modular decomposition. `.inc` files are not independently compiled — they are all included into `ParamsController.sma`. The public header (`ParamsController.inc`) only declares natives/forwards; it contains no implementation.