@robertlinde/react-tour-kit 0.8.8 → 1.0.0

package/dist/shared/geometry/reveal.util.js

@@ -0,0 +1,135 @@
+import { bottom, right, zeroInsets } from './box.util.js';
+const fitSlack = 1e-6;
+/**
+ * How far a container has to scroll (positive: further down/right) so that the target plus a
+ * margin is inside `area` and clear of `obstacles` (elements that stay put while the content
+ * scrolls: sticky headers, floating buttons, cookie banners, any number of them).
+ *
+ * Per axis, the obstacles in the target's column (row) cut the area into free gaps. The target is
+ * moved into the gap that needs the least scrolling, so scrolling up and down behave the same. The
+ * first margin that fits is used (preferring one that fits on both axes). A target that only fits
+ * without margin is centred in the nearest gap that can hold it; a target that fits in no gap is
+ * aligned to the start of the largest one, keeping the smallest margin.
+ */
+export function computeRevealDelta(target, area, margins, obstacles = []) {
+    const candidates = margins.length > 0 ? margins : [zeroInsets];
+    const smallest = candidates.at(-1) ?? zeroInsets;
+    // Pages scroll vertically: the vertical gaps depend on the obstacles in the target's column, the
+    // horizontal ones on the obstacles in the row the target ends up in.
+    const ySegments = freeSegments(area.y, bottom(area), obstacles.filter((o) => o.x < right(target) && right(o) > target.x).map((o) => [o.y, bottom(o)]));
+    const xSegmentsAfter = (dy) => freeSegments(area.x, right(area), obstacles
+        .filter((o) => o.y < bottom(target) - dy && bottom(o) > target.y - dy)
+        .map((o) => [o.x, right(o)]));
+    const yAxis = { start: target.y, size: target.height };
+    const xAxis = { start: target.x, size: target.width };
+    // The first margin that fits on both axes (it may leave room for the tooltip on one side).
+    for (const margin of candidates) {
+        const y = fitDelta(yAxis, ySegments, [margin.top, margin.bottom]);
+        const x = y === undefined ? undefined : fitDelta(xAxis, xSegmentsAfter(y), [margin.left, margin.right]);
+        if (y !== undefined && x !== undefined) {
+            return { x, y };
+        }
+    }
+    // Otherwise each axis on its own.
+    const y = firstDefined(candidates, (m) => fitDelta(yAxis, ySegments, [m.top, m.bottom])) ??
+        fallbackDelta(yAxis, ySegments, smallest.top);
+    const xSegments = xSegmentsAfter(y);
+    const x = firstDefined(candidates, (m) => fitDelta(xAxis, xSegments, [m.left, m.right])) ??
+        fallbackDelta(xAxis, xSegments, smallest.left);
+    return { x, y };
+}
+function firstDefined(items, map) {
+    for (const item of items) {
+        const value = map(item);
+        if (value !== undefined) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/** The parts of `[from, to]` not covered by `blocked`. Fully blocked: the whole range (nothing can be avoided). */
+export function freeSegments(from, to, blocked) {
+    const sorted = [...blocked]
+        .map(([a, b]) => [Math.max(a, from), Math.min(b, to)])
+        .filter(([a, b]) => b > a)
+        // eslint-disable-next-line unicorn/no-array-sort -- sorting a fresh copy (ES2023 `toSorted` is not available on every supported React Native version)
+        .sort((a, b) => a[0] - b[0]);
+    const segments = [];
+    let cursor = from;
+    for (const [a, b] of sorted) {
+        if (a > cursor) {
+            segments.push({ from: cursor, to: a });
+        }
+        cursor = Math.max(cursor, b);
+    }
+    if (to > cursor) {
+        segments.push({ from: cursor, to });
+    }
+    return segments.length > 0 ? segments : [{ from, to }];
+}
+/** Smallest movement that puts `[from, to]` inside `segment`. */
+function deltaInto(from, to, segment) {
+    if (from < segment.from) {
+        return from - segment.from;
+    }
+    return to > segment.to ? to - segment.to : 0;
+}
+function smallestBy(items, score) {
+    let best;
+    let bestScore = Number.POSITIVE_INFINITY;
+    for (const item of items) {
+        const value = score(item);
+        if (value < bestScore) {
+            best = item;
+            bestScore = value;
+        }
+    }
+    return best;
+}
+/** The smallest movement that puts the target plus margin into a gap that can hold it, if any. */
+function fitDelta({ start, size }, segments, [before, after]) {
+    const from = start - before;
+    const to = start + size + after;
+    // Sub-pixel slack: gap widths computed from coordinates lose their last bits of precision.
+    const fitting = segments.filter((segment) => segment.to - segment.from >= to - from - fitSlack);
+    const best = smallestBy(fitting, (segment) => Math.abs(deltaInto(from, to, segment)));
+    return best ? deltaInto(from, to, best) : undefined;
+}
+/**
+ * When no margin fits: centre the target in the nearest gap that can hold it, or align it to the
+ * start of the largest gap (keeping `leadingMargin`) when it fits nowhere.
+ */
+function fallbackDelta({ start, size }, segments, leadingMargin) {
+    const centreDelta = (segment) => start + size / 2 - (segment.from + segment.to) / 2;
+    const holding = segments.filter((segment) => segment.to - segment.from >= size);
+    const nearest = smallestBy(holding, (segment) => Math.abs(centreDelta(segment)));
+    if (nearest) {
+        return centreDelta(nearest);
+    }
+    const largest = smallestBy(segments, (segment) => -(segment.to - segment.from)) ?? { from: start, to: start };
+    return start - Math.min(leadingMargin, (largest.to - largest.from) / 2) - largest.from;
+}
+/**
+ * Margins to keep around the target while scrolling it into view. The first entry also leaves
+ * room for the tooltip on the first side (in the given order) where target and tooltip fit on
+ * screen together. The last entry only keeps the highlight padding and viewport padding.
+ */
+export function buildRevealMargins(input) {
+    const base = input.highlightPadding + input.viewportPadding;
+    const baseMargin = { top: base, right: base, bottom: base, left: base };
+    for (const side of input.sides) {
+        const vertical = side === 'top' || side === 'bottom';
+        const room = input.gap + (vertical ? input.tooltip.height : input.tooltip.width);
+        const mainFits = vertical
+            ? input.target.height + base * 2 + room <= input.area.height
+            : input.target.width + base * 2 + room <= input.area.width;
+        const crossFits = vertical
+            ? input.tooltip.width + input.viewportPadding * 2 <= input.area.width
+            : input.tooltip.height + input.viewportPadding * 2 <= input.area.height;
+        if (mainFits && crossFits) {
+            return [{ ...baseMargin, [side]: base + room }, baseMargin];
+        }
+    }
+    return [baseMargin];
+}
+//# sourceMappingURL=reveal.util.js.map

package/dist/shared/geometry/reveal.util.js.map

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

package/dist/shared/geometry/target-visibility.util.d.ts

@@ -0,0 +1,10 @@
+import type { Box } from './geometry.type.js';
+/**
+ * How much of a target the user can see:
+ * - `full`: the whole target is visible, or, for targets larger than the area, it covers the area.
+ * - `partial`: at least half of what could be visible is visible on both axes.
+ * - `none`: anything less.
+ */
+export type TargetVisibility = 'full' | 'partial' | 'none';
+export declare function getTargetVisibility(target: Box, area: Box): TargetVisibility;
+//# sourceMappingURL=target-visibility.util.d.ts.map

package/dist/shared/geometry/target-visibility.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-visibility.util.d.ts","sourceRoot":"","sources":["../../../src/shared/geometry/target-visibility.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,oBAAoB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AA2B3D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,gBAAgB,CAQ5E"}

package/dist/shared/geometry/target-visibility.util.js

@@ -0,0 +1,29 @@
+function axisVisibility(start, size, areaStart, areaSize) {
+    const end = start + size;
+    const areaEnd = areaStart + areaSize;
+    if (areaSize <= 0) {
+        return 'none';
+    }
+    if (size === 0) {
+        return start >= areaStart && start <= areaEnd ? 'full' : 'none';
+    }
+    const fullyInside = start >= areaStart && end <= areaEnd;
+    const covers = start <= areaStart && end >= areaEnd;
+    if (size <= areaSize ? fullyInside : covers) {
+        return 'full';
+    }
+    const visible = Math.max(0, Math.min(end, areaEnd) - Math.max(start, areaStart));
+    if (visible === 0 || visible < Math.min(size, areaSize) / 2) {
+        return 'none';
+    }
+    return 'partial';
+}
+export function getTargetVisibility(target, area) {
+    const horizontal = axisVisibility(target.x, target.width, area.x, area.width);
+    const vertical = axisVisibility(target.y, target.height, area.y, area.height);
+    if (horizontal === 'none' || vertical === 'none') {
+        return 'none';
+    }
+    return horizontal === 'full' && vertical === 'full' ? 'full' : 'partial';
+}
+//# sourceMappingURL=target-visibility.util.js.map

package/dist/shared/geometry/target-visibility.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-visibility.util.js","sourceRoot":"","sources":["../../../src/shared/geometry/target-visibility.util.ts"],"names":[],"mappings":"AAUA,SAAS,cAAc,CAAC,KAAa,EAAE,IAAY,EAAE,SAAiB,EAAE,QAAgB;IACtF,MAAM,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC;IACzB,MAAM,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IACrC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,OAAO,KAAK,IAAI,SAAS,IAAI,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAClE,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,IAAI,SAAS,IAAI,GAAG,IAAI,OAAO,CAAC;IACzD,MAAM,MAAM,GAAG,KAAK,IAAI,SAAS,IAAI,GAAG,IAAI,OAAO,CAAC;IACpD,IAAI,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IACjF,IAAI,OAAO,KAAK,CAAC,IAAI,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAW,EAAE,IAAS;IACxD,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,UAAU,KAAK,MAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,UAAU,KAAK,MAAM,IAAI,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC"}

package/dist/shared/platform/create-tour-adapter.d.ts

@@ -0,0 +1,9 @@
+import type { TourAdapter } from '../engine/tour-adapter.type.js';
+import type { PlatformAdapter } from './platform.type.js';
+/**
+ * The tour's behaviour on top of a platform: waiting for targets, following them, and scrolling
+ * them into view. Shared by every platform, so they behave the same; platforms only provide the
+ * raw facts ({@link PlatformAdapter}).
+ */
+export declare function createTourAdapter(platform: PlatformAdapter): TourAdapter;
+//# sourceMappingURL=create-tour-adapter.d.ts.map

package/dist/shared/platform/create-tour-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-tour-adapter.d.ts","sourceRoot":"","sources":["../../../src/shared/platform/create-tour-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,WAAW,EAAC,MAAM,gCAAgC,CAAC;AAKnF,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAC;AAYxD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,WAAW,CA+HxE"}

package/dist/shared/platform/create-tour-adapter.js

@@ -0,0 +1,130 @@
+import { nextFrame, nextFrameOrAfter } from '../engine/abort.util.js';
+import { boxesEqual } from '../geometry/box.util.js';
+import { requestFrame } from '../utils/frame.util.js';
+import { revealInScrollContainers } from './reveal-in-scroll-containers.js';
+/** A found target counts as settled once it has not moved for this many frames (screens slide in, drawers expand)... */
+const stableFramesNeeded = 2;
+/** ...or after this many frames, so a target that never stops moving (a pulsing button) is still shown... */
+const maxSettleFrames = 12;
+/** ...or after this long: frames stop in background tabs, timers only slow down. */
+const maxSettleMs = 300;
+/** Longest wait for a frame while settling, for the same reason. */
+const settleFrameMs = 50;
+/**
+ * The tour's behaviour on top of a platform: waiting for targets, following them, and scrolling
+ * them into view. Shared by every platform, so they behave the same; platforms only provide the
+ * raw facts ({@link PlatformAdapter}).
+ */
+export function createTourAdapter(platform) {
+    return {
+        measure: platform.measure,
+        async waitForTarget(target, signal) {
+            // Subscribed for the whole wait, so a change between measuring and waiting is never missed.
+            let hasChanged = false;
+            let wake;
+            const unsubscribe = platform.subscribe(target, () => {
+                hasChanged = true;
+                wake?.();
+            });
+            const onAbort = () => {
+                wake?.();
+            };
+            const sleepUntilChange = async () => new Promise((resolve) => {
+                wake = resolve;
+            });
+            signal.addEventListener('abort', onAbort);
+            try {
+                let previous;
+                let stableFrames = 0;
+                let settleFrames = 0;
+                let firstSeenAt = 0;
+                while (!signal.aborted) {
+                    hasChanged = false;
+                    // eslint-disable-next-line no-await-in-loop -- measuring until the target is there and settled
+                    const current = await platform.measure(target);
+                    if (signal.aborted) {
+                        return undefined;
+                    }
+                    if (current) {
+                        stableFrames = previous && boxesEqual(current.rect, previous, 0.5) ? stableFrames + 1 : 0;
+                        firstSeenAt = settleFrames === 0 ? Date.now() : firstSeenAt;
+                        settleFrames++;
+                        const isSettled = stableFrames >= stableFramesNeeded ||
+                            settleFrames > maxSettleFrames ||
+                            Date.now() - firstSeenAt >= maxSettleMs;
+                        if (isSettled) {
+                            return current;
+                        }
+                        previous = current.rect;
+                        // eslint-disable-next-line no-await-in-loop -- see above
+                        await nextFrameOrAfter(signal, settleFrameMs);
+                        continue;
+                    }
+                    previous = undefined;
+                    stableFrames = 0;
+                    settleFrames = 0;
+                    if (platform.isAwaitingLayout(target)) {
+                        // eslint-disable-next-line no-await-in-loop -- see above
+                        await nextFrame(signal);
+                    }
+                    else if (!hasChanged) {
+                        // Not there yet: sleep until something changes instead of polling.
+                        // eslint-disable-next-line no-await-in-loop -- see above
+                        await sleepUntilChange();
+                        wake = undefined;
+                    }
+                }
+                return undefined;
+            }
+            finally {
+                signal.removeEventListener('abort', onAbort);
+                unsubscribe();
+            }
+        },
+        getViewport: platform.getViewport,
+        measuresWhileScrolling: platform.measuresWhileScrolling,
+        async reveal(target, request) {
+            const containers = await platform.scrollContainers(target);
+            if (request.signal.aborted) {
+                return;
+            }
+            await revealInScrollContainers({
+                containers,
+                async measureTarget() {
+                    const measurement = await platform.measure(target);
+                    return measurement?.rect;
+                },
+                margins: request.margins,
+                animated: request.behavior === 'smooth' && !platform.reducedMotion.get(),
+                signal: request.signal,
+                onScrollStart: request.onScrollStart,
+            });
+        },
+        observe(target, onChange, signal) {
+            if (signal.aborted) {
+                return;
+            }
+            // At most one call per frame, however many events arrive.
+            let cancelFrame;
+            const schedule = () => {
+                if (cancelFrame !== undefined || signal.aborted) {
+                    return;
+                }
+                cancelFrame = requestFrame(() => {
+                    cancelFrame = undefined;
+                    if (!signal.aborted) {
+                        onChange();
+                    }
+                });
+            };
+            const unsubscribe = platform.subscribe(target, schedule);
+            signal.addEventListener('abort', () => {
+                cancelFrame?.();
+                unsubscribe();
+            });
+        },
+        getPixelRatio: platform.getPixelRatio,
+        nextFrame,
+    };
+}
+//# sourceMappingURL=create-tour-adapter.js.map

package/dist/shared/platform/create-tour-adapter.js.map

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

package/dist/shared/platform/platform.type.d.ts

@@ -0,0 +1,77 @@
+import type { TargetMeasurement } from '../engine/tour-adapter.type.js';
+import type { Box, Point, Viewport } from '../geometry/geometry.type.js';
+import type { TourTarget } from '../types/tour-step.type.js';
+/**
+ * What the tour needs from a platform (web, React Native): raw facts about the screen and the
+ * app's views, and nothing else. Everything built on them — waiting for targets, following them,
+ * scrolling them into view, deciding when scrolling has finished — is shared (see
+ * `createTourAdapter`), so it behaves the same everywhere.
+ *
+ * Every member is required: a platform that lacks one does not compile.
+ */
+export type PlatformAdapter = {
+    /** Where the target is, in the tour layer's coordinates, or `undefined` when it is not rendered. */
+    readonly measure: (target: TourTarget) => Promise<TargetMeasurement | undefined>;
+    /**
+     * Calls `onChange` whenever the target, the layout around it or the viewport may have changed.
+     * Event-driven: no calls while nothing changes. Calling too often is fine (calls are coalesced
+     * per frame and results compared). Returns the unsubscribe function.
+     */
+    readonly subscribe: (target: TourTarget | undefined, onChange: () => void) => () => void;
+    /**
+     * True when the target exists but cannot be measured yet, and no event will announce when it
+     * can (React Native: registered, but not laid out yet). The tour then checks every frame.
+     */
+    readonly isAwaitingLayout: (target: TourTarget) => boolean;
+    /** The scroll containers around the target, innermost first, including the page where it scrolls. */
+    readonly scrollContainers: (target: TourTarget) => Promise<readonly ScrollContainer[]>;
+    /**
+     * The visible area of the tour layer and what covers its edges (safe areas, the on-screen
+     * keyboard). Pass the step's target so that a bar containing it does not count as covering it.
+     */
+    readonly getViewport: (target?: TourTarget) => Viewport;
+    /** Whether the user asked the system to reduce motion. */
+    readonly reducedMotion: ExternalValue<boolean>;
+    /**
+     * Whether `measure` sees targets move while a scroll animation runs. When it does not (React
+     * Native: on the New Architecture, measurements only catch up once a scroll has finished), the
+     * highlight moves straight to where the target will end up instead of following it.
+     */
+    readonly measuresWhileScrolling: boolean;
+    /** Device pixel ratio, used to place the tooltip on whole device pixels. */
+    readonly getPixelRatio: () => number;
+};
+/** A value that can change outside React (a system setting), readable with `useSyncExternalStore`. */
+export type ExternalValue<T> = {
+    readonly get: () => T;
+    readonly subscribe: (listener: () => void) => () => void;
+};
+/** One scrollable area between the target and the screen (a nested scroller, a list, or the page itself). */
+export type ScrollContainer = {
+    /** Current geometry, or `undefined` when the container is not rendered. */
+    readonly measure: () => Promise<ScrollContainerMetrics | undefined>;
+    /**
+     * Scrolls to `offset` and resolves once this container has finished scrolling (or cannot get
+     * further). Stops waiting as soon as `signal` is aborted.
+     */
+    readonly scrollTo: (offset: Point, options: ScrollOptions) => Promise<void>;
+};
+export type ScrollOptions = {
+    readonly animated: boolean;
+    readonly signal: AbortSignal;
+};
+export type ScrollContainerMetrics = {
+    /** The part of the container's viewport content should be revealed in (scroll-padding already applied), in layer coordinates. */
+    readonly area: Box;
+    readonly offset: Point;
+    /**
+     * The range the tour may scroll in, per axis. Usually `0` to the end of the content; on an axis
+     * the tour must not scroll (the app's own `overflow: hidden`), both are the current offset. Offsets
+     * can be negative at rest (content insets, centred content).
+     */
+    readonly minOffset: Point;
+    readonly maxOffset: Point;
+    /** Elements over this area that do not scroll with its content (sticky headers, floating buttons), in layer coordinates. */
+    readonly obstacles?: readonly Box[];
+};
+//# sourceMappingURL=platform.type.d.ts.map

package/dist/shared/platform/platform.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.type.d.ts","sourceRoot":"","sources":["../../../src/shared/platform/platform.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAC,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,4BAA4B,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,oGAAoG;IACpG,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;IACjF;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IACzF;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IAC3D,qGAAqG;IACrG,QAAQ,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;IACvF;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,UAAU,KAAK,QAAQ,CAAC;IACxD,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,EAAE,MAAM,MAAM,CAAC;CACtC,CAAC;AAEF,sGAAsG;AACtG,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CAC1D,CAAC;AAEF,6GAA6G;AAC7G,MAAM,MAAM,eAAe,GAAG;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAAC;IACpE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,iIAAiI;IACjI,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAC1B,4HAA4H;IAC5H,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,EAAE,CAAC;CACrC,CAAC"}

package/dist/shared/platform/platform.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform.type.js.map

package/dist/shared/platform/platform.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.type.js","sourceRoot":"","sources":["../../../src/shared/platform/platform.type.ts"],"names":[],"mappings":""}

package/dist/shared/platform/reveal-in-scroll-containers.d.ts

@@ -0,0 +1,27 @@
+import type { Box, Insets } from '../geometry/geometry.type.js';
+import type { ScrollContainer } from './platform.type.js';
+export type RevealOptions = {
+    /** Innermost container first. */
+    readonly containers: readonly ScrollContainer[];
+    readonly measureTarget: () => Promise<Box | undefined>;
+    /** Space to keep around the target, most generous first (see `buildRevealMargins`). */
+    readonly margins: readonly Insets[];
+    readonly animated: boolean;
+    readonly signal: AbortSignal;
+    /**
+     * Called once, right before the first container scrolls, with where the target will be once
+     * everything has scrolled. Not called if nothing needs to scroll.
+     */
+    readonly onScrollStart?: (destination: Box) => void;
+};
+/** Safety cap: a scroll that never reports finishing (interrupted, snapped elsewhere) does not hold the tour up longer. */
+export declare const settleTimeoutMs = 1500;
+/**
+ * Scrolls every container around the target just enough to bring it (plus margin) into view, all
+ * at once: each container's scroll is computed innermost first, on the position the target will
+ * have after the inner containers have scrolled (an inner scroll moves the target by exactly the
+ * scrolled distance), and then all containers scroll together as one movement. Resolves once every
+ * container has finished scrolling.
+ */
+export declare function revealInScrollContainers(options: RevealOptions): Promise<boolean>;
+//# sourceMappingURL=reveal-in-scroll-containers.d.ts.map

package/dist/shared/platform/reveal-in-scroll-containers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reveal-in-scroll-containers.d.ts","sourceRoot":"","sources":["../../../src/shared/platform/reveal-in-scroll-containers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,GAAG,EAAE,MAAM,EAAQ,MAAM,8BAA8B,CAAC;AAErE,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;IACvD,uFAAuF;IACvF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,KAAK,IAAI,CAAC;CACrD,CAAC;AAGF,2HAA2H;AAC3H,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA6CvF"}

package/dist/shared/platform/reveal-in-scroll-containers.js

@@ -0,0 +1,49 @@
+import { withTimeout } from '../engine/abort.util.js';
+import { clamp } from '../geometry/box.util.js';
+import { computeRevealDelta } from '../geometry/reveal.util.js';
+const minimumScroll = 0.5;
+/** Safety cap: a scroll that never reports finishing (interrupted, snapped elsewhere) does not hold the tour up longer. */
+export const settleTimeoutMs = 1500;
+/**
+ * Scrolls every container around the target just enough to bring it (plus margin) into view, all
+ * at once: each container's scroll is computed innermost first, on the position the target will
+ * have after the inner containers have scrolled (an inner scroll moves the target by exactly the
+ * scrolled distance), and then all containers scroll together as one movement. Resolves once every
+ * container has finished scrolling.
+ */
+export async function revealInScrollContainers(options) {
+    const metrics = await Promise.all(options.containers.map(async (container) => container.measure()));
+    let predicted = await options.measureTarget();
+    if (options.signal.aborted || !predicted) {
+        return false;
+    }
+    const moves = [];
+    for (const [index, container] of options.containers.entries()) {
+        const current = metrics[index];
+        if (!current) {
+            continue;
+        }
+        const delta = computeRevealDelta(predicted, current.area, options.margins, current.obstacles);
+        const offset = {
+            x: clamp(current.offset.x + delta.x, current.minOffset.x, Math.max(current.minOffset.x, current.maxOffset.x)),
+            y: clamp(current.offset.y + delta.y, current.minOffset.y, Math.max(current.minOffset.y, current.maxOffset.y)),
+        };
+        const applied = { x: offset.x - current.offset.x, y: offset.y - current.offset.y };
+        if (Math.abs(applied.x) < minimumScroll && Math.abs(applied.y) < minimumScroll) {
+            continue;
+        }
+        moves.push({ container, offset });
+        // Scrolling by `applied` moves the content (and the target) the other way.
+        predicted = { ...predicted, x: predicted.x - applied.x, y: predicted.y - applied.y };
+    }
+    if (moves.length === 0) {
+        return false;
+    }
+    options.onScrollStart?.(predicted);
+    await withTimeout(async (signal) => {
+        await Promise.all(moves.map(async (move) => move.container.scrollTo(move.offset, { animated: options.animated, signal })));
+        return true;
+    }, options.signal, settleTimeoutMs);
+    return true;
+}
+//# sourceMappingURL=reveal-in-scroll-containers.js.map

package/dist/shared/platform/reveal-in-scroll-containers.js.map

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

package/dist/shared/react/tour-context.d.ts

@@ -0,0 +1,7 @@
+import type { TourEngine } from '../engine/tour-engine.js';
+import type { TourContextType } from '../types/tour-context.type.js';
+/** Public tour state and actions (what `useTour()` returns). */
+export declare const TourContext: import("react").Context<TourContextType>;
+/** The engine, for the built-in renderer and platform hooks. Not part of the public API. */
+export declare const TourEngineContext: import("react").Context<TourEngine | undefined>;
+//# sourceMappingURL=tour-context.d.ts.map

package/dist/shared/react/tour-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-context.d.ts","sourceRoot":"","sources":["../../../src/shared/react/tour-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+BAA+B,CAAC;AAkBnE,gEAAgE;AAChE,eAAO,MAAM,WAAW,0CAAoC,CAAC;AAG7D,4FAA4F;AAC5F,eAAO,MAAM,iBAAiB,iDAAmD,CAAC"}

package/dist/shared/react/tour-context.js

@@ -0,0 +1,23 @@
+import { createContext } from 'react';
+import { devWarn } from '../engine/report.util.js';
+function outsideProvider() {
+    devWarn('useTour() was called outside of <TourProvider>; the call has no effect.');
+}
+const defaultTourContext = {
+    isActive: false,
+    currentStep: 0,
+    steps: [],
+    currentTourId: undefined,
+    startTour: outsideProvider,
+    endTour: outsideProvider,
+    nextStep: outsideProvider,
+    prevStep: outsideProvider,
+    goToStep: outsideProvider,
+};
+/** Public tour state and actions (what `useTour()` returns). */
+export const TourContext = createContext(defaultTourContext);
+TourContext.displayName = 'TourContext';
+/** The engine, for the built-in renderer and platform hooks. Not part of the public API. */
+export const TourEngineContext = createContext(undefined);
+TourEngineContext.displayName = 'TourEngineContext';
+//# sourceMappingURL=tour-context.js.map

package/dist/shared/react/tour-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-context.js","sourceRoot":"","sources":["../../../src/shared/react/tour-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,OAAO,CAAC;AACpC,OAAO,EAAC,OAAO,EAAC,MAAM,0BAA0B,CAAC;AAIjD,SAAS,eAAe;IACtB,OAAO,CAAC,yEAAyE,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,kBAAkB,GAAoB;IAC1C,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,CAAC;IACd,KAAK,EAAE,EAAE;IACT,aAAa,EAAE,SAAS;IACxB,SAAS,EAAE,eAAe;IAC1B,OAAO,EAAE,eAAe;IACxB,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,eAAe;CAC1B,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC;AAC7D,WAAW,CAAC,WAAW,GAAG,aAAa,CAAC;AAExC,4FAA4F;AAC5F,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAyB,SAAS,CAAC,CAAC;AAClF,iBAAiB,CAAC,WAAW,GAAG,mBAAmB,CAAC"}

package/dist/shared/react/tour-provider-core.d.ts

@@ -0,0 +1,41 @@
+import { type ComponentType, type ReactNode } from 'react';
+import type { TourEngine } from '../engine/tour-engine.js';
+import type { PlatformAdapter } from '../platform/platform.type.js';
+import type { TourRenderer } from '../renderer/renderer.type.js';
+import type { TourOverlayProps } from '../renderer/tour-overlay.js';
+import type { TourEndCallback } from '../types/tour-end-info.type.js';
+import type { TourI18n } from '../types/tour-i18n.type.js';
+import type { TourTheme } from '../types/tour-theme.type.js';
+import type { TourTooltipProps } from '../types/tour-tooltip-props.type.js';
+/** Props of `TourProvider` on every platform. Platforms may add their own (React Native: `insets`). */
+export type TourProviderBaseProps = {
+    readonly children?: ReactNode;
+    /** Colours of the built-in tooltip and overlay. */
+    readonly theme?: TourTheme;
+    /** Texts of the built-in tooltip. */
+    readonly i18n?: TourI18n;
+    /** Called once whenever a tour ends, after the tour's own `onTourEnd`. */
+    readonly onTourEnd?: TourEndCallback;
+    /**
+     * Whether clicking or tapping the dimmed area ends the tour (with the reason `'blur'`).
+     * @defaultValue `true`
+     */
+    readonly closeOnOverlayClick?: boolean;
+    /**
+     * Replaces the content of the tooltip card. The tour still measures, positions, animates and
+     * focuses it, and keeps it on screen.
+     */
+    readonly TooltipComponent?: ComponentType<TourTooltipProps>;
+};
+export type TourCore = {
+    readonly engine: TourEngine;
+    /** Everything the overlay needs; the platform renders `<TourOverlay {...overlay} />` where the tour is drawn. */
+    readonly overlay: TourOverlayProps;
+};
+/**
+ * What every `TourProvider` does, whatever the platform: creates the engine on top of the
+ * platform's facts, resolves theme and texts, and prepares the overlay. `platform` and `renderer`
+ * must keep their identity for the lifetime of the provider.
+ */
+export declare function useTourCore(props: TourProviderBaseProps, platform: PlatformAdapter, renderer: TourRenderer): TourCore;
+//# sourceMappingURL=tour-provider-core.d.ts.map

package/dist/shared/react/tour-provider-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-provider-core.d.ts","sourceRoot":"","sources":["../../../src/shared/react/tour-provider-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,aAAa,EAAE,KAAK,SAAS,EAA0C,MAAM,OAAO,CAAC;AAClG,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAElE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,qCAAqC,CAAC;AAK1E,uGAAuG;AACvG,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CAC7D,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,iHAAiH;IACjH,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,qBAAqB,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,GAAG,QAAQ,CAiBrH"}