@opentui-ui/toast 0.0.1

package/dist/icons-DXx_5j_z.mjs

@@ -0,0 +1,181 @@
+//#region src/types.ts
+/**
+* Check if a value is a SpinnerConfig object
+*/
+function isSpinnerConfig(value) {
+	return typeof value === "object" && value !== null && "frames" in value && "interval" in value && Array.isArray(value.frames);
+}
+/**
+* Check if an action object is a valid Action
+*/
+function isAction(action) {
+	return typeof action === "object" && action !== null && "label" in action && "onClick" in action;
+}
+
+//#endregion
+//#region src/icons.ts
+/**
+* Default spinner configuration for loading toasts
+*
+* Uses a circular animation pattern. Override this by providing
+* a custom `loading` value in the `icons` option.
+*
+* @example
+* ```ts
+* // Use a different spinner pattern
+* const toaster = new ToasterRenderable(ctx, {
+*   icons: {
+*     ...DEFAULT_ICONS,
+*     loading: {
+*       frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],
+*       interval: 80,
+*     },
+*   },
+* });
+* ```
+*/
+const DEFAULT_SPINNER = {
+	frames: [
+		"◜",
+		"◠",
+		"◝",
+		"◞",
+		"◡",
+		"◟"
+	],
+	interval: 100
+};
+/**
+* Default Unicode icons for toast notifications
+*
+* These work in most modern terminals. Use these as the base
+* and override specific icons as needed.
+*
+* @example
+* ```ts
+* import { DEFAULT_ICONS, ToasterRenderable } from '@opentui-ui/toast';
+*
+* // Use defaults with a custom success icon
+* const toaster = new ToasterRenderable(ctx, {
+*   icons: { ...DEFAULT_ICONS, success: '++' },
+* });
+* ```
+*/
+const DEFAULT_ICONS = {
+	success: "✓",
+	error: "✗",
+	warning: "!",
+	info: "ℹ",
+	loading: DEFAULT_SPINNER,
+	close: "×"
+};
+/**
+* ASCII-only icons for terminals with limited Unicode support
+*
+* Use these when targeting older terminals or environments
+* where Unicode characters may not render correctly.
+*
+* @example
+* ```ts
+* import { ASCII_ICONS, ToasterRenderable } from '@opentui-ui/toast';
+*
+* const toaster = new ToasterRenderable(ctx, {
+*   icons: ASCII_ICONS,
+* });
+* ```
+*/
+const ASCII_ICONS = {
+	success: "[/]",
+	error: "[x]",
+	warning: "[!]",
+	info: "[i]",
+	loading: "...",
+	close: "x"
+};
+/**
+* Minimal icons using simple single characters
+*
+* Perfect for clean, unobtrusive toast notifications.
+* Pairs well with the `minimal` theme.
+*
+* @example
+* ```ts
+* import { MINIMAL_ICONS, ToasterRenderable } from '@opentui-ui/toast';
+* import { minimal } from '@opentui-ui/toast/themes';
+*
+* const toaster = new ToasterRenderable(ctx, {
+*   ...minimal,
+*   icons: MINIMAL_ICONS,
+* });
+* ```
+*/
+const MINIMAL_ICONS = {
+	success: "*",
+	error: "!",
+	warning: "!",
+	info: "i",
+	loading: "~",
+	close: "x"
+};
+/**
+* Emoji icons for terminals with good emoji support
+*
+* Note: Emoji rendering varies across terminals. Test in your
+* target environment before using in production.
+*
+* @example
+* ```ts
+* import { EMOJI_ICONS, ToasterRenderable } from '@opentui-ui/toast';
+*
+* const toaster = new ToasterRenderable(ctx, {
+*   icons: EMOJI_ICONS,
+* });
+* ```
+*/
+const EMOJI_ICONS = {
+	success: "✅",
+	error: "❌",
+	warning: "⚠️",
+	info: "ℹ️",
+	loading: "⏳",
+	close: "✖️"
+};
+/**
+* Get the icon string for a specific toast type
+*
+* For loading type, returns the first frame if it's a SpinnerConfig,
+* or the static string otherwise.
+*
+* @internal - Used by ToastRenderable, not part of public API
+*/
+function getTypeIcon(type, icons) {
+	switch (type) {
+		case "success": return icons.success;
+		case "error": return icons.error;
+		case "warning": return icons.warning;
+		case "info": return icons.info;
+		case "loading": return getLoadingIcon(icons.loading);
+		default: return "";
+	}
+}
+/**
+* Get the initial loading icon (first frame if spinner, or static string)
+*
+* @internal
+*/
+function getLoadingIcon(loading) {
+	if (isSpinnerConfig(loading)) return loading.frames[0] ?? "◌";
+	return loading;
+}
+/**
+* Get the spinner config if loading is animated, or null if static
+*
+* @internal
+*/
+function getSpinnerConfig(loading) {
+	return isSpinnerConfig(loading) ? loading : null;
+}
+
+//#endregion
+export { MINIMAL_ICONS as a, getTypeIcon as c, EMOJI_ICONS as i, isAction as l, DEFAULT_ICONS as n, getLoadingIcon as o, DEFAULT_SPINNER as r, getSpinnerConfig as s, ASCII_ICONS as t, isSpinnerConfig as u };
+//# sourceMappingURL=icons-DXx_5j_z.mjs.map

