@robertlinde/react-tour-kit 0.8.8 → 1.0.0

package/dist/shared/react/tour-provider-core.js

@@ -0,0 +1,24 @@
+import { useMemo, useState, useSyncExternalStore } from 'react';
+import { createTourAdapter } from '../platform/create-tour-adapter.js';
+import { DefaultTooltip } from '../renderer/default-tooltip.js';
+import { resolveI18n } from '../utils/i18n.util.js';
+import { resolveTheme } from '../utils/theme.util.js';
+import { useTourEngine } from './tour-root.js';
+const neverReduced = () => false;
+/**
+ * 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 function useTourCore(props, platform, renderer) {
+    const [adapter] = useState(() => createTourAdapter(platform));
+    const engine = useTourEngine(adapter, props.onTourEnd);
+    const isReducedMotion = useSyncExternalStore(platform.reducedMotion.subscribe, platform.reducedMotion.get, neverReduced);
+    const theme = useMemo(() => resolveTheme(props.theme), [props.theme]);
+    const i18n = useMemo(() => resolveI18n(props.i18n), [props.i18n]);
+    const Tooltip = props.TooltipComponent ?? DefaultTooltip;
+    const isOverlayDismissible = props.closeOnOverlayClick ?? true;
+    const overlay = useMemo(() => ({ engine, renderer, theme, i18n, Tooltip, isOverlayDismissible, isReducedMotion }), [engine, renderer, theme, i18n, Tooltip, isOverlayDismissible, isReducedMotion]);
+    return { engine, overlay };
+}
+//# sourceMappingURL=tour-provider-core.js.map

package/dist/shared/react/tour-provider-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-provider-core.js","sourceRoot":"","sources":["../../../src/shared/react/tour-provider-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAC,MAAM,OAAO,CAAC;AAElG,OAAO,EAAC,iBAAiB,EAAC,MAAM,oCAAoC,CAAC;AAErE,OAAO,EAAC,cAAc,EAAC,MAAM,gCAAgC,CAAC;AAO9D,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAC,YAAY,EAAC,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAC,aAAa,EAAC,MAAM,gBAAgB,CAAC;AA6B7C,MAAM,YAAY,GAAG,GAAY,EAAE,CAAC,KAAK,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAA4B,EAAE,QAAyB,EAAE,QAAsB;IACzG,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,oBAAoB,CAC1C,QAAQ,CAAC,aAAa,CAAC,SAAS,EAChC,QAAQ,CAAC,aAAa,CAAC,GAAG,EAC1B,YAAY,CACb,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,KAAK,CAAC,gBAAgB,IAAI,cAAc,CAAC;IACzD,MAAM,oBAAoB,GAAG,KAAK,CAAC,mBAAmB,IAAI,IAAI,CAAC;IAC/D,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CAAC,CAAC,EAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAC,CAAC,EACvF,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,eAAe,CAAC,CAChF,CAAC;IACF,OAAO,EAAC,MAAM,EAAE,OAAO,EAAC,CAAC;AAC3B,CAAC"}

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

@@ -0,0 +1,14 @@
+import { type ReactNode } from 'react';
+import type { TourAdapter } from '../engine/tour-adapter.type.js';
+import { type TourEngine } from '../engine/tour-engine.js';
+import type { TourEndCallback } from '../types/tour-end-info.type.js';
+/** Creates the engine once and keeps its options in sync with the latest props. */
+export declare function useTourEngine(adapter: TourAdapter, onTourEnd: TourEndCallback | undefined): TourEngine;
+type TourRootProps = {
+    readonly engine: TourEngine;
+    readonly children: ReactNode;
+};
+/** Provides the public tour context (for `useTour`) and the engine (for the renderer). */
+export declare function TourRoot({ engine, children }: TourRootProps): ReactNode;
+export {};
+//# sourceMappingURL=tour-root.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tour-root.d.ts","sourceRoot":"","sources":["../../../src/shared/react/tour-root.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,SAAS,EAAqD,MAAM,OAAO,CAAC;AACzF,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAmB,KAAK,UAAU,EAAC,MAAM,0BAA0B,CAAC;AAE3E,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,gCAAgC,CAAC;AAIpE,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,GAAG,SAAS,GAAG,UAAU,CAQtG;AAED,KAAK,aAAa,GAAG;IACnB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,QAAQ,CAAC,EAAC,MAAM,EAAE,QAAQ,EAAC,EAAE,aAAa,GAAG,SAAS,CAQrE"}

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

