toastflow-core 0.0.3 → 1.0.0

package/package.json

@@ -2,7 +2,13 @@
   "name": "toastflow-core",
   "author": "adrianjanocko",
   "license": "MIT",
-  "version": "0.0.3",
+  "homepage": "https://toastflow.vercel.app/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adrianjanocko/toastflow.git",
+    "directory": "packages/core"
+  },
+  "version": "1.0.0",
   "main": "src/index.ts",
   "module": "src/index.ts",
   "types": "src/index.ts",

package/src/store.ts

@@ -673,27 +673,18 @@ function pickOverflowToast(
     return null;
   }
 
-  const [first, ...rest] = samePos;
+  const first = samePos[0];
   if (!first) {
     return null;
   }
 
   if (order === "newest") {
-    let oldest = first;
-    for (const t of rest) {
-      if (t.createdAt < oldest.createdAt) {
-        oldest = t;
-      }
-    }
-    return oldest;
-  }
-
-  let newest = first;
-  for (const t of rest) {
-    if (t.createdAt > newest.createdAt) {
-      newest = t;
-    }
+    return samePos.slice(1).reduce((oldest, toast) => {
+      return toast.createdAt < oldest.createdAt ? toast : oldest;
+    }, first);
   }
 
-  return newest;
+  return samePos.slice(1).reduce((newest, toast) => {
+    return toast.createdAt > newest.createdAt ? toast : newest;
+  }, first);
 }

package/dist/index.d.mts

