@skdx/vue 0.26.0 → 0.28.0

package/dist/toast/context.d.cts

@@ -1,10 +1,22 @@
 import type { InjectionKey, Ref } from 'vue';
+/**
+ * Which way a toast is dragged to dismiss it. `'start'`/`'end'` are logical and
+ * resolve against the toast's own writing direction; the four physical values
+ * are absolute.
+ */
+export type ToastSwipeDirection = 'up' | 'down' | 'left' | 'right' | 'start' | 'end';
+/** The phase a swipe is in, published as `data-swipe` on the toast root. */
+export type ToastSwipePhase = 'start' | 'move' | 'cancel' | 'end';
 /** @internal Injection key a ToastProvider provides so ToastViewport/Toast can read shared state. */
 export interface ToastProviderContext {
     label: string;
     duration: number;
+    /** Logical swipe direction to dismiss; resolved per toast. */
+    swipeDirection: ToastSwipeDirection;
+    /** Drag distance (px) along swipeDirection to dismiss. */
+    swipeThreshold: number;
     viewportRef: Ref<HTMLElement | null>;
-    /** Copies a toast's text into a persistent live region so screen readers reliably announce it. */
+    /** Announce message via persistent live region. */
     announce(message: string, priority: 'polite' | 'assertive'): void;
 }
 /** @internal Injection key a ToastProvider provides so its Viewport/Toast descendants share timing and the announce region. */
@@ -12,6 +24,14 @@ 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;
+    /** Title id; root's aria-labelledby when present. */
+    titleId: string;
+    /** Description id; root's aria-describedby when present. */
+    descriptionId: string;
+    /** Register Title presence. */
+    setHasTitle(present: boolean): void;
+    /** Register Description presence. */
+    setHasDescription(present: boolean): 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

@@ -1,10 +1,22 @@
 import type { InjectionKey, Ref } from 'vue';
+/**
+ * Which way a toast is dragged to dismiss it. `'start'`/`'end'` are logical and
+ * resolve against the toast's own writing direction; the four physical values
+ * are absolute.
+ */
+export type ToastSwipeDirection = 'up' | 'down' | 'left' | 'right' | 'start' | 'end';
+/** The phase a swipe is in, published as `data-swipe` on the toast root. */
+export type ToastSwipePhase = 'start' | 'move' | 'cancel' | 'end';
 /** @internal Injection key a ToastProvider provides so ToastViewport/Toast can read shared state. */
 export interface ToastProviderContext {
     label: string;
     duration: number;
+    /** Logical swipe direction to dismiss; resolved per toast. */
+    swipeDirection: ToastSwipeDirection;
+    /** Drag distance (px) along swipeDirection to dismiss. */
+    swipeThreshold: number;
     viewportRef: Ref<HTMLElement | null>;
-    /** Copies a toast's text into a persistent live region so screen readers reliably announce it. */
+    /** Announce message via persistent live region. */
     announce(message: string, priority: 'polite' | 'assertive'): void;
 }
 /** @internal Injection key a ToastProvider provides so its Viewport/Toast descendants share timing and the announce region. */
@@ -12,6 +24,14 @@ 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;
+    /** Title id; root's aria-labelledby when present. */
+    titleId: string;
+    /** Description id; root's aria-describedby when present. */
+    descriptionId: string;
+    /** Register Title presence. */
+    setHasTitle(present: boolean): void;
+    /** Register Description presence. */
+    setHasDescription(present: boolean): 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/index.cjs

@@ -1 +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;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./toaster.cjs"),r=require("./Toaster.vue.cjs");exports.DEFAULT_TOAST_DURATION=e.DEFAULT_TOAST_DURATION;exports.SkdxToaster=r.default;exports.createToaster=e.createToaster;exports.useToaster=e.useToaster;

package/dist/toast/index.d.cts

@@ -1,10 +1,3 @@
-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

@@ -1,10 +1,3 @@
-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

@@ -1 +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};
+import{DEFAULT_TOAST_DURATION as s,createToaster as a,useToaster as e}from"./toaster.js";import r from"./Toaster.vue.js";export{s as DEFAULT_TOAST_DURATION,r as SkdxToaster,a as createToaster,e as useToaster};

package/dist/toast/primitives.cjs

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

package/dist/toast/primitives.d.cts

