varsel 0.1.1 → 0.2.0

package/dist/VarselManager.svelte

@@ -1,5 +1,11 @@
 <script lang="ts">
-import { onMount } from "svelte";
+/**
+ * @component
+ * @description
+ * Internal component responsible for grouping toasts by position and calculating
+ * their stacking offsets (both collapsed and expanded).
+ * It handles the "hover to expand" logic and manages the lifecycle of toast groups.
+ */
 import VarselItem from "./VarselItem.svelte";
 import {
 	ANIMATION_CONFIG,
@@ -8,9 +14,18 @@ import {
 	type ToastPosition,
 } from "./internals";
 
-export let toasts: ToastData[] = [];
-export let onRemove: (id: string) => void;
-export let expandedGap: number = ANIMATION_CONFIG.EXPANDED_GAP;
+let {
+	toasts = [],
+	onRemove,
+	expandedGap = ANIMATION_CONFIG.EXPANDED_GAP,
+}: {
+	/** The list of all active toasts from the global state. */
+	toasts?: ToastData[];
+	/** Callback to remove a toast from the state. */
+	onRemove: (id: string) => void;
+	/** The gap in pixels between toasts when expanded. */
+	expandedGap?: number;
+} = $props();
 
 const createPositionMap = <T>(value: () => T): Record<ToastPosition, T> => ({
 	"top-left": value(),
@@ -21,31 +36,38 @@ const createPositionMap = <T>(value: () => T): Record<ToastPosition, T> => ({
 	"bottom-right": value(),
 });
 
-let heights: Record<string, number> = {};
-let hovered: Record<ToastPosition, boolean> = createPositionMap(() => false);
-let heldToasts: Record<ToastPosition, Set<string>> = createPositionMap(
-	() => new Set<string>(),
+let heights = $state<Record<string, number>>({});
+let hovered = $state<Record<ToastPosition, boolean>>(
+	createPositionMap(() => false),
 );
+let heldToasts = $state<Record<ToastPosition, Set<string>>>(
+	createPositionMap(() => new Set<string>()),
+);
+
+// Non-reactive internal state for "previous" values (mimicking legacy behavior)
 let previousStackIndex: Record<string, number> = {};
 let previousCollapsedOffsets: Record<string, number> = {};
 let previousExpandedOffsets: Record<string, number> = {};
-let toastsByPosition: Record<ToastPosition, PositionedToast[]> =
-	createPositionMap<PositionedToast[]>(() => []);
-let positionEntries: [ToastPosition, PositionedToast[]][] = [];
-let collapsedOffsetData: {
+
+let toastsByPosition = $state<Record<ToastPosition, PositionedToast[]>>(
+	createPositionMap<PositionedToast[]>(() => []),
+);
+
+let collapsedOffsetData = $state<{
 	byPosition: Record<ToastPosition, number[]>;
 	byId: Record<string, number>;
-} = { byPosition: createPositionMap<number[]>(() => []), byId: {} };
-let expandedOffsetData: {
+}>({ byPosition: createPositionMap<number[]>(() => []), byId: {} });
+
+let expandedOffsetData = $state<{
 	byPosition: Record<ToastPosition, number[]>;
 	byId: Record<string, number>;
-} = { byPosition: createPositionMap<number[]>(() => []), byId: {} };
-
-let latestPositionEntries: [ToastPosition, PositionedToast[]][] = [];
-let latestHovered: Record<ToastPosition, boolean> = hovered;
+}>({ byPosition: createPositionMap<number[]>(() => []), byId: {} });
 
-$: latestPositionEntries = positionEntries;
-$: latestHovered = hovered;
+let positionEntries = $derived(
+	Object.entries(toastsByPosition) as [ToastPosition, PositionedToast[]][],
+);
+let latestPositionEntries = $derived(positionEntries);
+let latestHovered = $derived(hovered);
 
 const updateHoldState = (
 	position: ToastPosition,
@@ -64,7 +86,8 @@ const updateHoldState = (
 	}
 };
 
-$: {
+// Calculate toastsByPosition based on toasts
+$effect(() => {
 	const grouped = createPositionMap<ToastData[]>(() => []);
 	for (const toast of toasts) {
 		const pos = toast.position || "bottom-center";
@@ -104,9 +127,10 @@ $: {
 
 	previousStackIndex = nextStackIndices;
 	toastsByPosition = positioned;
-}
+});
 
-$: {
+// Update hovered state based on empty groups
+$effect(() => {
 	const next = { ...hovered };
 	let changed = false;
 	for (const pos of Object.keys(hovered) as ToastPosition[]) {
@@ -119,14 +143,10 @@ $: {
 	if (changed) {
 		hovered = next;
 	}
-}
-
-$: positionEntries = Object.entries(toastsByPosition) as [
-	ToastPosition,
-	PositionedToast[],
-][];
+});
 
-$: collapsedOffsetData = (() => {
+// Calculate collapsedOffsetData
+$effect(() => {
 	const byPosition = createPositionMap<number[]>(() => []);
 	const byId: Record<string, number> = {};
 
@@ -200,10 +220,11 @@ $: collapsedOffsetData = (() => {
 	}
 
 	previousCollapsedOffsets = byId;
-	return { byPosition, byId };
-})();
+	collapsedOffsetData = { byPosition, byId };
+});
 
-$: expandedOffsetData = (() => {
+// Calculate expandedOffsetData
+$effect(() => {
 	const byPosition = createPositionMap<number[]>(() => []);
 	const byId: Record<string, number> = {};
 
@@ -251,10 +272,10 @@ $: expandedOffsetData = (() => {
 	}
 
 	previousExpandedOffsets = byId;
-	return { byPosition, byId };
-})();
+	expandedOffsetData = { byPosition, byId };
+});
 
-onMount(() => {
+$effect(() => {
 	const handleMouseMove = (event: MouseEvent) => {
 		if (latestPositionEntries.length === 0) return;
 		const { clientX: x, clientY: y } = event;
@@ -384,4 +405,4 @@ const handleHeightChange = (id: string, height: number) => {
 			{/each}
 		{/each}
 	</div>
-{/if}
+{/if}

package/dist/VarselManager.svelte.d.ts

@@ -1,24 +1,13 @@
 import { type ToastData } from "./internals";
-interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
-    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
-        $$bindings?: Bindings;
-    } & Exports;
-    (internal: unknown, props: Props & {
-        $$events?: Events;
-        $$slots?: Slots;
-    }): Exports & {
-        $set?: any;
-        $on?: any;
-    };
-    z_$$bindings?: Bindings;
-}
-declare const VarselManager: $$__sveltets_2_IsomorphicComponent<{
+type $$ComponentProps = {
+    /** The list of all active toasts from the global state. */
     toasts?: ToastData[];
+    /** Callback to remove a toast from the state. */
     onRemove: (id: string) => void;
+    /** The gap in pixels between toasts when expanded. */
     expandedGap?: number;
-}, {
-    [evt: string]: CustomEvent<any>;
-}, {}, {}, string>;
-type VarselManager = InstanceType<typeof VarselManager>;
+};
+declare const VarselManager: import("svelte").Component<$$ComponentProps, {}, "">;
+type VarselManager = ReturnType<typeof VarselManager>;
 export default VarselManager;
 //# sourceMappingURL=VarselManager.svelte.d.ts.map

package/dist/VarselManager.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VarselManager.svelte.d.ts","sourceRoot":"","sources":["../src/lib/VarselManager.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,EAGN,KAAK,SAAS,EAEd,MAAM,aAAa,CAAC;AAwXrB,UAAU,kCAAkC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,MAAM;IACpM,KAAK,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;IACjK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAC,GAAG,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IAC9G,YAAY,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAKD,QAAA,MAAM,aAAa;aAV2E,SAAS,EAAE;cAAY,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI;kBAAgB,MAAM;;;kBAU7D,CAAC;AACjF,KAAK,aAAa,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,eAAe,aAAa,CAAC"}
+{"version":3,"file":"VarselManager.svelte.d.ts","sourceRoot":"","sources":["../src/lib/VarselManager.svelte.ts"],"names":[],"mappings":"AAWA,OAAO,EAGN,KAAK,SAAS,EAEd,MAAM,aAAa,CAAC;AAEpB,KAAK,gBAAgB,GAAI;IACzB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,iDAAiD;IACjD,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA8XF,QAAA,MAAM,aAAa,sDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/VarselToaster.svelte

@@ -1,4 +1,7 @@
-<script lang="ts" context="module">
+<script lang="ts" module>
+/**
+ * Main module exports for the Varsel library.
+ */
 export {
 	toast,
 	type ToastData,
@@ -8,7 +11,15 @@ export {
 </script>
 
 <script lang="ts">
-	import { onMount } from 'svelte';
+	/**
+	 * @component
+	 * @description
+	 * The root component for the Varsel notification system.
+	 * It subscribes to the global toast state and renders the `VarselManager`
+	 * which handles the positioning and layout of individual toasts.
+	 *
+	 * Place this component once in your application's root layout (e.g., `+layout.svelte`).
+	 */
 	import VarselManager from './VarselManager.svelte';
 	import {
 		toastState,
@@ -16,16 +27,22 @@ export {
 		type ToastData,
 	} from './internals';
 
-	export let expandedGap: number | undefined = undefined;
+	let { expandedGap = undefined }: { 
+		/**
+		 * The gap (in pixels) between expanded toasts when hovering over the stack.
+		 * If undefined, uses the default value from animation config.
+		 */
+		expandedGap?: number 
+	} = $props();
 
-	let toasts: ToastData[] = [];
+	let toasts = $state<ToastData[]>([]);
 	const instanceId = toasterInstanceManager.registerInstance();
 
 	const handleRemove = (id: string) => {
 		toastState.remove(id);
 	};
 
-	onMount(() => {
+	$effect(() => {
 		toasts = toastState.getToasts();
 		const unsubscribe = toastState.subscribe((value) => {
 			toasts = value;

package/dist/VarselToaster.svelte.d.ts

@@ -1,22 +1,15 @@
+/**
+ * Main module exports for the Varsel library.
+ */
 export { toast, type ToastData, type ToastInvoker, type ToastPosition, } from "./internals";
-interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
-    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
-        $$bindings?: Bindings;
-    } & Exports;
-    (internal: unknown, props: Props & {
-        $$events?: Events;
-        $$slots?: Slots;
-    }): Exports & {
-        $set?: any;
-        $on?: any;
-    };
-    z_$$bindings?: Bindings;
-}
-declare const VarselToaster: $$__sveltets_2_IsomorphicComponent<{
-    expandedGap?: number | undefined;
-}, {
-    [evt: string]: CustomEvent<any>;
-}, {}, {}, string>;
-type VarselToaster = InstanceType<typeof VarselToaster>;
+type $$ComponentProps = {
+    /**
+     * The gap (in pixels) between expanded toasts when hovering over the stack.
+     * If undefined, uses the default value from animation config.
+     */
+    expandedGap?: number;
+};
+declare const VarselToaster: import("svelte").Component<$$ComponentProps, {}, "">;
+type VarselToaster = ReturnType<typeof VarselToaster>;
 export default VarselToaster;
 //# sourceMappingURL=VarselToaster.svelte.d.ts.map

package/dist/VarselToaster.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VarselToaster.svelte.d.ts","sourceRoot":"","sources":["../src/lib/VarselToaster.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,KAAK,EACL,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,aAAa,GAClB,MAAM,aAAa,CAAC;AAiDrB,UAAU,kCAAkC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,MAAM;IACpM,KAAK,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;IACjK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAC,GAAG,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IAC9G,YAAY,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAKD,QAAA,MAAM,aAAa;kBAV0C,MAAM,GAAG,SAAS;;;kBAUmB,CAAC;AACjF,KAAK,aAAa,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,eAAe,aAAa,CAAC"}
+{"version":3,"file":"VarselToaster.svelte.d.ts","sourceRoot":"","sources":["../src/lib/VarselToaster.svelte.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,OAAO,EACN,KAAK,EACL,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,aAAa,GAClB,MAAM,aAAa,CAAC;AAmBpB,KAAK,gBAAgB,GAAI;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB,CAAC;AAuCH,QAAA,MAAM,aAAa,sDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/core/accessibility.d.ts

@@ -1,2 +1,6 @@
+/**
+ * CSS selectors used to identify focusable elements within a toast.
+ * Used for managing keyboard focus when interacting with toasts containing actions.
+ */
 export declare const FOCUSABLE_SELECTORS: string;
 //# sourceMappingURL=accessibility.d.ts.map

package/dist/core/accessibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/lib/core/accessibility.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,QAOpB,CAAC"}
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/lib/core/accessibility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAOpB,CAAC"}

package/dist/core/accessibility.js

@@ -1,3 +1,7 @@
+/**
+ * CSS selectors used to identify focusable elements within a toast.
+ * Used for managing keyboard focus when interacting with toasts containing actions.
+ */
 export const FOCUSABLE_SELECTORS = [
     "button:not([disabled])",
     "input:not([disabled])",

package/dist/core/animations.d.ts

@@ -1,14 +1,29 @@
+/**
+ * Global configuration constants for toast animations and stacking behavior.
+ * These values control timing, spacing, scaling, and easing of toast transitions.
+ */
 export declare const ANIMATION_CONFIG: {
+    /** Duration of the entry animation in seconds. */
     readonly ENTER_DURATION: 0.75;
+    /** Duration of the exit animation in seconds. */
     readonly EXIT_DURATION: 0.75;
+    /** Duration of the stack reorganization animation in seconds. */
     readonly STACK_DURATION: 0.75;
+    /** Vertical offset (in pixels) between stacked toasts in collapsed state. */
     readonly STACK_OFFSET: 16;
+    /** Vertical gap (in pixels) between toasts in expanded (hover) state. */
     readonly EXPANDED_GAP: 12;
+    /** Scale reduction factor for each subsequent toast in the stack. */
     readonly SCALE_FACTOR: 0.04;
+    /** Minimum scale value for the furthest toast in the stack. */
     readonly MIN_SCALE: 0.92;
+    /** Maximum number of toasts visible in the stack at once. */
     readonly MAX_VISIBLE_TOASTS: 3;
+    /** Base z-index for the toast layer. */
     readonly Z_INDEX_BASE: 50;
+    /** Default cubic-bezier easing function for animations. */
     readonly EASING_DEFAULT: "var(--ease-vs-toast)";
+    /** Easing function for exit animations. */
     readonly EASING_EXIT: "var(--ease-vs-toast)";
 };
 //# sourceMappingURL=animations.d.ts.map

package/dist/core/animations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animations.d.ts","sourceRoot":"","sources":["../../src/lib/core/animations.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;CAYnB,CAAC"}
+{"version":3,"file":"animations.d.ts","sourceRoot":"","sources":["../../src/lib/core/animations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC5B,kDAAkD;;IAElD,iDAAiD;;IAEjD,iEAAiE;;IAEjE,6EAA6E;;IAE7E,yEAAyE;;IAEzE,qEAAqE;;IAErE,+DAA+D;;IAE/D,6DAA6D;;IAE7D,wCAAwC;;IAExC,2DAA2D;;IAE3D,2CAA2C;;CAElC,CAAC"}

package/dist/core/animations.js

@@ -1,13 +1,28 @@
+/**
+ * Global configuration constants for toast animations and stacking behavior.
+ * These values control timing, spacing, scaling, and easing of toast transitions.
+ */
 export const ANIMATION_CONFIG = {
+    /** Duration of the entry animation in seconds. */
     ENTER_DURATION: 0.75,
+    /** Duration of the exit animation in seconds. */
     EXIT_DURATION: 0.75,
+    /** Duration of the stack reorganization animation in seconds. */
     STACK_DURATION: 0.75,
+    /** Vertical offset (in pixels) between stacked toasts in collapsed state. */
     STACK_OFFSET: 16,
+    /** Vertical gap (in pixels) between toasts in expanded (hover) state. */
     EXPANDED_GAP: 12,
+    /** Scale reduction factor for each subsequent toast in the stack. */
     SCALE_FACTOR: 0.04,
+    /** Minimum scale value for the furthest toast in the stack. */
     MIN_SCALE: 0.92,
+    /** Maximum number of toasts visible in the stack at once. */
     MAX_VISIBLE_TOASTS: 3,
+    /** Base z-index for the toast layer. */
     Z_INDEX_BASE: 50,
+    /** Default cubic-bezier easing function for animations. */
     EASING_DEFAULT: "var(--ease-vs-toast)",
+    /** Easing function for exit animations. */
     EASING_EXIT: "var(--ease-vs-toast)",
 };

package/dist/core/positions.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Configuration for initial animation states based on toast position.
+ * Defines the starting transform values (x, y) for entering and exiting toasts.
+ */
 export declare const POSITION_CONFIGS: {
     readonly "top-left": {
         readonly animateIn: {
@@ -60,5 +64,8 @@ export declare const POSITION_CONFIGS: {
         };
     };
 };
+/**
+ * Available positions for the toaster on the screen.
+ */
 export type ToastPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
 //# sourceMappingURL=positions.d.ts.map

package/dist/core/positions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"positions.d.ts","sourceRoot":"","sources":["../../src/lib/core/positions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyBnB,CAAC;AAEX,MAAM,MAAM,aAAa,GACtB,UAAU,GACV,YAAY,GACZ,WAAW,GACX,aAAa,GACb,eAAe,GACf,cAAc,CAAC"}
+{"version":3,"file":"positions.d.ts","sourceRoot":"","sources":["../../src/lib/core/positions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyBnB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,aAAa,GACtB,UAAU,GACV,YAAY,GACZ,WAAW,GACX,aAAa,GACb,eAAe,GACf,cAAc,CAAC"}

package/dist/core/positions.js

@@ -1,3 +1,7 @@
+/**
+ * Configuration for initial animation states based on toast position.
+ * Defines the starting transform values (x, y) for entering and exiting toasts.
+ */
 export const POSITION_CONFIGS = {
     "top-left": {
         animateIn: { x: -100, y: -20 },

package/dist/core/swipe.d.ts

@@ -1,8 +1,20 @@
 import type { ToastPosition } from "./positions";
+/** Directions in which a toast can be swiped to dismiss. */
 export type SwipeDirection = "top" | "bottom" | "left" | "right";
+/** Axes along which swipe gestures are tracked. */
 export type SwipeAxis = "x" | "y";
+/** Minimum pixel distance required to trigger a swipe dismissal. */
 export declare const SWIPE_DISMISS_THRESHOLD = 45;
+/** Minimum velocity (pixels/ms) required to trigger a swipe dismissal. */
 export declare const SWIPE_DISMISS_VELOCITY = 0.11;
+/** Distance in pixels to move the toast during the exit animation after a swipe. */
 export declare const SWIPE_EXIT_DISTANCE = 600;
+/**
+ * Determines the allowed swipe directions based on the toast's position.
+ * For example, a "top-right" toast can be swiped "top" or "right".
+ *
+ * @param position - The toast's position on screen.
+ * @returns An array of allowed swipe directions.
+ */
 export declare const getDefaultSwipeDirections: (position?: ToastPosition | null) => SwipeDirection[];
 //# sourceMappingURL=swipe.d.ts.map

package/dist/core/swipe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"swipe.d.ts","sourceRoot":"","sources":["../../src/lib/core/swipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AACjE,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,CAAC;AAElC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,eAAO,MAAM,yBAAyB,GACrC,WAAW,aAAa,GAAG,IAAI,KAC7B,cAAc,EAwBhB,CAAC"}
+{"version":3,"file":"swipe.d.ts","sourceRoot":"","sources":["../../src/lib/core/swipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AACjE,mDAAmD;AACnD,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,CAAC;AAElC,oEAAoE;AACpE,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACrC,WAAW,aAAa,GAAG,IAAI,KAC7B,cAAc,EAwBhB,CAAC"}

package/dist/core/swipe.js

@@ -1,6 +1,16 @@
+/** Minimum pixel distance required to trigger a swipe dismissal. */
 export const SWIPE_DISMISS_THRESHOLD = 45;
+/** Minimum velocity (pixels/ms) required to trigger a swipe dismissal. */
 export const SWIPE_DISMISS_VELOCITY = 0.11;
+/** Distance in pixels to move the toast during the exit animation after a swipe. */
 export const SWIPE_EXIT_DISTANCE = 600;
+/**
+ * Determines the allowed swipe directions based on the toast's position.
+ * For example, a "top-right" toast can be swiped "top" or "right".
+ *
+ * @param position - The toast's position on screen.
+ * @returns An array of allowed swipe directions.
+ */
 export const getDefaultSwipeDirections = (position) => {
     if (!position) {
         return ["top", "bottom", "left", "right"];

package/dist/core/toast-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast-factory.d.ts","sourceRoot":"","sources":["../../src/lib/core/toast-factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGX,YAAY,EAEZ,MAAM,SAAS,CAAC;AAkGjB,eAAO,MAAM,KAAK,cAAc,CAAC"}
+{"version":3,"file":"toast-factory.d.ts","sourceRoot":"","sources":["../../src/lib/core/toast-factory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGX,YAAY,EAEZ,MAAM,SAAS,CAAC;AAoIjB,eAAO,MAAM,KAAK,cAAc,CAAC"}

package/dist/core/toast-factory.js

@@ -1,35 +1,67 @@
+/**
+ * Factory module for creating and managing toast notifications.
+ * Provides the main `toast` function and its variants (success, error, promise).
+ */
 import { toastState } from "./toast-state";
+/**
+ * Helper to normalize string input into a ToastData object.
+ */
 const normalizeToastData = (data) => {
     if (typeof data === "string") {
         return { description: data };
     }
     return data;
 };
+/**
+ * Resolves the state of a promise-based toast (success or error) into actual toast data.
+ */
 const resolvePromiseState = async (value, state) => {
     const resolved = typeof state === "function" ? await state(value) : await state;
     return normalizeToastData(resolved);
 };
+/**
+ * The main entry point for creating toasts.
+ * @param data - Toast configuration object or description string.
+ * @returns The ID of the created toast.
+ */
 const createToast = ((data) => {
     return toastState.add(normalizeToastData(data));
 });
+/**
+ * Creates a success variant toast.
+ */
 createToast.success = (data) => {
     if (typeof data === "string") {
         return toastState.add({ description: data, variant: "success" });
     }
     return toastState.add({ ...data, variant: "success" });
 };
+/**
+ * Creates a warning variant toast.
+ */
 createToast.warning = (data) => {
     if (typeof data === "string") {
         return toastState.add({ description: data, variant: "warning" });
     }
     return toastState.add({ ...data, variant: "warning" });
 };
+/**
+ * Creates an error (destructive) variant toast.
+ */
 createToast.error = (data) => {
     if (typeof data === "string") {
         return toastState.add({ description: data, variant: "destructive" });
     }
     return toastState.add({ ...data, variant: "destructive" });
 };
+/**
+ * Creates a toast that tracks a promise's lifecycle.
+ * Updates automatically from loading -> success/error.
+ *
+ * @param promise - The promise to observe.
+ * @param options - Configuration for loading, success, and error states.
+ * @returns The ID of the toast.
+ */
 createToast.promise = (promise, options) => {
     const loadingData = normalizeToastData(options.loading);
     const toastId = toastState.add({
@@ -58,9 +90,15 @@ createToast.promise = (promise, options) => {
     });
     return toastId;
 };
+/**
+ * Dismisses a toast by ID.
+ */
 createToast.dismiss = (id) => {
     toastState.update(id, { shouldClose: true });
 };
+/**
+ * Dismisses all active toasts.
+ */
 createToast.dismissAll = () => {
     toastState.dismissAll();
 };

package/dist/core/toast-state.d.ts

@@ -1,17 +1,49 @@
 import type { ToastData, ToastSubscriber } from "./types";
+/**
+ * Manages the global state of toast notifications.
+ * Implements a singleton pattern with a subscription mechanism.
+ */
 declare class ToastState {
     private toasts;
     private subscribers;
     private idCounter;
+    /**
+     * Subscribes to changes in the toast list.
+     * @param callback - Function to be called when the toast list updates.
+     * @returns A cleanup function to unsubscribe.
+     */
     subscribe(callback: ToastSubscriber): () => void;
     private notify;
     private generateId;
+    /**
+     * Adds a new toast to the state.
+     * @param data - The toast configuration (without ID).
+     * @returns The generated ID of the new toast.
+     */
     add(data: Omit<ToastData, "id">): string;
+    /**
+     * Removes a toast from the state by its ID.
+     * @param id - The ID of the toast to remove.
+     */
     remove(id: string): void;
+    /**
+     * Updates an existing toast's data.
+     * @param id - The ID of the toast to update.
+     * @param data - Partial data to merge into the existing toast.
+     */
     update(id: string, data: Partial<ToastData>): void;
+    /**
+     * Marks all active toasts for dismissal.
+     * Triggers the closing animation by setting `shouldClose` to true.
+     */
     dismissAll(): void;
+    /**
+     * Returns the current list of active toasts.
+     * @returns A copy of the toast array.
+     */
     getToasts(): ToastData[];
 }
+/** Global singleton instance of the toast state. */
 export declare const toastState: ToastState;
 export { ToastState };
 //# sourceMappingURL=toast-state.d.ts.map

package/dist/core/toast-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast-state.d.ts","sourceRoot":"","sources":["../../src/lib/core/toast-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1D,cAAM,UAAU;IACf,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,SAAS,CAAK;IAEtB,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAOhD,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,UAAU;IAIlB,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,MAAM;IAQxC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;IAOlD,UAAU,IAAI,IAAI;IASlB,SAAS,IAAI,SAAS,EAAE;CAGxB;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"toast-state.d.ts","sourceRoot":"","sources":["../../src/lib/core/toast-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1D;;;GAGG;AACH,cAAM,UAAU;IACf,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,SAAS,CAAK;IAEtB;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAOhD,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,MAAM;IASxC;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;IAOlD;;;OAGG;IACH,UAAU,IAAI,IAAI;IASlB;;;OAGG;IACH,SAAS,IAAI,SAAS,EAAE;CAGxB;AAED,oDAAoD;AACpD,eAAO,MAAM,UAAU,YAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,CAAC"}