accented 0.0.1-dev.3 → 0.0.2

package/dist/utils/get-element-position.js

@@ -0,0 +1,22 @@
+export default function getElementPosition(element, win) {
+    const rect = element.getBoundingClientRect();
+    const direction = win.getComputedStyle(element).direction;
+    if (direction === 'ltr') {
+        return {
+            inlineEndLeft: rect.right,
+            blockStartTop: rect.top,
+            direction
+        };
+    }
+    else if (direction === 'rtl') {
+        return {
+            inlineEndLeft: rect.left,
+            blockStartTop: rect.top,
+            direction
+        };
+    }
+    else {
+        throw new Error(`The element ${element} has a direction "${direction}", which is not supported.`);
+    }
+}
+//# sourceMappingURL=get-element-position.js.map

package/dist/utils/get-element-position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-element-position.js","sourceRoot":"","sources":["../../src/utils/get-element-position.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,OAAgB,EAAE,GAAW;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAG,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC;IAC1D,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,KAAK;YACzB,aAAa,EAAE,IAAI,CAAC,GAAG;YACvB,SAAS;SACV,CAAC;IACJ,CAAC;SAAM,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QAC/B,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,IAAI;YACxB,aAAa,EAAE,IAAI,CAAC,GAAG;YACvB,SAAS;SACV,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,eAAe,OAAO,qBAAqB,SAAS,4BAA4B,CAAC,CAAC;IACpG,CAAC;AACH,CAAC"}

package/dist/utils/get-scrollable-ancestors.d.ts

@@ -0,0 +1,2 @@
+export default function getScrollableAncestors(element: HTMLElement, win: Window): Set<HTMLElement>;
+//# sourceMappingURL=get-scrollable-ancestors.d.ts.map

package/dist/utils/get-scrollable-ancestors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-scrollable-ancestors.d.ts","sourceRoot":"","sources":["../../src/utils/get-scrollable-ancestors.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,oBAWhF"}

package/dist/utils/get-scrollable-ancestors.js

@@ -0,0 +1,15 @@
+const scrollableOverflowValues = new Set(['auto', 'scroll', 'hidden']);
+export default function getScrollableAncestors(element, win) {
+    let currentElement = element;
+    let scrollableAncestors = new Set();
+    while (currentElement.parentElement) {
+        currentElement = currentElement.parentElement;
+        const computedStyle = win.getComputedStyle(currentElement);
+        if (scrollableOverflowValues.has(computedStyle.overflowX) || scrollableOverflowValues.has(computedStyle.overflowY)) {
+            scrollableAncestors.add(currentElement);
+        }
+    }
+    return scrollableAncestors;
+}
+;
+//# sourceMappingURL=get-scrollable-ancestors.js.map

package/dist/utils/get-scrollable-ancestors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-scrollable-ancestors.js","sourceRoot":"","sources":["../../src/utils/get-scrollable-ancestors.ts"],"names":[],"mappings":"AAAA,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEvE,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAE,OAAoB,EAAE,GAAW;IAC/E,IAAI,cAAc,GAAG,OAAO,CAAC;IAC7B,IAAI,mBAAmB,GAAG,IAAI,GAAG,EAAe,CAAC;IACjD,OAAO,cAAc,CAAC,aAAa,EAAE,CAAC;QACpC,cAAc,GAAG,cAAc,CAAC,aAAa,CAAC;QAC9C,MAAM,aAAa,GAAG,GAAG,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;QAC3D,IAAI,wBAAwB,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,wBAAwB,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;YACnH,mBAAmB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAAA,CAAC"}

package/dist/utils/recalculate-positions.d.ts

@@ -0,0 +1,2 @@
+export default function recalculatePositions(): void;
+//# sourceMappingURL=recalculate-positions.d.ts.map

package/dist/utils/recalculate-positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recalculate-positions.d.ts","sourceRoot":"","sources":["../../src/utils/recalculate-positions.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,OAAO,UAAU,oBAAoB,SAmB3C"}

