@modernman00/shared-js-lib 1.2.49 → 1.2.61

package/AcctMgt/changePassword.js

@@ -2,6 +2,7 @@ import { loginSubmission } from './processAll.js';
 import { id } from '../UtilityHtml.js';
 import { bindEvent, showPassword } from '../Utility.js';
 import { matchInput } from '../general.js';
+import { showError } from '../ShowResponse.js';
 
 
 /**
@@ -26,6 +27,7 @@ import { matchInput } from '../general.js';
  * @param {string} [config.redirect] - URL to redirect to after successful password change.
  * @param {string} [config.theme='bulma'] - UI theme identifier passed to `loginSubmission`.
  * @param {number} [config.maxLength=50] - Maximum allowed length for password fields.
+ * @param {Object} [config.recaptchaV3=null] - reCAPTCHA v3 configuration ({ siteKey: 'xxx', action: 'CHANGE_PASSWORD' }).
  *
  * @example
  * setupPasswordChange(); // Uses default IDs and routes
@@ -52,7 +54,8 @@ export const setupPasswordChange = ({
   route,
   redirect,
   theme = 'bulma',
-  maxLength = 50
+  maxLength = 50,
+  recaptchaV3 = null // { siteKey: 'xxx', action: 'CHANGE_PASSWORD' }
 } = {}) => {
   // Accessibility & input attributes
   const passwordInput = id(passwordId);
@@ -65,6 +68,8 @@ export const setupPasswordChange = ({
   helperText.textContent =
     'Password must be at least 8 characters long, contain at least one uppercase letter, one lowercase letter, one number, and one special character.';
 
+    
+
   // Length limit object
   const lengthLimit = {
     maxLength: {
@@ -74,9 +79,24 @@ export const setupPasswordChange = ({
   };
 
   // Submission handler
-  const handleSubmit = (e) => {
+  const handleSubmit = async (e) => {
     e.preventDefault();
-    loginSubmission(formId, route, redirect, theme, lengthLimit);
+
+    let recaptchaToken = null;
+    // Only run v3 if configured AND grecaptcha is available 
+    if (recaptchaV3?.siteKey && window.grecaptcha && window.grecaptcha.enterprise) {
+      try {
+        recaptchaToken = await grecaptcha.enterprise.execute(
+          recaptchaV3.siteKey,
+          { action: recaptchaV3.action || 'CHANGE_PASSWORD' });
+      } catch (err) {
+        showError(err);
+      }
+    }
+
+    loginSubmission(formId, route, redirect, theme, lengthLimit, [], recaptchaToken);
+
+    
   };
 
   // Bind events

package/AcctMgt/code.js

@@ -1,5 +1,6 @@
 import { loginSubmission } from './processAll.js';
 import { bindEvent } from '../Utility.js';
+import { showError } from '../ShowResponse.js';
 
 /**
  * Creates a reusable form submission handler for code-based forms.
@@ -13,6 +14,7 @@ import { bindEvent } from '../Utility.js';
  * @param {string} options.redirect - URL to redirect to after success.
  * @param {string} [options.theme='bulma'] - UI theme identifier.
  * @param {number} [options.maxLength=50] - Max input length.
+ * @param {Object} [options.recaptchaV3=null] - reCAPTCHA v3 configuration ({ siteKey: 'OUR_ENTERPRISE_SITE_KEYx', action: 'TOKEN' }).
  *
  * @example
  * createCodeSubmitHandler({
@@ -30,11 +32,24 @@ export function createCodeSubmitHandler({
   route,
   redirect,
   theme = 'bulma',
-  maxLength = 50
+  maxLength = 50,
+  recaptchaV3 = null // { siteKey: 'xxx', action: 'LOGIN' }
 }) {
-  const handler = (e) => {
+  const handler = async (e) => {
     e.preventDefault();
 
+    let recaptchaToken = null;
+    // Only run v3 if configured AND grecaptcha is available 
+    if (recaptchaV3?.siteKey && window.grecaptcha && window.grecaptcha.enterprise) {
+      try {
+        recaptchaToken = await grecaptcha.enterprise.execute(
+          recaptchaV3.siteKey,
+          { action: recaptchaV3.action || 'LOGIN' });
+      } catch (err) {
+        showError(err);
+      }
+    }
+
     const lengthLimit = {
       maxLength: {
         id: [inputId],

package/AcctMgt/forgot.js

@@ -1,5 +1,6 @@
-import { loginSubmission} from './processAll.js';
-import {bindEvent } from '../Utility.js';
+import { loginSubmission } from './processAll.js';
+import { bindEvent } from '../Utility.js';
+import { showError } from '../ShowResponse.js';
 
 
 /**
@@ -19,6 +20,7 @@ import {bindEvent } from '../Utility.js';
  * @param {string} options.redirect - URL to redirect to after success.
  * @param {string} [options.theme='bulma'] - UI theme identifier.
  * @param {number} [options.maxLength=50] - Max input length.
+ * @param {Object} [options.recaptchaV3=null] - reCAPTCHA v3 configuration ({ siteKey: 'OUR_ENTERPRISE_SITE_KEYx', action: 'FORGOT' }).
  *
  * @example
  * createEmailSubmitHandler({
@@ -36,11 +38,24 @@ export function forgotSubmitHandler({
   route,
   redirect,
   theme = 'bulma',
-  maxLength = 50
+  maxLength = 50,
+  recaptchaV3 = null // { siteKey: 'xxx', action: 'LOGIN' }
 }) {
-  const handler = (e) => {
+  const handler = async (e) => {
     e.preventDefault();
 
+    let recaptchaToken = null;
+    // Only run v3 if configured AND grecaptcha is available 
+    if (recaptchaV3?.siteKey && window.grecaptcha && window.grecaptcha.enterprise) {
+      try {
+        recaptchaToken = await grecaptcha.enterprise.execute(
+          recaptchaV3.siteKey,
+          { action: recaptchaV3.action || 'LOGIN' });
+      } catch (err) {
+        showError(err);
+      }
+    }
+
     const lengthLimit = {
       maxLength: {
         id: [inputId],

package/AcctMgt/login.js

@@ -1,6 +1,7 @@
 import { loginSubmission } from './processAll.js';
 import { id} from '../UtilityHtml.js';
 import { bindEvent, showPassword } from '../Utility.js';
+import { showError } from '../ShowResponse.js';
 
 
 /**
@@ -23,6 +24,7 @@ import { bindEvent, showPassword } from '../Utility.js';
  * @param {string} options.redirect - URL to redirect to after successful login.
  * @param {string} [options.theme='bootstrap'] - UI theme identifier.
  * @param {number[]} [options.maxLength=[30, 50]] - Max lengths for password and email respectively.
+ * @param {Object} [options.recaptchaV3=null] - reCAPTCHA v3 configuration ({ siteKey: 'OUR_ENTERPRISE_SITE_KEY', action: 'LOGIN' }).
  *
  * @example
  * createAdminLoginHandler({
@@ -44,11 +46,24 @@ export function createAdminLoginHandler({
   route,
   redirect,
   theme = 'bootstrap',
-  maxLength = [30, 50]
+  maxLength = [30, 50],
+  recaptchaV3 = null // { siteKey: 'xxx', action: 'LOGIN' }
 }) {
-  const handler = (e) => {
+  const handler = async (e) => {
     e.preventDefault();
 
+    let recaptchaToken = null;
+    // Only run v3 if configured AND grecaptcha is available 
+    if (recaptchaV3?.siteKey && window.grecaptcha && window.grecaptcha.enterprise) { 
+      try { 
+        recaptchaToken = await grecaptcha.enterprise.execute( 
+          recaptchaV3.siteKey, 
+          { action: recaptchaV3.action || 'LOGIN' } ); 
+          } catch (err) { 
+            showError(err); 
+          } 
+    }
+
     const lengthLimit = {
       maxLength: {
         id: [passwordId, emailId],
@@ -56,7 +71,7 @@ export function createAdminLoginHandler({
       }
     };
 
-    loginSubmission(formId, route, redirect, theme, lengthLimit);
+    loginSubmission(formId, route, redirect, theme, lengthLimit, [], recaptchaToken);
   };
 
   bindEvent({ id: buttonId, handler });

package/AcctMgt/processAll.js

@@ -9,15 +9,15 @@ import FormHelper from '../FormHelper.js';
 // block the setLoader div
 
 /**
- * Handles the submission of the login form.
+ * Handles the submission of the login form and redirects the user.
  * @param {string} formId - The ID of the form to submit.
  * @param {string} loginURL - The URL to make the POST request to.
  * @param {string} redirect - The URL to redirect the user to after the submission is complete.
  * @param {string} [css=null] - The CSS class to add to the notification element if the submission is successful.
- * @returns {void}
+ * @returns {void} yes
  * @throws {Error} - If there is an error with the submission
  */
