keystra 0.0.0-stage → 0.1.0

package/dist/utils.cjs

@@ -0,0 +1,195 @@
+'use strict';
+
+// src/utils/dom.ts
+function hasDom() {
+  return typeof globalThis !== "undefined" && typeof globalThis.document !== "undefined";
+}
+function resolveElement(target, root = null) {
+  if (target == null) return null;
+  if (typeof target === "function") {
+    return resolveElement(target(), root);
+  }
+  if (typeof target === "string") {
+    const scope = root ?? (hasDom() ? document : null);
+    if (!scope) return null;
+    try {
+      return scope.querySelector(target);
+    } catch {
+      return null;
+    }
+  }
+  return target;
+}
+function queryItems(container, selector) {
+  if (!container) return [];
+  if (typeof selector === "function") {
+    const result = selector(container);
+    return Array.from(result);
+  }
+  if (!selector) return [];
+  try {
+    return Array.from(container.querySelectorAll(selector));
+  } catch {
+    return [];
+  }
+}
+var DISABLED_SELECTOR_DEFAULT = "[disabled],[aria-disabled='true']";
+function isDisabled(element, selector = DISABLED_SELECTOR_DEFAULT) {
+  if (!selector) return false;
+  const html = element;
+  if (html.disabled === true) return true;
+  if (element.getAttribute("aria-disabled") === "true") return true;
+  if (selector === DISABLED_SELECTOR_DEFAULT) return element.hasAttribute("disabled");
+  try {
+    return element.matches(selector);
+  } catch {
+    return false;
+  }
+}
+function isHidden(element) {
+  const html = element;
+  const probe = html;
+  if (typeof probe.checkVisibility === "function") {
+    try {
+      return !probe.checkVisibility.call(html, { checkOpacity: false, checkVisibilityCSS: true });
+    } catch {
+    }
+  }
+  let node = html;
+  while (node && node.nodeType === 1) {
+    if (node.hidden === true) return true;
+    if (node.style && node.style.display === "none") return true;
+    node = node.parentElement;
+  }
+  return false;
+}
+function isFocusable(element) {
+  const html = element;
+  if (typeof html.focus !== "function") return false;
+  if (isDisabled(element)) return false;
+  return !isHidden(element);
+}
+var EDITABLE_SELECTOR_DEFAULT = "input:not([type='hidden']):not([readonly]),textarea:not([readonly]),select,[contenteditable=''],[contenteditable='true'],[iscontenteditable]";
+function isEditableTarget(target, extraSelector) {
+  if (!target || typeof target.matches !== "function") return false;
+  const element = target;
+  const selector = extraSelector ? `${EDITABLE_SELECTOR_DEFAULT},${extraSelector}` : EDITABLE_SELECTOR_DEFAULT;
+  try {
+    if (element.matches(selector)) return true;
+  } catch {
+  }
+  const html = element;
+  return html.isContentEditable === true;
+}
+function getText(element) {
+  const label = element.getAttribute("aria-label") ?? element.textContent ?? "";
+  return label.replace(/\s+/g, " ").trim();
+}
+function setAttribute(element, name, value) {
+  if (value === null) element.removeAttribute(name);
+  else if (element.getAttribute(name) !== value) element.setAttribute(name, value);
+}
+function toggleClass(element, name, on) {
+  if (!name) return;
+  const html = element;
+  if (typeof html.classList?.toggle === "function") html.classList.toggle(name, on);
+}
+function focusElement(element, preventScroll = true) {
+  if (typeof element.focus !== "function") return false;
+  try {
+    element.focus({ preventScroll });
+  } catch {
+    try {
+      element.focus();
+    } catch {
+      return false;
+    }
+  }
+  return true;
+}
+function contains(parent, child) {
+  if (!parent || !child) return false;
+  if (parent === child) return true;
+  if (typeof parent.contains === "function") return parent.contains(child);
+  let node = child;
+  while (node) {
+    if (node === parent) return true;
+    node = node.parentNode;
+  }
+  return false;
+}
+
+// src/utils/emitter.ts
+var Emitter = class {
+  constructor() {
+    this.handlers = null;
+  }
+  on(event, handler) {
+    if (!this.handlers) this.handlers = /* @__PURE__ */ new Map();
+    let set = this.handlers.get(event);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.handlers.set(event, set);
+    }
+    set.add(handler);
+    let disposed = false;
+    return () => {
+      if (disposed) return;
+      disposed = true;
+      this.off(event, handler);
+    };
+  }
+  off(event, handler) {
+    const set = this.handlers?.get(event);
+    if (!set) return;
+    if (handler) set.delete(handler);
+    else set.clear();
+    if (set.size === 0) this.handlers?.delete(event);
+  }
+  emit(event, payload) {
+    const set = this.handlers?.get(event);
+    if (!set || set.size === 0) return;
+    for (const handler of Array.from(set)) {
+      handler(payload);
+    }
+  }
+  clear() {
+    this.handlers?.clear();
+    this.handlers = null;
+  }
+  get size() {
+    if (!this.handlers) return 0;
+    let total = 0;
+    for (const set of this.handlers.values()) total += set.size;
+    return total;
+  }
+};
+
+// src/utils/layout.ts
+var LayoutCache = class {
+  constructor() {
+    this.rects = /* @__PURE__ */ new WeakMap();
+  }
+  rect(element, version) {
+    const cached = this.rects.get(element);
+    if (cached && cached.version === version) return cached.rect;
+    const rect = element.getBoundingClientRect();
+    this.rects.set(element, { version, rect });
+    return rect;
+  }
+};
+
+exports.Emitter = Emitter;
+exports.LayoutCache = LayoutCache;
+exports.contains = contains;
+exports.focusElement = focusElement;
+exports.getText = getText;
+exports.hasDom = hasDom;
+exports.isDisabled = isDisabled;
+exports.isEditableTarget = isEditableTarget;
+exports.isFocusable = isFocusable;
+exports.isHidden = isHidden;
+exports.queryItems = queryItems;
+exports.resolveElement = resolveElement;
+exports.setAttribute = setAttribute;
+exports.toggleClass = toggleClass;