package/dist/utils/recalculate-positions.js

@@ -0,0 +1,27 @@
+import { batch } from '@preact/signals-core';
+import { extendedElementsWithIssues } from '../state.js';
+import getElementPosition from './get-element-position.js';
+import logAndRethrow from '../log-and-rethrow.js';
+let frameRequested = false;
+export default function recalculatePositions() {
+    if (frameRequested) {
+        return;
+    }
+    frameRequested = true;
+    window.requestAnimationFrame(() => {
+        try {
+            frameRequested = false;
+            batch(() => {
+                extendedElementsWithIssues.value.forEach(({ element, position, visible }) => {
+                    if (visible.value && element.isConnected) {
+                        position.value = getElementPosition(element, window);
+                    }
+                });
+            });
+        }
+        catch (error) {
+            logAndRethrow(error);
+        }
+    });
+}
+//# sourceMappingURL=recalculate-positions.js.map

package/dist/utils/recalculate-positions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recalculate-positions.js","sourceRoot":"","sources":["../../src/utils/recalculate-positions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,kBAAkB,MAAM,2BAA2B,CAAC;AAC3D,OAAO,aAAa,MAAM,uBAAuB,CAAC;AAElD,IAAI,cAAc,GAAG,KAAK,CAAC;AAE3B,MAAM,CAAC,OAAO,UAAU,oBAAoB;IAC1C,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IACD,cAAc,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,qBAAqB,CAAC,GAAG,EAAE;QAChC,IAAI,CAAC;YACH,cAAc,GAAG,KAAK,CAAC;YACvB,KAAK,CAAC,GAAG,EAAE;gBACT,0BAA0B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;oBAC1E,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;wBACzC,QAAQ,CAAC,KAAK,GAAG,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;oBACvD,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/recalculate-scrollable-ancestors.d.ts

@@ -0,0 +1,2 @@
+export default function recalculateScrollableAncestors(): void;
+//# sourceMappingURL=recalculate-scrollable-ancestors.d.ts.map

package/dist/utils/recalculate-scrollable-ancestors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recalculate-scrollable-ancestors.d.ts","sourceRoot":"","sources":["../../src/utils/recalculate-scrollable-ancestors.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,OAAO,UAAU,8BAA8B,SAQrD"}

package/dist/utils/recalculate-scrollable-ancestors.js

@@ -0,0 +1,13 @@
+import { batch } from '@preact/signals-core';
+import { extendedElementsWithIssues } from '../state.js';
+import getScrollableAncestors from './get-scrollable-ancestors.js';
+export default function recalculateScrollableAncestors() {
+    batch(() => {
+        extendedElementsWithIssues.value.forEach(({ element, scrollableAncestors }) => {
+            if (element.isConnected) {
+                scrollableAncestors.value = getScrollableAncestors(element, window);
+            }
+        });
+    });
+}
+//# sourceMappingURL=recalculate-scrollable-ancestors.js.map

package/dist/utils/recalculate-scrollable-ancestors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recalculate-scrollable-ancestors.js","sourceRoot":"","sources":["../../src/utils/recalculate-scrollable-ancestors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,sBAAsB,MAAM,+BAA+B,CAAC;AAEnE,MAAM,CAAC,OAAO,UAAU,8BAA8B;IACpD,KAAK,CAAC,GAAG,EAAE;QACT,0BAA0B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,EAAE;YAC5E,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBACxB,mBAAmB,CAAC,KAAK,GAAG,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACtE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/supports-anchor-positioning.d.ts

@@ -0,0 +1,6 @@
+type WindowWithCSS = Window & {
+    CSS: typeof CSS;
+};
+export default function supportsAnchorPositioning(win: WindowWithCSS): boolean;
+export {};
+//# sourceMappingURL=supports-anchor-positioning.d.ts.map

package/dist/utils/supports-anchor-positioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supports-anchor-positioning.d.ts","sourceRoot":"","sources":["../../src/utils/supports-anchor-positioning.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,GAAG,MAAM,GAAG;IAC5B,GAAG,EAAE,OAAO,GAAG,CAAA;CAChB,CAAA;AAED,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,GAAG,EAAE,aAAa,WAEnE"}

