@skdx/vue 0.28.0 → 0.29.0

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

@@ -1,6 +1,5 @@
 /**
- * Button advances to next step; on final step, completes tour (closes, emits `complete`).
- * Use `data-last` to relabel without tracking index. Must be used in `SkdxTour`.
+ * Button that advances to the next step, or completes the tour on the final step.
  *
  * @example
  * ```vue

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

@@ -1,6 +1,5 @@
 /**
- * Button advances to next step; on final step, completes tour (closes, emits `complete`).
- * Use `data-last` to relabel without tracking index. Must be used in `SkdxTour`.
+ * Button that advances to the next step, or completes the tour on the final step.
  *
  * @example
  * ```vue

package/dist/tour/TourNextTrigger.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const n=require("./context.cjs");let e=require("vue");var a=["data-last"],s=(0,e.defineComponent)({__name:"TourNextTrigger",setup(i){const t=(0,e.inject)(n.TOUR_CONTEXT);if(!t)throw new Error("SkdxTourNextTrigger must be used within SkdxTour.");const u=(0,e.computed)(()=>t.step.value>=t.total.value-1);return(o,r)=>((0,e.openBlock)(),(0,e.createElementBlock)("button",{class:"skdx-tour__next-trigger","data-part":"next-trigger",type:"button","data-last":u.value?"":void 0,onClick:r[0]||(r[0]=l=>(0,e.unref)(t).next())},[(0,e.renderSlot)(o.$slots,"default")],8,a))}});exports.default=s;
+const o=require("../utils/injectRequired.cjs"),a=require("./context.cjs");let e=require("vue");var i=["data-last"],s=(0,e.defineComponent)({__name:"TourNextTrigger",setup(l){const t=o.injectRequired(a.TOUR_CONTEXT,"SkdxTourNextTrigger must be used within SkdxTour."),u=(0,e.computed)(()=>t.step.value>=t.total.value-1);return(n,r)=>((0,e.openBlock)(),(0,e.createElementBlock)("button",{class:"skdx-tour__next-trigger","data-part":"next-trigger",type:"button","data-last":u.value?"":void 0,onClick:r[0]||(r[0]=_=>(0,e.unref)(t).next())},[(0,e.renderSlot)(n.$slots,"default")],8,i))}});exports.default=s;

package/dist/tour/TourNextTrigger.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{TOUR_CONTEXT as t}from"./context.js";import{computed as e,createElementBlock as r,defineComponent as a,inject as o,openBlock as s,renderSlot as n,unref as u}from"vue";var l=["data-last"],d=/* @__PURE__ */a({__name:"TourNextTrigger",setup(a){const d=o(t);if(!d)throw new Error("SkdxTourNextTrigger must be used within SkdxTour.");const i=e(()=>d.step.value>=d.total.value-1);return(t,e)=>(s(),r("button",{class:"skdx-tour__next-trigger","data-part":"next-trigger",type:"button","data-last":i.value?"":void 0,onClick:e[0]||(e[0]=t=>u(d).next())},[n(t.$slots,"default")],8,l))}});export{d as default};
+import{injectRequired as t}from"../utils/injectRequired.js";import{TOUR_CONTEXT as e}from"./context.js";import{computed as r,createElementBlock as a,defineComponent as o,openBlock as s,renderSlot as u,unref as n}from"vue";var i=["data-last"],l=/* @__PURE__ */o({__name:"TourNextTrigger",setup(o){const l=t(e,"SkdxTourNextTrigger must be used within SkdxTour."),d=r(()=>l.step.value>=l.total.value-1);return(t,e)=>(s(),a("button",{class:"skdx-tour__next-trigger","data-part":"next-trigger",type:"button","data-last":d.value?"":void 0,onClick:e[0]||(e[0]=t=>n(l).next())},[u(t.$slots,"default")],8,i))}});export{l as default};

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

@@ -1,8 +1,5 @@
 import type { PortalContainer } from '../utils/portal.cjs';
