@skdx/vue 0.26.0

package/dist/toast/ToastViewport.vue.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Fixed, portaled `<div role="region">` that hosts rendered `SkdxToast`s in
+ * order, labelled via the ancestor `SkdxToastProvider`'s `label`. Render once,
+ * near the end of the app, alongside `SkdxToastProvider`.
+ *
+ * As a landmark it's reachable with **F6** (and **Shift+F6** to leave), and
+ * it puts focus back where it was when the toast holding focus is removed.
+ */
+type __VLS_Props = {};
+declare var __VLS_5: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_5) => 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/toast/ToastViewport.vue.js

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

package/dist/toast/ToastViewport.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const a=require("../utils/composeRefs.cjs"),u=require("./context.cjs"),l=require("./region-focus.cjs");let e=require("vue");var d=["aria-label"],c=(0,e.defineComponent)({inheritAttrs:!1,__name:"ToastViewport",setup(_){const t=(0,e.inject)(u.TOAST_PROVIDER_CONTEXT);if(!t)throw new Error("SkdxToastViewport must be used within SkdxToastProvider.");const r=(0,e.ref)(null),n=a.composeRefs(r,t.viewportRef),o=(0,e.ref)(!1);let s;return(0,e.onMounted)(()=>{o.value=!0,r.value&&(s=l.wireRegionFocus(r.value))}),(0,e.onBeforeUnmount)(()=>s?.()),(i,f)=>((0,e.openBlock)(),(0,e.createBlock)(e.Teleport,{to:"body",disabled:!o.value},[(0,e.createElementVNode)("div",(0,e.mergeProps)({class:"skdx-toast__viewport","data-part":"viewport",ref:(0,e.unref)(n),role:"region","aria-label":(0,e.unref)(t).label,tabindex:"-1",style:{position:"fixed"}},i.$attrs),[(0,e.renderSlot)(i.$slots,"default")],16,d)],8,["disabled"]))}});exports.default=c;

package/dist/toast/ToastViewport.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{composeRefs as e}from"../utils/composeRefs.js";import{TOAST_PROVIDER_CONTEXT as o}from"./context.js";import{wireRegionFocus as t}from"./region-focus.js";import{Teleport as s,createBlock as a,createElementVNode as r,defineComponent as i,inject as l,mergeProps as n,onBeforeUnmount as d,onMounted as p,openBlock as u,ref as f,renderSlot as m,unref as c}from"vue";var v=["aria-label"],w=/* @__PURE__ */i({inheritAttrs:!1,__name:"ToastViewport",setup(i){const w=l(o);if(!w)throw new Error("SkdxToastViewport must be used within SkdxToastProvider.");const b=f(null),T=e(b,w.viewportRef),x=f(!1);let R;return p(()=>{x.value=!0,b.value&&(R=t(b.value))}),d(()=>R?.()),(e,o)=>(u(),a(s,{to:"body",disabled:!x.value},[r("div",n({class:"skdx-toast__viewport","data-part":"viewport",ref:c(T),role:"region","aria-label":c(w).label,tabindex:"-1",style:{position:"fixed"}},e.$attrs),[m(e.$slots,"default")],16,v)],8,["disabled"]))}});export{w as default};

package/dist/toast/Toaster.vue.cjs

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

package/dist/toast/Toaster.vue.d.cts

@@ -0,0 +1,17 @@
+import { type ToasterStore } from './toaster.cjs';
+/**
+ * Renders a `createToaster` queue: an `SkdxToastProvider` + `SkdxToastViewport`
+ * region hosting one `SkdxToast` per visible entry. Mount it once near the
+ * root of your app; everything after that is imperative
+ * (`toaster.create({ title })`) from anywhere.
+ *
+ * The viewport is a labelled `region` landmark: **F6** moves focus into it
+ * from anywhere on the page, **Shift+F6** returns focus to where it was, and
+ * focus is restored automatically when the toast holding it is removed.
+ */
+type __VLS_Props = {
+    /** The queue to render, from `createToaster`. */
+    toaster: ToasterStore;
+};
+declare const _default: 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>;
+export default _default;

package/dist/toast/Toaster.vue.d.ts

@@ -0,0 +1,17 @@
+import { type ToasterStore } from './toaster.js';
+/**
+ * Renders a `createToaster` queue: an `SkdxToastProvider` + `SkdxToastViewport`
+ * region hosting one `SkdxToast` per visible entry. Mount it once near the
+ * root of your app; everything after that is imperative
+ * (`toaster.create({ title })`) from anywhere.
+ *
+ * The viewport is a labelled `region` landmark: **F6** moves focus into it
+ * from anywhere on the page, **Shift+F6** returns focus to where it was, and
+ * focus is restored automatically when the toast holding it is removed.
+ */
+type __VLS_Props = {
+    /** The queue to render, from `createToaster`. */
+    toaster: ToasterStore;
+};
+declare const _default: 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>;
+export default _default;

package/dist/toast/Toaster.vue.js

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