@@ -0,0 +1,22 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useMemo, useState, useSyncExternalStore } from 'react';
+import { createTourEngine } from '../engine/tour-engine.js';
+import { TourContext, TourEngineContext } from './tour-context.js';
+import { useIsomorphicLayoutEffect } from './use-isomorphic-layout-effect.hook.js';
+/** Creates the engine once and keeps its options in sync with the latest props. */
+export function useTourEngine(adapter, onTourEnd) {
+    const [engine] = useState(() => createTourEngine({ adapter, onTourEnd }));
+    // Latest props: callback identity never matters, so inline callbacks cannot restart anything.
+    useIsomorphicLayoutEffect(() => {
+        engine.configure({ adapter, onTourEnd });
+    });
+    useEffect(() => engine.mount(), [engine]);
+    return engine;
+}
+/** Provides the public tour context (for `useTour`) and the engine (for the renderer). */
+export function TourRoot({ engine, children }) {
+    const state = useSyncExternalStore(engine.subscribe, engine.getPublicState, engine.getPublicState);
+    const value = useMemo(() => ({ ...state, ...engine.actions }), [state, engine]);
+    return (_jsx(TourEngineContext.Provider, { value: engine, children: _jsx(TourContext.Provider, { value: value, children: children }) }));
+}
+//# sourceMappingURL=tour-root.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tour-root.js","sourceRoot":"","sources":["../../../src/shared/react/tour-root.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAiB,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAC,MAAM,OAAO,CAAC;AAEzF,OAAO,EAAC,gBAAgB,EAAkB,MAAM,0BAA0B,CAAC;AAG3E,OAAO,EAAC,WAAW,EAAE,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAC,yBAAyB,EAAC,MAAM,wCAAwC,CAAC;AAEjF,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAAC,OAAoB,EAAE,SAAsC;IACxF,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,EAAC,OAAO,EAAE,SAAS,EAAC,CAAC,CAAC,CAAC;IACxE,8FAA8F;IAC9F,yBAAyB,CAAC,GAAG,EAAE;QAC7B,MAAM,CAAC,SAAS,CAAC,EAAC,OAAO,EAAE,SAAS,EAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD,0FAA0F;AAC1F,MAAM,UAAU,QAAQ,CAAC,EAAC,MAAM,EAAE,QAAQ,EAAgB;IACxD,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IACnG,MAAM,KAAK,GAAG,OAAO,CAAkB,GAAG,EAAE,CAAC,CAAC,EAAC,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC,OAAO,EAAC,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/F,OAAO,CACL,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YACvC,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAwB,GAC1C,CAC9B,CAAC;AACJ,CAAC"}

package/dist/shared/react/use-isomorphic-layout-effect.hook.d.ts

@@ -0,0 +1,4 @@
+import { useLayoutEffect } from 'react';
+/** `useLayoutEffect` in the browser and on React Native; `useEffect` during server rendering (avoids React 18's SSR warning). */
+export declare const useIsomorphicLayoutEffect: typeof useLayoutEffect;
+//# sourceMappingURL=use-isomorphic-layout-effect.hook.d.ts.map

package/dist/shared/react/use-isomorphic-layout-effect.hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-isomorphic-layout-effect.hook.d.ts","sourceRoot":"","sources":["../../../src/shared/react/use-isomorphic-layout-effect.hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,eAAe,EAAC,MAAM,OAAO,CAAC;AAKjD,iIAAiI;AACjI,eAAO,MAAM,yBAAyB,wBAAmD,CAAC"}

package/dist/shared/react/use-isomorphic-layout-effect.hook.js

@@ -0,0 +1,5 @@
+import { useEffect, useLayoutEffect } from 'react';
+const canUseLayoutEffect = typeof document !== 'undefined' || (typeof navigator !== 'undefined' && navigator.product === 'ReactNative');
+/** `useLayoutEffect` in the browser and on React Native; `useEffect` during server rendering (avoids React 18's SSR warning). */
+export const useIsomorphicLayoutEffect = canUseLayoutEffect ? useLayoutEffect : useEffect;
+//# sourceMappingURL=use-isomorphic-layout-effect.hook.js.map

package/dist/shared/react/use-isomorphic-layout-effect.hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-isomorphic-layout-effect.hook.js","sourceRoot":"","sources":["../../../src/shared/react/use-isomorphic-layout-effect.hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,eAAe,EAAC,MAAM,OAAO,CAAC;AAEjD,MAAM,kBAAkB,GACtB,OAAO,QAAQ,KAAK,WAAW,IAAI,CAAC,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC;AAE/G,iIAAiI;AACjI,MAAM,CAAC,MAAM,yBAAyB,GAAG,kBAAkB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC"}

package/dist/shared/react/use-tour-view.hook.d.ts

@@ -0,0 +1,5 @@
+import type { TourEngine, TourViewState } from '../engine/tour-engine.js';
+export declare function useTourEngineContext(): TourEngine;
+/** What the renderer draws. Re-renders only on structural changes (step, phase, layout). */
+export declare function useTourView(engine: TourEngine): TourViewState;
+//# sourceMappingURL=use-tour-view.hook.d.ts.map

package/dist/shared/react/use-tour-view.hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tour-view.hook.d.ts","sourceRoot":"","sources":["../../../src/shared/react/use-tour-view.hook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,UAAU,EAAE,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAGxE,wBAAgB,oBAAoB,IAAI,UAAU,CAOjD;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAE7D"}

package/dist/shared/react/use-tour-view.hook.js

