@cocreate/aria 1.1.1 → 1.3.0

package/.github/workflows/automated.yml

@@ -1,8 +1,10 @@
 name: Automated Workflow
+
 on:
   push:
     branches:
       - master
+
 jobs:
   about:
     runs-on: ubuntu-latest
@@ -18,26 +20,37 @@ jobs:
         with:
           direction: overwrite-github
           githubToken: "${{ secrets.GITHUB }}"
+
   release:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Required so semantic-release can trace git tags/history
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 22 # Required for the latest semantic-release plugins
-      - name: Semantic Release
-        uses: cycjimmy/semantic-release-action@v4 # Update to v4 for better Node 20+ support
-        id: semantic
-        with:
-          extra_plugins: |
-            @semantic-release/changelog
+          node-version: 22
+
+      - name: Install Semantic Release & Plugins
+        # Installs semantic-release and its plugins on the runner
+        run: |
+          npm install -g semantic-release \
+            @semantic-release/changelog \
+            @semantic-release/npm \
+            @semantic-release/github \
             @semantic-release/git
-            @semantic-release/github
+
+      - name: Run Semantic Release (Native)
+        id: semantic
+        # This will automatically pick up your export default config file in the repository root
+        run: npx semantic-release
         env:
-          GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}" # Use the built-in token if possible
+          GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
           NPM_TOKEN: "${{ secrets.NPM_TOKEN }}"
+
     outputs:
       new_release_published: "${{ steps.semantic.outputs.new_release_published }}"
-      new_release_version: "${{ steps.semantic.outputs.new_release_version }}"
+      new_release_version: "${{ steps.semantic.outputs.new_release_version }}"

package/.github/workflows/manual.yml

@@ -14,8 +14,7 @@ jobs:
         env:
             DRY_RUN: ${{ github.event.inputs.dry_run }}
             GITHUB_TOKEN: "${{ secrets.GITHUB }}"
-            NPM_TOKEN: "${{ secrets.NPM_TOKEN }}"
-
+  
         steps:
             - name: Checkout
               uses: actions/checkout@v3

package/CHANGELOG.md