package/dist/toast/Toaster.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const d=require("./ToastProvider.vue.cjs"),s=require("./ToastViewport.vue.cjs"),p=require("./Toast.vue.cjs"),f=require("./ToastTitle.vue.cjs"),_=require("./ToastDescription.vue.cjs"),T=require("./ToastAction.vue.cjs"),k=require("./ToastClose.vue.cjs"),i=require("./toaster.cjs");let e=require("vue");var C=(0,e.defineComponent)({inheritAttrs:!1,__name:"Toaster",props:{toaster:{}},setup(r){const n=r,u=i.useToasterRef(()=>n.toaster);function c(o,a){o||n.toaster.dismiss(a)}return(o,a)=>((0,e.openBlock)(),(0,e.createBlock)(d.default,{label:r.toaster.label,duration:r.toaster.duration},{default:(0,e.withCtx)(()=>[(0,e.createVNode)(s.default,(0,e.mergeProps)({"data-placement":r.toaster.placement},o.$attrs),{default:(0,e.withCtx)(()=>[((0,e.openBlock)(!0),(0,e.createElementBlock)(e.Fragment,null,(0,e.renderList)((0,e.unref)(u),t=>((0,e.openBlock)(),(0,e.createBlock)(p.default,{key:`${t.id}:${t.revision}`,role:(0,e.unref)(i.TOAST_ROLE_BY_TYPE)[t.type],type:(0,e.unref)(i.TOAST_POLITENESS_BY_TYPE)[t.type],duration:t.duration??(t.type==="loading"?1/0:void 0),"data-type":t.type,onOpenChange:l=>c(l,t.id)},{default:(0,e.withCtx)(()=>[t.title?((0,e.openBlock)(),(0,e.createBlock)(f.default,{key:0},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.title),1)]),_:2},1024)):(0,e.createCommentVNode)("",!0),t.description?((0,e.openBlock)(),(0,e.createBlock)(_.default,{key:1},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.description),1)]),_:2},1024)):(0,e.createCommentVNode)("",!0),t.action?((0,e.openBlock)(),(0,e.createBlock)(T.default,{key:2,"alt-text":t.action.altText,onClick:l=>t.action.onClick?.()},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.action.label),1)]),_:2},1032,["alt-text","onClick"])):(0,e.createCommentVNode)("",!0),(0,e.createVNode)(k.default,{"aria-label":t.closeLabel??"Dismiss"},{default:(0,e.withCtx)(()=>[...a[0]||(a[0]=[(0,e.createTextVNode)("×",-1)])]),_:1},8,["aria-label"])]),_:2},1032,["role","type","duration","data-type","onOpenChange"]))),128))]),_:1},16,["data-placement"])]),_:1},8,["label","duration"]))}});exports.default=C;

package/dist/toast/Toaster.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import t from"./ToastProvider.vue.js";import e from"./ToastViewport.vue.js";import a from"./Toast.vue.js";import o from"./ToastTitle.vue.js";import r from"./ToastDescription.vue.js";import s from"./ToastAction.vue.js";import i from"./ToastClose.vue.js";import{TOAST_POLITENESS_BY_TYPE as l,TOAST_ROLE_BY_TYPE as n,useToasterRef as p}from"./toaster.js";import{Fragment as d,createBlock as m,createCommentVNode as u,createElementBlock as c,createTextVNode as f,createVNode as T,defineComponent as _,mergeProps as y,openBlock as v,renderList as k,toDisplayString as C,unref as j,withCtx as b}from"vue";var g=/* @__PURE__ */_({inheritAttrs:!1,__name:"Toaster",props:{toaster:{}},setup(_){const g=_,x=p(()=>g.toaster);return(p,E)=>(v(),m(t,{label:_.toaster.label,duration:_.toaster.duration},{default:b(()=>[T(e,y({"data-placement":_.toaster.placement},p.$attrs),{default:b(()=>[(v(!0),c(d,null,k(j(x),t=>(v(),m(a,{key:`${t.id}:${t.revision}`,role:j(n)[t.type],type:j(l)[t.type],duration:t.duration??("loading"===t.type?1/0:void 0),"data-type":t.type,onOpenChange:e=>function(t,e){t||g.toaster.dismiss(e)}(e,t.id)},{default:b(()=>[t.title?(v(),m(o,{key:0},{default:b(()=>[f(C(t.title),1)]),_:2},1024)):u("",!0),t.description?(v(),m(r,{key:1},{default:b(()=>[f(C(t.description),1)]),_:2},1024)):u("",!0),t.action?(v(),m(s,{key:2,"alt-text":t.action.altText,onClick:e=>t.action.onClick?.()},{default:b(()=>[f(C(t.action.label),1)]),_:2},1032,["alt-text","onClick"])):u("",!0),T(i,{"aria-label":t.closeLabel??"Dismiss"},{default:b(()=>[...E[0]||(E[0]=[f("×",-1)])]),_:1},8,["aria-label"])]),_:2},1032,["role","type","duration","data-type","onOpenChange"]))),128))]),_:1},16,["data-placement"])]),_:1},8,["label","duration"]))}});export{g as default};

package/dist/toast/context.cjs

@@ -0,0 +1 @@
+var T=Symbol("skdx-toast-provider-context"),O=Symbol("skdx-toast-context");exports.TOAST_CONTEXT=O;exports.TOAST_PROVIDER_CONTEXT=T;

package/dist/toast/context.d.cts

@@ -0,0 +1,17 @@
+import type { InjectionKey, Ref } from 'vue';
+/** @internal Injection key a ToastProvider provides so ToastViewport/Toast can read shared state. */
+export interface ToastProviderContext {
+    label: string;
+    duration: number;
+    viewportRef: Ref<HTMLElement | null>;
+    /** Copies a toast's text into a persistent live region so screen readers reliably announce it. */
+    announce(message: string, priority: 'polite' | 'assertive'): void;
+}
+/** @internal Injection key a ToastProvider provides so its Viewport/Toast descendants share timing and the announce region. */
+export declare const TOAST_PROVIDER_CONTEXT: InjectionKey<ToastProviderContext>;
+/** @internal Injection key a single Toast provides so its parts (Action/Close) can close it. */
+export interface ToastContext {
+    onClose(): void;
+}
+/** @internal Injection key a single Toast provides so its Action/Close parts can dismiss it. */
+export declare const TOAST_CONTEXT: InjectionKey<ToastContext>;

