@yusufceng1z/ding 0.0.0-stage → 0.0.2

package/dist/index.d.cts

@@ -0,0 +1,164 @@
+type ToastType = 'success' | 'error' | 'warning' | 'info' | 'loading';
+/** enter: shape only · open: pill expanded · closing: text erased, pill shrinking · exit: shape leaves */
+type Phase = 'enter' | 'open' | 'closing' | 'exit';
+type Position = 'top-center' | 'top-left' | 'top-right' | 'bottom-center' | 'bottom-left' | 'bottom-right';
+type Theme = 'system' | 'light' | 'dark';
+interface ToastAction {
+    label: string;
+    /** Return a patch to morph this toast in place (e.g. Undo → "Restored"). Return nothing to dismiss it. */
+    onClick: () => void | ToastPatch;
+}
+interface ToastOptions {
+    id?: string;
+    description?: string;
+    action?: ToastAction;
+    /** Second button beside the action (e.g. Reply + Snooze). */
+    secondary?: ToastAction;
+    /** Small trailing text beside the title, e.g. a timestamp ("now", "2m"). */
+    meta?: string;
+    /** Avatar or thumbnail URL. Replaces the status icon with a round image. */
+    image?: string;
+    /** ms before auto-close. 0 = until dismissed. Default 5000; errors, actions and loading stay until dismissed. */
+    duration?: number;
+    /** 0–1. Draws a thin bar inside the pill. */
+    progress?: number;
+}
+interface ToastPatch {
+    title?: string;
+    description?: string;
+    type?: ToastType;
+    duration?: number;
+    /** 0–1, or null to remove the bar */
+    progress?: number | null;
+    /** null removes the action button */
+    action?: ToastAction | null;
+    secondary?: ToastAction | null;
+    /** null removes it */
+    meta?: string | null;
+    /** null returns to the status icon */
+    image?: string | null;
+}
+interface ToastItem {
+    id: string;
+    type: ToastType;
+    title: string;
+    description?: string;
+    phase: Phase;
+    /** ms until auto-close; 0 = stays until dismissed */
+    duration: number;
+    action?: ToastAction;
+    secondary?: ToastAction;
+    meta?: string;
+    image?: string;
+    progress?: number;
+    /** identical toasts fired again collapse into one with a counter */
+    count: number;
+}
+interface ToasterState {
+    toasts: ToastItem[];
+    position: Position;
+    theme: Theme;
+    /** text for the persistent polite live region (role=status) */
+    status: string;
+    /** text for the persistent assertive live region (role=alert) */
+    alert: string;
+}
+interface PromiseMessages<T> {
+    loading: string;
+    success: string | ((value: T) => string);
+    error: string | ((error: unknown) => string);
+}
+
+declare const TIMING: {
+    /** shape arrives, then the pill opens */
+    openDelay: number;
+    /** text erase + shrink back to shape */
+    closing: number;
+    /** shape leaves the screen */
+    exit: number;
+    duration: number;
+};
+declare function createToaster(): {
+    show: (type: ToastType, title: string, opts?: ToastOptions) => string;
+    success: (title: string, o?: ToastOptions) => string;
+    error: (title: string, o?: ToastOptions) => string;
+    warning: (title: string, o?: ToastOptions) => string;
+    info: (title: string, o?: ToastOptions) => string;
+    loading: (title: string, o?: ToastOptions) => string;
+    promise: <T>(p: Promise<T> | (() => Promise<T>), m: PromiseMessages<T>) => Promise<T>;
+    update: (callerId: string, p: ToastPatch) => void;
+    act: (id: string, which?: "action" | "secondary") => void;
+    dismiss: (id?: string, opts?: {
+        immediate?: boolean;
+    }) => void;
+    pause: (id?: string) => void;
+    resume: (id?: string) => void;
+    configure(c: {
+        position?: Position;
+        theme?: Theme;
+        sound?: boolean | ((type: ToastType) => void);
+        volume?: number;
+    }): void;
+    subscribe(fn: () => void): () => undefined;
+    getState: () => ToasterState;
+};
+type Toaster = ReturnType<typeof createToaster>;
+declare const toast: Toaster;
+
+interface SpringConfig {
+    stiffness?: number;
+    damping?: number;
+    mass?: number;
+}
+/**
+ * Bake a spring into a CSS `linear()` easing so the browser animates it
+ * (transitions/keyframes) with no per-frame JS.
+ */
+declare function springEasing(config?: SpringConfig): {
+    easing: string;
+    duration: number;
+};
+
+type Springs = {
+    enter: SpringConfig;
+    morph: SpringConfig;
+    stack: SpringConfig;
+};
+declare function getSprings(): {
+    enter: {
+        easing: string;
+        duration: number;
+    };
+    morph: {
+        easing: string;
+        duration: number;
+    };
+    stack: {
+        easing: string;
+        duration: number;
+    };
+};
+/** Retune springs live; affects toasts shown afterwards. */
+declare function setSprings(p: Partial<Springs>): void;
+declare function buildCss(): string;
+/** Idempotent; call from the adapter on the client. */
+declare function injectStyles(doc?: Document): void;
+
+/** Adapter hook-up: call with the `.tst-slot` element (its first child is the pill). Returns cleanup. */
+declare function bindToast(slot: HTMLElement, id: string, t?: Toaster): () => void;
+
+/** Shared keyboard handling for every adapter: Escape dismisses, Alt+T moves focus into the toast. */
+declare function onToastKey(e: KeyboardEvent): void;
+/** Framework-free renderer. Returns an unmount function. */
+declare function mountToaster(opts?: {
+    position?: Position;
+    theme?: Theme;
+}): () => void;
+
+/** Play the cue for a toast type. Silent for types without one, and wherever Web Audio is missing or still locked. */
+declare function chime(type: ToastType, volume?: number): void;
+
+declare const ICONS: Record<ToastType, string[]>;
+
+export { ICONS, TIMING, bindToast, buildCss, chime, createToaster, getSprings, injectStyles, mountToaster, onToastKey, setSprings, springEasing, toast };
+export type { Phase, Position, PromiseMessages, SpringConfig, Theme, ToastAction, ToastItem, ToastOptions, ToastPatch, ToastType, Toaster, ToasterState };