-/**
- * Teleports the tour layer to `document.body` (or a custom `container`) so
- * it escapes clipping. Mounts while the tour is running unless `forceMount` is set.
- */
+/** Teleports the tour layer to `document.body` (or a custom `container`) so it escapes clipping. */
 type __VLS_Props = {
     /**
      * DOM node (or CSS selector) the children are rendered into.
@@ -10,9 +7,7 @@ type __VLS_Props = {
      */
     container?: PortalContainer;
     /**
-     * Render the portal even while the tour is closed, instead of unmounting
-     * it — for animation libraries that need the outgoing layer present in the
-     * DOM during an exit transition.
+     * Render the portal even while the tour is closed, instead of unmounting it.
      * @default false — the layer leaves the DOM with the tour.
      */
     forceMount?: boolean;

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

@@ -1,8 +1,5 @@
 import type { PortalContainer } from '../utils/portal.js';
-/**
- * Teleports the tour layer to `document.body` (or a custom `container`) so
- * it escapes clipping. Mounts while the tour is running unless `forceMount` is set.
- */
+/** Teleports the tour layer to `document.body` (or a custom `container`) so it escapes clipping. */
 type __VLS_Props = {
     /**
      * DOM node (or CSS selector) the children are rendered into.
@@ -10,9 +7,7 @@ type __VLS_Props = {
      */
     container?: PortalContainer;
     /**
-     * Render the portal even while the tour is closed, instead of unmounting
-     * it — for animation libraries that need the outgoing layer present in the
-     * DOM during an exit transition.
+     * Render the portal even while the tour is closed, instead of unmounting it.
      * @default false — the layer leaves the DOM with the tour.
      */
     forceMount?: boolean;

package/dist/tour/TourPortal.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const n=require("../utils/Portal.vue.cjs"),u=require("./context.cjs");let e=require("vue");var a=(0,e.defineComponent)({__name:"TourPortal",props:{container:{default:null},forceMount:{type:Boolean,default:!1}},setup(t){const r=(0,e.inject)(u.TOUR_CONTEXT);if(!r)throw new Error("SkdxTourPortal must be used within SkdxTour.");return(o,l)=>t.forceMount||(0,e.unref)(r).open.value?((0,e.openBlock)(),(0,e.createBlock)(n.default,{key:0,container:t.container},{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(o.$slots,"default")]),_:3},8,["container"])):(0,e.createCommentVNode)("",!0)}});exports.default=a;
+const o=require("../utils/injectRequired.cjs"),n=require("../utils/Portal.vue.cjs"),a=require("./context.cjs");let e=require("vue");var l=(0,e.defineComponent)({__name:"TourPortal",props:{container:{default:null},forceMount:{type:Boolean,default:!1}},setup(t){const r=o.injectRequired(a.TOUR_CONTEXT,"SkdxTourPortal must be used within SkdxTour.");return(u,c)=>t.forceMount||(0,e.unref)(r).open.value?((0,e.openBlock)(),(0,e.createBlock)(n.default,{key:0,container:t.container},{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(u.$slots,"default")]),_:3},8,["container"])):(0,e.createCommentVNode)("",!0)}});exports.default=l;

package/dist/tour/TourPortal.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import e from"../utils/Portal.vue.js";import{TOUR_CONTEXT as o}from"./context.js";import{createBlock as t,createCommentVNode as r,defineComponent as a,inject as n,openBlock as s,renderSlot as u,unref as l,withCtx as i}from"vue";var c=/* @__PURE__ */a({__name:"TourPortal",props:{container:{default:null},forceMount:{type:Boolean,default:!1}},setup(a){const c=n(o);if(!c)throw new Error("SkdxTourPortal must be used within SkdxTour.");return(o,n)=>a.forceMount||l(c).open.value?(s(),t(e,{key:0,container:a.container},{default:i(()=>[u(o.$slots,"default")]),_:3},8,["container"])):r("",!0)}});export{c as default};
+import{injectRequired as e}from"../utils/injectRequired.js";import t from"../utils/Portal.vue.js";import{TOUR_CONTEXT as o}from"./context.js";import{createBlock as r,createCommentVNode as a,defineComponent as n,openBlock as u,renderSlot as s,unref as i,withCtx as l}from"vue";var c=/* @__PURE__ */n({__name:"TourPortal",props:{container:{default:null},forceMount:{type:Boolean,default:!1}},setup(n){const c=e(o,"SkdxTourPortal must be used within SkdxTour.");return(e,o)=>n.forceMount||i(c).open.value?(u(),r(t,{key:0,container:n.container},{default:l(()=>[s(e.$slots,"default")]),_:3},8,["container"])):a("",!0)}});export{c as default};

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