package/dist/toast/context.d.ts

@@ -0,0 +1,17 @@
+import type { InjectionKey, Ref } from 'vue';
+/** @internal Injection key a ToastProvider provides so ToastViewport/Toast can read shared state. */
+export interface ToastProviderContext {
+    label: string;
+    duration: number;
+    viewportRef: Ref<HTMLElement | null>;
+    /** Copies a toast's text into a persistent live region so screen readers reliably announce it. */
+    announce(message: string, priority: 'polite' | 'assertive'): void;
+}
+/** @internal Injection key a ToastProvider provides so its Viewport/Toast descendants share timing and the announce region. */
+export declare const TOAST_PROVIDER_CONTEXT: InjectionKey<ToastProviderContext>;
+/** @internal Injection key a single Toast provides so its parts (Action/Close) can close it. */
+export interface ToastContext {
+    onClose(): void;
+}
+/** @internal Injection key a single Toast provides so its Action/Close parts can dismiss it. */
+export declare const TOAST_CONTEXT: InjectionKey<ToastContext>;

package/dist/toast/context.js

@@ -0,0 +1 @@
+var t=/* @__PURE__ */Symbol("skdx-toast-provider-context"),o=/* @__PURE__ */Symbol("skdx-toast-context");export{o as TOAST_CONTEXT,t as TOAST_PROVIDER_CONTEXT};

package/dist/toast/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./ToastProvider.vue.cjs"),t=require("./ToastViewport.vue.cjs"),o=require("./Toast.vue.cjs"),s=require("./ToastTitle.vue.cjs"),a=require("./ToastDescription.vue.cjs"),i=require("./ToastAction.vue.cjs"),T=require("./ToastClose.vue.cjs"),e=require("./toaster.cjs"),u=require("./Toaster.vue.cjs");exports.DEFAULT_TOAST_DURATION=e.DEFAULT_TOAST_DURATION;exports.SkdxToast=o.default;exports.SkdxToastAction=i.default;exports.SkdxToastClose=T.default;exports.SkdxToastDescription=a.default;exports.SkdxToastProvider=r.default;exports.SkdxToastTitle=s.default;exports.SkdxToastViewport=t.default;exports.SkdxToaster=u.default;exports.createToaster=e.createToaster;exports.useToaster=e.useToaster;

package/dist/toast/index.d.cts

@@ -0,0 +1,10 @@
+export { default as SkdxToastProvider } from './ToastProvider.vue.cjs';
+export { default as SkdxToastViewport } from './ToastViewport.vue.cjs';
+export { default as SkdxToast } from './Toast.vue.cjs';
+export { default as SkdxToastTitle } from './ToastTitle.vue.cjs';
+export { default as SkdxToastDescription } from './ToastDescription.vue.cjs';
+export { default as SkdxToastAction } from './ToastAction.vue.cjs';
+export { default as SkdxToastClose } from './ToastClose.vue.cjs';
+export { default as SkdxToaster } from './Toaster.vue.cjs';
+export { createToaster, useToaster, DEFAULT_TOAST_DURATION } from './toaster.cjs';
+export type { ToasterStore, ToasterOptions, ToasterPromiseMessages, ToasterToast, ToasterToastAction, ToasterToastOptions, ToasterToastType, ToastPlacement, } from './toaster.cjs';

package/dist/toast/index.d.ts

@@ -0,0 +1,10 @@
+export { default as SkdxToastProvider } from './ToastProvider.vue.js';
+export { default as SkdxToastViewport } from './ToastViewport.vue.js';
+export { default as SkdxToast } from './Toast.vue.js';
+export { default as SkdxToastTitle } from './ToastTitle.vue.js';
+export { default as SkdxToastDescription } from './ToastDescription.vue.js';
+export { default as SkdxToastAction } from './ToastAction.vue.js';
+export { default as SkdxToastClose } from './ToastClose.vue.js';
+export { default as SkdxToaster } from './Toaster.vue.js';
+export { createToaster, useToaster, DEFAULT_TOAST_DURATION } from './toaster.js';
+export type { ToasterStore, ToasterOptions, ToasterPromiseMessages, ToasterToast, ToasterToastAction, ToasterToastOptions, ToasterToastType, ToastPlacement, } from './toaster.js';

package/dist/toast/index.js

@@ -0,0 +1 @@
+import o from"./ToastProvider.vue.js";import s from"./ToastViewport.vue.js";import t from"./Toast.vue.js";import a from"./ToastTitle.vue.js";import r from"./ToastDescription.vue.js";import e from"./ToastAction.vue.js";import T from"./ToastClose.vue.js";import{DEFAULT_TOAST_DURATION as i,createToaster as m,useToaster as p}from"./toaster.js";import d from"./Toaster.vue.js";export{i as DEFAULT_TOAST_DURATION,t as SkdxToast,e as SkdxToastAction,T as SkdxToastClose,r as SkdxToastDescription,o as SkdxToastProvider,a as SkdxToastTitle,s as SkdxToastViewport,d as SkdxToaster,m as createToaster,p as useToaster};

package/dist/toast/region-focus.cjs