package/dist/icons-DXx_5j_z.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons-DXx_5j_z.mjs","names":["DEFAULT_SPINNER: SpinnerConfig","DEFAULT_ICONS: ToastIcons","ASCII_ICONS: ToastIcons","MINIMAL_ICONS: ToastIcons","EMOJI_ICONS: ToastIcons"],"sources":["../src/types.ts","../src/icons.ts"],"sourcesContent":["import type { BorderCharacters, BorderSides, BorderStyle } from \"@opentui/core\";\n\n/**\n * Toast notification types\n */\nexport type ToastType =\n  | \"default\"\n  | \"success\"\n  | \"error\"\n  | \"warning\"\n  | \"info\"\n  | \"loading\";\n\n/**\n * Position options for the toaster\n */\nexport type Position =\n  | \"top-left\"\n  | \"top-center\"\n  | \"top-right\"\n  | \"bottom-left\"\n  | \"bottom-center\"\n  | \"bottom-right\";\n\n/**\n * Stacking mode for multiple toasts\n */\nexport type StackingMode = \"single\" | \"stack\";\n\n/**\n * Action button configuration\n */\nexport interface Action {\n  label: string;\n  onClick: () => void;\n}\n\n/**\n * Terminal-specific toast styling options\n *\n * These map to terminal box rendering properties and provide\n * intuitive shorthands for common patterns.\n */\nexport interface ToastStyle {\n  /**\n   * Border configuration\n   * - `true` = full border (all sides)\n   * - `false` = no border\n   * - `[\"left\", \"right\"]` = specific sides only\n   */\n  border?: boolean | BorderSides[];\n\n  /**\n   * Border color (hex, rgb, or named color)\n   */\n  borderColor?: string;\n\n  /**\n   * Border style for terminal rendering\n   * @default 'single'\n   */\n  borderStyle?: BorderStyle;\n\n  /**\n   * Custom border characters for full control over border rendering\n   *\n   * When provided, this overrides the borderStyle setting.\n   * Use this to create unique border styles with custom characters.\n   */\n  customBorderChars?: BorderCharacters;\n\n  /**\n   * Minimum height in terminal rows\n   */\n  minHeight?: number;\n\n  /**\n   * Maximum width in terminal columns\n   */\n  maxWidth?: number;\n\n  /**\n   * Minimum width in terminal columns\n   */\n  minWidth?: number;\n\n  /**\n   * Uniform padding (all sides)\n   */\n  padding?: number;\n\n  /**\n   * Horizontal padding (left + right)\n   */\n  paddingX?: number;\n\n  /**\n   * Vertical padding (top + bottom)\n   */\n  paddingY?: number;\n\n  /**\n   * Top padding\n   */\n  paddingTop?: number;\n\n  /**\n   * Bottom padding\n   */\n  paddingBottom?: number;\n\n  /**\n   * Left padding\n   */\n  paddingLeft?: number;\n\n  /**\n   * Right padding\n   */\n  paddingRight?: number;\n\n  /**\n   * Background color (hex, rgb, or named color)\n   */\n  backgroundColor?: string;\n\n  /**\n   * Text/foreground color (hex, rgb, or named color)\n   */\n  foregroundColor?: string;\n\n  /**\n   * Muted text color (for descriptions)\n   */\n  mutedColor?: string;\n\n  /**\n   * Icon color override (defaults to borderColor)\n   */\n  iconColor?: string;\n}\n\n/**\n * Per-type toast options\n *\n * Each type can override style and duration.\n */\nexport interface TypeToastOptions {\n  /** Style overrides for this toast type */\n  style?: Partial<ToastStyle>;\n  /** Duration override for this toast type */\n  duration?: number;\n}\n\n/**\n * Default options for all toasts, with per-type overrides\n *\n * Similar to react-hot-toast's toastOptions API:\n * @example\n * ```ts\n * toastOptions={{\n *   style: { backgroundColor: '#1a1a1a' },\n *   duration: 5000,\n *   success: {\n *     style: { borderColor: '#22c55e' },\n *     duration: 3000,\n *   },\n *   error: {\n *     style: { borderColor: '#ef4444' },\n *   },\n * }}\n * ```\n */\nexport interface ToastOptions {\n  /** Base styles applied to all toasts */\n  style?: ToastStyle;\n  /** Default duration for all toasts (ms) */\n  duration?: number;\n  /** Options for default toasts */\n  default?: TypeToastOptions;\n  /** Options for success toasts */\n  success?: TypeToastOptions;\n  /** Options for error toasts */\n  error?: TypeToastOptions;\n  /** Options for warning toasts */\n  warning?: TypeToastOptions;\n  /** Options for info toasts */\n  info?: TypeToastOptions;\n  /** Options for loading toasts */\n  loading?: TypeToastOptions;\n}\n\n/**\n * Internal toast representation\n */\nexport interface Toast {\n  id: string | number;\n  type: ToastType;\n  title?: string | (() => string);\n  description?: string | (() => string);\n  duration?: number;\n  dismissible?: boolean;\n  icon?: string;\n  action?: Action;\n  onDismiss?: (toast: Toast) => void;\n  onAutoClose?: (toast: Toast) => void;\n  closeButton?: boolean;\n  /**\n   * Per-toast style overrides (highest priority)\n   */\n  style?: Partial<ToastStyle>;\n}\n\n/**\n * Toast to be dismissed\n */\nexport interface ToastToDismiss {\n  id: string | number;\n  dismiss: boolean;\n}\n\n/**\n * External toast options (user-facing API)\n *\n * This is the options object passed to `toast()`, `toast.success()`, etc.\n */\nexport interface ExternalToast\n  extends Partial<Omit<Toast, \"id\" | \"type\" | \"title\" | \"promise\">> {\n  id?: string | number;\n}\n\n/**\n * Promise type for toast.promise()\n */\nexport type PromiseT<Data = unknown> = Promise<Data> | (() => Promise<Data>);\n\n/**\n * Extended result type for promise toasts\n */\nexport interface PromiseExtendedResult extends ExternalToast {\n  message: string;\n}\n\n/**\n * Promise result - can be a string or extended object\n */\nexport type PromiseTResult<Data = unknown> =\n  | string\n  | ((data: Data) => string | Promise<string>);\n\n/**\n * Promise toast configuration\n */\nexport interface PromiseData<ToastData = unknown> {\n  loading?: string;\n  success?:\n    | PromiseTResult<ToastData>\n    | PromiseExtendedResult\n    | ((\n        data: ToastData,\n      ) => PromiseExtendedResult | Promise<PromiseExtendedResult>);\n  error?:\n    | PromiseTResult\n    | PromiseExtendedResult\n    | ((\n        error: unknown,\n      ) => PromiseExtendedResult | Promise<PromiseExtendedResult>);\n  description?: PromiseTResult<ToastData>;\n  finally?: () => void | Promise<void>;\n}\n\n/**\n * Spinner configuration for animated loading icons\n *\n * @example\n * ```ts\n * // Dots spinner\n * { frames: [\"⠋\", \"⠙\", \"⠹\", \"⠸\", \"⠼\", \"⠴\", \"⠦\", \"⠧\", \"⠇\", \"⠏\"], interval: 80 }\n *\n * // Simple spinner\n * { frames: [\"-\", \"\\\\\", \"|\", \"/\"], interval: 100 }\n * ```\n */\nexport interface SpinnerConfig {\n  /** Array of frames to cycle through */\n  frames: string[];\n  /** Interval between frames in milliseconds */\n  interval: number;\n}\n\n/**\n * Check if a value is a SpinnerConfig object\n */\nexport function isSpinnerConfig(\n  value: string | SpinnerConfig,\n): value is SpinnerConfig {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"frames\" in value &&\n    \"interval\" in value &&\n    Array.isArray(value.frames)\n  );\n}\n\n/**\n * Icon configuration\n */\nexport interface ToastIcons {\n  success: string;\n  error: string;\n  warning: string;\n  info: string;\n  /**\n   * Loading icon - can be a static string or an animated spinner config\n   *\n   * @example\n   * ```ts\n   * // Static icon\n   * loading: \"◌\"\n   *\n   * // Animated spinner\n   * loading: {\n   *   frames: [\"◜\", \"◠\", \"◝\", \"◞\", \"◡\", \"◟\"],\n   *   interval: 100,\n   * }\n   * ```\n   */\n  loading: string | SpinnerConfig;\n  close: string;\n}\n\n/**\n * Offset configuration for toaster positioning\n */\nexport interface ToasterOffset {\n  top?: number;\n  right?: number;\n  bottom?: number;\n  left?: number;\n}\n\n/**\n * Toaster component options\n */\nexport interface ToasterOptions {\n  /**\n   * Position of the toaster on screen\n   * @default 'bottom-right'\n   */\n  position?: Position;\n\n  /**\n   * Gap between toasts in terminal rows\n   * @default 1\n   */\n  gap?: number;\n\n  /**\n   * Maximum number of visible toasts in stack mode\n   * @default 3\n   */\n  visibleToasts?: number;\n\n  /**\n   * Show close button on toasts\n   * @default false\n   */\n  closeButton?: boolean;\n\n  /**\n   * Offset from screen edges\n   */\n  offset?: ToasterOffset;\n\n  /**\n   * Custom icons, or `false` to disable icons entirely\n   *\n   * @example\n   * ```ts\n   * // Custom icons\n   * icons: { success: \"✓\", error: \"✗\" }\n   *\n   * // Disable icons\n   * icons: false\n   * ```\n   */\n  icons?: Partial<ToastIcons> | false;\n\n  /**\n   * How to handle multiple toasts\n   * @default 'single'\n   */\n  stackingMode?: StackingMode;\n\n  /**\n   * Maximum width for toasts\n   * @default 60\n   */\n  maxWidth?: number;\n\n  /**\n   * Default options for toasts (styles, duration, per-type overrides)\n   *\n   * @example\n   * ```ts\n   * toastOptions: {\n   *   style: { backgroundColor: '#1a1a1a' },\n   *   duration: 5000,\n   *   success: {\n   *     style: { borderColor: '#22c55e' },\n   *     duration: 3000,\n   *   },\n   * }\n   * ```\n   */\n  toastOptions?: ToastOptions;\n}\n\n/**\n * Check if an action object is a valid Action\n */\nexport function isAction(action: Action | unknown): action is Action {\n  return (\n    typeof action === \"object\" &&\n    action !== null &&\n    \"label\" in action &&\n    \"onClick\" in action\n  );\n}\n","import type { SpinnerConfig, ToastIcons, ToastType } from \"./types\";\nimport { isSpinnerConfig } from \"./types\";\n\n/**\n * Default spinner configuration for loading toasts\n *\n * Uses a circular animation pattern. Override this by providing\n * a custom `loading` value in the `icons` option.\n *\n * @example\n * ```ts\n * // Use a different spinner pattern\n * const toaster = new ToasterRenderable(ctx, {\n *   icons: {\n *     ...DEFAULT_ICONS,\n *     loading: {\n *       frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],\n *       interval: 80,\n *     },\n *   },\n * });\n * ```\n */\nexport const DEFAULT_SPINNER: SpinnerConfig = {\n  frames: [\"◜\", \"◠\", \"◝\", \"◞\", \"◡\", \"◟\"],\n  interval: 100,\n};\n\n/**\n * Default Unicode icons for toast notifications\n *\n * These work in most modern terminals. Use these as the base\n * and override specific icons as needed.\n *\n * @example\n * ```ts\n * import { DEFAULT_ICONS, ToasterRenderable } from '@opentui-ui/toast';\n *\n * // Use defaults with a custom success icon\n * const toaster = new ToasterRenderable(ctx, {\n *   icons: { ...DEFAULT_ICONS, success: '++' },\n * });\n * ```\n */\nexport const DEFAULT_ICONS: ToastIcons = {\n  success: \"\\u2713\", // checkmark\n  error: \"\\u2717\", // X mark\n  warning: \"\\u0021\", // exclamation mark\n  info: \"\\u2139\", // information\n  loading: DEFAULT_SPINNER,\n  close: \"\\u00D7\", // multiplication sign (x)\n};\n\n/**\n * ASCII-only icons for terminals with limited Unicode support\n *\n * Use these when targeting older terminals or environments\n * where Unicode characters may not render correctly.\n *\n * @example\n * ```ts\n * import { ASCII_ICONS, ToasterRenderable } from '@opentui-ui/toast';\n *\n * const toaster = new ToasterRenderable(ctx, {\n *   icons: ASCII_ICONS,\n * });\n * ```\n */\nexport const ASCII_ICONS: ToastIcons = {\n  success: \"[/]\",\n  error: \"[x]\",\n  warning: \"[!]\",\n  info: \"[i]\",\n  loading: \"...\",\n  close: \"x\",\n};\n\n/**\n * Minimal icons using simple single characters\n *\n * Perfect for clean, unobtrusive toast notifications.\n * Pairs well with the `minimal` theme.\n *\n * @example\n * ```ts\n * import { MINIMAL_ICONS, ToasterRenderable } from '@opentui-ui/toast';\n * import { minimal } from '@opentui-ui/toast/themes';\n *\n * const toaster = new ToasterRenderable(ctx, {\n *   ...minimal,\n *   icons: MINIMAL_ICONS,\n * });\n * ```\n */\nexport const MINIMAL_ICONS: ToastIcons = {\n  success: \"*\",\n  error: \"!\",\n  warning: \"!\",\n  info: \"i\",\n  loading: \"~\",\n  close: \"x\",\n};\n\n/**\n * Emoji icons for terminals with good emoji support\n *\n * Note: Emoji rendering varies across terminals. Test in your\n * target environment before using in production.\n *\n * @example\n * ```ts\n * import { EMOJI_ICONS, ToasterRenderable } from '@opentui-ui/toast';\n *\n * const toaster = new ToasterRenderable(ctx, {\n *   icons: EMOJI_ICONS,\n * });\n * ```\n */\nexport const EMOJI_ICONS: ToastIcons = {\n  success: \"\\u2705\", // green checkmark\n  error: \"\\u274C\", // red X\n  warning: \"\\u26A0\\uFE0F\", // warning with variation selector\n  info: \"\\u2139\\uFE0F\", // info with variation selector\n  loading: \"\\u23F3\", // hourglass\n  close: \"\\u2716\\uFE0F\", // heavy multiplication X\n};\n\n/**\n * Get the icon string for a specific toast type\n *\n * For loading type, returns the first frame if it's a SpinnerConfig,\n * or the static string otherwise.\n *\n * @internal - Used by ToastRenderable, not part of public API\n */\nexport function getTypeIcon(type: ToastType, icons: ToastIcons): string {\n  switch (type) {\n    case \"success\":\n      return icons.success;\n    case \"error\":\n      return icons.error;\n    case \"warning\":\n      return icons.warning;\n    case \"info\":\n      return icons.info;\n    case \"loading\":\n      return getLoadingIcon(icons.loading);\n    default:\n      return \"\";\n  }\n}\n\n/**\n * Get the initial loading icon (first frame if spinner, or static string)\n *\n * @internal\n */\nexport function getLoadingIcon(loading: string | SpinnerConfig): string {\n  if (isSpinnerConfig(loading)) {\n    return loading.frames[0] ?? \"\\u25CC\"; // dotted circle (fallback when spinner unavailable)\n  }\n  return loading;\n}\n\n/**\n * Get the spinner config if loading is animated, or null if static\n *\n * @internal\n */\nexport function getSpinnerConfig(\n  loading: string | SpinnerConfig,\n): SpinnerConfig | null {\n  return isSpinnerConfig(loading) ? loading : null;\n}\n"],"mappings":";;;;AAqSA,SAAgB,gBACd,OACwB;AACxB,QACE,OAAO,UAAU,YACjB,UAAU,QACV,YAAY,SACZ,cAAc,SACd,MAAM,QAAQ,MAAM,OAAO;;;;;AAyH/B,SAAgB,SAAS,QAA4C;AACnE,QACE,OAAO,WAAW,YAClB,WAAW,QACX,WAAW,UACX,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;ACpZjB,MAAaA,kBAAiC;CAC5C,QAAQ;EAAC;EAAK;EAAK;EAAK;EAAK;EAAK;EAAI;CACtC,UAAU;CACX;;;;;;;;;;;;;;;;;AAkBD,MAAaC,gBAA4B;CACvC,SAAS;CACT,OAAO;CACP,SAAS;CACT,MAAM;CACN,SAAS;CACT,OAAO;CACR;;;;;;;;;;;;;;;;AAiBD,MAAaC,cAA0B;CACrC,SAAS;CACT,OAAO;CACP,SAAS;CACT,MAAM;CACN,SAAS;CACT,OAAO;CACR;;;;;;;;;;;;;;;;;;AAmBD,MAAaC,gBAA4B;CACvC,SAAS;CACT,OAAO;CACP,SAAS;CACT,MAAM;CACN,SAAS;CACT,OAAO;CACR;;;;;;;;;;;;;;;;AAiBD,MAAaC,cAA0B;CACrC,SAAS;CACT,OAAO;CACP,SAAS;CACT,MAAM;CACN,SAAS;CACT,OAAO;CACR;;;;;;;;;AAUD,SAAgB,YAAY,MAAiB,OAA2B;AACtE,SAAQ,MAAR;EACE,KAAK,UACH,QAAO,MAAM;EACf,KAAK,QACH,QAAO,MAAM;EACf,KAAK,UACH,QAAO,MAAM;EACf,KAAK,OACH,QAAO,MAAM;EACf,KAAK,UACH,QAAO,eAAe,MAAM,QAAQ;EACtC,QACE,QAAO;;;;;;;;AASb,SAAgB,eAAe,SAAyC;AACtE,KAAI,gBAAgB,QAAQ,CAC1B,QAAO,QAAQ,OAAO,MAAM;AAE9B,QAAO;;;;;;;AAQT,SAAgB,iBACd,SACsB;AACtB,QAAO,gBAAgB,QAAQ,GAAG,UAAU"}

