@hypoth-ui/test-utils 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 hypoth-org
+
+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,34 @@
+# @hypoth-ui/test-utils
+
+![Alpha](https://img.shields.io/badge/status-alpha-orange)
+
+Shared test utilities for the hypoth-ui design system. Provides helpers for rendering, querying, and asserting on Web Components and React adapters in Vitest.
+
+## Installation
+
+```bash
+npm install @hypoth-ui/test-utils --save-dev
+```
+
+## Usage
+
+```typescript
+import { renderWc, renderReact, waitForElement } from '@hypoth-ui/test-utils';
+
+// Render a Web Component for testing
+const el = await renderWc('<ds-button variant="primary">Click</ds-button>');
+
+// Render a React adapter for testing
+const { getByRole } = renderReact(<Button variant="primary">Click</Button>);
+
+// Wait for a custom element to be defined
+await waitForElement('ds-button');
+```
+
+## Documentation
+
+See the [main README](../../README.md) for full documentation and architecture overview.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,324 @@
+/**
+ * Keyboard simulation helpers for cross-framework testing.
+ */
+interface KeyboardEventInit {
+    key: string;
+    code?: string;
+    keyCode?: number;
+    shiftKey?: boolean;
+    ctrlKey?: boolean;
+    altKey?: boolean;
+    metaKey?: boolean;
+    bubbles?: boolean;
+    cancelable?: boolean;
+}
+/**
+ * Common key mappings for keyboard simulation.
+ */
+declare const Keys: {
+    readonly Enter: {
+        readonly key: "Enter";
+        readonly code: "Enter";
+        readonly keyCode: 13;
+    };
+    readonly Space: {
+        readonly key: " ";
+        readonly code: "Space";
+        readonly keyCode: 32;
+    };
+    readonly Escape: {
+        readonly key: "Escape";
+        readonly code: "Escape";
+        readonly keyCode: 27;
+    };
+    readonly Tab: {
+        readonly key: "Tab";
+        readonly code: "Tab";
+        readonly keyCode: 9;
+    };
+    readonly ArrowUp: {
+        readonly key: "ArrowUp";
+        readonly code: "ArrowUp";
+        readonly keyCode: 38;
+    };
+    readonly ArrowDown: {
+        readonly key: "ArrowDown";
+        readonly code: "ArrowDown";
+        readonly keyCode: 40;
+    };
+    readonly ArrowLeft: {
+        readonly key: "ArrowLeft";
+        readonly code: "ArrowLeft";
+        readonly keyCode: 37;
+    };
+    readonly ArrowRight: {
+        readonly key: "ArrowRight";
+        readonly code: "ArrowRight";
+        readonly keyCode: 39;
+    };
+    readonly Home: {
+        readonly key: "Home";
+        readonly code: "Home";
+        readonly keyCode: 36;
+    };
+    readonly End: {
+        readonly key: "End";
+        readonly code: "End";
+        readonly keyCode: 35;
+    };
+    readonly PageUp: {
+        readonly key: "PageUp";
+        readonly code: "PageUp";
+        readonly keyCode: 33;
+    };
+    readonly PageDown: {
+        readonly key: "PageDown";
+        readonly code: "PageDown";
+        readonly keyCode: 34;
+    };
+    readonly Backspace: {
+        readonly key: "Backspace";
+        readonly code: "Backspace";
+        readonly keyCode: 8;
+    };
+    readonly Delete: {
+        readonly key: "Delete";
+        readonly code: "Delete";
+        readonly keyCode: 46;
+    };
+};
+/**
+ * Creates a KeyboardEvent with proper initialization.
+ */
+declare function createKeyboardEvent(type: "keydown" | "keyup" | "keypress", init: KeyboardEventInit): KeyboardEvent;
+/**
+ * Simulates a key press (keydown + keyup) on an element.
+ */
+declare function pressKey(element: Element, keyOrInit: keyof typeof Keys | KeyboardEventInit): void;
+/**
+ * Simulates a keydown event on an element.
+ */
+declare function keyDown(element: Element, keyOrInit: keyof typeof Keys | KeyboardEventInit): void;
+/**
+ * Simulates a keyup event on an element.
+ */
+declare function keyUp(element: Element, keyOrInit: keyof typeof Keys | KeyboardEventInit): void;
+/**
+ * Simulates typing text character by character.
+ */
+declare function typeText(element: Element, text: string): void;
+/**
+ * Simulates pressing Tab to move focus.
+ */
+declare function tab(options?: {
+    shiftKey?: boolean;
+}): void;
+/**
+ * Simulates pressing Enter key.
+ */
+declare function enter(element: Element): void;
+/**
+ * Simulates pressing Space key.
+ */
+declare function space(element: Element): void;
+/**
+ * Simulates pressing Escape key.
+ */
+declare function pressEscape(element: Element): void;
+/**
+ * Simulates arrow key navigation.
+ */
+declare function arrowUp(element: Element): void;
+declare function arrowDown(element: Element): void;
+declare function arrowLeft(element: Element): void;
+declare function arrowRight(element: Element): void;
+
+/**
+ * ARIA assertion helpers for cross-framework testing.
+ */
+interface AriaRole {
+    role: string;
+    element: Element;
+}
+/**
+ * Gets the effective role of an element (explicit or implicit).
+ */
+declare function getRole(element: Element): string | null;
+/**
+ * Asserts that an element has the specified role.
+ */
+declare function hasRole(element: Element, expectedRole: string): boolean;
+/**
+ * Gets an ARIA attribute value from an element.
+ */
+declare function getAriaAttribute(element: Element, attribute: string): string | null;
+/**
+ * Asserts that an element has the specified ARIA attribute with the expected value.
+ */
+declare function hasAriaAttribute(element: Element, attribute: string, expectedValue?: string): boolean;
+/**
+ * Checks if an element is expanded (aria-expanded="true").
+ */
+declare function isExpanded(element: Element): boolean;
+/**
+ * Checks if an element is collapsed (aria-expanded="false").
+ */
+declare function isCollapsed(element: Element): boolean;
+/**
+ * Checks if an element is selected (aria-selected="true").
+ */
+declare function isSelected(element: Element): boolean;
+/**
+ * Checks if an element is checked (aria-checked="true").
+ */
+declare function isChecked(element: Element): boolean;
+/**
+ * Checks if an element is disabled (aria-disabled="true" or disabled attribute).
+ */
+declare function isDisabled(element: Element): boolean;
+/**
+ * Checks if an element is hidden from accessibility tree.
+ */
+declare function isHidden(element: Element): boolean;
+/**
+ * Checks if an element has a valid accessible name.
+ */
+declare function hasAccessibleName(element: Element): boolean;
+/**
+ * Gets the accessible name of an element.
+ */
+declare function getAccessibleName(element: Element): string;
+/**
+ * Queries elements by role.
+ */
+declare function queryByRole(container: Element, role: string): Element[];
+/**
+ * Gets all focusable elements within a container.
+ */
+declare function getFocusableElements(container: Element): Element[];
+
+/**
+ * Component wrapper abstraction for cross-framework testing.
+ */
+/**
+ * Component wrapper interface for framework-agnostic testing.
+ */
+interface ComponentWrapper {
+    /** The root element of the component */
+    element: Element;
+    /** Query for a single element within the component */
+    query(selector: string): Element | null;
+    /** Query for all elements matching selector */
+    queryAll(selector: string): Element[];
+    /** Get an attribute value from the root element */
+    getAttribute(name: string): string | null;
+    /** Check if root element has an attribute */
+    hasAttribute(name: string): boolean;
+    /** Get text content of the component */
+    getText(): string;
+    /** Focus the component */
+    focus(): void;
+    /** Click the component */
+    click(): void;
+    /** Wait for the component to update */
+    waitForUpdate(): Promise<void>;
+    /** Cleanup the component */
+    destroy(): void;
+}
+/**
+ * Creates a wrapper for a Web Component element.
+ */
+declare function wrapElement(element: Element): ComponentWrapper;
+/**
+ * Creates a Web Component in a test container and returns a wrapper.
+ */
+declare function createComponent<T extends Element>(tagName: string, attributes?: Record<string, string>, innerHTML?: string): Promise<ComponentWrapper & {
+    component: T;
+}>;
+/**
+ * Cleans up all test components.
+ */
+declare function cleanupComponents(): void;
+/**
+ * Renders HTML content and returns the first child element wrapped.
+ */
+declare function renderHTML(html: string): Promise<ComponentWrapper>;
+
+/**
+ * Shared button keyboard activation tests.
+ *
+ * These tests can run against both Web Component and React implementations
+ * to ensure consistent behavior across frameworks.
+ */
+interface ButtonTestContext {
+    /** Creates a button element and returns it */
+    createButton: (props?: {
+        disabled?: boolean;
+        loading?: boolean;
+        /** Callback for activation (click for WC, onPress for React) */
+        onActivate?: () => void;
+    }) => Promise<HTMLElement>;
+    /** Cleans up the button element */
+    cleanup: () => void;
+    /** Gets the clickable element within the button (may be the button itself or an inner element) */
+    getClickableElement: (button: HTMLElement) => HTMLElement;
+    /** Test assertion functions (from test framework) */
+    expect: (value: unknown) => {
+        toBe: (expected: unknown) => void;
+        toHaveBeenCalled: () => void;
+        toHaveBeenCalledTimes: (times: number) => void;
+        not: {
+            toHaveBeenCalled: () => void;
+        };
+    };
+    /** Creates a mock function */
+    createMockFn: () => {
+        (): void;
+        mock: {
+            calls: unknown[][];
+        };
+    };
+    /**
+     * Whether keyboard events trigger the activation callback directly
+     * (true for React with onPress) or trigger click events (false for WC)
+     */
+    keyboardTriggersActivation?: boolean;
+    /**
+     * Whether Space key activates the button (native buttons activate on Space keyup).
+     * Some behavior implementations may not handle Space activation.
+     * Default: true (tests Space key activation)
+     */
+    spaceKeyActivates?: boolean;
+}
+/**
+ * Runs shared button keyboard activation tests.
+ *
+ * @example
+ * ```ts
+ * // In WC test file
+ * import { runButtonKeyboardTests } from '@hypoth-ui/test-utils/shared-tests/button';
+ *
+ * describe('ds-button keyboard', () => {
+ *   runButtonKeyboardTests({
+ *     createButton: async (props) => {
+ *       const button = document.createElement('ds-button');
+ *       if (props?.disabled) button.disabled = true;
+ *       document.body.appendChild(button);
+ *       await button.updateComplete;
+ *       return button;
+ *     },
+ *     cleanup: () => document.body.innerHTML = '',
+ *     getClickableElement: (button) => button.querySelector('button')!,
+ *     expect: expect,
+ *     createMockFn: vi.fn,
+ *   });
+ * });
+ * ```
+ */
+declare function runButtonKeyboardTests(context: ButtonTestContext, testFn: (name: string, fn: () => void | Promise<void>) => void): void;
+/**
+ * Creates test context for Web Component button testing.
+ */
+declare function createWCButtonTestContext(expectFn: any, mockFn: any): Omit<ButtonTestContext, "createButton" | "cleanup">;
+
+export { type AriaRole, type ButtonTestContext, type ComponentWrapper, type KeyboardEventInit, Keys, arrowDown, arrowLeft, arrowRight, arrowUp, cleanupComponents, createComponent, createKeyboardEvent, createWCButtonTestContext, enter, getAccessibleName, getAriaAttribute, getFocusableElements, getRole, hasAccessibleName, hasAriaAttribute, hasRole, isChecked, isCollapsed, isDisabled, isExpanded, isHidden, isSelected, keyDown, keyUp, pressEscape, pressKey, queryByRole, renderHTML, runButtonKeyboardTests, space, tab, typeText, wrapElement };

package/dist/index.js

@@ -0,0 +1,483 @@
+// src/keyboard.ts
+var Keys = {
+  Enter: { key: "Enter", code: "Enter", keyCode: 13 },
+  Space: { key: " ", code: "Space", keyCode: 32 },
+  Escape: { key: "Escape", code: "Escape", keyCode: 27 },
+  Tab: { key: "Tab", code: "Tab", keyCode: 9 },
+  ArrowUp: { key: "ArrowUp", code: "ArrowUp", keyCode: 38 },
+  ArrowDown: { key: "ArrowDown", code: "ArrowDown", keyCode: 40 },
+  ArrowLeft: { key: "ArrowLeft", code: "ArrowLeft", keyCode: 37 },
+  ArrowRight: { key: "ArrowRight", code: "ArrowRight", keyCode: 39 },
+  Home: { key: "Home", code: "Home", keyCode: 36 },
+  End: { key: "End", code: "End", keyCode: 35 },
+  PageUp: { key: "PageUp", code: "PageUp", keyCode: 33 },
+  PageDown: { key: "PageDown", code: "PageDown", keyCode: 34 },
+  Backspace: { key: "Backspace", code: "Backspace", keyCode: 8 },
+  Delete: { key: "Delete", code: "Delete", keyCode: 46 }
+};
+function createKeyboardEvent(type, init) {
+  return new KeyboardEvent(type, {
+    key: init.key,
+    code: init.code ?? init.key,
+    keyCode: init.keyCode,
+    shiftKey: init.shiftKey ?? false,
+    ctrlKey: init.ctrlKey ?? false,
+    altKey: init.altKey ?? false,
+    metaKey: init.metaKey ?? false,
+    bubbles: init.bubbles ?? true,
+    cancelable: init.cancelable ?? true
+  });
+}
+function pressKey(element, keyOrInit) {
+  const init = typeof keyOrInit === "string" ? Keys[keyOrInit] : keyOrInit;
+  const keydownEvent = createKeyboardEvent("keydown", init);
+  element.dispatchEvent(keydownEvent);
+  const keyupEvent = createKeyboardEvent("keyup", init);
+  element.dispatchEvent(keyupEvent);
+}
+function keyDown(element, keyOrInit) {
+  const init = typeof keyOrInit === "string" ? Keys[keyOrInit] : keyOrInit;
+  const event = createKeyboardEvent("keydown", init);
+  element.dispatchEvent(event);
+}
+function keyUp(element, keyOrInit) {
+  const init = typeof keyOrInit === "string" ? Keys[keyOrInit] : keyOrInit;
+  const event = createKeyboardEvent("keyup", init);
+  element.dispatchEvent(event);
+}
+function typeText(element, text) {
+  for (const char of text) {
+    const init = {
+      key: char,
+      code: `Key${char.toUpperCase()}`,
+      keyCode: char.charCodeAt(0)
+    };
+    pressKey(element, init);
+  }
+}
+function tab(options = {}) {
+  const activeElement = document.activeElement;
+  if (activeElement) {
+    pressKey(activeElement, { ...Keys.Tab, shiftKey: options.shiftKey ?? false });
+  }
+}
+function enter(element) {
+  pressKey(element, "Enter");
+}
+function space(element) {
+  pressKey(element, "Space");
+}
+function pressEscape(element) {
+  pressKey(element, "Escape");
+}
+function arrowUp(element) {
+  pressKey(element, "ArrowUp");
+}
+function arrowDown(element) {
+  pressKey(element, "ArrowDown");
+}
+function arrowLeft(element) {
+  pressKey(element, "ArrowLeft");
+}
+function arrowRight(element) {
+  pressKey(element, "ArrowRight");
+}
+
+// src/aria.ts
+function getRole(element) {
+  const explicitRole = element.getAttribute("role");
+  if (explicitRole) {
+    return explicitRole;
+  }
+  const implicitRoles = {
+    BUTTON: "button",
+    A: "link",
+    INPUT: getInputRole(element),
+    SELECT: "combobox",
+    TEXTAREA: "textbox",
+    DIALOG: "dialog",
+    ARTICLE: "article",
+    ASIDE: "complementary",
+    FOOTER: "contentinfo",
+    HEADER: "banner",
+    MAIN: "main",
+    NAV: "navigation",
+    SECTION: "region",
+    FORM: "form",
+    IMG: "img",
+    UL: "list",
+    OL: "list",
+    LI: "listitem",
+    TABLE: "table",
+    THEAD: "rowgroup",
+    TBODY: "rowgroup",
+    TR: "row",
+    TH: "columnheader",
+    TD: "cell",
+    H1: "heading",
+    H2: "heading",
+    H3: "heading",
+    H4: "heading",
+    H5: "heading",
+    H6: "heading"
+  };
+  return implicitRoles[element.tagName] ?? null;
+}
+function getInputRole(input) {
+  const type = input.type?.toLowerCase() ?? "text";
+  const roleMap = {
+    button: "button",
+    checkbox: "checkbox",
+    email: "textbox",
+    number: "spinbutton",
+    password: "textbox",
+    radio: "radio",
+    range: "slider",
+    search: "searchbox",
+    submit: "button",
+    tel: "textbox",
+    text: "textbox",
+    url: "textbox"
+  };
+  return roleMap[type] ?? "textbox";
+}
+function hasRole(element, expectedRole) {
+  const actualRole = getRole(element);
+  return actualRole === expectedRole;
+}
+function getAriaAttribute(element, attribute) {
+  if (attribute.startsWith("aria-")) {
+    return element.getAttribute(attribute);
+  }
+  return element.getAttribute(`aria-${attribute}`);
+}
+function hasAriaAttribute(element, attribute, expectedValue) {
+  const value = getAriaAttribute(element, attribute);
+  if (expectedValue === void 0) {
+    return value !== null;
+  }
+  return value === expectedValue;
+}
+function isExpanded(element) {
+  return element.getAttribute("aria-expanded") === "true";
+}
+function isCollapsed(element) {
+  return element.getAttribute("aria-expanded") === "false";
+}
+function isSelected(element) {
+  return element.getAttribute("aria-selected") === "true";
+}
+function isChecked(element) {
+  return element.getAttribute("aria-checked") === "true";
+}
+function isDisabled(element) {
+  return element.getAttribute("aria-disabled") === "true" || element.hasAttribute("disabled");
+}
+function isHidden(element) {
+  return element.getAttribute("aria-hidden") === "true" || element.hasAttribute("hidden") || element.style?.display === "none";
+}
+function hasAccessibleName(element) {
+  if (element.getAttribute("aria-label")) {
+    return true;
+  }
+  const labelledBy = element.getAttribute("aria-labelledby");
+  if (labelledBy) {
+    const labelElement = document.getElementById(labelledBy);
+    if (labelElement?.textContent?.trim()) {
+      return true;
+    }
+  }
+  const id = element.id;
+  if (id) {
+    const label = document.querySelector(`label[for="${id}"]`);
+    if (label?.textContent?.trim()) {
+      return true;
+    }
+  }
+  const role = getRole(element);
+  if (role === "button" || role === "link") {
+    return Boolean(element.textContent?.trim());
+  }
+  return false;
+}
+function getAccessibleName(element) {
+  const ariaLabel = element.getAttribute("aria-label");
+  if (ariaLabel) {
+    return ariaLabel;
+  }
+  const labelledBy = element.getAttribute("aria-labelledby");
+  if (labelledBy) {
+    const ids = labelledBy.split(/\s+/);
+    const labels = ids.map((id2) => document.getElementById(id2)?.textContent?.trim()).filter(Boolean);
+    if (labels.length > 0) {
+      return labels.join(" ");
+    }
+  }
+  const id = element.id;
+  if (id) {
+    const label = document.querySelector(`label[for="${id}"]`);
+    if (label?.textContent?.trim()) {
+      return label.textContent.trim();
+    }
+  }
+  return element.textContent?.trim() ?? "";
+}
+function queryByRole(container, role) {
+  const elements = container.querySelectorAll(`[role="${role}"]`);
+  const result = [];
+  elements.forEach((el) => result.push(el));
+  const implicitSelectors = {
+    button: "button, input[type='button'], input[type='submit']",
+    checkbox: "input[type='checkbox']",
+    radio: "input[type='radio']",
+    textbox: "input:not([type]), input[type='text'], input[type='email'], input[type='password'], input[type='tel'], input[type='url'], textarea",
+    link: "a[href]",
+    listbox: "select",
+    option: "option",
+    dialog: "dialog",
+    heading: "h1, h2, h3, h4, h5, h6",
+    list: "ul, ol",
+    listitem: "li"
+  };
+  const selector = implicitSelectors[role];
+  if (selector) {
+    container.querySelectorAll(selector).forEach((el) => {
+      if (!el.hasAttribute("role") && !result.includes(el)) {
+        result.push(el);
+      }
+    });
+  }
+  return result;
+}
+function getFocusableElements(container) {
+  const selector = [
+    "a[href]",
+    "button:not([disabled])",
+    "input:not([disabled])",
+    "select:not([disabled])",
+    "textarea:not([disabled])",
+    "[tabindex]:not([tabindex='-1'])",
+    "[contenteditable='true']"
+  ].join(", ");
+  return Array.from(container.querySelectorAll(selector)).filter((el) => {
+    return !isHidden(el) && !isDisabled(el);
+  });
+}
+
+// src/component.ts
+function wrapElement(element) {
+  return {
+    element,
+    query(selector) {
+      return element.querySelector(selector);
+    },
+    queryAll(selector) {
+      return Array.from(element.querySelectorAll(selector));
+    },
+    getAttribute(name) {
+      return element.getAttribute(name);
+    },
+    hasAttribute(name) {
+      return element.hasAttribute(name);
+    },
+    getText() {
+      return element.textContent?.trim() ?? "";
+    },
+    focus() {
+      element.focus();
+    },
+    click() {
+      element.click();
+    },
+    async waitForUpdate() {
+      if ("updateComplete" in element) {
+        await element.updateComplete;
+      }
+      await new Promise((resolve) => requestAnimationFrame(resolve));
+    },
+    destroy() {
+      element.remove();
+    }
+  };
+}
+async function createComponent(tagName, attributes, innerHTML) {
+  let container = document.getElementById("test-container");
+  if (!container) {
+    container = document.createElement("div");
+    container.id = "test-container";
+    document.body.appendChild(container);
+  }
+  const element = document.createElement(tagName);
+  if (attributes) {
+    for (const [name, value] of Object.entries(attributes)) {
+      element.setAttribute(name, value);
+    }
+  }
+  if (innerHTML) {
+    element.innerHTML = innerHTML;
+  }
+  container.appendChild(element);
+  await customElements.whenDefined(tagName);
+  if ("updateComplete" in element) {
+    await element.updateComplete;
+  }
+  const wrapper = wrapElement(element);
+  return {
+    ...wrapper,
+    component: element
+  };
+}
+function cleanupComponents() {
+  const container = document.getElementById("test-container");
+  if (container) {
+    container.innerHTML = "";
+  }
+}
+async function renderHTML(html) {
+  let container = document.getElementById("test-container");
+  if (!container) {
+    container = document.createElement("div");
+    container.id = "test-container";
+    document.body.appendChild(container);
+  }
+  container.innerHTML = html;
+  const element = container.firstElementChild;
+  if (!element) {
+    throw new Error("No element rendered from HTML");
+  }
+  const customElements2 = container.querySelectorAll(":not(:defined)");
+  await Promise.all(
+    Array.from(customElements2).map(
+      (el) => window.customElements.whenDefined(el.tagName.toLowerCase())
+    )
+  );
+  await new Promise((resolve) => requestAnimationFrame(resolve));
+  return wrapElement(element);
+}
+
+// src/shared-tests/button.ts
+function runButtonKeyboardTests(context, testFn) {
+  const {
+    createButton,
+    cleanup,
+    getClickableElement,
+    expect,
+    createMockFn,
+    keyboardTriggersActivation,
+    spaceKeyActivates = true
+  } = context;
+  testFn("should trigger activation on Enter key", async () => {
+    const activationHandler = createMockFn();
+    const button = await createButton(
+      keyboardTriggersActivation ? { onActivate: activationHandler } : void 0
+    );
+    const clickable = getClickableElement(button);
+    if (!keyboardTriggersActivation) {
+      button.addEventListener("click", activationHandler);
+    }
+    pressKey(clickable, "Enter");
+    expect(activationHandler).toHaveBeenCalled();
+    cleanup();
+  });
+  if (spaceKeyActivates) {
+    testFn("should trigger activation on Space key", async () => {
+      const activationHandler = createMockFn();
+      const button = await createButton(
+        keyboardTriggersActivation ? { onActivate: activationHandler } : void 0
+      );
+      const clickable = getClickableElement(button);
+      if (!keyboardTriggersActivation) {
+        button.addEventListener("click", activationHandler);
+      }
+      pressKey(clickable, "Space");
+      expect(activationHandler).toHaveBeenCalled();
+      cleanup();
+    });
+  }
+  testFn("should not trigger activation on Enter when disabled", async () => {
+    const activationHandler = createMockFn();
+    const button = await createButton(
+      keyboardTriggersActivation ? { disabled: true, onActivate: activationHandler } : { disabled: true }
+    );
+    const clickable = getClickableElement(button);
+    if (!keyboardTriggersActivation) {
+      button.addEventListener("click", activationHandler);
+    }
+    pressKey(clickable, "Enter");
+    expect(activationHandler).not.toHaveBeenCalled();
+    cleanup();
+  });
+  if (spaceKeyActivates) {
+    testFn("should not trigger activation on Space when disabled", async () => {
+      const activationHandler = createMockFn();
+      const button = await createButton(
+        keyboardTriggersActivation ? { disabled: true, onActivate: activationHandler } : { disabled: true }
+      );
+      const clickable = getClickableElement(button);
+      if (!keyboardTriggersActivation) {
+        button.addEventListener("click", activationHandler);
+      }
+      pressKey(clickable, "Space");
+      expect(activationHandler).not.toHaveBeenCalled();
+      cleanup();
+    });
+  }
+  testFn("should have button role", async () => {
+    const button = await createButton();
+    const clickable = getClickableElement(button);
+    expect(hasRole(clickable, "button")).toBe(true);
+    cleanup();
+  });
+  testFn("should indicate disabled state via aria-disabled", async () => {
+    const button = await createButton({ disabled: true });
+    const clickable = getClickableElement(button);
+    expect(isDisabled(clickable)).toBe(true);
+    cleanup();
+  });
+}
+function createWCButtonTestContext(expectFn, mockFn) {
+  return {
+    getClickableElement: (button) => {
+      return button.querySelector("button") ?? button;
+    },
+    expect: expectFn,
+    createMockFn: mockFn
+  };
+}
+export {
+  Keys,
+  arrowDown,
+  arrowLeft,
+  arrowRight,
+  arrowUp,
+  cleanupComponents,
+  createComponent,
+  createKeyboardEvent,
+  createWCButtonTestContext,
+  enter,
+  getAccessibleName,
+  getAriaAttribute,
+  getFocusableElements,
+  getRole,
+  hasAccessibleName,
+  hasAriaAttribute,
+  hasRole,
+  isChecked,
+  isCollapsed,
+  isDisabled,
+  isExpanded,
+  isHidden,
+  isSelected,
+  keyDown,
+  keyUp,
+  pressEscape,
+  pressKey,
+  queryByRole,
+  renderHTML,
+  runButtonKeyboardTests,
+  space,
+  tab,
+  typeText,
+  wrapElement
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/keyboard.ts","../src/aria.ts","../src/component.ts","../src/shared-tests/button.ts"],"sourcesContent":["/**\n * Keyboard simulation helpers for cross-framework testing.\n */\n\nexport interface KeyboardEventInit {\n  key: string;\n  code?: string;\n  keyCode?: number;\n  shiftKey?: boolean;\n  ctrlKey?: boolean;\n  altKey?: boolean;\n  metaKey?: boolean;\n  bubbles?: boolean;\n  cancelable?: boolean;\n}\n\n/**\n * Common key mappings for keyboard simulation.\n */\nexport const Keys = {\n  Enter: { key: \"Enter\", code: \"Enter\", keyCode: 13 },\n  Space: { key: \" \", code: \"Space\", keyCode: 32 },\n  Escape: { key: \"Escape\", code: \"Escape\", keyCode: 27 },\n  Tab: { key: \"Tab\", code: \"Tab\", keyCode: 9 },\n  ArrowUp: { key: \"ArrowUp\", code: \"ArrowUp\", keyCode: 38 },\n  ArrowDown: { key: \"ArrowDown\", code: \"ArrowDown\", keyCode: 40 },\n  ArrowLeft: { key: \"ArrowLeft\", code: \"ArrowLeft\", keyCode: 37 },\n  ArrowRight: { key: \"ArrowRight\", code: \"ArrowRight\", keyCode: 39 },\n  Home: { key: \"Home\", code: \"Home\", keyCode: 36 },\n  End: { key: \"End\", code: \"End\", keyCode: 35 },\n  PageUp: { key: \"PageUp\", code: \"PageUp\", keyCode: 33 },\n  PageDown: { key: \"PageDown\", code: \"PageDown\", keyCode: 34 },\n  Backspace: { key: \"Backspace\", code: \"Backspace\", keyCode: 8 },\n  Delete: { key: \"Delete\", code: \"Delete\", keyCode: 46 },\n} as const;\n\n/**\n * Creates a KeyboardEvent with proper initialization.\n */\nexport function createKeyboardEvent(\n  type: \"keydown\" | \"keyup\" | \"keypress\",\n  init: KeyboardEventInit\n): KeyboardEvent {\n  return new KeyboardEvent(type, {\n    key: init.key,\n    code: init.code ?? init.key,\n    keyCode: init.keyCode,\n    shiftKey: init.shiftKey ?? false,\n    ctrlKey: init.ctrlKey ?? false,\n    altKey: init.altKey ?? false,\n    metaKey: init.metaKey ?? false,\n    bubbles: init.bubbles ?? true,\n    cancelable: init.cancelable ?? true,\n  });\n}\n\n/**\n * Simulates a key press (keydown + keyup) on an element.\n */\nexport function pressKey(element: Element, keyOrInit: keyof typeof Keys | KeyboardEventInit): void {\n  const init = typeof keyOrInit === \"string\" ? Keys[keyOrInit] : keyOrInit;\n\n  const keydownEvent = createKeyboardEvent(\"keydown\", init);\n  element.dispatchEvent(keydownEvent);\n\n  const keyupEvent = createKeyboardEvent(\"keyup\", init);\n  element.dispatchEvent(keyupEvent);\n}\n\n/**\n * Simulates a keydown event on an element.\n */\nexport function keyDown(element: Element, keyOrInit: keyof typeof Keys | KeyboardEventInit): void {\n  const init = typeof keyOrInit === \"string\" ? Keys[keyOrInit] : keyOrInit;\n  const event = createKeyboardEvent(\"keydown\", init);\n  element.dispatchEvent(event);\n}\n\n/**\n * Simulates a keyup event on an element.\n */\nexport function keyUp(element: Element, keyOrInit: keyof typeof Keys | KeyboardEventInit): void {\n  const init = typeof keyOrInit === \"string\" ? Keys[keyOrInit] : keyOrInit;\n  const event = createKeyboardEvent(\"keyup\", init);\n  element.dispatchEvent(event);\n}\n\n/**\n * Simulates typing text character by character.\n */\nexport function typeText(element: Element, text: string): void {\n  for (const char of text) {\n    const init: KeyboardEventInit = {\n      key: char,\n      code: `Key${char.toUpperCase()}`,\n      keyCode: char.charCodeAt(0),\n    };\n    pressKey(element, init);\n  }\n}\n\n/**\n * Simulates pressing Tab to move focus.\n */\nexport function tab(options: { shiftKey?: boolean } = {}): void {\n  const activeElement = document.activeElement;\n  if (activeElement) {\n    pressKey(activeElement, { ...Keys.Tab, shiftKey: options.shiftKey ?? false });\n  }\n}\n\n/**\n * Simulates pressing Enter key.\n */\nexport function enter(element: Element): void {\n  pressKey(element, \"Enter\");\n}\n\n/**\n * Simulates pressing Space key.\n */\nexport function space(element: Element): void {\n  pressKey(element, \"Space\");\n}\n\n/**\n * Simulates pressing Escape key.\n */\nexport function pressEscape(element: Element): void {\n  pressKey(element, \"Escape\");\n}\n\n/**\n * Simulates arrow key navigation.\n */\nexport function arrowUp(element: Element): void {\n  pressKey(element, \"ArrowUp\");\n}\n\nexport function arrowDown(element: Element): void {\n  pressKey(element, \"ArrowDown\");\n}\n\nexport function arrowLeft(element: Element): void {\n  pressKey(element, \"ArrowLeft\");\n}\n\nexport function arrowRight(element: Element): void {\n  pressKey(element, \"ArrowRight\");\n}\n","/**\n * ARIA assertion helpers for cross-framework testing.\n */\n\nexport interface AriaRole {\n  role: string;\n  element: Element;\n}\n\n/**\n * Gets the effective role of an element (explicit or implicit).\n */\nexport function getRole(element: Element): string | null {\n  // Check explicit role\n  const explicitRole = element.getAttribute(\"role\");\n  if (explicitRole) {\n    return explicitRole;\n  }\n\n  // Check implicit role from tag name\n  const implicitRoles: Record<string, string> = {\n    BUTTON: \"button\",\n    A: \"link\",\n    INPUT: getInputRole(element as HTMLInputElement),\n    SELECT: \"combobox\",\n    TEXTAREA: \"textbox\",\n    DIALOG: \"dialog\",\n    ARTICLE: \"article\",\n    ASIDE: \"complementary\",\n    FOOTER: \"contentinfo\",\n    HEADER: \"banner\",\n    MAIN: \"main\",\n    NAV: \"navigation\",\n    SECTION: \"region\",\n    FORM: \"form\",\n    IMG: \"img\",\n    UL: \"list\",\n    OL: \"list\",\n    LI: \"listitem\",\n    TABLE: \"table\",\n    THEAD: \"rowgroup\",\n    TBODY: \"rowgroup\",\n    TR: \"row\",\n    TH: \"columnheader\",\n    TD: \"cell\",\n    H1: \"heading\",\n    H2: \"heading\",\n    H3: \"heading\",\n    H4: \"heading\",\n    H5: \"heading\",\n    H6: \"heading\",\n  };\n\n  return implicitRoles[element.tagName] ?? null;\n}\n\nfunction getInputRole(input: HTMLInputElement): string {\n  const type = input.type?.toLowerCase() ?? \"text\";\n  const roleMap: Record<string, string> = {\n    button: \"button\",\n    checkbox: \"checkbox\",\n    email: \"textbox\",\n    number: \"spinbutton\",\n    password: \"textbox\",\n    radio: \"radio\",\n    range: \"slider\",\n    search: \"searchbox\",\n    submit: \"button\",\n    tel: \"textbox\",\n    text: \"textbox\",\n    url: \"textbox\",\n  };\n  return roleMap[type] ?? \"textbox\";\n}\n\n/**\n * Asserts that an element has the specified role.\n */\nexport function hasRole(element: Element, expectedRole: string): boolean {\n  const actualRole = getRole(element);\n  return actualRole === expectedRole;\n}\n\n/**\n * Gets an ARIA attribute value from an element.\n */\nexport function getAriaAttribute(element: Element, attribute: string): string | null {\n  // Handle aria-* attributes\n  if (attribute.startsWith(\"aria-\")) {\n    return element.getAttribute(attribute);\n  }\n  return element.getAttribute(`aria-${attribute}`);\n}\n\n/**\n * Asserts that an element has the specified ARIA attribute with the expected value.\n */\nexport function hasAriaAttribute(element: Element, attribute: string, expectedValue?: string): boolean {\n  const value = getAriaAttribute(element, attribute);\n  if (expectedValue === undefined) {\n    return value !== null;\n  }\n  return value === expectedValue;\n}\n\n/**\n * Checks if an element is expanded (aria-expanded=\"true\").\n */\nexport function isExpanded(element: Element): boolean {\n  return element.getAttribute(\"aria-expanded\") === \"true\";\n}\n\n/**\n * Checks if an element is collapsed (aria-expanded=\"false\").\n */\nexport function isCollapsed(element: Element): boolean {\n  return element.getAttribute(\"aria-expanded\") === \"false\";\n}\n\n/**\n * Checks if an element is selected (aria-selected=\"true\").\n */\nexport function isSelected(element: Element): boolean {\n  return element.getAttribute(\"aria-selected\") === \"true\";\n}\n\n/**\n * Checks if an element is checked (aria-checked=\"true\").\n */\nexport function isChecked(element: Element): boolean {\n  return element.getAttribute(\"aria-checked\") === \"true\";\n}\n\n/**\n * Checks if an element is disabled (aria-disabled=\"true\" or disabled attribute).\n */\nexport function isDisabled(element: Element): boolean {\n  return (\n    element.getAttribute(\"aria-disabled\") === \"true\" ||\n    element.hasAttribute(\"disabled\")\n  );\n}\n\n/**\n * Checks if an element is hidden from accessibility tree.\n */\nexport function isHidden(element: Element): boolean {\n  return (\n    element.getAttribute(\"aria-hidden\") === \"true\" ||\n    element.hasAttribute(\"hidden\") ||\n    (element as HTMLElement).style?.display === \"none\"\n  );\n}\n\n/**\n * Checks if an element has a valid accessible name.\n */\nexport function hasAccessibleName(element: Element): boolean {\n  // Check aria-label\n  if (element.getAttribute(\"aria-label\")) {\n    return true;\n  }\n\n  // Check aria-labelledby\n  const labelledBy = element.getAttribute(\"aria-labelledby\");\n  if (labelledBy) {\n    const labelElement = document.getElementById(labelledBy);\n    if (labelElement?.textContent?.trim()) {\n      return true;\n    }\n  }\n\n  // Check for associated label element\n  const id = element.id;\n  if (id) {\n    const label = document.querySelector(`label[for=\"${id}\"]`);\n    if (label?.textContent?.trim()) {\n      return true;\n    }\n  }\n\n  // Check text content for some roles\n  const role = getRole(element);\n  if (role === \"button\" || role === \"link\") {\n    return Boolean((element as HTMLElement).textContent?.trim());\n  }\n\n  return false;\n}\n\n/**\n * Gets the accessible name of an element.\n */\nexport function getAccessibleName(element: Element): string {\n  // Check aria-label first\n  const ariaLabel = element.getAttribute(\"aria-label\");\n  if (ariaLabel) {\n    return ariaLabel;\n  }\n\n  // Check aria-labelledby\n  const labelledBy = element.getAttribute(\"aria-labelledby\");\n  if (labelledBy) {\n    const ids = labelledBy.split(/\\s+/);\n    const labels = ids\n      .map((id) => document.getElementById(id)?.textContent?.trim())\n      .filter(Boolean);\n    if (labels.length > 0) {\n      return labels.join(\" \");\n    }\n  }\n\n  // Check for associated label element\n  const id = element.id;\n  if (id) {\n    const label = document.querySelector(`label[for=\"${id}\"]`);\n    if (label?.textContent?.trim()) {\n      return label.textContent.trim();\n    }\n  }\n\n  // Fall back to text content\n  return (element as HTMLElement).textContent?.trim() ?? \"\";\n}\n\n/**\n * Queries elements by role.\n */\nexport function queryByRole(container: Element, role: string): Element[] {\n  const elements = container.querySelectorAll(`[role=\"${role}\"]`);\n  const result: Element[] = [];\n\n  // Add explicit role matches\n  elements.forEach((el) => result.push(el));\n\n  // Add implicit role matches\n  const implicitSelectors: Record<string, string> = {\n    button: \"button, input[type='button'], input[type='submit']\",\n    checkbox: \"input[type='checkbox']\",\n    radio: \"input[type='radio']\",\n    textbox: \"input:not([type]), input[type='text'], input[type='email'], input[type='password'], input[type='tel'], input[type='url'], textarea\",\n    link: \"a[href]\",\n    listbox: \"select\",\n    option: \"option\",\n    dialog: \"dialog\",\n    heading: \"h1, h2, h3, h4, h5, h6\",\n    list: \"ul, ol\",\n    listitem: \"li\",\n  };\n\n  const selector = implicitSelectors[role];\n  if (selector) {\n    container.querySelectorAll(selector).forEach((el) => {\n      if (!el.hasAttribute(\"role\") && !result.includes(el)) {\n        result.push(el);\n      }\n    });\n  }\n\n  return result;\n}\n\n/**\n * Gets all focusable elements within a container.\n */\nexport function getFocusableElements(container: Element): Element[] {\n  const selector = [\n    \"a[href]\",\n    \"button:not([disabled])\",\n    \"input:not([disabled])\",\n    \"select:not([disabled])\",\n    \"textarea:not([disabled])\",\n    \"[tabindex]:not([tabindex='-1'])\",\n    \"[contenteditable='true']\",\n  ].join(\", \");\n\n  return Array.from(container.querySelectorAll(selector)).filter((el) => {\n    return !isHidden(el) && !isDisabled(el);\n  });\n}\n","/**\n * Component wrapper abstraction for cross-framework testing.\n */\n\n/**\n * Component wrapper interface for framework-agnostic testing.\n */\nexport interface ComponentWrapper {\n  /** The root element of the component */\n  element: Element;\n\n  /** Query for a single element within the component */\n  query(selector: string): Element | null;\n\n  /** Query for all elements matching selector */\n  queryAll(selector: string): Element[];\n\n  /** Get an attribute value from the root element */\n  getAttribute(name: string): string | null;\n\n  /** Check if root element has an attribute */\n  hasAttribute(name: string): boolean;\n\n  /** Get text content of the component */\n  getText(): string;\n\n  /** Focus the component */\n  focus(): void;\n\n  /** Click the component */\n  click(): void;\n\n  /** Wait for the component to update */\n  waitForUpdate(): Promise<void>;\n\n  /** Cleanup the component */\n  destroy(): void;\n}\n\n/**\n * Creates a wrapper for a Web Component element.\n */\nexport function wrapElement(element: Element): ComponentWrapper {\n  return {\n    element,\n\n    query(selector: string): Element | null {\n      return element.querySelector(selector);\n    },\n\n    queryAll(selector: string): Element[] {\n      return Array.from(element.querySelectorAll(selector));\n    },\n\n    getAttribute(name: string): string | null {\n      return element.getAttribute(name);\n    },\n\n    hasAttribute(name: string): boolean {\n      return element.hasAttribute(name);\n    },\n\n    getText(): string {\n      return (element as HTMLElement).textContent?.trim() ?? \"\";\n    },\n\n    focus(): void {\n      (element as HTMLElement).focus();\n    },\n\n    click(): void {\n      (element as HTMLElement).click();\n    },\n\n    async waitForUpdate(): Promise<void> {\n      // Wait for Lit updateComplete if available\n      if (\"updateComplete\" in element) {\n        await (element as { updateComplete: Promise<unknown> }).updateComplete;\n      }\n      // Additional frame for DOM updates\n      await new Promise((resolve) => requestAnimationFrame(resolve));\n    },\n\n    destroy(): void {\n      element.remove();\n    },\n  };\n}\n\n/**\n * Creates a Web Component in a test container and returns a wrapper.\n */\nexport async function createComponent<T extends Element>(\n  tagName: string,\n  attributes?: Record<string, string>,\n  innerHTML?: string\n): Promise<ComponentWrapper & { component: T }> {\n  // Create container if it doesn't exist\n  let container = document.getElementById(\"test-container\");\n  if (!container) {\n    container = document.createElement(\"div\");\n    container.id = \"test-container\";\n    document.body.appendChild(container);\n  }\n\n  // Create the element\n  const element = document.createElement(tagName) as unknown as T;\n\n  // Set attributes\n  if (attributes) {\n    for (const [name, value] of Object.entries(attributes)) {\n      element.setAttribute(name, value);\n    }\n  }\n\n  // Set innerHTML\n  if (innerHTML) {\n    element.innerHTML = innerHTML;\n  }\n\n  // Append to container\n  container.appendChild(element);\n\n  // Wait for component to be ready\n  await customElements.whenDefined(tagName);\n\n  // Wait for initial render\n  if (\"updateComplete\" in element) {\n    await (element as { updateComplete: Promise<unknown> }).updateComplete;\n  }\n\n  const wrapper = wrapElement(element);\n\n  return {\n    ...wrapper,\n    component: element,\n  };\n}\n\n/**\n * Cleans up all test components.\n */\nexport function cleanupComponents(): void {\n  const container = document.getElementById(\"test-container\");\n  if (container) {\n    container.innerHTML = \"\";\n  }\n}\n\n/**\n * Renders HTML content and returns the first child element wrapped.\n */\nexport async function renderHTML(html: string): Promise<ComponentWrapper> {\n  let container = document.getElementById(\"test-container\");\n  if (!container) {\n    container = document.createElement(\"div\");\n    container.id = \"test-container\";\n    document.body.appendChild(container);\n  }\n\n  container.innerHTML = html;\n\n  const element = container.firstElementChild;\n  if (!element) {\n    throw new Error(\"No element rendered from HTML\");\n  }\n\n  // Wait for any custom elements to be defined\n  const customElements = container.querySelectorAll(\":not(:defined)\");\n  await Promise.all(\n    Array.from(customElements).map((el) =>\n      window.customElements.whenDefined(el.tagName.toLowerCase())\n    )\n  );\n\n  // Wait for updates\n  await new Promise((resolve) => requestAnimationFrame(resolve));\n\n  return wrapElement(element);\n}\n","/**\n * Shared button keyboard activation tests.\n *\n * These tests can run against both Web Component and React implementations\n * to ensure consistent behavior across frameworks.\n */\n\nimport { pressKey } from \"../keyboard.js\";\nimport { hasRole, isDisabled } from \"../aria.js\";\n\nexport interface ButtonTestContext {\n  /** Creates a button element and returns it */\n  createButton: (props?: {\n    disabled?: boolean;\n    loading?: boolean;\n    /** Callback for activation (click for WC, onPress for React) */\n    onActivate?: () => void;\n  }) => Promise<HTMLElement>;\n  /** Cleans up the button element */\n  cleanup: () => void;\n  /** Gets the clickable element within the button (may be the button itself or an inner element) */\n  getClickableElement: (button: HTMLElement) => HTMLElement;\n  /** Test assertion functions (from test framework) */\n  expect: (value: unknown) => {\n    toBe: (expected: unknown) => void;\n    toHaveBeenCalled: () => void;\n    toHaveBeenCalledTimes: (times: number) => void;\n    not: {\n      toHaveBeenCalled: () => void;\n    };\n  };\n  /** Creates a mock function */\n  createMockFn: () => { (): void; mock: { calls: unknown[][] } };\n  /**\n   * Whether keyboard events trigger the activation callback directly\n   * (true for React with onPress) or trigger click events (false for WC)\n   */\n  keyboardTriggersActivation?: boolean;\n  /**\n   * Whether Space key activates the button (native buttons activate on Space keyup).\n   * Some behavior implementations may not handle Space activation.\n   * Default: true (tests Space key activation)\n   */\n  spaceKeyActivates?: boolean;\n}\n\n/**\n * Runs shared button keyboard activation tests.\n *\n * @example\n * ```ts\n * // In WC test file\n * import { runButtonKeyboardTests } from '@hypoth-ui/test-utils/shared-tests/button';\n *\n * describe('ds-button keyboard', () => {\n *   runButtonKeyboardTests({\n *     createButton: async (props) => {\n *       const button = document.createElement('ds-button');\n *       if (props?.disabled) button.disabled = true;\n *       document.body.appendChild(button);\n *       await button.updateComplete;\n *       return button;\n *     },\n *     cleanup: () => document.body.innerHTML = '',\n *     getClickableElement: (button) => button.querySelector('button')!,\n *     expect: expect,\n *     createMockFn: vi.fn,\n *   });\n * });\n * ```\n */\nexport function runButtonKeyboardTests(\n  context: ButtonTestContext,\n  testFn: (name: string, fn: () => void | Promise<void>) => void\n): void {\n  const {\n    createButton,\n    cleanup,\n    getClickableElement,\n    expect,\n    createMockFn,\n    keyboardTriggersActivation,\n    spaceKeyActivates = true,\n  } = context;\n\n  testFn(\"should trigger activation on Enter key\", async () => {\n    const activationHandler = createMockFn();\n    const button = await createButton(\n      keyboardTriggersActivation ? { onActivate: activationHandler } : undefined\n    );\n    const clickable = getClickableElement(button);\n\n    if (!keyboardTriggersActivation) {\n      button.addEventListener(\"click\", activationHandler);\n    }\n\n    pressKey(clickable, \"Enter\");\n\n    expect(activationHandler).toHaveBeenCalled();\n    cleanup();\n  });\n\n  if (spaceKeyActivates) {\n    testFn(\"should trigger activation on Space key\", async () => {\n      const activationHandler = createMockFn();\n      const button = await createButton(\n        keyboardTriggersActivation ? { onActivate: activationHandler } : undefined\n      );\n      const clickable = getClickableElement(button);\n\n      if (!keyboardTriggersActivation) {\n        button.addEventListener(\"click\", activationHandler);\n      }\n\n      pressKey(clickable, \"Space\");\n\n      expect(activationHandler).toHaveBeenCalled();\n      cleanup();\n    });\n  }\n\n  testFn(\"should not trigger activation on Enter when disabled\", async () => {\n    const activationHandler = createMockFn();\n    const button = await createButton(\n      keyboardTriggersActivation\n        ? { disabled: true, onActivate: activationHandler }\n        : { disabled: true }\n    );\n    const clickable = getClickableElement(button);\n\n    if (!keyboardTriggersActivation) {\n      button.addEventListener(\"click\", activationHandler);\n    }\n\n    pressKey(clickable, \"Enter\");\n\n    expect(activationHandler).not.toHaveBeenCalled();\n    cleanup();\n  });\n\n  if (spaceKeyActivates) {\n    testFn(\"should not trigger activation on Space when disabled\", async () => {\n      const activationHandler = createMockFn();\n      const button = await createButton(\n        keyboardTriggersActivation\n          ? { disabled: true, onActivate: activationHandler }\n          : { disabled: true }\n      );\n      const clickable = getClickableElement(button);\n\n      if (!keyboardTriggersActivation) {\n        button.addEventListener(\"click\", activationHandler);\n      }\n\n      pressKey(clickable, \"Space\");\n\n      expect(activationHandler).not.toHaveBeenCalled();\n      cleanup();\n    });\n  }\n\n  testFn(\"should have button role\", async () => {\n    const button = await createButton();\n    const clickable = getClickableElement(button);\n\n    expect(hasRole(clickable, \"button\")).toBe(true);\n    cleanup();\n  });\n\n  testFn(\"should indicate disabled state via aria-disabled\", async () => {\n    const button = await createButton({ disabled: true });\n    const clickable = getClickableElement(button);\n\n    expect(isDisabled(clickable)).toBe(true);\n    cleanup();\n  });\n}\n\n/**\n * Creates test context for Web Component button testing.\n */\nexport function createWCButtonTestContext(\n  // biome-ignore lint/suspicious/noExplicitAny: Test framework types vary\n  expectFn: any,\n  // biome-ignore lint/suspicious/noExplicitAny: Test framework types vary\n  mockFn: any\n): Omit<ButtonTestContext, \"createButton\" | \"cleanup\"> {\n  return {\n    getClickableElement: (button: HTMLElement) => {\n      // WC buttons typically have an inner button element\n      return button.querySelector(\"button\") ?? button;\n    },\n    expect: expectFn,\n    createMockFn: mockFn,\n  };\n}\n"],"mappings":"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","names":["id","customElements"]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@hypoth-ui/test-utils",
+  "version": "0.1.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Test utilities for the hypoth-ui design system (Alpha)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hypoth-ui/hypoth-ui.git",
+    "directory": "packages/test-utils"
+  },
+  "homepage": "https://github.com/hypoth-ui/hypoth-ui#readme",
+  "keywords": [
+    "testing",
+    "utilities",
+    "design-system",
+    "vitest",
+    "hypoth-ui"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  }
+}