@@ -0,0 +1 @@
+function f(t){let n=document.activeElement;for(;n;){if(t.contains(n))return!0;n=n.shadowRoot?.activeElement??null}return!1}function a(t){let n=null;const o=()=>{const e=n;n=null,e?.isConnected&&e.focus()},s=e=>{const c=e.composedPath();if(c.includes(t))return;const r=c[0];r instanceof HTMLElement&&(n=r)},i=e=>{e.key==="F6"&&(e.preventDefault(),e.shiftKey?o():f(t)||t.focus())},u=e=>{e.relatedTarget||window.setTimeout(()=>{f(t)||o()},0)};return document.addEventListener("focusin",s),document.addEventListener("keydown",i),t.addEventListener("focusout",u),()=>{document.removeEventListener("focusin",s),document.removeEventListener("keydown",i),t.removeEventListener("focusout",u)}}exports.wireRegionFocus=a;

package/dist/toast/region-focus.d.cts

@@ -0,0 +1,13 @@
+/**
+ * Wires the toast region's keyboard traversal and focus recovery onto
+ * `node`, and returns its own teardown.
+ *
+ * A toast never steals focus, so a keyboard user needs a way in: **F6** moves
+ * focus to the region from anywhere on the page and **Shift+F6** returns it
+ * to wherever it came from — the same landmark-hopping shortcut browsers use,
+ * and what React Aria's toast spec prescribes. Focus is also restored
+ * automatically when the toast currently holding it is removed (the
+ * last-toast-closed case), which otherwise drops focus to `<body>` and loses
+ * the user's place entirely.
+ */
+export declare function wireRegionFocus(node: HTMLElement): () => void;

package/dist/toast/region-focus.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Wires the toast region's keyboard traversal and focus recovery onto
+ * `node`, and returns its own teardown.
+ *
+ * A toast never steals focus, so a keyboard user needs a way in: **F6** moves
+ * focus to the region from anywhere on the page and **Shift+F6** returns it
+ * to wherever it came from — the same landmark-hopping shortcut browsers use,
+ * and what React Aria's toast spec prescribes. Focus is also restored
+ * automatically when the toast currently holding it is removed (the
+ * last-toast-closed case), which otherwise drops focus to `<body>` and loses
+ * the user's place entirely.
+ */
+export declare function wireRegionFocus(node: HTMLElement): () => void;

package/dist/toast/region-focus.js

@@ -0,0 +1 @@
+function e(e){let n=document.activeElement;for(;n;){if(e.contains(n))return!0;n=n.shadowRoot?.activeElement??null}return!1}function n(n){let t=null;const o=()=>{const e=t;t=null,e?.isConnected&&e.focus()},s=e=>{const o=e.composedPath();if(o.includes(n))return;const s=o[0];s instanceof HTMLElement&&(t=s)},u=t=>{"F6"===t.key&&(t.preventDefault(),t.shiftKey?o():e(n)||n.focus())},c=t=>{t.relatedTarget||window.setTimeout(()=>{e(n)||o()},0)};return document.addEventListener("focusin",s),document.addEventListener("keydown",u),n.addEventListener("focusout",c),()=>{document.removeEventListener("focusin",s),document.removeEventListener("keydown",u),n.removeEventListener("focusout",c)}}export{n as wireRegionFocus};

package/dist/toast/toaster.cjs

@@ -0,0 +1 @@
+let a=require("vue");var x={info:"status",success:"status",loading:"status",warning:"alert",error:"alert"},O={info:"background",success:"background",loading:"background",warning:"foreground",error:"foreground"},E=5e3;function R(u={}){const{max:r=3,placement:f="bottom-end",duration:c=E,label:b="Notifications"}=u,o=[],d=new Set;let _=[],g=0;function T(){_=o.slice(0,r);for(const n of d)n()}function p(n){return d.add(n),()=>{d.delete(n)}}function S(){return _}function v(n={}){const e=n.id??`skdx-toast-${++g}`,t=o.findIndex(s=>s.id===e),i={type:"info",...n,id:e,revision:t<0?0:o[t].revision+1};return t<0?o.push(i):o[t]=i,T(),e}function l(n,e){const t=o.findIndex(s=>s.id===n);if(t<0)return;const i=o[t];o[t]={...i,...e,id:n,revision:i.revision+1},T()}function h(n){if(n===void 0){if(o.length===0)return;o.length=0}else{const e=o.findIndex(t=>t.id===n);if(e<0)return;o.splice(e,1)}T()}function A(n,e,t={}){const i=v({...t,...e.loading,type:"loading"});return n.then(s=>(l(i,{duration:void 0,...t,...typeof e.success=="function"?e.success(s):e.success,type:"success"}),s),s=>{throw l(i,{duration:void 0,...t,...typeof e.error=="function"?e.error(s):e.error,type:"error"}),s})}return{max:r,placement:f,duration:c,label:b,subscribe:p,getToasts:S,create:v,update:l,dismiss:h,promise:A}}function Y(u){const r=(0,a.shallowRef)(u.getToasts());return(0,a.onScopeDispose)(u.subscribe(()=>{r.value=u.getToasts()})),r}function w(u){const r=(0,a.shallowRef)([]);return(0,a.watchEffect)(f=>{const c=u();r.value=c.getToasts(),f(c.subscribe(()=>{r.value=c.getToasts()}))}),r}exports.DEFAULT_TOAST_DURATION=E;exports.TOAST_POLITENESS_BY_TYPE=O;exports.TOAST_ROLE_BY_TYPE=x;exports.createToaster=R;exports.useToaster=Y;exports.useToasterRef=w;

