@skdx/vue 0.26.0 → 0.28.0

package/dist/popover/Popover.vue.d.ts

@@ -1,31 +1,96 @@
+import type { Align, Side } from '../utils/popper.js';
+import type { PopoverModality } from './context.js';
 /**
- * The Vue implementation of the shared Popover contract (see
- * `@skdx/shared`'s `popoverContract`). Root of a non-modal-by-default
- * popover: owns open state and hands it down to `SkdxPopoverTrigger` /
- * `SkdxPopoverAnchor` / `SkdxPopoverPortal` / `SkdxPopoverContent` /
- * `SkdxPopoverArrow` / `SkdxPopoverClose` via context. Wraps children in the
- * shared popper positioning root, so `SkdxPopoverContent` can float relative
- * to the trigger (or a custom `SkdxPopoverAnchor`). Renders no DOM of its own.
+ * Non-modal-by-default popover component: owns open state and renders the
+ * anatomy of trigger, title, description, body content, and close button.
+ * Wraps children in the shared popper positioning root so the content can
+ * float relative to the trigger. Works controlled (`v-model:open`) or
+ * uncontrolled (`default-open`).
  *
  * Emits `open-change` the instant the state flips and `open-change-complete`
- * once the change has finished on screen — after `SkdxPopoverContent`'s enter
- * or exit animation ends, or in the same task when it declares none.
+ * once the animation finishes — after `SkdxPopoverContent`'s enter or exit
+ * animation ends, or immediately when it declares none.
  *
- * Works controlled (`v-model:open`) or uncontrolled (`default-open`).
+ * The `trigger` slot supplies only the trigger's *content* — text or icon —
+ * not the interactive element itself: the anatomy renders a real `<button>`
+ * and nesting one interactive element inside another would violate HTML.
+ * For full primitive composition, use `SkdxPopoverRoot` from
+ * `@skdx/vue/primitives/popover`.
+ *
+ * @example
+ * ```vue
+ * <SkdxPopover title="Share this page">
+ *   <template #trigger>Share</template>
+ *   <p>Anyone with the link can view it.</p>
+ * </SkdxPopover>
+ * ```
+ *
+ * @example Full primitive composition —
+ * `import * as Popover from '@skdx/vue/primitives/popover'`:
+ * ```vue
+ * <Popover.Root>
+ *   <Popover.Trigger>Share</Popover.Trigger>
+ *   <Popover.Portal>
+ *     <Popover.Content>
+ *       <Popover.Title>Share this page</Popover.Title>
+ *       <Popover.Close>Close</Popover.Close>
+ *     </Popover.Content>
+ *   </Popover.Portal>
+ * </Popover.Root>
+ * ```
  */
 type __VLS_Props = {
     /** Whether the popover is open, for controlled usage via v-model:open. */
     open?: boolean;
     /** Whether the popover is initially open, for uncontrolled usage. */
     defaultOpen?: boolean;
-    /** Whether SkdxPopoverContent traps focus while open. Non-modal (the default) lets the rest of the page stay interactive. */
-    modal?: boolean;
+    /**
+     * How much of the page the open popover takes over. Three points, because
+     * modality is three independent things: `false` (the default) contains
+     * nothing; `'trap-focus'` cycles Tab inside the panel and marks the rest
+     * of the document `inert`, leaving page scroll alone; `true` adds the
+     * body-scroll lock on top, which is what `modal` means on Dialog,
+     * AlertDialog and Drawer. Any value but `false` requires an
+     * `SkdxPopoverClose` inside the panel.
+     */
+    modal?: PopoverModality;
+    /**
+     * Title rendered by the derived anatomy as `SkdxPopoverTitle`.
+     * @default undefined — no title is rendered.
+     */
+    title?: string;
+    /**
+     * Description rendered by the derived anatomy as
+     * `SkdxPopoverDescription`.
+     * @default undefined — no description is rendered.
+     */
+    description?: string;
+    /**
+     * Preferred edge of the trigger the derived panel is placed against.
+     * @default 'bottom'
+     */
+    side?: Side;
+    /**
+     * Preferred alignment of the derived panel along `side`.
+     * @default 'center'
+     */
+    align?: Align;
+    /**
+     * Whether the derived panel includes a `SkdxPopoverArrow`.
+     * @default false
+     */
+    showArrow?: boolean;
 };
-declare var __VLS_5: {};
+declare var __VLS_15: {}, __VLS_17: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_5) => any;
+    trigger?: (props: typeof __VLS_15) => any;
+} & {
+    default?: (props: typeof __VLS_17) => any;
 };
-declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
+    /** Recomputes the open panel's position immediately, for an anchor that moved without the floating layer noticing. */
+    reposition: () => void | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:open": (open: boolean) => any;
     "open-change": (open: boolean) => any;
     "open-change-complete": (open: boolean) => any;
