@mortenbrudvik/waveui 0.14.0 → 0.14.1

package/dist/components/overlays/TeachingPopover.root.mjs

@@ -5,146 +5,154 @@ import { slotRendersContent as i } from "../../lib/slot.mjs";
 import { teachingPopoverClassNames as ee } from "../../lib/classNames.mjs";
 import { useEventCallback as a } from "../../hooks/useEventCallback.mjs";
 import { useControllable as o } from "../../hooks/useControllable.mjs";
-import { useId as s } from "../../hooks/useId.mjs";
-import { useMergedRefs as te } from "../../hooks/useMergedRefs.mjs";
-import { useTargetConflictWarning as ne } from "../../hooks/useResolvedTarget.mjs";
-import { TeachingPopoverContext as re } from "./TeachingPopover.context.mjs";
-import { TeachingPopoverSurface as c, TeachingPopoverTrigger as l, TeachingSurface as ie } from "./TeachingPopover.parts.mjs";
-import * as u from "react";
-import { jsx as ae, jsxs as oe } from "react/jsx-runtime";
+import { useId as te } from "../../hooks/useId.mjs";
+import { useMergedRefs as ne } from "../../hooks/useMergedRefs.mjs";
+import { useTargetConflictWarning as re } from "../../hooks/useResolvedTarget.mjs";
+import { TeachingPopoverContext as ie } from "./TeachingPopover.context.mjs";
+import { TeachingPopoverSurface as s, TeachingPopoverTrigger as c, TeachingSurface as ae } from "./TeachingPopover.parts.mjs";
+import * as l from "react";
+import { jsx as oe, jsxs as se } from "react/jsx-runtime";
 //#region src/components/overlays/TeachingPopover.root.tsx