package/dist/toast/toaster.d.cts

@@ -0,0 +1,149 @@
+import { type Ref } from 'vue';
+/**
+ * Where the toast region sits on screen. Emitted as `data-placement` on the
+ * viewport — headless, so the design layer does the actual positioning.
+ */
+export type ToastPlacement = 'top-start' | 'top' | 'top-end' | 'bottom-start' | 'bottom' | 'bottom-end';
+/** Semantic kind of a queued toast. Drives `data-type`, the root's role, and live-region politeness. */
+export type ToasterToastType = 'info' | 'success' | 'warning' | 'error' | 'loading';
+/**
+ * `error`/`warning` are failures the user has to know about now, so they get
+ * `role="alert"` (an assertive live region); everything else is
+ * `role="status"` (polite) and waits for a gap in speech.
+ */
+export declare const TOAST_ROLE_BY_TYPE: Record<ToasterToastType, 'status' | 'alert'>;
+/** The same split as {@link TOAST_ROLE_BY_TYPE}, in `SkdxToast`'s `type` vocabulary (`foreground` = assertive). */
+export declare const TOAST_POLITENESS_BY_TYPE: Record<ToasterToastType, 'foreground' | 'background'>;
+/**
+ * Default auto-dismiss duration (ms). WCAG 2.2.1 wants time limits to be
+ * adjustable or long enough to read; 5s is the floor a short toast needs, and
+ * the timer additionally pauses on hover, on focus, and while the page is
+ * hidden, so the countdown only runs while the message is actually readable.
+ */
+export declare const DEFAULT_TOAST_DURATION = 5000;
+/** An actionable button rendered inside a queued toast (the "Undo" affordance). */
+export interface ToasterToastAction {
+    /** Visible button text. */
+    label: string;
+    /** Describes the action for assistive tech users who can't easily reach it, per `SkdxToastAction`. */
+    altText: string;
+    /** Runs on click. The toast closes either way. */
+    onClick?: () => void;
+}
+/** What {@link ToasterStore.create} and {@link ToasterStore.update} accept. */
+export interface ToasterToastOptions {
+    /**
+     * Stable id, so a later `update`/`dismiss` can address this toast. Creating
+     * with an id that is already queued replaces that entry in place.
+     * @default undefined — generated.
+     */
+    id?: string;
+    /** Heading text, rendered as `SkdxToastTitle`. @default undefined — no title. */
+    title?: string;
+    /** Body text, rendered as `SkdxToastDescription`. @default undefined — no description. */
+    description?: string;
+    /** Semantic kind. @default 'info' */
+    type?: ToasterToastType;
+    /**
+     * Auto-dismiss duration (ms); `Infinity` never auto-dismisses.
+     * @default undefined — the toaster's `duration`, except `type: 'loading'`, which is `Infinity`.
+     */
+    duration?: number;
+    /** Optional action button. @default undefined — no action button. */
+    action?: ToasterToastAction;
+    /** Accessible name for the close button. @default 'Dismiss' */
+    closeLabel?: string;
+}
+/** One queued toast, as handed to the renderer. */
+export interface ToasterToast extends ToasterToastOptions {
+    id: string;
+    type: ToasterToastType;
+    /**
+     * Bumped on every `update`. Renderers key on `id:revision`, so an updated
+     * toast remounts — which is what re-announces the new text and restarts the
+     * auto-dismiss timer for the message the user is now actually reading.
+     */
+    revision: number;
+}
+/** Options for {@link createToaster}. */
+export interface ToasterOptions {
+    /**
+     * How many toasts are visible at once; the rest wait in FIFO order and
+     * appear as visible ones are dismissed.
+     * @default 3
+     */
+    max?: number;
+    /** Where the region sits, as `data-placement` on the viewport. @default 'bottom-end' */
+    placement?: ToastPlacement;
+    /** Default auto-dismiss duration (ms) for queued toasts. @default 5000 */
+    duration?: number;
+    /** Accessible label for the toast region landmark. @default 'Notifications' */
+    label?: string;
+}
+/** Messages a {@link ToasterStore.promise} call swaps between as the promise settles. */
+export interface ToasterPromiseMessages<T> {
+    /** Shown immediately, as `type: 'loading'` (no auto-dismiss). */
+    loading: ToasterToastOptions;
+    /** Shown on fulfilment, as `type: 'success'`. */
+    success: ToasterToastOptions | ((value: T) => ToasterToastOptions);
+    /** Shown on rejection, as `type: 'error'`. The rejection is re-thrown either way. */
+    error: ToasterToastOptions | ((error: unknown) => ToasterToastOptions);
+}
+/**
+ * An imperative toast queue: app code calls `create`/`dismiss` from anywhere
+ * (no component instance, no injection), and a mounted `SkdxToaster` renders
+ * whatever is currently visible.
+ */
+export interface ToasterStore {
+    /** See {@link ToasterOptions.max}. */
+    readonly max: number;
+    /** See {@link ToasterOptions.placement}. */
+    readonly placement: ToastPlacement;
+    /** See {@link ToasterOptions.duration}. */
+    readonly duration: number;
+    /** See {@link ToasterOptions.label}. */
+    readonly label: string;
+    /** Subscribes to queue changes. Returns its own unsubscribe. */
+    subscribe(listener: () => void): () => void;
+    /** The currently visible toasts (at most `max`) — a stable reference until the queue changes. */
+    getToasts(): readonly ToasterToast[];
+    /** Queues a toast and returns its id. */
+    create(options?: ToasterToastOptions): string;
+    /** Merges `options` into a queued toast, bumping its revision. No-ops for an unknown id. */
+    update(id: string, options: ToasterToastOptions): void;
+    /** Removes one toast, or the whole queue when called with no id. */
+    dismiss(id?: string): void;
+    /** Shows a loading toast, then swaps it for success/error when `promise` settles. Re-throws rejections. */
+    promise<T>(promise: Promise<T>, messages: ToasterPromiseMessages<T>, options?: ToasterToastOptions): Promise<T>;
+}
+/**
+ * Creates a toast queue: `create`/`update`/`dismiss`/`promise` callable from
+ * anywhere in your app, `max` visible at a time with the rest waiting in FIFO
+ * order. Create it once at module scope and render one `SkdxToaster` for it.
+ *
+ * @example
+ * ```ts
+ * // toaster.ts
+ * export const toaster = createToaster({ max: 3, placement: 'bottom-end' });
+ *
+ * // anywhere
+ * toaster.create({ title: 'Saved', type: 'success' });
+ * ```
+ */
+export declare function createToaster(options?: ToasterOptions): ToasterStore;
+/**
+ * Subscribes to a toaster's visible toasts as a `shallowRef`. Only needed if
+ * you're rendering the queue yourself instead of mounting `SkdxToaster`.
+ *
+ * @example
+ * ```ts
+ * const toasts = useToaster(toaster);
+ * ```
+ */
+export declare function useToaster(toaster: ToasterStore): Ref<readonly ToasterToast[]>;
+/**
+ * @internal Same as {@link useToaster}, but for a toaster that can change
+ * identity (a prop) — re-subscribes when it does, and unsubscribes with the
+ * owning effect scope.
+ */
+export declare function useToasterRef(getToaster: () => ToasterStore): Ref<readonly ToasterToast[]>;

