@vielzeug/assay 1.0.0

package/README.md

@@ -0,0 +1,51 @@
+# @vielzeug/assay
+
+> Framework-agnostic DOM testing primitives — scoped queries, synchronous event dispatchers, and async wait helpers, with zero dependency on any particular UI library.
+
+[![npm version](https://img.shields.io/npm/v/@vielzeug/assay)](https://www.npmjs.com/package/@vielzeug/assay) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+<details>
+<summary>Quick Reference</summary>
+
+**Package:** `@vielzeug/assay` &nbsp;·&nbsp; **Category:** Testing
+
+**Key exports:** `within`, `queryByText`, `queryAllByText`, `fire`, `createPointerEvent`, `waitFor`, `waitForEvent`, `AssayError`, `AssayTimeoutError`
+
+**When to use:** Writing DOM-level tests for any custom-element or vanilla-DOM code — scoped element queries, low-level synchronous event dispatch, and deterministic async waiting — without pulling in a full testing-library dependency or coupling to a specific component framework.
+
+**Related:** [@vielzeug/ore](https://vielzeug.dev/ore/) · [@vielzeug/refine](https://vielzeug.dev/refine/)
+
+</details>
+
+`@vielzeug/assay` is part of Vielzeug and ships as a zero-dependency TypeScript package with ESM+CJS output.
+
+## Installation
+
+```sh
+pnpm add -D @vielzeug/assay
+npm install -D @vielzeug/assay
+yarn add -D @vielzeug/assay
+```
+
+## Quick Start
+
+```ts
+import { fire, waitFor, within } from '@vielzeug/assay';
+
+const panel = document.querySelector('.panel')!;
+const { query, queryByText } = within(panel);
+
+fire.click(query('button.submit')!);
+
+await waitFor(() => queryByText('Saved') !== null);
+```
+
+## Documentation
+
+- [Overview](https://vielzeug.dev/assay/)
+- [Usage Guide](https://vielzeug.dev/assay/usage)
+- [API Reference](https://vielzeug.dev/assay/api)
+
+## License
+
+MIT © [Helmuth Saatkamp](https://github.com/helmuthdu) — part of the [Vielzeug](https://github.com/helmuthdu/vielzeug) monorepo.

package/dist/_dev.cjs

@@ -0,0 +1,2 @@
+var e=!globalThis.__ASSAY_PROD__,t=new Set;function n(n,r){!e||t.has(n)||(t.add(n),console.warn(`[@vielzeug/assay] ${r}`))}exports.warnOnce=n;
+//# sourceMappingURL=_dev.cjs.map

package/dist/_dev.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dev.cjs","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __ASSAY_PROD__?: boolean }).__ASSAY_PROD__;\n\nconst warnedKeys = new Set<string>();\n\n/**\n * @internal Warn at most once per `key` for the lifetime of the module — used for\n * environment-capability fallbacks (e.g. missing `PointerEvent`/`TouchEvent`), which would\n * otherwise log once per dispatched event in a suite that fires hundreds of them.\n */\nexport function warnOnce(key: string, msg: string): void {\n  if (!isDev || warnedKeys.has(key)) return;\n\n  warnedKeys.add(key);\n  console.warn(`[@vielzeug/assay] ${msg}`);\n}\n\n/** @internal Test-only — clears \"warned once\" state so fallback-warning tests can run in any order. */\nexport function _resetWarnings(): void {\n  warnedKeys.clear();\n}\n"],"mappings":"AAAA,IAAM,EAAQ,CAAE,WAA4C,eAEtD,EAAa,IAAI,IAOvB,SAAgB,EAAS,EAAa,EAAmB,CACnD,CAAC,GAAS,EAAW,IAAI,CAAG,IAEhC,EAAW,IAAI,CAAG,EAClB,QAAQ,KAAK,qBAAqB,GAAK,EACzC"}

package/dist/_dev.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=_dev.d.ts.map

package/dist/_dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dev.d.ts","sourceRoot":"","sources":["../src/_dev.ts"],"names":[],"mappings":""}

package/dist/_dev.js

@@ -0,0 +1,9 @@
+//#region src/_dev.ts
+var e = !globalThis.__ASSAY_PROD__, t = /* @__PURE__ */ new Set();
+function n(n, r) {
+	!e || t.has(n) || (t.add(n), console.warn(`[@vielzeug/assay] ${r}`));
+}
+//#endregion
+export { n as warnOnce };
+
+//# sourceMappingURL=_dev.js.map

package/dist/_dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dev.js","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __ASSAY_PROD__?: boolean }).__ASSAY_PROD__;\n\nconst warnedKeys = new Set<string>();\n\n/**\n * @internal Warn at most once per `key` for the lifetime of the module — used for\n * environment-capability fallbacks (e.g. missing `PointerEvent`/`TouchEvent`), which would\n * otherwise log once per dispatched event in a suite that fires hundreds of them.\n */\nexport function warnOnce(key: string, msg: string): void {\n  if (!isDev || warnedKeys.has(key)) return;\n\n  warnedKeys.add(key);\n  console.warn(`[@vielzeug/assay] ${msg}`);\n}\n\n/** @internal Test-only — clears \"warned once\" state so fallback-warning tests can run in any order. */\nexport function _resetWarnings(): void {\n  warnedKeys.clear();\n}\n"],"mappings":";AAAA,IAAM,IAAQ,CAAE,WAA4C,gBAEtD,oBAAa,IAAI,IAAY;AAOnC,SAAgB,EAAS,GAAa,GAAmB;CACnD,CAAC,KAAS,EAAW,IAAI,CAAG,MAEhC,EAAW,IAAI,CAAG,GAClB,QAAQ,KAAK,qBAAqB,GAAK;AACzC"}

package/dist/assay.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},t=class extends e{},n=!globalThis.__ASSAY_PROD__,r=new Set;function i(e,t){!n||r.has(e)||(r.add(e),console.warn(`[@vielzeug/assay] ${t}`))}var a=(e,t={})=>typeof PointerEvent<`u`?new PointerEvent(e,t):(i(`pointer-fallback`,`PointerEvent is unavailable in this environment — falling back to MouseEvent. pointerId/pointerType/isPrimary and similar pointer-only fields will be missing from every dispatched event.`),new MouseEvent(e,t)),o={blur:(e,t)=>e.dispatchEvent(new FocusEvent(`blur`,{bubbles:!0,...t})),change:(e,t)=>e.dispatchEvent(new Event(`change`,{bubbles:!0,...t})),click:(e,t)=>e.dispatchEvent(new MouseEvent(`click`,{bubbles:!0,cancelable:!0,...t})),custom:(e,t,n)=>e.dispatchEvent(new CustomEvent(t,{bubbles:!0,cancelable:!0,composed:!1,...n})),event:(e,t)=>e.dispatchEvent(t),focus:(e,t,n)=>e.dispatchEvent(new FocusEvent(`focus`,{bubbles:!0,...n})),input:(e,t)=>e.dispatchEvent(new Event(`input`,{bubbles:!0,...t})),keyboard:(e,t,n)=>e.dispatchEvent(new KeyboardEvent(t,{bubbles:!0,cancelable:!0,...n})),keyDown:(e,t)=>e.dispatchEvent(new KeyboardEvent(`keydown`,{bubbles:!0,cancelable:!0,...t})),keyUp:(e,t)=>e.dispatchEvent(new KeyboardEvent(`keyup`,{bubbles:!0,cancelable:!0,...t})),mouse:(e,t,n)=>e.dispatchEvent(new MouseEvent(t,{bubbles:!0,cancelable:!0,...n})),pointerCancel:(e,t)=>e.dispatchEvent(a(`pointercancel`,{bubbles:!0,cancelable:!1,...t})),pointerDown:(e,t)=>e.dispatchEvent(a(`pointerdown`,{bubbles:!0,cancelable:!0,...t})),pointerEnter:(e,t)=>e.dispatchEvent(a(`pointerenter`,{bubbles:!1,...t})),pointerLeave:(e,t)=>e.dispatchEvent(a(`pointerleave`,{bubbles:!1,...t})),pointerMove:(e,t)=>e.dispatchEvent(a(`pointermove`,{bubbles:!0,cancelable:!0,...t})),pointerUp:(e,t)=>e.dispatchEvent(a(`pointerup`,{bubbles:!0,cancelable:!0,...t})),submit:(e,t)=>e.dispatchEvent(new Event(`submit`,{bubbles:!0,cancelable:!0,...t})),touch:(e,t,n)=>typeof TouchEvent<`u`?e.dispatchEvent(new TouchEvent(t,{bubbles:!0,cancelable:!0,...n})):(i(`touch-fallback`,"TouchEvent is unavailable in this environment — falling back to CustomEvent. The dispatched event will have no `touches`/`changedTouches` data."),e.dispatchEvent(new CustomEvent(t,{bubbles:!0,cancelable:!0,...n})))};function s(e,t){return e.querySelector(t)}function c(e,t){return Array.from(e.querySelectorAll(t))}function l(e,t){return e.querySelector(`[data-testid="${t}"]`)}function u(e,t){return Array.from(e.querySelectorAll(`[data-testid="${t}"]`))}function d(e,t,n){for(let r of e.querySelectorAll(n))if(r.textContent?.trim()===t)return r;return null}function f(e,t,n){return Array.from(e.querySelectorAll(n)).filter(e=>e.textContent?.trim()===t)}function p(e,t){return e.shadowRoot?.querySelector(t)??null}function m(e,t){return Array.from(e.shadowRoot?.querySelectorAll(t)??[])}function h(e,t){return p(e,`[part="${t}"]`)}function g(e,t){let n=t?`[slot="${t}"]`:`:not([slot])`;return Array.from(e.querySelectorAll(`:scope > ${n}`))}function _(e){return{query:t=>s(e,t),queryAll:t=>c(e,t),queryAllByTestId:t=>u(e,t),queryAllByText:(t,n=`*`)=>f(e,t,n),queryByTestId:t=>l(e,t),queryByText:(t,n=`*`)=>d(e,t,n)}}async function v(e,{interval:n=50,message:r,timeout:i=1e3}={}){let a=Date.now()+i,o;for(;;){try{let t=await e();if(t===void 0||t)return}catch(e){o=e}if(Date.now()>=a)break;await x(n)}let s=`waitFor timed out after ${i}ms`,c=r?`${r} (${s})`:s,l=o instanceof Error?o.message:o==null?void 0:String(o);throw new t(l?`${c}\n${l}`:c,{cause:o})}function y(e,n,r=1e3){return new Promise((i,a)=>{let o=e=>{clearTimeout(s),i(e)},s=setTimeout(()=>{e.removeEventListener(n,o),a(new t(`waitForEvent: "${n}" timed out after ${r}ms`))},r);e.addEventListener(n,o,{once:!0})})}var b=()=>new Promise(e=>{queueMicrotask(e)}),x=(e=0)=>new Promise(t=>{setTimeout(t,e)});exports.AssayError=e,exports.AssayTimeoutError=t,exports.createPointerEvent=a,exports.fire=o,exports.getSlotted=g,exports.nextTick=b,exports.query=s,exports.queryAll=c,exports.queryAllByTestId=u,exports.queryAllByText=f,exports.queryAllInShadow=m,exports.queryByTestId=l,exports.queryByText=d,exports.queryInShadow=p,exports.queryPart=h,exports.wait=x,exports.waitFor=v,exports.waitForEvent=y,exports.within=_;
+//# sourceMappingURL=assay.cjs.map

package/dist/assay.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assay.cjs","names":[],"sources":["../src/errors.ts","../src/_dev.ts","../src/events.ts","../src/query.ts","../src/wait.ts"],"sourcesContent":["/** Base class for all Assay errors. Use `instanceof AssayError` to catch any Assay-originated error. */\nexport class AssayError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is AssayError {\n    return err instanceof AssayError;\n  }\n}\n\n/** Thrown by `waitFor`/`waitForEvent` when a condition is not met within the timeout. */\nexport class AssayTimeoutError extends AssayError {}\n","const isDev = !(globalThis as { __ASSAY_PROD__?: boolean }).__ASSAY_PROD__;\n\nconst warnedKeys = new Set<string>();\n\n/**\n * @internal Warn at most once per `key` for the lifetime of the module — used for\n * environment-capability fallbacks (e.g. missing `PointerEvent`/`TouchEvent`), which would\n * otherwise log once per dispatched event in a suite that fires hundreds of them.\n */\nexport function warnOnce(key: string, msg: string): void {\n  if (!isDev || warnedKeys.has(key)) return;\n\n  warnedKeys.add(key);\n  console.warn(`[@vielzeug/assay] ${msg}`);\n}\n\n/** @internal Test-only — clears \"warned once\" state so fallback-warning tests can run in any order. */\nexport function _resetWarnings(): void {\n  warnedKeys.clear();\n}\n","/**\n * Synchronous DOM event dispatchers for test environments.\n */\n\nimport { warnOnce } from './_dev';\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\nexport const createPointerEvent = (type: string, init: PointerEventInit = {}): Event => {\n  if (typeof PointerEvent !== 'undefined') {\n    return new PointerEvent(type, init);\n  }\n\n  warnOnce(\n    'pointer-fallback',\n    'PointerEvent is unavailable in this environment — falling back to MouseEvent. ' +\n      'pointerId/pointerType/isPrimary and similar pointer-only fields will be missing from every dispatched event.',\n  );\n\n  return new MouseEvent(type, init);\n};\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Fire low-level DOM events synchronously. Every method dispatches an appropriately-typed\n * `Event` subclass with sensible defaults and returns `dispatchEvent`'s own boolean result\n * (`false` when a listener called `preventDefault()`) — the same contract for all of them,\n * with no exceptions.\n *\n * @example\n * fire.click(button);\n * fire.keyDown(input, { key: 'Enter' });\n * fire.custom(el, 'value-change', { detail: 42 });\n */\nexport const fire = {\n  blur: (el: Element, opts?: FocusEventInit) => el.dispatchEvent(new FocusEvent('blur', { bubbles: true, ...opts })),\n  change: (el: Element, opts?: EventInit) => el.dispatchEvent(new Event('change', { bubbles: true, ...opts })),\n  click: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a CustomEvent. Pass `{ detail: ... }` for event detail. */\n  custom: (el: Element, name: string, opts?: CustomEventInit) =>\n    el.dispatchEvent(new CustomEvent(name, { bubbles: true, cancelable: true, composed: false, ...opts })),\n  /** Dispatch any pre-built Event instance directly. */\n  event: (el: Element, event: Event) => el.dispatchEvent(event),\n  focus: (el: Element, _name?: string, opts?: FocusEventInit) =>\n    el.dispatchEvent(new FocusEvent('focus', { bubbles: true, ...opts })),\n  input: (el: Element, opts?: EventInit) => el.dispatchEvent(new Event('input', { bubbles: true, ...opts })),\n  /** Fire a KeyboardEvent with a given type (keydown, keyup, keypress). */\n  keyboard: (el: Element, type: string, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent(type, { bubbles: true, cancelable: true, ...opts })),\n  keyDown: (el: Element, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent('keydown', { bubbles: true, cancelable: true, ...opts })),\n  keyUp: (el: Element, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent('keyup', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a MouseEvent with a given type (click, mousedown, etc.). */\n  mouse: (el: Element, type: string, opts?: MouseEventInit) =>\n    el.dispatchEvent(new MouseEvent(type, { bubbles: true, cancelable: true, ...opts })),\n  pointerCancel: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointercancel', { bubbles: true, cancelable: false, ...opts })),\n  pointerDown: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerdown', { bubbles: true, cancelable: true, ...opts })),\n  pointerEnter: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerenter', { bubbles: false, ...opts })),\n  pointerLeave: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerleave', { bubbles: false, ...opts })),\n  pointerMove: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointermove', { bubbles: true, cancelable: true, ...opts })),\n  pointerUp: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerup', { bubbles: true, cancelable: true, ...opts })),\n  submit: (el: Element, opts?: EventInit) =>\n    el.dispatchEvent(new Event('submit', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a touch event; falls back to CustomEvent in environments without TouchEvent. */\n  touch: (el: Element, type: string, opts?: EventInit) => {\n    if (typeof TouchEvent !== 'undefined') {\n      return el.dispatchEvent(new TouchEvent(type, { bubbles: true, cancelable: true, ...opts }));\n    }\n\n    warnOnce(\n      'touch-fallback',\n      'TouchEvent is unavailable in this environment — falling back to CustomEvent. The dispatched event will have no `touches`/`changedTouches` data.',\n    );\n\n    return el.dispatchEvent(new CustomEvent(type, { bubbles: true, cancelable: true, ...opts }));\n  },\n} as const;\n","/**\n * DOM query helpers for test environments.\n */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Scoped query helpers for any DOM element — see {@link within} */\nexport interface QueryScope {\n  query<E extends Element = Element>(selector: string): E | null;\n  queryAll<E extends Element = Element>(selector: string): E[];\n  queryByText<E extends Element = Element>(text: string, selector?: string): E | null;\n  queryAllByText<E extends Element = Element>(text: string, selector?: string): E[];\n  queryByTestId<E extends Element = Element>(testId: string): E | null;\n  queryAllByTestId<E extends Element = Element>(testId: string): E[];\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\n/** Query a single element within `root`. Equivalent to `root.querySelector(selector)`. */\nexport function query<E extends Element = Element>(root: Element | ShadowRoot, selector: string): E | null {\n  return root.querySelector<E>(selector);\n}\n\n/** Query every element within `root` matching `selector`. */\nexport function queryAll<E extends Element = Element>(root: Element | ShadowRoot, selector: string): E[] {\n  return Array.from(root.querySelectorAll<E>(selector));\n}\n\n/** Query a single element within `root` by its `data-testid` attribute. */\nexport function queryByTestId<E extends Element = Element>(root: Element | ShadowRoot, testId: string): E | null {\n  return root.querySelector<E>(`[data-testid=\"${testId}\"]`);\n}\n\n/** Query every element within `root` matching a `data-testid` attribute. */\nexport function queryAllByTestId<E extends Element = Element>(root: Element | ShadowRoot, testId: string): E[] {\n  return Array.from(root.querySelectorAll<E>(`[data-testid=\"${testId}\"]`));\n}\n\nexport function queryByText<E extends Element = Element>(\n  root: Element | ShadowRoot,\n  text: string,\n  selector: string,\n): E | null {\n  for (const el of root.querySelectorAll<E>(selector)) {\n    if (el.textContent?.trim() === text) return el;\n  }\n\n  return null;\n}\n\nexport function queryAllByText<E extends Element = Element>(\n  root: Element | ShadowRoot,\n  text: string,\n  selector: string,\n): E[] {\n  return Array.from(root.querySelectorAll<E>(selector)).filter((el) => el.textContent?.trim() === text);\n}\n\n/**\n * Queries the shadow root of a custom element for a matching CSS selector.\n * Returns `null` if the element has no shadow root or no match is found — safe to call on\n * both open-shadow custom elements and plain elements without checking `shadowRoot` first.\n */\nexport function queryInShadow<E extends Element = Element>(host: Element, selector: string): E | null {\n  return host.shadowRoot?.querySelector<E>(selector) ?? null;\n}\n\n/** Queries all matching elements inside the shadow root of a custom element. */\nexport function queryAllInShadow<E extends Element = Element>(host: Element, selector: string): E[] {\n  return Array.from(host.shadowRoot?.querySelectorAll<E>(selector) ?? []);\n}\n\n/**\n * Queries a shadow DOM element by its CSS `part` attribute — shorthand for\n * `queryInShadow(host, '[part=\"name\"]')`.\n *\n * @example\n * const btn = queryPart(carousel, 'prev-btn');\n * expect(btn).not.toBeNull();\n */\nexport function queryPart<E extends Element = Element>(host: Element, part: string): E | null {\n  return queryInShadow<E>(host, `[part=\"${part}\"]`);\n}\n\n/**\n * Returns the light-DOM children assigned to a named slot, or every slotted child (elements\n * with no `slot` attribute) when no name is given.\n *\n * @example\n * const slides = getSlotted(carousel);\n * expect(slides).toHaveLength(3);\n */\nexport function getSlotted<E extends Element = Element>(host: Element, slotName?: string): E[] {\n  const selector = slotName ? `[slot=\"${slotName}\"]` : ':not([slot])';\n\n  return Array.from(host.querySelectorAll<E>(`:scope > ${selector}`));\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Create query helpers scoped to any element — useful for slotted/light DOM content.\n *\n * @example\n * const panel = fixture.query('.panel')!;\n * const { query } = within(panel);\n * expect(query('.title')?.textContent).toBe('Hello');\n */\nexport function within(element: Element): QueryScope {\n  return {\n    query: <E extends Element = Element>(selector: string) => query<E>(element, selector),\n    queryAll: <E extends Element = Element>(selector: string) => queryAll<E>(element, selector),\n    queryAllByTestId: <E extends Element = Element>(testId: string) => queryAllByTestId<E>(element, testId),\n    queryAllByText: <E extends Element = Element>(text: string, selector = '*') =>\n      queryAllByText<E>(element, text, selector),\n    queryByTestId: <E extends Element = Element>(testId: string) => queryByTestId<E>(element, testId),\n    queryByText: <E extends Element = Element>(text: string, selector = '*') => queryByText<E>(element, text, selector),\n  };\n}\n","/**\n * Async waiting utilities for test environments.\n */\n\nimport { AssayTimeoutError } from './errors';\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface WaitOptions {\n  /** Maximum wait time in ms (default: 1000) */\n  timeout?: number;\n  /** Polling interval in ms (default: 50) */\n  interval?: number;\n  /** Message included in timeout error */\n  message?: string;\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Poll until a callback returns truthy (or void) without throwing.\n * Supports both boolean conditions and `expect()` assertions.\n *\n * - Returns truthy → success\n * - Returns `undefined` (e.g. bare `expect()` call) → success\n * - Returns falsy value → retry\n * - Throws → retry\n *\n * Always rejects with `AssayTimeoutError` on timeout, regardless of which of the two retry\n * reasons above was last observed — `instanceof AssayTimeoutError` is a reliable way to catch\n * \"the condition never became true\" without caring whether the last attempt returned falsy or\n * threw. The original failure (an assertion's message, a thrown error) is preserved as `.cause`,\n * not merged into a mutated copy of it — `fn`'s thrown errors are caller-owned and never mutated.\n *\n * @example\n * await waitFor(() => query('.status')?.textContent === 'loaded');\n * await waitFor(() => expect(count).toBe(3));\n */\nexport async function waitFor(\n  fn: () => unknown,\n  { interval = 50, message, timeout = 1000 }: WaitOptions = {},\n): Promise<void> {\n  const deadline = Date.now() + timeout;\n  let lastError: unknown;\n\n  // Single loop, one `fn()` call site — always tries once more before checking the deadline,\n  // so a condition that becomes true exactly as the timeout elapses still succeeds.\n  for (;;) {\n    try {\n      const result = await fn();\n\n      if (result === undefined || result) return;\n    } catch (e) {\n      lastError = e;\n    }\n\n    if (Date.now() >= deadline) break;\n\n    await wait(interval);\n  }\n\n  // The default timing summary always appears — a custom `message` adds context in front of it\n  // rather than replacing it, so a debugging session never loses \"how long did this actually wait\".\n  const timing = `waitFor timed out after ${timeout}ms`;\n  const base = message ? `${message} (${timing})` : timing;\n  const cause = lastError instanceof Error ? lastError.message : lastError != null ? String(lastError) : undefined;\n\n  throw new AssayTimeoutError(cause ? `${base}\\n${cause}` : base, { cause: lastError });\n}\n\n/**\n * Resolve when the target element emits the given event.\n *\n * @example\n * const promise = waitForEvent(el, 'change');\n * fire.click(trigger);\n * const event = await promise;\n */\nexport function waitForEvent<T extends Event = Event>(element: Element, name: string, timeout = 1000): Promise<T> {\n  return new Promise((resolve, reject) => {\n    const onEvent = (e: Event): void => {\n      clearTimeout(timer);\n      resolve(e as T);\n    };\n    const timer = setTimeout(() => {\n      element.removeEventListener(name, onEvent);\n      reject(new AssayTimeoutError(`waitForEvent: \"${name}\" timed out after ${timeout}ms`));\n    }, timeout);\n\n    element.addEventListener(name, onEvent, { once: true });\n  });\n}\n\n/**\n * Resolves after one microtask tick (`queueMicrotask`). Use to wait for reactivity (signal\n * effects, promise-chain continuations) to settle without moving into the macrotask queue —\n * cheaper and more precise than `wait(0)`, which yields to a full `setTimeout` turn instead.\n */\nexport const nextTick = (): Promise<void> =>\n  new Promise((resolve) => {\n    queueMicrotask(resolve);\n  });\n\n/**\n * Resolves after `ms` milliseconds. Prefer `nextTick()` for reactive updates and `waitFor()`\n * for polling a condition — reach for this only when a real macrotask delay is what the code\n * under test actually depends on (e.g. a debounce timer).\n */\nexport const wait = (ms = 0): Promise<void> =>\n  new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n"],"mappings":"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"}

