@skdx/vue 0.26.0

package/dist/tooltip/TooltipProvider.vue.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Optional ancestor that coordinates hover-delay timing across multiple
+ * `SkdxTooltip`s: after any tooltip closes, sibling tooltips open instantly
+ * (skipping `delayDuration`) for `skipDelayDuration` ms, matching how OS
+ * tooltips behave when the pointer sweeps between adjacent triggers. Also
+ * supplies the default `disableHoverableContent` its descendant tooltips use.
+ * Renders no DOM element itself; wrap it once near the root of your app or
+ * a toolbar.
+ */
+type __VLS_Props = {
+    /** Delay before a tooltip opens on hover (ms). Individual `SkdxTooltip`s can override this. */
+    delayDuration?: number;
+    /** Window after closing during which sibling tooltips open instantly (ms), skipping their open delay. */
+    skipDelayDuration?: number;
+    /**
+     * Whether `SkdxTooltipContent` ignores the pointer entirely, so moving off
+     * the trigger closes the tooltip even if the pointer lands on the bubble.
+     *
+     * Set it `false` to let the pointer travel into the content and keep the
+     * tooltip open — a short grace period covers the gap between the two. The
+     * default differs from Radix's `false`: tooltips here are pointer-
+     * transparent today, and flipping that silently would be a breaking
+     * change. Individual `SkdxTooltip`s can override it.
+     */
+    disableHoverableContent?: boolean;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    delayDuration: number;
+    skipDelayDuration: number;
+    disableHoverableContent: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/tooltip/TooltipProvider.vue.js

@@ -0,0 +1 @@
+import e from"./TooltipProvider.vue_vue_type_script_setup_true_lang.js";var r=e;export{r as default};

package/dist/tooltip/TooltipProvider.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const i=require("./context.cjs");let e=require("vue");var s=(0,e.defineComponent)({__name:"TooltipProvider",props:{delayDuration:{default:700},skipDelayDuration:{default:300},disableHoverableContent:{type:Boolean,default:!0}},setup(n){const t=n,o=(0,e.ref)(!0);let r;(0,e.onBeforeUnmount)(()=>clearTimeout(r));function a(){clearTimeout(r),o.value=!1}function u(){clearTimeout(r),r=setTimeout(()=>{o.value=!0},t.skipDelayDuration)}return(0,e.provide)(i.TOOLTIP_PROVIDER_CONTEXT,{get delayDuration(){return t.delayDuration},get skipDelayDuration(){return t.skipDelayDuration},get disableHoverableContent(){return t.disableHoverableContent},isOpenDelayed:o,onOpen:a,onClose:u}),(l,p)=>(0,e.renderSlot)(l.$slots,"default")}});exports.default=s;

package/dist/tooltip/TooltipProvider.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{TOOLTIP_PROVIDER_CONTEXT as e}from"./context.js";import{defineComponent as t,onBeforeUnmount as o,provide as a,ref as n,renderSlot as r}from"vue";var l=/* @__PURE__ */t({__name:"TooltipProvider",props:{delayDuration:{default:700},skipDelayDuration:{default:300},disableHoverableContent:{type:Boolean,default:!0}},setup(t){const l=t,i=n(!0);let u;return o(()=>clearTimeout(u)),a(e,{get delayDuration(){return l.delayDuration},get skipDelayDuration(){return l.skipDelayDuration},get disableHoverableContent(){return l.disableHoverableContent},isOpenDelayed:i,onOpen:function(){clearTimeout(u),i.value=!1},onClose:function(){clearTimeout(u),u=setTimeout(()=>{i.value=!0},l.skipDelayDuration)}}),(e,t)=>r(e.$slots,"default")}});export{l as default};

package/dist/tooltip/TooltipTrigger.vue.cjs

@@ -0,0 +1 @@
+const e=require("./TooltipTrigger.vue_vue_type_script_setup_true_lang.cjs");var r=e.default;exports.default=r;

package/dist/tooltip/TooltipTrigger.vue.d.cts

@@ -0,0 +1,22 @@
+/**
+ * Element that reveals the tooltip on hover (after the configured delay,
+ * ignored for touch pointers) or focus, and doubles as the positioning
+ * anchor for `SkdxTooltipContent`. Sets `aria-describedby` (only while open)
+ * and `data-state` (`open`/`closed`). Closes on pointer-leave, blur, click,
+ * or Escape — pointer-leave after a short grace period when the tooltip's
+ * content is hoverable, so the pointer can cross into the bubble instead.
+ * Must be used inside `SkdxTooltip`.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/tooltip/TooltipTrigger.vue.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Element that reveals the tooltip on hover (after the configured delay,
+ * ignored for touch pointers) or focus, and doubles as the positioning
+ * anchor for `SkdxTooltipContent`. Sets `aria-describedby` (only while open)
+ * and `data-state` (`open`/`closed`). Closes on pointer-leave, blur, click,
+ * or Escape — pointer-leave after a short grace period when the tooltip's
+ * content is hoverable, so the pointer can cross into the bubble instead.
+ * Must be used inside `SkdxTooltip`.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/tooltip/TooltipTrigger.vue.js

@@ -0,0 +1 @@
+import e from"./TooltipTrigger.vue_vue_type_script_setup_true_lang.js";var r=e;export{r as default};

package/dist/tooltip/TooltipTrigger.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const a=require("../utils/popper.cjs"),f=require("./context.cjs");let e=require("vue");var d=["aria-describedby","data-state"],c=(0,e.defineComponent)({__name:"TooltipTrigger",setup(T){const o=(0,e.inject)(f.TOOLTIP_CONTEXT);if(!o)throw new Error("SkdxTooltipTrigger must be used within SkdxTooltip.");const i=(0,e.inject)(a.POPPER_CONTEXT);if(!i)throw new Error("SkdxTooltipTrigger must be used within SkdxTooltip.");const u=(0,e.ref)(null);(0,e.onMounted)(()=>i.setAnchor(u.value)),(0,e.onBeforeUnmount)(()=>{i.anchor.value===u.value&&i.setAnchor(null)});function l(n){n.pointerType!=="touch"&&o.onDelayedOpen()}function s(n){n.pointerType!=="touch"&&(o.disableHoverableContent.value?o.onClose():o.onDelayedClose())}function p(n){n.key==="Escape"&&o.onClose()}return(n,t)=>((0,e.openBlock)(),(0,e.createElementBlock)("button",{class:"skdx-tooltip__trigger","data-part":"trigger",ref_key:"elRef",ref:u,type:"button","aria-describedby":(0,e.unref)(o).open.value?(0,e.unref)(o).contentId:void 0,"data-state":(0,e.unref)(o).open.value?"open":"closed",onPointerenter:l,onPointerleave:s,onFocus:t[0]||(t[0]=(...r)=>(0,e.unref)(o).onOpen&&(0,e.unref)(o).onOpen(...r)),onBlur:t[1]||(t[1]=(...r)=>(0,e.unref)(o).onClose&&(0,e.unref)(o).onClose(...r)),onClick:t[2]||(t[2]=(...r)=>(0,e.unref)(o).onClose&&(0,e.unref)(o).onClose(...r)),onKeydown:p},[(0,e.renderSlot)(n.$slots,"default")],40,d))}});exports.default=c;

package/dist/tooltip/TooltipTrigger.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{POPPER_CONTEXT as e}from"../utils/popper.js";import{TOOLTIP_CONTEXT as o}from"./context.js";import{createElementBlock as n,defineComponent as t,inject as r,onBeforeUnmount as s,onMounted as a,openBlock as l,ref as i,renderSlot as u,unref as p}from"vue";var d=["aria-describedby","data-state"],c=/* @__PURE__ */t({__name:"TooltipTrigger",setup(t){const c=r(o);if(!c)throw new Error("SkdxTooltipTrigger must be used within SkdxTooltip.");const f=r(e);if(!f)throw new Error("SkdxTooltipTrigger must be used within SkdxTooltip.");const T=i(null);function m(e){"touch"!==e.pointerType&&c.onDelayedOpen()}function C(e){"touch"!==e.pointerType&&(c.disableHoverableContent.value?c.onClose():c.onDelayedClose())}function v(e){"Escape"===e.key&&c.onClose()}return a(()=>f.setAnchor(T.value)),s(()=>{f.anchor.value===T.value&&f.setAnchor(null)}),(e,o)=>(l(),n("button",{class:"skdx-tooltip__trigger","data-part":"trigger",ref_key:"elRef",ref:T,type:"button","aria-describedby":p(c).open.value?p(c).contentId:void 0,"data-state":p(c).open.value?"open":"closed",onPointerenter:m,onPointerleave:C,onFocus:o[0]||(o[0]=(...e)=>p(c).onOpen&&p(c).onOpen(...e)),onBlur:o[1]||(o[1]=(...e)=>p(c).onClose&&p(c).onClose(...e)),onClick:o[2]||(o[2]=(...e)=>p(c).onClose&&p(c).onClose(...e)),onKeydown:v},[u(e.$slots,"default")],40,d))}});export{c as default};

package/dist/tooltip/context.cjs

@@ -0,0 +1 @@
+const t=require("../utils/id.cjs");let e=require("vue");var o=Symbol("skdx-tooltip-provider-context");function n(){return{delayDuration:700,skipDelayDuration:300,disableHoverableContent:!0,isOpenDelayed:(0,e.ref)(!0),onOpen:()=>{},onClose:()=>{}}}var r=Symbol("skdx-tooltip-context");function i(){return t.nextId("tooltip-content")}exports.TOOLTIP_CONTEXT=r;exports.TOOLTIP_PROVIDER_CONTEXT=o;exports.defaultTooltipProviderContext=n;exports.nextTooltipContentId=i;

package/dist/tooltip/context.d.cts

@@ -0,0 +1,33 @@
+import { type InjectionKey, type Ref } from 'vue';
+/** @internal Injection key an optional TooltipProvider provides so sibling Tooltips can share hover-delay timing. */
+export interface TooltipProviderContext {
+    delayDuration: number;
+    skipDelayDuration: number;
+    /** Whether TooltipContent ignores the pointer entirely; individual Tooltips can override it. */
+    disableHoverableContent: boolean;
+    isOpenDelayed: Ref<boolean>;
+    onOpen(): void;
+    onClose(): void;
+}
+/** @internal Injection key a TooltipProvider provides so sibling Tooltips share hover-delay timing. */
+export declare const TOOLTIP_PROVIDER_CONTEXT: InjectionKey<TooltipProviderContext>;
+/** @internal Default TooltipProvider context used when a Tooltip has no ancestor TooltipProvider. */
+export declare function defaultTooltipProviderContext(): TooltipProviderContext;
+/** @internal Injection key a Tooltip provides so its parts can read/drive shared state. */
+export interface TooltipContext {
+    contentId: string;
+    /** The bubble element, published by TooltipContent so the root can watch its enter/exit motion. */
+    contentRef: Ref<HTMLElement | null>;
+    open: Readonly<Ref<boolean>>;
+    /** Resolved from this Tooltip's own prop, falling back to the provider's: `true` means the bubble ignores the pointer. */
+    disableHoverableContent: Readonly<Ref<boolean>>;
+    onOpen(): void;
+    onDelayedOpen(): void;
+    onClose(): void;
+    /** Closes after a short grace period, giving the pointer time to cross from the trigger into hoverable content. */
+    onDelayedClose(): void;
+}
+/** @internal Injection key a Tooltip provides so its Trigger/Content parts share open state. */
+export declare const TOOLTIP_CONTEXT: InjectionKey<TooltipContext>;
+/** @internal Generates a unique id for a Tooltip's content. */
+export declare function nextTooltipContentId(): string;

package/dist/tooltip/context.d.ts

@@ -0,0 +1,33 @@
+import { type InjectionKey, type Ref } from 'vue';
+/** @internal Injection key an optional TooltipProvider provides so sibling Tooltips can share hover-delay timing. */
+export interface TooltipProviderContext {
+    delayDuration: number;
+    skipDelayDuration: number;
+    /** Whether TooltipContent ignores the pointer entirely; individual Tooltips can override it. */
+    disableHoverableContent: boolean;
+    isOpenDelayed: Ref<boolean>;
+    onOpen(): void;
+    onClose(): void;
+}
+/** @internal Injection key a TooltipProvider provides so sibling Tooltips share hover-delay timing. */
+export declare const TOOLTIP_PROVIDER_CONTEXT: InjectionKey<TooltipProviderContext>;
+/** @internal Default TooltipProvider context used when a Tooltip has no ancestor TooltipProvider. */
+export declare function defaultTooltipProviderContext(): TooltipProviderContext;
+/** @internal Injection key a Tooltip provides so its parts can read/drive shared state. */
+export interface TooltipContext {
+    contentId: string;
+    /** The bubble element, published by TooltipContent so the root can watch its enter/exit motion. */
+    contentRef: Ref<HTMLElement | null>;
+    open: Readonly<Ref<boolean>>;
+    /** Resolved from this Tooltip's own prop, falling back to the provider's: `true` means the bubble ignores the pointer. */
+    disableHoverableContent: Readonly<Ref<boolean>>;
+    onOpen(): void;
+    onDelayedOpen(): void;
+    onClose(): void;
+    /** Closes after a short grace period, giving the pointer time to cross from the trigger into hoverable content. */
+    onDelayedClose(): void;
+}
+/** @internal Injection key a Tooltip provides so its Trigger/Content parts share open state. */
+export declare const TOOLTIP_CONTEXT: InjectionKey<TooltipContext>;
+/** @internal Generates a unique id for a Tooltip's content. */
+export declare function nextTooltipContentId(): string;

package/dist/tooltip/context.js

@@ -0,0 +1 @@
+import{nextId as o}from"../utils/id.js";import{ref as t}from"vue";var e=/* @__PURE__ */Symbol("skdx-tooltip-provider-context");function n(){return{delayDuration:700,skipDelayDuration:300,disableHoverableContent:!0,isOpenDelayed:t(!0),onOpen:()=>{},onClose:()=>{}}}var r=/* @__PURE__ */Symbol("skdx-tooltip-context");function i(){return o("tooltip-content")}export{r as TOOLTIP_CONTEXT,e as TOOLTIP_PROVIDER_CONTEXT,n as defaultTooltipProviderContext,i as nextTooltipContentId};

package/dist/tooltip/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./TooltipProvider.vue.cjs"),o=require("./Tooltip.vue.cjs"),r=require("./TooltipTrigger.vue.cjs"),t=require("./TooltipPortal.vue.cjs"),i=require("./TooltipContent.vue.cjs"),l=require("./TooltipArrow.vue.cjs");exports.SkdxTooltip=o.default;exports.SkdxTooltipArrow=l.default;exports.SkdxTooltipContent=i.default;exports.SkdxTooltipPortal=t.default;exports.SkdxTooltipProvider=e.default;exports.SkdxTooltipTrigger=r.default;

package/dist/tooltip/index.d.cts

@@ -0,0 +1,6 @@
+export { default as SkdxTooltipProvider } from './TooltipProvider.vue.cjs';
+export { default as SkdxTooltip } from './Tooltip.vue.cjs';
+export { default as SkdxTooltipTrigger } from './TooltipTrigger.vue.cjs';
+export { default as SkdxTooltipPortal } from './TooltipPortal.vue.cjs';
+export { default as SkdxTooltipContent } from './TooltipContent.vue.cjs';
+export { default as SkdxTooltipArrow } from './TooltipArrow.vue.cjs';

package/dist/tooltip/index.d.ts

@@ -0,0 +1,6 @@
+export { default as SkdxTooltipProvider } from './TooltipProvider.vue.js';
+export { default as SkdxTooltip } from './Tooltip.vue.js';
+export { default as SkdxTooltipTrigger } from './TooltipTrigger.vue.js';
+export { default as SkdxTooltipPortal } from './TooltipPortal.vue.js';
+export { default as SkdxTooltipContent } from './TooltipContent.vue.js';
+export { default as SkdxTooltipArrow } from './TooltipArrow.vue.js';

package/dist/tooltip/index.js

@@ -0,0 +1 @@
+import o from"./TooltipProvider.vue.js";import r from"./Tooltip.vue.js";import t from"./TooltipTrigger.vue.js";import i from"./TooltipPortal.vue.js";import p from"./TooltipContent.vue.js";import l from"./TooltipArrow.vue.js";export{r as SkdxTooltip,l as SkdxTooltipArrow,p as SkdxTooltipContent,i as SkdxTooltipPortal,o as SkdxTooltipProvider,t as SkdxTooltipTrigger};

package/dist/tour/Tour.vue.cjs

@@ -0,0 +1 @@
+const e=require("./Tour.vue_vue_type_script_setup_true_lang.cjs");var u=e.default;exports.default=u;

package/dist/tour/Tour.vue.d.cts

@@ -0,0 +1,139 @@
+import { type TourStep } from './context.cjs';
+/**
+ * The Vue implementation of the shared Tour contract (see `@skdx/shared`'s
+ * `tourContract`). Root of a stepped product tour: owns the running state,
+ * the active step index, the step list, target resolution and the spotlight
+ * geometry, and hands them down to `SkdxTourTrigger` / `SkdxTourPortal` /
+ * `SkdxTourBackdrop` / `SkdxTourSpotlight` / `SkdxTourContent` and the
+ * navigation triggers via context. Renders no DOM element itself.
+ *
+ * Steps are **data**: each declares the element it points at (a selector, an
+ * element, or a template ref), optionally a `placement`, a `title` for the
+ * announcement, and a `type`. A step with no target renders centred, which is
+ * how a tour usually opens and closes.
+ *
+ * A target that has not mounted yet is polled for up to `targetTimeout`; on
+ * timeout `step-target-missing` fires and the tour skips forward rather than
+ * showing a popup anchored to nothing. A target that is found is scrolled
+ * into view before it is measured.
+ *
+ * Works controlled (`v-model:open` / `v-model:step`) or uncontrolled
+ * (`default-open` / `default-step`) — the two axes are independent.
+ *
+ * Everything that touches the DOM (resolving a target, measuring it,
+ * announcing a step) is deferred to `onMounted` or a watcher, so the root
+ * server-renders without a DOM.
+ *
+ * @example
+ * ```vue
+ * <SkdxTour :steps="steps" @complete="markSeen">
+ *   <SkdxTourTrigger>Take the tour</SkdxTourTrigger>
+ *   <SkdxTourPortal>
+ *     <SkdxTourBackdrop />
+ *     <SkdxTourSpotlight />
+ *     <SkdxTourContent>
+ *       <SkdxTourTitle>Your inbox</SkdxTourTitle>
+ *       <SkdxTourDescription>Everything lands here first.</SkdxTourDescription>
+ *       <SkdxTourProgressText />
+ *       <SkdxTourPrevTrigger>Back</SkdxTourPrevTrigger>
+ *       <SkdxTourNextTrigger>Next</SkdxTourNextTrigger>
+ *       <SkdxTourSkipTrigger>Skip</SkdxTourSkipTrigger>
+ *     </SkdxTourContent>
+ *   </SkdxTourPortal>
+ * </SkdxTour>
+ * ```
+ */
+type __VLS_Props = {
+    /**
+     * 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.
+     */
+    steps: TourStep[];
+    /**
+     * Whether the tour is running, for controlled usage via `v-model:open`.
+     * @default undefined — uncontrolled, the tour tracks its own running state.
+     */
+    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.
+     */
+    defaultOpen?: boolean;
+    /**
+     * Index of the active step, for controlled usage via `v-model:step`.
+     * @default undefined — uncontrolled, the tour tracks the index itself.
+     */
+    step?: number;
+    /**
+     * Index the tour starts on, for uncontrolled usage.
+     * @default 0 — useful to raise when resuming a tour the user abandoned.
+     */
+    defaultStep?: number;
+    /**
+     * 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.
+     */
+    closeOnEscape?: 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.
+     */
+    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.
+     */
+    spotlightPadding?: number;
+    /**
+     * 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.
+     * @default 2000 — long enough for a lazy chunk to land, short enough that a genuinely absent target does not strand the tour.
+     */
+    targetTimeout?: number;
+    /**
+     * 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;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (open: boolean) => any;
+    "open-change": (open: boolean) => any;
+    complete: () => any;
+    "update:step": (step: number) => any;
+    "step-change": (step: number) => any;
+    skip: () => any;
+    "step-target-missing": (index: number, step: TourStep) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:open"?: ((open: boolean) => any) | undefined;
+    "onOpen-change"?: ((open: boolean) => any) | undefined;
+    onComplete?: (() => any) | undefined;
+    "onUpdate:step"?: ((step: number) => any) | undefined;
+    "onStep-change"?: ((step: number) => any) | undefined;
+    onSkip?: (() => any) | undefined;
+    "onStep-target-missing"?: ((index: number, step: TourStep) => any) | undefined;
+}>, {
+    open: boolean;
+    defaultOpen: boolean;
+    step: number;
+    defaultStep: number;
+    closeOnEscape: boolean;
+    closeOnInteractOutside: boolean;
+    spotlightPadding: number;
+    targetTimeout: number;
+    getAnnouncement: (step: TourStep, index: number, total: number) => string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/tour/Tour.vue.d.ts

@@ -0,0 +1,139 @@
+import { type TourStep } from './context.js';
+/**
+ * The Vue implementation of the shared Tour contract (see `@skdx/shared`'s
+ * `tourContract`). Root of a stepped product tour: owns the running state,
+ * the active step index, the step list, target resolution and the spotlight
+ * geometry, and hands them down to `SkdxTourTrigger` / `SkdxTourPortal` /
+ * `SkdxTourBackdrop` / `SkdxTourSpotlight` / `SkdxTourContent` and the
+ * navigation triggers via context. Renders no DOM element itself.
+ *
+ * Steps are **data**: each declares the element it points at (a selector, an
+ * element, or a template ref), optionally a `placement`, a `title` for the
+ * announcement, and a `type`. A step with no target renders centred, which is
+ * how a tour usually opens and closes.
+ *
+ * A target that has not mounted yet is polled for up to `targetTimeout`; on
+ * timeout `step-target-missing` fires and the tour skips forward rather than
+ * showing a popup anchored to nothing. A target that is found is scrolled
+ * into view before it is measured.
+ *
+ * Works controlled (`v-model:open` / `v-model:step`) or uncontrolled
+ * (`default-open` / `default-step`) — the two axes are independent.
+ *
+ * Everything that touches the DOM (resolving a target, measuring it,
+ * announcing a step) is deferred to `onMounted` or a watcher, so the root
+ * server-renders without a DOM.
+ *
+ * @example
+ * ```vue
+ * <SkdxTour :steps="steps" @complete="markSeen">
+ *   <SkdxTourTrigger>Take the tour</SkdxTourTrigger>
+ *   <SkdxTourPortal>
+ *     <SkdxTourBackdrop />
+ *     <SkdxTourSpotlight />
+ *     <SkdxTourContent>
+ *       <SkdxTourTitle>Your inbox</SkdxTourTitle>
+ *       <SkdxTourDescription>Everything lands here first.</SkdxTourDescription>
+ *       <SkdxTourProgressText />
+ *       <SkdxTourPrevTrigger>Back</SkdxTourPrevTrigger>
+ *       <SkdxTourNextTrigger>Next</SkdxTourNextTrigger>
+ *       <SkdxTourSkipTrigger>Skip</SkdxTourSkipTrigger>
+ *     </SkdxTourContent>
+ *   </SkdxTourPortal>
+ * </SkdxTour>
+ * ```
+ */
+type __VLS_Props = {
+    /**
+     * 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.
+     */
+    steps: TourStep[];
+    /**
+     * Whether the tour is running, for controlled usage via `v-model:open`.
+     * @default undefined — uncontrolled, the tour tracks its own running state.
+     */
+    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.
+     */
+    defaultOpen?: boolean;
+    /**
+     * Index of the active step, for controlled usage via `v-model:step`.
+     * @default undefined — uncontrolled, the tour tracks the index itself.
+     */
+    step?: number;
+    /**
+     * Index the tour starts on, for uncontrolled usage.
+     * @default 0 — useful to raise when resuming a tour the user abandoned.
+     */
+    defaultStep?: number;
+    /**
+     * 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.
+     */
+    closeOnEscape?: 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.
+     */
+    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.
+     */
+    spotlightPadding?: number;
+    /**
+     * 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.
+     * @default 2000 — long enough for a lazy chunk to land, short enough that a genuinely absent target does not strand the tour.
+     */
+    targetTimeout?: number;
+    /**
+     * 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;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (open: boolean) => any;
+    "open-change": (open: boolean) => any;
+    complete: () => any;
+    "update:step": (step: number) => any;
+    "step-change": (step: number) => any;
+    skip: () => any;
+    "step-target-missing": (index: number, step: TourStep) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:open"?: ((open: boolean) => any) | undefined;
+    "onOpen-change"?: ((open: boolean) => any) | undefined;
+    onComplete?: (() => any) | undefined;
+    "onUpdate:step"?: ((step: number) => any) | undefined;
+    "onStep-change"?: ((step: number) => any) | undefined;
+    onSkip?: (() => any) | undefined;
+    "onStep-target-missing"?: ((index: number, step: TourStep) => any) | undefined;
+}>, {
+    open: boolean;
+    defaultOpen: boolean;
+    step: number;
+    defaultStep: number;
+    closeOnEscape: boolean;
+    closeOnInteractOutside: boolean;
+    spotlightPadding: number;
+    targetTimeout: number;
+    getAnnouncement: (step: TourStep, index: number, total: number) => string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/tour/Tour.vue.js

@@ -0,0 +1 @@
+import e from"./Tour.vue_vue_type_script_setup_true_lang.js";var r=e;export{r as default};

package/dist/tour/Tour.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const T=require("../utils/id.cjs"),D=require("../utils/popper.cjs"),d=require("../utils/clamp.cjs"),H=require("../utils/liveAnnouncer.cjs"),U=require("./context.cjs");let t=require("vue");var V=50,W=(0,t.defineComponent)({__name:"Tour",props:{steps:{},open:{type:Boolean,default:void 0},defaultOpen:{type:Boolean,default:!1},step:{default:void 0},defaultStep:{default:0},closeOnEscape:{type:Boolean,default:!0},closeOnInteractOutside:{type:Boolean,default:!1},spotlightPadding:{default:8},targetTimeout:{default:2e3},getAnnouncement:{type:Function,default:void 0}},emits:["update:open","open-change","update:step","step-change","complete","skip","step-target-missing"],setup(B,{emit:L}){const n=B,s=L,$=(0,t.ref)(null),i=(0,t.ref)(null),v=(0,t.ref)(null),g=(0,t.ref)(null),y=(0,t.ref)(n.defaultOpen),a=(0,t.computed)(()=>n.open??y.value),I=(0,t.ref)(n.defaultStep),o=(0,t.computed)(()=>n.step??I.value),R=(0,t.computed)(()=>n.steps),m=(0,t.computed)(()=>n.steps.length),h=(0,t.computed)(()=>n.steps[o.value]),q=(0,t.computed)(()=>i.value!==null&&h.value?.type!=="dialog");function w(e){e!==a.value&&(n.open===void 0&&(y.value=e),s("update:open",e),s("open-change",e))}function C(e){e!==o.value&&(n.step===void 0&&(I.value=e),s("update:step",e),s("step-change",e))}function _(e){C(d.clamp(e,0,Math.max(m.value-1,0)))}function x(){w(!1),s("complete")}function M(){w(!1),s("skip")}function E(){o.value>=m.value-1?x():_(o.value+1)}function N(){_(o.value-1)}function S(e){return e?typeof e=="string"?document.querySelector(e):(0,t.isRef)(e)?e.value:e:null}const P=(0,t.computed)(()=>h.value?.target);let O;function f(){clearInterval(O),O=void 0}function k(){if(f(),!a.value)return;const e=P.value;if(!e){i.value=null;return}const l=p=>{p.scrollIntoView?.({block:"center",inline:"center"}),i.value=p},r=S(e);if(r){l(r);return}i.value=null;const u=Date.now(),c=o.value;O=setInterval(()=>{const p=S(e);if(p){f(),l(p);return}Date.now()-u<n.targetTimeout||(f(),s("step-target-missing",c,n.steps[c]),E())},V)}(0,t.watch)([a,o,P,()=>n.targetTimeout],k,{flush:"post"}),(0,t.onMounted)(k),(0,t.onBeforeUnmount)(f),(0,t.watch)(i,(e,l,r)=>{if(!e){v.value=null;return}const u=()=>{v.value=e.getBoundingClientRect()};u(),window.addEventListener("scroll",u,!0),window.addEventListener("resize",u),r(()=>{window.removeEventListener("scroll",u,!0),window.removeEventListener("resize",u)})},{flush:"post"});function b(e,l,r){return[e.title,`Step ${l+1} of ${r}`].filter(Boolean).join(", ")}function A(){if(!a.value)return;const e=n.steps[o.value];e&&H.announce((n.getAnnouncement??b)(e,o.value,n.steps.length))}(0,t.watch)([a,o],A,{flush:"post"}),(0,t.onMounted)(A);const z=(0,t.computed)(()=>{const e=v.value;if(!e)return{};const l=window.innerWidth,r=window.innerHeight,u=d.clamp(e.left-n.spotlightPadding,0,l),c=d.clamp(e.top-n.spotlightPadding,0,r);return{"--skdx-tour-x":`${u}px`,"--skdx-tour-y":`${c}px`,"--skdx-tour-width":`${d.clamp(e.width+n.spotlightPadding*2,0,l-u)}px`,"--skdx-tour-height":`${d.clamp(e.height+n.spotlightPadding*2,0,r-c)}px`}});return(0,t.watchEffect)(()=>{g.value=q.value?i.value:null}),(0,t.provide)(D.POPPER_CONTEXT,{anchor:g,setAnchor:e=>{g.value=e}}),(0,t.provide)(U.TOUR_CONTEXT,{steps:R,step:o,total:m,activeStep:h,open:a,anchored:q,target:i,spotlightStyle:z,contentRef:$,contentId:T.nextId("tour-content"),titleId:T.nextId("tour-title"),descriptionId:T.nextId("tour-description"),closeOnEscape:(0,t.computed)(()=>n.closeOnEscape),closeOnInteractOutside:(0,t.computed)(()=>n.closeOnInteractOutside),setOpen:w,goTo:_,next:E,prev:N,skip:M,complete:x}),(e,l)=>(0,t.renderSlot)(e.$slots,"default")}});exports.default=W;

package/dist/tour/Tour.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{nextId as e}from"../utils/id.js";import{POPPER_CONTEXT as t}from"../utils/popper.js";import{clamp as n}from"../utils/clamp.js";import{announce as o}from"../utils/liveAnnouncer.js";import{TOUR_CONTEXT as l}from"./context.js";import{computed as s,defineComponent as u,isRef as a,onBeforeUnmount as i,onMounted as r,provide as p,ref as d,renderSlot as c,watch as v,watchEffect as f}from"vue";var g=/* @__PURE__ */u({__name:"Tour",props:{steps:{},open:{type:Boolean,default:void 0},defaultOpen:{type:Boolean,default:!1},step:{default:void 0},defaultStep:{default:0},closeOnEscape:{type:Boolean,default:!0},closeOnInteractOutside:{type:Boolean,default:!1},spotlightPadding:{default:8},targetTimeout:{default:2e3},getAnnouncement:{type:Function,default:void 0}},emits:["update:open","open-change","update:step","step-change","complete","skip","step-target-missing"],setup(u,{emit:g}){const m=u,h=g,w=d(null),O=d(null),x=d(null),E=d(null),y=d(m.defaultOpen),I=s(()=>m.open??y.value),T=d(m.defaultStep),k=s(()=>m.step??T.value),P=s(()=>m.steps),B=s(()=>m.steps.length),S=s(()=>m.steps[k.value]),$=s(()=>null!==O.value&&"dialog"!==S.value?.type);function j(e){e!==I.value&&(void 0===m.open&&(y.value=e),h("update:open",e),h("open-change",e))}function R(e){!function(e){e!==k.value&&(void 0===m.step&&(T.value=e),h("update:step",e),h("step-change",e))}(n(e,0,Math.max(B.value-1,0)))}function A(){j(!1),h("complete")}function C(){k.value>=B.value-1?A():R(k.value+1)}function L(e){return e?"string"==typeof e?document.querySelector(e):a(e)?e.value:e:null}const _=s(()=>S.value?.target);let z;function D(){clearInterval(z),z=void 0}function M(){if(D(),!I.value)return;const e=_.value;if(!e)return void(O.value=null);const t=e=>{e.scrollIntoView?.({block:"center",inline:"center"}),O.value=e},n=L(e);if(n)return void t(n);O.value=null;const o=Date.now(),l=k.value;z=setInterval(()=>{const n=L(e);if(n)return D(),void t(n);Date.now()-o<m.targetTimeout||(D(),h("step-target-missing",l,m.steps[l]),C())},50)}function N(e,t,n){return[e.title,`Step ${t+1} of ${n}`].filter(Boolean).join(", ")}function U(){if(!I.value)return;const e=m.steps[k.value];e&&o((m.getAnnouncement??N)(e,k.value,m.steps.length))}v([I,k,_,()=>m.targetTimeout],M,{flush:"post"}),r(M),i(D),v(O,(e,t,n)=>{if(!e)return void(x.value=null);const o=()=>{x.value=e.getBoundingClientRect()};o(),window.addEventListener("scroll",o,!0),window.addEventListener("resize",o),n(()=>{window.removeEventListener("scroll",o,!0),window.removeEventListener("resize",o)})},{flush:"post"}),v([I,k],U,{flush:"post"}),r(U);const X=s(()=>{const e=x.value;if(!e)return{};const t=window.innerWidth,o=window.innerHeight,l=n(e.left-m.spotlightPadding,0,t),s=n(e.top-m.spotlightPadding,0,o);return{"--skdx-tour-x":`${l}px`,"--skdx-tour-y":`${s}px`,"--skdx-tour-width":`${n(e.width+2*m.spotlightPadding,0,t-l)}px`,"--skdx-tour-height":`${n(e.height+2*m.spotlightPadding,0,o-s)}px`}});return f(()=>{E.value=$.value?O.value:null}),p(t,{anchor:E,setAnchor:e=>{E.value=e}}),p(l,{steps:P,step:k,total:B,activeStep:S,open:I,anchored:$,target:O,spotlightStyle:X,contentRef:w,contentId:e("tour-content"),titleId:e("tour-title"),descriptionId:e("tour-description"),closeOnEscape:s(()=>m.closeOnEscape),closeOnInteractOutside:s(()=>m.closeOnInteractOutside),setOpen:j,goTo:R,next:C,prev:function(){R(k.value-1)},skip:function(){j(!1),h("skip")},complete:A}),(e,t)=>c(e.$slots,"default")}});export{g as default};

package/dist/tour/TourArrow.vue.cjs

@@ -0,0 +1 @@
+const r=require("./TourArrow.vue_vue_type_script_setup_true_lang.cjs");var e=r.default;exports.default=e;

package/dist/tour/TourArrow.vue.d.cts

@@ -0,0 +1,22 @@
+/**
+ * Optional arrow pointing from `SkdxTourContent` back at the step's target,
+ * self-positioning on the edge facing it. Must be rendered inside
+ * `SkdxTourContent`.
+ *
+ * Renders nothing on a step that is centred — one with no target, or with
+ * `type: 'dialog'`. There is nothing for it to point at, and the underlying
+ * popper arrow has no positioning context to read on that branch.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/tour/TourArrow.vue.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Optional arrow pointing from `SkdxTourContent` back at the step's target,
+ * self-positioning on the edge facing it. Must be rendered inside
+ * `SkdxTourContent`.
+ *
+ * Renders nothing on a step that is centred — one with no target, or with
+ * `type: 'dialog'`. There is nothing for it to point at, and the underlying
+ * popper arrow has no positioning context to read on that branch.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/tour/TourArrow.vue.js

@@ -0,0 +1 @@
+import r from"./TourArrow.vue_vue_type_script_setup_true_lang.js";var e=r;export{e as default};

package/dist/tour/TourArrow.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const u=require("../utils/popper.cjs"),l=require("./context.cjs");let e=require("vue");var s=(0,e.defineComponent)({__name:"TourArrow",setup(a){const o=(0,e.inject)(l.TOUR_CONTEXT);if(!o)throw new Error("SkdxTourArrow must be used within SkdxTour.");const r=(0,e.inject)(u.ARROW_CONTEXT);if(!r)throw new Error("SkdxTourArrow must be used within SkdxTourContent.");const n=(0,e.ref)(null);return(0,e.watch)(n,t=>r.setArrowEl(t)),(0,e.onBeforeUnmount)(()=>r.setArrowEl(null)),(t,_)=>(0,e.unref)(o).anchored.value?((0,e.openBlock)(),(0,e.createElementBlock)("span",{key:0,class:"skdx-tour__arrow","data-part":"arrow",ref_key:"elRef",ref:n,style:(0,e.normalizeStyle)((0,e.unref)(r).style.value)},[(0,e.renderSlot)(t.$slots,"default")],4)):(0,e.createCommentVNode)("",!0)}});exports.default=s;

package/dist/tour/TourArrow.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{ARROW_CONTEXT as r}from"../utils/popper.js";import{TOUR_CONTEXT as e}from"./context.js";import{createCommentVNode as o,createElementBlock as t,defineComponent as s,inject as a,normalizeStyle as n,onBeforeUnmount as l,openBlock as u,ref as m,renderSlot as d,unref as f,watch as w}from"vue";var i=/* @__PURE__ */s({__name:"TourArrow",setup(s){const i=a(e);if(!i)throw new Error("SkdxTourArrow must be used within SkdxTour.");const c=a(r);if(!c)throw new Error("SkdxTourArrow must be used within SkdxTourContent.");const p=m(null);return w(p,r=>c.setArrowEl(r)),l(()=>c.setArrowEl(null)),(r,e)=>f(i).anchored.value?(u(),t("span",{key:0,class:"skdx-tour__arrow","data-part":"arrow",ref_key:"elRef",ref:p,style:n(f(c).style.value)},[d(r.$slots,"default")],4)):o("",!0)}});export{i as default};

package/dist/tour/TourBackdrop.vue.cjs

@@ -0,0 +1 @@
+const e=require("./TourBackdrop.vue_vue_type_script_setup_true_lang.cjs");var r=e.default;exports.default=r;