package/dist/toast/toaster.d.ts

@@ -0,0 +1,149 @@
+import { type Ref } from 'vue';
+/**
+ * Where the toast region sits on screen. Emitted as `data-placement` on the
+ * viewport — headless, so the design layer does the actual positioning.
+ */
+export type ToastPlacement = 'top-start' | 'top' | 'top-end' | 'bottom-start' | 'bottom' | 'bottom-end';
+/** Semantic kind of a queued toast. Drives `data-type`, the root's role, and live-region politeness. */
+export type ToasterToastType = 'info' | 'success' | 'warning' | 'error' | 'loading';
+/**
+ * `error`/`warning` are failures the user has to know about now, so they get
+ * `role="alert"` (an assertive live region); everything else is
+ * `role="status"` (polite) and waits for a gap in speech.
+ */
+export declare const TOAST_ROLE_BY_TYPE: Record<ToasterToastType, 'status' | 'alert'>;
+/** The same split as {@link TOAST_ROLE_BY_TYPE}, in `SkdxToast`'s `type` vocabulary (`foreground` = assertive). */
+export declare const TOAST_POLITENESS_BY_TYPE: Record<ToasterToastType, 'foreground' | 'background'>;
+/**
+ * Default auto-dismiss duration (ms). WCAG 2.2.1 wants time limits to be
+ * adjustable or long enough to read; 5s is the floor a short toast needs, and
+ * the timer additionally pauses on hover, on focus, and while the page is
+ * hidden, so the countdown only runs while the message is actually readable.
+ */
+export declare const DEFAULT_TOAST_DURATION = 5000;
+/** An actionable button rendered inside a queued toast (the "Undo" affordance). */
+export interface ToasterToastAction {
+    /** Visible button text. */
+    label: string;
+    /** Describes the action for assistive tech users who can't easily reach it, per `SkdxToastAction`. */
+    altText: string;
+    /** Runs on click. The toast closes either way. */
+    onClick?: () => void;
+}
+/** What {@link ToasterStore.create} and {@link ToasterStore.update} accept. */
+export interface ToasterToastOptions {
+    /**
+     * Stable id, so a later `update`/`dismiss` can address this toast. Creating
+     * with an id that is already queued replaces that entry in place.
+     * @default undefined — generated.
+     */
+    id?: string;
+    /** Heading text, rendered as `SkdxToastTitle`. @default undefined — no title. */
+    title?: string;
+    /** Body text, rendered as `SkdxToastDescription`. @default undefined — no description. */
+    description?: string;
+    /** Semantic kind. @default 'info' */
+    type?: ToasterToastType;
+    /**
+     * Auto-dismiss duration (ms); `Infinity` never auto-dismisses.
+     * @default undefined — the toaster's `duration`, except `type: 'loading'`, which is `Infinity`.
+     */
+    duration?: number;
+    /** Optional action button. @default undefined — no action button. */
+    action?: ToasterToastAction;
+    /** Accessible name for the close button. @default 'Dismiss' */
+    closeLabel?: string;
+}
+/** One queued toast, as handed to the renderer. */
+export interface ToasterToast extends ToasterToastOptions {
+    id: string;
+    type: ToasterToastType;
+    /**
+     * Bumped on every `update`. Renderers key on `id:revision`, so an updated
+     * toast remounts — which is what re-announces the new text and restarts the
+     * auto-dismiss timer for the message the user is now actually reading.
+     */
+    revision: number;
+}
+/** Options for {@link createToaster}. */
+export interface ToasterOptions {
+    /**
+     * How many toasts are visible at once; the rest wait in FIFO order and
+     * appear as visible ones are dismissed.
+     * @default 3
+     */
+    max?: number;
+    /** Where the region sits, as `data-placement` on the viewport. @default 'bottom-end' */
+    placement?: ToastPlacement;
+    /** Default auto-dismiss duration (ms) for queued toasts. @default 5000 */
+    duration?: number;
+    /** Accessible label for the toast region landmark. @default 'Notifications' */
+    label?: string;
+}
+/** Messages a {@link ToasterStore.promise} call swaps between as the promise settles. */
+export interface ToasterPromiseMessages<T> {
+    /** Shown immediately, as `type: 'loading'` (no auto-dismiss). */
+    loading: ToasterToastOptions;
+    /** Shown on fulfilment, as `type: 'success'`. */
+    success: ToasterToastOptions | ((value: T) => ToasterToastOptions);
+    /** Shown on rejection, as `type: 'error'`. The rejection is re-thrown either way. */
+    error: ToasterToastOptions | ((error: unknown) => ToasterToastOptions);
+}
+/**
+ * An imperative toast queue: app code calls `create`/`dismiss` from anywhere
+ * (no component instance, no injection), and a mounted `SkdxToaster` renders
+ * whatever is currently visible.
+ */
+export interface ToasterStore {
+    /** See {@link ToasterOptions.max}. */
+    readonly max: number;
+    /** See {@link ToasterOptions.placement}. */
+    readonly placement: ToastPlacement;
+    /** See {@link ToasterOptions.duration}. */
+    readonly duration: number;
+    /** See {@link ToasterOptions.label}. */
+    readonly label: string;
+    /** Subscribes to queue changes. Returns its own unsubscribe. */
+    subscribe(listener: () => void): () => void;
+    /** The currently visible toasts (at most `max`) — a stable reference until the queue changes. */
+    getToasts(): readonly ToasterToast[];
+    /** Queues a toast and returns its id. */
+    create(options?: ToasterToastOptions): string;
+    /** Merges `options` into a queued toast, bumping its revision. No-ops for an unknown id. */
+    update(id: string, options: ToasterToastOptions): void;
+    /** Removes one toast, or the whole queue when called with no id. */
+    dismiss(id?: string): void;
+    /** Shows a loading toast, then swaps it for success/error when `promise` settles. Re-throws rejections. */
+    promise<T>(promise: Promise<T>, messages: ToasterPromiseMessages<T>, options?: ToasterToastOptions): Promise<T>;
+}
+/**
+ * Creates a toast queue: `create`/`update`/`dismiss`/`promise` callable from
+ * anywhere in your app, `max` visible at a time with the rest waiting in FIFO
+ * order. Create it once at module scope and render one `SkdxToaster` for it.
+ *
+ * @example
+ * ```ts
+ * // toaster.ts
+ * export const toaster = createToaster({ max: 3, placement: 'bottom-end' });
+ *
+ * // anywhere
+ * toaster.create({ title: 'Saved', type: 'success' });
+ * ```
+ */
+export declare function createToaster(options?: ToasterOptions): ToasterStore;
+/**
+ * Subscribes to a toaster's visible toasts as a `shallowRef`. Only needed if
+ * you're rendering the queue yourself instead of mounting `SkdxToaster`.
+ *
+ * @example
+ * ```ts
+ * const toasts = useToaster(toaster);
+ * ```
+ */
+export declare function useToaster(toaster: ToasterStore): Ref<readonly ToasterToast[]>;
+/**
+ * @internal Same as {@link useToaster}, but for a toaster that can change
+ * identity (a prop) — re-subscribes when it does, and unsubscribes with the
+ * owning effect scope.
+ */
+export declare function useToasterRef(getToaster: () => ToasterStore): Ref<readonly ToasterToast[]>;

