@elvora/core 1.0.0-rc.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Elvora UI Contributors
+
+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,24 @@
+# @elvora/core
+
+Framework-agnostic primitives, state machines, accessibility logic, and shared types powering [Elvora UI](https://github.com/elvora-ui/elvora)'s React, React Native, Angular, Vue, and Svelte adapters.
+
+## What's inside
+
+- **State hooks (React)**: `useControllableState`, `useFocusTrap`, `useDismissable`, `usePortal`, `useId`.
+- **State machines**: `getButtonStyle`, `getNextTabIndex`, focus/keyboard navigation helpers.
+- **Shared types**: `ElvoraTheme`, `ElvoraSize`, `ElvoraVariant`, `ElvoraStatus`, `ElvoraTone`, `Direction`, `Placement`, `Orientation`, etc.
+- **Default props**: `defaultButtonProps`, etc.
+
+You probably don't need to install this directly — every framework adapter
+depends on it. Install it only if you want to build your own adapter or
+consume the headless logic in a custom renderer.
+
+## Install
+
+```bash
+pnpm add @elvora/core
+```
+
+## License
+
+MIT

package/dist/chunk-VFHCOPTO.js

@@ -0,0 +1,127 @@
+// src/focus/focusable.ts
+var FOCUSABLE_SELECTORS = [
+  "a[href]",
+  "area[href]",
+  "button:not([disabled])",
+  'input:not([disabled]):not([type="hidden"])',
+  "select:not([disabled])",
+  "textarea:not([disabled])",
+  "iframe",
+  "object",
+  "embed",
+  "audio[controls]",
+  "video[controls]",
+  '[contenteditable]:not([contenteditable="false"])',
+  '[tabindex]:not([tabindex^="-"])'
+];
+var FOCUSABLE_SELECTOR = FOCUSABLE_SELECTORS.join(", ");
+function isElementVisible(el) {
+  if (el.hidden) return false;
+  const style = el.ownerDocument.defaultView?.getComputedStyle(el);
+  if (!style) return true;
+  return style.visibility !== "hidden" && style.display !== "none";
+}
+function isFocusable(el) {
+  if (!el.isConnected) return false;
+  if (el.disabled) return false;
+  if (el.getAttribute("aria-hidden") === "true") return false;
+  if (el.hasAttribute("inert")) return false;
+  if (!isElementVisible(el)) return false;
+  return el.matches(FOCUSABLE_SELECTOR);
+}
+function getFocusableElements(container) {
+  const nodes = Array.from(container.querySelectorAll(FOCUSABLE_SELECTOR));
+  return nodes.filter(isFocusable);
+}
+function getFirstFocusable(container) {
+  return getFocusableElements(container)[0] ?? null;
+}
+function getLastFocusable(container) {
+  const list = getFocusableElements(container);
+  return list[list.length - 1] ?? null;
+}
+
+// src/focus/focusTrap.ts
+function createFocusTrap(container, options = {}) {
+  let active = false;
+  let previouslyFocused = null;
+  function handleKeyDown(event) {
+    if (!active) return;
+    if (event.key === "Escape" && options.onEscape) {
+      options.onEscape(event);
+      return;
+    }
+    if (event.key !== "Tab") return;
+    const first = getFirstFocusable(container);
+    const last = getLastFocusable(container);
+    if (!first || !last) {
+      event.preventDefault();
+      container.focus();
+      return;
+    }
+    const activeEl = container.ownerDocument.activeElement;
+    if (event.shiftKey) {
+      if (activeEl === first || !container.contains(activeEl)) {
+        event.preventDefault();
+        last.focus();
+      }
+    } else {
+      if (activeEl === last) {
+        event.preventDefault();
+        first.focus();
+      }
+    }
+  }
+  function handlePointerDown(event) {
+    if (!active) return;
+    const target = event.target;
+    if (target && !container.contains(target)) {
+      options.onOutsideClick?.(event);
+    }
+  }
+  return {
+    activate() {
+      if (active) return;
+      active = true;
+      previouslyFocused = container.ownerDocument.activeElement ?? null;
+      const target = options.initialFocus ?? getFirstFocusable(container) ?? (isFocusable(container) ? container : null);
+      if (target) {
+        target.focus({ preventScroll: false });
+      } else {
+        container.setAttribute("tabindex", "-1");
+        container.focus({ preventScroll: false });
+      }
+      container.ownerDocument.addEventListener("keydown", handleKeyDown, true);
+      container.ownerDocument.addEventListener("mousedown", handlePointerDown, true);
+      container.ownerDocument.addEventListener("touchstart", handlePointerDown, true);
+    },
+    deactivate() {
+      if (!active) return;
+      active = false;
+      container.ownerDocument.removeEventListener("keydown", handleKeyDown, true);
+      container.ownerDocument.removeEventListener("mousedown", handlePointerDown, true);
+      container.ownerDocument.removeEventListener("touchstart", handlePointerDown, true);
+      const returnTo = options.returnFocus ?? previouslyFocused;
+      if (returnTo && returnTo.isConnected) {
+        returnTo.focus({ preventScroll: false });
+      }
+    },
+    isActive() {
+      return active;
+    }
+  };
+}
+
+// src/id.ts
+var counter = 0;
+function generateId(prefix = "elvora") {
+  if (typeof globalThis !== "undefined" && globalThis.crypto?.randomUUID) {
+    return `${prefix}-${globalThis.crypto.randomUUID().slice(0, 8)}`;
+  }
+  counter = counter + 1 | 0;
+  return `${prefix}-${counter.toString(36)}`;
+}
+
+export { FOCUSABLE_SELECTOR, createFocusTrap, generateId, getFirstFocusable, getFocusableElements, getLastFocusable, isElementVisible, isFocusable };
+//# sourceMappingURL=chunk-VFHCOPTO.js.map
+//# sourceMappingURL=chunk-VFHCOPTO.js.map

package/dist/chunk-VFHCOPTO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/focus/focusable.ts","../src/focus/focusTrap.ts","../src/id.ts"],"names":[],"mappings":"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","file":"chunk-VFHCOPTO.js","sourcesContent":["/**\r\n * Discover and walk focusable elements within a container. Used by focus traps,\r\n * roving-tabindex managers, and keyboard-navigable lists/menus.\r\n *\r\n * Selectors are based on the WAI-ARIA Authoring Practices and the live\r\n * `tabindex`/`disabled`/`inert` semantics of HTML.\r\n */\r\n\r\nconst FOCUSABLE_SELECTORS = [\r\n  'a[href]',\r\n  'area[href]',\r\n  'button:not([disabled])',\r\n  'input:not([disabled]):not([type=\"hidden\"])',\r\n  'select:not([disabled])',\r\n  'textarea:not([disabled])',\r\n  'iframe',\r\n  'object',\r\n  'embed',\r\n  'audio[controls]',\r\n  'video[controls]',\r\n  '[contenteditable]:not([contenteditable=\"false\"])',\r\n  '[tabindex]:not([tabindex^=\"-\"])',\r\n] as const;\r\n\r\nexport const FOCUSABLE_SELECTOR = FOCUSABLE_SELECTORS.join(', ');\r\n\r\nexport function isElementVisible(el: HTMLElement): boolean {\r\n  if (el.hidden) return false;\r\n  const style = el.ownerDocument.defaultView?.getComputedStyle(el);\r\n  if (!style) return true;\r\n  return style.visibility !== 'hidden' && style.display !== 'none';\r\n}\r\n\r\nexport function isFocusable(el: HTMLElement): boolean {\r\n  if (!el.isConnected) return false;\r\n  if ((el as HTMLInputElement).disabled) return false;\r\n  if (el.getAttribute('aria-hidden') === 'true') return false;\r\n  if (el.hasAttribute('inert')) return false;\r\n  if (!isElementVisible(el)) return false;\r\n  return el.matches(FOCUSABLE_SELECTOR);\r\n}\r\n\r\nexport function getFocusableElements(container: HTMLElement): HTMLElement[] {\r\n  const nodes = Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR));\r\n  return nodes.filter(isFocusable);\r\n}\r\n\r\nexport function getFirstFocusable(container: HTMLElement): HTMLElement | null {\r\n  return getFocusableElements(container)[0] ?? null;\r\n}\r\n\r\nexport function getLastFocusable(container: HTMLElement): HTMLElement | null {\r\n  const list = getFocusableElements(container);\r\n  return list[list.length - 1] ?? null;\r\n}\r\n","/**\r\n * Headless focus trap. Pure DOM, no framework dependency.\r\n *\r\n * Adapters call `createFocusTrap(node)` on mount, `trap.activate()` when the\r\n * dialog/menu opens, and `trap.deactivate()` when it closes. The trap is\r\n * compliant with WAI-ARIA APG's modal-dialog pattern.\r\n */\r\nimport { getFirstFocusable, getLastFocusable, isFocusable } from './focusable';\r\n\r\nexport interface FocusTrapOptions {\r\n  /** Element to restore focus to on deactivation. Defaults to the previously active element. */\r\n  returnFocus?: HTMLElement | null;\r\n  /** Initial element to focus. Defaults to first focusable child. */\r\n  initialFocus?: HTMLElement | null;\r\n  /** When true, pressing Escape calls `onEscape`. */\r\n  onEscape?: (event: KeyboardEvent) => void;\r\n  /** Outside clicks call this. Trap does not auto-close on outside click. */\r\n  onOutsideClick?: (event: MouseEvent | TouchEvent) => void;\r\n}\r\n\r\nexport interface FocusTrap {\r\n  activate(): void;\r\n  deactivate(): void;\r\n  isActive(): boolean;\r\n}\r\n\r\nexport function createFocusTrap(container: HTMLElement, options: FocusTrapOptions = {}): FocusTrap {\r\n  let active = false;\r\n  let previouslyFocused: HTMLElement | null = null;\r\n\r\n  function handleKeyDown(event: KeyboardEvent): void {\r\n    if (!active) return;\r\n\r\n    if (event.key === 'Escape' && options.onEscape) {\r\n      options.onEscape(event);\r\n      return;\r\n    }\r\n\r\n    if (event.key !== 'Tab') return;\r\n\r\n    const first = getFirstFocusable(container);\r\n    const last = getLastFocusable(container);\r\n    if (!first || !last) {\r\n      event.preventDefault();\r\n      container.focus();\r\n      return;\r\n    }\r\n\r\n    const activeEl = container.ownerDocument.activeElement as HTMLElement | null;\r\n\r\n    if (event.shiftKey) {\r\n      if (activeEl === first || !container.contains(activeEl)) {\r\n        event.preventDefault();\r\n        last.focus();\r\n      }\r\n    } else {\r\n      if (activeEl === last) {\r\n        event.preventDefault();\r\n        first.focus();\r\n      }\r\n    }\r\n  }\r\n\r\n  function handlePointerDown(event: MouseEvent | TouchEvent): void {\r\n    if (!active) return;\r\n    const target = event.target as Node | null;\r\n    if (target && !container.contains(target)) {\r\n      options.onOutsideClick?.(event);\r\n    }\r\n  }\r\n\r\n  return {\r\n    activate() {\r\n      if (active) return;\r\n      active = true;\r\n      previouslyFocused = (container.ownerDocument.activeElement as HTMLElement) ?? null;\r\n\r\n      const target =\r\n        options.initialFocus ??\r\n        getFirstFocusable(container) ??\r\n        (isFocusable(container) ? container : null);\r\n\r\n      if (target) {\r\n        target.focus({ preventScroll: false });\r\n      } else {\r\n        container.setAttribute('tabindex', '-1');\r\n        container.focus({ preventScroll: false });\r\n      }\r\n\r\n      container.ownerDocument.addEventListener('keydown', handleKeyDown, true);\r\n      container.ownerDocument.addEventListener('mousedown', handlePointerDown, true);\r\n      container.ownerDocument.addEventListener('touchstart', handlePointerDown, true);\r\n    },\r\n    deactivate() {\r\n      if (!active) return;\r\n      active = false;\r\n      container.ownerDocument.removeEventListener('keydown', handleKeyDown, true);\r\n      container.ownerDocument.removeEventListener('mousedown', handlePointerDown, true);\r\n      container.ownerDocument.removeEventListener('touchstart', handlePointerDown, true);\r\n\r\n      const returnTo = options.returnFocus ?? previouslyFocused;\r\n      if (returnTo && returnTo.isConnected) {\r\n        returnTo.focus({ preventScroll: false });\r\n      }\r\n    },\r\n    isActive() {\r\n      return active;\r\n    },\r\n  };\r\n}\r\n","/**\r\n * Tiny, SSR-safe id generator. Prefer crypto.randomUUID when available, fall\r\n * back to a monotonic counter otherwise so generated ids are stable across\r\n * server/client when adapters seed them once.\r\n */\r\n\r\nlet counter = 0;\r\n\r\nexport function generateId(prefix = 'elvora'): string {\r\n  if (typeof globalThis !== 'undefined' && globalThis.crypto?.randomUUID) {\r\n    return `${prefix}-${globalThis.crypto.randomUUID().slice(0, 8)}`;\r\n  }\r\n  counter = (counter + 1) | 0;\r\n  return `${prefix}-${counter.toString(36)}`;\r\n}\r\n"]}