package/dist/icons.d.mts

@@ -0,0 +1,116 @@
+import { f as ToastType, l as ToastIcons, o as SpinnerConfig } from "./types-BnTc6iEw.mjs";
+
+//#region src/icons.d.ts
+
+/**
+ * Default spinner configuration for loading toasts
+ *
+ * Uses a circular animation pattern. Override this by providing
+ * a custom `loading` value in the `icons` option.
+ *
+ * @example
+ * ```ts
+ * // Use a different spinner pattern
+ * const toaster = new ToasterRenderable(ctx, {
+ *   icons: {
+ *     ...DEFAULT_ICONS,
+ *     loading: {
+ *       frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],
+ *       interval: 80,
+ *     },
+ *   },
+ * });
+ * ```
+ */
+declare const DEFAULT_SPINNER: SpinnerConfig;
+/**
+ * Default Unicode icons for toast notifications
+ *
+ * These work in most modern terminals. Use these as the base
+ * and override specific icons as needed.
+ *
+ * @example
+ * ```ts
+ * import { DEFAULT_ICONS, ToasterRenderable } from '@opentui-ui/toast';
+ *
+ * // Use defaults with a custom success icon
+ * const toaster = new ToasterRenderable(ctx, {
+ *   icons: { ...DEFAULT_ICONS, success: '++' },
+ * });
+ * ```
+ */
+declare const DEFAULT_ICONS: ToastIcons;
+/**
+ * ASCII-only icons for terminals with limited Unicode support
+ *
+ * Use these when targeting older terminals or environments
+ * where Unicode characters may not render correctly.
+ *
+ * @example
+ * ```ts
+ * import { ASCII_ICONS, ToasterRenderable } from '@opentui-ui/toast';
+ *
+ * const toaster = new ToasterRenderable(ctx, {
+ *   icons: ASCII_ICONS,
+ * });
+ * ```
+ */
+declare const ASCII_ICONS: ToastIcons;
+/**
+ * Minimal icons using simple single characters
+ *
+ * Perfect for clean, unobtrusive toast notifications.
+ * Pairs well with the `minimal` theme.
+ *
+ * @example
+ * ```ts
+ * import { MINIMAL_ICONS, ToasterRenderable } from '@opentui-ui/toast';
+ * import { minimal } from '@opentui-ui/toast/themes';
+ *
+ * const toaster = new ToasterRenderable(ctx, {
+ *   ...minimal,
+ *   icons: MINIMAL_ICONS,
+ * });
+ * ```
+ */
+declare const MINIMAL_ICONS: ToastIcons;
+/**
+ * Emoji icons for terminals with good emoji support
+ *
+ * Note: Emoji rendering varies across terminals. Test in your
+ * target environment before using in production.
+ *
+ * @example
+ * ```ts
+ * import { EMOJI_ICONS, ToasterRenderable } from '@opentui-ui/toast';
+ *
+ * const toaster = new ToasterRenderable(ctx, {
+ *   icons: EMOJI_ICONS,
+ * });
+ * ```
+ */
+declare const EMOJI_ICONS: ToastIcons;
+/**
+ * Get the icon string for a specific toast type
+ *
+ * For loading type, returns the first frame if it's a SpinnerConfig,
+ * or the static string otherwise.
+ *
+ * @internal - Used by ToastRenderable, not part of public API
+ */
+declare function getTypeIcon(type: ToastType, icons: ToastIcons): string;
+/**
+ * Get the initial loading icon (first frame if spinner, or static string)
+ *
+ * @internal
+ */
+declare function getLoadingIcon(loading: string | SpinnerConfig): string;
+/**
+ * Get the spinner config if loading is animated, or null if static
+ *
+ * @internal
+ */
+declare function getSpinnerConfig(loading: string | SpinnerConfig): SpinnerConfig | null;
+//#endregion
+export { ASCII_ICONS, DEFAULT_ICONS, DEFAULT_SPINNER, EMOJI_ICONS, MINIMAL_ICONS, getLoadingIcon, getSpinnerConfig, getTypeIcon };
+//# sourceMappingURL=icons.d.mts.map