@@ -34,9 +99,14 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     "onOpen-change"?: ((open: boolean) => any) | undefined;
     "onOpen-change-complete"?: ((open: boolean) => any) | undefined;
 }>, {
+    title: string;
+    description: string;
     open: boolean;
     defaultOpen: boolean;
-    modal: boolean;
+    align: Align;
+    side: Side;
+    modal: PopoverModality;
+    showArrow: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/popover/Popover.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const i=require("../utils/useOpenChangeComplete.cjs"),_=require("../utils/PopperRoot.vue.cjs"),r=require("./context.cjs");let e=require("vue");var m=(0,e.defineComponent)({__name:"Popover",props:{open:{type:Boolean,default:void 0},defaultOpen:{type:Boolean,default:!1},modal:{type:Boolean,default:!1}},emits:["update:open","open-change","open-change-complete"],setup(a,{emit:c}){const t=a,n=c,d=(0,e.ref)(null),p=(0,e.ref)(null),l=(0,e.ref)(t.defaultOpen),u=(0,e.computed)(()=>t.open??l.value),s=(0,e.computed)(()=>t.modal);i.useOpenChangeComplete(u,p,o=>n("open-change-complete",o));function f(o){t.open===void 0&&(l.value=o),n("update:open",o),n("open-change",o)}return(0,e.provide)(r.POPOVER_CONTEXT,{triggerRef:d,contentRef:p,contentId:r.nextPopoverContentId(),open:u,modal:s,setOpen:f}),(o,v)=>((0,e.openBlock)(),(0,e.createBlock)(_.default,null,{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(o.$slots,"default")]),_:3}))}});exports.default=m;
+const i=require("./PopoverAnatomy.vue.cjs"),d=require("./PopoverRoot.vue.cjs");let e=require("vue");var u=(0,e.defineComponent)({inheritAttrs:!1,__name:"Popover",props:{open:{type:Boolean,default:void 0},defaultOpen:{type:Boolean,default:!1},modal:{type:[Boolean,String],default:!1},title:{default:void 0},description:{default:void 0},side:{default:"bottom"},align:{default:"center"},showArrow:{type:Boolean,default:!1}},emits:["update:open","open-change","open-change-complete"],setup(t,{expose:a}){const r=(0,e.ref)(null);return a({reposition:()=>r.value?.reposition()}),(o,n)=>((0,e.openBlock)(),(0,e.createBlock)(d.default,{ref_key:"rootRef",ref:r,open:t.open,"default-open":t.defaultOpen,modal:t.modal,"onUpdate:open":n[0]||(n[0]=l=>o.$emit("update:open",l)),onOpenChange:n[1]||(n[1]=l=>o.$emit("open-change",l)),onOpenChangeComplete:n[2]||(n[2]=l=>o.$emit("open-change-complete",l))},{default:(0,e.withCtx)(()=>[(0,e.createVNode)(i.default,(0,e.mergeProps)(o.$attrs,{title:t.title,description:t.description,side:t.side,align:t.align,"show-arrow":t.showArrow}),{trigger:(0,e.withCtx)(()=>[(0,e.renderSlot)(o.$slots,"trigger")]),default:(0,e.withCtx)(()=>[(0,e.renderSlot)(o.$slots,"default")]),_:3},16,["title","description","side","align","show-arrow"])]),_:3},8,["open","default-open","modal"]))}});exports.default=u;

package/dist/popover/Popover.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{useOpenChangeComplete as e}from"../utils/useOpenChangeComplete.js";import o from"../utils/PopperRoot.vue.js";import{POPOVER_CONTEXT as t,nextPopoverContentId as n}from"./context.js";import{computed as p,createBlock as a,defineComponent as l,openBlock as s,provide as u,ref as r,renderSlot as d,withCtx as m}from"vue";var f=/* @__PURE__ */l({__name:"Popover",props:{open:{type:Boolean,default:void 0},defaultOpen:{type:Boolean,default:!1},modal:{type:Boolean,default:!1}},emits:["update:open","open-change","open-change-complete"],setup(l,{emit:f}){const c=l,i=f,v=r(null),g=r(null),C=r(c.defaultOpen),O=p(()=>c.open??C.value),h=p(()=>c.modal);return e(O,g,e=>i("open-change-complete",e)),u(t,{triggerRef:v,contentRef:g,contentId:n(),open:O,modal:h,setOpen:function(e){void 0===c.open&&(C.value=e),i("update:open",e),i("open-change",e)}}),(e,t)=>(s(),a(o,null,{default:m(()=>[d(e.$slots,"default")]),_:3}))}});export{f as default};
+import e from"./PopoverAnatomy.vue.js";import o from"./PopoverRoot.vue.js";import{createBlock as t,createVNode as a,defineComponent as n,mergeProps as p,openBlock as r,ref as l,renderSlot as i,withCtx as d}from"vue";var s=/* @__PURE__ */n({inheritAttrs:!1,__name:"Popover",props:{open:{type:Boolean,default:void 0},defaultOpen:{type:Boolean,default:!1},modal:{type:[Boolean,String],default:!1},title:{default:void 0},description:{default:void 0},side:{default:"bottom"},align:{default:"center"},showArrow:{type:Boolean,default:!1}},emits:["update:open","open-change","open-change-complete"],setup(n,{expose:s}){const u=l(null);return s({reposition:()=>u.value?.reposition()}),(l,s)=>(r(),t(o,{ref_key:"rootRef",ref:u,open:n.open,"default-open":n.defaultOpen,modal:n.modal,"onUpdate:open":s[0]||(s[0]=e=>l.$emit("update:open",e)),onOpenChange:s[1]||(s[1]=e=>l.$emit("open-change",e)),onOpenChangeComplete:s[2]||(s[2]=e=>l.$emit("open-change-complete",e))},{default:d(()=>[a(e,p(l.$attrs,{title:n.title,description:n.description,side:n.side,align:n.align,"show-arrow":n.showArrow}),{trigger:d(()=>[i(l.$slots,"trigger")]),default:d(()=>[i(l.$slots,"default")]),_:3},16,["title","description","side","align","show-arrow"])]),_:3},8,["open","default-open","modal"]))}});export{s as default};

package/dist/popover/PopoverAnatomy.vue.cjs

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

package/dist/popover/PopoverAnatomy.vue.d.cts