package/dist/toast/toaster.js

@@ -0,0 +1 @@
+import{onScopeDispose as e,shallowRef as t,watchEffect as n}from"vue";var s={info:"status",success:"status",loading:"status",warning:"alert",error:"alert"},o={info:"background",success:"background",loading:"background",warning:"foreground",error:"foreground"},r=5e3;function i(e={}){const{max:t=3,placement:n="bottom-end",duration:s=r,label:o="Notifications"}=e,i=[],a=/* @__PURE__ */new Set;let u=[],c=0;function d(){u=i.slice(0,t);for(const e of a)e()}function f(e={}){const t=e.id??"skdx-toast-"+ ++c,n=i.findIndex(e=>e.id===t),s={type:"info",...e,id:t,revision:n<0?0:i[n].revision+1};return n<0?i.push(s):i[n]=s,d(),t}function l(e,t){const n=i.findIndex(t=>t.id===e);if(n<0)return;const s=i[n];i[n]={...s,...t,id:e,revision:s.revision+1},d()}return{max:t,placement:n,duration:s,label:o,subscribe:function(e){return a.add(e),()=>{a.delete(e)}},getToasts:function(){return u},create:f,update:l,dismiss:function(e){if(void 0===e){if(0===i.length)return;i.length=0}else{const t=i.findIndex(t=>t.id===e);if(t<0)return;i.splice(t,1)}d()},promise:function(e,t,n={}){const s=f({...n,...t.loading,type:"loading"});return e.then(e=>(l(s,{duration:void 0,...n,..."function"==typeof t.success?t.success(e):t.success,type:"success"}),e),e=>{throw l(s,{duration:void 0,...n,..."function"==typeof t.error?t.error(e):t.error,type:"error"}),e})}}}function a(n){const s=t(n.getToasts());return e(n.subscribe(()=>{s.value=n.getToasts()})),s}function u(e){const s=t([]);return n(t=>{const n=e();s.value=n.getToasts(),t(n.subscribe(()=>{s.value=n.getToasts()}))}),s}export{r as DEFAULT_TOAST_DURATION,o as TOAST_POLITENESS_BY_TYPE,s as TOAST_ROLE_BY_TYPE,i as createToaster,a as useToaster,u as useToasterRef};