package/dist/icons.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.mts","names":[],"sources":["../src/icons.ts"],"sourcesContent":[],"mappings":";;;;;;AAuBA;AAqBA;AAwBA;AA0BA;AAwBA;AAiBA;AAsBA;AAYA;;;;;;;;;;;cAlJa,iBAAiB;;;;;;;;;;;;;;;;;cAqBjB,eAAe;;;;;;;;;;;;;;;;cAwBf,aAAa;;;;;;;;;;;;;;;;;;cA0Bb,eAAe;;;;;;;;;;;;;;;;cAwBf,aAAa;;;;;;;;;iBAiBV,WAAA,OAAkB,kBAAkB;;;;;;iBAsBpC,cAAA,mBAAiC;;;;;;iBAYjC,gBAAA,mBACI,gBACjB"}

package/dist/icons.mjs

@@ -0,0 +1,3 @@
+import { a as MINIMAL_ICONS, c as getTypeIcon, i as EMOJI_ICONS, n as DEFAULT_ICONS, o as getLoadingIcon, r as DEFAULT_SPINNER, s as getSpinnerConfig, t as ASCII_ICONS } from "./icons-DXx_5j_z.mjs";
+
+export { ASCII_ICONS, DEFAULT_ICONS, DEFAULT_SPINNER, EMOJI_ICONS, MINIMAL_ICONS, getLoadingIcon, getSpinnerConfig, getTypeIcon };