@@ -0,0 +1,32 @@
+/**
+ * Advanced primitives for `SkdxToaster` — the parts the recipe composes.
+ * Use when you need a different structure. `SkdxToast` is the single-notification
+ * toast the toaster renders per queue entry.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxToast, SkdxToastAction, SkdxToastClose, SkdxToastDescription, SkdxToastProvider, SkdxToastTitle, SkdxToastViewport } from '@skdx/vue/primitives/toast';
+ * </script>
+ *
+ * <template>
+ *   <SkdxToastProvider>
+ *     <SkdxToast v-model:open="open">
+ *       <SkdxToastTitle>Saved</SkdxToastTitle>
+ *       <SkdxToastDescription>Your changes are live.</SkdxToastDescription>
+ *       <SkdxToastAction alt-text="Undo the save" @click="undo">Undo</SkdxToastAction>
+ *       <SkdxToastClose aria-label="Dismiss">×</SkdxToastClose>
+ *     </SkdxToast>
+ *     <SkdxToastViewport />
+ *   </SkdxToastProvider>
+ * </template>
+ * ```
+ */
+export { default as SkdxToast } from './Toast.vue.cjs';
+export { default as SkdxToastProvider } from './ToastProvider.vue.cjs';
+export { default as SkdxToastViewport } from './ToastViewport.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 type { ToastSwipeDirection, ToastSwipePhase } from './context.cjs';

