@skdx/react 0.26.0 → 0.28.0

package/dist/tour/TourProgressText.d.cts

@@ -1,13 +1,8 @@
 import * as React from 'react';
 import type { TourProgressTextProps } from './types.cjs';
 /**
- * The visible "Step 2 of 5" line, as a `<p>` also carrying `data-step` and
- * `data-total`. Pass `format` to translate it, or `children` to render the
- * position yourself.
- *
- * Not a live region: the same information is already spoken on every step
- * change through the tour's own announcement, and a second live region would
- * make a screen reader say it twice.
+ * The visible "Step 2 of 5" line as a `<p>` with `data-step` and `data-total`.
+ * Not a live region — the tour announces each step separately.
  *
  * @example
  * ```tsx

package/dist/tour/TourProgressText.d.ts

@@ -1,13 +1,8 @@
 import * as React from 'react';
 import type { TourProgressTextProps } from './types.js';
 /**
- * The visible "Step 2 of 5" line, as a `<p>` also carrying `data-step` and
- * `data-total`. Pass `format` to translate it, or `children` to render the
- * position yourself.
- *
- * Not a live region: the same information is already spoken on every step
- * change through the tour's own announcement, and a second live region would
- * make a screen reader say it twice.
+ * The visible "Step 2 of 5" line as a `<p>` with `data-step` and `data-total`.
+ * Not a live region — the tour announces each step separately.
  *
  * @example
  * ```tsx

package/dist/tour/TourSkipTrigger.d.cts

@@ -1,10 +1,7 @@
 import * as React from 'react';
 import type { TourSkipTriggerProps } from './types.cjs';
 /**
- * Button that ends the tour early: closes it and fires `onSkip`, never
- * `onComplete`. The explicit "Skip tour" affordance — every tour needs one on
- * every step, since a user who already knows the product must be able to get
- * out without clicking through.
+ * Button that ends the tour early and fires `onSkip` instead of `onComplete`.
  *
  * @example
  * ```tsx

package/dist/tour/TourSkipTrigger.d.ts

@@ -1,10 +1,7 @@
 import * as React from 'react';
 import type { TourSkipTriggerProps } from './types.js';
 /**
- * Button that ends the tour early: closes it and fires `onSkip`, never
- * `onComplete`. The explicit "Skip tour" affordance — every tour needs one on
- * every step, since a user who already knows the product must be able to get
- * out without clicking through.
+ * Button that ends the tour early and fires `onSkip` instead of `onComplete`.
  *
  * @example
  * ```tsx

package/dist/tour/TourSpotlight.d.cts

@@ -1,13 +1,9 @@
 import * as React from 'react';
 import type { TourSpotlightProps } from './types.cjs';
 /**
- * The highlight box sitting over the active step's target, carrying the same
- * `--skdx-tour-x` / `-y` / `-width` / `-height` geometry as `TourBackdrop` so a
- * ring, glow or cut-out can be positioned from CSS alone.
- *
- * Renders nothing when the active step has no resolved target — a centred step
- * spotlights nothing, and an empty box parked at the top-left corner would be
- * worse than no box. Decorative and `aria-hidden`.
+ * The highlight box over the active step's target, carrying CSS custom
+ * properties for ring, glow, or cut-out positioning. Renders nothing when
+ * the active step has no resolved target. Decorative and `aria-hidden`.
  *
  * @example
  * ```css

package/dist/tour/TourSpotlight.d.ts

@@ -1,13 +1,9 @@
 import * as React from 'react';
 import type { TourSpotlightProps } from './types.js';
 /**
- * The highlight box sitting over the active step's target, carrying the same
- * `--skdx-tour-x` / `-y` / `-width` / `-height` geometry as `TourBackdrop` so a
- * ring, glow or cut-out can be positioned from CSS alone.
- *
- * Renders nothing when the active step has no resolved target — a centred step
- * spotlights nothing, and an empty box parked at the top-left corner would be
- * worse than no box. Decorative and `aria-hidden`.
+ * The highlight box over the active step's target, carrying CSS custom
+ * properties for ring, glow, or cut-out positioning. Renders nothing when
+ * the active step has no resolved target. Decorative and `aria-hidden`.
  *
  * @example
  * ```css

package/dist/tour/TourTrigger.d.cts

@@ -1,13 +1,7 @@
 import * as React from 'react';
 import type { TourTriggerProps } from './types.cjs';
 /**
- * Button that starts the tour. Sets `aria-haspopup="dialog"`,
- * `aria-expanded`, `aria-controls` pointing at `TourContent`, and `data-state`
- * (`open`/`closed`).
- *
- * It is also where focus goes back to when the tour completes or is skipped —
- * whatever was focused when the tour started is what the focus trap restores,
- * and for a tour started from a button that is this button.
+ * Starts the tour. Sets `aria-haspopup="dialog"` and `aria-expanded`. Focus returns here when tour completes or is skipped.
  *
  * @example
  * ```tsx

package/dist/tour/TourTrigger.d.ts

@@ -1,13 +1,7 @@
 import * as React from 'react';
 import type { TourTriggerProps } from './types.js';
 /**
- * Button that starts the tour. Sets `aria-haspopup="dialog"`,
- * `aria-expanded`, `aria-controls` pointing at `TourContent`, and `data-state`
- * (`open`/`closed`).
- *
- * It is also where focus goes back to when the tour completes or is skipped —
- * whatever was focused when the tour started is what the focus trap restores,
- * and for a tour started from a button that is this button.
+ * Starts the tour. Sets `aria-haspopup="dialog"` and `aria-expanded`. Focus returns here when tour completes or is skipped.
  *
  * @example
  * ```tsx

package/dist/tour/index.d.cts

@@ -1,15 +1,2 @@
 export { Tour } from './Tour.cjs';
-export { TourTrigger } from './TourTrigger.cjs';
-export { TourPortal } from './TourPortal.cjs';
-export { TourBackdrop } from './TourBackdrop.cjs';
-export { TourSpotlight } from './TourSpotlight.cjs';
-export { TourContent } from './TourContent.cjs';
-export { TourArrow } from './TourArrow.cjs';
-export { TourTitle } from './TourTitle.cjs';
-export { TourDescription } from './TourDescription.cjs';
-export { TourProgressText } from './TourProgressText.cjs';
-export { TourNextTrigger } from './TourNextTrigger.cjs';
-export { TourPrevTrigger } from './TourPrevTrigger.cjs';
-export { TourSkipTrigger } from './TourSkipTrigger.cjs';
-export { TourCloseTrigger } from './TourCloseTrigger.cjs';
-export type { TourStep, TourStepType, TourProps, TourTriggerProps, TourPortalProps, TourBackdropProps, TourSpotlightProps, TourContentProps, TourArrowProps, TourTitleProps, TourDescriptionProps, TourProgressTextProps, TourNextTriggerProps, TourPrevTriggerProps, TourSkipTriggerProps, TourCloseTriggerProps, } from './types.cjs';
+export type { TourProps, TourStep, TourStepType } from './types.cjs';

package/dist/tour/index.d.ts

@@ -1,15 +1,2 @@
 export { Tour } from './Tour.js';
-export { TourTrigger } from './TourTrigger.js';
-export { TourPortal } from './TourPortal.js';
-export { TourBackdrop } from './TourBackdrop.js';
-export { TourSpotlight } from './TourSpotlight.js';
-export { TourContent } from './TourContent.js';
-export { TourArrow } from './TourArrow.js';
-export { TourTitle } from './TourTitle.js';
-export { TourDescription } from './TourDescription.js';
-export { TourProgressText } from './TourProgressText.js';
-export { TourNextTrigger } from './TourNextTrigger.js';
-export { TourPrevTrigger } from './TourPrevTrigger.js';
-export { TourSkipTrigger } from './TourSkipTrigger.js';
-export { TourCloseTrigger } from './TourCloseTrigger.js';
-export type { TourStep, TourStepType, TourProps, TourTriggerProps, TourPortalProps, TourBackdropProps, TourSpotlightProps, TourContentProps, TourArrowProps, TourTitleProps, TourDescriptionProps, TourProgressTextProps, TourNextTriggerProps, TourPrevTriggerProps, TourSkipTriggerProps, TourCloseTriggerProps, } from './types.js';
+export type { TourProps, TourStep, TourStepType } from './types.js';

package/dist/tour/primitives.d.cts

@@ -0,0 +1,41 @@
+/**
+ * Primitives for `Tour` — manual composition escape hatch.
+ *
+ * @example
+ * ```tsx
+ * import { Tour, TourTrigger, TourPortal, TourBackdrop, TourSpotlight, TourContent, TourTitle, TourProgressText, TourActions, TourPrevTrigger, TourNextTrigger, TourSkipTrigger } from '@skdx/react/primitives/tour';
+ *
+ * <Tour steps={steps}>
+ *   <TourTrigger>Take the tour</TourTrigger>
+ *   <TourPortal>
+ *     <TourBackdrop />
+ *     <TourSpotlight />
+ *     <TourContent>
+ *       <TourTitle>Your inbox</TourTitle>
+ *       <TourProgressText />
+ *       <TourActions>
+ *         <TourPrevTrigger>Back</TourPrevTrigger>
+ *         <TourNextTrigger>Next</TourNextTrigger>
+ *         <TourSkipTrigger>Skip</TourSkipTrigger>
+ *       </TourActions>
+ *     </TourContent>
+ *   </TourPortal>
+ * </Tour>
+ * ```
+ */
+export { Tour } from './Tour.cjs';
+export { TourTrigger } from './TourTrigger.cjs';
+export { TourPortal } from './TourPortal.cjs';
+export { TourBackdrop } from './TourBackdrop.cjs';
+export { TourSpotlight } from './TourSpotlight.cjs';
+export { TourContent } from './TourContent.cjs';
+export { TourArrow } from './TourArrow.cjs';
+export { TourTitle } from './TourTitle.cjs';
+export { TourDescription } from './TourDescription.cjs';
+export { TourProgressText } from './TourProgressText.cjs';
+export { TourActions } from './TourActions.cjs';
+export { TourNextTrigger } from './TourNextTrigger.cjs';
+export { TourPrevTrigger } from './TourPrevTrigger.cjs';
+export { TourSkipTrigger } from './TourSkipTrigger.cjs';
+export { TourCloseTrigger } from './TourCloseTrigger.cjs';
+export type { TourProps, TourTriggerProps, TourPortalProps, TourBackdropProps, TourSpotlightProps, TourContentProps, TourArrowProps, TourTitleProps, TourDescriptionProps, TourProgressTextProps, TourActionsProps, TourNextTriggerProps, TourPrevTriggerProps, TourSkipTriggerProps, TourCloseTriggerProps, } from './types.cjs';