package/dist/focusTrap-Bko1L5FG.d.cts

@@ -0,0 +1,18 @@
+interface FocusTrapOptions {
+    /** Element to restore focus to on deactivation. Defaults to the previously active element. */
+    returnFocus?: HTMLElement | null;
+    /** Initial element to focus. Defaults to first focusable child. */
+    initialFocus?: HTMLElement | null;
+    /** When true, pressing Escape calls `onEscape`. */
+    onEscape?: (event: KeyboardEvent) => void;
+    /** Outside clicks call this. Trap does not auto-close on outside click. */
+    onOutsideClick?: (event: MouseEvent | TouchEvent) => void;
+}
+interface FocusTrap {
+    activate(): void;
+    deactivate(): void;
+    isActive(): boolean;
+}
+declare function createFocusTrap(container: HTMLElement, options?: FocusTrapOptions): FocusTrap;
+
+export { type FocusTrap as F, type FocusTrapOptions as a, createFocusTrap as c };

package/dist/focusTrap-Bko1L5FG.d.ts

@@ -0,0 +1,18 @@
+interface FocusTrapOptions {
+    /** Element to restore focus to on deactivation. Defaults to the previously active element. */
+    returnFocus?: HTMLElement | null;
+    /** Initial element to focus. Defaults to first focusable child. */
+    initialFocus?: HTMLElement | null;
+    /** When true, pressing Escape calls `onEscape`. */
+    onEscape?: (event: KeyboardEvent) => void;
+    /** Outside clicks call this. Trap does not auto-close on outside click. */
+    onOutsideClick?: (event: MouseEvent | TouchEvent) => void;
+}
+interface FocusTrap {
+    activate(): void;
+    deactivate(): void;
+    isActive(): boolean;
+}
+declare function createFocusTrap(container: HTMLElement, options?: FocusTrapOptions): FocusTrap;
+
+export { type FocusTrap as F, type FocusTrapOptions as a, createFocusTrap as c };