@sunboard/react 0.5.0 → 0.6.1

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { ReactNode } from "react";
-import { RuntimeBootstrapRequest, RuntimeBootstrapResponse, RuntimeExperience, RuntimeProgress, RuntimeTrackRequest, RuntimeTrackResponse, SunboardRuntimeApiError, SunboardRuntimeClient, SunboardRuntimeClientOptions } from "@sunboard/core/runtime-api";
-import * as react_jsx_runtime1 from "react/jsx-runtime";
-import { NormalizedSunboardSpec, SunboardHotspot, SunboardStep, SunboardTourStep, SurveyQuestionType, TrackEventName } from "@sunboard/core";
+import { RuntimeBootstrapRequest, RuntimeBootstrapResponse, RuntimeExperience, RuntimeProgress, RuntimeTrackRequest, RuntimeTrackResponse, SunboardRuntimeApiError, SunboardRuntimeClient, SunboardRuntimeClientOptions, TooltipDismissVia } from "@sunboard/core/runtime-api";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { NormalizedSunboardSpec, SunboardHotspot, SunboardPlacement, SunboardStep, SunboardTooltip, SunboardTourStep, SurveyQuestionType, TrackEventName } from "@sunboard/core";
 
 //#region src/adapters/navigation.d.ts
 type NavigateCallback = (url: string) => void | Promise<void>;
@@ -52,6 +52,23 @@ type TourResult = {
   ok: false;
   reason: "not-ready" | "missing-user" | "missing-tour";
 };
+type TooltipResult = {
+  ok: true;
+} | {
+  ok: false;
+  reason: "not-ready" | "missing-user" | "missing-tooltip";
+};
+type VisibleSunboardTooltip = {
+  key: string;
+  tooltip: SunboardTooltip;
+  /**
+   * True when the user asked for this tooltip (a checklist step's
+   * `openTooltip` action), false when it is showing proactively. A requested
+   * tooltip shows even if it was dismissed before — the user explicitly asked
+   * to be shown where the action happens.
+   */
+  requested: boolean;
+};
 type ActiveSunboardTour = {
   key: string;
   name: string;
@@ -88,11 +105,33 @@ type SunboardContextValue = {
   }) => Promise<TourResult>;
   advanceTour: () => Promise<TourResult>;
   navigateToStep: (step: SunboardStep) => Promise<void>;
-  startChecklistStep: (step: SunboardStep) => Promise<TourResult | void>;
+  startChecklistStep: (step: SunboardStep) => Promise<TourResult | TooltipResult | void>;
   visibleHotspots: Array<{
     key: string;
     hotspot: SunboardHotspot;
   }>;
+  dismissedTooltipKeys: ReadonlySet<string>;
+  /**
+   * Tooltips that qualify for the current route, requested-first. Renderers
+   * show ONE at a time: the first entry whose target resolves.
+   */
+  visibleTooltips: VisibleSunboardTooltip[];
+  /**
+   * Open a tooltip on demand (the checklist's openTooltip action). Navigates
+   * are the caller's job; this just marks the tooltip requested so it renders
+   * once its route matches and its target is present, dismissal or not.
+   */
+  openTooltip: (tooltipKey: string) => Promise<TooltipResult>;
+  /**
+   * Never show this tooltip again. `via: "close"` is the negative signal (the
+   * default); `via: "action"` records that the user took the tooltip's action;
+   * `via: "target"` records that the user clicked the tooltip's target element.
+   */
+  dismissTooltip: (tooltipKey: string, options?: {
+    via?: TooltipDismissVia;
+  }) => Promise<TooltipResult>;
+  /** Report that a tooltip actually reached the user's eyes (deduped per session). */
+  markTooltipSeen: (tooltipKey: string) => void;
 };
 //#endregion
 //#region src/components/SunboardProvider.d.ts
@@ -132,21 +171,31 @@ declare function SunboardProvider({
   identities: identitiesProp,
   onTrack,
   children
-}: SunboardProviderProps): react_jsx_runtime1.JSX.Element;
+}: SunboardProviderProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/SunboardHotspots.d.ts
-declare function SunboardHotspots(): react_jsx_runtime1.JSX.Element;
+declare function SunboardHotspots(): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/components/SunboardTooltips.d.ts
+/**
+ * Renders at most one tooltip: the first visible candidate whose target
+ * resolves. A candidate whose selector never appears is skipped for the rest
+ * of the session (without recording a dismissal — the user rejected nothing),
+ * so one stale selector can't block the tooltips behind it.
+ */
+declare function SunboardTooltips(): react_jsx_runtime0.JSX.Element | null;
 //#endregion
 //#region src/components/SunboardTour.d.ts