package/dist/utils/supports-anchor-positioning.js

@@ -0,0 +1,4 @@
+export default function supportsAnchorPositioning(win) {
+    return win.CSS.supports('anchor-name: --foo') && win.CSS.supports('position-anchor: --foo');
+}
+//# sourceMappingURL=supports-anchor-positioning.js.map

package/dist/utils/supports-anchor-positioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supports-anchor-positioning.js","sourceRoot":"","sources":["../../src/utils/supports-anchor-positioning.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,GAAkB;IAClE,OAAO,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AAC9F,CAAC"}

package/dist/utils/transform-violations.d.ts

@@ -0,0 +1,4 @@
+import type { AxeResults } from 'axe-core';
+import type { ElementWithIssues } from '../types';
+export default function transformViolations(violations: typeof AxeResults.violations): ElementWithIssues[];
+//# sourceMappingURL=transform-violations.d.ts.map

package/dist/utils/transform-violations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-violations.d.ts","sourceRoot":"","sources":["../../src/utils/transform-violations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAS,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAOzD,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,UAAU,EAAE,OAAO,UAAU,CAAC,UAAU,uBA+CnF"}

package/dist/utils/transform-violations.js

@@ -0,0 +1,48 @@
+function impactCompare(a, b) {
+    const impactOrder = [null, 'minor', 'moderate', 'serious', 'critical'];
+    return impactOrder.indexOf(a) - impactOrder.indexOf(b);
+}
+export default function transformViolations(violations) {
+    const elementsWithIssues = [];
+    for (const violation of violations) {
+        for (const node of violation.nodes) {
+            const { element, target } = node;
+            // Although axe-core can perform iframe scanning, I haven't succeeded in it,
+            // and the docs suggest that the axe-core script should be explicitly included
+            // in each of the iframed documents anyway.
+            // It seems preferable to disallow iframe scanning and not report issues in elements within iframes
+            // in the case that such issues are for some reason reported by axe-core.
+            // A consumer of Accented can instead scan the iframed document by calling Accented initialization from that document.
+            const isInIframe = target.length > 1;
+            // Highlighting elements in shadow DOM is not yet supported, see https://github.com/pomerantsev/accented/issues/25
+            // Until then, we don’t want such elements to be added to the set.
+            const isInShadowDOM = Array.isArray(target[0]);
+            if (element && !isInIframe && !isInShadowDOM) {
+                const issue = {
+                    id: violation.id,
+                    title: violation.help,
+                    description: node.failureSummary ?? violation.description,
+                    url: violation.helpUrl,
+                    impact: violation.impact ?? null
+                };
+                const existingElementIndex = elementsWithIssues.findIndex(elementWithIssues => elementWithIssues.element === element);
+                if (existingElementIndex === -1) {
+                    elementsWithIssues.push({
+                        element,
+                        issues: [issue]
+                    });
+                }
+                else {
+                    elementsWithIssues[existingElementIndex].issues.push(issue);
+                }
+            }
+        }
+    }
+    for (const elementWithIssues of elementsWithIssues) {
+        elementWithIssues.issues.sort((a, b) => {
+            return -impactCompare(a.impact, b.impact) || a.id.localeCompare(b.id);
+        });
+    }
+    return elementsWithIssues;
+}
+//# sourceMappingURL=transform-violations.js.map