package/dist/assay.iife.js

@@ -0,0 +1,2 @@
+var Assay=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},n=class extends t{},r=!globalThis.__ASSAY_PROD__,i=new Set;function a(e,t){!r||i.has(e)||(i.add(e),console.warn(`[@vielzeug/assay] ${t}`))}var o=(e,t={})=>typeof PointerEvent<`u`?new PointerEvent(e,t):(a(`pointer-fallback`,`PointerEvent is unavailable in this environment — falling back to MouseEvent. pointerId/pointerType/isPrimary and similar pointer-only fields will be missing from every dispatched event.`),new MouseEvent(e,t)),s={blur:(e,t)=>e.dispatchEvent(new FocusEvent(`blur`,{bubbles:!0,...t})),change:(e,t)=>e.dispatchEvent(new Event(`change`,{bubbles:!0,...t})),click:(e,t)=>e.dispatchEvent(new MouseEvent(`click`,{bubbles:!0,cancelable:!0,...t})),custom:(e,t,n)=>e.dispatchEvent(new CustomEvent(t,{bubbles:!0,cancelable:!0,composed:!1,...n})),event:(e,t)=>e.dispatchEvent(t),focus:(e,t,n)=>e.dispatchEvent(new FocusEvent(`focus`,{bubbles:!0,...n})),input:(e,t)=>e.dispatchEvent(new Event(`input`,{bubbles:!0,...t})),keyboard:(e,t,n)=>e.dispatchEvent(new KeyboardEvent(t,{bubbles:!0,cancelable:!0,...n})),keyDown:(e,t)=>e.dispatchEvent(new KeyboardEvent(`keydown`,{bubbles:!0,cancelable:!0,...t})),keyUp:(e,t)=>e.dispatchEvent(new KeyboardEvent(`keyup`,{bubbles:!0,cancelable:!0,...t})),mouse:(e,t,n)=>e.dispatchEvent(new MouseEvent(t,{bubbles:!0,cancelable:!0,...n})),pointerCancel:(e,t)=>e.dispatchEvent(o(`pointercancel`,{bubbles:!0,cancelable:!1,...t})),pointerDown:(e,t)=>e.dispatchEvent(o(`pointerdown`,{bubbles:!0,cancelable:!0,...t})),pointerEnter:(e,t)=>e.dispatchEvent(o(`pointerenter`,{bubbles:!1,...t})),pointerLeave:(e,t)=>e.dispatchEvent(o(`pointerleave`,{bubbles:!1,...t})),pointerMove:(e,t)=>e.dispatchEvent(o(`pointermove`,{bubbles:!0,cancelable:!0,...t})),pointerUp:(e,t)=>e.dispatchEvent(o(`pointerup`,{bubbles:!0,cancelable:!0,...t})),submit:(e,t)=>e.dispatchEvent(new Event(`submit`,{bubbles:!0,cancelable:!0,...t})),touch:(e,t,n)=>typeof TouchEvent<`u`?e.dispatchEvent(new TouchEvent(t,{bubbles:!0,cancelable:!0,...n})):(a(`touch-fallback`,"TouchEvent is unavailable in this environment — falling back to CustomEvent. The dispatched event will have no `touches`/`changedTouches` data."),e.dispatchEvent(new CustomEvent(t,{bubbles:!0,cancelable:!0,...n})))};function c(e,t){return e.querySelector(t)}function l(e,t){return Array.from(e.querySelectorAll(t))}function u(e,t){return e.querySelector(`[data-testid="${t}"]`)}function d(e,t){return Array.from(e.querySelectorAll(`[data-testid="${t}"]`))}function f(e,t,n){for(let r of e.querySelectorAll(n))if(r.textContent?.trim()===t)return r;return null}function p(e,t,n){return Array.from(e.querySelectorAll(n)).filter(e=>e.textContent?.trim()===t)}function m(e,t){return e.shadowRoot?.querySelector(t)??null}function h(e,t){return Array.from(e.shadowRoot?.querySelectorAll(t)??[])}function g(e,t){return m(e,`[part="${t}"]`)}function _(e,t){let n=t?`[slot="${t}"]`:`:not([slot])`;return Array.from(e.querySelectorAll(`:scope > ${n}`))}function v(e){return{query:t=>c(e,t),queryAll:t=>l(e,t),queryAllByTestId:t=>d(e,t),queryAllByText:(t,n=`*`)=>p(e,t,n),queryByTestId:t=>u(e,t),queryByText:(t,n=`*`)=>f(e,t,n)}}async function y(e,{interval:t=50,message:r,timeout:i=1e3}={}){let a=Date.now()+i,o;for(;;){try{let t=await e();if(t===void 0||t)return}catch(e){o=e}if(Date.now()>=a)break;await S(t)}let s=`waitFor timed out after ${i}ms`,c=r?`${r} (${s})`:s,l=o instanceof Error?o.message:o==null?void 0:String(o);throw new n(l?`${c}\n${l}`:c,{cause:o})}function b(e,t,r=1e3){return new Promise((i,a)=>{let o=e=>{clearTimeout(s),i(e)},s=setTimeout(()=>{e.removeEventListener(t,o),a(new n(`waitForEvent: "${t}" timed out after ${r}ms`))},r);e.addEventListener(t,o,{once:!0})})}var x=()=>new Promise(e=>{queueMicrotask(e)}),S=(e=0)=>new Promise(t=>{setTimeout(t,e)});return e.AssayError=t,e.AssayTimeoutError=n,e.createPointerEvent=o,e.fire=s,e.getSlotted=_,e.nextTick=x,e.query=c,e.queryAll=l,e.queryAllByTestId=d,e.queryAllByText=p,e.queryAllInShadow=h,e.queryByTestId=u,e.queryByText=f,e.queryInShadow=m,e.queryPart=g,e.wait=S,e.waitFor=y,e.waitForEvent=b,e.within=v,e})({});
+//# sourceMappingURL=assay.iife.js.map