package/dist/index.d.mts

@@ -0,0 +1,53 @@
+import { _ as isSpinnerConfig, d as ToastStyle, f as ToastType, g as isAction, h as TypeToastOptions, i as PromiseData, l as ToastIcons, m as ToasterOptions, n as ExternalToast, o as SpinnerConfig, p as ToasterOffset, r as Position, s as StackingMode, t as Action, u as ToastOptions } from "./types-BnTc6iEw.mjs";
+import { ASCII_ICONS, DEFAULT_ICONS, EMOJI_ICONS, MINIMAL_ICONS } from "./icons.mjs";
+import { n as ToasterRenderable, t as toast } from "./state-CoqnQZsz.mjs";
+
+//#region src/constants.d.ts
+
+/**
+ * Common toast duration presets (in milliseconds)
+ *
+ * Use these for consistent, readable duration values across your app.
+ *
+ * | Preset       | Duration   | Use Case                  |
+ * |--------------|------------|---------------------------|
+ * | `SHORT`      | 2000ms     | Brief confirmations       |
+ * | `DEFAULT`    | 4000ms     | Standard notifications    |
+ * | `LONG`       | 6000ms     | Important messages        |
+ * | `EXTENDED`   | 10000ms    | Critical information      |
+ * | `PERSISTENT` | Infinity   | Requires manual dismissal |
+ *
+ * @example
+ * ```ts
+ * import { toast, TOAST_DURATION } from '@opentui-ui/toast';
+ *
+ * // Quick confirmation
+ * toast.success('Copied!', { duration: TOAST_DURATION.SHORT });
+ *
+ * // Important warning
+ * toast.warning('Check your settings', { duration: TOAST_DURATION.LONG });
+ *
+ * // Critical error that requires acknowledgment
+ * toast.error('Connection lost', { duration: TOAST_DURATION.PERSISTENT });
+ *
+ * // Set as default for all toasts
+ * const toaster = new ToasterRenderable(ctx, {
+ *   toastOptions: { duration: TOAST_DURATION.LONG },
+ * });
+ * ```
+ */
+declare const TOAST_DURATION: {
+  /** 2 seconds - for brief confirmations */
+  readonly SHORT: 2000;
+  /** 4 seconds - default duration */
+  readonly DEFAULT: 4000;
+  /** 6 seconds - for important messages */
+  readonly LONG: 6000;
+  /** 10 seconds - for critical information */
+  readonly EXTENDED: 10000;
+  /** Never auto-dismiss - requires manual dismissal */
+  readonly PERSISTENT: number;
+};
+//#endregion
+export { ASCII_ICONS, type Action, DEFAULT_ICONS, EMOJI_ICONS, type ExternalToast, MINIMAL_ICONS, type Position, type PromiseData, type SpinnerConfig, type StackingMode, TOAST_DURATION, type ToastIcons, type ToastOptions, type ToastStyle, type ToastType, type ToasterOffset, type ToasterOptions, ToasterRenderable, type TypeToastOptions, isAction, isSpinnerConfig, toast };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/constants.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAkCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa"}