@@ -0,0 +1,14 @@
+import { useContext, useSyncExternalStore } from 'react';
+import { TourEngineContext } from './tour-context.js';
+export function useTourEngineContext() {
+    const engine = useContext(TourEngineContext);
+    if (!engine) {
+        throw new Error('[react-tour-kit] This component must be rendered inside <TourProvider>.');
+    }
+    return engine;
+}
+/** What the renderer draws. Re-renders only on structural changes (step, phase, layout). */
+export function useTourView(engine) {
+    return useSyncExternalStore(engine.subscribe, engine.getViewState, engine.getViewState);
+}
+//# sourceMappingURL=use-tour-view.hook.js.map

package/dist/shared/react/use-tour-view.hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tour-view.hook.js","sourceRoot":"","sources":["../../../src/shared/react/use-tour-view.hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,oBAAoB,EAAC,MAAM,OAAO,CAAC;AAEvD,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAEpD,MAAM,UAAU,oBAAoB;IAClC,MAAM,MAAM,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,WAAW,CAAC,MAAkB;IAC5C,OAAO,oBAAoB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;AAC1F,CAAC"}

package/dist/shared/react/use-tour.hook.d.ts

@@ -0,0 +1,7 @@
+import type { TourContextType } from '../types/tour-context.type.js';
+/**
+ * The current tour's state and the functions to control it. The functions keep their identity for
+ * the lifetime of the `TourProvider`, so they are safe to use in effect dependencies.
+ */
+export declare function useTour(): TourContextType;
+//# sourceMappingURL=use-tour.hook.d.ts.map

package/dist/shared/react/use-tour.hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tour.hook.d.ts","sourceRoot":"","sources":["../../../src/shared/react/use-tour.hook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+BAA+B,CAAC;AAGnE;;;GAGG;AACH,wBAAgB,OAAO,IAAI,eAAe,CAEzC"}

package/dist/shared/react/use-tour.hook.js

@@ -0,0 +1,10 @@
+import { useContext } from 'react';
+import { TourContext } from './tour-context.js';
+/**
+ * The current tour's state and the functions to control it. The functions keep their identity for
+ * the lifetime of the `TourProvider`, so they are safe to use in effect dependencies.
+ */
+export function useTour() {
+    return useContext(TourContext);
+}
+//# sourceMappingURL=use-tour.hook.js.map

package/dist/shared/react/use-tour.hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tour.hook.js","sourceRoot":"","sources":["../../../src/shared/react/use-tour.hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AAEjC,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC"}

package/dist/shared/renderer/default-tooltip.d.ts

@@ -0,0 +1,5 @@
+import type { ReactNode } from 'react';
+import type { TourTooltipProps } from '../types/tour-tooltip-props.type.js';
+/** The built-in tooltip: the same structure and texts on every platform, drawn with the platform's card parts. */
+export declare function DefaultTooltip(props: TourTooltipProps): ReactNode;
+//# sourceMappingURL=default-tooltip.d.ts.map

package/dist/shared/renderer/default-tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-tooltip.d.ts","sourceRoot":"","sources":["../../../src/shared/renderer/default-tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,qCAAqC,CAAC;AAI1E,kHAAkH;AAClH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CA6CjE"}

package/dist/shared/renderer/default-tooltip.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRendererContext } from './renderer-context.js';
+import { tooltipModel } from './tooltip-model.js';
+/** The built-in tooltip: the same structure and texts on every platform, drawn with the platform's card parts. */
+export function DefaultTooltip(props) {
+    const { renderer, i18n } = useRendererContext();
+    const { Card, Arrow, Header, Counter, CloseButton, Body, Title, Content, Footer, Button, Dots, Dot, Ellipsis } = renderer.card;
+    const model = tooltipModel(props, i18n);
+    return (_jsxs(Card, { placement: props.placement, children: [model.arrow ? _jsx(Arrow, { side: model.arrow.side, offset: model.arrow.offset }) : null, _jsxs(Header, { children: [_jsx(Counter, { text: model.counter }), _jsx(CloseButton, { label: model.closeLabel, onPress: props.onClose })] }), _jsxs(Body, { children: [_jsx(Title, { id: props.titleId, children: props.step.title }), _jsx(Content, { id: props.descriptionId, children: props.step.content })] }), _jsxs(Footer, { children: [_jsx(Button, { kind: "previous", label: model.previous.label, isDisabled: model.previous.isDisabled, onPress: props.onPrev }), model.dots ? (_jsx(Dots, { label: model.counter, children: model.dots.map((dot) => dot.kind === 'ellipsis' ? (_jsx(Ellipsis, {}, dot.key)) : (_jsx(Dot, { label: dot.label, isCurrent: dot.isCurrent, onPress: () => {
+                                props.onGoToStep(dot.index);
+                            } }, dot.index))) })) : null, _jsx(Button, { kind: "next", label: model.next.label, isDisabled: false, onPress: props.onNext })] })] }));
+}
+//# sourceMappingURL=default-tooltip.js.map

