@compa11y/core 0.1.2 → 0.1.5

package/dist/index.js

@@ -1,338 +1,3 @@
-export { FOCUSABLE_SELECTORS, TABBABLE_SELECTORS, containsFocus, createFocusScope, createFocusTrap, createRovingTabindex, focusWithVisibleRing, getActiveFocusTrap, getFirstFocusable, getFocusableElements, getLastFocusSource, getLastFocusable, getNextFocusable, getPreviousFocusable, getTabbableElements, hasFocusTrap, hasVisibleFocus, initFocusVisible, isFocusVisible, isFocusable, isTabbable, isVisible, isWithinContainer, resolveElement, setFocusVisible } from './chunk-2PUYKF2E.js';
-export { KeyboardPatterns, createKeyboardManager, createTypeAhead, getKeyCombo, normalizeKey } from './chunk-2WF5Y6D7.js';
-export { announce, announceAssertive, announceError, announcePolite, announceProgress, announceStatus, clearAnnouncements, createAnnouncer, initAnnouncer, queueAnnouncement } from './chunk-2CQOLVQH.js';
-export { createMediaQueryListener, getScreenReaderHints, isAndroid, isBrowser, isIOS, isMac, isTouchDevice, isWindows, prefersDarkMode, prefersHighContrast, prefersReducedMotion } from './chunk-Z7K2G6FX.js';
-import { hasAccessibleName } from './chunk-24U5HHMC.js';
-export { aria, buildAriaProps, hasAccessibleName, mergeAriaIds } from './chunk-24U5HHMC.js';
+export{a as FOCUSABLE_SELECTORS,b as TABBABLE_SELECTORS,j as containsFocus,A as createFocusReturn,x as createFocusScope,o as createFocusTrap,y as createRovingTabindex,z as findFocusNeighbor,w as focusWithVisibleRing,p as getActiveFocusTrap,h as getFirstFocusable,f as getFocusableElements,u as getLastFocusSource,i as getLastFocusable,k as getNextFocusable,l as getPreviousFocusable,g as getTabbableElements,q as hasFocusTrap,t as hasVisibleFocus,r as initFocusVisible,s as isFocusVisible,d as isFocusable,e as isTabbable,c as isVisible,m as isWithinContainer,n as resolveElement,v as setFocusVisible}from'./chunk-QGEFH2VG.js';export{d as KeyboardPatterns,c as createKeyboardManager,e as createTypeAhead,b as getKeyCombo,a as normalizeKey}from'./chunk-RE4QIUWR.js';export{b as announce,d as announceAssertive,i as announceError,c as announcePolite,j as announceProgress,h as announceStatus,e as clearAnnouncements,g as createAnnouncer,a as initAnnouncer,f as queueAnnouncement}from'./chunk-ZAQMM5TA.js';export{k as createMediaQueryListener,j as getScreenReaderHints,d as isAndroid,a as isBrowser,c as isIOS,b as isMac,f as isTouchDevice,e as isWindows,i as prefersDarkMode,h as prefersHighContrast,g as prefersReducedMotion}from'./chunk-C3VZQUKG.js';import {d as d$1}from'./chunk-TGXWODB3.js';export{a as aria,b as buildAriaProps,d as hasAccessibleName,c as mergeAriaIds}from'./chunk-TGXWODB3.js';var g=0,d="compa11y";function u(e){let n=++g;return e?`${d}-${e}-${n}`:`${d}-${n}`}function $e(e,n){let r=u(n),t={};for(let o of e)t[o]=`${r}-${o}`;return t}function we(){g=0;}function Ae(e){let n=u(e);return {id:n,generate:r=>`${n}-${r}`,generateMultiple:r=>{let t={};for(let o of r)t[o]=`${n}-${o}`;return t}}}var a=null,l=new Set;function p(){return typeof process<"u"&&process.env?.NODE_ENV!=="production"}function b(e){a=e;}function f(e){return `${e.component}:${e.message}`}function i(e){if(!p())return;let n=f(e);if(l.has(n))return;if(l.add(n),a){a(e);return}let r=`[compa11y/${e.component}]`,t=m(e.type),o=e.suggestion?`${e.message}
 
-// src/utils/id.ts
-var idCounter = 0;
-var PREFIX = "compa11y";
-function generateId(prefix) {
-  const id = ++idCounter;
-  return prefix ? `${PREFIX}-${prefix}-${id}` : `${PREFIX}-${id}`;
-}
-function generateIds(parts, prefix) {
-  const baseId = generateId(prefix);
-  const ids = {};
-  for (const part of parts) {
-    ids[part] = `${baseId}-${part}`;
-  }
-  return ids;
-}
-function resetIdCounter() {
-  idCounter = 0;
-}
-function createIdScope(componentName) {
-  const scopeId = generateId(componentName);
-  return {
-    id: scopeId,
-    generate: (suffix) => `${scopeId}-${suffix}`,
-    generateMultiple: (parts) => {
-      const ids = {};
-      for (const part of parts) {
-        ids[part] = `${scopeId}-${part}`;
-      }
-      return ids;
-    }
-  };
-}
-
-// src/dev/warnings.ts
-var warningHandler = null;
-var issuedWarnings = /* @__PURE__ */ new Set();
-function isDev() {
-  return typeof process !== "undefined" && process.env?.NODE_ENV !== "production";
-}
-function setWarningHandler(handler) {
-  warningHandler = handler;
-}
-function createWarningKey(warning) {
-  return `${warning.component}:${warning.message}`;
-}
-function warn(warning) {
-  if (!isDev()) return;
-  const key = createWarningKey(warning);
-  if (issuedWarnings.has(key)) return;
-  issuedWarnings.add(key);
-  if (warningHandler) {
-    warningHandler(warning);
-    return;
-  }
-  const prefix = `[compa11y/${warning.component}]`;
-  const style = getConsoleStyle(warning.type);
-  const message = warning.suggestion ? `${warning.message}
-
-\u{1F4A1} Suggestion: ${warning.suggestion}` : warning.message;
-  switch (warning.type) {
-    case "error":
-      console.error(`%c${prefix}%c ${message}`, style, "");
-      break;
-    case "warning":
-      console.warn(`%c${prefix}%c ${message}`, style, "");
-      break;
-    case "info":
-      console.info(`%c${prefix}%c ${message}`, style, "");
-      break;
-  }
-  if (warning.element) {
-    console.log("Element:", warning.element);
-  }
-}
-function getConsoleStyle(type) {
-  switch (type) {
-    case "error":
-      return "background: #ff5555; color: white; padding: 2px 4px; border-radius: 2px; font-weight: bold;";
-    case "warning":
-      return "background: #ffaa00; color: black; padding: 2px 4px; border-radius: 2px; font-weight: bold;";
-    case "info":
-      return "background: #5555ff; color: white; padding: 2px 4px; border-radius: 2px; font-weight: bold;";
-  }
-}
-function clearWarnings() {
-  issuedWarnings.clear();
-}
-var checks = {
-  /**
-   * Check for missing accessible label
-   */
-  accessibleLabel(element, component, propName = "aria-label") {
-    if (!element) return;
-    if (!hasAccessibleName(element)) {
-      warn({
-        type: "error",
-        component,
-        message: `Missing accessible label. Screen reader users will not be able to understand this element.`,
-        suggestion: `Add ${propName}, aria-labelledby, or visible text content.`,
-        element
-      });
-    }
-  },
-  /**
-   * Check for missing required prop
-   */
-  requiredProp(value, propName, component) {
-    if (value === void 0 || value === null || value === "") {
-      warn({
-        type: "error",
-        component,
-        message: `Missing required prop "${propName}".`,
-        suggestion: `Provide a value for the "${propName}" prop.`
-      });
-    }
-  },
-  /**
-   * Check for invalid ARIA role
-   */
-  validRole(role, component, element) {
-    if (!role) return;
-    const validRoles = /* @__PURE__ */ new Set([
-      "alert",
-      "alertdialog",
-      "application",
-      "article",
-      "banner",
-      "button",
-      "cell",
-      "columnheader",
-      "combobox",
-      "complementary",
-      "contentinfo",
-      "definition",
-      "dialog",
-      "directory",
-      "document",
-      "feed",
-      "figure",
-      "form",
-      "grid",
-      "gridcell",
-      "group",
-      "heading",
-      "img",
-      "link",
-      "list",
-      "listbox",
-      "listitem",
-      "log",
-      "main",
-      "marquee",
-      "math",
-      "menu",
-      "menubar",
-      "menuitem",
-      "navigation",
-      "none",
-      "note",
-      "option",
-      "presentation",
-      "progressbar",
-      "region",
-      "row",
-      "rowgroup",
-      "rowheader",
-      "scrollbar",
-      "search",
-      "searchbox",
-      "separator",
-      "slider",
-      "spinbutton",
-      "status",
-      "switch",
-      "tab",
-      "table",
-      "tablist",
-      "tabpanel",
-      "term",
-      "textbox",
-      "timer",
-      "toolbar",
-      "tooltip",
-      "tree",
-      "treegrid",
-      "treeitem"
-    ]);
-    if (!validRoles.has(role)) {
-      warn({
-        type: "warning",
-        component,
-        message: `Invalid ARIA role "${role}".`,
-        suggestion: "Use a valid ARIA role from the WAI-ARIA specification.",
-        element
-      });
-    }
-  },
-  /**
-   * Check for interactive element without keyboard support
-   */
-  keyboardAccessible(element, component, handlers) {
-    if (!element) return;
-    if (handlers.onClick && !handlers.onKeyDown) {
-      const tagName = element.tagName.toLowerCase();
-      const role = element.getAttribute("role");
-      if (["button", "a", "input", "select", "textarea"].includes(tagName)) {
-        return;
-      }
-      const interactiveRoles = ["button", "link", "menuitem", "option", "tab"];
-      if (role && interactiveRoles.includes(role)) {
-        warn({
-          type: "warning",
-          component,
-          message: `Element has onClick but no onKeyDown handler.`,
-          suggestion: "Add keyboard event handling for Enter and Space keys.",
-          element
-        });
-      }
-    }
-  },
-  /**
-   * Check tabIndex usage
-   */
-  tabIndex(tabIndex, component, element) {
-    if (tabIndex === void 0) return;
-    if (tabIndex > 0) {
-      warn({
-        type: "warning",
-        component,
-        message: `Positive tabIndex (${tabIndex}) disrupts natural tab order.`,
-        suggestion: "Use tabIndex={0} or tabIndex={-1} instead. Rely on DOM order for tab sequence.",
-        element
-      });
-    }
-  },
-  /**
-   * Check for autofocus in dialogs
-   */
-  dialogAutoFocus(hasAutoFocus, component) {
-    if (!hasAutoFocus) {
-      warn({
-        type: "info",
-        component,
-        message: "No initial focus element specified for dialog.",
-        suggestion: "Consider setting initialFocus to guide keyboard users."
-      });
-    }
-  },
-  /**
-   * Check for missing form labels
-   */
-  formLabel(inputElement, labelId, component) {
-    if (!inputElement) return;
-    const hasLabel = labelId || inputElement.getAttribute("aria-label") || inputElement.getAttribute("aria-labelledby") || inputElement.labels?.length;
-    if (!hasLabel) {
-      warn({
-        type: "error",
-        component,
-        message: "Form input is missing an accessible label.",
-        suggestion: "Add a <label>, aria-label, or aria-labelledby.",
-        element: inputElement
-      });
-    }
-  },
-  /**
-   * Check for missing alt text on images
-   */
-  imageAlt(element, component) {
-    if (!element || element.tagName !== "IMG") return;
-    const alt = element.getAttribute("alt");
-    const role = element.getAttribute("role");
-    if (alt === null && role !== "presentation" && role !== "none") {
-      warn({
-        type: "error",
-        component,
-        message: "Image is missing alt attribute.",
-        suggestion: 'Add alt="" for decorative images or descriptive alt text for meaningful images.',
-        element
-      });
-    }
-  }
-};
-function createComponentWarnings(componentName) {
-  return {
-    error: (message, suggestion, element) => warn({
-      type: "error",
-      component: componentName,
-      message,
-      suggestion,
-      element
-    }),
-    warning: (message, suggestion, element) => warn({
-      type: "warning",
-      component: componentName,
-      message,
-      suggestion,
-      element
-    }),
-    info: (message, suggestion, element) => warn({
-      type: "info",
-      component: componentName,
-      message,
-      suggestion,
-      element
-    }),
-    checks: {
-      accessibleLabel: (element, propName) => checks.accessibleLabel(element, componentName, propName),
-      requiredProp: (value, propName) => checks.requiredProp(value, propName, componentName),
-      keyboardAccessible: (element, handlers) => checks.keyboardAccessible(element, componentName, handlers),
-      tabIndex: (tabIndex, element) => checks.tabIndex(tabIndex, componentName, element)
-    }
-  };
-}
-
-// src/index.ts
-function initCompa11y() {
-  const cleanups = [];
-  import('./focus/index.js').then(({ initFocusVisible: initFocusVisible2 }) => {
-    cleanups.push(initFocusVisible2());
-  });
-  import('./announcer/index.js').then(({ initAnnouncer: initAnnouncer2 }) => {
-    cleanups.push(initAnnouncer2());
-  });
-  return () => {
-    cleanups.forEach((cleanup) => cleanup());
-  };
-}
-
-export { checks, clearWarnings, createComponentWarnings, createIdScope, generateId, generateIds, initCompa11y, resetIdCounter, setWarningHandler, warn };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+\u{1F4A1} Suggestion: ${e.suggestion}`:e.message;switch(e.type){case "error":console.error(`%c${r}%c ${o}`,t,"");break;case "warning":console.warn(`%c${r}%c ${o}`,t,"");break;case "info":console.info(`%c${r}%c ${o}`,t,"");break}e.element&&console.log("Element:",e.element);}function m(e){switch(e){case "error":return "background: #ff5555; color: white; padding: 2px 4px; border-radius: 2px; font-weight: bold;";case "warning":return "background: #ffaa00; color: black; padding: 2px 4px; border-radius: 2px; font-weight: bold;";case "info":return "background: #5555ff; color: white; padding: 2px 4px; border-radius: 2px; font-weight: bold;"}}function x(){l.clear();}var s={accessibleLabel(e,n,r="aria-label"){e&&(d$1(e)||i({type:"error",component:n,message:"Missing accessible label. Screen reader users will not be able to understand this element.",suggestion:`Add ${r}, aria-labelledby, or visible text content.`,element:e}));},requiredProp(e,n,r){(e==null||e==="")&&i({type:"error",component:r,message:`Missing required prop "${n}".`,suggestion:`Provide a value for the "${n}" prop.`});},validRole(e,n,r){if(!e)return;new Set(["alert","alertdialog","application","article","banner","button","cell","columnheader","combobox","complementary","contentinfo","definition","dialog","directory","document","feed","figure","form","grid","gridcell","group","heading","img","link","list","listbox","listitem","log","main","marquee","math","menu","menubar","menuitem","navigation","none","note","option","presentation","progressbar","region","row","rowgroup","rowheader","scrollbar","search","searchbox","separator","slider","spinbutton","status","switch","tab","table","tablist","tabpanel","term","textbox","timer","toolbar","tooltip","tree","treegrid","treeitem"]).has(e)||i({type:"warning",component:n,message:`Invalid ARIA role "${e}".`,suggestion:"Use a valid ARIA role from the WAI-ARIA specification.",element:r});},keyboardAccessible(e,n,r){if(e&&r.onClick&&!r.onKeyDown){let t=e.tagName.toLowerCase(),o=e.getAttribute("role");if(["button","a","input","select","textarea"].includes(t))return;o&&["button","link","menuitem","option","tab"].includes(o)&&i({type:"warning",component:n,message:"Element has onClick but no onKeyDown handler.",suggestion:"Add keyboard event handling for Enter and Space keys.",element:e});}},tabIndex(e,n,r){e!==void 0&&e>0&&i({type:"warning",component:n,message:`Positive tabIndex (${e}) disrupts natural tab order.`,suggestion:"Use tabIndex={0} or tabIndex={-1} instead. Rely on DOM order for tab sequence.",element:r});},dialogAutoFocus(e,n){e||i({type:"info",component:n,message:"No initial focus element specified for dialog.",suggestion:"Consider setting initialFocus to guide keyboard users."});},formLabel(e,n,r){if(!e)return;n||e.getAttribute("aria-label")||e.getAttribute("aria-labelledby")||e.labels?.length||i({type:"error",component:r,message:"Form input is missing an accessible label.",suggestion:"Add a <label>, aria-label, or aria-labelledby.",element:e});},imageAlt(e,n){if(!e||e.tagName!=="IMG")return;let r=e.getAttribute("alt"),t=e.getAttribute("role");r===null&&t!=="presentation"&&t!=="none"&&i({type:"error",component:n,message:"Image is missing alt attribute.",suggestion:'Add alt="" for decorative images or descriptive alt text for meaningful images.',element:e});}};function y(e){return {error:(n,r,t)=>i({type:"error",component:e,message:n,suggestion:r,element:t}),warning:(n,r,t)=>i({type:"warning",component:e,message:n,suggestion:r,element:t}),info:(n,r,t)=>i({type:"info",component:e,message:n,suggestion:r,element:t}),checks:{accessibleLabel:(n,r)=>s.accessibleLabel(n,e,r),requiredProp:(n,r)=>s.requiredProp(n,r,e),keyboardAccessible:(n,r)=>s.keyboardAccessible(n,e,r),tabIndex:(n,r)=>s.tabIndex(n,e,r)}}}function We(){let e=[];return import('./focus/index.js').then(({initFocusVisible:n})=>{e.push(n());}),import('./announcer/index.js').then(({initAnnouncer:n})=>{e.push(n());}),()=>{e.forEach(n=>n());}}export{s as checks,x as clearWarnings,y as createComponentWarnings,Ae as createIdScope,u as generateId,$e as generateIds,We as initCompa11y,we as resetIdCounter,b as setWarningHandler,i as warn};