package/dist/index.d.ts

@@ -0,0 +1,164 @@
+type ToastType = 'success' | 'error' | 'warning' | 'info' | 'loading';
+/** enter: shape only · open: pill expanded · closing: text erased, pill shrinking · exit: shape leaves */
+type Phase = 'enter' | 'open' | 'closing' | 'exit';
+type Position = 'top-center' | 'top-left' | 'top-right' | 'bottom-center' | 'bottom-left' | 'bottom-right';
+type Theme = 'system' | 'light' | 'dark';
+interface ToastAction {
+    label: string;
+    /** Return a patch to morph this toast in place (e.g. Undo → "Restored"). Return nothing to dismiss it. */
+    onClick: () => void | ToastPatch;
+}
+interface ToastOptions {
+    id?: string;
+    description?: string;
+    action?: ToastAction;
+    /** Second button beside the action (e.g. Reply + Snooze). */
+    secondary?: ToastAction;
+    /** Small trailing text beside the title, e.g. a timestamp ("now", "2m"). */
+    meta?: string;
+    /** Avatar or thumbnail URL. Replaces the status icon with a round image. */
+    image?: string;
+    /** ms before auto-close. 0 = until dismissed. Default 5000; errors, actions and loading stay until dismissed. */
+    duration?: number;
+    /** 0–1. Draws a thin bar inside the pill. */
+    progress?: number;
+}
+interface ToastPatch {
+    title?: string;
+    description?: string;
+    type?: ToastType;
+    duration?: number;
+    /** 0–1, or null to remove the bar */
+    progress?: number | null;
+    /** null removes the action button */
+    action?: ToastAction | null;
+    secondary?: ToastAction | null;
+    /** null removes it */
+    meta?: string | null;
+    /** null returns to the status icon */
+    image?: string | null;
+}
+interface ToastItem {
+    id: string;
+    type: ToastType;
+    title: string;
+    description?: string;
+    phase: Phase;
+    /** ms until auto-close; 0 = stays until dismissed */
+    duration: number;
+    action?: ToastAction;
+    secondary?: ToastAction;
+    meta?: string;
+    image?: string;
+    progress?: number;
+    /** identical toasts fired again collapse into one with a counter */
+    count: number;
+}
+interface ToasterState {
+    toasts: ToastItem[];
+    position: Position;
+    theme: Theme;
+    /** text for the persistent polite live region (role=status) */
+    status: string;
+    /** text for the persistent assertive live region (role=alert) */
+    alert: string;
+}
+interface PromiseMessages<T> {
+    loading: string;
+    success: string | ((value: T) => string);
+    error: string | ((error: unknown) => string);
+}
+
+declare const TIMING: {
+    /** shape arrives, then the pill opens */
+    openDelay: number;
+    /** text erase + shrink back to shape */
+    closing: number;
+    /** shape leaves the screen */
+    exit: number;
+    duration: number;
+};
+declare function createToaster(): {
+    show: (type: ToastType, title: string, opts?: ToastOptions) => string;
+    success: (title: string, o?: ToastOptions) => string;
+    error: (title: string, o?: ToastOptions) => string;
+    warning: (title: string, o?: ToastOptions) => string;
+    info: (title: string, o?: ToastOptions) => string;
+    loading: (title: string, o?: ToastOptions) => string;
+    promise: <T>(p: Promise<T> | (() => Promise<T>), m: PromiseMessages<T>) => Promise<T>;
+    update: (callerId: string, p: ToastPatch) => void;
+    act: (id: string, which?: "action" | "secondary") => void;
+    dismiss: (id?: string, opts?: {
+        immediate?: boolean;
+    }) => void;
+    pause: (id?: string) => void;
+    resume: (id?: string) => void;
+    configure(c: {
+        position?: Position;
+        theme?: Theme;
+        sound?: boolean | ((type: ToastType) => void);
+        volume?: number;
+    }): void;
+    subscribe(fn: () => void): () => undefined;
+    getState: () => ToasterState;
+};
+type Toaster = ReturnType<typeof createToaster>;
+declare const toast: Toaster;
+
+interface SpringConfig {
+    stiffness?: number;
+    damping?: number;
+    mass?: number;
+}
+/**
+ * Bake a spring into a CSS `linear()` easing so the browser animates it
+ * (transitions/keyframes) with no per-frame JS.
+ */
+declare function springEasing(config?: SpringConfig): {
+    easing: string;
+    duration: number;
+};
+
+type Springs = {
+    enter: SpringConfig;
+    morph: SpringConfig;
+    stack: SpringConfig;
+};
+declare function getSprings(): {
+    enter: {
+        easing: string;
+        duration: number;
+    };
+    morph: {
+        easing: string;
+        duration: number;
+    };
+    stack: {
+        easing: string;
+        duration: number;
+    };
+};
+/** Retune springs live; affects toasts shown afterwards. */
+declare function setSprings(p: Partial<Springs>): void;
+declare function buildCss(): string;
+/** Idempotent; call from the adapter on the client. */
+declare function injectStyles(doc?: Document): void;
+
+/** Adapter hook-up: call with the `.tst-slot` element (its first child is the pill). Returns cleanup. */
+declare function bindToast(slot: HTMLElement, id: string, t?: Toaster): () => void;
+
+/** Shared keyboard handling for every adapter: Escape dismisses, Alt+T moves focus into the toast. */
+declare function onToastKey(e: KeyboardEvent): void;
+/** Framework-free renderer. Returns an unmount function. */
+declare function mountToaster(opts?: {
+    position?: Position;
+    theme?: Theme;
+}): () => void;
+
+/** Play the cue for a toast type. Silent for types without one, and wherever Web Audio is missing or still locked. */
+declare function chime(type: ToastType, volume?: number): void;
+
+declare const ICONS: Record<ToastType, string[]>;
+
+export { ICONS, TIMING, bindToast, buildCss, chime, createToaster, getSprings, injectStyles, mountToaster, onToastKey, setSprings, springEasing, toast };
+export type { Phase, Position, PromiseMessages, SpringConfig, Theme, ToastAction, ToastItem, ToastOptions, ToastPatch, ToastType, Toaster, ToasterState };