package/dist/shared/renderer/default-tooltip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-tooltip.js","sourceRoot":"","sources":["../../../src/shared/renderer/default-tooltip.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAEhD,kHAAkH;AAClH,MAAM,UAAU,cAAc,CAAC,KAAuB;IACpD,MAAM,EAAC,QAAQ,EAAE,IAAI,EAAC,GAAG,kBAAkB,EAAE,CAAC;IAC9C,MAAM,EAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAC,GAC1G,QAAQ,CAAC,IAAI,CAAC;IAChB,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACxC,OAAO,CACL,MAAC,IAAI,IAAC,SAAS,EAAE,KAAK,CAAC,SAAS,aAC7B,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAC,KAAK,IAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAI,CAAC,CAAC,CAAC,IAAI,EACnF,MAAC,MAAM,eACL,KAAC,OAAO,IAAC,IAAI,EAAE,KAAK,CAAC,OAAO,GAAI,EAChC,KAAC,WAAW,IAAC,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,GAAI,IACzD,EACT,MAAC,IAAI,eACH,KAAC,KAAK,IAAC,EAAE,EAAE,KAAK,CAAC,OAAO,YAAG,KAAK,CAAC,IAAI,CAAC,KAAK,GAAS,EACpD,KAAC,OAAO,IAAC,EAAE,EAAE,KAAK,CAAC,aAAa,YAAG,KAAK,CAAC,IAAI,CAAC,OAAO,GAAW,IAC3D,EACP,MAAC,MAAM,eACL,KAAC,MAAM,IACL,IAAI,EAAC,UAAU,EACf,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,EAC3B,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU,EACrC,OAAO,EAAE,KAAK,CAAC,MAAM,GACrB,EACD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CACZ,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,OAAO,YACvB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACtB,GAAG,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CACxB,KAAC,QAAQ,MAAM,GAAG,CAAC,GAAG,CAAI,CAC3B,CAAC,CAAC,CAAC,CACF,KAAC,GAAG,IAEF,KAAK,EAAE,GAAG,CAAC,KAAK,EAChB,SAAS,EAAE,GAAG,CAAC,SAAS,EACxB,OAAO,EAAE,GAAG,EAAE;gCACZ,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;4BAC9B,CAAC,IALI,GAAG,CAAC,KAAK,CAMd,CACH,CACF,GACI,CACR,CAAC,CAAC,CAAC,IAAI,EACR,KAAC,MAAM,IAAC,IAAI,EAAC,MAAM,EAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,GAAI,IAClF,IACJ,CACR,CAAC;AACJ,CAAC"}

package/dist/shared/renderer/motion.d.ts

@@ -0,0 +1,29 @@
+import type { TourPlacement } from '../types/tour-step.type.js';
+import type { Entrance } from './renderer.type.js';
+/** Timing of every animation, the same on every platform. */
+export declare const motion: {
+    readonly fadeInMs: 200;
+    readonly fadeOutMs: 150;
+    /** With reduced motion turned on: short fades, no movement. */
+    readonly reducedMs: 100;
+    /** The spotlight moving from one target to the next. */
+    readonly morphMs: 250;
+    /** The spotlight following a target that is being scrolled into view, frame by frame. */
+    readonly chaseMs: 120;
+    readonly enterMs: 200;
+    /** The tooltip starts entering while the spotlight is still on its way. */
+    readonly enterDelayMs: 100;
+    /** Distance (from the target's side) and scale the tooltip enters from. */
+    readonly enterOffset: 6;
+    readonly enterScale: 0.96;
+    /** If the first step takes longer than this to prepare (navigation, data), the screen is dimmed meanwhile. */
+    readonly waitingDimDelayMs: 300;
+    /** Control points of the standard easing curve (`cubic-bezier`). */
+    readonly easing: readonly [0.2, 0, 0, 1];
+};
+export declare function fadeDuration(isClosing: boolean, isReducedMotion: boolean): number;
+export declare function entranceFor(placement: TourPlacement | 'center', { isDelayed, isReducedMotion }: {
+    readonly isDelayed: boolean;
+    readonly isReducedMotion: boolean;
+}): Entrance;
+//# sourceMappingURL=motion.d.ts.map

package/dist/shared/renderer/motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../../src/shared/renderer/motion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,oBAAoB,CAAC;AAEjD,6DAA6D;AAC7D,eAAO,MAAM,MAAM;;;IAGjB,+DAA+D;;IAE/D,wDAAwD;;IAExD,yFAAyF;;;IAGzF,2EAA2E;;IAE3E,2EAA2E;;;IAG3E,8GAA8G;;IAE9G,oEAAoE;;CAE5D,CAAC;AAEX,wBAAgB,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,GAAG,MAAM,CAMjF;AAWD,wBAAgB,WAAW,CACzB,SAAS,EAAE,aAAa,GAAG,QAAQ,EACnC,EAAC,SAAS,EAAE,eAAe,EAAC,EAAE;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAC,GAC7F,QAAQ,CAaV"}

package/dist/shared/renderer/motion.js