package/dist/keyboard/index.cjs

@@ -1,28 +1 @@
-'use strict';
-
-var chunkHQOFVJFO_cjs = require('../chunk-HQOFVJFO.cjs');
-
-
-
-Object.defineProperty(exports, "KeyboardPatterns", {
-  enumerable: true,
-  get: function () { return chunkHQOFVJFO_cjs.KeyboardPatterns; }
-});
-Object.defineProperty(exports, "createKeyboardManager", {
-  enumerable: true,
-  get: function () { return chunkHQOFVJFO_cjs.createKeyboardManager; }
-});
-Object.defineProperty(exports, "createTypeAhead", {
-  enumerable: true,
-  get: function () { return chunkHQOFVJFO_cjs.createTypeAhead; }
-});
-Object.defineProperty(exports, "getKeyCombo", {
-  enumerable: true,
-  get: function () { return chunkHQOFVJFO_cjs.getKeyCombo; }
-});
-Object.defineProperty(exports, "normalizeKey", {
-  enumerable: true,
-  get: function () { return chunkHQOFVJFO_cjs.normalizeKey; }
-});
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map
+'use strict';var chunkEM45V5TK_cjs=require('../chunk-EM45V5TK.cjs');Object.defineProperty(exports,"KeyboardPatterns",{enumerable:true,get:function(){return chunkEM45V5TK_cjs.d}});Object.defineProperty(exports,"createKeyboardManager",{enumerable:true,get:function(){return chunkEM45V5TK_cjs.c}});Object.defineProperty(exports,"createTypeAhead",{enumerable:true,get:function(){return chunkEM45V5TK_cjs.e}});Object.defineProperty(exports,"getKeyCombo",{enumerable:true,get:function(){return chunkEM45V5TK_cjs.b}});Object.defineProperty(exports,"normalizeKey",{enumerable:true,get:function(){return chunkEM45V5TK_cjs.a}});

package/dist/keyboard/index.js

@@ -1,3 +1 @@
-export { KeyboardPatterns, createKeyboardManager, createTypeAhead, getKeyCombo, normalizeKey } from '../chunk-2WF5Y6D7.js';
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+export{d as KeyboardPatterns,c as createKeyboardManager,e as createTypeAhead,b as getKeyCombo,a as normalizeKey}from'../chunk-RE4QIUWR.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compa11y/core",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "Framework-agnostic accessibility primitives",
   "author": "Ivan Trajkovski",
   "license": "MIT",

package/dist/announcer/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/announcer/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/aria/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/aria/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}