-declare function SunboardTour(): react_jsx_runtime1.JSX.Element | null;
+declare function SunboardTour(): react_jsx_runtime0.JSX.Element | null;
 //#endregion
 //#region src/components/Sunboard.d.ts
-declare function SunboardChecklist(): react_jsx_runtime1.JSX.Element | null;
-declare function SunboardSurvey(): react_jsx_runtime1.JSX.Element | null;
+declare function SunboardChecklist(): react_jsx_runtime0.JSX.Element | null;
+declare function SunboardSurvey(): react_jsx_runtime0.JSX.Element | null;
 declare const Sunboard: typeof SunboardChecklist & {
   Checklist: typeof SunboardChecklist;
   Survey: typeof SunboardSurvey;
   Hotspots: typeof SunboardHotspots;
+  Tooltips: typeof SunboardTooltips;
   Tour: typeof SunboardTour;
 };
 //#endregion
@@ -234,5 +283,43 @@ type UseSurveyResult = {
 };
 declare function useSurvey(): UseSurveyResult;
 //#endregion
-export { type ChecklistViewStep, type RuntimeBootstrapRequest, type RuntimeBootstrapResponse, type RuntimeExperience, type RuntimeProgress, type RuntimeTrackRequest, type RuntimeTrackResponse, Sunboard, SunboardChecklist, type SunboardContextValue, SunboardHotspots, SunboardProvider, type SunboardProviderProps, SunboardRuntimeApiError, SunboardRuntimeClient, type SunboardRuntimeClientOptions, SunboardSurvey, SunboardTour, type SunboardUser, type SurveyResult, type SurveyViewOption, type SurveyViewQuestion, type SurveyViewStep, type TourResult, type TrackProperties, type TrackResult, type UseChecklistResult, type UseSurveyResult, useChecklist, useSunboard, useSurvey };
+//#region src/hooks/useTooltips.d.ts
+type TooltipView = {
+  key: string;
+  title: string;
+  body?: string;
+  /** CSS selector of the element the tooltip points at. */
+  target: string;
+  placement: SunboardPlacement;
+  /** True when a tour action is attached; `engage` starts it. */
+  hasAction: boolean;
+  actionLabel?: string;
+  /** True when the user asked for this tooltip via a checklist step. */
+  requested: boolean;
+};
+type UseTooltipsResult = {
+  /**
+   * Tooltips that qualify for the current route (undismissed, or explicitly
+   * requested). Render ONE at a time — the first whose target you can anchor.
+   */
+  tooltips: TooltipView[];
+  /** Report that a tooltip is actually on screen (deduped per session). */
+  markSeen: (key: string) => void;
+  /** Close without acting — the tooltip never shows again. */
+  dismiss: (key: string) => void;
+  /** Take the tooltip's action: starts its tour and retires the tooltip. */
+  engage: (key: string) => void;
+  /**
+   * Report that the user clicked the tooltip's target element: the nudge
+   * worked, so this retires the tooltip and records the engagement.
+   */
+  markTargetClicked: (key: string) => void;
+};
+/**
+ * Headless counterpart of `<SunboardTooltips>`: the same visibility, seen,
+ * dismissal, and engagement semantics with rendering left to the host.
+ */
+declare function useTooltips(): UseTooltipsResult;
+//#endregion
+export { type ChecklistViewStep, type RuntimeBootstrapRequest, type RuntimeBootstrapResponse, type RuntimeExperience, type RuntimeProgress, type RuntimeTrackRequest, type RuntimeTrackResponse, Sunboard, SunboardChecklist, type SunboardContextValue, SunboardHotspots, SunboardProvider, type SunboardProviderProps, SunboardRuntimeApiError, SunboardRuntimeClient, type SunboardRuntimeClientOptions, SunboardSurvey, SunboardTooltips, SunboardTour, type SunboardUser, type SurveyResult, type SurveyViewOption, type SurveyViewQuestion, type SurveyViewStep, type TooltipResult, type TooltipView, type TourResult, type TrackProperties, type TrackResult, type UseChecklistResult, type UseSurveyResult, type UseTooltipsResult, type VisibleSunboardTooltip, useChecklist, useSunboard, useSurvey, useTooltips };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/adapters/navigation.ts","../src/lib/detect-identities.ts","../src/hooks/sunboard-context.ts","../src/components/SunboardProvider.tsx","../src/components/SunboardHotspots.tsx","../src/components/SunboardTour.tsx","../src/components/Sunboard.tsx","../src/hooks/useSunboard.ts","../src/hooks/useChecklist.ts","../src/hooks/useSurvey.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/adapters/navigation.ts","../src/lib/detect-identities.ts","../src/hooks/sunboard-context.ts","../src/components/SunboardProvider.tsx","../src/components/SunboardHotspots.tsx","../src/components/SunboardTooltips.tsx","../src/components/SunboardTour.tsx","../src/components/Sunboard.tsx","../src/hooks/useSunboard.ts","../src/hooks/useChecklist.ts","../src/hooks/useSurvey.ts","../src/hooks/useTooltips.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -148,28 +148,32 @@ function SunboardProvider({ spec: specProp, user, loading: loadingProp, route, n
 	}, [user, ownedAttributes]);
 	const [completedStepKeys, setCompletedStepKeys] = useState(() => /* @__PURE__ */ new Set());
 	const [completedTourKeys, setCompletedTourKeys] = useState(() => /* @__PURE__ */ new Set());