package/dist/index.mjs

@@ -0,0 +1,4 @@
+import { n as toast, r as TOAST_DURATION, t as ToasterRenderable } from "./toaster-CQ5RySDh.mjs";
+import { a as MINIMAL_ICONS, i as EMOJI_ICONS, l as isAction, n as DEFAULT_ICONS, t as ASCII_ICONS, u as isSpinnerConfig } from "./icons-DXx_5j_z.mjs";
+
+export { ASCII_ICONS, DEFAULT_ICONS, EMOJI_ICONS, MINIMAL_ICONS, TOAST_DURATION, ToasterRenderable, isAction, isSpinnerConfig, toast };

package/dist/react.d.mts

@@ -0,0 +1,13 @@
+import { m as ToasterOptions } from "./types-BnTc6iEw.mjs";
+import { n as ToasterRenderable, t as toast } from "./state-CoqnQZsz.mjs";
+
+//#region src/react.d.ts
+declare module "@opentui/react" {
+  interface OpenTUIComponents {
+    toaster: typeof ToasterRenderable;
+  }
+}
+declare function Toaster(props: ToasterOptions): React.ReactNode;
+//#endregion
+export { Toaster, toast };
+//# sourceMappingURL=react.d.mts.map

package/dist/react.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.mts","names":[],"sources":["../src/react.tsx"],"sourcesContent":[],"mappings":";;;;;EAI8C,UAAA,iBAAA,CAAA;IAAA,OAAA,EAAA,OAK1B,iBAL0B;;;AAKT,iBAOrB,OAAA,CAPqB,KAAA,EAON,cAPM,CAAA,EAOQ,KAAA,CAAA,SAPR"}