@@ -0,0 +1,30 @@
+import type { Align, Side } from '../utils/popper.cjs';
+/**
+ * The anatomy a `SkdxPopover` draws when its default slot holds no
+ * `SkdxPopoverContent`: a trigger from the `trigger` slot and a portalled
+ * floating panel carrying the derived title, description, slotted body and
+ * close button. A focus-trapping panel with no way out is an accessibility
+ * bug; the Close is not optional.
+ * @internal
+ */
+type __VLS_Props = {
+    title?: string;
+    description?: string;
+    side: Side;
+    align: Align;
+    showArrow: boolean;
+};
+declare var __VLS_4: {}, __VLS_21: {};
+type __VLS_Slots = {} & {
+    trigger?: (props: typeof __VLS_4) => any;
+} & {
+    default?: (props: typeof __VLS_21) => 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/popover/PopoverAnatomy.vue.d.ts

@@ -0,0 +1,30 @@
+import type { Align, Side } from '../utils/popper.js';
+/**
+ * The anatomy a `SkdxPopover` draws when its default slot holds no
+ * `SkdxPopoverContent`: a trigger from the `trigger` slot and a portalled
+ * floating panel carrying the derived title, description, slotted body and
+ * close button. A focus-trapping panel with no way out is an accessibility
+ * bug; the Close is not optional.
+ * @internal
+ */
+type __VLS_Props = {
+    title?: string;
+    description?: string;
+    side: Side;
+    align: Align;
+    showArrow: boolean;
+};
+declare var __VLS_4: {}, __VLS_21: {};
+type __VLS_Slots = {} & {
+    trigger?: (props: typeof __VLS_4) => any;
+} & {
+    default?: (props: typeof __VLS_21) => 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/popover/PopoverAnatomy.vue.js

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

package/dist/popover/PopoverAnatomy.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const a=require("./PopoverArrow.vue.cjs"),n=require("./PopoverClose.vue.cjs"),u=require("./PopoverContent.vue.cjs"),d=require("./PopoverDescription.vue.cjs"),s=require("./PopoverPortal.vue.cjs"),c=require("./PopoverTitle.vue.cjs"),f=require("./PopoverTrigger.vue.cjs");let e=require("vue");var p=(0,e.defineComponent)({inheritAttrs:!1,__name:"PopoverAnatomy",props:{title:{},description:{},side:{},align:{},showArrow:{type:Boolean}},setup(t){const o=(0,e.useAttrs)(),l=(0,e.computed)(()=>o.id?{"aria-controls":o.id}:{});return(r,i)=>((0,e.openBlock)(),(0,e.createElementBlock)(e.Fragment,null,[(0,e.createVNode)(f.default,(0,e.normalizeProps)((0,e.guardReactiveProps)(l.value)),{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(r.$slots,"trigger")]),_:3},16),(0,e.createVNode)(s.default,null,{default:(0,e.withCtx)(()=>[(0,e.createVNode)(u.default,(0,e.mergeProps)(r.$attrs,{side:t.side,align:t.align}),{default:(0,e.withCtx)(()=>[t.showArrow?((0,e.openBlock)(),(0,e.createBlock)(a.default,{key:0})):(0,e.createCommentVNode)("",!0),t.title?((0,e.openBlock)(),(0,e.createBlock)(c.default,{key:1},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.title),1)]),_:1})):(0,e.createCommentVNode)("",!0),t.description?((0,e.openBlock)(),(0,e.createBlock)(d.default,{key:2},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.description),1)]),_:1})):(0,e.createCommentVNode)("",!0),(0,e.renderSlot)(r.$slots,"default"),(0,e.createVNode)(n.default,{"aria-label":"Close"},{default:(0,e.withCtx)(()=>[...i[0]||(i[0]=[(0,e.createElementVNode)("svg",{viewBox:"0 0 16 16",width:"1em",height:"1em",fill:"none","aria-hidden":"true",focusable:"false"},[(0,e.createElementVNode)("path",{d:"M4 4l8 8M12 4l-8 8",stroke:"currentColor","stroke-width":"1.5","stroke-linecap":"round"})],-1)])]),_:1})]),_:3},16,["side","align"])]),_:3})],64))}});exports.default=p;

package/dist/popover/PopoverAnatomy.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import e from"./PopoverArrow.vue.js";import o from"./PopoverClose.vue.js";import r from"./PopoverContent.vue.js";import t from"./PopoverDescription.vue.js";import a from"./PopoverPortal.vue.js";import s from"./PopoverTitle.vue.js";import i from"./PopoverTrigger.vue.js";import{Fragment as l,computed as n,createBlock as p,createCommentVNode as d,createElementBlock as m,createElementVNode as u,createTextVNode as v,createVNode as c,defineComponent as f,guardReactiveProps as g,mergeProps as P,normalizeProps as h,openBlock as k,renderSlot as w,toDisplayString as _,useAttrs as j,withCtx as C}from"vue";var y=/* @__PURE__ */f({inheritAttrs:!1,__name:"PopoverAnatomy",props:{title:{},description:{},side:{},align:{},showArrow:{type:Boolean}},setup(f){const y=j(),A=n(()=>y.id?{"aria-controls":y.id}:{});return(n,j)=>(k(),m(l,null,[c(i,h(g(A.value)),{default:C(()=>[w(n.$slots,"trigger")]),_:3},16),c(a,null,{default:C(()=>[c(r,P(n.$attrs,{side:f.side,align:f.align}),{default:C(()=>[f.showArrow?(k(),p(e,{key:0})):d("",!0),f.title?(k(),p(s,{key:1},{default:C(()=>[v(_(f.title),1)]),_:1})):d("",!0),f.description?(k(),p(t,{key:2},{default:C(()=>[v(_(f.description),1)]),_:1})):d("",!0),w(n.$slots,"default"),c(o,{"aria-label":"Close"},{default:C(()=>[...j[0]||(j[0]=[u("svg",{viewBox:"0 0 16 16",width:"1em",height:"1em",fill:"none","aria-hidden":"true",focusable:"false"},[u("path",{d:"M4 4l8 8M12 4l-8 8",stroke:"currentColor","stroke-width":"1.5","stroke-linecap":"round"})],-1)])]),_:1})]),_:3},16,["side","align"])]),_:3})],64))}});export{y as default};

package/dist/popover/PopoverContent.vue.d.cts