package/dist/assay.iife.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assay.iife.js","names":[],"sources":["../src/errors.ts","../src/_dev.ts","../src/events.ts","../src/query.ts","../src/wait.ts"],"sourcesContent":["/** Base class for all Assay errors. Use `instanceof AssayError` to catch any Assay-originated error. */\nexport class AssayError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is AssayError {\n    return err instanceof AssayError;\n  }\n}\n\n/** Thrown by `waitFor`/`waitForEvent` when a condition is not met within the timeout. */\nexport class AssayTimeoutError extends AssayError {}\n","const isDev = !(globalThis as { __ASSAY_PROD__?: boolean }).__ASSAY_PROD__;\n\nconst warnedKeys = new Set<string>();\n\n/**\n * @internal Warn at most once per `key` for the lifetime of the module — used for\n * environment-capability fallbacks (e.g. missing `PointerEvent`/`TouchEvent`), which would\n * otherwise log once per dispatched event in a suite that fires hundreds of them.\n */\nexport function warnOnce(key: string, msg: string): void {\n  if (!isDev || warnedKeys.has(key)) return;\n\n  warnedKeys.add(key);\n  console.warn(`[@vielzeug/assay] ${msg}`);\n}\n\n/** @internal Test-only — clears \"warned once\" state so fallback-warning tests can run in any order. */\nexport function _resetWarnings(): void {\n  warnedKeys.clear();\n}\n","/**\n * Synchronous DOM event dispatchers for test environments.\n */\n\nimport { warnOnce } from './_dev';\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\nexport const createPointerEvent = (type: string, init: PointerEventInit = {}): Event => {\n  if (typeof PointerEvent !== 'undefined') {\n    return new PointerEvent(type, init);\n  }\n\n  warnOnce(\n    'pointer-fallback',\n    'PointerEvent is unavailable in this environment — falling back to MouseEvent. ' +\n      'pointerId/pointerType/isPrimary and similar pointer-only fields will be missing from every dispatched event.',\n  );\n\n  return new MouseEvent(type, init);\n};\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Fire low-level DOM events synchronously. Every method dispatches an appropriately-typed\n * `Event` subclass with sensible defaults and returns `dispatchEvent`'s own boolean result\n * (`false` when a listener called `preventDefault()`) — the same contract for all of them,\n * with no exceptions.\n *\n * @example\n * fire.click(button);\n * fire.keyDown(input, { key: 'Enter' });\n * fire.custom(el, 'value-change', { detail: 42 });\n */\nexport const fire = {\n  blur: (el: Element, opts?: FocusEventInit) => el.dispatchEvent(new FocusEvent('blur', { bubbles: true, ...opts })),\n  change: (el: Element, opts?: EventInit) => el.dispatchEvent(new Event('change', { bubbles: true, ...opts })),\n  click: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a CustomEvent. Pass `{ detail: ... }` for event detail. */\n  custom: (el: Element, name: string, opts?: CustomEventInit) =>\n    el.dispatchEvent(new CustomEvent(name, { bubbles: true, cancelable: true, composed: false, ...opts })),\n  /** Dispatch any pre-built Event instance directly. */\n  event: (el: Element, event: Event) => el.dispatchEvent(event),\n  focus: (el: Element, _name?: string, opts?: FocusEventInit) =>\n    el.dispatchEvent(new FocusEvent('focus', { bubbles: true, ...opts })),\n  input: (el: Element, opts?: EventInit) => el.dispatchEvent(new Event('input', { bubbles: true, ...opts })),\n  /** Fire a KeyboardEvent with a given type (keydown, keyup, keypress). */\n  keyboard: (el: Element, type: string, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent(type, { bubbles: true, cancelable: true, ...opts })),\n  keyDown: (el: Element, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent('keydown', { bubbles: true, cancelable: true, ...opts })),\n  keyUp: (el: Element, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent('keyup', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a MouseEvent with a given type (click, mousedown, etc.). */\n  mouse: (el: Element, type: string, opts?: MouseEventInit) =>\n    el.dispatchEvent(new MouseEvent(type, { bubbles: true, cancelable: true, ...opts })),\n  pointerCancel: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointercancel', { bubbles: true, cancelable: false, ...opts })),\n  pointerDown: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerdown', { bubbles: true, cancelable: true, ...opts })),\n  pointerEnter: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerenter', { bubbles: false, ...opts })),\n  pointerLeave: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerleave', { bubbles: false, ...opts })),\n  pointerMove: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointermove', { bubbles: true, cancelable: true, ...opts })),\n  pointerUp: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerup', { bubbles: true, cancelable: true, ...opts })),\n  submit: (el: Element, opts?: EventInit) =>\n    el.dispatchEvent(new Event('submit', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a touch event; falls back to CustomEvent in environments without TouchEvent. */\n  touch: (el: Element, type: string, opts?: EventInit) => {\n    if (typeof TouchEvent !== 'undefined') {\n      return el.dispatchEvent(new TouchEvent(type, { bubbles: true, cancelable: true, ...opts }));\n    }\n\n    warnOnce(\n      'touch-fallback',\n      'TouchEvent is unavailable in this environment — falling back to CustomEvent. The dispatched event will have no `touches`/`changedTouches` data.',\n    );\n\n    return el.dispatchEvent(new CustomEvent(type, { bubbles: true, cancelable: true, ...opts }));\n  },\n} as const;\n","/**\n * DOM query helpers for test environments.\n */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Scoped query helpers for any DOM element — see {@link within} */\nexport interface QueryScope {\n  query<E extends Element = Element>(selector: string): E | null;\n  queryAll<E extends Element = Element>(selector: string): E[];\n  queryByText<E extends Element = Element>(text: string, selector?: string): E | null;\n  queryAllByText<E extends Element = Element>(text: string, selector?: string): E[];\n  queryByTestId<E extends Element = Element>(testId: string): E | null;\n  queryAllByTestId<E extends Element = Element>(testId: string): E[];\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\n/** Query a single element within `root`. Equivalent to `root.querySelector(selector)`. */\nexport function query<E extends Element = Element>(root: Element | ShadowRoot, selector: string): E | null {\n  return root.querySelector<E>(selector);\n}\n\n/** Query every element within `root` matching `selector`. */\nexport function queryAll<E extends Element = Element>(root: Element | ShadowRoot, selector: string): E[] {\n  return Array.from(root.querySelectorAll<E>(selector));\n}\n\n/** Query a single element within `root` by its `data-testid` attribute. */\nexport function queryByTestId<E extends Element = Element>(root: Element | ShadowRoot, testId: string): E | null {\n  return root.querySelector<E>(`[data-testid=\"${testId}\"]`);\n}\n\n/** Query every element within `root` matching a `data-testid` attribute. */\nexport function queryAllByTestId<E extends Element = Element>(root: Element | ShadowRoot, testId: string): E[] {\n  return Array.from(root.querySelectorAll<E>(`[data-testid=\"${testId}\"]`));\n}\n\nexport function queryByText<E extends Element = Element>(\n  root: Element | ShadowRoot,\n  text: string,\n  selector: string,\n): E | null {\n  for (const el of root.querySelectorAll<E>(selector)) {\n    if (el.textContent?.trim() === text) return el;\n  }\n\n  return null;\n}\n\nexport function queryAllByText<E extends Element = Element>(\n  root: Element | ShadowRoot,\n  text: string,\n  selector: string,\n): E[] {\n  return Array.from(root.querySelectorAll<E>(selector)).filter((el) => el.textContent?.trim() === text);\n}\n\n/**\n * Queries the shadow root of a custom element for a matching CSS selector.\n * Returns `null` if the element has no shadow root or no match is found — safe to call on\n * both open-shadow custom elements and plain elements without checking `shadowRoot` first.\n */\nexport function queryInShadow<E extends Element = Element>(host: Element, selector: string): E | null {\n  return host.shadowRoot?.querySelector<E>(selector) ?? null;\n}\n\n/** Queries all matching elements inside the shadow root of a custom element. */\nexport function queryAllInShadow<E extends Element = Element>(host: Element, selector: string): E[] {\n  return Array.from(host.shadowRoot?.querySelectorAll<E>(selector) ?? []);\n}\n\n/**\n * Queries a shadow DOM element by its CSS `part` attribute — shorthand for\n * `queryInShadow(host, '[part=\"name\"]')`.\n *\n * @example\n * const btn = queryPart(carousel, 'prev-btn');\n * expect(btn).not.toBeNull();\n */\nexport function queryPart<E extends Element = Element>(host: Element, part: string): E | null {\n  return queryInShadow<E>(host, `[part=\"${part}\"]`);\n}\n\n/**\n * Returns the light-DOM children assigned to a named slot, or every slotted child (elements\n * with no `slot` attribute) when no name is given.\n *\n * @example\n * const slides = getSlotted(carousel);\n * expect(slides).toHaveLength(3);\n */\nexport function getSlotted<E extends Element = Element>(host: Element, slotName?: string): E[] {\n  const selector = slotName ? `[slot=\"${slotName}\"]` : ':not([slot])';\n\n  return Array.from(host.querySelectorAll<E>(`:scope > ${selector}`));\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Create query helpers scoped to any element — useful for slotted/light DOM content.\n *\n * @example\n * const panel = fixture.query('.panel')!;\n * const { query } = within(panel);\n * expect(query('.title')?.textContent).toBe('Hello');\n */\nexport function within(element: Element): QueryScope {\n  return {\n    query: <E extends Element = Element>(selector: string) => query<E>(element, selector),\n    queryAll: <E extends Element = Element>(selector: string) => queryAll<E>(element, selector),\n    queryAllByTestId: <E extends Element = Element>(testId: string) => queryAllByTestId<E>(element, testId),\n    queryAllByText: <E extends Element = Element>(text: string, selector = '*') =>\n      queryAllByText<E>(element, text, selector),\n    queryByTestId: <E extends Element = Element>(testId: string) => queryByTestId<E>(element, testId),\n    queryByText: <E extends Element = Element>(text: string, selector = '*') => queryByText<E>(element, text, selector),\n  };\n}\n","/**\n * Async waiting utilities for test environments.\n */\n\nimport { AssayTimeoutError } from './errors';\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface WaitOptions {\n  /** Maximum wait time in ms (default: 1000) */\n  timeout?: number;\n  /** Polling interval in ms (default: 50) */\n  interval?: number;\n  /** Message included in timeout error */\n  message?: string;\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Poll until a callback returns truthy (or void) without throwing.\n * Supports both boolean conditions and `expect()` assertions.\n *\n * - Returns truthy → success\n * - Returns `undefined` (e.g. bare `expect()` call) → success\n * - Returns falsy value → retry\n * - Throws → retry\n *\n * Always rejects with `AssayTimeoutError` on timeout, regardless of which of the two retry\n * reasons above was last observed — `instanceof AssayTimeoutError` is a reliable way to catch\n * \"the condition never became true\" without caring whether the last attempt returned falsy or\n * threw. The original failure (an assertion's message, a thrown error) is preserved as `.cause`,\n * not merged into a mutated copy of it — `fn`'s thrown errors are caller-owned and never mutated.\n *\n * @example\n * await waitFor(() => query('.status')?.textContent === 'loaded');\n * await waitFor(() => expect(count).toBe(3));\n */\nexport async function waitFor(\n  fn: () => unknown,\n  { interval = 50, message, timeout = 1000 }: WaitOptions = {},\n): Promise<void> {\n  const deadline = Date.now() + timeout;\n  let lastError: unknown;\n\n  // Single loop, one `fn()` call site — always tries once more before checking the deadline,\n  // so a condition that becomes true exactly as the timeout elapses still succeeds.\n  for (;;) {\n    try {\n      const result = await fn();\n\n      if (result === undefined || result) return;\n    } catch (e) {\n      lastError = e;\n    }\n\n    if (Date.now() >= deadline) break;\n\n    await wait(interval);\n  }\n\n  // The default timing summary always appears — a custom `message` adds context in front of it\n  // rather than replacing it, so a debugging session never loses \"how long did this actually wait\".\n  const timing = `waitFor timed out after ${timeout}ms`;\n  const base = message ? `${message} (${timing})` : timing;\n  const cause = lastError instanceof Error ? lastError.message : lastError != null ? String(lastError) : undefined;\n\n  throw new AssayTimeoutError(cause ? `${base}\\n${cause}` : base, { cause: lastError });\n}\n\n/**\n * Resolve when the target element emits the given event.\n *\n * @example\n * const promise = waitForEvent(el, 'change');\n * fire.click(trigger);\n * const event = await promise;\n */\nexport function waitForEvent<T extends Event = Event>(element: Element, name: string, timeout = 1000): Promise<T> {\n  return new Promise((resolve, reject) => {\n    const onEvent = (e: Event): void => {\n      clearTimeout(timer);\n      resolve(e as T);\n    };\n    const timer = setTimeout(() => {\n      element.removeEventListener(name, onEvent);\n      reject(new AssayTimeoutError(`waitForEvent: \"${name}\" timed out after ${timeout}ms`));\n    }, timeout);\n\n    element.addEventListener(name, onEvent, { once: true });\n  });\n}\n\n/**\n * Resolves after one microtask tick (`queueMicrotask`). Use to wait for reactivity (signal\n * effects, promise-chain continuations) to settle without moving into the macrotask queue —\n * cheaper and more precise than `wait(0)`, which yields to a full `setTimeout` turn instead.\n */\nexport const nextTick = (): Promise<void> =>\n  new Promise((resolve) => {\n    queueMicrotask(resolve);\n  });\n\n/**\n * Resolves after `ms` milliseconds. Prefer `nextTick()` for reactive updates and `waitFor()`\n * for polling a condition — reach for this only when a real macrotask delay is what the code\n * under test actually depends on (e.g. a debounce timer).\n */\nexport const wait = (ms = 0): Promise<void> =>\n  new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n"],"mappings":"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"}

package/dist/assay.js

@@ -0,0 +1,2 @@
+var e=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},t=class extends e{},n=!globalThis.__ASSAY_PROD__,r=new Set;function i(e,t){!n||r.has(e)||(r.add(e),console.warn(`[@vielzeug/assay] ${t}`))}var a=(e,t={})=>typeof PointerEvent<`u`?new PointerEvent(e,t):(i(`pointer-fallback`,`PointerEvent is unavailable in this environment — falling back to MouseEvent. pointerId/pointerType/isPrimary and similar pointer-only fields will be missing from every dispatched event.`),new MouseEvent(e,t)),o={blur:(e,t)=>e.dispatchEvent(new FocusEvent(`blur`,{bubbles:!0,...t})),change:(e,t)=>e.dispatchEvent(new Event(`change`,{bubbles:!0,...t})),click:(e,t)=>e.dispatchEvent(new MouseEvent(`click`,{bubbles:!0,cancelable:!0,...t})),custom:(e,t,n)=>e.dispatchEvent(new CustomEvent(t,{bubbles:!0,cancelable:!0,composed:!1,...n})),event:(e,t)=>e.dispatchEvent(t),focus:(e,t,n)=>e.dispatchEvent(new FocusEvent(`focus`,{bubbles:!0,...n})),input:(e,t)=>e.dispatchEvent(new Event(`input`,{bubbles:!0,...t})),keyboard:(e,t,n)=>e.dispatchEvent(new KeyboardEvent(t,{bubbles:!0,cancelable:!0,...n})),keyDown:(e,t)=>e.dispatchEvent(new KeyboardEvent(`keydown`,{bubbles:!0,cancelable:!0,...t})),keyUp:(e,t)=>e.dispatchEvent(new KeyboardEvent(`keyup`,{bubbles:!0,cancelable:!0,...t})),mouse:(e,t,n)=>e.dispatchEvent(new MouseEvent(t,{bubbles:!0,cancelable:!0,...n})),pointerCancel:(e,t)=>e.dispatchEvent(a(`pointercancel`,{bubbles:!0,cancelable:!1,...t})),pointerDown:(e,t)=>e.dispatchEvent(a(`pointerdown`,{bubbles:!0,cancelable:!0,...t})),pointerEnter:(e,t)=>e.dispatchEvent(a(`pointerenter`,{bubbles:!1,...t})),pointerLeave:(e,t)=>e.dispatchEvent(a(`pointerleave`,{bubbles:!1,...t})),pointerMove:(e,t)=>e.dispatchEvent(a(`pointermove`,{bubbles:!0,cancelable:!0,...t})),pointerUp:(e,t)=>e.dispatchEvent(a(`pointerup`,{bubbles:!0,cancelable:!0,...t})),submit:(e,t)=>e.dispatchEvent(new Event(`submit`,{bubbles:!0,cancelable:!0,...t})),touch:(e,t,n)=>typeof TouchEvent<`u`?e.dispatchEvent(new TouchEvent(t,{bubbles:!0,cancelable:!0,...n})):(i(`touch-fallback`,"TouchEvent is unavailable in this environment — falling back to CustomEvent. The dispatched event will have no `touches`/`changedTouches` data."),e.dispatchEvent(new CustomEvent(t,{bubbles:!0,cancelable:!0,...n})))};function s(e,t){return e.querySelector(t)}function c(e,t){return Array.from(e.querySelectorAll(t))}function l(e,t){return e.querySelector(`[data-testid="${t}"]`)}function u(e,t){return Array.from(e.querySelectorAll(`[data-testid="${t}"]`))}function d(e,t,n){for(let r of e.querySelectorAll(n))if(r.textContent?.trim()===t)return r;return null}function f(e,t,n){return Array.from(e.querySelectorAll(n)).filter(e=>e.textContent?.trim()===t)}function p(e,t){return e.shadowRoot?.querySelector(t)??null}function m(e,t){return Array.from(e.shadowRoot?.querySelectorAll(t)??[])}function h(e,t){return p(e,`[part="${t}"]`)}function g(e,t){let n=t?`[slot="${t}"]`:`:not([slot])`;return Array.from(e.querySelectorAll(`:scope > ${n}`))}function _(e){return{query:t=>s(e,t),queryAll:t=>c(e,t),queryAllByTestId:t=>u(e,t),queryAllByText:(t,n=`*`)=>f(e,t,n),queryByTestId:t=>l(e,t),queryByText:(t,n=`*`)=>d(e,t,n)}}async function v(e,{interval:n=50,message:r,timeout:i=1e3}={}){let a=Date.now()+i,o;for(;;){try{let t=await e();if(t===void 0||t)return}catch(e){o=e}if(Date.now()>=a)break;await x(n)}let s=`waitFor timed out after ${i}ms`,c=r?`${r} (${s})`:s,l=o instanceof Error?o.message:o==null?void 0:String(o);throw new t(l?`${c}\n${l}`:c,{cause:o})}function y(e,n,r=1e3){return new Promise((i,a)=>{let o=e=>{clearTimeout(s),i(e)},s=setTimeout(()=>{e.removeEventListener(n,o),a(new t(`waitForEvent: "${n}" timed out after ${r}ms`))},r);e.addEventListener(n,o,{once:!0})})}var b=()=>new Promise(e=>{queueMicrotask(e)}),x=(e=0)=>new Promise(t=>{setTimeout(t,e)});export{e as AssayError,t as AssayTimeoutError,a as createPointerEvent,o as fire,g as getSlotted,b as nextTick,s as query,c as queryAll,u as queryAllByTestId,f as queryAllByText,m as queryAllInShadow,l as queryByTestId,d as queryByText,p as queryInShadow,h as queryPart,x as wait,v as waitFor,y as waitForEvent,_ as within};
+//# sourceMappingURL=assay.js.map