-var se = "Back", ce = "Next", le = "Done", ue = "Choose step", de = (e, t) => `step ${e + 1} of ${t}`, fe = (e, t) => `Step ${e + 1} of ${t}`;
-function pe(e, t) {
+var ce = "Back", le = "Next", ue = "Done", de = "Choose step", fe = (e, t) => `step ${e + 1} of ${t}`, pe = (e, t) => `Step ${e + 1} of ${t}`;
+function u(e, t) {
 	return i(e) ? e : i(t) ? t : void 0;
 }
-function me(e, t) {
+function d(e, t) {
 	return Number.isFinite(e) ? Math.min(Math.max(Math.trunc(e), 0), t - 1) : 0;
 }
-function he(n) {
+function me(n) {
 	let r = {
 		trigger: !1,
 		surface: !1
 	};
 	if (n == null) return r;
-	for (let { node: i } of e(n)) t(i, l) ? r.trigger = !0 : t(i, c) && (r.surface = !0);
+	for (let { node: i } of e(n)) t(i, c) ? r.trigger = !0 : t(i, s) && (r.surface = !0);
 	return r;
 }
-var ge = "TeachingPopover.Surface:placement", _e = "TeachingPopover.Surface: render one TeachingPopover.Surface in a TeachingPopover; a second Surface renders a second popover.", ve = "TeachingPopover:surface-props", ye = "TeachingPopover: the props of the surface element on TeachingPopover (`className`, `style`, `ref`, `onKeyDown` and the other element props) are ignored next to a TeachingPopover.Surface: pass them to the Surface.", d = ({ steps: e, activeStep: t, defaultActiveStep: i, currentStep: c, defaultCurrentStep: l, onStepChange: d, onDismiss: f, onFinish: be, primaryAction: xe, secondaryAction: Se, footerLayout: p = "horizontal", open: Ce, defaultOpen: we, onOpenChange: Te, closeLabel: m = "Close", labels: h, target: g, positioning: _, side: v = "bottom", align: y = "center", children: b, id: x, className: S, style: C, onKeyDown: w, ref: T, ...E }) => {
-	ne("TeachingPopover", g, _?.target);
-	let D = g === void 0 ? _?.target : g, Ee = n("TeachingPopover", t, c, "currentStep", "activeStep"), De = n("TeachingPopover", i, l, "defaultCurrentStep", "defaultActiveStep") ?? 0, [O, k] = o(Ee, De, d), A = he(b), [j, M] = o(Ce, we ?? !A.trigger, Te), N = s("teaching-popover-title"), P = e.length, F = j && P > 0, I = P > 0 ? me(O, P) : 0, L = P > 0 && I !== O, R = P > 0 ? e[I] : void 0, z = I === 0, B = I === P - 1, V = P > 0 ? (h?.step ?? de)(I, P) : "", Oe = R ? pe(R.primaryAction, xe) : void 0, H = R ? pe(R.secondaryAction, Se) : void 0, U = h?.back ?? se, W = h?.next ?? ce, G = h?.done ?? le, K = h?.nav ?? ue, q = h?.navButton ?? fe, [J, ke] = u.useState(null), Y = A.trigger || J !== null, Ae = D === void 0 ? Y ? J : void 0 : D, je = u.useRef(null), Me = te(je, ke), X = u.useRef(0), [Ne, Pe] = u.useState(!1), Fe = u.useCallback(() => (X.current += 1, Pe(!0), () => {
-		--X.current, X.current === 0 && Pe(!1);
-	}), []), Z = A.surface || Ne;
-	u.useEffect(() => {
-		X.current > 1 && r(ge, _e);
+var he = "TeachingPopover.Surface:placement", ge = "TeachingPopover.Surface: render one TeachingPopover.Surface in a TeachingPopover; a second Surface renders a second popover.", _e = "TeachingPopover:surface-props", ve = "TeachingPopover: the props of the surface element on TeachingPopover (`className`, `style`, `ref`, `onKeyDown` and the other element props) are ignored next to a TeachingPopover.Surface: pass them to the Surface.", f = ({ steps: e, activeStep: t, defaultActiveStep: i, currentStep: s, defaultCurrentStep: c, onStepChange: f, onDismiss: p, onFinish: ye, primaryAction: be, secondaryAction: xe, footerLayout: m = "horizontal", open: Se, defaultOpen: Ce, onOpenChange: we, closeLabel: h = "Close", labels: g, target: _, positioning: v, side: Te = "bottom", align: Ee = "center", children: y, id: b, className: x, style: S, onKeyDown: C, ref: w, ...T }) => {
+	re("TeachingPopover", _, v?.target);
+	let E = _ === void 0 ? v?.target : _, De = n("TeachingPopover", t, s, "currentStep", "activeStep"), D = n("TeachingPopover", i, c, "defaultCurrentStep", "defaultActiveStep") ?? 0, [O, k, A] = o(De, D, f), j = me(y), [M, N] = o(Se, Ce ?? !j.trigger, we), P = te("teaching-popover-title"), [Oe, ke] = l.useState(M), [F, I] = l.useState(!1);
+	M !== Oe && (ke(M), M && !A && !Object.is(O, D) && I(!0)), F && (A || Object.is(O, D)) && I(!1), l.useLayoutEffect(() => {
+		F && k(D);
+	}, [
+		F,
+		D,
+		k
+	]);
+	let L = F ? D : O, R = e.length, z = M && R > 0, B = R > 0 ? d(L, R) : 0, V = R > 0 && B !== L, H = R > 0 ? e[B] : void 0, U = B === 0, W = B === R - 1, Ae = R > 0 ? (g?.step ?? fe)(B, R) : "", G = H ? u(H.primaryAction, be) : void 0, K = H ? u(H.secondaryAction, xe) : void 0, q = g?.back ?? ce, J = g?.next ?? le, je = g?.done ?? ue, Me = g?.nav ?? de, Ne = g?.navButton ?? pe, [Pe, Fe] = l.useState(null), Y = j.trigger || Pe !== null, Ie = E === void 0 ? Y ? Pe : void 0 : E, Le = l.useRef(null), Re = ne(Le, Fe), X = l.useRef(0), [ze, Be] = l.useState(!1), Ve = l.useCallback(() => (X.current += 1, Be(!0), () => {
+		--X.current, X.current === 0 && Be(!1);
+	}), []), Z = j.surface || ze;
+	l.useEffect(() => {
+		X.current > 1 && r(he, ge);
 	});
-	let Ie = s("teaching-popover"), [Le, Re] = u.useState(void 0), ze = (Z ? Le : x || void 0) ?? Ie, Be = a(() => M(!0)), Ve = a(() => {
-		M(!1), f?.();
+	let He = te("teaching-popover"), [Ue, We] = l.useState(void 0), Ge = (Z ? Ue : b || void 0) ?? He, Ke = a(() => N(!0)), qe = a(() => {
+		N(!1), p?.();
 	}), Q = a(() => {
-		M(!1), be?.(), f?.();
-	}), He = a(() => {
-		z || k(I - 1);
-	}), Ue = a(() => {
-		B ? Q() : k(I + 1);
-	}), We = a((e) => {
-		if (P === 0) return;
-		let t = me(e, P);
-		t !== I && k(t);
-	}), Ge = Z && (x !== void 0 || S !== void 0 || C !== void 0 || w !== void 0 || T !== void 0 || Object.keys(E).length > 0);
-	u.useEffect(() => {
-		Ge && r(ve, ye);
-	}, [Ge]), u.useEffect(() => {
-		L && r("TeachingPopover:activeStep-range", `TeachingPopover: activeStep ${O} is out of range for ${P} steps; showing step ${I + 1}.`);
+		N(!1), ye?.(), p?.();
+	}), Je = a(() => {
+		U || k(B - 1);
+	}), Ye = a(() => {
+		W ? Q() : k(B + 1);
+	}), Xe = a((e) => {
+		if (R === 0) return;
+		let t = d(e, R);
+		t !== B && k(t);
+	}), Ze = Z && (b !== void 0 || x !== void 0 || S !== void 0 || C !== void 0 || w !== void 0 || Object.keys(T).length > 0);
+	l.useEffect(() => {
+		Ze && r(_e, ve);
+	}, [Ze]), l.useEffect(() => {
+		V && r("TeachingPopover:activeStep-range", `TeachingPopover: activeStep ${L} is out of range for ${R} steps; showing step ${B + 1}.`);
 	}, [
+		V,
 		L,
-		O,
-		P,
-		I
+		R,
+		B
 	]);
-	let $ = u.useMemo(() => ({
-		open: j,
-		shown: F,
-		requestOpen: Be,
-		dismiss: Ve,
+	let $ = l.useMemo(() => ({
+		open: M,
+		shown: z,
+		requestOpen: Ke,
+		dismiss: qe,
 		finish: Q,
-		count: P,
-		index: I,
-		step: R,
-		isFirst: z,
-		isLast: B,
-		stepPosition: V,
-		goBack: He,
-		goNext: Ue,
-		goToStep: We,
-		primaryAction: Oe,
-		secondaryAction: H,
-		footerLayout: p,
-		backLabel: U,
-		nextLabel: W,
-		doneLabel: G,
-		closeLabel: m,
-		navLabel: K,
-		navButtonLabel: q,
-		titleId: N,
-		target: Ae,
-		side: v,
-		align: y,
-		positioning: _,
+		count: R,
+		index: B,
+		step: H,
+		isFirst: U,
+		isLast: W,
+		stepPosition: Ae,
+		goBack: Je,
+		goNext: Ye,
+		goToStep: Xe,
+		primaryAction: G,
+		secondaryAction: K,
+		footerLayout: m,
+		backLabel: q,
+		nextLabel: J,
+		doneLabel: je,
+		closeLabel: h,
+		navLabel: Me,
+		navButtonLabel: Ne,
+		titleId: P,
+		target: Ie,
+		side: Te,
+		align: Ee,
+		positioning: v,
 		hasTrigger: Y,
-		triggerElementRef: Me,
-		triggerRef: je,
-		surfaceId: ze,
-		setCustomSurfaceId: Re,
-		registerSurface: Fe
+		triggerElementRef: Re,
+		triggerRef: Le,
+		surfaceId: Ge,
+		setCustomSurfaceId: We,
+		registerSurface: Ve
 	}), [
-		j,
-		F,
-		Be,
-		Ve,
+		M,
+		z,
+		Ke,
+		qe,
 		Q,
-		P,
-		I,
 		R,
-		z,
 		B,
-		V,
-		He,
-		Ue,
-		We,
-		Oe,
 		H,
-		p,
 		U,
 		W,
+		Ae,
+		Je,
+		Ye,
+		Xe,
 		G,
-		m,
 		K,
+		m,
 		q,
-		N,
-		Ae,
+		J,
+		je,
+		h,
+		Me,
+		Ne,
+		P,
+		Ie,
+		Te,
+		Ee,
 		v,
-		y,
-		_,
 		Y,
-		Me,
-		ze,
-		Fe
+		Re,
+		Ge,
+		Ve
 	]);
-	return /* @__PURE__ */ oe(re.Provider, {
+	return /* @__PURE__ */ se(ie.Provider, {
 		value: $,
-		children: [b, Z ? null : /* @__PURE__ */ ae(ie, {
+		children: [y, Z ? null : /* @__PURE__ */ oe(ae, {
 			context: $,
 			rootClassName: ee.root,
-			id: x,
-			className: S,
-			style: C,
-			onKeyDown: w,
-			...E,
-			ref: T
+			id: b,
+			className: x,
+			style: S,
+			onKeyDown: C,
+			...T,
+			ref: w
 		})]
 	});
 };
-d.displayName = "TeachingPopover";
+f.displayName = "TeachingPopover";
 //#endregion
-export { d as TeachingPopoverRoot };
+export { f as TeachingPopoverRoot };
 
 //# sourceMappingURL=TeachingPopover.root.mjs.map

package/dist/components/overlays/TeachingPopover.root.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"TeachingPopover.root.mjs","names":["useId","useId$1","React","DEFAULT_BACK_LABEL","DEFAULT_NEXT_LABEL","DEFAULT_DONE_LABEL","DEFAULT_NAV_LABEL","defaultStepLabel","index","count","defaultNavButtonLabel","pickAction","slotRendersContent","own","fallback","clampStep","step","findParts","found","children","flattenChildren","isElementOfType","node","TeachingPopoverTrigger","TeachingPopoverSurface","SURFACE_PLACEMENT_WARNING_KEY","SURFACE_PLACEMENT_WARNING","SURFACE_PROPS_WARNING_KEY","SURFACE_PROPS_WARNING","TeachingPopoverRoot","activeStepProp","primaryActionProp","secondaryActionProp","openProp","targetProp","rest","positioning","explicitTarget","controlledStep","resolveDeprecatedProp","currentStep","initialStep","defaultActiveStep","defaultCurrentStep","rawStep","setStep","useControllable","onStepChange","parts","open","setOpen","defaultOpen","onOpenChange","titleId","steps","shown","outOfRange","isFirst","isLast","stepPosition","labels","primaryAction","secondaryAction","backLabel","nextLabel","doneLabel","navLabel","navButtonLabel","triggerElement","setTriggerElement","hasTrigger","target","triggerRef","triggerElementRef","useMergedRefs","surfaceCountRef","hasRegisteredSurface","setHasRegisteredSurface","registerSurface","hasSurfacePart","warnOnce","generatedSurfaceId","customSurfaceId","setCustomSurfaceId","surfaceId","id","requestOpen","useEventCallback","dismiss","onDismiss","finish","onFinish","goBack","goNext","goToStep","next","ignoresSurfaceProps","className","style","onKeyDown","ref","context","footerLayout","closeLabel","side","align","TeachingPopoverContext","TeachingSurface","teachingPopoverClassNames"],"sources":["../../../src/components/overlays/TeachingPopover.root.tsx"],"sourcesContent":["import * as React from 'react';\nimport { flattenChildren, isElementOfType } from '../../lib/children';\nimport { teachingPopoverClassNames } from '../../lib/classNames';\nimport { resolveDeprecatedProp, warnOnce } from '../../lib/dev';\nimport { slotRendersContent } from '../../lib/slot';\nimport type { PopupAlign, PopupPositioning, PopupSide, VirtualElement } from '../../lib/types';\nimport { useControllable } from '../../hooks/useControllable';\nimport { useEventCallback } from '../../hooks/useEventCallback';\nimport { useId } from '../../hooks/useId';\nimport { useMergedRefs } from '../../hooks/useMergedRefs';\nimport { useTargetConflictWarning } from '../../hooks/useResolvedTarget';\nimport {\n  TeachingPopoverContext,\n  type TeachingPopoverAction,\n  type TeachingPopoverContextValue,\n  type TeachingPopoverLabels,\n  type TeachingPopoverStep,\n} from './TeachingPopover.context';\nimport {\n  TeachingPopoverSurface,\n  TeachingPopoverTrigger,\n  TeachingSurface,\n} from './TeachingPopover.parts';\n\n/*\n * The TeachingPopover root: its props, the state of both forms (the open state, the step and the\n * step's resolved content), the child scan for the Trigger and the Surface, and the surface it\n * renders when no Surface is among its children. Imports the context and parts modules (never\n * `TeachingPopover.tsx`, which holds the compound).\n */\n\nconst DEFAULT_BACK_LABEL = 'Back';\nconst DEFAULT_NEXT_LABEL = 'Next';\nconst DEFAULT_DONE_LABEL = 'Done';\nconst DEFAULT_NAV_LABEL = 'Choose step';\nconst defaultStepLabel = (index: number, count: number) => `step ${index + 1} of ${count}`;\nconst defaultNavButtonLabel = (index: number, count: number) => `Step ${index + 1} of ${count}`;\n\n/** Properties for the TeachingPopover component. */\nexport interface TeachingPopoverProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Steps to display in the teaching popover (a readonly array is accepted). */\n  steps: readonly TeachingPopoverStep[];\n  /**\n   * Controlled index of the displayed step. Out-of-range values are clamped to the first or last\n   * step (with a development warning).\n   */\n  activeStep?: number;\n  /** Initial step index for uncontrolled usage.\n   * @default 0\n   */\n  defaultActiveStep?: number;\n  /** @deprecated Use `activeStep`. */\n  currentStep?: number;\n  /** @deprecated Use `defaultActiveStep`. */\n  defaultCurrentStep?: number;\n  /**\n   * Called with the requested step index when Next, Back or a step button of\n   * `TeachingPopover.CarouselNav` is activated (the button of the current step requests nothing).\n   */\n  onStepChange?: (step: number) => void;\n  /**\n   * Called when the popover is dismissed with Close, Done, Escape or a `TeachingPopover.Trigger`\n   * that closes it.\n   *\n   * Done also calls it in 0.x, after `onFinish`, so that code written before `onFinish` keeps\n   * working; from 1.0 only Close, Escape and the Trigger will.\n   */\n  onDismiss?: () => void;\n  /**\n   * Called when the tour is finished: Done, the button that replaces Next on the last step, or a\n   * `primaryAction` on the last step whose click was not prevented. The popover closes first.\n   * Close, Escape and the Trigger call only `onDismiss`. Fires on every activation, like\n   * `onStepChange`.\n   */\n  onFinish?: () => void;\n  /**\n   * Replaces the Next (or Done) button on every step that sets no `primaryAction` of its own.\n   */\n  primaryAction?: TeachingPopoverAction;\n  /**\n   * Replaces the Back button on every step that sets no `secondaryAction` of its own.\n   */\n  secondaryAction?: TeachingPopoverAction;\n  /**\n   * How the footer lays out the step dots and the buttons: side by side, or the dots above\n   * buttons that fill the width. Rendered as `data-layout` on the popover and on its footer.\n   * `TeachingPopover.CarouselFooter` has its own `layout` instead.\n   * @default 'horizontal'\n   */\n  footerLayout?: 'horizontal' | 'vertical';\n  /** Controlled visibility of the teaching popover. */\n  open?: boolean;\n  /**\n   * Initial visibility for uncontrolled usage: `true` (a tour that shows on page load), or\n   * `false` when a `TeachingPopover.Trigger` is a direct child (a Fragment is fine), which then\n   * opens it.\n   * @default true (false with a direct TeachingPopover.Trigger)\n   */\n  defaultOpen?: boolean;\n  /**\n   * Called with `false` when Close, Done or Escape dismisses the popover, and with the new state\n   * when a `TeachingPopover.Trigger` opens or closes it.\n   */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * Accessible name of the built-in Close button (an icon-only button). Localize it with the\n   * page's language.\n   * @default 'Close'\n   */\n  closeLabel?: string;\n  /**\n   * Text of the Back, Next and Done buttons, the wording of the step position (“step 2 of 3”) and\n   * the names of `TeachingPopover.CarouselNav`'s step buttons, for localization. Unset members keep\n   * their English defaults.\n   */\n  labels?: TeachingPopoverLabels;\n  /**\n   * The element the popover points at (a ref, the element, or a `VirtualElement`: a rectangle such as a\n   * point; an inline object is fine). When given, the popover is\n   * rendered in a portal, positioned next to it with a beak, and flips or shifts to stay in view;\n   * without it (`undefined`) the popover renders inline where it is placed (0.4 behaviour), or,\n   * with a `TeachingPopover.Trigger`, points at the trigger.\n   * While the target is `null` or has not been positioned against yet (an element held in state\n   * that is not set yet, a ref that is not attached), the popover stays hidden: it is not\n   * shown, takes no focus, announces no step change and does not handle Escape until it can\n   * point at the target. It hides the same way when the target goes away later and shows again\n   * when a target returns.\n   *\n   * An element (for example one held in state through a callback ref) is followed as soon as the\n   * prop changes. A ref cannot be observed, so it is read after each render of the popover is\n   * committed, wherever the target is in the tree: an element attaching to or detaching from the\n   * ref is noticed the next time the popover renders (for example when the parent that mounts or\n   * unmounts the target re-renders it), not in a commit that does not render the popover. A\n   * memoized popover whose target mounts or unmounts in another subtree therefore stays hidden,\n   * or keeps pointing at the removed element, until it renders again. A newly passed ref keeps\n   * the previous visibility until it has been read, so a tour can move between attached refs\n   * (`target={step === 0 ? aRef : bRef}`) without hiding, and a switch to a ref that is not\n   * attached hides the popover right after that commit. Pass the element held in state when the\n   * target can mount or unmount without the popover re-rendering.\n   */\n  target?: React.RefObject<HTMLElement | null> | HTMLElement | VirtualElement | null;\n  /** Side of the `target` to open on; `start`/`end` follow the writing direction.\n   * @default 'bottom'\n   */\n  side?: PopupSide;\n  /** Alignment along the `target`'s edge.\n   * @default 'center'\n   */\n  align?: PopupAlign;\n  /**\n   * Advanced positioning (Fluent's `positioning`): `offset`, `fitViewport`, `matchReferenceWidth`,\n   * `fallbackPlacements` and `target` (used when the `target` prop is not set). `side` and `align`\n   * stay separate props.\n   * @default `{ offset: 12 }`\n   */\n  positioning?: PopupPositioning;\n  /**\n   * `TeachingPopover.Trigger` and `TeachingPopover.Surface` (Fluent's composition), rendered where\n   * they are written. Without a `TeachingPopover.Surface` among them, the popover renders its\n   * surface itself, after the children, with the element props given here (`className`, `style`,\n   * `ref`, …); with one (best written directly inside, a Fragment is fine: see\n   * `TeachingPopover.Surface`), the Surface takes them instead.\n   */\n  children?: React.ReactNode;\n  /**\n   * Ref to the popover surface (`role=\"dialog\"`). Ignored next to a `TeachingPopover.Surface`\n   * (pass it to the Surface).\n   */\n  ref?: React.Ref<HTMLDivElement>;\n}\n\n/** The action a step shows: its own when it renders anything, else the popover's. */\nfunction pickAction(\n  own: TeachingPopoverAction | undefined,\n  fallback: TeachingPopoverAction | undefined,\n): TeachingPopoverAction | undefined {\n  if (slotRendersContent(own)) return own;\n  return slotRendersContent(fallback) ? fallback : undefined;\n}\n\nfunction clampStep(step: number, count: number): number {\n  if (!Number.isFinite(step)) return 0;\n  return Math.min(Math.max(Math.trunc(step), 0), count - 1);\n}\n\n/**\n * Which parts are direct children (Fragments flattened, lazy types of a Server Component\n * unwrapped): a Trigger closes `defaultOpen`, a Surface replaces the root's own surface. Runs\n * during render, so the server HTML agrees (a Surface deeper down registers once mounted).\n */\nfunction findParts(children: React.ReactNode): { trigger: boolean; surface: boolean } {\n  const found = { trigger: false, surface: false };\n  if (children === null || children === undefined) return found;\n  for (const { node } of flattenChildren(children)) {\n    if (isElementOfType(node, TeachingPopoverTrigger)) found.trigger = true;\n    else if (isElementOfType(node, TeachingPopoverSurface)) found.surface = true;\n  }\n  return found;\n}\n\nconst SURFACE_PLACEMENT_WARNING_KEY = 'TeachingPopover.Surface:placement';\nconst SURFACE_PLACEMENT_WARNING =\n  'TeachingPopover.Surface: render one TeachingPopover.Surface in a TeachingPopover; a second Surface renders a second popover.';\n\nconst SURFACE_PROPS_WARNING_KEY = 'TeachingPopover:surface-props';\nconst SURFACE_PROPS_WARNING =\n  'TeachingPopover: the props of the surface element on TeachingPopover (`className`, `style`, `ref`, `onKeyDown` and the other element props) are ignored next to a TeachingPopover.Surface: pass them to the Surface.';\n\n// The root of `TeachingPopover` (documented on the export in TeachingPopover.tsx).\nexport const TeachingPopoverRoot = ({\n  steps,\n  activeStep: activeStepProp,\n  defaultActiveStep,\n  currentStep,\n  defaultCurrentStep,\n  onStepChange,\n  onDismiss,\n  onFinish,\n  primaryAction: primaryActionProp,\n  secondaryAction: secondaryActionProp,\n  footerLayout = 'horizontal',\n  open: openProp,\n  defaultOpen,\n  onOpenChange,\n  closeLabel = 'Close',\n  labels,\n  target: targetProp,\n  positioning,\n  side = 'bottom',\n  align = 'center',\n  children,\n  id,\n  className,\n  style,\n  onKeyDown,\n  ref,\n  ...rest\n}: TeachingPopoverProps) => {\n  useTargetConflictWarning('TeachingPopover', targetProp, positioning?.target);\n  const explicitTarget = (\n    targetProp !== undefined ? targetProp : positioning?.target\n  ) as TeachingPopoverProps['target'];\n  const controlledStep = resolveDeprecatedProp(\n    'TeachingPopover',\n    activeStepProp,\n    currentStep,\n    'currentStep',\n    'activeStep',\n  );\n  const initialStep =\n    resolveDeprecatedProp(\n      'TeachingPopover',\n      defaultActiveStep,\n      defaultCurrentStep,\n      'defaultCurrentStep',\n      'defaultActiveStep',\n    ) ?? 0;\n  const [rawStep, setStep] = useControllable(controlledStep, initialStep, onStepChange);\n  const parts = findParts(children);\n  const [open, setOpen] = useControllable(openProp, defaultOpen ?? !parts.trigger, onOpenChange);\n  const titleId = useId('teaching-popover-title');\n\n  const count = steps.length;\n  const shown = open && count > 0;\n  const index = count > 0 ? clampStep(rawStep, count) : 0;\n  const outOfRange = count > 0 && index !== rawStep;\n  const step = count > 0 ? steps[index] : undefined;\n  const isFirst = index === 0;\n  const isLast = index === count - 1;\n  const stepPosition = count > 0 ? (labels?.step ?? defaultStepLabel)(index, count) : '';\n  const primaryAction = step ? pickAction(step.primaryAction, primaryActionProp) : undefined;\n  const secondaryAction = step ? pickAction(step.secondaryAction, secondaryActionProp) : undefined;\n  const backLabel = labels?.back ?? DEFAULT_BACK_LABEL;\n  const nextLabel = labels?.next ?? DEFAULT_NEXT_LABEL;\n  const doneLabel = labels?.done ?? DEFAULT_DONE_LABEL;\n  const navLabel = labels?.nav ?? DEFAULT_NAV_LABEL;\n  const navButtonLabel = labels?.navButton ?? defaultNavButtonLabel;\n\n  // A Trigger is the target when neither `target` nor `positioning.target` is set: a direct one\n  // from the first render (the surface stays hidden until its element attaches), a nested one\n  // once its element has attached.\n  const [triggerElement, setTriggerElement] = React.useState<HTMLElement | null>(null);\n  const hasTrigger = parts.trigger || triggerElement !== null;\n  const target =\n    explicitTarget !== undefined ? explicitTarget : hasTrigger ? triggerElement : undefined;\n  // The Trigger's element also as a ref, where the surface returns focus.\n  const triggerRef = React.useRef<HTMLElement | null>(null);\n  const triggerElementRef = useMergedRefs<HTMLElement>(triggerRef, setTriggerElement);\n\n  // Surfaces (TeachingPopover.Surface) register while mounted, wherever they are among the\n  // children: once one has, the root renders no surface of its own. A direct one is also found by\n  // the scan above, so it never renders next to the root's own; one inside a component of yours\n  // does in its first commit, until its registration re-renders the root. After every commit\n  // (every surface's layout effect has run) more than one warns.\n  const surfaceCountRef = React.useRef(0);\n  const [hasRegisteredSurface, setHasRegisteredSurface] = React.useState(false);\n  const registerSurface = React.useCallback(() => {\n    surfaceCountRef.current += 1;\n    setHasRegisteredSurface(true);\n    return () => {\n      surfaceCountRef.current -= 1;\n      if (surfaceCountRef.current === 0) setHasRegisteredSurface(false);\n    };\n  }, []);\n  const hasSurfacePart = parts.surface || hasRegisteredSurface;\n  React.useEffect(() => {\n    if (surfaceCountRef.current > 1) {\n      warnOnce(SURFACE_PLACEMENT_WARNING_KEY, SURFACE_PLACEMENT_WARNING);\n    }\n  });\n\n  // The Trigger's `aria-controls`: the surface's id (the root's own `id` on its own surface, or\n  // the id a Surface reports), else a generated one.\n  const generatedSurfaceId = useId('teaching-popover');\n  const [customSurfaceId, setCustomSurfaceId] = React.useState<string | undefined>(undefined);\n  const surfaceId = (hasSurfacePart ? customSurfaceId : id || undefined) ?? generatedSurfaceId;\n\n  const requestOpen = useEventCallback(() => setOpen(true));\n  const dismiss = useEventCallback(() => {\n    setOpen(false);\n    onDismiss?.();\n  });\n  // Done: close, then `onFinish`. `onDismiss` still follows in 0.x (see its JSDoc).\n  const finish = useEventCallback(() => {\n    setOpen(false);\n    onFinish?.();\n    onDismiss?.();\n  });\n  const goBack = useEventCallback(() => {\n    if (!isFirst) setStep(index - 1);\n  });\n  const goNext = useEventCallback(() => {\n    if (isLast) finish();\n    else setStep(index + 1);\n  });\n  // A step button of TeachingPopover.CarouselNav: the shown (clamped) step requests nothing.\n  const goToStep = useEventCallback((target: number) => {\n    if (count === 0) return;\n    const next = clampStep(target, count);\n    if (next !== index) setStep(next);\n  });\n\n  // Next to a Surface the root renders no surface element, so its element props go nowhere.\n  const ignoresSurfaceProps =\n    hasSurfacePart &&\n    (id !== undefined ||\n      className !== undefined ||\n      style !== undefined ||\n      onKeyDown !== undefined ||\n      ref !== undefined ||\n      Object.keys(rest).length > 0);\n  React.useEffect(() => {\n    if (ignoresSurfaceProps) warnOnce(SURFACE_PROPS_WARNING_KEY, SURFACE_PROPS_WARNING);\n  }, [ignoresSurfaceProps]);\n\n  React.useEffect(() => {\n    if (!outOfRange) return;\n    warnOnce(\n      'TeachingPopover:activeStep-range',\n      `TeachingPopover: activeStep ${rawStep} is out of range for ${count} steps; showing step ${index + 1}.`,\n    );\n  }, [outOfRange, rawStep, count, index]);\n\n  const context = React.useMemo<TeachingPopoverContextValue>(\n    () => ({\n      open,\n      shown,\n      requestOpen,\n      dismiss,\n      finish,\n      count,\n      index,\n      step,\n      isFirst,\n      isLast,\n      stepPosition,\n      goBack,\n      goNext,\n      goToStep,\n      primaryAction,\n      secondaryAction,\n      footerLayout,\n      backLabel,\n      nextLabel,\n      doneLabel,\n      closeLabel,\n      navLabel,\n      navButtonLabel,\n      titleId,\n      target,\n      side,\n      align,\n      positioning,\n      hasTrigger,\n      triggerElementRef,\n      triggerRef,\n      surfaceId,\n      setCustomSurfaceId,\n      registerSurface,\n    }),\n    [\n      open,\n      shown,\n      requestOpen,\n      dismiss,\n      finish,\n      count,\n      index,\n      step,\n      isFirst,\n      isLast,\n      stepPosition,\n      goBack,\n      goNext,\n      goToStep,\n      primaryAction,\n      secondaryAction,\n      footerLayout,\n      backLabel,\n      nextLabel,\n      doneLabel,\n      closeLabel,\n      navLabel,\n      navButtonLabel,\n      titleId,\n      target,\n      side,\n      align,\n      positioning,\n      hasTrigger,\n      triggerElementRef,\n      surfaceId,\n      registerSurface,\n    ],\n  );\n\n  return (\n    <TeachingPopoverContext.Provider value={context}>\n      {children}\n      {hasSurfacePart ? null : (\n        <TeachingSurface\n          context={context}\n          rootClassName={teachingPopoverClassNames.root}\n          id={id}\n          className={className}\n          style={style}\n          onKeyDown={onKeyDown}\n          {...rest}\n          ref={ref}\n        />\n      )}\n    </TeachingPopoverContext.Provider>\n  );\n};\nTeachingPopoverRoot.displayName = 'TeachingPopover';\n"],"mappings":"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"}
+{"version":3,"file":"TeachingPopover.root.mjs","names":["useId","useId$1","React","DEFAULT_BACK_LABEL","DEFAULT_NEXT_LABEL","DEFAULT_DONE_LABEL","DEFAULT_NAV_LABEL","defaultStepLabel","index","count","defaultNavButtonLabel","pickAction","slotRendersContent","own","fallback","clampStep","step","findParts","found","children","flattenChildren","isElementOfType","node","TeachingPopoverTrigger","TeachingPopoverSurface","SURFACE_PLACEMENT_WARNING_KEY","SURFACE_PLACEMENT_WARNING","SURFACE_PROPS_WARNING_KEY","SURFACE_PROPS_WARNING","TeachingPopoverRoot","activeStepProp","primaryActionProp","secondaryActionProp","openProp","targetProp","rest","positioning","explicitTarget","controlledStep","resolveDeprecatedProp","currentStep","initialStep","defaultActiveStep","defaultCurrentStep","storedStep","setStep","stepControlled","useControllable","onStepChange","parts","open","setOpen","defaultOpen","onOpenChange","titleId","openSeen","setOpenSeen","stepResetPending","setStepResetPending","rawStep","steps","shown","outOfRange","isFirst","isLast","stepPosition","labels","primaryAction","secondaryAction","backLabel","nextLabel","doneLabel","navLabel","navButtonLabel","triggerElement","setTriggerElement","hasTrigger","target","triggerRef","triggerElementRef","useMergedRefs","surfaceCountRef","hasRegisteredSurface","setHasRegisteredSurface","registerSurface","hasSurfacePart","warnOnce","generatedSurfaceId","customSurfaceId","setCustomSurfaceId","surfaceId","id","requestOpen","useEventCallback","dismiss","onDismiss","finish","onFinish","goBack","goNext","goToStep","next","ignoresSurfaceProps","className","style","onKeyDown","ref","context","footerLayout","closeLabel","side","align","TeachingPopoverContext","TeachingSurface","teachingPopoverClassNames"],"sources":["../../../src/components/overlays/TeachingPopover.root.tsx"],"sourcesContent":["import * as React from 'react';\nimport { flattenChildren, isElementOfType } from '../../lib/children';\nimport { teachingPopoverClassNames } from '../../lib/classNames';\nimport { resolveDeprecatedProp, warnOnce } from '../../lib/dev';\nimport { slotRendersContent } from '../../lib/slot';\nimport type { PopupAlign, PopupPositioning, PopupSide, VirtualElement } from '../../lib/types';\nimport { useControllable } from '../../hooks/useControllable';\nimport { useEventCallback } from '../../hooks/useEventCallback';\nimport { useId } from '../../hooks/useId';\nimport { useMergedRefs } from '../../hooks/useMergedRefs';\nimport { useTargetConflictWarning } from '../../hooks/useResolvedTarget';\nimport {\n  TeachingPopoverContext,\n  type TeachingPopoverAction,\n  type TeachingPopoverContextValue,\n  type TeachingPopoverLabels,\n  type TeachingPopoverStep,\n} from './TeachingPopover.context';\nimport {\n  TeachingPopoverSurface,\n  TeachingPopoverTrigger,\n  TeachingSurface,\n} from './TeachingPopover.parts';\n\n/*\n * The TeachingPopover root: its props, the state of both forms (the open state, the step and the\n * step's resolved content), the child scan for the Trigger and the Surface, and the surface it\n * renders when no Surface is among its children. Imports the context and parts modules (never\n * `TeachingPopover.tsx`, which holds the compound).\n */\n\nconst DEFAULT_BACK_LABEL = 'Back';\nconst DEFAULT_NEXT_LABEL = 'Next';\nconst DEFAULT_DONE_LABEL = 'Done';\nconst DEFAULT_NAV_LABEL = 'Choose step';\nconst defaultStepLabel = (index: number, count: number) => `step ${index + 1} of ${count}`;\nconst defaultNavButtonLabel = (index: number, count: number) => `Step ${index + 1} of ${count}`;\n\n/** Properties for the TeachingPopover component. */\nexport interface TeachingPopoverProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Steps to display in the teaching popover (a readonly array is accepted). */\n  steps: readonly TeachingPopoverStep[];\n  /**\n   * Controlled index of the displayed step. Out-of-range values are clamped to the first or last\n   * step (with a development warning). Opening the popover leaves it as it is.\n   */\n  activeStep?: number;\n  /**\n   * Initial step index for uncontrolled usage, and the step the popover starts on again each time\n   * it opens (after Done, Close, Escape or the Trigger closed it, or a controlled `open` turned it\n   * off), so a tour opened again starts over; `onStepChange` is called with it when the step was\n   * elsewhere.\n   * @default 0\n   */\n  defaultActiveStep?: number;\n  /** @deprecated Use `activeStep`. */\n  currentStep?: number;\n  /** @deprecated Use `defaultActiveStep`. */\n  defaultCurrentStep?: number;\n  /**\n   * Called with the requested step index when Next, Back or a step button of\n   * `TeachingPopover.CarouselNav` is activated (the button of the current step requests nothing),\n   * and, while the step is uncontrolled, with the initial step when an opening moves the step back\n   * to it (see `defaultActiveStep`).\n   */\n  onStepChange?: (step: number) => void;\n  /**\n   * Called when the popover is dismissed with Close, Done, Escape or a `TeachingPopover.Trigger`\n   * that closes it.\n   *\n   * Done also calls it in 0.x, after `onFinish`, so that code written before `onFinish` keeps\n   * working; from 1.0 only Close, Escape and the Trigger will.\n   */\n  onDismiss?: () => void;\n  /**\n   * Called when the tour is finished: Done, the button that replaces Next on the last step, or a\n   * `primaryAction` on the last step whose click was not prevented. The popover closes first.\n   * Close, Escape and the Trigger call only `onDismiss`. Fires on every activation, like\n   * `onStepChange`.\n   */\n  onFinish?: () => void;\n  /**\n   * Replaces the Next (or Done) button on every step that sets no `primaryAction` of its own.\n   */\n  primaryAction?: TeachingPopoverAction;\n  /**\n   * Replaces the Back button on every step that sets no `secondaryAction` of its own.\n   */\n  secondaryAction?: TeachingPopoverAction;\n  /**\n   * How the footer lays out the step dots and the buttons: side by side, or the dots above\n   * buttons that fill the width. Rendered as `data-layout` on the popover and on its footer.\n   * `TeachingPopover.CarouselFooter` has its own `layout` instead.\n   * @default 'horizontal'\n   */\n  footerLayout?: 'horizontal' | 'vertical';\n  /** Controlled visibility of the teaching popover. */\n  open?: boolean;\n  /**\n   * Initial visibility for uncontrolled usage: `true` (a tour that shows on page load), or\n   * `false` when a `TeachingPopover.Trigger` is a direct child (a Fragment is fine), which then\n   * opens it.\n   * @default true (false with a direct TeachingPopover.Trigger)\n   */\n  defaultOpen?: boolean;\n  /**\n   * Called with `false` when Close, Done or Escape dismisses the popover, and with the new state\n   * when a `TeachingPopover.Trigger` opens or closes it.\n   */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * Accessible name of the built-in Close button (an icon-only button). Localize it with the\n   * page's language.\n   * @default 'Close'\n   */\n  closeLabel?: string;\n  /**\n   * Text of the Back, Next and Done buttons, the wording of the step position (“step 2 of 3”) and\n   * the names of `TeachingPopover.CarouselNav`'s step buttons, for localization. Unset members keep\n   * their English defaults.\n   */\n  labels?: TeachingPopoverLabels;\n  /**\n   * The element the popover points at (a ref, the element, or a `VirtualElement`: a rectangle such as a\n   * point; an inline object is fine). When given, the popover is\n   * rendered in a portal, positioned next to it with a beak, and flips or shifts to stay in view;\n   * without it (`undefined`) the popover renders inline where it is placed (0.4 behaviour), or,\n   * with a `TeachingPopover.Trigger`, points at the trigger.\n   * While the target is `null` or has not been positioned against yet (an element held in state\n   * that is not set yet, a ref that is not attached), the popover stays hidden: it is not\n   * shown, takes no focus, announces no step change and does not handle Escape until it can\n   * point at the target. It hides the same way when the target goes away later and shows again\n   * when a target returns.\n   *\n   * An element (for example one held in state through a callback ref) is followed as soon as the\n   * prop changes. A ref cannot be observed, so it is read after each render of the popover is\n   * committed, wherever the target is in the tree: an element attaching to or detaching from the\n   * ref is noticed the next time the popover renders (for example when the parent that mounts or\n   * unmounts the target re-renders it), not in a commit that does not render the popover. A\n   * memoized popover whose target mounts or unmounts in another subtree therefore stays hidden,\n   * or keeps pointing at the removed element, until it renders again. A newly passed ref keeps\n   * the previous visibility until it has been read, so a tour can move between attached refs\n   * (`target={step === 0 ? aRef : bRef}`) without hiding, and a switch to a ref that is not\n   * attached hides the popover right after that commit. Pass the element held in state when the\n   * target can mount or unmount without the popover re-rendering.\n   */\n  target?: React.RefObject<HTMLElement | null> | HTMLElement | VirtualElement | null;\n  /** Side of the `target` to open on; `start`/`end` follow the writing direction.\n   * @default 'bottom'\n   */\n  side?: PopupSide;\n  /** Alignment along the `target`'s edge.\n   * @default 'center'\n   */\n  align?: PopupAlign;\n  /**\n   * Advanced positioning (Fluent's `positioning`): `offset`, `fitViewport`, `matchReferenceWidth`,\n   * `fallbackPlacements` and `target` (used when the `target` prop is not set). `side` and `align`\n   * stay separate props.\n   * @default `{ offset: 12 }`\n   */\n  positioning?: PopupPositioning;\n  /**\n   * `TeachingPopover.Trigger` and `TeachingPopover.Surface` (Fluent's composition), rendered where\n   * they are written. Without a `TeachingPopover.Surface` among them, the popover renders its\n   * surface itself, after the children, with the element props given here (`className`, `style`,\n   * `ref`, …); with one (best written directly inside, a Fragment is fine: see\n   * `TeachingPopover.Surface`), the Surface takes them instead.\n   */\n  children?: React.ReactNode;\n  /**\n   * Ref to the popover surface (`role=\"dialog\"`). Ignored next to a `TeachingPopover.Surface`\n   * (pass it to the Surface).\n   */\n  ref?: React.Ref<HTMLDivElement>;\n}\n\n/** The action a step shows: its own when it renders anything, else the popover's. */\nfunction pickAction(\n  own: TeachingPopoverAction | undefined,\n  fallback: TeachingPopoverAction | undefined,\n): TeachingPopoverAction | undefined {\n  if (slotRendersContent(own)) return own;\n  return slotRendersContent(fallback) ? fallback : undefined;\n}\n\nfunction clampStep(step: number, count: number): number {\n  if (!Number.isFinite(step)) return 0;\n  return Math.min(Math.max(Math.trunc(step), 0), count - 1);\n}\n\n/**\n * Which parts are direct children (Fragments flattened, lazy types of a Server Component\n * unwrapped): a Trigger closes `defaultOpen`, a Surface replaces the root's own surface. Runs\n * during render, so the server HTML agrees (a Surface deeper down registers once mounted).\n */\nfunction findParts(children: React.ReactNode): { trigger: boolean; surface: boolean } {\n  const found = { trigger: false, surface: false };\n  if (children === null || children === undefined) return found;\n  for (const { node } of flattenChildren(children)) {\n    if (isElementOfType(node, TeachingPopoverTrigger)) found.trigger = true;\n    else if (isElementOfType(node, TeachingPopoverSurface)) found.surface = true;\n  }\n  return found;\n}\n\nconst SURFACE_PLACEMENT_WARNING_KEY = 'TeachingPopover.Surface:placement';\nconst SURFACE_PLACEMENT_WARNING =\n  'TeachingPopover.Surface: render one TeachingPopover.Surface in a TeachingPopover; a second Surface renders a second popover.';\n\nconst SURFACE_PROPS_WARNING_KEY = 'TeachingPopover:surface-props';\nconst SURFACE_PROPS_WARNING =\n  'TeachingPopover: the props of the surface element on TeachingPopover (`className`, `style`, `ref`, `onKeyDown` and the other element props) are ignored next to a TeachingPopover.Surface: pass them to the Surface.';\n\n// The root of `TeachingPopover` (documented on the export in TeachingPopover.tsx).\nexport const TeachingPopoverRoot = ({\n  steps,\n  activeStep: activeStepProp,\n  defaultActiveStep,\n  currentStep,\n  defaultCurrentStep,\n  onStepChange,\n  onDismiss,\n  onFinish,\n  primaryAction: primaryActionProp,\n  secondaryAction: secondaryActionProp,\n  footerLayout = 'horizontal',\n  open: openProp,\n  defaultOpen,\n  onOpenChange,\n  closeLabel = 'Close',\n  labels,\n  target: targetProp,\n  positioning,\n  side = 'bottom',\n  align = 'center',\n  children,\n  id,\n  className,\n  style,\n  onKeyDown,\n  ref,\n  ...rest\n}: TeachingPopoverProps) => {\n  useTargetConflictWarning('TeachingPopover', targetProp, positioning?.target);\n  const explicitTarget = (\n    targetProp !== undefined ? targetProp : positioning?.target\n  ) as TeachingPopoverProps['target'];\n  const controlledStep = resolveDeprecatedProp(\n    'TeachingPopover',\n    activeStepProp,\n    currentStep,\n    'currentStep',\n    'activeStep',\n  );\n  const initialStep =\n    resolveDeprecatedProp(\n      'TeachingPopover',\n      defaultActiveStep,\n      defaultCurrentStep,\n      'defaultCurrentStep',\n      'defaultActiveStep',\n    ) ?? 0;\n  const [storedStep, setStep, stepControlled] = useControllable(\n    controlledStep,\n    initialStep,\n    onStepChange,\n  );\n  const parts = findParts(children);\n  const [open, setOpen] = useControllable(openProp, defaultOpen ?? !parts.trigger, onOpenChange);\n  const titleId = useId('teaching-popover-title');\n\n  // An uncontrolled step starts again at the initial step each time the popover opens (not on\n  // mount), whatever closed it and whatever opens it. The opening is noticed during render (C-HOOKS:\n  // a previous-value state), so the opened popover shows the initial step from its first render;\n  // the layout effect stores it through the setter (which calls `onStepChange` once, from the\n  // commit), and the render that reads it back ends the reset.\n  const [openSeen, setOpenSeen] = React.useState(open);\n  const [stepResetPending, setStepResetPending] = React.useState(false);\n  if (open !== openSeen) {\n    setOpenSeen(open);\n    if (open && !stepControlled && !Object.is(storedStep, initialStep)) {\n      setStepResetPending(true);\n    }\n  }\n  if (stepResetPending && (stepControlled || Object.is(storedStep, initialStep))) {\n    setStepResetPending(false);\n  }\n  React.useLayoutEffect(() => {\n    if (stepResetPending) setStep(initialStep);\n  }, [stepResetPending, initialStep, setStep]);\n  const rawStep = stepResetPending ? initialStep : storedStep;\n\n  const count = steps.length;\n  const shown = open && count > 0;\n  const index = count > 0 ? clampStep(rawStep, count) : 0;\n  const outOfRange = count > 0 && index !== rawStep;\n  const step = count > 0 ? steps[index] : undefined;\n  const isFirst = index === 0;\n  const isLast = index === count - 1;\n  const stepPosition = count > 0 ? (labels?.step ?? defaultStepLabel)(index, count) : '';\n  const primaryAction = step ? pickAction(step.primaryAction, primaryActionProp) : undefined;\n  const secondaryAction = step ? pickAction(step.secondaryAction, secondaryActionProp) : undefined;\n  const backLabel = labels?.back ?? DEFAULT_BACK_LABEL;\n  const nextLabel = labels?.next ?? DEFAULT_NEXT_LABEL;\n  const doneLabel = labels?.done ?? DEFAULT_DONE_LABEL;\n  const navLabel = labels?.nav ?? DEFAULT_NAV_LABEL;\n  const navButtonLabel = labels?.navButton ?? defaultNavButtonLabel;\n\n  // A Trigger is the target when neither `target` nor `positioning.target` is set: a direct one\n  // from the first render (the surface stays hidden until its element attaches), a nested one\n  // once its element has attached.\n  const [triggerElement, setTriggerElement] = React.useState<HTMLElement | null>(null);\n  const hasTrigger = parts.trigger || triggerElement !== null;\n  const target =\n    explicitTarget !== undefined ? explicitTarget : hasTrigger ? triggerElement : undefined;\n  // The Trigger's element also as a ref, where the surface returns focus.\n  const triggerRef = React.useRef<HTMLElement | null>(null);\n  const triggerElementRef = useMergedRefs<HTMLElement>(triggerRef, setTriggerElement);\n\n  // Surfaces (TeachingPopover.Surface) register while mounted, wherever they are among the\n  // children: once one has, the root renders no surface of its own. A direct one is also found by\n  // the scan above, so it never renders next to the root's own; one inside a component of yours\n  // does in its first commit, until its registration re-renders the root. After every commit\n  // (every surface's layout effect has run) more than one warns.\n  const surfaceCountRef = React.useRef(0);\n  const [hasRegisteredSurface, setHasRegisteredSurface] = React.useState(false);\n  const registerSurface = React.useCallback(() => {\n    surfaceCountRef.current += 1;\n    setHasRegisteredSurface(true);\n    return () => {\n      surfaceCountRef.current -= 1;\n      if (surfaceCountRef.current === 0) setHasRegisteredSurface(false);\n    };\n  }, []);\n  const hasSurfacePart = parts.surface || hasRegisteredSurface;\n  React.useEffect(() => {\n    if (surfaceCountRef.current > 1) {\n      warnOnce(SURFACE_PLACEMENT_WARNING_KEY, SURFACE_PLACEMENT_WARNING);\n    }\n  });\n\n  // The Trigger's `aria-controls`: the surface's id (the root's own `id` on its own surface, or\n  // the id a Surface reports), else a generated one.\n  const generatedSurfaceId = useId('teaching-popover');\n  const [customSurfaceId, setCustomSurfaceId] = React.useState<string | undefined>(undefined);\n  const surfaceId = (hasSurfacePart ? customSurfaceId : id || undefined) ?? generatedSurfaceId;\n\n  const requestOpen = useEventCallback(() => setOpen(true));\n  const dismiss = useEventCallback(() => {\n    setOpen(false);\n    onDismiss?.();\n  });\n  // Done: close, then `onFinish`. `onDismiss` still follows in 0.x (see its JSDoc).\n  const finish = useEventCallback(() => {\n    setOpen(false);\n    onFinish?.();\n    onDismiss?.();\n  });\n  const goBack = useEventCallback(() => {\n    if (!isFirst) setStep(index - 1);\n  });\n  const goNext = useEventCallback(() => {\n    if (isLast) finish();\n    else setStep(index + 1);\n  });\n  // A step button of TeachingPopover.CarouselNav: the shown (clamped) step requests nothing.\n  const goToStep = useEventCallback((target: number) => {\n    if (count === 0) return;\n    const next = clampStep(target, count);\n    if (next !== index) setStep(next);\n  });\n\n  // Next to a Surface the root renders no surface element, so its element props go nowhere.\n  const ignoresSurfaceProps =\n    hasSurfacePart &&\n    (id !== undefined ||\n      className !== undefined ||\n      style !== undefined ||\n      onKeyDown !== undefined ||\n      ref !== undefined ||\n      Object.keys(rest).length > 0);\n  React.useEffect(() => {\n    if (ignoresSurfaceProps) warnOnce(SURFACE_PROPS_WARNING_KEY, SURFACE_PROPS_WARNING);\n  }, [ignoresSurfaceProps]);\n\n  React.useEffect(() => {\n    if (!outOfRange) return;\n    warnOnce(\n      'TeachingPopover:activeStep-range',\n      `TeachingPopover: activeStep ${rawStep} is out of range for ${count} steps; showing step ${index + 1}.`,\n    );\n  }, [outOfRange, rawStep, count, index]);\n\n  const context = React.useMemo<TeachingPopoverContextValue>(\n    () => ({\n      open,\n      shown,\n      requestOpen,\n      dismiss,\n      finish,\n      count,\n      index,\n      step,\n      isFirst,\n      isLast,\n      stepPosition,\n      goBack,\n      goNext,\n      goToStep,\n      primaryAction,\n      secondaryAction,\n      footerLayout,\n      backLabel,\n      nextLabel,\n      doneLabel,\n      closeLabel,\n      navLabel,\n      navButtonLabel,\n      titleId,\n      target,\n      side,\n      align,\n      positioning,\n      hasTrigger,\n      triggerElementRef,\n      triggerRef,\n      surfaceId,\n      setCustomSurfaceId,\n      registerSurface,\n    }),\n    [\n      open,\n      shown,\n      requestOpen,\n      dismiss,\n      finish,\n      count,\n      index,\n      step,\n      isFirst,\n      isLast,\n      stepPosition,\n      goBack,\n      goNext,\n      goToStep,\n      primaryAction,\n      secondaryAction,\n      footerLayout,\n      backLabel,\n      nextLabel,\n      doneLabel,\n      closeLabel,\n      navLabel,\n      navButtonLabel,\n      titleId,\n      target,\n      side,\n      align,\n      positioning,\n      hasTrigger,\n      triggerElementRef,\n      surfaceId,\n      registerSurface,\n    ],\n  );\n\n  return (\n    <TeachingPopoverContext.Provider value={context}>\n      {children}\n      {hasSurfacePart ? null : (\n        <TeachingSurface\n          context={context}\n          rootClassName={teachingPopoverClassNames.root}\n          id={id}\n          className={className}\n          style={style}\n          onKeyDown={onKeyDown}\n          {...rest}\n          ref={ref}\n        />\n      )}\n    </TeachingPopoverContext.Provider>\n  );\n};\nTeachingPopoverRoot.displayName = 'TeachingPopover';\n"],"mappings":"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AACsD;EAAYH;EAASlD;EAAOD;CAAK,CAAC;CAEtC,IAAMmG,IAAUzG,EAAM,eACb;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EACEgD;EACAW;EACA+B;EACAE;EACAE;EACAvF;EACAD;EACAQ;EACA+C;EACAC;EACAC;EACAiC;EACAC;EACAC;EACAjC;EACAC;EACAwC;EACAvC;EACAC;EACAC;EACAsC;EACArC;EACAC;EACAnB;EACAuB;EACAiC;EACAC;EACA3E;EACAwC;EACAG;EACAW;EACAN;CACF,CACF;CAEA,OACE,mBAAC4B,GAAuB,UAAxB;EAAiC,OAAOL;EAAxC,UAAA,CACGxF,GACAkE,IAAiB,OAChB,mBAAC4B,IAAD;GACW;GACT,eAAeC,GAA0B;GACrC;GACO;GACJ;GACI;GACX,GAAI/E;GACC;EACN,CAAA,CAE4B;;AAErC;AACA,EAAoB,cAAc"}

package/dist/index.d.cts

@@ -14610,8 +14610,11 @@ export declare type TagSize = Extract<Size, 'extra-small' | 'small' | 'medium'>;
  *   `TeachingPopover.Trigger`)/`onOpenChange`; Close, Done, Escape (anywhere in the document) and
  *   the Trigger dismiss it and call `onDismiss`.
  * - The step is controllable with `activeStep`/`defaultActiveStep`/`onStepChange` and clamped to
- *   the available steps. The heading carries a visually hidden “step n of m”, the new step is
- *   announced politely, and Back stays focusable (`aria-disabled`) on the first step.
+ *   the available steps. An uncontrolled step starts again at `defaultActiveStep` each time the
+ *   popover opens, so a tour finished with Done or closed midway starts over (`onStepChange`
+ *   reports the move back); a controlled `activeStep` is left as it is. The heading carries a
+ *   visually hidden “step n of m”, the new step is announced politely, and Back stays focusable
+ *   (`aria-disabled`) on the first step.
  * - `primaryAction` and `secondaryAction` (on the popover, or on a step, which wins) replace Next/Done
  *   and Back: a label, a Button-like element or a slot object. The consumer's `onClick` runs first,
  *   then the step's normal action unless it called `preventDefault()`. Done calls `onFinish`
@@ -15094,10 +15097,14 @@ export declare interface TeachingPopoverProps extends React_2.HTMLAttributes<HTM
     steps: readonly TeachingPopoverStep[];
     /**
      * Controlled index of the displayed step. Out-of-range values are clamped to the first or last
-     * step (with a development warning).
+     * step (with a development warning). Opening the popover leaves it as it is.
      */
     activeStep?: number;
-    /** Initial step index for uncontrolled usage.
+    /**
+     * Initial step index for uncontrolled usage, and the step the popover starts on again each time
+     * it opens (after Done, Close, Escape or the Trigger closed it, or a controlled `open` turned it
+     * off), so a tour opened again starts over; `onStepChange` is called with it when the step was
+     * elsewhere.
      * @default 0
      */
     defaultActiveStep?: number;
@@ -15107,7 +15114,9 @@ export declare interface TeachingPopoverProps extends React_2.HTMLAttributes<HTM
     defaultCurrentStep?: number;
     /**
      * Called with the requested step index when Next, Back or a step button of
-     * `TeachingPopover.CarouselNav` is activated (the button of the current step requests nothing).
+     * `TeachingPopover.CarouselNav` is activated (the button of the current step requests nothing),
+     * and, while the step is uncontrolled, with the initial step when an opening moves the step back
+     * to it (see `defaultActiveStep`).
      */
     onStepChange?: (step: number) => void;
     /**

package/dist/index.d.ts

@@ -14610,8 +14610,11 @@ export declare type TagSize = Extract<Size, 'extra-small' | 'small' | 'medium'>;
  *   `TeachingPopover.Trigger`)/`onOpenChange`; Close, Done, Escape (anywhere in the document) and
  *   the Trigger dismiss it and call `onDismiss`.
  * - The step is controllable with `activeStep`/`defaultActiveStep`/`onStepChange` and clamped to
- *   the available steps. The heading carries a visually hidden “step n of m”, the new step is
- *   announced politely, and Back stays focusable (`aria-disabled`) on the first step.
+ *   the available steps. An uncontrolled step starts again at `defaultActiveStep` each time the
+ *   popover opens, so a tour finished with Done or closed midway starts over (`onStepChange`
+ *   reports the move back); a controlled `activeStep` is left as it is. The heading carries a
+ *   visually hidden “step n of m”, the new step is announced politely, and Back stays focusable
+ *   (`aria-disabled`) on the first step.
  * - `primaryAction` and `secondaryAction` (on the popover, or on a step, which wins) replace Next/Done
  *   and Back: a label, a Button-like element or a slot object. The consumer's `onClick` runs first,
  *   then the step's normal action unless it called `preventDefault()`. Done calls `onFinish`
@@ -15094,10 +15097,14 @@ export declare interface TeachingPopoverProps extends React_2.HTMLAttributes<HTM
     steps: readonly TeachingPopoverStep[];
     /**
      * Controlled index of the displayed step. Out-of-range values are clamped to the first or last
-     * step (with a development warning).
+     * step (with a development warning). Opening the popover leaves it as it is.
      */
     activeStep?: number;
-    /** Initial step index for uncontrolled usage.
+    /**
+     * Initial step index for uncontrolled usage, and the step the popover starts on again each time
+     * it opens (after Done, Close, Escape or the Trigger closed it, or a controlled `open` turned it
+     * off), so a tour opened again starts over; `onStepChange` is called with it when the step was
+     * elsewhere.
      * @default 0
      */
     defaultActiveStep?: number;
@@ -15107,7 +15114,9 @@ export declare interface TeachingPopoverProps extends React_2.HTMLAttributes<HTM
     defaultCurrentStep?: number;
     /**
      * Called with the requested step index when Next, Back or a step button of
-     * `TeachingPopover.CarouselNav` is activated (the button of the current step requests nothing).
+     * `TeachingPopover.CarouselNav` is activated (the button of the current step requests nothing),
+     * and, while the step is uncontrolled, with the initial step when an opening moves the step back
+     * to it (see `defaultActiveStep`).
      */
     onStepChange?: (step: number) => void;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mortenbrudvik/waveui",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "type": "module",
   "description": "A comprehensive React component library with modern design tokens — accessible, composable components built with TypeScript and Tailwind CSS",
   "license": "MIT",