package/dist/tour/primitives.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Primitives for `Tour` — manual composition escape hatch.
+ *
+ * @example
+ * ```tsx
+ * import { Tour, TourTrigger, TourPortal, TourBackdrop, TourSpotlight, TourContent, TourTitle, TourProgressText, TourActions, TourPrevTrigger, TourNextTrigger, TourSkipTrigger } from '@skdx/react/primitives/tour';
+ *
+ * <Tour steps={steps}>
+ *   <TourTrigger>Take the tour</TourTrigger>
+ *   <TourPortal>
+ *     <TourBackdrop />
+ *     <TourSpotlight />
+ *     <TourContent>
+ *       <TourTitle>Your inbox</TourTitle>
+ *       <TourProgressText />
+ *       <TourActions>
+ *         <TourPrevTrigger>Back</TourPrevTrigger>
+ *         <TourNextTrigger>Next</TourNextTrigger>
+ *         <TourSkipTrigger>Skip</TourSkipTrigger>
+ *       </TourActions>
+ *     </TourContent>
+ *   </TourPortal>
+ * </Tour>
+ * ```
+ */
+export { Tour } from './Tour.js';
+export { TourTrigger } from './TourTrigger.js';
+export { TourPortal } from './TourPortal.js';
+export { TourBackdrop } from './TourBackdrop.js';
+export { TourSpotlight } from './TourSpotlight.js';
+export { TourContent } from './TourContent.js';
+export { TourArrow } from './TourArrow.js';
+export { TourTitle } from './TourTitle.js';
+export { TourDescription } from './TourDescription.js';
+export { TourProgressText } from './TourProgressText.js';
+export { TourActions } from './TourActions.js';
+export { TourNextTrigger } from './TourNextTrigger.js';
+export { TourPrevTrigger } from './TourPrevTrigger.js';
+export { TourSkipTrigger } from './TourSkipTrigger.js';
+export { TourCloseTrigger } from './TourCloseTrigger.js';
+export type { TourProps, TourTriggerProps, TourPortalProps, TourBackdropProps, TourSpotlightProps, TourContentProps, TourArrowProps, TourTitleProps, TourDescriptionProps, TourProgressTextProps, TourActionsProps, TourNextTriggerProps, TourPrevTriggerProps, TourSkipTriggerProps, TourCloseTriggerProps, } from './types.js';

