@depup/testing-library__user-event 14.6.3-depup.0

package/dist/cjs/utils/misc/isDisabled.js

@@ -0,0 +1,33 @@
+'use strict';
+
+var isElementType = require('./isElementType.js');
+
+// This should probably just rely on the :disabled pseudo-class, but JSDOM doesn't implement it properly.
+function isDisabled(element) {
+    for(let el = element; el; el = el.parentElement){
+        if (isElementType.isElementType(el, [
+            'button',
+            'input',
+            'select',
+            'textarea',
+            'optgroup',
+            'option'
+        ])) {
+            if (el.hasAttribute('disabled')) {
+                return true;
+            }
+        } else if (isElementType.isElementType(el, 'fieldset')) {
+            var _el_querySelector;
+            if (el.hasAttribute('disabled') && !((_el_querySelector = el.querySelector(':scope > legend')) === null || _el_querySelector === void 0 ? void 0 : _el_querySelector.contains(element))) {
+                return true;
+            }
+        } else if (el.tagName.includes('-')) {
+            if (el.constructor.formAssociated && el.hasAttribute('disabled')) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+
+exports.isDisabled = isDisabled;

package/dist/cjs/utils/misc/isElementType.js

@@ -0,0 +1,20 @@
+'use strict';
+
+function isElementType(element, tag, props) {
+    if (element.namespaceURI && element.namespaceURI !== 'http://www.w3.org/1999/xhtml') {
+        return false;
+    }
+    tag = Array.isArray(tag) ? tag : [
+        tag
+    ];
+    // tagName is uppercase in HTMLDocument and lowercase in XMLDocument
+    if (!tag.includes(element.tagName.toLowerCase())) {
+        return false;
+    }
+    if (props) {
+        return Object.entries(props).every(([k, v])=>element[k] === v);
+    }
+    return true;
+}
+
+exports.isElementType = isElementType;

package/dist/cjs/utils/misc/isVisible.js

@@ -0,0 +1,19 @@
+'use strict';
+
+var getWindow = require('./getWindow.js');
+
+function isVisible(element) {
+    const window = getWindow.getWindow(element);
+    for(let el = element; el === null || el === void 0 ? void 0 : el.ownerDocument; el = el.parentElement){
+        const { display, visibility } = window.getComputedStyle(el);
+        if (display === 'none') {
+            return false;
+        }
+        if (visibility === 'hidden') {
+            return false;
+        }
+    }
+    return true;
+}
+
+exports.isVisible = isVisible;

package/dist/cjs/utils/misc/level.js

@@ -0,0 +1,17 @@
+'use strict';
+
+var ApiLevel = /*#__PURE__*/ function(ApiLevel) {
+    ApiLevel[ApiLevel["Trigger"] = 2] = "Trigger";
+    ApiLevel[ApiLevel["Call"] = 1] = "Call";
+    return ApiLevel;
+}({});
+function setLevelRef(instance, level) {
+    instance.levelRefs[level] = {};
+}
+function getLevelRef(instance, level) {
+    return instance.levelRefs[level];
+}
+
+exports.ApiLevel = ApiLevel;
+exports.getLevelRef = getLevelRef;
+exports.setLevelRef = setLevelRef;

package/dist/cjs/utils/misc/wait.js

@@ -0,0 +1,14 @@
+'use strict';
+
+function wait(config) {
+    const delay = config.delay;
+    if (typeof delay !== 'number') {
+        return;
+    }
+    return Promise.all([
+        new Promise((resolve)=>globalThis.setTimeout(()=>resolve(), delay)),
+        config.advanceTimers(delay)
+    ]);
+}
+
+exports.wait = wait;

package/dist/cjs/utils/pointer/cssPointerEvents.js

@@ -0,0 +1,102 @@
+'use strict';
+
+var options = require('../../options.js');
+var getWindow = require('../misc/getWindow.js');
+var isElementType = require('../misc/isElementType.js');
+var level = require('../misc/level.js');
+
+function hasPointerEvents(instance, element) {
+    var _checkPointerEvents;
+    return ((_checkPointerEvents = checkPointerEvents(instance, element)) === null || _checkPointerEvents === void 0 ? void 0 : _checkPointerEvents.pointerEvents) !== 'none';
+}
+function closestPointerEventsDeclaration(element) {
+    const window = getWindow.getWindow(element);
+    for(let el = element, tree = []; el === null || el === void 0 ? void 0 : el.ownerDocument; el = el.parentElement){
+        tree.push(el);
+        const pointerEvents = window.getComputedStyle(el).pointerEvents;
+        if (pointerEvents && ![
+            'inherit',
+            'unset'
+        ].includes(pointerEvents)) {
+            return {
+                pointerEvents,
+                tree
+            };
+        }
+    }
+    return undefined;
+}
+const PointerEventsCheck = Symbol('Last check for pointer-events');
+function checkPointerEvents(instance, element) {
+    const lastCheck = element[PointerEventsCheck];
+    const needsCheck = instance.config.pointerEventsCheck !== options.PointerEventsCheckLevel.Never && (!lastCheck || hasBitFlag(instance.config.pointerEventsCheck, options.PointerEventsCheckLevel.EachApiCall) && lastCheck[level.ApiLevel.Call] !== level.getLevelRef(instance, level.ApiLevel.Call) || hasBitFlag(instance.config.pointerEventsCheck, options.PointerEventsCheckLevel.EachTrigger) && lastCheck[level.ApiLevel.Trigger] !== level.getLevelRef(instance, level.ApiLevel.Trigger));
+    if (!needsCheck) {
+        return lastCheck === null || lastCheck === void 0 ? void 0 : lastCheck.result;
+    }
+    const declaration = closestPointerEventsDeclaration(element);
+    element[PointerEventsCheck] = {
+        [level.ApiLevel.Call]: level.getLevelRef(instance, level.ApiLevel.Call),
+        [level.ApiLevel.Trigger]: level.getLevelRef(instance, level.ApiLevel.Trigger),
+        result: declaration
+    };
+    return declaration;
+}
+function assertPointerEvents(instance, element) {
+    const declaration = checkPointerEvents(instance, element);
+    if ((declaration === null || declaration === void 0 ? void 0 : declaration.pointerEvents) === 'none') {
+        throw new Error([
+            `Unable to perform pointer interaction as the element ${declaration.tree.length > 1 ? 'inherits' : 'has'} \`pointer-events: none\`:`,
+            '',
+            printTree(declaration.tree)
+        ].join('\n'));
+    }
+}
+function printTree(tree) {
+    return tree.reverse().map((el, i)=>[
+            ''.padEnd(i),
+            el.tagName,
+            el.id && `#${el.id}`,
+            el.hasAttribute('data-testid') && `(testId=${el.getAttribute('data-testid')})`,
+            getLabelDescr(el),
+            tree.length > 1 && i === 0 && '  <-- This element declared `pointer-events: none`',
+            tree.length > 1 && i === tree.length - 1 && '  <-- Asserted pointer events here'
+        ].filter(Boolean).join('')).join('\n');
+}
+function getLabelDescr(element) {
+    var _element_labels;
+    let label;
+    if (element.hasAttribute('aria-label')) {
+        label = element.getAttribute('aria-label');
+    } else if (element.hasAttribute('aria-labelledby')) {
+        var _element_ownerDocument_getElementById_textContent, _element_ownerDocument_getElementById;
+        label = (_element_ownerDocument_getElementById = element.ownerDocument.getElementById(element.getAttribute('aria-labelledby'))) === null || _element_ownerDocument_getElementById === void 0 ? void 0 : (_element_ownerDocument_getElementById_textContent = _element_ownerDocument_getElementById.textContent) === null || _element_ownerDocument_getElementById_textContent === void 0 ? void 0 : _element_ownerDocument_getElementById_textContent.trim();
+    } else if (isElementType.isElementType(element, [
+        'button',
+        'input',
+        'meter',
+        'output',
+        'progress',
+        'select',
+        'textarea'
+    ]) && ((_element_labels = element.labels) === null || _element_labels === void 0 ? void 0 : _element_labels.length)) {
+        label = Array.from(element.labels).map((el)=>{
+            var _el_textContent;
+            return (_el_textContent = el.textContent) === null || _el_textContent === void 0 ? void 0 : _el_textContent.trim();
+        }).join('|');
+    } else if (isElementType.isElementType(element, 'button')) {
+        var _element_textContent;
+        label = (_element_textContent = element.textContent) === null || _element_textContent === void 0 ? void 0 : _element_textContent.trim();
+    }
+    label = label === null || label === void 0 ? void 0 : label.replace(/\n/g, '  ');
+    if (Number(label === null || label === void 0 ? void 0 : label.length) > 30) {
+        label = `${label === null || label === void 0 ? void 0 : label.substring(0, 29)}…`;
+    }
+    return label ? `(label=${label})` : '';
+}
+// With the eslint rule and prettier the bitwise operation isn't nice to read
+function hasBitFlag(conf, flag) {
+    return (conf & flag) > 0;
+}
+
+exports.assertPointerEvents = assertPointerEvents;
+exports.hasPointerEvents = hasPointerEvents;

package/dist/esm/clipboard/copy.js

@@ -0,0 +1,20 @@
+import { writeDataTransferToClipboard } from '../utils/dataTransfer/Clipboard.js';
+import { copySelection } from '../document/copySelection.js';
+
+async function copy() {
+    var _doc_activeElement;
+    const doc = this.config.document;
+    const target = (_doc_activeElement = doc.activeElement) !== null && _doc_activeElement !== void 0 ? _doc_activeElement : /* istanbul ignore next */ doc.body;
+    const clipboardData = copySelection(target);
+    if (clipboardData.items.length === 0) {
+        return;
+    }
+    if (this.dispatchUIEvent(target, 'copy', {
+        clipboardData
+    }) && this.config.writeToClipboard) {
+        await writeDataTransferToClipboard(doc, clipboardData);
+    }
+    return clipboardData;
+}
+
+export { copy };

package/dist/esm/clipboard/cut.js

@@ -0,0 +1,20 @@
+import { writeDataTransferToClipboard } from '../utils/dataTransfer/Clipboard.js';
+import { copySelection } from '../document/copySelection.js';
+
+async function cut() {
+    var _doc_activeElement;
+    const doc = this.config.document;
+    const target = (_doc_activeElement = doc.activeElement) !== null && _doc_activeElement !== void 0 ? _doc_activeElement : /* istanbul ignore next */ doc.body;
+    const clipboardData = copySelection(target);
+    if (clipboardData.items.length === 0) {
+        return;
+    }
+    if (this.dispatchUIEvent(target, 'cut', {
+        clipboardData
+    }) && this.config.writeToClipboard) {
+        await writeDataTransferToClipboard(target.ownerDocument, clipboardData);
+    }
+    return clipboardData;
+}
+
+export { cut };

package/dist/esm/clipboard/index.js

@@ -0,0 +1,3 @@
+export { copy } from './copy.js';
+export { cut } from './cut.js';
+export { paste } from './paste.js';

package/dist/esm/clipboard/paste.js

@@ -0,0 +1,22 @@
+import { createDataTransfer } from '../utils/dataTransfer/DataTransfer.js';
+import { readDataTransferFromClipboard } from '../utils/dataTransfer/Clipboard.js';
+import { getWindow } from '../utils/misc/getWindow.js';
+
+async function paste(clipboardData) {
+    var _doc_activeElement, _ref;
+    const doc = this.config.document;
+    const target = (_doc_activeElement = doc.activeElement) !== null && _doc_activeElement !== void 0 ? _doc_activeElement : /* istanbul ignore next */ doc.body;
+    const dataTransfer = (_ref = typeof clipboardData === 'string' ? getClipboardDataFromString(doc, clipboardData) : clipboardData) !== null && _ref !== void 0 ? _ref : await readDataTransferFromClipboard(doc).catch(()=>{
+        throw new Error('`userEvent.paste()` without `clipboardData` requires the `ClipboardAPI` to be available.');
+    });
+    this.dispatchUIEvent(target, 'paste', {
+        clipboardData: dataTransfer
+    });
+}
+function getClipboardDataFromString(doc, text) {
+    const dt = createDataTransfer(getWindow(doc));
+    dt.setData('text', text);
+    return dt;
+}
+
+export { paste };

package/dist/esm/convenience/click.js

@@ -0,0 +1,31 @@
+async function click(element) {
+    const pointerIn = [];
+    if (!this.config.skipHover) {
+        pointerIn.push({
+            target: element
+        });
+    }
+    pointerIn.push({
+        keys: '[MouseLeft]',
+        target: element
+    });
+    return this.pointer(pointerIn);
+}
+async function dblClick(element) {
+    return this.pointer([
+        {
+            target: element
+        },
+        '[MouseLeft][MouseLeft]'
+    ]);
+}
+async function tripleClick(element) {
+    return this.pointer([
+        {
+            target: element
+        },
+        '[MouseLeft][MouseLeft][MouseLeft]'
+    ]);
+}
+
+export { click, dblClick, tripleClick };

package/dist/esm/convenience/hover.js

@@ -0,0 +1,16 @@
+import '../utils/dataTransfer/Clipboard.js';
+import { assertPointerEvents } from '../utils/pointer/cssPointerEvents.js';
+
+async function hover(element) {
+    return this.pointer({
+        target: element
+    });
+}
+async function unhover(element) {
+    assertPointerEvents(this, this.system.pointer.getMouseTarget(this));
+    return this.pointer({
+        target: element.ownerDocument.body
+    });
+}
+
+export { hover, unhover };

package/dist/esm/convenience/index.js

@@ -0,0 +1,3 @@
+export { click, dblClick, tripleClick } from './click.js';
+export { hover, unhover } from './hover.js';
+export { tab } from './tab.js';

package/dist/esm/convenience/tab.js

@@ -0,0 +1,5 @@
+async function tab({ shift } = {}) {
+    return this.keyboard(shift === true ? '{Shift>}{Tab}{/Shift}' : shift === false ? '[/ShiftLeft][/ShiftRight]{Tab}' : '{Tab}');
+}
+
+export { tab };

package/dist/esm/document/UI.js

@@ -0,0 +1,77 @@
+const UIValue = Symbol('Displayed value in UI');
+const UISelection = Symbol('Displayed selection in UI');
+const InitialValue = Symbol('Initial value to compare on blur');
+function isUIValue(value) {
+    return typeof value === 'object' && UIValue in value;
+}
+function isUISelectionStart(start) {
+    return !!start && typeof start === 'object' && UISelection in start;
+}
+function setUIValue(element, value) {
+    if (element[InitialValue] === undefined) {
+        element[InitialValue] = element.value;
+    }
+    element[UIValue] = value;
+    element.value = Object.assign(new String(value), {
+        [UIValue]: true
+    });
+}
+function getUIValue(element) {
+    return element[UIValue] === undefined ? element.value : String(element[UIValue]);
+}
+/** Flag the IDL value as clean. This does not change the value. */ function setUIValueClean(element) {
+    element[UIValue] = undefined;
+}
+function clearInitialValue(element) {
+    element[InitialValue] = undefined;
+}
+function getInitialValue(element) {
+    return element[InitialValue];
+}
+function setUISelectionRaw(element, selection) {
+    element[UISelection] = selection;
+}
+function setUISelection(element, { focusOffset: focusOffsetParam, anchorOffset: anchorOffsetParam = focusOffsetParam }, mode = 'replace') {
+    const valueLength = getUIValue(element).length;
+    const sanitizeOffset = (o)=>Math.max(0, Math.min(valueLength, o));
+    const anchorOffset = mode === 'replace' || element[UISelection] === undefined ? sanitizeOffset(anchorOffsetParam) : element[UISelection].anchorOffset;
+    const focusOffset = sanitizeOffset(focusOffsetParam);
+    const startOffset = Math.min(anchorOffset, focusOffset);
+    const endOffset = Math.max(anchorOffset, focusOffset);
+    element[UISelection] = {
+        anchorOffset,
+        focusOffset
+    };
+    if (element.selectionStart === startOffset && element.selectionEnd === endOffset) {
+        return;
+    }
+    const startObj = Object.assign(new Number(startOffset), {
+        [UISelection]: true
+    });
+    try {
+        element.setSelectionRange(startObj, endOffset);
+    } catch  {
+    // DOMException for invalid state is expected when calling this
+    // on an element without support for setSelectionRange
+    }
+}
+function getUISelection(element) {
+    var _element_UISelection, _element_selectionStart, _element_selectionEnd;
+    const sel = (_element_UISelection = element[UISelection]) !== null && _element_UISelection !== void 0 ? _element_UISelection : {
+        anchorOffset: (_element_selectionStart = element.selectionStart) !== null && _element_selectionStart !== void 0 ? _element_selectionStart : 0,
+        focusOffset: (_element_selectionEnd = element.selectionEnd) !== null && _element_selectionEnd !== void 0 ? _element_selectionEnd : 0
+    };
+    return {
+        ...sel,
+        startOffset: Math.min(sel.anchorOffset, sel.focusOffset),
+        endOffset: Math.max(sel.anchorOffset, sel.focusOffset)
+    };
+}
+function hasUISelection(element) {
+    return !!element[UISelection];
+}
+/** Flag the IDL selection as clean. This does not change the selection. */ function setUISelectionClean(element) {
+    element[UISelection] = undefined;
+}
+
+export { clearInitialValue, getInitialValue, getUISelection, getUIValue, hasUISelection, isUISelectionStart, isUIValue, setUISelection, setUISelectionClean, setUISelectionRaw, setUIValue, setUIValueClean };

package/dist/esm/document/copySelection.js

@@ -0,0 +1,27 @@
+import { createDataTransfer } from '../utils/dataTransfer/DataTransfer.js';
+import '../utils/dataTransfer/Clipboard.js';
+import { getWindow } from '../utils/misc/getWindow.js';
+import { hasOwnSelection } from '../utils/focus/selection.js';
+import { getUISelection, getUIValue } from './UI.js';
+
+function copySelection(target) {
+    const data = hasOwnSelection(target) ? {
+        'text/plain': readSelectedValueFromInput(target)
+    } : {
+        'text/plain': String(target.ownerDocument.getSelection())
+    };
+    const dt = createDataTransfer(getWindow(target));
+    for(const type in data){
+        if (data[type]) {
+            dt.setData(type, data[type]);
+        }
+    }
+    return dt;
+}
+function readSelectedValueFromInput(target) {
+    const sel = getUISelection(target);
+    const val = getUIValue(target);
+    return val.substring(sel.startOffset, sel.endOffset);
+}
+
+export { copySelection };

package/dist/esm/document/getValueOrTextContent.js

@@ -0,0 +1,16 @@
+import '../utils/dataTransfer/Clipboard.js';
+import { isContentEditable } from '../utils/edit/isContentEditable.js';
+import { getUIValue } from './UI.js';
+
+function getValueOrTextContent(element) {
+    // istanbul ignore if
+    if (!element) {
+        return null;
+    }
+    if (isContentEditable(element)) {
+        return element.textContent;
+    }
+    return getUIValue(element);
+}
+
+export { getValueOrTextContent };

package/dist/esm/document/index.js

@@ -0,0 +1,4 @@
+export { clearInitialValue, getUISelection, getUIValue, setUISelection, setUIValue } from './UI.js';
+export { getValueOrTextContent } from './getValueOrTextContent.js';
+export { copySelection } from './copySelection.js';
+export { commitValueAfterInput } from './trackValue.js';

package/dist/esm/document/interceptor.js

@@ -0,0 +1,99 @@
+import { isElementType } from '../utils/misc/isElementType.js';
+import '../utils/dataTransfer/Clipboard.js';
+import { startTrackValue, trackOrSetValue } from './trackValue.js';
+import { isUIValue, setUISelectionClean, isUISelectionStart, setUISelectionRaw, getUIValue, setUIValueClean } from './UI.js';
+
+const Interceptor = Symbol('Interceptor for programmatical calls');
+function prepareInterceptor(element, propName, interceptorImpl) {
+    const prototypeDescriptor = Object.getOwnPropertyDescriptor(element.constructor.prototype, propName);
+    const objectDescriptor = Object.getOwnPropertyDescriptor(element, propName);
+    const target = (prototypeDescriptor === null || prototypeDescriptor === void 0 ? void 0 : prototypeDescriptor.set) ? 'set' : 'value';
+    /* istanbul ignore if */ if (typeof (prototypeDescriptor === null || prototypeDescriptor === void 0 ? void 0 : prototypeDescriptor[target]) !== 'function' || prototypeDescriptor[target][Interceptor]) {
+        throw new Error(`Element ${element.tagName} does not implement "${String(propName)}".`);
+    }
+    function intercept(...args) {
+        const { applyNative = false, realArgs, then } = interceptorImpl.call(this, ...args);
+        const realFunc = (!applyNative && objectDescriptor || prototypeDescriptor)[target];
+        if (target === 'set') {
+            realFunc.call(this, realArgs);
+        } else {
+            realFunc.call(this, ...realArgs);
+        }
+        then === null || then === void 0 ? void 0 : then();
+    }
+    intercept[Interceptor] = Interceptor;
+    Object.defineProperty(element, propName, {
+        ...objectDescriptor !== null && objectDescriptor !== void 0 ? objectDescriptor : prototypeDescriptor,
+        [target]: intercept
+    });
+}
+function prepareValueInterceptor(element) {
+    prepareInterceptor(element, 'value', function interceptorImpl(v) {
+        const isUI = isUIValue(v);
+        if (isUI) {
+            startTrackValue(this);
+        }
+        return {
+            applyNative: !!isUI,
+            realArgs: sanitizeValue(this, v),
+            then: isUI ? undefined : ()=>trackOrSetValue(this, String(v))
+        };
+    });
+}
+function sanitizeValue(element, v) {
+    // Workaround for JSDOM
+    if (isElementType(element, 'input', {
+        type: 'number'
+    }) && String(v) !== '' && !Number.isNaN(Number(v))) {
+        // Setting value to "1." results in `null` in JSDOM
+        return String(Number(v));
+    }
+    return String(v);
+}
+function prepareSelectionInterceptor(element) {
+    prepareInterceptor(element, 'setSelectionRange', function interceptorImpl(start, ...others) {
+        const isUI = isUISelectionStart(start);
+        return {
+            applyNative: !!isUI,
+            realArgs: [
+                Number(start),
+                ...others
+            ],
+            then: ()=>isUI ? undefined : setUISelectionClean(element)
+        };
+    });
+    prepareInterceptor(element, 'selectionStart', function interceptorImpl(v) {
+        return {
+            realArgs: v,
+            then: ()=>setUISelectionClean(element)
+        };
+    });
+    prepareInterceptor(element, 'selectionEnd', function interceptorImpl(v) {
+        return {
+            realArgs: v,
+            then: ()=>setUISelectionClean(element)
+        };
+    });
+    prepareInterceptor(element, 'select', function interceptorImpl() {
+        return {
+            realArgs: [],
+            then: ()=>setUISelectionRaw(element, {
+                    anchorOffset: 0,
+                    focusOffset: getUIValue(element).length
+                })
+        };
+    });
+}
+function prepareRangeTextInterceptor(element) {
+    prepareInterceptor(element, 'setRangeText', function interceptorImpl(...realArgs) {
+        return {
+            realArgs,
+            then: ()=>{
+                setUIValueClean(element);
+                setUISelectionClean(element);
+            }
+        };
+    });
+}
+
+export { prepareInterceptor, prepareRangeTextInterceptor, prepareSelectionInterceptor, prepareValueInterceptor };