package/dist/utils/transform-violations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-violations.js","sourceRoot":"","sources":["../../src/utils/transform-violations.ts"],"names":[],"mappings":"AAGA,SAAS,aAAa,CAAC,CAAc,EAAE,CAAc;IACnD,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACvE,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,UAAwC;IAClF,MAAM,kBAAkB,GAA6B,EAAE,CAAC;IAExD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACnC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;YAEjC,4EAA4E;YAC5E,8EAA8E;YAC9E,2CAA2C;YAC3C,mGAAmG;YACnG,yEAAyE;YACzE,sHAAsH;YACtH,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YAErC,kHAAkH;YAClH,kEAAkE;YAClE,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAE/C,IAAI,OAAO,IAAI,CAAC,UAAU,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC7C,MAAM,KAAK,GAAU;oBACnB,EAAE,EAAE,SAAS,CAAC,EAAE;oBAChB,KAAK,EAAE,SAAS,CAAC,IAAI;oBACrB,WAAW,EAAE,IAAI,CAAC,cAAc,IAAI,SAAS,CAAC,WAAW;oBACzD,GAAG,EAAE,SAAS,CAAC,OAAO;oBACtB,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,IAAI;iBACjC,CAAC;gBACF,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC,iBAAiB,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;gBACtH,IAAI,oBAAoB,KAAK,CAAC,CAAC,EAAE,CAAC;oBAChC,kBAAkB,CAAC,IAAI,CAAC;wBACtB,OAAO;wBACP,MAAM,EAAE,CAAC,KAAK,CAAC;qBAChB,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,kBAAkB,CAAC,oBAAoB,CAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,iBAAiB,IAAI,kBAAkB,EAAE,CAAC;QACnD,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/utils/update-elements-with-issues.d.ts

@@ -0,0 +1,7 @@
+import type { AxeResults } from 'axe-core';
+import type { Signal } from '@preact/signals-core';
+import type { ExtendedElementWithIssues } from '../types';
+export default function updateElementsWithIssues(extendedElementsWithIssues: Signal<Array<ExtendedElementWithIssues>>, violations: typeof AxeResults.violations, win: Window & {
+    CSS: typeof CSS;
+}, name: string): void;
+//# sourceMappingURL=update-elements-with-issues.d.ts.map

package/dist/utils/update-elements-with-issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-elements-with-issues.d.ts","sourceRoot":"","sources":["../../src/utils/update-elements-with-issues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAW1D,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,0BAA0B,EAAE,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,UAAU,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,OAAO,GAAG,CAAA;CAAE,EAAE,IAAI,EAAE,MAAM,QA4D/M"}

package/dist/utils/update-elements-with-issues.js