@@ -1,3 +1,32 @@
+# [1.3.0](https://github.com/CoCreate-app/CoCreate-aria/compare/v1.2.1...v1.3.0) (2026-07-17)
+
+
+### Features
+
+* update automated workflow and release configuration for improved semantic release handling ([496feb1](https://github.com/CoCreate-app/CoCreate-aria/commit/496feb179258d215ed33d644e0e412712bf9b2a7))
+
+## [1.2.1](https://github.com/CoCreate-app/CoCreate-aria/compare/v1.2.0...v1.2.1) (2026-07-11)
+
+
+### Bug Fixes
+
+* bump package versions ([2ad08d0](https://github.com/CoCreate-app/CoCreate-aria/commit/2ad08d0434fd16624190902a3da18d3e1aabdee2))
+* removed post install and add add packages to apprved list ([100c02b](https://github.com/CoCreate-app/CoCreate-aria/commit/100c02b93154001d03f2cb9ce6da41ea9c337df2))
+* semantic version handling ([a64a089](https://github.com/CoCreate-app/CoCreate-aria/commit/a64a089292f5d7dd86d6439066081f8d701c8404))
+* update aria-open and aria-close attribute handling to treat them as boolean-like ([608bb59](https://github.com/CoCreate-app/CoCreate-aria/commit/608bb59372d3fc0dabbcda96f8be4ef4e34d8405))
+
+# [1.2.0](https://github.com/CoCreate-app/CoCreate-aria/compare/v1.1.1...v1.2.0) (2026-02-09)
+
+
+### Bug Fixes
+
+* root factory variable Module ([6f35875](https://github.com/CoCreate-app/CoCreate-aria/commit/6f358757c9917ec52c397a35bc6f5e97976de6ed))
+
+
+### Features
+
+* aria-attribute-group for tab navigation grouping to deactivate state of other tabs in the group ([12822c0](https://github.com/CoCreate-app/CoCreate-aria/commit/12822c04fbe41672833852018242a58c179b9229))
+
 ## [1.1.1](https://github.com/CoCreate-app/CoCreate-aria/compare/v1.1.0...v1.1.1) (2025-12-26)
 
 

package/README.md

@@ -1,6 +1,6 @@
 # CoCreate-aria
 
-Chain multiple component executions to generate your desired logic, when one action is complete next one will start. The sequence goes until all aria have been completed. Vanilla javascript, easily configured using HTML5 attributes and/or JavaScript API. Take it for a spin in our [playground!](https://cocreate.app/docs/aria)
+Orchestrate dynamic UI behavior and ARIA state with event-driven action chains, configured via HTML5 attributes or the JavaScript API. Take it for a spin in our [playground!](https://cocreate.app/docs/aria)
 
 ![minified](https://img.badgesize.io/https://cdn.cocreate.app/aria/latest/CoCreate-aria.min.js?style=flat-square&label=minified&color=orange)
 ![gzip](https://img.badgesize.io/https://cdn.cocreate.app/aria/latest/CoCreate-aria.min.js?compression=gzip&style=flat-square&label=gzip&color=yellow)

package/package.json

@@ -1,17 +1,19 @@
 {
   "name": "@cocreate/aria",
-  "version": "1.1.1",
-  "description": "Chain multiple component executions to generate your desired logic, when one action is complete next one will start. The sequence goes until all aria have been completed. Vanilla javascript, easily configured using HTML5 attributes and/or JavaScript API.",
+  "version": "1.3.0",
+  "description": "Orchestrate dynamic UI behavior and ARIA state with event-driven action chains, configured via HTML5 attributes or the JavaScript API.",
   "keywords": [
     "aria",
-    "chain-functions",
+    "workflow",
+    "orchestration",
+    "automation",
+    "chain-actions",
+    "event-driven",
+    "attributes",
+    "dom",
     "low-code",
-    "realtime",
-    "realtime-framework",
-    "collaboration",
-    "shared-editing",
-    "html5-framework",
-    "javascript-framework"
+    "html5",
+    "javascript"
   ],
   "publishConfig": {
     "access": "public"
@@ -19,8 +21,7 @@
   "scripts": {
     "start": "npx webpack --config webpack.config.js",
     "build": "npx webpack --mode=production --config webpack.config.js",
-    "dev": "npx webpack --config webpack.config.js --watch",
-    "postinstall": "node -e \"const { execSync } = require('child_process'); try { execSync('coc --version', { stdio: 'ignore' }); } catch (error) { try { execSync('npm install -g @cocreate/cli', { stdio: 'inherit' }); console.log('Installed \"@cocreate/cli\" globally.'); } catch (error) { console.error('Failed to install \"@cocreate/cli\" globally:', error); } }\""
+    "dev": "npx webpack --config webpack.config.js --watch"
   },
   "repository": {
     "type": "git",
@@ -37,18 +38,15 @@
     "url": "https://github.com/sponsors/CoCreate-app"
   },
   "main": "./src/index.js",
+  "dependencies": {
+    "@cocreate/observer": "^1.19.0"
+  },
   "devDependencies": {
-    "css-loader": "^5.1.3",
-    "esbuild": "^0.25.2",
-    "esbuild-loader": "^4.3.0",
-    "mini-css-extract-plugin": "^1.5.0",
-    "webpack": "^5.24.4",
-    "webpack-cli": "^4.5.0",
-    "webpack-log": "^3.0.1"
+    "@cocreate/webpack": "^1.4.3"
   },
-  "dependencies": {
-    "@cocreate/observer": "^1.18.1",
-    "@cocreate/uuid": "^1.12.1",
-    "@cocreate/utils": "^1.39.0"
+  "allowScripts": {
+    "@cocreate/observer@1.19.0": true,
+    "@cocreate/utils@1.42.2": true,
+    "@cocreate/webpack@1.4.3": true
   }
 }

package/release.config.js

@@ -10,12 +10,20 @@ module.exports = {
         changelogFile: "CHANGELOG.md",
       },
     ],
-    "@semantic-release/npm",
-    "@semantic-release/github",
+    "@semantic-release/npm", 
     [
-      "@semantic-release/git",
+      "@semantic-release/github", 
       {
+        successComment: false,
+        failTitle: false,
+      },
+    ],
+    [
+      "@semantic-release/git", 
+      {
+        // Only stage and commit the changelog and package.json
         assets: ["CHANGELOG.md", "package.json"],
+        message: "chore(release): ${nextRelease.version} [skip ci]",
       },
     ],
   ],

package/src/index.js

@@ -1,231 +1,353 @@
+import Observer from '@cocreate/observer';
+
+/**
+ * Main initialization entry point for ARIA attributes.
+ * Orchestrates the setup of interactive controls and navigation states.
+ * @param {Element|Element[]|NodeList} [elements] - Optional specific elements to initialize. 
+ * If omitted, the script scans the entire document for [aria-controls].
+ */
 function init(elements) {
-	if (!elements) {
-		elements = document.querySelectorAll("[aria-controls]");
-		// initDocument();
-	}
-	initElement(elements);
+    // 1. Initialize aria-controls (Toggles, Popups, Tabs)
+    let controlsElements = elements;
+    if (!controlsElements) {
+        controlsElements = document.querySelectorAll("[aria-controls]");
+    }
+    initElement(controlsElements);
+
+    // 2. Initialize aria-current (Navigation links)
+    // Performed after controls to ensure global scan happens last
+    setAriaCurrent();
 }
 
-let popupListener = null;
+/**
+ * Initializes interactive elements by binding click events and handling 
+ * accessibility state changes (aria-expanded, aria-hidden, aria-selected).
+ * @param {Element|Element[]|NodeList} elements - Elements to be initialized as ARIA controls.
+ */
+const initialized = new Set();
 
-function addPopupListener() {
-	if (!popupListener) {
-		popupListener = function (event) {
-			
-			const hasPopUps = document.querySelectorAll(
-				'[aria-controls][aria-haspopup][aria-expanded="true"]'
-			);
-
-			let skipControlledId = null;
-			for (let hasPopUp of hasPopUps) {
-				const controlledId = hasPopUp.getAttribute("aria-controls");
-				if (skipControlledId === controlledId) {
-					continue; // Skip this controlledId if it was already processed
-				}
-				if (hasPopUp.contains(event.target)) {
-					skipControlledId = controlledId;
-					continue; // Ignore clicks inside the popup
-				}
-
-				const controlledElement = document.getElementById(controlledId);
-				let closeOn = controlledElement.getAttribute("aria-close-on");
-				let closeOnEl = controlledElement;
-				if (!closeOn) {
-					closeOnEl = event.target.closest(
-						`#${controlledId} [aria-close-on]`
-					);
-					if (closeOnEl) {
-						closeOn = closeOnEl.getAttribute("aria-close-on");
-					}
-				}
-
-				let closeOnConditions = closeOn ? closeOn.split(",").map(c => c.trim()) : [];
-
-				let shouldClose = false;
-				for (let condition of closeOnConditions) {
-					if (condition === "outside" && !closeOnEl.contains(event.target)) {
-						shouldClose = true;
-					} else if (condition === "inside" && closeOnEl.contains(event.target)) {
-						shouldClose = true;
-					} else if (condition === "anywhere") {
-						shouldClose = true;
-					}
-
-					// If any condition matches, break the loop
-					if (shouldClose) break;
-				}
-
-				if (!shouldClose) continue;
-
-				controlledElement.classList.remove("show");
-				controlledElement.setAttribute("aria-hidden", "true");
-				updateAllControls(controlledId, "false");
-			}
-			// Remove listener if no popups remain open
-			if (
-				!document.querySelector(
-					'[aria-controls][aria-haspopup][aria-expanded="true"]'
-				)
-			) {
-				document.removeEventListener("click", popupListener, true);
-				popupListener = null;
-			}
-		};
-		document.addEventListener("click", popupListener, true);
-	}
+function initElement(elements) {
+    if (
+        !Array.isArray(elements) &&
+        !(elements instanceof NodeList) &&
+        !(elements instanceof HTMLCollection)
+    ) {
+        elements = [elements];
+    }
+
+    if (elements.length === 0) return;
+
+    for (let control of elements) {
+        if (!control.hasAttribute('aria-controls')) continue;
+        if (initialized.has(control)) continue;
+        initialized.add(control);
+        
+        initEscapeKey(control);
+        
+        control.addEventListener("click", function (event) {
+            // Only prevent default if it's not a standard link leading to another page
+            const href = this.getAttribute("href");
+            if (!href || href.startsWith("#") || this.hasAttribute("aria-haspopup")) {
+                event.preventDefault();
+            }
+
+            const controlledId = this.getAttribute("aria-controls");
+            const controlledElement = document.getElementById(controlledId);
+
+            if (!controlledElement) {
+                console.warn(`ARIA Controls: No element found with ID "${controlledId}" controlled by`, this);
+                return;
+            }
+
+            const closeOn = controlledElement.getAttribute("aria-close-on");
+            const role = this.getAttribute("role");
+            const ariaOpenAttr = this.getAttribute("aria-open");
+            const ariaCloseAttr = this.getAttribute("aria-close");
+            // Treat these attributes as boolean-like: presence and not equal to "false"
+            const hasAriaOpen = ariaOpenAttr !== null && ariaOpenAttr !== "false";
+            const hasAriaClose = ariaCloseAttr !== null && ariaCloseAttr !== "false";
+            const expanded = this.getAttribute("aria-expanded");
+            const controlsClass = this.getAttribute("aria-controls-class") || "show";
+            const group = this.getAttribute("aria-controls-group");
+
+            // Prevent interaction if state is already in target position
+            if (hasAriaOpen && expanded === "true") return;
+            if (hasAriaClose && expanded !== "true") return;
+
+            if (role === "tab") {
+                // Tab Pattern: Mutual exclusivity within a tablist
+                const tablist = this.closest("[role='tablist']");
+                const tabs = tablist.querySelectorAll('[role="tab"]');
+                for (let tab of tabs) {
+                    const tabControlledId = tab.getAttribute("aria-controls");
+                    const tabControlledEl = document.getElementById(tabControlledId);
+                    if (this === tab) {
+                        tab.setAttribute("aria-selected", "true");
+                        tabControlledEl.setAttribute("aria-hidden", "false");
+                        if (controlsClass) tabControlledEl.classList.add(controlsClass);
+                    } else {
+                        tab.setAttribute("aria-selected", "false");
+                        tabControlledEl.setAttribute("aria-hidden", "true");
+                        if (controlsClass) tabControlledEl.classList.remove(controlsClass);
+                    }
+                }
+            } else {
+                // Toggle Pattern: Standard expand/collapse
+                if (expanded === "true") {
+                    controlledElement.setAttribute("aria-hidden", "true");
+                    if (controlsClass) controlledElement.classList.remove(controlsClass);
+                    updateAllControls(controlledId, "false");
+                    removePopupListener();
+                } else {
+                    controlledElement.setAttribute("aria-hidden", "false");
+                    if (controlsClass) controlledElement.classList.add(controlsClass);
+                    
+                    // Handle grouped controls (Accordions)
+                    if (group) {
+                        const groupedControls = document.querySelectorAll(`[aria-controls-group="${group}"][aria-expanded="true"]`);
+                        for (let groupedControl of groupedControls) {
+                            const groupedId = groupedControl.getAttribute("aria-controls");
+                            if (!groupedId || groupedId === controlledId) continue;
+                            const groupedElement = document.getElementById(groupedId);
+                            if (!groupedElement) continue;
+                            const gClass = groupedControl.getAttribute("aria-controls-class") || "show";
+                            groupedElement.setAttribute("aria-hidden", "true");
+                            if (gClass) groupedElement.classList.remove(gClass);
+                            updateAllControls(groupedId, "false");
+                        }
+                    }
+                    updateAllControls(controlledId, "true");
+                    if (closeOn !== "btn" && closeOn !== "button") {
+                        addPopupListener();
+                    }
+                }
+            }
+        });
+    }
 }
 
-function removePopupListener() {
-	if (popupListener) {
-		document.removeEventListener("click", popupListener, true);
-		popupListener = null;
-	}
+/**
+ * Synchronizes aria-expanded state across all elements controlling the same ID.
+ * @param {string} controlledId - The ID of the target element.
+ * @param {string} state - The target state ('true' or 'false').
+ */
+function updateAllControls(controlledId, state) {
+    const allControls = document.querySelectorAll(`[aria-controls="${controlledId}"]`);
+    allControls.forEach((ctrl) => ctrl.setAttribute("aria-expanded", state));
 }
 
-const initialized = new Set();
-function initElement(elements) {
-	if (
-		!Array.isArray(elements) &&
-		!(elements instanceof NodeList) &&
-		!(elements instanceof HTMLCollection)
-	) {
-		elements = [elements];
-	}
-
-	if (elements.length === 0) {
-		return;
-	}
-
-	for (let control of elements) {
-		if (initialized.has(control)) continue;
-		initialized.add(control);
-		initEscapeKey(control);
-		control.addEventListener("click", function (event) {
-			event.preventDefault(); // Prevent default link behavior for <a> tags
-
-			const controlledId = this.getAttribute("aria-controls");
-			const controlledElement = document.getElementById(controlledId);
-
-			if (!controlledElement) {
-				console.warn(
-					`ARIA Controls: No element found with ID "${controlledId}" controlled by`,
-					this
-				);
-				return;
-			}
-
-			const closeOn = controlledElement.getAttribute("aria-close-on");
-			const role = this.getAttribute("role");
-			const hasAriaOpen = this.hasAttribute("aria-open");
-			const hasAriaClose = this.hasAttribute("aria-close");
-			const expanded = this.getAttribute("aria-expanded");
-			const controlsClass = this.getAttribute("aria-controls-class") || "show";
-
-			// Apply aria-open and aria-close logic globally, before any role-specific logic
-			if (hasAriaOpen && expanded === "true") {
-				// Do nothing if already open and aria-open is set
-				return;
-			}
-			if (hasAriaClose && expanded !== "true") {
-				// Do nothing if already closed and aria-close is set
-				return;
-			}
-
-			if (role === "tab") {
-				const tablist = this.closest("[role='tablist']");
-				const tabs = tablist.querySelectorAll('[role="tab"]');
-				for (let tab of tabs) {
-					const tabControlledId = tab.getAttribute("aria-controls");
-					const tabControlledEl =
-						document.getElementById(tabControlledId);
-					if (this === tab) {
-						tab.setAttribute("aria-selected", "true");
-						tabControlledEl.setAttribute("aria-hidden", "false");
-						if (controlsClass) {
-							tabControlledEl.classList.add(controlsClass);
-						}
-					} else {
-						tab.setAttribute("aria-selected", "false");
-						tabControlledEl.setAttribute("aria-hidden", "true");
-						if (controlsClass) {
-							tabControlledEl.classList.remove(controlsClass);
-						}
-					}
-				}
-			} else {
-				// Default toggle logic
-				if (expanded === "true") {
-					controlledElement.setAttribute("aria-hidden", "true");
-						if (controlsClass) {
-							controlledElement.classList.remove(controlsClass);
-						}
-					updateAllControls(controlledId, "false");
-					removePopupListener();
-				} else {
-					controlledElement.setAttribute("aria-hidden", "false");
-					if (controlsClass) {
-						controlledElement.classList.add(controlsClass);
-					}
-					updateAllControls(controlledId, "true");
-					if (closeOn !== "btn" && closeOn !== "button") {
-						addPopupListener();
-					}
-				}
-			}
-		});
-	}
+/**
+ * Binds a global click listener to handle "click-outside" behavior for popups.
+ * Conditions are defined via 'aria-close-on' attribute (outside, inside, anywhere).
+ */
+let popupListener = null;
+
+function addPopupListener() {
+    if (!popupListener) {
+        popupListener = function (event) {
+            const hasPopUps = document.querySelectorAll(
+                '[aria-controls][aria-haspopup][aria-expanded="true"]'
+            );
+
+            let skipControlledId = null;
+            for (let hasPopUp of hasPopUps) {
+                const controlledId = hasPopUp.getAttribute("aria-controls");
+                if (skipControlledId === controlledId) continue;
+                if (hasPopUp.contains(event.target)) {
+                    skipControlledId = controlledId;
+                    continue; 
+                }
+
+                const controlledElement = document.getElementById(controlledId);
+                if (!controlledElement) continue;
+
+                // Check if the click occurred on an item explicitly marked to exclude closing
+                const excludeElement = event.target.closest('[aria-close="false"]');
+                if (excludeElement && controlledElement.contains(excludeElement)) {
+                    skipControlledId = controlledId;
+                    continue; 
+                }
+
+                let closeOn = controlledElement.getAttribute("aria-close-on");
+                let closeOnEl = controlledElement;
+                if (!closeOn) {
+                    closeOnEl = event.target.closest(`#${controlledId} [aria-close-on]`);
+                    if (closeOnEl) closeOn = closeOnEl.getAttribute("aria-close-on");
+                }
+
+                let closeOnConditions = closeOn ? closeOn.split(",").map(c => c.trim()) : [];
+                let shouldClose = false;
+
+                for (let condition of closeOnConditions) {
+                    if (condition === "outside" && !closeOnEl.contains(event.target)) {
+                        shouldClose = true;
+                    } else if (condition === "inside" && closeOnEl.contains(event.target)) {
+                        shouldClose = true;
+                    } else if (condition === "anywhere") {
+                        shouldClose = true;
+                    }
+                    if (shouldClose) break;
+                }
+
+                if (!shouldClose) continue;
+
+                controlledElement.classList.remove("show");
+                controlledElement.setAttribute("aria-hidden", "true");
+                updateAllControls(controlledId, "false");
+            }
+
+            if (!document.querySelector('[aria-controls][aria-haspopup][aria-expanded="true"]')) {
+                document.removeEventListener("click", popupListener, true);
+                popupListener = null;
+            }
+        };
+        document.addEventListener("click", popupListener, true);
+    }
 }
 
-function updateAllControls(controlledId, state) {
-	const allControls = document.querySelectorAll(
-		`[aria-controls="${controlledId}"]`
-	);
-	allControls.forEach((ctrl) => ctrl.setAttribute("aria-expanded", state));
+/**
+ * Removes the global popup click listener.
+ */
+function removePopupListener() {
+    if (popupListener) {
+        document.removeEventListener("click", popupListener, true);
+        popupListener = null;
+    }
 }
 
+/**
+ * Binds the Escape key to close the controlled element.
+ * @param {Element} control - The trigger element that controls the target.
+ */
 function initEscapeKey(control) {
-	const controlledId = control.getAttribute("aria-controls");
-	const controlledElement = document.getElementById(controlledId);
-	if (controlledElement) {
-		control.addEventListener("keydown", handleEscapeKey);
-		controlledElement.addEventListener("keydown", handleEscapeKey);
-	}
+    const controlledId = control.getAttribute("aria-controls");
+    const controlledElement = document.getElementById(controlledId);
+    if (controlledElement) {
+        control.addEventListener("keydown", handleEscapeKey);
+        controlledElement.addEventListener("keydown", handleEscapeKey);
+    }
 }
 
+/**
+ * Global handler for the Escape key to close open interactive elements.
+ * @param {KeyboardEvent} event - The keyboard event object.
+ */
 function handleEscapeKey(event) {
-	if (event.key === "Escape") {
-		// Use currentTarget to reference the element the listener is attached to
-		const toggleButton = event.currentTarget.matches("[aria-controls]")
-			? event.currentTarget
-			: document.querySelector(
-					`[aria-controls="${event.currentTarget.id}"]`
-			  );
-
-		if (toggleButton) {
-			toggleButton.click();
-		}
-	}
+    if (event.key === "Escape") {
+        const toggleButton = event.currentTarget.matches("[aria-controls]")
+            ? event.currentTarget
+            : document.querySelector(`[aria-controls="${event.currentTarget.id}"]`);
+
+        if (toggleButton) {
+            toggleButton.click();
+        }
+    }
 }
 
-// Attach Escape key handler globally
+/**
+ * Manages navigation state attributes by scanning links and matching them against
+ * the current URL and hash. Assigns aria-current="page" or "location".
+ * @param {Element|Element[]|NodeList} [elements] - Links or containers to scan. 
+ * Defaults to all a[href] if not provided.
+ */
+function setAriaCurrent(elements) {
+    if (!elements) {
+        elements = document.querySelectorAll("a[href]");
+    }
+
+    if (
+        !Array.isArray(elements) &&
+        !(elements instanceof NodeList) &&
+        !(elements instanceof HTMLCollection)
+    ) {
+        elements = [elements];
+    }
+
+    const currentUrl = new URL(window.location.href);
+    const currentPage = `${currentUrl.origin}${normalizePath(currentUrl.pathname)}`;
+    const currentHash = currentUrl.hash;
+
+    for (const item of elements) {
+        const links = (item.nodeName === 'A' && item.hasAttribute('href'))
+            ? [item]
+            : (item.querySelectorAll ? item.querySelectorAll("a[href]") : []);
+
+        for (const link of links) {
+            const href = link.getAttribute("href") || "";
+
+            if (!href || href === "#") {
+                link.removeAttribute("aria-current");
+                continue;
+            }
+
+            let linkUrl;
+            try {
+                linkUrl = new URL(href, window.location.href);
+            } catch {
+                continue;
+            }
+
+            const linkPage = `${linkUrl.origin}${normalizePath(linkUrl.pathname)}`;
+            const isSamePage = linkPage === currentPage;
+            const linkHasHash = Boolean(linkUrl.hash);
+
+            let ariaValue = null;
+
+            if (isSamePage) {
+                // Match exact location (hash) or general page
+                if (linkHasHash && linkUrl.hash === currentHash) {
+                    ariaValue = "location";
+                } else if (!linkHasHash) {
+                    ariaValue = "page";
+                }
+            }
+
+            if (ariaValue) {
+                link.setAttribute("aria-current", ariaValue);
+            } else {
+                link.removeAttribute("aria-current");
+            }
+        }
+    }
+}
+
+/**
+ * Sanitizes and normalizes URL paths to prevent trailing slash mismatches.
+ * @param {string} path - The raw URL path.
+ * @returns {string} The normalized path string.
+ */
+const normalizePath = (path) => path.replace(/\/$/, "") || "/";
+
+/**
+ * Event Listeners and Observers
+ * Handles browser navigation events and dynamic DOM mutations.
+ */
+window.addEventListener("hashchange", () => setAriaCurrent());
+window.addEventListener("popstate", () => setAriaCurrent());
 document.addEventListener("keydown", handleEscapeKey);
 
-CoCreate.observer.init({
-	name: "aria",
-	types: ["addedNodes"],
-	selector: "[aria-controls]",
-	callback: function (mutation) {
-		initElement(mutation.target);
-	}
+// Observer: Interactive controls
+Observer.init({
+    name: "aria-controls",
+    types: ["addedNodes"],
+    selector: "[aria-controls]",
+    callback: function (mutation) {
+        initElement(mutation.target);
+    }
 });
 
-// CoCreate.observer.init({
-// 	name: "aria-attributes",
-// 	types: ["attributes"],
-// 	attributeFilters: ["aria-selected"],
-// 	callback: function (mutation) {
-// 		initElement(mutation.target);
-// 	}
-// });
+// Observer: Navigation links
+Observer.init({
+    name: "aria-current",
+    types: ["addedNodes", "attributes"],
+    selector: "a[href]",
+    attributeFilters: ["href"],
+    callback: function (mutation) {
+        setAriaCurrent(mutation.target);
+    }
+});
 
+// Initial execution
 init();
+
+export { init, initElement, setAriaCurrent };