@@ -0,0 +1,49 @@
+/** Timing of every animation, the same on every platform. */
+export const motion = {
+    fadeInMs: 200,
+    fadeOutMs: 150,
+    /** With reduced motion turned on: short fades, no movement. */
+    reducedMs: 100,
+    /** The spotlight moving from one target to the next. */
+    morphMs: 250,
+    /** The spotlight following a target that is being scrolled into view, frame by frame. */
+    chaseMs: 120,
+    enterMs: 200,
+    /** The tooltip starts entering while the spotlight is still on its way. */
+    enterDelayMs: 100,
+    /** Distance (from the target's side) and scale the tooltip enters from. */
+    enterOffset: 6,
+    enterScale: 0.96,
+    /** If the first step takes longer than this to prepare (navigation, data), the screen is dimmed meanwhile. */
+    waitingDimDelayMs: 300,
+    /** Control points of the standard easing curve (`cubic-bezier`). */
+    easing: [0.2, 0, 0, 1],
+};
+export function fadeDuration(isClosing, isReducedMotion) {
+    if (isReducedMotion) {
+        return motion.reducedMs;
+    }
+    return isClosing ? motion.fadeOutMs : motion.fadeInMs;
+}
+const entranceDirection = {
+    // Above the target: comes down towards it; below: comes up; and so on.
+    top: [0, 1],
+    bottom: [0, -1],
+    left: [1, 0],
+    right: [-1, 0],
+    center: [0, 0],
+};
+export function entranceFor(placement, { isDelayed, isReducedMotion }) {
+    if (isReducedMotion) {
+        return { dx: 0, dy: 0, scale: 1, durationMs: motion.reducedMs, delayMs: 0 };
+    }
+    const [x, y] = entranceDirection[placement];
+    return {
+        dx: x * motion.enterOffset,
+        dy: y * motion.enterOffset,
+        scale: motion.enterScale,
+        durationMs: motion.enterMs,
+        delayMs: isDelayed ? motion.enterDelayMs : 0,
+    };
+}
+//# sourceMappingURL=motion.js.map

package/dist/shared/renderer/motion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.js","sourceRoot":"","sources":["../../../src/shared/renderer/motion.ts"],"names":[],"mappings":"AAGA,6DAA6D;AAC7D,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,QAAQ,EAAE,GAAG;IACb,SAAS,EAAE,GAAG;IACd,+DAA+D;IAC/D,SAAS,EAAE,GAAG;IACd,wDAAwD;IACxD,OAAO,EAAE,GAAG;IACZ,yFAAyF;IACzF,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;IACZ,2EAA2E;IAC3E,YAAY,EAAE,GAAG;IACjB,2EAA2E;IAC3E,WAAW,EAAE,CAAC;IACd,UAAU,EAAE,IAAI;IAChB,8GAA8G;IAC9G,iBAAiB,EAAE,GAAG;IACtB,oEAAoE;IACpE,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;CACd,CAAC;AAEX,MAAM,UAAU,YAAY,CAAC,SAAkB,EAAE,eAAwB;IACvE,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,OAAO,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;AACxD,CAAC;AAED,MAAM,iBAAiB,GAAgE;IACrF,uEAAuE;IACvE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACf,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACZ,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACd,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;CACf,CAAC;AAEF,MAAM,UAAU,WAAW,CACzB,SAAmC,EACnC,EAAC,SAAS,EAAE,eAAe,EAAmE;IAE9F,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,EAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,EAAC,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO;QACL,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW;QAC1B,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW;QAC1B,KAAK,EAAE,MAAM,CAAC,UAAU;QACxB,UAAU,EAAE,MAAM,CAAC,OAAO;QAC1B,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;KAC7C,CAAC;AACJ,CAAC"}

package/dist/shared/renderer/renderer-context.d.ts

@@ -0,0 +1,17 @@
+import type { ResolvedI18n } from '../utils/i18n.util.js';
+import type { ResolvedTheme } from '../utils/theme.util.js';
+import type { TourRenderer } from './renderer.type.js';
+export type RendererContextValue = {
+    readonly renderer: TourRenderer;
+    readonly theme: ResolvedTheme;
+    readonly i18n: ResolvedI18n;
+};
+/** The platform's primitives, the theme and the texts, for everything drawn inside the tour. Internal. */
+export declare const RendererContext: import("react").Context<RendererContextValue | undefined>;
+export declare function useRendererContext(): RendererContextValue;
+export type TooltipLimits = {
+    readonly maxWidth: number;
+    readonly maxHeight: number;
+};
+export declare const TooltipLimitsContext: import("react").Context<TooltipLimits>;
+//# sourceMappingURL=renderer-context.d.ts.map

package/dist/shared/renderer/renderer-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-context.d.ts","sourceRoot":"","sources":["../../../src/shared/renderer/renderer-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,0GAA0G;AAC1G,eAAO,MAAM,eAAe,2DAA6D,CAAC;AAG1F,wBAAgB,kBAAkB,IAAI,oBAAoB,CAOzD;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAIF,eAAO,MAAM,oBAAoB,wCAA+B,CAAC"}

package/dist/shared/renderer/renderer-context.js