@@ -1,270 +0,0 @@
-/**
- * Unique identifier assigned to each toast instance.
- */
-type ToastId = string;
-/**
- * Supported viewport anchors where toasts can stack.
- */
-type ToastPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
-/**
- * Order to display and evict toasts in a stack.
- */
-type ToastOrder = "newest" | "oldest";
-/**
- * Determines how the timer behaves after an interaction pause.
- */
-type PauseStrategy = "resume" | "reset";
-/**
- * Semantic type that controls the toast's appearance.
- */
-type ToastType = "loading" | "default" | "success" | "error" | "info" | "warning";
-/**
- * Internal lifecycle markers used for animations and cleanup.
- */
-type ToastPhase = "enter" | "leaving" | "clear-all";
-/**
- * Event kinds emitted to event subscribers.
- */
-type ToastEventKind = "duplicate" | "timer-reset" | "update";
-/**
- * Payload emitted whenever the store dispatches a toast event.
- */
-interface ToastEvent {
-    id: ToastId;
-    kind: ToastEventKind;
-}
-/**
- * Async work passed to the loading helper.
- */
-type ToastLoadingInput<T> = Promise<T> | (() => Promise<T>);
-/**
- * Text and rendering options for the loading helper phases.
- */
-interface ToastLoadingConfig<T> {
-    loading: ToastContentInput;
-    success: ToastLoadingRender<T>;
-    error: ToastLoadingRender<unknown>;
-}
-/**
- * CSS class names used to animate toasts.
- */
-interface ToastAnimation {
-    name: string;
-    bump: string;
-    clearAll: string;
-    update: string;
-}
-/**
- * Minimal context shared with lifecycle and click callbacks.
- */
-interface ToastContext {
-    id: ToastId;
-    position: ToastPosition;
-    type: ToastType;
-    title: string;
-    description: string;
-    createdAt: number;
-}
-/**
- * Global configuration that shapes how toasts look and behave.
- */
-interface ToastConfig {
-    /**
-     * Distance from the viewport edge where toasts start.
-     */
-    offset: string;
-    /**
-     * Gap between toasts stacked at the same position.
-     */
-    gap: string;
-    /**
-     * z-index applied to the toast container.
-     */
-    zIndex: number;
-    /**
-     * Fixed width applied to each toast.
-     */
-    width: string;
-    /**
-     * Time in milliseconds before a toast auto-dismisses.
-     * Use Infinity or 0 to keep it visible until manually dismissed.
-     */
-    duration: number;
-    /**
-     * Maximum number of visible toasts per position; extra items are evicted.
-     */
-    maxVisible: number;
-    /**
-     * Default stack position used when none is provided.
-     */
-    position: ToastPosition;
-    /**
-     * When true, skip showing identical toasts that are still visible.
-     */
-    preventDuplicates: boolean;
-    /**
-     * Controls whether new toasts appear before or after older ones.
-     */
-    order: ToastOrder;
-    /**
-     * When enabled, render a progress bar for finite durations.
-     */
-    progressBar: boolean;
-    /**
-     * Pause the timer while the toast is hovered.
-     */
-    pauseOnHover: boolean;
-    /**
-     * Whether resuming should continue the remaining time or restart it.
-     */
-    pauseStrategy: PauseStrategy;
-    /**
-     * CSS animation class overrides for various toast transitions.
-     */
-    animation: Partial<ToastAnimation>;
-    /**
-     * Show a close button inside each toast.
-     */
-    closeButton: boolean;
-    /**
-     * Allow closing a toast by clicking anywhere on it.
-     */
-    closeOnClick: boolean;
-    /**
-     * When true, title/description may contain HTML.
-     */
-    supportHtml: boolean;
-    /**
-     * Show the createdAt timestamp in the rendered toast.
-     */
-    showCreatedAt: boolean;
-    /**
-     * Format the createdAt timestamp when displayed.
-     */
-    createdAtFormatter: (createdAt: number) => string;
-    /**
-     * Called after the toast is added to state.
-     */
-    onMount?(ctx: ToastContext): void;
-    /**
-     * Called after the toast is removed from state.
-     */
-    onUnmount?(ctx: ToastContext): void;
-    /**
-     * Called when the toast is clicked.
-     */
-    onClick?(ctx: ToastContext, event: MouseEvent): void;
-    /**
-     * Called right before a toast starts leaving.
-     */
-    onClose?(ctx: ToastContext): void;
-}
-/**
- * Fully resolved options applied to a toast instance.
- */
-interface ToastOptions extends ToastConfig {
-    type: ToastType;
-    title: string;
-    description: string;
-}
-/**
- * Minimal text payload required to render a toast.
- */
-type ToastTextInput = {
-    title: string;
-    description?: string;
-} | {
-    title?: string;
-    description: string;
-};
-/**
- * Text payload with optional configuration overrides.
- */
-type ToastContentInput = ToastTextInput & Partial<Omit<ToastOptions, "type" | "title" | "description">>;
-/**
- * Payload required to create a toast.
- */
-type ToastShowInput = {
-    type: ToastType;
-} & ToastContentInput;
-/**
- * Allowed fields when updating an existing toast.
- */
-type ToastUpdateInput = ToastContentInput & Partial<Omit<ToastOptions, "title" | "description">>;
-/**
- * Render instructions for the loading helper's success/error states.
- */
-type ToastLoadingRender<T> = ToastContentInput | ((value: T) => ToastContentInput);
-/**
- * Promise returned from the loading helper that also exposes the toast id.
- */
-type ToastLoadingResult<T> = Promise<T> & {
-    toastId: ToastId;
-};
-/**
- * Concrete toast stored in state, including timing metadata.
- */
-interface ToastInstance extends ToastOptions {
-    id: ToastId;
-    createdAt: number;
-    phase?: ToastPhase;
-}
-/**
- * Shape of the store's current state.
- */
-interface ToastState {
-    toasts: ToastInstance[];
-}
-/**
- * Public API for interacting with the toast store.
- */
-interface ToastStore {
-    /**
-     * Return the current toast state snapshot.
-     */
-    getState(): ToastState;
-    /**
-     * Subscribe to state changes; immediately emits the current state.
-     */
-    subscribe(listener: (state: ToastState) => void): () => void;
-    /**
-     * Subscribe to one-off toast events such as duplicates or timer resets.
-     */
-    subscribeEvents(listener: (event: ToastEvent) => void): () => void;
-    /**
-     * Create and show a toast; returns its id.
-     */
-    show(options: ToastShowInput): ToastId;
-    /**
-     * Update an existing toast by id.
-     */
-    update(id: ToastId, options: ToastUpdateInput): void;
-    /**
-     * Dismiss a single toast by id.
-     */
-    dismiss(id: ToastId): void;
-    /**
-     * Dismiss all toasts at once.
-     */
-    dismissAll(): void;
-    /**
-     * Pause the auto-dismiss timer for a toast.
-     */
-    pause(id: ToastId): void;
-    /**
-     * Resume the auto-dismiss timer using the configured strategy.
-     */
-    resume(id: ToastId): void;
-    /**
-     * Return the resolved global configuration.
-     */
-    getConfig(): ToastConfig;
-    /**
-     * Wrap an async task with a loading toast that updates on completion.
-     */
-    loading<T>(input: ToastLoadingInput<T>, config: ToastLoadingConfig<T>): ToastLoadingResult<T>;
-}
-
-declare function createToastStore(globalConfig?: Partial<ToastConfig>): ToastStore;
-
-export { type PauseStrategy, type ToastAnimation, type ToastConfig, type ToastContentInput, type ToastContext, type ToastEvent, type ToastEventKind, type ToastId, type ToastInstance, type ToastLoadingConfig, type ToastLoadingInput, type ToastLoadingRender, type ToastLoadingResult, type ToastOptions, type ToastOrder, type ToastPhase, type ToastPosition, type ToastShowInput, type ToastState, type ToastStore, type ToastTextInput, type ToastType, type ToastUpdateInput, createToastStore };