package/dist/toast/primitives.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Advanced primitives for `SkdxToaster` — the parts the recipe composes.
+ * Use when you need a different structure. `SkdxToast` is the single-notification
+ * toast the toaster renders per queue entry.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxToast, SkdxToastAction, SkdxToastClose, SkdxToastDescription, SkdxToastProvider, SkdxToastTitle, SkdxToastViewport } from '@skdx/vue/primitives/toast';
+ * </script>
+ *
+ * <template>
+ *   <SkdxToastProvider>
+ *     <SkdxToast v-model:open="open">
+ *       <SkdxToastTitle>Saved</SkdxToastTitle>
+ *       <SkdxToastDescription>Your changes are live.</SkdxToastDescription>
+ *       <SkdxToastAction alt-text="Undo the save" @click="undo">Undo</SkdxToastAction>
+ *       <SkdxToastClose aria-label="Dismiss">×</SkdxToastClose>
+ *     </SkdxToast>
+ *     <SkdxToastViewport />
+ *   </SkdxToastProvider>
+ * </template>
+ * ```
+ */
+export { default as SkdxToast } from './Toast.vue.js';
+export { default as SkdxToastProvider } from './ToastProvider.vue.js';
+export { default as SkdxToastViewport } from './ToastViewport.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 type { ToastSwipeDirection, ToastSwipePhase } from './context.js';

package/dist/toast/primitives.js

@@ -0,0 +1 @@
+import o from"./Toast.vue.js";import s from"./ToastAction.vue.js";import t from"./ToastClose.vue.js";import r from"./ToastDescription.vue.js";import a from"./ToastProvider.vue.js";import i from"./ToastTitle.vue.js";import e from"./ToastViewport.vue.js";export{o as SkdxToast,s as SkdxToastAction,t as SkdxToastClose,r as SkdxToastDescription,a as SkdxToastProvider,i as SkdxToastTitle,e as SkdxToastViewport};

package/dist/toast/region-focus.cjs

@@ -1 +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;
+function f(e){let t=document.activeElement;for(;t;){if(e.contains(t))return!0;t=t.shadowRoot?.activeElement??null}return!1}var l=["F6"];function d(e,t){const o=t[t.length-1];if(o===void 0||e.key!==o)return!1;const s=t.slice(0,-1).map(i=>i.toLowerCase());return s.includes("alt")===e.altKey&&s.includes("control")===e.ctrlKey&&s.includes("meta")===e.metaKey}function m(e){return e.join("+")}function E(e,t=l){let o=null;const s=()=>{const n=o;o=null,n?.isConnected&&n.focus()},i=n=>{const u=n.composedPath();if(u.includes(e))return;const a=u[0];a instanceof HTMLElement&&(o=a)},c=n=>{d(n,t)&&(n.preventDefault(),n.shiftKey?s():f(e)||e.focus())},r=n=>{n.relatedTarget||window.setTimeout(()=>{f(e)||s()},0)};return document.addEventListener("focusin",i),document.addEventListener("keydown",c),e.addEventListener("focusout",r),()=>{document.removeEventListener("focusin",i),document.removeEventListener("keydown",c),e.removeEventListener("focusout",r)}}exports.DEFAULT_TOAST_HOTKEY=l;exports.formatHotkey=m;exports.wireRegionFocus=E;

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

@@ -1,13 +1,14 @@
 /**
- * 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.
+ * The region's entry shortcut when unconfigured.
  */
-export declare function wireRegionFocus(node: HTMLElement): () => void;
+export declare const DEFAULT_TOAST_HOTKEY: readonly string[];
+/**
+ * Formats the hotkey for announcement since a toast never steals focus.
+ */
+export declare function formatHotkey(hotkey: readonly string[]): string;
+/**
+ * Wires keyboard traversal for the toast region. `hotkey` (F6 by default) moves
+ * focus to it from anywhere; Shift+hotkey restores prior focus. Restores when
+ * a toast is removed. Configurable to avoid collisions with app pane traversal.
+ */
+export declare function wireRegionFocus(node: HTMLElement, hotkey?: readonly string[]): () => void;

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

@@ -1,13 +1,14 @@
 /**
- * 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.
+ * The region's entry shortcut when unconfigured.
  */
-export declare function wireRegionFocus(node: HTMLElement): () => void;
+export declare const DEFAULT_TOAST_HOTKEY: readonly string[];
+/**
+ * Formats the hotkey for announcement since a toast never steals focus.
+ */
+export declare function formatHotkey(hotkey: readonly string[]): string;
+/**
+ * Wires keyboard traversal for the toast region. `hotkey` (F6 by default) moves
+ * focus to it from anywhere; Shift+hotkey restores prior focus. Restores when
+ * a toast is removed. Configurable to avoid collisions with app pane traversal.
+ */
+export declare function wireRegionFocus(node: HTMLElement, hotkey?: readonly string[]): () => void;

package/dist/toast/region-focus.js

@@ -1 +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};
+function e(e){let t=document.activeElement;for(;t;){if(e.contains(t))return!0;t=t.shadowRoot?.activeElement??null}return!1}var t=["F6"];function n(e){return e.join("+")}function o(n,o=t){let c=null;const s=()=>{const e=c;c=null,e?.isConnected&&e.focus()},r=e=>{const t=e.composedPath();if(t.includes(n))return;const o=t[0];o instanceof HTMLElement&&(c=o)},u=t=>{(function(e,t){const n=t[t.length-1];if(void 0===n||e.key!==n)return!1;const o=t.slice(0,-1).map(e=>e.toLowerCase());return o.includes("alt")===e.altKey&&o.includes("control")===e.ctrlKey&&o.includes("meta")===e.metaKey})(t,o)&&(t.preventDefault(),t.shiftKey?s():e(n)||n.focus())},i=t=>{t.relatedTarget||window.setTimeout(()=>{e(n)||s()},0)};return document.addEventListener("focusin",r),document.addEventListener("keydown",u),n.addEventListener("focusout",i),()=>{document.removeEventListener("focusin",r),document.removeEventListener("keydown",u),n.removeEventListener("focusout",i)}}export{t as DEFAULT_TOAST_HOTKEY,n as formatHotkey,o as wireRegionFocus};

package/dist/toast/toaster.cjs

@@ -1 +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;
+let a=require("vue");var x={info:"background",success:"background",loading:"background",warning:"foreground",error:"foreground"},w={info:"info",success:"success",loading:"neutral",warning:"warning",error:"danger"},g=5e3;function Y(c={}){const{max:r=3,placement:f="bottom-end",duration:u=g,label:v="Notifications"}=c,o=[],T=new Set;let S=[],b=0;function d(){S=o.slice(0,r);for(const n of T)n()}function p(n){return T.add(n),()=>{T.delete(n)}}function A(){return S}function _(n={}){const e=n.id??`skdx-toast-${++b}`,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,d(),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},d()}function E(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)}d()}function h(n,e,t={}){const i=_({...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:u,label:v,subscribe:p,getToasts:A,create:_,update:l,dismiss:E,promise:h}}function I(c){const r=(0,a.shallowRef)(c.getToasts());return(0,a.onScopeDispose)(c.subscribe(()=>{r.value=c.getToasts()})),r}function O(c){const r=(0,a.shallowRef)([]);return(0,a.watchEffect)(f=>{const u=c();r.value=u.getToasts(),f(u.subscribe(()=>{r.value=u.getToasts()}))}),r}exports.DEFAULT_TOAST_DURATION=g;exports.TOAST_POLITENESS_BY_TYPE=x;exports.TOAST_STATUS_BY_TYPE=w;exports.createToaster=Y;exports.useToaster=I;exports.useToasterRef=O;

package/dist/toast/toaster.d.cts

@@ -1,139 +1,119 @@
 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.
- */
+/** Toast region position (emitted as data-placement). */
 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.
+ * Politeness level for live-region announcement: error / warning are assertive,
+ * others polite. Only the politeness attribute changes; no role="alert" on root.
  */
-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.
+ * Type-to-status mapping for shared color vocabulary (error → danger,
+ * loading → neutral). data-status is read by _status.css for styling.
+ */
+export declare const TOAST_STATUS_BY_TYPE: Record<ToasterToastType, string>;
+/**
+ * Default auto-dismiss duration (WCAG 2.2.1): 5s minimum; pauses on hover,
+ * focus, or page hidden, so countdown runs only while message is readable.
  */
 export declare const DEFAULT_TOAST_DURATION = 5000;
-/** An actionable button rendered inside a queued toast (the "Undo" affordance). */
+/** Action button for a toast (e.g., "Undo"). */
 export interface ToasterToastAction {
     /** Visible button text. */
     label: string;
-    /** Describes the action for assistive tech users who can't easily reach it, per `SkdxToastAction`. */
+    /** Accessible name for assistive tech. */
     altText: string;
-    /** Runs on click. The toast closes either way. */
+    /** Callback; toast closes regardless. */
     onClick?: () => void;
 }
-/** What {@link ToasterStore.create} and {@link ToasterStore.update} accept. */
+/** Options for create and update methods. */
 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.
+     * Stable id for update / dismiss; re-creating replaces existing.
      * @default undefined — generated.
      */
     id?: string;
-    /** Heading text, rendered as `SkdxToastTitle`. @default undefined — no title. */
+    /** Rendered as SkdxToastTitle. @default undefined */
     title?: string;
-    /** Body text, rendered as `SkdxToastDescription`. @default undefined — no description. */
+    /** Rendered as SkdxToastDescription. @default undefined */
     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`.