@@ -0,0 +1,16 @@
+import { createContext, useContext } from 'react';
+/** The platform's primitives, the theme and the texts, for everything drawn inside the tour. Internal. */
+export const RendererContext = createContext(undefined);
+RendererContext.displayName = 'TourRendererContext';
+export function useRendererContext() {
+    const value = useContext(RendererContext);
+    if (!value) {
+        throw new Error('[react-tour-kit] The built-in tooltip can only be rendered by the tour.');
+    }
+    return value;
+}
+/** Size limits of the tooltip being rendered; platforms that cannot express them in styles size the card with them. */
+const defaultLimits = { maxWidth: 380, maxHeight: 600 };
+export const TooltipLimitsContext = createContext(defaultLimits);
+TooltipLimitsContext.displayName = 'TourTooltipLimitsContext';
+//# sourceMappingURL=renderer-context.js.map

package/dist/shared/renderer/renderer-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-context.js","sourceRoot":"","sources":["../../../src/shared/renderer/renderer-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,UAAU,EAAC,MAAM,OAAO,CAAC;AAWhD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAmC,SAAS,CAAC,CAAC;AAC1F,eAAe,CAAC,WAAW,GAAG,qBAAqB,CAAC;AAEpD,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAOD,uHAAuH;AACvH,MAAM,aAAa,GAAkB,EAAC,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAC,CAAC;AACrE,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;AACjE,oBAAoB,CAAC,WAAW,GAAG,0BAA0B,CAAC"}

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

@@ -0,0 +1,164 @@
+import type { ComponentType, ReactNode } from 'react';
+import type { TourPhase } from '../engine/tour-engine.js';
+import type { TooltipLayout } from '../geometry/compute-tooltip-layout.util.js';
+import type { Box, Point, Side, Size } from '../geometry/geometry.type.js';
+import type { TourPlacement } from '../types/tour-step.type.js';
+import type { ResolvedTheme } from '../utils/theme.util.js';
+/**
+ * How a platform draws the tour: primitives only. Every decision — what is visible, when and how
+ * things animate, which texts are shown, what a press means — is made by the shared overlay
+ * (`TourOverlay`) and default tooltip (`DefaultTooltip`), so all platforms behave the same.
+ *
+ * Every primitive is required: a platform that lacks one does not compile. A new feature either
+ * lives in the shared code (and every platform gets it), or needs a new primitive here (and every
+ * platform has to draw it).
+ */
+export type TourRenderer = {
+    /** The full-screen layer everything else is drawn in. */
+    readonly Layer: ComponentType<LayerProps>;
+    /** The area behind the spotlight that receives presses on the dimmed part of the screen. */
+    readonly Backdrop: ComponentType<BackdropProps>;
+    /** The dimmed overlay with a hole over the target. */
+    readonly Spotlight: ComponentType<SpotlightProps>;
+    /** Places the tooltip, plays its entrance, reports its size and takes focus. */
+    readonly TooltipFrame: ComponentType<TooltipFrameProps>;
+    /** Renders a tooltip invisibly with given size limits and reports its size. */
+    readonly MeasureFrame: ComponentType<MeasureFrameProps>;
+    /** The pieces of the built-in tooltip card. */
+    readonly card: CardParts;
+};
+/** What the user asked for through platform input (keys, gestures, system buttons). */
+export type TourIntent = 
+/** Go to the next step. */
+'next'
+/** Go to the previous step. */
+ | 'previous'
+/** Leave the tour like Escape does (ends with `'escape'`). */
+ | 'escape'
+/** Leave the tour with a system back action (ends with `'closed'`). */
+ | 'back';
+export type LayerProps = {
+    readonly children: ReactNode;
+    readonly state: TourPhase | 'closing';
+    /** Faded in (`true`) or out, over `fadeMs`. */
+    readonly isVisible: boolean;
+    readonly fadeMs: number;
+    /** False while fading out: input is no longer handled. */
+    readonly isInteractive: boolean;
+    readonly theme: ResolvedTheme;
+    /** Id of the element showing the step's title, `undefined` while no step is shown. */
+    readonly titleId: string | undefined;
+    /** Id of the element showing the step's content, `undefined` while no step is shown. */
+    readonly descriptionId: string | undefined;
+    /** Accessible name for when a custom tooltip renders no element with `titleId`. */
+    readonly fallbackLabel: string;
+    /** Text for screen readers when the step changes; empty when there is nothing to announce. */
+    readonly announcement: string;
+    /** Changes whenever a step is shown. */
+    readonly stepKey: number | undefined;
+    readonly onIntent: (intent: TourIntent) => void;
+};
+export type BackdropProps = {
+    /** Whether a press closes the tour (to show it with a pointer cursor, for example). */
+    readonly isDismissible: boolean;
+    /** A press on the dimmed area, at a point in layer coordinates. */
+    readonly onPress: (point: Point) => void;
+};
+export type SpotlightProps = {
+    /** The hole over the target, or `undefined`: no hole, everything dimmed (shrunk to the layer's centre). */
+    readonly hole: Box | undefined;
+    /** How changes are animated; `undefined`: applied instantly. */
+    readonly transition: SpotlightTransition | undefined;
+    readonly theme: ResolvedTheme;
+};
+export type SpotlightTransition = {
+    readonly durationMs: number;
+    readonly easing: 'standard' | 'linear';
+};
+export type TooltipFrameProps = {
+    readonly children: ReactNode;
+    readonly layout: TooltipLayout;
+    /** Played once, when the frame mounts. */
+    readonly entrance: Entrance;
+    /** A step change is being prepared: ignore presses. */
+    readonly isBusy: boolean;
+    /** The next target is being scrolled into view: hide the tooltip (keep its size). */
+    readonly isHidden: boolean;
+    readonly onSize: (size: Size) => void;
+    readonly onIntent: (intent: TourIntent) => void;
+};
+/** The tooltip's entrance: from this offset, scale and transparency to its place, after `delayMs`. */
+export type Entrance = {
+    readonly dx: number;
+    readonly dy: number;
+    readonly scale: number;
+    readonly durationMs: number;
+    readonly delayMs: number;
+};
+export type MeasureFrameProps = {
+    readonly children: ReactNode;
+    readonly maxWidth: number;
+    readonly maxHeight: number;
+    readonly onSize: (size: Size) => void;
+};
+/** The pieces of the built-in tooltip, put together by the shared `DefaultTooltip`. */
+export type CardParts = {
+    readonly Card: ComponentType<CardProps>;
+    readonly Arrow: ComponentType<ArrowProps>;
+    readonly Header: ComponentType<ContainerProps>;
+    readonly Counter: ComponentType<CounterProps>;
+    readonly CloseButton: ComponentType<CloseButtonProps>;
+    /** Scrolls when the content is taller than the space available. */
+    readonly Body: ComponentType<ContainerProps>;
+    readonly Title: ComponentType<TextPartProps>;
+    readonly Content: ComponentType<TextPartProps>;
+    readonly Footer: ComponentType<ContainerProps>;
+    readonly Button: ComponentType<ButtonProps>;
+    readonly Dots: ComponentType<DotsProps>;
+    readonly Dot: ComponentType<DotProps>;
+    readonly Ellipsis: ComponentType<EllipsisProps>;
+};
+export type CardProps = {
+    readonly placement: TourPlacement | 'center';
+    readonly children: ReactNode;
+};
+export type ArrowProps = {
+    readonly side: Side;
+    /** Distance from the card's left edge (top/bottom) or top edge (left/right) to the arrow's tip. */
+    readonly offset: number;
+};
+export type ContainerProps = {
+    readonly children: ReactNode;
+};
+export type CounterProps = {
+    readonly text: string;
+};
+export type CloseButtonProps = {
+    readonly label: string;
+    readonly onPress: () => void;
+};
+/** The title or the content: any React content, with the id screen readers find it by. */
+export type TextPartProps = {
+    readonly id: string;
+    readonly children: ReactNode;
+};
+export type ButtonProps = {
+    readonly kind: 'previous' | 'next';
+    readonly label: string;
+    readonly isDisabled: boolean;
+    readonly onPress: () => void;
+};
+export type DotsProps = {
+    /** Describes the group, for example "2 of 5". */
+    readonly label: string;
+    readonly children: ReactNode;
+};
+export type DotProps = {
+    readonly label: string;
+    readonly isCurrent: boolean;
+    readonly onPress: () => void;
+};
+export type EllipsisProps = {
+    readonly children?: never;
+};
+//# sourceMappingURL=renderer.type.d.ts.map

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

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