-export const loginSubmission = async (formId, loginURL, redirect, css = null, lengthLimit = null
+export const loginSubmission = async (formId, loginURL, redirect, css = null, lengthLimit = null, optionalFields = [], recaptchaToken = null
 ) => {
 
   try {
@@ -39,7 +39,7 @@ export const loginSubmission = async (formId, loginURL, redirect, css = null, le
       formData.realTimeCheckLen(lengthLimit.maxLength.id, lengthLimit.maxLength.max);
     }
 
-    formData.massValidate([], { email: 'email', password: 'password' });
+    formData.massValidate(optionalFields, { email: 'email', password: 'password' });
 
     if (formData.result === 1) {
 
@@ -51,7 +51,7 @@ export const loginSubmission = async (formId, loginURL, redirect, css = null, le
 
       localStorage.setItem('redirect', redirect);
 
-      await postFormData(loginURL, formId, redirect, css);
+      await postFormData(loginURL, formId, redirect, css, recaptchaToken);
 
     } else {
 

package/AcctMgt/update.js

@@ -1,6 +1,6 @@
-import {id } from '../UtilityHtml.js';
+import { id } from '../UtilityHtml.js';
 import { bindEvent } from '../Utility.js';
-import { msgException } from '../ShowResponse.js';
+import { msgException, showError } from '../ShowResponse.js';
 import axios from 'axios';
 import { redirectAfterDelay, parseErrorResponse } from '../general.js';
 /**
@@ -12,6 +12,8 @@ import { redirectAfterDelay, parseErrorResponse } from '../general.js';
    * @param {string} options.buttonId - ID of the submit button.
  * @param {string} options.route - API endpoint for submission.
  * @param {string} options.redirect - URL to redirect to after success.
+ * @param {Object} [options.recaptchaV3=null] - reCAPTCHA v3 configuration ({ siteKey: 'OUR_ENTERPRISE_SITE_KEY', action: 'LOGIN' }).
+ * 
  *
  * @example
  * update({
@@ -26,10 +28,23 @@ export function update({
   buttonId,
   route,
   redirect,
+  recaptchaV3 = null // { siteKey: 'xxx', action: 'UPDATE_DATA' }
 }) {
   const handler = async (e) => {
     e.preventDefault();
 
+    let recaptchaToken = null;
+    // Only run v3 if configured AND grecaptcha is available 
+    if (recaptchaV3?.siteKey && window.grecaptcha && window.grecaptcha.enterprise) {
+      try {
+        recaptchaToken = await grecaptcha.enterprise.execute(
+          recaptchaV3.siteKey,
+          { action: recaptchaV3.action || 'LOGIN' });
+      } catch (err) {
+        showError(err);
+      }
+    }
+
     const form = id(formId);
     if (!form) {
       msgException(`Form with ID "${formId}" not found.`);
@@ -39,6 +54,11 @@ export function update({
     const formData = new FormData();
     const inputs = form.querySelectorAll('[name]');
 
+     // if recaptcha token is provided, append it
+    if (recaptchaToken) {
+        formData.append('recaptchaTokenV3', recaptchaToken);
+    }
+
     inputs.forEach(input => {
       const name = input.name;
       const original = input.getAttribute('data-original');
@@ -59,6 +79,7 @@ export function update({
       const message = response.data.message;
 
       const notificationId = id(`${formId}_notification`) || formId;
+      notificationId.style.display = 'block'
 
       notificationId.scrollIntoView({ behavior: 'smooth' });
 
@@ -73,6 +94,7 @@ export function update({
       console.log(error);
       const ErrorMsg = parseErrorResponse(error);
       const notificationId = id(`${formId}_notification`)
+      notificationId.style.display = 'block'
       notificationId.innerHTML = `<li style="color:white; background-color:red">${ErrorMsg}</li>`;
     }
   };

package/FormHelper.js

@@ -1,7 +1,7 @@
 'use strict';
 export default class FormHelper {
     constructor(data) {
-        if (!Array.isArray(data)) throwError('data must be an array of form elements');
+        if (!Array.isArray(data)) throw new Error('data must be an array of form elements');
         this.data = data;
         this.error = [];
         this.result = 0;
@@ -101,7 +101,7 @@ export default class FormHelper {
 
 
 
-    massValidate(optionalFields = [], typeMap = {}) {
+    massValidate(optionalFields, typeMap = {}) {
         this.clearError(); // Reset errors
         this.result = 0;
 
@@ -109,11 +109,11 @@ export default class FormHelper {
             const { name, value, id, type, placeholder } = input;
            
 
-            // Skip non-input elements
+              // Skip non-input elements
             if (
                 ['submit', 'button', 'g-recaptcha-response', 'cancel'].includes(name) ||
                 ['button', 'showPassword', 'token', 'g-recaptcha-response'].includes(id) ||
-                type === 'button' ||
+                type === 'button' || optionalFields.includes(id) ||
                 id === 'checkbox'
             ) continue;
 
@@ -123,7 +123,7 @@ export default class FormHelper {
               const errorEl = this.id(`${id}_error`);
             let val = value.trim();
 
-            // Handle optional fields
+            // Handle optional fields - If optional but empty → auto‑fill “Not Provided”
             if (optionalFields.includes(id) && val === '') {
                 input.value = 'Not Provided';
                 continue;

package/Http.js

@@ -11,7 +11,7 @@ import { redirectAfterDelay, parseErrorResponse } from './general.js';
  * @param {string|null} css - The CSS framework to use for notification styling (e.g., 'W3css', 'bulma').
  NOTICE:::Make sure you set the notification id as the formId_notification
  */
-export const postFormData = async (url, formId, redirect = null, css = null) => {
+export const postFormData = async (url, formId, redirect = null, css = null, recaptchaToken = null) => {
 
     let notificationForm = `${formId}_notification`;
     const notificationId = id(notificationForm);
@@ -43,6 +43,11 @@ export const postFormData = async (url, formId, redirect = null, css = null) =>
 
     let formEntries = new FormData(form);
 
+    // if recaptcha token is provided, append it for v3
+    if (recaptchaToken) {
+        formEntries.append('recaptchaTokenV3', recaptchaToken);
+    }
+
     formEntries.delete('submit');
     formEntries.delete('checkbox');
 

package/config/version.php

@@ -1,3 +1,3 @@
 <?php
-define('APP_VERSION', 'v1.2.50');
+define('APP_VERSION', 'v1.2.61');
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modernman00/shared-js-lib",
-  "version": "1.2.49",
+  "version": "1.2.61",
   "description": "Reusable JS utilities for numerous js problems",
   "homepage": "https://github.com/modernman00/shared-js-lib#readme",
   "keywords": [
@@ -23,24 +23,44 @@
     "test": "jest"
   },
   "dependencies": {
-    "axios": "^1.9.0",
-    "axios-retry": "^4.5.0"
+    "axios": "^1.13.2",
+    "axios-retry": "^4.5.0",
+    "settings": "^0.1.1"
   },
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "index.js",
+    "AcctMgt/",
+    "Cookie.js",
+    "CountryCode.js",
+    "DateTime.js",
+    "FileUpload.js",
+    "FormHelper.js",
+    "Http.js",
+    "Loader.js",
+    "ShowResponse.js",
+    "Utility.js",
+    "UtilityHtml.js",
+    "axiosWrapper.js",
+    "general.js",
+    "config/",
+    "README.md",
+    "release-history.md"
+  ],
   "devDependencies": {
     "@babel/core": "^7.28.3",
     "@babel/preset-env": "^7.28.3",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^11.0.4",
-    "@semantic-release/npm": "^12.0.2",
+    "@semantic-release/npm": "^13.1.2",
     "auto-changelog": "^2.5.0",
     "babel-jest": "^30.0.5",
     "jest": "^30.0.5",
     "jest-environment-jsdom": "^30.0.5",
-    "semantic-release": "^24.2.7"
+    "semantic-release": "^25.0.2"
   },
   "release": {
     "branches": [

package/release-history.md

@@ -19,3 +19,25 @@
 ### Changelog for v1.2.18
 
 - 🔖 Bump version to v1.2.18 _(by modernman00)_
+
+## v1.2.59 — 2025-12-21 21:50
+### Changelog for v1.2.59
+
+- 🔖 Bump version to v1.2.59 _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🔖 Bump version to v1.2.58 _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+
+## v1.2.61 — 2026-01-27 09:25
+### Changelog for v1.2.61
+
+- 🔖 Bump version to v1.2.61 _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_

package/.github/workflows/publish.yml

@@ -1,53 +0,0 @@
-name: Release shared-js-lib
-
-on:
-  push:
-    branches:
-      - main
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v3
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: '18'
-          registry-url: 'https://registry.npmjs.org/'
-          scope: '@modernman00'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run tests
-        run: npm test
-
-      - name: Bump version and generate changelog
-        run: |
-          npm version patch -m "chore(release): %s"
-          npx auto-changelog -p
-        env:
-          GIT_AUTHOR_NAME: github-actions
-          GIT_AUTHOR_EMAIL: actions@github.com
-          GIT_COMMITTER_NAME: github-actions
-          GIT_COMMITTER_EMAIL: actions@github.com
-
-      - name: Push version bump and changelog
-        run: |
-          git push origin main --follow-tags
-
-      - name: Publish to npm
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v1
-        with:
-          tag_name: ${{ github.ref_name }}
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/release.yml

@@ -1,40 +0,0 @@
-name: Publish to npm
-
-on:
-  push:
-    tags:
-      - 'v*.*.*'  # Trigger only on semantic version tags
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v3
-
-      - name: Use Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: '18'
-          registry-url: 'https://registry.npmjs.org/'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Publish to npm
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Confirm publish
-        run: |
-          echo "🔍 Verifying publish..."
-          PACKAGE=$(node -p "require('./package.json').name")
-          VERSION=$(node -p "require('./package.json').version")
-          PUBLISHED=$(npm view $PACKAGE version)
-          if [[ "$PUBLISHED" == "$VERSION" ]]; then
-            echo "✅ $PACKAGE@$VERSION is live on npmjs.org"
-          else
-            echo "⚠️ Expected $VERSION, but registry shows $PUBLISHED"
-          fi

package/.github/workflows/test.yml

@@ -1,32 +0,0 @@
-name: Run Tests and Coverage
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repo
-        uses: actions/checkout@v3
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: '20'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run tests with coverage
-        run: npm test -- --coverage
-
-      - name: Upload coverage report
-        uses: actions/upload-artifact@v3
-        with:
-          name: coverage-report
-          path: coverage/

package/__tests__/handlers.test.js

@@ -1,156 +0,0 @@
-import { createCodeSubmitHandler } from '../AcctMgt/code.js';
-import { forgotSubmitHandler } from '../AcctMgt/forgot.js';
-import { createAdminLoginHandler } from '../AcctMgt/login.js';
-import { setupPasswordChange } from '../AcctMgt/changePassword.js';
-import { loginSubmission } from '../AcctMgt/processAll.js';
-import { showPassword, bindEvent } from '../Utility.js';
-
-
-jest.mock('../AcctMgt/processAll.js');
-jest.mock('../Utility.js');
-
-// Then patch the specific function after DOM is available
-beforeEach(() => {
-  bindEvent.mockImplementation(({ id, event = 'click', handler }) => {
-    const el = document.getElementById(id);
-    if (el) el.addEventListener(event, handler);
-  });
-
-  showPassword.mockImplementation(() => {});
-});
-
-// 🧪 Utility to scaffold DOM elements
-const injectDOM = (elements) => {
-  elements.forEach(({ tag = 'button', id, value = '' }) => {
-    const el = document.createElement(tag);
-    el.setAttribute('id', id);
-    if (value) el.value = value;
-    document.body.appendChild(el);
-  });
-};
-
-afterEach(() => {
-  document.body.innerHTML = '';
-  jest.clearAllMocks();
-});
-
-describe('AcctMgt Handlers', () => {
-  test('🧾 createCodeSubmitHandler submits code form correctly', () => {
-    injectDOM([{ id: 'button' }]);
-
-    createCodeSubmitHandler({
-      formId: 'codeForm',
-      inputId: 'code',
-      buttonId: 'button',
-      route: '/api/code',
-      redirect: '/success',
-      theme: 'bulma',
-      maxLength: 40
-    });
-
-    document.getElementById('button').dispatchEvent(new Event('click'));
-
-    expect(loginSubmission).toHaveBeenCalledWith(
-      'codeForm',
-      '/api/code',
-      '/success',
-      'bulma',
-      { maxLength: { id: ['code'], max: [40] } }
-    );
-  });
-
-  test('📧 forgotSubmitHandler submits email form correctly', () => {
-    injectDOM([
-      { id: 'button' },
-      { tag: 'input', id: 'email', value: 'user@example.com' }
-    ]);
-
-    forgotSubmitHandler({
-      formId: 'forgotPassword',
-      inputId: 'email',
-      buttonId: 'button',
-      route: '/api/forgot',
-      redirect: '/reset',
-      theme: 'bulma',
-      maxLength: 50
-    });
-
-    document.getElementById('button').dispatchEvent(new Event('click'));
-
-    expect(loginSubmission).toHaveBeenCalledWith(
-      'forgotPassword',
-      '/api/forgot',
-      '/reset',
-      'bulma',
-      { maxLength: { id: ['email'], max: [50] } }
-    );
-  });
-
-  test('🔐 createAdminLoginHandler sets attributes and submits login', () => {
-    injectDOM([
-      { id: 'button' },
-      { id: 'showPassword' },
-      { tag: 'input', id: 'password' }
-    ]);
-
-    createAdminLoginHandler({
-      formId: 'managed',
-      emailId: 'email',
-      passwordId: 'password',
-      buttonId: 'button',
-      showToggleId: 'showPassword',
-      route: '/api/login',
-      redirect: '/admin',
-      theme: 'bootstrap',
-      maxLength: [30, 50]
-    });
-
-    document.getElementById('button').dispatchEvent(new Event('click'));
-    document.getElementById('showPassword').dispatchEvent(new Event('click'));
-
-    expect(loginSubmission).toHaveBeenCalledWith(
-      'managed',
-      '/api/login',
-      '/admin',
-      'bootstrap',
-      { maxLength: { id: ['password', 'email'], max: [30, 50] } }
-    );
-
-    expect(document.getElementById('password').getAttribute('autocomplete')).toBe('current-password');
-    expect(showPassword).toHaveBeenCalledWith('password');
-  });
-
-  test('🔁 setupPasswordChange submits when passwords match', () => {
-    injectDOM([
-      { id: 'button' },
-      { id: 'showPassword' },
-      { tag: 'input', id: 'password', value: 'Secure123!' },
-      { tag: 'input', id: 'confirm_password', value: 'Secure123!' },
-      { tag: 'div', id: 'confirm_password_error' },
-      { tag: 'div', id: 'password_help' }
-    ]);
-
-    setupPasswordChange({
-      buttonId: 'button',
-      passwordId: 'password',
-      confirmId: 'confirm_password',
-      errorId: 'confirm_password_error',
-      helpId: 'password_help',
-      showToggleId: 'showPassword',
-      route: '/api/change-password',
-      redirect: '/dashboard',
-      theme: 'bulma',
-      maxLength: 50
-    });
-
-    document.getElementById('button').dispatchEvent(new Event('click'));
-
-    expect(loginSubmission).toHaveBeenCalledWith(
-      'changePassword',
-      '/api/change-password',
-      '/dashboard',
-      'bulma',
-      { maxLength: { id: ['password', 'confirm_password'], max: [50, 50] } }
-    );
-  });
-});

package/babel.config.js

@@ -1,3 +0,0 @@
-export default {
-  presets: [['@babel/preset-env', { targets: { node: 'current' } }]]
-};

package/jest.config.js

@@ -1,6 +0,0 @@
-export default {
-  transform: {
-    '^.+\\.js$': 'babel-jest'
-  },
-  testEnvironment: 'jsdom'
-};

package/release.sh

@@ -1,161 +0,0 @@
-#!/bin/bash
-set -e
-
-# --- Config ---
-VERSION_FILE="config/version.php"
-HISTORY_FILE="release-history.md"
-REPO="origin"
-DEFAULT_BRANCH="main"
-
-# --- Utilities ---
-function detect_branch() {
-  CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
-  echo "🔍 Current branch: $CURRENT_BRANCH"
-  if [[ "$CURRENT_BRANCH" != "$DEFAULT_BRANCH" && "$CURRENT_BRANCH" != "master" ]]; then
-    echo "⚠️ You're on '$CURRENT_BRANCH'. Switch to '$DEFAULT_BRANCH' or 'master' before releasing."
-    exit 1
-  fi
-}
-
-function ensure_clean_git() {
-  if [[ -n $(git status --porcelain) ]]; then
-    echo "🛑 Uncommitted changes detected."
-    git status
-    read -p "❓ Auto-commit all changes before release? (y/n): " choice
-    if [[ "$choice" == "y" ]]; then
-      git add .
-      git commit -m "🧹 Auto-commit before release"
-    else
-      echo "🚫 Aborting release."
-      exit 1
-    fi
-  fi
-}
-
-function run_tests() {
-  echo "🧪 Running tests with coverage..."
-  npm test -- --coverage || {
-    echo "❌ Tests failed. Aborting release."
-    exit 1
-  }
-  echo "✅ Tests passed."
-}
-
-function validate_dependencies() {
-  command -v gh >/dev/null || {
-    echo "❌ GitHub CLI (gh) not found. Install it to publish releases."
-    exit 1
-  }
-}
-
-function extract_version() {
-  grep -q "APP_VERSION" "$VERSION_FILE" || {
-    echo "❌ APP_VERSION not found in $VERSION_FILE"
-    exit 1
-  }
-  CURRENT=$(grep "APP_VERSION" "$VERSION_FILE" | sed -E "s/.*'([^']+)'.*/\1/")
-  IFS='.' read -r MAJOR MINOR PATCH <<< "${CURRENT//v/}"
-}
-
-function determine_bump_type() {
-  LAST_COMMIT=$(git log -1 --pretty=%s)
-  MODE="patch"
-  [[ "$LAST_COMMIT" == feat:* ]] && MODE="minor"
-  [[ "$LAST_COMMIT" == fix:* ]] && MODE="patch"
-  [[ "$LAST_COMMIT" == chore:* || "$LAST_COMMIT" == docs:* ]] && MODE="patch"
-  [[ "$LAST_COMMIT" == BREAKING:* ]] && MODE="major"
-
-  case "$MODE" in
-    major) MAJOR=$((MAJOR + 1)); MINOR=0; PATCH=0 ;;
-    minor) MINOR=$((MINOR + 1)); PATCH=0 ;;
-    patch) PATCH=$((PATCH + 1)) ;;
-  esac
-
-  SEMVER="${MAJOR}.${MINOR}.${PATCH}"
-  NEW="v$SEMVER"
-  echo "🔧 Current version: $CURRENT"
-  echo "⏫ Detected bump: $MODE → $NEW"
-  echo "📦 Last commit: $LAST_COMMIT"
-}
-
-function update_version_file() {
-  if [[ "$OSTYPE" == "darwin"* ]]; then
-    sed -i '' "s/$CURRENT/$NEW/" "$VERSION_FILE"
-  else
-    sed -i "s/$CURRENT/$NEW/" "$VERSION_FILE"
-  fi
-}
-
-function commit_and_tag() {
-  COMMIT_MSG="🔖 Bump version to $NEW"
-  npm version "$SEMVER" --no-git-tag-version
-  git add "$VERSION_FILE"
-  git commit -m "$COMMIT_MSG"
-
-  if git rev-parse "$NEW" >/dev/null 2>&1; then
-    echo "⚠️ Tag $NEW already exists. Skipping tag creation."
-  else
-    git tag "$NEW"
-    git push "$REPO" "$NEW"
-  fi
-
-  echo "🚀 Pushing changes to $REPO/$DEFAULT_BRANCH..."
-  git push "$REPO" "$DEFAULT_BRANCH" || {
-    echo "❌ Failed to push to $DEFAULT_BRANCH. Check your Git credentials or branch name."
-    exit 1
-  }
-}
-
-function generate_changelog() {
-  LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null)
-  [ "$LAST_TAG" = "$NEW" ] && LAST_TAG=$(git rev-list --tags --max-count=2 | tail -n1 | xargs git describe --tags --abbrev=0)
-  NOTES="### Changelog for $NEW\n\n"
-  NOTES+=$(git log "$LAST_TAG"..HEAD --pretty=format:"- %s _(by %an)_" --no-merges)
-  [ -z "$NOTES" ] && NOTES="Initial release."
-}
-
-function publish_github_release() {
-  gh release create "$NEW" \
-    --title "Release $NEW" \
-    --notes "$NOTES" \
-    --verify-tag
-  echo "✅ Published $NEW with changelog and updated $VERSION_FILE!"
-}
-
-function log_release_history() {
-  echo -e "\n## $NEW — $(date '+%Y-%m-%d %H:%M')\n$NOTES" >> "$HISTORY_FILE"
-  echo "📝 Logged release to $HISTORY_FILE"
-}
-
-function publish_to_npm() {
-  echo "🚀 Publishing $SEMVER to npm..."
-  npm publish --access public || {
-    echo "❌ npm publish failed. Check your credentials, registry access, or package.json config."
-    exit 1
-  }
-
-  echo "🔍 Verifying publish on npm registry..."
-  PACKAGE_NAME=$(node -p "require('./package.json').name")
-  PUBLISHED_VERSION=$(npm view "$PACKAGE_NAME" version)
-
-  if [[ "$PUBLISHED_VERSION" == "$SEMVER" ]]; then
-    echo "✅ npm publish confirmed: $PUBLISHED_VERSION is live on npmjs.org"
-  else
-    echo "⚠️ Publish may not have propagated yet. Expected $SEMVER, got $PUBLISHED_VERSION"
-  fi
-}
-
-
-# --- Execution ---
-detect_branch
-ensure_clean_git
-run_tests
-validate_dependencies
-extract_version
-determine_bump_type
-update_version_file
-commit_and_tag
-generate_changelog
-publish_github_release
-log_release_history
-publish_to_npm

package/theAutoComplete.js

@@ -1,93 +0,0 @@
-import { id } from './UtilityHtml.js'
-
-/**
- * 
- * @param {string} inputId 
- * @param {Array} arr 
- */
-
-/**
- * Sets up an autocomplete functionality for an input element.
- *
- * @param {string} inputId - The ID of the input element to attach the autocomplete to.
- * @param {Array<string>} arr - An array of strings containing the autocomplete suggestions.
- *
- * The function converts all strings in the array to lowercase for case-insensitive matching.
- * It initializes the autocomplete with the given input element and array of suggestions,
- * providing real-time suggestions based on user input. On selecting a suggestion,
- * it populates the input element with the selected suggestion.
- */
-export const autocomplete = (inputId, arr) => {
-    const whatToBuyInput = id(inputId); // Get the text input
-    if (whatToBuyInput) {
-  // Create a <ul> for autocomplete suggestions
-  const suggestionList = document.createElement("ul");
-  suggestionList.classList.add("autocomplete-suggestions");
-  suggestionList.id = "suggestions"; // For accessibility
-  whatToBuyInput.parentElement.appendChild(suggestionList); // Append to input's parent
-
-  // Function to show matching suggestions based on user input
-  const showSuggestions = (inputValue) => {
-    suggestionList.innerHTML = ""; // Clear previous suggestions
-    if (!inputValue) return; // Exit if input is empty
-
-    // Filter items that match the input (case-insensitive), limit to 8
-    const matches = arr
-      .filter(item => item.toLowerCase().includes(inputValue.toLowerCase()))
-      .slice(0, 8);
-
-    // Create <li> for each match
-    matches.forEach((item, index) => {
-      const li = document.createElement("li");
-      li.textContent = item;
-      li.setAttribute("tabindex", "0"); // Make focusable for keyboard
-      li.setAttribute("data-index", index); // Store index for navigation
-      li.addEventListener("click", () => {
-        whatToBuyInput.value = item; // Set input value on click
-        suggestionList.innerHTML = ""; // Clear suggestions
-      });
-      li.addEventListener("keypress", (e) => {
-        if (e.key === "Enter") {
-          whatToBuyInput.value = item; // Set input value on Enter
-          suggestionList.innerHTML = ""; // Clear suggestions
-        }
-      });
-      suggestionList.appendChild(li);
-    });
-  };
-
-  // Show suggestions as user types
-  whatToBuyInput.addEventListener("input", (e) => {
-    showSuggestions(e.target.value);
-  });
-
-  // Clear suggestions on blur (with delay for click to register)
-  whatToBuyInput.addEventListener("blur", () => {
-    setTimeout(() => suggestionList.innerHTML = "", 200);
-  });
-
-  // Handle keyboard navigation for suggestions
-  whatToBuyInput.addEventListener("keydown", (e) => {
-    const suggestions = suggestionList.querySelectorAll("li");
-    if (!suggestions.length) return; // Exit if no suggestions
-
-    let focusedIndex = Array.from(suggestions).findIndex(li => li === document.activeElement);
-    if (e.key === "ArrowDown") {
-      e.preventDefault(); // Prevent cursor movement
-      focusedIndex = (focusedIndex + 1) % suggestions.length; // Loop to start
-      suggestions[focusedIndex].focus();
-    } else if (e.key === "ArrowUp") {
-      e.preventDefault();
-      focusedIndex = (focusedIndex - 1 + suggestions.length) % suggestions.length; // Loop to end
-      suggestions[focusedIndex].focus();
-    } else if (e.key === "Enter" && focusedIndex >= 0) {
-      e.preventDefault();
-      whatToBuyInput.value = suggestions[focusedIndex].textContent; // Select item
-      suggestionList.innerHTML = ""; // Clear suggestions
-    } else if (e.key === "Escape") {
-      suggestionList.innerHTML = ""; // Clear suggestions
-    }
-  });
-}
-}
-