package/dist/assay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assay.js","names":[],"sources":["../src/errors.ts","../src/_dev.ts","../src/events.ts","../src/query.ts","../src/wait.ts"],"sourcesContent":["/** Base class for all Assay errors. Use `instanceof AssayError` to catch any Assay-originated error. */\nexport class AssayError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is AssayError {\n    return err instanceof AssayError;\n  }\n}\n\n/** Thrown by `waitFor`/`waitForEvent` when a condition is not met within the timeout. */\nexport class AssayTimeoutError extends AssayError {}\n","const isDev = !(globalThis as { __ASSAY_PROD__?: boolean }).__ASSAY_PROD__;\n\nconst warnedKeys = new Set<string>();\n\n/**\n * @internal Warn at most once per `key` for the lifetime of the module — used for\n * environment-capability fallbacks (e.g. missing `PointerEvent`/`TouchEvent`), which would\n * otherwise log once per dispatched event in a suite that fires hundreds of them.\n */\nexport function warnOnce(key: string, msg: string): void {\n  if (!isDev || warnedKeys.has(key)) return;\n\n  warnedKeys.add(key);\n  console.warn(`[@vielzeug/assay] ${msg}`);\n}\n\n/** @internal Test-only — clears \"warned once\" state so fallback-warning tests can run in any order. */\nexport function _resetWarnings(): void {\n  warnedKeys.clear();\n}\n","/**\n * Synchronous DOM event dispatchers for test environments.\n */\n\nimport { warnOnce } from './_dev';\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\nexport const createPointerEvent = (type: string, init: PointerEventInit = {}): Event => {\n  if (typeof PointerEvent !== 'undefined') {\n    return new PointerEvent(type, init);\n  }\n\n  warnOnce(\n    'pointer-fallback',\n    'PointerEvent is unavailable in this environment — falling back to MouseEvent. ' +\n      'pointerId/pointerType/isPrimary and similar pointer-only fields will be missing from every dispatched event.',\n  );\n\n  return new MouseEvent(type, init);\n};\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Fire low-level DOM events synchronously. Every method dispatches an appropriately-typed\n * `Event` subclass with sensible defaults and returns `dispatchEvent`'s own boolean result\n * (`false` when a listener called `preventDefault()`) — the same contract for all of them,\n * with no exceptions.\n *\n * @example\n * fire.click(button);\n * fire.keyDown(input, { key: 'Enter' });\n * fire.custom(el, 'value-change', { detail: 42 });\n */\nexport const fire = {\n  blur: (el: Element, opts?: FocusEventInit) => el.dispatchEvent(new FocusEvent('blur', { bubbles: true, ...opts })),\n  change: (el: Element, opts?: EventInit) => el.dispatchEvent(new Event('change', { bubbles: true, ...opts })),\n  click: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a CustomEvent. Pass `{ detail: ... }` for event detail. */\n  custom: (el: Element, name: string, opts?: CustomEventInit) =>\n    el.dispatchEvent(new CustomEvent(name, { bubbles: true, cancelable: true, composed: false, ...opts })),\n  /** Dispatch any pre-built Event instance directly. */\n  event: (el: Element, event: Event) => el.dispatchEvent(event),\n  focus: (el: Element, _name?: string, opts?: FocusEventInit) =>\n    el.dispatchEvent(new FocusEvent('focus', { bubbles: true, ...opts })),\n  input: (el: Element, opts?: EventInit) => el.dispatchEvent(new Event('input', { bubbles: true, ...opts })),\n  /** Fire a KeyboardEvent with a given type (keydown, keyup, keypress). */\n  keyboard: (el: Element, type: string, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent(type, { bubbles: true, cancelable: true, ...opts })),\n  keyDown: (el: Element, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent('keydown', { bubbles: true, cancelable: true, ...opts })),\n  keyUp: (el: Element, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent('keyup', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a MouseEvent with a given type (click, mousedown, etc.). */\n  mouse: (el: Element, type: string, opts?: MouseEventInit) =>\n    el.dispatchEvent(new MouseEvent(type, { bubbles: true, cancelable: true, ...opts })),\n  pointerCancel: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointercancel', { bubbles: true, cancelable: false, ...opts })),\n  pointerDown: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerdown', { bubbles: true, cancelable: true, ...opts })),\n  pointerEnter: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerenter', { bubbles: false, ...opts })),\n  pointerLeave: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerleave', { bubbles: false, ...opts })),\n  pointerMove: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointermove', { bubbles: true, cancelable: true, ...opts })),\n  pointerUp: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerup', { bubbles: true, cancelable: true, ...opts })),\n  submit: (el: Element, opts?: EventInit) =>\n    el.dispatchEvent(new Event('submit', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a touch event; falls back to CustomEvent in environments without TouchEvent. */\n  touch: (el: Element, type: string, opts?: EventInit) => {\n    if (typeof TouchEvent !== 'undefined') {\n      return el.dispatchEvent(new TouchEvent(type, { bubbles: true, cancelable: true, ...opts }));\n    }\n\n    warnOnce(\n      'touch-fallback',\n      'TouchEvent is unavailable in this environment — falling back to CustomEvent. The dispatched event will have no `touches`/`changedTouches` data.',\n    );\n\n    return el.dispatchEvent(new CustomEvent(type, { bubbles: true, cancelable: true, ...opts }));\n  },\n} as const;\n","/**\n * DOM query helpers for test environments.\n */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Scoped query helpers for any DOM element — see {@link within} */\nexport interface QueryScope {\n  query<E extends Element = Element>(selector: string): E | null;\n  queryAll<E extends Element = Element>(selector: string): E[];\n  queryByText<E extends Element = Element>(text: string, selector?: string): E | null;\n  queryAllByText<E extends Element = Element>(text: string, selector?: string): E[];\n  queryByTestId<E extends Element = Element>(testId: string): E | null;\n  queryAllByTestId<E extends Element = Element>(testId: string): E[];\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\n/** Query a single element within `root`. Equivalent to `root.querySelector(selector)`. */\nexport function query<E extends Element = Element>(root: Element | ShadowRoot, selector: string): E | null {\n  return root.querySelector<E>(selector);\n}\n\n/** Query every element within `root` matching `selector`. */\nexport function queryAll<E extends Element = Element>(root: Element | ShadowRoot, selector: string): E[] {\n  return Array.from(root.querySelectorAll<E>(selector));\n}\n\n/** Query a single element within `root` by its `data-testid` attribute. */\nexport function queryByTestId<E extends Element = Element>(root: Element | ShadowRoot, testId: string): E | null {\n  return root.querySelector<E>(`[data-testid=\"${testId}\"]`);\n}\n\n/** Query every element within `root` matching a `data-testid` attribute. */\nexport function queryAllByTestId<E extends Element = Element>(root: Element | ShadowRoot, testId: string): E[] {\n  return Array.from(root.querySelectorAll<E>(`[data-testid=\"${testId}\"]`));\n}\n\nexport function queryByText<E extends Element = Element>(\n  root: Element | ShadowRoot,\n  text: string,\n  selector: string,\n): E | null {\n  for (const el of root.querySelectorAll<E>(selector)) {\n    if (el.textContent?.trim() === text) return el;\n  }\n\n  return null;\n}\n\nexport function queryAllByText<E extends Element = Element>(\n  root: Element | ShadowRoot,\n  text: string,\n  selector: string,\n): E[] {\n  return Array.from(root.querySelectorAll<E>(selector)).filter((el) => el.textContent?.trim() === text);\n}\n\n/**\n * Queries the shadow root of a custom element for a matching CSS selector.\n * Returns `null` if the element has no shadow root or no match is found — safe to call on\n * both open-shadow custom elements and plain elements without checking `shadowRoot` first.\n */\nexport function queryInShadow<E extends Element = Element>(host: Element, selector: string): E | null {\n  return host.shadowRoot?.querySelector<E>(selector) ?? null;\n}\n\n/** Queries all matching elements inside the shadow root of a custom element. */\nexport function queryAllInShadow<E extends Element = Element>(host: Element, selector: string): E[] {\n  return Array.from(host.shadowRoot?.querySelectorAll<E>(selector) ?? []);\n}\n\n/**\n * Queries a shadow DOM element by its CSS `part` attribute — shorthand for\n * `queryInShadow(host, '[part=\"name\"]')`.\n *\n * @example\n * const btn = queryPart(carousel, 'prev-btn');\n * expect(btn).not.toBeNull();\n */\nexport function queryPart<E extends Element = Element>(host: Element, part: string): E | null {\n  return queryInShadow<E>(host, `[part=\"${part}\"]`);\n}\n\n/**\n * Returns the light-DOM children assigned to a named slot, or every slotted child (elements\n * with no `slot` attribute) when no name is given.\n *\n * @example\n * const slides = getSlotted(carousel);\n * expect(slides).toHaveLength(3);\n */\nexport function getSlotted<E extends Element = Element>(host: Element, slotName?: string): E[] {\n  const selector = slotName ? `[slot=\"${slotName}\"]` : ':not([slot])';\n\n  return Array.from(host.querySelectorAll<E>(`:scope > ${selector}`));\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Create query helpers scoped to any element — useful for slotted/light DOM content.\n *\n * @example\n * const panel = fixture.query('.panel')!;\n * const { query } = within(panel);\n * expect(query('.title')?.textContent).toBe('Hello');\n */\nexport function within(element: Element): QueryScope {\n  return {\n    query: <E extends Element = Element>(selector: string) => query<E>(element, selector),\n    queryAll: <E extends Element = Element>(selector: string) => queryAll<E>(element, selector),\n    queryAllByTestId: <E extends Element = Element>(testId: string) => queryAllByTestId<E>(element, testId),\n    queryAllByText: <E extends Element = Element>(text: string, selector = '*') =>\n      queryAllByText<E>(element, text, selector),\n    queryByTestId: <E extends Element = Element>(testId: string) => queryByTestId<E>(element, testId),\n    queryByText: <E extends Element = Element>(text: string, selector = '*') => queryByText<E>(element, text, selector),\n  };\n}\n","/**\n * Async waiting utilities for test environments.\n */\n\nimport { AssayTimeoutError } from './errors';\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface WaitOptions {\n  /** Maximum wait time in ms (default: 1000) */\n  timeout?: number;\n  /** Polling interval in ms (default: 50) */\n  interval?: number;\n  /** Message included in timeout error */\n  message?: string;\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Poll until a callback returns truthy (or void) without throwing.\n * Supports both boolean conditions and `expect()` assertions.\n *\n * - Returns truthy → success\n * - Returns `undefined` (e.g. bare `expect()` call) → success\n * - Returns falsy value → retry\n * - Throws → retry\n *\n * Always rejects with `AssayTimeoutError` on timeout, regardless of which of the two retry\n * reasons above was last observed — `instanceof AssayTimeoutError` is a reliable way to catch\n * \"the condition never became true\" without caring whether the last attempt returned falsy or\n * threw. The original failure (an assertion's message, a thrown error) is preserved as `.cause`,\n * not merged into a mutated copy of it — `fn`'s thrown errors are caller-owned and never mutated.\n *\n * @example\n * await waitFor(() => query('.status')?.textContent === 'loaded');\n * await waitFor(() => expect(count).toBe(3));\n */\nexport async function waitFor(\n  fn: () => unknown,\n  { interval = 50, message, timeout = 1000 }: WaitOptions = {},\n): Promise<void> {\n  const deadline = Date.now() + timeout;\n  let lastError: unknown;\n\n  // Single loop, one `fn()` call site — always tries once more before checking the deadline,\n  // so a condition that becomes true exactly as the timeout elapses still succeeds.\n  for (;;) {\n    try {\n      const result = await fn();\n\n      if (result === undefined || result) return;\n    } catch (e) {\n      lastError = e;\n    }\n\n    if (Date.now() >= deadline) break;\n\n    await wait(interval);\n  }\n\n  // The default timing summary always appears — a custom `message` adds context in front of it\n  // rather than replacing it, so a debugging session never loses \"how long did this actually wait\".\n  const timing = `waitFor timed out after ${timeout}ms`;\n  const base = message ? `${message} (${timing})` : timing;\n  const cause = lastError instanceof Error ? lastError.message : lastError != null ? String(lastError) : undefined;\n\n  throw new AssayTimeoutError(cause ? `${base}\\n${cause}` : base, { cause: lastError });\n}\n\n/**\n * Resolve when the target element emits the given event.\n *\n * @example\n * const promise = waitForEvent(el, 'change');\n * fire.click(trigger);\n * const event = await promise;\n */\nexport function waitForEvent<T extends Event = Event>(element: Element, name: string, timeout = 1000): Promise<T> {\n  return new Promise((resolve, reject) => {\n    const onEvent = (e: Event): void => {\n      clearTimeout(timer);\n      resolve(e as T);\n    };\n    const timer = setTimeout(() => {\n      element.removeEventListener(name, onEvent);\n      reject(new AssayTimeoutError(`waitForEvent: \"${name}\" timed out after ${timeout}ms`));\n    }, timeout);\n\n    element.addEventListener(name, onEvent, { once: true });\n  });\n}\n\n/**\n * Resolves after one microtask tick (`queueMicrotask`). Use to wait for reactivity (signal\n * effects, promise-chain continuations) to settle without moving into the macrotask queue —\n * cheaper and more precise than `wait(0)`, which yields to a full `setTimeout` turn instead.\n */\nexport const nextTick = (): Promise<void> =>\n  new Promise((resolve) => {\n    queueMicrotask(resolve);\n  });\n\n/**\n * Resolves after `ms` milliseconds. Prefer `nextTick()` for reactive updates and `waitFor()`\n * for polling a condition — reach for this only when a real macrotask delay is what the code\n * under test actually depends on (e.g. a debounce timer).\n */\nexport const wait = (ms = 0): Promise<void> =>\n  new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n"],"mappings":"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"}

package/dist/errors.cjs

@@ -0,0 +1,2 @@
+var e=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},t=class extends e{};exports.AssayError=e,exports.AssayTimeoutError=t;
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all Assay errors. Use `instanceof AssayError` to catch any Assay-originated error. */\nexport class AssayError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is AssayError {\n    return err instanceof AssayError;\n  }\n}\n\n/** Thrown by `waitFor`/`waitForEvent` when a condition is not met within the timeout. */\nexport class AssayTimeoutError extends AssayError {}\n"],"mappings":"AACA,IAAa,EAAb,MAAa,UAAmB,KAAM,CACpC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,IAAI,OAAO,KACvB,OAAO,eAAe,KAAM,IAAI,OAAO,SAAS,CAClD,CAEA,OAAO,GAAG,EAAiC,CACzC,OAAO,aAAe,CACxB,CACF,EAGa,EAAb,cAAuC,CAAW,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,9 @@
+/** Base class for all Assay errors. Use `instanceof AssayError` to catch any Assay-originated error. */
+export declare class AssayError extends Error {
+    constructor(message: string, opts?: ErrorOptions);
+    static is(err: unknown): err is AssayError;
+}
+/** Thrown by `waitFor`/`waitForEvent` when a condition is not met within the timeout. */
+export declare class AssayTimeoutError extends AssayError {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;IAMhD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU;CAG3C;AAED,yFAAyF;AACzF,qBAAa,iBAAkB,SAAQ,UAAU;CAAG"}

package/dist/errors.js

@@ -0,0 +1,13 @@
+//#region src/errors.ts
+var e = class e extends Error {
+	constructor(e, t) {
+		super(e, t), this.name = new.target.name, Object.setPrototypeOf(this, new.target.prototype);
+	}
+	static is(t) {
+		return t instanceof e;
+	}
+}, t = class extends e {};
+//#endregion
+export { e as AssayError, t as AssayTimeoutError };
+
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all Assay errors. Use `instanceof AssayError` to catch any Assay-originated error. */\nexport class AssayError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is AssayError {\n    return err instanceof AssayError;\n  }\n}\n\n/** Thrown by `waitFor`/`waitForEvent` when a condition is not met within the timeout. */\nexport class AssayTimeoutError extends AssayError {}\n"],"mappings":";AACA,IAAa,IAAb,MAAa,UAAmB,MAAM;CACpC,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAM,GAAS,CAAI,GACnB,KAAK,OAAO,IAAI,OAAO,MACvB,OAAO,eAAe,MAAM,IAAI,OAAO,SAAS;CAClD;CAEA,OAAO,GAAG,GAAiC;EACzC,OAAO,aAAe;CACxB;AACF,GAGa,IAAb,cAAuC,EAAW,CAAC"}

package/dist/events.cjs

@@ -0,0 +1,2 @@
+const e=require("./_dev.cjs");var t=(t,n={})=>typeof PointerEvent<`u`?new PointerEvent(t,n):(e.warnOnce(`pointer-fallback`,`PointerEvent is unavailable in this environment — falling back to MouseEvent. pointerId/pointerType/isPrimary and similar pointer-only fields will be missing from every dispatched event.`),new MouseEvent(t,n)),n={blur:(e,t)=>e.dispatchEvent(new FocusEvent(`blur`,{bubbles:!0,...t})),change:(e,t)=>e.dispatchEvent(new Event(`change`,{bubbles:!0,...t})),click:(e,t)=>e.dispatchEvent(new MouseEvent(`click`,{bubbles:!0,cancelable:!0,...t})),custom:(e,t,n)=>e.dispatchEvent(new CustomEvent(t,{bubbles:!0,cancelable:!0,composed:!1,...n})),event:(e,t)=>e.dispatchEvent(t),focus:(e,t,n)=>e.dispatchEvent(new FocusEvent(`focus`,{bubbles:!0,...n})),input:(e,t)=>e.dispatchEvent(new Event(`input`,{bubbles:!0,...t})),keyboard:(e,t,n)=>e.dispatchEvent(new KeyboardEvent(t,{bubbles:!0,cancelable:!0,...n})),keyDown:(e,t)=>e.dispatchEvent(new KeyboardEvent(`keydown`,{bubbles:!0,cancelable:!0,...t})),keyUp:(e,t)=>e.dispatchEvent(new KeyboardEvent(`keyup`,{bubbles:!0,cancelable:!0,...t})),mouse:(e,t,n)=>e.dispatchEvent(new MouseEvent(t,{bubbles:!0,cancelable:!0,...n})),pointerCancel:(e,n)=>e.dispatchEvent(t(`pointercancel`,{bubbles:!0,cancelable:!1,...n})),pointerDown:(e,n)=>e.dispatchEvent(t(`pointerdown`,{bubbles:!0,cancelable:!0,...n})),pointerEnter:(e,n)=>e.dispatchEvent(t(`pointerenter`,{bubbles:!1,...n})),pointerLeave:(e,n)=>e.dispatchEvent(t(`pointerleave`,{bubbles:!1,...n})),pointerMove:(e,n)=>e.dispatchEvent(t(`pointermove`,{bubbles:!0,cancelable:!0,...n})),pointerUp:(e,n)=>e.dispatchEvent(t(`pointerup`,{bubbles:!0,cancelable:!0,...n})),submit:(e,t)=>e.dispatchEvent(new Event(`submit`,{bubbles:!0,cancelable:!0,...t})),touch:(t,n,r)=>typeof TouchEvent<`u`?t.dispatchEvent(new TouchEvent(n,{bubbles:!0,cancelable:!0,...r})):(e.warnOnce(`touch-fallback`,"TouchEvent is unavailable in this environment — falling back to CustomEvent. The dispatched event will have no `touches`/`changedTouches` data."),t.dispatchEvent(new CustomEvent(n,{bubbles:!0,cancelable:!0,...r})))};exports.createPointerEvent=t,exports.fire=n;
+//# sourceMappingURL=events.cjs.map