package/dist/shared/renderer/renderer.type.js

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

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

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

package/dist/shared/renderer/tooltip-model.d.ts

@@ -0,0 +1,32 @@
+import type { Side } from '../geometry/geometry.type.js';
+import type { TourTooltipProps } from '../types/tour-tooltip-props.type.js';
+import { type ResolvedI18n } from '../utils/i18n.util.js';
+export type TooltipDot = {
+    readonly kind: 'dot';
+    readonly index: number;
+    readonly label: string;
+    readonly isCurrent: boolean;
+} | {
+    readonly kind: 'ellipsis';
+    readonly key: string;
+};
+/** Everything the built-in tooltip shows, worked out once for every platform. */
+export type TooltipModel = {
+    readonly counter: string;
+    readonly closeLabel: string;
+    readonly arrow: {
+        readonly side: Side;
+        readonly offset: number;
+    } | undefined;
+    readonly previous: {
+        readonly label: string;
+        readonly isDisabled: boolean;
+    };
+    readonly next: {
+        readonly label: string;
+    };
+    /** `undefined` for a single step. */
+    readonly dots: readonly TooltipDot[] | undefined;
+};
+export declare function tooltipModel(props: TourTooltipProps, i18n: ResolvedI18n): TooltipModel;
+//# sourceMappingURL=tooltip-model.d.ts.map

package/dist/shared/renderer/tooltip-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip-model.d.ts","sourceRoot":"","sources":["../../../src/shared/renderer/tooltip-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,8BAA8B,CAAC;AACvD,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAiB,KAAK,YAAY,EAAC,MAAM,uBAAuB,CAAC;AAExE,MAAM,MAAM,UAAU,GAClB;IAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAAC,GACnG;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAC,CAAC;AAEtD,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE;QAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAC,GAAG,SAAS,CAAC;IAC3E,QAAQ,CAAC,QAAQ,EAAE;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;KAAC,CAAC;IAC1E,QAAQ,CAAC,IAAI,EAAE;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC;IACxC,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,CAAC;CAClD,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,YAAY,CAuBtF"}