package/dist/toggle/Toggle.vue.cjs

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

package/dist/toggle/Toggle.vue.d.cts

@@ -0,0 +1,37 @@
+/**
+ * The Vue implementation of the shared Toggle contract (see
+ * `@skdx/shared`'s `toggleContract`). Renders a native `<button>`:
+ * behavior and accessibility only, no visual style.
+ *
+ * Supports `v-model:pressed` (or explicit `@pressed-change`).
+ */
+type __VLS_Props = {
+    /** Pressed state, for controlled usage. Pair with `v-model:pressed` or `@pressed-change`. */
+    pressed?: boolean;
+    /** Initial pressed state, for uncontrolled usage. */
+    defaultPressed?: boolean;
+    /** Native `disabled` attribute — excludes the toggle from focus and click handling. */
+    disabled?: 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, {
+    "update:pressed": (pressed: boolean) => any;
+    "pressed-change": (pressed: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:pressed"?: ((pressed: boolean) => any) | undefined;
+    "onPressed-change"?: ((pressed: boolean) => any) | undefined;
+}>, {
+    disabled: boolean;
+    pressed: boolean;
+    defaultPressed: 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/toggle/Toggle.vue.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The Vue implementation of the shared Toggle contract (see
+ * `@skdx/shared`'s `toggleContract`). Renders a native `<button>`:
+ * behavior and accessibility only, no visual style.
+ *
+ * Supports `v-model:pressed` (or explicit `@pressed-change`).
+ */
+type __VLS_Props = {
+    /** Pressed state, for controlled usage. Pair with `v-model:pressed` or `@pressed-change`. */
+    pressed?: boolean;
+    /** Initial pressed state, for uncontrolled usage. */
+    defaultPressed?: boolean;
+    /** Native `disabled` attribute — excludes the toggle from focus and click handling. */
+    disabled?: 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, {
+    "update:pressed": (pressed: boolean) => any;
+    "pressed-change": (pressed: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:pressed"?: ((pressed: boolean) => any) | undefined;
+    "onPressed-change"?: ((pressed: boolean) => any) | undefined;
+}>, {
+    disabled: boolean;
+    pressed: boolean;
+    defaultPressed: 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/toggle/Toggle.vue.js

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

package/dist/toggle/Toggle.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+let t=require("vue");var u=["aria-pressed","data-state","data-disabled","disabled"],i=(0,t.defineComponent)({__name:"Toggle",props:{pressed:{type:Boolean,default:void 0},defaultPressed:{type:Boolean,default:!1},disabled:{type:Boolean,default:!1}},emits:["update:pressed","pressed-change"],setup(d,{emit:r}){const s=d,l=r,o=(0,t.ref)(s.defaultPressed),a=()=>s.pressed??o.value;function n(){if(s.disabled)return;const e=!a();s.pressed===void 0&&(o.value=e),l("update:pressed",e),l("pressed-change",e)}return(e,p)=>((0,t.openBlock)(),(0,t.createElementBlock)("button",{class:"skdx-toggle","data-part":"root","data-skdx-component":"toggle",type:"button","aria-pressed":a(),"data-state":a()?"on":"off","data-disabled":d.disabled?"":void 0,disabled:d.disabled,onClick:n},[(0,t.renderSlot)(e.$slots,"default")],8,u))}});exports.default=i;

package/dist/toggle/Toggle.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{createElementBlock as e,defineComponent as a,openBlock as d,ref as s,renderSlot as t}from"vue";var o=["aria-pressed","data-state","data-disabled","disabled"],l=/* @__PURE__ */a({__name:"Toggle",props:{pressed:{type:Boolean,default:void 0},defaultPressed:{type:Boolean,default:!1},disabled:{type:Boolean,default:!1}},emits:["update:pressed","pressed-change"],setup(a,{emit:l}){const r=a,n=l,p=s(r.defaultPressed),i=()=>r.pressed??p.value;function u(){if(r.disabled)return;const e=!i();void 0===r.pressed&&(p.value=e),n("update:pressed",e),n("pressed-change",e)}return(s,l)=>(d(),e("button",{class:"skdx-toggle","data-part":"root","data-skdx-component":"toggle",type:"button","aria-pressed":i(),"data-state":i()?"on":"off","data-disabled":a.disabled?"":void 0,disabled:a.disabled,onClick:u},[t(s.$slots,"default")],8,o))}});export{l as default};

package/dist/toggle/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./Toggle.vue.cjs");exports.SkdxToggle=e.default;

package/dist/toggle/index.d.cts

@@ -0,0 +1 @@
+export { default as SkdxToggle } from './Toggle.vue.cjs';

package/dist/toggle/index.d.ts

@@ -0,0 +1 @@
+export { default as SkdxToggle } from './Toggle.vue.js';

package/dist/toggle/index.js

@@ -0,0 +1 @@
+import o from"./Toggle.vue.js";export{o as SkdxToggle};

package/dist/toggle-group/ToggleGroup.vue.cjs

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