package/dist/events.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.cjs","names":[],"sources":["../src/events.ts"],"sourcesContent":["/**\n * Synchronous DOM event dispatchers for test environments.\n */\n\nimport { warnOnce } from './_dev';\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\nexport const createPointerEvent = (type: string, init: PointerEventInit = {}): Event => {\n  if (typeof PointerEvent !== 'undefined') {\n    return new PointerEvent(type, init);\n  }\n\n  warnOnce(\n    'pointer-fallback',\n    'PointerEvent is unavailable in this environment — falling back to MouseEvent. ' +\n      'pointerId/pointerType/isPrimary and similar pointer-only fields will be missing from every dispatched event.',\n  );\n\n  return new MouseEvent(type, init);\n};\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Fire low-level DOM events synchronously. Every method dispatches an appropriately-typed\n * `Event` subclass with sensible defaults and returns `dispatchEvent`'s own boolean result\n * (`false` when a listener called `preventDefault()`) — the same contract for all of them,\n * with no exceptions.\n *\n * @example\n * fire.click(button);\n * fire.keyDown(input, { key: 'Enter' });\n * fire.custom(el, 'value-change', { detail: 42 });\n */\nexport const fire = {\n  blur: (el: Element, opts?: FocusEventInit) => el.dispatchEvent(new FocusEvent('blur', { bubbles: true, ...opts })),\n  change: (el: Element, opts?: EventInit) => el.dispatchEvent(new Event('change', { bubbles: true, ...opts })),\n  click: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a CustomEvent. Pass `{ detail: ... }` for event detail. */\n  custom: (el: Element, name: string, opts?: CustomEventInit) =>\n    el.dispatchEvent(new CustomEvent(name, { bubbles: true, cancelable: true, composed: false, ...opts })),\n  /** Dispatch any pre-built Event instance directly. */\n  event: (el: Element, event: Event) => el.dispatchEvent(event),\n  focus: (el: Element, _name?: string, opts?: FocusEventInit) =>\n    el.dispatchEvent(new FocusEvent('focus', { bubbles: true, ...opts })),\n  input: (el: Element, opts?: EventInit) => el.dispatchEvent(new Event('input', { bubbles: true, ...opts })),\n  /** Fire a KeyboardEvent with a given type (keydown, keyup, keypress). */\n  keyboard: (el: Element, type: string, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent(type, { bubbles: true, cancelable: true, ...opts })),\n  keyDown: (el: Element, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent('keydown', { bubbles: true, cancelable: true, ...opts })),\n  keyUp: (el: Element, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent('keyup', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a MouseEvent with a given type (click, mousedown, etc.). */\n  mouse: (el: Element, type: string, opts?: MouseEventInit) =>\n    el.dispatchEvent(new MouseEvent(type, { bubbles: true, cancelable: true, ...opts })),\n  pointerCancel: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointercancel', { bubbles: true, cancelable: false, ...opts })),\n  pointerDown: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerdown', { bubbles: true, cancelable: true, ...opts })),\n  pointerEnter: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerenter', { bubbles: false, ...opts })),\n  pointerLeave: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerleave', { bubbles: false, ...opts })),\n  pointerMove: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointermove', { bubbles: true, cancelable: true, ...opts })),\n  pointerUp: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerup', { bubbles: true, cancelable: true, ...opts })),\n  submit: (el: Element, opts?: EventInit) =>\n    el.dispatchEvent(new Event('submit', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a touch event; falls back to CustomEvent in environments without TouchEvent. */\n  touch: (el: Element, type: string, opts?: EventInit) => {\n    if (typeof TouchEvent !== 'undefined') {\n      return el.dispatchEvent(new TouchEvent(type, { bubbles: true, cancelable: true, ...opts }));\n    }\n\n    warnOnce(\n      'touch-fallback',\n      'TouchEvent is unavailable in this environment — falling back to CustomEvent. The dispatched event will have no `touches`/`changedTouches` data.',\n    );\n\n    return el.dispatchEvent(new CustomEvent(type, { bubbles: true, cancelable: true, ...opts }));\n  },\n} as const;\n"],"mappings":"8BAQA,IAAa,GAAsB,EAAc,EAAyB,CAAC,IACrE,OAAO,aAAiB,IACnB,IAAI,aAAa,EAAM,CAAI,GAGpC,EAAA,SACE,mBACA,4LAEF,EAEO,IAAI,WAAW,EAAM,CAAI,GAgBrB,EAAO,CAClB,MAAO,EAAa,IAA0B,EAAG,cAAc,IAAI,WAAW,OAAQ,CAAE,QAAS,GAAM,GAAG,CAAK,CAAC,CAAC,EACjH,QAAS,EAAa,IAAqB,EAAG,cAAc,IAAI,MAAM,SAAU,CAAE,QAAS,GAAM,GAAG,CAAK,CAAC,CAAC,EAC3G,OAAQ,EAAa,IACnB,EAAG,cAAc,IAAI,WAAW,QAAS,CAAE,QAAS,GAAM,WAAY,GAAM,GAAG,CAAK,CAAC,CAAC,EAExF,QAAS,EAAa,EAAc,IAClC,EAAG,cAAc,IAAI,YAAY,EAAM,CAAE,QAAS,GAAM,WAAY,GAAM,SAAU,GAAO,GAAG,CAAK,CAAC,CAAC,EAEvG,OAAQ,EAAa,IAAiB,EAAG,cAAc,CAAK,EAC5D,OAAQ,EAAa,EAAgB,IACnC,EAAG,cAAc,IAAI,WAAW,QAAS,CAAE,QAAS,GAAM,GAAG,CAAK,CAAC,CAAC,EACtE,OAAQ,EAAa,IAAqB,EAAG,cAAc,IAAI,MAAM,QAAS,CAAE,QAAS,GAAM,GAAG,CAAK,CAAC,CAAC,EAEzG,UAAW,EAAa,EAAc,IACpC,EAAG,cAAc,IAAI,cAAc,EAAM,CAAE,QAAS,GAAM,WAAY,GAAM,GAAG,CAAK,CAAC,CAAC,EACxF,SAAU,EAAa,IACrB,EAAG,cAAc,IAAI,cAAc,UAAW,CAAE,QAAS,GAAM,WAAY,GAAM,GAAG,CAAK,CAAC,CAAC,EAC7F,OAAQ,EAAa,IACnB,EAAG,cAAc,IAAI,cAAc,QAAS,CAAE,QAAS,GAAM,WAAY,GAAM,GAAG,CAAK,CAAC,CAAC,EAE3F,OAAQ,EAAa,EAAc,IACjC,EAAG,cAAc,IAAI,WAAW,EAAM,CAAE,QAAS,GAAM,WAAY,GAAM,GAAG,CAAK,CAAC,CAAC,EACrF,eAAgB,EAAa,IAC3B,EAAG,cAAc,EAAmB,gBAAiB,CAAE,QAAS,GAAM,WAAY,GAAO,GAAG,CAAK,CAAC,CAAC,EACrG,aAAc,EAAa,IACzB,EAAG,cAAc,EAAmB,cAAe,CAAE,QAAS,GAAM,WAAY,GAAM,GAAG,CAAK,CAAC,CAAC,EAClG,cAAe,EAAa,IAC1B,EAAG,cAAc,EAAmB,eAAgB,CAAE,QAAS,GAAO,GAAG,CAAK,CAAC,CAAC,EAClF,cAAe,EAAa,IAC1B,EAAG,cAAc,EAAmB,eAAgB,CAAE,QAAS,GAAO,GAAG,CAAK,CAAC,CAAC,EAClF,aAAc,EAAa,IACzB,EAAG,cAAc,EAAmB,cAAe,CAAE,QAAS,GAAM,WAAY,GAAM,GAAG,CAAK,CAAC,CAAC,EAClG,WAAY,EAAa,IACvB,EAAG,cAAc,EAAmB,YAAa,CAAE,QAAS,GAAM,WAAY,GAAM,GAAG,CAAK,CAAC,CAAC,EAChG,QAAS,EAAa,IACpB,EAAG,cAAc,IAAI,MAAM,SAAU,CAAE,QAAS,GAAM,WAAY,GAAM,GAAG,CAAK,CAAC,CAAC,EAEpF,OAAQ,EAAa,EAAc,IAC7B,OAAO,WAAe,IACjB,EAAG,cAAc,IAAI,WAAW,EAAM,CAAE,QAAS,GAAM,WAAY,GAAM,GAAG,CAAK,CAAC,CAAC,GAG5F,EAAA,SACE,iBACA,iJACF,EAEO,EAAG,cAAc,IAAI,YAAY,EAAM,CAAE,QAAS,GAAM,WAAY,GAAM,GAAG,CAAK,CAAC,CAAC,EAE/F"}