+     * Auto-dismiss ms; Infinity persists.
+     * @default undefined — toaster's duration or Infinity for loading type.
      */
     duration?: number;
-    /** Optional action button. @default undefined — no action button. */
+    /** Optional action button. @default undefined */
     action?: ToasterToastAction;
-    /** Accessible name for the close button. @default 'Dismiss' */
+    /** Close button label. @default 'Dismiss' */
     closeLabel?: string;
 }
-/** One queued toast, as handed to the renderer. */
+/** Queued toast with id and revision. */
 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.
+     * Bumped on update; key on id:revision to remount for re-announcement
+     * and timer restart.
      */
     revision: number;
 }
-/** Options for {@link createToaster}. */
+/** Options for createToaster. */
 export interface ToasterOptions {
     /**
-     * How many toasts are visible at once; the rest wait in FIFO order and
-     * appear as visible ones are dismissed.
+     * Max visible at once; rest queue in FIFO order.
      * @default 3
      */
     max?: number;
-    /** Where the region sits, as `data-placement` on the viewport. @default 'bottom-end' */
+    /** Region position (data-placement). @default 'bottom-end' */
     placement?: ToastPlacement;
-    /** Default auto-dismiss duration (ms) for queued toasts. @default 5000 */
+    /** Default auto-dismiss ms. @default 5000 */
     duration?: number;
-    /** Accessible label for the toast region landmark. @default 'Notifications' */
+    /** Landmark label. @default 'Notifications' */
     label?: string;
 }
-/** Messages a {@link ToasterStore.promise} call swaps between as the promise settles. */
+/** Messages for promise tracking (loading → success or error). */
 export interface ToasterPromiseMessages<T> {
-    /** Shown immediately, as `type: 'loading'` (no auto-dismiss). */
+    /** Shown as loading (no auto-dismiss). */
     loading: ToasterToastOptions;
-    /** Shown on fulfilment, as `type: 'success'`. */
+    /** Shown on fulfilment as success. */
     success: ToasterToastOptions | ((value: T) => ToasterToastOptions);
-    /** Shown on rejection, as `type: 'error'`. The rejection is re-thrown either way. */
+    /** Shown on rejection as error; rejection is re-thrown. */
     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.
- */
+/** Imperative toast queue: create / dismiss from anywhere, render with SkdxToaster. */
 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 to queue changes; returns unsubscribe. */
     subscribe(listener: () => void): () => void;
-    /** The currently visible toasts (at most `max`) — a stable reference until the queue changes. */
+    /** Currently visible toasts (stable reference until change). */
     getToasts(): readonly ToasterToast[];
-    /** Queues a toast and returns its id. */
+    /** Queue a toast; returns its id. */
     create(options?: ToasterToastOptions): string;
-    /** Merges `options` into a queued toast, bumping its revision. No-ops for an unknown id. */
+    /** Merge options into queued toast (bumps revision). */
     update(id: string, options: ToasterToastOptions): void;
-    /** Removes one toast, or the whole queue when called with no id. */
+    /** Remove one toast or clear all. */
     dismiss(id?: string): void;
-    /** Shows a loading toast, then swaps it for success/error when `promise` settles. Re-throws rejections. */
+    /** Loading → success or error on promise settlement; 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.
+ * Create a queue (call once at module scope); render with one SkdxToaster.
  *
  * @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`.
+ * Subscribe to visible toasts as shallowRef (only needed for custom render).
  *
  * @example
  * ```ts
@@ -142,8 +122,6 @@ export declare function createToaster(options?: ToasterOptions): ToasterStore;
  */
 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.
+ * @internal Like useToaster but for a toaster that can change identity (prop).
  */
 export declare function useToasterRef(getToaster: () => ToasterStore): Ref<readonly ToasterToast[]>;