varsel 0.1.1 → 0.2.0

package/dist/core/toast-state.js

@@ -1,7 +1,16 @@
+/**
+ * Manages the global state of toast notifications.
+ * Implements a singleton pattern with a subscription mechanism.
+ */
 class ToastState {
     toasts = [];
     subscribers = new Set();
     idCounter = 0;
+    /**
+     * 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) {
         this.subscribers.add(callback);
         return () => {
@@ -16,21 +25,40 @@ class ToastState {
     generateId() {
         return `toast-${Date.now()}-${++this.idCounter}`;
     }
+    /**
+     * Adds a new toast to the state.
+     * @param data - The toast configuration (without ID).
+     * @returns The generated ID of the new toast.
+     */
     add(data) {
         const id = this.generateId();
         const newToast = { ...data, id };
+        // Add new toasts to the beginning of the array (stack LIFO visually for some positions, logic handled in manager)
         this.toasts = [newToast, ...this.toasts];
         this.notify();
         return id;
     }
+    /**
+     * Removes a toast from the state by its ID.
+     * @param id - The ID of the toast to remove.
+     */
     remove(id) {
         this.toasts = this.toasts.filter((toast) => toast.id !== id);
         this.notify();
     }
+    /**
+     * 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, data) {
         this.toasts = this.toasts.map((toast) => toast.id === id ? { ...toast, ...data } : toast);
         this.notify();
     }
+    /**
+     * Marks all active toasts for dismissal.
+     * Triggers the closing animation by setting `shouldClose` to true.
+     */
     dismissAll() {
         this.toasts = this.toasts.map((toast) => ({
             ...toast,
@@ -39,9 +67,14 @@ class ToastState {
         }));
         this.notify();
     }
+    /**
+     * Returns the current list of active toasts.
+     * @returns A copy of the toast array.
+     */
     getToasts() {
         return [...this.toasts];
     }
 }
+/** Global singleton instance of the toast state. */
 export const toastState = new ToastState();
 export { ToastState };

package/dist/core/toaster-instances.d.ts

@@ -1,8 +1,25 @@
+/**
+ * Manages unique instances of the Toaster component to prevent conflicts.
+ * Ensures that if multiple Toasters are rendered, only one (the first or primary) is active.
+ */
 declare class ToasterInstanceManager {
     private activeInstanceId;
     private instanceCounter;
+    /**
+     * Registers a new toaster instance.
+     * @returns A unique instance ID.
+     */
     registerInstance(): string;
+    /**
+     * Unregisters an instance, potentially freeing up the active slot.
+     * @param instanceId - The ID of the instance to unregister.
+     */
     unregisterInstance(instanceId: string): void;
+    /**
+     * Checks if the given instance is the currently active one.
+     * @param instanceId - The ID to check.
+     * @returns True if active, false otherwise.
+     */
     isActiveInstance(instanceId: string): boolean;
 }
 export declare const toasterInstanceManager: ToasterInstanceManager;

package/dist/core/toaster-instances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toaster-instances.d.ts","sourceRoot":"","sources":["../../src/lib/core/toaster-instances.ts"],"names":[],"mappings":"AAAA,cAAM,sBAAsB;IAC3B,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,eAAe,CAAK;IAE5B,gBAAgB,IAAI,MAAM;IAQ1B,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAM5C,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;CAG7C;AAED,eAAO,MAAM,sBAAsB,wBAA+B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"toaster-instances.d.ts","sourceRoot":"","sources":["../../src/lib/core/toaster-instances.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAM,sBAAsB;IAC3B,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,eAAe,CAAK;IAE5B;;;OAGG;IACH,gBAAgB,IAAI,MAAM;IAQ1B;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAM5C;;;;OAIG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;CAG7C;AAED,eAAO,MAAM,sBAAsB,wBAA+B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/core/toaster-instances.js

@@ -1,6 +1,14 @@
+/**
+ * Manages unique instances of the Toaster component to prevent conflicts.
+ * Ensures that if multiple Toasters are rendered, only one (the first or primary) is active.
+ */
 class ToasterInstanceManager {
     activeInstanceId = null;
     instanceCounter = 0;
+    /**
+     * Registers a new toaster instance.
+     * @returns A unique instance ID.
+     */
     registerInstance() {
         const instanceId = `toaster-${++this.instanceCounter}`;
         if (!this.activeInstanceId) {
@@ -8,11 +16,20 @@ class ToasterInstanceManager {
         }
         return instanceId;
     }
+    /**
+     * Unregisters an instance, potentially freeing up the active slot.
+     * @param instanceId - The ID of the instance to unregister.
+     */
     unregisterInstance(instanceId) {
         if (this.activeInstanceId === instanceId) {
             this.activeInstanceId = null;
         }
     }
+    /**
+     * Checks if the given instance is the currently active one.
+     * @param instanceId - The ID to check.
+     * @returns True if active, false otherwise.
+     */
     isActiveInstance(instanceId) {
         return this.activeInstanceId === instanceId;
     }

package/dist/core/types.d.ts

@@ -2,43 +2,112 @@ import type { VariantProps } from "class-variance-authority";
 import type { toastContainerVariants } from "./variants";
 import type { ToastPosition } from "./positions";
 import type { SwipeAxis, SwipeDirection } from "./swipe";
+/**
+ * Represents the data structure for a single toast notification.
+ */
 export interface ToastData extends VariantProps<typeof toastContainerVariants> {
+    /** Unique identifier for the toast. */
     id: string;
+    /** The main title of the toast notification. */
     title?: string;
+    /** Additional details or description displayed below the title. */
     description?: string;
+    /** Optional CSS class to apply to the toast container. */
     className?: string;
+    /**
+     * Duration in milliseconds before the toast automatically closes.
+     * Defaults to 5000ms. Set to `Infinity` to keep open indefinitely.
+     */
     duration?: number;
+    /** Whether the toast is in a loading state. */
     isLoading?: boolean;
+    /** Whether to show the close button. Defaults to `true`. */
     showClose?: boolean;
+    /** Optional action button to display within the toast. */
     action?: {
+        /** Label for the action button. */
         label: string;
+        /** Callback function executed when the action button is clicked. */
         onClick: () => void;
     };
+    /** Callback function executed when the toast is closed. */
     onClose?: () => void;
+    /** Internal flag: signals that the toast should begin its closing animation. */
     shouldClose?: boolean;
+    /** Internal flag: signals that the toast is currently leaving the DOM. */
     isLeaving?: boolean;
+    /** The position on the screen where this toast should appear. */
     position?: ToastPosition;
 }
+/**
+ * Represents the possible states for a promise-based toast.
+ * Can be a static message string, a ToastData object (minus ID), or a function returning one of those.
+ */
 export type PromiseToastState<Value> = string | Omit<ToastData, "id"> | ((value: Value) => string | Omit<ToastData, "id"> | PromiseLike<string | Omit<ToastData, "id">>);
+/**
+ * Options for the `toast.promise` function.
+ */
 export type ToastPromiseOptions<SuccessValue = unknown, ErrorValue = unknown> = {
+    /** The message or data to show while the promise is pending. */
     loading: Omit<ToastData, "id"> | string;
+    /** The message or data to show when the promise resolves successfully. */
     success: PromiseToastState<SuccessValue>;
+    /** The message or data to show when the promise rejects. */
     error: PromiseToastState<ErrorValue>;
 };
+/**
+ * The interface for the main `toast` function and its utility methods.
+ */
 export type ToastInvoker = {
+    /**
+     * Creates a default toast notification.
+     * @param data - The toast options or description string.
+     * @returns The ID of the created toast.
+     */
     (data: Omit<ToastData, "id"> | string): string;
+    /**
+     * Creates a success toast notification.
+     */
     success: (data: Omit<ToastData, "id" | "variant"> | string) => string;
+    /**
+     * Creates a warning toast notification.
+     */
     warning: (data: Omit<ToastData, "id" | "variant"> | string) => string;
+    /**
+     * Creates an error toast notification.
+     */
     error: (data: Omit<ToastData, "id" | "variant"> | string) => string;
+    /**
+     * Creates a toast that updates based on the state of a Promise.
+     * @param promise - The promise to track.
+     * @param options - Configuration for loading, success, and error states.
+     * @returns The ID of the toast.
+     */
     promise: <T, E = unknown>(promise: PromiseLike<T>, options: ToastPromiseOptions<T, E>) => string;
+    /**
+     * Dismisses a specific toast by its ID.
+     * @param id - The ID of the toast to dismiss.
+     */
     dismiss: (id: string) => void;
+    /**
+     * Dismisses all currently active toasts.
+     */
     dismissAll: () => void;
 };
+/**
+ * Extends `ToastData` with positioning information for rendering.
+ */
 export type PositionedToast = ToastData & {
+    /** The visual index of the toast in the stack. */
     index: number;
+    /** The render order index (z-index calculation base). */
     renderIndex: number;
+    /** Total number of toasts in the current group. */
     total: number;
 };
+/**
+ * Context provided to toast items (mostly for internal use).
+ */
 export interface VarselItemContext {
     toast: PositionedToast;
     onRemove: (id: string) => void;
@@ -50,6 +119,7 @@ export interface VarselItemContext {
     onHeightChange?: (id: string, height: number) => void;
     onGroupHoverEnter?: () => void;
 }
+/** Function signature for toast state subscribers. */
 export type ToastSubscriber = (toasts: ToastData[]) => void;
 export type { ToastPosition, SwipeAxis, SwipeDirection };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/core/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/utils.d.ts

@@ -1,2 +1,10 @@
+/**
+ * Utility function to conditionally join class names.
+ * A lightweight alternative to libraries like `clsx` or `classnames`,
+ * tailored for this project's needs.
+ *
+ * @param values - A list of class names or conditional expressions.
+ * @returns A single string of valid class names joined by spaces.
+ */
 export declare const cn: (...values: Array<string | false | undefined | null>) => string;
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/core/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE,GAAI,GAAG,QAAQ,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC,WACrC,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/core/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,EAAE,GAAI,GAAG,QAAQ,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC,WACrC,CAAC"}

package/dist/core/utils.js

@@ -1 +1,9 @@
+/**
+ * Utility function to conditionally join class names.
+ * A lightweight alternative to libraries like `clsx` or `classnames`,
+ * tailored for this project's needs.
+ *
+ * @param values - A list of class names or conditional expressions.
+ * @returns A single string of valid class names joined by spaces.
+ */
 export const cn = (...values) => values.filter(Boolean).join(" ");

package/dist/core/variants.d.ts

@@ -1,7 +1,17 @@
+/**
+ * CVA definition for the main toast container element.
+ * Handles positioning logic (absolute/fixed positioning coordinates)
+ * and base theming (colors based on variant).
+ */
 export declare const toastContainerVariants: (props?: ({
     position?: "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right" | null | undefined;
     variant?: "default" | "success" | "warning" | "destructive" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * CVA definition for the inner content wrapper of the toast.
+ * Useful for applying styles specific to the content area (e.g. overflow, padding overrides)
+ * separate from the structural container.
+ */
 export declare const toastContentVariants: (props?: ({
     variant?: "default" | "success" | "warning" | "destructive" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;

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

@@ -1 +1 @@
-{"version":3,"file":"variants.d.ts","sourceRoot":"","sources":["../../src/lib/core/variants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB;;;8EA0BlC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;8EAY/B,CAAC"}
+{"version":3,"file":"variants.d.ts","sourceRoot":"","sources":["../../src/lib/core/variants.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;8EAgClC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;8EAY/B,CAAC"}

package/dist/core/variants.js

@@ -1,6 +1,14 @@
 import { cva } from "class-variance-authority";
+/**
+ * CVA definition for the main toast container element.
+ * Handles positioning logic (absolute/fixed positioning coordinates)
+ * and base theming (colors based on variant).
+ */
 export const toastContainerVariants = cva("pointer-events-auto fixed rounded-vs-lg border shadow-vs-toast will-change-transform border-vs-border bg-vs-popover", {
     variants: {
+        /**
+         * Determines where the toast is anchored on the screen.
+         */
         position: {
             "top-left": "top-4 left-4 w-full max-w-sm",
             "top-center": "top-4 left-1/2 w-full max-w-sm -translate-x-1/2 transform",
@@ -9,6 +17,9 @@ export const toastContainerVariants = cva("pointer-events-auto fixed rounded-vs-
             "bottom-center": "bottom-4 left-1/2 w-full max-w-sm -translate-x-1/2 transform",
             "bottom-right": "right-4 bottom-4 w-full max-w-sm",
         },
+        /**
+         * Semantic variant of the toast affecting text colors.
+         */
         variant: {
             default: "text-vs-foreground",
             success: "text-vs-success/90",
@@ -21,6 +32,11 @@ export const toastContainerVariants = cva("pointer-events-auto fixed rounded-vs-
         variant: "default",
     },
 });
+/**
+ * CVA definition for the inner content wrapper of the toast.
+ * Useful for applying styles specific to the content area (e.g. overflow, padding overrides)
+ * separate from the structural container.
+ */
 export const toastContentVariants = cva("relative overflow-hidden rounded-vs-lg", {
     variants: {
         variant: {

package/dist/index.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Public API of the Varsel library.
+ * Exports the main components, functions, and types required to use the library.
+ *
+ * @module varsel
+ */
 export { default as VarselToaster } from "./VarselToaster.svelte";
 export { toast } from "./internals";
 export type { ToastData, ToastInvoker, ToastPosition, SwipeAxis, SwipeDirection, PositionedToast, VarselItemContext, ToastPromiseOptions, } from "./internals";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,YAAY,EACX,SAAS,EACT,YAAY,EACZ,aAAa,EACb,SAAS,EACT,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,YAAY,EACX,SAAS,EACT,YAAY,EACZ,aAAa,EACb,SAAS,EACT,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,2 +1,8 @@
+/**
+ * Public API of the Varsel library.
+ * Exports the main components, functions, and types required to use the library.
+ *
+ * @module varsel
+ */
 export { default as VarselToaster } from "./VarselToaster.svelte";
 export { toast } from "./internals";

package/dist/internals.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Internal aggregation module.
+ * Re-exports core functionality to simplify imports within the library.
+ * This file is meant for internal package usage and shouldn't generally be imported directly by consumers.
+ */
 export { ANIMATION_CONFIG } from "./core/animations";
 export { FOCUSABLE_SELECTORS } from "./core/accessibility";
 export { POSITION_CONFIGS, type ToastPosition } from "./core/positions";

package/dist/internals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internals.d.ts","sourceRoot":"","sources":["../src/lib/internals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACN,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,SAAS,EACd,KAAK,cAAc,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,sBAAsB,EACtB,oBAAoB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EACX,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,iBAAiB,GACjB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"internals.d.ts","sourceRoot":"","sources":["../src/lib/internals.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACN,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,SAAS,EACd,KAAK,cAAc,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,sBAAsB,EACtB,oBAAoB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EACX,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,iBAAiB,GACjB,MAAM,cAAc,CAAC"}

package/dist/internals.js

@@ -1,3 +1,8 @@
+/**
+ * Internal aggregation module.
+ * Re-exports core functionality to simplify imports within the library.
+ * This file is meant for internal package usage and shouldn't generally be imported directly by consumers.
+ */
 export { ANIMATION_CONFIG } from "./core/animations";
 export { FOCUSABLE_SELECTORS } from "./core/accessibility";
 export { POSITION_CONFIGS } from "./core/positions";