@@ -0,0 +1,64 @@
+import { batch, signal } from '@preact/signals-core';
+import transformViolations from './transform-violations.js';
+import areIssueSetsEqual from './are-issue-sets-equal.js';
+import getElementPosition from './get-element-position.js';
+import getScrollableAncestors from './get-scrollable-ancestors.js';
+import supportsAnchorPositioning from './supports-anchor-positioning.js';
+let count = 0;
+export default function updateElementsWithIssues(extendedElementsWithIssues, violations, win, name) {
+    const updatedElementsWithIssues = transformViolations(violations);
+    batch(() => {
+        for (const updatedElementWithIssues of updatedElementsWithIssues) {
+            const existingElementIndex = extendedElementsWithIssues.value.findIndex(extendedElementWithIssues => extendedElementWithIssues.element === updatedElementWithIssues.element);
+            if (existingElementIndex > -1 && extendedElementsWithIssues.value[existingElementIndex] && !areIssueSetsEqual(extendedElementsWithIssues.value[existingElementIndex].issues.value, updatedElementWithIssues.issues)) {
+                extendedElementsWithIssues.value[existingElementIndex].issues.value = updatedElementWithIssues.issues;
+            }
+        }
+        const addedElementsWithIssues = updatedElementsWithIssues.filter(updatedElementWithIssues => {
+            return !extendedElementsWithIssues.value.some(extendedElementWithIssues => extendedElementWithIssues.element === updatedElementWithIssues.element);
+        });
+        const removedElementsWithIssues = extendedElementsWithIssues.value.filter(extendedElementWithIssues => {
+            return !updatedElementsWithIssues.some(updatedElementWithIssues => updatedElementWithIssues.element === extendedElementWithIssues.element);
+        });
+        if (addedElementsWithIssues.length > 0 || removedElementsWithIssues.length > 0) {
+            extendedElementsWithIssues.value = [...extendedElementsWithIssues.value]
+                .filter(extendedElementWithIssues => {
+                return !removedElementsWithIssues.some(removedElementWithIssues => removedElementWithIssues.element === extendedElementWithIssues.element);
+            })
+                .concat(addedElementsWithIssues
+                .filter(addedElementWithIssues => addedElementWithIssues.element.isConnected)
+                .map(addedElementWithIssues => {
+                const id = count++;
+                const trigger = win.document.createElement(`${name}-trigger`);
+                const elementZIndex = parseInt(win.getComputedStyle(addedElementWithIssues.element).zIndex, 10);
+                if (!isNaN(elementZIndex)) {
+                    trigger.style.setProperty('z-index', (elementZIndex + 1).toString(), 'important');
+                }
+                trigger.style.setProperty('position-anchor', `--${name}-anchor-${id}`, 'important');
+                trigger.dataset.id = id.toString();
+                const accentedDialog = win.document.createElement(`${name}-dialog`);
+                trigger.dialog = accentedDialog;
+                const position = getElementPosition(addedElementWithIssues.element, win);
+                trigger.position = signal(position);
+                trigger.visible = signal(true);
+                trigger.element = addedElementWithIssues.element;
+                const scrollableAncestors = supportsAnchorPositioning(win) ?
+                    new Set() :
+                    getScrollableAncestors(addedElementWithIssues.element, win);
+                const issues = signal(addedElementWithIssues.issues);
+                accentedDialog.issues = issues;
+                accentedDialog.element = addedElementWithIssues.element;
+                return {
+                    id,
+                    element: addedElementWithIssues.element,
+                    visible: trigger.visible,
+                    position: trigger.position,
+                    scrollableAncestors: signal(scrollableAncestors),
+                    trigger,
+                    issues
+                };
+            }));
+        }
+    });
+}
+//# sourceMappingURL=update-elements-with-issues.js.map

package/dist/utils/update-elements-with-issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-elements-with-issues.js","sourceRoot":"","sources":["../../src/utils/update-elements-with-issues.ts"],"names":[],"mappings":"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"}

package/dist/validate-options.d.ts

@@ -0,0 +1,3 @@
+import type { AccentedOptions } from './types';
+export default function validateOptions(options: AccentedOptions): void;
+//# sourceMappingURL=validate-options.d.ts.map

package/dist/validate-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-options.d.ts","sourceRoot":"","sources":["../src/validate-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAQ/C,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,OAAO,EAAE,eAAe,QAmC/D"}

package/dist/validate-options.js