package/dist/events.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Synchronous DOM event dispatchers for test environments.
+ */
+export declare const createPointerEvent: (type: string, init?: PointerEventInit) => Event;
+/**
+ * Fire low-level DOM events synchronously. Every method dispatches an appropriately-typed
+ * `Event` subclass with sensible defaults and returns `dispatchEvent`'s own boolean result
+ * (`false` when a listener called `preventDefault()`) — the same contract for all of them,
+ * with no exceptions.
+ *
+ * @example
+ * fire.click(button);
+ * fire.keyDown(input, { key: 'Enter' });
+ * fire.custom(el, 'value-change', { detail: 42 });
+ */
+export declare const fire: {
+    readonly blur: (el: Element, opts?: FocusEventInit) => boolean;
+    readonly change: (el: Element, opts?: EventInit) => boolean;
+    readonly click: (el: Element, opts?: PointerEventInit) => boolean;
+    /** Fire a CustomEvent. Pass `{ detail: ... }` for event detail. */
+    readonly custom: (el: Element, name: string, opts?: CustomEventInit) => boolean;
+    /** Dispatch any pre-built Event instance directly. */
+    readonly event: (el: Element, event: Event) => boolean;
+    readonly focus: (el: Element, _name?: string, opts?: FocusEventInit) => boolean;
+    readonly input: (el: Element, opts?: EventInit) => boolean;
+    /** Fire a KeyboardEvent with a given type (keydown, keyup, keypress). */
+    readonly keyboard: (el: Element, type: string, opts?: KeyboardEventInit) => boolean;
+    readonly keyDown: (el: Element, opts?: KeyboardEventInit) => boolean;
+    readonly keyUp: (el: Element, opts?: KeyboardEventInit) => boolean;
+    /** Fire a MouseEvent with a given type (click, mousedown, etc.). */
+    readonly mouse: (el: Element, type: string, opts?: MouseEventInit) => boolean;
+    readonly pointerCancel: (el: Element, opts?: PointerEventInit) => boolean;
+    readonly pointerDown: (el: Element, opts?: PointerEventInit) => boolean;
+    readonly pointerEnter: (el: Element, opts?: PointerEventInit) => boolean;
+    readonly pointerLeave: (el: Element, opts?: PointerEventInit) => boolean;
+    readonly pointerMove: (el: Element, opts?: PointerEventInit) => boolean;
+    readonly pointerUp: (el: Element, opts?: PointerEventInit) => boolean;
+    readonly submit: (el: Element, opts?: EventInit) => boolean;
+    /** Fire a touch event; falls back to CustomEvent in environments without TouchEvent. */
+    readonly touch: (el: Element, type: string, opts?: EventInit) => boolean;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,OAAM,gBAAqB,KAAG,KAY9E,CAAC;AAIF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI;wBACJ,OAAO,SAAS,cAAc;0BAC5B,OAAO,SAAS,SAAS;yBAC1B,OAAO,SAAS,gBAAgB;IAE5C,mEAAmE;0BACtD,OAAO,QAAQ,MAAM,SAAS,eAAe;IAE1D,sDAAsD;yBAC1C,OAAO,SAAS,KAAK;yBACrB,OAAO,UAAU,MAAM,SAAS,cAAc;yBAE9C,OAAO,SAAS,SAAS;IACrC,yEAAyE;4BAC1D,OAAO,QAAQ,MAAM,SAAS,iBAAiB;2BAEhD,OAAO,SAAS,iBAAiB;yBAEnC,OAAO,SAAS,iBAAiB;IAE7C,oEAAoE;yBACxD,OAAO,QAAQ,MAAM,SAAS,cAAc;iCAEpC,OAAO,SAAS,gBAAgB;+BAElC,OAAO,SAAS,gBAAgB;gCAE/B,OAAO,SAAS,gBAAgB;gCAEhC,OAAO,SAAS,gBAAgB;+BAEjC,OAAO,SAAS,gBAAgB;6BAElC,OAAO,SAAS,gBAAgB;0BAEnC,OAAO,SAAS,SAAS;IAEtC,wFAAwF;yBAC5E,OAAO,QAAQ,MAAM,SAAS,SAAS;CAY3C,CAAC"}

package/dist/events.js

@@ -0,0 +1,98 @@
+import { warnOnce as e } from "./_dev.js";
+//#region src/events.ts
+var t = (t, n = {}) => typeof PointerEvent < "u" ? new PointerEvent(t, n) : (e("pointer-fallback", "PointerEvent is unavailable in this environment — falling back to MouseEvent. pointerId/pointerType/isPrimary and similar pointer-only fields will be missing from every dispatched event."), new MouseEvent(t, n)), n = {
+	blur: (e, t) => e.dispatchEvent(new FocusEvent("blur", {
+		bubbles: !0,
+		...t
+	})),
+	change: (e, t) => e.dispatchEvent(new Event("change", {
+		bubbles: !0,
+		...t
+	})),
+	click: (e, t) => e.dispatchEvent(new MouseEvent("click", {
+		bubbles: !0,
+		cancelable: !0,
+		...t
+	})),
+	custom: (e, t, n) => e.dispatchEvent(new CustomEvent(t, {
+		bubbles: !0,
+		cancelable: !0,
+		composed: !1,
+		...n
+	})),
+	event: (e, t) => e.dispatchEvent(t),
+	focus: (e, t, n) => e.dispatchEvent(new FocusEvent("focus", {
+		bubbles: !0,
+		...n
+	})),
+	input: (e, t) => e.dispatchEvent(new Event("input", {
+		bubbles: !0,
+		...t
+	})),
+	keyboard: (e, t, n) => e.dispatchEvent(new KeyboardEvent(t, {
+		bubbles: !0,
+		cancelable: !0,
+		...n
+	})),
+	keyDown: (e, t) => e.dispatchEvent(new KeyboardEvent("keydown", {
+		bubbles: !0,
+		cancelable: !0,
+		...t
+	})),
+	keyUp: (e, t) => e.dispatchEvent(new KeyboardEvent("keyup", {
+		bubbles: !0,
+		cancelable: !0,
+		...t
+	})),
+	mouse: (e, t, n) => e.dispatchEvent(new MouseEvent(t, {
+		bubbles: !0,
+		cancelable: !0,
+		...n
+	})),
+	pointerCancel: (e, n) => e.dispatchEvent(t("pointercancel", {
+		bubbles: !0,
+		cancelable: !1,
+		...n
+	})),
+	pointerDown: (e, n) => e.dispatchEvent(t("pointerdown", {
+		bubbles: !0,
+		cancelable: !0,
+		...n
+	})),
+	pointerEnter: (e, n) => e.dispatchEvent(t("pointerenter", {
+		bubbles: !1,
+		...n
+	})),
+	pointerLeave: (e, n) => e.dispatchEvent(t("pointerleave", {
+		bubbles: !1,
+		...n
+	})),
+	pointerMove: (e, n) => e.dispatchEvent(t("pointermove", {
+		bubbles: !0,
+		cancelable: !0,
+		...n
+	})),
+	pointerUp: (e, n) => e.dispatchEvent(t("pointerup", {
+		bubbles: !0,
+		cancelable: !0,
+		...n
+	})),
+	submit: (e, t) => e.dispatchEvent(new Event("submit", {
+		bubbles: !0,
+		cancelable: !0,
+		...t
+	})),
+	touch: (t, n, r) => typeof TouchEvent < "u" ? t.dispatchEvent(new TouchEvent(n, {
+		bubbles: !0,
+		cancelable: !0,
+		...r
+	})) : (e("touch-fallback", "TouchEvent is unavailable in this environment — falling back to CustomEvent. The dispatched event will have no `touches`/`changedTouches` data."), t.dispatchEvent(new CustomEvent(n, {
+		bubbles: !0,
+		cancelable: !0,
+		...r
+	})))
+};
+//#endregion
+export { t as createPointerEvent, n as fire };
+
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../src/events.ts"],"sourcesContent":["/**\n * Synchronous DOM event dispatchers for test environments.\n */\n\nimport { warnOnce } from './_dev';\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\nexport const createPointerEvent = (type: string, init: PointerEventInit = {}): Event => {\n  if (typeof PointerEvent !== 'undefined') {\n    return new PointerEvent(type, init);\n  }\n\n  warnOnce(\n    'pointer-fallback',\n    'PointerEvent is unavailable in this environment — falling back to MouseEvent. ' +\n      'pointerId/pointerType/isPrimary and similar pointer-only fields will be missing from every dispatched event.',\n  );\n\n  return new MouseEvent(type, init);\n};\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Fire low-level DOM events synchronously. Every method dispatches an appropriately-typed\n * `Event` subclass with sensible defaults and returns `dispatchEvent`'s own boolean result\n * (`false` when a listener called `preventDefault()`) — the same contract for all of them,\n * with no exceptions.\n *\n * @example\n * fire.click(button);\n * fire.keyDown(input, { key: 'Enter' });\n * fire.custom(el, 'value-change', { detail: 42 });\n */\nexport const fire = {\n  blur: (el: Element, opts?: FocusEventInit) => el.dispatchEvent(new FocusEvent('blur', { bubbles: true, ...opts })),\n  change: (el: Element, opts?: EventInit) => el.dispatchEvent(new Event('change', { bubbles: true, ...opts })),\n  click: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a CustomEvent. Pass `{ detail: ... }` for event detail. */\n  custom: (el: Element, name: string, opts?: CustomEventInit) =>\n    el.dispatchEvent(new CustomEvent(name, { bubbles: true, cancelable: true, composed: false, ...opts })),\n  /** Dispatch any pre-built Event instance directly. */\n  event: (el: Element, event: Event) => el.dispatchEvent(event),\n  focus: (el: Element, _name?: string, opts?: FocusEventInit) =>\n    el.dispatchEvent(new FocusEvent('focus', { bubbles: true, ...opts })),\n  input: (el: Element, opts?: EventInit) => el.dispatchEvent(new Event('input', { bubbles: true, ...opts })),\n  /** Fire a KeyboardEvent with a given type (keydown, keyup, keypress). */\n  keyboard: (el: Element, type: string, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent(type, { bubbles: true, cancelable: true, ...opts })),\n  keyDown: (el: Element, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent('keydown', { bubbles: true, cancelable: true, ...opts })),\n  keyUp: (el: Element, opts?: KeyboardEventInit) =>\n    el.dispatchEvent(new KeyboardEvent('keyup', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a MouseEvent with a given type (click, mousedown, etc.). */\n  mouse: (el: Element, type: string, opts?: MouseEventInit) =>\n    el.dispatchEvent(new MouseEvent(type, { bubbles: true, cancelable: true, ...opts })),\n  pointerCancel: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointercancel', { bubbles: true, cancelable: false, ...opts })),\n  pointerDown: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerdown', { bubbles: true, cancelable: true, ...opts })),\n  pointerEnter: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerenter', { bubbles: false, ...opts })),\n  pointerLeave: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerleave', { bubbles: false, ...opts })),\n  pointerMove: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointermove', { bubbles: true, cancelable: true, ...opts })),\n  pointerUp: (el: Element, opts?: PointerEventInit) =>\n    el.dispatchEvent(createPointerEvent('pointerup', { bubbles: true, cancelable: true, ...opts })),\n  submit: (el: Element, opts?: EventInit) =>\n    el.dispatchEvent(new Event('submit', { bubbles: true, cancelable: true, ...opts })),\n  /** Fire a touch event; falls back to CustomEvent in environments without TouchEvent. */\n  touch: (el: Element, type: string, opts?: EventInit) => {\n    if (typeof TouchEvent !== 'undefined') {\n      return el.dispatchEvent(new TouchEvent(type, { bubbles: true, cancelable: true, ...opts }));\n    }\n\n    warnOnce(\n      'touch-fallback',\n      'TouchEvent is unavailable in this environment — falling back to CustomEvent. The dispatched event will have no `touches`/`changedTouches` data.',\n    );\n\n    return el.dispatchEvent(new CustomEvent(type, { bubbles: true, cancelable: true, ...opts }));\n  },\n} as const;\n"],"mappings":";;AAQA,IAAa,KAAsB,GAAc,IAAyB,CAAC,MACrE,OAAO,eAAiB,MACnB,IAAI,aAAa,GAAM,CAAI,KAGpC,EACE,oBACA,4LAEF,GAEO,IAAI,WAAW,GAAM,CAAI,IAgBrB,IAAO;CAClB,OAAO,GAAa,MAA0B,EAAG,cAAc,IAAI,WAAW,QAAQ;EAAE,SAAS;EAAM,GAAG;CAAK,CAAC,CAAC;CACjH,SAAS,GAAa,MAAqB,EAAG,cAAc,IAAI,MAAM,UAAU;EAAE,SAAS;EAAM,GAAG;CAAK,CAAC,CAAC;CAC3G,QAAQ,GAAa,MACnB,EAAG,cAAc,IAAI,WAAW,SAAS;EAAE,SAAS;EAAM,YAAY;EAAM,GAAG;CAAK,CAAC,CAAC;CAExF,SAAS,GAAa,GAAc,MAClC,EAAG,cAAc,IAAI,YAAY,GAAM;EAAE,SAAS;EAAM,YAAY;EAAM,UAAU;EAAO,GAAG;CAAK,CAAC,CAAC;CAEvG,QAAQ,GAAa,MAAiB,EAAG,cAAc,CAAK;CAC5D,QAAQ,GAAa,GAAgB,MACnC,EAAG,cAAc,IAAI,WAAW,SAAS;EAAE,SAAS;EAAM,GAAG;CAAK,CAAC,CAAC;CACtE,QAAQ,GAAa,MAAqB,EAAG,cAAc,IAAI,MAAM,SAAS;EAAE,SAAS;EAAM,GAAG;CAAK,CAAC,CAAC;CAEzG,WAAW,GAAa,GAAc,MACpC,EAAG,cAAc,IAAI,cAAc,GAAM;EAAE,SAAS;EAAM,YAAY;EAAM,GAAG;CAAK,CAAC,CAAC;CACxF,UAAU,GAAa,MACrB,EAAG,cAAc,IAAI,cAAc,WAAW;EAAE,SAAS;EAAM,YAAY;EAAM,GAAG;CAAK,CAAC,CAAC;CAC7F,QAAQ,GAAa,MACnB,EAAG,cAAc,IAAI,cAAc,SAAS;EAAE,SAAS;EAAM,YAAY;EAAM,GAAG;CAAK,CAAC,CAAC;CAE3F,QAAQ,GAAa,GAAc,MACjC,EAAG,cAAc,IAAI,WAAW,GAAM;EAAE,SAAS;EAAM,YAAY;EAAM,GAAG;CAAK,CAAC,CAAC;CACrF,gBAAgB,GAAa,MAC3B,EAAG,cAAc,EAAmB,iBAAiB;EAAE,SAAS;EAAM,YAAY;EAAO,GAAG;CAAK,CAAC,CAAC;CACrG,cAAc,GAAa,MACzB,EAAG,cAAc,EAAmB,eAAe;EAAE,SAAS;EAAM,YAAY;EAAM,GAAG;CAAK,CAAC,CAAC;CAClG,eAAe,GAAa,MAC1B,EAAG,cAAc,EAAmB,gBAAgB;EAAE,SAAS;EAAO,GAAG;CAAK,CAAC,CAAC;CAClF,eAAe,GAAa,MAC1B,EAAG,cAAc,EAAmB,gBAAgB;EAAE,SAAS;EAAO,GAAG;CAAK,CAAC,CAAC;CAClF,cAAc,GAAa,MACzB,EAAG,cAAc,EAAmB,eAAe;EAAE,SAAS;EAAM,YAAY;EAAM,GAAG;CAAK,CAAC,CAAC;CAClG,YAAY,GAAa,MACvB,EAAG,cAAc,EAAmB,aAAa;EAAE,SAAS;EAAM,YAAY;EAAM,GAAG;CAAK,CAAC,CAAC;CAChG,SAAS,GAAa,MACpB,EAAG,cAAc,IAAI,MAAM,UAAU;EAAE,SAAS;EAAM,YAAY;EAAM,GAAG;CAAK,CAAC,CAAC;CAEpF,QAAQ,GAAa,GAAc,MAC7B,OAAO,aAAe,MACjB,EAAG,cAAc,IAAI,WAAW,GAAM;EAAE,SAAS;EAAM,YAAY;EAAM,GAAG;CAAK,CAAC,CAAC,KAG5F,EACE,kBACA,iJACF,GAEO,EAAG,cAAc,IAAI,YAAY,GAAM;EAAE,SAAS;EAAM,YAAY;EAAM,GAAG;CAAK,CAAC,CAAC;AAE/F"}

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./errors.cjs"),t=require("./events.cjs"),n=require("./query.cjs"),r=require("./wait.cjs");exports.AssayError=e.AssayError,exports.AssayTimeoutError=e.AssayTimeoutError,exports.createPointerEvent=t.createPointerEvent,exports.fire=t.fire,exports.getSlotted=n.getSlotted,exports.nextTick=r.nextTick,exports.query=n.query,exports.queryAll=n.queryAll,exports.queryAllByTestId=n.queryAllByTestId,exports.queryAllByText=n.queryAllByText,exports.queryAllInShadow=n.queryAllInShadow,exports.queryByTestId=n.queryByTestId,exports.queryByText=n.queryByText,exports.queryInShadow=n.queryInShadow,exports.queryPart=n.queryPart,exports.wait=r.wait,exports.waitFor=r.waitFor,exports.waitForEvent=r.waitForEvent,exports.within=n.within;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { AssayError, AssayTimeoutError } from './errors';
+export { fire, createPointerEvent } from './events';
+export { within, query, queryAll, queryByTestId, queryAllByTestId, queryByText, queryAllByText, queryInShadow, queryAllInShadow, queryPart, getSlotted, type QueryScope, } from './query';
+export { waitFor, waitForEvent, nextTick, wait, type WaitOptions } from './wait';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEzD,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EACL,MAAM,EACN,KAAK,EACL,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,KAAK,UAAU,GAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+import { AssayError as e, AssayTimeoutError as t } from "./errors.js";
+import { createPointerEvent as n, fire as r } from "./events.js";
+import { getSlotted as i, query as a, queryAll as o, queryAllByTestId as s, queryAllByText as c, queryAllInShadow as l, queryByTestId as u, queryByText as d, queryInShadow as f, queryPart as p, within as m } from "./query.js";
+import { nextTick as h, wait as g, waitFor as _, waitForEvent as v } from "./wait.js";
+export { e as AssayError, t as AssayTimeoutError, n as createPointerEvent, r as fire, i as getSlotted, h as nextTick, a as query, o as queryAll, s as queryAllByTestId, c as queryAllByText, l as queryAllInShadow, u as queryByTestId, d as queryByText, f as queryInShadow, p as queryPart, g as wait, _ as waitFor, v as waitForEvent, m as within };

package/dist/query.cjs

@@ -0,0 +1,2 @@
+function e(e,t){return e.querySelector(t)}function t(e,t){return Array.from(e.querySelectorAll(t))}function n(e,t){return e.querySelector(`[data-testid="${t}"]`)}function r(e,t){return Array.from(e.querySelectorAll(`[data-testid="${t}"]`))}function i(e,t,n){for(let r of e.querySelectorAll(n))if(r.textContent?.trim()===t)return r;return null}function a(e,t,n){return Array.from(e.querySelectorAll(n)).filter(e=>e.textContent?.trim()===t)}function o(e,t){return e.shadowRoot?.querySelector(t)??null}function s(e,t){return Array.from(e.shadowRoot?.querySelectorAll(t)??[])}function c(e,t){return o(e,`[part="${t}"]`)}function l(e,t){let n=t?`[slot="${t}"]`:`:not([slot])`;return Array.from(e.querySelectorAll(`:scope > ${n}`))}function u(o){return{query:t=>e(o,t),queryAll:e=>t(o,e),queryAllByTestId:e=>r(o,e),queryAllByText:(e,t=`*`)=>a(o,e,t),queryByTestId:e=>n(o,e),queryByText:(e,t=`*`)=>i(o,e,t)}}exports.getSlotted=l,exports.query=e,exports.queryAll=t,exports.queryAllByTestId=r,exports.queryAllByText=a,exports.queryAllInShadow=s,exports.queryByTestId=n,exports.queryByText=i,exports.queryInShadow=o,exports.queryPart=c,exports.within=u;
+//# sourceMappingURL=query.cjs.map

