@vielzeug/assay 2.1.0 → 2.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/assay.cjs +1 -1
- package/dist/assay.cjs.map +1 -1
- package/dist/assay.iife.js +1 -1
- package/dist/assay.iife.js.map +1 -1
- package/dist/assay.js +1 -1
- package/dist/assay.js.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -3
- package/dist/live-region.cjs +2 -0
- package/dist/live-region.cjs.map +1 -0
- package/dist/live-region.d.ts +66 -0
- package/dist/live-region.d.ts.map +1 -0
- package/dist/live-region.js +65 -0
- package/dist/live-region.js.map +1 -0
- package/package.json +2 -1
package/dist/assay.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{},n=class extends e{},r=(e,t)=>e.dispatchEvent(t),i=(e,t={})=>r(e,new FocusEvent(`blur`,t)),a=(e,t={})=>r(e,new Event(`change`,{bubbles:!0,...t})),o=(e,t={})=>r(e,new MouseEvent(`click`,{bubbles:!0,cancelable:!0,...t})),s=(e,t,n={})=>r(e,new CustomEvent(t,{bubbles:!0,cancelable:!0,composed:!1,...n})),c=(e,t={})=>r(e,new FocusEvent(`focus`,t)),l=(e,t={})=>r(e,new InputEvent(`input`,{bubbles:!0,...t})),u=(e,t={})=>r(e,new KeyboardEvent(`keydown`,{bubbles:!0,cancelable:!0,...t})),d=(e,t={})=>r(e,new KeyboardEvent(`keyup`,{bubbles:!0,cancelable:!0,...t})),f=(e,t={})=>r(e,new SubmitEvent(`submit`,{bubbles:!0,cancelable:!0,...t})),p=e=>e
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{},n=class extends e{},r=(e,t)=>e.dispatchEvent(t),i=(e,t={})=>r(e,new FocusEvent(`blur`,t)),a=(e,t={})=>r(e,new Event(`change`,{bubbles:!0,...t})),o=(e,t={})=>r(e,new MouseEvent(`click`,{bubbles:!0,cancelable:!0,...t})),s=(e,t,n={})=>r(e,new CustomEvent(t,{bubbles:!0,cancelable:!0,composed:!1,...n})),c=(e,t={})=>r(e,new FocusEvent(`focus`,t)),l=(e,t={})=>r(e,new InputEvent(`input`,{bubbles:!0,...t})),u=(e,t={})=>r(e,new KeyboardEvent(`keydown`,{bubbles:!0,cancelable:!0,...t})),d=(e,t={})=>r(e,new KeyboardEvent(`keyup`,{bubbles:!0,cancelable:!0,...t})),f=(e,t={})=>r(e,new SubmitEvent(`submit`,{bubbles:!0,cancelable:!0,...t})),p=e=>e.reason??new DOMException(`The operation was aborted.`,`AbortError`),m=(e=0,{signal:t}={})=>new Promise((n,r)=>{if(t?.aborted){r(p(t));return}let i=setTimeout(a,e);function a(){t?.removeEventListener(`abort`,o),n()}function o(){clearTimeout(i),r(p(t))}t?.addEventListener(`abort`,o,{once:!0})});async function h(e,{interval:t=50,signal:r,timeout:i=1e3}={}){let a=Date.now()+i;for(;;){if(r?.aborted)throw p(r);if(await e())return;if(Date.now()>=a)break;await m(t,{signal:r})}throw new n(`waitUntil timed out after ${i}ms`)}async function g(e,{interval:t=50,message:r,signal:i,timeout:a=1e3}={}){let o=Date.now()+a,s;for(;;){if(i?.aborted)throw p(i);try{await e();return}catch(e){s=e}if(Date.now()>=o)break;await m(t,{signal:i})}let c=`retry timed out after ${a}ms`,l=r?`${r} (${c})`:c,u=s instanceof Error?s.message:s==null?``:String(s);throw new n(u?`${l}\n${u}`:l,{cause:s})}function _(e,t,{signal:r,timeout:i=1e3}={}){return new Promise((a,o)=>{if(r?.aborted){o(p(r));return}let s=()=>{clearTimeout(l),r?.removeEventListener(`abort`,u),e.removeEventListener(t,c)},c=e=>{s(),a(e)},l=setTimeout(()=>{s(),o(new n(`waitForEvent: "${t}" timed out after ${i}ms`))},i),u=()=>{s(),o(p(r))};e.addEventListener(t,c,{once:!0}),r?.addEventListener(`abort`,u,{once:!0})})}var v=()=>new Promise(e=>{queueMicrotask(e)}),y={alert:`assertive`,status:`polite`};function b(e){let t=e.getAttribute(`aria-live`);if(t)return t;let n=e.getAttribute(`role`);return n&&n in y?y[n]:null}function x(e={}){let t=e.document??(typeof document<`u`?document:null),n=e.politeness??`polite`,r=e.root??t?.body??null;if(!r)return null;let i=Array.from(r.querySelectorAll(`[aria-live], [role="status"], [role="alert"]`));for(let t of i)if(b(t)===n&&(e.role===void 0||t.getAttribute(`role`)===e.role))return t;return null}function S(e={}){let t=e.document??(typeof document<`u`?document:null),n=e.politeness??`polite`,r=e.root??t?.body??null;return r?Array.from(r.querySelectorAll(`[aria-live], [role="status"], [role="alert"]`)).filter(t=>!(b(t)!==n||e.role!==void 0&&t.getAttribute(`role`)!==e.role)):[]}async function C(e,n={}){let r=n.politeness??`polite`,i=null;return await g(()=>{let a=x({document:n.document,politeness:r,role:n.role,root:n.root});if(!a)throw new t(`No ${r} live region found.`);if(!a.textContent?.includes(e))throw new t(`Live region text "${a.textContent}" does not include "${e}".`);i=a},{interval:n.interval,message:`waitForLiveRegion("${e}")`,signal:n.signal,timeout:n.timeout}),i}async function w(e={}){let n=e.politeness??`polite`;await g(()=>{let r=x({document:e.document,politeness:n,role:e.role,root:e.root});if(!r)throw new t(`No ${n} live region found.`);if(r.textContent!==``)throw new t(`Live region not cleared: "${r.textContent}".`)},{interval:e.interval,message:`waitForLiveRegionCleared`,signal:e.signal,timeout:e.timeout})}var T=e=>e instanceof Element?e.outerHTML.slice(0,500):e instanceof ShadowRoot?`<shadow-root>${e.innerHTML.slice(0,500)}</shadow-root>`:e.nodeName,E=(e,n,r)=>{if(e)return e;throw new t(`Unable to find ${n} within ${T(r)}.`)},D=(e,t)=>e.querySelector(t),O=(e,t)=>Array.from(e.querySelectorAll(t)),k=(e,t)=>O(e,`[data-testid]`).find(e=>e.getAttribute(`data-testid`)===t)??null,A=(e,t)=>O(e,`[data-testid]`).filter(e=>e.getAttribute(`data-testid`)===t),j=(e,t,n=`*`)=>{for(let r of e.querySelectorAll(n))if(r.textContent?.trim()===t)return r;return null},M=(e,t,n=`*`)=>Array.from(e.querySelectorAll(n)).filter(e=>e.textContent?.trim()===t);function N(e,t){return e.shadowRoot?D(e.shadowRoot,t):null}function P(e,t){return e.shadowRoot?O(e.shadowRoot,t):[]}function F(e,t){return P(e,`[part]`).find(e=>e.getAttribute(`part`)?.split(/\s+/).includes(t))??null}function I(e,t){return Array.from(e.children).filter(e=>t===void 0?!e.getAttribute(`slot`):e.getAttribute(`slot`)===t)}function L(e){return{get:t=>E(D(e,t),`"${t}"`,e),getByTestId:t=>E(k(e,t),`data-testid "${t}"`,e),getByText:(t,n=`*`)=>E(j(e,t,n),`text "${t}" matching "${n}"`,e),query:t=>D(e,t),queryAll:t=>O(e,t),queryAllByTestId:t=>A(e,t),queryAllByText:(t,n=`*`)=>M(e,t,n),queryByTestId:t=>k(e,t),queryByText:(t,n=`*`)=>j(e,t,n)}}exports.AssayError=e,exports.AssayQueryError=t,exports.AssayTimeoutError=n,exports.delay=m,exports.dispatch=r,exports.fireBlur=i,exports.fireChange=a,exports.fireClick=o,exports.fireCustom=s,exports.fireFocus=c,exports.fireInput=l,exports.fireKeyDown=u,exports.fireKeyUp=d,exports.fireSubmit=f,exports.getSlotted=I,exports.nextTick=v,exports.queryAllInShadow=P,exports.queryAllLiveRegions=S,exports.queryInShadow=N,exports.queryLiveRegion=x,exports.queryPart=F,exports.retry=g,exports.waitForEvent=_,exports.waitForLiveRegion=C,exports.waitForLiveRegionCleared=w,exports.waitUntil=h,exports.within=L;
|
|
2
2
|
//# sourceMappingURL=assay.cjs.map
|
package/dist/assay.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"assay.cjs","names":[],"sources":["../src/errors.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\n/** Thrown when a required query has no match. */\nexport class AssayQueryError extends AssayError {}\n\n/** Thrown by `waitUntil`/`retry`/`waitForEvent` when the timeout elapses. */\nexport class AssayTimeoutError extends AssayError {}\n","/** Synchronous, exact DOM event dispatchers for test environments. */\n\n/** Dispatch an event instance without modifying it. */\nexport const dispatch = (target: EventTarget, event: Event): boolean => target.dispatchEvent(event);\n\nexport const fireBlur = (target: EventTarget, init: FocusEventInit = {}): boolean =>\n dispatch(target, new FocusEvent('blur', init));\n\nexport const fireChange = (target: EventTarget, init: EventInit = {}): boolean =>\n dispatch(target, new Event('change', { bubbles: true, ...init }));\n\nexport const fireClick = (target: EventTarget, init: MouseEventInit = {}): boolean =>\n dispatch(target, new MouseEvent('click', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireCustom = <T>(target: EventTarget, type: string, init: CustomEventInit<T> = {}): boolean =>\n dispatch(target, new CustomEvent(type, { bubbles: true, cancelable: true, composed: false, ...init }));\n\nexport const fireFocus = (target: EventTarget, init: FocusEventInit = {}): boolean =>\n dispatch(target, new FocusEvent('focus', init));\n\nexport const fireInput = (target: EventTarget, init: InputEventInit = {}): boolean =>\n dispatch(target, new InputEvent('input', { bubbles: true, ...init }));\n\nexport const fireKeyDown = (target: EventTarget, init: KeyboardEventInit = {}): boolean =>\n dispatch(target, new KeyboardEvent('keydown', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireKeyUp = (target: EventTarget, init: KeyboardEventInit = {}): boolean =>\n dispatch(target, new KeyboardEvent('keyup', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireSubmit = (target: EventTarget, init: SubmitEventInit = {}): boolean =>\n dispatch(target, new SubmitEvent('submit', { bubbles: true, cancelable: true, ...init }));\n","import { AssayQueryError } from './errors';\n\n/** DOM query helpers for test environments. */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Scoped query helpers for any queryable DOM root — see {@link within}. */\nexport interface QueryScope {\n get<E extends Element = Element>(selector: string): E;\n getByTestId<E extends Element = Element>(testId: string): E;\n getByText<E extends Element = Element>(text: string, selector?: string): E;\n query<E extends Element = Element>(selector: string): E | null;\n queryAll<E extends Element = Element>(selector: string): E[];\n queryAllByTestId<E extends Element = Element>(testId: string): E[];\n queryAllByText<E extends Element = Element>(text: string, selector?: string): E[];\n queryByTestId<E extends Element = Element>(testId: string): E | null;\n queryByText<E extends Element = Element>(text: string, selector?: string): E | null;\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\ntype QueryRoot = ParentNode;\n\nconst describeRoot = (root: QueryRoot): string => {\n if (root instanceof Element) return root.outerHTML.slice(0, 500);\n\n if (root instanceof ShadowRoot) return `<shadow-root>${root.innerHTML.slice(0, 500)}</shadow-root>`;\n\n return root.nodeName;\n};\n\nconst requireMatch = <E extends Element>(element: E | null, description: string, root: QueryRoot): E => {\n if (element) return element;\n\n throw new AssayQueryError(`Unable to find ${description} within ${describeRoot(root)}.`);\n};\n\nconst query = <E extends Element = Element>(root: QueryRoot, selector: string): E | null =>\n root.querySelector<E>(selector);\n\nconst queryAll = <E extends Element = Element>(root: QueryRoot, selector: string): E[] => {\n return Array.from(root.querySelectorAll<E>(selector));\n};\n\nconst queryByTestId = <E extends Element = Element>(root: QueryRoot, testId: string): E | null =>\n queryAll<E>(root, '[data-testid]').find((element) => element.getAttribute('data-testid') === testId) ?? null;\n\nconst queryAllByTestId = <E extends Element = Element>(root: QueryRoot, testId: string): E[] =>\n queryAll<E>(root, '[data-testid]').filter((element) => element.getAttribute('data-testid') === testId);\n\nconst queryByText = <E extends Element = Element>(root: QueryRoot, text: string, selector = '*'): 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\nconst queryAllByText = <E extends Element = Element>(root: QueryRoot, text: string, selector = '*'): 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 ? query<E>(host.shadowRoot, 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 host.shadowRoot ? queryAll<E>(host.shadowRoot, 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 (\n queryAllInShadow<E>(host, '[part]').find((element) => element.getAttribute('part')?.split(/\\s+/).includes(part)) ??\n null\n );\n}\n\n/**\n * Returns the light-DOM children assigned to a named slot, or every child assigned to the\n * default slot 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 return Array.from(host.children).filter((element) =>\n slotName === undefined ? !element.getAttribute('slot') : element.getAttribute('slot') === slotName,\n ) as E[];\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Create query helpers scoped to a DOM root — useful for light DOM and shadow roots.\n *\n * @example\n * const view = within(fixture.shadow!);\n * expect(view.get('.title').textContent).toBe('Hello');\n */\nexport function within(root: QueryRoot): QueryScope {\n return {\n get: <E extends Element = Element>(selector: string) =>\n requireMatch(query<E>(root, selector), `\"${selector}\"`, root),\n getByTestId: <E extends Element = Element>(testId: string) =>\n requireMatch(queryByTestId<E>(root, testId), `data-testid \"${testId}\"`, root),\n getByText: <E extends Element = Element>(text: string, selector = '*') =>\n requireMatch(queryByText<E>(root, text, selector), `text \"${text}\" matching \"${selector}\"`, root),\n query: <E extends Element = Element>(selector: string) => query<E>(root, selector),\n queryAll: <E extends Element = Element>(selector: string) => queryAll<E>(root, selector),\n queryAllByTestId: <E extends Element = Element>(testId: string) => queryAllByTestId<E>(root, testId),\n queryAllByText: <E extends Element = Element>(text: string, selector = '*') =>\n queryAllByText<E>(root, text, selector),\n queryByTestId: <E extends Element = Element>(testId: string) => queryByTestId<E>(root, testId),\n queryByText: <E extends Element = Element>(text: string, selector = '*') => queryByText<E>(root, text, selector),\n };\n}\n","import { AssayTimeoutError } from './errors';\n\nexport interface WaitOptions {\n /** Polling interval in ms (default: 50). */\n interval?: number;\n /** Cancel the pending wait. */\n signal?: AbortSignal;\n /** Maximum wait time in ms (default: 1000). */\n timeout?: number;\n}\n\nexport interface RetryOptions extends WaitOptions {\n /** Context included in the timeout error. */\n message?: string;\n}\n\nexport interface DelayOptions {\n /** Cancel the pending delay. */\n signal?: AbortSignal;\n}\n\nconst abortReason = (signal: AbortSignal): unknown =>\n signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\n\n/**\n * Resolve after `ms` milliseconds. Rejects with the abort reason when cancelled.\n */\nexport const delay = (ms = 0, { signal }: DelayOptions = {}): Promise<void> =>\n new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(abortReason(signal));\n\n return;\n }\n\n const timer = setTimeout(done, ms);\n\n function done(): void {\n signal?.removeEventListener('abort', abort);\n resolve();\n }\n\n function abort(): void {\n clearTimeout(timer);\n reject(abortReason(signal!));\n }\n\n signal?.addEventListener('abort', abort, { once: true });\n });\n\n/** Poll until a synchronous or asynchronous predicate returns `true`. */\nexport async function waitUntil(\n predicate: () => boolean | Promise<boolean>,\n { interval = 50, signal, timeout = 1000 }: WaitOptions = {},\n): Promise<void> {\n const deadline = Date.now() + timeout;\n\n for (;;) {\n if (signal?.aborted) throw abortReason(signal);\n\n if (await predicate()) return;\n\n if (Date.now() >= deadline) break;\n\n await delay(interval, { signal });\n }\n\n throw new AssayTimeoutError(`waitUntil timed out after ${timeout}ms`);\n}\n\n/** Retry an assertion until it stops throwing. */\nexport async function retry(\n assertion: () => void | Promise<void>,\n { interval = 50, message, signal, timeout = 1000 }: RetryOptions = {},\n): Promise<void> {\n const deadline = Date.now() + timeout;\n let lastError: unknown;\n\n for (;;) {\n if (signal?.aborted) throw abortReason(signal);\n\n try {\n await assertion();\n\n return;\n } catch (error) {\n lastError = error;\n }\n\n if (Date.now() >= deadline) break;\n\n await delay(interval, { signal });\n }\n\n const timing = `retry timed out after ${timeout}ms`;\n const context = message ? `${message} (${timing})` : timing;\n const detail = lastError instanceof Error ? lastError.message : lastError == null ? '' : String(lastError);\n\n throw new AssayTimeoutError(detail ? `${context}\\n${detail}` : context, { cause: lastError });\n}\n\n/** Resolve with the next event of `type`, or reject when it times out or is aborted. */\nexport function waitForEvent<T extends Event = Event>(\n target: EventTarget,\n type: string,\n { signal, timeout = 1000 }: Omit<WaitOptions, 'interval'> = {},\n): Promise<T> {\n return new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(abortReason(signal));\n\n return;\n }\n\n const dispose = () => {\n clearTimeout(timer);\n signal?.removeEventListener('abort', onAbort);\n target.removeEventListener(type, onEvent);\n };\n const onEvent = (e: Event): void => {\n dispose();\n resolve(e as T);\n };\n const timer = setTimeout(() => {\n dispose();\n reject(new AssayTimeoutError(`waitForEvent: \"${type}\" timed out after ${timeout}ms`));\n }, timeout);\n const onAbort = () => {\n dispose();\n reject(abortReason(signal!));\n };\n\n target.addEventListener(type, onEvent, { once: true });\n signal?.addEventListener('abort', onAbort, { once: true });\n });\n}\n\n/** Resolve after one microtask tick. */\nexport const nextTick = (): Promise<void> =>\n new Promise((resolve) => {\n queueMicrotask(resolve);\n });\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"assay.cjs","names":[],"sources":["../src/errors.ts","../src/events.ts","../src/wait.ts","../src/live-region.ts","../src/query.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\n/** Thrown when a required query has no match. */\nexport class AssayQueryError extends AssayError {}\n\n/** Thrown by `waitUntil`/`retry`/`waitForEvent` when the timeout elapses. */\nexport class AssayTimeoutError extends AssayError {}\n","/** Synchronous, exact DOM event dispatchers for test environments. */\n\n/** Dispatch an event instance without modifying it. */\nexport const dispatch = (target: EventTarget, event: Event): boolean => target.dispatchEvent(event);\n\nexport const fireBlur = (target: EventTarget, init: FocusEventInit = {}): boolean =>\n dispatch(target, new FocusEvent('blur', init));\n\nexport const fireChange = (target: EventTarget, init: EventInit = {}): boolean =>\n dispatch(target, new Event('change', { bubbles: true, ...init }));\n\nexport const fireClick = (target: EventTarget, init: MouseEventInit = {}): boolean =>\n dispatch(target, new MouseEvent('click', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireCustom = <T>(target: EventTarget, type: string, init: CustomEventInit<T> = {}): boolean =>\n dispatch(target, new CustomEvent(type, { bubbles: true, cancelable: true, composed: false, ...init }));\n\nexport const fireFocus = (target: EventTarget, init: FocusEventInit = {}): boolean =>\n dispatch(target, new FocusEvent('focus', init));\n\nexport const fireInput = (target: EventTarget, init: InputEventInit = {}): boolean =>\n dispatch(target, new InputEvent('input', { bubbles: true, ...init }));\n\nexport const fireKeyDown = (target: EventTarget, init: KeyboardEventInit = {}): boolean =>\n dispatch(target, new KeyboardEvent('keydown', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireKeyUp = (target: EventTarget, init: KeyboardEventInit = {}): boolean =>\n dispatch(target, new KeyboardEvent('keyup', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireSubmit = (target: EventTarget, init: SubmitEventInit = {}): boolean =>\n dispatch(target, new SubmitEvent('submit', { bubbles: true, cancelable: true, ...init }));\n","import { AssayTimeoutError } from './errors';\n\nexport interface WaitOptions {\n /** Polling interval in ms (default: 50). */\n interval?: number;\n /** Cancel the pending wait. */\n signal?: AbortSignal;\n /** Maximum wait time in ms (default: 1000). */\n timeout?: number;\n}\n\nexport interface RetryOptions extends WaitOptions {\n /** Context included in the timeout error. */\n message?: string;\n}\n\nexport interface DelayOptions {\n /** Cancel the pending delay. */\n signal?: AbortSignal;\n}\n\nconst abortReason = (signal: AbortSignal): unknown =>\n signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\n\n/**\n * Resolve after `ms` milliseconds. Rejects with the abort reason when cancelled.\n */\nexport const delay = (ms = 0, { signal }: DelayOptions = {}): Promise<void> =>\n new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(abortReason(signal));\n\n return;\n }\n\n const timer = setTimeout(done, ms);\n\n function done(): void {\n signal?.removeEventListener('abort', abort);\n resolve();\n }\n\n function abort(): void {\n clearTimeout(timer);\n reject(abortReason(signal!));\n }\n\n signal?.addEventListener('abort', abort, { once: true });\n });\n\n/** Poll until a synchronous or asynchronous predicate returns `true`. */\nexport async function waitUntil(\n predicate: () => boolean | Promise<boolean>,\n { interval = 50, signal, timeout = 1000 }: WaitOptions = {},\n): Promise<void> {\n const deadline = Date.now() + timeout;\n\n for (;;) {\n if (signal?.aborted) throw abortReason(signal);\n\n if (await predicate()) return;\n\n if (Date.now() >= deadline) break;\n\n await delay(interval, { signal });\n }\n\n throw new AssayTimeoutError(`waitUntil timed out after ${timeout}ms`);\n}\n\n/** Retry an assertion until it stops throwing. */\nexport async function retry(\n assertion: () => void | Promise<void>,\n { interval = 50, message, signal, timeout = 1000 }: RetryOptions = {},\n): Promise<void> {\n const deadline = Date.now() + timeout;\n let lastError: unknown;\n\n for (;;) {\n if (signal?.aborted) throw abortReason(signal);\n\n try {\n await assertion();\n\n return;\n } catch (error) {\n lastError = error;\n }\n\n if (Date.now() >= deadline) break;\n\n await delay(interval, { signal });\n }\n\n const timing = `retry timed out after ${timeout}ms`;\n const context = message ? `${message} (${timing})` : timing;\n const detail = lastError instanceof Error ? lastError.message : lastError == null ? '' : String(lastError);\n\n throw new AssayTimeoutError(detail ? `${context}\\n${detail}` : context, { cause: lastError });\n}\n\n/** Resolve with the next event of `type`, or reject when it times out or is aborted. */\nexport function waitForEvent<T extends Event = Event>(\n target: EventTarget,\n type: string,\n { signal, timeout = 1000 }: Omit<WaitOptions, 'interval'> = {},\n): Promise<T> {\n return new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(abortReason(signal));\n\n return;\n }\n\n const dispose = () => {\n clearTimeout(timer);\n signal?.removeEventListener('abort', onAbort);\n target.removeEventListener(type, onEvent);\n };\n const onEvent = (e: Event): void => {\n dispose();\n resolve(e as T);\n };\n const timer = setTimeout(() => {\n dispose();\n reject(new AssayTimeoutError(`waitForEvent: \"${type}\" timed out after ${timeout}ms`));\n }, timeout);\n const onAbort = () => {\n dispose();\n reject(abortReason(signal!));\n };\n\n target.addEventListener(type, onEvent, { once: true });\n signal?.addEventListener('abort', onAbort, { once: true });\n });\n}\n\n/** Resolve after one microtask tick. */\nexport const nextTick = (): Promise<void> =>\n new Promise((resolve) => {\n queueMicrotask(resolve);\n });\n","import { AssayQueryError } from './errors';\nimport { retry, type WaitOptions } from './wait';\n\n/** Politeness levels for ARIA live regions. */\nexport type LiveRegionPoliteness = 'assertive' | 'off' | 'polite';\n\n/**\n * ARIA roles that carry an implicit `aria-live` value per the WAI-ARIA spec.\n * `role=\"status\"` → `polite`, `role=\"alert\"` → `assertive`. Elements with these\n * roles are live regions even without an explicit `aria-live` attribute.\n */\nconst IMPLICIT_ROLE_POLITENESS: Record<string, LiveRegionPoliteness> = {\n alert: 'assertive',\n status: 'polite',\n};\n\nexport interface LiveRegionQueryOptions {\n /** The document to search. Defaults to the global `document`. */\n document?: Document;\n /** Politeness to match via `aria-live` (or implicit role). Defaults to `'polite'`. */\n politeness?: LiveRegionPoliteness;\n /** ARIA role to match (e.g. `'status'`, `'alert'`). Omit to match any role. */\n role?: string;\n /** Root to scope the query. Defaults to `document.body`. */\n root?: ParentNode;\n}\n\n/**\n * Resolves the effective politeness of an element: explicit `aria-live` wins,\n * otherwise falls back to the implicit value from `role=\"status\"`/`role=\"alert\"`.\n * Returns `null` when the element is not a live region.\n */\nfunction resolvePoliteness(el: HTMLElement): LiveRegionPoliteness | null {\n const explicit = el.getAttribute('aria-live');\n\n if (explicit) return explicit as LiveRegionPoliteness;\n\n const role = el.getAttribute('role');\n\n if (role && role in IMPLICIT_ROLE_POLITENESS) return IMPLICIT_ROLE_POLITENESS[role];\n\n return null;\n}\n\n/**\n * Queries the first live region matching the given politeness (and optional role)\n * within `root`. Returns `null` when none exists — safe to call before the region\n * has been lazily created.\n *\n * Matches both explicit `aria-live` attributes and implicit roles (`status` →\n * polite, `alert` → assertive) per the WAI-ARIA spec.\n *\n * @example\n * const region = queryLiveRegion({ politeness: 'polite' });\n * expect(region).not.toBeNull();\n */\nexport function queryLiveRegion(options: LiveRegionQueryOptions = {}): HTMLElement | null {\n const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n const politeness = options.politeness ?? 'polite';\n const root = options.root ?? doc?.body ?? null;\n\n if (!root) return null;\n\n const candidates = Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]'));\n\n for (const el of candidates) {\n if (resolvePoliteness(el) !== politeness) continue;\n\n if (options.role !== undefined && el.getAttribute('role') !== options.role) continue;\n\n return el;\n }\n\n return null;\n}\n\n/**\n * Queries all live regions matching the given politeness (and optional role)\n * within `root`. Useful for asserting no duplicate regions were created.\n *\n * @example\n * expect(queryAllLiveRegions({ politeness: 'polite' })).toHaveLength(1);\n */\nexport function queryAllLiveRegions(options: LiveRegionQueryOptions = {}): HTMLElement[] {\n const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n const politeness = options.politeness ?? 'polite';\n const root = options.root ?? doc?.body ?? null;\n\n if (!root) return [];\n\n return Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]')).filter((el) => {\n if (resolvePoliteness(el) !== politeness) return false;\n\n if (options.role !== undefined && el.getAttribute('role') !== options.role) return false;\n\n return true;\n });\n}\n\nexport interface WaitForLiveRegionOptions extends WaitOptions {\n /** The document to search. Defaults to the global `document`. */\n document?: Document;\n /** Politeness to match via `aria-live`. Defaults to `'polite'`. */\n politeness?: LiveRegionPoliteness;\n /** ARIA role to match. Omit to match any role. */\n role?: string;\n /** Root to scope the query. Defaults to `document.body`. */\n root?: ParentNode;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and contains\n * `text` (substring match). Throws `AssayTimeoutError` on timeout.\n *\n * Handles the clear-then-set announce pattern: the region may briefly be empty\n * before the message is written, so polling until the text appears is the\n * correct approach rather than a single snapshot assertion.\n *\n * @example\n * await waitForLiveRegion({ text: '3 results found' });\n * await waitForLiveRegion({ politeness: 'assertive', text: 'Session expired' });\n */\nexport async function waitForLiveRegion(text: string, options: WaitForLiveRegionOptions = {}): Promise<HTMLElement> {\n const politeness = options.politeness ?? 'polite';\n let matched: HTMLElement | null = null;\n\n await retry(\n () => {\n const region = queryLiveRegion({\n document: options.document,\n politeness,\n role: options.role,\n root: options.root,\n });\n\n if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n if (!region.textContent?.includes(text)) {\n throw new AssayQueryError(`Live region text \"${region.textContent}\" does not include \"${text}\".`);\n }\n\n matched = region;\n },\n {\n interval: options.interval,\n message: `waitForLiveRegion(\"${text}\")`,\n signal: options.signal,\n timeout: options.timeout,\n },\n );\n\n // `retry` only resolves once the assertion stops throwing, so `matched` is set.\n return matched!;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and is empty\n * (cleared). Throws `AssayTimeoutError` on timeout.\n *\n * @example\n * await waitForLiveRegionCleared();\n */\nexport async function waitForLiveRegionCleared(options: WaitForLiveRegionOptions = {}): Promise<void> {\n const politeness = options.politeness ?? 'polite';\n\n await retry(\n () => {\n const region = queryLiveRegion({\n document: options.document,\n politeness,\n role: options.role,\n root: options.root,\n });\n\n if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n if (region.textContent !== '') {\n throw new AssayQueryError(`Live region not cleared: \"${region.textContent}\".`);\n }\n },\n {\n interval: options.interval,\n message: 'waitForLiveRegionCleared',\n signal: options.signal,\n timeout: options.timeout,\n },\n );\n}\n","import { AssayQueryError } from './errors';\n\n/** DOM query helpers for test environments. */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Scoped query helpers for any queryable DOM root — see {@link within}. */\nexport interface QueryScope {\n get<E extends Element = Element>(selector: string): E;\n getByTestId<E extends Element = Element>(testId: string): E;\n getByText<E extends Element = Element>(text: string, selector?: string): E;\n query<E extends Element = Element>(selector: string): E | null;\n queryAll<E extends Element = Element>(selector: string): E[];\n queryAllByTestId<E extends Element = Element>(testId: string): E[];\n queryAllByText<E extends Element = Element>(text: string, selector?: string): E[];\n queryByTestId<E extends Element = Element>(testId: string): E | null;\n queryByText<E extends Element = Element>(text: string, selector?: string): E | null;\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\ntype QueryRoot = ParentNode;\n\nconst describeRoot = (root: QueryRoot): string => {\n if (root instanceof Element) return root.outerHTML.slice(0, 500);\n\n if (root instanceof ShadowRoot) return `<shadow-root>${root.innerHTML.slice(0, 500)}</shadow-root>`;\n\n return root.nodeName;\n};\n\nconst requireMatch = <E extends Element>(element: E | null, description: string, root: QueryRoot): E => {\n if (element) return element;\n\n throw new AssayQueryError(`Unable to find ${description} within ${describeRoot(root)}.`);\n};\n\nconst query = <E extends Element = Element>(root: QueryRoot, selector: string): E | null =>\n root.querySelector<E>(selector);\n\nconst queryAll = <E extends Element = Element>(root: QueryRoot, selector: string): E[] => {\n return Array.from(root.querySelectorAll<E>(selector));\n};\n\nconst queryByTestId = <E extends Element = Element>(root: QueryRoot, testId: string): E | null =>\n queryAll<E>(root, '[data-testid]').find((element) => element.getAttribute('data-testid') === testId) ?? null;\n\nconst queryAllByTestId = <E extends Element = Element>(root: QueryRoot, testId: string): E[] =>\n queryAll<E>(root, '[data-testid]').filter((element) => element.getAttribute('data-testid') === testId);\n\nconst queryByText = <E extends Element = Element>(root: QueryRoot, text: string, selector = '*'): 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\nconst queryAllByText = <E extends Element = Element>(root: QueryRoot, text: string, selector = '*'): 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 ? query<E>(host.shadowRoot, 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 host.shadowRoot ? queryAll<E>(host.shadowRoot, 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 (\n queryAllInShadow<E>(host, '[part]').find((element) => element.getAttribute('part')?.split(/\\s+/).includes(part)) ??\n null\n );\n}\n\n/**\n * Returns the light-DOM children assigned to a named slot, or every child assigned to the\n * default slot 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 return Array.from(host.children).filter((element) =>\n slotName === undefined ? !element.getAttribute('slot') : element.getAttribute('slot') === slotName,\n ) as E[];\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Create query helpers scoped to a DOM root — useful for light DOM and shadow roots.\n *\n * @example\n * const view = within(fixture.shadow!);\n * expect(view.get('.title').textContent).toBe('Hello');\n */\nexport function within(root: QueryRoot): QueryScope {\n return {\n get: <E extends Element = Element>(selector: string) =>\n requireMatch(query<E>(root, selector), `\"${selector}\"`, root),\n getByTestId: <E extends Element = Element>(testId: string) =>\n requireMatch(queryByTestId<E>(root, testId), `data-testid \"${testId}\"`, root),\n getByText: <E extends Element = Element>(text: string, selector = '*') =>\n requireMatch(queryByText<E>(root, text, selector), `text \"${text}\" matching \"${selector}\"`, root),\n query: <E extends Element = Element>(selector: string) => query<E>(root, selector),\n queryAll: <E extends Element = Element>(selector: string) => queryAll<E>(root, selector),\n queryAllByTestId: <E extends Element = Element>(testId: string) => queryAllByTestId<E>(root, testId),\n queryAllByText: <E extends Element = Element>(text: string, selector = '*') =>\n queryAllByText<E>(root, text, selector),\n queryByTestId: <E extends Element = Element>(testId: string) => queryByTestId<E>(root, testId),\n queryByText: <E extends Element = Element>(text: string, selector = '*') => queryByText<E>(root, text, selector),\n };\n}\n"],"mappings":"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"}
|
package/dist/assay.iife.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
var Assay=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},n=class extends t{},r=class extends t{},i=(e,t)=>e.dispatchEvent(t),a=(e,t={})=>i(e,new FocusEvent(`blur`,t)),o=(e,t={})=>i(e,new Event(`change`,{bubbles:!0,...t})),s=(e,t={})=>i(e,new MouseEvent(`click`,{bubbles:!0,cancelable:!0,...t})),c=(e,t,n={})=>i(e,new CustomEvent(t,{bubbles:!0,cancelable:!0,composed:!1,...n})),l=(e,t={})=>i(e,new FocusEvent(`focus`,t)),u=(e,t={})=>i(e,new InputEvent(`input`,{bubbles:!0,...t})),d=(e,t={})=>i(e,new KeyboardEvent(`keydown`,{bubbles:!0,cancelable:!0,...t})),f=(e,t={})=>i(e,new KeyboardEvent(`keyup`,{bubbles:!0,cancelable:!0,...t})),p=(e,t={})=>i(e,new SubmitEvent(`submit`,{bubbles:!0,cancelable:!0,...t})),m=e=>e
|
|
1
|
+
var Assay=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},n=class extends t{},r=class extends t{},i=(e,t)=>e.dispatchEvent(t),a=(e,t={})=>i(e,new FocusEvent(`blur`,t)),o=(e,t={})=>i(e,new Event(`change`,{bubbles:!0,...t})),s=(e,t={})=>i(e,new MouseEvent(`click`,{bubbles:!0,cancelable:!0,...t})),c=(e,t,n={})=>i(e,new CustomEvent(t,{bubbles:!0,cancelable:!0,composed:!1,...n})),l=(e,t={})=>i(e,new FocusEvent(`focus`,t)),u=(e,t={})=>i(e,new InputEvent(`input`,{bubbles:!0,...t})),d=(e,t={})=>i(e,new KeyboardEvent(`keydown`,{bubbles:!0,cancelable:!0,...t})),f=(e,t={})=>i(e,new KeyboardEvent(`keyup`,{bubbles:!0,cancelable:!0,...t})),p=(e,t={})=>i(e,new SubmitEvent(`submit`,{bubbles:!0,cancelable:!0,...t})),m=e=>e.reason??new DOMException(`The operation was aborted.`,`AbortError`),h=(e=0,{signal:t}={})=>new Promise((n,r)=>{if(t?.aborted){r(m(t));return}let i=setTimeout(a,e);function a(){t?.removeEventListener(`abort`,o),n()}function o(){clearTimeout(i),r(m(t))}t?.addEventListener(`abort`,o,{once:!0})});async function g(e,{interval:t=50,signal:n,timeout:i=1e3}={}){let a=Date.now()+i;for(;;){if(n?.aborted)throw m(n);if(await e())return;if(Date.now()>=a)break;await h(t,{signal:n})}throw new r(`waitUntil timed out after ${i}ms`)}async function _(e,{interval:t=50,message:n,signal:i,timeout:a=1e3}={}){let o=Date.now()+a,s;for(;;){if(i?.aborted)throw m(i);try{await e();return}catch(e){s=e}if(Date.now()>=o)break;await h(t,{signal:i})}let c=`retry timed out after ${a}ms`,l=n?`${n} (${c})`:c,u=s instanceof Error?s.message:s==null?``:String(s);throw new r(u?`${l}\n${u}`:l,{cause:s})}function v(e,t,{signal:n,timeout:i=1e3}={}){return new Promise((a,o)=>{if(n?.aborted){o(m(n));return}let s=()=>{clearTimeout(l),n?.removeEventListener(`abort`,u),e.removeEventListener(t,c)},c=e=>{s(),a(e)},l=setTimeout(()=>{s(),o(new r(`waitForEvent: "${t}" timed out after ${i}ms`))},i),u=()=>{s(),o(m(n))};e.addEventListener(t,c,{once:!0}),n?.addEventListener(`abort`,u,{once:!0})})}var y=()=>new Promise(e=>{queueMicrotask(e)}),b={alert:`assertive`,status:`polite`};function x(e){let t=e.getAttribute(`aria-live`);if(t)return t;let n=e.getAttribute(`role`);return n&&n in b?b[n]:null}function S(e={}){let t=e.document??(typeof document<`u`?document:null),n=e.politeness??`polite`,r=e.root??t?.body??null;if(!r)return null;let i=Array.from(r.querySelectorAll(`[aria-live], [role="status"], [role="alert"]`));for(let t of i)if(x(t)===n&&(e.role===void 0||t.getAttribute(`role`)===e.role))return t;return null}function C(e={}){let t=e.document??(typeof document<`u`?document:null),n=e.politeness??`polite`,r=e.root??t?.body??null;return r?Array.from(r.querySelectorAll(`[aria-live], [role="status"], [role="alert"]`)).filter(t=>!(x(t)!==n||e.role!==void 0&&t.getAttribute(`role`)!==e.role)):[]}async function w(e,t={}){let r=t.politeness??`polite`,i=null;return await _(()=>{let a=S({document:t.document,politeness:r,role:t.role,root:t.root});if(!a)throw new n(`No ${r} live region found.`);if(!a.textContent?.includes(e))throw new n(`Live region text "${a.textContent}" does not include "${e}".`);i=a},{interval:t.interval,message:`waitForLiveRegion("${e}")`,signal:t.signal,timeout:t.timeout}),i}async function T(e={}){let t=e.politeness??`polite`;await _(()=>{let r=S({document:e.document,politeness:t,role:e.role,root:e.root});if(!r)throw new n(`No ${t} live region found.`);if(r.textContent!==``)throw new n(`Live region not cleared: "${r.textContent}".`)},{interval:e.interval,message:`waitForLiveRegionCleared`,signal:e.signal,timeout:e.timeout})}var E=e=>e instanceof Element?e.outerHTML.slice(0,500):e instanceof ShadowRoot?`<shadow-root>${e.innerHTML.slice(0,500)}</shadow-root>`:e.nodeName,D=(e,t,r)=>{if(e)return e;throw new n(`Unable to find ${t} within ${E(r)}.`)},O=(e,t)=>e.querySelector(t),k=(e,t)=>Array.from(e.querySelectorAll(t)),A=(e,t)=>k(e,`[data-testid]`).find(e=>e.getAttribute(`data-testid`)===t)??null,j=(e,t)=>k(e,`[data-testid]`).filter(e=>e.getAttribute(`data-testid`)===t),M=(e,t,n=`*`)=>{for(let r of e.querySelectorAll(n))if(r.textContent?.trim()===t)return r;return null},N=(e,t,n=`*`)=>Array.from(e.querySelectorAll(n)).filter(e=>e.textContent?.trim()===t);function P(e,t){return e.shadowRoot?O(e.shadowRoot,t):null}function F(e,t){return e.shadowRoot?k(e.shadowRoot,t):[]}function I(e,t){return F(e,`[part]`).find(e=>e.getAttribute(`part`)?.split(/\s+/).includes(t))??null}function L(e,t){return Array.from(e.children).filter(e=>t===void 0?!e.getAttribute(`slot`):e.getAttribute(`slot`)===t)}function R(e){return{get:t=>D(O(e,t),`"${t}"`,e),getByTestId:t=>D(A(e,t),`data-testid "${t}"`,e),getByText:(t,n=`*`)=>D(M(e,t,n),`text "${t}" matching "${n}"`,e),query:t=>O(e,t),queryAll:t=>k(e,t),queryAllByTestId:t=>j(e,t),queryAllByText:(t,n=`*`)=>N(e,t,n),queryByTestId:t=>A(e,t),queryByText:(t,n=`*`)=>M(e,t,n)}}return e.AssayError=t,e.AssayQueryError=n,e.AssayTimeoutError=r,e.delay=h,e.dispatch=i,e.fireBlur=a,e.fireChange=o,e.fireClick=s,e.fireCustom=c,e.fireFocus=l,e.fireInput=u,e.fireKeyDown=d,e.fireKeyUp=f,e.fireSubmit=p,e.getSlotted=L,e.nextTick=y,e.queryAllInShadow=F,e.queryAllLiveRegions=C,e.queryInShadow=P,e.queryLiveRegion=S,e.queryPart=I,e.retry=_,e.waitForEvent=v,e.waitForLiveRegion=w,e.waitForLiveRegionCleared=T,e.waitUntil=g,e.within=R,e})({});
|
|
2
2
|
//# sourceMappingURL=assay.iife.js.map
|
package/dist/assay.iife.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"assay.iife.js","names":[],"sources":["../src/errors.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\n/** Thrown when a required query has no match. */\nexport class AssayQueryError extends AssayError {}\n\n/** Thrown by `waitUntil`/`retry`/`waitForEvent` when the timeout elapses. */\nexport class AssayTimeoutError extends AssayError {}\n","/** Synchronous, exact DOM event dispatchers for test environments. */\n\n/** Dispatch an event instance without modifying it. */\nexport const dispatch = (target: EventTarget, event: Event): boolean => target.dispatchEvent(event);\n\nexport const fireBlur = (target: EventTarget, init: FocusEventInit = {}): boolean =>\n dispatch(target, new FocusEvent('blur', init));\n\nexport const fireChange = (target: EventTarget, init: EventInit = {}): boolean =>\n dispatch(target, new Event('change', { bubbles: true, ...init }));\n\nexport const fireClick = (target: EventTarget, init: MouseEventInit = {}): boolean =>\n dispatch(target, new MouseEvent('click', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireCustom = <T>(target: EventTarget, type: string, init: CustomEventInit<T> = {}): boolean =>\n dispatch(target, new CustomEvent(type, { bubbles: true, cancelable: true, composed: false, ...init }));\n\nexport const fireFocus = (target: EventTarget, init: FocusEventInit = {}): boolean =>\n dispatch(target, new FocusEvent('focus', init));\n\nexport const fireInput = (target: EventTarget, init: InputEventInit = {}): boolean =>\n dispatch(target, new InputEvent('input', { bubbles: true, ...init }));\n\nexport const fireKeyDown = (target: EventTarget, init: KeyboardEventInit = {}): boolean =>\n dispatch(target, new KeyboardEvent('keydown', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireKeyUp = (target: EventTarget, init: KeyboardEventInit = {}): boolean =>\n dispatch(target, new KeyboardEvent('keyup', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireSubmit = (target: EventTarget, init: SubmitEventInit = {}): boolean =>\n dispatch(target, new SubmitEvent('submit', { bubbles: true, cancelable: true, ...init }));\n","import { AssayQueryError } from './errors';\n\n/** DOM query helpers for test environments. */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Scoped query helpers for any queryable DOM root — see {@link within}. */\nexport interface QueryScope {\n get<E extends Element = Element>(selector: string): E;\n getByTestId<E extends Element = Element>(testId: string): E;\n getByText<E extends Element = Element>(text: string, selector?: string): E;\n query<E extends Element = Element>(selector: string): E | null;\n queryAll<E extends Element = Element>(selector: string): E[];\n queryAllByTestId<E extends Element = Element>(testId: string): E[];\n queryAllByText<E extends Element = Element>(text: string, selector?: string): E[];\n queryByTestId<E extends Element = Element>(testId: string): E | null;\n queryByText<E extends Element = Element>(text: string, selector?: string): E | null;\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\ntype QueryRoot = ParentNode;\n\nconst describeRoot = (root: QueryRoot): string => {\n if (root instanceof Element) return root.outerHTML.slice(0, 500);\n\n if (root instanceof ShadowRoot) return `<shadow-root>${root.innerHTML.slice(0, 500)}</shadow-root>`;\n\n return root.nodeName;\n};\n\nconst requireMatch = <E extends Element>(element: E | null, description: string, root: QueryRoot): E => {\n if (element) return element;\n\n throw new AssayQueryError(`Unable to find ${description} within ${describeRoot(root)}.`);\n};\n\nconst query = <E extends Element = Element>(root: QueryRoot, selector: string): E | null =>\n root.querySelector<E>(selector);\n\nconst queryAll = <E extends Element = Element>(root: QueryRoot, selector: string): E[] => {\n return Array.from(root.querySelectorAll<E>(selector));\n};\n\nconst queryByTestId = <E extends Element = Element>(root: QueryRoot, testId: string): E | null =>\n queryAll<E>(root, '[data-testid]').find((element) => element.getAttribute('data-testid') === testId) ?? null;\n\nconst queryAllByTestId = <E extends Element = Element>(root: QueryRoot, testId: string): E[] =>\n queryAll<E>(root, '[data-testid]').filter((element) => element.getAttribute('data-testid') === testId);\n\nconst queryByText = <E extends Element = Element>(root: QueryRoot, text: string, selector = '*'): 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\nconst queryAllByText = <E extends Element = Element>(root: QueryRoot, text: string, selector = '*'): 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 ? query<E>(host.shadowRoot, 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 host.shadowRoot ? queryAll<E>(host.shadowRoot, 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 (\n queryAllInShadow<E>(host, '[part]').find((element) => element.getAttribute('part')?.split(/\\s+/).includes(part)) ??\n null\n );\n}\n\n/**\n * Returns the light-DOM children assigned to a named slot, or every child assigned to the\n * default slot 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 return Array.from(host.children).filter((element) =>\n slotName === undefined ? !element.getAttribute('slot') : element.getAttribute('slot') === slotName,\n ) as E[];\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Create query helpers scoped to a DOM root — useful for light DOM and shadow roots.\n *\n * @example\n * const view = within(fixture.shadow!);\n * expect(view.get('.title').textContent).toBe('Hello');\n */\nexport function within(root: QueryRoot): QueryScope {\n return {\n get: <E extends Element = Element>(selector: string) =>\n requireMatch(query<E>(root, selector), `\"${selector}\"`, root),\n getByTestId: <E extends Element = Element>(testId: string) =>\n requireMatch(queryByTestId<E>(root, testId), `data-testid \"${testId}\"`, root),\n getByText: <E extends Element = Element>(text: string, selector = '*') =>\n requireMatch(queryByText<E>(root, text, selector), `text \"${text}\" matching \"${selector}\"`, root),\n query: <E extends Element = Element>(selector: string) => query<E>(root, selector),\n queryAll: <E extends Element = Element>(selector: string) => queryAll<E>(root, selector),\n queryAllByTestId: <E extends Element = Element>(testId: string) => queryAllByTestId<E>(root, testId),\n queryAllByText: <E extends Element = Element>(text: string, selector = '*') =>\n queryAllByText<E>(root, text, selector),\n queryByTestId: <E extends Element = Element>(testId: string) => queryByTestId<E>(root, testId),\n queryByText: <E extends Element = Element>(text: string, selector = '*') => queryByText<E>(root, text, selector),\n };\n}\n","import { AssayTimeoutError } from './errors';\n\nexport interface WaitOptions {\n /** Polling interval in ms (default: 50). */\n interval?: number;\n /** Cancel the pending wait. */\n signal?: AbortSignal;\n /** Maximum wait time in ms (default: 1000). */\n timeout?: number;\n}\n\nexport interface RetryOptions extends WaitOptions {\n /** Context included in the timeout error. */\n message?: string;\n}\n\nexport interface DelayOptions {\n /** Cancel the pending delay. */\n signal?: AbortSignal;\n}\n\nconst abortReason = (signal: AbortSignal): unknown =>\n signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\n\n/**\n * Resolve after `ms` milliseconds. Rejects with the abort reason when cancelled.\n */\nexport const delay = (ms = 0, { signal }: DelayOptions = {}): Promise<void> =>\n new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(abortReason(signal));\n\n return;\n }\n\n const timer = setTimeout(done, ms);\n\n function done(): void {\n signal?.removeEventListener('abort', abort);\n resolve();\n }\n\n function abort(): void {\n clearTimeout(timer);\n reject(abortReason(signal!));\n }\n\n signal?.addEventListener('abort', abort, { once: true });\n });\n\n/** Poll until a synchronous or asynchronous predicate returns `true`. */\nexport async function waitUntil(\n predicate: () => boolean | Promise<boolean>,\n { interval = 50, signal, timeout = 1000 }: WaitOptions = {},\n): Promise<void> {\n const deadline = Date.now() + timeout;\n\n for (;;) {\n if (signal?.aborted) throw abortReason(signal);\n\n if (await predicate()) return;\n\n if (Date.now() >= deadline) break;\n\n await delay(interval, { signal });\n }\n\n throw new AssayTimeoutError(`waitUntil timed out after ${timeout}ms`);\n}\n\n/** Retry an assertion until it stops throwing. */\nexport async function retry(\n assertion: () => void | Promise<void>,\n { interval = 50, message, signal, timeout = 1000 }: RetryOptions = {},\n): Promise<void> {\n const deadline = Date.now() + timeout;\n let lastError: unknown;\n\n for (;;) {\n if (signal?.aborted) throw abortReason(signal);\n\n try {\n await assertion();\n\n return;\n } catch (error) {\n lastError = error;\n }\n\n if (Date.now() >= deadline) break;\n\n await delay(interval, { signal });\n }\n\n const timing = `retry timed out after ${timeout}ms`;\n const context = message ? `${message} (${timing})` : timing;\n const detail = lastError instanceof Error ? lastError.message : lastError == null ? '' : String(lastError);\n\n throw new AssayTimeoutError(detail ? `${context}\\n${detail}` : context, { cause: lastError });\n}\n\n/** Resolve with the next event of `type`, or reject when it times out or is aborted. */\nexport function waitForEvent<T extends Event = Event>(\n target: EventTarget,\n type: string,\n { signal, timeout = 1000 }: Omit<WaitOptions, 'interval'> = {},\n): Promise<T> {\n return new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(abortReason(signal));\n\n return;\n }\n\n const dispose = () => {\n clearTimeout(timer);\n signal?.removeEventListener('abort', onAbort);\n target.removeEventListener(type, onEvent);\n };\n const onEvent = (e: Event): void => {\n dispose();\n resolve(e as T);\n };\n const timer = setTimeout(() => {\n dispose();\n reject(new AssayTimeoutError(`waitForEvent: \"${type}\" timed out after ${timeout}ms`));\n }, timeout);\n const onAbort = () => {\n dispose();\n reject(abortReason(signal!));\n };\n\n target.addEventListener(type, onEvent, { once: true });\n signal?.addEventListener('abort', onAbort, { once: true });\n });\n}\n\n/** Resolve after one microtask tick. */\nexport const nextTick = (): Promise<void> =>\n new Promise((resolve) => {\n queueMicrotask(resolve);\n });\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"assay.iife.js","names":[],"sources":["../src/errors.ts","../src/events.ts","../src/wait.ts","../src/live-region.ts","../src/query.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\n/** Thrown when a required query has no match. */\nexport class AssayQueryError extends AssayError {}\n\n/** Thrown by `waitUntil`/`retry`/`waitForEvent` when the timeout elapses. */\nexport class AssayTimeoutError extends AssayError {}\n","/** Synchronous, exact DOM event dispatchers for test environments. */\n\n/** Dispatch an event instance without modifying it. */\nexport const dispatch = (target: EventTarget, event: Event): boolean => target.dispatchEvent(event);\n\nexport const fireBlur = (target: EventTarget, init: FocusEventInit = {}): boolean =>\n dispatch(target, new FocusEvent('blur', init));\n\nexport const fireChange = (target: EventTarget, init: EventInit = {}): boolean =>\n dispatch(target, new Event('change', { bubbles: true, ...init }));\n\nexport const fireClick = (target: EventTarget, init: MouseEventInit = {}): boolean =>\n dispatch(target, new MouseEvent('click', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireCustom = <T>(target: EventTarget, type: string, init: CustomEventInit<T> = {}): boolean =>\n dispatch(target, new CustomEvent(type, { bubbles: true, cancelable: true, composed: false, ...init }));\n\nexport const fireFocus = (target: EventTarget, init: FocusEventInit = {}): boolean =>\n dispatch(target, new FocusEvent('focus', init));\n\nexport const fireInput = (target: EventTarget, init: InputEventInit = {}): boolean =>\n dispatch(target, new InputEvent('input', { bubbles: true, ...init }));\n\nexport const fireKeyDown = (target: EventTarget, init: KeyboardEventInit = {}): boolean =>\n dispatch(target, new KeyboardEvent('keydown', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireKeyUp = (target: EventTarget, init: KeyboardEventInit = {}): boolean =>\n dispatch(target, new KeyboardEvent('keyup', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireSubmit = (target: EventTarget, init: SubmitEventInit = {}): boolean =>\n dispatch(target, new SubmitEvent('submit', { bubbles: true, cancelable: true, ...init }));\n","import { AssayTimeoutError } from './errors';\n\nexport interface WaitOptions {\n /** Polling interval in ms (default: 50). */\n interval?: number;\n /** Cancel the pending wait. */\n signal?: AbortSignal;\n /** Maximum wait time in ms (default: 1000). */\n timeout?: number;\n}\n\nexport interface RetryOptions extends WaitOptions {\n /** Context included in the timeout error. */\n message?: string;\n}\n\nexport interface DelayOptions {\n /** Cancel the pending delay. */\n signal?: AbortSignal;\n}\n\nconst abortReason = (signal: AbortSignal): unknown =>\n signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\n\n/**\n * Resolve after `ms` milliseconds. Rejects with the abort reason when cancelled.\n */\nexport const delay = (ms = 0, { signal }: DelayOptions = {}): Promise<void> =>\n new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(abortReason(signal));\n\n return;\n }\n\n const timer = setTimeout(done, ms);\n\n function done(): void {\n signal?.removeEventListener('abort', abort);\n resolve();\n }\n\n function abort(): void {\n clearTimeout(timer);\n reject(abortReason(signal!));\n }\n\n signal?.addEventListener('abort', abort, { once: true });\n });\n\n/** Poll until a synchronous or asynchronous predicate returns `true`. */\nexport async function waitUntil(\n predicate: () => boolean | Promise<boolean>,\n { interval = 50, signal, timeout = 1000 }: WaitOptions = {},\n): Promise<void> {\n const deadline = Date.now() + timeout;\n\n for (;;) {\n if (signal?.aborted) throw abortReason(signal);\n\n if (await predicate()) return;\n\n if (Date.now() >= deadline) break;\n\n await delay(interval, { signal });\n }\n\n throw new AssayTimeoutError(`waitUntil timed out after ${timeout}ms`);\n}\n\n/** Retry an assertion until it stops throwing. */\nexport async function retry(\n assertion: () => void | Promise<void>,\n { interval = 50, message, signal, timeout = 1000 }: RetryOptions = {},\n): Promise<void> {\n const deadline = Date.now() + timeout;\n let lastError: unknown;\n\n for (;;) {\n if (signal?.aborted) throw abortReason(signal);\n\n try {\n await assertion();\n\n return;\n } catch (error) {\n lastError = error;\n }\n\n if (Date.now() >= deadline) break;\n\n await delay(interval, { signal });\n }\n\n const timing = `retry timed out after ${timeout}ms`;\n const context = message ? `${message} (${timing})` : timing;\n const detail = lastError instanceof Error ? lastError.message : lastError == null ? '' : String(lastError);\n\n throw new AssayTimeoutError(detail ? `${context}\\n${detail}` : context, { cause: lastError });\n}\n\n/** Resolve with the next event of `type`, or reject when it times out or is aborted. */\nexport function waitForEvent<T extends Event = Event>(\n target: EventTarget,\n type: string,\n { signal, timeout = 1000 }: Omit<WaitOptions, 'interval'> = {},\n): Promise<T> {\n return new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(abortReason(signal));\n\n return;\n }\n\n const dispose = () => {\n clearTimeout(timer);\n signal?.removeEventListener('abort', onAbort);\n target.removeEventListener(type, onEvent);\n };\n const onEvent = (e: Event): void => {\n dispose();\n resolve(e as T);\n };\n const timer = setTimeout(() => {\n dispose();\n reject(new AssayTimeoutError(`waitForEvent: \"${type}\" timed out after ${timeout}ms`));\n }, timeout);\n const onAbort = () => {\n dispose();\n reject(abortReason(signal!));\n };\n\n target.addEventListener(type, onEvent, { once: true });\n signal?.addEventListener('abort', onAbort, { once: true });\n });\n}\n\n/** Resolve after one microtask tick. */\nexport const nextTick = (): Promise<void> =>\n new Promise((resolve) => {\n queueMicrotask(resolve);\n });\n","import { AssayQueryError } from './errors';\nimport { retry, type WaitOptions } from './wait';\n\n/** Politeness levels for ARIA live regions. */\nexport type LiveRegionPoliteness = 'assertive' | 'off' | 'polite';\n\n/**\n * ARIA roles that carry an implicit `aria-live` value per the WAI-ARIA spec.\n * `role=\"status\"` → `polite`, `role=\"alert\"` → `assertive`. Elements with these\n * roles are live regions even without an explicit `aria-live` attribute.\n */\nconst IMPLICIT_ROLE_POLITENESS: Record<string, LiveRegionPoliteness> = {\n alert: 'assertive',\n status: 'polite',\n};\n\nexport interface LiveRegionQueryOptions {\n /** The document to search. Defaults to the global `document`. */\n document?: Document;\n /** Politeness to match via `aria-live` (or implicit role). Defaults to `'polite'`. */\n politeness?: LiveRegionPoliteness;\n /** ARIA role to match (e.g. `'status'`, `'alert'`). Omit to match any role. */\n role?: string;\n /** Root to scope the query. Defaults to `document.body`. */\n root?: ParentNode;\n}\n\n/**\n * Resolves the effective politeness of an element: explicit `aria-live` wins,\n * otherwise falls back to the implicit value from `role=\"status\"`/`role=\"alert\"`.\n * Returns `null` when the element is not a live region.\n */\nfunction resolvePoliteness(el: HTMLElement): LiveRegionPoliteness | null {\n const explicit = el.getAttribute('aria-live');\n\n if (explicit) return explicit as LiveRegionPoliteness;\n\n const role = el.getAttribute('role');\n\n if (role && role in IMPLICIT_ROLE_POLITENESS) return IMPLICIT_ROLE_POLITENESS[role];\n\n return null;\n}\n\n/**\n * Queries the first live region matching the given politeness (and optional role)\n * within `root`. Returns `null` when none exists — safe to call before the region\n * has been lazily created.\n *\n * Matches both explicit `aria-live` attributes and implicit roles (`status` →\n * polite, `alert` → assertive) per the WAI-ARIA spec.\n *\n * @example\n * const region = queryLiveRegion({ politeness: 'polite' });\n * expect(region).not.toBeNull();\n */\nexport function queryLiveRegion(options: LiveRegionQueryOptions = {}): HTMLElement | null {\n const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n const politeness = options.politeness ?? 'polite';\n const root = options.root ?? doc?.body ?? null;\n\n if (!root) return null;\n\n const candidates = Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]'));\n\n for (const el of candidates) {\n if (resolvePoliteness(el) !== politeness) continue;\n\n if (options.role !== undefined && el.getAttribute('role') !== options.role) continue;\n\n return el;\n }\n\n return null;\n}\n\n/**\n * Queries all live regions matching the given politeness (and optional role)\n * within `root`. Useful for asserting no duplicate regions were created.\n *\n * @example\n * expect(queryAllLiveRegions({ politeness: 'polite' })).toHaveLength(1);\n */\nexport function queryAllLiveRegions(options: LiveRegionQueryOptions = {}): HTMLElement[] {\n const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n const politeness = options.politeness ?? 'polite';\n const root = options.root ?? doc?.body ?? null;\n\n if (!root) return [];\n\n return Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]')).filter((el) => {\n if (resolvePoliteness(el) !== politeness) return false;\n\n if (options.role !== undefined && el.getAttribute('role') !== options.role) return false;\n\n return true;\n });\n}\n\nexport interface WaitForLiveRegionOptions extends WaitOptions {\n /** The document to search. Defaults to the global `document`. */\n document?: Document;\n /** Politeness to match via `aria-live`. Defaults to `'polite'`. */\n politeness?: LiveRegionPoliteness;\n /** ARIA role to match. Omit to match any role. */\n role?: string;\n /** Root to scope the query. Defaults to `document.body`. */\n root?: ParentNode;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and contains\n * `text` (substring match). Throws `AssayTimeoutError` on timeout.\n *\n * Handles the clear-then-set announce pattern: the region may briefly be empty\n * before the message is written, so polling until the text appears is the\n * correct approach rather than a single snapshot assertion.\n *\n * @example\n * await waitForLiveRegion({ text: '3 results found' });\n * await waitForLiveRegion({ politeness: 'assertive', text: 'Session expired' });\n */\nexport async function waitForLiveRegion(text: string, options: WaitForLiveRegionOptions = {}): Promise<HTMLElement> {\n const politeness = options.politeness ?? 'polite';\n let matched: HTMLElement | null = null;\n\n await retry(\n () => {\n const region = queryLiveRegion({\n document: options.document,\n politeness,\n role: options.role,\n root: options.root,\n });\n\n if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n if (!region.textContent?.includes(text)) {\n throw new AssayQueryError(`Live region text \"${region.textContent}\" does not include \"${text}\".`);\n }\n\n matched = region;\n },\n {\n interval: options.interval,\n message: `waitForLiveRegion(\"${text}\")`,\n signal: options.signal,\n timeout: options.timeout,\n },\n );\n\n // `retry` only resolves once the assertion stops throwing, so `matched` is set.\n return matched!;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and is empty\n * (cleared). Throws `AssayTimeoutError` on timeout.\n *\n * @example\n * await waitForLiveRegionCleared();\n */\nexport async function waitForLiveRegionCleared(options: WaitForLiveRegionOptions = {}): Promise<void> {\n const politeness = options.politeness ?? 'polite';\n\n await retry(\n () => {\n const region = queryLiveRegion({\n document: options.document,\n politeness,\n role: options.role,\n root: options.root,\n });\n\n if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n if (region.textContent !== '') {\n throw new AssayQueryError(`Live region not cleared: \"${region.textContent}\".`);\n }\n },\n {\n interval: options.interval,\n message: 'waitForLiveRegionCleared',\n signal: options.signal,\n timeout: options.timeout,\n },\n );\n}\n","import { AssayQueryError } from './errors';\n\n/** DOM query helpers for test environments. */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Scoped query helpers for any queryable DOM root — see {@link within}. */\nexport interface QueryScope {\n get<E extends Element = Element>(selector: string): E;\n getByTestId<E extends Element = Element>(testId: string): E;\n getByText<E extends Element = Element>(text: string, selector?: string): E;\n query<E extends Element = Element>(selector: string): E | null;\n queryAll<E extends Element = Element>(selector: string): E[];\n queryAllByTestId<E extends Element = Element>(testId: string): E[];\n queryAllByText<E extends Element = Element>(text: string, selector?: string): E[];\n queryByTestId<E extends Element = Element>(testId: string): E | null;\n queryByText<E extends Element = Element>(text: string, selector?: string): E | null;\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\ntype QueryRoot = ParentNode;\n\nconst describeRoot = (root: QueryRoot): string => {\n if (root instanceof Element) return root.outerHTML.slice(0, 500);\n\n if (root instanceof ShadowRoot) return `<shadow-root>${root.innerHTML.slice(0, 500)}</shadow-root>`;\n\n return root.nodeName;\n};\n\nconst requireMatch = <E extends Element>(element: E | null, description: string, root: QueryRoot): E => {\n if (element) return element;\n\n throw new AssayQueryError(`Unable to find ${description} within ${describeRoot(root)}.`);\n};\n\nconst query = <E extends Element = Element>(root: QueryRoot, selector: string): E | null =>\n root.querySelector<E>(selector);\n\nconst queryAll = <E extends Element = Element>(root: QueryRoot, selector: string): E[] => {\n return Array.from(root.querySelectorAll<E>(selector));\n};\n\nconst queryByTestId = <E extends Element = Element>(root: QueryRoot, testId: string): E | null =>\n queryAll<E>(root, '[data-testid]').find((element) => element.getAttribute('data-testid') === testId) ?? null;\n\nconst queryAllByTestId = <E extends Element = Element>(root: QueryRoot, testId: string): E[] =>\n queryAll<E>(root, '[data-testid]').filter((element) => element.getAttribute('data-testid') === testId);\n\nconst queryByText = <E extends Element = Element>(root: QueryRoot, text: string, selector = '*'): 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\nconst queryAllByText = <E extends Element = Element>(root: QueryRoot, text: string, selector = '*'): 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 ? query<E>(host.shadowRoot, 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 host.shadowRoot ? queryAll<E>(host.shadowRoot, 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 (\n queryAllInShadow<E>(host, '[part]').find((element) => element.getAttribute('part')?.split(/\\s+/).includes(part)) ??\n null\n );\n}\n\n/**\n * Returns the light-DOM children assigned to a named slot, or every child assigned to the\n * default slot 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 return Array.from(host.children).filter((element) =>\n slotName === undefined ? !element.getAttribute('slot') : element.getAttribute('slot') === slotName,\n ) as E[];\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Create query helpers scoped to a DOM root — useful for light DOM and shadow roots.\n *\n * @example\n * const view = within(fixture.shadow!);\n * expect(view.get('.title').textContent).toBe('Hello');\n */\nexport function within(root: QueryRoot): QueryScope {\n return {\n get: <E extends Element = Element>(selector: string) =>\n requireMatch(query<E>(root, selector), `\"${selector}\"`, root),\n getByTestId: <E extends Element = Element>(testId: string) =>\n requireMatch(queryByTestId<E>(root, testId), `data-testid \"${testId}\"`, root),\n getByText: <E extends Element = Element>(text: string, selector = '*') =>\n requireMatch(queryByText<E>(root, text, selector), `text \"${text}\" matching \"${selector}\"`, root),\n query: <E extends Element = Element>(selector: string) => query<E>(root, selector),\n queryAll: <E extends Element = Element>(selector: string) => queryAll<E>(root, selector),\n queryAllByTestId: <E extends Element = Element>(testId: string) => queryAllByTestId<E>(root, testId),\n queryAllByText: <E extends Element = Element>(text: string, selector = '*') =>\n queryAllByText<E>(root, text, selector),\n queryByTestId: <E extends Element = Element>(testId: string) => queryByTestId<E>(root, testId),\n queryByText: <E extends Element = Element>(text: string, selector = '*') => queryByText<E>(root, text, selector),\n };\n}\n"],"mappings":"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"}
|
package/dist/assay.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
var e=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{},n=class extends e{},r=(e,t)=>e.dispatchEvent(t),i=(e,t={})=>r(e,new FocusEvent(`blur`,t)),a=(e,t={})=>r(e,new Event(`change`,{bubbles:!0,...t})),o=(e,t={})=>r(e,new MouseEvent(`click`,{bubbles:!0,cancelable:!0,...t})),s=(e,t,n={})=>r(e,new CustomEvent(t,{bubbles:!0,cancelable:!0,composed:!1,...n})),c=(e,t={})=>r(e,new FocusEvent(`focus`,t)),l=(e,t={})=>r(e,new InputEvent(`input`,{bubbles:!0,...t})),u=(e,t={})=>r(e,new KeyboardEvent(`keydown`,{bubbles:!0,cancelable:!0,...t})),d=(e,t={})=>r(e,new KeyboardEvent(`keyup`,{bubbles:!0,cancelable:!0,...t})),f=(e,t={})=>r(e,new SubmitEvent(`submit`,{bubbles:!0,cancelable:!0,...t})),p=e=>e
|
|
1
|
+
var e=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{},n=class extends e{},r=(e,t)=>e.dispatchEvent(t),i=(e,t={})=>r(e,new FocusEvent(`blur`,t)),a=(e,t={})=>r(e,new Event(`change`,{bubbles:!0,...t})),o=(e,t={})=>r(e,new MouseEvent(`click`,{bubbles:!0,cancelable:!0,...t})),s=(e,t,n={})=>r(e,new CustomEvent(t,{bubbles:!0,cancelable:!0,composed:!1,...n})),c=(e,t={})=>r(e,new FocusEvent(`focus`,t)),l=(e,t={})=>r(e,new InputEvent(`input`,{bubbles:!0,...t})),u=(e,t={})=>r(e,new KeyboardEvent(`keydown`,{bubbles:!0,cancelable:!0,...t})),d=(e,t={})=>r(e,new KeyboardEvent(`keyup`,{bubbles:!0,cancelable:!0,...t})),f=(e,t={})=>r(e,new SubmitEvent(`submit`,{bubbles:!0,cancelable:!0,...t})),p=e=>e.reason??new DOMException(`The operation was aborted.`,`AbortError`),m=(e=0,{signal:t}={})=>new Promise((n,r)=>{if(t?.aborted){r(p(t));return}let i=setTimeout(a,e);function a(){t?.removeEventListener(`abort`,o),n()}function o(){clearTimeout(i),r(p(t))}t?.addEventListener(`abort`,o,{once:!0})});async function h(e,{interval:t=50,signal:r,timeout:i=1e3}={}){let a=Date.now()+i;for(;;){if(r?.aborted)throw p(r);if(await e())return;if(Date.now()>=a)break;await m(t,{signal:r})}throw new n(`waitUntil timed out after ${i}ms`)}async function g(e,{interval:t=50,message:r,signal:i,timeout:a=1e3}={}){let o=Date.now()+a,s;for(;;){if(i?.aborted)throw p(i);try{await e();return}catch(e){s=e}if(Date.now()>=o)break;await m(t,{signal:i})}let c=`retry timed out after ${a}ms`,l=r?`${r} (${c})`:c,u=s instanceof Error?s.message:s==null?``:String(s);throw new n(u?`${l}\n${u}`:l,{cause:s})}function _(e,t,{signal:r,timeout:i=1e3}={}){return new Promise((a,o)=>{if(r?.aborted){o(p(r));return}let s=()=>{clearTimeout(l),r?.removeEventListener(`abort`,u),e.removeEventListener(t,c)},c=e=>{s(),a(e)},l=setTimeout(()=>{s(),o(new n(`waitForEvent: "${t}" timed out after ${i}ms`))},i),u=()=>{s(),o(p(r))};e.addEventListener(t,c,{once:!0}),r?.addEventListener(`abort`,u,{once:!0})})}var v=()=>new Promise(e=>{queueMicrotask(e)}),y={alert:`assertive`,status:`polite`};function b(e){let t=e.getAttribute(`aria-live`);if(t)return t;let n=e.getAttribute(`role`);return n&&n in y?y[n]:null}function x(e={}){let t=e.document??(typeof document<`u`?document:null),n=e.politeness??`polite`,r=e.root??t?.body??null;if(!r)return null;let i=Array.from(r.querySelectorAll(`[aria-live], [role="status"], [role="alert"]`));for(let t of i)if(b(t)===n&&(e.role===void 0||t.getAttribute(`role`)===e.role))return t;return null}function S(e={}){let t=e.document??(typeof document<`u`?document:null),n=e.politeness??`polite`,r=e.root??t?.body??null;return r?Array.from(r.querySelectorAll(`[aria-live], [role="status"], [role="alert"]`)).filter(t=>!(b(t)!==n||e.role!==void 0&&t.getAttribute(`role`)!==e.role)):[]}async function C(e,n={}){let r=n.politeness??`polite`,i=null;return await g(()=>{let a=x({document:n.document,politeness:r,role:n.role,root:n.root});if(!a)throw new t(`No ${r} live region found.`);if(!a.textContent?.includes(e))throw new t(`Live region text "${a.textContent}" does not include "${e}".`);i=a},{interval:n.interval,message:`waitForLiveRegion("${e}")`,signal:n.signal,timeout:n.timeout}),i}async function w(e={}){let n=e.politeness??`polite`;await g(()=>{let r=x({document:e.document,politeness:n,role:e.role,root:e.root});if(!r)throw new t(`No ${n} live region found.`);if(r.textContent!==``)throw new t(`Live region not cleared: "${r.textContent}".`)},{interval:e.interval,message:`waitForLiveRegionCleared`,signal:e.signal,timeout:e.timeout})}var T=e=>e instanceof Element?e.outerHTML.slice(0,500):e instanceof ShadowRoot?`<shadow-root>${e.innerHTML.slice(0,500)}</shadow-root>`:e.nodeName,E=(e,n,r)=>{if(e)return e;throw new t(`Unable to find ${n} within ${T(r)}.`)},D=(e,t)=>e.querySelector(t),O=(e,t)=>Array.from(e.querySelectorAll(t)),k=(e,t)=>O(e,`[data-testid]`).find(e=>e.getAttribute(`data-testid`)===t)??null,A=(e,t)=>O(e,`[data-testid]`).filter(e=>e.getAttribute(`data-testid`)===t),j=(e,t,n=`*`)=>{for(let r of e.querySelectorAll(n))if(r.textContent?.trim()===t)return r;return null},M=(e,t,n=`*`)=>Array.from(e.querySelectorAll(n)).filter(e=>e.textContent?.trim()===t);function N(e,t){return e.shadowRoot?D(e.shadowRoot,t):null}function P(e,t){return e.shadowRoot?O(e.shadowRoot,t):[]}function F(e,t){return P(e,`[part]`).find(e=>e.getAttribute(`part`)?.split(/\s+/).includes(t))??null}function I(e,t){return Array.from(e.children).filter(e=>t===void 0?!e.getAttribute(`slot`):e.getAttribute(`slot`)===t)}function L(e){return{get:t=>E(D(e,t),`"${t}"`,e),getByTestId:t=>E(k(e,t),`data-testid "${t}"`,e),getByText:(t,n=`*`)=>E(j(e,t,n),`text "${t}" matching "${n}"`,e),query:t=>D(e,t),queryAll:t=>O(e,t),queryAllByTestId:t=>A(e,t),queryAllByText:(t,n=`*`)=>M(e,t,n),queryByTestId:t=>k(e,t),queryByText:(t,n=`*`)=>j(e,t,n)}}export{e as AssayError,t as AssayQueryError,n as AssayTimeoutError,m as delay,r as dispatch,i as fireBlur,a as fireChange,o as fireClick,s as fireCustom,c as fireFocus,l as fireInput,u as fireKeyDown,d as fireKeyUp,f as fireSubmit,I as getSlotted,v as nextTick,P as queryAllInShadow,S as queryAllLiveRegions,N as queryInShadow,x as queryLiveRegion,F as queryPart,g as retry,_ as waitForEvent,C as waitForLiveRegion,w as waitForLiveRegionCleared,h as waitUntil,L as within};
|
|
2
2
|
//# sourceMappingURL=assay.js.map
|
package/dist/assay.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"assay.js","names":[],"sources":["../src/errors.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\n/** Thrown when a required query has no match. */\nexport class AssayQueryError extends AssayError {}\n\n/** Thrown by `waitUntil`/`retry`/`waitForEvent` when the timeout elapses. */\nexport class AssayTimeoutError extends AssayError {}\n","/** Synchronous, exact DOM event dispatchers for test environments. */\n\n/** Dispatch an event instance without modifying it. */\nexport const dispatch = (target: EventTarget, event: Event): boolean => target.dispatchEvent(event);\n\nexport const fireBlur = (target: EventTarget, init: FocusEventInit = {}): boolean =>\n dispatch(target, new FocusEvent('blur', init));\n\nexport const fireChange = (target: EventTarget, init: EventInit = {}): boolean =>\n dispatch(target, new Event('change', { bubbles: true, ...init }));\n\nexport const fireClick = (target: EventTarget, init: MouseEventInit = {}): boolean =>\n dispatch(target, new MouseEvent('click', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireCustom = <T>(target: EventTarget, type: string, init: CustomEventInit<T> = {}): boolean =>\n dispatch(target, new CustomEvent(type, { bubbles: true, cancelable: true, composed: false, ...init }));\n\nexport const fireFocus = (target: EventTarget, init: FocusEventInit = {}): boolean =>\n dispatch(target, new FocusEvent('focus', init));\n\nexport const fireInput = (target: EventTarget, init: InputEventInit = {}): boolean =>\n dispatch(target, new InputEvent('input', { bubbles: true, ...init }));\n\nexport const fireKeyDown = (target: EventTarget, init: KeyboardEventInit = {}): boolean =>\n dispatch(target, new KeyboardEvent('keydown', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireKeyUp = (target: EventTarget, init: KeyboardEventInit = {}): boolean =>\n dispatch(target, new KeyboardEvent('keyup', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireSubmit = (target: EventTarget, init: SubmitEventInit = {}): boolean =>\n dispatch(target, new SubmitEvent('submit', { bubbles: true, cancelable: true, ...init }));\n","import { AssayQueryError } from './errors';\n\n/** DOM query helpers for test environments. */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Scoped query helpers for any queryable DOM root — see {@link within}. */\nexport interface QueryScope {\n get<E extends Element = Element>(selector: string): E;\n getByTestId<E extends Element = Element>(testId: string): E;\n getByText<E extends Element = Element>(text: string, selector?: string): E;\n query<E extends Element = Element>(selector: string): E | null;\n queryAll<E extends Element = Element>(selector: string): E[];\n queryAllByTestId<E extends Element = Element>(testId: string): E[];\n queryAllByText<E extends Element = Element>(text: string, selector?: string): E[];\n queryByTestId<E extends Element = Element>(testId: string): E | null;\n queryByText<E extends Element = Element>(text: string, selector?: string): E | null;\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\ntype QueryRoot = ParentNode;\n\nconst describeRoot = (root: QueryRoot): string => {\n if (root instanceof Element) return root.outerHTML.slice(0, 500);\n\n if (root instanceof ShadowRoot) return `<shadow-root>${root.innerHTML.slice(0, 500)}</shadow-root>`;\n\n return root.nodeName;\n};\n\nconst requireMatch = <E extends Element>(element: E | null, description: string, root: QueryRoot): E => {\n if (element) return element;\n\n throw new AssayQueryError(`Unable to find ${description} within ${describeRoot(root)}.`);\n};\n\nconst query = <E extends Element = Element>(root: QueryRoot, selector: string): E | null =>\n root.querySelector<E>(selector);\n\nconst queryAll = <E extends Element = Element>(root: QueryRoot, selector: string): E[] => {\n return Array.from(root.querySelectorAll<E>(selector));\n};\n\nconst queryByTestId = <E extends Element = Element>(root: QueryRoot, testId: string): E | null =>\n queryAll<E>(root, '[data-testid]').find((element) => element.getAttribute('data-testid') === testId) ?? null;\n\nconst queryAllByTestId = <E extends Element = Element>(root: QueryRoot, testId: string): E[] =>\n queryAll<E>(root, '[data-testid]').filter((element) => element.getAttribute('data-testid') === testId);\n\nconst queryByText = <E extends Element = Element>(root: QueryRoot, text: string, selector = '*'): 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\nconst queryAllByText = <E extends Element = Element>(root: QueryRoot, text: string, selector = '*'): 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 ? query<E>(host.shadowRoot, 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 host.shadowRoot ? queryAll<E>(host.shadowRoot, 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 (\n queryAllInShadow<E>(host, '[part]').find((element) => element.getAttribute('part')?.split(/\\s+/).includes(part)) ??\n null\n );\n}\n\n/**\n * Returns the light-DOM children assigned to a named slot, or every child assigned to the\n * default slot 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 return Array.from(host.children).filter((element) =>\n slotName === undefined ? !element.getAttribute('slot') : element.getAttribute('slot') === slotName,\n ) as E[];\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Create query helpers scoped to a DOM root — useful for light DOM and shadow roots.\n *\n * @example\n * const view = within(fixture.shadow!);\n * expect(view.get('.title').textContent).toBe('Hello');\n */\nexport function within(root: QueryRoot): QueryScope {\n return {\n get: <E extends Element = Element>(selector: string) =>\n requireMatch(query<E>(root, selector), `\"${selector}\"`, root),\n getByTestId: <E extends Element = Element>(testId: string) =>\n requireMatch(queryByTestId<E>(root, testId), `data-testid \"${testId}\"`, root),\n getByText: <E extends Element = Element>(text: string, selector = '*') =>\n requireMatch(queryByText<E>(root, text, selector), `text \"${text}\" matching \"${selector}\"`, root),\n query: <E extends Element = Element>(selector: string) => query<E>(root, selector),\n queryAll: <E extends Element = Element>(selector: string) => queryAll<E>(root, selector),\n queryAllByTestId: <E extends Element = Element>(testId: string) => queryAllByTestId<E>(root, testId),\n queryAllByText: <E extends Element = Element>(text: string, selector = '*') =>\n queryAllByText<E>(root, text, selector),\n queryByTestId: <E extends Element = Element>(testId: string) => queryByTestId<E>(root, testId),\n queryByText: <E extends Element = Element>(text: string, selector = '*') => queryByText<E>(root, text, selector),\n };\n}\n","import { AssayTimeoutError } from './errors';\n\nexport interface WaitOptions {\n /** Polling interval in ms (default: 50). */\n interval?: number;\n /** Cancel the pending wait. */\n signal?: AbortSignal;\n /** Maximum wait time in ms (default: 1000). */\n timeout?: number;\n}\n\nexport interface RetryOptions extends WaitOptions {\n /** Context included in the timeout error. */\n message?: string;\n}\n\nexport interface DelayOptions {\n /** Cancel the pending delay. */\n signal?: AbortSignal;\n}\n\nconst abortReason = (signal: AbortSignal): unknown =>\n signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\n\n/**\n * Resolve after `ms` milliseconds. Rejects with the abort reason when cancelled.\n */\nexport const delay = (ms = 0, { signal }: DelayOptions = {}): Promise<void> =>\n new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(abortReason(signal));\n\n return;\n }\n\n const timer = setTimeout(done, ms);\n\n function done(): void {\n signal?.removeEventListener('abort', abort);\n resolve();\n }\n\n function abort(): void {\n clearTimeout(timer);\n reject(abortReason(signal!));\n }\n\n signal?.addEventListener('abort', abort, { once: true });\n });\n\n/** Poll until a synchronous or asynchronous predicate returns `true`. */\nexport async function waitUntil(\n predicate: () => boolean | Promise<boolean>,\n { interval = 50, signal, timeout = 1000 }: WaitOptions = {},\n): Promise<void> {\n const deadline = Date.now() + timeout;\n\n for (;;) {\n if (signal?.aborted) throw abortReason(signal);\n\n if (await predicate()) return;\n\n if (Date.now() >= deadline) break;\n\n await delay(interval, { signal });\n }\n\n throw new AssayTimeoutError(`waitUntil timed out after ${timeout}ms`);\n}\n\n/** Retry an assertion until it stops throwing. */\nexport async function retry(\n assertion: () => void | Promise<void>,\n { interval = 50, message, signal, timeout = 1000 }: RetryOptions = {},\n): Promise<void> {\n const deadline = Date.now() + timeout;\n let lastError: unknown;\n\n for (;;) {\n if (signal?.aborted) throw abortReason(signal);\n\n try {\n await assertion();\n\n return;\n } catch (error) {\n lastError = error;\n }\n\n if (Date.now() >= deadline) break;\n\n await delay(interval, { signal });\n }\n\n const timing = `retry timed out after ${timeout}ms`;\n const context = message ? `${message} (${timing})` : timing;\n const detail = lastError instanceof Error ? lastError.message : lastError == null ? '' : String(lastError);\n\n throw new AssayTimeoutError(detail ? `${context}\\n${detail}` : context, { cause: lastError });\n}\n\n/** Resolve with the next event of `type`, or reject when it times out or is aborted. */\nexport function waitForEvent<T extends Event = Event>(\n target: EventTarget,\n type: string,\n { signal, timeout = 1000 }: Omit<WaitOptions, 'interval'> = {},\n): Promise<T> {\n return new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(abortReason(signal));\n\n return;\n }\n\n const dispose = () => {\n clearTimeout(timer);\n signal?.removeEventListener('abort', onAbort);\n target.removeEventListener(type, onEvent);\n };\n const onEvent = (e: Event): void => {\n dispose();\n resolve(e as T);\n };\n const timer = setTimeout(() => {\n dispose();\n reject(new AssayTimeoutError(`waitForEvent: \"${type}\" timed out after ${timeout}ms`));\n }, timeout);\n const onAbort = () => {\n dispose();\n reject(abortReason(signal!));\n };\n\n target.addEventListener(type, onEvent, { once: true });\n signal?.addEventListener('abort', onAbort, { once: true });\n });\n}\n\n/** Resolve after one microtask tick. */\nexport const nextTick = (): Promise<void> =>\n new Promise((resolve) => {\n queueMicrotask(resolve);\n });\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"assay.js","names":[],"sources":["../src/errors.ts","../src/events.ts","../src/wait.ts","../src/live-region.ts","../src/query.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\n/** Thrown when a required query has no match. */\nexport class AssayQueryError extends AssayError {}\n\n/** Thrown by `waitUntil`/`retry`/`waitForEvent` when the timeout elapses. */\nexport class AssayTimeoutError extends AssayError {}\n","/** Synchronous, exact DOM event dispatchers for test environments. */\n\n/** Dispatch an event instance without modifying it. */\nexport const dispatch = (target: EventTarget, event: Event): boolean => target.dispatchEvent(event);\n\nexport const fireBlur = (target: EventTarget, init: FocusEventInit = {}): boolean =>\n dispatch(target, new FocusEvent('blur', init));\n\nexport const fireChange = (target: EventTarget, init: EventInit = {}): boolean =>\n dispatch(target, new Event('change', { bubbles: true, ...init }));\n\nexport const fireClick = (target: EventTarget, init: MouseEventInit = {}): boolean =>\n dispatch(target, new MouseEvent('click', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireCustom = <T>(target: EventTarget, type: string, init: CustomEventInit<T> = {}): boolean =>\n dispatch(target, new CustomEvent(type, { bubbles: true, cancelable: true, composed: false, ...init }));\n\nexport const fireFocus = (target: EventTarget, init: FocusEventInit = {}): boolean =>\n dispatch(target, new FocusEvent('focus', init));\n\nexport const fireInput = (target: EventTarget, init: InputEventInit = {}): boolean =>\n dispatch(target, new InputEvent('input', { bubbles: true, ...init }));\n\nexport const fireKeyDown = (target: EventTarget, init: KeyboardEventInit = {}): boolean =>\n dispatch(target, new KeyboardEvent('keydown', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireKeyUp = (target: EventTarget, init: KeyboardEventInit = {}): boolean =>\n dispatch(target, new KeyboardEvent('keyup', { bubbles: true, cancelable: true, ...init }));\n\nexport const fireSubmit = (target: EventTarget, init: SubmitEventInit = {}): boolean =>\n dispatch(target, new SubmitEvent('submit', { bubbles: true, cancelable: true, ...init }));\n","import { AssayTimeoutError } from './errors';\n\nexport interface WaitOptions {\n /** Polling interval in ms (default: 50). */\n interval?: number;\n /** Cancel the pending wait. */\n signal?: AbortSignal;\n /** Maximum wait time in ms (default: 1000). */\n timeout?: number;\n}\n\nexport interface RetryOptions extends WaitOptions {\n /** Context included in the timeout error. */\n message?: string;\n}\n\nexport interface DelayOptions {\n /** Cancel the pending delay. */\n signal?: AbortSignal;\n}\n\nconst abortReason = (signal: AbortSignal): unknown =>\n signal.reason ?? new DOMException('The operation was aborted.', 'AbortError');\n\n/**\n * Resolve after `ms` milliseconds. Rejects with the abort reason when cancelled.\n */\nexport const delay = (ms = 0, { signal }: DelayOptions = {}): Promise<void> =>\n new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(abortReason(signal));\n\n return;\n }\n\n const timer = setTimeout(done, ms);\n\n function done(): void {\n signal?.removeEventListener('abort', abort);\n resolve();\n }\n\n function abort(): void {\n clearTimeout(timer);\n reject(abortReason(signal!));\n }\n\n signal?.addEventListener('abort', abort, { once: true });\n });\n\n/** Poll until a synchronous or asynchronous predicate returns `true`. */\nexport async function waitUntil(\n predicate: () => boolean | Promise<boolean>,\n { interval = 50, signal, timeout = 1000 }: WaitOptions = {},\n): Promise<void> {\n const deadline = Date.now() + timeout;\n\n for (;;) {\n if (signal?.aborted) throw abortReason(signal);\n\n if (await predicate()) return;\n\n if (Date.now() >= deadline) break;\n\n await delay(interval, { signal });\n }\n\n throw new AssayTimeoutError(`waitUntil timed out after ${timeout}ms`);\n}\n\n/** Retry an assertion until it stops throwing. */\nexport async function retry(\n assertion: () => void | Promise<void>,\n { interval = 50, message, signal, timeout = 1000 }: RetryOptions = {},\n): Promise<void> {\n const deadline = Date.now() + timeout;\n let lastError: unknown;\n\n for (;;) {\n if (signal?.aborted) throw abortReason(signal);\n\n try {\n await assertion();\n\n return;\n } catch (error) {\n lastError = error;\n }\n\n if (Date.now() >= deadline) break;\n\n await delay(interval, { signal });\n }\n\n const timing = `retry timed out after ${timeout}ms`;\n const context = message ? `${message} (${timing})` : timing;\n const detail = lastError instanceof Error ? lastError.message : lastError == null ? '' : String(lastError);\n\n throw new AssayTimeoutError(detail ? `${context}\\n${detail}` : context, { cause: lastError });\n}\n\n/** Resolve with the next event of `type`, or reject when it times out or is aborted. */\nexport function waitForEvent<T extends Event = Event>(\n target: EventTarget,\n type: string,\n { signal, timeout = 1000 }: Omit<WaitOptions, 'interval'> = {},\n): Promise<T> {\n return new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(abortReason(signal));\n\n return;\n }\n\n const dispose = () => {\n clearTimeout(timer);\n signal?.removeEventListener('abort', onAbort);\n target.removeEventListener(type, onEvent);\n };\n const onEvent = (e: Event): void => {\n dispose();\n resolve(e as T);\n };\n const timer = setTimeout(() => {\n dispose();\n reject(new AssayTimeoutError(`waitForEvent: \"${type}\" timed out after ${timeout}ms`));\n }, timeout);\n const onAbort = () => {\n dispose();\n reject(abortReason(signal!));\n };\n\n target.addEventListener(type, onEvent, { once: true });\n signal?.addEventListener('abort', onAbort, { once: true });\n });\n}\n\n/** Resolve after one microtask tick. */\nexport const nextTick = (): Promise<void> =>\n new Promise((resolve) => {\n queueMicrotask(resolve);\n });\n","import { AssayQueryError } from './errors';\nimport { retry, type WaitOptions } from './wait';\n\n/** Politeness levels for ARIA live regions. */\nexport type LiveRegionPoliteness = 'assertive' | 'off' | 'polite';\n\n/**\n * ARIA roles that carry an implicit `aria-live` value per the WAI-ARIA spec.\n * `role=\"status\"` → `polite`, `role=\"alert\"` → `assertive`. Elements with these\n * roles are live regions even without an explicit `aria-live` attribute.\n */\nconst IMPLICIT_ROLE_POLITENESS: Record<string, LiveRegionPoliteness> = {\n alert: 'assertive',\n status: 'polite',\n};\n\nexport interface LiveRegionQueryOptions {\n /** The document to search. Defaults to the global `document`. */\n document?: Document;\n /** Politeness to match via `aria-live` (or implicit role). Defaults to `'polite'`. */\n politeness?: LiveRegionPoliteness;\n /** ARIA role to match (e.g. `'status'`, `'alert'`). Omit to match any role. */\n role?: string;\n /** Root to scope the query. Defaults to `document.body`. */\n root?: ParentNode;\n}\n\n/**\n * Resolves the effective politeness of an element: explicit `aria-live` wins,\n * otherwise falls back to the implicit value from `role=\"status\"`/`role=\"alert\"`.\n * Returns `null` when the element is not a live region.\n */\nfunction resolvePoliteness(el: HTMLElement): LiveRegionPoliteness | null {\n const explicit = el.getAttribute('aria-live');\n\n if (explicit) return explicit as LiveRegionPoliteness;\n\n const role = el.getAttribute('role');\n\n if (role && role in IMPLICIT_ROLE_POLITENESS) return IMPLICIT_ROLE_POLITENESS[role];\n\n return null;\n}\n\n/**\n * Queries the first live region matching the given politeness (and optional role)\n * within `root`. Returns `null` when none exists — safe to call before the region\n * has been lazily created.\n *\n * Matches both explicit `aria-live` attributes and implicit roles (`status` →\n * polite, `alert` → assertive) per the WAI-ARIA spec.\n *\n * @example\n * const region = queryLiveRegion({ politeness: 'polite' });\n * expect(region).not.toBeNull();\n */\nexport function queryLiveRegion(options: LiveRegionQueryOptions = {}): HTMLElement | null {\n const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n const politeness = options.politeness ?? 'polite';\n const root = options.root ?? doc?.body ?? null;\n\n if (!root) return null;\n\n const candidates = Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]'));\n\n for (const el of candidates) {\n if (resolvePoliteness(el) !== politeness) continue;\n\n if (options.role !== undefined && el.getAttribute('role') !== options.role) continue;\n\n return el;\n }\n\n return null;\n}\n\n/**\n * Queries all live regions matching the given politeness (and optional role)\n * within `root`. Useful for asserting no duplicate regions were created.\n *\n * @example\n * expect(queryAllLiveRegions({ politeness: 'polite' })).toHaveLength(1);\n */\nexport function queryAllLiveRegions(options: LiveRegionQueryOptions = {}): HTMLElement[] {\n const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n const politeness = options.politeness ?? 'polite';\n const root = options.root ?? doc?.body ?? null;\n\n if (!root) return [];\n\n return Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]')).filter((el) => {\n if (resolvePoliteness(el) !== politeness) return false;\n\n if (options.role !== undefined && el.getAttribute('role') !== options.role) return false;\n\n return true;\n });\n}\n\nexport interface WaitForLiveRegionOptions extends WaitOptions {\n /** The document to search. Defaults to the global `document`. */\n document?: Document;\n /** Politeness to match via `aria-live`. Defaults to `'polite'`. */\n politeness?: LiveRegionPoliteness;\n /** ARIA role to match. Omit to match any role. */\n role?: string;\n /** Root to scope the query. Defaults to `document.body`. */\n root?: ParentNode;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and contains\n * `text` (substring match). Throws `AssayTimeoutError` on timeout.\n *\n * Handles the clear-then-set announce pattern: the region may briefly be empty\n * before the message is written, so polling until the text appears is the\n * correct approach rather than a single snapshot assertion.\n *\n * @example\n * await waitForLiveRegion({ text: '3 results found' });\n * await waitForLiveRegion({ politeness: 'assertive', text: 'Session expired' });\n */\nexport async function waitForLiveRegion(text: string, options: WaitForLiveRegionOptions = {}): Promise<HTMLElement> {\n const politeness = options.politeness ?? 'polite';\n let matched: HTMLElement | null = null;\n\n await retry(\n () => {\n const region = queryLiveRegion({\n document: options.document,\n politeness,\n role: options.role,\n root: options.root,\n });\n\n if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n if (!region.textContent?.includes(text)) {\n throw new AssayQueryError(`Live region text \"${region.textContent}\" does not include \"${text}\".`);\n }\n\n matched = region;\n },\n {\n interval: options.interval,\n message: `waitForLiveRegion(\"${text}\")`,\n signal: options.signal,\n timeout: options.timeout,\n },\n );\n\n // `retry` only resolves once the assertion stops throwing, so `matched` is set.\n return matched!;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and is empty\n * (cleared). Throws `AssayTimeoutError` on timeout.\n *\n * @example\n * await waitForLiveRegionCleared();\n */\nexport async function waitForLiveRegionCleared(options: WaitForLiveRegionOptions = {}): Promise<void> {\n const politeness = options.politeness ?? 'polite';\n\n await retry(\n () => {\n const region = queryLiveRegion({\n document: options.document,\n politeness,\n role: options.role,\n root: options.root,\n });\n\n if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n if (region.textContent !== '') {\n throw new AssayQueryError(`Live region not cleared: \"${region.textContent}\".`);\n }\n },\n {\n interval: options.interval,\n message: 'waitForLiveRegionCleared',\n signal: options.signal,\n timeout: options.timeout,\n },\n );\n}\n","import { AssayQueryError } from './errors';\n\n/** DOM query helpers for test environments. */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Scoped query helpers for any queryable DOM root — see {@link within}. */\nexport interface QueryScope {\n get<E extends Element = Element>(selector: string): E;\n getByTestId<E extends Element = Element>(testId: string): E;\n getByText<E extends Element = Element>(text: string, selector?: string): E;\n query<E extends Element = Element>(selector: string): E | null;\n queryAll<E extends Element = Element>(selector: string): E[];\n queryAllByTestId<E extends Element = Element>(testId: string): E[];\n queryAllByText<E extends Element = Element>(text: string, selector?: string): E[];\n queryByTestId<E extends Element = Element>(testId: string): E | null;\n queryByText<E extends Element = Element>(text: string, selector?: string): E | null;\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\ntype QueryRoot = ParentNode;\n\nconst describeRoot = (root: QueryRoot): string => {\n if (root instanceof Element) return root.outerHTML.slice(0, 500);\n\n if (root instanceof ShadowRoot) return `<shadow-root>${root.innerHTML.slice(0, 500)}</shadow-root>`;\n\n return root.nodeName;\n};\n\nconst requireMatch = <E extends Element>(element: E | null, description: string, root: QueryRoot): E => {\n if (element) return element;\n\n throw new AssayQueryError(`Unable to find ${description} within ${describeRoot(root)}.`);\n};\n\nconst query = <E extends Element = Element>(root: QueryRoot, selector: string): E | null =>\n root.querySelector<E>(selector);\n\nconst queryAll = <E extends Element = Element>(root: QueryRoot, selector: string): E[] => {\n return Array.from(root.querySelectorAll<E>(selector));\n};\n\nconst queryByTestId = <E extends Element = Element>(root: QueryRoot, testId: string): E | null =>\n queryAll<E>(root, '[data-testid]').find((element) => element.getAttribute('data-testid') === testId) ?? null;\n\nconst queryAllByTestId = <E extends Element = Element>(root: QueryRoot, testId: string): E[] =>\n queryAll<E>(root, '[data-testid]').filter((element) => element.getAttribute('data-testid') === testId);\n\nconst queryByText = <E extends Element = Element>(root: QueryRoot, text: string, selector = '*'): 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\nconst queryAllByText = <E extends Element = Element>(root: QueryRoot, text: string, selector = '*'): 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 ? query<E>(host.shadowRoot, 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 host.shadowRoot ? queryAll<E>(host.shadowRoot, 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 (\n queryAllInShadow<E>(host, '[part]').find((element) => element.getAttribute('part')?.split(/\\s+/).includes(part)) ??\n null\n );\n}\n\n/**\n * Returns the light-DOM children assigned to a named slot, or every child assigned to the\n * default slot 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 return Array.from(host.children).filter((element) =>\n slotName === undefined ? !element.getAttribute('slot') : element.getAttribute('slot') === slotName,\n ) as E[];\n}\n\n// ─── API ─────────────────────────────────────────────────────────────────────\n\n/**\n * Create query helpers scoped to a DOM root — useful for light DOM and shadow roots.\n *\n * @example\n * const view = within(fixture.shadow!);\n * expect(view.get('.title').textContent).toBe('Hello');\n */\nexport function within(root: QueryRoot): QueryScope {\n return {\n get: <E extends Element = Element>(selector: string) =>\n requireMatch(query<E>(root, selector), `\"${selector}\"`, root),\n getByTestId: <E extends Element = Element>(testId: string) =>\n requireMatch(queryByTestId<E>(root, testId), `data-testid \"${testId}\"`, root),\n getByText: <E extends Element = Element>(text: string, selector = '*') =>\n requireMatch(queryByText<E>(root, text, selector), `text \"${text}\" matching \"${selector}\"`, root),\n query: <E extends Element = Element>(selector: string) => query<E>(root, selector),\n queryAll: <E extends Element = Element>(selector: string) => queryAll<E>(root, selector),\n queryAllByTestId: <E extends Element = Element>(testId: string) => queryAllByTestId<E>(root, testId),\n queryAllByText: <E extends Element = Element>(text: string, selector = '*') =>\n queryAllByText<E>(root, text, selector),\n queryByTestId: <E extends Element = Element>(testId: string) => queryByTestId<E>(root, testId),\n queryByText: <E extends Element = Element>(text: string, selector = '*') => queryByText<E>(root, text, selector),\n };\n}\n"],"mappings":"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"}
|
package/dist/index.cjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./errors.cjs"),t=require("./events.cjs"),n=require("./
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./errors.cjs"),t=require("./events.cjs"),n=require("./wait.cjs"),r=require("./live-region.cjs"),i=require("./query.cjs");exports.AssayError=e.AssayError,exports.AssayQueryError=e.AssayQueryError,exports.AssayTimeoutError=e.AssayTimeoutError,exports.delay=n.delay,exports.dispatch=t.dispatch,exports.fireBlur=t.fireBlur,exports.fireChange=t.fireChange,exports.fireClick=t.fireClick,exports.fireCustom=t.fireCustom,exports.fireFocus=t.fireFocus,exports.fireInput=t.fireInput,exports.fireKeyDown=t.fireKeyDown,exports.fireKeyUp=t.fireKeyUp,exports.fireSubmit=t.fireSubmit,exports.getSlotted=i.getSlotted,exports.nextTick=n.nextTick,exports.queryAllInShadow=i.queryAllInShadow,exports.queryAllLiveRegions=r.queryAllLiveRegions,exports.queryInShadow=i.queryInShadow,exports.queryLiveRegion=r.queryLiveRegion,exports.queryPart=i.queryPart,exports.retry=n.retry,exports.waitForEvent=n.waitForEvent,exports.waitForLiveRegion=r.waitForLiveRegion,exports.waitForLiveRegionCleared=r.waitForLiveRegionCleared,exports.waitUntil=n.waitUntil,exports.within=i.within;
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
export { AssayError, AssayQueryError, AssayTimeoutError } from './errors';
|
|
2
2
|
export { dispatch, fireBlur, fireChange, fireClick, fireCustom, fireFocus, fireInput, fireKeyDown, fireKeyUp, fireSubmit, } from './events';
|
|
3
|
+
export { type LiveRegionPoliteness, type LiveRegionQueryOptions, queryAllLiveRegions, queryLiveRegion, type WaitForLiveRegionOptions, waitForLiveRegion, waitForLiveRegionCleared, } from './live-region';
|
|
3
4
|
export { getSlotted, type QueryScope, queryAllInShadow, queryInShadow, queryPart, within } from './query';
|
|
4
5
|
export { type DelayOptions, delay, nextTick, type RetryOptions, retry, type WaitOptions, waitForEvent, waitUntil, } from './wait';
|
|
5
6
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE1E,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,UAAU,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC1G,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,EACL,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,EACL,KAAK,WAAW,EAChB,YAAY,EACZ,SAAS,GACV,MAAM,QAAQ,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE1E,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,UAAU,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,mBAAmB,EACnB,eAAe,EACf,KAAK,wBAAwB,EAC7B,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC1G,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,EACL,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,EACL,KAAK,WAAW,EAChB,YAAY,EACZ,SAAS,GACV,MAAM,QAAQ,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { AssayError as e, AssayQueryError as t, AssayTimeoutError as n } from "./errors.js";
|
|
2
2
|
import { dispatch as r, fireBlur as i, fireChange as a, fireClick as o, fireCustom as s, fireFocus as c, fireInput as l, fireKeyDown as u, fireKeyUp as d, fireSubmit as f } from "./events.js";
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
5
|
-
|
|
3
|
+
import { delay as p, nextTick as m, retry as h, waitForEvent as g, waitUntil as _ } from "./wait.js";
|
|
4
|
+
import { queryAllLiveRegions as v, queryLiveRegion as y, waitForLiveRegion as b, waitForLiveRegionCleared as x } from "./live-region.js";
|
|
5
|
+
import { getSlotted as S, queryAllInShadow as C, queryInShadow as w, queryPart as T, within as E } from "./query.js";
|
|
6
|
+
export { e as AssayError, t as AssayQueryError, n as AssayTimeoutError, p as delay, r as dispatch, i as fireBlur, a as fireChange, o as fireClick, s as fireCustom, c as fireFocus, l as fireInput, u as fireKeyDown, d as fireKeyUp, f as fireSubmit, S as getSlotted, m as nextTick, C as queryAllInShadow, v as queryAllLiveRegions, w as queryInShadow, y as queryLiveRegion, T as queryPart, h as retry, g as waitForEvent, b as waitForLiveRegion, x as waitForLiveRegionCleared, _ as waitUntil, E as within };
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
const e=require("./errors.cjs"),t=require("./wait.cjs");var n={alert:`assertive`,status:`polite`};function r(e){let t=e.getAttribute(`aria-live`);if(t)return t;let r=e.getAttribute(`role`);return r&&r in n?n[r]:null}function i(e={}){let t=e.document??(typeof document<`u`?document:null),n=e.politeness??`polite`,i=e.root??t?.body??null;if(!i)return null;let a=Array.from(i.querySelectorAll(`[aria-live], [role="status"], [role="alert"]`));for(let t of a)if(r(t)===n&&(e.role===void 0||t.getAttribute(`role`)===e.role))return t;return null}function a(e={}){let t=e.document??(typeof document<`u`?document:null),n=e.politeness??`polite`,i=e.root??t?.body??null;return i?Array.from(i.querySelectorAll(`[aria-live], [role="status"], [role="alert"]`)).filter(t=>!(r(t)!==n||e.role!==void 0&&t.getAttribute(`role`)!==e.role)):[]}async function o(n,r={}){let a=r.politeness??`polite`,o=null;return await t.retry(()=>{let t=i({document:r.document,politeness:a,role:r.role,root:r.root});if(!t)throw new e.AssayQueryError(`No ${a} live region found.`);if(!t.textContent?.includes(n))throw new e.AssayQueryError(`Live region text "${t.textContent}" does not include "${n}".`);o=t},{interval:r.interval,message:`waitForLiveRegion("${n}")`,signal:r.signal,timeout:r.timeout}),o}async function s(n={}){let r=n.politeness??`polite`;await t.retry(()=>{let t=i({document:n.document,politeness:r,role:n.role,root:n.root});if(!t)throw new e.AssayQueryError(`No ${r} live region found.`);if(t.textContent!==``)throw new e.AssayQueryError(`Live region not cleared: "${t.textContent}".`)},{interval:n.interval,message:`waitForLiveRegionCleared`,signal:n.signal,timeout:n.timeout})}exports.queryAllLiveRegions=a,exports.queryLiveRegion=i,exports.waitForLiveRegion=o,exports.waitForLiveRegionCleared=s;
|
|
2
|
+
//# sourceMappingURL=live-region.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"live-region.cjs","names":[],"sources":["../src/live-region.ts"],"sourcesContent":["import { AssayQueryError } from './errors';\nimport { retry, type WaitOptions } from './wait';\n\n/** Politeness levels for ARIA live regions. */\nexport type LiveRegionPoliteness = 'assertive' | 'off' | 'polite';\n\n/**\n * ARIA roles that carry an implicit `aria-live` value per the WAI-ARIA spec.\n * `role=\"status\"` → `polite`, `role=\"alert\"` → `assertive`. Elements with these\n * roles are live regions even without an explicit `aria-live` attribute.\n */\nconst IMPLICIT_ROLE_POLITENESS: Record<string, LiveRegionPoliteness> = {\n alert: 'assertive',\n status: 'polite',\n};\n\nexport interface LiveRegionQueryOptions {\n /** The document to search. Defaults to the global `document`. */\n document?: Document;\n /** Politeness to match via `aria-live` (or implicit role). Defaults to `'polite'`. */\n politeness?: LiveRegionPoliteness;\n /** ARIA role to match (e.g. `'status'`, `'alert'`). Omit to match any role. */\n role?: string;\n /** Root to scope the query. Defaults to `document.body`. */\n root?: ParentNode;\n}\n\n/**\n * Resolves the effective politeness of an element: explicit `aria-live` wins,\n * otherwise falls back to the implicit value from `role=\"status\"`/`role=\"alert\"`.\n * Returns `null` when the element is not a live region.\n */\nfunction resolvePoliteness(el: HTMLElement): LiveRegionPoliteness | null {\n const explicit = el.getAttribute('aria-live');\n\n if (explicit) return explicit as LiveRegionPoliteness;\n\n const role = el.getAttribute('role');\n\n if (role && role in IMPLICIT_ROLE_POLITENESS) return IMPLICIT_ROLE_POLITENESS[role];\n\n return null;\n}\n\n/**\n * Queries the first live region matching the given politeness (and optional role)\n * within `root`. Returns `null` when none exists — safe to call before the region\n * has been lazily created.\n *\n * Matches both explicit `aria-live` attributes and implicit roles (`status` →\n * polite, `alert` → assertive) per the WAI-ARIA spec.\n *\n * @example\n * const region = queryLiveRegion({ politeness: 'polite' });\n * expect(region).not.toBeNull();\n */\nexport function queryLiveRegion(options: LiveRegionQueryOptions = {}): HTMLElement | null {\n const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n const politeness = options.politeness ?? 'polite';\n const root = options.root ?? doc?.body ?? null;\n\n if (!root) return null;\n\n const candidates = Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]'));\n\n for (const el of candidates) {\n if (resolvePoliteness(el) !== politeness) continue;\n\n if (options.role !== undefined && el.getAttribute('role') !== options.role) continue;\n\n return el;\n }\n\n return null;\n}\n\n/**\n * Queries all live regions matching the given politeness (and optional role)\n * within `root`. Useful for asserting no duplicate regions were created.\n *\n * @example\n * expect(queryAllLiveRegions({ politeness: 'polite' })).toHaveLength(1);\n */\nexport function queryAllLiveRegions(options: LiveRegionQueryOptions = {}): HTMLElement[] {\n const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n const politeness = options.politeness ?? 'polite';\n const root = options.root ?? doc?.body ?? null;\n\n if (!root) return [];\n\n return Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]')).filter((el) => {\n if (resolvePoliteness(el) !== politeness) return false;\n\n if (options.role !== undefined && el.getAttribute('role') !== options.role) return false;\n\n return true;\n });\n}\n\nexport interface WaitForLiveRegionOptions extends WaitOptions {\n /** The document to search. Defaults to the global `document`. */\n document?: Document;\n /** Politeness to match via `aria-live`. Defaults to `'polite'`. */\n politeness?: LiveRegionPoliteness;\n /** ARIA role to match. Omit to match any role. */\n role?: string;\n /** Root to scope the query. Defaults to `document.body`. */\n root?: ParentNode;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and contains\n * `text` (substring match). Throws `AssayTimeoutError` on timeout.\n *\n * Handles the clear-then-set announce pattern: the region may briefly be empty\n * before the message is written, so polling until the text appears is the\n * correct approach rather than a single snapshot assertion.\n *\n * @example\n * await waitForLiveRegion({ text: '3 results found' });\n * await waitForLiveRegion({ politeness: 'assertive', text: 'Session expired' });\n */\nexport async function waitForLiveRegion(text: string, options: WaitForLiveRegionOptions = {}): Promise<HTMLElement> {\n const politeness = options.politeness ?? 'polite';\n let matched: HTMLElement | null = null;\n\n await retry(\n () => {\n const region = queryLiveRegion({\n document: options.document,\n politeness,\n role: options.role,\n root: options.root,\n });\n\n if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n if (!region.textContent?.includes(text)) {\n throw new AssayQueryError(`Live region text \"${region.textContent}\" does not include \"${text}\".`);\n }\n\n matched = region;\n },\n {\n interval: options.interval,\n message: `waitForLiveRegion(\"${text}\")`,\n signal: options.signal,\n timeout: options.timeout,\n },\n );\n\n // `retry` only resolves once the assertion stops throwing, so `matched` is set.\n return matched!;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and is empty\n * (cleared). Throws `AssayTimeoutError` on timeout.\n *\n * @example\n * await waitForLiveRegionCleared();\n */\nexport async function waitForLiveRegionCleared(options: WaitForLiveRegionOptions = {}): Promise<void> {\n const politeness = options.politeness ?? 'polite';\n\n await retry(\n () => {\n const region = queryLiveRegion({\n document: options.document,\n politeness,\n role: options.role,\n root: options.root,\n });\n\n if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n if (region.textContent !== '') {\n throw new AssayQueryError(`Live region not cleared: \"${region.textContent}\".`);\n }\n },\n {\n interval: options.interval,\n message: 'waitForLiveRegionCleared',\n signal: options.signal,\n timeout: options.timeout,\n },\n );\n}\n"],"mappings":"wDAWA,IAAM,EAAiE,CACrE,MAAO,YACP,OAAQ,QACV,EAkBA,SAAS,EAAkB,EAA8C,CACvE,IAAM,EAAW,EAAG,aAAa,WAAW,EAE5C,GAAI,EAAU,OAAO,EAErB,IAAM,EAAO,EAAG,aAAa,MAAM,EAInC,OAFI,GAAQ,KAAQ,EAAiC,EAAyB,GAEvE,IACT,CAcA,SAAgB,EAAgB,EAAkC,CAAC,EAAuB,CACxF,IAAM,EAAM,EAAQ,WAAa,OAAO,SAAa,IAAc,SAAW,MACxE,EAAa,EAAQ,YAAc,SACnC,EAAO,EAAQ,MAAQ,GAAK,MAAQ,KAE1C,GAAI,CAAC,EAAM,OAAO,KAElB,IAAM,EAAa,MAAM,KAAK,EAAK,iBAA8B,8CAA8C,CAAC,EAEhH,IAAK,IAAM,KAAM,EACX,KAAkB,CAAE,IAAM,IAE1B,EAAQ,OAAS,IAAA,IAAa,EAAG,aAAa,MAAM,IAAM,EAAQ,MAEtE,OAAO,EAGT,OAAO,IACT,CASA,SAAgB,EAAoB,EAAkC,CAAC,EAAkB,CACvF,IAAM,EAAM,EAAQ,WAAa,OAAO,SAAa,IAAc,SAAW,MACxE,EAAa,EAAQ,YAAc,SACnC,EAAO,EAAQ,MAAQ,GAAK,MAAQ,KAI1C,OAFK,EAEE,MAAM,KAAK,EAAK,iBAA8B,8CAA8C,CAAC,CAAC,CAAC,OAAQ,GAG5G,EAFI,EAAkB,CAAE,IAAM,GAE1B,EAAQ,OAAS,IAAA,IAAa,EAAG,aAAa,MAAM,IAAM,EAAQ,KAGvE,EARiB,CAAC,CASrB,CAyBA,eAAsB,EAAkB,EAAc,EAAoC,CAAC,EAAyB,CAClH,IAAM,EAAa,EAAQ,YAAc,SACrC,EAA8B,KA4BlC,OA1BA,MAAM,EAAA,UACE,CACJ,IAAM,EAAS,EAAgB,CAC7B,SAAU,EAAQ,SAClB,aACA,KAAM,EAAQ,KACd,KAAM,EAAQ,IAChB,CAAC,EAED,GAAI,CAAC,EAAQ,MAAM,IAAI,EAAA,gBAAgB,MAAM,EAAW,oBAAoB,EAE5E,GAAI,CAAC,EAAO,aAAa,SAAS,CAAI,EACpC,MAAM,IAAI,EAAA,gBAAgB,qBAAqB,EAAO,YAAY,sBAAsB,EAAK,GAAG,EAGlG,EAAU,CACZ,EACA,CACE,SAAU,EAAQ,SAClB,QAAS,sBAAsB,EAAK,IACpC,OAAQ,EAAQ,OAChB,QAAS,EAAQ,OACnB,CACF,EAGO,CACT,CASA,eAAsB,EAAyB,EAAoC,CAAC,EAAkB,CACpG,IAAM,EAAa,EAAQ,YAAc,SAEzC,MAAM,EAAA,UACE,CACJ,IAAM,EAAS,EAAgB,CAC7B,SAAU,EAAQ,SAClB,aACA,KAAM,EAAQ,KACd,KAAM,EAAQ,IAChB,CAAC,EAED,GAAI,CAAC,EAAQ,MAAM,IAAI,EAAA,gBAAgB,MAAM,EAAW,oBAAoB,EAE5E,GAAI,EAAO,cAAgB,GACzB,MAAM,IAAI,EAAA,gBAAgB,6BAA6B,EAAO,YAAY,GAAG,CAEjF,EACA,CACE,SAAU,EAAQ,SAClB,QAAS,2BACT,OAAQ,EAAQ,OAChB,QAAS,EAAQ,OACnB,CACF,CACF"}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import { type WaitOptions } from './wait';
|
|
2
|
+
/** Politeness levels for ARIA live regions. */
|
|
3
|
+
export type LiveRegionPoliteness = 'assertive' | 'off' | 'polite';
|
|
4
|
+
export interface LiveRegionQueryOptions {
|
|
5
|
+
/** The document to search. Defaults to the global `document`. */
|
|
6
|
+
document?: Document;
|
|
7
|
+
/** Politeness to match via `aria-live` (or implicit role). Defaults to `'polite'`. */
|
|
8
|
+
politeness?: LiveRegionPoliteness;
|
|
9
|
+
/** ARIA role to match (e.g. `'status'`, `'alert'`). Omit to match any role. */
|
|
10
|
+
role?: string;
|
|
11
|
+
/** Root to scope the query. Defaults to `document.body`. */
|
|
12
|
+
root?: ParentNode;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Queries the first live region matching the given politeness (and optional role)
|
|
16
|
+
* within `root`. Returns `null` when none exists — safe to call before the region
|
|
17
|
+
* has been lazily created.
|
|
18
|
+
*
|
|
19
|
+
* Matches both explicit `aria-live` attributes and implicit roles (`status` →
|
|
20
|
+
* polite, `alert` → assertive) per the WAI-ARIA spec.
|
|
21
|
+
*
|
|
22
|
+
* @example
|
|
23
|
+
* const region = queryLiveRegion({ politeness: 'polite' });
|
|
24
|
+
* expect(region).not.toBeNull();
|
|
25
|
+
*/
|
|
26
|
+
export declare function queryLiveRegion(options?: LiveRegionQueryOptions): HTMLElement | null;
|
|
27
|
+
/**
|
|
28
|
+
* Queries all live regions matching the given politeness (and optional role)
|
|
29
|
+
* within `root`. Useful for asserting no duplicate regions were created.
|
|
30
|
+
*
|
|
31
|
+
* @example
|
|
32
|
+
* expect(queryAllLiveRegions({ politeness: 'polite' })).toHaveLength(1);
|
|
33
|
+
*/
|
|
34
|
+
export declare function queryAllLiveRegions(options?: LiveRegionQueryOptions): HTMLElement[];
|
|
35
|
+
export interface WaitForLiveRegionOptions extends WaitOptions {
|
|
36
|
+
/** The document to search. Defaults to the global `document`. */
|
|
37
|
+
document?: Document;
|
|
38
|
+
/** Politeness to match via `aria-live`. Defaults to `'polite'`. */
|
|
39
|
+
politeness?: LiveRegionPoliteness;
|
|
40
|
+
/** ARIA role to match. Omit to match any role. */
|
|
41
|
+
role?: string;
|
|
42
|
+
/** Root to scope the query. Defaults to `document.body`. */
|
|
43
|
+
root?: ParentNode;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Retries until a live region matching the politeness/role exists and contains
|
|
47
|
+
* `text` (substring match). Throws `AssayTimeoutError` on timeout.
|
|
48
|
+
*
|
|
49
|
+
* Handles the clear-then-set announce pattern: the region may briefly be empty
|
|
50
|
+
* before the message is written, so polling until the text appears is the
|
|
51
|
+
* correct approach rather than a single snapshot assertion.
|
|
52
|
+
*
|
|
53
|
+
* @example
|
|
54
|
+
* await waitForLiveRegion({ text: '3 results found' });
|
|
55
|
+
* await waitForLiveRegion({ politeness: 'assertive', text: 'Session expired' });
|
|
56
|
+
*/
|
|
57
|
+
export declare function waitForLiveRegion(text: string, options?: WaitForLiveRegionOptions): Promise<HTMLElement>;
|
|
58
|
+
/**
|
|
59
|
+
* Retries until a live region matching the politeness/role exists and is empty
|
|
60
|
+
* (cleared). Throws `AssayTimeoutError` on timeout.
|
|
61
|
+
*
|
|
62
|
+
* @example
|
|
63
|
+
* await waitForLiveRegionCleared();
|
|
64
|
+
*/
|
|
65
|
+
export declare function waitForLiveRegionCleared(options?: WaitForLiveRegionOptions): Promise<void>;
|
|
66
|
+
//# sourceMappingURL=live-region.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"live-region.d.ts","sourceRoot":"","sources":["../src/live-region.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEjD,+CAA+C;AAC/C,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,KAAK,GAAG,QAAQ,CAAC;AAYlE,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,sFAAsF;IACtF,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,WAAW,GAAG,IAAI,CAkBxF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,sBAA2B,GAAG,WAAW,EAAE,CAcvF;AAED,MAAM,WAAW,wBAAyB,SAAQ,WAAW;IAC3D,iEAAiE;IACjE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,mEAAmE;IACnE,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,WAAW,CAAC,CA+BlH;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBpG"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { AssayQueryError as e } from "./errors.js";
|
|
2
|
+
import { retry as t } from "./wait.js";
|
|
3
|
+
//#region src/live-region.ts
|
|
4
|
+
var n = {
|
|
5
|
+
alert: "assertive",
|
|
6
|
+
status: "polite"
|
|
7
|
+
};
|
|
8
|
+
function r(e) {
|
|
9
|
+
let t = e.getAttribute("aria-live");
|
|
10
|
+
if (t) return t;
|
|
11
|
+
let r = e.getAttribute("role");
|
|
12
|
+
return r && r in n ? n[r] : null;
|
|
13
|
+
}
|
|
14
|
+
function i(e = {}) {
|
|
15
|
+
let t = e.document ?? (typeof document < "u" ? document : null), n = e.politeness ?? "polite", i = e.root ?? t?.body ?? null;
|
|
16
|
+
if (!i) return null;
|
|
17
|
+
let a = Array.from(i.querySelectorAll("[aria-live], [role=\"status\"], [role=\"alert\"]"));
|
|
18
|
+
for (let t of a) if (r(t) === n && (e.role === void 0 || t.getAttribute("role") === e.role)) return t;
|
|
19
|
+
return null;
|
|
20
|
+
}
|
|
21
|
+
function a(e = {}) {
|
|
22
|
+
let t = e.document ?? (typeof document < "u" ? document : null), n = e.politeness ?? "polite", i = e.root ?? t?.body ?? null;
|
|
23
|
+
return i ? Array.from(i.querySelectorAll("[aria-live], [role=\"status\"], [role=\"alert\"]")).filter((t) => !(r(t) !== n || e.role !== void 0 && t.getAttribute("role") !== e.role)) : [];
|
|
24
|
+
}
|
|
25
|
+
async function o(n, r = {}) {
|
|
26
|
+
let a = r.politeness ?? "polite", o = null;
|
|
27
|
+
return await t(() => {
|
|
28
|
+
let t = i({
|
|
29
|
+
document: r.document,
|
|
30
|
+
politeness: a,
|
|
31
|
+
role: r.role,
|
|
32
|
+
root: r.root
|
|
33
|
+
});
|
|
34
|
+
if (!t) throw new e(`No ${a} live region found.`);
|
|
35
|
+
if (!t.textContent?.includes(n)) throw new e(`Live region text "${t.textContent}" does not include "${n}".`);
|
|
36
|
+
o = t;
|
|
37
|
+
}, {
|
|
38
|
+
interval: r.interval,
|
|
39
|
+
message: `waitForLiveRegion("${n}")`,
|
|
40
|
+
signal: r.signal,
|
|
41
|
+
timeout: r.timeout
|
|
42
|
+
}), o;
|
|
43
|
+
}
|
|
44
|
+
async function s(n = {}) {
|
|
45
|
+
let r = n.politeness ?? "polite";
|
|
46
|
+
await t(() => {
|
|
47
|
+
let t = i({
|
|
48
|
+
document: n.document,
|
|
49
|
+
politeness: r,
|
|
50
|
+
role: n.role,
|
|
51
|
+
root: n.root
|
|
52
|
+
});
|
|
53
|
+
if (!t) throw new e(`No ${r} live region found.`);
|
|
54
|
+
if (t.textContent !== "") throw new e(`Live region not cleared: "${t.textContent}".`);
|
|
55
|
+
}, {
|
|
56
|
+
interval: n.interval,
|
|
57
|
+
message: "waitForLiveRegionCleared",
|
|
58
|
+
signal: n.signal,
|
|
59
|
+
timeout: n.timeout
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
//#endregion
|
|
63
|
+
export { a as queryAllLiveRegions, i as queryLiveRegion, o as waitForLiveRegion, s as waitForLiveRegionCleared };
|
|
64
|
+
|
|
65
|
+
//# sourceMappingURL=live-region.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"live-region.js","names":[],"sources":["../src/live-region.ts"],"sourcesContent":["import { AssayQueryError } from './errors';\nimport { retry, type WaitOptions } from './wait';\n\n/** Politeness levels for ARIA live regions. */\nexport type LiveRegionPoliteness = 'assertive' | 'off' | 'polite';\n\n/**\n * ARIA roles that carry an implicit `aria-live` value per the WAI-ARIA spec.\n * `role=\"status\"` → `polite`, `role=\"alert\"` → `assertive`. Elements with these\n * roles are live regions even without an explicit `aria-live` attribute.\n */\nconst IMPLICIT_ROLE_POLITENESS: Record<string, LiveRegionPoliteness> = {\n alert: 'assertive',\n status: 'polite',\n};\n\nexport interface LiveRegionQueryOptions {\n /** The document to search. Defaults to the global `document`. */\n document?: Document;\n /** Politeness to match via `aria-live` (or implicit role). Defaults to `'polite'`. */\n politeness?: LiveRegionPoliteness;\n /** ARIA role to match (e.g. `'status'`, `'alert'`). Omit to match any role. */\n role?: string;\n /** Root to scope the query. Defaults to `document.body`. */\n root?: ParentNode;\n}\n\n/**\n * Resolves the effective politeness of an element: explicit `aria-live` wins,\n * otherwise falls back to the implicit value from `role=\"status\"`/`role=\"alert\"`.\n * Returns `null` when the element is not a live region.\n */\nfunction resolvePoliteness(el: HTMLElement): LiveRegionPoliteness | null {\n const explicit = el.getAttribute('aria-live');\n\n if (explicit) return explicit as LiveRegionPoliteness;\n\n const role = el.getAttribute('role');\n\n if (role && role in IMPLICIT_ROLE_POLITENESS) return IMPLICIT_ROLE_POLITENESS[role];\n\n return null;\n}\n\n/**\n * Queries the first live region matching the given politeness (and optional role)\n * within `root`. Returns `null` when none exists — safe to call before the region\n * has been lazily created.\n *\n * Matches both explicit `aria-live` attributes and implicit roles (`status` →\n * polite, `alert` → assertive) per the WAI-ARIA spec.\n *\n * @example\n * const region = queryLiveRegion({ politeness: 'polite' });\n * expect(region).not.toBeNull();\n */\nexport function queryLiveRegion(options: LiveRegionQueryOptions = {}): HTMLElement | null {\n const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n const politeness = options.politeness ?? 'polite';\n const root = options.root ?? doc?.body ?? null;\n\n if (!root) return null;\n\n const candidates = Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]'));\n\n for (const el of candidates) {\n if (resolvePoliteness(el) !== politeness) continue;\n\n if (options.role !== undefined && el.getAttribute('role') !== options.role) continue;\n\n return el;\n }\n\n return null;\n}\n\n/**\n * Queries all live regions matching the given politeness (and optional role)\n * within `root`. Useful for asserting no duplicate regions were created.\n *\n * @example\n * expect(queryAllLiveRegions({ politeness: 'polite' })).toHaveLength(1);\n */\nexport function queryAllLiveRegions(options: LiveRegionQueryOptions = {}): HTMLElement[] {\n const doc = options.document ?? (typeof document !== 'undefined' ? document : null);\n const politeness = options.politeness ?? 'polite';\n const root = options.root ?? doc?.body ?? null;\n\n if (!root) return [];\n\n return Array.from(root.querySelectorAll<HTMLElement>('[aria-live], [role=\"status\"], [role=\"alert\"]')).filter((el) => {\n if (resolvePoliteness(el) !== politeness) return false;\n\n if (options.role !== undefined && el.getAttribute('role') !== options.role) return false;\n\n return true;\n });\n}\n\nexport interface WaitForLiveRegionOptions extends WaitOptions {\n /** The document to search. Defaults to the global `document`. */\n document?: Document;\n /** Politeness to match via `aria-live`. Defaults to `'polite'`. */\n politeness?: LiveRegionPoliteness;\n /** ARIA role to match. Omit to match any role. */\n role?: string;\n /** Root to scope the query. Defaults to `document.body`. */\n root?: ParentNode;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and contains\n * `text` (substring match). Throws `AssayTimeoutError` on timeout.\n *\n * Handles the clear-then-set announce pattern: the region may briefly be empty\n * before the message is written, so polling until the text appears is the\n * correct approach rather than a single snapshot assertion.\n *\n * @example\n * await waitForLiveRegion({ text: '3 results found' });\n * await waitForLiveRegion({ politeness: 'assertive', text: 'Session expired' });\n */\nexport async function waitForLiveRegion(text: string, options: WaitForLiveRegionOptions = {}): Promise<HTMLElement> {\n const politeness = options.politeness ?? 'polite';\n let matched: HTMLElement | null = null;\n\n await retry(\n () => {\n const region = queryLiveRegion({\n document: options.document,\n politeness,\n role: options.role,\n root: options.root,\n });\n\n if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n if (!region.textContent?.includes(text)) {\n throw new AssayQueryError(`Live region text \"${region.textContent}\" does not include \"${text}\".`);\n }\n\n matched = region;\n },\n {\n interval: options.interval,\n message: `waitForLiveRegion(\"${text}\")`,\n signal: options.signal,\n timeout: options.timeout,\n },\n );\n\n // `retry` only resolves once the assertion stops throwing, so `matched` is set.\n return matched!;\n}\n\n/**\n * Retries until a live region matching the politeness/role exists and is empty\n * (cleared). Throws `AssayTimeoutError` on timeout.\n *\n * @example\n * await waitForLiveRegionCleared();\n */\nexport async function waitForLiveRegionCleared(options: WaitForLiveRegionOptions = {}): Promise<void> {\n const politeness = options.politeness ?? 'polite';\n\n await retry(\n () => {\n const region = queryLiveRegion({\n document: options.document,\n politeness,\n role: options.role,\n root: options.root,\n });\n\n if (!region) throw new AssayQueryError(`No ${politeness} live region found.`);\n\n if (region.textContent !== '') {\n throw new AssayQueryError(`Live region not cleared: \"${region.textContent}\".`);\n }\n },\n {\n interval: options.interval,\n message: 'waitForLiveRegionCleared',\n signal: options.signal,\n timeout: options.timeout,\n },\n );\n}\n"],"mappings":";;;AAWA,IAAM,IAAiE;CACrE,OAAO;CACP,QAAQ;AACV;AAkBA,SAAS,EAAkB,GAA8C;CACvE,IAAM,IAAW,EAAG,aAAa,WAAW;CAE5C,IAAI,GAAU,OAAO;CAErB,IAAM,IAAO,EAAG,aAAa,MAAM;CAInC,OAFI,KAAQ,KAAQ,IAAiC,EAAyB,KAEvE;AACT;AAcA,SAAgB,EAAgB,IAAkC,CAAC,GAAuB;CACxF,IAAM,IAAM,EAAQ,aAAa,OAAO,WAAa,MAAc,WAAW,OACxE,IAAa,EAAQ,cAAc,UACnC,IAAO,EAAQ,QAAQ,GAAK,QAAQ;CAE1C,IAAI,CAAC,GAAM,OAAO;CAElB,IAAM,IAAa,MAAM,KAAK,EAAK,iBAA8B,kDAA8C,CAAC;CAEhH,KAAK,IAAM,KAAM,GACX,MAAkB,CAAE,MAAM,MAE1B,EAAQ,SAAS,KAAA,KAAa,EAAG,aAAa,MAAM,MAAM,EAAQ,OAEtE,OAAO;CAGT,OAAO;AACT;AASA,SAAgB,EAAoB,IAAkC,CAAC,GAAkB;CACvF,IAAM,IAAM,EAAQ,aAAa,OAAO,WAAa,MAAc,WAAW,OACxE,IAAa,EAAQ,cAAc,UACnC,IAAO,EAAQ,QAAQ,GAAK,QAAQ;CAI1C,OAFK,IAEE,MAAM,KAAK,EAAK,iBAA8B,kDAA8C,CAAC,CAAC,CAAC,QAAQ,MAG5G,EAFI,EAAkB,CAAE,MAAM,KAE1B,EAAQ,SAAS,KAAA,KAAa,EAAG,aAAa,MAAM,MAAM,EAAQ,KAGvE,IARiB,CAAC;AASrB;AAyBA,eAAsB,EAAkB,GAAc,IAAoC,CAAC,GAAyB;CAClH,IAAM,IAAa,EAAQ,cAAc,UACrC,IAA8B;CA4BlC,OA1BA,MAAM,QACE;EACJ,IAAM,IAAS,EAAgB;GAC7B,UAAU,EAAQ;GAClB;GACA,MAAM,EAAQ;GACd,MAAM,EAAQ;EAChB,CAAC;EAED,IAAI,CAAC,GAAQ,MAAM,IAAI,EAAgB,MAAM,EAAW,oBAAoB;EAE5E,IAAI,CAAC,EAAO,aAAa,SAAS,CAAI,GACpC,MAAM,IAAI,EAAgB,qBAAqB,EAAO,YAAY,sBAAsB,EAAK,GAAG;EAGlG,IAAU;CACZ,GACA;EACE,UAAU,EAAQ;EAClB,SAAS,sBAAsB,EAAK;EACpC,QAAQ,EAAQ;EAChB,SAAS,EAAQ;CACnB,CACF,GAGO;AACT;AASA,eAAsB,EAAyB,IAAoC,CAAC,GAAkB;CACpG,IAAM,IAAa,EAAQ,cAAc;CAEzC,MAAM,QACE;EACJ,IAAM,IAAS,EAAgB;GAC7B,UAAU,EAAQ;GAClB;GACA,MAAM,EAAQ;GACd,MAAM,EAAQ;EAChB,CAAC;EAED,IAAI,CAAC,GAAQ,MAAM,IAAI,EAAgB,MAAM,EAAW,oBAAoB;EAE5E,IAAI,EAAO,gBAAgB,IACzB,MAAM,IAAI,EAAgB,6BAA6B,EAAO,YAAY,GAAG;CAEjF,GACA;EACE,UAAU,EAAQ;EAClB,SAAS;EACT,QAAQ,EAAQ;EAChB,SAAS,EAAQ;CACnB,CACF;AACF"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vielzeug/assay",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.2.0",
|
|
4
4
|
"description": "Framework-agnostic DOM testing primitives — scoped queries, event dispatch, and async waiting",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -24,6 +24,7 @@
|
|
|
24
24
|
"types": "./dist/index.d.ts"
|
|
25
25
|
}
|
|
26
26
|
},
|
|
27
|
+
"sideEffects": false,
|
|
27
28
|
"publishConfig": {
|
|
28
29
|
"access": "public",
|
|
29
30
|
"registry": "https://registry.npmjs.org/"
|