@zappzarapp/browser-utils 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marc Straube
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,220 @@
+# ⚡ @zappzarapp/browser-utils
+
+[![npm version](https://img.shields.io/npm/v/@zappzarapp/browser-utils.svg)](https://www.npmjs.com/package/@zappzarapp/browser-utils)
+[![Node.js Version](https://img.shields.io/node/v/@zappzarapp/browser-utils.svg)](https://www.npmjs.com/package/@zappzarapp/browser-utils)
+[![License](https://img.shields.io/npm/l/@zappzarapp/browser-utils.svg)](https://www.npmjs.com/package/@zappzarapp/browser-utils)
+[![CI](https://github.com/marcstraube/zappzarapp-browser-utils/actions/workflows/ci.yml/badge.svg)](https://github.com/marcstraube/zappzarapp-browser-utils/actions/workflows/ci.yml)
+
+Zero-dependency browser utilities with security-first design — type-safe,
+tree-shakeable, and fully tested.
+
+## Highlights
+
+- **All-in-one** — 35 browser modules in a single, tree-shakeable package
+- **Type-safe** — strict TypeScript with generics throughout
+- **Zero dependencies** — no runtime dependencies
+- **Secure by default** — cryptographic randomness, input validation, XSS
+  prevention
+- **Dual error handling** — throwing and Result-based APIs
+- **Quality-backed** — 3950+ tests, strict ESLint, full coverage
+
+## Modules
+
+### Storage & Data
+
+| Module     | Key Classes             | Description                       |
+| ---------- | ----------------------- | --------------------------------- |
+| storage    | `StorageManager`        | localStorage with LRU eviction    |
+| session    | `SessionStorageManager` | sessionStorage wrapper            |
+| cookie     | `CookieManager`         | Secure cookie management          |
+| indexeddb  | `IndexedDBManager`      | IndexedDB async wrapper           |
+| cache      | `CacheManager`          | HTTP-style stale-while-revalidate |
+| encryption | `EncryptedStorage`      | AES-GCM with PBKDF2               |
+
+### DOM & UI
+
+| Module     | Key Classes                       | Description                  |
+| ---------- | --------------------------------- | ---------------------------- |
+| html       | `DomHelper`, `HtmlEscaper`        | DOM helpers, HTML escaping   |
+| focus      | `FocusTrap`                       | Focus trapping for modals    |
+| scroll     | `ScrollManager`                   | Scroll utilities and locking |
+| fullscreen | `FullscreenManager`               | Fullscreen API wrapper       |
+| form       | `FormValidator`, `FormSerializer` | Validation and serialization |
+
+### Events & Input
+
+| Module   | Key Classes                              | Description                 |
+| -------- | ---------------------------------------- | --------------------------- |
+| events   | `EventDelegator`, `debounce`, `throttle` | Event delegation and timing |
+| keyboard | `ShortcutManager`                        | Keyboard shortcuts          |
+| idle     | `IdleCallback`                           | requestIdleCallback wrapper |
+
+### Observers
+
+| Module  | Key Classes                                            | Description                    |
+| ------- | ------------------------------------------------------ | ------------------------------ |
+| observe | `IntersectionObserverWrapper`, `ResizeObserverWrapper` | Intersection, Resize, Mutation |
+
+### Network & Communication
+
+| Module    | Key Classes                   | Description                   |
+| --------- | ----------------------------- | ----------------------------- |
+| network   | `RetryQueue`, `NetworkStatus` | Retry queue with backoff      |
+| offline   | `OfflineQueue`                | IndexedDB-backed offline sync |
+| websocket | `WebSocketManager`            | WebSocket with auto-reconnect |
+| request   | `RequestInterceptor`          | Fetch middleware and auth     |
+| url       | `UrlBuilder`                  | URL building, query params    |
+| broadcast | `BroadcastManager`            | Cross-tab messaging           |
+
+### Device & Environment
+
+| Module      | Key Classes          | Description                |
+| ----------- | -------------------- | -------------------------- |
+| device      | `DeviceInfo`         | Device detection           |
+| features    | `FeatureDetect`      | Browser feature detection  |
+| media       | `MediaQuery`         | Media queries, breakpoints |
+| visibility  | `VisibilityManager`  | Page Visibility API        |
+| geolocation | `GeolocationManager` | Geolocation API wrapper    |
+| performance | `PerformanceMonitor` | Core Web Vitals monitoring |
+
+### Security
+
+| Module    | Key Classes        | Description               |
+| --------- | ------------------ | ------------------------- |
+| csp       | `CspDetector`      | CSP detection and helpers |
+| sanitize  | `HtmlSanitizer`    | HTML sanitization         |
+| clipboard | `ClipboardManager` | Secure clipboard access   |
+
+### Utility
+
+| Module       | Key Classes                              | Description                 |
+| ------------ | ---------------------------------------- | --------------------------- |
+| logging      | `Logger`                                 | Console logging with levels |
+| notification | `NotificationManager`                    | Browser notifications       |
+| download     | `FileDownload`                           | File download triggers      |
+| a11y         | `AriaUtils`, `LiveAnnouncer`, `SkipLink` | Accessibility utilities     |
+| core         | `Result`, `Validator`, `debounce`        | Types, errors, validation   |
+
+## Requirements
+
+- **Node.js** >= 20
+- **ESM-only** — cannot be `require()`'d from CommonJS
+
+## Installation
+
+```bash
+npm install @zappzarapp/browser-utils
+# or
+pnpm add @zappzarapp/browser-utils
+```
+
+## Quick Start
+
+### Storage Manager
+
+```typescript
+import { StorageManager } from '@zappzarapp/browser-utils/storage';
+
+interface UserData {
+  id: string;
+  name: string;
+}
+
+const storage = StorageManager.create<UserData>({
+  prefix: 'myApp',
+  maxEntries: 100,
+});
+
+storage.set('user-1', { id: '1', name: 'Alice' });
+const user = storage.get('user-1');
+```
+
+### Keyboard Shortcuts
+
+```typescript
+import { ShortcutManager } from '@zappzarapp/browser-utils/keyboard';
+
+const shortcuts = ShortcutManager.create();
+
+shortcuts.register({
+  key: 's',
+  ctrlKey: true,
+  handler: () => saveDocument(),
+});
+
+shortcuts.destroy();
+```
+
+### Network Retry Queue
+
+```typescript
+import { RetryQueue } from '@zappzarapp/browser-utils/network';
+
+const queue = RetryQueue.create({
+  maxRetries: 3,
+  backoffStrategy: 'exponential',
+  networkAware: true,
+});
+
+const result = await queue.add({
+  operation: () => fetch('/api/data').then((r) => r.json()),
+});
+```
+
+### Lazy Loading with Observers
+
+```typescript
+import { IntersectionObserverWrapper } from '@zappzarapp/browser-utils/observe';
+
+const cleanup = IntersectionObserverWrapper.lazyLoad(
+  document.querySelectorAll('img[data-src]'),
+  (img) => {
+    img.src = img.dataset.src!;
+  }
+);
+```
+
+## Documentation
+
+| Module                                      | Module                                        |
+| ------------------------------------------- | --------------------------------------------- |
+| [a11y](documentation/a11y.md)               | [keyboard](documentation/keyboard.md)         |
+| [broadcast](documentation/broadcast.md)     | [logging](documentation/logging.md)           |
+| [cache](documentation/cache.md)             | [media](documentation/media.md)               |
+| [clipboard](documentation/clipboard.md)     | [network](documentation/network.md)           |
+| [cookie](documentation/cookie.md)           | [notification](documentation/notification.md) |
+| [core](documentation/core.md)               | [observe](documentation/observe.md)           |
+| [csp](documentation/csp.md)                 | [offline](documentation/offline.md)           |
+| [device](documentation/device.md)           | [performance](documentation/performance.md)   |
+| [download](documentation/download.md)       | [request](documentation/request.md)           |
+| [encryption](documentation/encryption.md)   | [sanitize](documentation/sanitize.md)         |
+| [events](documentation/events.md)           | [scroll](documentation/scroll.md)             |
+| [features](documentation/features.md)       | [session](documentation/session.md)           |
+| [focus](documentation/focus.md)             | [storage](documentation/storage.md)           |
+| [form](documentation/form.md)               | [url](documentation/url.md)                   |
+| [fullscreen](documentation/fullscreen.md)   | [visibility](documentation/visibility.md)     |
+| [geolocation](documentation/geolocation.md) | [websocket](documentation/websocket.md)       |
+| [idle](documentation/idle.md)               | [glossary](documentation/glossary.md)         |
+
+**Guides:** [Browser Support](documentation/browser-support.md) ·
+[Error Handling](documentation/error-handling.md) ·
+[Security Guide](documentation/security-guide.md)
+
+Generate API docs locally with `pnpm run docs`.
+
+## Versioning
+
+This project follows [Semantic Versioning](https://semver.org/).
+
+## Security
+
+See [SECURITY.md](./SECURITY.md) for vulnerability disclosure policy and
+supported versions.
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+
+MIT

package/dist/a11y/AriaUtils.d.ts

@@ -0,0 +1,11 @@
+export declare const AriaUtils: {
+    readonly set: (element: Element, attribute: string, value: string) => void;
+    readonly get: (element: Element, attribute: string) => string | null;
+    readonly remove: (element: Element, attribute: string) => void;
+    readonly toggle: (element: Element, attribute: string) => string;
+    readonly setRole: (element: Element, role: string) => void;
+    readonly getRole: (element: Element) => string | null;
+    readonly removeRole: (element: Element) => void;
+    readonly validateAttribute: (attribute: string) => void;
+};
+//# sourceMappingURL=AriaUtils.d.ts.map

package/dist/a11y/AriaUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AriaUtils.d.ts","sourceRoot":"","sources":["../../src/a11y/AriaUtils.ts"],"names":[],"mappings":"AA4KA,eAAO,MAAM,SAAS;4BASP,OAAO,aAAa,MAAM,SAAS,MAAM,KAAG,IAAI;4BAahD,OAAO,aAAa,MAAM,KAAG,MAAM,GAAG,IAAI;+BAYvC,OAAO,aAAa,MAAM,KAAG,IAAI;+BAejC,OAAO,aAAa,MAAM,KAAG,MAAM;gCAelC,OAAO,QAAQ,MAAM,KAAG,IAAI;gCAa5B,OAAO,KAAG,MAAM,GAAG,IAAI;mCASpB,OAAO,KAAG,IAAI;4CAWL,MAAM,KAAG,IAAI;CAalC,CAAC"}

package/dist/a11y/AriaUtils.js

@@ -0,0 +1,179 @@
+import { ValidationError } from '../core';
+const VALID_ARIA_ATTRIBUTES = new Set([
+    'activedescendant',
+    'atomic',
+    'autocomplete',
+    'braillelabel',
+    'brailleroledescription',
+    'busy',
+    'checked',
+    'colcount',
+    'colindex',
+    'colindextext',
+    'colspan',
+    'controls',
+    'current',
+    'describedby',
+    'description',
+    'details',
+    'disabled',
+    'errormessage',
+    'expanded',
+    'flowto',
+    'haspopup',
+    'hidden',
+    'invalid',
+    'keyshortcuts',
+    'label',
+    'labelledby',
+    'level',
+    'live',
+    'modal',
+    'multiline',
+    'multiselectable',
+    'orientation',
+    'owns',
+    'placeholder',
+    'posinset',
+    'pressed',
+    'readonly',
+    'relevant',
+    'required',
+    'roledescription',
+    'rowcount',
+    'rowindex',
+    'rowindextext',
+    'rowspan',
+    'selected',
+    'setsize',
+    'sort',
+    'valuemax',
+    'valuemin',
+    'valuenow',
+    'valuetext',
+]);
+const VALID_ROLES = new Set([
+    'alert',
+    'alertdialog',
+    'application',
+    'article',
+    'banner',
+    'blockquote',
+    'button',
+    'caption',
+    'cell',
+    'checkbox',
+    'code',
+    'columnheader',
+    'combobox',
+    'comment',
+    'complementary',
+    'contentinfo',
+    'definition',
+    'deletion',
+    'dialog',
+    'directory',
+    'document',
+    'emphasis',
+    'feed',
+    'figure',
+    'form',
+    'generic',
+    'grid',
+    'gridcell',
+    'group',
+    'heading',
+    'img',
+    'insertion',
+    'link',
+    'list',
+    'listbox',
+    'listitem',
+    'log',
+    'main',
+    'mark',
+    'marquee',
+    'math',
+    'menu',
+    'menubar',
+    'menuitem',
+    'menuitemcheckbox',
+    'menuitemradio',
+    'meter',
+    'navigation',
+    'none',
+    'note',
+    'option',
+    'paragraph',
+    'presentation',
+    'progressbar',
+    'radio',
+    'radiogroup',
+    'region',
+    'row',
+    'rowgroup',
+    'rowheader',
+    'scrollbar',
+    'search',
+    'searchbox',
+    'separator',
+    'slider',
+    'spinbutton',
+    'status',
+    'strong',
+    'subscript',
+    'superscript',
+    'switch',
+    'tab',
+    'table',
+    'tablist',
+    'tabpanel',
+    'term',
+    'textbox',
+    'time',
+    'timer',
+    'toolbar',
+    'tooltip',
+    'tree',
+    'treegrid',
+    'treeitem',
+]);
+export const AriaUtils = {
+    set(element, attribute, value) {
+        AriaUtils.validateAttribute(attribute);
+        element.setAttribute(`aria-${attribute}`, value);
+    },
+    get(element, attribute) {
+        AriaUtils.validateAttribute(attribute);
+        return element.getAttribute(`aria-${attribute}`);
+    },
+    remove(element, attribute) {
+        AriaUtils.validateAttribute(attribute);
+        element.removeAttribute(`aria-${attribute}`);
+    },
+    toggle(element, attribute) {
+        AriaUtils.validateAttribute(attribute);
+        const current = element.getAttribute(`aria-${attribute}`);
+        const newValue = current === 'true' ? 'false' : 'true';
+        element.setAttribute(`aria-${attribute}`, newValue);
+        return newValue;
+    },
+    setRole(element, role) {
+        if (!VALID_ROLES.has(role)) {
+            throw ValidationError.invalidFormat('role', role, 'a valid ARIA role');
+        }
+        element.setAttribute('role', role);
+    },
+    getRole(element) {
+        return element.getAttribute('role');
+    },
+    removeRole(element) {
+        element.removeAttribute('role');
+    },
+    validateAttribute(attribute) {
+        if (!VALID_ARIA_ATTRIBUTES.has(attribute)) {
+            throw ValidationError.invalidFormat('aria-attribute', attribute, 'a valid ARIA attribute name (without aria- prefix)');
+        }
+    },
+};
+//# sourceMappingURL=AriaUtils.js.map

package/dist/a11y/AriaUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AriaUtils.js","sourceRoot":"","sources":["../../src/a11y/AriaUtils.ts"],"names":[],"mappings":"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"}

package/dist/a11y/LiveAnnouncer.d.ts

@@ -0,0 +1,10 @@
+export type LivePoliteness = 'polite' | 'assertive';
+export interface LiveAnnouncerInstance {
+    announce(message: string, politeness?: LivePoliteness): void;
+    clear(): void;
+    destroy(): void;
+}
+export declare const LiveAnnouncer: {
+    readonly create: () => LiveAnnouncerInstance;
+};
+//# sourceMappingURL=LiveAnnouncer.d.ts.map

package/dist/a11y/LiveAnnouncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveAnnouncer.d.ts","sourceRoot":"","sources":["../../src/a11y/LiveAnnouncer.ts"],"names":[],"mappings":"AAyBA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAC;AAKpD,MAAM,WAAW,qBAAqB;IAOpC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAK7D,KAAK,IAAI,IAAI,CAAC;IAKd,OAAO,IAAI,IAAI,CAAC;CACjB;AAOD,eAAO,MAAM,aAAa;2BAQd,qBAAqB;CAoCvB,CAAC"}

package/dist/a11y/LiveAnnouncer.js

@@ -0,0 +1,54 @@
+const ANNOUNCE_DELAY_MS = 100;
+export const LiveAnnouncer = {
+    create() {
+        const politeRegion = createLiveRegion('polite');
+        const assertiveRegion = createLiveRegion('assertive');
+        let destroyed = false;
+        return {
+            announce(message, politeness = 'polite') {
+                if (destroyed)
+                    return;
+                const region = politeness === 'assertive' ? assertiveRegion : politeRegion;
+                region.textContent = '';
+                setTimeout(() => {
+                    if (!destroyed) {
+                        region.textContent = message;
+                    }
+                }, ANNOUNCE_DELAY_MS);
+            },
+            clear() {
+                if (destroyed)
+                    return;
+                politeRegion.textContent = '';
+                assertiveRegion.textContent = '';
+            },
+            destroy() {
+                if (destroyed)
+                    return;
+                destroyed = true;
+                politeRegion.remove();
+                assertiveRegion.remove();
+            },
+        };
+    },
+};
+function createLiveRegion(politeness) {
+    const element = document.createElement('div');
+    element.setAttribute('aria-live', politeness);
+    element.setAttribute('aria-atomic', 'true');
+    element.setAttribute('role', 'status');
+    Object.assign(element.style, {
+        position: 'absolute',
+        width: '1px',
+        height: '1px',
+        padding: '0',
+        margin: '-1px',
+        overflow: 'hidden',
+        clip: 'rect(0, 0, 0, 0)',
+        whiteSpace: 'nowrap',
+        border: '0',
+    });
+    document.body.appendChild(element);
+    return element;
+}
+//# sourceMappingURL=LiveAnnouncer.js.map

package/dist/a11y/LiveAnnouncer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveAnnouncer.js","sourceRoot":"","sources":["../../src/a11y/LiveAnnouncer.ts"],"names":[],"mappings":"AAqDA,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,MAAM,CAAC,MAAM,aAAa,GAAG;IAQ3B,MAAM;QACJ,MAAM,YAAY,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,eAAe,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAEtD,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,OAAO;YACL,QAAQ,CAAC,OAAe,EAAE,aAA6B,QAAQ;gBAC7D,IAAI,SAAS;oBAAE,OAAO;gBAEtB,MAAM,MAAM,GAAG,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC;gBAI3E,MAAM,CAAC,WAAW,GAAG,EAAE,CAAC;gBACxB,UAAU,CAAC,GAAG,EAAE;oBACd,IAAI,CAAC,SAAS,EAAE,CAAC;wBACf,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC;oBAC/B,CAAC;gBACH,CAAC,EAAE,iBAAiB,CAAC,CAAC;YACxB,CAAC;YAED,KAAK;gBACH,IAAI,SAAS;oBAAE,OAAO;gBACtB,YAAY,CAAC,WAAW,GAAG,EAAE,CAAC;gBAC9B,eAAe,CAAC,WAAW,GAAG,EAAE,CAAC;YACnC,CAAC;YAED,OAAO;gBACL,IAAI,SAAS;oBAAE,OAAO;gBACtB,SAAS,GAAG,IAAI,CAAC;gBACjB,YAAY,CAAC,MAAM,EAAE,CAAC;gBACtB,eAAe,CAAC,MAAM,EAAE,CAAC;YAC3B,CAAC;SACF,CAAC;IACJ,CAAC;CACO,CAAC;AAKX,SAAS,gBAAgB,CAAC,UAA0B;IAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC9C,OAAO,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAGvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE;QAC3B,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,GAAG;QACZ,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,kBAAkB;QACxB,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,GAAG;KACZ,CAAC,CAAC;IAEH,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/a11y/ReducedMotion.d.ts

@@ -0,0 +1,6 @@
+import type { CleanupFn } from '../core';
+export declare const ReducedMotion: {
+    readonly isReduced: () => boolean;
+    readonly onChange: (handler: (reduced: boolean) => void) => CleanupFn;
+};
+//# sourceMappingURL=ReducedMotion.d.ts.map

package/dist/a11y/ReducedMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReducedMotion.d.ts","sourceRoot":"","sources":["../../src/a11y/ReducedMotion.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAKzC,eAAO,MAAM,aAAa;8BAMX,OAAO;iCAaF,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,KAAG,SAAS;CAgBhD,CAAC"}

package/dist/a11y/ReducedMotion.js

@@ -0,0 +1,23 @@
+const MEDIA_QUERY = '(prefers-reduced-motion: reduce)';
+export const ReducedMotion = {
+    isReduced() {
+        if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') {
+            return false;
+        }
+        return window.matchMedia(MEDIA_QUERY).matches;
+    },
+    onChange(handler) {
+        if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') {
+            return () => { };
+        }
+        const mql = window.matchMedia(MEDIA_QUERY);
+        const listener = (event) => {
+            handler(event.matches);
+        };
+        mql.addEventListener('change', listener);
+        return () => {
+            mql.removeEventListener('change', listener);
+        };
+    },
+};
+//# sourceMappingURL=ReducedMotion.js.map

package/dist/a11y/ReducedMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReducedMotion.js","sourceRoot":"","sources":["../../src/a11y/ReducedMotion.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,GAAG,kCAAkC,CAAC;AAGvD,MAAM,CAAC,MAAM,aAAa,GAAG;IAM3B,SAAS;QACP,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YAC7E,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;IAChD,CAAC;IAQD,QAAQ,CAAC,OAAmC;QAC1C,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YAC7E,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,CAAC,KAA0B,EAAQ,EAAE;YACpD,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEzC,OAAO,GAAG,EAAE;YACV,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC;IACJ,CAAC;CACO,CAAC"}

package/dist/a11y/SkipLink.d.ts

@@ -0,0 +1,10 @@
+import type { CleanupFn } from '../core';
+export interface SkipLinkConfig {
+    readonly targetId: string;
+    readonly text?: string;
+    readonly className?: string;
+}
+export declare const SkipLink: {
+    readonly create: (config: SkipLinkConfig) => CleanupFn;
+};
+//# sourceMappingURL=SkipLink.d.ts.map

package/dist/a11y/SkipLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkipLink.d.ts","sourceRoot":"","sources":["../../src/a11y/SkipLink.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMzC,MAAM,WAAW,cAAc;IAI7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAM1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAMvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,QAAQ;8BAWJ,cAAc,KAAG,SAAS;CAiFjC,CAAC"}

package/dist/a11y/SkipLink.js

@@ -0,0 +1,73 @@
+import { ValidationError } from '../core';
+export const SkipLink = {
+    create(config) {
+        if (!config.targetId) {
+            throw ValidationError.empty('targetId');
+        }
+        const text = config.text ?? 'Skip to main content';
+        const link = document.createElement('a');
+        link.href = `#${config.targetId}`;
+        link.textContent = text;
+        if (config.className !== undefined && config.className !== '') {
+            link.className = config.className;
+        }
+        else {
+            Object.assign(link.style, {
+                position: 'absolute',
+                left: '-9999px',
+                top: 'auto',
+                width: '1px',
+                height: '1px',
+                overflow: 'hidden',
+                zIndex: '999999',
+            });
+            link.addEventListener('focus', () => {
+                Object.assign(link.style, {
+                    position: 'fixed',
+                    left: '8px',
+                    top: '8px',
+                    width: 'auto',
+                    height: 'auto',
+                    overflow: 'visible',
+                    padding: '8px 16px',
+                    background: '#000',
+                    color: '#fff',
+                    textDecoration: 'none',
+                    fontSize: '14px',
+                    borderRadius: '4px',
+                });
+            });
+            link.addEventListener('blur', () => {
+                Object.assign(link.style, {
+                    position: 'absolute',
+                    left: '-9999px',
+                    top: 'auto',
+                    width: '1px',
+                    height: '1px',
+                    overflow: 'hidden',
+                    padding: '0',
+                    background: '',
+                    color: '',
+                    textDecoration: '',
+                    fontSize: '',
+                    borderRadius: '',
+                });
+            });
+        }
+        link.addEventListener('click', (event) => {
+            event.preventDefault();
+            const target = document.getElementById(config.targetId);
+            if (target) {
+                if (!target.hasAttribute('tabindex')) {
+                    target.setAttribute('tabindex', '-1');
+                }
+                target.focus();
+            }
+        });
+        document.body.insertBefore(link, document.body.firstChild);
+        return () => {
+            link.remove();
+        };
+    },
+};
+//# sourceMappingURL=SkipLink.js.map

package/dist/a11y/SkipLink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkipLink.js","sourceRoot":"","sources":["../../src/a11y/SkipLink.ts"],"names":[],"mappings":"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"}

package/dist/a11y/index.d.ts

@@ -0,0 +1,7 @@
+export { AriaUtils } from './AriaUtils.js';
+export { LiveAnnouncer } from './LiveAnnouncer.js';
+export type { LivePoliteness, LiveAnnouncerInstance } from './LiveAnnouncer.js';
+export { ReducedMotion } from './ReducedMotion.js';
+export { SkipLink } from './SkipLink.js';
+export type { SkipLinkConfig } from './SkipLink.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/a11y/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/a11y/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}