package/dist/shared/renderer/tooltip-model.js

@@ -0,0 +1,24 @@
+import { getTruncatedDots } from '../utils/get-truncated-dots.util.js';
+import { formatTemplate } from '../utils/i18n.util.js';
+export function tooltipModel(props, i18n) {
+    const { currentStep, totalSteps, placement, arrowOffset } = props;
+    const isLast = currentStep >= totalSteps - 1;
+    return {
+        counter: formatTemplate(i18n.stepCounterTemplate, { current: currentStep + 1, total: totalSteps }),
+        closeLabel: i18n.closeAriaLabel,
+        arrow: arrowOffset === undefined || placement === 'center' ? undefined : { side: placement, offset: arrowOffset },
+        previous: { label: i18n.prevLabel, isDisabled: currentStep === 0 },
+        next: { label: isLast ? i18n.finishLabel : i18n.nextLabel },
+        dots: totalSteps > 1
+            ? getTruncatedDots(currentStep, totalSteps).map((item) => item.type === 'ellipsis'
+                ? { kind: 'ellipsis', key: `ellipsis-${item.position}` }
+                : {
+                    kind: 'dot',
+                    index: item.index,
+                    label: formatTemplate(i18n.dotAriaLabelTemplate, { step: item.index + 1, total: totalSteps }),
+                    isCurrent: item.index === currentStep,
+                })
+            : undefined,
+    };
+}
+//# sourceMappingURL=tooltip-model.js.map

package/dist/shared/renderer/tooltip-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip-model.js","sourceRoot":"","sources":["../../../src/shared/renderer/tooltip-model.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,gBAAgB,EAAC,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAC,cAAc,EAAoB,MAAM,uBAAuB,CAAC;AAiBxE,MAAM,UAAU,YAAY,CAAC,KAAuB,EAAE,IAAkB;IACtE,MAAM,EAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAC,GAAG,KAAK,CAAC;IAChE,MAAM,MAAM,GAAG,WAAW,IAAI,UAAU,GAAG,CAAC,CAAC;IAC7C,OAAO;QACL,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAC,OAAO,EAAE,WAAW,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,EAAC,CAAC;QAChG,UAAU,EAAE,IAAI,CAAC,cAAc;QAC/B,KAAK,EAAE,WAAW,KAAK,SAAS,IAAI,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAC;QAC/G,QAAQ,EAAE,EAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,KAAK,CAAC,EAAC;QAChE,IAAI,EAAE,EAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAC;QACzD,IAAI,EACF,UAAU,GAAG,CAAC;YACZ,CAAC,CAAC,gBAAgB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAc,EAAE,CACjE,IAAI,CAAC,IAAI,KAAK,UAAU;gBACtB,CAAC,CAAC,EAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,IAAI,CAAC,QAAQ,EAAE,EAAC;gBACtD,CAAC,CAAC;oBACE,IAAI,EAAE,KAAK;oBACX,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,EAAC,CAAC;oBAC3F,SAAS,EAAE,IAAI,CAAC,KAAK,KAAK,WAAW;iBACtC,CACN;YACH,CAAC,CAAC,SAAS;KAChB,CAAC;AACJ,CAAC"}

package/dist/shared/renderer/tour-overlay.d.ts

@@ -0,0 +1,24 @@
+import { type ComponentType, type ReactNode } from 'react';
+import { type TourEngine } from '../engine/tour-engine.js';
+import type { TourTooltipProps } from '../types/tour-tooltip-props.type.js';
+import { type ResolvedI18n } from '../utils/i18n.util.js';
+import type { ResolvedTheme } from '../utils/theme.util.js';
+import type { TourRenderer } from './renderer.type.js';
+export type TourOverlayProps = {
+    readonly engine: TourEngine;
+    readonly renderer: TourRenderer;
+    readonly theme: ResolvedTheme;
+    readonly i18n: ResolvedI18n;
+    readonly Tooltip: ComponentType<TourTooltipProps>;
+    readonly isOverlayDismissible: boolean;
+    readonly isReducedMotion: boolean;
+};
+/**
+ * The tour on screen, for every platform: decides what is visible, how it animates, what it
+ * says and what input means, and draws it with the platform's primitives ({@link TourRenderer}).
+ * Keeps the last step on screen while the tour fades out.
+ */
+export declare function TourOverlay(props: TourOverlayProps): ReactNode;
+/** The plain text of React content (strings, numbers, arrays and the children of elements). */
+export declare function textOf(node: ReactNode): string;
+//# sourceMappingURL=tour-overlay.d.ts.map

package/dist/shared/renderer/tour-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-overlay.d.ts","sourceRoot":"","sources":["../../../src/shared/renderer/tour-overlay.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AACf,OAAO,EAGL,KAAK,UAAU,EAGhB,MAAM,0BAA0B,CAAC;AAIlC,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAiB,KAAK,YAAY,EAAC,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAG1D,OAAO,KAAK,EAAkC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAEtF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC,CAAC;AAMF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAqB9D;AAiXD,+FAA+F;AAC/F,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAc9C"}