package/dist/index.d.ts

@@ -1,270 +0,0 @@
-/**
- * Unique identifier assigned to each toast instance.
- */
-type ToastId = string;
-/**
- * Supported viewport anchors where toasts can stack.
- */
-type ToastPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
-/**
- * Order to display and evict toasts in a stack.
- */
-type ToastOrder = "newest" | "oldest";
-/**
- * Determines how the timer behaves after an interaction pause.
- */
-type PauseStrategy = "resume" | "reset";
-/**
- * Semantic type that controls the toast's appearance.
- */
-type ToastType = "loading" | "default" | "success" | "error" | "info" | "warning";
-/**
- * Internal lifecycle markers used for animations and cleanup.
- */
-type ToastPhase = "enter" | "leaving" | "clear-all";
-/**
- * Event kinds emitted to event subscribers.
- */
-type ToastEventKind = "duplicate" | "timer-reset" | "update";
-/**
- * Payload emitted whenever the store dispatches a toast event.
- */
-interface ToastEvent {
-    id: ToastId;
-    kind: ToastEventKind;
-}
-/**
- * Async work passed to the loading helper.
- */
-type ToastLoadingInput<T> = Promise<T> | (() => Promise<T>);
-/**
- * Text and rendering options for the loading helper phases.
- */
-interface ToastLoadingConfig<T> {
-    loading: ToastContentInput;
-    success: ToastLoadingRender<T>;
-    error: ToastLoadingRender<unknown>;
-}
-/**
- * CSS class names used to animate toasts.
- */
-interface ToastAnimation {
-    name: string;
-    bump: string;
-    clearAll: string;
-    update: string;
-}
-/**
- * Minimal context shared with lifecycle and click callbacks.
- */
-interface ToastContext {
-    id: ToastId;
-    position: ToastPosition;
-    type: ToastType;
-    title: string;
-    description: string;
-    createdAt: number;
-}
-/**
- * Global configuration that shapes how toasts look and behave.
- */
-interface ToastConfig {
-    /**
-     * Distance from the viewport edge where toasts start.
-     */
-    offset: string;
-    /**
-     * Gap between toasts stacked at the same position.
-     */
-    gap: string;
-    /**
-     * z-index applied to the toast container.
-     */
-    zIndex: number;
-    /**
-     * Fixed width applied to each toast.
-     */
-    width: string;
-    /**
-     * Time in milliseconds before a toast auto-dismisses.
-     * Use Infinity or 0 to keep it visible until manually dismissed.
-     */
-    duration: number;
-    /**
-     * Maximum number of visible toasts per position; extra items are evicted.
-     */
-    maxVisible: number;
-    /**
-     * Default stack position used when none is provided.
-     */
-    position: ToastPosition;
-    /**
-     * When true, skip showing identical toasts that are still visible.
-     */
-    preventDuplicates: boolean;
-    /**
-     * Controls whether new toasts appear before or after older ones.
-     */
-    order: ToastOrder;
-    /**
-     * When enabled, render a progress bar for finite durations.
-     */
-    progressBar: boolean;
-    /**
-     * Pause the timer while the toast is hovered.
-     */
-    pauseOnHover: boolean;
-    /**
-     * Whether resuming should continue the remaining time or restart it.
-     */
-    pauseStrategy: PauseStrategy;
-    /**
-     * CSS animation class overrides for various toast transitions.
-     */
-    animation: Partial<ToastAnimation>;
-    /**
-     * Show a close button inside each toast.
-     */
-    closeButton: boolean;
-    /**
-     * Allow closing a toast by clicking anywhere on it.
-     */
-    closeOnClick: boolean;
-    /**
-     * When true, title/description may contain HTML.
-     */
-    supportHtml: boolean;
-    /**
-     * Show the createdAt timestamp in the rendered toast.
-     */
-    showCreatedAt: boolean;
-    /**
-     * Format the createdAt timestamp when displayed.
-     */
-    createdAtFormatter: (createdAt: number) => string;
-    /**
-     * Called after the toast is added to state.
-     */
-    onMount?(ctx: ToastContext): void;
-    /**
-     * Called after the toast is removed from state.
-     */
-    onUnmount?(ctx: ToastContext): void;
-    /**
-     * Called when the toast is clicked.
-     */
-    onClick?(ctx: ToastContext, event: MouseEvent): void;
-    /**
-     * Called right before a toast starts leaving.
-     */
-    onClose?(ctx: ToastContext): void;
-}
-/**
- * Fully resolved options applied to a toast instance.
- */
-interface ToastOptions extends ToastConfig {
-    type: ToastType;
-    title: string;
-    description: string;
-}
-/**
- * Minimal text payload required to render a toast.
- */
-type ToastTextInput = {
-    title: string;
-    description?: string;
-} | {
-    title?: string;
-    description: string;
-};
-/**
- * Text payload with optional configuration overrides.
- */
-type ToastContentInput = ToastTextInput & Partial<Omit<ToastOptions, "type" | "title" | "description">>;
-/**
- * Payload required to create a toast.
- */
-type ToastShowInput = {
-    type: ToastType;
-} & ToastContentInput;
-/**
- * Allowed fields when updating an existing toast.
- */
-type ToastUpdateInput = ToastContentInput & Partial<Omit<ToastOptions, "title" | "description">>;
-/**
- * Render instructions for the loading helper's success/error states.
- */
-type ToastLoadingRender<T> = ToastContentInput | ((value: T) => ToastContentInput);
-/**
- * Promise returned from the loading helper that also exposes the toast id.
- */
-type ToastLoadingResult<T> = Promise<T> & {
-    toastId: ToastId;
-};
-/**
- * Concrete toast stored in state, including timing metadata.
- */
-interface ToastInstance extends ToastOptions {
-    id: ToastId;
-    createdAt: number;
-    phase?: ToastPhase;
-}
-/**
- * Shape of the store's current state.
- */
-interface ToastState {
-    toasts: ToastInstance[];
-}
-/**
- * Public API for interacting with the toast store.
- */
-interface ToastStore {
-    /**
-     * Return the current toast state snapshot.
-     */
-    getState(): ToastState;
-    /**
-     * Subscribe to state changes; immediately emits the current state.
-     */
-    subscribe(listener: (state: ToastState) => void): () => void;
-    /**
-     * Subscribe to one-off toast events such as duplicates or timer resets.
-     */
-    subscribeEvents(listener: (event: ToastEvent) => void): () => void;
-    /**
-     * Create and show a toast; returns its id.
-     */
-    show(options: ToastShowInput): ToastId;
-    /**
-     * Update an existing toast by id.
-     */
-    update(id: ToastId, options: ToastUpdateInput): void;
-    /**
-     * Dismiss a single toast by id.
-     */
-    dismiss(id: ToastId): void;
-    /**
-     * Dismiss all toasts at once.
-     */
-    dismissAll(): void;
-    /**
-     * Pause the auto-dismiss timer for a toast.
-     */
-    pause(id: ToastId): void;
-    /**
-     * Resume the auto-dismiss timer using the configured strategy.
-     */
-    resume(id: ToastId): void;
-    /**
-     * Return the resolved global configuration.
-     */
-    getConfig(): ToastConfig;
-    /**
-     * Wrap an async task with a loading toast that updates on completion.
-     */
-    loading<T>(input: ToastLoadingInput<T>, config: ToastLoadingConfig<T>): ToastLoadingResult<T>;
-}
-
-declare function createToastStore(globalConfig?: Partial<ToastConfig>): ToastStore;
-
-export { type PauseStrategy, type ToastAnimation, type ToastConfig, type ToastContentInput, type ToastContext, type ToastEvent, type ToastEventKind, type ToastId, type ToastInstance, type ToastLoadingConfig, type ToastLoadingInput, type ToastLoadingRender, type ToastLoadingResult, type ToastOptions, type ToastOrder, type ToastPhase, type ToastPosition, type ToastShowInput, type ToastState, type ToastStore, type ToastTextInput, type ToastType, type ToastUpdateInput, createToastStore };