@@ -0,0 +1,42 @@
+import { allowedAxeOptions } from './types.js';
+// The space of valid CSS and HTML names is wider than this,
+// but with Unicode it gets complicated quickly, so I'm sticking to only allowing
+// lowercase alphanumeric names that possibly contain dashes that start with a letter.
+const nameRegex = /^[a-z]([a-z0-9]|-)+$/;
+export default function validateOptions(options) {
+    if (typeof options !== 'object' || options === null) {
+        throw new TypeError(`Accented: invalid argument. The options parameter must be an object if provided. It’s currently set to ${options}.`);
+    }
+    if (options.throttle !== undefined) {
+        if (typeof options.throttle !== 'object' || options.throttle === null) {
+            throw new TypeError(`Accented: invalid argument. \`throttle\` option must be an object if provided. It’s currently set to ${options.throttle}.`);
+        }
+        if (options.throttle.wait !== undefined && (typeof options.throttle.wait !== 'number' || options.throttle.wait < 0)) {
+            throw new TypeError(`Accented: invalid argument. \`throttle.wait\` option must be a non-negative number if provided. It’s currently set to ${options.throttle.wait}.`);
+        }
+    }
+    if (options.output !== undefined) {
+        if (typeof options.output !== 'object' || options.output === null) {
+            throw new TypeError(`Accented: invalid argument. \`output\` option must be an object if provided. It’s currently set to ${options.output}.`);
+        }
+        if (options.output.console !== undefined && typeof options.output.console !== 'boolean') {
+            console.warn(`Accented: invalid argument. \`output.console\` option is expected to be a boolean. It’s currently set to ${options.output.console}.`);
+        }
+    }
+    if (options.callback !== undefined && typeof options.callback !== 'function') {
+        throw new TypeError(`Accented: invalid argument. \`callback\` option must be a function if provided. It’s currently set to ${options.callback}.`);
+    }
+    if (options.name !== undefined && (typeof options.name !== 'string' || !options.name.match(nameRegex))) {
+        throw new TypeError(`Accented: invalid argument. \`name\` option must be a string that starts with a lowercase letter and only contains lowercase alphanumeric characters and dashes. It’s currently set to ${options.name}.`);
+    }
+    if (options.axeOptions !== undefined) {
+        if (typeof options.axeOptions !== 'object' || options.axeOptions === null) {
+            throw new TypeError(`Accented: invalid argument. \`axeOptions\` option must be an object if provided. It’s currently set to ${options.axeOptions}.`);
+        }
+        const unsupportedKeys = Object.keys(options.axeOptions).filter(key => !allowedAxeOptions.includes(key));
+        if (unsupportedKeys.length > 0) {
+            throw new TypeError(`Accented: invalid argument. \`axeOptions\` contains the following unsupported keys: ${unsupportedKeys.join(', ')}. Valid options are: ${allowedAxeOptions.join(', ')}.`);
+        }
+    }
+}
+//# sourceMappingURL=validate-options.js.map

package/dist/validate-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-options.js","sourceRoot":"","sources":["../src/validate-options.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "accented",
-  "version": "0.0.1-dev.3",
+  "version": "0.0.2",
   "description": "Continuous accessibility testing and issue highlighting for web development",
   "type": "module",
   "main": "dist/accented.js",
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "repository": {
     "type": "git",
@@ -24,11 +25,15 @@
   },
   "homepage": "https://github.com/pomerantsev/accented#readme",
   "dependencies": {
+    "@preact/signals-core": "^1.8.0",
     "axe-core": "^4.10.2"
   },
   "scripts": {
     "build": "tsc",
+    "checkBuiltFiles": "node --import tsx ./scripts/check-built-files.ts",
+    "checkImportsInBuiltFiles": "node ./dist/accented.js",
+    "typecheckTests": "tsc -p ./tsconfig.test.json",
     "watch": "tsc --watch",
-    "test": "node --test --import tsx ./**/*.test.ts"
+    "test": "node --test --import tsx \"./**/*.test.ts\""
   }
 }

package/src/accented.test.ts

@@ -0,0 +1,24 @@
+import assert from 'node:assert/strict';
+import {suite, test} from 'node:test';
+import type { Mock } from 'node:test';
+
+import accented from './accented.js';
+
+suite('Accented', () => {
+  test('runs without errors in NodeJS and issues a warning and a trace (it’s meant to be a no-op on the server side)', (t) => {
+    t.mock.method(console, 'warn', () => {});
+    t.mock.method(console, 'trace', () => {});
+    accented();
+    assert.equal((console.warn as Mock<() => void>).mock.callCount(), 1);
+    assert.equal((console.trace as Mock<() => void>).mock.callCount(), 1);
+  });
+
+  suite('argument validation', () => {
+    // @ts-expect-error
+    assert.throws(() => accented({ throttle: null }));
+    // @ts-expect-error
+    assert.throws(() => accented({ throttle: 1000 }));
+
+    assert.throws(() => accented({ throttle: { wait: -1 } }));
+  });
+});

package/src/accented.ts

