@robertlinde/react-tour-kit 0.8.9 → 1.0.1

package/dist/react-platform/dom/elements.util.js

@@ -0,0 +1,155 @@
+export function toBox(rect) {
+    return { x: rect.left, y: rect.top, width: rect.width, height: rect.height };
+}
+/**
+ * False in documents without a layout engine (jsdom, happy-dom in test suites): every size there is
+ * zero. A real page always has a size, also a zero-sized frame (its window is zero-sized too).
+ */
+export function hasLayout() {
+    const root = document.documentElement;
+    return root.clientWidth > 0 || root.clientHeight > 0 || globalThis.innerWidth === 0 || globalThis.innerHeight === 0;
+}
+/** `checkVisibility()` where the browser has it. */
+export function checkVisibility(element, options) {
+    const check = element.checkVisibility;
+    return typeof check === 'function' ? check.call(element, options) : undefined;
+}
+/** True when the element takes up space and is not hidden (`display: none`, `visibility: hidden`, closed `<details>`). */
+export function isRendered(element) {
+    if (!hasLayout()) {
+        // Nothing has a size: count every element that is not explicitly hidden.
+        return element.isConnected && !element.closest('[hidden]') && getComputedStyle(element).display !== 'none';
+    }
+    const rect = element.getBoundingClientRect();
+    if (rect.width <= 0 && rect.height <= 0) {
+        return false;
+    }
+    return checkVisibility(element, { visibilityProperty: true }) ?? getComputedStyle(element).visibility !== 'hidden';
+}
+/**
+ * Resolves a target to an element. For selectors, the first rendered match wins, which handles
+ * layouts that duplicate markup (for example a mobile and a desktop navigation).
+ */
+export function resolveTarget(target) {
+    if (typeof target === 'string') {
+        let matches;
+        try {
+            matches = document.querySelectorAll(target);
+        }
+        catch {
+            return undefined;
+        }
+        for (const element of matches) {
+            if (isRendered(element)) {
+                return element;
+            }
+        }
+        return matches[0] ?? undefined;
+    }
+    const { current } = target;
+    return current instanceof Element ? current : undefined;
+}
+/** The parent element, crossing shadow-root boundaries. */
+export function parentOf(element) {
+    if (element.parentElement) {
+        return element.parentElement;
+    }
+    const root = element.getRootNode();
+    return root instanceof ShadowRoot ? root.host : undefined;
+}
+/** `ancestor.contains(element)`, also for elements inside shadow roots of the ancestor's descendants. */
+export function containsComposed(ancestor, element) {
+    for (let current = element; current; current = parentOf(current)) {
+        if (current === ancestor) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * The page's direction. Browsers take it from `<body>` (CSS calls it the principal writing mode),
+ * so `<body dir="rtl">` turns the page right-to-left even when `<html>` is left-to-right.
+ */
+export function pageDirection() {
+    const element = document.body ?? document.documentElement;
+    return getComputedStyle(element).direction === 'rtl' ? 'rtl' : 'ltr';
+}
+const textInputTypes = new Set([
+    'text',
+    'search',
+    'email',
+    'url',
+    'tel',
+    'password',
+    'number',
+    'date',
+    'datetime-local',
+    'month',
+    'week',
+    'time',
+]);
+/** Inputs that a space press activates or toggles. */
+const pressableInputTypes = new Set(['button', 'submit', 'reset', 'image', 'checkbox', 'file', 'color']);
+const arrowKeys = new Set(['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight']);
+const rangeKeys = new Set([...arrowKeys, 'PageUp', 'PageDown', 'Home', 'End']);
+/** Widgets whose arrow, page, Home and End keys move a selection or change a value. */
+const keyedWidgetSelector = [
+    'slider',
+    'spinbutton',
+    'radio',
+    'radiogroup',
+    'tab',
+    'tablist',
+    'listbox',
+    'option',
+    'menu',
+    'menubar',
+    'menuitem',
+    'menuitemcheckbox',
+    'menuitemradio',
+    'tree',
+    'treeitem',
+    'treegrid',
+    'grid',
+    'gridcell',
+    'combobox',
+    'textbox',
+    'searchbox',
+    'scrollbar',
+]
+    .map((role) => `[role="${role}"]`)
+    .join(', ');
+/** Widgets that a space press activates (links do not: space scrolls the page there). */
+const pressableSelector = 'button, summary, [role="button"], [role="checkbox"], [role="switch"], [role="radio"], [role="option"], [role="tab"], [role="treeitem"], [role^="menuitem"]';
+/**
+ * True when the focused element handles `key` itself (typing, toggling, choosing, adjusting a
+ * value), so the tour neither navigates nor blocks scrolling with it.
+ */
+export function handlesKey(target, key) {
+    if (!(target instanceof HTMLElement)) {
+        return false;
+    }
+    if (target.isContentEditable ||
+        target instanceof HTMLTextAreaElement ||
+        target instanceof HTMLSelectElement ||
+        ((target instanceof HTMLAudioElement || target instanceof HTMLVideoElement) && target.controls)) {
+        return true;
+    }
+    if (target instanceof HTMLInputElement) {
+        if (textInputTypes.has(target.type)) {
+            return true;
+        }
+        if (target.type === 'radio') {
+            return key === ' ' || arrowKeys.has(key);
+        }
+        if (target.type === 'range') {
+            return rangeKeys.has(key);
+        }
+        return key === ' ' && pressableInputTypes.has(target.type);
+    }
+    if (key === ' ') {
+        return target.closest(pressableSelector) !== null;
+    }
+    return rangeKeys.has(key) && target.closest(keyedWidgetSelector) !== null;
+}
+//# sourceMappingURL=elements.util.js.map

package/dist/react-platform/dom/elements.util.js.map

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

package/dist/react-platform/dom/occluders.util.d.ts

@@ -0,0 +1,13 @@
+import type { Box } from '../../shared/geometry/geometry.type.js';
+/** Forgets the cached elements, so a page that has been navigated away from is not kept in memory. */
+export declare function clearOccluderCache(): void;
+/**
+ * Rectangles (viewport coordinates) of elements that can cover the target. Excluded: elements
+ * containing the target (highlighting a link in a sticky navigation) or inside it, empty or
+ * invisible ones, and ones covering more than half the screen (app shells, full-screen
+ * backgrounds), which cannot be scrolled away from.
+ */
+export declare function findOccluders(target: Element | undefined, layer: Element | undefined): Box[];
+/** The occluders overlapping `box`. */
+export declare function occludersOver(box: Box, occluders: readonly Box[]): Box[];
+//# sourceMappingURL=occluders.util.d.ts.map

package/dist/react-platform/dom/occluders.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"occluders.util.d.ts","sourceRoot":"","sources":["../../../src/react-platform/dom/occluders.util.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,wCAAwC,CAAC;AAgBhE,sGAAsG;AACtG,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAuCD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,GAAG,EAAE,CAiB5F;AAED,uCAAuC;AACvC,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,CAExE"}

package/dist/react-platform/dom/occluders.util.js

@@ -0,0 +1,75 @@
+import { intersect } from '../../shared/geometry/box.util.js';
+import { checkVisibility, containsComposed, toBox } from './elements.util.js';
+/**
+ * Elements that stay put while the page scrolls (`position: fixed` or `sticky`): navigation bars,
+ * headers, floating buttons, chat widgets, cookie banners, toasts. Anything scrolled underneath
+ * them is hidden, so the tour scrolls targets clear of them where it can.
+ *
+ * Hit-testing (`elementsFromPoint`) cannot find them while the tour is open: the tour is a modal
+ * dialog and the inert page is excluded from hit-testing. They are found by computed style instead,
+ * also inside open shadow roots (web components). The list is cached briefly so following a
+ * scrolling target does not rescan the page every frame.
+ */
+const rescanAfterMs = 500;
+let cache;
+/** Forgets the cached elements, so a page that has been navigated away from is not kept in memory. */
+export function clearOccluderCache() {
+    cache = undefined;
+}
+function stayingPutElements(layer) {
+    const now = performance.now();
+    if (cache && now - cache.at < rescanAfterMs) {
+        return cache.elements;
+    }
+    const elements = [];
+    const scan = (root) => {
+        for (const element of root.querySelectorAll('*')) {
+            if (element.shadowRoot) {
+                scan(element.shadowRoot);
+            }
+            const { position } = getComputedStyle(element);
+            if (position === 'fixed' || position === 'sticky') {
+                elements.push(element);
+            }
+        }
+    };
+    scan(document.body);
+    const found = elements.filter((element) => !layer?.contains(element) && !element.matches('[data-rtk-probe]'));
+    cache = { at: now, elements: found };
+    return found;
+}
+/** False for elements that are there but cannot be seen: closed menus faded out with `visibility` or `opacity`. */
+function isSeen(element) {
+    const checked = checkVisibility(element, { visibilityProperty: true, opacityProperty: true });
+    if (checked !== undefined) {
+        return checked;
+    }
+    const style = getComputedStyle(element);
+    return style.visibility !== 'hidden' && style.opacity !== '0';
+}
+/**
+ * Rectangles (viewport coordinates) of elements that can cover the target. Excluded: elements
+ * containing the target (highlighting a link in a sticky navigation) or inside it, empty or
+ * invisible ones, and ones covering more than half the screen (app shells, full-screen
+ * backgrounds), which cannot be scrolled away from.
+ */
+export function findOccluders(target, layer) {
+    const screen = { width: document.documentElement.clientWidth, height: document.documentElement.clientHeight };
+    const occluders = [];
+    for (const element of stayingPutElements(layer)) {
+        if (!element.isConnected || (target && (containsComposed(element, target) || containsComposed(target, element)))) {
+            continue;
+        }
+        const rect = toBox(element.getBoundingClientRect());
+        const isCovering = rect.width > 0 && rect.height > 0 && rect.width * rect.height <= (screen.width * screen.height) / 2;
+        if (isCovering && isSeen(element)) {
+            occluders.push(rect);
+        }
+    }
+    return occluders;
+}
+/** The occluders overlapping `box`. */
+export function occludersOver(box, occluders) {
+    return occluders.filter((occluder) => intersect(occluder, box) !== undefined);
+}
+//# sourceMappingURL=occluders.util.js.map

package/dist/react-platform/dom/occluders.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"occluders.util.js","sourceRoot":"","sources":["../../../src/react-platform/dom/occluders.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,mCAAmC,CAAC;AAE5D,OAAO,EAAC,eAAe,EAAE,gBAAgB,EAAE,KAAK,EAAC,MAAM,oBAAoB,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,IAAI,KAA+E,CAAC;AAEpF,sGAAsG;AACtG,MAAM,UAAU,kBAAkB;IAChC,KAAK,GAAG,SAAS,CAAC;AACpB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAA0B;IACpD,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAC9B,IAAI,KAAK,IAAI,GAAG,GAAG,KAAK,CAAC,EAAE,GAAG,aAAa,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC,QAAQ,CAAC;IACxB,CAAC;IAED,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,IAAgB,EAAQ,EAAE;QACtC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YACjD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC3B,CAAC;YAED,MAAM,EAAC,QAAQ,EAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAClD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpB,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC9G,KAAK,GAAG,EAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC;IACnC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mHAAmH;AACnH,SAAS,MAAM,CAAC,OAAgB;IAC9B,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,EAAE,EAAC,kBAAkB,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAC,CAAC,CAAC;IAC5F,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,KAAK,GAAG,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAA2B,EAAE,KAA0B;IACnF,MAAM,MAAM,GAAG,EAAC,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,YAAY,EAAC,CAAC;IAC5G,MAAM,SAAS,GAAU,EAAE,CAAC;IAC5B,KAAK,MAAM,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACjH,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;QACpD,MAAM,UAAU,GACd,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtG,IAAI,UAAU,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,aAAa,CAAC,GAAQ,EAAE,SAAyB;IAC/D,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;AAChF,CAAC"}

package/dist/react-platform/dom/scroll-lock.util.d.ts

@@ -0,0 +1,13 @@
+/** The page's own overflow, also while the tour has locked it. */
+export declare function pageOverflow(): {
+    readonly x: string;
+    readonly y: string;
+};
+/**
+ * Keeps the page from scrolling while the tour is open (wheel, touch, keyboard, overlay scrollbars), so
+ * the user cannot scroll the highlighted element out of view. Scrolling inside the tooltip still
+ * works, with the keyboard too, and so do keys that controls in the tooltip use themselves.
+ * Programmatic scrolling (the tour's own, or the app's) is not affected. Returns the cleanup.
+ */
+export declare function lockScroll(layer: HTMLElement): () => void;
+//# sourceMappingURL=scroll-lock.util.d.ts.map

package/dist/react-platform/dom/scroll-lock.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-lock.util.d.ts","sourceRoot":"","sources":["../../../src/react-platform/dom/scroll-lock.util.ts"],"names":[],"mappings":"AAuHA,kEAAkE;AAClE,wBAAgB,YAAY,IAAI;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAC,CAEvE;AAyED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,IAAI,CA2DzD"}

package/dist/react-platform/dom/scroll-lock.util.js

@@ -0,0 +1,219 @@
+import { handlesKey, hasLayout } from './elements.util.js';
+import { readPageOverflow } from './scroll.util.js';
+function canScroll(element, deltaX, deltaY) {
+    const style = getComputedStyle(element);
+    const scrollsY = /auto|scroll|overlay/u.test(style.overflowY) && element.scrollHeight > element.clientHeight;
+    const scrollsX = /auto|scroll|overlay/u.test(style.overflowX) && element.scrollWidth > element.clientWidth;
+    if (scrollsY && deltaY !== 0) {
+        const atTop = element.scrollTop <= 0;
+        const atBottom = element.scrollTop + element.clientHeight >= element.scrollHeight - 1;
+        if ((deltaY < 0 && !atTop) || (deltaY > 0 && !atBottom)) {
+            return true;
+        }
+    }
+    if (scrollsX && deltaX !== 0) {
+        const max = element.scrollWidth - element.clientWidth;
+        const position = Math.abs(element.scrollLeft);
+        if ((deltaX < 0 && position > 0) || (deltaX > 0 && position < max - 1)) {
+            return true;
+        }
+    }
+    return false;
+}
+/** True when `from` or one of its ancestors (up to `boundary`) can scroll further in the given direction. */
+function canScrollWithin(from, boundary, deltaX, deltaY) {
+    for (let element = from instanceof Element ? from : null; element && element !== boundary; element = element.parentElement) {
+        if (canScroll(element, deltaX, deltaY)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * The scrollable part of the tooltip (the built-in card's body, or a custom tooltip that does not
+ * fit) that can scroll in the given direction, when the focus is on the tooltip itself: browsers
+ * only scroll the focused element's ancestors with the keyboard, never its descendants.
+ */
+function scrollableInTooltip(from, layer, deltaY) {
+    const frame = from === layer
+        ? layer.querySelector('[data-rtk-tooltip]:not([data-hidden])')
+        : from instanceof Element
+            ? from.closest('[data-rtk-tooltip]')
+            : null;
+    if (!frame || !(from instanceof Element) || (from !== layer && !frame.contains(from))) {
+        return undefined;
+    }
+    return [frame, ...frame.querySelectorAll('*')].find((element) => canScroll(element, 0, deltaY));
+}
+/** How far each scrolling key scrolls: pixels, or `page` / `end`. */
+function keyScroll(event) {
+    // Ctrl/Cmd with an arrow goes all the way.
+    const arrowAmount = event.ctrlKey || event.metaKey ? 'end' : 40;
+    switch (event.key) {
+        case 'ArrowUp': {
+            return { direction: -1, amount: arrowAmount };
+        }
+        case 'ArrowDown': {
+            return { direction: 1, amount: arrowAmount };
+        }
+        case 'PageUp': {
+            return { direction: -1, amount: 'page' };
+        }
+        case 'Home': {
+            return { direction: -1, amount: 'end' };
+        }
+        case 'End': {
+            return { direction: 1, amount: 'end' };
+        }
+        default: {
+            // PageDown, and the space bar (with Shift: up).
+            return { direction: event.key === ' ' && event.shiftKey ? -1 : 1, amount: 'page' };
+        }
+    }
+}
+function prefersReducedMotion() {
+    return (typeof globalThis.matchMedia === 'function' && globalThis.matchMedia('(prefers-reduced-motion: reduce)').matches);
+}
+const scrollKeys = new Set(['PageUp', 'PageDown', 'Home', 'End', 'ArrowUp', 'ArrowDown', ' ']);
+/** Where smooth keyboard scrolls are heading, so quick presses add up like the browser's own. */
+const keyScrollDestinations = new WeakMap();
+const smoothScrollMs = 400;
+function scrollByKey(element, direction, amount) {
+    const max = element.scrollHeight - element.clientHeight;
+    const pending = keyScrollDestinations.get(element);
+    const from = pending && performance.now() - pending.at < smoothScrollMs ? pending.top : element.scrollTop;
+    const distance = amount === 'end' ? max : amount === 'page' ? element.clientHeight * 0.875 : amount;
+    const top = Math.min(max, Math.max(0, from + direction * distance));
+    const isSmooth = !prefersReducedMotion();
+    keyScrollDestinations.set(element, { top, at: performance.now() });
+    element.scrollTo({ top, behavior: isSmooth ? 'smooth' : 'instant' });
+}
+let pageLock;
+let pageLockUsers = 0;
+/** The page's own overflow, also while the tour has locked it. */
+export function pageOverflow() {
+    return pageLock?.overflow ?? readPageOverflow();
+}
+/**
+ * Hides the page's scrollbar (`overflow: hidden` on `<html>`), so it cannot be dragged while the
+ * tour is open; programmatic scrolling still works. Only where that cannot move anything: with
+ * overlay scrollbars, which take no space (macOS, mobile). Hiding a classic scrollbar would widen
+ * the page (browsers drop the space of styled scrollbars even with `scrollbar-gutter: stable`), and
+ * pages cannot block it (the wheel over it scrolls the page whatever its listeners do), so it stays
+ * usable; the tour keeps the target in view when it is used. Pages whose `<body>` has an overflow of
+ * its own, and pinch-zoomed pages, are left alone too.
+ */
+function lockPage() {
+    const overflow = readPageOverflow();
+    const root = document.documentElement;
+    const body = document.body ? getComputedStyle(document.body) : undefined;
+    const isRootOverflow = getComputedStyle(root).overflowY !== 'visible' ||
+        !body ||
+        (body.overflowX === 'visible' && body.overflowY === 'visible');
+    const hasClassicScrollbar = globalThis.innerWidth - root.clientWidth > 0.5 || globalThis.innerHeight - root.clientHeight > 0.5;
+    const isZoomed = Math.abs((globalThis.visualViewport?.scale ?? 1) - 1) >= 0.01;
+    if (!hasLayout() || !isRootOverflow || hasClassicScrollbar || isZoomed) {
+        return {
+            overflow,
+            release() {
+                // Nothing was changed.
+            },
+        };
+    }
+    const hadStyle = root.hasAttribute('style');
+    const previous = ['overflow-x', 'overflow-y'].map((property) => [property, root.style.getPropertyValue(property), root.style.getPropertyPriority(property)]);
+    root.style.setProperty('overflow-x', 'hidden');
+    root.style.setProperty('overflow-y', 'hidden');
+    return {
+        overflow,
+        release() {
+            for (const [property, value, priority] of previous) {
+                if (value) {
+                    root.style.setProperty(property, value, priority);
+                }
+                else {
+                    root.style.removeProperty(property);
+                }
+            }
+            if (!hadStyle && !root.getAttribute('style')) {
+                root.removeAttribute('style');
+            }
+        },
+    };
+}
+function acquirePageLock() {
+    pageLockUsers++;
+    pageLock ??= lockPage();
+    let isReleased = false;
+    return () => {
+        if (isReleased) {
+            return;
+        }
+        isReleased = true;
+        pageLockUsers--;
+        if (pageLockUsers === 0) {
+            pageLock?.release();
+            pageLock = undefined;
+        }
+    };
+}
+/**
+ * Keeps the page from scrolling while the tour is open (wheel, touch, keyboard, overlay scrollbars), so
+ * the user cannot scroll the highlighted element out of view. Scrolling inside the tooltip still
+ * works, with the keyboard too, and so do keys that controls in the tooltip use themselves.
+ * Programmatic scrolling (the tour's own, or the app's) is not affected. Returns the cleanup.
+ */
+export function lockScroll(layer) {
+    let touchX = 0;
+    let touchY = 0;
+    const releasePage = acquirePageLock();
+    const onWheel = (event) => {
+        if (!event.ctrlKey && !canScrollWithin(event.target, layer, event.deltaX, event.deltaY)) {
+            event.preventDefault();
+        }
+    };
+    const onTouchStart = (event) => {
+        const touch = event.touches[0];
+        if (touch) {
+            touchX = touch.clientX;
+            touchY = touch.clientY;
+        }
+    };
+    const onTouchMove = (event) => {
+        const touch = event.touches[0];
+        // Two fingers: pinch-zoom stays available.
+        if (!touch || event.touches.length > 1) {
+            return;
+        }
+        if (!canScrollWithin(event.target, layer, touchX - touch.clientX, touchY - touch.clientY)) {
+            event.preventDefault();
+        }
+    };
+    const onKeyDown = (event) => {
+        if (!scrollKeys.has(event.key) || event.defaultPrevented || handlesKey(event.target, event.key)) {
+            return;
+        }
+        const { direction, amount } = keyScroll(event);
+        if (canScrollWithin(event.target, layer, 0, direction)) {
+            // The browser scrolls the focused element's scrollable ancestor.
+            return;
+        }
+        event.preventDefault();
+        const scrollable = scrollableInTooltip(event.target, layer, direction);
+        if (scrollable) {
+            scrollByKey(scrollable, direction, amount);
+        }
+    };
+    layer.addEventListener('wheel', onWheel, { passive: false });
+    layer.addEventListener('touchstart', onTouchStart, { passive: true });
+    layer.addEventListener('touchmove', onTouchMove, { passive: false });
+    layer.addEventListener('keydown', onKeyDown);
+    return () => {
+        releasePage();
+        layer.removeEventListener('wheel', onWheel);
+        layer.removeEventListener('touchstart', onTouchStart);
+        layer.removeEventListener('touchmove', onTouchMove);
+        layer.removeEventListener('keydown', onKeyDown);
+    };
+}
+//# sourceMappingURL=scroll-lock.util.js.map

package/dist/react-platform/dom/scroll-lock.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-lock.util.js","sourceRoot":"","sources":["../../../src/react-platform/dom/scroll-lock.util.ts"],"names":[],"mappings":"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"}

package/dist/react-platform/dom/scroll.util.d.ts

@@ -0,0 +1,44 @@
+import type { Box } from '../../shared/geometry/geometry.type.js';
+import type { ScrollContainer } from '../../shared/platform/platform.type.js';
+/** Which axes of a scroll container the tour may scroll. */
+export type ScrollAxes = {
+    readonly x: boolean;
+    readonly y: boolean;
+};
+/** The page's own overflow per axis (from `<html>`, or from `<body>` when `<html>` has none). */
+export declare function readPageOverflow(): {
+    readonly x: string;
+    readonly y: string;
+};
+/** A computed length (`20px`, `10%`, `calc(10% + 20px)`) in pixels; percentages refer to `basis`. */
+export declare function resolveLength(value: string, basis: number): number;
+type Ancestors = {
+    /** Scroll containers that move the target, innermost first (the page itself is not included). */
+    readonly scrollers: ReadonlyArray<{
+        readonly element: Element;
+        readonly axes: ScrollAxes;
+    }>;
+    /** Intersection of every clipping ancestor's padding box, or `undefined` when nothing clips. */
+    readonly clip: Box | undefined;
+    /** True when the target sits inside a `position: fixed` element, so scrolling the page does not move it. */
+    readonly fixed: boolean;
+};
+/**
+ * Walks up from `element`, collecting the scroll containers and clipping that apply to it. An
+ * absolutely positioned element escapes the overflow of the ancestors between it and its
+ * containing block (a dropdown sticking out of a navigation bar); a fixed one escapes everything
+ * up to the page.
+ */
+export declare function inspectAncestors(element: Element): Ancestors;
+/** A nested scroll container. Horizontal offsets are normalised to [0, max] in right-to-left containers too. */
+export declare function elementContainer(element: Element, axes: ScrollAxes, occluders: () => readonly Box[]): ScrollContainer;
+/**
+ * The page itself; its visible area is the visual viewport minus safe areas and the page's
+ * scroll-padding. `overflow` is the page's own (see `readPageOverflow`), not the tour's scroll lock.
+ */
+export declare function pageContainer(occluders: () => readonly Box[], overflow: {
+    readonly x: string;
+    readonly y: string;
+}): ScrollContainer;
+export {};
+//# sourceMappingURL=scroll.util.d.ts.map

package/dist/react-platform/dom/scroll.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.util.d.ts","sourceRoot":"","sources":["../../../src/react-platform/dom/scroll.util.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,GAAG,EAAgB,MAAM,wCAAwC,CAAC;AAC/E,OAAO,KAAK,EAAC,eAAe,EAAwC,MAAM,wCAAwC,CAAC;AAanH,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAAG;IAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAA;CAAC,CAAC;AAcpE,iGAAiG;AACjG,wBAAgB,gBAAgB,IAAI;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAC,CAI3E;AAwCD,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAqBlE;AAYD,KAAK,SAAS,GAAG;IACf,iGAAiG;IACjG,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;KAAC,CAAC,CAAC;IAC1F,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,SAAS,CAAC;IAC/B,4GAA4G;IAC5G,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAmC5D;AAkBD,gHAAgH;AAChH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,GAAG,EAAE,GAAG,eAAe,CA+BrH;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,SAAS,GAAG,EAAE,EAC/B,QAAQ,EAAE;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAC,GACjD,eAAe,CAiCjB"}