package/dist/utils.d.cts

@@ -0,0 +1,3 @@
+export { c as contains, f as focusElement, g as getText, h as hasDom, i as isDisabled, a as isEditableTarget, b as isFocusable, d as isHidden, q as queryItems, r as resolveElement, s as setAttribute, t as toggleClass } from './utils-CkveVeIJ.cjs';
+export { E as Emitter, L as LayoutCache } from './layout-CBzD-87D.cjs';
+import './index-IZkcWAXP.cjs';

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+export { c as contains, f as focusElement, g as getText, h as hasDom, i as isDisabled, a as isEditableTarget, b as isFocusable, d as isHidden, q as queryItems, r as resolveElement, s as setAttribute, t as toggleClass } from './utils-JmPZTlys.js';
+export { E as Emitter, L as LayoutCache } from './layout-C2-n8aUI.js';
+import './index-IZkcWAXP.js';

package/dist/utils.js

@@ -0,0 +1,2 @@
+export { Emitter, LayoutCache } from './chunk-S5YVXIMA.js';
+export { contains, focusElement, getText, hasDom, isDisabled, isEditableTarget, isFocusable, isHidden, queryItems, resolveElement, setAttribute, toggleClass } from './chunk-77GGU3AX.js';

package/package.json

@@ -1,6 +1,149 @@
 {
   "name": "keystra",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "A tiny, framework-independent keyboard interaction engine: navigation, roving focus and selection for any DOM UI.",
+  "keywords": [
+    "keyboard",
+    "navigation",
+    "focus",
+    "focus-management",
+    "roving-tabindex",
+    "accessibility",
+    "a11y",
+    "aria",
+    "typeahead",
+    "menu",
+    "tabs",
+    "grid",
+    "tree",
+    "command-palette",
+    "vanilla-js",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "Zahid Hasan",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zahidhasann88/keystra.git"
+  },
+  "homepage": "https://github.com/zahidhasann88/keystra#readme",
+  "bugs": "https://github.com/zahidhasann88/keystra/issues",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "unpkg": "./dist/index.global.js",
+  "jsdelivr": "./dist/index.global.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./core": {
+      "import": {
+        "types": "./dist/core.d.ts",
+        "default": "./dist/core.js"
+      },
+      "require": {
+        "types": "./dist/core.d.cts",
+        "default": "./dist/core.cjs"
+      }
+    },
+    "./navigation": {
+      "import": {
+        "types": "./dist/navigation.d.ts",
+        "default": "./dist/navigation.js"
+      },
+      "require": {
+        "types": "./dist/navigation.d.cts",
+        "default": "./dist/navigation.cjs"
+      }
+    },
+    "./focus": {
+      "import": {
+        "types": "./dist/focus.d.ts",
+        "default": "./dist/focus.js"
+      },
+      "require": {
+        "types": "./dist/focus.d.cts",
+        "default": "./dist/focus.cjs"
+      }
+    },
+    "./selection": {
+      "import": {
+        "types": "./dist/selection.d.ts",
+        "default": "./dist/selection.js"
+      },
+      "require": {
+        "types": "./dist/selection.d.cts",
+        "default": "./dist/selection.cjs"
+      }
+    },
+    "./patterns": {
+      "import": {
+        "types": "./dist/patterns.d.ts",
+        "default": "./dist/patterns.js"
+      },
+      "require": {
+        "types": "./dist/patterns.d.cts",
+        "default": "./dist/patterns.cjs"
+      }
+    },
+    "./utils": {
+      "import": {
+        "types": "./dist/utils.d.ts",
+        "default": "./dist/utils.js"
+      },
+      "require": {
+        "types": "./dist/utils.d.cts",
+        "default": "./dist/utils.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:browser": "npm run build && node tests/browser/run.mjs",
+    "bench": "npm run build && node benchmarks/run.mjs",
+    "size": "npm run build && node scripts/size.mjs",
+    "verify": "npm run typecheck && npm run test && npm run build && node scripts/verify-package.mjs",
+    "prepublishOnly": "npm run verify"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "@vitest/coverage-v8": "^5.0.5",
+    "esbuild": "^0.28.2",
+    "happy-dom": "^21.0.4",
+    "hotkeys-js": "^4.0.10",
+    "playwright-core": "^1.64.1",
+    "roving-ux": "^1.0.5",
+    "tinykeys": "^4.0.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^5.0.5"
+  }
+}