package/dist/react.mjs

@@ -0,0 +1,14 @@
+import { n as toast, t as ToasterRenderable } from "./toaster-CQ5RySDh.mjs";
+import { extend } from "@opentui/react";
+import { jsx } from "@opentui/react/jsx-runtime";
+
+//#region src/react.tsx
+/** @jsxImportSource @opentui/react */
+extend({ toaster: ToasterRenderable });
+function Toaster(props) {
+	return /* @__PURE__ */ jsx("toaster", { ...props });
+}
+
+//#endregion
+export { Toaster, toast };
+//# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.mjs","names":[],"sources":["../src/react.tsx"],"sourcesContent":["/** @jsxImportSource @opentui/react */\n\nimport { extend } from \"@opentui/react\";\nimport { ToasterRenderable } from \"./renderables\";\nimport type { ToasterOptions } from \"./types\";\n\n// Add TypeScript support\ndeclare module \"@opentui/react\" {\n  interface OpenTUIComponents {\n    toaster: typeof ToasterRenderable;\n  }\n}\n\n// Register the toaster component\nextend({ toaster: ToasterRenderable });\n\nexport function Toaster(props: ToasterOptions) {\n  return <toaster {...props} />;\n}\n\nexport { toast } from \"./state\";\n"],"mappings":";;;;;;AAcA,OAAO,EAAE,SAAS,mBAAmB,CAAC;AAEtC,SAAgB,QAAQ,OAAuB;AAC7C,QAAO,oBAAC,aAAQ,GAAI,QAAS"}

package/dist/state-CoqnQZsz.d.mts

@@ -0,0 +1,157 @@
+import { a as PromiseT, c as Toast, i as PromiseData, m as ToasterOptions, n as ExternalToast } from "./types-BnTc6iEw.mjs";
+import { BoxRenderable, RenderContext } from "@opentui/core";
+
+//#region src/renderables/toaster.d.ts
+
+/**
+ * ToasterRenderable - Container for toast notifications
+ *
+ * Features:
+ * - Subscribes to ToastState for automatic toast management
+ * - Supports 6 position variants (top/bottom + left/center/right)
+ * - Single or stack mode for multiple toasts
+ * - Configurable visible toast limit in stack mode
+ * - Automatic oldest toast removal when limit exceeded
+ *
+ * @example
+ * ```ts
+ * import { ToasterRenderable, toast } from '@opentui-ui/toast';
+ *
+ * // Basic usage - add to your app once
+ * const toaster = new ToasterRenderable(ctx);
+ * ctx.root.add(toaster);
+ *
+ * // Then show toasts from anywhere
+ * toast.success('Hello World!');
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With full configuration
+ * const toaster = new ToasterRenderable(ctx, {
+ *   position: 'top-right',
+ *   stackingMode: 'stack',
+ *   visibleToasts: 5,
+ *   closeButton: true,
+ *   gap: 1,
+ *   toastOptions: {
+ *     style: { backgroundColor: '#1a1a1a' },
+ *     duration: 5000,
+ *     success: { style: { borderColor: '#22c55e' } },
+ *     error: { style: { borderColor: '#ef4444' } },
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With a theme preset
+ * import { minimal } from '@opentui-ui/toast/themes';
+ *
+ * const toaster = new ToasterRenderable(ctx, {
+ *   ...minimal,
+ *   position: 'bottom-center',
+ * });
+ * ```
+ */
+declare class ToasterRenderable extends BoxRenderable {
+  private _options;
+  private _toastRenderables;
+  private _unsubscribe;
+  constructor(ctx: RenderContext, options?: ToasterOptions);
+  /**
+   * Subscribe to toast state changes
+   */
+  private subscribe;
+  /**
+   * Add a new toast or update an existing one
+   */
+  private addOrUpdateToast;
+  /**
+   * Remove a toast by ID
+   */
+  private removeToast;
+  /**
+   * Handle when a toast is fully removed
+   */
+  private handleToastRemoved;
+  /**
+   * Get the current number of visible toasts
+   *
+   * @example
+   * ```ts
+   * if (toaster.toastCount > 0) {
+   *   console.log(`Showing ${toaster.toastCount} notifications`);
+   * }
+   * ```
+   */
+  get toastCount(): number;
+  /**
+   * Dismiss all toasts managed by this toaster
+   *
+   * @example
+   * ```ts
+   * // Clear all notifications
+   * toaster.dismissAll();
+   * ```
+   */
+  dismissAll(): void;
+  /**
+   * Clean up on destroy
+   */
+  destroy(): void;
+}
+//#endregion
+//#region src/state.d.ts
+type TitleT = string | (() => string);
+/**
+ * Observer class implementing the pub/sub pattern for toast state management.
+ * This is the core of the Sonner-compatible API.
+ */
+
+/**
+ * The main toast API - a function with methods attached
+ *
+ * @example
+ * ```ts
+ * // Basic usage
+ * toast('Hello World');
+ *
+ * // With variants
+ * toast.success('Operation completed');
+ * toast.error('Something went wrong');
+ * toast.warning('Be careful');
+ * toast.info('Did you know?');
+ * toast.loading('Processing...');
+ *
+ * // Promise toast
+ * toast.promise(fetchData(), {
+ *   loading: 'Loading...',
+ *   success: 'Data loaded!',
+ *   error: 'Failed to load',
+ * });
+ *
+ * // Dismiss
+ * const id = toast('Hello');
+ * toast.dismiss(id);
+ * toast.dismiss(); // dismiss all
+ * ```
+ */
+declare const toast: ((message: TitleT, data?: ExternalToast) => string | number) & {
+  success: (message: TitleT, data?: ExternalToast) => string | number;
+  info: (message: TitleT, data?: ExternalToast) => string | number;
+  warning: (message: TitleT, data?: ExternalToast) => string | number;
+  error: (message: TitleT, data?: ExternalToast) => string | number;
+  message: (message: TitleT, data?: ExternalToast) => string | number;
+  promise: <ToastData>(promise: PromiseT<ToastData>, data?: PromiseData<ToastData> | undefined) => {
+    unwrap: () => Promise<ToastData>;
+  } | undefined;
+  dismiss: (id?: string | number) => string | number | undefined;
+  loading: (message: TitleT, data?: ExternalToast) => string | number;
+} & {
+  getHistory: () => Toast[];
+  getToasts: () => Toast[];
+};
+//#endregion
+export { ToasterRenderable as n, toast as t };
+//# sourceMappingURL=state-CoqnQZsz.d.mts.map

