@reticlehq/browser 3.7.0 → 3.8.0

package/dist/actions/action-report.d.ts

@@ -13,9 +13,14 @@ export interface ActionEffect {
     occluded: boolean;
     occludedBy: string | null;
     scrolledIntoView: boolean;
+    occluderName?: string;
+    noSize?: true;
+    offViewport?: true;
     heldMs?: number;
     alreadyAtValue?: true;
+    canvases?: number;
 }
+export declare function visibleCanvases(doc: Document): number;
 export interface ActionResult {
     ok: true;
     ref: string;
@@ -25,6 +30,7 @@ export interface ActionResult {
     settleReason: SettleReason | null;
     effect: ActionEffect;
     testid?: string;
+    testidOf?: number;
     component?: string;
     role?: string;
     name?: string;
@@ -35,10 +41,13 @@ export interface ActionResult {
         line: number;
         column?: number;
     };
+    secret?: true;
     warning?: string;
+    reticleUi?: true;
 }
 export interface CapturedAnchor {
     testid?: string;
+    testidOf?: number;
     component?: string;
     source?: {
         file: string;
@@ -49,6 +58,7 @@ export interface CapturedAnchor {
     name?: string;
     nth?: number;
     of?: number;
+    secret?: true;
 }
 export declare function anchorOf(el: Element): CapturedAnchor;
 export declare const result: (ref: string, action: string, effect: ActionEffect, settled: boolean, settleReason: SettleReason | null, anchor: CapturedAnchor, warning?: string) => ActionResult;

package/dist/actions/action-report.js

@@ -1,14 +1,35 @@
 import { readTestId } from '../dom/addressing/testid-attr.js';
 import { QueryBy } from '@reticlehq/core';
 import { elementsMatching } from '../dom/query.js';
-import { getAccessibleName, getRole } from '../dom/a11y.js';
+import { getAccessibleName, getRole, isSensitiveField } from '../dom/a11y.js';
 import { identifyComponent } from '../registry/stores/adapters.js';
+import { isReticleUi } from '../dom/dom-ignore.js';
+const CANVAS_SELECTOR = 'canvas';
+export function visibleCanvases(doc) {
+    const width = doc.defaultView?.innerWidth ?? 0;
+    const height = doc.defaultView?.innerHeight ?? 0;
+    let count = 0;
+    for (const canvas of doc.querySelectorAll(CANVAS_SELECTOR)) {
+        if (isReticleUi(canvas))
+            continue;
+        const box = canvas.getBoundingClientRect();
+        const sized = box.width > 0 && box.height > 0;
+        const onScreen = box.bottom > 0 && box.right > 0 && box.top < height && box.left < width;
+        if (sized && onScreen)
+            count += 1;
+    }
+    return count;
+}
 export function anchorOf(el) {
     const testid = readTestId(el) ?? undefined;
     const info = identifyComponent(el);
     const out = {};
-    if (testid !== undefined)
+    if (testid !== undefined) {
         out.testid = testid;
+        const shared = elementsMatching({ by: QueryBy.TESTID, value: testid }).length;
+        if (1 < shared)
+            out.testidOf = shared;
+    }
     const component = info?.componentStack[0];
     if (component !== undefined)
         out.component = component;
@@ -20,6 +41,8 @@ export function anchorOf(el) {
         out.role = role;
     if (name.length > 0)
         out.name = name;
+    if (isSensitiveField(el))
+        out.secret = true;
     if (role.length > 0 && name.length > 0) {
         const same = elementsMatching({ by: QueryBy.ROLE, value: role, name });
         const at = same.indexOf(el);
@@ -42,6 +65,8 @@ export const result = (ref, action, effect, settled, settleReason, anchor, warni
     };
     if (anchor.testid !== undefined)
         base.testid = anchor.testid;
+    if (anchor.testidOf !== undefined)
+        base.testidOf = anchor.testidOf;
     if (anchor.component !== undefined)
         base.component = anchor.component;
     if (anchor.source !== undefined)
@@ -54,6 +79,8 @@ export const result = (ref, action, effect, settled, settleReason, anchor, warni
         base.nth = anchor.nth;
     if (anchor.of !== undefined)
         base.of = anchor.of;
+    if (anchor.secret !== undefined)
+        base.secret = anchor.secret;
     if (warning !== undefined)
         base.warning = warning;
     return base;

package/dist/actions/actions-dom.d.ts

@@ -3,6 +3,9 @@ interface ClickGeometry {
     occluded: boolean;
     occludedBy: string | null;
     scrolledIntoView: boolean;
+    occluderName?: string;
+    noSize?: true;
+    offViewport?: true;
 }
 export declare const NO_GEOMETRY: ClickGeometry;
 export declare function mouseEventFor(el: Element, type: string, init?: MouseEventInit): MouseEvent;
@@ -14,6 +17,7 @@ export declare function fireClickSequence(el: ActionTarget, hold?: {
     prevented: boolean;
     heldMs: number;
 }>;
+export declare function isOffViewport(el: Element, rect: DOMRect): boolean;
 export declare function clickGeometry(el: ActionTarget): ClickGeometry;
 export declare function firePointer(el: Element, type: string, relatedTarget?: EventTarget | null): void;
 export declare function firePointerNonBubbling(el: Element, type: string, relatedTarget?: EventTarget | null): void;

package/dist/actions/actions-dom.js

@@ -1,4 +1,6 @@
 import { refs } from '../dom/addressing/refs.js';
+import { readTestId } from '../dom/addressing/testid-attr.js';
+import { getAccessibleName, getRole } from '../dom/a11y.js';
 import { hitTestOccluder } from '../dom/occlusion.js';
 import { nativeFrame } from '../timers/native/native-timers.js';
 import { asSyntheticInput } from './synthetic/synthetic-input.js';
@@ -58,7 +60,7 @@ export async function fireClickSequence(el, hold, detail) {
 function isMeasurable(rect) {
     return rect.width > 0 || rect.height > 0;
 }
-function isOffViewport(el, rect) {
+export function isOffViewport(el, rect) {
     const win = el.ownerDocument.defaultView;
     if (null === win)
         return false;
@@ -70,21 +72,35 @@ function hitTest(el, rect) {
     const top = hitTestOccluder(el, rect);
     return null === top
         ? { occluded: false, occludedBy: null }
-        : { occluded: true, occludedBy: refs.refFor(top) };
+        : { occluded: true, occludedBy: refs.refFor(top), occluderName: nameOf(top) };
+}
+function nameOf(el) {
+    const testid = readTestId(el);
+    if (testid !== null && testid.length > 0)
+        return `[data-testid="${testid}"]`;
+    const name = getAccessibleName(el).trim();
+    return name.length > 0 ? `${getRole(el)} "${name.slice(0, 40)}"` : el.tagName.toLowerCase();
+}
+function hasNoSize(el) {
+    if (typeof el.getClientRects !== 'function')
+        return false;
+    const rects = Array.from(el.getClientRects());
+    return rects.length > 0 && rects.every((r) => 0 === r.width || 0 === r.height);
 }
 export function clickGeometry(el) {
     if (typeof el.getBoundingClientRect !== 'function')
         return NO_GEOMETRY;
     let rect = el.getBoundingClientRect();
     if (!isMeasurable(rect))
-        return NO_GEOMETRY;
+        return hasNoSize(el) ? { ...NO_GEOMETRY, noSize: true } : NO_GEOMETRY;
     let scrolledIntoView = false;
     if (isOffViewport(el, rect) && 'function' === typeof el.scrollIntoView) {
         el.scrollIntoView({ block: 'center', inline: 'center' });
         scrolledIntoView = true;
         rect = el.getBoundingClientRect();
     }
-    return { ...hitTest(el, rect), scrolledIntoView };
+    const stillOff = scrolledIntoView && isOffViewport(el, rect);
+    return { ...hitTest(el, rect), scrolledIntoView, ...(stillOff ? { offViewport: true } : {}) };
 }
 export function firePointer(el, type, relatedTarget = null) {
     asSyntheticInput(() => el.dispatchEvent(pointerEventFor(el, type, { bubbles: true, cancelable: true, relatedTarget })));

package/dist/actions/actions.d.ts

@@ -22,6 +22,7 @@ interface SequenceStepResult {
         line: number;
         column?: number;
     };
+    secret?: true;
     warning?: string;
 }
 export declare function executeSequence(steps: ActionStep[]): Promise<{

package/dist/actions/actions.js

@@ -1,16 +1,19 @@
 import { ActionType, ActionWarning, clampHoldMs, DANGEROUS_ACTION_CONFIRM_ARG, ElementState, NATIVE_INPUT_ARG, SettleReason, } from '@reticlehq/core';
+import { isHiddenNativeOption } from '../dom/query.js';
+import { isReticleUi } from '../dom/dom-ignore.js';
 import { asSyntheticInput } from './synthetic/synthetic-input.js';
 import { echoRef, refs } from '../dom/addressing/refs.js';
-import { dangerousActionContext, requiresDangerousConfirmation, assertOutwardAllowed, submitControlFor, } from './danger-context.js';
+import { requiresDangerousConfirmation, assertOutwardAllowed, assertPaymentEntryAllowed, submitControlFor, } from './danger-context.js';
 import { assertEditable, assertNotRichText, isAutofillSafeTarget, setNativeValue, } from './value-input.js';
-import { getRole, isVisible, getStates } from '../dom/a11y.js';
+import { isVisible, getStates } from '../dom/a11y.js';
 import { elementHasHoverHandlers } from '../registry/stores/adapters.js';
 import { isActionTarget, isForm, isInput, isSelect, isTextArea, } from '../dom/realm.js';
-import { nativeSetTimeout, settle } from '../timers/native/native-timers.js';
+import { asSettleBudget, nativeSetTimeout, settle } from '../timers/native/native-timers.js';
+import { publishSettledField, watchActedField } from '../observers/field.js';
 import { AppearedText } from './appeared-text.js';
 import { alreadyAtCheckedState, assertAriaToggleLanded, isAriaToggle } from './check-state.js';
 import { focusedOrDocument, isReflessDocumentPress, pressCode, pressKey, pressModifiers, pressKeys, holdKey, pressCombo, dispatchKeypress, closeModalOnEscape, keyboardEvent, } from './actions-press.js';
-import { anchorOf, result } from './action-report.js';
+import { anchorOf, result, visibleCanvases, } from './action-report.js';
 function asString(value, fallback = '') {
     return 'string' === typeof value ? value : fallback;
 }
@@ -69,16 +72,19 @@ function assertActionAllowed(el, action, args) {
     const submitter = action === ActionType.PRESS && 'Enter' === pressKey(args) ? submitControlFor(el) : null;
     if (canTrigger)
         assertOutwardAllowed([el, submitter, isActionTarget(dragTarget) ? dragTarget : null]);
-    const sourceDangerous = requiresDangerousConfirmation(dangerousActionContext(el), getRole(el)) ||
-        (submitter !== null &&
-            requiresDangerousConfirmation(dangerousActionContext(submitter), getRole(submitter)));
-    const targetDangerous = isActionTarget(dragTarget) &&
-        requiresDangerousConfirmation(dangerousActionContext(dragTarget), getRole(dragTarget));
+    if (action === ActionType.FILL || action === ActionType.TYPE)
+        assertPaymentEntryAllowed(el);
+    const sourceDangerous = requiresDangerousConfirmation(el) ||
+        (submitter !== null && requiresDangerousConfirmation(submitter));
+    const targetDangerous = isActionTarget(dragTarget) && requiresDangerousConfirmation(dragTarget);
     if (canTrigger &&
         (sourceDangerous || targetDangerous) &&
         args[DANGEROUS_ACTION_CONFIRM_ARG] !== true) {
         throw new Error(`potentially destructive action blocked; retry with args.${DANGEROUS_ACTION_CONFIRM_ARG}=true`);
     }
+    if (CLICK_LIKE.has(action) && el instanceof HTMLElement && isHiddenNativeOption(el)) {
+        throw new Error('cannot click a native <option> inside a visually-hidden <select> — open the dropdown and target the visible option');
+    }
 }
 function optionValueFor(options, named) {
     if (options.some((option) => option.value === named))
@@ -88,6 +94,7 @@ function optionValueFor(options, named) {
 }
 import { NO_GEOMETRY, fireClickSequence, fireTapSequence, clickGeometry, firePointer, firePointerNonBubbling, dragElement, mouseEventFor, assertNotLeaving, } from './actions-dom.js';
 import { scrollFrom } from './scroll.js';
+import { clickHitsNoControl } from './click-target.js';
 function enabledOf(el) {
     return !getStates(el).includes(ElementState.DISABLED);
 }
@@ -299,12 +306,6 @@ async function dispatchOther(el, action, args) {
             throw new Error(`unknown action '${action}'`);
     }
 }
-function asSettleBudget(raw) {
-    if ('number' !== typeof raw || !Number.isFinite(raw))
-        return undefined;
-    return Math.max(0, Math.min(raw, FRAME_BUDGET_MS_CEILING));
-}
-const FRAME_BUDGET_MS_CEILING = 200;
 export async function executeAction(ref, action, args = {}) {
     const named = 0 < ref.length;
     const el = isReflessDocumentPress(ref, action, args) ? focusedOrDocument() : requireElement(ref);
@@ -317,8 +318,10 @@ export async function executeAction(ref, action, args = {}) {
     const enabled = enabledOf(el);
     const prevFocus = activeRef(el);
     const valueBefore = valueOf(el);
+    const actedField = watchActedField(el);
     const geometry = CLICK_LIKE.has(action) ? clickGeometry(el) : NO_GEOMETRY;
     const alreadyAtValue = alreadyAtCheckedState(el, action);
+    const hitsNoControl = clickHitsNoControl(el, action);
     let mutated = 0;
     const said = new AppearedText();
     const obs = new MutationObserver((records) => {
@@ -346,9 +349,11 @@ export async function executeAction(ref, action, args = {}) {
         settled = outcome.settled;
         settleReason = outcome.settled ? null : SettleReason.TIMEOUT;
         obs.disconnect();
+        actedField?.stop();
     }
     assertAriaToggleLanded(el, action, alreadyAtValue);
     const valueAfter = valueOf(el);
+    publishSettledField(el, actedField);
     const nextFocus = activeRef(el);
     const effect = {
         dispatched: true,
@@ -364,8 +369,12 @@ export async function executeAction(ref, action, args = {}) {
         occluded: geometry.occluded,
         occludedBy: geometry.occludedBy,
         scrolledIntoView: geometry.scrolledIntoView,
+        ...(geometry.occluderName === undefined ? {} : { occluderName: geometry.occluderName }),
+        ...(true === geometry.noSize ? { noSize: true } : {}),
+        ...(true === geometry.offViewport ? { offViewport: true } : {}),
         ...(heldMs > 0 ? { heldMs } : {}),
         ...(alreadyAtValue ? { alreadyAtValue: true } : {}),
+        ...canvasesOnScreen(),
     };
     const warning = !named
         ? ActionWarning.GLOBAL_PRESS
@@ -373,8 +382,15 @@ export async function executeAction(ref, action, args = {}) {
             ? ActionWarning.CLICK_OCCLUDED
             : action === ActionType.HOVER && elementHasHoverHandlers(el)
                 ? ActionWarning.HOVER_NATIVE_ENTER_LEAVE
-                : undefined;
-    return result(ref, action, effect, settled, settleReason, anchor, warning);
+                : hitsNoControl
+                    ? ActionWarning.CLICK_NOT_A_CONTROL
+                    : undefined;
+    const done = result(ref, action, effect, settled, settleReason, anchor, warning);
+    return isReticleUi(el) ? { ...done, reticleUi: true } : done;
+}
+function canvasesOnScreen() {
+    const canvases = visibleCanvases(document);
+    return canvases > 0 ? { canvases } : {};
 }
 const sleep = (ms) => new Promise((r) => nativeSetTimeout(r, ms));
 export async function executeSequence(steps) {
@@ -400,6 +416,8 @@ export async function executeSequence(steps) {
             stepBase.name = res.name;
         if (res.source !== undefined)
             stepBase.source = res.source;
+        if (res.secret !== undefined)
+            stepBase.secret = res.secret;
         if (res.warning !== undefined)
             stepBase.warning = res.warning;
         stepResults.push(stepBase);

package/dist/actions/appeared-text.js

@@ -1,4 +1,4 @@
-import { isIgnored } from '../dom/dom-ignore.js';
+import { isWordsIgnored } from '../dom/dom-ignore.js';
 import { isSensitiveField } from '../dom/a11y.js';
 const APPEARED_MAX = 200;
 const JOIN = ' | ';
@@ -45,7 +45,7 @@ export class AppearedText {
         return this.#length > APPEARED_MAX;
     }
     #add(raw, owner) {
-        if (null !== owner && isIgnored(owner))
+        if (null !== owner && isWordsIgnored(owner))
             return;
         if (null !== owner && isSensitiveField(owner))
             return;

package/dist/actions/click-target.d.ts

@@ -0,0 +1 @@
+export declare function clickHitsNoControl(el: Element, action: string): boolean;

package/dist/actions/click-target.js

@@ -0,0 +1,14 @@
+import { ActionType } from '@reticlehq/core';
+import { getRole } from '../dom/a11y.js';
+import { parentAcrossShadowBoundary } from '../dom/shadow-registry.js';
+import { INTERACTIVE } from '../dom/snapshot.js';
+const CLICK_FORWARDING = 'label, summary, [onclick], [tabindex], [contenteditable]:not([contenteditable="false"])';
+export function clickHitsNoControl(el, action) {
+    if (ActionType.CLICK !== action && ActionType.DBLCLICK !== action)
+        return false;
+    for (let node = el; node !== null; node = parentAcrossShadowBoundary(node)) {
+        if (INTERACTIVE.has(getRole(node)) || node.matches(CLICK_FORWARDING))
+            return false;
+    }
+    return 'pointer' !== getComputedStyle(el).cursor;
+}

package/dist/actions/danger-context.d.ts

@@ -1,6 +1,7 @@
 import { type ActionTarget } from '../dom/realm.js';
 export declare function dangerousActionContext(el: ActionTarget): string;
 export declare function submitControlFor(el: ActionTarget): HTMLElement | null;
-export declare function requiresDangerousConfirmation(text: string, role?: string): boolean;
+export declare function requiresDangerousConfirmation(el: ActionTarget): boolean;
 export declare function setOutwardPolicy(allowed: readonly string[] | undefined): void;
 export declare function assertOutwardAllowed(targets: readonly (ActionTarget | null)[]): void;
+export declare function assertPaymentEntryAllowed(el: ActionTarget): void;

package/dist/actions/danger-context.js

@@ -1,4 +1,4 @@
-import { isDangerousActionText, outwardActionOf, outwardRefusal } from '@reticlehq/core';
+import { OutwardAction, isDangerousActionText, isInertHref, isDangerousNavigation, isPaymentField, outwardActionOf, outwardRefusal, } from '@reticlehq/core';
 import { getAccessibleName, getRole } from '../dom/a11y.js';
 import { isHtmlElement } from '../dom/realm.js';
 const LABEL_VALUED_INPUT_TYPES = new Set([
@@ -17,12 +17,11 @@ function holdsUserText(el) {
     return false;
 }
 const ANCHOR_TAG = 'A';
-const INERT_HREF = /^\s*(#.*|javascript:.*)?$/i;
 function navigatingHref(el) {
     if (ANCHOR_TAG !== el.tagName)
         return undefined;
     const href = el.getAttribute('href');
-    return null === href || INERT_HREF.test(href) ? undefined : href;
+    return null === href || isInertHref(href) ? undefined : href;
 }
 export function dangerousActionContext(el) {
     const href = navigatingHref(el);
@@ -46,8 +45,11 @@ export function submitControlFor(el) {
     const found = el.closest('form')?.querySelector(SUBMIT_CONTROL_SELECTOR);
     return isHtmlElement(found) ? found : null;
 }
-export function requiresDangerousConfirmation(text, role) {
-    return isDangerousActionText(text, role);
+export function requiresDangerousConfirmation(el) {
+    const href = navigatingHref(el);
+    if (href !== undefined)
+        return isDangerousNavigation(href);
+    return isDangerousActionText(dangerousActionContext(el), getRole(el));
 }
 let outwardAllowed;
 export function setOutwardPolicy(allowed) {
@@ -64,3 +66,16 @@ export function assertOutwardAllowed(targets) {
             throw new Error(outwardRefusal(kind));
     }
 }
+export function assertPaymentEntryAllowed(el) {
+    if (outwardAllowed === undefined || outwardAllowed.includes(OutwardAction.PAY))
+        return;
+    const facts = {
+        autocomplete: el.getAttribute('autocomplete') ?? undefined,
+        name: el.getAttribute('name') ?? undefined,
+        id: el.getAttribute('id') ?? undefined,
+        inputMode: el.getAttribute('inputmode') ?? undefined,
+        label: `${getAccessibleName(el)} ${el.getAttribute('placeholder') ?? ''}`,
+    };
+    if (isPaymentField(facts))
+        throw new Error(outwardRefusal(OutwardAction.PAY));
+}

package/dist/activate.d.ts

@@ -0,0 +1,14 @@
+import type { ReticleConnectOptions } from './connect-options.js';
+export interface ActivateOptions {
+    publicKey: string;
+}
+export interface ActivateHost {
+    location: Pick<Location, 'href' | 'origin'>;
+    history: Pick<History, 'replaceState' | 'state'>;
+    now: () => number;
+    connect: () => Promise<{
+        connect: (options: ReticleConnectOptions) => void;
+    }>;
+    warn: (message: string) => void;
+}
+export declare function activate(options: ActivateOptions, host?: ActivateHost | undefined): Promise<boolean>;

package/dist/activate.js

@@ -0,0 +1,43 @@
+import { HelloEnv, PRODUCTION_ACTIVATE_PARAM, verifyActivationTicket, } from '@reticlehq/core/activation';
+const REFUSED_PREFIX = '[Reticle] activation refused: ';
+function pageHost() {
+    if ('undefined' === typeof location || 'undefined' === typeof history)
+        return undefined;
+    return {
+        location,
+        history,
+        now: () => Date.now(),
+        connect: () => import('./reticle-singleton.js').then((sdk) => sdk.reticle),
+        warn: (message) => console.warn(message),
+    };
+}
+export async function activate(options, host = pageHost()) {
+    if (host === undefined)
+        return false;
+    const url = new URL(host.location.href);
+    const ticket = url.searchParams.get(PRODUCTION_ACTIVATE_PARAM);
+    if (null === ticket)
+        return false;
+    url.searchParams.delete(PRODUCTION_ACTIVATE_PARAM);
+    host.history.replaceState(host.history.state, '', url.toString());
+    const verdict = await verifyActivationTicket(ticket, {
+        publicKey: options.publicKey,
+        origin: host.location.origin,
+        now: host.now(),
+    });
+    if (!verdict.ok) {
+        host.warn(`${REFUSED_PREFIX}${verdict.reason}`);
+        return false;
+    }
+    const { payload } = verdict;
+    const sdk = await host.connect();
+    sdk.connect({
+        url: payload.bridge,
+        token: payload.nonce,
+        env: HelloEnv.PRODUCTION,
+        scope: payload.scope,
+        allowInProduction: true,
+        allowNonLocalhost: true,
+    });
+    return true;
+}

package/dist/busy.d.ts

@@ -0,0 +1,3 @@
+export declare function trackBusy<T>(work: Promise<T>, signal: (name: string, data: Record<string, unknown>) => void): Promise<T>;
+export declare const SHORT_TIMER_MS = 1000;
+export declare function trackShortTimers(signal: (name: string, data: Record<string, unknown>) => void, maxMs?: number): () => void;

package/dist/busy.js

@@ -0,0 +1,42 @@
+import { RETICLE_BUSY_SIGNAL } from '@reticlehq/core';
+import { captureMethod } from './patching/capture-method.js';
+export function trackBusy(work, signal) {
+    signal(RETICLE_BUSY_SIGNAL, { delta: 1 });
+    const done = () => {
+        signal(RETICLE_BUSY_SIGNAL, { delta: -1 });
+    };
+    work.then(done, done);
+    return work;
+}
+export const SHORT_TIMER_MS = 1000;
+export function trackShortTimers(signal, maxMs = SHORT_TIMER_MS) {
+    const realSet = captureMethod(window, 'setTimeout');
+    const realClear = captureMethod(window, 'clearTimeout');
+    const callSet = realSet.bind(window);
+    const callClear = realClear.bind(window);
+    const pending = new Set();
+    const end = (id) => {
+        if (pending.delete(id))
+            signal(RETICLE_BUSY_SIGNAL, { delta: -1 });
+    };
+    window.setTimeout = ((cb, delay = 0, ...args) => {
+        if ('function' !== typeof cb || delay > maxMs)
+            return Reflect.apply(realSet, window, [cb, delay, ...args]);
+        signal(RETICLE_BUSY_SIGNAL, { delta: 1 });
+        const id = callSet(() => {
+            end(id);
+            cb(...args);
+        }, delay);
+        pending.add(id);
+        return id;
+    });
+    window.clearTimeout = ((id) => {
+        if (id !== undefined)
+            end(id);
+        callClear(id);
+    });
+    return () => {
+        window.setTimeout = realSet;
+        window.clearTimeout = realClear;
+    };
+}