+	const [dismissedTooltipKeys, setDismissedTooltipKeys] = useState(() => /* @__PURE__ */ new Set());
 	const [activeTourState, setActiveTourState] = useState(null);
+	const [requestedTooltipKey, setRequestedTooltipKey] = useState(null);
+	const seenTooltipKeys = useRef(/* @__PURE__ */ new Set());
 	const lastNavigatedTourStep = useRef(null);
 	const storageKey = !hostedMode && resolvedSpec && user ? completedToursStorageKey(resolvedSpec.key, user.id) : null;
+	const tooltipStorageKey = !hostedMode && resolvedSpec && user ? dismissedTooltipsStorageKey(resolvedSpec.key, user.id) : null;
 	const experienceKey = activeSurvey?.key ?? activeExperience?.key ?? resolvedSpec?.key ?? null;
 	const versionId = activeSurvey?.version.id ?? activeExperience?.version.id ?? null;
 	useEffect(() => {
 		setCompletedStepKeys(/* @__PURE__ */ new Set());
 		setActiveTourState(null);
+		setRequestedTooltipKey(null);
+		seenTooltipKeys.current = /* @__PURE__ */ new Set();
 		lastNavigatedTourStep.current = null;
-		if (!storageKey) {
-			setCompletedTourKeys(/* @__PURE__ */ new Set());
-			return;
-		}
-		setCompletedTourKeys(readCompletedTours(storageKey));
+		setCompletedTourKeys(storageKey ? readStoredKeys(storageKey) : /* @__PURE__ */ new Set());
+		setDismissedTooltipKeys(tooltipStorageKey ? readStoredKeys(tooltipStorageKey) : /* @__PURE__ */ new Set());
 	}, [
 		resolvedSpec?.key,
 		storageKey,
+		tooltipStorageKey,
 		user?.id
 	]);
 	useEffect(() => {
 		if (!hostedMode || !activeExperience) return;
-		applyProgress(activeExperience.progress, setCompletedStepKeys, setCompletedTourKeys);
+		applyProgress(activeExperience.progress, setCompletedStepKeys, setCompletedTourKeys, setDismissedTooltipKeys);
 	}, [activeExperience, hostedMode]);
 	const effectiveCompletedStepKeys = useMemo(() => {
 		if (!hostedMode || !activeExperience) return completedStepKeys;
@@ -187,6 +191,14 @@ function SunboardProvider({ spec: specProp, user, loading: loadingProp, route, n
 		completedTourKeys,
 		hostedMode
 	]);
+	const effectiveDismissedTooltipKeys = useMemo(() => {
+		if (!hostedMode || !activeExperience) return dismissedTooltipKeys;
+		return mergeKeys(dismissedTooltipKeys, activeExperience.progress.dismissedTooltipKeys);
+	}, [
+		activeExperience,
+		dismissedTooltipKeys,
+		hostedMode
+	]);
 	useEffect(() => {
 		if (!resolvedSpec) return;
 		const tourCompletedStepKeys = (resolvedSpec.checklist?.steps ?? []).filter((step) => step.completeWhen?.tour && effectiveCompletedTourKeys.has(step.completeWhen.tour)).map((step) => step.key);
@@ -243,7 +255,7 @@ function SunboardProvider({ spec: specProp, user, loading: loadingProp, route, n
 		setCompletedTourKeys((current) => {
 			const next = new Set(current);
 			next.add(tourKey);
-			if (storageKey) writeCompletedTours(storageKey, next);
+			if (storageKey) writeStoredKeys(storageKey, next);
 			return next;
 		});
 	}, [storageKey]);
@@ -269,7 +281,7 @@ function SunboardProvider({ spec: specProp, user, loading: loadingProp, route, n
 				user: toRuntimeUser(user),
 				versionId: versionId ?? void 0
 			});
-			if (response.progress) applyProgress(response.progress, setCompletedStepKeys, setCompletedTourKeys);
+			if (response.progress) applyProgress(response.progress, setCompletedStepKeys, setCompletedTourKeys, setDismissedTooltipKeys);
 		} catch {
 			networkOk = false;
 		}
@@ -423,7 +435,7 @@ function SunboardProvider({ spec: specProp, user, loading: loadingProp, route, n
 				tourKey,
 				user: toRuntimeUser(user),
 				versionId: versionId ?? void 0
-			})).progress, setCompletedStepKeys, setCompletedTourKeys);
+			})).progress, setCompletedStepKeys, setCompletedTourKeys, setDismissedTooltipKeys);
 		} catch {}
 	}, [
 		client,
@@ -468,10 +480,106 @@ function SunboardProvider({ spec: specProp, user, loading: loadingProp, route, n
 		resolvedSpec,
 		user
 	]);
+	const openTooltip = useCallback(async (tooltipKey) => {
+		if (resolvedLoading || !resolvedSpec) return {
+			ok: false,
+			reason: "not-ready"
+		};
+		if (!user) return {
+			ok: false,
+			reason: "missing-user"
+		};
+		if (!resolvedSpec.tooltips[tooltipKey]) return {
+			ok: false,
+			reason: "missing-tooltip"
+		};
+		setRequestedTooltipKey(tooltipKey);
+		return { ok: true };
+	}, [
+		resolvedLoading,
+		resolvedSpec,
+		user
+	]);
+	const dismissTooltip = useCallback(async (tooltipKey, options) => {
+		if (resolvedLoading || !resolvedSpec) return {
+			ok: false,
+			reason: "not-ready"
+		};
+		if (!user) return {
+			ok: false,
+			reason: "missing-user"
+		};
+		if (!resolvedSpec.tooltips[tooltipKey]) return {
+			ok: false,
+			reason: "missing-tooltip"
+		};
+		const via = options?.via ?? "close";
+		setRequestedTooltipKey((current) => current === tooltipKey ? null : current);
+		setDismissedTooltipKeys((current) => {
+			const next = mergeKeys(current, [tooltipKey]);
+			if (tooltipStorageKey && next !== current) writeStoredKeys(tooltipStorageKey, next);
+			return next;
+		});
+		if (hostedMode && client && experienceKey) client.dismissTooltip({
+			experienceKey,
+			origin: currentOrigin,
+			route: currentRoute,
+			tooltipKey,
+			user: toRuntimeUser(user),
+			versionId: versionId ?? void 0,
+			via
+		}).catch(() => {});
+		return { ok: true };
+	}, [
+		client,
+		currentOrigin,
+		currentRoute,
+		experienceKey,
+		hostedMode,
+		resolvedLoading,
+		resolvedSpec,
+		tooltipStorageKey,
+		user,
+		versionId
+	]);
+	const markTooltipSeen = useCallback((tooltipKey) => {
+		if (!resolvedSpec?.tooltips[tooltipKey] || seenTooltipKeys.current.has(tooltipKey)) return;
+		seenTooltipKeys.current.add(tooltipKey);
+		if (hostedMode && client && experienceKey && user) client.recordTooltipSeen({
+			experienceKey,
+			origin: currentOrigin,
+			route: currentRoute,
+			tooltipKey,
+			user: toRuntimeUser(user),
+			versionId: versionId ?? void 0
+		}).catch(() => {});
+	}, [
+		client,
+		currentOrigin,
+		currentRoute,
+		experienceKey,
+		hostedMode,
+		resolvedSpec,
+		user,
+		versionId
+	]);
 	const startChecklistStep = useCallback(async (step) => {
 		if (step.action?.type === "startTour") return startTour(step.action.tour);
+		if (step.action?.type === "openTooltip") {
+			const tooltipKey = step.action.tooltip;
+			const destination = resolvedSpec?.tooltips[tooltipKey]?.route ?? step.route;
+			if (destination && !routeMatches(destination, currentRoute)) await navigateWithFallback(destination, navigate);
+			return openTooltip(tooltipKey);
+		}
 		await navigateToStep(step);
-	}, [navigateToStep, startTour]);
+	}, [
+		currentRoute,
+		navigate,
+		navigateToStep,
+		openTooltip,
+		resolvedSpec,
+		startTour
+	]);
 	const visibleHotspots = useMemo(() => {
 		if (!resolvedSpec || activeTour) return [];
 		return Object.entries(resolvedSpec.hotspots).filter(([, hotspot]) => routeMatches(hotspot.route, currentRoute)).filter(([, hotspot]) => hotspot.repeatable || !effectiveCompletedTourKeys.has(hotspot.action.tour)).map(([key, hotspot]) => ({
@@ -484,6 +592,29 @@ function SunboardProvider({ spec: specProp, user, loading: loadingProp, route, n
 		currentRoute,
 		resolvedSpec
 	]);
+	const visibleTooltips = useMemo(() => {
+		if (!resolvedSpec || activeTour) return [];
+		const requestedTooltip = requestedTooltipKey ? resolvedSpec.tooltips[requestedTooltipKey] : void 0;
+		if (requestedTooltipKey && requestedTooltip) {
+			if (!routeMatches(requestedTooltip.route, currentRoute)) return [];
+			return [{
+				key: requestedTooltipKey,
+				requested: true,
+				tooltip: requestedTooltip
+			}];
+		}
+		return Object.entries(resolvedSpec.tooltips).filter(([key, tooltip]) => routeMatches(tooltip.route, currentRoute) && !effectiveDismissedTooltipKeys.has(key)).map(([key, tooltip]) => ({
+			key,
+			requested: false,
+			tooltip
+		}));
+	}, [
+		activeTour,
+		currentRoute,
+		effectiveDismissedTooltipKeys,
+		requestedTooltipKey,
+		resolvedSpec
+	]);
 	const value = useMemo(() => ({
 		spec: resolvedSpec,
 		user: effectiveUser,
@@ -501,7 +632,12 @@ function SunboardProvider({ spec: specProp, user, loading: loadingProp, route, n
 		advanceTour,
 		navigateToStep,
 		startChecklistStep,
-		visibleHotspots
+		visibleHotspots,
+		dismissedTooltipKeys: effectiveDismissedTooltipKeys,
+		visibleTooltips,
+		openTooltip,
+		dismissTooltip,
+		markTooltipSeen
 	}), [
 		resolvedSpec,
 		effectiveUser,
@@ -519,7 +655,12 @@ function SunboardProvider({ spec: specProp, user, loading: loadingProp, route, n
 		advanceTour,
 		navigateToStep,
 		startChecklistStep,
-		visibleHotspots
+		visibleHotspots,
+		effectiveDismissedTooltipKeys,
+		visibleTooltips,
+		openTooltip,
+		dismissTooltip,
+		markTooltipSeen
 	]);
 	return /* @__PURE__ */ jsx(SunboardContext.Provider, {
 		value,
@@ -639,9 +780,10 @@ function scheduleLateIdentityCapture(options) {
 function hasUnsentIdentity(detected, sent) {
 	return Object.entries(detected).some(([provider, id]) => sent?.[provider] !== id);
 }
-function applyProgress(progress, setSteps, setTours) {
+function applyProgress(progress, setSteps, setTours, setDismissedTooltips) {
 	setSteps((current) => mergeKeys(current, progress.completedStepKeys));
 	setTours((current) => mergeKeys(current, progress.completedTourKeys));
+	setDismissedTooltips?.((current) => mergeKeys(current, progress.dismissedTooltipKeys));
 }
 function mergeKeys(current, incoming) {
 	if (incoming.length === 0) return current;
@@ -665,6 +807,9 @@ function toRuntimeUser(user) {
 function completedToursStorageKey(specKey, userId) {
 	return `sunboard:${specKey}:${userId}:completed-tours`;
 }
+function dismissedTooltipsStorageKey(specKey, userId) {
+	return `sunboard:${specKey}:${userId}:dismissed-tooltips`;
+}
 function getBrowserRoute() {
 	if (typeof window === "undefined") return "/";
 	return `${window.location.pathname}${window.location.search}`;
@@ -673,7 +818,7 @@ function getBrowserOrigin() {
 	if (typeof window === "undefined") return;
 	return window.location.origin;
 }
-function readCompletedTours(storageKey) {
+function readStoredKeys(storageKey) {
 	if (typeof window === "undefined") return /* @__PURE__ */ new Set();
 	try {
 		const rawValue = window.localStorage.getItem(storageKey);
@@ -684,10 +829,10 @@ function readCompletedTours(storageKey) {
 		return /* @__PURE__ */ new Set();
 	}
 }
-function writeCompletedTours(storageKey, tourKeys) {
+function writeStoredKeys(storageKey, keys) {
 	if (typeof window === "undefined") return;
 	try {
-		window.localStorage.setItem(storageKey, JSON.stringify([...tourKeys].sort()));
+		window.localStorage.setItem(storageKey, JSON.stringify([...keys].sort()));
 	} catch {}
 }
 
@@ -740,7 +885,8 @@ function useSunboard() {
 //#region src/hooks/useChecklist.ts
 function actionLabelFor(step) {
 	if (step.action?.type === "startTour") return "Start";
-	if (step.action || step.route) return "Open";
+	if (step.action?.type === "openTooltip") return "Show me";
+	if (step.route) return "Open";
 }
 function interpolateOptional$1(text, user) {
 	if (!text) return void 0;
@@ -1115,6 +1261,126 @@ function Hotspot({ hotspot, hotspotKey }) {
 	}) });
 }
 
+//#endregion
+//#region src/components/SunboardTooltips.tsx
+/**
+* Renders at most one tooltip: the first visible candidate whose target
+* resolves. A candidate whose selector never appears is skipped for the rest
+* of the session (without recording a dismissal — the user rejected nothing),
+* so one stale selector can't block the tooltips behind it.
+*/
+function SunboardTooltips() {
+	const { visibleTooltips } = useSunboard();
+	const [skippedKeys, setSkippedKeys] = useState(() => /* @__PURE__ */ new Set());
+	const active = visibleTooltips.find(({ key }) => !skippedKeys.has(key)) ?? null;
+	if (!active) return null;
+	return /* @__PURE__ */ jsx(Tooltip, {
+		onTargetMissing: () => setSkippedKeys((current) => new Set(current).add(active.key)),
+		requested: active.requested,
+		tooltip: active.tooltip,
+		tooltipKey: active.key
+	}, active.key);
+}
+function Tooltip({ tooltip, tooltipKey, requested, onTargetMissing }) {
+	const { dismissTooltip, markTooltipSeen, startTour } = useSunboard();
+	const arrowRef = useRef(null);
+	const title = useInterpolated(tooltip.title);
+	const body = useInterpolated(tooltip.body);
+	const actionLabel = useInterpolated(tooltip.actionLabel) ?? "Show me how";
+	const target = useTargetElement(tooltip.target, true);
+	const { context, refs, floatingStyles, update } = useFloating({
+		placement: tooltip.placement,
+		middleware: [
+			offset(12),
+			flip(),
+			shift({ padding: 12 }),
+			arrow({ element: arrowRef })
+		],
+		whileElementsMounted: autoUpdate
+	});
+	useEffect(() => {
+		if (!target.timedOut) return;
+		onTargetMissing();
+	}, [target.timedOut]);
+	useEffect(() => {
+		if (!target.element) return;
+		refs.setReference(target.element);
+		update();
+		markTooltipSeen(tooltipKey);
+	}, [
+		markTooltipSeen,
+		refs,
+		target.element,
+		tooltipKey,
+		update
+	]);
+	useEffect(() => {
+		const element = target.element;
+		if (!element) return;
+		const dismissOnTargetClick = () => {
+			window.setTimeout(() => {
+				dismissTooltip(tooltipKey, { via: "target" });
+			}, 0);
+		};
+		element.addEventListener("click", dismissOnTargetClick);
+		return () => {
+			element.removeEventListener("click", dismissOnTargetClick);
+		};
+	}, [
+		dismissTooltip,
+		target.element,
+		tooltipKey
+	]);
+	if (!target.element) return null;
+	return /* @__PURE__ */ jsx(FloatingPortal, { children: /* @__PURE__ */ jsxs("section", {
+		"aria-label": title,
+		className: "sunboard-tooltip",
+		"data-sunboard-tooltip": tooltipKey,
+		"data-requested": requested,
+		ref: refs.setFloating,
+		role: "dialog",
+		style: floatingStyles,
+		children: [
+			/* @__PURE__ */ jsx(FloatingArrow, {
+				className: "sunboard-tooltip-arrow",
+				context,
+				fill: "var(--sunboard-tour-background)",
+				ref: arrowRef,
+				stroke: "var(--sunboard-tour-border)",
+				strokeWidth: 1,
+				tipRadius: 2
+			}),
+			/* @__PURE__ */ jsx("button", {
+				"aria-label": `Dismiss ${title}`,
+				className: "sunboard-tooltip-close",
+				onClick: () => void dismissTooltip(tooltipKey),
+				type: "button",
+				children: "x"
+			}),
+			/* @__PURE__ */ jsx("h2", {
+				className: "sunboard-tooltip-title",
+				children: title
+			}),
+			body ? /* @__PURE__ */ jsx("p", {
+				className: "sunboard-tooltip-body",
+				children: body
+			}) : null,
+			tooltip.action ? /* @__PURE__ */ jsx("div", {
+				className: "sunboard-tooltip-actions",
+				children: /* @__PURE__ */ jsx("button", {
+					className: "sunboard-tooltip-action",
+					onClick: () => {
+						dismissTooltip(tooltipKey, { via: "action" });
+						startTour(tooltip.action.tour);
+					},
+					type: "button",
+					children: actionLabel
+				})
+			}) : null
+		]
+	}) });
+}
+
 //#endregion
 //#region src/components/SunboardTour.tsx
 function SunboardTour() {
@@ -1524,9 +1790,48 @@ const Sunboard = Object.assign(SunboardChecklist, {
 	Checklist: SunboardChecklist,
 	Survey: SunboardSurvey,
 	Hotspots: SunboardHotspots,
+	Tooltips: SunboardTooltips,
 	Tour: SunboardTour
 });
 
 //#endregion
-export { Sunboard, SunboardChecklist, SunboardHotspots, SunboardProvider, SunboardRuntimeApiError, SunboardRuntimeClient, SunboardSurvey, SunboardTour, useChecklist, useSunboard, useSurvey };
+//#region src/hooks/useTooltips.ts
+/**
+* Headless counterpart of `<SunboardTooltips>`: the same visibility, seen,
+* dismissal, and engagement semantics with rendering left to the host.
+*/
+function useTooltips() {
+	const { user, visibleTooltips, markTooltipSeen, dismissTooltip, startTour } = useSunboard();
+	return {
+		tooltips: useMemo(() => visibleTooltips.map(({ key, tooltip, requested }) => ({
+			key,
+			title: interpolateTokens(tooltip.title, user ?? null),
+			body: tooltip.body ? interpolateTokens(tooltip.body, user ?? null) : void 0,
+			target: tooltip.target,
+			placement: tooltip.placement,
+			hasAction: Boolean(tooltip.action),
+			actionLabel: tooltip.actionLabel ? interpolateTokens(tooltip.actionLabel, user ?? null) : void 0,
+			requested
+		})), [user, visibleTooltips]),
+		markSeen: markTooltipSeen,
+		dismiss: (key) => {
+			dismissTooltip(key);
+		},
+		engage: useCallback((key) => {
+			const entry = visibleTooltips.find((candidate) => candidate.key === key);
+			dismissTooltip(key, { via: "action" });
+			if (entry?.tooltip.action) startTour(entry.tooltip.action.tour);
+		}, [
+			dismissTooltip,
+			startTour,
+			visibleTooltips
+		]),
+		markTargetClicked: (key) => {
+			dismissTooltip(key, { via: "target" });
+		}
+	};
+}
+
+//#endregion
+export { Sunboard, SunboardChecklist, SunboardHotspots, SunboardProvider, SunboardRuntimeApiError, SunboardRuntimeClient, SunboardSurvey, SunboardTooltips, SunboardTour, useChecklist, useSunboard, useSurvey, useTooltips };
 //# sourceMappingURL=index.mjs.map