@@ -2,29 +2,27 @@ import { type Align, type PhysicalSide, type Side } from '../utils/popper.cjs';
 import { type FocusOutsideEvent, type InteractOutsideEvent } from '../utils/useDismiss.cjs';
 import { type AutoFocusEvent } from '../utils/useFocusTrap.cjs';
 /**
- * The popover's floating panel: `role="dialog"` with `data-state`
- * (`open`/`closed`), positioned via the shared popper layer against the
- * trigger (or `SkdxPopoverAnchor`) using `side`/`align`/`sideOffset`
- * (defaults to `4`)/`alignOffset` and flipping/shifting to avoid viewport
- * collisions unless `avoidCollisions` is `false` — against `collisionBoundary`
- * when one is given, otherwise the panel's clipping ancestors. Also exposes
- * `data-side`/`data-align` reflecting the resolved placement, and the
- * measurement custom properties `--skdx-popover-available-width` /
- * `-available-height` / `-trigger-width` / `-transform-origin`, so the panel
- * can be sized and animated from CSS without measuring anything by hand.
- * Traps focus
- * when the popover is `modal`. Closes on Escape or an outside interaction
- * (pointer-down or focus moving out) unless `escape-key-down`/
- * `pointer-down-outside`/`focus-outside`/`interact-outside` call
- * `event.preventDefault()`. `interact-outside` fires for either kind of
- * outside interaction, immediately before the specific event and with the
- * same event object, so one veto covers both.
+ * The popover's floating panel: `role="dialog"` positioned against the trigger
+ * (or `SkdxPopoverAnchor`) using `side`/`align`/`sideOffset`/`alignOffset`,
+ * with flipping/shifting to avoid viewport collisions when `avoidCollisions`
+ * is true. Exposes `data-state` (`open`/`closed`), `data-side`/`data-align`
+ * reflecting resolved placement, and CSS custom properties for panel sizing
+ * and animation (`--skdx-popover-available-width`, `-available-height`,
+ * `-trigger-width`, `-transform-origin`).
  *
- * Where it manages focus it announces the move first: `open-auto-focus`
- * before focus enters the panel and `close-auto-focus` before focus goes back
- * to the trigger, each cancelable — `preventDefault()` leaves focus where it
- * is, so a consumer can place it by hand. Mounts only while open unless
- * `forceMount` is set. Must be used inside `SkdxPopover`.
+ * Must be named with a `SkdxPopoverTitle` (wired to `aria-labelledby`) or an
+ * `aria-label` — a `role="dialog"` with no name announces as bare "dialog".
+ * A `SkdxPopoverDescription` optionally provides supporting text via
+ * `aria-describedby`; both attributes appear only while their source parts
+ * are mounted.
+ *
+ * When `modal` is set, traps focus inside the panel and marks the rest of the
+ * document `inert`. Closes on Escape or outside interaction (pointer-down or
+ * focus moving out) unless handlers call `preventDefault()`. Announces focus
+ * moves via `open-auto-focus` (before entering) and `close-auto-focus`
+ * (before leaving), each cancelable and directable with `initial-focus` /
+ * `final-focus` selectors. Mounts only while open unless `forceMount` is set.
+ * Must be used inside `SkdxPopover`.
  */
 type __VLS_Props = {
     /** Preferred edge of the anchor to place the panel against. */
@@ -48,6 +46,40 @@ type __VLS_Props = {
     collisionBoundary?: Element | Element[] | null;
     /** Keep this panel mounted even while the popover is closed. */
     forceMount?: boolean;
+    /**
+     * Clearance in pixels between the arrow and each end of the panel's edge,
+     * so the arrow cannot ride over a rounded corner. The arrow's *size* stays
+     * in CSS, which is where a shape belongs; only the clearance depends on the
+     * panel's radius, which the positioner is the only thing that can honour.
+     */
+    arrowPadding?: number;
+    /**
+     * Hide the panel while its anchor has been scrolled fully out of view
+     * inside a clipping ancestor, instead of leaving it floating over unrelated
+     * content. The panel is hidden, not unmounted and not closed: unmounting on
+     * a scroll would tear down the focus trap and move the user's focus for a
+     * reason they did not ask for.
+     */
+    hideWhenDetached?: boolean;
+    /**
+     * CSS selector for the element that should receive focus when the popover
+     * opens, resolved with querySelector inside this panel. Live only while
+     * `modal` contains focus — a non-modal popover never moves focus in, and
+     * this must not resurrect a move that deliberately does not happen. Applies
+     * only when `open-auto-focus` was not vetoed, and falls back to the first
+     * tabbable element when it matches nothing.
+     * @default undefined — the panel's first tabbable element, then the panel itself.
+     */
+    initialFocus?: string;
+    /**
+     * CSS selector for the element focus should be sent to when the popover
+     * closes, resolved at document level because the return target is outside
+     * the panel by definition. Live in every modality, unlike `initialFocus`.
+     * Applies only when `close-auto-focus` was not vetoed, and falls back to the
+     * trigger when it matches nothing.
+     * @default undefined — the trigger, or whatever was focused before opening.
+     */
+    finalFocus?: string;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
@@ -69,12 +101,14 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     "onInteract-outside"?: ((event: InteractOutsideEvent) => any) | undefined;
 }>, {
     forceMount: boolean;
-    side: Side;
     align: Align;
+    side: Side;
     sideOffset: number;
     alignOffset: number;
     avoidCollisions: boolean;
     collisionPadding: number | Partial<Record<PhysicalSide, number>>;
+    arrowPadding: number;
+    hideWhenDetached: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/popover/PopoverContent.vue.d.ts

@@ -2,29 +2,27 @@ import { type Align, type PhysicalSide, type Side } from '../utils/popper.js';
 import { type FocusOutsideEvent, type InteractOutsideEvent } from '../utils/useDismiss.js';
 import { type AutoFocusEvent } from '../utils/useFocusTrap.js';
 /**
- * The popover's floating panel: `role="dialog"` with `data-state`
- * (`open`/`closed`), positioned via the shared popper layer against the
- * trigger (or `SkdxPopoverAnchor`) using `side`/`align`/`sideOffset`
- * (defaults to `4`)/`alignOffset` and flipping/shifting to avoid viewport
- * collisions unless `avoidCollisions` is `false` — against `collisionBoundary`
- * when one is given, otherwise the panel's clipping ancestors. Also exposes
- * `data-side`/`data-align` reflecting the resolved placement, and the
- * measurement custom properties `--skdx-popover-available-width` /
- * `-available-height` / `-trigger-width` / `-transform-origin`, so the panel
- * can be sized and animated from CSS without measuring anything by hand.
- * Traps focus
- * when the popover is `modal`. Closes on Escape or an outside interaction
- * (pointer-down or focus moving out) unless `escape-key-down`/
- * `pointer-down-outside`/`focus-outside`/`interact-outside` call
- * `event.preventDefault()`. `interact-outside` fires for either kind of
- * outside interaction, immediately before the specific event and with the
- * same event object, so one veto covers both.
+ * The popover's floating panel: `role="dialog"` positioned against the trigger
+ * (or `SkdxPopoverAnchor`) using `side`/`align`/`sideOffset`/`alignOffset`,
+ * with flipping/shifting to avoid viewport collisions when `avoidCollisions`
+ * is true. Exposes `data-state` (`open`/`closed`), `data-side`/`data-align`
+ * reflecting resolved placement, and CSS custom properties for panel sizing
+ * and animation (`--skdx-popover-available-width`, `-available-height`,
+ * `-trigger-width`, `-transform-origin`).
  *
- * Where it manages focus it announces the move first: `open-auto-focus`
- * before focus enters the panel and `close-auto-focus` before focus goes back
- * to the trigger, each cancelable — `preventDefault()` leaves focus where it
- * is, so a consumer can place it by hand. Mounts only while open unless
- * `forceMount` is set. Must be used inside `SkdxPopover`.
+ * Must be named with a `SkdxPopoverTitle` (wired to `aria-labelledby`) or an
+ * `aria-label` — a `role="dialog"` with no name announces as bare "dialog".
+ * A `SkdxPopoverDescription` optionally provides supporting text via
+ * `aria-describedby`; both attributes appear only while their source parts
+ * are mounted.
+ *
+ * When `modal` is set, traps focus inside the panel and marks the rest of the
+ * document `inert`. Closes on Escape or outside interaction (pointer-down or
+ * focus moving out) unless handlers call `preventDefault()`. Announces focus
+ * moves via `open-auto-focus` (before entering) and `close-auto-focus`
+ * (before leaving), each cancelable and directable with `initial-focus` /
+ * `final-focus` selectors. Mounts only while open unless `forceMount` is set.
+ * Must be used inside `SkdxPopover`.
  */
 type __VLS_Props = {
     /** Preferred edge of the anchor to place the panel against. */
@@ -48,6 +46,40 @@ type __VLS_Props = {
     collisionBoundary?: Element | Element[] | null;
     /** Keep this panel mounted even while the popover is closed. */
     forceMount?: boolean;
+    /**
+     * Clearance in pixels between the arrow and each end of the panel's edge,
+     * so the arrow cannot ride over a rounded corner. The arrow's *size* stays
+     * in CSS, which is where a shape belongs; only the clearance depends on the
+     * panel's radius, which the positioner is the only thing that can honour.
+     */
+    arrowPadding?: number;
+    /**
+     * Hide the panel while its anchor has been scrolled fully out of view
+     * inside a clipping ancestor, instead of leaving it floating over unrelated
+     * content. The panel is hidden, not unmounted and not closed: unmounting on
+     * a scroll would tear down the focus trap and move the user's focus for a
+     * reason they did not ask for.
+     */
+    hideWhenDetached?: boolean;
+    /**
+     * CSS selector for the element that should receive focus when the popover
+     * opens, resolved with querySelector inside this panel. Live only while
+     * `modal` contains focus — a non-modal popover never moves focus in, and
+     * this must not resurrect a move that deliberately does not happen. Applies
+     * only when `open-auto-focus` was not vetoed, and falls back to the first
+     * tabbable element when it matches nothing.
+     * @default undefined — the panel's first tabbable element, then the panel itself.
+     */
+    initialFocus?: string;
+    /**
+     * CSS selector for the element focus should be sent to when the popover
+     * closes, resolved at document level because the return target is outside
+     * the panel by definition. Live in every modality, unlike `initialFocus`.
+     * Applies only when `close-auto-focus` was not vetoed, and falls back to the
+     * trigger when it matches nothing.
+     * @default undefined — the trigger, or whatever was focused before opening.
+     */
+    finalFocus?: string;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
@@ -69,12 +101,14 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     "onInteract-outside"?: ((event: InteractOutsideEvent) => any) | undefined;
 }>, {
     forceMount: boolean;
-    side: Side;
     align: Align;
+    side: Side;
     sideOffset: number;
     alignOffset: number;
     avoidCollisions: boolean;
     collisionPadding: number | Partial<Record<PhysicalSide, number>>;
+    arrowPadding: number;
+    hideWhenDetached: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/popover/PopoverContent.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const O=require("../utils/composeRefs.cjs"),w=require("../utils/useDismiss.cjs"),c=require("../utils/useFocusTrap.cjs"),r=require("../utils/popper.cjs"),g=require("./context.cjs");let e=require("vue");var y=["id","data-state","data-side","data-align"],R=(0,e.defineComponent)({__name:"PopoverContent",props:{side:{default:"bottom"},align:{default:"center"},sideOffset:{default:4},alignOffset:{default:0},avoidCollisions:{type:Boolean,default:!0},collisionPadding:{default:8},collisionBoundary:{},forceMount:{type:Boolean,default:!1}},emits:["escape-key-down","pointer-down-outside","focus-outside","interact-outside","open-auto-focus","close-auto-focus"],setup(u,{emit:d}){const f=u,n=d,t=(0,e.inject)(g.POPOVER_CONTEXT);if(!t)throw new Error("SkdxPopoverContent must be used within SkdxPopover.");const a=(0,e.inject)(r.POPPER_CONTEXT);if(!a)throw new Error("SkdxPopoverContent must be used within SkdxPopover.");const s=(0,e.ref)(null),i=(0,e.ref)(null),p=O.composeRefs(s,t.contentRef);c.useFocusTrap(s,(0,e.computed)(()=>t.open.value&&t.modal.value),{onOpenAutoFocus:o=>n("open-auto-focus",o),onCloseAutoFocus:o=>n("close-auto-focus",o)}),w.useDismiss({enabled:t.open,onEscapeKeyDown:o=>{n("escape-key-down",o),!o.defaultPrevented&&(t.setOpen(!1),(t.modal.value||c.autoFocusEvent("close-auto-focus",l=>n("close-auto-focus",l)))&&t.triggerRef.value?.focus())},onPointerDownOutside:o=>{n("pointer-down-outside",o),o.defaultPrevented||t.setOpen(!1)},onFocusOutside:o=>{n("focus-outside",o),o.defaultPrevented||t.setOpen(!1)},onInteractOutside:o=>n("interact-outside",o)},[s,t.triggerRef]);const{style:v,arrowStyle:_,placedSide:m,placedAlign:P}=r.usePopperPosition(a.anchor,s,t.open,()=>({...f,component:"popover"}),i);return(0,e.provide)(r.ARROW_CONTEXT,{style:_,setArrowEl:o=>{i.value=o}}),(o,l)=>u.forceMount||(0,e.unref)(t).open.value?((0,e.openBlock)(),(0,e.createElementBlock)("div",{key:0,class:"skdx-popover__content","data-part":"content",id:(0,e.unref)(t).contentId,ref:(0,e.unref)(p),role:"dialog","data-state":(0,e.unref)(t).open.value?"open":"closed","data-side":(0,e.unref)(m),"data-align":(0,e.unref)(P),style:(0,e.normalizeStyle)((0,e.unref)(v))},[(0,e.renderSlot)(o.$slots,"default")],12,y)):(0,e.createCommentVNode)("",!0)}});exports.default=R;
+const O=require("../utils/tabbable.cjs"),b=require("../utils/is-dev-mode.cjs"),k=require("../utils/composeRefs.cjs"),R=require("../utils/useBodyScrollLock.cjs"),S=require("../utils/useDismiss.cjs"),m=require("../utils/useFocusTrap.cjs"),g=require("../utils/useOutsideInert.cjs"),i=require("../utils/popper.cjs"),E=require("./context.cjs"),l=require("./focusTargets.cjs");let e=require("vue");var C=["id","aria-labelledby","aria-describedby","data-state","data-side","data-align"],x=(0,e.defineComponent)({__name:"PopoverContent",props:{side:{default:"bottom"},align:{default:"center"},sideOffset:{default:4},alignOffset:{default:0},avoidCollisions:{type:Boolean,default:!0},collisionPadding:{default:8},collisionBoundary:{},forceMount:{type:Boolean,default:!1},arrowPadding:{default:8},hideWhenDetached:{type:Boolean,default:!1},initialFocus:{},finalFocus:{}},emits:["escape-key-down","pointer-down-outside","focus-outside","interact-outside","open-auto-focus","close-auto-focus"],setup(c,{emit:y}){const u=c,n=y,o=(0,e.inject)(E.POPOVER_CONTEXT);if(!o)throw new Error("SkdxPopoverContent must be used within SkdxPopover.");const d=(0,e.inject)(i.POPPER_CONTEXT);if(!d)throw new Error("SkdxPopoverContent must be used within SkdxPopover.");const s=(0,e.ref)(null),f=(0,e.ref)(null),P=k.composeRefs(s,o.contentRef),p=(0,e.computed)(()=>o.modal.value!==!1),a=(0,e.computed)(()=>o.open.value&&p.value);R.useBodyScrollLock((0,e.computed)(()=>o.open.value&&o.modal.value===!0)),g.useOutsideInert(s,a),m.useFocusTrap(s,a,{onOpenAutoFocus:t=>{if(n("open-auto-focus",t),t.defaultPrevented||!u.initialFocus)return;const r=s.value;if(!r)return;const _=l.resolveFocusSelector(r,u.initialFocus,"initialFocus")??r.querySelector(O.TABBABLE_SELECTOR)??r;t.preventDefault(),_===r&&(r.tabIndex=-1),_.focus({preventScroll:!0})},onCloseAutoFocus:t=>{n("close-auto-focus",t),!(t.defaultPrevented||!u.finalFocus)&&l.applyFinalFocus(u.finalFocus)&&t.preventDefault()}}),S.useDismiss({enabled:o.open,onEscapeKeyDown:t=>{n("escape-key-down",t),!t.defaultPrevented&&(o.setOpen(!1),p.value?o.triggerRef.value?.focus():m.autoFocusEvent("close-auto-focus",r=>n("close-auto-focus",r))&&(l.applyFinalFocus(u.finalFocus)||o.triggerRef.value?.focus()))},onPointerDownOutside:t=>{n("pointer-down-outside",t),t.defaultPrevented||o.setOpen(!1)},onFocusOutside:t=>{n("focus-outside",t),t.defaultPrevented||o.setOpen(!1)},onInteractOutside:t=>n("interact-outside",t)},[s,o.triggerRef]);const{style:q,arrowStyle:w,placedSide:F,placedAlign:h,reposition:v}=i.usePopperPosition(d.anchor,s,o.open,()=>({...u,component:"popover"}),f);return o.repositionRef.value=v,(0,e.onBeforeUnmount)(()=>{o.repositionRef.value===v&&(o.repositionRef.value=null)}),(0,e.watch)(a,t=>{if(!t)return;const r=s.value;!r||r.querySelector(".skdx-popover__close")||b.isDevMode()&&console.warn("[skdx] Popover: `modal` contains focus inside SkdxPopoverContent, but no SkdxPopoverClose was rendered inside it. A user who cannot press Escape — a touch screen-reader user has no Escape key — has no way out of the panel. Render an SkdxPopoverClose, or set `modal` to false.")},{flush:"post",immediate:!0}),(0,e.provide)(i.ARROW_CONTEXT,{style:w,setArrowEl:t=>{f.value=t}}),(t,r)=>c.forceMount||(0,e.unref)(o).open.value?((0,e.openBlock)(),(0,e.createElementBlock)("div",{key:0,class:"skdx-popover__content","data-part":"content",id:(0,e.unref)(o).contentId,ref:(0,e.unref)(P),role:"dialog","aria-labelledby":(0,e.unref)(o).hasTitle.value?(0,e.unref)(o).titleId:void 0,"aria-describedby":(0,e.unref)(o).hasDescription.value?(0,e.unref)(o).descriptionId:void 0,"data-state":(0,e.unref)(o).open.value?"open":"closed","data-side":(0,e.unref)(F),"data-align":(0,e.unref)(h),style:(0,e.normalizeStyle)((0,e.unref)(q))},[(0,e.renderSlot)(t.$slots,"default")],12,C)):(0,e.createCommentVNode)("",!0)}});exports.default=x;

package/dist/popover/PopoverContent.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{composeRefs as e}from"../utils/composeRefs.js";import{useDismiss as o}from"../utils/useDismiss.js";import{autoFocusEvent as t,useFocusTrap as s}from"../utils/useFocusTrap.js";import{ARROW_CONTEXT as a,POPPER_CONTEXT as n,usePopperPosition as u}from"../utils/popper.js";import{POPOVER_CONTEXT as r}from"./context.js";import{computed as d,createCommentVNode as i,createElementBlock as l,defineComponent as p,inject as c,normalizeStyle as f,openBlock as m,provide as v,ref as P,renderSlot as O,unref as w}from"vue";var y=["id","data-state","data-side","data-align"],g=/* @__PURE__ */p({__name:"PopoverContent",props:{side:{default:"bottom"},align:{default:"center"},sideOffset:{default:4},alignOffset:{default:0},avoidCollisions:{type:Boolean,default:!0},collisionPadding:{default:8},collisionBoundary:{},forceMount:{type:Boolean,default:!1}},emits:["escape-key-down","pointer-down-outside","focus-outside","interact-outside","open-auto-focus","close-auto-focus"],setup(p,{emit:g}){const E=p,k=g,C=c(r);if(!C)throw new Error("SkdxPopoverContent must be used within SkdxPopover.");const R=c(n);if(!R)throw new Error("SkdxPopoverContent must be used within SkdxPopover.");const S=P(null),T=P(null),x=e(S,C.contentRef);s(S,d(()=>C.open.value&&C.modal.value),{onOpenAutoFocus:e=>k("open-auto-focus",e),onCloseAutoFocus:e=>k("close-auto-focus",e)}),o({enabled:C.open,onEscapeKeyDown:e=>{k("escape-key-down",e),!e.defaultPrevented&&(C.setOpen(!1),(C.modal.value||t("close-auto-focus",e=>k("close-auto-focus",e)))&&C.triggerRef.value?.focus())},onPointerDownOutside:e=>{k("pointer-down-outside",e),e.defaultPrevented||C.setOpen(!1)},onFocusOutside:e=>{k("focus-outside",e),e.defaultPrevented||C.setOpen(!1)},onInteractOutside:e=>k("interact-outside",e)},[S,C.triggerRef]);const{style:_,arrowStyle:j,placedSide:F,placedAlign:h}=u(R.anchor,S,C.open,()=>({...E,component:"popover"}),T);return v(a,{style:j,setArrowEl:e=>{T.value=e}}),(e,o)=>p.forceMount||w(C).open.value?(m(),l("div",{key:0,class:"skdx-popover__content","data-part":"content",id:w(C).contentId,ref:w(x),role:"dialog","data-state":w(C).open.value?"open":"closed","data-side":w(F),"data-align":w(h),style:f(w(_))},[O(e.$slots,"default")],12,y)):i("",!0)}});export{g as default};
+import{TABBABLE_SELECTOR as e}from"../utils/tabbable.js";import{isDevMode as o}from"../utils/is-dev-mode.js";import{composeRefs as t}from"../utils/composeRefs.js";import{useBodyScrollLock as s}from"../utils/useBodyScrollLock.js";import{useDismiss as a}from"../utils/useDismiss.js";import{autoFocusEvent as n,useFocusTrap as r}from"../utils/useFocusTrap.js";import{useOutsideInert as i}from"../utils/useOutsideInert.js";import{ARROW_CONTEXT as u,POPPER_CONTEXT as l,usePopperPosition as d}from"../utils/popper.js";import{POPOVER_CONTEXT as c}from"./context.js";import{applyFinalFocus as p,resolveFocusSelector as f}from"./focusTargets.js";import{computed as v,createCommentVNode as m,createElementBlock as y,defineComponent as P,inject as w,normalizeStyle as O,onBeforeUnmount as k,openBlock as S,provide as b,ref as h,renderSlot as F,unref as E,watch as g}from"vue";var R=["id","aria-labelledby","aria-describedby","data-state","data-side","data-align"],C=/* @__PURE__ */P({__name:"PopoverContent",props:{side:{default:"bottom"},align:{default:"center"},sideOffset:{default:4},alignOffset:{default:0},avoidCollisions:{type:Boolean,default:!0},collisionPadding:{default:8},collisionBoundary:{},forceMount:{type:Boolean,default:!1},arrowPadding:{default:8},hideWhenDetached:{type:Boolean,default:!1},initialFocus:{},finalFocus:{}},emits:["escape-key-down","pointer-down-outside","focus-outside","interact-outside","open-auto-focus","close-auto-focus"],setup(P,{emit:C}){const x=P,B=C,T=w(c);if(!T)throw new Error("SkdxPopoverContent must be used within SkdxPopover.");const j=w(l);if(!j)throw new Error("SkdxPopoverContent must be used within SkdxPopover.");const _=h(null),D=h(null),A=t(_,T.contentRef),I=v(()=>!1!==T.modal.value),L=v(()=>T.open.value&&I.value);s(v(()=>T.open.value&&!0===T.modal.value)),i(_,L),r(_,L,{onOpenAutoFocus:o=>{if(B("open-auto-focus",o),o.defaultPrevented||!x.initialFocus)return;const t=_.value;if(!t)return;const s=f(t,x.initialFocus,"initialFocus")??t.querySelector(e)??t;o.preventDefault(),s===t&&(t.tabIndex=-1),s.focus({preventScroll:!0})},onCloseAutoFocus:e=>{B("close-auto-focus",e),!e.defaultPrevented&&x.finalFocus&&p(x.finalFocus)&&e.preventDefault()}}),a({enabled:T.open,onEscapeKeyDown:e=>{B("escape-key-down",e),!e.defaultPrevented&&(T.setOpen(!1),I.value?T.triggerRef.value?.focus():n("close-auto-focus",e=>B("close-auto-focus",e))&&(p(x.finalFocus)||T.triggerRef.value?.focus()))},onPointerDownOutside:e=>{B("pointer-down-outside",e),e.defaultPrevented||T.setOpen(!1)},onFocusOutside:e=>{B("focus-outside",e),e.defaultPrevented||T.setOpen(!1)},onInteractOutside:e=>B("interact-outside",e)},[_,T.triggerRef]);const{style:N,arrowStyle:M,placedSide:X,placedAlign:q,reposition:V}=d(j.anchor,_,T.open,()=>({...x,component:"popover"}),D);return T.repositionRef.value=V,k(()=>{T.repositionRef.value===V&&(T.repositionRef.value=null)}),g(L,e=>{if(!e)return;const t=_.value;!t||t.querySelector(".skdx-popover__close")||o()&&console.warn("[skdx] Popover: `modal` contains focus inside SkdxPopoverContent, but no SkdxPopoverClose was rendered inside it. A user who cannot press Escape — a touch screen-reader user has no Escape key — has no way out of the panel. Render an SkdxPopoverClose, or set `modal` to false.")},{flush:"post",immediate:!0}),b(u,{style:M,setArrowEl:e=>{D.value=e}}),(e,o)=>P.forceMount||E(T).open.value?(S(),y("div",{key:0,class:"skdx-popover__content","data-part":"content",id:E(T).contentId,ref:E(A),role:"dialog","aria-labelledby":E(T).hasTitle.value?E(T).titleId:void 0,"aria-describedby":E(T).hasDescription.value?E(T).descriptionId:void 0,"data-state":E(T).open.value?"open":"closed","data-side":E(X),"data-align":E(q),style:O(E(N))},[F(e.$slots,"default")],12,R)):m("",!0)}});export{C as default};

package/dist/popover/PopoverDescription.vue.cjs

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

package/dist/popover/PopoverDescription.vue.d.cts

@@ -0,0 +1,29 @@
+/**
+ * The popover's accessible description: renders a `<p>` whose id
+ * `SkdxPopoverContent` points `aria-describedby` at while this part is mounted.
+ * Genuinely optional: a panel needs a name but may or may not need supporting
+ * text. The wiring only appears while this element is mounted, so an omitted
+ * Description never leaves a dangling `aria-describedby` reference. Must be
+ * used inside `SkdxPopover`.
+ *
+ * @example
+ * ```vue
+ * <SkdxPopoverContent>
+ *   <SkdxPopoverTitle>Share this page</SkdxPopoverTitle>
+ *   <SkdxPopoverDescription>Anyone with the link can view it.</SkdxPopoverDescription>
+ * </SkdxPopoverContent>
+ * ```
+ */
+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/popover/PopoverDescription.vue.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The popover's accessible description: renders a `<p>` whose id
+ * `SkdxPopoverContent` points `aria-describedby` at while this part is mounted.
+ * Genuinely optional: a panel needs a name but may or may not need supporting
+ * text. The wiring only appears while this element is mounted, so an omitted
+ * Description never leaves a dangling `aria-describedby` reference. Must be
+ * used inside `SkdxPopover`.
+ *
+ * @example
+ * ```vue
+ * <SkdxPopoverContent>
+ *   <SkdxPopoverTitle>Share this page</SkdxPopoverTitle>
+ *   <SkdxPopoverDescription>Anyone with the link can view it.</SkdxPopoverDescription>
+ * </SkdxPopoverContent>
+ * ```
+ */
+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/popover/PopoverDescription.vue.js

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

package/dist/popover/PopoverDescription.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const o=require("./context.cjs");let e=require("vue");var n=["id"],i=(0,e.defineComponent)({__name:"PopoverDescription",setup(s){const t=(0,e.inject)(o.POPOVER_CONTEXT);if(!t)throw new Error("SkdxPopoverDescription must be used within SkdxPopover.");return t.setHasDescription(!0),(0,e.onUnmounted)(()=>t.setHasDescription(!1)),(r,p)=>((0,e.openBlock)(),(0,e.createElementBlock)("p",{class:"skdx-popover__description","data-part":"description",id:(0,e.unref)(t).descriptionId},[(0,e.renderSlot)(r.$slots,"default")],8,n))}});exports.default=i;

package/dist/popover/PopoverDescription.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{POPOVER_CONTEXT as e}from"./context.js";import{createElementBlock as o,defineComponent as t,inject as s,onUnmounted as r,openBlock as n,renderSlot as i,unref as a}from"vue";var p=["id"],d=/* @__PURE__ */t({__name:"PopoverDescription",setup(t){const d=s(e);if(!d)throw new Error("SkdxPopoverDescription must be used within SkdxPopover.");return d.setHasDescription(!0),r(()=>d.setHasDescription(!1)),(e,t)=>(n(),o("p",{class:"skdx-popover__description","data-part":"description",id:a(d).descriptionId},[i(e.$slots,"default")],8,p))}});export{d as default};

package/dist/popover/PopoverPortal.vue.d.cts

@@ -1,8 +1,8 @@
 import type { PortalContainer } from '../utils/portal.cjs';
 /**
- * Teleports `SkdxPopoverContent` to `document.body` (or a custom `container`), so the popover escapes
- * any clipping/`overflow` ancestors. Mounts only while open unless
- * `forceMount` is set. Must be used inside `SkdxPopover`.
+ * Teleports `SkdxPopoverContent` to `document.body` (or custom `container`) to escape
+ * clipping/`overflow` ancestors. Mounts only while open unless `forceMount` is set.
+ * Must be used in `SkdxPopover`.
  */
 type __VLS_Props = {
     /**

package/dist/popover/PopoverPortal.vue.d.ts

@@ -1,8 +1,8 @@
 import type { PortalContainer } from '../utils/portal.js';
 /**
- * Teleports `SkdxPopoverContent` to `document.body` (or a custom `container`), so the popover escapes
- * any clipping/`overflow` ancestors. Mounts only while open unless
- * `forceMount` is set. Must be used inside `SkdxPopover`.
+ * Teleports `SkdxPopoverContent` to `document.body` (or custom `container`) to escape
+ * clipping/`overflow` ancestors. Mounts only while open unless `forceMount` is set.
+ * Must be used in `SkdxPopover`.
  */
 type __VLS_Props = {
     /**

package/dist/popover/PopoverRoot.vue.cjs

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