package/dist/tour/types.d.cts

@@ -1,66 +1,83 @@
 import type * as React from 'react';
+import type { PassThroughProps } from '../utils/passThrough.cjs';
 import type { Align, PopperContentProps, Side } from '../utils/popper.cjs';
 import type { PortalProps } from '../utils/portal.cjs';
 import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
 import type { FocusOutsideEvent, InteractOutsideEvent } from '../utils/useDismiss.cjs';
-/**
- * How a step presents itself. `tooltip` and `floating` both anchor to the
- * step's target; `dialog` renders centred even when a target is present, so a
- * step can spotlight an element while explaining it from the middle of the
- * screen. Published as `data-type` on `TourContent` either way.
- */
+import type { AutoFocusEvent } from '../utils/useFocusTrap.cjs';
+/** How step presents: `tooltip` / `floating` anchor to target, `dialog` centres. */
 export type TourStepType = 'tooltip' | 'dialog' | 'floating';
 /** One step of a {@link Tour}. Steps are data, not markup — the whole list is passed to the root. */
 export interface TourStep {
     /**
-     * The element this step points at, as a CSS selector or a ref. A step with
-     * no target renders centred and spotlights nothing — that is how a tour
-     * opens and closes.
-     * @default undefined — the step is centred, with no spotlight and no anchoring.
+     * Stable id for step; persist instead of index (which shifts on add/remove).
+     * @default undefined — `onStepChange` reports index alone.
+     */
+    id?: string;
+    /**
+     * Element step points at (CSS selector or ref); no target renders centred.
+     * @default undefined — centred with no spotlight.
      */
     target?: string | React.RefObject<HTMLElement | null>;
     /**
-     * Short name for the step, announced to screen readers alongside its
-     * position. Purely for the announcement — render the visible heading with
-     * `TourTitle`.
-     * @default undefined — only the position ("Step 2 of 5") is announced.
+     * Short name announced with step position (render visible heading with `TourTitle`).
+     * @default undefined — position only ("Step 2 of 5").
      */
     title?: string;
     /**
-     * Side of the target this step's content is placed against, fed straight to
-     * the shared popper layer. `start`/`end` are logical and mirror under RTL.
-     * @default undefined — falls back to `TourContent`'s own `side`, which defaults to `bottom`.
+     * Body text rendered as `TourDescription`.
+     * @default undefined — no description.
+     */
+    description?: string;
+    /**
+     * Side of target content is placed against (fed to popper).
+     * @default undefined — falls back to `TourContent`'s `side`.
      */
     placement?: Side;
     /**
      * Alignment along `placement`.
-     * @default undefined — falls back to `TourContent`'s own `align`, which defaults to `center`.
+     * @default undefined — falls back to `TourContent`'s `align`.
      */
     align?: Align;
     /**
-     * How this step presents itself. `dialog` forces centred content even with a
-     * target set; the other two anchor.
-     * @default undefined — anchored when the step has a target, centred when it does not.
+     * How step presents (`dialog` forces centre even with target).
+     * @default undefined — anchored if target exists, otherwise centred.
      */
     type?: TourStepType;
+    /**
+     * Whether step dims page (false renders no backdrop, drops `data-backdrop`).
+     * @default true
+     */
+    backdrop?: boolean;
 }