@@ -0,0 +1,119 @@
+
+import registerElements from './register-elements.js';
+import createDomUpdater from './dom-updater.js';
+import createLogger from './logger.js';
+import createScanner from './scanner.js';
+import setupScrollListeners from './scroll-listeners.js';
+import setupResizeListener from './resize-listener.js';
+import setupIntersectionObserver from './intersection-observer.js';
+import { enabled, extendedElementsWithIssues } from './state.js';
+import deepMerge from './utils/deep-merge.js';
+import type { AccentedOptions, DisableAccented } from './types';
+import validateOptions from './validate-options.js';
+import supportsAnchorPositioning from './utils/supports-anchor-positioning.js';
+import logAndRethrow from './log-and-rethrow.js';
+
+export type { AccentedOptions, DisableAccented };
+
+/**
+ * Enables highlighting of elements with accessibility issues.
+ *
+ * @param {AccentedOptions} options - The options object.
+ *
+ * @returns A `disable` function that can be called to stop the scanning and highlighting.
+ *
+ * @example
+ * accented();
+ *
+ * @example
+ * const disableAccented = accented({
+ *   output: {
+ *     console: false
+ *   },
+ *   throttle: {
+ *     wait: 500,
+ *     leading: false
+ *   },
+ *   callback: ({ elementsWithIssues, scanDuration }) => {
+ *    console.log('Elements with issues:', elementsWithIssues);
+ *    console.log('Scan duration:', scanDuration);
+ *   }
+ * });
+ */
+export default function accented(options: AccentedOptions = {}): DisableAccented {
+
+  validateOptions(options);
+
+  try {
+    if (typeof window === 'undefined' || typeof document === 'undefined') {
+      console.warn('Accented: this script can only run in the browser, and it’s likely running on the server now. Exiting.');
+      console.trace();
+      return () => {};
+    }
+
+    const defaultOutput: Required<AccentedOptions['output']> = {
+      console: true
+    };
+
+    const defaultThrottle: Required<AccentedOptions['throttle']> = {
+      wait: 1000,
+      leading: true
+    };
+
+    // IMPORTANT: when changing any of the properties or values, also do the following:
+    // * update the default value in the type documentation accordingly;
+    // * update validations and validation tests if necessary;
+    // * update examples in the accented() function JSDoc;
+    // * update examples in the Readme.
+    const defaultOptions: Required<AccentedOptions> = {
+      axeContext: document,
+      axeOptions: {},
+      name: 'accented',
+      output: defaultOutput,
+      throttle: defaultThrottle,
+      callback: () => {}
+    };
+
+    const {axeContext, axeOptions, name, output, throttle, callback} = deepMerge(defaultOptions, options);
+
+    if (enabled.value) {
+      // Add link to the recipes section of the docs (#56).
+      console.warn(
+        'You are trying to run the Accented library more than once. ' +
+        'This will likely lead to errors.'
+      );
+      console.trace();
+    }
+
+    enabled.value = true;
+
+    registerElements(name);
+
+    const {disconnect: cleanupIntersectionObserver, intersectionObserver } = supportsAnchorPositioning(window) ? {} : setupIntersectionObserver();
+    const cleanupScanner = createScanner(name, axeContext, axeOptions, throttle, callback);
+    const cleanupDomUpdater = createDomUpdater(name, intersectionObserver);
+    const cleanupLogger = output.console ? createLogger() : () => {};
+    const cleanupScrollListeners = supportsAnchorPositioning(window) ? () => {} : setupScrollListeners();
+    const cleanupResizeListener = supportsAnchorPositioning(window) ? () => {} : setupResizeListener();
+
+    return () => {
+      try {
+        enabled.value = false;
+        extendedElementsWithIssues.value = [];
+        cleanupScanner();
+        cleanupDomUpdater();
+        cleanupLogger();
+        cleanupScrollListeners();
+        cleanupResizeListener();
+        if (cleanupIntersectionObserver) {
+          cleanupIntersectionObserver();
+        }
+      } catch (error) {
+        logAndRethrow(error);
+      }
+    };
+  } catch (error) {
+    logAndRethrow(error);
+    return () => {};
+  }
+}

package/src/constants.ts

@@ -0,0 +1,2 @@
+export const accentedUrl = 'https://www.npmjs.com/package/accented';
+export const issuesUrl = 'https://github.com/pomerantsev/accented/issues';