release 4.5.5

Author: karikjtomi

.github/CONTRIBUTING.md

@@ -0,0 +1,78 @@
+# Contributing to Perun Core
+
+Thank you for your interest in contributing to Perun Core, the front-end module of the [Svarog Business Platform](https://github.com/PerunTech/svarog).
+
+## Prerequisites
+
+- [Node.js](https://nodejs.org/) v18.12.0 or higher
+- [npm](https://www.npmjs.com/) v8 or higher
+- Java JDK (for the OSGi bundle build via Maven)
+
+## Getting Started
+
+1. Fork the repository and clone your fork:
+   ```bash
+   git clone https://github.com/<your-username>/perun-core.git
+   cd perun-core
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+3. Start the development server:
+   ```bash
+   npm run dev
+   ```
+
+## Development Workflow
+
+### Branching
+
+- Base your branch off `dev`.
+- Use descriptive branch names, e.g. `feature/session-token-header` or `fix/grid-reload`.
+
+### Making Changes
+
+- Keep changes focused — one feature or fix per pull request.
+- Run the linter before committing:
+  ```bash
+  npm run test
+  ```
+- Build the bundle to verify it compiles cleanly:
+  ```bash
+  npm run build-dev
+  ```
+
+### Commit Messages
+
+Follow the format: `type(scope): short description`
+
+Common types: `feat`, `fix`, `chore`, `refactor`, `docs`, `style`, `test`
+
+Examples:
+```
+feat(grid): add reload-all-grids action
+fix(router): resolve page reload issue
+chore(deps): upgrade axios to 1.8.3
+```
+
+## Submitting a Pull Request
+
+1. Push your branch to your fork.
+2. Open a pull request against the `dev` branch of this repository.
+3. Describe what changed and why.
+4. Link any related issues.
+
+## Reporting Issues
+
+Open an issue on GitHub and include:
+- A clear description of the problem
+- Steps to reproduce
+- Expected vs. actual behavior
+- Browser and Node.js version if relevant
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [Apache 2.0 License](LICENSE).

.github/workflows/release.yml

@@ -9,30 +9,32 @@ jobs:
   publish:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Java
-        uses: actions/setup-java@v3
+        uses: actions/setup-java@v4
         with:
           java-version: '11'
-          distribution: 'adopt'
-      - name: Use Node.js
-        uses: actions/setup-node@v3
+          distribution: 'temurin'
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
         with:
-          node-version: '16.x'          
-      - name: Npm install
-        run: npm install --legacy-peer-deps
-      - name: Rm  the backend.js
+          node-version: '18.x'
+          cache: 'npm'
+      - name: Install dependencies
+        run: npm ci
+      - name: Clean build output
         run: rm -rf backend/www/*.js
-      - name: Build the new JS
+      - name: Build frontend
         run: npm run build
-      - name: Switch current dir
-        run: cd backend
-      - name: Publish package
+      - name: Publish to Maven Central
         env:
           JRELEASER_NEXUS2_USERNAME: ${{ secrets.JRELEASER_NEXUS2_USERNAME }}
           JRELEASER_NEXUS2_PASSWORD: ${{ secrets.JRELEASER_NEXUS2_PASSWORD }}
+          JRELEASER_MAVENCENTRAL_USERNAME: ${{ secrets.JRELEASER_MAVENCENTRAL_USERNAME }}
+          JRELEASER_MAVENCENTRAL_PASSWORD: ${{ secrets.JRELEASER_MAVENCENTRAL_PASSWORD }}
           JRELEASER_GPG_PASSPHRASE: ${{ secrets.JRELEASER_GPG_PASSPHRASE }}
           JRELEASER_GPG_SECRET_KEY: ${{ secrets.JRELEASER_GPG_SECRET_KEY }}
           JRELEASER_GPG_PUBLIC_KEY: ${{ secrets.JRELEASER_GPG_PUBLIC_KEY }}
           JRELEASER_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: mvn -Prelease deploy jreleaser:deploy -DaltDeploymentRepository=local::file:./target/staging-deploy -DskipTests
+        working-directory: backend
+        run: mvn -Prelease deploy jreleaser:deploy -Djreleaser.config.file=jreleaser.yml -DaltDeploymentRepository=local::file:./target/staging-deploy -DskipTests

.gitignore

@@ -1,5 +1,7 @@
 *.retry
 .env
+.npm
+.webpack_cache
 node_modules
 extracted-messages
 npm-debug.log*
@@ -38,4 +40,4 @@ www/perun-core.js
 www/perun-core.js.map
 www/*.perun-core.js
 www/*.perun-core.js.map
-www/perun-core.js.LICENSE.txt
+www/perun-core.js.LICENSE.txt

.gitlab-ci.yml

@@ -10,6 +10,7 @@ cache:
       - package-lock.json
   paths:
     - .webpack_cache/
+    - .npm/
 
 before_script:
   - pwd
@@ -29,8 +30,7 @@ after_script:
   script:
     - pwd
     - git reset --hard HEAD
-    - rm -rf node_modules
-    - npm install
+    - npm ci --cache .npm --prefer-offline
     - npm run test
     - npm run build
 
@@ -46,8 +46,7 @@ after_script:
     - pwd
     - cd $CI_PROJECT_DIR/
     - git reset --hard HEAD
-    - rm -rf node_modules
-    - npm install
+    - npm ci --cache .npm --prefer-offline
     - rm -rf www/*.js
     - npm run build-dev
     - pwd
@@ -61,8 +60,7 @@ after_script:
     - pwd
     - cd $CI_PROJECT_DIR/
     - git reset --hard HEAD
-    - rm -rf node_modules
-    - npm install
+    - npm ci --cache .npm --prefer-offline
     - rm -rf www/*.js
     - npm run build-dev
     - url_host=`git remote get-url origin | sed -e "s/https:\/\/gitlab-ci-token:.*@//g"`
@@ -81,8 +79,7 @@ after_script:
     - pwd
     - cd $CI_PROJECT_DIR/
     - git reset --hard HEAD
-    - rm -rf node_modules
-    - npm install
+    - npm ci --cache .npm --prefer-offline
     - rm -rf www/*.js
     - npm run build
     - url_host=`git remote get-url origin | sed -e "s/https:\/\/gitlab-ci-token:.*@//g"`
@@ -101,8 +98,7 @@ after_script:
     - pwd
     - cd $CI_PROJECT_DIR/
     - git reset --hard HEAD
-    - rm -rf node_modules
-    - npm install
+    - npm ci --cache .npm --prefer-offline
     - rm -rf www/*.js
     - npm run build
     - pwd

CHANGELOG.md

@@ -0,0 +1,147 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+---
+
+## [v4.5.5] - 2026-06-23
+
+### New Features
+- **JSON editor**: Replaced the legacy JSON editor/viewer with Monaco editor; extracted JsonEditor utilities; fixed `handleFormat` to populate `editorRef` on mount
+- **reCAPTCHA**: Load script conditionally based on the `GOOGLE_CAPTCHA_ENABLED` system parameter
+- **Google Analytics**: Load script conditionally based on the `GOOGLE_ANALYTICS_ID` system parameter
+- **Tasks**: New tasks component with supporting logic and web services
+- **LabelEditor**: Refactored into focused sub-components; enabled in the UI
+- **Server unavailability**: Graceful handling on page load with SweetAlert2 fallback; applied to `index.html` template
+- **Login CSS**: New login-specific classes replacing generic logon CSS classes
+
+### CodeList Editor
+- Fully refactored the CodeList editor
+- Auto-search new codelist after save
+- Children sorted by `SORT_ORDER` in both the grid and exported tree
+- Pre-fill and disable `PARENT_CODE_VALUE` when adding child codes; disable when editing existing codelist entries
+- Breadcrumb updated on edit
+- Export always includes the full tree from root, regardless of current navigation depth
+
+### Svarog Tables & Fields Admin
+- Added `ConfigTables` component for config-type tables; `SvarogTables` now filtered to non-config tables only
+- Inline field editor with `GUI_METADATA` badge and editing
+- New-table creation flow and fixed table edit form submission
+- Switched fields fetch to `WsCore/children`
+- Field label displayed in the editor; field export no longer drops server-only values
+
+### Export UX
+- Auto-select locale when only one is configured
+- Trigger export on locale select
+- Export loading state; fixed preview race condition on cancel
+- Close modal after export; improved empty-fields hint text
+
+### UI / UX
+- `SystemConfLogs`: improved grid config and log preview
+- `CACHE_TYPE`: show translated value
+- Labels: always show the label (not only when translated); show index as title
+
+### Bug Fixes
+- Axios: suppress alert on cancelled requests; handle connection refused errors
+- Abort in-flight form fetches; deduplicate `getRowField`; guard export on empty breadcrumb
+- `onInputChange`: fix spreading array `formData` into an object (losing array type)
+- `isJSON`: drop `strcmp` dependency, check objects directly, handle null
+- CodeList: fix stale search grid after root node delete
+- Alert when `BUSINESS_OBJECT_TYPE_NAME` parameter is missing
+- Export locale auto-select: use `useEffect` for locales arriving after modal opens; validate parsed array before use
+
+### Build & Tooling
+- CI: updated Node.js version; switched to `npm ci` with `.npm` cache; webpack filesystem cache with absolute cache path
+- Overrode `dompurify` to 3.4.0
+- Multiple `npm audit` fixes
+
+### Docs
+- Clarified Google Analytics and reCAPTCHA configuration docs
+
+---
+
+## [v4.5.4] - 2026-04-17
+
+### Build & Tooling
+- Parallelized Babel transpilation; narrowed `preset-env` targets for smaller bundles
+- Modernized and cleaned up Webpack config; added filesystem cache
+- Updated `engines` property in `package.json`
+- Upgraded `maven-bundle-plugin` to 5.1.9
+- Multiple `npm audit` fixes across several commits
+
+### ESLint
+- Migrated from ESLint v8 to v9
+
+### Dependencies
+- Replaced `xlsx` with `xlsx-js-style`
+
+### Features
+- **Session token**: sent as `sessionId` header on every request
+- **Reload all grids**: new logic to reload all grids at once
+- **Selected rows**: improved tracking when sorting/filtering is applied; reset filters and filtered rows
+- **Tables & Fields**: components for managing DB tables and fields, download as JSON, handle add/delete
+- **Workflow**: added workflow item params to perun-core
+- **Icons**: new icon handling approach; fixed broken imports
+- **User management**: new user management web services
+- **Router**: fixes for the reload issues
+
+### UI / UX
+- New and updated labels across multiple commits
+
+### Docs & Config
+- Rewrote README with reorganized dev guide; added prerequisites and index.html template
+- Standardized `client.js` comments; extracted GA tracking ID to env variable
+- Various clean-ups and minor clarifications
+
+---
+
+## [v4.5.3] - 2026-01-22
+
+### General Updates
+- Added an admin console component for managing the `PERUN_MENU` table
+- Added an admin console component for managing the `SVAROG_WORKFLOW_AUTOMATON` table
+- Added the `@tabler/icons-react` package and a component for displaying the icons
+
+### Improvements
+- Added more utility functions to avoid duplicating code across projects/modules
+
+### Clean-up
+- Removed unused/deprecated `Module Menu` and `Context Menu` components
+
+---
+
+## [v4.5.2] - 2025-09-19
+
+### General Updates
+- Added generic functions to avoid code duplication
+- Added language switch functionality to `PerunNavbar`
+
+### Improvements
+- Formatting
+- Card classes
+- Error handling
+
+---
+
+## [v4.5.1] - 2025-07-01
+
+### Misc
+- Removed naits check in `Router.js`
+
+---
+
+## [v4.5.0] - 2025-06-30
+
+### General Updates
+- Updated outdated dependencies in `package.json` to improve stability and compatibility
+
+### New Features
+- **My Profile**: Added a new user profile section for easier account management
+- **AlertUserV2**: Introduced an enhanced alert system for improved user notifications
+
+### Improvements
+- **User Management**: Reworked to enhance performance and usability
+- **PerunNavbar**: Redesigned for improved performance, usability, and a more modern look
+
+### Clean-up
+- Removed unused components and deprecated functions to optimize the codebase

README.md

@@ -4,7 +4,7 @@ The front-end module of the Svarog framework, containing the core functionalitie
 
 ## Prerequisites
 
-- [Node.js](https://nodejs.org/) (v16 or higher)
+- [Node.js](https://nodejs.org/) (v18.12.0 or higher)
 - [npm](https://www.npmjs.com/) (v8 or higher)
 
 ## Getting Started
@@ -26,17 +26,7 @@ npm install
 
 ## Environment Variables
 
-| Variable | Description | Required |
-|----------|-------------|----------|
-| `GA_TRACKING_ID` | Google Analytics tracking ID | No |
-
-For local development, create a `.env` file in the project root:
-
-```
-GA_TRACKING_ID=UA-XXXXXXXXX-X
-```
-
-For CI/CD, set the variable in your GitLab CI/CD settings under **Settings > CI/CD > Variables**.
+This project has no required build-time environment variables. Google Analytics is configured at runtime via the `GOOGLE_ANALYTICS_ID` system parameter fetched from the server (`WsConf/params/get/sys/GOOGLE_ANALYTICS_ID`). reCAPTCHA is loaded conditionally based on the `GOOGLE_CAPTCHA_ENABLED` system parameter (`WsConf/params/get/sys/GOOGLE_CAPTCHA_ENABLED`); set it to `"true"` to enable it.
 
 ## Local Development Guide
 
@@ -117,6 +107,14 @@ window.server = 'http://<host>:<port>/services'
 
 > **Note:** This is a simplified template. The full boilerplate is available at [`docs/index.html.template`](docs/index.html.template) — copy it into your project's `backend/www` directory and customize as needed.
 
+### Server Unavailability Handling
+
+`index.html` loads `sweetalert2.all.min.js` from the assets server before the inline script runs. If the backend is temporarily unavailable (e.g. during a restart or deploy), the `getServer` script will fail to set `window.server`, and a SweetAlert2 dialog will be shown instead of a blank page.
+
+Make sure `sweetalert2.all.min.js` is present in your assets project at `perun-assets/js/`. The file can be obtained from the [SweetAlert2 releases page](https://github.com/sweetalert2/sweetalert2/releases).
+
+To simulate a server unavailability scenario locally, block the `getServer` request in your browser's DevTools under **Network > Block request URL**, then reload the page.
+
 ### Spatial Support
 
 If your project uses spatial features, you must manually add the following parameters to `index.html` (inside a `<script>` tag, before other scripts):