-/** @internal Shared state distributed from {@link Tour} to its parts via context. Not part of the public API. */
+/** @internal Shared state distributed from {@link Tour} to its parts via context; not public API. */
 export interface TourContextValue {
     steps: TourStep[];
     step: number;
     total: number;
     activeStep: TourStep | undefined;
     open: boolean;
-    /** True when the active step's content is positioned against a resolved target rather than centred. */
+    /** True when content is positioned against target (not centred). */
     anchored: boolean;
+    /** Whether active step keeps dimming layer. */
+    hasBackdrop: boolean;
+    /** Whether root binds ArrowRight / ArrowLeft navigation on Content. */
+    keyboardNavigation: boolean;
     target: HTMLElement | null;
     spotlightStyle: React.CSSProperties;
     contentRef: React.RefObject<HTMLDivElement | null>;
     contentId: string;
     titleId: string;
     descriptionId: string;
+    /** Whether `TourTitle` currently renders (withhold dangling `aria-labelledby`). */
+    hasTitle: boolean;
+    setHasTitle: (present: boolean) => void;
+    /** Whether `TourDescription` currently renders (withhold dangling `aria-describedby`). */
+    hasDescription: boolean;
+    setHasDescription: (present: boolean) => void;
     closeOnEscape: boolean;
     closeOnInteractOutside: boolean;
+    preventInteraction: boolean;
     setOpen: (open: boolean) => void;
     goTo: (index: number) => void;
     next: () => void;
@@ -69,53 +86,53 @@ export interface TourContextValue {
     complete: () => void;
 }
 /** Props for the {@link Tour} root. */
-export interface TourProps {
+export interface TourProps extends PassThroughProps {
     /**
-     * The trigger and portal, typically — the tour's own DOM (backdrop,
-     * spotlight, content) is rendered by {@link TourPortal} elsewhere.
-     * @default undefined — renders nothing if omitted.
+     * Manually-composed parts for full control; given children, derived anatomy is not rendered.
+     * @default undefined — the tour derives its anatomy from `steps`.
      */
     children?: React.ReactNode;
     /**
-     * The ordered steps. Required: a tour with no steps has nothing to show, and
-     * the array's length is what "Step 2 of 5" counts against.
+     * Ordered steps whose length counts against the total in step numbering.
      */
     steps: TourStep[];
     /**
-     * Whether the tour is running, for controlled usage. Pair with `onOpenChange`.
-     * @default undefined — uncontrolled, tracks its own open state internally.
+     * Whether tour is running for controlled usage; Pair with `onOpenChange`.
+     * @default undefined — uncontrolled.
      */
     open?: boolean;
     /**
-     * Whether the tour is running on mount, for uncontrolled usage.
-     * @default false — the tour waits for a trigger, so a first-visit tour is started deliberately rather than on every render.
+     * Whether tour runs on mount for uncontrolled usage.
+     * @default false — Set true to start on mount.
      */
     defaultOpen?: boolean;
     /**
-     * Fires with the new open state whenever the tour starts or ends, controlled or not.
+     * Fires with new open state when tour starts or ends.
      * @default undefined — no-op if omitted.
      */
     onOpenChange?: (open: boolean) => void;
     /**
-     * Index of the active step, for controlled usage. Pair with `onStepChange`.
-     * @default undefined — uncontrolled, tracks the index itself.
+     * Fires when open-state change finishes on screen `onOpenChange`.
+     * @default undefined — no-op if omitted.
+     */
+    onOpenChangeComplete?: (open: boolean) => void;
+    /**
+     * Active step index for controlled usage; Pair with `onStepChange`.
+     * @default undefined — uncontrolled.
      */
     step?: number;
     /**
-     * Index the tour starts on, for uncontrolled usage. Useful for resuming a
-     * tour the user abandoned.
+     * Index the tour starts on, for uncontrolled usage, useful for resuming an abandoned tour.
      * @default 0
      */
     defaultStep?: number;
     /**
-     * Fires with the new index whenever the active step changes, controlled or
-     * not. Not fired on completion or skip — those have their own callbacks.
+     * Fires with the new index and step's `id` when the step changes; persist the id, not the index.
      * @default undefined — no-op if omitted.
      */
-    onStepChange?: (step: number) => void;
+    onStepChange?: (step: number, id?: string) => void;
     /**
-     * Fires when the user advances past the last step. The tour closes either
-     * way; this is where you record that the user has seen it.
+     * Fires when the user advances past the last step; the tour closes either way regardless.
      * @default undefined — the tour still closes, it just tells nobody.
      */
     onComplete?: () => void;
@@ -126,46 +143,75 @@ export interface TourProps {
     onSkip?: () => void;
     /**
      * Whether pressing Escape ends the tour the same way skipping does.
-     * @default true — Escape must always get a user out of a modal layer; set `false` only when the tour genuinely cannot be abandoned, and then provide another way out.
+     * @default true — set `false` only when the tour cannot be abandoned, and then render a {@link TourSkipTrigger} or {@link TourCloseTrigger} inside {@link TourContent}.
      */
     closeOnEscape?: boolean;
+    /**
+     * Whether the page behind the tour is marked `inert` and Content declares `aria-modal="true"`.
+     * @default false — a tour points at the page, so the page stays readable and operable.
+     */
+    preventInteraction?: boolean;
     /**
      * Whether a pointer-down outside the content skips the tour.
-     * @default false — during a tour an outside click is almost always a misclick on the very UI being explained, and losing the tour to it is worse than ignoring it.
+     * @default false — an outside click during a tour is usually a misclick on the UI being explained.
      */
     closeOnInteractOutside?: boolean;
     /**
-     * Pixels of breathing room added around the target on every side when the
-     * spotlight geometry is published.
-     * @default 8 — the cutout clears the target's own focus ring instead of clipping it.
+     * Pixels of breathing room added around the target on every side when the spotlight geometry is published.
+     * @default 8 — clears the target's own focus ring instead of clipping it.
      */
     spotlightPadding?: number;
+    /**
+     * Corner radius of the spotlight cutout in pixels, published as `--skdx-tour-radius`.
+     * @default 0
+     */
+    spotlightRadius?: number;
+    /**
+     * Whether and how a step's target is scrolled into view; `behavior` forces `auto` when `prefers-reduced-motion: reduce` matches.
+     * @default { block: 'center', inline: 'center' }
+     */
+    scrollIntoView?: boolean | ScrollIntoViewOptions;
     /**
      * How long, in milliseconds, to keep polling for a step's target before
-     * giving up on it. Covers targets that mount late — a lazy route, a panel
-     * that opens on the previous step's action.
+     * giving up — covers targets that mount late, like a lazy route.
      * @default 2000 — long enough for a lazy chunk to land, short enough that a genuinely absent target does not strand the tour.
      */
     targetTimeout?: number;
     /**
-     * Fires when a step's target never appeared within `targetTimeout`. The tour
-     * then skips forward rather than rendering an unanchored popup.
+     * Fires when a step's target never appeared within `targetTimeout`; the tour then skips forward rather than rendering unanchored.
      * @default undefined — the step is still skipped, it just tells nobody.
      */
     onStepTargetMissing?: (index: number, step: TourStep) => void;
+    /**
+     * Whether ArrowRight/ArrowLeft navigate the tour when TourContent holds focus, mirrored under RTL; keys in `<input>` are never taken.
+     * @default false — arrow keys belong to whatever the step is pointing at.
+     */
+    keyboardNavigation?: boolean;
     /**
      * Builds the string announced to screen readers on every step change.
-     * Override it to translate, or to include more of the step than its title.
      * @default undefined — announces the step's `title` (when set) followed by "Step {n} of {total}", in English.
      */
     getAnnouncement?: (step: TourStep, index: number, total: number) => string;
+    /**
+     * Whether the derived anatomy renders a {@link TourProgressText}. Ignored when `children` is given.
+     * @default true
+     */
+    showProgress?: boolean;
+    /**
+     * Whether the derived anatomy renders a {@link TourSkipTrigger}. Ignored when `children` is given.
+     * @default true
+     */
+    showSkip?: boolean;
+    /**
+     * Whether the derived anatomy renders a {@link TourSpotlight} over the active step's target. Ignored when `children` is given.
+     * @default true
+     */
+    spotlight?: boolean;
 }
 /** Props for {@link TourPortal}, which teleports the tour's layer to `document.body`. */
 export interface TourPortalProps extends PortalProps {
     /**
      * Render the portal even while the tour is closed, instead of unmounting it.
-     * Useful for animation libraries that need the outgoing layer present in the
-     * DOM during an exit transition.
      * @default false
      */
     forceMount?: boolean;
@@ -181,17 +227,15 @@ export interface TourBackdropProps extends PrimitivePropsWithRef<'div'> {
 /** Props for {@link TourSpotlight}, the highlight box over the active step's target. */
 export interface TourSpotlightProps extends PrimitivePropsWithRef<'div'> {
     /**
-     * Keep the spotlight mounted even while the tour is closed. It still renders
-     * nothing when the active step has no target — there is nothing to spotlight.
+     * Keep the spotlight mounted even while the tour is closed; still renders nothing when the active step has no target.
      * @default false
      */
     forceMount?: boolean;
 }
 /**
  * Props for {@link TourContent}, the active step's panel. Extends the shared
- * popper positioning props (`side`, `align`, `sideOffset`, `alignOffset`,
- * `avoidCollisions`, `collisionPadding`, `collisionBoundary`), which act as
- * the defaults each step's own `placement`/`align` override.
+ * popper positioning props, which act as the defaults each step's own
+ * `placement`/`align` override.
  */
 export interface TourContentProps extends PopperContentProps {
     /**
@@ -200,32 +244,35 @@ export interface TourContentProps extends PopperContentProps {
      */
     forceMount?: boolean;
     /**
-     * Fires when Escape is pressed while the tour is open. Call
-     * `event.preventDefault()` to stop it from skipping the tour, regardless of
-     * `closeOnEscape`.
+     * Fires when Escape is pressed while the tour is open; call `event.preventDefault()` to stop it from skipping the tour.
      * @default undefined — no-op if omitted.
      */
     onEscapeKeyDown?: (event: KeyboardEvent) => void;
     /**
-     * Fires on pointer-down outside the content. Call `event.preventDefault()`
-     * to stop it from skipping the tour when `closeOnInteractOutside` is set.
+     * Fires on pointer-down outside the content; call `event.preventDefault()` to stop it from skipping the tour.
      * @default undefined — no-op if omitted.
      */
     onPointerDownOutside?: (event: PointerEvent) => void;
     /**
-     * Fires when focus moves outside the content. Reported only — a tour never
-     * ends on focus alone, since moving focus into the UI being explained is the
-     * point. Receives a cancelable stand-in carrying the original `focusin` as
-     * its `detail`.
+     * Fires when focus moves outside the content; reported only, since a tour never ends on focus alone.
      * @default undefined — no-op if omitted.
      */
     onFocusOutside?: (event: FocusOutsideEvent) => void;
     /**
-     * Fires for either kind of outside interaction, immediately before the
-     * specific handler above and with the same event.
+     * Fires for either kind of outside interaction, immediately before the specific handler above and with the same event.
      * @default undefined — no-op if omitted.
      */
     onInteractOutside?: (event: InteractOutsideEvent) => void;
+    /**
+     * Fires before focus moves into the panel; call preventDefault to place focus yourself, once per tour or per-step.
+     * @default undefined — no-op if omitted.
+     */
+    onOpenAutoFocus?: (event: AutoFocusEvent) => void;
+    /**
+     * Fires before focus returns to the previously focused element; call preventDefault to suppress that return.
+     * @default undefined — no-op if omitted.
+     */
+    onCloseAutoFocus?: (event: AutoFocusEvent) => void;
 }
 /** Props for {@link TourTrigger}, the button that starts the tour. */
 export interface TourTriggerProps extends PrimitivePropsWithRef<'button'> {
@@ -247,11 +294,19 @@ export interface TourProgressTextProps extends PrimitivePropsWithRef<'p'> {
      */
     format?: (index: number, total: number) => string;
 }
+/** Props for {@link TourActions}, the row the navigation triggers sit in. */
+export interface TourActionsProps extends PrimitivePropsWithRef<'div'> {
+}
 /** Props for {@link TourNextTrigger}, which advances the tour. */
 export interface TourNextTriggerProps extends PrimitivePropsWithRef<'button'> {
 }
 /** Props for {@link TourPrevTrigger}, which steps the tour back. */
 export interface TourPrevTriggerProps extends PrimitivePropsWithRef<'button'> {
+    /**
+     * Disables this button; automatically set on the first step.
+     * @default false
+     */
+    disabled?: boolean;
 }
 /** Props for {@link TourSkipTrigger}, which ends the tour early. */
 export interface TourSkipTriggerProps extends PrimitivePropsWithRef<'button'> {