@sc4rfurryx/proteusjs 1.0.0 → 1.1.0

package/dist/modules/a11y-primitives.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @sc4rfurryx/proteusjs/a11y-primitives
+ * Headless accessibility patterns (no styles)
+ *
+ * @version 1.1.0
+ * @author sc4rfurry
+ * @license MIT
+ */
+interface Controller {
+    destroy(): void;
+}
+interface DialogOptions {
+    modal?: boolean;
+    restoreFocus?: boolean;
+}
+interface TooltipOptions {
+    delay?: number;
+}
+interface ComboboxOptions {
+    multiselect?: boolean;
+    filtering?: (query: string) => Promise<unknown[]> | unknown[];
+}
+interface ListboxOptions {
+    multiselect?: boolean;
+}
+interface FocusTrapController {
+    activate(): void;
+    deactivate(): void;
+}
+/**
+ * Dialog primitive with proper ARIA and focus management
+ */
+declare function dialog(root: Element | string, opts?: DialogOptions): Controller;
+/**
+ * Tooltip primitive with delay and proper ARIA
+ */
+declare function tooltip(trigger: Element | string, panel: Element | string, opts?: TooltipOptions): Controller;
+/**
+ * Listbox primitive with keyboard navigation
+ */
+declare function listbox(root: Element | string, opts?: ListboxOptions): Controller;
+/**
+ * Combobox primitive with filtering and multiselect
+ */
+declare function combobox(root: Element | string, opts?: ComboboxOptions): Controller;
+/**
+ * Tabs primitive with keyboard navigation
+ */
+declare function tabs(root: Element | string): Controller;
+/**
+ * Menu primitive with keyboard navigation
+ */
+declare function menu(root: Element | string): Controller;
+/**
+ * Focus trap utility
+ */
+declare function focusTrap(root: Element | string): FocusTrapController;
+declare const _default: {
+    dialog: typeof dialog;
+    tooltip: typeof tooltip;
+    combobox: typeof combobox;
+    listbox: typeof listbox;
+    tabs: typeof tabs;
+    menu: typeof menu;
+    focusTrap: typeof focusTrap;
+};
+
+export { combobox, _default as default, dialog, focusTrap, listbox, menu, tabs, tooltip };
+export type { ComboboxOptions, Controller, DialogOptions, FocusTrapController, ListboxOptions, TooltipOptions };

package/dist/modules/a11y-primitives.esm.js