package/dist/state-CoqnQZsz.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-CoqnQZsz.d.mts","names":[],"sources":["../src/renderables/toaster.ts","../src/state.ts"],"sourcesContent":[],"mappings":";;;;;;;;;ACQiB;AAqejB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cD3aa,iBAAA,SAA0B,aAAA;;;;mBAKpB,yBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KC3DtC,MAAA;;;ADsDL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cC2aa,kBAtDF,eACF;qBAxPa,eAAe;kBAalB,eAAe;qBAaZ,eAAe;mBAvCjB,eAAe;qBAbb,eAAe;gCAsGf,SAAA,mBAAA,YAAA;;;;qBA/BA,eAAe"}

package/dist/themes.d.mts

@@ -0,0 +1,69 @@
+import { m as ToasterOptions } from "./types-BnTc6iEw.mjs";
+
+//#region src/themes.d.ts
+
+/**
+ * A theme configuration for the toaster.
+ * Extends ToasterOptions with metadata.
+ */
+interface ToasterTheme extends ToasterOptions {
+  /** Human-readable name for the theme */
+  name: string;
+  /** Brief description of the theme */
+  description: string;
+}
+/**
+ * Minimal theme - clean and unobtrusive
+ *
+ * No borders, subtle styling. Perfect for apps where
+ * toasts should be informative but not distracting.
+ *
+ * @example
+ * ```ts
+ * import { ToasterRenderable } from '@opentui-ui/toast';
+ * import { minimal } from '@opentui-ui/toast/themes';
+ *
+ * const toaster = new ToasterRenderable(ctx, minimal);
+ *
+ * // Or customize it
+ * const toaster = new ToasterRenderable(ctx, {
+ *   ...minimal,
+ *   position: 'top-center',
+ *   stackingMode: 'stack',
+ * });
+ * ```
+ */
+declare const minimal: ToasterTheme;
+/**
+ * Monochrome theme - grayscale only
+ *
+ * No colors, just shades of gray. Useful for
+ * accessibility or when color is not desired.
+ *
+ * @example
+ * ```ts
+ * import { ToasterRenderable } from '@opentui-ui/toast';
+ * import { monochrome } from '@opentui-ui/toast/themes';
+ *
+ * const toaster = new ToasterRenderable(ctx, monochrome);
+ * ```
+ */
+declare const monochrome: ToasterTheme;
+/**
+ * All available themes as a single object
+ *
+ * @example
+ * ```ts
+ * import { themes } from '@opentui-ui/toast/themes';
+ *
+ * // Access themes by name
+ * const toaster = new ToasterRenderable(ctx, themes.minimal);
+ * ```
+ */
+declare const themes: {
+  readonly minimal: ToasterTheme;
+  readonly monochrome: ToasterTheme;
+};
+//#endregion
+export { ToasterTheme, minimal, monochrome, themes };
+//# sourceMappingURL=themes.d.mts.map

package/dist/themes.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themes.d.mts","names":[],"sources":["../src/themes.ts"],"sourcesContent":[],"mappings":";;;;;;;;UAsBiB,YAAA,SAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;cAgCzB,SAAS;;;;;;;;;;;;;;;cAoCT,YAAY;;;;;;;;;;;;cA0CZ;oBAGH;uBAAA"}