@@ -6,7 +6,7 @@ type __VLS_Props = {
     alignOffset: number;
     avoidCollisions: boolean;
     collisionPadding: number | Partial<Record<PhysicalSide, number>>;
-    collisionBoundary?: Element | Element[] | null;
+    collisionBoundary?: Element | Element[] | null | undefined;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

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

@@ -6,7 +6,7 @@ type __VLS_Props = {
     alignOffset: number;
     avoidCollisions: boolean;
     collisionPadding: number | Partial<Record<PhysicalSide, number>>;
-    collisionBoundary?: Element | Element[] | null;
+    collisionBoundary?: Element | Element[] | null | undefined;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/tour/TourPositioner.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const r=require("../utils/popper.cjs"),d=require("./context.cjs");let o=require("vue");var _=(0,o.defineComponent)({__name:"TourPositioner",props:{side:{},align:{},sideOffset:{},alignOffset:{},avoidCollisions:{type:Boolean},collisionPadding:{},collisionBoundary:{}},setup(n){const i=n,e=(0,o.inject)(d.TOUR_POSITION);if(!e)throw new Error("TourPositioner must be used within SkdxTourContent.");const t=(0,o.inject)(r.POPPER_CONTEXT);if(!t)throw new Error("TourPositioner must be used within SkdxTour.");const u=(0,o.computed)(()=>t.anchor.value!==null),{style:l,arrowStyle:s,placedSide:a,placedAlign:c}=r.usePopperPosition(t.anchor,e.contentRef,u,()=>({...i,component:"tour"}),e.arrowRef);return(0,o.watchEffect)(()=>{e.style.value=l.value,e.arrowStyle.value=s.value,e.placedSide.value=a.value,e.placedAlign.value=c.value}),(p,f)=>(0,o.renderSlot)(p.$slots,"default")}});exports.default=_;
+const p=require("../utils/injectRequired.cjs"),t=require("../utils/popper.cjs"),_=require("./context.cjs");let o=require("vue");var v=(0,o.defineComponent)({__name:"TourPositioner",props:{side:{},align:{},sideOffset:{},alignOffset:{},avoidCollisions:{type:Boolean},collisionPadding:{},collisionBoundary:{}},setup(n){const i=n,e=p.injectRequired(_.TOUR_POSITION,"TourPositioner must be used within SkdxTourContent."),r=(0,o.inject)(t.POPPER_CONTEXT);if(!r)throw new Error("TourPositioner must be used within SkdxTour.");const u=(0,o.computed)(()=>r.anchor.value!==null),{style:l,arrowStyle:s,placedSide:a,placedAlign:c}=t.usePopperPosition(r.anchor,e.contentRef,u,()=>({...i,component:"tour"}),e.arrowRef);return(0,o.watchEffect)(()=>{e.style.value=l.value,e.arrowStyle.value=s.value,e.placedSide.value=a.value,e.placedAlign.value=c.value}),(d,f)=>(0,o.renderSlot)(d.$slots,"default")}});exports.default=v;

package/dist/tour/TourPositioner.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{POPPER_CONTEXT as e,usePopperPosition as o}from"../utils/popper.js";import{TOUR_POSITION as t}from"./context.js";import{computed as r,defineComponent as a,inject as n,renderSlot as s,watchEffect as i}from"vue";var l=/* @__PURE__ */a({__name:"TourPositioner",props:{side:{},align:{},sideOffset:{},alignOffset:{},avoidCollisions:{type:Boolean},collisionPadding:{},collisionBoundary:{}},setup(a){const l=a,u=n(t);if(!u)throw new Error("TourPositioner must be used within SkdxTourContent.");const d=n(e);if(!d)throw new Error("TourPositioner must be used within SkdxTour.");const p=r(()=>null!==d.anchor.value),{style:c,arrowStyle:f,placedSide:m,placedAlign:v}=o(d.anchor,u.contentRef,p,()=>({...l,component:"tour"}),u.arrowRef);return i(()=>{u.style.value=c.value,u.arrowStyle.value=f.value,u.placedSide.value=m.value,u.placedAlign.value=v.value}),(e,o)=>s(e.$slots,"default")}});export{l as default};
+import{injectRequired as e}from"../utils/injectRequired.js";import{POPPER_CONTEXT as o,usePopperPosition as t}from"../utils/popper.js";import{TOUR_POSITION as i}from"./context.js";import{computed as r,defineComponent as s,inject as a,renderSlot as n,watchEffect as l}from"vue";var u=/* @__PURE__ */s({__name:"TourPositioner",props:{side:{},align:{},sideOffset:{},alignOffset:{},avoidCollisions:{type:Boolean},collisionPadding:{},collisionBoundary:{}},setup(s){const u=s,d=e(i,"TourPositioner must be used within SkdxTourContent."),p=a(o);if(!p)throw new Error("TourPositioner must be used within SkdxTour.");const c=r(()=>null!==p.anchor.value),{style:f,arrowStyle:m,placedSide:v,placedAlign:P}=t(p.anchor,d.contentRef,c,()=>({...u,component:"tour"}),d.arrowRef);return l(()=>{d.style.value=f.value,d.arrowStyle.value=m.value,d.placedSide.value=v.value,d.placedAlign.value=P.value}),(e,o)=>n(e.$slots,"default")}});export{u as default};

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

@@ -1,8 +1,4 @@
-/**
- * Back button for the tour. Disabled on the first step (nowhere to go); an
- * explicit `data-disabled` is better than a silent no-op. Must be used inside
- * `SkdxTour`.
- */
+/** Back button for the tour, disabled on the first step since there is nowhere to go back to. */
 type __VLS_Props = {
     /**
      * Disable the trigger on steps other than the first as well.

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

@@ -1,8 +1,4 @@
-/**
- * Back button for the tour. Disabled on the first step (nowhere to go); an
- * explicit `data-disabled` is better than a silent no-op. Must be used inside
- * `SkdxTour`.
- */
+/** Back button for the tour, disabled on the first step since there is nowhere to go back to. */
 type __VLS_Props = {
     /**
      * Disable the trigger on steps other than the first as well.

package/dist/tour/TourPrevTrigger.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const s=require("./context.cjs");let e=require("vue");var i=["disabled","data-disabled"],l=(0,e.defineComponent)({__name:"TourPrevTrigger",props:{disabled:{type:Boolean,default:!1}},setup(d){const u=d,r=(0,e.inject)(s.TOUR_CONTEXT);if(!r)throw new Error("SkdxTourPrevTrigger must be used within SkdxTour.");const t=(0,e.computed)(()=>u.disabled||r.step.value===0);return(a,o)=>((0,e.openBlock)(),(0,e.createElementBlock)("button",{class:"skdx-tour__prev-trigger","data-part":"prev-trigger",type:"button",disabled:t.value,"data-disabled":t.value?"":void 0,onClick:o[0]||(o[0]=n=>(0,e.unref)(r).prev())},[(0,e.renderSlot)(a.$slots,"default")],8,i))}});exports.default=l;
+const a=require("../utils/injectRequired.cjs"),s=require("./context.cjs");let e=require("vue");var n=["disabled","data-disabled"],l=(0,e.defineComponent)({__name:"TourPrevTrigger",props:{disabled:{type:Boolean,default:!1}},setup(d){const i=d,r=a.injectRequired(s.TOUR_CONTEXT,"SkdxTourPrevTrigger must be used within SkdxTour."),t=(0,e.computed)(()=>i.disabled||r.step.value===0);return(o,u)=>((0,e.openBlock)(),(0,e.createElementBlock)("button",{class:"skdx-tour__prev-trigger","data-part":"prev-trigger",type:"button",disabled:t.value,"data-disabled":t.value?"":void 0,onClick:u[0]||(u[0]=p=>(0,e.unref)(r).prev())},[(0,e.renderSlot)(o.$slots,"default")],8,n))}});exports.default=l;

package/dist/tour/TourPrevTrigger.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{TOUR_CONTEXT as e}from"./context.js";import{computed as t,createElementBlock as r,defineComponent as a,inject as o,openBlock as s,renderSlot as d,unref as l}from"vue";var i=["disabled","data-disabled"],n=/* @__PURE__ */a({__name:"TourPrevTrigger",props:{disabled:{type:Boolean,default:!1}},setup(a){const n=a,u=o(e);if(!u)throw new Error("SkdxTourPrevTrigger must be used within SkdxTour.");const p=t(()=>n.disabled||0===u.step.value);return(e,t)=>(s(),r("button",{class:"skdx-tour__prev-trigger","data-part":"prev-trigger",type:"button",disabled:p.value,"data-disabled":p.value?"":void 0,onClick:t[0]||(t[0]=e=>l(u).prev())},[d(e.$slots,"default")],8,i))}});export{n as default};
+import{injectRequired as e}from"../utils/injectRequired.js";import{TOUR_CONTEXT as t}from"./context.js";import{computed as r,createElementBlock as a,defineComponent as s,openBlock as d,renderSlot as o,unref as i}from"vue";var u=["disabled","data-disabled"],l=/* @__PURE__ */s({__name:"TourPrevTrigger",props:{disabled:{type:Boolean,default:!1}},setup(s){const l=s,n=e(t,"SkdxTourPrevTrigger must be used within SkdxTour."),p=r(()=>l.disabled||0===n.step.value);return(e,t)=>(d(),a("button",{class:"skdx-tour__prev-trigger","data-part":"prev-trigger",type:"button",disabled:p.value,"data-disabled":p.value?"":void 0,onClick:t[0]||(t[0]=e=>i(n).prev())},[o(e.$slots,"default")],8,u))}});export{l as default};

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

@@ -1,7 +1,5 @@
 /**
- * Visible progress text ("Step 2 of 5") as `<p>` with `data-step` and `data-total`.
- * Pass `format` to customize, or use default slot.
- * Not a live region (tour already announces on step change).
+ * Visible progress text ("Step 2 of 5"), rendered as a `<p>` with `data-step` and `data-total`.
  *
  * @example
  * ```vue

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

@@ -1,7 +1,5 @@
 /**
- * Visible progress text ("Step 2 of 5") as `<p>` with `data-step` and `data-total`.
- * Pass `format` to customize, or use default slot.
- * Not a live region (tour already announces on step change).
+ * Visible progress text ("Step 2 of 5"), rendered as a `<p>` with `data-step` and `data-total`.
  *
  * @example
  * ```vue

package/dist/tour/TourProgressText.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const s=require("./context.cjs");let e=require("vue");var u=["data-step","data-total"],n=(0,e.defineComponent)({__name:"TourProgressText",props:{format:{type:Function,default:(r,o)=>`Step ${r+1} of ${o}`}},setup(r){const o=r,t=(0,e.inject)(s.TOUR_CONTEXT);if(!t)throw new Error("SkdxTourProgressText must be used within SkdxTour.");return(a,l)=>((0,e.openBlock)(),(0,e.createElementBlock)("p",{class:"skdx-tour__progress-text","data-part":"progress-text","data-step":(0,e.unref)(t).step.value,"data-total":(0,e.unref)(t).total.value},[(0,e.renderSlot)(a.$slots,"default",{},()=>[(0,e.createTextVNode)((0,e.toDisplayString)(o.format((0,e.unref)(t).step.value,(0,e.unref)(t).total.value)),1)])],8,u))}});exports.default=n;
+const a=require("../utils/injectRequired.cjs"),s=require("./context.cjs");let e=require("vue");var n=["data-step","data-total"],l=(0,e.defineComponent)({__name:"TourProgressText",props:{format:{type:Function,default:(r,o)=>`Step ${r+1} of ${o}`}},setup(r){const o=r,t=a.injectRequired(s.TOUR_CONTEXT,"SkdxTourProgressText must be used within SkdxTour.");return(u,p)=>((0,e.openBlock)(),(0,e.createElementBlock)("p",{class:"skdx-tour__progress-text","data-part":"progress-text","data-step":(0,e.unref)(t).step.value,"data-total":(0,e.unref)(t).total.value},[(0,e.renderSlot)(u.$slots,"default",{},()=>[(0,e.createTextVNode)((0,e.toDisplayString)(o.format((0,e.unref)(t).step.value,(0,e.unref)(t).total.value)),1)])],8,n))}});exports.default=l;

package/dist/tour/TourProgressText.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{TOUR_CONTEXT as t}from"./context.js";import{createElementBlock as e,createTextVNode as a,defineComponent as o,inject as r,openBlock as s,renderSlot as p,toDisplayString as l,unref as u}from"vue";var n=["data-step","data-total"],d=/* @__PURE__ */o({__name:"TourProgressText",props:{format:{type:Function,default:(t,e)=>`Step ${t+1} of ${e}`}},setup(o){const d=o,f=r(t);if(!f)throw new Error("SkdxTourProgressText must be used within SkdxTour.");return(t,o)=>(s(),e("p",{class:"skdx-tour__progress-text","data-part":"progress-text","data-step":u(f).step.value,"data-total":u(f).total.value},[p(t.$slots,"default",{},()=>[a(l(d.format(u(f).step.value,u(f).total.value)),1)])],8,n))}});export{d as default};
+import{injectRequired as t}from"../utils/injectRequired.js";import{TOUR_CONTEXT as e}from"./context.js";import{createElementBlock as a,createTextVNode as s,defineComponent as o,openBlock as r,renderSlot as u,toDisplayString as p,unref as l}from"vue";var d=["data-step","data-total"],n=/* @__PURE__ */o({__name:"TourProgressText",props:{format:{type:Function,default:(t,e)=>`Step ${t+1} of ${e}`}},setup(o){const n=o,i=t(e,"SkdxTourProgressText must be used within SkdxTour.");return(t,e)=>(r(),a("p",{class:"skdx-tour__progress-text","data-part":"progress-text","data-step":l(i).step.value,"data-total":l(i).total.value},[u(t.$slots,"default",{},()=>[s(p(n.format(l(i).step.value,l(i).total.value)),1)])],8,d))}});export{n as default};

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

@@ -1,9 +1,4 @@
-/**
- * Button that ends the tour early: closes it and emits `skip`, never
- * `complete`. 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. Must be used inside `SkdxTour`.
- */
+/** Button that ends the tour early, closing it and emitting `skip` rather than `complete`. */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

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

@@ -1,9 +1,4 @@
-/**
- * Button that ends the tour early: closes it and emits `skip`, never
- * `complete`. 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. Must be used inside `SkdxTour`.
- */
+/** Button that ends the tour early, closing it and emitting `skip` rather than `complete`. */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/tour/TourSkipTrigger.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const n=require("./context.cjs");let e=require("vue");var o=(0,e.defineComponent)({__name:"TourSkipTrigger",setup(i){const r=(0,e.inject)(n.TOUR_CONTEXT);if(!r)throw new Error("SkdxTourSkipTrigger must be used within SkdxTour.");return(u,t)=>((0,e.openBlock)(),(0,e.createElementBlock)("button",{class:"skdx-tour__skip-trigger","data-part":"skip-trigger",type:"button",onClick:t[0]||(t[0]=p=>(0,e.unref)(r).skip())},[(0,e.renderSlot)(u.$slots,"default")]))}});exports.default=o;
+const i=require("../utils/injectRequired.cjs"),n=require("./context.cjs");let e=require("vue");var o=(0,e.defineComponent)({__name:"TourSkipTrigger",setup(s){const t=i.injectRequired(n.TOUR_CONTEXT,"SkdxTourSkipTrigger must be used within SkdxTour.");return(u,r)=>((0,e.openBlock)(),(0,e.createElementBlock)("button",{class:"skdx-tour__skip-trigger","data-part":"skip-trigger",type:"button",onClick:r[0]||(r[0]=p=>(0,e.unref)(t).skip())},[(0,e.renderSlot)(u.$slots,"default")]))}});exports.default=o;

package/dist/tour/TourSkipTrigger.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{TOUR_CONTEXT as r}from"./context.js";import{createElementBlock as t,defineComponent as e,inject as o,openBlock as s,renderSlot as a,unref as i}from"vue";var n=/* @__PURE__ */e({__name:"TourSkipTrigger",setup(e){const n=o(r);if(!n)throw new Error("SkdxTourSkipTrigger must be used within SkdxTour.");return(r,e)=>(s(),t("button",{class:"skdx-tour__skip-trigger","data-part":"skip-trigger",type:"button",onClick:e[0]||(e[0]=r=>i(n).skip())},[a(r.$slots,"default")]))}});export{n as default};
+import{injectRequired as e}from"../utils/injectRequired.js";import{TOUR_CONTEXT as t}from"./context.js";import{createElementBlock as r,defineComponent as o,openBlock as s,renderSlot as i,unref as a}from"vue";var n=/* @__PURE__ */o({__name:"TourSkipTrigger",setup(o){const n=e(t,"SkdxTourSkipTrigger must be used within SkdxTour.");return(e,t)=>(s(),r("button",{class:"skdx-tour__skip-trigger","data-part":"skip-trigger",type:"button",onClick:t[0]||(t[0]=e=>a(n).skip())},[i(e.$slots,"default")]))}});export{n as default};

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

@@ -1,6 +1,5 @@
 /**
  * Highlight box over the active step's target, positioned via `--skdx-tour-x/y/width/height`.
- * Renders nothing when the step has no target. Decorative and `aria-hidden`. Must be used inside `SkdxTour`.
  *
  * @example
  * ```css

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

@@ -1,6 +1,5 @@
 /**
  * Highlight box over the active step's target, positioned via `--skdx-tour-x/y/width/height`.
- * Renders nothing when the step has no target. Decorative and `aria-hidden`. Must be used inside `SkdxTour`.
  *
  * @example
  * ```css

package/dist/tour/TourSpotlight.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const u=require("./context.cjs");let e=require("vue");var a=["data-state"],n=(0,e.defineComponent)({__name:"TourSpotlight",props:{forceMount:{type:Boolean,default:!1}},setup(r){const t=(0,e.inject)(u.TOUR_CONTEXT);if(!t)throw new Error("SkdxTourSpotlight must be used within SkdxTour.");return(o,l)=>(0,e.unref)(t).target.value&&(r.forceMount||(0,e.unref)(t).open.value)?((0,e.openBlock)(),(0,e.createElementBlock)("div",{key:0,class:"skdx-tour__spotlight","data-part":"spotlight","aria-hidden":"true","data-state":(0,e.unref)(t).open.value?"open":"closed",style:(0,e.normalizeStyle)((0,e.unref)(t).spotlightStyle.value)},[(0,e.renderSlot)(o.$slots,"default")],12,a)):(0,e.createCommentVNode)("",!0)}});exports.default=n;
+const u=require("../utils/injectRequired.cjs"),a=require("./context.cjs");let e=require("vue");var n=["data-state"],l=(0,e.defineComponent)({__name:"TourSpotlight",props:{forceMount:{type:Boolean,default:!1}},setup(r){const t=u.injectRequired(a.TOUR_CONTEXT,"SkdxTourSpotlight must be used within SkdxTour.");return(o,i)=>(0,e.unref)(t).target.value&&(r.forceMount||(0,e.unref)(t).open.value)?((0,e.openBlock)(),(0,e.createElementBlock)("div",{key:0,class:"skdx-tour__spotlight","data-part":"spotlight","aria-hidden":"true","data-state":(0,e.unref)(t).open.value?"open":"closed",style:(0,e.normalizeStyle)((0,e.unref)(t).spotlightStyle.value)},[(0,e.renderSlot)(o.$slots,"default")],12,n)):(0,e.createCommentVNode)("",!0)}});exports.default=l;

package/dist/tour/TourSpotlight.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{TOUR_CONTEXT as e}from"./context.js";import{createCommentVNode as t,createElementBlock as o,defineComponent as a,inject as r,normalizeStyle as s,openBlock as l,renderSlot as n,unref as u}from"vue";var p=["data-state"],d=/* @__PURE__ */a({__name:"TourSpotlight",props:{forceMount:{type:Boolean,default:!1}},setup(a){const d=r(e);if(!d)throw new Error("SkdxTourSpotlight must be used within SkdxTour.");return(e,r)=>u(d).target.value&&(a.forceMount||u(d).open.value)?(l(),o("div",{key:0,class:"skdx-tour__spotlight","data-part":"spotlight","aria-hidden":"true","data-state":u(d).open.value?"open":"closed",style:s(u(d).spotlightStyle.value)},[n(e.$slots,"default")],12,p)):t("",!0)}});export{d as default};
+import{injectRequired as e}from"../utils/injectRequired.js";import{TOUR_CONTEXT as t}from"./context.js";import{createCommentVNode as o,createElementBlock as a,defineComponent as s,normalizeStyle as r,openBlock as l,renderSlot as n,unref as u}from"vue";var i=["data-state"],d=/* @__PURE__ */s({__name:"TourSpotlight",props:{forceMount:{type:Boolean,default:!1}},setup(s){const d=e(t,"SkdxTourSpotlight must be used within SkdxTour.");return(e,t)=>u(d).target.value&&(s.forceMount||u(d).open.value)?(l(),a("div",{key:0,class:"skdx-tour__spotlight","data-part":"spotlight","aria-hidden":"true","data-state":u(d).open.value?"open":"closed",style:r(u(d).spotlightStyle.value)},[n(e.$slots,"default")],12,i)):o("",!0)}});export{d as default};

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

@@ -1,7 +1,4 @@
-/**
- * The active step's accessible name via `aria-labelledby` on `SkdxTourContent`.
- * Renders an `<h2>`. Must be used inside `SkdxTour`.
- */
+/** The active step's accessible name, rendered as an `<h2>` wired to `SkdxTourContent` via `aria-labelledby`. */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

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

@@ -1,7 +1,4 @@
-/**
- * The active step's accessible name via `aria-labelledby` on `SkdxTourContent`.
- * Renders an `<h2>`. Must be used inside `SkdxTour`.
- */
+/** The active step's accessible name, rendered as an `<h2>` wired to `SkdxTourContent` via `aria-labelledby`. */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/tour/TourTitle.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const u=require("./context.cjs");let e=require("vue");var o=["id"],n=(0,e.defineComponent)({__name:"TourTitle",setup(i){const t=(0,e.inject)(u.TOUR_CONTEXT);if(!t)throw new Error("SkdxTourTitle must be used within SkdxTour.");return t.setHasTitle(!0),(0,e.onUnmounted)(()=>t.setHasTitle(!1)),(r,l)=>((0,e.openBlock)(),(0,e.createElementBlock)("h2",{class:"skdx-tour__title","data-part":"title",id:(0,e.unref)(t).titleId},[(0,e.renderSlot)(r.$slots,"default")],8,o))}});exports.default=n;
+const u=require("../utils/injectRequired.cjs"),i=require("./context.cjs");let e=require("vue");var n=["id"],o=(0,e.defineComponent)({__name:"TourTitle",setup(l){const t=u.injectRequired(i.TOUR_CONTEXT,"SkdxTourTitle must be used within SkdxTour.");return t.setHasTitle(!0),(0,e.onUnmounted)(()=>t.setHasTitle(!1)),(r,s)=>((0,e.openBlock)(),(0,e.createElementBlock)("h2",{id:(0,e.unref)(t).titleId,class:"skdx-tour__title","data-part":"title"},[(0,e.renderSlot)(r.$slots,"default")],8,n))}});exports.default=o;

package/dist/tour/TourTitle.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{TOUR_CONTEXT as t}from"./context.js";import{createElementBlock as e,defineComponent as s,inject as o,onUnmounted as r,openBlock as a,renderSlot as n,unref as i}from"vue";var l=["id"],d=/* @__PURE__ */s({__name:"TourTitle",setup(s){const d=o(t);if(!d)throw new Error("SkdxTourTitle must be used within SkdxTour.");return d.setHasTitle(!0),r(()=>d.setHasTitle(!1)),(t,s)=>(a(),e("h2",{class:"skdx-tour__title","data-part":"title",id:i(d).titleId},[n(t.$slots,"default")],8,l))}});export{d as default};
+import{injectRequired as e}from"../utils/injectRequired.js";import{TOUR_CONTEXT as t}from"./context.js";import{createElementBlock as s,defineComponent as o,onUnmounted as r,openBlock as a,renderSlot as i,unref as n}from"vue";var l=["id"],u=/* @__PURE__ */o({__name:"TourTitle",setup(o){const u=e(t,"SkdxTourTitle must be used within SkdxTour.");return u.setHasTitle(!0),r(()=>u.setHasTitle(!1)),(e,t)=>(a(),s("h2",{id:n(u).titleId,class:"skdx-tour__title","data-part":"title"},[i(e.$slots,"default")],8,l))}});export{u as default};

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

@@ -1,8 +1,4 @@
-/**
- * Button that opens the tour. Sets `aria-haspopup="dialog"`, `aria-expanded`,
- * `aria-controls` (pointing at `SkdxTourContent`), and `data-state` (`open`/`closed`).
- * Focus returns here when tour completes or is skipped. Must be used in `SkdxTour`.
- */
+/** Button that opens the tour, with `aria-haspopup`/`aria-expanded`/`aria-controls` wired to its content. */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

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

@@ -1,8 +1,4 @@
-/**
- * Button that opens the tour. Sets `aria-haspopup="dialog"`, `aria-expanded`,
- * `aria-controls` (pointing at `SkdxTourContent`), and `data-state` (`open`/`closed`).
- * Focus returns here when tour completes or is skipped. Must be used in `SkdxTour`.
- */
+/** Button that opens the tour, with `aria-haspopup`/`aria-expanded`/`aria-controls` wired to its content. */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/tour/TourTrigger.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const o=require("./context.cjs");let e=require("vue");var a=["aria-expanded","aria-controls","data-state"],u=(0,e.defineComponent)({__name:"TourTrigger",setup(i){const r=(0,e.inject)(o.TOUR_CONTEXT);if(!r)throw new Error("SkdxTourTrigger must be used within SkdxTour.");return(n,t)=>((0,e.openBlock)(),(0,e.createElementBlock)("button",{class:"skdx-tour__trigger","data-part":"trigger",type:"button","aria-haspopup":"dialog","aria-expanded":(0,e.unref)(r).open.value,"aria-controls":(0,e.unref)(r).contentId,"data-state":(0,e.unref)(r).open.value?"open":"closed",onClick:t[0]||(t[0]=s=>(0,e.unref)(r).setOpen(!0))},[(0,e.renderSlot)(n.$slots,"default")],8,a))}});exports.default=u;
+const u=require("../utils/injectRequired.cjs"),a=require("./context.cjs");let e=require("vue");var o=["aria-expanded","aria-controls","data-state"],i=(0,e.defineComponent)({__name:"TourTrigger",setup(d){const r=u.injectRequired(a.TOUR_CONTEXT,"SkdxTourTrigger must be used within SkdxTour.");return(n,t)=>((0,e.openBlock)(),(0,e.createElementBlock)("button",{class:"skdx-tour__trigger","data-part":"trigger",type:"button","aria-haspopup":"dialog","aria-expanded":(0,e.unref)(r).open.value,"aria-controls":(0,e.unref)(r).contentId,"data-state":(0,e.unref)(r).open.value?"open":"closed",onClick:t[0]||(t[0]=s=>(0,e.unref)(r).setOpen(!0))},[(0,e.renderSlot)(n.$slots,"default")],8,o))}});exports.default=i;

package/dist/tour/TourTrigger.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{TOUR_CONTEXT as e}from"./context.js";import{createElementBlock as t,defineComponent as a,inject as r,openBlock as o,renderSlot as n,unref as s}from"vue";var d=["aria-expanded","aria-controls","data-state"],i=/* @__PURE__ */a({__name:"TourTrigger",setup(a){const i=r(e);if(!i)throw new Error("SkdxTourTrigger must be used within SkdxTour.");return(e,a)=>(o(),t("button",{class:"skdx-tour__trigger","data-part":"trigger",type:"button","aria-haspopup":"dialog","aria-expanded":s(i).open.value,"aria-controls":s(i).contentId,"data-state":s(i).open.value?"open":"closed",onClick:a[0]||(a[0]=e=>s(i).setOpen(!0))},[n(e.$slots,"default")],8,d))}});export{i as default};
+import{injectRequired as e}from"../utils/injectRequired.js";import{TOUR_CONTEXT as t}from"./context.js";import{createElementBlock as a,defineComponent as r,openBlock as o,renderSlot as n,unref as s}from"vue";var i=["aria-expanded","aria-controls","data-state"],d=/* @__PURE__ */r({__name:"TourTrigger",setup(r){const d=e(t,"SkdxTourTrigger must be used within SkdxTour.");return(e,t)=>(o(),a("button",{class:"skdx-tour__trigger","data-part":"trigger",type:"button","aria-haspopup":"dialog","aria-expanded":s(d).open.value,"aria-controls":s(d).contentId,"data-state":s(d).open.value?"open":"closed",onClick:t[0]||(t[0]=e=>s(d).setOpen(!0))},[n(e.$slots,"default")],8,i))}});export{d as default};

package/dist/tour/context.d.cts

@@ -2,11 +2,18 @@ import type { ComputedRef, CSSProperties, InjectionKey, Ref } from 'vue';
 import type { Align, PhysicalSide, Side } from '../utils/popper.cjs';
 /** Step presentation: tooltip / floating anchor, dialog centers. */
 export type TourStepType = 'tooltip' | 'dialog' | 'floating';
+/** Payload of the `step-change` event: the new index and the step's `id`. */
+export interface TourStepChange {
+    /** Zero-based index of the step now active. */
+    index: number;
+    /** The active step's `id`, when it declares one. */
+    id?: string | undefined;
+}
 /** One tour step (data-driven, not markup). */
 export interface TourStep {
     /**
      * Stable step id (reported on step-change; stable across conditional rendering).
-     * @default undefined — index alone.
+     * @default undefined — the index is reported with no id.
      */
     id?: string;
     /**
@@ -15,12 +22,12 @@ export interface TourStep {
      */
     target?: string | HTMLElement | Ref<HTMLElement | null> | null;
     /**
-     * Accessible name (announced with position).
+     * Accessible name, announced together with the step's position.
      * @default undefined — position only.
      */
     title?: string;
     /**
-     * Description (rendered as TourDescription).
+     * Description text, rendered as the `TourDescription` part.
      * @default undefined — no description.
      */
     description?: string;
@@ -30,7 +37,7 @@ export interface TourStep {
      */
     placement?: Side;
     /**
-     * Alignment along placement.
+     * Alignment of the bubble along `placement`.
      * @default undefined — TourContent's align (center).
      */
     align?: Align;
@@ -40,7 +47,7 @@ export interface TourStep {
      */
     type?: TourStepType;
     /**
-     * Dims page behind step.
+     * Dims the page behind the active step.
      * @default true
      */
     backdrop?: boolean;

package/dist/tour/context.d.ts

@@ -2,11 +2,18 @@ import type { ComputedRef, CSSProperties, InjectionKey, Ref } from 'vue';
 import type { Align, PhysicalSide, Side } from '../utils/popper.js';
 /** Step presentation: tooltip / floating anchor, dialog centers. */
 export type TourStepType = 'tooltip' | 'dialog' | 'floating';
+/** Payload of the `step-change` event: the new index and the step's `id`. */
+export interface TourStepChange {
+    /** Zero-based index of the step now active. */
+    index: number;
+    /** The active step's `id`, when it declares one. */
+    id?: string | undefined;
+}
 /** One tour step (data-driven, not markup). */
 export interface TourStep {
     /**
      * Stable step id (reported on step-change; stable across conditional rendering).
-     * @default undefined — index alone.
+     * @default undefined — the index is reported with no id.
      */
     id?: string;
     /**
@@ -15,12 +22,12 @@ export interface TourStep {
      */
     target?: string | HTMLElement | Ref<HTMLElement | null> | null;
     /**
-     * Accessible name (announced with position).
+     * Accessible name, announced together with the step's position.
      * @default undefined — position only.
      */
     title?: string;
     /**
-     * Description (rendered as TourDescription).
+     * Description text, rendered as the `TourDescription` part.
      * @default undefined — no description.
      */
     description?: string;
@@ -30,7 +37,7 @@ export interface TourStep {
      */
     placement?: Side;
     /**
-     * Alignment along placement.
+     * Alignment of the bubble along `placement`.
      * @default undefined — TourContent's align (center).
      */
     align?: Align;
@@ -40,7 +47,7 @@ export interface TourStep {
      */
     type?: TourStepType;
     /**
-     * Dims page behind step.
+     * Dims the page behind the active step.
      * @default true
      */
     backdrop?: boolean;

package/dist/tour/index.d.cts

@@ -1,2 +1,2 @@
 export { default as SkdxTour } from './Tour.vue.cjs';
-export type { TourStep, TourStepType } from './context.cjs';
+export type { TourStep, TourStepChange, TourStepType } from './context.cjs';

package/dist/tour/index.d.ts

@@ -1,2 +1,2 @@
 export { default as SkdxTour } from './Tour.vue.js';
-export type { TourStep, TourStepType } from './context.js';
+export type { TourStep, TourStepChange, TourStepType } from './context.js';

package/dist/tour/primitives.d.cts

@@ -1,6 +1,5 @@
 /**
- * Advanced primitives for custom `SkdxTour` layouts. Recipe is built from these.
- * `TourPositioner` (internal helper) not included.
+ * Advanced primitives for custom `SkdxTour` layouts.
  *
  * @example
  * ```vue

package/dist/tour/primitives.d.ts

@@ -1,6 +1,5 @@
 /**
- * Advanced primitives for custom `SkdxTour` layouts. Recipe is built from these.
- * `TourPositioner` (internal helper) not included.
+ * Advanced primitives for custom `SkdxTour` layouts.
  *
  * @example
  * ```vue