@@ -0,0 +1,445 @@
+/*!
+ * ProteusJS v1.1.0
+ * Shape-shifting responsive design that adapts like the sea god himself
+ * (c) 2025 sc4rfurry
+ * Released under the MIT License
+ */
+/**
+ * @sc4rfurryx/proteusjs/a11y-primitives
+ * Headless accessibility patterns (no styles)
+ *
+ * @version 1.1.0
+ * @author sc4rfurry
+ * @license MIT
+ */
+/**
+ * Dialog primitive with proper ARIA and focus management
+ */
+function dialog(root, opts = {}) {
+    const rootEl = typeof root === 'string' ? document.querySelector(root) : root;
+    if (!rootEl)
+        throw new Error('Dialog root element not found');
+    const { modal = true, restoreFocus = true } = opts;
+    let isOpen = false;
+    const setup = () => {
+        rootEl.setAttribute('role', 'dialog');
+        if (modal) {
+            rootEl.setAttribute('aria-modal', 'true');
+        }
+        // Ensure dialog is initially hidden
+        if (!rootEl.hasAttribute('hidden')) {
+            rootEl.setAttribute('hidden', '');
+        }
+    };
+    const handleKeyDown = (e) => {
+        if (e.key === 'Escape' && isOpen) ;
+    };
+    setup();
+    document.addEventListener('keydown', handleKeyDown);
+    return {
+        destroy: () => {
+            document.removeEventListener('keydown', handleKeyDown);
+        }
+    };
+}
+/**
+ * Tooltip primitive with delay and proper ARIA
+ */
+function tooltip(trigger, panel, opts = {}) {
+    const triggerEl = typeof trigger === 'string' ? document.querySelector(trigger) : trigger;
+    const panelEl = typeof panel === 'string' ? document.querySelector(panel) : panel;
+    if (!triggerEl || !panelEl) {
+        throw new Error('Both trigger and panel elements must exist');
+    }
+    const { delay = 500 } = opts;
+    let timeoutId = null;
+    let isVisible = false;
+    const setup = () => {
+        const tooltipId = panelEl.id || `tooltip-${Math.random().toString(36).substring(2, 11)}`;
+        panelEl.id = tooltipId;
+        panelEl.setAttribute('role', 'tooltip');
+        triggerEl.setAttribute('aria-describedby', tooltipId);
+        // Initially hidden
+        panelEl.style.display = 'none';
+    };
+    const show = () => {
+        if (isVisible)
+            return;
+        panelEl.style.display = 'block';
+        isVisible = true;
+    };
+    const hide = () => {
+        if (!isVisible)
+            return;
+        panelEl.style.display = 'none';
+        isVisible = false;
+    };
+    const handleMouseEnter = () => {
+        if (timeoutId)
+            clearTimeout(timeoutId);
+        timeoutId = window.setTimeout(show, delay);
+    };
+    const handleMouseLeave = () => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+        hide();
+    };
+    const handleFocus = () => {
+        show();
+    };
+    const handleBlur = () => {
+        hide();
+    };
+    setup();
+    triggerEl.addEventListener('mouseenter', handleMouseEnter);
+    triggerEl.addEventListener('mouseleave', handleMouseLeave);
+    triggerEl.addEventListener('focus', handleFocus);
+    triggerEl.addEventListener('blur', handleBlur);
+    return {
+        destroy: () => {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            triggerEl.removeEventListener('mouseenter', handleMouseEnter);
+            triggerEl.removeEventListener('mouseleave', handleMouseLeave);
+            triggerEl.removeEventListener('focus', handleFocus);
+            triggerEl.removeEventListener('blur', handleBlur);
+            hide();
+        }
+    };
+}
+/**
+ * Listbox primitive with keyboard navigation
+ */
+function listbox(root, opts = {}) {
+    const rootEl = typeof root === 'string' ? document.querySelector(root) : root;
+    if (!rootEl)
+        throw new Error('Listbox root element not found');
+    const { multiselect = false } = opts;
+    let currentIndex = -1;
+    const setup = () => {
+        rootEl.setAttribute('role', 'listbox');
+        if (multiselect) {
+            rootEl.setAttribute('aria-multiselectable', 'true');
+        }
+        // Set up options
+        const options = rootEl.querySelectorAll('[role="option"]');
+        options.forEach((option, _index) => {
+            option.setAttribute('aria-selected', 'false');
+            option.setAttribute('tabindex', '-1');
+        });
+        if (options.length > 0) {
+            options[0]?.setAttribute('tabindex', '0');
+            currentIndex = 0;
+        }
+    };
+    const getOptions = () => rootEl.querySelectorAll('[role="option"]');
+    const setCurrentIndex = (index) => {
+        const options = getOptions();
+        if (index < 0 || index >= options.length)
+            return;
+        // Remove tabindex from all options
+        options.forEach(option => option.setAttribute('tabindex', '-1'));
+        // Set current option
+        currentIndex = index;
+        options[currentIndex]?.setAttribute('tabindex', '0');
+        options[currentIndex]?.focus();
+    };
+    const selectOption = (index) => {
+        const options = getOptions();
+        if (index < 0 || index >= options.length)
+            return;
+        if (multiselect) {
+            const isSelected = options[index]?.getAttribute('aria-selected') === 'true';
+            options[index]?.setAttribute('aria-selected', (!isSelected).toString());
+        }
+        else {
+            // Single select - clear all others
+            options.forEach(option => option.setAttribute('aria-selected', 'false'));
+            options[index]?.setAttribute('aria-selected', 'true');
+        }
+    };
+    const handleKeyDown = (e) => {
+        const keyEvent = e;
+        const options = getOptions();
+        switch (keyEvent.key) {
+            case 'ArrowDown':
+                keyEvent.preventDefault();
+                setCurrentIndex(Math.min(currentIndex + 1, options.length - 1));
+                break;
+            case 'ArrowUp':
+                keyEvent.preventDefault();
+                setCurrentIndex(Math.max(currentIndex - 1, 0));
+                break;
+            case 'Home':
+                keyEvent.preventDefault();
+                setCurrentIndex(0);
+                break;
+            case 'End':
+                keyEvent.preventDefault();
+                setCurrentIndex(options.length - 1);
+                break;
+            case 'Enter':
+            case ' ':
+                keyEvent.preventDefault();
+                selectOption(currentIndex);
+                break;
+        }
+    };
+    const handleClick = (e) => {
+        const target = e.target;
+        const option = target.closest('[role="option"]');
+        if (!option)
+            return;
+        const options = Array.from(getOptions());
+        const index = options.indexOf(option);
+        if (index >= 0) {
+            setCurrentIndex(index);
+            selectOption(index);
+        }
+    };
+    setup();
+    rootEl.addEventListener('keydown', handleKeyDown);
+    rootEl.addEventListener('click', handleClick);
+    return {
+        destroy: () => {
+            rootEl.removeEventListener('keydown', handleKeyDown);
+            rootEl.removeEventListener('click', handleClick);
+        }
+    };
+}
+/**
+ * Combobox primitive with filtering and multiselect
+ */
+function combobox(root, opts = {}) {
+    const rootEl = typeof root === 'string' ? document.querySelector(root) : root;
+    if (!rootEl)
+        throw new Error('Combobox root element not found');
+    const { multiselect = false, filtering: _filtering } = opts;
+    let isOpen = false;
+    const setup = () => {
+        rootEl.setAttribute('role', 'combobox');
+        rootEl.setAttribute('aria-expanded', 'false');
+        if (multiselect) {
+            rootEl.setAttribute('aria-multiselectable', 'true');
+        }
+    };
+    const handleKeyDown = (e) => {
+        const keyEvent = e;
+        switch (keyEvent.key) {
+            case 'ArrowDown':
+                keyEvent.preventDefault();
+                if (!isOpen) {
+                    isOpen = true;
+                    rootEl.setAttribute('aria-expanded', 'true');
+                }
+                // Navigate options logic would go here
+                break;
+            case 'Escape':
+                keyEvent.preventDefault();
+                isOpen = false;
+                rootEl.setAttribute('aria-expanded', 'false');
+                break;
+        }
+    };
+    setup();
+    rootEl.addEventListener('keydown', handleKeyDown);
+    return {
+        destroy: () => {
+            rootEl.removeEventListener('keydown', handleKeyDown);
+        }
+    };
+}
+/**
+ * Tabs primitive with keyboard navigation
+ */
+function tabs(root) {
+    const rootEl = typeof root === 'string' ? document.querySelector(root) : root;
+    if (!rootEl)
+        throw new Error('Tabs root element not found');
+    let currentIndex = 0;
+    const setup = () => {
+        const tabList = rootEl.querySelector('[role="tablist"]');
+        const tabs = rootEl.querySelectorAll('[role="tab"]');
+        const panels = rootEl.querySelectorAll('[role="tabpanel"]');
+        if (!tabList) {
+            rootEl.setAttribute('role', 'tablist');
+        }
+        tabs.forEach((tab, index) => {
+            tab.setAttribute('tabindex', index === 0 ? '0' : '-1');
+            tab.setAttribute('aria-selected', index === 0 ? 'true' : 'false');
+        });
+        panels.forEach((panel, index) => {
+            panel.setAttribute('hidden', index === 0 ? '' : 'true');
+        });
+    };
+    const handleKeyDown = (e) => {
+        const keyEvent = e;
+        const tabs = Array.from(rootEl.querySelectorAll('[role="tab"]'));
+        switch (keyEvent.key) {
+            case 'ArrowRight':
+                keyEvent.preventDefault();
+                currentIndex = (currentIndex + 1) % tabs.length;
+                activateTab(currentIndex);
+                break;
+            case 'ArrowLeft':
+                keyEvent.preventDefault();
+                currentIndex = currentIndex === 0 ? tabs.length - 1 : currentIndex - 1;
+                activateTab(currentIndex);
+                break;
+        }
+    };
+    const activateTab = (index) => {
+        const tabs = rootEl.querySelectorAll('[role="tab"]');
+        const panels = rootEl.querySelectorAll('[role="tabpanel"]');
+        tabs.forEach((tab, i) => {
+            tab.setAttribute('tabindex', i === index ? '0' : '-1');
+            tab.setAttribute('aria-selected', i === index ? 'true' : 'false');
+            if (i === index) {
+                tab.focus();
+            }
+        });
+        panels.forEach((panel, i) => {
+            if (i === index) {
+                panel.removeAttribute('hidden');
+            }
+            else {
+                panel.setAttribute('hidden', 'true');
+            }
+        });
+    };
+    setup();
+    rootEl.addEventListener('keydown', handleKeyDown);
+    return {
+        destroy: () => {
+            rootEl.removeEventListener('keydown', handleKeyDown);
+        }
+    };
+}
+/**
+ * Menu primitive with keyboard navigation
+ */
+function menu(root) {
+    const rootEl = typeof root === 'string' ? document.querySelector(root) : root;
+    if (!rootEl)
+        throw new Error('Menu root element not found');
+    let currentIndex = -1;
+    const setup = () => {
+        rootEl.setAttribute('role', 'menu');
+        const items = rootEl.querySelectorAll('[role="menuitem"]');
+        items.forEach((item, index) => {
+            item.setAttribute('tabindex', index === 0 ? '0' : '-1');
+        });
+        if (items.length > 0) {
+            currentIndex = 0;
+        }
+    };
+    const handleKeyDown = (e) => {
+        const keyEvent = e;
+        const items = Array.from(rootEl.querySelectorAll('[role="menuitem"]'));
+        switch (keyEvent.key) {
+            case 'ArrowDown':
+                keyEvent.preventDefault();
+                currentIndex = (currentIndex + 1) % items.length;
+                setCurrentItem(currentIndex);
+                break;
+            case 'ArrowUp':
+                keyEvent.preventDefault();
+                currentIndex = currentIndex === 0 ? items.length - 1 : currentIndex - 1;
+                setCurrentItem(currentIndex);
+                break;
+            case 'Enter':
+            case ' ':
+                keyEvent.preventDefault();
+                if (items[currentIndex]) {
+                    items[currentIndex].click();
+                }
+                break;
+        }
+    };
+    const setCurrentItem = (index) => {
+        const items = rootEl.querySelectorAll('[role="menuitem"]');
+        items.forEach((item, i) => {
+            item.setAttribute('tabindex', i === index ? '0' : '-1');
+            if (i === index) {
+                item.focus();
+            }
+        });
+    };
+    setup();
+    rootEl.addEventListener('keydown', handleKeyDown);
+    return {
+        destroy: () => {
+            rootEl.removeEventListener('keydown', handleKeyDown);
+        }
+    };
+}
+/**
+ * Focus trap utility
+ */
+function focusTrap(root) {
+    const rootEl = typeof root === 'string' ? document.querySelector(root) : root;
+    if (!rootEl)
+        throw new Error('Focus trap root element not found');
+    let isActive = false;
+    let focusableElements = [];
+    const updateFocusableElements = () => {
+        const selector = 'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])';
+        focusableElements = Array.from(rootEl.querySelectorAll(selector));
+    };
+    const handleKeyDown = (e) => {
+        if (!isActive || e.key !== 'Tab')
+            return;
+        updateFocusableElements();
+        if (focusableElements.length === 0)
+            return;
+        const firstElement = focusableElements[0];
+        const lastElement = focusableElements[focusableElements.length - 1];
+        if (e.shiftKey) {
+            if (document.activeElement === firstElement) {
+                e.preventDefault();
+                lastElement.focus();
+            }
+        }
+        else {
+            if (document.activeElement === lastElement) {
+                e.preventDefault();
+                firstElement.focus();
+            }
+        }
+    };
+    const activate = () => {
+        if (isActive)
+            return;
+        isActive = true;
+        updateFocusableElements();
+        if (focusableElements.length > 0) {
+            focusableElements[0].focus();
+        }
+        document.addEventListener('keydown', handleKeyDown);
+    };
+    const deactivate = () => {
+        if (!isActive)
+            return;
+        isActive = false;
+        document.removeEventListener('keydown', handleKeyDown);
+    };
+    return {
+        activate,
+        deactivate
+    };
+}
+// Export all functions
+var index = {
+    dialog,
+    tooltip,
+    combobox,
+    listbox,
+    tabs,
+    menu,
+    focusTrap
+};
+
+export { combobox, index as default, dialog, focusTrap, listbox, menu, tabs, tooltip };
+//# sourceMappingURL=a11y-primitives.esm.js.map

package/dist/modules/a11y-primitives.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-primitives.esm.js","sources":["../../src/modules/a11y-primitives/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/modules/anchor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @sc4rfurryx/proteusjs/anchor
+ * CSS Anchor Positioning utilities with robust JS fallback
+ *
+ * @version 1.1.0
+ * @author sc4rfurry
+ * @license MIT
+ */
+interface TetherOptions {
+    anchor: Element | string;
+    placement?: 'top' | 'bottom' | 'left' | 'right' | 'auto';
+    align?: 'start' | 'center' | 'end';
+    offset?: number;
+    strategy?: 'absolute' | 'fixed';
+}
+interface TetherController {
+    destroy(): void;
+}
+/**
+ * Declarative tethers (tooltips, callouts) via CSS Anchor Positioning when available;
+ * robust JS fallback with flip/collision detection
+ */
+declare function tether(floating: Element | string, opts: TetherOptions): TetherController;
+declare const _default: {
+    tether: typeof tether;
+};
+
+export { _default as default, tether };
+export type { TetherController, TetherOptions };