package/dist/query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.cjs","names":[],"sources":["../src/query.ts"],"sourcesContent":["/**\n * DOM query helpers for test environments.\n */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Scoped query helpers for any DOM element — see {@link within} */\nexport interface QueryScope {\n  query<E extends Element = Element>(selector: string): E | null;\n  queryAll<E extends Element = Element>(selector: string): E[];\n  queryByText<E extends Element = Element>(text: string, selector?: string): E | null;\n  queryAllByText<E extends Element = Element>(text: string, selector?: string): E[];\n  queryByTestId<E extends Element = Element>(testId: string): E | null;\n  queryAllByTestId<E extends Element = Element>(testId: string): E[];\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\n/** Query a single element within `root`. Equivalent to `root.querySelector(selector)`. */\nexport function query<E extends Element = Element>(root: Element | ShadowRoot, selector: string): E | null {\n  return root.querySelector<E>(selector);\n}\n\n/** Query every element within `root` matching `selector`. */\nexport function queryAll<E extends Element = Element>(root: Element | ShadowRoot, selector: string): E[] {\n  return Array.from(root.querySelectorAll<E>(selector));\n}\n\n/** Query a single element within `root` by its `data-testid` attribute. */\nexport function queryByTestId<E extends Element = Element>(root: Element | ShadowRoot, testId: string): E | null {\n  return root.querySelector<E>(`[data-testid=\"${testId}\"]`);\n}\n\n/** Query every element within `root` matching a `data-testid` attribute. */\nexport function queryAllByTestId<E extends Element = Element>(root: Element | ShadowRoot, testId: string): E[] {\n  return Array.from(root.querySelectorAll<E>(`[data-testid=\"${testId}\"]`));\n}\n\nexport function queryByText<E extends Element = Element>(\n  root: Element | ShadowRoot,\n  text: string,\n  selector: string,\n): E | null {\n  for (const el of root.querySelectorAll<E>(selector)) {\n    if (el.textContent?.trim() === text) return el;\n  }\n\n  return null;\n}\n\nexport function queryAllByText<E extends Element = Element>(\n  root: Element | ShadowRoot,\n  text: string,\n  selector: string,\n): E[] {\n  return Array.from(root.querySelectorAll<E>(selector)).filter((el) => el.textContent?.trim() === text);\n}\n\n/**\n * Queries the shadow root of a custom element for a matching CSS selector.\n * Returns `null` if the element has no shadow root or no match is found — safe to call on\n * both open-shadow custom elements and plain elements without checking `shadowRoot` first.\n */\nexport function queryInShadow<E extends Element = Element>(host: Element, selector: string): E | null {\n  return host.shadowRoot?.querySelector<E>(selector) ?? null;\n}\n\n/** Queries all matching elements inside the shadow root of a custom element. */\nexport function queryAllInShadow<E extends Element = Element>(host: Element, selector: string): E[] {\n  return Array.from(host.shadowRoot?.querySelectorAll<E>(selector) ?? []);\n}\n\n/**\n * Queries a shadow DOM element by its CSS `part` attribute — shorthand for\n * `queryInShadow(host, '[part=\"name\"]')`.\n *\n * @example\n * const btn = queryPart(carousel, 'prev-btn');\n * expect(btn).not.toBeNull();\n */\nexport function queryPart<E extends Element = Element>(host: Element, part: string): E | null {\n  return queryInShadow<E>(host, `[part=\"${part}\"]`);\n}\n\n/**\n * Returns the light-DOM children assigned to a named slot, or every slotted child (elements\n * with no `slot` attribute) when no name is given.\n *\n * @example\n * const slides = getSlotted(carousel);\n * expect(slides).toHaveLength(3);\n */\nexport function getSlotted<E extends Element = Element>(host: Element, slotName?: string): E[] {\n  const selector = slotName ? `[slot=\"${slotName}\"]` : ':not([slot])';\n\n  return Array.from(host.querySelectorAll<E>(`:scope > ${selector}`));\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Create query helpers scoped to any element — useful for slotted/light DOM content.\n *\n * @example\n * const panel = fixture.query('.panel')!;\n * const { query } = within(panel);\n * expect(query('.title')?.textContent).toBe('Hello');\n */\nexport function within(element: Element): QueryScope {\n  return {\n    query: <E extends Element = Element>(selector: string) => query<E>(element, selector),\n    queryAll: <E extends Element = Element>(selector: string) => queryAll<E>(element, selector),\n    queryAllByTestId: <E extends Element = Element>(testId: string) => queryAllByTestId<E>(element, testId),\n    queryAllByText: <E extends Element = Element>(text: string, selector = '*') =>\n      queryAllByText<E>(element, text, selector),\n    queryByTestId: <E extends Element = Element>(testId: string) => queryByTestId<E>(element, testId),\n    queryByText: <E extends Element = Element>(text: string, selector = '*') => queryByText<E>(element, text, selector),\n  };\n}\n"],"mappings":"AAmBA,SAAgB,EAAmC,EAA4B,EAA4B,CACzG,OAAO,EAAK,cAAiB,CAAQ,CACvC,CAGA,SAAgB,EAAsC,EAA4B,EAAuB,CACvG,OAAO,MAAM,KAAK,EAAK,iBAAoB,CAAQ,CAAC,CACtD,CAGA,SAAgB,EAA2C,EAA4B,EAA0B,CAC/G,OAAO,EAAK,cAAiB,iBAAiB,EAAO,GAAG,CAC1D,CAGA,SAAgB,EAA8C,EAA4B,EAAqB,CAC7G,OAAO,MAAM,KAAK,EAAK,iBAAoB,iBAAiB,EAAO,GAAG,CAAC,CACzE,CAEA,SAAgB,EACd,EACA,EACA,EACU,CACV,IAAK,IAAM,KAAM,EAAK,iBAAoB,CAAQ,EAChD,GAAI,EAAG,aAAa,KAAK,IAAM,EAAM,OAAO,EAG9C,OAAO,IACT,CAEA,SAAgB,EACd,EACA,EACA,EACK,CACL,OAAO,MAAM,KAAK,EAAK,iBAAoB,CAAQ,CAAC,CAAC,CAAC,OAAQ,GAAO,EAAG,aAAa,KAAK,IAAM,CAAI,CACtG,CAOA,SAAgB,EAA2C,EAAe,EAA4B,CACpG,OAAO,EAAK,YAAY,cAAiB,CAAQ,GAAK,IACxD,CAGA,SAAgB,EAA8C,EAAe,EAAuB,CAClG,OAAO,MAAM,KAAK,EAAK,YAAY,iBAAoB,CAAQ,GAAK,CAAC,CAAC,CACxE,CAUA,SAAgB,EAAuC,EAAe,EAAwB,CAC5F,OAAO,EAAiB,EAAM,UAAU,EAAK,GAAG,CAClD,CAUA,SAAgB,EAAwC,EAAe,EAAwB,CAC7F,IAAM,EAAW,EAAW,UAAU,EAAS,IAAM,eAErD,OAAO,MAAM,KAAK,EAAK,iBAAoB,YAAY,GAAU,CAAC,CACpE,CAYA,SAAgB,EAAO,EAA8B,CACnD,MAAO,CACL,MAAqC,GAAqB,EAAS,EAAS,CAAQ,EACpF,SAAwC,GAAqB,EAAY,EAAS,CAAQ,EAC1F,iBAAgD,GAAmB,EAAoB,EAAS,CAAM,EACtG,gBAA8C,EAAc,EAAW,MACrE,EAAkB,EAAS,EAAM,CAAQ,EAC3C,cAA6C,GAAmB,EAAiB,EAAS,CAAM,EAChG,aAA2C,EAAc,EAAW,MAAQ,EAAe,EAAS,EAAM,CAAQ,CACpH,CACF"}

package/dist/query.d.ts

@@ -0,0 +1,58 @@
+/**
+ * DOM query helpers for test environments.
+ */
+/** Scoped query helpers for any DOM element — see {@link within} */
+export interface QueryScope {
+    query<E extends Element = Element>(selector: string): E | null;
+    queryAll<E extends Element = Element>(selector: string): E[];
+    queryByText<E extends Element = Element>(text: string, selector?: string): E | null;
+    queryAllByText<E extends Element = Element>(text: string, selector?: string): E[];
+    queryByTestId<E extends Element = Element>(testId: string): E | null;
+    queryAllByTestId<E extends Element = Element>(testId: string): E[];
+}
+/** Query a single element within `root`. Equivalent to `root.querySelector(selector)`. */
+export declare function query<E extends Element = Element>(root: Element | ShadowRoot, selector: string): E | null;
+/** Query every element within `root` matching `selector`. */
+export declare function queryAll<E extends Element = Element>(root: Element | ShadowRoot, selector: string): E[];
+/** Query a single element within `root` by its `data-testid` attribute. */
+export declare function queryByTestId<E extends Element = Element>(root: Element | ShadowRoot, testId: string): E | null;
+/** Query every element within `root` matching a `data-testid` attribute. */
+export declare function queryAllByTestId<E extends Element = Element>(root: Element | ShadowRoot, testId: string): E[];
+export declare function queryByText<E extends Element = Element>(root: Element | ShadowRoot, text: string, selector: string): E | null;
+export declare function queryAllByText<E extends Element = Element>(root: Element | ShadowRoot, text: string, selector: string): E[];
+/**
+ * Queries the shadow root of a custom element for a matching CSS selector.
+ * Returns `null` if the element has no shadow root or no match is found — safe to call on
+ * both open-shadow custom elements and plain elements without checking `shadowRoot` first.
+ */
+export declare function queryInShadow<E extends Element = Element>(host: Element, selector: string): E | null;
+/** Queries all matching elements inside the shadow root of a custom element. */
+export declare function queryAllInShadow<E extends Element = Element>(host: Element, selector: string): E[];
+/**
+ * Queries a shadow DOM element by its CSS `part` attribute — shorthand for
+ * `queryInShadow(host, '[part="name"]')`.
+ *
+ * @example
+ * const btn = queryPart(carousel, 'prev-btn');
+ * expect(btn).not.toBeNull();
+ */
+export declare function queryPart<E extends Element = Element>(host: Element, part: string): E | null;
+/**
+ * Returns the light-DOM children assigned to a named slot, or every slotted child (elements
+ * with no `slot` attribute) when no name is given.
+ *
+ * @example
+ * const slides = getSlotted(carousel);
+ * expect(slides).toHaveLength(3);
+ */
+export declare function getSlotted<E extends Element = Element>(host: Element, slotName?: string): E[];
+/**
+ * Create query helpers scoped to any element — useful for slotted/light DOM content.
+ *
+ * @example
+ * const panel = fixture.query('.panel')!;
+ * const { query } = within(panel);
+ * expect(query('.title')?.textContent).toBe('Hello');
+ */
+export declare function within(element: Element): QueryScope;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;IAC/D,QAAQ,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IAC7D,WAAW,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;IACpF,cAAc,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IAClF,aAAa,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;IACrE,gBAAgB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;CACpE;AAID,0FAA0F;AAC1F,wBAAgB,KAAK,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAEzG;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,EAAE,CAEvG;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAE/G;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAE7G;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EACrD,IAAI,EAAE,OAAO,GAAG,UAAU,EAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,CAAC,GAAG,IAAI,CAMV;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EACxD,IAAI,EAAE,OAAO,GAAG,UAAU,EAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,CAAC,EAAE,CAEL;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAEpG;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,EAAE,CAElG;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAE5F;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAI7F;AAID;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAUnD"}

package/dist/query.js

@@ -0,0 +1,47 @@
+//#region src/query.ts
+function e(e, t) {
+	return e.querySelector(t);
+}
+function t(e, t) {
+	return Array.from(e.querySelectorAll(t));
+}
+function n(e, t) {
+	return e.querySelector(`[data-testid="${t}"]`);
+}
+function r(e, t) {
+	return Array.from(e.querySelectorAll(`[data-testid="${t}"]`));
+}
+function i(e, t, n) {
+	for (let r of e.querySelectorAll(n)) if (r.textContent?.trim() === t) return r;
+	return null;
+}
+function a(e, t, n) {
+	return Array.from(e.querySelectorAll(n)).filter((e) => e.textContent?.trim() === t);
+}
+function o(e, t) {
+	return e.shadowRoot?.querySelector(t) ?? null;
+}
+function s(e, t) {
+	return Array.from(e.shadowRoot?.querySelectorAll(t) ?? []);
+}
+function c(e, t) {
+	return o(e, `[part="${t}"]`);
+}
+function l(e, t) {
+	let n = t ? `[slot="${t}"]` : ":not([slot])";
+	return Array.from(e.querySelectorAll(`:scope > ${n}`));
+}
+function u(o) {
+	return {
+		query: (t) => e(o, t),
+		queryAll: (e) => t(o, e),
+		queryAllByTestId: (e) => r(o, e),
+		queryAllByText: (e, t = "*") => a(o, e, t),
+		queryByTestId: (e) => n(o, e),
+		queryByText: (e, t = "*") => i(o, e, t)
+	};
+}
+//#endregion
+export { l as getSlotted, e as query, t as queryAll, r as queryAllByTestId, a as queryAllByText, s as queryAllInShadow, n as queryByTestId, i as queryByText, o as queryInShadow, c as queryPart, u as within };
+
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../src/query.ts"],"sourcesContent":["/**\n * DOM query helpers for test environments.\n */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Scoped query helpers for any DOM element — see {@link within} */\nexport interface QueryScope {\n  query<E extends Element = Element>(selector: string): E | null;\n  queryAll<E extends Element = Element>(selector: string): E[];\n  queryByText<E extends Element = Element>(text: string, selector?: string): E | null;\n  queryAllByText<E extends Element = Element>(text: string, selector?: string): E[];\n  queryByTestId<E extends Element = Element>(testId: string): E | null;\n  queryAllByTestId<E extends Element = Element>(testId: string): E[];\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\n/** Query a single element within `root`. Equivalent to `root.querySelector(selector)`. */\nexport function query<E extends Element = Element>(root: Element | ShadowRoot, selector: string): E | null {\n  return root.querySelector<E>(selector);\n}\n\n/** Query every element within `root` matching `selector`. */\nexport function queryAll<E extends Element = Element>(root: Element | ShadowRoot, selector: string): E[] {\n  return Array.from(root.querySelectorAll<E>(selector));\n}\n\n/** Query a single element within `root` by its `data-testid` attribute. */\nexport function queryByTestId<E extends Element = Element>(root: Element | ShadowRoot, testId: string): E | null {\n  return root.querySelector<E>(`[data-testid=\"${testId}\"]`);\n}\n\n/** Query every element within `root` matching a `data-testid` attribute. */\nexport function queryAllByTestId<E extends Element = Element>(root: Element | ShadowRoot, testId: string): E[] {\n  return Array.from(root.querySelectorAll<E>(`[data-testid=\"${testId}\"]`));\n}\n\nexport function queryByText<E extends Element = Element>(\n  root: Element | ShadowRoot,\n  text: string,\n  selector: string,\n): E | null {\n  for (const el of root.querySelectorAll<E>(selector)) {\n    if (el.textContent?.trim() === text) return el;\n  }\n\n  return null;\n}\n\nexport function queryAllByText<E extends Element = Element>(\n  root: Element | ShadowRoot,\n  text: string,\n  selector: string,\n): E[] {\n  return Array.from(root.querySelectorAll<E>(selector)).filter((el) => el.textContent?.trim() === text);\n}\n\n/**\n * Queries the shadow root of a custom element for a matching CSS selector.\n * Returns `null` if the element has no shadow root or no match is found — safe to call on\n * both open-shadow custom elements and plain elements without checking `shadowRoot` first.\n */\nexport function queryInShadow<E extends Element = Element>(host: Element, selector: string): E | null {\n  return host.shadowRoot?.querySelector<E>(selector) ?? null;\n}\n\n/** Queries all matching elements inside the shadow root of a custom element. */\nexport function queryAllInShadow<E extends Element = Element>(host: Element, selector: string): E[] {\n  return Array.from(host.shadowRoot?.querySelectorAll<E>(selector) ?? []);\n}\n\n/**\n * Queries a shadow DOM element by its CSS `part` attribute — shorthand for\n * `queryInShadow(host, '[part=\"name\"]')`.\n *\n * @example\n * const btn = queryPart(carousel, 'prev-btn');\n * expect(btn).not.toBeNull();\n */\nexport function queryPart<E extends Element = Element>(host: Element, part: string): E | null {\n  return queryInShadow<E>(host, `[part=\"${part}\"]`);\n}\n\n/**\n * Returns the light-DOM children assigned to a named slot, or every slotted child (elements\n * with no `slot` attribute) when no name is given.\n *\n * @example\n * const slides = getSlotted(carousel);\n * expect(slides).toHaveLength(3);\n */\nexport function getSlotted<E extends Element = Element>(host: Element, slotName?: string): E[] {\n  const selector = slotName ? `[slot=\"${slotName}\"]` : ':not([slot])';\n\n  return Array.from(host.querySelectorAll<E>(`:scope > ${selector}`));\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Create query helpers scoped to any element — useful for slotted/light DOM content.\n *\n * @example\n * const panel = fixture.query('.panel')!;\n * const { query } = within(panel);\n * expect(query('.title')?.textContent).toBe('Hello');\n */\nexport function within(element: Element): QueryScope {\n  return {\n    query: <E extends Element = Element>(selector: string) => query<E>(element, selector),\n    queryAll: <E extends Element = Element>(selector: string) => queryAll<E>(element, selector),\n    queryAllByTestId: <E extends Element = Element>(testId: string) => queryAllByTestId<E>(element, testId),\n    queryAllByText: <E extends Element = Element>(text: string, selector = '*') =>\n      queryAllByText<E>(element, text, selector),\n    queryByTestId: <E extends Element = Element>(testId: string) => queryByTestId<E>(element, testId),\n    queryByText: <E extends Element = Element>(text: string, selector = '*') => queryByText<E>(element, text, selector),\n  };\n}\n"],"mappings":";AAmBA,SAAgB,EAAmC,GAA4B,GAA4B;CACzG,OAAO,EAAK,cAAiB,CAAQ;AACvC;AAGA,SAAgB,EAAsC,GAA4B,GAAuB;CACvG,OAAO,MAAM,KAAK,EAAK,iBAAoB,CAAQ,CAAC;AACtD;AAGA,SAAgB,EAA2C,GAA4B,GAA0B;CAC/G,OAAO,EAAK,cAAiB,iBAAiB,EAAO,GAAG;AAC1D;AAGA,SAAgB,EAA8C,GAA4B,GAAqB;CAC7G,OAAO,MAAM,KAAK,EAAK,iBAAoB,iBAAiB,EAAO,GAAG,CAAC;AACzE;AAEA,SAAgB,EACd,GACA,GACA,GACU;CACV,KAAK,IAAM,KAAM,EAAK,iBAAoB,CAAQ,GAChD,IAAI,EAAG,aAAa,KAAK,MAAM,GAAM,OAAO;CAG9C,OAAO;AACT;AAEA,SAAgB,EACd,GACA,GACA,GACK;CACL,OAAO,MAAM,KAAK,EAAK,iBAAoB,CAAQ,CAAC,CAAC,CAAC,QAAQ,MAAO,EAAG,aAAa,KAAK,MAAM,CAAI;AACtG;AAOA,SAAgB,EAA2C,GAAe,GAA4B;CACpG,OAAO,EAAK,YAAY,cAAiB,CAAQ,KAAK;AACxD;AAGA,SAAgB,EAA8C,GAAe,GAAuB;CAClG,OAAO,MAAM,KAAK,EAAK,YAAY,iBAAoB,CAAQ,KAAK,CAAC,CAAC;AACxE;AAUA,SAAgB,EAAuC,GAAe,GAAwB;CAC5F,OAAO,EAAiB,GAAM,UAAU,EAAK,GAAG;AAClD;AAUA,SAAgB,EAAwC,GAAe,GAAwB;CAC7F,IAAM,IAAW,IAAW,UAAU,EAAS,MAAM;CAErD,OAAO,MAAM,KAAK,EAAK,iBAAoB,YAAY,GAAU,CAAC;AACpE;AAYA,SAAgB,EAAO,GAA8B;CACnD,OAAO;EACL,QAAqC,MAAqB,EAAS,GAAS,CAAQ;EACpF,WAAwC,MAAqB,EAAY,GAAS,CAAQ;EAC1F,mBAAgD,MAAmB,EAAoB,GAAS,CAAM;EACtG,iBAA8C,GAAc,IAAW,QACrE,EAAkB,GAAS,GAAM,CAAQ;EAC3C,gBAA6C,MAAmB,EAAiB,GAAS,CAAM;EAChG,cAA2C,GAAc,IAAW,QAAQ,EAAe,GAAS,GAAM,CAAQ;CACpH;AACF"}

package/dist/wait.cjs

@@ -0,0 +1,2 @@
+const e=require("./errors.cjs");async function t(t,{interval:n=50,message:r,timeout:a=1e3}={}){let o=Date.now()+a,s;for(;;){try{let e=await t();if(e===void 0||e)return}catch(e){s=e}if(Date.now()>=o)break;await i(n)}let c=`waitFor timed out after ${a}ms`,l=r?`${r} (${c})`:c,u=s instanceof Error?s.message:s==null?void 0:String(s);throw new e.AssayTimeoutError(u?`${l}\n${u}`:l,{cause:s})}function n(t,n,r=1e3){return new Promise((i,a)=>{let o=e=>{clearTimeout(s),i(e)},s=setTimeout(()=>{t.removeEventListener(n,o),a(new e.AssayTimeoutError(`waitForEvent: "${n}" timed out after ${r}ms`))},r);t.addEventListener(n,o,{once:!0})})}var r=()=>new Promise(e=>{queueMicrotask(e)}),i=(e=0)=>new Promise(t=>{setTimeout(t,e)});exports.nextTick=r,exports.wait=i,exports.waitFor=t,exports.waitForEvent=n;
+//# sourceMappingURL=wait.cjs.map

package/dist/wait.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.cjs","names":[],"sources":["../src/wait.ts"],"sourcesContent":["/**\n * Async waiting utilities for test environments.\n */\n\nimport { AssayTimeoutError } from './errors';\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface WaitOptions {\n  /** Maximum wait time in ms (default: 1000) */\n  timeout?: number;\n  /** Polling interval in ms (default: 50) */\n  interval?: number;\n  /** Message included in timeout error */\n  message?: string;\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Poll until a callback returns truthy (or void) without throwing.\n * Supports both boolean conditions and `expect()` assertions.\n *\n * - Returns truthy → success\n * - Returns `undefined` (e.g. bare `expect()` call) → success\n * - Returns falsy value → retry\n * - Throws → retry\n *\n * Always rejects with `AssayTimeoutError` on timeout, regardless of which of the two retry\n * reasons above was last observed — `instanceof AssayTimeoutError` is a reliable way to catch\n * \"the condition never became true\" without caring whether the last attempt returned falsy or\n * threw. The original failure (an assertion's message, a thrown error) is preserved as `.cause`,\n * not merged into a mutated copy of it — `fn`'s thrown errors are caller-owned and never mutated.\n *\n * @example\n * await waitFor(() => query('.status')?.textContent === 'loaded');\n * await waitFor(() => expect(count).toBe(3));\n */\nexport async function waitFor(\n  fn: () => unknown,\n  { interval = 50, message, timeout = 1000 }: WaitOptions = {},\n): Promise<void> {\n  const deadline = Date.now() + timeout;\n  let lastError: unknown;\n\n  // Single loop, one `fn()` call site — always tries once more before checking the deadline,\n  // so a condition that becomes true exactly as the timeout elapses still succeeds.\n  for (;;) {\n    try {\n      const result = await fn();\n\n      if (result === undefined || result) return;\n    } catch (e) {\n      lastError = e;\n    }\n\n    if (Date.now() >= deadline) break;\n\n    await wait(interval);\n  }\n\n  // The default timing summary always appears — a custom `message` adds context in front of it\n  // rather than replacing it, so a debugging session never loses \"how long did this actually wait\".\n  const timing = `waitFor timed out after ${timeout}ms`;\n  const base = message ? `${message} (${timing})` : timing;\n  const cause = lastError instanceof Error ? lastError.message : lastError != null ? String(lastError) : undefined;\n\n  throw new AssayTimeoutError(cause ? `${base}\\n${cause}` : base, { cause: lastError });\n}\n\n/**\n * Resolve when the target element emits the given event.\n *\n * @example\n * const promise = waitForEvent(el, 'change');\n * fire.click(trigger);\n * const event = await promise;\n */\nexport function waitForEvent<T extends Event = Event>(element: Element, name: string, timeout = 1000): Promise<T> {\n  return new Promise((resolve, reject) => {\n    const onEvent = (e: Event): void => {\n      clearTimeout(timer);\n      resolve(e as T);\n    };\n    const timer = setTimeout(() => {\n      element.removeEventListener(name, onEvent);\n      reject(new AssayTimeoutError(`waitForEvent: \"${name}\" timed out after ${timeout}ms`));\n    }, timeout);\n\n    element.addEventListener(name, onEvent, { once: true });\n  });\n}\n\n/**\n * Resolves after one microtask tick (`queueMicrotask`). Use to wait for reactivity (signal\n * effects, promise-chain continuations) to settle without moving into the macrotask queue —\n * cheaper and more precise than `wait(0)`, which yields to a full `setTimeout` turn instead.\n */\nexport const nextTick = (): Promise<void> =>\n  new Promise((resolve) => {\n    queueMicrotask(resolve);\n  });\n\n/**\n * Resolves after `ms` milliseconds. Prefer `nextTick()` for reactive updates and `waitFor()`\n * for polling a condition — reach for this only when a real macrotask delay is what the code\n * under test actually depends on (e.g. a debounce timer).\n */\nexport const wait = (ms = 0): Promise<void> =>\n  new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n"],"mappings":"gCAsCA,eAAsB,EACpB,EACA,CAAE,WAAW,GAAI,UAAS,UAAU,KAAsB,CAAC,EAC5C,CACf,IAAM,EAAW,KAAK,IAAI,EAAI,EAC1B,EAIJ,OAAS,CACP,GAAI,CACF,IAAM,EAAS,MAAM,EAAG,EAExB,GAAI,IAAW,IAAA,IAAa,EAAQ,MACtC,OAAS,EAAG,CACV,EAAY,CACd,CAEA,GAAI,KAAK,IAAI,GAAK,EAAU,MAE5B,MAAM,EAAK,CAAQ,CACrB,CAIA,IAAM,EAAS,2BAA2B,EAAQ,IAC5C,EAAO,EAAU,GAAG,EAAQ,IAAI,EAAO,GAAK,EAC5C,EAAQ,aAAqB,MAAQ,EAAU,QAAU,GAAa,KAA2B,IAAA,GAApB,OAAO,CAAS,EAEnG,MAAM,IAAI,EAAA,kBAAkB,EAAQ,GAAG,EAAK,IAAI,IAAU,EAAM,CAAE,MAAO,CAAU,CAAC,CACtF,CAUA,SAAgB,EAAsC,EAAkB,EAAc,EAAU,IAAkB,CAChH,OAAO,IAAI,SAAS,EAAS,IAAW,CACtC,IAAM,EAAW,GAAmB,CAClC,aAAa,CAAK,EAClB,EAAQ,CAAM,CAChB,EACM,EAAQ,eAAiB,CAC7B,EAAQ,oBAAoB,EAAM,CAAO,EACzC,EAAO,IAAI,EAAA,kBAAkB,kBAAkB,EAAK,oBAAoB,EAAQ,GAAG,CAAC,CACtF,EAAG,CAAO,EAEV,EAAQ,iBAAiB,EAAM,EAAS,CAAE,KAAM,EAAK,CAAC,CACxD,CAAC,CACH,CAOA,IAAa,MACX,IAAI,QAAS,GAAY,CACvB,eAAe,CAAO,CACxB,CAAC,EAOU,GAAQ,EAAK,IACxB,IAAI,QAAS,GAAY,CACvB,WAAW,EAAS,CAAE,CACxB,CAAC"}

package/dist/wait.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Async waiting utilities for test environments.
+ */
+export interface WaitOptions {
+    /** Maximum wait time in ms (default: 1000) */
+    timeout?: number;
+    /** Polling interval in ms (default: 50) */
+    interval?: number;
+    /** Message included in timeout error */
+    message?: string;
+}
+/**
+ * Poll until a callback returns truthy (or void) without throwing.
+ * Supports both boolean conditions and `expect()` assertions.
+ *
+ * - Returns truthy → success
+ * - Returns `undefined` (e.g. bare `expect()` call) → success
+ * - Returns falsy value → retry
+ * - Throws → retry
+ *
+ * Always rejects with `AssayTimeoutError` on timeout, regardless of which of the two retry
+ * reasons above was last observed — `instanceof AssayTimeoutError` is a reliable way to catch
+ * "the condition never became true" without caring whether the last attempt returned falsy or
+ * threw. The original failure (an assertion's message, a thrown error) is preserved as `.cause`,
+ * not merged into a mutated copy of it — `fn`'s thrown errors are caller-owned and never mutated.
+ *
+ * @example
+ * await waitFor(() => query('.status')?.textContent === 'loaded');
+ * await waitFor(() => expect(count).toBe(3));
+ */
+export declare function waitFor(fn: () => unknown, { interval, message, timeout }?: WaitOptions): Promise<void>;
+/**
+ * Resolve when the target element emits the given event.
+ *
+ * @example
+ * const promise = waitForEvent(el, 'change');
+ * fire.click(trigger);
+ * const event = await promise;
+ */
+export declare function waitForEvent<T extends Event = Event>(element: Element, name: string, timeout?: number): Promise<T>;
+/**
+ * Resolves after one microtask tick (`queueMicrotask`). Use to wait for reactivity (signal
+ * effects, promise-chain continuations) to settle without moving into the macrotask queue —
+ * cheaper and more precise than `wait(0)`, which yields to a full `setTimeout` turn instead.
+ */
+export declare const nextTick: () => Promise<void>;
+/**
+ * Resolves after `ms` milliseconds. Prefer `nextTick()` for reactive updates and `waitFor()`
+ * for polling a condition — reach for this only when a real macrotask delay is what the code
+ * under test actually depends on (e.g. a debounce timer).
+ */
+export declare const wait: (ms?: number) => Promise<void>;
+//# sourceMappingURL=wait.d.ts.map

package/dist/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../src/wait.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,OAAO,CAC3B,EAAE,EAAE,MAAM,OAAO,EACjB,EAAE,QAAa,EAAE,OAAO,EAAE,OAAc,EAAE,GAAE,WAAgB,GAC3D,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAahH;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,QAAO,OAAO,CAAC,IAAI,CAGpC,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,IAAI,GAAI,WAAM,KAAG,OAAO,CAAC,IAAI,CAGtC,CAAC"}

package/dist/wait.js

@@ -0,0 +1,36 @@
+import { AssayTimeoutError as e } from "./errors.js";
+//#region src/wait.ts
+async function t(t, { interval: n = 50, message: r, timeout: a = 1e3 } = {}) {
+	let o = Date.now() + a, s;
+	for (;;) {
+		try {
+			let e = await t();
+			if (e === void 0 || e) return;
+		} catch (e) {
+			s = e;
+		}
+		if (Date.now() >= o) break;
+		await i(n);
+	}
+	let c = `waitFor timed out after ${a}ms`, l = r ? `${r} (${c})` : c, u = s instanceof Error ? s.message : s == null ? void 0 : String(s);
+	throw new e(u ? `${l}\n${u}` : l, { cause: s });
+}
+function n(t, n, r = 1e3) {
+	return new Promise((i, a) => {
+		let o = (e) => {
+			clearTimeout(s), i(e);
+		}, s = setTimeout(() => {
+			t.removeEventListener(n, o), a(new e(`waitForEvent: "${n}" timed out after ${r}ms`));
+		}, r);
+		t.addEventListener(n, o, { once: !0 });
+	});
+}
+var r = () => new Promise((e) => {
+	queueMicrotask(e);
+}), i = (e = 0) => new Promise((t) => {
+	setTimeout(t, e);
+});
+//#endregion
+export { r as nextTick, i as wait, t as waitFor, n as waitForEvent };
+
+//# sourceMappingURL=wait.js.map

package/dist/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","names":[],"sources":["../src/wait.ts"],"sourcesContent":["/**\n * Async waiting utilities for test environments.\n */\n\nimport { AssayTimeoutError } from './errors';\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface WaitOptions {\n  /** Maximum wait time in ms (default: 1000) */\n  timeout?: number;\n  /** Polling interval in ms (default: 50) */\n  interval?: number;\n  /** Message included in timeout error */\n  message?: string;\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Poll until a callback returns truthy (or void) without throwing.\n * Supports both boolean conditions and `expect()` assertions.\n *\n * - Returns truthy → success\n * - Returns `undefined` (e.g. bare `expect()` call) → success\n * - Returns falsy value → retry\n * - Throws → retry\n *\n * Always rejects with `AssayTimeoutError` on timeout, regardless of which of the two retry\n * reasons above was last observed — `instanceof AssayTimeoutError` is a reliable way to catch\n * \"the condition never became true\" without caring whether the last attempt returned falsy or\n * threw. The original failure (an assertion's message, a thrown error) is preserved as `.cause`,\n * not merged into a mutated copy of it — `fn`'s thrown errors are caller-owned and never mutated.\n *\n * @example\n * await waitFor(() => query('.status')?.textContent === 'loaded');\n * await waitFor(() => expect(count).toBe(3));\n */\nexport async function waitFor(\n  fn: () => unknown,\n  { interval = 50, message, timeout = 1000 }: WaitOptions = {},\n): Promise<void> {\n  const deadline = Date.now() + timeout;\n  let lastError: unknown;\n\n  // Single loop, one `fn()` call site — always tries once more before checking the deadline,\n  // so a condition that becomes true exactly as the timeout elapses still succeeds.\n  for (;;) {\n    try {\n      const result = await fn();\n\n      if (result === undefined || result) return;\n    } catch (e) {\n      lastError = e;\n    }\n\n    if (Date.now() >= deadline) break;\n\n    await wait(interval);\n  }\n\n  // The default timing summary always appears — a custom `message` adds context in front of it\n  // rather than replacing it, so a debugging session never loses \"how long did this actually wait\".\n  const timing = `waitFor timed out after ${timeout}ms`;\n  const base = message ? `${message} (${timing})` : timing;\n  const cause = lastError instanceof Error ? lastError.message : lastError != null ? String(lastError) : undefined;\n\n  throw new AssayTimeoutError(cause ? `${base}\\n${cause}` : base, { cause: lastError });\n}\n\n/**\n * Resolve when the target element emits the given event.\n *\n * @example\n * const promise = waitForEvent(el, 'change');\n * fire.click(trigger);\n * const event = await promise;\n */\nexport function waitForEvent<T extends Event = Event>(element: Element, name: string, timeout = 1000): Promise<T> {\n  return new Promise((resolve, reject) => {\n    const onEvent = (e: Event): void => {\n      clearTimeout(timer);\n      resolve(e as T);\n    };\n    const timer = setTimeout(() => {\n      element.removeEventListener(name, onEvent);\n      reject(new AssayTimeoutError(`waitForEvent: \"${name}\" timed out after ${timeout}ms`));\n    }, timeout);\n\n    element.addEventListener(name, onEvent, { once: true });\n  });\n}\n\n/**\n * Resolves after one microtask tick (`queueMicrotask`). Use to wait for reactivity (signal\n * effects, promise-chain continuations) to settle without moving into the macrotask queue —\n * cheaper and more precise than `wait(0)`, which yields to a full `setTimeout` turn instead.\n */\nexport const nextTick = (): Promise<void> =>\n  new Promise((resolve) => {\n    queueMicrotask(resolve);\n  });\n\n/**\n * Resolves after `ms` milliseconds. Prefer `nextTick()` for reactive updates and `waitFor()`\n * for polling a condition — reach for this only when a real macrotask delay is what the code\n * under test actually depends on (e.g. a debounce timer).\n */\nexport const wait = (ms = 0): Promise<void> =>\n  new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n"],"mappings":";;AAsCA,eAAsB,EACpB,GACA,EAAE,cAAW,IAAI,YAAS,aAAU,QAAsB,CAAC,GAC5C;CACf,IAAM,IAAW,KAAK,IAAI,IAAI,GAC1B;CAIJ,SAAS;EACP,IAAI;GACF,IAAM,IAAS,MAAM,EAAG;GAExB,IAAI,MAAW,KAAA,KAAa,GAAQ;EACtC,SAAS,GAAG;GACV,IAAY;EACd;EAEA,IAAI,KAAK,IAAI,KAAK,GAAU;EAE5B,MAAM,EAAK,CAAQ;CACrB;CAIA,IAAM,IAAS,2BAA2B,EAAQ,KAC5C,IAAO,IAAU,GAAG,EAAQ,IAAI,EAAO,KAAK,GAC5C,IAAQ,aAAqB,QAAQ,EAAU,UAAU,KAAa,OAA2B,KAAA,IAApB,OAAO,CAAS;CAEnG,MAAM,IAAI,EAAkB,IAAQ,GAAG,EAAK,IAAI,MAAU,GAAM,EAAE,OAAO,EAAU,CAAC;AACtF;AAUA,SAAgB,EAAsC,GAAkB,GAAc,IAAU,KAAkB;CAChH,OAAO,IAAI,SAAS,GAAS,MAAW;EACtC,IAAM,KAAW,MAAmB;GAElC,AADA,aAAa,CAAK,GAClB,EAAQ,CAAM;EAChB,GACM,IAAQ,iBAAiB;GAE7B,AADA,EAAQ,oBAAoB,GAAM,CAAO,GACzC,EAAO,IAAI,EAAkB,kBAAkB,EAAK,oBAAoB,EAAQ,GAAG,CAAC;EACtF,GAAG,CAAO;EAEV,EAAQ,iBAAiB,GAAM,GAAS,EAAE,MAAM,GAAK,CAAC;CACxD,CAAC;AACH;AAOA,IAAa,UACX,IAAI,SAAS,MAAY;CACvB,eAAe,CAAO;AACxB,CAAC,GAOU,KAAQ,IAAK,MACxB,IAAI,SAAS,MAAY;CACvB,WAAW,GAAS,CAAE;AACxB,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@vielzeug/assay",
+  "version": "1.0.0",
+  "description": "Framework-agnostic DOM testing primitives — scoped queries and synchronous event dispatchers",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "vite build && pnpm run build:bundle && pnpm run build:types",
+    "build:types": "tsc -p tsconfig.declarations.json",
+    "fix": "eslint --fix src",
+    "lint": "eslint src",
+    "prepublishOnly": "pnpm run build",
+    "preview": "vite preview",
+    "test": "vitest",
+    "build:bundle": "vite build --config vite.bundle.config.ts"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "jsdom": "^29.1.1",
+    "typescript": "^6.0.3",
+    "vite": "^8.1.3",
+    "vitest": "^4.1.10"
+  }
+}